前言¶
用 DeepSeek Harness（DSH）做智能体开发时，如果想复用 CodeBuddy 平台上的模型，通常要自己处理 OAuth 授权、维护 token、再手动把账号可用的模型写进配置。账号模型一变，配置就得跟着改，凭据放在哪里也容易出错。
dsh-codebuddy 解决的就是这个问题：把 CodeBuddy 的 OAuth 登录、动态模型目录和推理等级选择做成一个标准 DSH 插件。下面介绍它的能力、安装方法和日常使用。
这是什么¶
dsh-codebuddy 是由 Lbryany 维护的 DeepSeek Harness 插件，定位是给 DSH 提供 CodeBuddy OAuth、动态模型和推理等级控制。当前版本 0.1.1，npm 包名 @lbryany/dsh-codebuddy，许可证为 MIT。
DSH 的理念是「一切皆插件」，登录方式和模型来源都可以通过插件扩展。这个插件沿这条路径把 CodeBuddy 接入进来：登录一次，模型选择器里就有当前账号的模型和推理等级可选。
核心功能¶
按 README 的说明，插件提供以下能力：
/codebuddy-login [site]登录国内版、国际版或自定义 CodeBuddy 站点；- 在 dsh 模型选择器中显示独立的
CodeBuddy分类； - 登录后动态加载当前账号可用的模型；
- 支持
Off / Minimal / Low / Medium / High / Xhigh / Max推理等级； - OAuth 凭据通过 dsh Credential Store 持久化，重启后自动恢复模型目录；
- 提供
/codebuddy-status和/codebuddy-logout。
凭据方面，OAuth 凭据存储在 dsh 凭据引用 CODEBUDDY_OAUTH 中，插件不会把 access token 或 refresh token 写入日志。
前置要求¶
- DeepSeek Harness
0.1.0-rc.6 - Node.js
22.19+或24+（package.json 中 engines 为^22.19.0 || >=24.0.0）
安装与启用¶
先把插件安装到实际运行 Web 应用的同一个 profile，再启动应用：
dsh plugin --profile web add github:Lbryany/dsh-codebuddy
dsh web
第一条命令从 GitHub 拉取并注册插件到 web profile，第二条启动 DSH Web 应用。如果 Web 应用使用自定义 profile，把 web 换成对应名称，并用 dsh --profile <name> 启动。
经过上面的步骤，插件就已生效，接下来在输入框里登录即可。
登录与使用¶
在 dsh 输入框执行：
/codebuddy-login cn
site 参数的取值规则如下：
cn/china：对应https://copilot.tencent.com；global/intl或留空：对应https://www.codebuddy.ai；- 也可以传入完整的
http(s)站点 URL。
浏览器授权成功后，模型选择器会出现 CodeBuddy 分类、当前账号的模型列表和可选推理等级。日常查看登录状态用 /codebuddy-status，需要切换账号或退出时用 /codebuddy-logout。
更新与卸载¶
更新只需重新执行一次安装命令，装回最新 GitHub 版本：
dsh plugin --profile web add github:Lbryany/dsh-codebuddy
卸载时把 add 换成 remove，并使用 npm 包名：
dsh plugin --profile web remove @lbryany/dsh-codebuddy
从源码构建安装¶
如果想审查或修改代码，可以先做克隆和构建，再从本地包安装：
git clone https://github.com/Lbryany/dsh-codebuddy.git
cd dsh-codebuddy
npm ci
npm run check
npm pack --ignore-scripts
dsh plugin --profile web add ./lbryany-dsh-codebuddy-0.1.1.tgz
dsh web
其中 npm run check 依次执行类型检查、测试和构建，npm pack --ignore-scripts 生成可安装的 tgz 包。
一个实现细节：仓库会把 lib/ 一并提交，这样 dsh 才能直接通过 GitHub 安装；CI 会验证提交的 bundle 与源码构建结果一致。
适用场景与注意¶
适合的场景很明确：已经在用 DSH，手上有一个 CodeBuddy 账号，希望通过 OAuth 复用账号下的模型，而不想手动维护 token 和模型列表。
安装前注意两点：
1、插件以当前 dsh 进程的权限运行，安装第三方插件等于扩展了 DSH 的能力边界，建议先阅读源码再决定是否安装；
2、插件采用 MIT 许可证（见 README 的 License 一节与 package.json 的 license 字段），凭据虽然存放在 dsh Credential Store 且不写日志，安装前检查凭据处理逻辑仍是必要动作。
结尾¶
整体来看，dsh-codebuddy 把 CodeBuddy 的登录、动态模型目录和推理等级控制收敛成两条命令：一条安装、一条登录，之后的模型选择都在 dsh 模型选择器里完成。项目地址与社区目录页：
- GitHub：https://github.com/Lbryany/dsh-codebuddy
- 社区目录页：https://www.skillhub.cn/plugins/Lbryany/dsh-codebuddy
需要说明的是，该目录为独立维护的社区站点，与 DeepSeek / 幻方没有官方从属关系。
