leeway-ui-check

Leeway UI Check 是一个用于验证 AI 编码代理 UI 修改结果的工具，支持 Web 与 Flutter 场景。基本流程是：用户提供参考截图和页面要求，编码代理修改页面，Leeway 用 Playwright 采集实现结果，返回像素、SSIM、布局和文字报告，供下一轮修复使用。 主要能力 - 对照参考图与页面截图，输出普通差异图、严格差异图和区域问题定位。 - 将文字、几何、交互及资源错误作为独立阻断条件，而不是混入单一分数。 - 通过五个 MCP 工具与编码代理交互：提交代码版本、查询反馈、取消和交付。 - 保存每轮源码快照、报告和证据，交付前可复核对应版本。 使用方式 已验证的开发环境为 Windows / PowerShell、Node 22.16.0、Python 3.13。首次安装需克隆仓库、执行 npm ci、创建 Python 虚拟环境并安装 workers/requirements.txt，再运行 npm run setup:browser。随后可通过 npm run build、npm run demo、npm run cli -- report 运行三个预设页面变体并打开本地报告页（127.0.0.1:4318）。 接入自有项目时，需从任务模板配置参考图、视口、源码目录和启动命令，创建任务并启动 worker，再按 MCP 指南连接编码代理。整体循环为：代理修改源码 → submit → worker 截图与比较 → 报告 → 代理再次修改。 边界与限制 项目自述为本地单用户早期版本。默认分数用于诊断，正式验收需要已验证的 profile；OCR、视觉模型、安全隔离和真实模型自动收敛尚未实现或验收。Harness 不会自动猜测按钮的业务行为，需要检查的交互必须写入任务配置，报告中的修改建议属于待验证假设。文档包含使用指南、MCP 接入、常见问题、架构说明、评分校准、更新记录、贡献指南和安全边界。项目采用 MIT 许可。