前言¶
DeepSeek Harness (DSH) 負責模型推理路由與對話編排，而 cc-switch 負責供應商配置與用量查詢。兩者在數據層面通常是割裂的：在 cc-switch 中配置的模型和供應商，無法直接在 DSH 中使用，且用量狀態難以在 DSH 界面中查看。dsh-switch 是一個 DSH 插件，其核心作用是作爲橋接層，將 cc-switch 的數據庫內容實時鏡像到 DSH 的設置命名空間中，並同步展示供應商的用量信息。
核心功能¶
該插件主要實現以下功能：
-
實時同步配置
插件通過文件監聽機制監視 cc-switch 的數據庫（~/.cc-switch/cc-switch.db）。當你在 cc-switch 中保存配置時，插件會將所有可用的供應商和模型鏡像到 DSH 的llm-pi-ai設置命名空間。同步過程通過 DSH 的事件總線（llm/adapters-updated）觸發，模型在保存後約一秒內即可在 DSH 中使用，無需重啓應用。 -
全類型供應商支持
插件支持將多種類型的供應商轉換爲 DSH 路由：- Claude：映射爲
anthropic-messages。 - Codex/GPT (API Key)：通過
wire_api映射爲openai-responses或openai-completions。 - Gemini 形狀中繼：映射爲
openai-completions。 - OpenClaw：直接使用 DSH 形狀配置。
- 對於無法轉換爲 DSH 路由的供應商（如 OAuth 登錄類或原生 Gemini 端點），插件會列出跳過原因。
- Claude：映射爲
-
用量可視化
插件在 DSH 的會話輸入欄模型選擇器旁顯示實時用量徽章。當模型所屬供應商配置了用量查詢時，徽章會顯示餘額或套餐窗口。- 餘額模板：支持
balance模板（DeepSeek、StepFun、SiliconFlow、OpenRouter、Novita AI 等）和general/newapi腳本。 - 套餐模板：支持
token_plan（火山方舟、MiniMax）。 - 查詢結果在客戶端緩存，切換模型時零延遲更新。
- 插件的設置卡片會爲每一個啓用了用量查詢的供應商顯示獨立的用量行。
- 餘額模板：支持
安裝與配置¶
使用該插件前，需滿足以下環境要求：
* 本地已安裝 cc-switch（數據庫路徑爲 ~/.cc-switch/cc-switch.db）。
* DSH 版本 >= 0.1.5-rc.1。
* Node.js 版本 >= 24。
安裝命令如下：
dsh plugin --profile desktop add github:a981008/dsh-switch
安裝完成後，重啓 DSH Desktop 即可生效。
使用示例¶
- 在 cc-switch 中配置供應商（如 Claude、GPT 等）和模型，並設置用量查詢腳本。
- 保存 cc-switch 配置。插件會自動將新的供應商和模型同步到 DSH。
- 在 DSH 的會話中選擇已同步的模型。如果該供應商配置了用量查詢，輸入欄模型選擇器旁會出現實時用量徽章。
- 在 DSH 插件的設置卡片中，可以查看所有供應商的用量狀態。
注意事項¶
- 隱私安全：插件以只讀模式打開 cc-switch 數據庫，API Key 值不會發送到瀏覽器，設置文件中只引用名稱，不保存明文。錯誤信息中的憑據也會被脫敏。
- 認證限制：OAuth/訂閱登錄類供應商（如 ChatGPT、Gemini 官方）無法用於 DSH 路由認證，會被跳過。
- 默認模型跟隨：在 cc-switch 中切換“當前供應商”時，DSH 的
agent-default-model會自動跟隨。但如果該默認值已固定指向非同步路由（如自定義供應商或第三方包裝），則不會被覆蓋。 - 許可證：MIT License。
結語¶
dsh-switch 通過消除 DSH 與 cc-switch 之間的數據隔閡，實現了配置的自動同步與用量的即時監控。對於同時使用 DSH 進行推理管理和 cc-switch 進行供應商管理的用戶，該插件提供了必要的連接層，減少了手動維護成本。
