LanMountainDesktop/docs/VISUAL_SPEC.md

# 视觉规范

## 中文

本规范用于统一阑山桌面的主题色、玻璃效果和基础视觉语义。

### 颜色角色

- `Primary`：品牌主色
- `Secondary`：辅助色
- `Accent`：强调色与选中态主色
- `OnAccent`：强调色背景上的文字或图标
- `SurfaceBase` / `SurfaceRaised` / `SurfaceOverlay`：背景层级
- `TextPrimary` / `TextSecondary` / `TextMuted` / `TextAccent`：文本层级

### 使用规则

- 主按钮和主要导航选中态使用 `Accent + OnAccent`
- 次级操作和输入控件优先使用语义背景色，不直接写死颜色
- 页面层只使用资源键和语义类名，不写业务颜色常量

### 玻璃效果层级

- `glass-overlay`：最外层遮罩
- `glass-strong`：主要大容器
- `glass-panel`：子区域、小面板、卡片

### 形状与圆角 (Shape & Corner Radius)

- **全局统一**：所有 UI 元素的圆角必须遵循 [圆角设计规范](file:///c:/Users/USER154971/Documents/GitHub/LanMountainDesktop/docs/CORNER_RADIUS_SPEC.md)。
- **禁止硬编码**：严禁在资源库以外的地方硬编码 `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.