mnote/design/05-editor-mainline/done/5-15-main-editor-resource-tab-vscode-open-target-v1.md

5-15 主编辑区 Resource Tab 与 VSCode 打开目标对齐 v1

状态：done

日期：2026-05-20

目标

把当前资源打开行为从“资源点击直接 window.open 或单独右侧 pane”收口为 VSCode 风格的打开目标模型：

• active-tab：在主编辑区打开或激活 resource tab。
• side：保留当前右侧 pane 打开能力。
• new-window：显式在新浏览器窗口打开。

本轮重点实现 active-tab，并保持已有右侧 pane 与新窗口路径不退化。

VSCode 对齐口径

VSCode Explorer 不按文件类型散落处理打开行为，而是把资源交给 editor service：

• 普通打开进入当前 editor group。
• Open to the Side 进入 side group。
• 同一资源应激活已有 editor tab，而不是无限重复打开。
• side group 与主 editor group 可以同时持有各自 tab。

MNote 对应关系：

• 主编辑区 tab host 对应 VSCode active editor group。
• 当前 secondary document pane 对应 VSCode side group。
• 浏览器新窗口只作为显式外部打开目标。

资源编辑规则

.md、.markdown、.txt、常见代码文件在主编辑区 resource tab 中继续使用 tiptap runtime 打开。

关键约束：

• 页面正文 tiptap 保存到 Page Aggregate body / 页面 Markdown。
• 资源 tiptap 保存到对应 resource 文件本身。
• resource tab 必须使用独立 object identity 与独立 session key。
• resource tab 保存不得调用 page.body.save 或 /api/page-body/write。
• 上传的 .md 资源不能因为用 tiptap 打开而重新变成 File Tree / Page Tree 页面。

最小实现范围

本轮只做浏览器内主编辑区 resource tab host 的最小闭环：

• 在文档 workspace 顶部增加 tab strip。
• 默认页面正文是一个固定 page tab。
• 点击本地上传或文件树资源时打开 resource tab。
• Office tab 内嵌 /onlyoffice?...。
• PDF / 图片使用 iframe/img 预览。
• .md / text / code 使用 tiptap runtime 编辑，并保存回本地资源文件。
• 右键菜单保留“在右侧边栏打开”和“在新窗口打开”。

Convex 远端资源本轮仅保留新窗口 fallback；主闭环优先覆盖 local-first 资源。

详细 Checklist

• 定义前端 open target：active-tab、side、new-window。
• 为本地资源生成稳定 objectIdentity：resource:file:<rootUri>:<relativePath>。
• 新增本地资源读写 API：
  • GET /api/local-folder/resource/read?rootUri=&path=
  • POST /api/local-folder/resource/write
  • 读写均复用 root escape 校验。
  • 写入返回 fileVersion / conflictDetectionKey。
• 主编辑区新增 resource tab strip：
  • page tab 默认存在。
  • resource tab 重复打开时激活已有 tab。
  • 关闭 resource tab 后回到 page tab。
  • 打开 resource tab 不关闭 secondary pane。
• tiptap resource editor：
  • .md / .markdown / .txt / code 资源挂载 tiptap。
  • session key 与页面正文 session key 隔离。
  • 保存写 /api/local-folder/resource/write。
  • 保存 payload 中保留 tiptapDocument，服务端转 Markdown / text 后写回文件。
• Office / PDF / 图片 resource tab：
  • Office 使用 /onlyoffice?... iframe，主编辑区默认 mode=view。
  • PDF 使用 iframe。
  • 图片使用 img。
  • 不触发页面正文保存。
• 菜单与默认行为：
  • 文件树资源普通点击默认 active-tab。
  • 附件普通点击默认 active-tab。
  • “在右侧边栏打开”继续走 side。
  • “在新窗口打开”继续走 new-window，Office 保留 mode=edit。
• Smoke：
  • 上传 .md 后点击资源，在主编辑区出现 resource tab 和 tiptap。
  • 编辑 .md resource tab 后文件内容写回资源文件，不写页面正文。
  • 上传 Office 后点击资源，在主编辑区出现 Office resource tab。
  • 显式新窗口打开仍打开 /onlyoffice 或文件 URL。

非目标

• 不在本轮实现多 tab 持久化恢复。
• 不在本轮实现 Convex 远端资源的主编辑区写回。
• 不在本轮引入完整代码编辑器或语法高亮。
• 不改变 Resource Tree / File Tree / Page Tree 的真源关系。