这个项目能做什么

Web UI Quality (WUQ) 是一个用于 AI 辅助 Web 变更验证层的开源预览版。其既定目的是帮助人员在将 AI 生成的 Web 变更标记为完成之前进行检查:包括 AI 被允许修改的内容、实际修改的内容、已验证的内容以及仍然未知的内容。 工作原理 该工具将四个问题分开处理:范围 (Scope)、变更 (Change)、证据 (Evidence) 和验证 (Verify)。范围涵盖可考虑的项目和文件;变更涵盖 Host 实际应用的内容;证据涵盖实际运行的测试、工具、浏览器以及前后记录;验证则涵盖这些证据是否足以支持所请求的声明。一项需要源代码变更的修复必须在获得适用的 Host 写入回执和当前的验证证据后,才能被报告为 VERIFIED(已验证)。该项目声明其不会静默安装依赖项、上传源代码、提交、推送、部署,也不会将模型建议转换为写入权限。 安装与命令 当前的预览版尚未发布到 PyPI 或 npm,因此需从源代码检出安装:克隆仓库,运行 pip install -e .,然后调用 web-ui-quality doctor。稳定的入口点包括带有 --help、run、doctor 和 auth 子命令的 web-ui-quality。run 命令需要一个本地 Web 项目路径以及用自然语言描述的任务;README 中的示例请求检查结账页面的移动端布局,同时禁止修改登录逻辑。对于在请求的修复声明未通过验证时应失败的集成,可以使用 --ci --require VERIFIED,且该选项不会绕过 Host 审批、范围检查、浏览器要求或项目工具证据。自包含的公开检查通过在检出版本中运行 python -B run_tests.py 来执行。 演示固定装置 仓库包含 examples/scope-drift-demo/,这是一个用于有界组件修复的小型公开固定装置。请求指定了一个组件文件,而一个配套文件则故意被置于该范围之外。在正常的仅源代码检出中,命令会记录真实的初始状态,并停止运行,直到受信任的 Host 应用变更并返回所需的证据;如果 Host 修改了批准范围之外的配套文件,则 project-drift 门禁将阻止结果变为 VERIFIED。README 将此描述为边界演示,而非关于模型准确性或生产行为的声明。 状态与既定限制 当前的公开版本标识为 Apache-2.0 协议下的 v4.3.0-oss-preview.1;历史版本 v4.3.0 被描述为一个单独的 MIT 许可源代码快照,仅作为历史保留。状态表将公开源代码和工程检查标记为 PASS,当前预览版的许可为 Apache-2.0,PyPI/npm 为未发布,真实 Host 资质为 NOT_MEASURED,外部盲测 holdout 为 NOT_MEASURED,商业 GA 资质为 NOT_ELIGIBLE。该预览版明确声明不对 Codex、Claude 或其他 Host 的真实准确性、真实用户收益、生产兼容性、通用可访问性、远程证明或 Token 节省做出承诺,且缺失浏览器或 Host 证据的部分将保持未验证状态。 仓库布局与许可边界 运行时和 CLI 位于 runtime/python/web_ui_quality/ 下,skills/ 包含 Codex 技能指令,schemas/ 包含公开 JSON 模式,examples/ 包含本地固定装置和资质输入,tests/public/ 包含旨在从干净检出运行的测试。发布边界文档包括 PUBLICATION.md、DEPENDENCY_LICENSE_REVIEW.md 和 FINAL_PUBLIC_SOURCE_MANIFEST.json。私有恢复记录、聊天历史、浏览器存储、evolution/、外部工作树、商业模板和商业演示材料均被排除在此公开核心之外。安全报告要求通过 GitHub 安全公告或项目联系地址提交,而非公开 Issue,许可边界在 LICENSE、NOTICE.md 和 THIRD_PARTY_NOTICES.md 中进行了描述。