dsh-qwen-connect

DSH PLUGIN视觉与多模态

仓库 xiao-hans/dsh-qwen-connect

视觉与多模态 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

DeepSeek Harness (DSH) 插件:零配置复用千问办公(QwenWorkCN)桌面 App 的登录态,把它注册为 DSH 模型 Provider,支持流式对话、工具调用、图片输入与实时积分读数,无需 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.

一句话选型结论

按资料字段整理

dsh-qwen-connect 是视觉与多模态类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类视觉与多模态 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-29 创建于 2026-10-26
README 16.9 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add @xiao-hans/dsh-qwen-connect
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

视觉与多模态
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

视觉识别办公自动化

上游标签

coding-agentdeepseekdsh-pluginllmmodel-provideropenai-compatibleqwentool-calling

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在视觉与多模态场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-qwen-connect当前 L4 · 沙盒安装通过 低风险 0 未标注 有
open-design L4 · 沙盒安装通过 低风险 10.0 万 未标注 有
awesome-gpt-image-2 L3 · 安装规范通过 低风险 3.4 万 未标注 无
PicGo L3 · 安装规范通过 低风险 2.7 万 未标注 无
iPolloWork L4 · 沙盒安装通过 低风险 6,775 未标注 有
modlens L5 · 运行验证通过 低风险 4,207 0.2.0-rc.2 等 13 个 有

仓库档案

视觉与多模态
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方xiao-hans仓库 dsh-qwen-connect · 默认分支 main
分类视觉与多模态vision
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-26 · 2026-10-29最后推送 2026-10-29
本站收录2026-10-30首次进入本站目录的时间

README 全文

16.9 KB
作者原文,中文版优先;只做安全转义,不改内容

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
> ;
> 姊妹项目(同一推理链的 Pi 编码代理宿主版):
> 。

它做什么

能力 状态
Provider 注册(模型出现在 DSH 模型选择器,名称含倍率) ✅
设置卡片:账号 / 积分 / 套餐 / 模型列表(含配额进度条) ✅
凭据解密(Chromium v10 + Windows DPAPI) ✅
账号 / 额度 / 套餐 REST 查询 ✅
真实对话(WASM 签名 + SSE 聊天端点) ✅
流式输出 + 多轮上下文 ✅
工具调用(tools 透传 + tool_calls 协议转换) ✅
图片输入(DSH 附件服务 → chat_context.imageUrls) ✅
token 统计(上游 raw_usage → OpenAI usage) ✅
上游重试(限流 / 网关瞬时故障,最多 3 次) ✅
请求方鉴别(shim 共享密钥 + 常量时间比较) ✅
动态模型目录 ❌ 静态内置(/api/v2/model/list 需签名)

图片输入(视觉)

上游模型具备视觉能力,本插件已打通完整链路。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-Flash 0.10x ✅ 1M
qwen3.8-max-preview Qwen3.8-Max 1.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.mjs 12 项:脱敏、环回 403、凭据错误降级、null 不变成 0
tools/client-load-check.mjs 5 项:__ModuleLoader__ 契约、slot key/priority、slot API 损坏时降级
tools/host-load-check.mjs host 入口可加载性
tools/apply-check.mjs provider 注册行为 12 项断言(含两条降级路径)
tools/seam-live-check.mjs 端到端真实 API 实测 + JWT 不下发断言

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

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

安装

插件通过 Junction 挂载进 profile(源码改动即时生效,无需重新物化):

$d = "E:\Codex开发\DHS开发\dsh-qwen-connect"
$w = "$env:APPDATA\dsh-desktop\harness\profiles\web"
$pkg = "@xiao-hans/dsh-qwen-connect"

# 1) 依赖桥:让 CLI 侧自检可解析(运行时解析由 DSH 宿主接管,非必需)
foreach ($ns in @("@deepseek-ai", "@earendil-works")) {
cmd /c mklink /J "$d\node_modules\$ns" `
"$env:APPDATA\dsh-desktop\harness\profiles\node_modules\$ns"
}

# 2) 挂进 profile(scoped 包:junction 放在 node_modules\@xiao-hans\ 下)
New-Item -ItemType Directory -Force "$w\node_modules\@xiao-hans" | Out-Null
cmd /c mklink /J "$w\node_modules\$pkg" "$d"

# 3) 在 profile 的 package.json 里登记(三处,包名用 scoped 全名)
#    dependencies:      "@xiao-hans/dsh-qwen-connect": "file:./node_modules/@xiao-hans/dsh-qwen-connect"
#    dsh.profile.bundles: "@xiao-hans/dsh-qwen-connect"
#    pnpm.overrides:    "@xiao-hans/dsh-qwen-connect": "link:./node_modules/@xiao-hans/dsh-qwen-connect"

回滚

$w = "$env:APPDATA\dsh-desktop\harness\profiles\web"
cmd /c rmdir "$w\node_modules\@xiao-hans\dsh-qwen-connect"
cmd /c rmdir "E:\Codex开发\DHS开发\dsh-qwen-connect\node_modules\@deepseek-ai"
cmd /c rmdir "E:\Codex开发\DHS开发\dsh-qwen-connect\node_modules\@earendil-works"
# 再用备份覆盖 profile 配置
Copy-Item "$w\_backup-qwen-connect-20260911-141226\package.json" "$w\package.json" -Force
Copy-Item "$w\_backup-qwen-connect-20260911-141226\cordis.patch.yml" "$w\cordis.patch.yml" -Force

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

流式推理需要区分正常收尾、截断、超时和客户端取消。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-,用于关联该请求的日志
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 锁定。

已知限制

  1. 仅 Windows:凭据解密走 Windows DPAPI。
  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 里。

聊天接入架构(阶段 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:/v1/chat/completions。
  • 签名头 Authorization: Bearer COSY.<...> 由官方 WASM 生成,绝不能被
    Bearer 覆盖
    (覆盖即 403 Signature invalid)。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-qwen-connect 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add @xiao-hans/dsh-qwen-connect` 即可。

dsh-qwen-connect 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-qwen-connect 安全吗?

低风险。

dsh-qwen-connect 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-qwen-connect 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
视觉与多模态
按星标排序,可作替代方案

open-design

open-design

L4 · 沙盒安装通过 10.0 万 星

awesome-gpt-image-2

awesome-gpt-image-2

GPT Image 2 / 2.5 提示词与案例库,530+ 个案例、20+ 套工业级模板与可复用 Skills,新增 2.5 同提示词对比

L3 · 安装规范通过 3.4 万 星

PicGo

PicGo

L3 · 安装规范通过 2.7 万 星

iPolloWork

iPolloWork

L4 · 沙盒安装通过 6,775 星

modlens

modlens

ModLens 是 DeepSeek Harness 的视觉插件,为纯文本模型外挂视觉能力,粘贴图片即得结构化 JSON 证据(OCR、版面

L5 · 运行验证通过 4,207 星

OpenBiliClaw

OpenBiliClaw

本地私有、开源的自进化跨平台 AI 内容发现 Agent:先理解你,再主动从 B站、小红书、抖音、YouTube、X、知乎、Reddit、微

L4 · 沙盒安装通过 3,398 星

xiao-hans 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。