DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-qwen-connect

d

dsh-qwen-connect

Manifest valid★ 1

DeepSeek Harness (DSH) Plugin: Reuse the login session of the QwenWorkCN desktop app with zero configuration, register it as a DSH model provider, and support streaming conversations, tool calls, image input, and live credit readings—all without an API key. A DSH plugin that reuses your QwenWorkCN desktop login as a model provider — streaming, tool calls, image input and live credits, no API key.

UI (client)hasBundlePatch

dsh-qwen-connect

把千问办公(QwenWorkCN)桌面 App 的登录态自动接入 DeepSeek Harness —— 零配置,不需要 API Key,不需要另外登录。

来源说明:本仓库衍生自 gaoqiaoliangjie666/dsh-qwen-connect—— 原始设计与协议逆向 / WASM 签名成果归属上游作者(MIT 许可)。 本仓库在其基础上追加(提交 e3ab432,2026-10):

  • 企业 VPC 租户支持:凭据 JWT iss 自动派生租户网关(lib/endpoint.js)、 organization_id / data_policy_agreed 补齐(修复 VPC 恒定 503)、 shim / seam 端点随凭据动态解析,公有云账号零行为变化;
  • 输入框实时积分读数:DSH 会话输入栏插槽显示剩余积分(lib/client.js);
  • DSH 0.2.x 兼容性修复:补齐 @deepseek-ai/dsh-llm-pi-ai peer 声明—— 缺失时装载期 import 被判为原生解析而失败,provider 静默不注册。

双端镜像:GitHub 本仓库 ↔ Gitee https://gitee.com/han-xiaos-whisper/dsh-qwen-connect; 姊妹项目(同一推理链的 Pi 编码代理宿主版): https://github.com/xiao-hans/pi-provider-qwenwork。

它做什么

能力状态
Provider 注册(模型出现在 DSH 模型选择器,名称含倍率)✅
设置卡片:账号 / 积分 / 套餐 / 模型列表(含配额进度条)✅
凭据(Windows DPAPI,或非 Windows 明文 JSON)✅
账号 / 额度 / 套餐 REST 查询✅
真实对话(WASM 签名 + SSE 聊天端点)✅
流式输出 + 多轮上下文✅
工具调用(tools 透传 + tool_calls 协议转换)✅
图片输入(DSH 附件服务 → chat_context.imageUrls)✅
token 统计(上游 raw_usage → OpenAI usage)✅
上游重试(限流 / 网关瞬时故障,最多 3 次)✅
请求方鉴别(shim 共享密钥 + 常量时间比较)✅
动态模型目录(签名 GET /api/v2/model/list,10 分钟缓存,失败保留上次结果)✅
设置页一级导航卡片(settings.section + 图标,与 WorkBuddy / Trae 同层)✅
导航图标用宿主同族图标(primitives 的 Icon*OutlineMedium)✅

动态模型目录

上游 GET /algo/api/v2/model/list 经 WASM 签名(mode: 'auth')可直接取, 返回按场景分组,千问办公用 qwork 那一组。插件启动时拉一次,之后每 10 分钟 到期再拉;读模型列表与读卡片状态都会触发「到期才拉」的后台刷新。

  • 失败不清空:保留上一次成功的真实目录并标 stale,卡片写明「显示上次成功的目录」; 从未拉成功过则用内置兜底表,卡片写明「内置兜底目录」。
  • 不编造数字:price_factor 缺失就不显示倍率(填 0 会被渲染成「免费」); 上下文窗口取 context_config 的默认档,不是 max_input_tokens。
  • 促销如实透传:promotion.badge 的原文(如「限时2折」)直接进选择器名与卡片徽章。

静态兜底表仍保留在 lib/models.js,供离线 / 未登录时使用。

图片输入(视觉)

上游模型具备视觉能力,本插件已打通完整链路。DSH 侧的三个条件必须同时成立:

  1. 模型描述符声明 image 模态(lib/models.js)
  2. pi-ai 配置了 resolveAttachments(lib/index.js 从 ctx.get('attachments') 取)
  3. shim 把图片转成上游认的形态

