110 lines
5.2 KiB
Markdown
110 lines
5.2 KiB
Markdown
|
# 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 页）
|