> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 主题风格

> 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 样式设置

主题色、明暗方案、语言、动画节奏与字体。这一组决定「全站看起来是什么气质」，与具体页面无关。

## 配置项

### 主题颜色与配色

| 选项   | 默认值  | 说明                                             |
| ---- | ---- | ---------------------------------------------- |
| 色调   | 250  | 主题色相，0\~360。红 0、蓝绿 200、青 250、粉 345；访客可在显示设置中覆盖 |
| 默认配色 | 跟随系统 | 跟随系统 / 深色 / 浅色                                 |

### 配色切换动画

| 选项     | 默认值  | 说明                                             |
| ------ | ---- | ---------------------------------------------- |
| 切换动画样式 | 淡入淡出 | 淡入淡出 / 圆形扩散 / 擦除 / 无动画                         |
| 速度曲线   | 默认   | 默认 / 线性 / 缓入 / 缓出 / 缓入缓出 / 指数缓出 / 回弹；时长随曲线自动匹配 |
| 擦除角度   | 90°  | 仅擦除样式生效：0° 从左到右、90° 从上到下、180° 从右到左             |

### 语言与动效

| 选项      | 默认值  | 说明                                                                                                      |
| ------- | ---- | ------------------------------------------------------------------------------------------------------- |
| 默认语言    | 跟随系统 | 跟随系统 / 简体中文 / 繁體中文 / English                                                                            |
| 动画速度档位  | 均衡   | 舒缓：保留完整错峰入场；均衡：默认值；疾速：入场只做轻微位移、换页更快；自定义：逐项设置                                                            |
| 自定义动画时长 | —    | 换页退场 200ms、入场 300ms、错峰步长 50ms、错峰上限 400ms、内容基础延迟 150ms、导航栏隐藏 700ms、浮动按钮 350ms、Banner 载入 700ms、轮播切换 700ms |

### 样式开关

| 选项      | 默认值 | 说明                            |
| ------- | --- | ----------------------------- |
| 底部波浪效果  | 开启  | 关闭 / 开启 / 移动端关闭。移动端关闭可降低开销    |
| 卡片悬浮效果  | 开启  | 悬停时轻微上移并显示主题色阴影               |
| 卡片边框和阴影 | 关闭  | 细边框 + 浅阴影，增强层次                |
| 卡片跟随主题色 | 关闭  | 浅色模式下卡片背景带主题色调                |
| 高级材质    | 开启  | 导航栏等元素半透明磨砂；配合「全屏透明」时内容卡片也会磨砂 |
| 全局樱花特效  | 关闭  | 全站樱花飘落，访客可覆盖                  |

### 外部字体

| 选项             | 默认值 | 说明                                                    |
| -------------- | --- | ----------------------------------------------------- |
| 启用外部字体         | 关闭  | 全局替换字体                                                |
| 字体资源           | 空   | 上传 TTF / OTF / WOFF / WOFF2，或粘贴 Google Fonts 等 CSS 链接 |
| font-family 名称 | 空   | 要应用的字体名称，需与字体文件或 CSS 中定义的一致                           |

## 推荐配法

**稳妥耐用**：色调 250、跟随系统、淡入淡出 + 默认曲线。绝大多数设备表现一致，也不容易踩浏览器兼容问题。

**品牌色统一**：把色调固定为品牌主色的色相（如 210 蓝、345 粉），关闭访客外观切换，保证访客看到的是同一套配色。

**阅读优先**：动画速度选「疾速」，关闭樱花与底部波浪，卡片边框关闭、跟随主题色关闭，减少视觉噪音。

**夜间舒适**：默认配色选「深色」，开启「卡片边框和阴影」并保持「高级材质」开启，深色下卡片边界更清晰。

## 注意事项

- 色调只改「色相」，饱和度与明度由主题预设控制；访客在前台拖动色相环同样写入这个值
- 「圆形扩散 / 擦除」在部分 Mac 浏览器上动画异常，建议用淡入淡出；擦除角度只在擦除样式下生效
- 动画速度选「自定义」后，上面列出的时长才会生效；换页动画与列表错峰是两套参数，不要只调其中一个就判断「没变快」
- 语言切换按钮是否显示由 [菜单栏](/ethereal/appearance/navbar.md) 控制；这里只决定默认语言
- 外部字体的 CSS 链接方式依赖第三方服务可用性，国内访问 Google Fonts 可能超时，建议上传字体文件
- 卡片相关开关会影响全站卡片，包括文章卡片、小组件卡片、关于页卡片