前言¶

在 DeepSeek Harness（DSH）里接第三方模型，常见做法是写适配层去对接 HTTP API，或把 CLI 当成子进程桥接进 Cordis 的 LlmAdapter。腾讯 CodeBuddy 提供官方 CLI（@tencent-ai/codebuddy-code），支持 ACP stdio 与独立委派所需的参数；若要在 DSH 会话里直接选 codebuddy/default、并保留多账户与 WorkBuddy 积分体系，需要一条与 DSH 工具链对齐的插件路径。dsh-codebuddy-link（维护者 liubaicai）即为此目的：Cordis 插件 + Web 设置面板，Provider 经 ACP stdio 原生执行，独立委派保留 stream-json 兼容调用。思路参考社区插件 amlyczz/dsh-agy-link 的 CLI provider 桥接。

这是什么¶

dsh-codebuddy-link 将腾讯 CodeBuddy CLI 接入 DSH。仓库：https://github.com/liubaicai/dsh-codebuddy-link；社区目录：https://www.skillhub.cn/plugins/liubaicai/dsh-codebuddy-link（独立站点，与 DeepSeek / 幻方无官方从属关系）。分类为客户端插件；当前 package 版本 0.3.30，许可证 MIT。插件以当前 DSH 进程权限运行 CLI，安装前宜自行查看源码与许可证。

核心功能¶

模型提供方与多账户¶

在 DSH 中选择 codebuddy/default 或 codebuddy/<模型ID>。设置面板支持浏览器添加多个账户、固定单一账户或账户池轮询；同一会话优先绑定同一账户，每账户最多同时执行 1 个调用。仅从未启用账户管理的安装保留本机 CLI 登录回退；启用账户管理后，缺失或失效授权会明确失败，不会悄悄切换身份。

ACP 原生执行¶

Provider 主调用固定通过 ACP stdio 使用 CodeBuddy CLI 原生完整工具完成读写和命令；DSH 接收进度及最终结果。旧配置中的 executionMode 会在加载时迁移到 ACP，不可降级回 bridge / DSH 工具协议模式。勾选 --dangerously-skip-permissions 时，ACP 原生工具会绕过 DSH 沙箱与逐项确认，仅适合可信任务。

独立委派与斜杠命令¶

• codebuddy_ask：接收独立问题，不自动附带 DSH 历史，默认关闭原生工具（可通过管理员配置 tools 等项调整委派行为）。
• /codebuddy status、/codebuddy models、/codebuddy runs、/codebuddy help：状态、模型、运行记录与帮助。

主模型与独立委派共享思考强度默认值、进程内 FIFO 并发队列；设置页提供脱敏调用诊断与无进展提醒。支持文本与思考流、usage、取消、超时，以及 Windows npm 启动器与进程树回收。

候选模型与 HTTP 429¶

设置页可多选候选模型（编号表示尝试顺序）。ACP 主任务因明确 HTTP 429 中断时，按顺序尝试已启用的候选，每个模型最多一次；默认不选则遇错直接结束。该机制不影响默认模型、会话所选模型或账户绑定；独立委派与标题/压缩等后台 print 调用不使用此设置。

共享积分（实验性，只读）¶

按 官方定价文档，CodeBuddy 与 WorkBuddy 同账号积分共享。插件在刷新账户等时机向中国区官方计费接口发起只读查询，不轮询、不代签到或购买。设置页仅提供浏览器授权，不再提供 JSON 导入 HTTP 端点；凭据保存在 ${DSH_HOME}/plugins/dsh-codebuddy-link/accounts.json（默认 ~/.dsh/...），明文秘密文件，需自行保护 DSH 用户目录。

环境与依赖¶

• Node.js：22.18+（与 package engines 一致）。
• DSH：需支持当前 LlmAdapter API；开发时 README 注明使用 @deepseek-ai/dsh-* 0.1.2-rc.1。
• CodeBuddy CLI：需支持 --acp --acp-transport stdio（ACP v1，provider 必需），以及独立委派使用的 --print、--output-format stream-json、--include-partial-messages、--tools、--no-session-persistence。项目在 CodeBuddy CLI 2.177.1 上核验参数与认证失败协议。

安装与启用¶

下面按 README 顺序：先装 CLI，再装插件，最后重启 DSH。

1. 安装 CodeBuddy CLI¶

npm install -g @tencent-ai/codebuddy-code

