Vetta
主题开发

06 / 主题开发

主题系统概览

使用主题模块定制 Vetta 外观、组件、页面、区域与运行时效果。

主题模块不仅能覆盖颜色,也能替换宿主公开的组件、注册页面和提供主题运行时。它适合形成一致的完整体验;只修改明暗模式、配色或侧栏样式时,直接使用“设置 → 外观”即可。

Vetta 内置仙侠主题,完整改变背景、侧栏、输入区和表面装饰
主题可以改变整个工作区的视觉表达,但项目、会话和 Agent 业务状态仍由宿主拥有。

主题可以提供什么

appearance颜色令牌和表面外观。
components替换宿主公开的组件槽位。
pages增加带导航入口的主题页面。
regions填充宿主公开区域。
runtime主题激活期间持续挂载的无头逻辑。

主题通过 Module Federation 加载,React、主题 SDK 和宿主 UI 包作为共享单例。主题代码运行在桌面渲染进程内,应按可信代码对待。

当前发布边界

外观页的 UI 主题选择可能由功能开关控制,且只有已经随应用打包的主题才可选择。

下一步

本页内容