前言¶

在 DeepSeek Harness（DSH）裏接第三方模型，常見做法是寫適配層去對接 HTTP API，或把 CLI 當成子進程橋接進 Cordis 的 LlmAdapter。騰訊 CodeBuddy 提供官方 CLI（@tencent-ai/codebuddy-code），支持 ACP stdio 與獨立委派所需的參數；若要在 DSH 會話裏直接選 codebuddy/default、並保留多賬戶與 WorkBuddy 積分體系，需要一條與 DSH 工具鏈對齊的插件路徑。dsh-codebuddy-link（維護者 liubaicai）即爲此目的：Cordis 插件 + Web 設置面板，Provider 經 ACP stdio 原生執行，獨立委派保留 stream-json 兼容調用。思路參考社區插件 amlyczz/dsh-agy-link 的 CLI provider 橋接。

這是什麼¶

dsh-codebuddy-link 將騰訊 CodeBuddy CLI 接入 DSH。倉庫：https://github.com/liubaicai/dsh-codebuddy-link；社區目錄：https://www.skillhub.cn/plugins/liubaicai/dsh-codebuddy-link（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。分類爲客戶端插件；當前 package 版本 0.3.30，許可證 MIT。插件以當前 DSH 進程權限運行 CLI，安裝前宜自行查看源碼與許可證。

核心功能¶

模型提供方與多賬戶¶

在 DSH 中選擇 codebuddy/default 或 codebuddy/<模型ID>。設置面板支持瀏覽器添加多個賬戶、固定單一賬戶或賬戶池輪詢；同一會話優先綁定同一賬戶，每賬戶最多同時執行 1 個調用。僅從未啓用賬戶管理的安裝保留本機 CLI 登錄回退；啓用賬戶管理後，缺失或失效授權會明確失敗，不會悄悄切換身份。

ACP 原生執行¶

Provider 主調用固定通過 ACP stdio 使用 CodeBuddy CLI 原生完整工具完成讀寫和命令；DSH 接收進度及最終結果。舊配置中的 executionMode 會在加載時遷移到 ACP，不可降級回 bridge / DSH 工具協議模式。勾選 --dangerously-skip-permissions 時，ACP 原生工具會繞過 DSH 沙箱與逐項確認，僅適合可信任務。

獨立委派與斜槓命令¶

• codebuddy_ask：接收獨立問題，不自動附帶 DSH 歷史，默認關閉原生工具（可通過管理員配置 tools 等項調整委派行爲）。
• /codebuddy status、/codebuddy models、/codebuddy runs、/codebuddy help：狀態、模型、運行記錄與幫助。

主模型與獨立委派共享思考強度默認值、進程內 FIFO 併發隊列；設置頁提供脫敏調用診斷與無進展提醒。支持文本與思考流、usage、取消、超時，以及 Windows npm 啓動器與進程樹回收。

候選模型與 HTTP 429¶

設置頁可多選候選模型（編號表示嘗試順序）。ACP 主任務因明確 HTTP 429 中斷時，按順序嘗試已啓用的候選，每個模型最多一次；默認不選則遇錯直接結束。該機制不影響默認模型、會話所選模型或賬戶綁定；獨立委派與標題/壓縮等後臺 print 調用不使用此設置。

共享積分（實驗性，只讀）¶

按 官方定價文檔，CodeBuddy 與 WorkBuddy 同賬號積分共享。插件在刷新賬戶等時機向中國區官方計費接口發起只讀查詢，不輪詢、不代簽到或購買。設置頁僅提供瀏覽器授權，不再提供 JSON 導入 HTTP 端點；憑據保存在 ${DSH_HOME}/plugins/dsh-codebuddy-link/accounts.json（默認 ~/.dsh/...），明文祕密文件，需自行保護 DSH 用戶目錄。

環境與依賴¶

• Node.js：22.18+（與 package engines 一致）。
• DSH：需支持當前 LlmAdapter API；開發時 README 註明使用 @deepseek-ai/dsh-* 0.1.2-rc.1。
• CodeBuddy CLI：需支持 --acp --acp-transport stdio（ACP v1，provider 必需），以及獨立委派使用的 --print、--output-format stream-json、--include-partial-messages、--tools、--no-session-persistence。項目在 CodeBuddy CLI 2.177.1 上覈驗參數與認證失敗協議。

安裝與啓用¶

下面按 README 順序：先裝 CLI，再裝插件，最後重啓 DSH。

1. 安裝 CodeBuddy CLI¶

npm install -g @tencent-ai/codebuddy-code

