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 执行路由

在干净的官方 DSH 0.1.1-rc.2 上，Plan Review 没有公开、安全的外部交接 seam。本插件因此失败关闭：外部 Agent 目标会显示但不可选，不回答或取消 Plan 问题，也不启动外部 Agent。既有 plan.prepare / plan.commit 名称仅为兼容保留并始终返回 fail-closed 错误。继续在 DSH 执行仍走官方批准答案；设置、探测、普通前台/后台委托和 Jobs 不受影响。

与 dsh-composer-picker v0.1.3 双装时，本插件以 priority -6 拥有顶层 conversation.composer 路由卡，并从包根导出插件拥有的 external-agents.plan-review.continue-in-dsh child-slot 契约。Composer 子项拥有 ModelSelection 草稿和官方 ModelDirectory 提交，并通过 plugin-owned registerCommit seam 注册执行提交；External Agents 只编排“Composer 提交模型 → 回答 Plan”。提交失败保留 Plan 并允许重试；无 Picker 时沿用当前 DSH 模型。rc.2 没有原子“选模型并回答”seam：若另一客户端在两步之间结算问题，模型切换无法由插件回滚；批准后的显式拒绝成为本地终态，transport 异常保持可重试。

完整 shadow exit_plan_mode 当前未获 ADR 授权，不实现。未来只有 Core 提供公开、可验证的 delegated Plan resolution seam，或另开 ADR 批准 shadow 方案后，才恢复外部 Plan 交接。见 ADR 0007。

安装（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 compat:check，打包并组合加载本插件与 composer-picker；默认从相邻的 ../dsh-composer-picker 读取兼容 checkout，工作区布局不同时用 DSH_COMPOSER_PICKER_REPO=/absolute/path/to/dsh-composer-picker pnpm compat:check 指定。该路径只用于跨包验证，不会加入运行时依赖。

pnpm install
pnpm check
npm pack --ignore-scripts
DSH_HOME=~/.dsh-lab dsh plugin --profile web add ./dsh-external-agents-0.1.0.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）打开 Codex 与 Claude Code：

- id: external-agents
  config:
    adapters:
      codex:
        enabled: true
      claude-code:
        enabled: true
      cursor:
        enabled: true
      antigravity:
        enabled: true
        env: {}
    defaultAdapter: codex

每个 Adapter 的 env 只传给该外部 Agent。用户可以自己填 HTTPS_PROXY 等；本插件不内置、不公布任何代理端点。

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

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