docs: archive stale process checklists
This commit is contained in:
@@ -8,6 +8,8 @@
|
|||||||
> Harness 拆分:
|
> Harness 拆分:
|
||||||
> - `task-019` 到 `task-026`
|
> - `task-019` 到 `task-026`
|
||||||
|
|
||||||
|
> 2026-06-06 历史快照说明:本文件记录 2026-04-28 迁移期 checklist,正文中的未完成项不再代表当前 active process。主 Web 执行面后续状态已被 `design/03-rust-web/done/3-10-rust-web-3000-tree-editor-runtime-integration-checklist-v1.md`、`design/03-rust-web/done/3-14-rust-web-tree-realtime-ws-push-v1.md`、`design/03-rust-web/done/3-18-local-folder-tree-live-consumer-convergence-checklist-v1.md`、`design/03-rust-web/done/3-19-rust-web-browser-runtime-module-extraction-v1.md` 和 `AGENTS.md` 当前主线覆盖。后续 worker 不应从本文件的 `[ ]` 项继续派活。
|
||||||
|
|
||||||
## 1. 目标
|
## 1. 目标
|
||||||
|
|
||||||
本 checklist 只检查一个长期目标:
|
本 checklist 只检查一个长期目标:
|
||||||
|
|||||||
+7
-7
@@ -1,8 +1,9 @@
|
|||||||
# 3-23 Sidebar local folder / resource runtime follow-up v1
|
# 3-23 Sidebar local folder / resource runtime follow-up v1
|
||||||
|
|
||||||
> 创建时间:2026-05-25
|
> 创建时间:2026-05-25
|
||||||
> 状态:`process`
|
> 状态:`reference`
|
||||||
> 来源:`design/03-rust-web/done/3-22-sidebar-tree-runtime-second-stage-split-v1.md` Batch B / Batch D。
|
> 来源:`design/03-rust-web/done/3-22-sidebar-tree-runtime-second-stage-split-v1.md` Batch B / Batch D。
|
||||||
|
> 2026-06-06 归档说明:本文件不再作为 active process。后续审计已在 `design/03-rust-web/done/3-20-browser-runtime-followup-checklist-v1.md` 记录:`refreshLocalFolderSidebarSnapshot` 仍是 shell 编排,不整体迁入 `filetree-runtime.js`;mindmap fetch observer 仅迁出纯 helper 层。新的高收益 runtime 收口应按 event bus / projection renderer / view-state owner 单独拆 checklist。
|
||||||
|
|
||||||
## 1. 背景
|
## 1. 背景
|
||||||
|
|
||||||
@@ -19,15 +20,14 @@
|
|||||||
|
|
||||||
其中纯 URL/body/method/file name helper 已有一部分迁入 `filetree-runtime.js`。剩余函数多涉及 fetch hook、workspace/root/document 状态、projection render、selection/focus 恢复、watcher 标记和资源行 patch,因此不能整体迁出。
|
其中纯 URL/body/method/file name helper 已有一部分迁入 `filetree-runtime.js`。剩余函数多涉及 fetch hook、workspace/root/document 状态、projection render、selection/focus 恢复、watcher 标记和资源行 patch,因此不能整体迁出。
|
||||||
|
|
||||||
## 2. 下一批边界
|
## 2. 参考边界
|
||||||
|
|
||||||
- [ ] 只读审计 mindmap fetch observer,确认是否有新的纯 helper 可迁入 `filetree-runtime.js`。
|
- `refreshLocalFolderSidebarSnapshot` 保持 shell 编排:fetch、projection render、selection/focus、watcher 标记和 post-apply 副作用仍耦合当前 sidebar host。
|
||||||
- [ ] 只读审计 `refreshLocalFolderSidebarSnapshot` 的 post-apply 副作用,避免重复拆已经确认应留在 shell 的 fetch/projection 编排。
|
- mindmap fetch observer 只适合迁纯 URL/body/method/file name helper,不迁 fetch hook、workspace/root/document 状态和 projection render。
|
||||||
- [ ] 若实现,只迁稳定 DOM helper 或 payload normalize helper,不迁 fetch hook 与 projection render。
|
- 回归基线仍参考 `task455-local-folder-mindmap-clean-smoke.js` 与 `task479-local-folder-markdown-resource-lifecycle-smoke.js`,但本文件不再承接实现任务。
|
||||||
- [ ] 验证 `task455-local-folder-mindmap-clean-smoke.js` 和 `task479-local-folder-markdown-resource-lifecycle-smoke.js`。
|
|
||||||
|
|
||||||
## 3. 非目标
|
## 3. 非目标
|
||||||
|
|
||||||
- 不改变 local folder 资源归属语义。
|
- 不改变 local folder 资源归属语义。
|
||||||
- 不迁 Rust tree command / projection 语义到前端。
|
- 不迁 Rust tree command / projection 语义到前端。
|
||||||
- 不把 Page AI panel 混入本文件;AI owner 已拆到 `design/07-ai/process/7-38-page-ai-sidebar-runtime-owner-split-v1.md`。
|
- 不把 Page AI panel 混入本文件;AI owner 已拆到 `design/07-ai/done/7-38-page-ai-sidebar-runtime-owner-split-v1.md`。
|
||||||
+4
-2
@@ -2,12 +2,14 @@
|
|||||||
|
|
||||||
> 创建时间:2026-06-02
|
> 创建时间:2026-06-02
|
||||||
>
|
>
|
||||||
> 状态:`process`
|
> 状态:`done`
|
||||||
>
|
>
|
||||||
> Owner:04-tree-domain / mnote-web FileTree runtime
|
> Owner:04-tree-domain / mnote-web FileTree runtime
|
||||||
>
|
>
|
||||||
> 参考:VSCode `AsyncDataTree` / Sidex extension tree view
|
> 参考:VSCode `AsyncDataTree` / Sidex extension tree view
|
||||||
|
|
||||||
|
> 2026-06-06 归档说明:本文件 checklist 已全部闭合,FileTree view-state / lazy reveal 问题不再占用 active process。验收中记录的 18 秒 Tiptap 冷加载在当前 checkout 未复现;复核约 274ms 可见,后续如再次复现再参考 `design/05-editor-mainline/reference/5-36-tiptap-real-shell-cold-load-followup-v1.md`。
|
||||||
|
|
||||||
## 1. 背景
|
## 1. 背景
|
||||||
|
|
||||||
MNote FileTree 已保存 `expandedRelativePaths / selection / scrollTop`,但历史实现把 view-state 恢复成首屏 DOM 递归展开动作。打开 `design` 这类目录时,浏览器需要扫描已有 DOM、逐个展开历史目录、重复同步 selection,容易产生长任务和强制布局。
|
MNote FileTree 已保存 `expandedRelativePaths / selection / scrollTop`,但历史实现把 view-state 恢复成首屏 DOM 递归展开动作。打开 `design` 这类目录时,浏览器需要扫描已有 DOM、逐个展开历史目录、重复同步 selection,容易产生长任务和强制布局。
|
||||||
@@ -55,6 +57,6 @@ VSCode / Sidex 的关键不是“保存展开路径”本身,而是:
|
|||||||
|
|
||||||
- 隐私窗口打开 `design` 不因历史展开目录触发多层 `/api/tree/projections/file/children`。
|
- 隐私窗口打开 `design` 不因历史展开目录触发多层 `/api/tree/projections/file/children`。
|
||||||
- 打开 `7-45-chatonly-api-provider-runtime-v1.md` 时 FileTree 能看到 `design/07-ai/done` 父链和 active 文件。
|
- 打开 `7-45-chatonly-api-provider-runtime-v1.md` 时 FileTree 能看到 `design/07-ai/done` 父链和 active 文件。
|
||||||
- 表格内容正常显示;当前 dev-hot 冷浏览器仍观测到 Tiptap wasm-bindgen snippets/hydration 约 18 秒延迟,作为独立编辑器 runtime 性能债,不混入本轮 FileTree view-state 修复。
|
- 表格内容正常显示;历史 dev-hot 冷浏览器曾观测到 Tiptap wasm-bindgen snippets/hydration 约 18 秒延迟,但 2026-06-06 当前 checkout 复核未复现,不混入本轮 FileTree view-state 修复。
|
||||||
- 无新增轮询或定时刷新链路。
|
- 无新增轮询或定时刷新链路。
|
||||||
- 重新登录后,如果用户历史展开的可见目录只剩下向下箭头但没有 children,首屏完成后的 idle 小批次补加载应恢复一层文件细节。
|
- 重新登录后,如果用户历史展开的可见目录只剩下向下箭头但没有 children,首屏完成后的 idle 小批次补加载应恢复一层文件细节。
|
||||||
+12
-8
@@ -1,4 +1,6 @@
|
|||||||
# 5-13 tiptap runtime 冷加载 mindmap 重包拆分 checklist v1
|
# 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`。
|
||||||
|
|
||||||
## 背景
|
## 背景
|
||||||
|
|
||||||
@@ -17,7 +19,7 @@
|
|||||||
- [x] 保留 mindmap paragraph attrs:`mnoteBlockType`、`mindmapId`、`rootNodeId`、`projectionVersion`、`mindmapWidth`、`mindmapHeight` 仍可 parse/render。
|
- [x] 保留 mindmap paragraph attrs:`mnoteBlockType`、`mindmapId`、`rootNodeId`、`projectionVersion`、`mindmapWidth`、`mindmapHeight` 仍可 parse/render。
|
||||||
- [x] mindmap block runtime 改为遇到 mindmap block 时再异步加载,普通文档不触发该加载。
|
- [x] mindmap block runtime 改为遇到 mindmap block 时再异步加载,普通文档不触发该加载。
|
||||||
- [x] 重建 `reference-code/leptos-tiptap/src/js/generated` 和 `rust/spikes/leptos-tiptap-spike/generated/island` 产物。
|
- [x] 重建 `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,说明还有下一层瓶颈。
|
- [x] 复测 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`。
|
||||||
|
|
||||||
## 修改边界
|
## 修改边界
|
||||||
|
|
||||||
@@ -26,12 +28,12 @@
|
|||||||
- 可补 route fallback:`mnote-web` 的 `/api/leptos-tiptap-runtime/*path` 允许加载 lazily generated mindmap runtime asset。
|
- 可补 route fallback:`mnote-web` 的 `/api/leptos-tiptap-runtime/*path` 允许加载 lazily generated mindmap runtime asset。
|
||||||
- 不改 FileTree scoped reveal 已完成逻辑,不回滚上一轮未提交变更。
|
- 不改 FileTree scoped reveal 已完成逻辑,不回滚上一轮未提交变更。
|
||||||
|
|
||||||
## 2026-06-02 实测补充
|
## 2026-06-02 历史实测补充
|
||||||
|
|
||||||
- `npm test` 中 `普通 paragraph 生成产物不应捆绑 mindmap 重运行时` 已从失败变为通过。
|
- `npm test` 中 `普通 paragraph 生成产物不应捆绑 mindmap 重运行时` 已从失败变为通过。
|
||||||
- 冷浏览器打开 7-45:`domContentLoadedMs=136`、`editorVisibleMs=18550`、`tableVisibleMs=18553`、`mindmapRuntimeRequested=false`、`pageErrors=0`。
|
- 冷浏览器打开 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 导致。
|
- 单独在同源页面 `import + init + mount` 同一份 7-45 Tiptap document 约 `166ms`,所以 18s 不是 Tiptap document 本身渲染 194 blocks/2 tables 导致。
|
||||||
- 下一层根因应继续查 document shell 首屏环境下 wasm-bindgen snippets module graph 为什么在真实页面中约 18s 后才完成,而同源空页面 import 只需约 50ms。
|
- 2026-06-06 当前 checkout 已无法复现该 18s 现象;此段只保留为历史测量记录,不再作为 active 性能任务来源。
|
||||||
|
|
||||||
|
|
||||||
## 2026-06-02 插入思维导图回归修复
|
## 2026-06-02 插入思维导图回归修复
|
||||||
@@ -41,8 +43,10 @@
|
|||||||
- [x] GREEN:保持 loading NodeView 外层 DOM 稳定,runtime 加载完成后清空 loading 文案并 `appendChild(realNodeView.dom)`,后续 `update/destroy/stopEvent/ignoreMutation` 代理到真实 NodeView。
|
- [x] GREEN:保持 loading NodeView 外层 DOM 稳定,runtime 加载完成后清空 loading 文案并 `appendChild(realNodeView.dom)`,后续 `update/destroy/stopEvent/ignoreMutation` 代理到真实 NodeView。
|
||||||
- [x] 浏览器 smoke:临时 local-folder 页面通过 slash 插入思维导图后,请求 `tiptap_mindmap_paragraph_runtime.js`,placeholder `data-stage=runtime-loaded`,内部出现 `mnote-mindmap-editor-root`、`leptos-mindmap-island[data-stage=ready]` 和 `simple-mind-map-runtime`。
|
- [x] 浏览器 smoke:临时 local-folder 页面通过 slash 插入思维导图后,请求 `tiptap_mindmap_paragraph_runtime.js`,placeholder `data-stage=runtime-loaded`,内部出现 `mnote-mindmap-editor-root`、`leptos-mindmap-island[data-stage=ready]` 和 `simple-mind-map-runtime`。
|
||||||
|
|
||||||
## 长期形态决策
|
## 长期形态决策参考
|
||||||
|
|
||||||
- [ ] 参考思源 KMind 的插件/挂件形式,把完整 mindmap 编辑器迁到独立 Resource/Object tab 或 plugin host。
|
以下不是本次重包拆分的归档阻塞项,后续如实施应另拆 Resource/Object tab 或 plugin host checklist:
|
||||||
- [ ] Markdown 正文内的 mindmap block 长期收敛为轻量镜像块/预览块/打开按钮,不在普通正文 NodeView 内承载完整编辑器。
|
|
||||||
- [ ] 插件 host 提供 `getMindMapData/saveMindMapData/resize/destroy` 一类数据桥和生命周期,数据真相仍为 Resource Tree 下的 `.mindmap.json`。
|
- 参考思源 KMind 的插件/挂件形式,把完整 mindmap 编辑器迁到独立 Resource/Object tab 或 plugin host。
|
||||||
|
- Markdown 正文内的 mindmap block 长期收敛为轻量镜像块/预览块/打开按钮,不在普通正文 NodeView 内承载完整编辑器。
|
||||||
|
- 插件 host 提供 `getMindMapData/saveMindMapData/resize/destroy` 一类数据桥和生命周期,数据真相仍为 Resource Tree 下的 `.mindmap.json`。
|
||||||
@@ -0,0 +1,72 @@
|
|||||||
|
# 5-36 Tiptap real shell cold-load follow-up v1
|
||||||
|
|
||||||
|
> 创建时间:2026-06-06
|
||||||
|
>
|
||||||
|
> 状态:`reference`
|
||||||
|
>
|
||||||
|
> Owner:05-editor-mainline / leptos-tiptap island / mnote-web document shell
|
||||||
|
>
|
||||||
|
> 来源:`design/05-editor-mainline/done/5-13-tiptap-runtime-cold-load-mindmap-split-checklist-v1.md`
|
||||||
|
>
|
||||||
|
> 2026-06-06 复核结论:当前 checkout 未复现 18 秒冷加载。临时真实浏览器复测打开 `design/07-ai/done/7-45-chatonly-api-provider-runtime-v1.md`,结果为 `domContentLoadedMs=102`、`editorVisibleMs=271`、`tableVisibleMs=274`、`mindmapRuntimeRequested=false`、1 个约 97ms longtask;截图和结果见 `tmp/tmp-7-45-current-cold-open-check/`。因此本文件不再作为 active process,只保留为性能问题复现时的参考 checklist。
|
||||||
|
|
||||||
|
## 1. 背景
|
||||||
|
|
||||||
|
`5-13` 已确认普通 paragraph runtime 不再捆绑 mindmap/simple-mind-map 重包:`tiptap_paragraph.js` 从约 1,025,978 bytes 降到约 7,619 bytes,普通 7-45 页面不再请求 `tiptap_mindmap_paragraph_runtime.js`。
|
||||||
|
|
||||||
|
历史记录中,真实文档壳打开 `design/07-ai/done/7-45-chatonly-api-provider-runtime-v1.md` 曾观测到 `editorVisibleMs/tableVisibleMs≈18.55s`;同源空页面单独 `import + init + mount` 同一份 Tiptap document 约 166ms。2026-06-06 当前 checkout 复核未复现该问题,表格约 274ms 可见。因此本文件只作为“若再次复现 18 秒冷加载时如何取证”的参考,不应直接派发实现任务。
|
||||||
|
|
||||||
|
## 2. 目标
|
||||||
|
|
||||||
|
- 建立可重复的冷浏览器性能 smoke,记录 editor visible、table visible、runtime asset waterfall 和主线程长任务。
|
||||||
|
- 区分 Tiptap document render、wasm-bindgen snippets import、document shell bootstrap、sidebar/page settings/Page AI 初始化之间的耗时。
|
||||||
|
- 给普通 Markdown 文档首屏设定可执行预算,先以 `tableVisibleMs < 3s` 作为 P0 目标。
|
||||||
|
- 保持 `5-13` 的 mindmap 懒加载成果,不重新把 mindmap runtime 放回普通 paragraph 主包。
|
||||||
|
|
||||||
|
## 3. 非目标
|
||||||
|
|
||||||
|
- 不改 FileTree view-state / lazy reveal;该问题已由 `4-25` 归档。
|
||||||
|
- 不在本轮实现完整 mindmap plugin host;正文内 mindmap 长期形态另拆 Resource/Object tab 或 plugin host checklist。
|
||||||
|
- 不通过新增轮询、定时刷新或隐藏首屏内容来掩盖加载问题。
|
||||||
|
|
||||||
|
## 4. 复现时 Checklist
|
||||||
|
|
||||||
|
### Phase A:RED smoke 与证据
|
||||||
|
|
||||||
|
- [ ] 新增或复用冷浏览器 smoke,固定打开 7-45 或等价大 Markdown 文档。
|
||||||
|
- [ ] 记录 `domContentLoadedMs`、`editorVisibleMs`、`tableVisibleMs`、wasm snippets 请求开始/结束、Tiptap island mount 开始/结束。
|
||||||
|
- [ ] 截取 Performance trace 或至少记录 `PerformanceObserver longtask` 摘要。
|
||||||
|
- [ ] 断言普通 Markdown 页面不请求 `tiptap_mindmap_paragraph_runtime.js`。
|
||||||
|
|
||||||
|
验收:
|
||||||
|
|
||||||
|
- [ ] smoke 在当前基线下能稳定复现 `tableVisibleMs` 远高于同源空页面 import。
|
||||||
|
- [ ] 结果 JSON 写入 `tmp/`,包含网络、longtask 和 runtime 阶段字段。
|
||||||
|
|
||||||
|
### Phase B:根因切分
|
||||||
|
|
||||||
|
- [ ] 对比真实 document shell 与同源空页面 import 的 module graph。
|
||||||
|
- [ ] 关掉非必要首屏 surface 的实验开关做只读对照:Page AI drawer、page settings、resource tab prewarm、sidebar secondary pane。
|
||||||
|
- [ ] 检查是否存在 modulepreload 缺失、重复 import、deferred script 排队或 wasm-bindgen init 被其他任务阻塞。
|
||||||
|
- [ ] 确认 `document-editor-adapter-runtime.js` 中 runtime prewarm 的 `setTimeout` 不影响首屏关键路径。
|
||||||
|
|
||||||
|
验收:
|
||||||
|
|
||||||
|
- [ ] 给出一个可被代码改动验证的根因假设,例如具体 runtime asset、init 阶段或主线程长任务来源。
|
||||||
|
|
||||||
|
### Phase C:小范围修复
|
||||||
|
|
||||||
|
- [ ] 只修改根因对应模块,不做编辑器大重构。
|
||||||
|
- [ ] 如果需要预加载,只用明确 asset hint 或模块加载顺序调整,不新增周期任务。
|
||||||
|
- [ ] 如果需要推迟非关键 surface 初始化,必须保持功能入口可用并补 smoke。
|
||||||
|
|
||||||
|
验收:
|
||||||
|
|
||||||
|
- [ ] 冷浏览器 smoke 达到 `tableVisibleMs < 3s`,或至少给出明确的剩余瓶颈和下一轮预算。
|
||||||
|
- [ ] `5-13` 的 mindmap 懒加载断言继续通过。
|
||||||
|
|
||||||
|
## 5. 重新激活条件
|
||||||
|
|
||||||
|
- 用户或 smoke 再次稳定复现 `tableVisibleMs > 3s`。
|
||||||
|
- 复现结果包含真实浏览器 result JSON、截图、runtime asset waterfall 和 longtask 摘要。
|
||||||
|
- 确认不是冷编译、服务刚启动、临时网络/磁盘抖动或非当前 checkout 造成。
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
# 19 Non-LightRAG design cleanup and follow-up checklist v1
|
||||||
|
|
||||||
|
> 创建时间:2026-06-06
|
||||||
|
>
|
||||||
|
> 状态:`process`
|
||||||
|
>
|
||||||
|
> Owner:10-review / 03-rust-web / 05-editor-mainline / 07-ai
|
||||||
|
|
||||||
|
## 1. 边界
|
||||||
|
|
||||||
|
当前另一个 agent 正在修改 LightRAG 相关实现与设计。本 checklist 暂不写 `design/07-ai/done/7-50-lightrag-knowledge-rag-provider-v1.md`、`rust/crates/mnote-web/src/routes/knowledge_rag.rs`、`rust/crates/mnote-web/src/hermes_tools/knowledge_rag.rs` 或 LightRAG smoke。等对方改动稳定后,再单独做 LightRAG diff review。
|
||||||
|
|
||||||
|
本轮先减少非 LightRAG 设计误读:关闭已完成 process、降级历史快照、把真实未完成项拆成更小 checklist。
|
||||||
|
|
||||||
|
## 2. 已执行清理
|
||||||
|
|
||||||
|
- [x] `4-25-filetree-view-state-model-driven-lazy-reveal-v1.md` 从 `04-tree-domain/process/` 移到 `04-tree-domain/done/`,并标注历史 18 秒冷加载当前未复现。
|
||||||
|
- [x] `3-23-sidebar-local-folder-resource-runtime-followup-v1.md` 从 `03-rust-web/process/` 移到 `03-rust-web/reference/`,并固定 `refreshLocalFolderSidebarSnapshot` 的 shell 编排边界。
|
||||||
|
- [x] `5-13-tiptap-runtime-cold-load-mindmap-split-checklist-v1.md` 从 `05-editor-mainline/process/` 移到 `05-editor-mainline/done/`,只归档 mindmap 重包拆分。
|
||||||
|
- [x] 新增并复核 `5-36-tiptap-real-shell-cold-load-followup-v1.md`。当前 checkout 未复现 18 秒冷加载,已降级为 `05-editor-mainline/reference/`。
|
||||||
|
- [x] 给 `3-6-rust-web-main-execution-plane-checklist-v1.md` 增加历史快照说明,避免从旧 `[ ]` 项继续派活。
|
||||||
|
- [x] 收紧 `10-current-mnote-ai-runtime-review-v1.md` 的 `mnote.doc.markdown_edit` 口径,避免把历史工具描述成 local-first 新 agent fallback。
|
||||||
|
|
||||||
|
## 3. 下一批非 LightRAG checklist
|
||||||
|
|
||||||
|
### P0:Tiptap real shell cold-load
|
||||||
|
|
||||||
|
- [x] 执行 7-45 当前 checkout 临时复核:`domContentLoadedMs=102`、`editorVisibleMs=271`、`tableVisibleMs=274`、`mindmapRuntimeRequested=false`。
|
||||||
|
- [x] 因未复现,`5-36` 降为 reference;暂不改 modulepreload、runtime prewarm 或非关键 surface 初始化顺序。
|
||||||
|
|
||||||
|
### P1:Local-folder event bus
|
||||||
|
|
||||||
|
- [ ] 新建 `03-rust-web` process:浏览器端 local-folder event bus。
|
||||||
|
- [ ] 目标是 sidebar、document session、resource tab 订阅同一 `/api/local-folder/events` 连接。
|
||||||
|
- [ ] 验收要统计同一页面只有一个 local-folder EventSource,且后台写入仍能触发 document refresh 与 localized filetree refresh。
|
||||||
|
|
||||||
|
### P2:Page Aggregate local-first hard guard
|
||||||
|
|
||||||
|
- [ ] 新建或更新 `05-editor-mainline` process:local-first 文档页必须优先消费 `page_aggregate.block_document`。
|
||||||
|
- [ ] 对 `compat.legacy_content` fallback 增加 local-first telemetry 或负向 smoke,确保它只出现在 cloud/legacy/explicit compat 场景。
|
||||||
|
- [ ] 保存链路继续向 `EditorBlockDocument` / `tiptapDocument` 单一主 payload 收口。
|
||||||
|
|
||||||
|
### P3:7-18 agent edit clean/dirty smoke
|
||||||
|
|
||||||
|
- [x] 在不碰 LightRAG 的前提下,拆出 `design/07-ai/process/7-18-agent-edit-clean-dirty-smoke-checklist-v1.md`。
|
||||||
|
- [ ] 验 clean buffer:agent 原生 patch 修改当前 `.md` 后,watcher -> BufferStore -> Page Aggregate -> ProseMirror 可见更新。
|
||||||
|
- [ ] 验 dirty buffer:外部 agent 写入不会静默覆盖,必须出现冲突或 review 状态。
|
||||||
|
- [ ] 验 readonly:写入型 run 在 ACP/tool 层前置拒绝,而不是只靠审计后置记录。
|
||||||
|
|
||||||
|
### P4:LightRAG diff review gate
|
||||||
|
|
||||||
|
- [ ] 等另一个 agent 完成后,只读检查 LightRAG diff。
|
||||||
|
- [ ] 重点核对 source registry、watcher stale/delete/reindex、query scope、`locatorDegraded`、job ledger 与 smoke 是否互相一致。
|
||||||
|
- [ ] 若 LightRAG diff 已稳定,再决定是否新建 `7-51` 或更新现有 `7-48`。
|
||||||
|
|
||||||
|
## 4. 非目标
|
||||||
|
|
||||||
|
- 不在本 checklist 中修改 LightRAG 实现。
|
||||||
|
- 不删除历史设计证据;只通过移动目录、状态说明和新 checklist 降低误读。
|
||||||
|
- 不把已归档文件中的旧 checklist 当作新 worker 的任务来源。
|
||||||
Reference in New Issue
Block a user