feat(desktop): embed BoosAPI Desktop client as a subproject

Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
2026-06-22 11:32:57 +08:00
parent d9c78ecc73
commit e0a5f57793
2305 changed files with 449355 additions and 0 deletions
@@ -0,0 +1,74 @@
+# E2E 测试报告（中文）
+
+> 英文版参见：`docs/e2e-testing-report.md`。
+
+本文档汇总了仓库中新增的端到端（E2E）Markdown 解析测试，便于在未来持续扩展覆盖范围。
+
+## 目标
+
+提供一个精简、可复现的 E2E 测试套件，用于验证解析器和渲染器是否能正确处理常见的 Markdown 结构，并作为后续扩展的基础。
+
+## 新增内容
+
+- `test/fixtures/` —— 收录具有代表性的 Markdown 用例：
+  - `headings.md`
+  - `code-diff.md`
+  - `table.md`
+  - `admonition.md`
+  - `math.md`
+  - `footnotes.md`
+  - `image-link.md`
+  - `checkbox.md`
+  - `mermaid.md`
+
+- `test/e2e.markdown.test.ts` —— Vitest 测试文件，主要职责：
+  - 读取每个 fixture
+  - 使用 `parseMarkdownToStructure`（基于 `getMarkdown`）进行解析
+  - 序列化为最小稳定结构并针对每个 fixture 生成快照
+  - 含有一个针对行内数学/代码块渲染的断言
+
+- 快照 —— 由 Vitest 生成，存放在默认快照目录。
+
+- `.github/workflows/ci.yml` —— GitHub Actions 工作流，在 `push` 与 `pull_request` 时执行：
+  - 安装依赖
+  - 运行 `pnpm test`
+  - 运行 `pnpm typecheck`
+  - 运行 `pnpm lint`
+
+## 本地运行方式
+
+如需在本地运行测试（并在输出预期发生变化时更新快照）：
+
+```bash
+pnpm test -- -u
+```
+
+仅运行测试（不更新快照）：
+
+```bash
+pnpm test
+```
+
+类型检查与 ESLint：
+
+```bash
+pnpm typecheck
+pnpm lint
+```
+
+## 建议 / 下一步
+
+1. 扩展快照内容（例如加入 `children` 文本片段与节点 `meta`），提升对节点 payload 回归的捕捉能力。
+2. 增加以下边界场景的 fixture 与断言：
+   - 未闭合的代码围栏
+   - 深度嵌套列表中混合标记
+   - 转义括号等特殊场景
+   - 流式代码围栏的异常输入
+3. 为需要 DOM 或 Worker 的插件（Mermaid、KaTeX、Monaco）补充集成测试，并考虑在 CI 中加入基于 Playwright 的浏览器流程。
+
+如果需要，我可以：
+1. 立即扩充快照的元信息。
+2. 补充上述边界场景的 fixture 与测试。
+3. 起草一个面向 DOM 插件的 Playwright CI 任务。
+
+欢迎告知下一步的优先项。