feat: integrate pi rust lab runtime

2026-07-10 10:54:34 +08:00
parent c8472bb898
commit 896c94b696
73 changed files with 19852 additions and 1152 deletions
@@ -0,0 +1,45 @@
+# 5-44 Block menu 打开后泄露 Material Symbols ligature 文本
+
+> 创建时间：2026-07-08
+> 状态：`done`
+> Owner：`05-editor-mainline`
+
+## 现象
+
+在 mnote 主编辑器中 hover 到块手柄并点开块菜单后，菜单项图标位置直接显示 `auto_awesome`、`autorenew`、`chevron_right`、`content_copy`、`format_align_center` 等英文 ligature 文本，导致菜单宽度和排版明显错乱。
+
+复现路径：
+
+1. 打开本地主编辑器文档。
+2. hover 到正文块左侧手柄。
+3. 点击手柄打开块菜单。
+4. 观察块菜单内图标列。
+
+失败证据：
+
+- `tmp/block-handle-menu-display-diagnostic/after-click.png`
+- `tmp/block-handle-menu-display-diagnostic/metrics.json`
+
+## 根因
+
+主编辑器 island 的 icon helper 和部分动态菜单项只输出了 `class="material-symbols-outlined"` 加 ligature 文本，没有输出 `data-icon`。当前 mnote 主壳使用本地 SVG mask 作为 Material Symbols fallback，fallback CSS 只对带 `data-icon` 的节点生效；缺少 `data-icon` 时，浏览器没有 Material Symbols 字体可用，就直接把 ligature 文本当普通文本显示出来。
+
+## 修复
+
+- `material_icon()` 改为输出 `data-icon=<name>`，并移除可见 ligature 文本。
+- block transform 子菜单和 slash 菜单动态图标同步输出 `data-icon`，不再把 ligature 作为可见文本。
+- 补齐主壳 CSS 中块菜单常用 icon 的本地 fallback，确保无外部 Material Symbols 字体时仍能显示为稳定图标。
+- 重新执行 wasm release build 与 `wasm-bindgen`，更新 `rust/spikes/leptos-tiptap-spike/generated/island/*` 产物。
+
+## 验收
+
+- `cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml` 通过，只有既有 warning。
+- `cargo build --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml --target wasm32-unknown-unknown --release` 通过，只有既有 warning。
+- `wasm-bindgen rust/spikes/leptos-tiptap-spike/target/wasm32-unknown-unknown/release/mnote_leptos_tiptap_spike.wasm --target web --out-dir rust/spikes/leptos-tiptap-spike/generated/island --out-name mnote-leptos-tiptap-spike-island` 通过。
+- `node scripts/task489-block-menu-delete-undo-smoke.js` 通过。
+- 浏览器诊断确认块菜单 `leaked=false`，12 个菜单项正常渲染，图标节点宽高恢复为 `20x20`。
+- 修复后截图：`tmp/block-handle-menu-display-diagnostic/after-click-fixed.png`。
+
+## 未覆盖
+
+- 本轮只修复手柄菜单与 editor runtime 图标文本泄露；没有扩大到全站所有未带 `data-icon` 的历史图标节点。
@@ -0,0 +1,109 @@
+# MNote 浏览器 QA 实测发现 2026-07-08
+
+- **状态**：`process`
+- **来源**：Agent Board Pi Taskflow 实测（MNote 浏览器 QA → Bug 文档 20260708-130503）
+- **复现环境**：
+  - MNote Web：`http://127.0.0.1:3000`，Rust SSR + leptos-tiptap island
+  - 后端：control-plane libSQL local
+  - 浏览器：Playwright Chromium headless，viewport 1280×800
+  - 登录：测试账号 `mnote.e2e@example.com`，authMode=controlPlaneSession
+  - 工作区：`/mnt/Data1T/Mnote_data/users/mnote-e2e/workspaces/my-space`
+
+---
+
+## 1. 总体状态
+
+| 检查项 | 结果 | 详情 |
+|--------|------|------|
+| API Gateway /health | ✅ PASS | 200 |
+| Auth 页面加载 | ✅ PASS | 518ms |
+| 测试账号快速登录 | ✅ PASS | 跳转到 `/` |
+| Workspace 壳渲染 | ✅ PASS | sidebar / topbar / shell 均可见 |
+| Page AI / OpenHub 页面 | ✅ PASS | 130ms 加载，AI 输入框可见 |
+| Console 错误 | ✅ PASS | 0 errors |
+| 业务网络错误 | ✅ PASS | 0 real errors（SSE abort 为预期导航行为） |
+
+---
+
+## 2. 发现的问题
+
+### 2.1 `file-order.json` 页面排序索引为空
+
+- **严重程度**：medium
+- **实际结果**：`/mnt/Data1T/Mnote_data/users/mnote-e2e/workspaces/my-space/.mnote/file-order.json` 内容为 `{"parents": {}, "version": 1}`，无任何页面条目。
+- **预期结果**：工作区中存在有效页面目录（`新页面054900`、`新页面145827`、`新页面233155`、`有机合成中的保护基` 等），每个目录下均有 `.md` 正文文件，file-order.json 应包含这些页面的排序条目。
+- **证据**：
+  ```bash
+  $ cat .mnote/file-order.json
+  {"parents": {}, "version": 1}
+
+  $ ls workspace/
+  新页面054900/  新页面145827/  新页面233155/  有机合成中的保护基/
+  ```
+- **影响范围**：页面树（Page Tree）排序可能不正确，新建页面可能无法正确出现在侧边栏页面列表中。
+- **建议修复方向**：检查页面创建/重命名/移动流程是否正确更新 `file-order.json`；检查 Pi lab 批量创建页面的流程是否绕过了正常的 metadata 写入路径。
+
+### 2.2 `/api/tree/page-tree` 端点返回 404
+
+- **严重程度**：low
+- **实际结果**：`GET /api/tree/page-tree` 返回 HTTP 404。
+- **预期结果**：应返回 200 或 401（需要认证），而非 404。
+- **证据**：
+  ```bash
+  $ curl -s -w "\nHTTP: %{http_code}" http://127.0.0.1:3000/api/tree/page-tree
+  HTTP: 404
+  ```
+- **影响范围**：直接调用此 API 的外部客户端或测试脚本会失败。前端使用 `GET /api/tree/view-state?treeKind=pagetree`（需要认证，已正常工作），当前不受影响。
+- **建议修复方向**：确认 `/api/tree/page-tree` 是否为已废弃路由；若是，应在路由注册时返回 410 Gone 或转发到 view-state；若不是，应修复路由注册。
+
+### 2.3 侧边栏中无 `a[href*="/document/"]` 格式的文档链接
+
+- **严重程度**：low（待确认是否为预期行为）
+- **实际结果**：Playwright selector `a[href*="/document/"]` 在侧边栏中找到 0 个元素。
+- **预期结果**：侧边栏页面树中的页面应可点击跳转到文档页。
+- **证据**：QA 脚本 `page.locator('a[href*="/document/"]').count()` 返回 0。
+- **影响范围**：如果页面确实使用不同 URL 模式（如 `/page/...` 或前端路由），则无影响；否则侧边栏页面无法点击跳转。
+- **建议修复方向**：确认当前侧边栏页面树使用的链接格式；如果是前端 SPA 路由（如 `data-page-id` + click handler），则更新测试 selector；如果是 bug，修复链接生成。
+
+### 2.4 Dev 模式 hot-reload 轮询累积
+
+- **严重程度**：low（仅 dev 模式）
+- **实际结果**：多个 `GET /api/dev/hot-reload` 请求处于 pending 状态，随时间累积。
+- **预期结果**：hot-reload 连接应复用或及时关闭，不应无限累积。
+- **证据**：网络追踪显示 20+ 个 pending 的 `GET /api/dev/hot-reload` 请求。
+- **影响范围**：仅影响开发模式下的浏览器性能和内存占用，不影响生产环境。
+- **建议修复方向**：检查 hot-reload EventSource/WebSocket 连接的生命周期管理，确保旧连接在页面导航或重连时正确关闭。
+
+---
+
+## 3. 已验证无问题的路径
+
+- Auth 登录流程：正常
+- Workspace 壳渲染：正常
+- Page AI / OpenHub 页面：正常加载
+- API `/api/auth/session`：正常
+- API `/api/tree/view-state`（需认证）：正常
+- API `/api/tree/projections/file/children`（需认证）：正常
+- SSE `/api/local-folder/events`：正常建立连接
+- API `/api/page-ai/pi/status`：正常
+- API `/api/ai-settings/effective`：正常
+
+---
+
+## 4. 测试脚本
+
+QA 脚本位于：
+- `/tmp/mnote-browser-qa-20260708.js`（基础检查）
+- `/tmp/mnote-browser-qa-20260708-detail.js`（详细检查）
+- `/tmp/mnote-browser-qa-comprehensive.js`（综合检查）
+- `/tmp/mnote-network-trace.js`（网络追踪）
+
+结果文件：
+- `/tmp/mnote-browser-qa-20260708/result.json`
+- `/tmp/mnote-browser-qa-20260708/result-detail.json`
+- `/tmp/mnote-browser-qa-20260708/result-final.json`
+
+截图：
+- `/tmp/mnote-browser-qa-20260708/01-main-page.png`（Auth 页）
+- `/tmp/mnote-browser-qa-20260708/02-after-login.png`（登录后 workspace）
+- `/tmp/mnote-browser-qa-20260708/05-post-login-workspace.png`（workspace 页）