pi-provider-qwenwork

让 Pi 编码代理（@earendil-works/pi-coding-agent）把千问办公（QwenWorkCN）桌面 App 当作一个模型 Provider——零配置、无需 API Key，直接复用你已经登录的 App 账号与积分。

本扩展是 DSH 插件 dsh-qwen-connect（Gitee 镜像 https://gitee.com/han-xiaos-whisper/dsh-qwen-connect）的姊妹项目：二者共用同一套零外部依赖的推理链（凭据解密 + 官方同源 WASM 签名 + 本地 OpenAI 兼容网关），只是宿主从 DSH 换成了 Pi。

来源说明：lib/ 与 research/ 下的推理链代码 vendored 自 gaoqiaoliangjie666/dsh-qwen-connect 的衍生版（含企业 VPC 支持），原始协议逆向 / WASM 签名成果归属上游作者，MIT 许可。 本仓库提供 Pi 扩展入口（index.js）及流收尾的宿主兼容适配； 凭据、WASM 签名与上游推理协议沿用共享实现。

工作原理

Pi ──(openai-completions)──▶ 本地环回 127.0.0.1:<随机端口>/v1/chat/completions   [lib/chat-shim.js]
                                    │  Bearer 共享密钥 + 环回校验
                                    ▼
                        官方同源 WASM 签名（research/wasm.bin，Cosy-* 头）   [lib/signer-session.js]
                                    │
                                    ▼
              千问办公上游 agent_chat_generation（公有云 或 企业 VPC 网关）

1. 读登录态：lib/credentials.js 从 %APPDATA%\QwenWorkCN 用 Windows DPAPI + AES-256-GCM 解出桌面 App 的 auth-v2.dat（token / refreshToken / user / loginDeviceId）。token 过期时自动走 deviceToken/refresh 轮换并原子回写。
2. 签名：lib/signer-session.js 用从官方 @qoder-ai/qoder-agent-sdk 提取的 wasm.bin 生成 Authorization: Bearer COSY.* 与全套 Cosy-* 头——与 App 自身走的算法字节级同源。
3. 网关：lib/chat-shim.js 在 127.0.0.1 随机端口提供 OpenAI /v1/chat/completions，把请求翻译成上游 SSE 推理接口，再把响应翻译回 OpenAI 格式（含思维链 reasoning_content、工具调用、图片输入）。
4. 注册：index.js 在扩展工厂内 await startChatShim() 起好本地端点，再 pi.registerProvider('qwenwork', …)，把共享密钥当作 API Key 喂回 Pi。

前置条件

• Windows（凭据解密依赖 DPAPI）。
• 已安装并已登录千问办公桌面客户端（QwenWorkCN）。扩展不弹窗登录，只读取 App 已有的登录态。
• Node ^22.19.0 || >=24.0.0（Pi 自身要求）。

安装

从 npm 装（推荐）

pi install npm:@xiao-hans/pi-provider-qwenwork

pi list 确认已登记；pi --list-models qwenwork 应能看到三个档位。想先试一次而不写进 settings：

pi -e npm:@xiao-hans/pi-provider-qwenwork

手动放进扩展目录

把本目录放进 Pi 的扩展目录即可（Pi 会自动发现含 index.js 的子目录）：

# 用户级
%USERPROFILE%\.pi\agent\extensions\pi-provider-qwenwork\

# 或项目级
<你的项目>\.pi\extensions\pi-provider-qwenwork\

两种装法都无需 npm install——本扩展零运行时 npm 依赖，lib/ 与 research/ 已自带全部实现。

使用

# 确认注册成功（应看到 provider=qwenwork 的 qwen3.8-flash / pro / qwen3.8-max-preview）
pi --list-models qwenwork

# 一次性对话
pi -p "你好" --model qwenwork/qwen3.8-flash

# 交互模式里用 Ctrl+P 切到 qwenwork
pi --model qwenwork/pro

均为 1M 上下文、32K 输出、支持图片与思维链。

企业 VPC 租户

若你的账号属于企业 VPC 版（凭据 JWT 的 iss 形如 https://<tenant>.vpc.qwenwork.cn/...），lib/endpoint.js 会自动把签名端点派生到租户网关，无需任何配置。VPC 网关常用企业自签证书，因此此时会一次性设置 NODE_TLS_REJECT_UNAUTHORIZED=0——这与千问办公 App 自身的运行方式一致（见其 main.log），仅在 VPC 租户下触发，公有云账号不受影响。

