前言¶

DeepSeek Harness (DSH) 採用了「一切皆插件」的架構理念。CodeBuddy (copilot.tencent.com) 是騰訊雲提供的智能編程助手，具備豐富的模型生態和工具鏈。本插件旨在將 CodeBuddy 的能力接入 DSH，爲開發者提供一套非官方但功能完整的 Provider Bundle。

該插件解決了在 DSH 環境中調用 CodeBuddy 模型、使用其原生網絡搜索/抓取工具、以及統一管理 OAuth 與多 Key 憑據的需求。

插件概覽¶

• 名稱：taikaikaikai-pixel/dsh-codebuddy-plugin
• 維護者：taikaikaikai-pixel
• 類別：模型推理
• 許可：MIT
• 安裝命令：

    dsh plugin --profile web add github:taikaikaikai-pixel/dsh-codebuddy-plugin

核心功能¶

插件主要包含以下能力：

1. 18 個模型接入
   提供了 DeepSeek、智譜 GLM、Moonshot Kimi、MiniMax、騰訊混元以及自動路由等多種模型。多數模型支持可調的思考強度（reasoningEfforts）與圖片輸入。

2. CodeBuddy 工具鏈集成

   • 網絡搜索與抓取：對接 dsh 原生的 web_search 和 web_fetch 工具，使用 CodeBuddy 的後端索引。
   • 生圖工具：提供 image_generate 工具，支持混元生圖後端。

3. 本地流式橋
   在本地運行一個流式代理服務（默認監聽 127.0.0.1:3901）。所有請求（含主聊天、工具調用）都經由該橋轉發，由橋統一解析憑據並調用 CodeBuddy 網關。支持 OAuth 登錄與多 Key 自動輪詢/失敗冷卻機制。

4. Web UI 設置卡片
   在 DSH 的 Web UI 中提供了一個獨立的設置面板，用於管理模型、切換登錄模式、配置工具開關及查看額度用量。

安裝與配置¶

安裝後，重啓 DSH 進程或 Web UI 即可生效。憑據與配置數據存儲在用戶目錄下：

• 憑據文件：~/.dsh/codebuddy-plugin-auth.json、~/.dsh/codebuddy-plugin.json
• 用量統計：~/.dsh/codebuddy-plugin-usage.json

典型用法¶

1. 登錄配置
   在 Web UI 的插件設置卡「登錄」區，選擇登錄方式。

   • OAuth 模式：點擊登錄，在瀏覽器中完成授權，令牌會自動續期。
   • API Key 模式：在設置卡內添加多個 Key，支持自動輪詢與失敗冷卻。

2. 圖片輸入配置
   若需使用圖片輸入功能，需在 ~/.dsh/settings.yaml 中配置 describe-image 工具，指向本地流式橋：

    describe-image:
      baseURL: http://127.0.0.1:3901/v2
      model: glm-5v-turbo
      apiKeyEnv: CODEBUDDY_API_KEY
      apiStyle: chat-completions

注意事項¶

• 非官方插件：插件由社區維護，與 DeepSeek 或騰訊雲無官方從屬關係。
• 模型清單維護：CodeBuddy 網關不支持 OpenAI 風格的 GET /models 端點。模型清單需手工維護或使用倉庫提供的 verify-models.mjs 腳本進行同步。
• 依賴流式橋：本地流式橋是主聊天的必要組件，禁用該橋會中斷主聊天功能。
• 憑據安全：所有請求憑據均由本地流式橋統一處理，調用方無需在代碼中硬編碼 Key。