用途：visual-pixel-perfect 用于自动化视觉回归测试，确保实现与设计参考像素级一致。适用于按 Figma/设计规范实现 UI、检查改动是否破坏现有界面、客户要求精确还原、视觉 QA、截图测试及 PDF 输出格式校验。不适用于单元测试、功能 E2E、组件行为测试或快速原型。
主要能力：核心循环为 IMPLEMENT → RENDER → SNAPSHOT → COMPARE → FIX，直到通过或达到最大尝试次数。Web 使用 Playwright MCP 渲染，PDF 使用 Puppeteer 脚本。截图格式 PNG、1x 缩放、无压缩，存放于 .claude/visual/snapshots/current/。使用 Pixelmatch 与基线对比，Web 阈值 0.5%，PDF 阈值 1.0%。失败时仅修复 CSS/布局，不改功能、不重构，最多 5 次，否则硬失败并输出报告。
使用方式：先初始化结构：./scripts/visual/init-claude-visual.sh；安装依赖：npm install --save-dev puppeteer pngjs pixelmatch。在 .claude/visual/spec/ 创建 DesignSpec JSON，定义 viewport、frozen、flexible、tokens、referenceImage、url、renderType。运行测试：./scripts/visual/visual-test.sh，可用 --spec=header、--update-baseline、--ci、--web-only、--pdf-only。CI 中可运行 ./scripts/visual/visual-test.sh --ci 并上传 diff 产物。
限制：需先有基线，否则用 --update-baseline；需安装 puppeteer、pngjs、pixelmatch；PDF 渲染需 pdftoppm 或 ImageMagick；视口须与 spec 匹配。资料未提供收费、价格、平台支持范围及具体效果数据。