用途：为 ryOS 设计并实现 UI 样式，统一使用当前操作系统主题令牌系统、Tailwind 变体、共享原语、Aqua Glass、深色模式与强调色约定。
主要能力：文档给出主题架构、令牌来源与加载顺序等权威参考，包括实现规范 docs/3.3.1-theme-architecture.md、用户概览 docs/3.3-theme-system.md、令牌真源 src/styles/themes/tokens.css、主题 CSS 引入顺序 src/styles/themes.css，以及 Tailwind 映射与变体 tailwind.config.js。视觉值应放在 CSS 的 --os-* 令牌中，TypeScript 主题文件只保留元数据、平台行为、深色模式支持标记与壁纸默认值，禁止在 TS 或组件代码中重复调色板。
支持主题：macOS Aqua（ID macosx，mac/aqua 平台，光泽控件、红绿灯、Dock、细条纹或 Aqua Glass，明暗、强调色）、System 7（system7，黑白、方角、Chicago 风格字体、点状标题栏）、Windows XP（xp，Luna 蓝色铬、圆角窗口边框、任务栏）、Windows 98（win98，灰色凹凸、方角、经典任务栏）。默认主题 macosx，默认 Aqua 材质 glass。
使用方式：优先使用令牌驱动的 Tailwind 工具类与根属性变体（如 os-mac:、os-windows:、os-theme-<id>:、os-dark:），通过 useThemeFlags() 或 @/themes 助手在结构与行为变化时才做 React 分支；复用共享原语 osThemePrimitives 中的类名；图标优先查找现有图标库并运行 bun run generate:icons。分号行为、深色、强调色遵循令牌与变体，避免手写十六进制值或临时玻璃效果。
适用场景：需要跨全部四种主题保持视觉一致的组件、窗口、面板与控件样式开发。
限制：仅 macosx 目前支持深色模式；mac 铬主题支持强调色，默认强调色为壁纸（即 System）。具体实现步骤、组件库细节与更完整的代码示例暂未提供。