Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(strategist): rework font seed table around contrast axes

hugohe3d44524ffb93a
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 06490593..2175a8df 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -114,37 +114,52 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre
#### Font Combinations
-> Table below is a starting point, not a menu — adapt or propose new combinations as content tone calls for it. Per-role assignment (`title` / `body` / `emphasis` / `code`) is expected.
->
+> Same-deck fonts must form **contrast** (different family, weight, or proportion) or **concord** (one family throughout). "Similar but not identical" pairings *across roles* are forbidden — see blacklist below. *Within one stack*, pairing a Windows font with a macOS counterpart (e.g. `Microsoft YaHei` + `PingFang SC`) is encouraged as a browser-preview nicety; converter writes only the first into PPTX.
+
> **⚠️ PPT-safe font discipline (HARD rule).** PPTX has no runtime fallback — missing fonts substitute to Calibri. Every stack MUST end with a pre-installed font:
-> - CJK-capable → `"Microsoft YaHei", sans-serif` or `SimSun, serif`
-> - Latin-only → `Arial, sans-serif` or `"Times New Roman", serif`
-> - Monospace → `Consolas, "Courier New", monospace`
+> - CJK → `"Microsoft YaHei"` / `SimHei` / `SimSun` / `FangSong` / `KaiTi`
+> - Latin sans → `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`
+> - Latin serif → `"Times New Roman"` / `Georgia` / `Cambria` / `Palatino` / `Garamond`
+> - Mono → `Consolas` / `"Courier New"`
+> - Display → `Impact` / `"Arial Black"`
>
-> Stacks leading with non-pre-installed fonts (Inter / HarmonyOS Sans / Google Fonts / brand typefaces like McKinsey Bower) are only acceptable when the Design Spec notes "requires install or PPTX embed". Never end a stack with a non-safe font.
+> Stacks led by non-pre-installed fonts (Inter / HarmonyOS Sans / Source Han / brand typefaces like McKinsey Bower) are only acceptable when the Design Spec notes "requires install or PPTX embed".
+
+**Forbidden — similar-but-not-identical pairings across roles** (do not split title vs body across these; within one stack as cross-platform fallback they remain encouraged):
+
+- `Microsoft YaHei` ↔ `PingFang SC` ↔ `Heiti SC`
+- `SimSun` ↔ `Songti SC` ↔ `STSong`
+- `Arial` ↔ `Helvetica Neue` ↔ `Segoe UI`
+- `"Times New Roman"` ↔ `Times`
+- `Georgia` ↔ `Cambria`
+
+**Mandatory**: propose **two** combinations to the user — one concord (safe), one contrast (with tension). Do not default to "title = body, same font" without explicit user request.
-**Cross-platform pre-installed reference** (Windows + Mac out of the box):
+**Cross-platform pre-installed reference**:
| Category | Safe families |
|----------|--------------|
| CJK sans | Microsoft YaHei, SimHei, PingFang SC, Heiti SC |
-| CJK serif | SimSun, FangSong, KaiTi, Songti SC, STSong |
-| Latin sans | Arial, Calibri, Segoe UI, Verdana, Helvetica, Helvetica Neue |
-| Latin serif | Times New Roman, Georgia, Cambria, Times, Palatino |
-| Monospace | Consolas, Courier New, Menlo, Monaco |
+| CJK serif | SimSun, FangSong, KaiTi, Songti SC |
+| Latin sans | Arial, Calibri, Segoe UI, Verdana, Trebuchet MS, Helvetica Neue |
+| Latin serif | Times New Roman, Georgia, Cambria, Palatino, Garamond, Book Antiqua |
+| Mono | Consolas, Courier New |
| Display | Impact, Arial Black |
-**Seed combinations** (all stacks are PPT-safe — end on pre-installed fonts):
-
-| Direction | Typical scenarios | Title stack | Body stack | Code stack |
-|-----------|-------------------|-------------|------------|------------|
-| **Modern CJK sans** (default) | Tech launches, enterprise reports, most contemporary decks | `"Microsoft YaHei", "PingFang SC", sans-serif` | same as Title | — |
-| **Government / 政务** | Government reports, party-building, formal briefings | `SimHei, "Microsoft YaHei", sans-serif` | `SimSun, serif` | — |
-| **Academic serif** | Research, legal, theses, serious analysis | `Georgia, "Times New Roman", serif` | `"Times New Roman", SimSun, serif` | — |
-| **Editorial display** | Magazine covers, luxury, finance, brand storytelling | `Georgia, SimSun, serif` (Bold/Heavy) | `"Microsoft YaHei", "PingFang SC", sans-serif` | — |
-| **Tech / developer** | Code-focused tech talks, developer docs, API / CLI explainers | `Arial, sans-serif` | same as Title | `Consolas, "Courier New", monospace` |
-| **International English** | English-primary decks, international audiences | `"Helvetica Neue", Arial, sans-serif` | same as Title | — |
-| **Impact / 海报** | Cover headlines, call-to-action, poster-style slides | `Impact, "Arial Black", "Microsoft YaHei", sans-serif` | `"Microsoft YaHei", "PingFang SC", sans-serif` | — |
+**Seed combinations** (all PPT-safe; first column names the contrast axis, not a scenario):
+
+| Contrast axis | Title stack | Body stack | Code stack |
+|---|---|---|---|
+| Serif × sans | `Georgia, KaiTi, serif` | `"Microsoft YaHei", "PingFang SC", sans-serif` | — |
+| Kai × hei | `KaiTi, Georgia, serif` | `"Microsoft YaHei", "PingFang SC", sans-serif` | — |
+| Fangsong × hei | `FangSong, "Times New Roman", serif` | `SimHei, "Microsoft YaHei", sans-serif` | — |
+| Double serif | `Palatino, FangSong, serif` | `Cambria, SimSun, serif` | — |
+| Same family, weight contrast (900 / 300) | `"Microsoft YaHei", "PingFang SC", sans-serif` | same | — |
+| Display × neutral | `Impact, "Arial Black", SimHei, sans-serif` | `Arial, "Microsoft YaHei", sans-serif` | — |
+| Cool serif (academic) | `Cambria, SimSun, serif` | `"Times New Roman", SimSun, serif` | — |
+| Hei × song (政务) | `SimHei, "Microsoft YaHei", sans-serif` | `SimSun, serif` | — |
+| Tech / developer | `Arial, "Microsoft YaHei", sans-serif` | same | `Consolas, "Courier New", monospace` |
+| Concord (default fallback) | `"Microsoft YaHei", "PingFang SC", sans-serif` | same | — |
> **Stack length discipline (soft rule).** ≤4 fonts per stack. Lead with Windows-preinstalled fonts (Microsoft YaHei / SimSun / Arial / Georgia / Consolas); keep at most **one** macOS-exclusive family (typically `"PingFang SC"`). Converter only picks the first Latin and first CJK font ([`drawingml_utils.py parse_font_family`](../scripts/svg_to_pptx/drawingml_utils.py)); macOS→Windows fallback is auto-mapped via `FONT_FALLBACK_WIN`.