English | 中文
把本机 AI 桌面客户端里已登录的模型，反向代理进 DeepSeek Harness（DSH）。
不新建 API Key，也不重走 OAuth：插件复用客户端的安装位置和登录态，客户端里能用的模型，DSH 里就能用。
| 厂商 | 模型 | 额度 | 思考强度 | 通道 |
|---|---|---|---|---|
| Qoder | 14 | 剩余积分 | 按模型给档位或开/关 | 子进程 + 控制帧 |
| WorkBuddy（含国际版 WorkBuddy AI） | 19 | 剩余积分 / 权益包 | 部分模型有档位 | HTTP + SSE |
模型数是一次实测的快照，会随账号状态和上游调整浮动。
| 版本 | |
|---|---|
| DSH 桌面端（实测） | 0.2.0-rc.2 |
| 声明的运行时范围 | ^0.2.0-rc.2（放行 0.2 整条线，拒绝 0.3） |
@deepseek-ai/dsh-llm |
0.2.0-rc.2（peer ^0.2.0-rc.2） |
@deepseek-ai/dsh-client-ui-plugin-manager |
0.2.0-rc.2 |
@deepseek-ai/cordis |
4.0.4（peer ^4.0.2） |
| Node | 24.21.0（要求 ^22.19.0 或 >=24） |
DSH 加载插件前，会把 peerDependencies 里的 @deepseek-ai/dsh* 与正在运行的版本比对，对不上就跳过整个 bundle：
dsh: skipping profile bundle "dsh-agent-bridge": Plugin dsh-agent-bridge@1.0.0 is
incompatible with dsh 0.2.1: peerDependencies {"@deepseek-ai/dsh-llm":"0.2.0-rc.2"}.
所以这里写范围而不是精确版本：精确锁会让 DSH 的每个补丁版都把插件静默跳过。被拒载时可以按「插件版本 × DSH 版本」单独放行：
依赖的 DSH 接口清单、升级后的自检步骤见 docs/compatibility.md。npm test 里的 test/compat.mjs 会检查这份声明有没有被改坏。
- 零配置：装好即用，不填 key、不二次登录。账号在客户端里切换，插件跟随。
-
一个包，两个组件：
cordis.patch.yml插两行 Loader，同一个模块、两个config.component。插件页显示一张包卡加两行组件，每行有自己的开关和详情页；关掉一家，另一家的路由、定时器、子进程不受影响。 -
流式对话，含思考过程：上游给
reasoning-delta就转发成 DSH 的折叠思考块。 -
思考强度：只显示上游声明的档位（
low / medium / high / xhigh / max，可关思考的模型多一个Off）。没声明就不显示，不猜也不探测。
-
额度在分组标题上：
Qoder · 2,427 credits left、WorkBuddy · 6,549 积分。 -
设置卡片：每行展开是「概览 / 模型 / 账号」三页签。额度按权益包给条，用尽的收成一行计数；模型列表与选择器同源；账号栏是驱动
locate()的原始结果。
-
卸载可恢复：卸载把该家的驱动目录移到
$DSH_HOME/agent-bridge-removed/<id>/，重装不会顺带装回来，点「恢复」可以还原。 -
故障隔离：驱动加载失败、缺客户端、注册冲突，都只让这一家显示「不提供」，另一家照常工作。
需要 Windows，已安装并登录至少一个受支持的客户端，DSH 桌面端在运行。两个驱动依赖 Windows 的安装路径与凭据文件，暂不支持 macOS / Linux。
- 取源码：
git clone https://github.com/AbyssWhalen/dsh-agent-bridge.git
cd dsh-agent-bridge- 把 bundle 登记进 profile（DSH 不会自动发现未登记的插件）：
// %USERPROFILE%\.dsh\profiles\desktop\package.json
{
"dependencies": {
"dsh-agent-bridge": "file:./plugins/dsh-agent-bridge"
},
"dsh": {
"profile": {
"bundles": [/* …原有项… */, "dsh-agent-bridge"]
}
}
}- 同步并安装：
.\tools\sync.ps1 # desktop profile
.\tools\sync.ps1 -Profile xxx # 其它 profile脚本会先确认 profile 清单里确实列了本插件，再复制源码、装依赖，最后逐文件比对源码与 node_modules 的哈希。改过源码要重跑一次并重启 DSH：pnpm 对 file: 依赖用硬链接，复制之后的改动不会自动同步。
如果 profile 里已有别的插件接管同一家厂商（例如 dsh-workbuddy-connect 与本插件的 WorkBuddy 驱动），只留一个：从 dsh.profile.bundles 去掉它，同时删掉 dependencies 里那条依赖，否则它还会留在磁盘上（虽然不加载）。DSH 对同一个 provider id 只接受一个 adapter，本插件遇到冲突只跳过冲突的那一家并记一条日志。
Qoder
- 需要 Qoder 桌面端已安装并登录，凭据在安装目录的
auth.v1.dat，只读取、不外发。 - 模型列表和额度走 Qoder 自己的接口；对话走它自带的 worker runtime，因为公开 HTTP 端点对第三方请求返回 503。
- 思考强度按
thinking_config给：有enabled.efforts的给档位，只有disabled/enabled的给开/关，两者都没有的不给控件。
WorkBuddy
- 国内版显示为「WorkBuddy」，国际版显示为「WorkBuddy AI」，装哪个出现哪个，两个都装就两组并存，各自用自己的账号和积分。
- 凭据文件加密，按
dsh-workbuddy-connect已公开的流程在本地解开，只用于本机请求。 Off的语义是不发这个字段，上游把缺省当作默认；两区端点都拒绝字面量off。- 模型名后的倍率和促销徽章（
GLM-5.3 · x0.79 credits、Hy3 · 免费）来自服务端字段，不是插件算的。
都是可选的，用于排查问题。
| 变量 | 作用 |
|---|---|
DSH_BRIDGE_POLL_MS |
模型/额度刷新间隔，默认 5 分钟，范围 5 秒 ~ 24 小时 |
QODER_INSTALL_DIR |
覆盖 Qoder 安装目录 |
WORKBUDDY_ELECTRON_BIN |
覆盖 WorkBuddy 可执行文件 |
WORKBUDDY_AUTH_FILE |
覆盖 WorkBuddy 凭据文件 |
npm install
npm test # 离线：契约与状态机，不需要客户端，不发网络请求
npm run test:host # 替身 ctx 跑真 apply()：注册、分组标题、开关隔离、路由权限
npm run test:soak # 反复开关 + 定时刷新，查适配器/路由泄漏（-Rounds=N 改轮数）
npm run test:collision # 另一个插件占着同一 provider id 时的降级与恢复
npm run test:live # 实机：两家各跑模型数 / 额度 / 两轮真对话
npm run test:counterfactual # 反向验证：把历史截断放回去，看 replay-shape 是否变红npm test与 CI 是同一组；test:host、test:soak、test:collision、test:live需要本机装着对应客户端，一个都没有时test:host打印SKIPPED。- 逐驱动探针：
node test/integration/leak.mjs qoder、node test/integration/turn-teardown.mjs qoder、node test/integration/drain.mjs workbuddy 20，分别查列模型后的子进程残留、一轮对话后的残留、收尾后事件循环是否干净。
实测记录见 docs/verification.md。
上面所有测试都是驱动直连。工具在真循环里能不能用，只有真循环能证明——只有那里，DSH 的系统提示才会推着模型去发起工具调用。搭法（隔离 DSH_HOME + headless profile）、判据（工具真执行 且 无标记泄漏，两条缺一不可）、排查表见 docs/real-loop.md：
pwsh -File tools/real-loop-check.ps1 -Profile e2e -Runs 5 -Provider qoderlib/
index.js 宿主：按组件挂载/卸载、注册 provider、刷新循环、日志
state.js 组件开关持久化、卸载/恢复
routes.js /plugins/dsh-agent-bridge/<id>/{status,action}
client.js 浏览器半身：包页 + 每行详情页
adapter.js 唯一的 LlmAdapter
catalog.js 模型与额度的本地快照
pool.js 会话池
messages.js DSH 消息 → 厂商中立消息
effort.js 思考强度归一化
quota.js 额度文本
driver.js 驱动契约校验
drivers/
qoder/ session.js 子进程通道 · upstream.js HTTP · conversation.js · models.js · locate.js
workbuddy/ seal.js 解密 · upstream.js · conversation.js · models.js · auth.js · locate.js
tools/
sync.ps1 同步源码到 profile 并安装
test/ 离线测试 · integration/ 宿主集成 · *-live.mjs 实盘
设计取舍见 docs/design.md。
宿主层形状沿用 dsh-workbuddy-connect，能对上的地方不另发明一套。
| dsh-workbuddy-connect | 本插件 | |
|---|---|---|
| 范围 | WorkBuddy（国内 + 国际两分组） | Qoder / WorkBuddy，一个包 |
| 组件化 | 一个 Loader 行 | 两个 Loader 行，各带开关与详情页 |
| 设置页 | 一张卡、三页签 | 包卡 + 每行一张卡、三页签 |
| 额度 | 输入框旁 + 卡片 | 分组标题 + 卡片 |
| 思考强度 | 声明优先，未声明的主动探测（消耗积分） | 只按声明，不探测 |
| 上下文窗口 | 国际版可切「用上游最大窗口」 | 只上报静态窗口 |
| 卸载 | — | 驱动移出包、可恢复 |
| 许可 | MIT（Corrine Hu） | MIT，保留其声明 |
两处不同是有意的：
- 不探测思考强度。 两家上游都把档位写在模型元数据里（Qoder 的
thinking_config、WorkBuddy 的supportedEfforts），没有需要试探才知道的模型，也就不发会扣额度的探测请求。 - 上下文窗口不是开关。 DSH 的请求契约里没有「这次请求换窗口」的字段，窗口是模型元数据，驱动压缩与计量。做成开关只能在上报时二选一，而两个数字都只对部分模型成立。
DSH 是编码代理，模型必须能调用工具才算真的能用。插件把 harness 的工具声明原样转给上游（WorkBuddy 是 OpenAI 的 tools 信封），并把上游流式返回的 tool_calls 片段重组成 harness 的分块序列（block-start → tool-call-delta → block-end，finish 报 tool-calls）。
历史里的工具调用也按原生结构重放：助手消息带 tool_calls，结果按 tool_call_id 对应。不要把它压成 [tool call: …] 文本——上游会拒绝一条没有对应调用的 tool 消息，而模型也分不清两次调用。
有工具时不再注入「你没有工具」的前导语：那和真实工具列表直接矛盾，模型会退回去用 <tool_call> 文本代替真正的调用，表现就是每轮都是空回复。
上游模型的调用通道偶尔不生效，它们会把调用当正文写出来。插件拦截并还原成真调用，而不是把标记流到屏幕上。截下来的一共五类：
<｜｜DSML｜｜invoke name="pwsh"> ← 原生 DSML，竖线数量与 `DSML` 有无都会漂移
<｜tool_name>pwsh</｜tool_name> ← 模型自创的语法，后跟 <command>…</command>
<｜tool_call><name>…</name><arguments>{…}</arguments></tool_call>
<｜｜｜▁begin｜>function<｜tool▁sep｜>pwsh ```json {…} ``` ← 分词器自己的控制 token
<｜｜｜｜call invoke="name">pwsh ← `invoke` 滑进了属性位，参数写成 <invoke name="command">…
第四类不是模型自创的方言，是它自己的函数调用 token 漏进了正文通道（▁ 是 U+2581，分词器代替空格的符号）。它的参数是围栏里的 JSON 对象，所以最好恢复。
第五类是位移：invoke name="pwsh" 里的 invoke 从标签名滑到了属性位上（call invoke="name">pwsh），参数同样写成 <invoke name="command">值</…parameter>。两种读法（属性是装饰 / 属性是字段名）对工具名的结论一致，所以能恢复而不是猜。
判定规则刻意宽松、删除规则刻意严格：
- 竖线上限 32 根、
DSML可省、开标签的parameter一词可省、_与 U+2581 互换——这些都在真机上出现过； - 裸竖线只在后面跟已知标签名时才算调用，所以
a || b、markdown 表格、<b>bold</b>原样通过；反过来说，某个形状的标签名不进那张表，它的开头就会在流式里被当成正文放出去； - 恢复不出参数就不执行。宁可显示原始块让用户看见发生了什么，也不能拿
{}去调工具——真机上这个错误让模型试了六次并最终判定「harness 坏了」；围栏里 JSON 截断、位移式缺参数时同理。
模型重复 ｜ 到预算耗尽（抓到过 500 根）算退化轮，按失败结束并说明原因，不当作回答渲染。
- 只支持 Windows。
- 只反代官方套餐通道，客户端里自己贴 Key 加的 provider 不会被接管。
- 额度是余额还是已用取决于厂商怎么报，插件照实显示，不换算。
- 能用哪些模型取决于客户端里的账号状态，插件不登录、不充值、不绕过限制。
- 改过源码要重跑
tools\sync.ps1再重启 DSH。
MIT，见 LICENSE。
宿主层设计（组件化 Loader 行、两条设置路由、能力探测边界）与 WorkBuddy 驱动的凭据解密流程派生自 dsh-workbuddy-connect（MIT, Copyright (c) 2026 Corrine Hu），许可声明已保留。