为 DeepSeek Harness 接入 CodeBuddy 中国区模型，支持 WorkBuddy API Key 与网页令牌双认证模式。
- 语言
- JavaScript
- License
- MIT
- 分支
- main
安装
$ dsh plugin --profile web add dsh-llm-codebuddy在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 Axiaohungry/dsh-llm-codebuddy：先查看仓库 https://github.com/Axiaohungry/dsh-llm-codebuddy 确认安全性，然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。
一句话定位
为 DeepSeek Harness 增加 CodeBuddy 中国区 模型提供方，让 DSH 用户既能通过 WorkBuddy 派发的 API Key 接入，也能用 CodeBuddy 中国站账号令牌登录直接调用模型。
核心能力
- 在 WebUI 的"添加提供方"下拉中新增
CodeBuddy 中国区，并按 DSH 的 Provider 协议完成注册 - 提供两种认证方式：WorkBuddy API Key 模式与 CodeBuddy 中国站账号令牌登录模式
- 在 API Key 输入框旁注入"API Key"和"令牌登录"切换按钮，网页端一键拉起浏览器完成登录
- 自动从 CodeBuddy 接口拉取当前 Key 可用的模型列表，并允许自定义编辑、添加、删除模型
- 自动按模型声明其思考能力档位（off / minimal / low / medium / high / xhigh / max）和默认档位
- 令牌临近过期时自动调用官方刷新接口续期，免去人工重新登录
技术实现
- 语言: JavaScript (ESM，
type: module) - 关键依赖:
@deepseek-ai/dsh-llm-pi-ai、@earendil-works/pi-ai、@deepseek-ai/dsh-settings、@deepseek-ai/dsh-credentials - 架构模式: 服务端通过
cordis.patch.yml禁用宿主自带的llm-pi-ai、插入名为llm-codebuddy的新 Plugin，并依赖 DSH 的installSettingsSection/registerAdapter/registerModelDiscovery钩子；前端通过 Web Profile 把client.js注入到 API Key 输入框所在字段，实现认证切换按钮 - 入口文件:
index.js（服务端插件）、client.js（WebUI 注入脚本）、cli.js（独立安装/登录/卸载命令行）
适用场景
已经拥有 WorkBuddy 派发 API Key 或 CodeBuddy 中国站账号、想在 DSH 中使用 CodeBuddy 模型推理能力的用户；尤其是希望免去手动复制 API Key、想让令牌自动续期的开发者。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH | 0.1.0-rc.6 | 已通过该版本验证；DSH 仍处预发布，未来接口变动需同步升级 |
| Node.js | >= 22.19.0 | 安装命令要求 |
| 平台 | macOS / Windows / Linux | 跨平台，浏览器登录按系统分别调用 open / rundll32.exe / xdg-open |
| 原生模块 | 无 | 仅依赖纯 JS 包（yaml、pi-ai 等），不引入需要本地编译的模块 |
安装方式
dsh plugin --profile web add dsh-llm-codebuddy
配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
llm-pi-ai.providers.codebuddy-cn | 对象 | 是否声明本 Provider 节点；存在即视为已启用 | 不存在 |
llm-pi-ai.providers.codebuddy-cn.apiKeyEnv | 字符串 | API Key 模式对应的凭据引用；删除该字段即切换为令牌模式 | CODEBUDDY_API_KEY |
llm-pi-ai.providers.codebuddy-cn.models | 数组 | 自定义模型目录；不配置则使用在线目录，失败时回退到内置目录 | 不配置 |
models[].id | 字符串 | 模型 ID，必填 | 无 |
models[].name | 字符串 | 在 WebUI 中显示的名称，留空继承在线/内置目录 | 继承 |
models[].contextWindow | 整数 | 上下文窗口大小 | 262144 |
models[].maxTokens | 整数 | 单次输出上限 | 32768 |
models[].input | 字符串数组 | 输入类型（text、image） | 继承 |
models[].reasoningEfforts | 对象 | 逐档位映射到 CodeBuddy 实际取值；任一档位留空表示该档位不可用 | 模型声明 |
models[].compat.thinkingFormat | 字符串 | 推理内容的格式 | 模型声明 |
常见问题
Q: 安装后 WebUI 里看不到 CodeBuddy 中国区 选项？
A: 安装或更新后必须重启 DSH，已经在运行的进程不会自动加载新插件。重启后再打开"设置 → 模型"即可看到。
Q: 获取模型失败怎么办？
A: 先确认 API Key 来自 WorkBuddy 且仍然有效，重新输入 Key 后再点"获取可用模型"。如果 CodeBuddy 接口临时不可用，插件会回退到内置模型目录，仍然能正常使用。
Q: 为什么别人能看到某个模型我这里看不到？
A: 模型权限与当前 API Key 绑定。插件只导入当前 Key 在 CodeBuddy 授权的模型；更换 Key 后需要重新点"获取可用模型"同步新账号的权限。
Q: 调用时报 500 status code (no body) 怎么办？
A: 升级到最新版并重启 DSH。早期版本可能被 DSH 覆盖 CodeBuddy 请求的 User-Agent 标识导致服务端拒绝，最新版已在请求层恢复官方标识。
Q: 卸载后 WebUI 还显示旧页面？
A: 关闭正在运行的 DSH 进程再重新启动。运行时进程不会自动卸载已加载的插件代码。
Q: WebUI 无法自动打开浏览器登录怎么办？
A: 在终端执行 npx dsh-llm-codebuddy@latest login，插件会调用 CodeBuddy 官方认证流程，完成后会自动把 Provider 切换为令牌模式。
Q: 卸载插件会丢失凭据吗？
A: 不会。卸载只删除 settings.yaml 里的 Provider 配置，DSH 凭据服务中的 API Key 和登录令牌会保留，方便以后重新安装。
上手难度
入门 — 双认证模式都有明确文档，配置文件语义直观，CLI 安装/登录/卸载命令都已封装好，普通用户按 README 步骤即可完成。
已知问题与限制
- DSH 仍处于预发布阶段，未来 DSH 调整插件接口时本插件需要同步升级（README.md:35）
- 用户填写的模型参数超过服务端真实限制时，CodeBuddy 仍可能直接拒绝请求（README.md:111）
- 模型列表仅取自 CodeBuddy
/v3/config中cliagent 授权的模型，其他 agent 的模型不会显示（index.js:133） - 流式请求空闲超时为 300 秒，超过将被中断（index.js:31）
- 浏览器登录最长等待 10 分钟，超时需重新发起（codebuddy-auth.js:121）
- 令牌在过期前 2 分钟会被视为需要刷新，避免请求过程中过期（codebuddy-auth.js:172）
- 旧版本可能被 DSH 覆盖 CodeBuddy 请求标识，需升级插件恢复官方 User-Agent（README.md:188）
为 DeepSeek Harness（DSH）增加 CodeBuddy 中国区 Provider。支持 WorkBuddy
API Key 和 CodeBuddy 中国站账号令牌两种认证方式，并可在 DSH WebUI 中获取、
选择和调整模型。
[!IMPORTANT] API Key 由 WorkBuddy 提供，本插件使用该 Key 调用供 CodeBuddy 使用的模型服务。 DSH 中的 Provider 名称仍为
CodeBuddy 中国区。本项目是第三方适配器，并非 WorkBuddy、CodeBuddy 或 DSH 官方插件。
功能
- WebUI 中直接添加
CodeBuddy 中国区； - 支持从 WorkBuddy 获取的 API Key；
- API Key 输入框旁可显式切换
API Key/令牌登录； - 支持从 WebUI 拉起浏览器登录 CodeBuddy 中国站，并自动复用、刷新登录令牌；
- 自动获取 CodeBuddy 当前可用模型；
- 支持编辑模型 ID、名称、上下文窗口和最大输出 Token；
- 支持添加、删除模型以及重新同步模型目录；
- 按模型目录声明各模型自己的思考能力、可选档位和默认档位；
- 输入新 API Key 可替换旧值，留空保存则保留原值；
- 模型接口暂时不可用时使用内置目录兜底；
- 独立安装，不修改 DSH 全局安装目录。
环境要求
- Windows、Linux 或 macOS；
- Node.js
>= 22.19.0； - 已安装 DSH；
- 已验证 DSH
0.1.0-rc.6。
安装器已自带 DSH 所需的 pnpm，无需全局安装；令牌登录也不需要安装 CodeBuddy CLI。
DSH 仍处于预发布阶段。未来版本如果调整插件接口，本插件可能需要同步升级； DSH 普通更新不会覆盖本插件。
安装
推荐使用一键安装命令：
npx --yes dsh-llm-codebuddy@latest install
该命令会为 DSH 的 web 和 headless Profile 安装插件。完成后重启 DSH。
也可以分别安装：
dsh plugin --profile web add dsh-llm-codebuddy@latest
dsh plugin --profile headless add dsh-llm-codebuddy@latest
只使用 WebUI 时，仅执行第一条即可。
WebUI 配置
CodeBuddy 账号令牌登录（新用户推荐）
- 打开“设置 → 模型”。
- 添加或编辑
CodeBuddy 中国区。 - 点击 API Key 输入框右侧的“令牌登录”。
- 在自动打开的浏览器中完成 CodeBuddy 中国站登录。
- WebUI 显示“令牌已登录”后即可获取模型并保存自定义目录。
如果 WebUI 无法打开浏览器，也可以使用命令行入口：
npx --yes dsh-llm-codebuddy@latest login
插件会调用 CodeBuddy 官方认证流程。完成登录后，插件会自动把
CodeBuddy 中国区 Provider 切换为令牌模式，无需 API Key。点击同一行的
“API Key”可以切回 API Key 模式；已经保存的 API Key 不会被删除。
两种凭据彼此独立保留，之后再次点击“令牌登录”会优先复用已保存令牌；仅在没有
令牌或主动重新登录时才需要再次打开浏览器。
插件直接调用 CodeBuddy 中国站官方网页登录和令牌刷新接口，不依赖本机
codebuddy 命令。访问令牌和刷新令牌保存在 DSH 凭据服务中，不会写入
settings.yaml 或模型目录。
WorkBuddy API Key
- 打开“设置 → 模型”。
- 点击“添加提供方”。
- 选择
CodeBuddy 中国区。 - 输入从 WorkBuddy 获取的 API Key 并保存。
- 点击该 Provider 的“编辑”，展开“自定义设置”。
- 点击“获取可用模型”，选择需要的模型并导入。
- 按需修改模型参数，然后保存。
再次编辑已配置的 Provider 时，会直接显示上次保存的模型目录。
API Key 替换
- 输入新的 API Key 并保存：替换原 Key；
- API Key 输入框留空并保存：保留原 Key；
- 更换 Key 后建议重新点击“获取可用模型”，同步新账号的模型权限。
API Key 由 DSH 凭据服务保存，不会写入模型目录或插件源码。
模型配置
- 没有自定义目录：使用 CodeBuddy 在线目录，失败时使用内置目录；
- 保存自定义目录：仅向 DSH 提供目录中保留的模型；
- 已知模型字段留空：继承在线目录或内置目录中的值；
- 新模型缺少容量：上下文窗口默认
262144，最大输出默认32768； - 点击“恢复默认模型”：删除自定义目录并恢复适配器目录。
配置值超过服务端真实限制时，CodeBuddy 仍可能拒绝请求。
思考程度
DSH 显示的思考程度来自当前模型自身的能力声明，插件把选中的档位转换为
reasoning_effort 并发送给 CodeBuddy。模型推理由 CodeBuddy 云端执行。
off / minimal / low / medium / high / xhigh / max
实际显示哪些档位由 /v3/config 中该模型的 supportsReasoning、onlyReasoning、
thinkingLevelMap 和 reasoning.effort 决定，不能跨模型共用一套固定档位。未手动
选择时，使用 CodeBuddy 为该模型返回的默认档位；服务端没有声明时则不强行指定。
更新
重新运行安装命令即可更新到最新版：
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配置； - 保留其他 Provider 和 DSH 设置；
- 从
web、headlessProfile 移除插件； - 保留 API Key 和登录令牌凭据，方便以后重新安装。
完成后重启 DSH。备份文件名类似：
settings.yaml.codebuddy-backup-2026-08-14T12-00-00-000Z
源码仓库、本地安装包和 API Key 不会被删除。
常见问题
安装后看不到 CodeBuddy
确认已经重启 DSH，并检查 Web Profile：
dsh plugin --profile web list --depth 0
获取模型失败
确认 API Key 来自 WorkBuddy 且仍然有效，然后重新输入 Key 并点击“获取可用模型”。 接口临时不可用时，插件仍会提供内置模型目录。
为什么别人能看到某个模型，我这里看不到
模型权限与 API Key 绑定。插件只导入 /v3/config 中 agents[name=cli].models 为
当前 Key 返回的模型；更换 Key 后请重新点击“获取可用模型”。插件不会强行显示
当前 Key 未授权的模型。
调用时报 500 status code (no body)
先更新到最新版并重启 DSH：
npx --yes dsh-llm-codebuddy@latest install
旧版本可能被 DSH 覆盖 CodeBuddy 请求标识，导致服务端拒绝请求；最新版已在插件请求层 恢复 CodeBuddy 官方标识，同时适用于 API Key 和令牌模式。
卸载后仍显示旧页面
关闭正在运行的 DSH，再重新启动。已经运行的进程不会自动卸载内存中的插件。
开发文档
需要开发其他 Agent 或 Provider 时，请阅读 反向代理调用 WorkBuddy API 开发文档。
工作原理
WorkBuddy 提供 API Key
↓
DSH Agent → 本插件 → CodeBuddy /v2/chat/completions
↘ CodeBuddy /v3/config（获取模型）
CodeBuddy 中国站网页登录 → 本插件保存并刷新 DSH 登录凭据
↓ 当前 access token
DSH Agent → 本插件 → CodeBuddy API（Authorization: Bearer）
- DSH：负责 Agent 循环、上下文、工具调用和权限；
- WorkBuddy：提供 API Key；
- 插件：负责 Provider 注册、模型目录转换和请求兼容；
- CodeBuddy：负责模型推理并返回结果。
License
查看使用指南 →
该插件的安装步骤、关键要点、FAQ 与兼容性说明（基于已收录字段派生）。
收录徽章
[](https://deepseek-plugin.org/plugins/Axiaohungry/dsh-llm-codebuddy)把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。