f8a4bb888c
Introduce unified material/color spec and tests, and refactor appearance plumbing to use MaterialColorSnapshot as the single source of truth. Add .trae material-color-service spec/checklist/tasks and integration/unit tests for plugin mapping and appearance VM behavior. AppearanceChangedEvent extended with new appearance change flags and HasChanged logic. ComponentEditorMaterialThemeAdapter rewritten to accept MaterialColorSnapshot and derive palette from snapshot data. Simplify AppearanceSettingsPageViewModel and related view code: remove legacy preview/custom-seed UI logic, preserve material/color fields when updating theme or corner radius, and update save calls to use with-expressions. Update ComponentEditorWindow to use adapter-provided OnPrimary brush and minor docs updates.
2.4 KiB
视觉规范
中文
本规范用于统一阑山桌面的主题色、玻璃效果和基础视觉语义。
颜色角色
Primary：品牌主色Secondary：辅助色Accent：强调色与选中态主色OnAccent：强调色背景上的文字或图标SurfaceBase/SurfaceRaised/SurfaceOverlay：背景层级TextPrimary/TextSecondary/TextMuted/TextAccent：文本层级
使用规则
- 主按钮和主要导航选中态使用
Accent + OnAccent - 次级操作和输入控件优先使用语义背景色，不直接写死颜色
- 页面层只使用资源键和语义类名，不写业务颜色常量
玻璃效果层级
glass-overlay：最外层遮罩glass-strong：主要大容器glass-panel：子区域、小面板、卡片
形状与圆角 (Shape & Corner Radius)
- 全局统一：所有 UI 元素的圆角必须遵循 圆角设计规范。
- 禁止硬编码：严禁在资源库以外的地方硬编码
CornerRadius数值。 - 动态适配：桌面组件必须使用
DesignCornerRadiusComponent动态资源，以支持用户在设置中全局切换“锐利/平衡/圆润/开放”风格。
可访问性
- 正文对比度目标不低于
4.5:1 - 大号文字和重点文字不低于
3.0:1 - 主题服务负责对前景色做自动对比度修正
English
This specification defines the visual language of LanMountainDesktop, including theme roles, glass layers, and semantic color usage.
Key rules
- use semantic resource keys instead of hard-coded colors
- keep glass layers visually distinct
- maintain contrast targets for readability
Material And Color Source
IMaterialColorService is the host source of truth for Monet seeds, wallpaper-derived colors, semantic color roles, material surfaces, and plugin appearance snapshots.
New UI, component, window, and plugin appearance consumers should use MaterialColorSnapshot or resources produced from it. Do not recalculate application colors from raw wallpaper settings, theme settings, or MonetPalette in parallel.
The Wallpaper settings page owns wallpaper asset/source selection. The Material & Color settings page owns color-source selection, wallpaper color-source selection, system material mode, wallpaper color refresh behavior, and color/material previews.