WPS（@adelie/use-wps-office）
把 Adelie 的对话搬进 WPS 文字：功能区多一个「Adelie」按钮，点开是侧栏——问它、让它读、让它改
当前这篇文档；同一套文档操作也作为 MCP 工具交给 Agent（mcp__wps__*）。
运行时就是一个零依赖的 Node 文件（skills/wps-office/kit/serve.mjs）。它同时是四样东西：
| 身份 | 接口 | 干什么 |
|---|---|---|
| 面板的宿主 | GET /addin/* | 发加载项那一页（WPS 以「在线加载项」加载这个目录） |
| Agent 的手 | GET /addin/commands（SSE）+ POST /addin/result，以及 POST /mcp | 把文档操作下发给面板执行，一次只跑一条；同一个操作也作为 MCP 工具给 Adelie |
| Adelie 的客户端 | `GET /panel/state | history |
| WPS 的安装按钮 | GET /publish、`POST /publish/enable | disable` |
为什么要中间这个桥：面板跑在 WPS 的内嵌浏览器里，与 Adelie 不同源，而 Adelie 明确不开 CORS
（仅限同源）。桥就是那个「另一个源」——面板只跟它说话，它再跟 Adelie 说话。全程只走 127.0.0.1。
装
node skills/wps-office/kit/install.mjs
它写设置、把加载项交给 WPS（这一步 WPS 要开着）、把桥登记成 Agent 的一个 MCP 服务器并自检、
在 Windows 上放一个开机自启的 .cmd、然后把桥拉起来。每一步都可以重复跑，重跑就是修复。
诊断页：http://127.0.0.1:3891/status；安装按钮那一页：/publish。文件都在数据根的
wps-bridge/（设置、状态、bridge.log）——不放插件目录，因为插件更新会整体替换。
卸载：node skills/wps-office/kit/uninstall.mjs（加 --purge 连日志一起删）。
文件
| 路径 | 是什么 |
|---|---|
skills/wps-office/kit/serve.mjs | 桥，也是这个插件的全部运行时 |
skills/wps-office/kit/adelie.mjs | 找 Adelie、带令牌调它的 HTTP 客户端（install.mjs 也用） |
skills/wps-office/kit/wps.mjs | WPS 本机上架服务（58890）的客户端 |
skills/wps-office/kit/install.mjs / uninstall.mjs | 装与卸 |
skills/wps-office/kit/addin/ | 加载项本身：manifest.xml、ribbon.xml、面板页与文档操作层 |
skills/wps-office/SKILL.md | Agent 读的说明书 |
test/ | 桥、安装脚本、加载项托管、面板冒烟四组测试 |
测试
node --test plugins/use-wps-office/test/ # 桥、安装脚本、加载项托管（不需要浏览器）
cd packages/web && npx playwright test -c ../../plugins/use-wps-office/test/playwright.config.mjs
# 面板在 Chromium 里真的跑一遍（14 条）
面板那组跑的时候 stub-wps.js 会顶掉 WPS：假文档、假 Range、假任务窗格接口，所以没有 WPS 的
机器也能验。真机上没验过的：ribbon 按钮图标呈现、CreateTaskPane/PluginStorage/app.Enum
的真实行为、app.Selection 的字符偏移、Documents.Add 四参数的老版本兼容、IME 回车。这些只能
在 Windows + WPS 上跑第一次。
来源
加载项的清单形状、ribbon 回调写法、InsertBreak 的位置取法（段落标记之前一格）参考了 Apache-2.0
的文策 AI（visresearch/WordAgent，frontend/wps_word_plugin/）与其发布页
（backend/gui/resources/publish.html，58890 那套接口的出处）；代码按本项目的契约重写，没有整段搬运。