AgentBridge Local

English | 简体中文

原名 MiMo Bridge MCP。

AgentBridge Local 是一个本地优先的 MCP 编排控制台，让 Codex 协调 MiMo Code、Reasonix TUI 以及未来的本地编码代理，同时保留审查控制权。

Codex 擅长规划、架构和审查。本地编码代理对于长时间的实现循环很有用。AgentBridge Local 将这些工作分开：

• Codex 负责规划和审查。

• MiMo / Reasonix 执行有边界的任务。

• 每个任务都在 Git Worktree 中运行。

• Codex 在接触差异、日志或文件之前，先读取紧凑的审查包。

• 由您决定合并什么。

目标不是“让代理自由编辑您的仓库”。目标是受控的委派：小任务范围、隔离执行、低令牌审查，以及由人类或 Codex 控制的最终决策。

为什么存在

长时间编码循环会消耗大量令牌，并淹没重要的审查信号。AgentBridge Local 为您提供更安全的模式：

1. Codex 将工作分解为有边界的任务。

2. 本地代理在隔离的 Worktree 中实现它。

3. 守护进程构建一个小型审查包：更改的文件、差异统计、风险标志、范围报告、测试结果和日志尾部。

4. Codex 首先审查该包。

5. 只有风险或不清楚的任务才会升级到有针对性的差异、有针对性的文件或有边界的日志读取。

6. Codex 或用户接受、拒绝、合并、丢弃，或要求代理继续。

这意味着 Codex 可以保持在昂贵、高杠杆的位置：规划、边界控制、审查和最终验收。

Related MCP server: codex-as-mcp

您将获得

• 本地 MCP 守护进程 位于 http://127.0.0.1:3210/mcp。

• 浏览器管理 UI 位于 http://127.0.0.1:3210/。

• MiMo Code 执行 通过传统的 mimo_* 工具和共享任务队列。

• Reasonix TUI 执行 通过通用的 agent_* 工具。

• 代理感知的任务队列，当 MiMo 和 Reasonix 的可编辑路径不重叠时，可以并行运行它们。

• 持久的 P0 任务准入，具有持久占位符、请求关联、幂等重试和八个任务的并发上限。

• Git Worktree 隔离 用于任务更改。

• 动态任务范围，具有每个任务的可编辑/只读边界。

• 低令牌审查包协议 用于 Codex 审查。

• 完成恢复收件箱，以便 Codex 在中断后恢复已完成或失败的任务。

• 模型路由配置文件，用于简单、正常、复杂、高风险和多模态任务。

• 多模态任务附件，支持粘贴图像和上传文件。

• 安全的本地打开操作，用于任务文件夹、会话文件夹、MiMo CMD 会话、Reasonix TUI CMD 会话和 Reasonix GUI 伴侣查看。

• Windows 便携 ZIP 和 EXE 安装程序，附带捆绑的 Node 运行时。

工作原理

flowchart TD
  A["Codex / Main Agent"] -->|"MCP"| B["AgentBridge Local Daemon"]
  B --> C["Agent Registry"]
  C --> D["MiMo Code Runner"]
  C --> E["Reasonix TUI Runner"]
  C --> F["Future Local Agents"]
  D --> G["Task Git Worktree"]
  E --> G
  F --> G
  G --> H["Review Package"]
  H --> I{"Risk or unclear result?"}
  I -->|"No"| J["Accept / Merge / Discard"]
  I -->|"Yes"| K["Focused diff / file / log"]
  K --> J
  J --> A

当前状态

AgentBridge Local 是一个早期 alpha 项目。

• 目标操作系统：Windows 10/11 x64。

• 运行时：仅限 localhost 的 Node 守护进程。

• MCP 端点：http://127.0.0.1:3210/mcp。

• 管理 UI：http://127.0.0.1:3210/。

• 分发：便携 ZIP 和 EXE 安装程序，附带捆绑的 Node。

• MiMo Code 和 Reasonix 不捆绑；请单独安装并登录这些工具。

• 仍然欢迎干净的 Windows 验证和社区测试。

快速开始

选项 A：使用 Windows 安装程序

1. 下载最新的发布资产：

   • MiMoBridgeSetup-win10-win11-x64.exe

2. 运行安装程序。

3. 从已安装的启动器启动 AgentBridge Local。

4. 打开管理 UI：

   http://127.0.0.1:3210/

5. 将 Codex MCP 配置指向：

   http://127.0.0.1:3210/mcp

选项 B：从源码运行

先决条件：

• Windows 10/11 x64。

• Git。

• Node.js 18+。

• Codex 或其他支持 MCP 的主代理。

• 如果希望使用 MiMo 执行，请安装并登录 MiMo Code。

• 如果希望使用 Reasonix TUI 执行，请安装并配置 Reasonix。

从仓库根目录：

npm.cmd install
npm.cmd run build
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 start -Open

启动器控制：

powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 status
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 start -Open
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 stop
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 restart -Open
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 adopt
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 allow-root -Path "C:\path\to\project" -Restart
powershell -ExecutionPolicy Bypass -File apps/local-daemon/launcher.ps1 logs

allowedRoots 是机器级边界，不会被任何任务扩展。allow-root 命令解析并验证目录，不区分大小写去重，写入活动配置，并可选择执行安全重启。仅当 localhost 端口所有者、Node 可执行文件、守护进程入口和健康标识完全匹配时，adopt 才会成功。

MCP 端点

配置 Codex 使用：

http://127.0.0.1:3210/mcp

然后要求 Codex 从有边界的任务开始，例如：

