前言¶
DeepSeek Harness (DSH) 是一个支持通过插件扩展模型提供商的框架。腾讯 CodeBuddy 开放平台提供了一套 OpenAI 兼容的 API 网关，但尚未被整合进 DSH。dsh-codebuddy 是一个非官方插件，旨在将 CodeBuddy 的模型接入 DSH。它不修改 DSH 的任何源码，而是作为标准插件存在。
插件概览¶
这是一个标准 DSH 插件（包含 package.json、cordis.patch.yml、host 入口及设置页）。它使用你自己的 API Key 直连官方网关，并通过图形界面完成配置。插件将密钥安全地存储在 DSH 的凭据库中，而不是写入配置文件。
前置条件¶
在使用前，请确保满足以下环境要求：
| 项 | 要求 |
|---|---|
| DeepSeek Harness | >= 0.1.7-rc.2 或 >= 0.2.0-rc.1 < 3.0.0-0 |
| Node.js | ^22.19.0 或 >= 24.0.0 |
| 账号 | 腾讯 CodeBuddy 开放平台账号及 API 密钥（sk- 或 ck- 开头） |
安装¶
安装时必须注意依赖解析路径。由于插件顶层静态导入了 @deepseek-ai/dsh-llm，该包仅存在于 DSH profile 的 node_modules 树中，因此不建议使用 link: 安装，否则会报 ERR_MODULE_NOT_FOUND。
方式 A：使用 file: 依赖（推荐）¶
- 将本仓库放置在一个固定位置，例如
E:\WorkBuddy\dsh-codebuddy。 - 在 DSH profile 的
package.json中添加依赖：
"dsh-codebuddy": "file:E:/WorkBuddy/dsh-codebuddy"
同时将其加入 dsh.profile.bundles 列表。
3. 让 profile 安装依赖。
4. 重启 DSH。
方式 B：手动复制¶
将插件的 lib/、cordis.patch.yml、package.json 复制到 <DSH profile 目录>/node_modules/dsh-codebuddy/，然后重启 DSH。
配置与使用¶
重启 DSH 后，进入 设置 → CodeBuddy 进行配置。
- 填入密钥：在「API 密钥」栏填入你的 Key，点击 保存密钥。
- 测试连接：点击 测试连接，确认密钥有效。
- 获取模型：点击 获取模型。插件会向网关发起探测请求以列出可用模型（注意：探测会产生真实计费请求）。
- 选择模型：在 设置 → 模型 中，选择 provider 为
CodeBuddy (unofficial)，然后从列表中选择模型。
接口地址限制：设置页中的接口地址为只读，无法修改。如需更改，需修改配置或环境变量 CODEBUDDY_BASE_URL。
数据与隐私¶
- API Key：仅作为
Authorization: Bearer头发送至https://copilot.tencent.com/v2，不经过作者服务器。 - 对话内容：提示词、代码等会全部上传至腾讯网关。
- 存储位置：密钥存储在 DSH 凭据库（
~/.dsh/.credentials.yaml）中，不写入配置文件。 - 遥测：无任何统计上报。
注意事项¶
- 非官方：本插件与腾讯控股有限公司及其关联公司无隶属关系。
- 探测成本：点击「获取模型」会发起真实计费的请求，请谨慎操作。
- 模型持久化：探测到的模型结果仅在本次会话内生效，重启 DSH 后会回退到内置清单，需重新探测。
- 元数据：内置模型清单的元数据是静态声明的，可能过时。
短结尾¶
dsh-codebuddy 为 DSH 用户提供了使用腾讯 CodeBuddy 模型的途径，采用零源码补丁的插件化方案。如需了解更多或获取源码，请访问插件目录或GitHub 仓库。
