---
name: visual-artifact-qa
description: 对课件、PPT、HTML 演示、PDF、网页文章、公众号长文和报告中的图形与版式做逐页/逐屏视觉质检并在授权时修正。凡用户说“检查课件图形”“逐页检查”“全屏检查”“投屏字太小”“图太小”“大框小图”“文字溢出”“图片不居中”“检查文章配图”“打印版检查”“配图和内容逻辑不一致”或要求交付前视觉复检时，都应使用此 Skill；不能只读代码，必须实际渲染、生成联系表、放大复核重点页并留下证据。
metadata:
  version: 1.0.0
  updated: 2026-07-12
---

# 视觉逐页质检

把“看起来应该没问题”变成可证明的逐页/逐屏验收。核心原则是从学员或读者的真实观看距离出发：先完整渲染，再看全局，再放大重点页，最后用自动检查兜底。

## 使用边界

适用于：

- 课件、HTML 幻灯片、PPT/PPTX、PDF 演示和打印手册。
- 网页文章、公众号长文、报告、长图和内嵌信息图。
- 对现有视觉成品做审查；用户要求“修正”时继续实施并回归验证。

不要用于：

- 只审文字事实、语法或论证而不涉及视觉呈现的任务。
- 从零创作单张艺术插画；那是图像生成或视觉设计任务。
- 仅要求提取文件内容、转换格式或压缩图片的任务。

## 必读标准

开始前读取 [references/audit-standard.md](references/audit-standard.md)。需要确认真实问法和交付样式时读取 [examples/examples.md](examples/examples.md)。

## 工作流

### 1. 确认交付场景

从文件和上下文推断主要受众、观看设备、投屏/手机/打印用途和成品格式。能从现有文件确认的信息不要重复询问。默认至少检查主阅读场景；同时用于投屏和打印时，两种模式都要验收。

先盘点总页数、图形数量、特殊页型和交互状态。特殊页至少包括封面、目录、讲师介绍、章节页、测验页、复杂流程图、表格、结尾页和长内容页。

### 2. 建立渲染矩阵

按成品类型选择真实视口：

- 演示课件：桌面常规视图、2000×1200 左右的全屏投屏、打印模式；有响应式界面时增加 390×844 左右的移动端。
- 网页文章：桌面、移动端、打印/PDF；按逻辑章节截取整页或分段长截图。
- PDF/PPTX：先逐页渲染为图片，再检查原格式的页面边界和导出结果。

实际进入全屏或产品的演示模式，不把浏览器普通窗口截图冒充全屏检查。对交互课件覆盖导航、浮层、弹窗、答题和关闭/恢复状态。

### 3. 先全量截图，再做联系表

渲染全部页面或全部逻辑段落，文件名带连续页码。每 18–24 页生成一张联系表，缩略图上标注页码。

先扫描 100% 联系表，寻找：

- 大框小图、下方/侧边空白失衡、图形偏心。
- 页面节奏突变、某页密度或字号明显异常。
- 图片裁切偏离主体、人物不居中、重复模板失衡。
- 图形与标题论点没有可解释的关系。

联系表只负责发现全局异常，不能替代单页高清复核。

### 4. 逐页检查六个维度

逐页检查并记录页码、问题、证据和严重度：

1. **图框比例**：主体是否充分占用分配给它的框体；避免为了“留白”把信息图缩成邮票。
2. **位置与裁切**：水平是否居中，垂直留白是否失衡，照片焦点是否落在视觉中心。
3. **文字可读性**：按标题、导语、卡片标题、正文、图内标签、脚注分别判断；投屏距离下能否读清。
4. **边界与溢出**：HTML、SVG、Canvas、表格、图片和打印页是否出现裁切、贴边、遮挡或滚动溢出。
5. **语义关系**：图是否解释、比较、排序或推进当前论点；装饰图不能伪装成逻辑图。
6. **跨模式一致性**：桌面正常不代表全屏、移动端和打印正常，每种交付模式分别验收。

### 5. 放大复核重点页

对自动检查报警页、联系表异常页、用户点名页和所有特殊页型查看原始分辨率。必要时测量元素边界、有效字号、视觉主体占框比例、水平偏移和上下留白。

不要用统一缩小字号解决溢出。优先顺序是：精简表达、调整布局、扩大容器、拆页，最后才是小幅调整字号。字号按信息角色分级，不做全局等比例放大。

### 6. 修正与红绿回归

用户要求修正时，先让现有检查暴露问题，再修改布局或素材，再运行同一套检查。修正后必须重新截图受影响页面；全局样式改动则重新跑全量回归。

语义问题不能仅靠放大解决：图形结构应与内容中的因果、流程、层级、对比或选择关系一致。

### 7. 交付证据

完成声明至少包含：

- 检查范围：实际页数/总页数、模式和视口。
- 问题与修正：按页码列出，不用“已优化若干页”。
- 验收结果：溢出、过小、偏心、低字号、资源失败等剩余数量。
- 证据路径：逐页截图、联系表、重点页高清图、QA 报告；需要打印时附导出 PDF。
- 未验证项：缺少源文件、浏览器或字体时如实说明。

不得只凭代码审查、DOM 数量或自动脚本就声称视觉验收完成。最终判断必须同时包含真实渲染和人工看图。

## 报告格式

```markdown
# 视觉逐页质检报告

- 范围：<已检查>/<总页数或总段落>
- 场景：<桌面/全屏/移动端/打印>
- 结论：<通过/修正后通过/仍有阻断问题>

## 逐页问题与处理
| 页码/段落 | 严重度 | 问题 | 处理 | 证据 |
|---|---|---|---|---|

## 自动与人工验收
- 文字溢出：<数量>
- 图形过小或框图失衡：<数量>
- 偏心/裁切问题：<数量>
- 投屏字号问题：<数量>
- 图文语义不一致：<数量>
- 资源/控制台错误：<数量>

## 证据与未验证项
- 联系表：<路径>
- 单页截图：<路径>
- 打印/PDF：<路径或不适用>
- 未验证项：<无或具体说明>
```

## 失败与降级

- 无法打开源文件：先确认实际格式和可用转换工具，不以文件列表代替检查。
- 无法运行浏览器：渲染 PDF/PPTX 图片并明确未验证交互和真实全屏。
- 页面过多：仍须覆盖 100%；可分批生成联系表，但不能抽样冒充逐页检查。
- 字体或外部资源缺失：记录失败资源，使用与交付环境一致的字体后重测。
- 文章没有固定分页：按视觉模块和关键断点编号，保证每张配图及其上下文都被覆盖。

## 最小完成门槛

只有同时满足以下条件才可说“检查完成”：

- 100% 页面/视觉段落已渲染。
- 所有联系表已人工扫描。
- 用户点名页和异常页已原图复核。
- 主交付模式无文字溢出或主体裁切。
- 图形大小、居中、字号与语义关系均有逐项结论。
- 证据文件真实存在且能定位到页码。
