前言¶

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。