MIT 的 DSH 外掛,把外部 Agent CLI(Claude Code、Kimi、Codex、PI、OMP、OpenCode、CodeBuddy)註冊成 ACP 模型提供者,並補上模型選單、變更面板、worktree 與啟動腳本。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-12
授權條款
MIT
01它能幫你完成什麼?
在 DSH 輸入框裡直接和 Claude Code / Codex / PI / OMP / OpenCode 對話
一個 ACP 工作階段:工具呼叫、審批和改動摘要都顯示在 DSH 原生介面裡,模型選單列出該 CLI 真正可用的模型
已經訂閱某個 Agent CLI、想在一個 DSH 視窗裡同時做規劃與 CLI 執行的開發者
不離開 DSH 就能審閱 CLI 改出來的程式碼,並開出隔離的 worktree
依已暫存 / 未暫存 / 未追蹤分組的變更面板(可暫存、復原、提交、推拉、切分支,附行內 diff),以及從新分支、既有分支或 PR 建立的 Git worktree
希望在同一個側邊欄審改動、開分支的 DSH 使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- DSH `>=0.2.2-rc.1 <0.3.0`(README 快速開始寫明的版本範圍)
- 至少一個已安裝並登入的受支援 CLI;外掛沿用 CLI 自己的登入狀態,不接觸 token
- 走命令列安裝時,需要 PATH 上有 `dsh`,或用 DSH 桌面版內建的那個 `dsh`
安裝步驟
- 01
點 DSH 左側欄的「外掛」,點右上角「新增外掛」,輸入 `dsh-ccgui` 後點「安裝」
- 02
提示重啟時用 Cmd+Q 完全結束再開啟——README 明確說不要點「立即啟用」,新舊程式碼混在同一個行程裡會啟動失敗
- 03
新建工作階段,點輸入框 `+` 右邊的 CLI 按鈕選一個 CLI
- 04
命令列方式:`dsh plugin --profile web add dsh-ccgui@1.0.2`;桌面版用 `"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-ccgui@1.0.2`
$ dsh plugin --profile web add dsh-ccgui@1.0.2
驗證整合成功
作者未說明
復原
- 在同一條指令裡把 `add …` 換成 `remove dsh-ccgui` 即可解除安裝
03DSH 整合程度與能力邊界
把外部 Agent CLI 註冊成 DSH 的模型提供者(ACP 工作階段),工具卡片、審批卡片與變更摘要仍走 DSH 原生介面
把外部 CLI 當成模型提供者
輸入框旁選單裡選中的 CLI→一個 ACP 工作階段:工具全部由 CLI 自己執行,DSH 端只做記錄
每個開啟的工作階段佔一個 CLI 行程,直到工作階段關閉或 DSH 結束來自 ACP configOptions 的模型選單
目前選中的 CLI→該 CLI 上報的模型清單,第一項是它自己的預設模型,超過 4 項可搜尋
每次啟動 DSH 後第一次用到某個 CLI 會短暫啟動它詢問模型;暫存工作階段放在 `ccgui/model-probe`,OMP 每次會留下約 4KB 記錄變更面板、啟動腳本、檔案與終端機
目前工作區→附行內 diff 的暫存 / 復原 / 提交 / 推拉 / 切分支,依工作目錄記住的啟動指令,從檔案樹插入 `@路徑`,以及右側欄終端機
啟動腳本在獨立的終端機分頁執行,再點一次會先關掉上一次的CC GUI 設定頁
左側欄底部的設定入口→CLI 選單的順序與開關、每項介面互動的個別開關,以及依版本分頁的版本記錄
設定存在瀏覽器本機,不會寫進 profile
04適合誰?何時不該用?
適合
- 已經訂閱某個 Agent CLI、想在一個 DSH 視窗裡同時做規劃與 CLI 執行的開發者
- 希望在同一個側邊欄審改動、開分支的 DSH 使用者
不適合
- DSH 的沙箱管不到 CLI:每個 CLI 自己決定哪些操作要詢問,它放行的操作不會彈 DSH 審批卡片。要攔住操作必須設定 CLI 自己的權限。
- 不支援 `/compact`、fork、回滾和執行中插話;執行中送的訊息會排隊到這一輪結束。
- README 針對 DSH `>=0.2.2-rc.1 <0.3.0`,其他宿主版本未宣告支援。
- DSH 啟動 CLI 時會移除名稱含 KEY、PASSWORD、SECRET、TOKEN 的環境變數,`ANTHROPIC_API_KEY` 這類變數要寫在 agent 設定的 `env` 裡。
- 預設的 Claude Code 項目經 claude-agent-acp 與 Claude Agent SDK 執行;Anthropic 條款要求以 Agent SDK 開發的產品使用 API Key,不允許代使用者轉送訂閱憑證,散布帶該預設項目的版本前需自行確認。
05相容性、維護與安全提醒
- DSH 的沙箱管不到 CLI:每個 CLI 自己決定哪些操作要詢問,它放行的操作不會彈 DSH 審批卡片。要攔住操作必須設定 CLI 自己的權限。
- 不支援 `/compact`、fork、回滾和執行中插話;執行中送的訊息會排隊到這一輪結束。
- README 針對 DSH `>=0.2.2-rc.1 <0.3.0`,其他宿主版本未宣告支援。
- DSH 啟動 CLI 時會移除名稱含 KEY、PASSWORD、SECRET、TOKEN 的環境變數,`ANTHROPIC_API_KEY` 這類變數要寫在 agent 設定的 `env` 裡。
- 預設的 Claude Code 項目經 claude-agent-acp 與 Claude Agent SDK 執行;Anthropic 條款要求以 Agent SDK 開發的產品使用 API Key,不允許代使用者轉送訂閱憑證,散布帶該預設項目的版本前需自行確認。
MIT 原始碼;本文所有事實都來自記錄提交處的儲存庫 README,未做獨立安全稽核。
06常見問題
在 DeepSeek Harness 裡怎麼安裝 dsh-ccgui?
點 DSH 左側欄的「外掛」→「新增外掛」,輸入 `dsh-ccgui` 後點「安裝」;提示重啟時用 Cmd+Q 完全結束再開啟。README 特別說明不要點「立即啟用」,否則新舊程式碼混在同一個行程裡會啟動失敗。命令列 profile 也可以用 `dsh plugin --profile web add dsh-ccgui@1.0.2`。
支援哪些 DSH 版本和哪些 CLI?
DSH `>=0.2.2-rc.1 <0.3.0`,外加至少一個已安裝並登入的 CLI。README 涵蓋 Claude Code、Kimi CLI、Codex CLI、PI CLI、OMP CLI、OpenCode 與 CodeBuddy——其中 CodeBuddy 尚未用真實帳號驗證,預設關閉。
DSH 的沙箱和審批卡片管得住 CLI 的工具呼叫嗎?
管不住。README 明確寫「DSH 的沙箱管不到 CLI」:每個 CLI 自己決定哪些操作要詢問,它放行的操作不會彈 DSH 審批卡片。要攔住操作,得去設定 CLI 自己的權限。
工作階段中途能換 CLI 或換模型嗎?
模型能換,選單列的是 CLI 真正上報的模型,切換後下一則訊息生效;CLI 只能在送出第一則訊息前選,要換 CLI 得新建工作階段。
為什麼 CLI 工作階段不顯示 tok/s、token 用量和快取命中?
ACP 每輪只給一個累計用量,換算不成 DSH 依單次請求統計的口徑,外掛寧可隱藏也不顯示錯數字。DSH 端的上下文壓縮(包括 billion-context 這類外掛)對 CLI 工作階段同樣不生效——歷史存在 CLI 那邊,由 CLI 自己壓縮。
07相關的 DSH 工作流程
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图,输出自包含 HTML,支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库,统一智能体记忆、知识 RAG 与技能。
aitoearn
作者 yikart
面向抖音、快手、小红书和视频号的 AI 内容发布工作流,提供相关平台与 MCP 工具集成。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程,从 0 到 1 系统学习智能体工作流框架。
08資料與來源
在输入框旁选一个 CLI,就像用模型一样和它对话。工具调用、审批和改动摘要都走 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)的原生界面。
CLI 注册为 DSH 的模型提供方,不需要改 agent loop。一轮 CLI 回合跨越多个 DSH 步骤:每遇到工具调用就结束这一步,CLI 上报结果后下一步接着读。工具都由 CLI 自己执行,DSH 侧只做记录。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-12。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
