boos
e0a5f57793
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.
92 lines
2.6 KiB
Markdown
92 lines
2.6 KiB
Markdown
# E2E 测试报告（重定向）
|
||
|
||
该页面已迁移到中文指南目录：
|
||
|
||
- 新页面：`/zh/guide/e2e-testing-report`
|
||
|
||
如果你的链接仍指向 `/zh/e2e-testing-report`，页面将自动跳转。
|
||
|
||
<script>
|
||
if (typeof window !== 'undefined') {
|
||
window.location.replace('/zh/guide/e2e-testing-report')
|
||
}
|
||
</script>
|
||
|
||
<noscript>
|
||
页面已迁移：请访问 <a href="/zh/guide/e2e-testing-report">中文指南 – E2E 测试报告</a>
|
||
</noscript>
|
||
# 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 任务。
|
||
|
||
欢迎告知下一步的优先项。
|