前言¶
在 DeepSeek Harness（DSH）里做编码代理时，模型来源通常是云端 API Key 或 DSH 内置通道。若你已经在 Windows 上日常使用 Qoder、WorkBuddy（含国际版 WorkBuddy AI）等桌面客户端，账号和额度都在客户端里维护，再为 DSH 单独申请 Key 或重复 OAuth 往往多余。
社区插件 dsh-agent-bridge（维护者 AbyssWhalen，SkillHub 分类：模型推理）走另一条路：读取本机客户端的安装位置与登录态，把客户端里能用的官方套餐模型，以 DSH 的 LlmAdapter 形式注册进来。不新建 API Key，也不重走 OAuth。
这是什么¶
DSH Agent Bridge（npm 包名 dsh-agent-bridge，当前版本 1.0.0）是一个 DSH 桌面端插件 bundle。一句话定位：把本机 AI 桌面客户端里已登录的模型，反向代理进 DSH，作为额外的 model provider。
README 中的实测快照（会随账号与上游调整浮动）如下：
| 厂商 | 模型数（快照） | 额度 | 思考强度 | 通道 |
|---|---|---|---|---|
| Qoder | 14 | 剩余积分 | 按模型给档位或开/关 | 子进程 + 控制帧 |
| WorkBuddy（含国际版 WorkBuddy AI） | 19 | 剩余积分 / 权益包 | 部分模型有档位 | HTTP + SSE |
插件以当前 DSH 进程权限运行，会读取本机客户端凭据文件（只用于本机请求）。安装前请自行审阅 GitHub 源码 与 MIT 许可证；许可说明中注明宿主层与 WorkBuddy 凭据解密流程部分派生自 dsh-workbuddy-connect（MIT, Corrine Hu）。
核心功能¶
下面按 README 已写明的能力归纳，不超出资料范围。
零配置接入。 装好并登记进 profile 后即用，不填 key、不二次登录；在客户端里切换账号，插件跟随。
一个包、两个可独立开关的组件。 cordis.patch.yml 为 Qoder 与 WorkBuddy 各插一行 Loader，同一模块、两个 config.component。插件页是一张包卡加两行组件，每行有自己的开关和详情页；关掉一家，另一家的路由、定时器、子进程不受影响。
流式对话与思考块。 上游返回 reasoning-delta 时，插件转发为 DSH 的折叠思考块。思考强度只展示上游声明的档位（low / medium / high / xhigh / max；可关思考的模型多一个 Off），未声明则不显示控件，不做主动探测（避免扣额度）。
额度与设置 UI。 模型分组标题上显示额度文案（例如 Qoder · 2,427 credits left）。每行展开为「概览 / 模型 / 账号」三页签；模型列表与选择器同源，账号栏展示驱动 locate() 的原始结果。
工具调用。 插件把 harness 的工具声明转给上游，并把流式 tool_calls 重组成 DSH 的分块序列；历史消息按原生 tool_calls / tool_call_id 重放，不压成纯文本占位。
故障隔离与卸载。 某家驱动加载失败、缺客户端或 provider id 冲突时，仅该家显示「不提供」，另一家照常。卸载时将该驱动目录移到 $DSH_HOME/agent-bridge-removed/<id>/，可通过「恢复」还原；重装不会自动带回已移出的驱动。
DSH 版本约束。 声明的运行时范围为 ^0.2.0-rc.2（放行 0.2 线，拒绝 0.3）。peerDependencies 与运行中的 @deepseek-ai/dsh* 不一致时，DSH 会跳过整个 bundle。可按 README 在 %USERPROFILE%\.dsh\profiles\desktop\compatibility.json 中为特定「插件版本 × DSH 版本」单独放行。
安装与启用¶
环境要求（来自 README）：
- 操作系统：仅 Windows（驱动依赖 Windows 安装路径与凭据文件，暂不支持 macOS / Linux）。
- 客户端：至少安装并登录一个受支持的客户端（Qoder 或 WorkBuddy / WorkBuddy AI）。
- DSH：桌面端在运行；实测 DSH 桌面端为 0.2.0-rc.2，Node 要求
^22.19.0或>=24。
DSH 不会自动发现未登记进 profile 的插件。官方步骤如下。
1、取得源码并进入目录：
git clone https://github.com/AbyssWhalen/dsh-agent-bridge.git
cd dsh-agent-bridge
2、在 desktop profile 的 package.json 中登记 bundle 与 file: 依赖（路径按你实际放置插件目录调整）：
// %USERPROFILE%\.dsh\profiles\desktop\package.json
{
"dependencies": {
"dsh-agent-bridge": "file:./plugins/dsh-agent-bridge"
},
"dsh": {
"profile": {
"bundles": [/* …原有项… */, "dsh-agent-bridge"]
}
}
}
3、同步并安装依赖：
.\tools\sync.ps1 # desktop profile
.\tools\sync.ps1 -Profile xxx # 其它 profile
脚本会确认 profile 清单里列了本插件，复制源码、安装依赖，并比对源码与 node_modules 的哈希。修改源码后需重跑 sync.ps1 并重启 DSH（file: 依赖经 pnpm 硬链接后，复制之后的改动不会自动同步）。
若 profile 里已有其它插件接管同一厂商（例如 dsh-workbuddy-connect 与本插件的 WorkBuddy 驱动），dsh.profile.bundles 与 dependencies 里只保留一个；DSH 对同一 provider id 只接受一个 adapter。
典型用法¶
资料中没有单独的「对话示例」章节，日常使用路径是：完成安装 → 在 DSH 插件页打开对应组件开关 → 在模型选择器里选用 Qoder 或 WorkBuddy 分组下的模型 → 像使用其它 provider 一样发起编码代理会话。
可选环境变量（排查用，均有默认值）：
| 变量 | 作用 |
|---|---|
DSH_BRIDGE_POLL_MS |
模型/额度刷新间隔，默认 5 分钟 |
QODER_INSTALL_DIR |
覆盖 Qoder 安装目录 |
WORKBUDDY_ELECTRON_BIN |
覆盖 WorkBuddy 可执行文件 |
WORKBUDDY_AUTH_FILE |
覆盖 WorkBuddy 凭据文件 |
维护者在 README 中提供了离线测试与实机验证命令，例如 npm test（契约与状态机，不需客户端）、npm run test:live（需本机安装对应客户端）。实机前可先确认客户端内模型与额度是否正常。
适用场景与注意¶
适合谁： 已在 Windows 上使用 Qoder 或 WorkBuddy 官方套餐，希望在 DSH 编码代理里复用同一账号与模型列表，且接受 DSH 0.2.x 桌面端与 profile 手动登记 bundle 的安装方式。
务必注意：
- 只反代客户端里官方套餐通道；自己在客户端里贴 Key 加的 provider 不会被接管。
- 能用哪些模型、额度显示为余额还是已用，取决于厂商上报与账号状态；插件不登录、不充值、不绕过限制。
- 插件读取本机凭据，请以你能接受的信任边界安装，并检查源码与许可证。
- 与
dsh-workbuddy-connect相比，本插件合并 Qoder + WorkBuddy、组件化两行 Loader，且对思考强度不做探测；若只需 WorkBuddy 且依赖对方特有行为，需自行对比 README 中的对照表。
已知限制（README）： 仅 Windows；改过源码须重跑 tools\sync.ps1 再重启 DSH。
结尾¶
DSH 社区生态强调「一切皆插件」；SkillHub 目录页 与 GitHub 仓库 相互独立，并非 DeepSeek / 幻方官方应用商店。若你的模型资产已经在 Qoder 或 WorkBuddy 桌面端里，DSH Agent Bridge 提供了一条不重复配 Key 的接入路径：登记 profile、跑 sync.ps1、在插件页打开对应组件，即可在 harness 里选用本机已登录模型。
