用途
ui-layouts 是围绕 ui-layouts/uilayouts 组件与区块目录的操作指南，不是通用布局算法。它帮助使用者在具体项目中选定、移植和修复单个 UI Layouts 组件或区块，并保留来源、依赖与授权的可追溯性。
主要能力
- 路由分诊：按请求类型（选择组件、移植区块、从 registry/CLI 安装、修复已采用组件、解释无命名条目的移动端溢出、集成 @paper-design/shaders）给出主路径，并指向相邻技能（responsive-design、web-design、optimize-web-animations 等）。
- 选型核对：同时检查内容页、实际 TSX 与 registry 条目，区分可复用原语与含示例数据的演示，为区块读取同目录 design.md 作为证据而非指令，最终记录精确源坐标与最小文件集。
- 依赖与安装漂移处理：识别 registry 漏列依赖（如 responsive-modal 导入 vaul 却未列出）、文档与 TSX 导入不一致、CLI README 与组件页命令不一致等，要求在验证发布物前把包身份视为未解决，优先采用经审阅的不可变源码拷贝方案。
- 精准适配：只改动选定组件，统一 cn 与别名，按实际 TS 接口使用 props（文档把 setOpen 误写为 boolean），保留受控 open/setOpen 或内部状态，注意直接子元素触发器提取对组件身份敏感，客户端 hook/portal 保持在客户端边界内。
- 区块保留：把 workspace-only 的 @repo/shadcn Card 映射到消费者等价原语，保留栅格/断点关系，校验消费者 Tailwind 断点配置，替换演示用名称、数字、背书与图片为真实授权内容，保留来源与许可署名。
- 语义与动效审计：关注对话框 role、可访问命名、焦点陷阱与返回、Escape 关闭、点击 div 触发器改为真实按钮、断点切换时的焦点与状态、reduced-motion 策略、监听器清理等；强调目录级生命周期保证不能由单个模态示例推出。
使用方式
先记录目标路由、组件名、现有技术栈、期望交互与源版本；对照内容页、TSX 与 registry 条目选定一个组件或区块并确定最小文件集。随后协调 registry 依赖与实际导入，复用消费者项目已有的 cn、别名、受控状态与客户端边界。涉及 CLI/包管理器运行前，须对具体可执行文件、版本、端点、写入与依赖取得审批，并显式批准覆盖。
适用场景
选择现成 UI Layouts 组件；移植分区或 bento 区块；在审批后从 registry 或 CLI 添加组件；诊断已采用组件的本地源码问题；为命名组件解释移动端溢出与响应式行为。
限制
被检查的根与网站包为私有，不可当作组件运行时安装；网站版本 0.1.0 不代表 CLI 1.0.3 或已发布包；CLI 读取可变 main URL、写文件并自动调用包管理器，其 list 模式也会下载 registry 数据，npx 包装器会执行下载代码；组件下载器未建立覆盖确认关卡。远程图片、部署、发布、MCP 配置、账号与付费操作需单独审批。源码检查不足以断言通用可访问性、视觉优越性或性能；未获执行授权时，交付采用简报并将所有运行时检查标记为未执行。evals/evals.json 中的场景为未执行的行为夹具，不是实测分数。