Mozzie

Mozzie 是什么？

Mozzie 是一款本地优先桌面应用，将 AI 编码代理作为托管工作力进行编排。与每次仅运行单个代理会话不同，您描述要构建的内容，Mozzie 将工作拆分为任务项，并行运行多个代理，并通过基于 Git 的工作流协调输出。

该应用设计为将工作和编排保留在您的机器上。它为每个工作项创建独立的 Git worktree，管理任务间的依赖关系，并提供评审流程，让您在合并前批准或拒绝变更。

主要特性

• 本地优先执行与离线工作流：使用本地 SQLite 数据库，一切均在您的机器上运行，包括代理执行工作流。
• 自然语言编排为工作项：编排器将您的请求转换为工作项，设置执行顺序并分配代理。
• 并行多代理支持：同时运行多个编码代理，包括内置支持 Claude Code、Gemini CLI、Codex CLI 和自定义 CLI/脚本。
• 每个工作项的 Git worktree 隔离：每个工作项在自己的 worktree 和分支中执行，减少代理运行间的冲突。
• 评审 + 合并工作流：代理完成后，Mozzie 提供 diff/评审步骤；批准则推送到 origin，拒绝则将反馈注入下次尝试。
• 依赖图与阻塞项自动启动：工作项可相互依赖；阻塞项在依赖完成时自动启动，并包含循环检测。
• 子工作项（堆叠分支）与父子合并：子分支合并到父工作项；父项作为单一 PR 推送到 origin。
• 跨会话持久对话：编排器上下文得到保留，您可从中断处继续。
• 代理输出的实时流式传输：您可实时查看代理输出，包括工具调用活动可视化。

如何使用 Mozzie

1. 安装先决条件：使用 Node >= 20、pnpm >= 9、Rust (stable) 以及平台特定的 Tauri 先决条件。确保至少安装一个 AI 编码代理 CLI。
2. 设置应用：
   • 克隆仓库并安装依赖 (pnpm install)。
   • 启动开发应用 (pnpm dev)。应用将打开。
3. 配置提供商和代理：
   • 在 Open Settings（齿轮图标）中，为您的 LLM 编排器提供商（OpenAI、Anthropic 或 Gemini）添加 API 密钥。
   • 为要运行的编码代理添加配置（例如 Claude Code、Gemini CLI、Codex 或自定义）。
4. 创建并运行工作项：
   • 创建工作项，指向仓库，分配代理并启动执行。
   • 或者打开命令栏 (Ctrl+K)，描述要构建的内容，让编排器创建工作项并排队。
5. 评审与合并：
   • 工作项到达评审时，批准以推送变更至 origin。
   • 拒绝以提供反馈；Mozzie 将完整尝试历史和拒绝原因注入代理的下次提示。

使用场景

• 将功能请求拆分为多个并行编码任务：通过命令栏描述较大变更；Mozzie 将其拆分为工作项，并同时运行支持的代理以生成可评审分支。
• 在保持代理输出隔离的情况下处理仓库：实验多种方法时，每个工作项在自己的 Git worktree 和分支中运行，防止代理运行相互干扰。
• 处理多步依赖（例如，先搭建再实现）：创建带依赖的工作项，阻塞项仅在先决项完成后自动启动，并包含循环检测以防循环计划。
• 失败尝试后通过结构化反馈迭代：评审时拒绝工作项并附反馈；Mozzie 将完整尝试历史（包括拒绝原因）注入下次运行，以减少重复错误。
• 从单一桌面应用会话管理多个项目：使用多工作区支持，在同一应用中运行和评审跨多个仓库的工作项。

常见问题

• Mozzie 需要云连接才能运行吗？ Mozzie 本地优先，完全离线可用。

• 它能运行哪些 AI 编码代理？ 仓库列出了内置支持 Claude Code（通过 ACP/stdio 传输）、Gemini CLI、Codex CLI 和自定义 CLI/脚本。

• Mozzie 如何防止代理间冲突？ 它为每个工作项创建独立的 git worktree 和分支，因此并发运行不会共享相同工作目录。

• 如果我在评审时拒绝工作项，会发生什么？ Mozzie 将完整尝试历史和您的拒绝原因纳入代理的下一个提示中，状态可从评审退回重跑路径。

• 工作项可以相互依赖吗？ 可以。Mozzie 支持依赖图，在依赖完成时自动启动被阻塞项，并包含循环检测。

替代方案

• 单代理 IDE 工具或聊天式编码助手：适合一次运行一个代理会话；通常不提供相同的工作项依赖编排和 git worktree 隔离。
• 本地脚本运行器，向 CLI 分发多个任务：可以并行化代理命令，但您需自行构建编排、依赖管理和评审流程。
• 基于 CI/CD 的代码生成和 PR 评审自动化：可处理评审关卡和分支，但较少面向交互式本地“单窗口”编排流程。
• 无本地优先 git worktree 的 AI 代理工作流/编排工具：可能协调代理调用，但可能不提供 Mozzie 描述的特定 git worktree 隔离和栈分支合并流程。