mnote/bugs/04-tree-domain/done/4-39-filetree-create-title-cache-md-conflict-v1.md

4-39 文件树新建不更新与 .md 后缀被缓存/标题同步覆盖

状态

• 状态：done
• 分类：04-tree-domain
• 发现时间：2026-05-15
• 关联：4-27、4-35、4-38

现象

1. File Tree 中点击新建页面后，树不再稳定更新；刷新后最新页面显示也异常。
2. 页面树显示为 新页面，文件树应显示为 新页面.md，但部分路径会显示成 新页面。
3. 点击 File Tree 的 mindmap 资源 mindmap-mindmap... 后，再点击 新页面.md，文件树标题会变成 新页面，.md 消失。

截图证据：

• /mnt/Data1T/mnote/tmp/image copy 103.png
• /mnt/Data1T/mnote/tmp/image copy 104.png

已确认冲突点

1. live snapshot filetree renderer 引用了未定义变量

rust/crates/mnote-web/src/ssr/pages/layout.rs 中，renderFileRows() 使用了 activeRowId，但旧函数签名没有把它作为参数传入。tree live snapshot / delta 调用 renderSidebarSnapshot() 时会进入该函数，可能抛出 ReferenceError，导致“新建后不更新”。

修复方向：

• renderFileRows(parentId, grouped, activeId, activeRowId) 显式传入 active row。
• 递归调用也继续传入 active row。
• renderFileProjection() 调用 currentFileTreeActiveRowId() 后传入。

2. live snapshot 使用原始页面标题，绕过 .md 文件树显示口径

本地 create 补偿路径 applyCreatedDocumentLocally() -> upsertFileDocumentRows() 会把页面标题 新页面 显示成 新页面.md。

但 live snapshot / SSR projection 路径直接使用 projection item 的 title，导致文件树页面行被重绘成 新页面。

修复方向：

• live renderFileRows() 对 document/doc/markdown 且非 asset 的行统一使用 fileTreePageTitle(rawTitle)。
• 资源行仍显示资源自身标题，不套页面 .md 规则。

3. 文档 pane 标题同步绕过 .md 文件树显示口径

rust/crates/mnote-web/src/routes/web_shell.rs 的 render_document_title_controller_script() 中，updateVisibleTitle() 更新文件树 row title 时使用原始 title，没有经过 fileTreePageTitle()。

这解释了“点击 mindmap 后再点 新页面.md，.md 消失”：pane 内导航/标题同步链路覆盖了文件树行标题。

修复方向：

• 在 title controller 中加入同等 fileTreePageTitle()。
• page tree / breadcrumb 仍显示页面标题 新页面。
• filetree document row 显示 新页面.md。

4. pane 内导航仍用旧 index:<documentId> 选中规则

web_shell.rs 的 updatePaneChrome() 中，primary pane 导航后 filetree selected 判断仍是 index:${documentId}。

当前 4-35 口径中，Convex 页面正文默认 row 已迁移为 doc:<documentId>，旧 index 规则会导致 selection 与 active row 不稳定。

修复方向：

• pane 内 primary navigation 统一使用 doc:<documentId>。

VSCode 参考原则

参考 /mnt/Data1T/mnote/design/05-editor-mainline/reference-code/vscode：

• 点击打开、active、selection、reveal 是分离状态，不能互相无条件覆盖。
• refresh 应更新局部 children / item，不应无条件清空重建整棵树。
• label 显示必须由单一口径生成；不能一条路径显示后缀，另一条路径丢后缀。
• selection/focus 需要去重，相同 selection 不应重复提交。

验收标准

• 在 File Tree 点击 + 新建页面后，不刷新即可出现新页面 row。
• 新建后本地补偿、tree live snapshot、刷新后文件树页面行都显示 {title}.md。
• 页面树仍显示 {title}，不显示 .md。
• 点击 mindmap 资源后，再点击同页面或其它页面的 filetree {title}.md，标题不丢 .md。
• tree live snapshot / delta 不再因为 activeRowId is not defined 中断。

已验证

• 已新增真实浏览器 smoke，覆盖 create -> live snapshot -> mindmap click -> filetree page click -> .md 保持。

验证结果

Rust 定向测试：

cargo test --manifest-path rust/Cargo.toml -p mnote-web sidebar_filetree_runtime_uses_markdown_page_row_without_local_index_child -- --nocapture
cargo test --manifest-path rust/Cargo.toml -p mnote-web document_shell_returns_page_aggregate_snapshot -- --nocapture

真实浏览器 smoke：

MNOTE_UI_BASE_URL=http://127.0.0.1:3428 node scripts/task444-filetree-create-mindmap-title-cache-smoke.js

结果文件：

• tmp/task444-filetree-create-mindmap-title-cache-smoke/result.json
• tmp/task444-filetree-create-mindmap-title-cache-smoke/after-page-click.png

关键断言：

• fileTreeCreated.title = "新页面.md"
• afterLive.title = "新页面.md"
• afterMindmapClick.title = "新页面.md"
• afterPageClick.title = "新页面.md"
• afterPageClick.selected = "true"
• 未出现 activeRowId / ReferenceError。

备注：smoke 中出现一次 mnote standalone mindmap mount failed TypeError: Failed to fetch，但不影响本 bug 的文件树 title / selected 验证；如后续稳定复现，应另归 05-editor-mainline 或 mindmap runtime 方向排查。