CodeBuddy Bridge（DSH 插件）

把本机的 CodeBuddy CLI 接进 DeepSeek Harness：DSH 派活 → 它干活 → 结论回注对话 → 逐轮核对它到底改了什么。 WorkBuddy 桌面版里内置的就是这套引擎，所以装了 WorkBuddy 也能直接用。

给模型看的用法写在 USAGE.md；本文件是给人和市场审核看的。

长什么样

面板（每轮的读取/修改打点 + 结论，可收起、可拖高）：

核对输出（PASS / FAIL + 证据，不花额度）：

输入框下方的开关：

它解决什么

让一个 agent 干活、另一个 agent 验收，人只负责拍板和最后一眼。现在多数的“协作”停在“它说它改了”， 这个插件补上最后一环：用 CLI 自己留的改前备份做内容 diff，给出 PASS / FAIL 和证据。

前置条件

• Windows（引擎路径按 WorkBuddy 的安装位置自动探测；其它平台未测）
• 已安装 WorkBuddy 桌面版（自带 CodeBuddy CLI），或自己装的 @tencent-ai/codebuddy-code
• 可选：dsh-connect-workbuddy 插件——relay 路线（/codebuddy）由它提供；没有它时其余功能照常

插件不接触、不保存、不转发任何凭据：认证完全由 CodeBuddy CLI 自己处理。

安装

dsh plugin --profile web add dsh-codebuddy-bridge

从仓库装（未发 npm 时）：

dsh plugin --profile web add github:<owner>/<repo>

安装后重启 DSH，输入框下方会出现「CodeBuddy 协作」胶囊。

首次使用

1. 点开胶囊（按会话独立；关着时工具会从该会话的 agent 作用域里收走）；
2. 对模型说「让 CodeBuddy 把 X 改了」——它调 workbuddy_relay(prompt, edit: true)；
3. 结论会以消息回注到对话，输入框上方的面板列出每步（读取/修改/执行）；
4. 说「验一下」，模型调 workbuddy_verify()，得到 PASS/FAIL + 证据。

工具

工具	作用
workbuddy_relay(prompt, edit?)	代敲 /codebuddy，结论回注对话（需要 dsh-connect-workbuddy）
workbuddy_verify(run?, session?)	核对某轮改没改：PASS/FAIL/WARN + 证据；不花额度
workbuddy_read(turns?, session?)	读 WorkBuddy 桌面版自己的会话记录
workbuddy_status() / workbuddy_close()	状态与会话管理
workbuddy_dispatch(task) + /dsh-handoff	老的文件交接兜底通道

工具名沿用 workbuddy_*：它们对接的一直是这台机器上的 WorkBuddy/CodeBuddy 引擎，改包名时没有跟着改，避免老文档和老习惯全断。

配置

cordis.patch.yml 或插件设置里：

字段	默认	说明
collabDir	~/.dsh/codebuddy-bridge	交换目录：轮次记录、模式开关、报告
permissionMode	acceptEdits	透传给引擎；bypassPermissions 为完全放行
cliPath	自动探测	CodeBuddy CLI 入口，仅 Windows 默认路径
productConfig	自动探测	让入口以 WorkBuddy 身份工作
model	引擎默认	透传 --model
timeoutMs	900000	单轮超时
watchMs	3000	兜底通道的轮询间隔

权限与隐私

• 读：~/.codebuddy/projects/<slug>/<session>.jsonl（CLI 自己的会话记录），用来生成面板和核对证据； 以及 ~/.workbuddy/projects（只有 workbuddy_read 读它）。
• 写：collabDir 下的几个 jsonl/md；引擎本身按 permissionMode 写工作区文件。
• 不碰：账号 token、登录态文件、任何网络请求（网络只发生在 CodeBuddy CLI 内部）。
• 面板要显示明细，所以会话记录的“工具调用参数摘要”会进入 DSH 的对话上下文——敏感工作区请自行评估。

限制

• 同一时刻一个 CodeBuddy 会话只能跑一轮。
• 面板不在右侧边栏（第三方插件开不了那个位置），放在输入框上方。
• 没有“运行中”的实时进度，只有跑完后的明细。
• workbuddy_verify 只能核对动作 + 文件事实；它说得对但没做的、或者做了没说的，都会标出来，判断仍然要人来做。

开发

node --check index.js
node --check client.js
npm test        # node:test，覆盖 verify 的判定分支

改 index.js：插件管理里关开一次即可。改 client.js：必须重启 DSH（客户端模块只在启动时扫描）。

License

MIT