LanMountainDesktop/docs/TYPOGRAPHY_SPEC.md

字体排版设计规范 (Typography Specification)

中文

本规范用于统一阑山桌面各组件（Widget）及页面的字体样式，解决目前组件间字体不协调、厚度不一的问题。通过引入标准化的设计 Token，确保在不同 DPI 和设备上呈现一致的高级感（Premium Look）。

1. 字体家族 (Font Family)

• 默认字体：优先使用内置的 MiSans VF (Variable Font)。
• 回退顺序：MiSans VF -> MiSans -> Microsoft YaHei -> Sans-serif。

2. 字重标准 (Font Weights)

为了达到“不粗不细”的协调感，我们采用 Medium (500) 作为默认正文字重，以应对复杂的背景环境。

角色	Token	MiSans 权重	说明
Caption/Secondary	DesignFontWeightCaption	Normal (400)	用于不重要的补充说明信息
Body (Default)	DesignFontWeightBody	Medium (500)	核心全局字重，用于所有常规正文
Title/Header	DesignFontWeightTitle	SemiBold (600)	用于卡片标题、分类标题
Display (Large)	DesignFontWeightDisplay	SemiBold (600)	用于超大号文本（如温度数字）

注意：除非极特殊艺术需求，应避免使用 Thin, ExtraLight, Light 或 Bold (700), Heavy。

3. 字号标准 (Font Sizes)

角色	Token	数值 (px)	典型应用场景
Caption	DesignFontSizeCaption	12	底部说明、状态提示
BodySmall	DesignFontSizeBodySmall	13	设置项描述、次要标签
Body	DesignFontSizeBody	14	标准文本、正文内容
BodyLarge	DesignFontSizeBodyLarge	16	加大正文、菜单项
Subtitle	DesignFontSizeSubtitle	18	小节标题、大按钮文字
Title	DesignFontSizeTitle	24	组件标题、大卡片标题
Headline	DesignFontSizeHeadline	32	重要数据指标
Display	DesignFontSizeDisplay	48	天气温度、时间分钟
DisplayLarge	DesignFontSizeDisplayLarge	54	诗词正文、欢迎语

4. 行高标准 (Line Heights)

统一行高可以增强视觉节奏感。

Token	数值 (倍率)	应用场景
DesignLineHeightStandard	1.2	单行标签、紧凑卡片
DesignLineHeightLoose	1.5	多行诗词、新闻摘要、说明文档

5. 使用规范

1. 禁止硬编码：严禁在 .axaml 中直接写入 FontSize="18" 或 FontWeight="Bold"。
2. 动态资源绑定：始终使用 {DynamicResource DesignFontSize...} 进行绑定。
3. 全局样式继承：App.axaml 已经设置了 TextBlock 的默认 FontWeight 为 Medium，除非是 Caption 或 Title，否则无需重复声明。

---

English (Summary)

• Default Font: MiSans VF.
• Base Weight: Medium (500) for better readability on glass/dark backgrounds.
• Header Weight: SemiBold (600) for a modern premium feel.
• Line Height: Standardized to 1.2x and 1.5x.
• Tokens: All components must use DesignFontSize... and DesignFontWeight... resource keys.