@@ -288,6 +288,77 @@ pi agent（earendil-works/pi）是一套轻量的多 Provider LLM 调用框架
 | `lib/ui.ts` | 复用现有控制面板的显示/隐藏模式添加 Agent 面板 |
 | `store/index.ts` | Agent 执行状态可通过同一 signal 机制管理 |
 
+### OnlyOffice Web Apps 版本升级（7.5.0 → 9.4.0）
+
+**结论：建议升级，与 Agent 协同计划捆绑进行，主要成本在于获取静态文件而非代码改动。**
+
+#### 当前状态
+
+- **当前版本**：`7.5.0 (build: 2024-10-16)`，文件位于 `public/sdkjs/`（~47 MB）、`public/wasm/`（~74 MB）、`public/web-apps/`
+- **最新版本**：`9.4.0`（2026-05-20 发布），跨越约 1.5 年、2 个大版本
+
+#### 升级带来的主要收益
+
+| 版本 | 关键改进 |
+|---|---|
+| v8.0 | `CreateTable(rows, cols)` API 重构，性能大幅提升 |
+| v9.2 | **Plugin API 大幅扩展**（新增 Form / CheckBox API），插件调试文档完善 |
+| v9.3 | 多页视图、REGEX 函数族（spreadsheet）、图片/形状超链接、PDF API |
+| v9.4 | 25 个演示主题、20 种幻灯片切换动画、表格深色模式、单进程架构简化 |
+
+**对 Agent 协同计划尤为重要**：v9.2 的 Plugin API 扩展是 Agent 工具层的基础，在旧版本上构建 Agent 集成可能遇到 API 不完整的问题。建议**先升级，再做 Agent 开发**。
+
+#### 升级成本
+
+**1. 获取静态文件（最大障碍，预估 1 天）**
+
+OnlyOffice 没有为"仅静态文件"提供官方分发渠道，可行路径：
+
+```bash
+# 最可靠：从官方 Docker 镜像提取
+docker run -d --name oo onlyoffice/documentserver:9.4.0
+docker cp oo:/var/www/onlyoffice/documentserver/web-apps ./public/web-apps
+docker cp oo:/var/www/onlyoffice/documentserver/sdkjs   ./public/sdkjs
+docker rm -f oo
+
+# x2t WASM 需单独处理（社区维护）
+# 参考：https://github.com/cryptpad/onlyoffice-x2t-wasm
+```
+
+**2. 代码层的 Breaking Changes（预估 0.5 天）**
+
+需检查的改动点：
+
+| 改动 | 版本 | 影响 |
+|---|---|---|
+| `CreateTable(rows, cols)` 参数顺序变更 | v8.0 | 搜索项目中对 `CreateTable` 的调用 |
+| `customization.commentAuthorOnly` 参数移除 | v8.x | 检查 `onlyoffice-editor.ts` 中的 config |
+| `installDeveloperPlugin` shim 移除 | v9.3.1 | 若有插件加载逻辑需更新 |
+
+**3. 功能回归测试（预估 1 天）**
+
+- docx / xlsx / pptx / csv 打开与保存
+- 格式转换（x2t WASM）
+- 只读模式切换
+- 现有 E2E smoke test 重跑
+
+**4. 包体积变化**
+
+新版本预计比当前（121 MB）更大，需评估对 GitHub Pages 首屏加载的影响。可配合 Service Worker 预缓存策略缓解。
+
+#### 与 Agent 计划的关系
+
+```
+建议顺序：
+  升级 OnlyOffice 9.4.0
+    ↓
+  阶段零：验证新版 Plugin API 可用性
+    ↓
+  Agent 工具层开发（基于完整的 v9.2+ Plugin API）
+```
+
+若先做 Agent 开发、后升级 OnlyOffice，可能需要在旧 API 基础上写兼容代码，升级时再改一遍，事倍功半。
+
 ---
 
 ## 测试覆盖说明