用途：在 XR Blocks 中构建可用的空间界面，让信息与控件在预期姿态下保持可读、可点击、可观察。
主要能力：提供 UICard（世界空间表面，以米计量和定位）、UIOverlay（有边界的视图空间表面）、UIPanel（仅在卡片或覆盖层内用于布局或视觉分组），以及 UIText、UIImage、UIIcon、UIButton、UISlider、ModelViewer 等语义化组件。内置 UI 自动启动并接入 XR Blocks 交互管线，应用代码无需启用 UI 子系统、注册 UIKit 或安装第二个射线投射器。
使用方式：先写表面契约，记录每个显示值与动作、状态归属、空间锚点、外观状态、更新频率、桌面输入、XR 输入和可观察结果；再选择正确的 UI 根；然后用语义 UI 组合阅读顺序，用 UIButton 和 UISlider 处理动作而非原始指针处理器；直接更新组件属性，用主题预设或主题更新共享调色板与结构角色，局部样式处理例外；最后构建或类型检查，在完成 UI 帧后运行 xb.ui.validate() 检查溢出、裁剪、禁用行为、输入、清理和控制台输出。可从 ../../templates/01_spatial_ui/ 或最接近的示例开始。
限制与注意：UICard.size 和世界变换以米为单位，后代数值布局值以 UIKit 布局单位计，数值 lineHeight 是字号倍数，显式单位用 px 或 % 字符串。内容驱动卡片用 size: {width, height: 'auto'} 并保持宽度固定。透明度本身不会禁用深度写入或输入，需分别使用 pointerEvents、interactionEnabled、visibility、材质深度行为和 opacity。根跟随、朝向或环绕其他对象时需阅读 Placement.md，操作与目标语义需阅读 Interaction.md。实现前需阅读 UI.mdx。具体平台、收费与价格信息暂未提供。