前两条是联动的:插件按附件服务是否可用动态决定是否声明 image (createQwenWorkAdapter 的 imagesAvailable)——避免「声明了却用不了」 (DSH 会抛 pi-ai image input requires the durable attachment service)。

上游要同时收到两样东西才认图(六变体对照实验的结论, 见 research/probes-2026-09-14/probe-image-format.mjs):

条件位置
① 有图标记chat_context.imageUrls(data URL 数组,无图时为 null)
② 多模态内容messages[].content 是含 image_url 的数组

任一缺失,模型都会回复「我没有看到您上传的图片」。因此 toQwenWorkMessages 对含图消息保留数组 content(不再塌缩成纯文本),collectImageUrls 只取最后一条 user 消息里的图(避免重复分析历史图)。

架构

lib/index.js            host 侧入口:注册 qwenwork provider + 挂载状态路由
lib/client.js           浏览器侧入口:设置卡片(__ModuleLoader__.load 包装)
lib/web-status.js       状态路由:loopback-only + JWT 脱敏,汇总卡片数据
lib/credentials-seam.js 与凭据层的唯一接缝(不重复实现解密)
lib/signer-session.js   WASM 签名会话 + 请求体构造
lib/chat-shim.js        环回聊天 shim:OpenAI ↔ QwenWork 协议转换 + 工具调用 + token 统计
lib/signer-shim.js      chat-shim 的稳定转发层(集成方从此导入)
lib/sse.js              健壮 SSE 解析 + OpenAI 分块编码 + usage 归一化
lib/runtime-identity.js Cosy-Version / machineId 的动态解析与多级回退
lib/models.js           静态模型目录(取自 App 日志的 rawModels,未臆造)
lib/loopback.js         环回访问判定(挡 DNS-rebinding)
lib/status-paths.js     host / client 共享常量

凭据与 REST 实现(lib/credentials.js、lib/auth.js、lib/rest.js、 lib/errors.js、lib/dpapi.js、lib/api.js)。集成层只通过接缝消费, 不重复实现任何解密逻辑。

模型目录

三个模型均取自 App 日志的 rawModels,无臆造:

id名称倍率视觉上下文
pro高级1.00x✅1M(默认)
flash标准|Qwen3.8-Flash0.10x✅1M
qwen3.8-max-previewQwen3.8-Max1.10x✅1M

maxOutputTokens: 32000;可选上下文档位 200K / 400K / 1M。

安全边界

  1. 绝不下发凭据:状态路由只回状态摘要,token 从不跨到浏览器。
  2. 错误信息脱敏:eyJ... 形态 JWT、Bearer xxx、token=... 一律替换后 才下发(卡片是浏览器渲染面,泄漏即等于泄漏到 DOM 与 devtools)。
  3. 只信任环回:Host 必须是 127.0.0.1 / localhost / [::1],非空 Origin 也必须是环回 —— 挡掉 DNS-rebinding 页面。
  4. 不编造数值:上游返回 null 的额度字段保持缺失,不会 Number(null) → 0 显示成「已用 0」。
  5. 失败降级:凭据缺失 / 加载失败时显式抛 QwenAuthError,卡片显示可操作 的修复提示;apply() 永不抛异常(避免 DSH 红色 "Failed to load plugins" 横幅)。

验证

node tools/verify-all.mjs        # 一键跑全部 5 项
项目内容
test/web-status.test.mjs12 项:脱敏、环回 403、凭据错误降级、null 不变成 0
tools/client-load-check.mjs5 项:__ModuleLoader__ 契约、slot key/priority、slot API 损坏时降级
tools/host-load-check.mjshost 入口可加载性
tools/apply-check.mjsprovider 注册行为 12 项断言(含两条降级路径)
tools/seam-live-check.mjs端到端真实 API 实测 + JWT 不下发断言

