4.7 KiB
4.7 KiB
5-13 [done] tiptap runtime 冷加载 mindmap 重包拆分 checklist v1
2026-06-06 归档说明：本文件只归档 mindmap 重包拆分与 mindmap block 懒加载回归。历史记录中的真实文档壳
tableVisibleMs≈18.55s当前未复现；复核结果约 274ms 可见，后续如再次复现再参考design/05-editor-mainline/reference/5-36-tiptap-real-shell-cold-load-followup-v1.md。
背景
- 实测打开
mnote-e2e的design/07-ai/done/7-45-chatonly-api-provider-runtime-v1.md时，FileTree scoped reveal 已降到毫秒级，但正文表格可见仍接近十几秒。 - 冷浏览器网络记录显示
/api/leptos-tiptap-runtime/snippets/.../tiptap_paragraph.js响应事件被主线程阻塞拖到后段；直接curl该资源只需毫秒级。 - 生成产物
tiptap_paragraph.js约 1MB，普通 paragraph extension 静态捆绑了 mindmap/simple-mind-map/KaTeX 相关代码。
根因假设
普通 Markdown 页面必须注册 paragraph extension，而当前 paragraph extension 在模块顶层静态导入 mindmap NodeView runtime。即使页面没有 mindmap block，浏览器也必须下载、解析和执行 mindmap 重包，导致 tiptap island 冷加载被拖慢。
验收标准
- RED：新增测试能证明当前
tiptap_paragraph.js含有 mindmap/simple-mind-map 重包。 - GREEN：普通
tiptap_paragraph.js不再包含simple-mind-map、mindmap.simple_mind_map_scene.get等重运行时代码。 - 保留 mindmap paragraph attrs：
mnoteBlockType、mindmapId、rootNodeId、projectionVersion、mindmapWidth、mindmapHeight仍可 parse/render。 - mindmap block runtime 改为遇到 mindmap block 时再异步加载，普通文档不触发该加载。
- 重建
reference-code/leptos-tiptap/src/js/generated和rust/spikes/leptos-tiptap-spike/generated/island产物。 - 复测 7-45 冷加载，记录 table visible 时间与 runtime asset 体积变化。历史复测：paragraph snippet 已从约 1,025,978 bytes 降到 7,619 bytes，
tiptap_mindmap_paragraph_runtime.js未在普通 7-45 页面请求；当时 table visible 仍约 18.55s。2026-06-06 当前 checkout 再复核未复现，tableVisibleMs≈274ms。
修改边界
- 主要 owner：
reference-code/leptos-tiptap/tiptap/src/extensions/tiptap_paragraph.ts。 - 可新增：
tiptap_mindmap_paragraph_runtime.ts，用于承载 mindmap NodeView 重逻辑。 - 可补 route fallback：
mnote-web的/api/leptos-tiptap-runtime/*path允许加载 lazily generated mindmap runtime asset。 - 不改 FileTree scoped reveal 已完成逻辑，不回滚上一轮未提交变更。
2026-06-02 历史实测补充
npm test中普通 paragraph 生成产物不应捆绑 mindmap 重运行时已从失败变为通过。- 冷浏览器打开 7-45：
domContentLoadedMs=136、editorVisibleMs=18550、tableVisibleMs=18553、mindmapRuntimeRequested=false、pageErrors=0。 - 单独在同源页面
import + init + mount同一份 7-45 Tiptap document 约166ms，所以 18s 不是 Tiptap document 本身渲染 194 blocks/2 tables 导致。 - 2026-06-06 当前 checkout 已无法复现该 18s 现象；此段只保留为历史测量记录，不再作为 active 性能任务来源。
2026-06-02 插入思维导图回归修复
- RED：新增
mindmap runtime 懒加载完成后会挂到稳定 loading NodeView 内测试，覆盖 runtime 加载完成后不能停留在 loading 的行为。 - 根因：懒加载完成后仅 dispatch
setNodeMarkup(position, sameAttrs)，ProseMirror 不保证重建 NodeView；直接replaceWith(realNodeView.dom)又会破坏 ProseMirror 持有的 NodeView DOM 引用。 - GREEN：保持 loading NodeView 外层 DOM 稳定，runtime 加载完成后清空 loading 文案并
appendChild(realNodeView.dom)，后续update/destroy/stopEvent/ignoreMutation代理到真实 NodeView。 - 浏览器 smoke：临时 local-folder 页面通过 slash 插入思维导图后，请求
tiptap_mindmap_paragraph_runtime.js，placeholderdata-stage=runtime-loaded，内部出现mnote-mindmap-editor-root、leptos-mindmap-island[data-stage=ready]和simple-mind-map-runtime。
长期形态决策参考
以下不是本次重包拆分的归档阻塞项，后续如实施应另拆 Resource/Object tab 或 plugin host checklist：
- 参考思源 KMind 的插件/挂件形式，把完整 mindmap 编辑器迁到独立 Resource/Object tab 或 plugin host。
- Markdown 正文内的 mindmap block 长期收敛为轻量镜像块/预览块/打开按钮，不在普通正文 NodeView 内承载完整编辑器。
- 插件 host 提供
getMindMapData/saveMindMapData/resize/destroy一类数据桥和生命周期，数据真相仍为 Resource Tree 下的.mindmap.json。