前言¶
用 DeepSeek Harness（DSH）做智能體開發時，如果想複用 CodeBuddy 平臺上的模型，通常要自己處理 OAuth 授權、維護 token、再手動把賬號可用的模型寫進配置。賬號模型一變，配置就得跟着改，憑據放在哪裏也容易出錯。
dsh-codebuddy 解決的就是這個問題：把 CodeBuddy 的 OAuth 登錄、動態模型目錄和推理等級選擇做成一個標準 DSH 插件。下面介紹它的能力、安裝方法和日常使用。
這是什麼¶
dsh-codebuddy 是由 Lbryany 維護的 DeepSeek Harness 插件，定位是給 DSH 提供 CodeBuddy OAuth、動態模型和推理等級控制。當前版本 0.1.1，npm 包名 @lbryany/dsh-codebuddy，許可證爲 MIT。
DSH 的理念是「一切皆插件」，登錄方式和模型來源都可以通過插件擴展。這個插件沿這條路徑把 CodeBuddy 接入進來：登錄一次，模型選擇器裏就有當前賬號的模型和推理等級可選。
核心功能¶
按 README 的說明，插件提供以下能力：
/codebuddy-login [site]登錄國內版、國際版或自定義 CodeBuddy 站點；- 在 dsh 模型選擇器中顯示獨立的
CodeBuddy分類； - 登錄後動態加載當前賬號可用的模型；
- 支持
Off / Minimal / Low / Medium / High / Xhigh / Max推理等級； - OAuth 憑據通過 dsh Credential Store 持久化，重啓後自動恢復模型目錄；
- 提供
/codebuddy-status和/codebuddy-logout。
憑據方面，OAuth 憑據存儲在 dsh 憑據引用 CODEBUDDY_OAUTH 中，插件不會把 access token 或 refresh token 寫入日誌。
前置要求¶
- DeepSeek Harness
0.1.0-rc.6 - Node.js
22.19+或24+（package.json 中 engines 爲^22.19.0 || >=24.0.0）
安裝與啓用¶
先把插件安裝到實際運行 Web 應用的同一個 profile，再啓動應用：
dsh plugin --profile web add github:Lbryany/dsh-codebuddy
dsh web
第一條命令從 GitHub 拉取並註冊插件到 web profile，第二條啓動 DSH Web 應用。如果 Web 應用使用自定義 profile，把 web 換成對應名稱，並用 dsh --profile <name> 啓動。
經過上面的步驟，插件就已生效，接下來在輸入框裏登錄即可。
登錄與使用¶
在 dsh 輸入框執行：
/codebuddy-login cn
site 參數的取值規則如下：
cn/china：對應https://copilot.tencent.com；global/intl或留空：對應https://www.codebuddy.ai；- 也可以傳入完整的
http(s)站點 URL。
瀏覽器授權成功後，模型選擇器會出現 CodeBuddy 分類、當前賬號的模型列表和可選推理等級。日常查看登錄狀態用 /codebuddy-status，需要切換賬號或退出時用 /codebuddy-logout。
更新與卸載¶
更新只需重新執行一次安裝命令，裝回最新 GitHub 版本：
dsh plugin --profile web add github:Lbryany/dsh-codebuddy
卸載時把 add 換成 remove，並使用 npm 包名：
dsh plugin --profile web remove @lbryany/dsh-codebuddy
從源碼構建安裝¶
如果想審查或修改代碼，可以先做克隆和構建，再從本地包安裝：
git clone https://github.com/Lbryany/dsh-codebuddy.git
cd dsh-codebuddy
npm ci
npm run check
npm pack --ignore-scripts
dsh plugin --profile web add ./lbryany-dsh-codebuddy-0.1.1.tgz
dsh web
其中 npm run check 依次執行類型檢查、測試和構建，npm pack --ignore-scripts 生成可安裝的 tgz 包。
一個實現細節：倉庫會把 lib/ 一併提交，這樣 dsh 才能直接通過 GitHub 安裝；CI 會驗證提交的 bundle 與源碼構建結果一致。
適用場景與注意¶
適合的場景很明確：已經在用 DSH，手上有一個 CodeBuddy 賬號，希望通過 OAuth 複用賬號下的模型，而不想手動維護 token 和模型列表。
安裝前注意兩點：
1、插件以當前 dsh 進程的權限運行，安裝第三方插件等於擴展了 DSH 的能力邊界，建議先閱讀源碼再決定是否安裝；
2、插件採用 MIT 許可證（見 README 的 License 一節與 package.json 的 license 字段），憑據雖然存放在 dsh Credential Store 且不寫日誌，安裝前檢查憑據處理邏輯仍是必要動作。
結尾¶
整體來看，dsh-codebuddy 把 CodeBuddy 的登錄、動態模型目錄和推理等級控制收斂成兩條命令：一條安裝、一條登錄，之後的模型選擇都在 dsh 模型選擇器裏完成。項目地址與社區目錄頁：
- GitHub：https://github.com/Lbryany/dsh-codebuddy
- 社區目錄頁：https://www.skillhub.cn/plugins/Lbryany/dsh-codebuddy
需要說明的是，該目錄爲獨立維護的社區站點，與 DeepSeek / 幻方沒有官方從屬關係。
