Mastra Code

什么是 Mastra Code？

Mastra Code 是基于终端的 AI 编程代理，使用 Mastra 的 Harness、Agent 和 Memory 原语构建。它在终端中运行，连接 70+ AI 模型，支持交互式编程工作流，如在项目中阅读、搜索、编辑和执行代码。

代理的核心目的是帮助您使用终端内 TUI（终端用户界面）、结构化模式和项目范围会话处理完成编程任务。它旨在组织代理的思考和行动方式——无论您需要快速查询、计划实现，还是完整的构建-测试循环。

主要特性

• 终端 UI (TUI) 体验：在终端中提供精美的 TUI（pi-tui 组件），用于交互式代理操作，而非独立的 Web 应用。
• 多模型支持 (70+ 模型)：连接 70+ AI 模型，支持对话中途切换模型，实现多模型工作流。
• 基于模式的流程控制：在 Build、Plan 和 Fast 模式间切换，以匹配您希望代理的响应方式（例如，实现 vs. 快速回答）。
• 项目范围会话和持久上下文：使用线程持久化和消息历史，按项目组织对话。
• 代理中的编程工具：内置 文件查看、编辑、搜索、Shell 命令 和 Web 搜索 工具，支持端到端编程任务。
• 可配置代理行为：支持项目范围配置，包括 MCP 服务器、钩子、自定义命令、技能和数据库设置。
• 程序化自定义：使用自定义模式、工具、子代理和存储扩展 Mastra Code。

如何使用 Mastra Code

1. 全局安装：使用提供的命令之一（npm、pnpm 或 yarn），例如 npm install -g mastracode。
2. 进入项目目录：cd your-project，然后用 mastracode 启动 Mastra Code。
3. 设置 API 密钥：为首选提供商设置密钥（示例为 Anthropic：export ANTHROPIC_API_KEY=...），或使用 /login 进行 身份验证（提及 Anthropic 或 OpenAI 订阅）。
4. 发送消息：在终端中发送消息；代理以流式文本响应，并可在您的项目中阅读、编辑和运行代码。
5. 使用斜杠命令和键盘快捷键：管理会话、切换模型和模式、控制 TUI（例如 /threads、/models、/mode、/cost、/login、/exit）。

使用场景

• 日常编程助手：询问代码库问题、请求编辑、运行测试、管理 Git 任务，同时保持在同一终端工作流中。
• 代码探索和架构规划：使用 Plan 模式 分析架构并生成实现计划，然后编写代码。
• 快速查询和小改动：切换到 Fast 模式，获取简短回答和少量编辑，延迟最小。
• 多提供商比较：通过对话中途切换模型，比较不同 AI 模型对同一编程问题的响应。
• 开发中的会话和设置管理：使用斜杠命令启动新对话线程、按项目列出线程、克隆线程、查看令牌使用量，并调整设置/主题。

常见问题

Mastra Code 的系统要求是什么？
Mastra Code 需要 Node.js 22.13.0 或更高版本。

如何与 AI 提供商身份验证？
您可以为提供商设置环境变量 API 密钥（显示 Anthropic 示例），或运行 /login 与 Anthropic 或 OpenAI 订阅身份验证。

使用代理时可以切换 AI 模型和模式吗？
可以。代理提供斜杠命令来选择不同 AI 模型，并在 Build、Plan 和 Fast 模式间切换。

Mastra Code 如何组织对话？
它使用 项目范围线程 和持久对话历史，允许在项目内列出、克隆和管理线程。

Mastra Code 支持自定义工具或代理行为吗？
支持。您可以配置 MCP 服务器、钩子、自定义命令、技能和数据库设置，并使用自定义模式、工具、子代理和存储扩展代理。

替代方案

• 本地 IDE 集成的 AI 编程工具：在编辑器/IDE 中运行的替代方案可提供上下文代码辅助，但通常专注于内联建议，而非终端优先的代理工作流及明确模式。
• 通用终端 LLM 聊天结合自定义工具：终端中的聊天代理可通过脚本扩展文件编辑和命令执行，但需更多设置来复制 Mastra Code 的内置工具、模式处理及会话/线程结构。
• 基于工作流的编程助手（规划/构建风格）：强调规划优先于实现的工具可匹配“Plan mode”理念；差异通常在于工具执行（编辑/搜索/Shell）和持久项目线程的处理方式。
• 用于编程任务的代理框架：通用代理框架可用于构建带内存和工具的编程代理，但 Mastra Code 将这些原语打包成即开即用的终端 TUI。