# 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 定向测试：

```bash
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：

```bash
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 方向排查。