前言¶
DeepSeek Harness（DSH）的生態理念是「一切皆插件」。在使用 dsh-router 時，若需接入騰訊 CodeBuddy 族服務（包含國內版 CodeBuddy 與國際版 WorkBuddy），dsh-router-codebuddy 是必要的供應商註冊插件。該插件由開發者 CARVIN94 維護，核心功能是通過 dsh-router 向 DSH 註冊兩個供應商，提供 OAuth 輪詢登錄、模型列表獲取及 OpenAI 兼容的網關能力。
核心功能¶
該插件通過 router.suppliers 服務向核心註冊供應商，具備以下能力：
- OAuth 輪詢登錄：生成登錄鏈接，瀏覽器登錄後後臺每 5 秒輪詢一次 token，最多 5 分鐘，自動落盤憑證，無需手動粘貼回調。
- 模型列表：通過
GET /v3/config實時拉取上游模型，不可達時回退內置兜底表，支持手動添加自定義模型。 - 接口歸一（僅國際版）：針對國際版 WorkBuddy 做接口歸一處理，將
developer映射爲system，處理tool_choice對象形態，規避參數報錯。 - 連接池：多賬號管理由核心負責，本插件僅報告單個賬號的成敗與語義狀態。
- token 自動刷新：在 token 到期前 24 小時內自動使用 refresh token 刷新，失敗則繼續使用舊 token。
- 簽到領積分：每日簽到 100 積分（連續 7 天 1000 積分），核心遍歷所有賬號逐個調用。
- 積分顯示：面板顯示
get-user-resource的剩餘額度（CapacityRemain），積分持久化由核心統一處理。
安裝與啓用¶
本插件依賴 dsh-router-core 核心，安裝前請確保已安裝。安裝並啓用後，必須重啓 dsh web 才能生效。
- 安裝核心：
dsh plugin --profile web add dsh-router-core
- 安裝本插件：
dsh plugin --profile web add dsh-router-codebuddy
- 重啓服務：
dsh web
典型用法¶
重啓完成後，在面板中操作：
- 進入面板的「供應商」頁面，找到
CodeBuddy或CodeBuddyEN卡片。 - 點擊「添加鏈接」，系統會打開瀏覽器窗口進行 OAuth 登錄，登錄成功後賬號會自動添加到賬號池。
- 在供應商詳情頁點擊「獲取模型」，從上游拉取模型列表。
- 在發起請求時，模型名稱可使用
glm-5.3-flash，或帶別名前綴使用codebuddy/glm-5.3-flash（插件會自動剝離前綴）。
適用場景與注意¶
- 依賴關係：單獨安裝此插件無法工作，必須先安裝
dsh-router-core。 - 重啓要求：安裝命令執行完畢後，必須重啓
dsh web，插件纔會向核心註冊供應商。 - 積分機制：積分的持久化存儲由核心統一處理，插件僅在獲取不到數據時返回
-1，由核心保留上次的持久化值。 - 本地開發：本地開發時，請在
dependencies中添加"dsh-router-codebuddy": "link:/path/to/dsh-router-codebuddy"，而非使用 npm 安裝。
結語¶
dsh-router-codebuddy 爲 DSH 用戶提供了接入 CodeBuddy 族服務的標準接口。它通過統一的實現類處理國內與國際版的不同差異，配合 dsh-router 的連接池與回退策略，實現了穩定的多賬號管理與模型調用。更多細節可參考項目源碼或目錄頁。