端到端实测输出(合成示例,实际值随账号与消耗变化):

nickname: Test User   account: testuser01   remaining: 2100   tierName: Free

安装

插件已发布到 npm,装进 DSH profile 即可(桌面版 profile 在 %USERPROFILE%\.dsh\profiles\desktop):

cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm add @xiao-hans/dsh-qwen-connect

装完确认 profile 的 package.json 里 dsh.profile.bundles 含 @xiao-hans/dsh-qwen-connect, 然后完全退出 DSH 再重启(host 侧只在启动时加载插件)。

卸载

cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm remove @xiao-hans/dsh-qwen-connect

并从 dsh.profile.bundles 移除同名条目,再重启 DSH。

本地源码调试

改 lib/ 时不想每改一次就发一个版本,用 Junction 把源码挂进 profile(改动即时生效):

node tools/install-to-dsh.mjs --dry-run   # 先预览
node tools/install-to-dsh.mjs             # 接线(自动备份 profile 配置)
node tools/install-to-dsh.mjs --uninstall # 移除接线,不动源码

它做三件事:profile 的 node_modules 下建 Junction、在 profile package.json 登记三处 (dependencies / dsh.profile.bundles / pnpm.overrides)、建依赖桥让插件能解析到宿主 peer 依赖。 详见 安装说明.md。

流收尾语义(为什么回合不会「突然不动」)

流式推理需要区分正常收尾、截断、超时和客户端取消。shim 按以下情况给下游明确结果:

情况shim 行为
已开流后上游静默(首帧前 90s / 首帧后 300s)写带 upstream idle timeout 标记的 error 帧 + [DONE],并 abort 上游;DSH pi-ai 将其归为 TIMEOUT
上游没给 finish 帧就断流有产出 → finish_reason: "length"(截断如实上报);无产出 → error 帧 + network_error
流里出现过 tool_calls,上游却标了 stop纠正为 finish_reason: "tool_calls",否则下游的 agent 循环会停在工具调用之前
整回合只有思考、正文与工具调用都没有error 帧(empty_answer)+ network_error,让下游重试(实测过 340s 思考、9.5 万字符思考链、0 正文)
客户端中途断开abort 上游请求,取消的回合立刻停止生成

空闲超时错误示例为 upstream idle timeout: no data for 300000ms。timeout 标记让 DSH 的 pi-ai adapter 产出 TIMEOUT,而不是通用的 PI_AI_ERROR。启用宿主 llm-retry 时,由 provider 的既有重试策略控制次数、退避和取消;shim 不在已经开始的流内重放请求。

FIRST_CONTENT_TIMEOUT_MS 保持 90 秒,首个原始数据块之后的空闲预算保持 300 秒。 任意原始上游数据块(含心跳)都会重置空闲计时,正文、思考和 token 统计各自处理。

回归测试:node --test test/unit/stream-robustness.test.mjs test/unit/chat-shim-timeout-diagnostics.test.mjs。 完整 npm test 需要 DSH 宿主提供的 peer 依赖;普通 Node 环境的依赖缺失应与插件行为失败分开判断。

请求级流诊断

日志位于 os.tmpdir()/dsh-qwen-connect-trace.log,上限 2 MiB(超过即截断重开)。 Pi 侧插件(pi-provider-qwenwork)固定写自己的 pi-qwenwork-trace.log:两边共用 一个文件时,本包宿主的活跃流量会在几十分钟内把 Pi 侧的事故记录轮转出上限。 单测必须用 QWEN_CONNECT_TRACE_PATH 把写入重定向到项目内临时目录 (test/unit/trace-sandbox.mjs 已统一处理),否则故障注入的伪数据会被误读成线上事故。 同一推理链的 Pi 版与 DSH 版使用一致的字段语义,以 source 和 pid 区分来源。

