在 DeepSeek Harness (DSH) 的插件生態中，開發者需要接入多種模型以完成不同的任務。CodeBuddy CLI 提供了包括 GLM-5.3、DeepSeek-V4-Pro 等在內的多種模型，但 DSH 原生未直接集成。dsh-codebuddy-cli 插件通過複用 CodeBuddy CLI 的登錄態，解決了這一接入問題，讓用戶在 DSH 對話窗口中零配置即可使用這些模型。
插件簡介¶
dsh-codebuddy-cli 是一個 DSH 客戶端插件，旨在複用 CodeBuddy CLI 的認證文件，自動將 CodeBuddy 的模型接入 DeepSeek Harness。安裝並啓用後，用戶無需在 DSH 中重新配置賬號，即可直接調用 CodeBuddy 的模型列表。
核心功能¶
- 開箱即用：只要在本機用 CodeBuddy CLI 登錄過一次，安裝並啓用插件後即可在 DSH 中直接使用，無需額外配置。
- 登錄跟隨：插件會自動讀取 CodeBuddy CLI 的認證文件（默認路徑或環境變量
CODEBUDDY_CLI_AUTH_FILE指定的路徑），在 CLI 裏重新登錄後自動跟隨。 - 多賬號管理：支持通過 OAuth 掃碼/鏈接登錄添加多個 CodeBuddy 賬號，也支持粘貼
refresh_token添加（refresh_token爲必填項）。賬號憑證保存在$DSH_HOME/.codebuddy-cli-accounts.json。 - 賬號切換：在設置中可查看各賬號的積分與令牌有效期，並支持切換當前生效的賬號。
- 圖片輸入：支持大部分模型的發圖功能，在對話裏直接粘貼或拖入圖片即可。
- 思考強度切換：支持 GLM-5.3 等模型的檔位調節（如 off / low / high / xhigh），只有上游明確聲明瞭檔位清單的模型纔會出現選項。
- 積分倍率與徽章顯示：模型名後直接顯示積分倍率（如
GLM-5.2 · x0.79）與促銷徽章。 - 對話內積分條：輸入框正下方會常駐一行，顯示當前 provider 與模型信息，以及剩餘積分。
- 每日簽到：支持每日簽到功能，點擊即可調用 CodeBuddy 每日簽到接口領取積分。
- 可選模型配置：可在設置中勾選要在模型選擇器中出現的模型，避免選擇器被過多模型塞滿。
安裝與啓用¶
安裝前需確保已安裝 CodeBuddy CLI 並完成登錄，同時 DSH 版本需在 0.1.2-rc.1 及以上。Web profile 推薦使用以下命令安裝：
dsh plugin --profile web add dsh-codebuddy-cli
dsh web
也可以從 GitHub 源碼安裝：
dsh plugin --profile web add github:fu827707013/dsh-codebuddy-cli
dsh web
Desktop profile 用戶可使用：
dsh plugin --profile desktop add dsh-codebuddy-cli
dsh --profile desktop
典型用法¶
安裝後，在對應界面的模型選擇器裏切換到 CodeBuddy 模型即可使用。以下是常用命令示例：
# 查看登錄狀態與剩餘積分
dsh plugin --profile web exec dsh-codebuddy-cli status
# 機器可讀輸出
dsh plugin --profile web exec dsh-codebuddy-cli status --json
# 環境診斷
dsh plugin --profile web exec dsh-codebuddy-cli doctor
# 清除插件側憑據副本
dsh plugin --profile web exec dsh-codebuddy-cli logout
注意事項¶
- TUI 用戶暫緩安裝：終端界面插件在 DSH 0.1.2 上的適配尚未完成，同類插件實測在 TUI 下安裝可能導致 DSH 啓動崩潰（報
events is not iterable）。建議等終端界面插件發佈適配版本後再安裝。 - 數據存儲：插件的令牌刷新結果保存在
$DSH_HOME/.codebuddy-cli-auth.json，粘貼的 Token 保存在$DSH_HOME/.codebuddy-cli-accounts.json。插件不修改 CLI 原始認證文件。 - 權限與用途：粘貼 Token 添加賬號時，
refresh_token是必填項。僅限個人學習和研究使用，請勿用於商業用途。 - 依賴更新：插件依賴 CodeBuddy CLI 的客戶端接口，CLI 更新後插件可能需要隨之調整。
結語¶
通過 dsh-codebuddy-cli，DSH 用戶可以無縫複用 CodeBuddy CLI 的登錄態與模型資源。更多詳情與源碼請訪問：GitHub。
