前言¶
DeepSeek Harness (DSH) 採用插件化架構，而 CLIProxyAPI (CPA) 的賬號管理通常需要單獨打開網頁控制台。dsh-cpa-switch 插件將 CPA 的管理功能集成到 DSH 的插件面板中，支持賬號餘額查看、簽到、任務執行以及賬號切換。
該項目由 cslkkl 維護，採用 MIT 許可證，目前 Star 數爲 1。安裝插件後，CPA 本體、渠道插件以及管理密鑰會由插件自動處理，無需手動準備。
安裝與啓用¶
通過 DSH 的插件管理器安裝該插件：
dsh plugin --profile <profile> add dsh-cpa-switch
插件首次啓動時會自動下載並配置 CPA 本體、渠道插件以及所需的密鑰。如果宿主機上已有 CPA，插件會嘗試複用現有配置。
核心功能¶
該插件提供以下能力：
- 賬號管理：查看餘額（可用/已用）、執行一鍵簽到與任務、切換當前使用的賬號。
- 進程託管：由插件控制 CPA 的啓動與停止，實現 DSH 開啓則 CPA 運行、關閉則 CPA 停止。
- 模型自動註冊：安裝並添加賬號後，四個渠道的對話模型會自動出現在 DSH 的模型選擇器中。
- 模型選擇限制：可以通過面板工具欄取消勾選模型，將其從對話界面的下拉列表中隱藏，但模型本身依然可用。
- 思考檔位：支持開啓或關閉模型的思考過程輸出。
使用方法¶
安裝並啓動插件後，按以下步驟操作：
- 打開面板：在 DSH 界面進入“插件” -> “CPA 切換器”。面板內會以四個標籤頁分別展示 WorkBuddy、Trae、Qoder、ZCode 四個渠道的狀態。
- 添加賬號：在每個渠道列表末尾點擊“+ 添加賬號”，系統會喚起瀏覽器進行 OAuth 登錄。
- 模型選擇：在 DSH 的模型選擇器中，模型以“渠道 · 模型名”的形式顯示。選擇模型時，只會使用當前渠道下的賬號，不會跨渠道輪詢。
- 隱藏模型：在 CPA 切換器面板的工具欄中，點擊“模型”按鈕，取消勾選不需要的模型並保存，即可在對話界面隱藏該模型。
- 思考檔位：在模型選擇器中，每個模型支持切換“關”或“開”兩個檔位。默認開啓思考過程。
配置說明¶
主要配置項包括：
manageLifecycle：控制是否由插件負責 CPA 的啓停（默認 true）。reasoningEfforts：控制模型是否可切思考檔位（默認 true）。maxOutputTokens：設置推給宿主的每模型輸出上限，用於避免 DSH 兜底截斷（默認 384000）。注意：此配置目前僅在 WorkBuddy 渠道真正生效，其他渠道可能由服務端或客戶端自行處理。autoCheckinOnStart：設置 DSH 啓動時是否自動補籤（默認 true）。
注意事項¶
- 平臺限制：當前僅支持 Windows 系統，CPA 以 Windows 可執行文件形式提供。
- 下載限制：插件首次運行需要從 GitHub Release 下載文件，需確保網絡能訪問。
- 狀態顯示：面板顯示“啓用”不代表賬號現在可用，可能因限流等原因暫時不可用，需在對話中驗證。
- 密鑰安全：管理密鑰僅保存在宿主機側，不會發送到瀏覽器，由插件代勞所有操作。
- 渠道插件更新：渠道插件不會被自動升級，面板會提示更新，需手動點擊更新以避免兼容性問題。
- 輸出上限：對於 Qoder 和 Trae 渠道，聲明輸出上限可能不會立即生效，需等待上游支持或自行調整。
總結¶
dsh-cpa-switch 通過插件化方式將 CLIProxyAPI 的管理流程融入 DSH，解決了賬號管理需要頻繁切換窗口的問題。對於需要管理多渠道 AI 賬號的用戶，它提供了一個集中化的控制面板。
- 項目主頁：https://github.com/cslkkl/dsh-cpa-switch
- 目錄頁：https://www.skillhub.cn/plugins/cslkkl/dsh-cpa-switch
