lix-2026
9551d4c1dc
Retire legacy OCR/media/evidence fallbacks, add local-folder event bus and Page Aggregate guards, and archive completed design checklists. Validation: cargo test -p mnote-web -- --test-threads=1; cargo test --workspace -- --test-threads=1; git diff --check; codegraph sync .; codegraph_status.
4.6 KiB
4.6 KiB
19 Non-LightRAG design cleanup and follow-up checklist v1
创建时间：2026-06-06
状态：
doneOwner：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. 已执行清理
4-25-filetree-view-state-model-driven-lazy-reveal-v1.md从04-tree-domain/process/移到04-tree-domain/done/，并标注历史 18 秒冷加载当前未复现。3-23-sidebar-local-folder-resource-runtime-followup-v1.md从03-rust-web/process/移到03-rust-web/reference/，并固定refreshLocalFolderSidebarSnapshot的 shell 编排边界。5-13-tiptap-runtime-cold-load-mindmap-split-checklist-v1.md从05-editor-mainline/process/移到05-editor-mainline/done/，只归档 mindmap 重包拆分。- 新增并复核
5-36-tiptap-real-shell-cold-load-followup-v1.md。当前 checkout 未复现 18 秒冷加载，已降级为05-editor-mainline/reference/。 - 给
3-6-rust-web-main-execution-plane-checklist-v1.md增加历史快照说明，避免从旧[ ]项继续派活。 - 收紧
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
- 执行 7-45 当前 checkout 临时复核：
domContentLoadedMs=102、editorVisibleMs=271、tableVisibleMs=274、mindmapRuntimeRequested=false。 - 因未复现，
5-36降为 reference；暂不改 modulepreload、runtime prewarm 或非关键 surface 初始化顺序。
P1：Local-folder event bus
- 已完成并归档
design/03-rust-web/done/3-24-local-folder-browser-event-bus-v1.md。 - sidebar、document session、resource tab 已订阅同一 local-folder event bus。
task540已验证同一页面只有一个 local-folder EventSource，且后台写入仍能触发 document refresh 与 localized filetree refresh。
P2：Page Aggregate local-first hard guard
- 已完成并归档
design/05-editor-mainline/done/5-36-page-aggregate-local-first-hard-guard-v1.md。 - 对
compat.legacy_contentfallback 增加 local-first DOM diagnostic，task541断言 local.md为page_aggregate.block_document。 - 保存链路未扩大 legacyBlocks 使用面，
task167覆盖 local-first title/body/options 写入回读。
P3：7-18 agent edit clean/dirty smoke
- 在不碰 LightRAG 的前提下，拆出并完成
design/07-ai/done/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 层前置拒绝，而不是只靠审计后置记录。
- 剩余归档项已在
design/10-review/done/20-post-lightrag-runtime-hardening-checklist-v1.mdP1 完成：补真实后端 auditScope / allowed root 外写入拒绝证据后归档 7-18。
P4：LightRAG post-commit audit gate
- LightRAG 已提交并统一为 7-50 主线，旧 LiteParse / evidence / local OCR 默认路径已退役。
- 只读检查 7-50 post-commit 状态。
- 重点核对 source registry、watcher stale/delete/reindex、query scope、
locatorDegraded、status bridge、image wrapper 与 smoke 是否互相一致。 - 发现的硬化项已拆到
20-post-lightrag-runtime-hardening-checklist-v1.md并完成design/07-ai/done/7-51-lightrag-post-commit-hardening-v1.md。
P5：7-47 capability registry / local search / design governance follow-up
20-post-lightrag-runtime-hardening-checklist-v1.md已继续完成 capability registry 口径重写、local search 边界和 design 状态治理。7-46/7-48已降级到design/07-ai/reference/，避免 worker 继续按旧 evidence / LiteParse 主线派活。
4. 非目标
- 不在本 checklist 中修改 LightRAG 实现。
- 不删除历史设计证据；只通过移动目录、状态说明和新 checklist 降低误读。
- 不把已归档文件中的旧 checklist 当作新 worker 的任务来源。