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.mdindex 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`.