用途:在缺少设计师评审时,对应用的界面视觉质量和可用性进行标准化审查,覆盖响应式、无障碍、视觉一致性、排版和国际化准备度,适用于发布或演示前、大幅 UI 改动后、无障碍合规检查以及跨设备响应式验证。
主要能力:通过 //shiplight:design-review 使用,分五个阶段——教育、范围界定、分析、报告、修复。分析阶段在浏览器中打开带录证的会话,按类别检查:RES(视口 meta、横向溢出、48x48px 触控目标、375px 可读性、导航适配、图片缩放、内容截断、移动表单)、A11Y(对比度 4.5:1/3:1、alt 文本、表单标签、标题层级、焦点可见、键盘导航、跳转链接、ARIA、lang 属性、模态焦点陷阱、错误关联、减弱动效、闪烁)、VIS(间距刻度、字体刻度、配色数量、组件样式、对齐、加载态、空态、错误态、深色模式)、TYP(正文 16-20px、行高 1.4-1.6、每行 45-75 字符、字体加载、层级数量、左对齐)、I18N(无硬编码字符串、文本扩展 +30%、RTL、日期数字本地化、CJK 字体回退、图标不含文字)。报告保存到 shiplight/reports/design-review-{date}.md,含评分、置信度和分发现;修复阶段提供修改建议和 YAML 回归测试,保存到 shiplight/tests/design-review.test.yaml。
使用方式:先用 inspect_page 读取 DOM,用 act 调整视口、执行键盘操作和 JavaScript 计算对比度;测试断点包括 375px、390px、768px、1280px、1920px;最后用 close_session 关闭会话并可用 generate_html_report 生成可分享报告。
限制:审查依赖浏览器会话和实际运行的应用 URL;置信度低于 50% 的发现不报告;部分检查如闪烁、图标文字内容为人工目视判断;资料未提供定价、平台支持范围、具体安装命令以及除上述标准外的其他能力说明。