用途：为 Meta Ray-Ban Display 的 UI Toolkit 界面应用或审查主题与颜色方案，涉及语义颜色、排版、间距、圆角、透明度、组件颜色变体和自定义颜色。
主要能力：工具包以 --uit-* CSS 自定义属性和受限的组件枚举暴露语义主题角色，要求按含义选择角色，而不是照搬截图的 RGB 值。文档按定制面分类说明：应用/子树级语义角色变更可覆盖 [data-app-root] 或作用域祖先上的 --uit-color-* 或 --uit-spacing-* 角色；文本角色使用 TextColor 和 TextStyle/TextAppearance；组件内容角色使用 SubtitleTextColor、TimestampTextColor、IconTintColor 或组件变体枚举；StaticContainer、Container 或 Surface 的材质绘制传入兼容的 ContainerMaterial；一次性布局使用带间距令牌的 CSS。
使用方式：应用需渲染在 App 内以加载工具包样式表；文档窗口和挂载根设为 var(--uit-color-background-window)，不要覆盖 [data-app-root] 为透明。仅使用当前 --uit- 令牌名，覆盖语义角色而非内部 CSS 模块选择器，不创建任意明暗模式，不硬编码字体、尺寸、字重、行高或字距，使用完整间距刻度、语义圆角/形状 API、启用/禁用和高度角色而非字面透明度/模糊值。颜色方面保持整页在工具包窗口背景上，语义正/警告/负/信息角色仅用于匹配含义，不单靠颜色传达状态，优先使用实心工具包图标和语义着色枚举；次要文本和图标需同时使用语义次要颜色及其合成行为，自定义 HTML 或 currentColor SVG 使用 uit-color-text-secondary 或 uit-color-icon-secondary 公共类，不能单独应用令牌。排版使用 TextView 配合适当语义元素，或为自定义标记应用 uit-text-*/TextAppearance 类，排版外观与语义颜色是分开的选择。材质颜色定制使用 MaterialLibrary.themedPrimary(theme) 重着色标准材质，提供含空闲填充、四个聚焦渐变步骤和辉光色调的六角色色阶，不通过字面颜色或单色加透明度近似。
适用场景：需要统一应用主题、审查颜色与排版合规性、定制组件语义颜色或材质色阶的 UI Toolkit for Meta Ray-Ban Display 开发工作。
限制：不得覆盖内部 CSS 模块选择器、不得创建任意明暗模式、不得硬编码任意像素值或令牌解析值；mix-blend-mode 不继承，次要工具类需放在实际绘制前景的元素或有意包装器上，不得用于未着色的全彩插图；自定义颜色需在空闲、聚焦、按下、禁用和部分聚焦极端状态下测试；CSS 令牌覆盖改变语义应用样式，材质改变交互表面的有状态绘制，二者不可互相替代；具体支持的令牌完整清单和版本信息暂未提供。