63 lines
4.5 KiB
Markdown
63 lines
4.5 KiB
Markdown
|
# 5-35 Office 编辑模式菜单与保护
|
|||
|
|
|
|||
|
|
## 目标
|
|||
|
|
|
|||
|
|
Office 文件默认只读打开；在正文附件三点菜单和文件树资源右键菜单中增加“使用编辑模式打开”入口。保存闭环未完成前，编辑入口必须有 guard 或明确实验标记。
|
|||
|
|
|
|||
|
|
## 原因
|
|||
|
|
|
|||
|
|
ONLYOFFICE `mode=edit` 只是编辑器初始化模式。若 MNote 没有完成 callback 写回，默认 edit 会让用户误以为修改已经保存到本地文件。
|
|||
|
|
|
|||
|
|
## 允许修改
|
|||
|
|
|
|||
|
|
- `rust/crates/mnote-web/src/ssr/pages/layout.rs`
|
|||
|
|
- `rust/crates/mnote-web/src/routes/onlyoffice.rs` 中与 view/edit 初始化事件相关的最小补充
|
|||
|
|
- 相关 `mnote-web` 单测
|
|||
|
|
|
|||
|
|
## 禁止事项
|
|||
|
|
|
|||
|
|
- 不默认 edit。
|
|||
|
|
- 不声称 edit/save 已完整支持。
|
|||
|
|
- 不改动 ACP / Hermes 无关代码。
|
|||
|
|
|
|||
|
|
## Checklist
|
|||
|
|
|
|||
|
|
- [x] `buildOnlyOfficeAssetOpenUrl` / local Office 默认输出 `mode=view`。
|
|||
|
|
- [x] 正文附件菜单增加“使用编辑模式打开”。
|
|||
|
|
- [x] 文件树 Office asset 菜单增加“使用编辑模式打开”。
|
|||
|
|
- [x] 编辑模式入口明确使用 `mode=edit` 打开到主 resource tab 或新窗口，行为与现有打开目标一致。
|
|||
|
|
- [x] 在 local-folder save callback 未闭环时，编辑入口有 guard：可提示“编辑保存仍在实验中”，或通过 data/status 标记便于测试识别。
|
|||
|
|
- [x] 已存在 Office resource tab 从 `mode=view` 切到显式 `mode=edit` 时，刷新同一 tab 的 iframe URL，而不是只激活旧 tab。
|
|||
|
|
- [ ] 若启用 `onRequestEditRights`，必须重新初始化为 edit URL，不只 reload 当前 view。（P1，未实现）
|
|||
|
|
|
|||
|
|
## 验收
|
|||
|
|
|
|||
|
|
- `cargo test -p mnote-web sidebar_tree_js -- --test-threads=1`
|
|||
|
|
- `cargo test -p mnote-web onlyoffice -- --test-threads=1`
|
|||
|
|
- 浏览器截图：默认打开是只读；菜单中存在编辑入口；点击编辑入口后的页面 URL / debug state 包含 `mode=edit` 或 guard 提示。
|
|||
|
|
|
|||
|
|
## 本轮执行记录
|
|||
|
|
|
|||
|
|
- 2026-05-21：Reasonix worker B 卡在计划阶段后由 Codex 终止；本条实现来自其它 Reasonix 结果与 Codex 复核修正。
|
|||
|
|
- `buildOnlyOfficeOpenUrl` 默认 mode 从 `'edit'` 改为 `'view'`。
|
|||
|
|
- `buildOnlyOfficeOpenPath` 默认 mode 从 `'edit'` 改为 `'view'`。
|
|||
|
|
- `buildLocalOnlyOfficeOpenUrl` 默认 mode 从 `'edit'` 改为 `'view'`。
|
|||
|
|
- `normalizeOnlyOfficeAttachmentHref` 默认 mode 从 `'edit'` 改为 `'view'`。
|
|||
|
|
- `detailFromEditorAttachmentLink` 默认 mode 从 `'edit'` 改为 `'view'`。
|
|||
|
|
- `enhanceEditorAttachmentLink` 默认 mode 从 `'edit'` 改为 `'view'`。
|
|||
|
|
- 正文附件菜单（`openTreeContextMenu` `isAttachment` 分支）增加菜单项 `{ action: 'open-edit-mode', icon: 'edit_note', label: '使用编辑模式打开' }`，放置于"在新窗口打开"之前。
|
|||
|
|
- 文件树 asset 菜单（`isAsset` 分支）增加相同的 `open-edit-mode` 菜单项。
|
|||
|
|
- 新增 `withOfficeEditModeGuard()` 守卫函数：
|
|||
|
|
- 设置 `data-mnote-last-office-edit-mode-requested="true"` 和 `data-mnote-last-office-edit-mode-guard="shown"` 以支持浏览器测试识别。
|
|||
|
|
- 弹出 `window.confirm('编辑保存仍在实验中，建议先备份文件。是否继续？')` 对话框，用户确认后才继续。
|
|||
|
|
- `handleTreeContextMenuAction` 中 attachment 和 isAsset 分支分别处理 `open-edit-mode` 动作，调用 guard 后再以 `mode=edit` 打开。
|
|||
|
|
- Codex 修正：普通“在新窗口打开”保持 `mode=view`；只有“使用编辑模式打开”才传入 `mode=edit`。
|
|||
|
|
- Codex 补充 `sidebar_tree_runtime_opens_office_assets_through_resource_shell` 契约测试，覆盖默认 view、显式 edit、guard 标记和 edit URL 重写。
|
|||
|
|
- `cargo test -p mnote-web sidebar_tree_runtime_opens_office_assets_through_resource_shell -- --test-threads=1` 通过。
|
|||
|
|
- `cargo test -p mnote-web onlyoffice -- --test-threads=1` 通过。
|
|||
|
|
- 2026-05-21：Codex 浏览器复核发现并修复“已有 Office tab 切 edit 不刷新”。
|
|||
|
|
- 根因：`openResourceInActiveTab()` 遇到已存在 `objectIdentity` 时只调用 `activateMainEditorTab(objectIdentity)`，没有更新旧 iframe 的 `officeUrl`。
|
|||
|
|
- 修复：`web_shell.rs` 新增 `refreshExistingOfficeResourceTab()`，仅对 `entry.kind === 'office'` 且新旧 `href/officeUrl` 不一致时重建 passive iframe。
|
|||
|
|
- 回归：`scripts/task463-onlyoffice-resolver-smoke.js` 新增 Test 1b，断言同一 docx tab 从 `mode=view` 刷新到 `mode=edit`，且不会创建第二个 Office tab。
|
|||
|
|
- Codex clean browser 自测通过：中文 docx 默认 view；同 tab edit 后 iframe URL `mode=edit`；证据见 `tmp/codex-office-view-edit-plugin-2026-05-21/result.json`。
|