UXLoom 是面向 AI 生成界面的 UI/UX 设计验证工具，核心理念是充当“评审层”：AI 生成器（如 v0、Lovable、Figma Make、Claude）通常只产出快乐路径的界面，而 UXLoom 在产品代码编写之前，就把用户旅程建模为状态机，将界面视为带状态契约的节点，并机械地证明设计中的缺失与缺陷。
主要能力
- 旅程完整性验证：检测不可达界面、死胡同状态。
- 状态覆盖检查：发现缺少的错误、空、加载等基线状态。
- 可访问性与适配性检查：WCAG 对比度失败、触控目标尺寸过小、本地化后标签溢出。
- 基于证据的设计：契约中的每个决策可携带理由、被拒绝的替代方案及其优缺点、来源和置信度，并由评审器执行；通过有界的 design_review 循环（最多 3 轮）迭代，预览的证据面板（ⓘ）和导出中可向利益相关者展示。
- 智能体可寻址评论：评审者在预览中放置固定评论并点击“→ agent”，评论即成为任何 Gen-AI 模型可读的工作项，comment_context 返回固定布局块、界面契约、旅程引用及该界面的当前发现，智能体可处理并带着注释解决回预览。
- 确定性：相同输入生成逐字节相同的报告；在种子缺陷目录上基准测试精确率/召回率均为 1.000，跨进程 SHA-256 稳定，1000 个界面处理时间低于 5ms。这使得设计完整性可以像 LLM 意见无法做到的那样，用于 CI 门禁。
使用方式
- 项目文件 uxloom.project.json 位于工作区并纳入 git，设计即数据，与代码一同版本化。
- 工作流（也作为 skill 提供在 packages/mcp-server/skills/）：project_init → brief_start / brief_answer → journey_define → screen_register → project_validate → 修复 → 重复直到零错误 → coverage_report。
- 面向智能体：接口为 MCP 服务器，可与 Claude Code、Codex 及任何 MCP 客户端配合。
- 面向人类与 CI：check 和 audit 支持 --json、--sarif（GitHub 代码扫描）和 --github（内联 PR 注释）。支持棕地：--update-baseline 冻结现有发现，只阻止新的漂移；uxloom.config.json 可调阈值以匹配可访问性标准。
适用场景
- 在 CI 中增加门禁，使仅含快乐路径的设计无法合并。
- 设计评审阶段发现状态缺失、可访问性问题和本地化风险。
- 智能体辅助设计工作流中，从反馈到处理的一键闭环。
限制与维护
- JourneyGraph 格式（formatVersion: "0.1"）可能在 1.0 之前演进。
- 已发布并维护在 npm 和官方 MCP 注册表；基准评分卡随每个 GitHub 发布公布。
- 详细的安装命令、快速入门步骤和故障排除文档在官网 uxloom.dev 及其文档页 uxloom.dev/docs.html。
