Skip to main content
Glama
README.md
# Agent Hub

A local Codex plugin and MCP server for **Antigravity**, **DeepSeek Harness (DSH)**, **Claude Code**, and **OpenCode**.

持久任务、实时公开事件、文件变更、会话续聊、进程树取消,以及可配置的执行权限。当前版本:**0.2.0 Preview**。仓库根目录附带 .agents/plugins/marketplace.json 本地插件市场描述。当前发布目标为 Windows;其他系统尚未完成端到端验收。

## 安装

需要 Python 3.11+,以及至少一个已经安装并登录的后端 CLI。

```powershell
python install.py --register-codex --root "C:\Projects"
```

也可以双击 `Install-Agent-Hub.cmd` 安装运行环境,再使用上面的命令注册。脚本创建本项目的 `.venv`、安装依赖、生成本机 `.mcp.json`,保留 Codex 配置中的其他服务。之后重新加载 Codex,并双击 `Start-Agent-Hub.cmd` 打开工作台。

CLI 不在 PATH 时可以显式指定:

```powershell
python install.py --register-codex --root "C:\Projects" --agy-exe "D:\Tools\agy.exe" --claude-exe "D:\Tools\claude.exe"
```

支持 `--opencode-exe`、`--dsh-exe`;重复 `--root` 可设置多个允许的任务目录。代理只在显式传入 `--proxy` 时写入本地配置,不硬编码代理端口。默认复用 CLI 已有登录、供应商和环境配置;本项目不附带账号或供应商密钥。

插件展示与技能位于 `.codex-plugin/plugin.json`、`skills/`;后台服务位于本仓库。将根目录作为本地插件源时,先运行安装脚本生成该电脑的 MCP 配置。若宿主同时加载插件内 MCP 与全局 MCP,只保留一个 `local_agents` 注册以免工具重复。脚本注册是可独立使用的完整 MCP 安装方式;不同 Codex 版本的插件导入 UI 仍需用户环境确认。

## 权限设置

默认 **最大权限(full)**,按操作者选择执行。工作台右上角 **权限设置** 可修改全局和各后端默认值;创建任务时也可以单独覆盖。

| 后端 | full | native |
|---|---|---|
| Antigravity | CLI 跳过工具审批 | 遵循 CLI 配置;无头模式拒绝后可在面板批准继续本任务 |
| DSH | 通过 ACP 原生权限选项自动授权 | 请求通过工作台传回原 worker |
| Claude Code | CLI 跳过工具审批 | 遵循 CLI 配置;无头审批被拒时需调整设置后续聊 |
| OpenCode | 仅为该进程注入允许工具的配置 | 保留既有 CLI 权限配置,支持工作台审批 |

权限在任务提交时保存。运行中的任务保留原权限,后续轮次使用当前设置。`native` 不是固定只读模式,其权限由后端自己的配置决定。`full` 不授予 Windows 管理员权限,也不突破 OS 或上游供应商限制。

Antigravity 的无头 CLI 没有原生单工具批准管道:面板明确标记“批准并继续本任务”,批准后允许该任务剩余步骤。Claude Code 当前没有面板到原 worker 的审批回复管道,不能将它的拒绝描述为可直接单击恢复。

## 后端

| ID | 默认模型 | 调用方式 |
|---|---|---|
| `antigravity` | `gemini-3.8-flash-high` | agy stream-json |
| `deepseek-harness` | 从当前已配置路由选择 | 桌面版捆绑 CLI 的 ACP |
| `claude-code` | `sonnet` | Claude Code CLI stream-json |
| `opencode` | `banban/deepseek-v4.1-flash` | OpenCode 本机服务/SSE |

DSH 优先选取当前桌面默认路由(若可解析),否则选取已配置的 DeepSeek 路由;可通过模型字段或 `DSH_MODEL` 覆盖。OpenCode 当前电脑实测存在旧数据库缺表及供应商令牌失效问题,详见 VALIDATION.md;更换测试数据目录可以设置 AGENT_HUB_OPENCODE_DATA,不会自动迁移旧数据库。默认模型不保证账号额度及上游可用性;模型字段可以覆盖。DSH 使用原桌面配置中的模型路由及凭据引用。只检测到可执行文件不代表已登录。Claude Code npm 包、原生安装均可探测,亦支持 `CLAUDE_EXE`。

## 使用

通过 Codex 调用 `hub_backends`,再用 `task_submit` 提交目标、工作目录和验收标准。用 `task_wait` 等待、`task_result` 读取结果、`task_artifacts` 查看文件变更,最后独立验收。`task_followup` 续接会话;正在执行时会排队,不能中途强插模型轮次。`hub_settings` 读取默认权限,`hub_dashboard` 打开面板。

独立后台服务不会因为 MCP 断开而结束;机器或服务重启后保留历史,旧进程无法原地恢复,任务标记中断。最多两个并行 worker,重叠目录串行。取消会结束进程树,已发生的文件修改保留。

任务根目录白名单仅限制提交目录,不是 OS 文件沙箱。产物根据执行前后快照计算;并发人工修改也可能进入差异,不构成作者归属证明。公开流不转发隐藏思考。

## 验证

```powershell
.venv\Scripts\python.exe -m unittest discover -s tests -v
.venv\Scripts\python.exe verify_protocol.py
.venv\Scripts\python.exe tools\release_check.py
```

离线测试不调用模型。协议检查会连接/启动本地服务,但不发起模型任务。真实账号验收会使用额度,应独立执行:

```powershell
.venv\Scripts\python.exe tools\smoke_backends.py --backend antigravity --backend deepseek-harness --backend claude-code --root "C:\Projects\hub-smoke" --report ".state\smoke.json"
```

它检查创建文件、会话 ID、续聊追加及文件内容。实测范围见 `VALIDATION.md`。

## 数据与卸载

`.state` 保存任务数据库、服务令牌和日志;`local-config.json`、`.mcp.json` 保存该电脑的路径配置。它们都被 Git 忽略。不要把整个目录直接压缩发布;使用 `tools/package_release.py` 从 Git 文件清单生成发布包。

```powershell
.venv\Scripts\python.exe install.py --unregister-codex
```

卸载只移除该 checkout 拥有的全局 MCP 注册,保留任务历史。请先结束运行任务并停止服务,再删除运行环境。迁移历史可以用 `--state "已有状态目录"`。安装脚本在私有 `.state` 中保存被替换的注册/配置备份,备份不可进入发布包。

许可证:MIT。后端 CLI 和模型服务分别遵循各自许可及条款,仓库不分发这些二进制或凭据。