什麼是 Mastra Code？

Mastra Code 是一款先進的、基於終端機的 AI 編碼代理，旨在無縫整合到開發人員的工作流程中。它建立在 Mastra 穩健的 Harness、Agent 和 Memory 原生元件之上，將大型語言模型的強大功能直接帶入您的命令列介面。它充當智慧型配對程式設計師，能夠理解上下文、執行命令並管理複雜的編碼任務，而無需離開終端機環境。

這個強大的代理連接到超過 70 種不同的 AI 模型，允許開發人員針對特定任務利用最佳模型，或在對話中比較不同供應商的輸出。其核心目的是透過提供對程式碼讀取、搜尋、編輯和執行功能的即時存取來提高生產力，所有這些都透過直觀的文字使用者介面 (TUI) 進行管理。

關鍵功能

• 多模型支援： 連接到並支援超過 70 種 AI 模型，允許在單一會話中動態切換供應商（如 Anthropic 或 OpenAI），以實現最佳效能或成本管理。
• 工作流程模式： 提供不同的操作模式——Build（通用開發）、Plan（架構分析和規劃）和 Fast（低延遲快速查找/編輯）——以匹配開發人員當前的焦點。
• 整合工具： 為基本開發任務提供內建工具，包括檔案檢視、編輯、程式碼搜尋、執行 shell 命令和執行網路搜尋。
• 持續的上下文與配置： 支援專案範圍的對話線程、MCP 伺服器、自訂 Hook 和技能。線程持久性確保跨會話的連續性。
• 可擴展性： 高度可自訂，允許開發人員透過新增自訂模式、新工具、子代理和替代儲存解決方案來以程式化方式擴展功能。
• 精美的 TUI： 採用使用 pi-tui 組件建構的現代、響應式的終端機介面，提供對操作、工具輸出和 Token 使用情況的清晰可見性。

如何使用 Mastra Code

開始使用 Mastra Code 很簡單，但需要 Node.js（22.13.0 或更高版本）作為先決條件。

1. 安裝： 使用 npm、yarn、bun 全域安裝 Mastra Code，或直接透過 npx 或 bun x 執行：

npm install -g mastracode
# 或
bun x mastracode

2. 初始化： 導航到您的專案目錄並啟動代理：

cd your-project
mastracode

3. 身份驗證： 將您的 API 金鑰設定為環境變數（例如 export ANTHROPIC_API_KEY=...），或使用 /login 斜線命令透過 OAuth 供應商進行身份驗證。

4. 互動： 驗證後，只需在 TUI 中輸入您的請求或命令即可。代理將串流傳輸回應，並且可以主動在您的專案上下文內讀取、編輯和執行程式碼。使用 /mode 等斜線命令來切換工作流程，或使用 /threads 來管理對話。

使用案例

1. 日常重構和除錯： 快速要求代理解釋複雜函數、建議重構改進、為特定模組生成單元測試，或直接從終端機管理簡單的 Git 操作。
2. 架構規劃： 利用 Plan Mode 向代理提供高階需求。它可以分析現有的程式碼結構，提出詳細的實施計畫，並在編寫任何程式碼之前概述必要的檔案變更。
3. 快速上下文切換： 在處理遺留系統或不熟悉的程式碼庫時，使用 Mastra Code 進行快速查找 (/mode Fast)，以立即搜尋文件或在不開啟多個檔案的情況下找到特定變數的初始化位置。
4. 模型比較測試： 處理效能關鍵任務的開發人員可以在對話中途切換模型（例如比較 GPT-4o 的延遲與 Claude 3 Opus 的推理能力），以選擇最適合當前任務且最具成本效益的 AI。
5. 自訂工具整合： 團隊可以定義針對內部部署腳本或專有資料庫互動量身定制的自訂斜線命令或子代理，將專業化的工作流程直接嵌入代理的功能中。

常見問題 (FAQ)

問：執行 Mastra Code 的最低系統要求是什麼？ 答：Mastra Code 需要 Node.js 22.13.0 或更高版本才能有效運行。請確保您的環境在安裝前滿足此先決條件。

問：Mastra Code 如何處理對話歷史記錄和上下文？ 答：它使用 LibSQL 儲存來維持線程持久性、訊息歷史記錄和 Token 使用情況追蹤。對話通常以專案目錄為範圍，確保代理在會話中記住相關上下文。

問：我可以為代理定義自己的命令嗎？ 答：是的，Mastra Code 具有高度擴展性。您可以透過建立 Markdown 檔案來定義自訂斜線命令，從而根據您特定的組織需求或內部工具來調整代理的功能。

問：如果代理正在運行長時間操作，會發生什麼？ 答：您可以使用標準鍵盤快捷鍵 Ctrl+C 中斷當前操作。這允許您立即停止正在運行的 shell 命令或正在進行的生成過程。

問：我如何管理我正在使用的 AI 供應商？ 答：您可以使用 /models 斜線命令或設定相關的 API 金鑰環境變數來在中途切換模型。該代理支援與 Anthropic 和 OpenAI 等主要供應商進行身份驗證。