68 lines
4.3 KiB
Markdown
68 lines
4.3 KiB
Markdown
|
# 5-40 ONLYOFFICE bridge 插件注入后噪音口径需复测
|
|||
|
|
|
|||
|
|
## 状态
|
|||
|
|
|
|||
|
|
- 状态：done
|
|||
|
|
- Owner：05-editor-mainline / OnlyOffice preview-edit / browser smoke
|
|||
|
|
- 发现时间：2026-05-31
|
|||
|
|
|
|||
|
|
## 现象
|
|||
|
|
|
|||
|
|
旧缺陷 `5-37` 的结论是当前代码没有注入 `plugins.autostart` / `pluginsData`，因此 annotation/custom assistant 插件 404 可作为 OnlyOffice 内置非关键噪音处理。但近期 ONLYOFFICE live bridge 已在 `onlyoffice.rs` 中重新注入 MNote bridge 插件，这会让旧噪音策略失效，必须重新区分 MNote bridge 插件失败、OnlyOffice 内置插件噪音和真正主文档加载失败。
|
|||
|
|
|
|||
|
|
## 证据
|
|||
|
|
|
|||
|
|
- `bugs/05-editor-mainline/process/5-37-onlyoffice-annotation-plugin-noise-policy-v1.md` 记录：“当前代码已无 autostart 注入，无需额外禁用”。
|
|||
|
|
- `rust/crates/mnote-web/src/routes/onlyoffice.rs` 当前 `editorConfig.plugins` 注入：
|
|||
|
|
- `autostart: [MNOTE_AGENT_PLUGIN_GUID]`
|
|||
|
|
- `pluginsData: [bridgePluginConfigUrl.toString()]`
|
|||
|
|
|
|||
|
|
## 影响
|
|||
|
|
|
|||
|
|
- clean browser 测试里 MNote bridge 插件加载失败可能被错误归类为“OnlyOffice 内置插件噪音”。
|
|||
|
|
- 相反，主 iframe 空白、`errorCode=-18`、DocumentServer WebSocket 失败也可能被泛化过滤掉。
|
|||
|
|
- Office live agent 能力上线后，插件加载失败将不再是纯噪音，而是 AI Office 工具不可用。
|
|||
|
|
|
|||
|
|
## 最小复现建议
|
|||
|
|
|
|||
|
|
1. clean browser 打开 docx/xlsx/pptx。
|
|||
|
|
2. 记录 console、pageerror、network 404/500、OnlyOffice iframe ready state。
|
|||
|
|
3. 分别验证：
|
|||
|
|
- MNote bridge 插件 config/index 是否成功加载。
|
|||
|
|
- OnlyOffice 内置 annotation/custom assistant 缺资源是否仍为 non-critical。
|
|||
|
|
- 主 iframe 空白、`errorCode=-18`、WebSocket 失败仍判定为失败。
|
|||
|
|
|
|||
|
|
## 修复建议
|
|||
|
|
|
|||
|
|
- 更新 `5-37` 或新 smoke 的错误分类规则：MNote bridge 插件错误不等同于内置插件噪音。
|
|||
|
|
- 在 OnlyOffice smoke 中输出插件分类字段，例如 `mnoteBridgePluginOk`、`builtinPluginNoiseOnly`、`mainDocumentReady`。
|
|||
|
|
- 对 bridge 插件 config/index 增加 route 单测和 browser smoke 断言。
|
|||
|
|
|
|||
|
|
## 本轮进展
|
|||
|
|
|
|||
|
|
- 2026-06-01：新增并通过 `scripts/task517-onlyoffice-bridge-plugin-direct-smoke.js`，在真实 Chromium 中 mock `Asc.plugin` 后直接加载 bridge plugin index，验证 session 注册、token 错误拒绝、`selection.get` / `document.insert_text` command 消费和 result 回传。
|
|||
|
|
- 该 smoke 证明 MNote bridge plugin index / HTTP loop 自身可用，但不覆盖真实 ONLYOFFICE iframe / DocumentServer 的 autostart、内置插件噪音、主文档 ready 或 `errorCode=-18` 分类，因此本 bug 仍保留在 `process/`。
|
|||
|
|
- 2026-06-01：新增并通过 `scripts/task518-onlyoffice-real-iframe-session-scope-smoke.js`，在真实 ONLYOFFICE iframe / DocumentServer 下验证 MNote bridge 插件可 autostart 注册并回收命令。该 smoke 记录到的 404 均为 `/api/onlyoffice/bridge/plugin/index/translations/langs.json` 与 `/api/onlyoffice/bridge/plugin/index/translations/zh-CN.json`，当前可归类为 bridge 插件翻译资源噪声；它没有阻断 session 注册、`selection.get` 或工具层授权 dry-run。
|
|||
|
|
|
|||
|
|
- 2026-06-01：增强并通过 `scripts/task518-onlyoffice-real-iframe-session-scope-smoke.js`，输出 `errorClassification`：
|
|||
|
|
- `mnoteBridgePlugin.httpErrors=[]`
|
|||
|
|
- `mnoteBridgePlugin.sessionsRegistered=true`
|
|||
|
|
- `mnoteBridgePlugin.commandLoopOk=true`
|
|||
|
|
- `bridgeTranslationNoise.count=6`，仅包含 `/api/onlyoffice/bridge/plugin/index/translations/langs.json` 和 `zh-CN.json` 404
|
|||
|
|
- `builtinPluginNoise.count=0`
|
|||
|
|
- `mainDocument.ready=true`
|
|||
|
|
- `mainDocument.failures=[]`
|
|||
|
|
- `mainDocument.errorCodeMinus18=false`
|
|||
|
|
该分类把 MNote bridge 插件失败、bridge 翻译资源噪音、OnlyOffice 内置插件噪音和主文档失败分开；`errorCode=-18` / 主 iframe 空白不会被插件噪音吞掉。
|
|||
|
|
|
|||
|
|
## 验收
|
|||
|
|
|
|||
|
|
- [x] Clean browser smoke 能区分三类错误：MNote bridge 插件失败、OnlyOffice 内置插件噪音、主文档加载失败。
|
|||
|
|
- [x] `errorCode=-18` / 主 iframe 空白不会被插件噪音过滤吞掉。
|
|||
|
|
- [x] bridge 插件不可用时，Office 文档预览结论和 Office AI 工具可用性结论分开报告。
|
|||
|
|
|
|||
|
|
## 最终验证
|
|||
|
|
|
|||
|
|
- `node --check scripts/task518-onlyoffice-real-iframe-session-scope-smoke.js`
|
|||
|
|
- `MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3301 node scripts/task518-onlyoffice-real-iframe-session-scope-smoke.js`
|