Maestro：AI 代理编曲指挥中心
跨平台桌面应用，编排多个 AI 编码代理并行工作，通过剧本和 Git Worktrees 实现自动化、长时间无人值守执行。
证据显示：SECURITY.md 明确说明进程以用户权限运行，并建议用户审查代理操作，这体现了最小权限原则的部分考虑。用户确认方面，README 提到 Auto Run 自动执行任务，但未明确说明用户确认机制。数据流透明度方面，README 描述了数据流（如 MCP 工具、权限、认证），但未详细说明数据流向。敏感数据处理方面，SECURITY.md 提到 Sentry DSN 是公开的，但未说明如何处理用户敏感数据。依赖安全方面，package.json 列出了依赖，但未提供漏洞扫描或审计证据。外部影响方面，SECURITY.md 提到本地 Web 服务器和 Cloudflare 隧道，但未说明默认状态。回滚方面，未提及任何回滚机制。来源归属方面，package.json 和 README 提供了作者和仓库信息，但发布者未经验证。扣分原因：缺乏明确的用户确认、数据流透明度和敏感数据处理细节，回滚机制缺失。
证据显示：README 和 package.json 中的描述一致，如功能列表和版本号，自洽性较好。依赖可用性方面，package.json 列出了大量依赖，但未提供锁定文件或完整性校验，依赖可用性存在风险。失败消息方面，SECURITY.md 提到响应时间，但未提供具体的错误处理或用户提示。扣分原因：依赖锁定和失败消息的具体实现未在静态文件中体现。
证据显示：README 明确了目标用户（黑客、高级用户）和使用场景（多项目并行），受众和场景清晰。能力边界方面，README 列出了支持的代理和功能，但未明确不支持的功能。触发精度方面，README 提到 Auto Run 和 Playbooks，但未详细说明触发条件。环境适配方面，README 提供了安装要求和平台支持，但未说明所有环境限制。扣分原因：触发精度和部分环境限制未详细说明。
证据显示：README 提供了详细的功能列表和文档链接，信息架构清晰。安装说明方面，README 提供了从源码构建的步骤，但未提供详细的安装指南。命名稳定性方面，package.json 中的名称和版本号一致，但未提供命名规范。示例和 FAQ 方面，README 提供了视频和文档链接，但未提供 FAQ。已知限制方面，README 提到支持有限，但未列出所有限制。许可证方面，LICENSE 文件为 AGPL-3.0，符合要求。版本变更日志方面，未提供 CHANGELOG 文件。维护责任方面，SECURITY.md 提到志愿者维护，但未明确责任分配。扣分原因：缺少 CHANGELOG、FAQ 和详细的已知限制。
证据显示：README 描述了输出过滤、JSONL 输出等功能，输出可用性较好。边际价值方面，Maestro 提供了多代理编排、Auto Run 等独特功能，边际价值较高。成本效益方面，README 提到成本跟踪，但未提供定价或成本分析。扣分原因：成本效益缺乏具体数据。
证据显示：README 中的功能描述与 package.json 中的依赖和脚本部分对应，但未提供测试结果或验证证据。跨来源佐证方面，README 和 SECURITY.md 提供了一些安全信息，但未与其他来源交叉验证。事实与推断分离方面，README 中的描述多为断言，未明确区分事实和推断。扣分原因：缺乏测试证据和明确的验证方法。
- 发布者身份未经验证，需谨慎对待。
- 依赖未锁定，存在供应链风险。
- 自动执行任务可能带来安全风险，需用户确认。
- 缺少回滚机制，操作不可逆。
这个 Agent 能做什么，适合哪些场景？
Maestro 是一款跨平台的桌面应用（macOS、Windows、Linux），支持 Claude Code、OpenAI Codex、OpenCode、Factory Droid 和 Copilot-CLI（beta）。它提供了一个类 Linear/Superhuman 的高响应界面，用于并行管理多个代理。核心功能包括 Git Worktrees 实现无冲突并行开发，以及基于文件系统的 Auto Run & Playbooks 任务执行器，可为每个任务启动独立会话，支持长达 24 小时的无人值守运行。它支持群聊、移动远程控制、CLI、消息队列、会话发现、Git 集成、文件浏览器、输出过滤、斜杠命令等。Maestro 是 AI 提供商的透传，这意味着代理的 MCP 工具、技能和认证在 Maestro 中同样有效，只是执行方式改为非交互式。
Maestro 充当多个命令行 AI 编码代理（如 Claude Code、Codex、OpenCode）的非交互式前端。用户可以启动和管理多个代理会话，每个会话具有隔离的工作区和上下文。它将 AI 终端的任务以提示方式发送到基础代理的 CLI，并获取响应，可新建会话或恢复之前的会话。它自动从已安装的代理中发现并导入现有会话。Git Worktrees 功能允许从分支菜单创建子代理，每个子代理在独立目录中操作，并支持一键创建 PR。Auto Run 从文件系统读取 markdown 检查清单，并通过 AI 代理批量处理，每个任务启动新的 AI 会话。群聊功能借助主持人 AI 协调多个代理，将问题路由给合适的代理并综合回复。消息队列在代理忙时暂存消息，并在空闲时自动发送。CLI（maestro-cli）支持无头操作，可列出代理/组，通过 cron 或 CI/CD 运行剧本，并提供 JSONL 输出。它包含使用仪表板，跟踪令牌使用和成本，并提供 CSV 导出。Document Graph 从 markdown 文档构建可视化的知识图谱，内部 wiki 链接和 markdown 链接以交互方式可视化。
- 同时使用 Claude Code、Codex 和 OpenCode 进行多项目的开发人员，需要一个统一的界面来管理和切换代理。
- 需要并行处理多个任务并在隔离分支上工作的开发者，利用 Git Worktrees 功能避免冲突。
- 希望自动化重复工作流（例如代码审查、测试、生成文档）的团队，通过 Playbooks 进行无人值守的批量执行。
- 需要在路上监控多个代理运行的开发者，通过内置的 Web 服务器和 QR 码在手机上访问。
- 使用 CLI 将代理任务集成到 CI/CD 管道或定时任务中的高级用户，利用 maestro-cli 的无头操作。
- 希望在一个对话中协调多个代理进行跨项目架构讨论或问题解答的团队，使用 Group Chat 功能。
这个 Agent 有哪些优点和局限？
- 支持多种主流 AI 编码代理（Claude Code、Codex、OpenCode 等），统一的非交互式界面。
- Git Worktrees 功能实现了真正的并行开发，避免分支冲突。
- Auto Run 和 Playbooks 支持无人值守执行长任务，提高了自动化效率。
- 支持群聊，可协调多个代理进行复杂讨论。
- 键盘优先的设计，支持自定义快捷键和成就系统，提升高生产力用户的效率。
- 需要安装并认证至少一个外部 AI 编码代理，增加了部署依赖。
- 作为透传，不提供内置的 AI 模型，依赖外部提供商的可用性和成本。
- Linux/Windows 上的快捷键支持与 macOS 不同，可能要求用户重新学习。
- Copilot-CLI 标记为 beta，支持可能不稳定。
- AGPL-3.0 许可证可能限制商业集成或修改。
如何安装或部署这个 Agent？
从 Releases 页面为你的平台下载最新版本。或者从源码构建：克隆仓库，npm install，npm run dev。需要安装并认证至少一个支持的 AI 编码代理：Claude Code、Codex、OpenCode 或 Copilot-CLI（beta）。可选要求 Git。
如何使用这个 Agent？
安装并启动 Maestro。通过 Cmd+N (Ctrl+N) 创建新代理，选择要使用的 AI 代理（Claude Code 等）。在提示区域键入你的请求，Maestro 会将其发送到所选代理的 CLI。使用 Cmd+J (Ctrl+J) 在 AI 终端和命令终端之间切换。使用 Cmd+K (Ctrl+K) 打开快速操作面板，通过 Cmd+[ / Cmd+] 切换代理。要使用 Auto Run，创建包含 markdown 检查清单的剧本文件，并通过 Auto Run 菜单运行。要使用群聊，从界面启动群聊会话，输入消息并让主持人 AI 进行协调。