前言¶
DeepSeek Harness（DSH）支持通過子智能體把任務委派給外部 Agent Client Protocol（ACP）客戶端。官方提供 @deepseek-ai/dsh-subagent-acp 作爲 provider，但多目標時往往要手改 YAML、覈對各 CLI 的啓動參數與模型傳法，連通性也要自己試。
下面介紹社區插件 dsh-subagent-acp-ui（維護者 NewSpringWei，分類：工作流）。它在官方 provider 之上增加配置頁、握手檢測和路由 skill，不自行實現 ACP 客戶端；每個目標仍掛載一個官方 provider 與一個官方 dsh-tool-subagent 實例，協議行爲與官方一致。
這是什麼¶
一句話：dsh-subagent-acp-ui 是 DSH 的 ACP 子智能體體驗層——基於官方 @deepseek-ai/dsh-subagent-acp 接入多個 ACP agent，提供配置頁、連通性檢測和路由 skill。
- 倉庫：https://github.com/NewSpringWei/dsh-subagent-acp-ui
- 社區目錄：https://www.skillhub.cn/plugins/NewSpringWei/dsh-subagent-acp-ui
- 當前 package 版本：
0.1.0（資料中的推薦安裝 tag 爲v0.1.0） - 許可證：MIT
- 運行環境：
engines.dsh爲>=0.2.0-rc.2 <0.3.0
DSH 生態主張「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
配置與 UI¶
安裝並重啓實例後，在「插件 → ACP 子智能體」裏添加目標。選擇 README 中「已驗證的 agent」時，插件會自動填好啓動命令與模型傳法；也可直接寫 YAML 配置。
插件還提供入口放置卡片：左側欄、設置導航、插件頁等界面各有一個實時開關，可配置插件出現在哪些位置，無需額外保存按鈕（見倉庫英文 README）。
每個啓用目標產生的產物¶
| 產物 | 名稱 |
|---|---|
| 子代理 provider | acp_<目標> |
| 委派工具 | subagent_acp_<目標> |
| 精確命令 | /acp-<目標> <任務> |
對話內工具與 skill¶
acp_targets：在對話裏增刪改查目標；test做免費握手，test mode="verify"會消耗少量 token 做真實驗證。acp-subagent-routingskill：說明何時委派、如何拆分任務、失敗時如何分析。
已驗證的 agent¶
OpenCode、Qoder CLI、MiMo Code、CodeBuddy Code、Kimi Code、MiniMax Code。適配說明見倉庫 adapters/README.md，預設數據在 adapters/agents.json。
適配清單在線更新¶
加或改 agent 不必等插件發版：
- 插件啓動時從
adaptersUrl拉取清單（默認 jsDelivr 鏡像），按id合併到內置預設。 - 緩存：
~/.dsh/subagent-acp-ui/adapters-cache.json，升級插件不會清除。 - 手動刷新：
POST /acp-ui-refresh。 - 需要即時生效時，將
adaptersUrl換成帶 commit 的地址以繞過 jsDelivr 緩存。
只有源碼改動才需要 bump 插件版本。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前應自行查看倉庫源碼與 MIT 許可證，確認可接受後再加入 profile。
推薦鎖定版本安裝：
dsh plugin --profile <profile> add github:NewSpringWei/dsh-subagent-acp-ui#v0.1.0
或跟隨 main 分支：
dsh plugin --profile <profile> add github:NewSpringWei/dsh-subagent-acp-ui
裝好後重啓實例，再到「插件 → ACP 子智能體」配置目標。
本地開發可將 file: 指向 checkout 下的 code 目錄：
dsh plugin --profile <profile> add file:<path-to-plugin>/code
典型用法¶
在 UI 或 YAML 裏添加目標¶
每個目標需要：可執行文件、ACP 啓動參數，且對應 CLI 已完成登錄。args / env 中可寫 {model} 佔位符，保存時用 model 字段展開；model 留空則省略該參數。
示例（來自 README）：
- id: subagent-acp-ui
name: dsh-subagent-acp-ui
config:
targets:
- name: opencode
command: opencode
args: ['acp']
model: opencode/glm-5.3-flash-free
env:
OPENCODE_CONFIG_CONTENT: '{"model":"{model}"}'
委派任務¶
對名爲 opencode 的目標，可用精確命令：
/acp-opencode <任務描述>
或在主會話中通過工具 subagent_acp_opencode 委派。具體何時委派、如何切分任務，可參考插件註冊的 acp-subagent-routing skill。
檢測連通性¶
通過 acp_targets 的 test 做握手；需要確認端到端可用時使用 test mode="verify"（會花少量 token）。
適用場景與限制¶
適合誰： 已在 DSH 中使用官方 ACP subagent provider，希望同時掛多個 ACP CLI（如 OpenCode、Kimi Code 等），並希望通過頁面管理目標、做握手/驗證、減少手改 YAML 的開發者。
限制（官方 provider 既定行爲，本插件不繞過）：
- 不能在單次調用時選模型：模型按目標全局固定。
- 不能續跑：每次委派都是一次性運行。
- 沒有進程池：每次委派都要承擔進程啓動與握手成本。
結尾¶
dsh-subagent-acp-ui 把「多 ACP 目標 + 官方協議棧」落到可操作的配置頁、檢測工具和路由 skill 上；若你已在 DSH 裏用子智能體委派，可先鎖定 v0.1.0 安裝，在「插件 → ACP 子智能體」裏從已驗證 agent 起步。
