前言¶
用 DeepSeek Harness（DSH）跑智能體，繞不開模型配置。如果你此前一直用 cc-switch 管理 Claude Code / Codex 的中轉商配置，這些現成的供應商在 DSH 裏並不能直接使用——常規做法是在 DSH 裏重新錄入一遍 API 地址和密鑰，再手工搭好路由。
dsh-cc-switch 要解決的就是這件事：把 cc-switch 裏已管理的供應商配置一鍵同步成 DSH 的模型路由，而且不要求 DSH 上已配置任何模型。換句話說，一個全新的、零模型的 DSH 實例，也能靠它從你已有的供應商起步。DSH 的理念是「一切皆插件」，模型接入這件事同樣可以交給插件完成。
下面介紹這個插件的功能、原理與用法。
這是什麼¶
dsh-cc-switch 是一個由 LKRCharon 維護的社區插件，以 MIT 協議開源。它讀取本地 cc-switch 的 SQLite 數據庫，把其中的 Claude Code / Codex 中轉商配置映射爲 DSH 的 llm-pi-ai 模型路由。
需要說明：這是非官方插件，與 cc-switch 或 DeepSeek 均無關聯。
工作原理¶
插件的實現有三個要點。
1、以只讀方式打開本地 cc-switch SQLite 數據庫，從不修改 cc-switch 本身。
2、通過 DSH settings seam 把供應商映射到 llm-pi-ai 路由。改動在下一次請求即生效，無需重啓。
3、API 密鑰通過 DSH credential seam 以引用形式存儲（CCS_*_KEY），密鑰值不會出現在設置、工具輸出或模型上下文中。
路由映射規則¶
| cc-switch 供應商 | DSH 路由 |
|---|---|
| codex 供應商 | openai-responses / openai-completions |
| claude 供應商 | anthropic-messages |
| 官方 OAuth 供應商 | 跳過（pi-ai 無法 OAuth） |
| gemini / claude-desktop | 暫跳過（roadmap） |
安裝與啓用¶
先執行安裝命令，再重啓 DSH：
dsh plugin --profile web add dsh-cc-switch
插件默認 syncOnStart: true，DSH 啓動時自動同步一次，cc-switch 裏的供應商會立即出現在模型選擇器中。
如果你的 DSH 還從未啓動過，也可以先在終端直接同步，無需安裝任何東西：
npx dsh-cc-switch # 立即同步
npx dsh-cc-switch --dry-run # 僅預覽
四種同步方式¶
同步可以在四個入口觸發，按需選用：
1、終端 CLI：運行 npx dsh-cc-switch 立即同步，加 --dry-run 僅預覽。無需安裝，首次啓動 DSH 之前也可用。
2、啓動自動同步：syncOnStart 默認開啓，DSH 啓動時插件自動執行同步。
3、人類命令：在 composer 輸入 /ccswitch 同步，/ccswitch dry 僅預覽。需要 DSH 正在運行。
4、代理工具：讓代理調用 ccswitch_sync 工具完成同步。需要有可用模型且 DSH 正在運行。
配置項¶
可以在 profile 的 cordis.patch.yml 中按行覆蓋配置。例如關閉啓動自動同步：
- id: cc-switch
config:
syncOnStart: false
全部可配置項及默認值如下：
| 配置項 | 默認值 | 說明 |
|---|---|---|
dbPath |
~/.cc-switch/cc-switch.db |
cc-switch 數據庫位置 |
prefix |
ccs- |
路由 id 前綴 |
apps |
['codex', 'claude'] |
要同步的應用類型 |
syncOnStart |
true |
插件加載時執行一次同步 |
適用場景與注意事項¶
適合兩類場景：
- 已經在用 cc-switch 管理 Claude Code / Codex 中轉商，想把這批配置直接帶進 DSH；
- 全新的 DSH 實例、還沒有任何模型配置，想從已有供應商起步。
使用前注意：
- 這是非官方社區插件，以當前 dsh 進程的權限運行，會讀取本地 cc-switch 數據庫。安裝前建議先查看源碼與許可證，倉庫地址見文末。
- 插件已針對 2026-08 的 cc-switch DB schema 與 DSH v0.1 developer preview 測試。兩邊迭代都快，建議鎖定版本。當前版本 0.1.0，要求 Node >= 22.13，依賴 @deepseek-ai/dsh-tools ^0.0.1-rc.1 與 yaml ^2.6.0。
- 在 cc-switch 中已刪除的供應商，暫不會從 DSH 設置中自動移除，需要在 Settings → Models 手動刪除殘留的
ccs-*路由。 - 官方 OAuth 供應商會被跳過；gemini 映射、Models 設置頁的「從 cc-switch 導入」按鈕、DB 變更監聽均爲計劃中的功能。
小結¶
經過上面的步驟，cc-switch 裏管理的供應商就能直接變成 DSH 的模型路由：不需要重新錄入密鑰，也不要求實例上已有模型。對同時使用 cc-switch 和 DSH 的人來說，這是一條現成的接入路徑。
- 插件目錄頁：https://www.skillhub.cn/plugins/LKRCharon/dsh-cc-switch
- GitHub 倉庫：https://github.com/LKRCharon/dsh-cc-switch
（注：目錄頁來自獨立運營的社區插件目錄，與 DeepSeek 或幻方無官方從屬關係。）