字段含义
source / pid本插件为 dsh-qwen-connect,并记录当前进程号
requestId / responseId每个本地请求独立的 UUID;对应 SSE 的 chatcmpl-<UUID>,用于关联该请求的日志
upstreamSessionId / upstreamRequestIds上游对话 ID 与白名单响应关联头;上游未返回关联头时保留空对象
lastChunkAt / idleMs本地最后读到原始数据块的时间与距该时刻的间隔;尚无数据块时前者为 null
upstreamChunks / upstreamBytes原始数据块数与字节数,与解析出的正文长度分开统计
outputChars / thinkingChars / toolCallsEmitted / usageSeen正文长度、思考长度、是否转发工具调用、是否收到有效 usage
watchdogDelayMs / eventLoopDelayMs看门狗回调相对单调时钟截止点的延迟;流读取期间事件循环延迟的最大值、p99,单位为毫秒、采样分辨率 20 ms,尚无采样时为 null

超时与流结束事件包含上述流摘要;首个原始数据块另记一次事件,不逐块刷日志。 这些记录不包含原始提示词、思考正文、凭据或全部响应头。lastChunkAt 是本地读取时间, 不能单独证明远端模型何时停止生成;需结合上游关联 ID、事件循环延迟与链路证据定位。

每个请求都必须留下一条终止记录

排障时踩过的坑:2026-10-30 一次 502 风暴里,33 条请求在日志中只有 request-in, 之后一行都没有,于是无法判断它们是我们提前返回、客户端先挂断,还是处理器抛异常。 三类原因都存在:若干提前返回分支只回错误不写日志;res.on('close') 过去要到 SSE 阶段才注册;readBody() 在客户端写完半截就断开时既不 end 也不 error,直接悬挂。

现在每个请求恰好一条终止记录:

终止事件含义
reject + reason提前返回:method / loopback / auth / body-too-large / body-read-failed / invalid-json / no-messages / no-user-message / signer-session
upstream-fail / upstream-rejected上游发起失败或被拒(原有行为)
stream-end已进入流式阶段(原有行为)
request-end + stage上述之外就结束了:ended:false 表示客户端在完成前断开,ended:true 表示处理器抛异常后由外层回了 500

回归测试:node --test test/unit/chat-shim-request-observability.test.mjs(含「只写半截 JSON 就拆连接」的真实 socket 用例,验证它不再悬挂且一定留下可读的终止记录)。

自动续跑与用户停止的优先级

模型有时会「宣告下一步却直接 stop」,lib/stall-detector.js 的 detectStall() 判定该形态后, lib/stall-guard.js 在 agent/turn-stopping 钩子内通过 agent.steer(...) 原位补一条 notice 让当前轮继续(上限 MAX_AUTO_CONTINUES = 2,用户本人发言后重新计数)。

为什么挂在 agent/turn-stopping 用 agent.steer(),而不是在 agent/status(idle) 里调 followup(): dsh-agent-loop 在「本轮即将收尾、模型不再欠回复」时串行触发 agent/turn-stopping; 监听器在此处调用 agent.steer() 会把消息压入 nextStep 队列,状态机直接在当前轮内继续下一步, 不会切入 idle,前端 running 始终保持 true(「停止生成」按钮常驻,不会闪烁或退化成「发送」按钮), 也彻底避开了 agent/status(idle) 同步广播栈内重入导致 api-session/status 翻转成 false 的问题。

这条机制同时保证永远排在用户的停止之后:

情况插件行为
agent/turn-stopping 触发原位续跑调用 agent.steer() 在本轮内继续,不切 idle,「停止生成」按钮常驻
signal.aborted 为真,或回合以 aborted / error / interrupted 收尾立即放弃续跑并置会话打断锁定,不再自动续跑
被打断之后由后台任务/通知类消息开的新回合(source.kind !== 'user')仍不续跑——只有用户本人发言(source.kind === 'user')才解除打断标记并重置预算
收件箱已有待处理输入(agent.inbox.hasPending)跳过续跑,让用户的输入优先处理,不抢在其前面
确认/复述长期规则约定(「以后遇到…我会先…」)detectStall 返回 verdict: 'standing-rule' 否决,不误触发续跑
agent.inbox 投影未激活导致读取抛错按未知处理,维持既有续跑,观测失败不得吞掉功能

