前言¶
DeepSeek Harness (DSH) 是一個支持通過插件擴展模型提供商的框架。騰訊 CodeBuddy 開放平臺提供了一套 OpenAI 兼容的 API 網關，但尚未被整合進 DSH。dsh-codebuddy 是一個非官方插件，旨在將 CodeBuddy 的模型接入 DSH。它不修改 DSH 的任何源碼，而是作爲標準插件存在。
插件概覽¶
這是一個標準 DSH 插件（包含 package.json、cordis.patch.yml、host 入口及設置頁）。它使用你自己的 API Key 直連官方網關，並通過圖形界面完成配置。插件將密鑰安全地存儲在 DSH 的憑據庫中，而不是寫入配置文件。
前置條件¶
在使用前，請確保滿足以下環境要求：
| 項 | 要求 |
|---|---|
| DeepSeek Harness | >= 0.1.7-rc.2 或 >= 0.2.0-rc.1 < 3.0.0-0 |
| Node.js | ^22.19.0 或 >= 24.0.0 |
| 賬號 | 騰訊 CodeBuddy 開放平臺賬號及 API 密鑰（sk- 或 ck- 開頭） |
安裝¶
安裝時必須注意依賴解析路徑。由於插件頂層靜態導入了 @deepseek-ai/dsh-llm，該包僅存在於 DSH profile 的 node_modules 樹中，因此不建議使用 link: 安裝，否則會報 ERR_MODULE_NOT_FOUND。
方式 A：使用 file: 依賴（推薦）¶
- 將本倉庫放置在一個固定位置，例如
E:\WorkBuddy\dsh-codebuddy。 - 在 DSH profile 的
package.json中添加依賴：
"dsh-codebuddy": "file:E:/WorkBuddy/dsh-codebuddy"
同時將其加入 dsh.profile.bundles 列表。
3. 讓 profile 安裝依賴。
4. 重啓 DSH。
方式 B：手動複製¶
將插件的 lib/、cordis.patch.yml、package.json 複製到 <DSH profile 目錄>/node_modules/dsh-codebuddy/，然後重啓 DSH。
配置與使用¶
重啓 DSH 後，進入 設置 → CodeBuddy 進行配置。
- 填入密鑰：在「API 密鑰」欄填入你的 Key，點擊 保存密鑰。
- 測試連接：點擊 測試連接，確認密鑰有效。
- 獲取模型：點擊 獲取模型。插件會向網關發起探測請求以列出可用模型（注意：探測會產生真實計費請求）。
- 選擇模型：在 設置 → 模型 中，選擇 provider 爲
CodeBuddy (unofficial)，然後從列表中選擇模型。
接口地址限制：設置頁中的接口地址爲只讀，無法修改。如需更改，需修改配置或環境變量 CODEBUDDY_BASE_URL。
數據與隱私¶
- API Key：僅作爲
Authorization: Bearer頭髮送至https://copilot.tencent.com/v2，不經過作者服務器。 - 對話內容：提示詞、代碼等會全部上傳至騰訊網關。
- 存儲位置：密鑰存儲在 DSH 憑據庫（
~/.dsh/.credentials.yaml）中，不寫入配置文件。 - 遙測：無任何統計上報。
注意事項¶
- 非官方：本插件與騰訊控股有限公司及其關聯公司無隸屬關係。
- 探測成本：點擊「獲取模型」會發起真實計費的請求，請謹慎操作。
- 模型持久化：探測到的模型結果僅在本次會話內生效，重啓 DSH 後會回退到內置清單，需重新探測。
- 元數據：內置模型清單的元數據是靜態聲明的，可能過時。
短結尾¶
dsh-codebuddy 爲 DSH 用戶提供了使用騰訊 CodeBuddy 模型的途徑，採用零源碼補丁的插件化方案。如需瞭解更多或獲取源碼，請訪問插件目錄或GitHub 倉庫。
