前言¶
DeepSeek Harness（DSH）擅長用插件擴展會話界面和模型提供方，但若要在同一會話裏驅動 Claude Code、Codex、PI 等命令行 Agent，以往往往要在終端與 DSH 之間來回切換，工具調用、審批和改動也不走同一套界面。dsh-ccgui 把多種 Agent CLI 註冊爲 DSH 的模型提供方：在輸入框旁選一個 CLI，對話、工具卡片和（在支持時）審批流程仍走 DSH 原生 UI，費用與賬號則沿用各 CLI 自己的配置。
這是什麼¶
dsh-ccgui（倉庫 zhukunpenglinyutong/dsh-ccgui）由社區維護者 zhukunpenglinyutong 發佈，在 DSH 插件目錄中歸類爲客戶端插件。它在 DeepSeek Harness 裏直接接入 Claude Code、Kimi、Codex、PI、OMP、OpenCode 等 Agent CLI，並附帶變更面板、啓動腳本、工作區文件快捷引用等界面增強。安裝與使用以插件倉庫 README 爲準；社區目錄頁見 SkillHub 上的 dsh-ccgui。
環境與依賴¶
使用前需滿足：
- DSH 版本：
>=0.2.2-rc.1且<0.3.0（與package.json中engines.dsh一致）。 - 對應 CLI 已安裝並完成登錄（部分 CLI 可通過
npx由插件自動拉取，見下文功能表）。 - 插件以當前 DSH 進程權限運行；DSH 沙箱管不到 CLI，CLI 自行決定是否詢問權限，安裝前宜閱讀源碼與 MIT 許可證。
核心功能¶
切換 CLI 與模型¶
輸入框 + 右側有 CLI 菜單；選中後還有模型菜單，列出該 CLI 真實可用的模型，第一項爲默認模型，超過 4 項可搜索，中途換模型下一條消息生效。不在 CLI 上的會話（例如 DeepSeek）只顯示 DSH 自帶提供方與推理等級。CLI 只能在發第一條消息前切換，要換 CLI 需新建會話。
README 功能對照表（節選）：
| 能力 | Claude Code | Kimi CLI | Codex CLI | PI CLI | OMP CLI | OpenCode |
|---|---|---|---|---|---|---|
| 真實賬號驗證 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
免安裝（npx 自動拉取） |
支持 | 支持 | 支持 | 支持 | 需先裝 omp |
需先裝 opencode |
| 會話中途換模型 | 支持 | 尚未驗證 | 支持 | 支持 | 支持 | 支持 |
標準模式與 PTC 模式均可用；PTC 下 CLI 工具調用會包成 run_code，長時構建或測試建議切回標準模式。
變更面板與工作區工具¶
右側欄「變更」按已暫存、未暫存、未跟蹤分組，支持暫存、撤銷、提交、推拉與分支切換，並可查看行內 diff。會話標題欄可保存按工作目錄區分的啓動腳本，在獨立終端標籤中執行。工作區文件中可右鍵「添加到對話」，將 @路徑 插入輸入框；標題欄終端按鈕可開關右側欄終端。
會話狀態與設置¶
會話列表項前顯示所用 CLI 圖標，回合進行中旁有狀態指示。DSH 設置中的「CC GUI 設置」可調整 CLI 菜單順序與開關，並單獨關閉插件增加的界面交互以恢復 DSH 原樣；DeepSeek 作爲內置提供方始終保留。設置保存在瀏覽器本地。
安裝與啓用¶
圖形界面¶
- 在 DSH 左側欄打開「插件」，點右上角「添加插件」。
- 輸入
dsh-ccgui，點「安裝」。 - 提示重啓時，應完全退出 DSH（例如 macOS 上 Cmd+Q）再打開；不要僅點「立即啓用」，否則新舊代碼混在同一進程可能啓動失敗。
- 新建會話，在輸入框旁選擇要使用的 CLI。
命令行¶
桌面版需先完全退出應用，再用內置 dsh 安裝；命令行版（dsh web）使用 profile web：
# DSH 桌面版
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-ccgui@1.0.2
# DSH 命令行版（dsh web）
dsh plugin --profile web add dsh-ccgui@1.0.2
卸載時將 add 換爲 remove dsh-ccgui。從源碼安裝時先 pnpm install && pnpm run build，在「添加插件」中填本地倉庫路徑（命令行安裝時把 dsh-ccgui@1.0.2 換成該路徑）。
典型用法¶
完成安裝並重啓後，新建會話，在 CLI 菜單中選擇已登錄的 Agent（例如 Claude Code 或 Codex CLI），在模型菜單確認模型，即可像與 DeepSeek 對話一樣發送消息。工具調用與改動摘要走 DSH 界面；若使用 Claude Code 手動模式或 OpenCode 的權限配置，相關操作會走 DSH 審批卡片。
讓 Claude Code 或 OpenCode 先詢問再執行時，可在項目配置中設置（示例來自 README）：
Claude Code（.claude/settings.json）：
{ "permissions": { "defaultMode": "default" } }
OpenCode（opencode.json）：
{ "permission": { "edit": "ask", "bash": "ask" } }
接入其他 CLI¶
在 profile 的 cordis.patch.yml 中爲 dsh-ccgui 配置 agents 列表；config 會整體替換默認項，因此需把默認 CLI 一併寫明。README 提供了含 npx 固定版本號的示例；自定義項可增加 { id: my-cli, name: My CLI, command: my-cli, args: [acp] } 等形式。
審批、停止與已知限制¶
README 強調：不同 CLI 對寫文件、執行命令與「停止」的行爲不同（例如 Codex 默認不詢問直接執行，按停止後已啓動命令可能仍在後臺運行）。後臺命令通常在會話關閉或 DSH 退出時結束。
使用前宜知曉的主要限制包括：不支持 /compact、fork、回滾與運行中插話；不轉發圖片及部分 DSH 內部提醒；上下文用量顯示可能不準；每個打開會話佔用一個 CLI 進程。/model 不宜在同一會話內在 DeepSeek 與 CLI 之間切換，以免上下文丟失。
適用場景與注意¶
適合已在 DSH 中開發、又希望統一界面驅動多種 Agent CLI 的開發者：同一工作區內完成對話、diff 與常用腳本啓動，而不必單獨開多個終端會話。使用前請確認 DSH 版本落在 README 要求範圍內，併爲各 CLI 單獨配置權限與賬號；社區插件目錄（SkillHub）與 DeepSeek / 幻方無官方從屬關係，版本與星標等信息以 GitHub 倉庫頁面爲準（README 展示 CI、覆蓋率與許可證徽章；倉庫當前在 package.json 中爲 1.0.4，安裝示例仍指向 dsh-ccgui@1.0.2，可按發佈渠道選擇對應版本號）。
結尾¶
dsh-ccgui 把多種 Agent CLI 接到 DSH 的模型提供方機制上，用菜單切換後端、用原生 UI 承接工具與變更，是「一切皆插件」思路下的客戶端增強。進一步說明與限制列表見 GitHub README，目錄入口見 SkillHub 插件頁。
