视觉预设验收,2026-10-05
本记录针对同级主题 checkout 的真实输出,没有注入原型样式;不代表发布版本、 升级消费站点或验收线上站点。
输入
2026-10-05 的主题与文档站工作树;macOS ARM64,Hugo Extended 0.166.0、
Go 1.27.1、Node 26.9.0、Playwright 1.62.1。常规浏览器套件使用 Chromium;
另有 Chromium、Firefox 与 WebKit 专项检查。站点仍固定 v1.1.0,
make check、make browser 与 make dev 使用同级本地主题,公开 pin 未修改。
本轮不是 Hugo 0.160.1 下限或 CI 固定工具链验收。
已执行检查
| 证据 | 结果与范围 |
|---|---|
check-presets.py |
Paper 明暗 token 对称与正文、链接、代码、铜色 AA 对比度;冻结的 v1.1.0 Slate 基础色板;四种严格配置构建与 16 个 HTML 根元素,包括 404 和打印 |
| 现有主题检查器 | 参数、字体角色、vendor 清单、32 个语言目录、动作、外壳、输出、命名空间、Landing 和运行时隔离均通过;生成的 schema 与源码一致 |
check-goldens.py |
52 个表面通过;已审阅并更新根属性、首绘颜色、菜单及其动作与运行时影响的 34 份 HTML/打印期望,其他输出格式未变 |
| 严格站点构建 | 真实本地主题中英文站以 --panicOnWarning 构建成功;翻译、渲染 Markdown 和站内链接检查通过 |
node --test 'tests/js/**/*.test.js' |
49 个运行时测试通过 |
appearance.spec.mjs |
25 个测试通过:Paper/Slate × EN/ZH × 390/1440 px × 浅深色,覆盖首页、配置长文、提示块和标签页;菜单 axe、键盘、持久化、恢复默认、跨语言导航、跨标签同步、禁用存储、非法值、无 JS、打印、命令面板、阅读锚点与断点处理、生成的评论样式表 |
appearance-engines.spec.mjs |
6 项通过:Chromium、Firefox、WebKit × 390/1440 px;CSS 前恢复状态和浏览器栏颜色、原生键盘选择、焦点返回及跨语言导航。Chromium 桌面另加 4 倍 CPU 限速 |
| 字体请求 | 观测到的字体均来自本地;Paper 不请求 Inter,Slate 不请求 Plex Sans。两次真实文档站配置覆盖构建证明系统排版不请求内置文字字体,显式字体角色可覆盖两套预设 |
make check |
完整非浏览器套件通过:57 个测试、141/141 篇翻译页面,以及既有 Markdown、渲染内容与站内链接检查 |
make browser |
九个常规套件共 197 个测试通过;sitemap axe 扫描限定为下述 15 条路由 |
| 视觉抽查 | 已检查真实 Paper 桌面首页、手机 Docs 长文、中英文浅深色外观面板,以及 Slate 深色首页;截图来自浏览器测试,不是样式注入原型 |
浏览器套件的 sitemap axe 扫描通过 A11Y_PATHS 限定为 15 条代表性路由:中英文
首页、配置、提示块、标签页与 OpenAPI,以及英文搜索、Mermaid、ECharts、Blog
和一个 Book 章节。另运行现有响应式 axe 矩阵。跨域 Giscus 与 API 供应商组件 DOM
沿用既有排除规则,本轮不是全量 sitemap 扫描。
整合检查发现并修复了 Paper 深色高亮代码行的行号对比度,以及平滑滚动干扰阅读 锚点恢复的问题。章节强调色测试现在分别断言 Paper 的暖色不透明选中底和 Slate 原有的半透明选中底。
限制与后续检查
手工读屏播报和逐帧绘制追踪尚未验证。阻塞样式表及 CPU 限速断言验证初始化顺序, 不等同于证明所有浏览器的首个绘制帧。Slate 比较冻结基础色板并检查渲染字体行为, 不宣称包含其他 1.2 改动后的所有组件与 1.1.0 像素等价。
Mermaid/ECharts 继续仅随明暗。Ink 与 Terminal 仍为研究;衬线展示标题、完整 几何与密度 token、图表随预设配色留待后续。本轮没有创建发布标签、推送、跨站 升级或部署。