29 lines
2.8 KiB
Markdown
29 lines
2.8 KiB
Markdown
# 浏览器验收 · 2026-10-27
|
|
|
|
在 `127.0.0.1:3015` 预览 Pages Router 的生产构建，使用实际浏览器操作与截图；未调用外部字体或 CDN，未修改部署架构。截图保留了改版后的首页、三篇文档、搜索及手机/平板布局。
|
|
|
|
## 检查结果
|
|
|
|
- `pnpm lint`、`pnpm typecheck`：通过。
|
|
- `UV_CACHE_DIR=/private/tmp/tabularium-uv-cache pnpm figures`：通过，SVG 与仓库一致。默认 uv 缓存路径受本机沙箱限制，使用临时缓存完成。
|
|
- `pnpm --filter @endor/docs run build --webpack`：通过，首页、三篇文档、404 与健康接口均成功生成。
|
|
- 默认 `pnpm build` 的 Turbopack 在这台机器因 PostCSS 编译子进程绑定本地端口遭 `EPERM` 中断；使用 Next.js 自带 webpack 参数完成本地构建。没有修改 package.json 或 CI 的构建命令，远程仍使用原有构建流程。
|
|
- `python3 scripts/smoke.py http://127.0.0.1:3015`：通过，覆盖健康、全部文档、生成 JS/CSS、SVG 和404。
|
|
- 中文章节锚点、重名标题后缀、代码围栏内的伪标题、行号映射和行内代码标题：使用 Node 断言通过。
|
|
- 实际输入「生命周期」只返回架构草案，Enter 打开对应文档；⌘K 打开搜索，Escape 关闭并将焦点恢复到搜索按钮；无结果时显示建议词。方向键保持选择索引边界。
|
|
- 代码复制按钮显示「已复制」状态；未将系统剪贴板内容作为验收依据。
|
|
- 手机菜单展开后可跳转并自动收起；页内目录展开后可跳转中文章节。草案标签、提示、表格和 SVG 正常呈现。
|
|
- 390px 首页和草案页、768px 入门页实测 `documentElement.scrollWidth === innerWidth`。320px 入门页页面宽320px，长命令的代码容器宽274px、内容宽320px，仅容器内部横向滚动。
|
|
- 检查浏览器捕获的 error/warn 日志为空。未进行跨浏览器测试；本次使用内置浏览器。
|
|
|
|
## 截图索引
|
|
|
|
- `home-desktop.png`、`home-desktop-full.png`：桌面首页和完整分区布局。
|
|
- `home-mobile.png`、`home-mobile-full.png`：390px 手机首页和完整纵向布局。
|
|
- `getting-started-desktop.png`、`getting-started-mobile.png`、`getting-started-tablet.png`：正文、代码块及不同尺寸的阅读布局。
|
|
- `draft-desktop.png`、`draft-mobile.png`、`draft-mobile-table.png`：草案状态、提示块、术语表与手机锚点定位。
|
|
- `figures-desktop.png`：本地 SVG 与文字的组合。
|
|
- `search-desktop.png`、`search-empty.png`：正文检索和无结果状态。
|
|
|
|
验收过程中发现并修正：辅助文字过淡、代码字号偏小、手机搜索图标缺少无障碍名称、手机目录位于正文标题之前，以及表格标题行未铺满阅读栏。截图来自同一轮渐进验收；最终重拍了受修正影响的关键视图。
|