前言¶
DeepSeek Harness（DSH）通過 Provider 插件接入各家模型服務。若你所在環境只發放 WorkBuddy 積分、沒有通用 API Key，或更習慣用 CodeBuddy 中國站賬號登錄，原生 DSH 默認並不覆蓋這類憑據與模型目錄。
下面介紹社區插件 dsh-llm-codebuddy：它爲 DSH 增加名爲 CodeBuddy 中國區 的 Provider，支持 WorkBuddy API Key 與 CodeBuddy 中國站令牌兩種認證，並在 WebUI 中完成模型獲取與配置。插件獨立安裝，不修改 DSH 全局目錄；維護者爲 Axiaohungry，當前版本 1.3.5，MIT 許可證，GitHub 約 20 stars。
這是什麼¶
dsh-llm-codebuddy 是第三方適配器，並非 WorkBuddy、CodeBuddy 或 DSH 官方插件。API Key 由 WorkBuddy 提供，插件使用該 Key 調用供 CodeBuddy 使用的模型服務；也可通過 CodeBuddy 中國站網頁登錄獲取令牌，無需本機安裝 CodeBuddy CLI。
請求路徑大致爲：DSH Agent → 本插件 → CodeBuddy /v2/chat/completions（推理）與 /v3/config（模型目錄）。DSH 負責 Agent 循環與工具調用，CodeBuddy 負責模型推理。
核心功能¶
根據倉庫 README，插件當前能力包括：
- WebUI 中直接添加
CodeBuddy 中國區Provider； - 支持 WorkBuddy API Key，輸入框旁可切換
API Key/令牌登錄； - 支持從 WebUI 或命令行拉起瀏覽器，完成 CodeBuddy 中國站登錄，並自動複用、刷新令牌；
- 自動獲取 CodeBuddy 當前可用模型，支持編輯模型 ID、名稱、上下文窗口、最大輸出 Token；
- 支持添加、刪除模型及重新同步模型目錄；
- 按模型目錄聲明各模型自己的思考能力與可選檔位（
off / minimal / low / medium / high / xhigh / max），轉換爲reasoning_effort發送； - 模型接口不可用時使用內置目錄兜底；
- 輸入新 API Key 可替換舊值，留空保存則保留原值；憑據由 DSH 憑據服務保存，不寫入
settings.yaml。
環境要求：Windows、Linux 或 macOS；Node.js >= 22.19.0；已安裝 DSH。倉庫說明已在 DSH 0.1.0-rc.6 上驗證。安裝器自帶 DSH 所需的 pnpm。
安裝與啓用¶
推薦使用一鍵安裝命令，會爲 DSH 的 web 和 headless Profile 安裝插件：
npx --yes dsh-llm-codebuddy@latest install
完成後重啓 DSH。若只使用 WebUI，也可僅安裝 web Profile：
dsh plugin --profile web add dsh-llm-codebuddy@latest
需要 headless 時再執行：
dsh plugin --profile headless add dsh-llm-codebuddy@latest
安裝後若 WebUI 中看不到 CodeBuddy，確認已重啓 DSH，並檢查 web Profile 插件列表：
dsh plugin --profile web list --depth 0
典型用法¶
令牌登錄（新用戶推薦）¶
- 打開「設置 → 模型」。
- 添加或編輯
CodeBuddy 中國區。 - 點擊 API Key 輸入框右側的「令牌登錄」。
- 在自動打開的瀏覽器中完成 CodeBuddy 中國站登錄。
- WebUI 顯示「令牌已登錄」後，獲取模型並保存自定義目錄。
若 WebUI 無法打開瀏覽器，可使用命令行入口：
npx --yes dsh-llm-codebuddy@latest login
登錄成功後，Provider 會切換爲令牌模式，無需 API Key。兩種憑據獨立保留，可隨時切回 API Key 模式。
WorkBuddy API Key¶
- 打開「設置 → 模型」，點擊「添加提供方」，選擇
CodeBuddy 中國區。 - 輸入從 WorkBuddy 獲取的 API Key 並保存。
- 編輯該 Provider，展開「自定義設置」，點擊「獲取可用模型」，選擇需要的模型並導入。
- 按需修改模型參數後保存。
更換 API Key 後建議重新點擊「獲取可用模型」，以同步新賬號的模型權限。模型權限與 Key 綁定，插件只導入當前 Key 授權的模型。
更新與卸載¶
更新到最新版：
npx --yes dsh-llm-codebuddy@latest install
更新後重啓 DSH；模型配置與 API Key 不會被覆蓋。
卸載：
npx --yes dsh-llm-codebuddy@latest uninstall
卸載會備份 ~/.dsh/settings.yaml，僅刪除 llm-pi-ai.providers.codebuddy-cn 配置，從 web、headless Profile 移除插件，並保留憑據以便日後重裝。
適用場景與注意¶
適合誰： 已在 DSH 中做 Agent 開發、且公司或團隊只提供 WorkBuddy 積分或 CodeBuddy 中國站賬號的用戶；需要在 DSH WebUI 裏統一管理 CodeBuddy 模型目錄與思考檔位時也可使用。
運行權限： 插件隨當前 DSH 進程運行，具備該進程可訪問的文件、網絡與憑據權限。安裝前應閱讀源碼與 MIT 許可證，確認符合本機安全策略。
版本與兼容： DSH 仍處於預發佈階段；若未來 DSH 調整插件接口，本插件可能需要同步升級。調用若出現 500 status code (no body)，README 建議更新到最新版並重啓，舊版可能被 DSH 覆蓋 CodeBuddy 請求標識。
第三方說明： 本項目是社區適配器；SkillHub 目錄頁與 GitHub 倉庫由維護者獨立發佈，與 DeepSeek / 幻方無官方從屬關係。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/Axiaohungry/dsh-llm-codebuddy
- GitHub 倉庫：https://github.com/Axiaohungry/dsh-llm-codebuddy
