dsh-connect-qwenwork
把 千问办公（QwenWork） 接入 DeepSeek Harness（DSH）。
插件读取本机已登录的千问办公桌面客户端凭证，在 127.0.0.1 上起一个 OpenAI 兼容的
回环桥，把 DSH 的模型请求翻译成千问办公真正使用的会话协议。
这份文档的协议结论是实测出来的
本文写于 2026-10-22，当时机器上装着千问办公桌面客户端并已登录，因此下面的 协议与凭证格式都在真实上游上跑通过（不是从 bundle 推断的）。三个关键结论 与早期的猜测相反：
| 早期猜测 | 实测结果 |
|---|---|
会话凭证在 Chromium 的 Cookies 库里 |
不在。那个库里只有一个统计 Cookie（.mmstat.com / cna）。真凭证在 auth-v2.dat |
上游用 Cookie: 鉴权 |
用 Authorization: Bearer <JWT>。同一 token 放 Cookie 里无效 |
会话协议是标准 ACP（initialize/session/new/session/prompt） |
是带信封的 JSON-RPC，方法名叫 join / new_prompt。标准 ACP 的方法名一律被拒：Unknown control method: initialize |
一条真实的对话回合（实测时间线）
REST POST /api/chat-sessions Authorization: Bearer <jwt> → 201 { id }
WS wss://qwenwork.cn/api/chat-ws Authorization: Bearer <jwt> → 101
→ {type:"control", payload:{method:"ping"}} → pong
→ {type:"control", payload:{method:"join", params:{sessionId}}} → join_ack {accepted:true}
→ {type:"control", payload:{method:"new_prompt", id:1,
params:{sessionId, prompt:[{type:"text",text}]}}}
← result { promptId, turnId } 只是"接受了"
← new_prompt_ack {accepted:true}
← session_status: idle **上一轮遗留，必须忽略**
← session_status: running 本轮真的开始
← session/update: agent_thought_chunk 思考增量
← session/update: agent_message_chunk 正文增量
← session_status: idle **本轮结束**
一次「一句话 + 单独一行 DONE-OK」的回合实测约 15–17 秒（上游是 agent 型会话， 有固定的沙箱启动开销）。
信封很重要：裸 JSON-RPC 会被回
{"code":-32700,"message":"unknown envelope type"}，必须包一层
{"type":"control"|"data", "payload":{...}}。带 seq 的 data 帧承载
session/update 通知，control 帧承载方法与响应。
结束判据（最容易写错的地方）：idle 在本轮开始前也会来一条，单看"有没有
idle"会把回复截断成空。判据必须是「见过 running 或正文增量之后的 idle」。
三层结构
DSH / pi-ai 本插件 千问办公
────────────── ─────────────────── ──────────────
chat/completions ──► bridge.js (回环 HTTP)
│ 压成一条 prompt 文本
▼
acp.js (控制信封) ──► wss://qwenwork.cn/api/chat-ws
▲ join / new_prompt
│ session/update …
SSE delta ◄── data 帧
desktop-auth.js ◄── 读取本机 %APPDATA%\QwenWorkCN\auth-v2.dat
接缝的选择与参考插件 dsh-connect-workbuddy
一致：回环 HTTP + pi-ai 适配器。理由也一致——DSH 的 adapter 契约是内部 API，
而回环地址 + OpenAI 兼容协议是稳定的外部契约。
凭证从哪来
按优先级：
- 插件设置里的
token—— 手填 Bearer 之后的那段 JWT，最高优先。 - 环境变量
QWENWORK_TOKEN—— 同上，适合脚本化环境。 - 千问办公桌面客户端的
auth-v2.dat（推荐，复用客户端的登录）。
auth-v2.dat 的解密链
实测的文件在 %APPDATA%\QwenWorkCN\auth-v2.dat（Electron 的 userData）：
Local State → os_crypt.encrypted_key base64("DPAPI" + DPAPI(<32 字节>))
──DPAPI──► 32 字节主密钥
auth-v2.dat = "v10" + nonce(12) + AES-256-GCM 密文 + tag(16)
──AES-GCM──► 明文 JSON
明文 JSON = { token, refreshToken, expiresAt, user: { name, planName, … } }
解出来的 token 是 JWT，iss: qwenwork.cn、aud: oauth_app、
app_id: qwenwork-desktop-app。同目录下还有一份更老的 auth.dat，它的 token
是 "placeholder-token-for-claudecode-sdk" 占位值——插件用"看起来像 JWT"这条
检查把它筛掉，避免把占位值发给上游（那会得到 401，然后用户被告知"没登录"）。
同目录还有两个取值名（QwenWork / QwenWorkCN），插件都扫。
一个必须知道的限制
DPAPI 解密需要起一个 powershell 子进程（ProtectedData::Unprotect）。
在禁止派生子进程的执行环境里这一步会失败（实测到 spawnSync powershell EPERM）。
那时插件会明确报 cannot spawn powershell (EPERM); this process is not allowed to start child processes——不是"登录态坏了"，重新登录没有用。此时用方式 1 手填 token。
同理，客户端正在运行时它的 Cookie 库被独占打开，任何方式都读不到（实测
File.Copy / cmd copy / esentutl 全被系统拒绝）。不过 auth-v2.dat 不在
那条路径上，所以凭证读取不受影响。
失败分类（每条指向不同的修复动作）：
reason |
含义 | 怎么办 |
|---|---|---|
missing |
该路径不存在 | 装客户端，或先登录一次 |
unreadable |
文件存在但打不开 | 退出占用它的程序 |
invalid |
解开后不是 JSON / 不是库 | 文件已损坏 |
encrypted |
容器解不开 | 见上文的 DPAPI 限制，或改手填 token |
no-session |
能读，但 token 不是 JWT |
该文件是旧格式/未登录 |
unsupported-platform |
该平台的密钥取法未实现 | 手填 token |
一个必须遵守的接入约束
本插件用静态 import 引宿主的 @earendil-works/pi-ai 等包。这不是风格选择：
那些包只在 DSH 的 app.asar 里，profile 的 node_modules 中不存在，只有宿主的
模块系统认得。改成动态 await import() 会 ERR_MODULE_NOT_FOUND，让 apply()
静默放弃注册——表现为「插件装了但模型列表里没有」，且没有报错。
细节与实测证据见 docs/HOST_IMPORTS.md。
安装
# 从 GitHub 安装（npm 发布前先走这条）
dsh plugin --profile <你的 profile> add github:tang-bugu/dsh-connect-qwenwork
# 或从本地目录安装
dsh plugin --profile <你的 profile> add "file:/path/to/dsh-connect-qwenwork"
dsh plugin add 会同时写 dependencies 与 dsh.profile.bundles——后者才是
Cordis 树真正读取的列表，手改 node_modules 不够。
本包自带的 cordis.patch.yml 会随 bundle 层一起生效，把插件挂进 Cordis 树，
不需要再手改 profile 的 cordis.patch.yml。装好重启 DSH 即可在模型选择器
里看到 qwenwork。
⚠️ 用
file:安装时不要跑dsh plugin remove：file:是复制而非链接， remove 会把源目录清空。详见docs/INSTALL.md。
设置卡片
插件自带一张卡片，注册在设置页的 Plugins → 本插件 行里
（plugins.row.config 槽位）。它显示：
- 是否找到登录态、账号名与套餐、凭证文件在哪；
- 桥是否就绪、它的回环地址；
- 每一条读取尝试的失败分类，并给出对应的修复动作；
- 可用的模型档位。
卡片上可以手填 Bearer token，写入 token 字段。留空并保存等于 unset
（恢复自动读取），而不是写空串——后者会存一个"存在但为空"的覆盖层。
卡片本身不接触任何 token：它读 Host 的只读路由
/plugins/dsh-connect-qwenwork/status，那份 JSON 只给来源、身份片段与字节数。
为什么是手写卡片：
@deepseek-ai/dsh-settings文档的原话是「autoGenerate…供客户端按 schema 建页面；目前还没有客户端这样做」。只声明 schema 等于 用户没有界面可填，所以插件自带一个。schema 仍要声明——设置页的写入校验走 序列化后的 Config schema。
诊断
npx dsh-connect-qwenwork doctor # 本机状态 + 上游验证
npx dsh-connect-qwenwork doctor --json # 机器可读
npx dsh-connect-qwenwork status # 只读，不联网
doctor 分两段报告：本地能看见什么（不联网，永远有答案），以及上游认不认
（联网，可能因网络本身失败）。混在一起会让「网络不通」看起来像「没登录」。
输出绝不包含 token：只给路径、来源与身份片段。身份信息也脱敏（邮箱保留 首字母与域，用户 id 只留前 6 位）。
模型目录
千问办公的模型选择器提供四个档位（官方文档）： 高级 / 基础 / 经济 / Qwen3.8-Max。文档明确说模型列表会持续更新、旧模型会被替换， 所以上游真正接受的 id 无法从文档静态推出。
因此：
- 目录里每个模型带
source字段，标明来自documented-tier还是上游实测； - 拿不到上游目录时保留这四个档位作为回落，而不是给空列表；
- 绝不编造看起来像真模型 id 的字符串——那会让用户选到一个永远失败的模型。
（建会话时上游回的 extra_data.mode 实测是 "flash"，模型档位由上游自己
按账号与套餐决定，new_prompt 不接受逐轮指定模型。）
安全边界
- 桥只
listen('127.0.0.1')，不接受外部连接； - 每次进程启动生成随机 bearer token，pi-ai 侧用它作
apiKey，桥做常量时间 校验（绑定回环不够：同机进程能猜端口，但猜不到 token）； /healthz不需要 token，且不泄露任何信息；- 未知路径回 404 不回显路径；
- 客户端断开时立即 abort 上游，避免继续消耗用户的额度；
- 插件不写上游的登录态，也不启动任何 OAuth 流程。
已知限制
- 每条 DSH 请求开一个新的上游会话。 复用会话会把 DSH 已经组装好的上下文 重复跑一遍（上游会话是有状态的 agent 会话），等于重复计费；代价是上游侧 会留下较多短会话。
- 只发送文本。 图片与文件标注为
[image omitted: …]占位符而不是静默丢弃， 但也不会上传。 new_prompt不接受逐轮指定模型。 模型档位由账号/套餐决定；插件目录里的 四个档位只作为 DSH 模型选择器的可选项。- 空回合由超时兜底。 上游若只回一条
idle而没有正文，本轮要等到 idle 超时才收尾（这是"上一轮遗留的 idle"与"这一轮真的空回复"在消息层面无法 区分所致）。
模块地图
| 文件 | 职责 |
|---|---|
src/index.js |
插件入口：配置 schema、provider 注册、状态路由、生命周期 |
src/desktop-auth.js |
读 auth-v2.dat（DPAPI → os_crypt → AES-GCM → JWT） |
src/auth.js |
旧的 Cookie 发现/解密层，保留供诊断对照 |
src/acp.js |
会话客户端：控制信封、join/new_prompt、事件归一化 |
src/bridge.js |
回环 HTTP 桥（OpenAI 兼容 → 会话协议） |
src/wsclient.js |
无依赖的 RFC 6455 WebSocket 客户端（需要自定义握手头） |
src/sqlite.js |
无依赖的只读 SQLite 读取器（供 auth.js 用） |
src/bin.js |
doctor / status 诊断 CLI |
lib/client.js |
浏览器侧设置卡片（window.__ModuleLoader__ 自注册脚本，不需打包） |
发布
发布由 tag 驱动：推一个 v* 标签，GitHub Actions 自动跑测试、发布 npm
并建 Release。
npm run release # 测试 -> bump patch -> 打 tag -> 推送
一次性的 secret 配置与完整说明见 docs/RELEASE-CI.md。
合并代码不会发布——npm 的版本号一旦发布不可覆盖，所以「发布」必须是一次显式声明。
开发
cd dsh-connect-qwenwork
npm test
九个套件、141 个用例，全部不联网、不依赖 npm 包。
| 套件 | 用例 | 覆盖 |
|---|---|---|
wsclient.test.mjs |
13 | 握手、分片、控制帧、掩码、超大帧、UTF-8 校验 |
sqlite.test.mjs |
32 | 头部、序列类型、rowid、溢出页、损坏输入 |
bridge.test.mjs |
15 | token 鉴权、SSE 顺序、finish_reason、错误路径 |
acp.test.mjs |
23 | 控制信封、事件归一化、流式时序、遗留 idle、断线 |
e2e.test.mjs |
6 | 假会话上游 → 真客户端 → 真桥 → OpenAI 客户端 |
auth.test.mjs |
19 | Cookie 组头、主机匹配、路径、失败分类 |
host.test.mjs |
13 | apply() 的 provider 注册、目录、模型发现 |
card.test.mjs |
18 | 状态路由脱敏；lib/client.js 真实执行；字段名对账 |
cli.test.mjs |
2 | CLI 模块顶层求值、help 里的子命令与实现对账 |
两个值得单独说的：
host.test.mjs需要@earendil-works/pi-ai等宿主依赖才能真正注册。 测试用test/fixtures/stubs里形状一致的桩包，运行前后自动链接/拆除 （tools/link-test-stubs.mjs），跑完不留会骗过pnpm install的node_modules。cli.test.mjs覆盖bin.js——那是用户跑的第一条命令，且它引用的函数名没有编译期保障。 本会话里真的发生过：Host 把readSession/verifySession换成readCredential/verifyCredential后，bin.js还在调旧名字，doctor一跑就抛；没有测试 覆盖到它，因为其它套件根本不碰 CLI。card.test.mjs里有两条字段名对账测试：把lib/client.js当文本读， 取出它引用的配置字段与状态字段，跟 Host 的 schema/状态文档逐个比。这类 bug（Host 改名、卡片没跟上）会静默渲染成"未登录"，没有任何报错—— 值得钉死。
许可
MIT
No comments yet. Be the first to write one.