NOirBRight/dsh-external-agents

dsh-external-agents

DeepSeek Harness 的 外部 Agent（Product Worker）控制面：让本机已安装的 Codex、Claude Code、Cursor Agent、Antigravity CLI 作为一次性外部 Agent，并在设置里被发现、启用、设默认。

先读：

- 领域词汇
- 产品规格
- 阶段划分
- 决策记录
- 外部 CLI 契约
- P0 lab 陷阱

一句话

DSH 继续当编排器；第三方产品作为外部 Agent；设置页展示外部 Agent；Job Panel 展示后台任务。

不是什么

- 不是 dsh-llm-cursor 那种把 Cursor 私有接口当父模型的供应商。
- 不是再做一套 DSH 内置子代理（subagent / subagent_fork）。人话里「子代理」只指那些。
- 不是多 Agent 编排器（Orca / 委员会）。

当前进度

P0 已在 lab 验收：Codex 前台+后台，Claude Code 在仓库本地 sonnet 下前台通。

P0–P3 已在 lab 接线。技能 delegate-product-worker 只路由、不 spawn。

Plan

本插件不拥有 Plan UI。外部 Agent 的 Plan 交接需要 DSH 官方提供已命名的委托 Plan 归属 seam；在该 seam 出现前，Plan 审查与执行完全由 DSH 内置能力负责。

开发与 lab 验证

本机验收装进 dsh-lab（DSH_HOME=~/.dsh-lab，GUI http://127.0.0.1:3082），不要改正在跑的 dsh-web。

标准 pnpm check 在本插件的独立 checkout 中完成 build、test 与 pack gate。

pnpm install
pnpm check
npm pack --ignore-scripts
DSH_HOME=~/.dsh-lab dsh plugin --profile web add ./dsh-external-agents-0.2.1.tgz
systemctl --user restart dsh-lab.service

lab 安装必须使用 pack 后的 artifact；不要写源码 checkout alias、手工 symlink 或直接修改 profile bundle 清单。依赖 store 不完整时先完成正常安装，再重新打包验收。

装上之后，官方预设里的 tool-subagent-codex / tool-subagent-claude-code 保持 disabled: true。模型看到的是本插件在宿主平面注册的同名工具。

P0 配置

默认（本仓库 cordis.patch.yml）打开四个 Adapter：

- id: external-agents
config:
adapters:
codex:
enabled: true
model: gpt-5.6-luna
claude-code:
enabled: true
model: sonnet
cursor:
enabled: true
model: auto
antigravity:
enabled: true
model: gemini-3.7-flash-high
env: {}
defaultAdapter: codex

每个已启用 Adapter 必须填写去掉首尾空白后的非空 model；已禁用 Adapter 可以省略 model。env 只传给该外部 Agent。用户可以自己填 HTTPS_PROXY 等；本插件不内置、不公布任何代理端点。

关掉某一个：在 profile 的 cordis.patch.yml 覆盖整份 config，把对应 enabled 设为 false。下一轮模型请求不再看到那把工具。

后台任务出现在会话头 Job Panel（kind: subagent），不要找第二套任务 UI。

正式版安装（Latest）

External Agent control plane for Codex, Claude Code, Cursor Agent, and Antigravity adapters. 正式成品只支持 DeepSeek Harness 0.1.2-alpha.1；发布包只包含构建后的 Host/Client 产物，不包含兄弟仓库源码、本机路径或 link:/workspace: 依赖。

Latest 安装命令（永久不含版本号）：

~~~sh
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-external-agents/releases/latest/download/dsh-external-agents.tgz
~~~

固定版本安装命令：

~~~sh
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-external-agents/releases/download/v0.2.1/dsh-external-agents.tgz
~~~

更新、卸载与验证：

~~~sh
更新到最新 Release
dsh plugin --profile web add --force \
https://github.com/NOirBRight/dsh-external-agents/releases/latest/download/dsh-external-agents.tgz
验证加载与版本
dsh plugin --profile web list
dsh plugin --profile web doctor
只卸载本插件
dsh plugin --profile web remove dsh-external-agents
~~~

配置入口：Web 使用「设置」中的本插件页面；Host-only 插件使用 profile 的 dsh.profile.bundles 配置。先复制本 README 的最小 YAML/JSON 示例，再填写凭据或后端地址。

回滚：重新执行固定版本 v0.2.1 命令，确认插件列表后只重启一次 Web 服务。失败时查看 journalctl --user -u dsh-web.service 与 dsh plugin --profile web doctor，不要把源码 checkout 写入 production profile。

Release 与完整性：v0.2.1 · SHA256SUMS。