可在普通终端运行 codebuddy 登录，或在安装插件后于 设置 → CodeBuddy → 添加账户 授权。运行 DSH 的用户必须能解析到 CLI；桌面应用 PATH 未更新时可配置 codebuddyBin。

2. 从 GitHub 安装插件（推荐固定版本）¶

需要本机 Git。将 web 换成实际使用的 DSH profile：

dsh plugin --profile web add "git+https://github.com/liubaicai/dsh-codebuddy-link.git#v0.3.30"

仓库包含已构建的 dist，安装不依赖 TypeScript 或安装时构建。跟随开发分支：

dsh plugin --profile web add "git+https://github.com/liubaicai/dsh-codebuddy-link.git#main"

3. 无 Git：Release 包¶

从 Releases 下载对应 .tgz，可用同页 SHA256SUMS.txt 核对。在下载目录执行（示例版本 0.3.30）：

dsh plugin --profile web add ./dsh-codebuddy-link-0.3.30.tgz

Windows PowerShell 使用 .\dsh-codebuddy-link-0.3.30.tgz；本地路径需带 ./、.\ 或绝对路径。

4. 启用¶

完全退出并重启对应 DSH 实例，在 设置 → CodeBuddy 获取模型列表，选择 codebuddy/default 或已启用模型。执行 /codebuddy status 可检查配置（不代表认证已成功）。升级时安装新版本标签或安装包后再重启。

典型用法¶

在会话中选择模型¶

安装并保存设置后，在 DSH 模型选择器中选 codebuddy/<模型ID>。默认模型用于未显式指定模型的调用（如 codebuddy_ask）；default 表示由 CLI 自身默认模型决定。

斜杠命令¶

在 DSH 会话中输入：

• /codebuddy status — 查看配置与运行态摘要
• /codebuddy models — 查看模型相关状态
• /codebuddy runs — 查看脱敏运行记录（与设置页「运行记录」一致）
• /codebuddy help — 命令说明

管理员 Cordis 配置示例¶

Cordis 插件名为 dsh-codebuddy-link。优先级：面板已保存设置 > 插件 config > 环境变量 > 默认值。

- name: dsh-codebuddy-link
  config:
    codebuddyBin: 'C:\Users\you\AppData\Roaming\npm\codebuddy.cmd'
    models: [default]
    timeoutMs: 600000
    tools: ''
    permissionMode: dontAsk

常用环境变量包括 DSH_CODEBUDDY_ENABLED、DSH_CODEBUDDY_BIN、DSH_CODEBUDDY_DEFAULT_MODEL、DSH_CODEBUDDY_MODE（dontAsk / plan / acceptEdits）等；完整表格见仓库 README「配置」一节。设置持久化在 ${DSH_HOME}/plugins/dsh-codebuddy-link/settings.json；账户在 accounts.json。

从未添加账户的旧安装仍可使用环境变量 DSH_CODEBUDDY_CREDENTIALS_FILE 指向 JSON 凭据文件；一旦启用多账户管理便不再回退 CLI 本地身份。

适用场景与注意¶

适合：已在用或计划用腾讯 CodeBuddy CLI，希望在 DSH 里统一选模型、做多账户调度，并需要 ACP 原生工具链与 DSH 会话并列的场景。

务必注意：

1. 插件以 当前 DSH 进程权限 启动 codebuddy；ACP 与权限跳过选项可能绕过沙箱，只应在可信环境使用。
2. 中国区浏览器授权与积分查询 不会 发往国际区接口；暂不支持国际区、企业额度、API Key 或加密凭据文件（以 README 为准）。
3. 计费接口非公开稳定 SDK；README 要求上线前与官方用量页核对，无法匹配时应保留未知状态。
4. workspaceRoot（默认当前 session 工作目录）为 ACP 原生执行必需，缺失时拒绝启动。
5. 安装前检查源码与 MIT 许可证；GitHub 安装或 Actions 不会读取 CodeBuddy 凭据，模型请求仅在本机 DSH 调用 CLI 时使用所配置授权。

结尾¶

dsh-codebuddy-link 把官方 CodeBuddy CLI 接进 DSH 的 Cordis 与 Web 设置流：ACP 主路径、独立委派、多账户与只读积分展示，避免自行逆向模型 API。DSH 生态强调「一切皆插件」；若需版本与 issue 跟踪，以仓库为准。

• 社区目录：https://www.skillhub.cn/plugins/liubaicai/dsh-codebuddy-link
• GitHub：https://github.com/liubaicai/dsh-codebuddy-link