Use AgentBridge Local. Ask MiMo or Reasonix to update only docs/example.md.
Review the result through the Review Package first, then merge only if the scope and tests are clean.

mimo_start_task 和 agent_start_task 在 Worktree 创建之前持久化并返回占位符。成功的请求返回 task_id、request_id、status="preparing_worktree"、queue_state 和 idempotent_replay。客户端应发送 idempotency_key 并在超时后重用；相同键但不同参数将被拒绝。

任务启动通过 preparing_worktree -> starting_agent -> running 阶段。阶段失败会存储结构化的 error_detail 及其 request_id，而传统的字符串 error 仍可用于兼容性。

发布安全的客户端仅使用 Node 内置模块和 REST，因此不需要此源码树的 node_modules 或 MCP SDK：

node scripts/mimo-bridge-client.mjs health
node scripts/mimo-bridge-client.mjs start --json .\task.json --idempotency-key my-stable-key
node scripts/mimo-bridge-client.mjs wait --task-id task_xxx --timeout-seconds 1800

便携版和安装版分发提供相同的入口 MiMo Bridge Client.cmd，并使用捆绑的 Node 运行时运行。

匹配的 Codex 使用技能在 skills/use-mimo-bridge-mcp 下版本化，并包含在两个分发版中。安装是显式的，因此现有自定义技能永远不会被静默覆盖：

& "$env:LOCALAPPDATA\MiMoBridgeApp\Install MiMo Bridge Codex Skill.cmd"

该命令在替换前备份现有的 use-mimo-bridge-mcp 技能。如果技能列表已被缓存，请之后打开新的 Codex 会话。

第一个任务流程

1. 打开管理 UI。

2. 选择工作区和任务范围。

3. 选择自动路由或手动选择 MiMo / Reasonix。

4. 粘贴任务目标。您可以粘贴截图或上传文件用于多模态任务。

5. 让代理在 Worktree 中运行。

6. 审查紧凑的结果。

7. 接受、合并、丢弃，或要求代理继续。

低令牌审查工作流

AgentBridge Local 围绕有边界的审查构建，而不是完整的上下文转储。

flowchart TD
  A["Start bounded task"] --> B["Wait once"]
  B --> C["Read Review Package"]
  C --> D["Check scope, changed files, tests, risk flags"]
  D --> E{"Need more evidence?"}
  E -->|"No"| F["Decide accept / merge / discard"]
  E -->|"Yes"| G["Read focused diff / file / log tail"]
  G --> F

支持的代理

安全模型

AgentBridge Local 有意保持狭窄的安全边界：

• 守护进程仅绑定到 localhost。

• 任务在 Git Worktrees 中运行。

• 机器级 allowedRoots 限制可以触及哪些文件夹。

• 健康和工作区边界错误仅暴露活动配置元数据、脱敏指纹、计数和请求的规范化路径；它们从不枚举其他允许的根目录。

• 每个任务记录其自己的可编辑/只读范围快照。

• 范围外的更改出现在审查包风险标志中。

• 浏览器打开操作是固定操作，而不是任意命令执行。

• 完整日志、完整差异、完整文件和原始本地路径不是默认审查输出。

• MiMo 和 Reasonix 不应合并自己的任务 Worktrees。

不要将守护进程暴露给公共网络。

构建、测试和打包

构建：

npm.cmd run build
npm.cmd --prefix apps/admin-ui run build
npm.cmd --prefix apps/local-daemon run build

运行正常回归测试，排除已知挂起的运行器集成测试：

$tests = Get-ChildItem -LiteralPath 'tests' -Filter '*.test.mjs' |
  Where-Object { $_.Name -ne 'runner-integration.test.mjs' } |
  ForEach-Object { $_.FullName }
node --test $tests

打包：

npm.cmd run package:portable
npm.cmd run package:installer
npm.cmd run validate:release

生成的发布输出：

• artifacts/MiMoBridge-portable-win10-win11-x64.zip

• artifacts/MiMoBridgeSetup-win10-win11-x64.exe

• artifacts/release-validation.json

工件名称仍使用原始的 MiMoBridge 命名以保持兼容性。产品名称现在是 AgentBridge Local。

文档

• 中文 README

• 故障排除

• 好的首个问题

• GitHub 发布检查清单

• 发布说明 v0.1.0-alpha

• 演示脚本

维护者交接文档：

1. PROJECT_MEMORY.md - 长期项目记忆和当前发布状态。

2. AGENTS.md - 代理规则、协作工作流和命令。

3. docs/HANDOVER_STATUS.md - 简短当前交接摘要。

4. docs/OPEN_TASKS.md - 待办工作和风险。

5. docs/RELEASE_VALIDATION.md - 干净的 Windows 验证检查清单。

6. docs/modules/multi-agent-dispatch.md - MiMo / Reasonix 多代理设计说明。

贡献

本项目特别需要：

• 干净的 Windows 10/11 安装程序和便携 ZIP 验证。

• Codex MCP 设置示例。

• MiMo 和 Reasonix 任务流程测试。

• 管理 UI 截图和演示 GIF。

• 更安全的故障恢复报告。

• 新用户的文档修复。

• 新的本地代理适配器。

从 CONTRIBUTING.md、docs/GOOD_FIRST_ISSUES.md 和 SECURITY.md 开始。

请不要在问题或拉取请求中包含 API 密钥、令牌、MiMo 凭据、Reasonix 凭据、完整的私有日志、本地 Worktrees 或未经脱敏的个人路径。

许可证

MIT。参见 LICENSE。