前言¶
DeepSeek Harness（DSH）通过 Provider 插件接入各家模型服务。若你所在环境只发放 WorkBuddy 积分、没有通用 API Key，或更习惯用 CodeBuddy 中国站账号登录，原生 DSH 默认并不覆盖这类凭据与模型目录。
下面介绍社区插件 dsh-llm-codebuddy：它为 DSH 增加名为 CodeBuddy 中国区 的 Provider，支持 WorkBuddy API Key 与 CodeBuddy 中国站令牌两种认证，并在 WebUI 中完成模型获取与配置。插件独立安装，不修改 DSH 全局目录；维护者为 Axiaohungry，当前版本 1.3.5，MIT 许可证，GitHub 约 20 stars。
这是什么¶
dsh-llm-codebuddy 是第三方适配器，并非 WorkBuddy、CodeBuddy 或 DSH 官方插件。API Key 由 WorkBuddy 提供，插件使用该 Key 调用供 CodeBuddy 使用的模型服务；也可通过 CodeBuddy 中国站网页登录获取令牌，无需本机安装 CodeBuddy CLI。
请求路径大致为：DSH Agent → 本插件 → CodeBuddy /v2/chat/completions（推理）与 /v3/config（模型目录）。DSH 负责 Agent 循环与工具调用，CodeBuddy 负责模型推理。
核心功能¶
根据仓库 README，插件当前能力包括：
- WebUI 中直接添加
CodeBuddy 中国区Provider； - 支持 WorkBuddy API Key，输入框旁可切换
API Key/令牌登录； - 支持从 WebUI 或命令行拉起浏览器，完成 CodeBuddy 中国站登录，并自动复用、刷新令牌；
- 自动获取 CodeBuddy 当前可用模型，支持编辑模型 ID、名称、上下文窗口、最大输出 Token；
- 支持添加、删除模型及重新同步模型目录；
- 按模型目录声明各模型自己的思考能力与可选档位（
off / minimal / low / medium / high / xhigh / max），转换为reasoning_effort发送； - 模型接口不可用时使用内置目录兜底；
- 输入新 API Key 可替换旧值，留空保存则保留原值；凭据由 DSH 凭据服务保存，不写入
settings.yaml。
环境要求：Windows、Linux 或 macOS；Node.js >= 22.19.0；已安装 DSH。仓库说明已在 DSH 0.1.0-rc.6 上验证。安装器自带 DSH 所需的 pnpm。
安装与启用¶
推荐使用一键安装命令，会为 DSH 的 web 和 headless Profile 安装插件：
npx --yes dsh-llm-codebuddy@latest install
完成后重启 DSH。若只使用 WebUI，也可仅安装 web Profile：
dsh plugin --profile web add dsh-llm-codebuddy@latest
需要 headless 时再执行：
dsh plugin --profile headless add dsh-llm-codebuddy@latest
安装后若 WebUI 中看不到 CodeBuddy，确认已重启 DSH，并检查 web Profile 插件列表：
dsh plugin --profile web list --depth 0
典型用法¶
令牌登录（新用户推荐）¶
- 打开「设置 → 模型」。
- 添加或编辑
CodeBuddy 中国区。 - 点击 API Key 输入框右侧的「令牌登录」。
- 在自动打开的浏览器中完成 CodeBuddy 中国站登录。
- WebUI 显示「令牌已登录」后，获取模型并保存自定义目录。
若 WebUI 无法打开浏览器，可使用命令行入口：
npx --yes dsh-llm-codebuddy@latest login
登录成功后，Provider 会切换为令牌模式，无需 API Key。两种凭据独立保留，可随时切回 API Key 模式。
WorkBuddy API Key¶
- 打开「设置 → 模型」，点击「添加提供方」，选择
CodeBuddy 中国区。 - 输入从 WorkBuddy 获取的 API Key 并保存。
- 编辑该 Provider，展开「自定义设置」，点击「获取可用模型」，选择需要的模型并导入。
- 按需修改模型参数后保存。
更换 API Key 后建议重新点击「获取可用模型」，以同步新账号的模型权限。模型权限与 Key 绑定，插件只导入当前 Key 授权的模型。
更新与卸载¶
更新到最新版：
npx --yes dsh-llm-codebuddy@latest install
更新后重启 DSH；模型配置与 API Key 不会被覆盖。
卸载：
npx --yes dsh-llm-codebuddy@latest uninstall
卸载会备份 ~/.dsh/settings.yaml，仅删除 llm-pi-ai.providers.codebuddy-cn 配置，从 web、headless Profile 移除插件，并保留凭据以便日后重装。
适用场景与注意¶
适合谁： 已在 DSH 中做 Agent 开发、且公司或团队只提供 WorkBuddy 积分或 CodeBuddy 中国站账号的用户；需要在 DSH WebUI 里统一管理 CodeBuddy 模型目录与思考档位时也可使用。
运行权限： 插件随当前 DSH 进程运行，具备该进程可访问的文件、网络与凭据权限。安装前应阅读源码与 MIT 许可证，确认符合本机安全策略。
版本与兼容： DSH 仍处于预发布阶段；若未来 DSH 调整插件接口，本插件可能需要同步升级。调用若出现 500 status code (no body)，README 建议更新到最新版并重启，旧版可能被 DSH 覆盖 CodeBuddy 请求标识。
第三方说明： 本项目是社区适配器；SkillHub 目录页与 GitHub 仓库由维护者独立发布，与 DeepSeek / 幻方无官方从属关系。
链接¶
- SkillHub 目录页：https://www.skillhub.cn/plugins/Axiaohungry/dsh-llm-codebuddy
- GitHub 仓库：https://github.com/Axiaohungry/dsh-llm-codebuddy
