千问办公插件

供 mu-agent-bridge 使用的千问办公插件。核心包已内置此插件；独立包适用于单独发布和安装。

安装：npm install -g agent-bridge-qwenwork。插件需要 Windows 千问办公开启 CDP 端口 9228。

executablePath 配置保存在独立状态目录，插件升级和重启会继续使用。千问桌面升级后，若路径指向带版本号的目录，插件会从同一安装位置查找最高版本的可执行文件；即使旧版本仍保留，也会启动新版。非版本目录中的固定路径仍优先使用；路径失效时再扫描常见安装目录。重载千问插件后，运行日志会显示实际启动的 executablePath。

后台每 30 秒检查主页面与 CDP 连接，空闲时每 2 小时最多发送一条带随机校验码的真实测试消息。首次启动及 CDP 恢复后必须完成真实对话，只有千问原样返回本次校验码才判定可用。任务或 /new 执行期间不发送检测消息、不执行恢复。普通 API/UI 错误或健康通信失败但 CDP 仍连接时只标记降级；只有 CDP 已断开才允许自动重启千问并重连。AUN、飞书和 HTTP 共用请求队列，恢复不修改 AID 或 owner 配置。autoStart: false 禁止自动启动和重启。

原生历史读取目前明确不支持：已核验的 CDP/tRPC 客户端只有任务提交等操作，没有只读会话枚举或历史读取接口。插件不会猜测 RPC、把配置中的 chatId/subChatId 当作当前身份，也不会为读取历史而点击、切换或发送内容；sessionHistory 的 scope 固定为本插件配置的 CDP 端口。中继、忙碌、恢复中、离线或未就绪时会返回对应拒绝原因。

请求超时或明确返回“API不可用”时只结束本次请求，已经发送的任务不自动重发，避免重复执行。健康接口 /api/plugins/qwenwork/health 的 lastHeartbeat 表示最近真实对话验证通过时间，同时返回 restarts 和 recovering；日志可搜索“千问真实对话心跳通过”“千问心跳失败”“千问自动恢复成功”。自动恢复只在 CDP 断开且当前无任务时结束千问进程及其子进程；daemon 应在已登录的 Windows 用户桌面会话运行。

/new 在已确认的空白新任务页可重复执行。远程消息和 /new 遇到输入框残留时，先将原文、页面地址和时间追加到插件数据目录的 draft-recovery.jsonl，再通过编辑器原生删除操作清理；备份失败、内容发生变化或正在生成回复时不清理。后台心跳只清理桥接自己的检测文本，遇到普通用户草稿则跳过。发送消息会点击桌面端“发送消息”按钮并确认输入框清空，避免仅按 Enter 后消息仍停留在输入框。真实通信失败后保持降级，普通 CDP 检查通过不会把状态改回就绪，须有真实回复或真实对话心跳通过。

真实心跳会消耗模型额度，并在当前千问聊天会话留下检测消息；它通过与用户请求相同的发送和取回回复路径运行。云端故障、账号额度不足或登录过期仍可能需要修复服务或账号，验证失败期间不会报告健康。

文件、图片、视频附件经桌面原生上传入口送入本轮任务；回传只采集本轮助手通过“已展示最终文件”工具声明的产物，不扫描普通正文中的任意路径。图片按内容去重，视频以 video/* 文件附件交给 AUN，使用分块读取避免大视频导致 CDP 断连。单条最多 8 个附件，单个不超过 32 MiB、合计不超过 64 MiB；实际可处理的格式及内容理解能力由桌面端和模型决定。验证证据见仓库的 docs/verification/2026-10-20-qwenwork-media.md。