可在普通終端運行 codebuddy 登錄，或在安裝插件後於 設置 → CodeBuddy → 添加賬戶 授權。運行 DSH 的用戶必須能解析到 CLI；桌面應用 PATH 未更新時可配置 codebuddyBin。

2. 從 GitHub 安裝插件（推薦固定版本）¶

需要本機 Git。將 web 換成實際使用的 DSH profile：

dsh plugin --profile web add "git+https://github.com/liubaicai/dsh-codebuddy-link.git#v0.3.30"

倉庫包含已構建的 dist，安裝不依賴 TypeScript 或安裝時構建。跟隨開發分支：

dsh plugin --profile web add "git+https://github.com/liubaicai/dsh-codebuddy-link.git#main"

3. 無 Git：Release 包¶

從 Releases 下載對應 .tgz，可用同頁 SHA256SUMS.txt 覈對。在下載目錄執行（示例版本 0.3.30）：

dsh plugin --profile web add ./dsh-codebuddy-link-0.3.30.tgz

Windows PowerShell 使用 .\dsh-codebuddy-link-0.3.30.tgz；本地路徑需帶 ./、.\ 或絕對路徑。

4. 啓用¶

完全退出並重啓對應 DSH 實例，在 設置 → CodeBuddy 獲取模型列表，選擇 codebuddy/default 或已啓用模型。執行 /codebuddy status 可檢查配置（不代表認證已成功）。升級時安裝新版本標籤或安裝包後再重啓。

典型用法¶

在會話中選擇模型¶

安裝並保存設置後，在 DSH 模型選擇器中選 codebuddy/<模型ID>。默認模型用於未顯式指定模型的調用（如 codebuddy_ask）；default 表示由 CLI 自身默認模型決定。

斜槓命令¶

在 DSH 會話中輸入：

• /codebuddy status — 查看配置與運行態摘要
• /codebuddy models — 查看模型相關狀態
• /codebuddy runs — 查看脫敏運行記錄（與設置頁「運行記錄」一致）
• /codebuddy help — 命令說明

管理員 Cordis 配置示例¶

Cordis 插件名爲 dsh-codebuddy-link。優先級：面板已保存設置 > 插件 config > 環境變量 > 默認值。

- name: dsh-codebuddy-link
  config:
    codebuddyBin: 'C:\Users\you\AppData\Roaming\npm\codebuddy.cmd'
    models: [default]
    timeoutMs: 600000
    tools: ''
    permissionMode: dontAsk

常用環境變量包括 DSH_CODEBUDDY_ENABLED、DSH_CODEBUDDY_BIN、DSH_CODEBUDDY_DEFAULT_MODEL、DSH_CODEBUDDY_MODE（dontAsk / plan / acceptEdits）等；完整表格見倉庫 README「配置」一節。設置持久化在 ${DSH_HOME}/plugins/dsh-codebuddy-link/settings.json；賬戶在 accounts.json。

從未添加賬戶的舊安裝仍可使用環境變量 DSH_CODEBUDDY_CREDENTIALS_FILE 指向 JSON 憑據文件；一旦啓用多賬戶管理便不再回退 CLI 本地身份。

適用場景與注意¶

適合：已在用或計劃用騰訊 CodeBuddy CLI，希望在 DSH 裏統一選模型、做多賬戶調度，並需要 ACP 原生工具鏈與 DSH 會話並列的場景。

務必注意：

1. 插件以 當前 DSH 進程權限 啓動 codebuddy；ACP 與權限跳過選項可能繞過沙箱，只應在可信環境使用。
2. 中國區瀏覽器授權與積分查詢 不會 發往國際區接口；暫不支持國際區、企業額度、API Key 或加密憑據文件（以 README 爲準）。
3. 計費接口非公開穩定 SDK；README 要求上線前與官方用量頁覈對，無法匹配時應保留未知狀態。
4. workspaceRoot（默認當前 session 工作目錄）爲 ACP 原生執行必需，缺失時拒絕啓動。
5. 安裝前檢查源碼與 MIT 許可證；GitHub 安裝或 Actions 不會讀取 CodeBuddy 憑據，模型請求僅在本機 DSH 調用 CLI 時使用所配置授權。

結尾¶

dsh-codebuddy-link 把官方 CodeBuddy CLI 接進 DSH 的 Cordis 與 Web 設置流：ACP 主路徑、獨立委派、多賬戶與只讀積分展示，避免自行逆向模型 API。DSH 生態強調「一切皆插件」；若需版本與 issue 跟蹤，以倉庫爲準。

• 社區目錄：https://www.skillhub.cn/plugins/liubaicai/dsh-codebuddy-link
• GitHub：https://github.com/liubaicai/dsh-codebuddy-link