endorphin-tabularium-docs/design/verification/README.md

浏览器验收 · 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：正文检索和无结果状态。

验收过程中发现并修正：辅助文字过淡、代码字号偏小、手机搜索图标缺少无障碍名称、手机目录位于正文标题之前，以及表格标题行未铺满阅读栏。截图来自同一轮渐进验收；最终重拍了受修正影响的关键视图。