---
summary: '17 个内置主题、从 PowerPoint 模板抽取自家品牌，以及通过 CLI flag、IR、项目配置做 style 覆盖'
read_when:
  - 挑主题，或查某个主题 id
  - 想让产出看起来像自己公司（`pptfast brand extract`）
  - 不分叉主题就换配色
---

# 主题

主题（theme）打包了 style（设计 tokens）、brand（品牌标识元素：logo、页脚、页码）与每个页型各自的版式集合。内置 17 个。

| id | label |
|---|---|
| `consulting` | Business Consulting |
| `enterprise` | Enterprise |
| `academic` | Academic |
| `insight` | Financial Insight |
| `campaign` | Marketing Campaign |
| `bloom` | Soft Bloom（`classroom` 的换色版）|
| `classroom` | Classroom |
| `ink` | Ink Wash |
| `tech` | Tech |
| `runway` | Fashion Runway |
| `journal` | Editorial Journal |
| `luxe` | Luxe |
| `heritage` | Heritage |
| `pulse` | Health & Life Science |
| `terra` | Sustainability & ESG |
| `ember` | Startup Pitch |
| `vermilion` | Official Report |

`pptfast themes [--json]` 会从你装的这一版里打印同一份清单。

每个内置主题默认对每个页型都开放全部已注册版式。每个版式都会按主题的实际背景色自适应取色，所以全集在任何主题下都保持可读。收窄集合是主题作者的主动选择，17 个主题里目前没有一个收窄任何页型。

主题收窄的不是集合，是偏好：每个内置主题都写明了自己偏向哪几个封面，所以同一份 deck、同一个 seed，换个主题通常会抽到不一样的封面。偏好不是锁定，封面必须是某一个时，在这一页上写 `slide.layout` 钉死。

`bloom` 就是换了五个色值的 `classroom`，别的一处不差：结构、字体、圆角、装饰几何全部相同，只是渲成自己的色板。想要樱粉纸和干玫瑰选 `bloom`，想要雾蓝讲义纸选 `classroom`，同一份 deck 在两者下抽到的版式相同。所以是 17 个主题 id、16 套设计。

## 你自己的品牌

让产出看起来像*你的公司*而不是某个内置主题，最快的路径是从你已有的模板里抽取品牌。`pptfast brand extract` 从 `.thmx` 主题、`.potx` 模板或 `.pptx` 演示文稿中读出配色与字体，写出一个 pptfast 主题文件。整个过程**完全在本地进行，文件从不离开你的机器**（已对 macOS PowerPoint 自带的全部 39 个 Office 主题逐一验证）。

```bash
pptfast brand extract corp-template.pptx -o my-brand.theme.json
pptfast render deck.json -o deck.pptx --theme-file my-brand.theme.json
```

`--theme-file` 在 `render`、`validate`、`audit`、`preview`、`serve` 上都可用。在 deck 项目目录里，把文件放进去命名为 `theme.json`，每条命令都会自动装载，在 `deck.spec.json` 里引用它的 id 即可，不需要任何 flag。

OOXML 的 12 个色槽与 pptfast 的 tokens 几乎一一对应，六个强调色恰好构成图表色板。唯一需要派生的 token 是 `muted`：向背景色逐步混合，止步于仍能保住 4.5:1 对比度的最后一档。

装载时执行与所有注册主题相同的对比度底线：文字与背景过近的配色会被拒绝，错误信息写明失败的 token、实测比值与对应背景，绝不渲染出不可读的结果。自定义主题永远不能顶替内置 id。

抽取的实现细节见 [`brand-extraction.md`](./brand-extraction.md)，对比度机制见 [`contrast-system.md`](./contrast-system.md)（均为英文）。

## style 覆盖与项目配置

不分叉主题就换配色：写一份 style JSON（结构见 `pptfast schema --style`），按次渲染传入（`--style brand.json`），或固化在项目级 `pptfast.config.json` 里（自当前目录向上查找，用 `pptfast init` 生成模板）。

```json
{ "theme": "consulting", "style": { "colors": { "primary": "#0B5FFF", "accent": "#FF6A00" } } }
```

优先级：CLI flag > 项目配置文件 > 用户配置文件 > IR。IR 自身也可以在 `theme.style` 携带同样的覆盖，做到单文件自包含。完整的四层链见 [`ir.zh-CN.md`](./ir.zh-CN.md#deck-项目)。