lix/mnote

Files

T

lix-2026 384da4e44c feat(tree): checkpoint resource lifecycle work

提交当前顶层 mnote Git 工作区，范围集中在 04-tree-domain 的 resource/trash/filetree 生命周期、mnote-web resource_trash 路由、Convex/Next 兼容接口、sidebar/file-tree 客户端适配、smoke 脚本与对应设计/bug 记录。

不包含被 ignore 的 design/05-editor-mainline/reference-code/leptos-tiptap 嵌套仓库改动。新增 smoke 的测试密码改为运行时读取 MNOTE_E2E_PASSWORD，避免提交明文 credential assignment。

2026-05-16 07:38:45 +08:00

3.5 KiB

Raw Blame History

4-36 [process][bug] 本地文件夹切回云空间后进入空白 workspace v1

更新时间：2026-05-15

分类归属：

04-tree-domain/process

涉及边界：workspace source switch、本地文件夹入口、Convex workspace 恢复、Sidebar File Tree/Page Tree projection

用户反馈：

点击进入本地文件夹后，再点击“云空间”，会得到空白的空间页面。

截图：/mnt/Data1T/mnote/tmp/image copy 101.png。

点击垃圾箱后才能找回之前空间的页面。

1. 问题定义

从 Convex 云空间切到本地文件夹，再通过工作区来源菜单切回“云空间”时，页面应恢复到之前的 Convex workspace，并展示原有 Page Tree / File Tree。

当前异常表现是：切回后页面壳仍显示“开发用户的空间”和文档编辑区，但左侧 Explorer 为空，提示“暂无文件或页面”。这会让用户误以为云空间数据丢失；进入垃圾箱后又能看到原空间内容，说明更像是 workspace source / workspaceId 恢复错误，而不是数据真的被删除。

2. 初步根因

已确认一个高风险代码点：

rust/crates/mnote-web/src/ssr/pages/layout.rs 中 openLocalFolderRoot() 在离开云空间前调用 rememberCloudWorkspaceId(resolveWorkspaceId(document.body))。
resolveWorkspaceId(document.body) 只检查当前元素和祖先，再回退到 URL 的 workspaceId 或 "default"；它不会读取页面子树里的真实 data-workspace-id。
当云空间入口 URL 没有显式 workspaceId 时，这会把 "default" 记为上次云空间 workspace。
之后 switchToCloudWorkspace() 读取这个错误的 last cloud workspace id，跳到 /?workspaceId=default&sourceKind=convex_workspace，从而得到空白 workspace。

3. 复现路径

进入 http://localhost:3000 的真实云空间，确保侧边栏有页面。
点击左上角工作区来源菜单或文件夹入口，进入一个本地文件夹。
再打开工作区来源菜单，点击“云空间”。
观察 URL、localStorage.mnote.workspace.lastCloudWorkspaceId、Page Tree / File Tree row。

期望：

URL 应带回真实云空间 workspaceId，不能是 default。
Page Tree / File Tree 应恢复云空间页面。
不需要通过垃圾箱或其它入口才能找回原空间。

4. 验收标准

新增 smoke 覆盖：云空间有至少一个页面 -> 打开本地文件夹 -> 切回云空间 -> 原云空间页面 row 仍可见。
mnote.workspace.lastCloudWorkspaceId 不得在有真实 workspace id 时被写成 default。
switchToCloudWorkspace() 不能携带 rootUri，也不能落到本地文件夹空树。
修复后真实浏览器复核截图中的路径不再出现“暂无文件或页面”的空白 Explorer。

5. 当前状态

当前状态：done

2026-05-15 已修复并验证：

rust/crates/mnote-web/src/ssr/pages/layout.rs 不再在进入本地文件夹前用 document.body 推导 workspaceId；改为从当前 URL / DOM 子树读取真实云空间 workspaceId，并忽略 synthetic default。
scripts/task441-local-folder-cloud-switch-smoke.js 通过：打开云空间 -> 进入本地文件夹 -> 切回云空间后，URL、lastCloudWorkspaceId、Page Tree / File Tree 都恢复到原 workspace，且原云空间页面 row 仍可见。
cargo test --manifest-path rust/Cargo.toml -p mnote-web sidebar_workspace_source_switch_remembers_real_cloud_workspace_before_local_folder -- --nocapture 通过。

3.5 KiB Raw Blame History