回归测试:node --import ./tmp/with-dsh-sdk.mjs --test test/unit/stall-guard-stop.test.mjs。 判定口径本身(哪些正文算半途停止)由 test/unit/stall-guard.test.mjs 锁定。

非 Windows 凭据

Windows 上默认仍读 %APPDATA%\QwenWorkCN 的 DPAPI 加密凭据。没有 DPAPI 的系统 (Linux / macOS)可以改用明文 JSON。只有没显式传入 appDataDir 时才会读它:

优先级位置
1环境变量 QWENWORK_CREDENTIAL_FILE
2~/.dsh/qwenwork-desktop.json

JSON 对象至少要有字符串字段 token。自动续期还会用到 refreshToken、expiresAt、 refreshTokenExpiresAt;其它字段原样保留。刷新成功后写回同一文件(先写同目录临时文件, 再改名替换)。这个文件里是登录态明文,权限用 0600,不要提交进仓库。 文件不存在时仍走原来的 DPAPI 路径。JSON 损坏或缺少 token 时抛 QwenAuthError(SCHEMA_INVALID),提示里带文件路径。

已知限制

  1. Windows 加密凭据绑定当前用户:默认路径走 DPAPI,auth-v2.dat 不能拷到别的机器或账户。其它平台用上面的明文 JSON。
  2. 工具调用已透传,视觉输入仍不支持:tool_calls 分片(含 index/id/ function)原样转成 OpenAI 形状,收尾时把上游常标的 stop 纠正为 tool_calls;图片输入仍会被 shim 丢弃(toQwenWorkMessages() 只保留 type: 'text' 块)。
  3. DPAPI 依赖 PowerShell 兜底:本机未装 koffi/ffi-napi,走 PowerShell 子进程(每进程约几十毫秒)。
  4. 模型目录是静态的:/api/v2/model/list 需要 WASM 签名(403), 目前用内置的三模型目录,不动态拉取。
  5. quota.total 对 Free 套餐为 null:卡片按「未提供」处理,不显示 0%。
  6. 签名依赖官方 WASM:research/wasm.bin 是从官方 App 产物提取的签名模块, 由 package.json 的 files 字段随包发布(npm 包与 dist 包内都带),换机器 无需重新提取;需要整体重提时用 node research/wasm-extract.mjs。
  7. Cosy-Version 动态解析:优先读 App 产物里 SDK 的 COSY_VERSION 常量(实测 1.1.32),失败时回退安装目录版本号,最后回退常量。 来源会记在 signerSession.describe().cosyVersion.source 里。
  8. 思考链无法关闭:QwenWork 网关服务端强制思考,实测对 enable_thinking:false、chat_template_kwargs.enable_thinking:false、 reasoning_effort:"none" 等客户端字段全部无视(research/buddy2api-probes/ probe-disable-thinking.mjs 五变体对照)。宿主设 thinking="off" 只是不请求 思考,并不能关掉它。DSH 侧应容忍 thinking 通道(pi-ai 会把 reasoning_content 转成独立 thinking 块,不污染正文)。

聊天接入架构(阶段 A-2)

DSH / pi-ai ──OpenAI 协议──▶ 环回 shim ──WASM 签名+加密──▶ gateway.qwenwork.cn
            ◀──OpenAI SSE──           ◀──双层信封 SSE──
  • shim 由 lib/chat-shim.js 实现,监听 127.0.0.1 随机端口,仅接受环回 请求(Host/Origin 双校验,挡 DNS-rebinding)。
  • provider 的 baseUrl 在 shim 就绪后指向 http://127.0.0.1:<port>/v1/chat/completions。
  • 签名头 Authorization: Bearer COSY.<...> 由官方 WASM 生成,绝不能被 Bearer <accessToken> 覆盖(覆盖即 403 Signature invalid)。

Comments

Loading…