doncheli-visual-test

doncheli-visual-test 是一项专门为开发人员和 QA 工程师设计的视觉回归测试工具，旨在 Don Cheli SDD 框架内提供严格的 UI 验证。它作为前端界面的质量闸门，确保视觉元素在部署周期中保持一致。通过截取当前 UI 状态并与验证过的基准图像进行比较，该工具能自动检测手动测试常忽略的像素级偏差。此代理程序特别适用于识别布局位移、字体渲染异常、色彩主题不匹配以及组件定位失效等问题，这些在处理 React 或 Vue 等复杂的基于组件的架构时十分常见。

• 自动检测并配置测试工具，包括 Playwright、Cypress、Percy、Chromatic 和 Storybook。

• 生成详细的视觉差异报告，按百分比和严重程度（阻塞、警告、信息）量化变更。

• 提供安全的基准批准工作流程，在将新快照纳入存储库之前需明确的人工确认。

• 执行局部像素级分析，区分显著的回归问题与轻微的抗锯齿瑕疵。

• 直接与 Don Cheli 运行时集成，将状态报告保存至 .dc/visual-test-report 目录，以利于 CI/CD 审计追踪。

• 使用提到 'visual test'（视觉测试）、'screenshot'（截图）、'UI regression'（UI 回归）、'pixel diff'（像素差异）或 'visual snapshot'（视觉快照）的自然语言指令来触发此技能。

• 系统要求存储目录中必须存在基准图像；若缺失，首次成功执行时会自动生成。

• 请务必检阅 .dc/ 目录下生成的 Markdown 报告，在人工批准前确认报告的布局位移或色彩变更是预期的更新。

• 代理程序根据预定义的阈值系统分类错误：大于 5% 的差异被视为阻塞，而微小差异则记录为信息，让团队能优先处理实际的回归问题而非噪声。

• 此工具旨在防止自动批准新设计，确保您的团队将这些变更视为 SDD 审查阶段的一部分，以维持一致性。