与 DSH 插件的差异

积分请在千问办公 App 或 DSH 里查看；本扩展专注「让 Pi 能用千问办公的模型」。

安全边界

• 本地网关只绑 127.0.0.1，且要求环回来源 + 进程内生成的 Bearer 共享密钥（常量时间比较）；密钥不落盘、不进日志。
• 凭据只在内存中传递；describeCredentials() 输出掩码摘要。
• 扩展不向千问办公上游之外的任何地址发起请求。

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

长时间任务里最容易出现的症状是：模型忽然没了输出、界面一直转、又没有任何报错。 根因通常不在模型，而在代理把「异常结束」说成了「正常结束」。本插件的 shim 按下面五条收尾：

FIRST_CONTENT_TIMEOUT_MS（90 秒）此前只有声明和注释、没有代码引用；现在它是真实的 首帧预算：上游「接了单没排上」的排队态会在 90 秒内明确失败，而不是拖满 300 秒。

空闲超时消息为 upstream idle timeout: no data for <N>ms。Pi 根据错误文本识别 可重试的传输故障；timeout 标记使该错误进入既有重试策略，重试开关、次数和退避 仍由 Pi 管理。shim 在响应开流后仅报告错误并结束该流，不自行重放请求。

回归测试：npm test（node --test test/unit/stream-robustness.test.mjs），使用本地 HTTP 假上游验证部分思考后的空闲超时、正常完成与用量、客户端取消，以及请求关联 和本地事件循环阻塞的诊断记录。

流停滞诊断

诊断事件追加到系统临时目录的 pi-qwenwork-trace.log（JSONL，2MB 上限）。 姊妹包 dsh-qwen-connect 固定写自己的 dsh-qwen-connect-trace.log：两边共用 一个文件时，DSH 的活跃流量会在几十分钟内把本侧的事故记录轮转出上限。 单测必须用 QWEN_CONNECT_TRACE_PATH 把写入重定向到项目内临时目录 （test/unit/trace-sandbox.mjs 已统一处理），否则故障注入的伪数据会混进 真实排障日志。 每条事件包含 source: "pi-provider-qwenwork"、进程 pid 和单次请求的 requestId； Pi 会话中保存的响应 ID 为 chatcmpl-<requestId>，可直接关联日志。同一对话的 upstreamSessionId 与单次请求 ID 分开记录。

idle-watchdog-fired 与 stream-end 会记录完整进度快照。日志只收集指定的关联头， 不保存提示词、模型输出原文、Authorization 或 Cookie。事件循环延迟与回调迟到量 用于识别本地阻塞线索；数据块时间是本地读取时间，不是远端生成时间。历史日志中 缺失的观测字段不能事后补回。

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

姊妹包 dsh-qwen-connect 在 2026-10-30 的 502 风暴里遇到 33 条只有 request-in、 之后一行都没有的请求，事后无法归因：部分提前返回分支只回错误不写日志， res.on('close') 过去要到 SSE 阶段才注册，readBody() 在客户端写完半截就断开时 既不 end 也不 error 而直接悬挂。本包保持与 dsh-qwen-connect/lib/chat-shim.js 字节一致（仅注释里的宿主名差异）：每个请求恰好一条终止记录——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 标志， ended:false 为客户端提前断开、ended:true 为处理器抛异常后由外层回 500）。

回归测试：npm test（含 test/unit/chat-shim-request-observability.test.mjs，其中 一个用例只写半截 JSON 就拆掉 socket，验证它不再悬挂且一定留下可读的终止记录）。

已知边界

• 复用 App 登录态意味着：App 退出登录后，扩展会随之报未登录，需重新打开 App。
• 上游对超高重复输入（如 '测'.repeat(500)）的 pro 档可能长时间不返首包，属上游行为，网关已加空闲超时兜底。
• 千问办公 App 大版本升级偶发改变请求契约（历史上 1.0.6→1.2.0 曾因缺 business 字段恒定 503）。本扩展的签名逻辑随 dsh-qwen-connect 维护，若失效请回溯其排查手册。

许可

MIT。research/wasm.bin 提取自官方 @qoder-ai/qoder-agent-sdk，版权归其原作者；本仓库仅为互操作目的复用。