mirror of
https://github.com/larksuite/cli.git
synced 2026-07-08 02:00:19 +08:00
docs: add slides screenshot QA checklist
This commit is contained in:
@@ -45,6 +45,37 @@ python3 skills/lark-slides/scripts/xml_text_overlap_lint.py --input <presentatio
|
||||
| `xml_not_well_formed` | XML 语法错误或文本未转义 | 修复标签闭合、属性引号、`&` / `<` / `>` 转义 |
|
||||
| `bbox_overlap` | 文本元素的估算绘制区域明显重叠 | 拉开文本坐标、缩小文本框/字号,或改成明确的分栏/分组结构 |
|
||||
|
||||
## Screenshot QA
|
||||
|
||||
获取页面截图后,必须使用 subagent 做视觉验收;主 agent 不要只凭 XML 回读或静态 lint 结论声称截图验收通过。验收时假设页面存在问题,主动寻找并报告所有风险,包括轻微问题。
|
||||
|
||||
把截图路径、每页预期内容和以下中文提示交给 subagent:
|
||||
|
||||
```text
|
||||
请逐页目视检查这些幻灯片截图。先假设存在问题,并尽量找出它们。
|
||||
|
||||
重点检查:
|
||||
- 元素重叠:文字与形状、图片或图表互相遮挡,线条穿过文字,卡片或标签堆叠。
|
||||
- 文本溢出或被裁切:靠近页面边缘、文本框边界或卡片边界处被截断。
|
||||
- 装饰元素位置错误:分割线、强调线或标签底板按单行文字布置,但标题或正文换行后压住文字或距离异常。
|
||||
- 来源标注、页脚或页码与上方内容碰撞。
|
||||
- 元素距离过近:相邻元素间距明显不足,卡片或分区几乎贴在一起;按 960x540 画布估算,小于约 25-30 px 的间隔通常要标记。
|
||||
- 间距不均:局部留白过大,另一处过于拥挤。
|
||||
- 页面边距不足:主体内容贴近幻灯片边缘;按 960x540 画布估算,小于约 45-50 px 的外边距通常要标记。
|
||||
- 列、卡片、图标或同类元素没有稳定对齐。
|
||||
- 图片、图表或 whiteboard 渲染异常:空白、变形、低清、关键内容不可读或预期图形缺失。
|
||||
- 文本对比度不足,例如浅灰文字放在米色或浅色背景上。
|
||||
- 图标对比度不足,例如深色图标放在深色背景上,且没有浅色圆形或底板承托。
|
||||
- 文本框过窄,导致不必要的频繁换行。
|
||||
- 残留占位符、模板默认文字或未替换内容。
|
||||
|
||||
对每一页分别列出发现的问题或可疑区域,即使只是轻微问题也要记录。
|
||||
|
||||
报告所有发现的问题,包括轻微问题。
|
||||
```
|
||||
|
||||
subagent 返回后,主 agent 必须根据问题严重度决定是否修复:空白页、破图、文字遮挡、明显裁切、低对比不可读、占位符残留等必须先修复再交付;轻微间距或对齐问题如果不修复,最终验证记录要说明已知风险。
|
||||
|
||||
## Page Count And Structure
|
||||
|
||||
- 实际页数必须等于用户要求或已确认大纲的页数。
|
||||
|
||||
Reference in New Issue
Block a user