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
fix: Latin runs in a non-Latin deck proof as English; bilingual roles and notes
hugohe3f76d1ecb4185
diff --git a/skills/ppt-master/references/executor-notes.md b/skills/ppt-master/references/executor-notes.mdindex 5ae652b3..400db2d7 100644--- a/skills/ppt-master/references/executor-notes.md+++ b/skills/ppt-master/references/executor-notes.md@@ -8,7 +8,7 @@ Conditional late-stage authority for generating or validating the complete speak## 1. Complete Speaker-notes Document-Write the whole deck to `notes/total.md` in one batch: `# <number>_<page_title>` per page, `---` between pages; only the heading is stripped before TTS. `notes_to_audio.py` reads the body verbatim, so write prose only — no list/bullet markup, stage markers, key-point labels, duration lines, or other metadata. Keep one language; spell out digits or symbols when literal TTS would sound wrong (Chinese "百分之六十八" rather than "68%").+Write the whole deck to `notes/total.md` in one batch: `# <number>_<page_title>` per page, `---` between pages; only the heading is stripped before TTS. `notes_to_audio.py` reads the body verbatim, so write prose only — no list/bullet markup, stage markers, key-point labels, duration lines, or other metadata. Keep one language unless the confirmed contract is bilingual — then every page keeps the same segment order (first language, blank line, second language); spell out digits or symbols when literal TTS would sound wrong (Chinese "百分之六十八" rather than "68%").**Pre-SVG narration branch**: when `notes/total.md` already exists from a final/literal script or Quick direct narrated video, validate it instead of regenerating. Retain every word and segment of a final/literal script; agent-authored Quick narration may be repaired only for final-SVG inconsistency and before audio. A `# Slide <number>` heading remains valid until Generate Step 7.1 resolves the roster.diff --git a/skills/ppt-master/references/plan-core.md b/skills/ppt-master/references/plan-core.mdindex 134d68e8..d8787278 100644--- a/skills/ppt-master/references/plan-core.md+++ b/skills/ppt-master/references/plan-core.md@@ -163,7 +163,7 @@ python3 skills/ppt-master/scripts/visualization_recall.py validate \**Family selection**: user/template typography is authoritative. Delivery target: an explicit user/template target first, otherwise Windows Microsoft PowerPoint (owner: [`shared-standards-core.md`](./shared-standards-core.md) §4.1) — the authoring host's installed fonts never select a face; name concrete faces installed or approved on that target; at most four families; a brand/web face leads only after user-confirmed installation, otherwise export a safe face and keep it as a Design Spec reference (fonts are not embedded; CSS tails are preview aids, not PowerPoint fallbacks). Avoid near-equivalent splits (YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, Times↔Times New Roman). Fonts in one deck form contrast (different family, weight, or proportion) or concord (one family throughout); across the direction set include both a concord and a contrast pairing unless the user or template fixes the stack, and never default to title = body without a reason.-**Reference — PPT-safe faces (recall, not a whitelist; one concrete named face per script — a stack carries at most one Latin face and one CJK face and never a fallback list of alternatives, because export takes the first named face of each script)**: CJK sans `Microsoft YaHei` / `SimHei`, CJK serif `SimSun` / `FangSong` / `KaiTi` (their macOS counterparts `PingFang SC` / `Heiti SC` / `Songti SC` are preview aliases, never the named face), Traditional Chinese sans `Microsoft JhengHei`, serif `PMingLiU` / `DFKai-SB`, Japanese sans `Yu Gothic` / `Meiryo`, serif `Yu Mincho`, Korean sans `Malgun Gothic`, serif `Batang` (text on another locale's CJK face takes that locale's glyph forms), Arabic `Segoe UI` / `Tahoma` / `Times New Roman` (one face carries both the Latin and Arabic text), Devanagari and other Indic scripts `Nirmala UI` / `Mangal`, Thai `Leelawadee UI` / `Tahoma`, Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond` (`Georgia` sets old-style figures whose digits sit at different heights — a hero-number or data role needs lining figures: `Times New Roman`, `Cambria`, or any listed sans or mono), mono `Consolas` / `Courier New`, math `Cambria Math` (formula preview runs only), display `Impact` / `Arial Black`. Let the locked style's character pick the axis and lead the title — `Microsoft YaHei` / `Arial` are the neutral members, never the automatic lead; a neutral sans title where the style asks for character is the failure to avoid. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.+**Reference — PPT-safe faces (recall, not a whitelist; one concrete named face per script — a stack carries at most one Latin face and one CJK face and never a fallback list of alternatives, because export takes the first named face of each script)**: CJK sans `Microsoft YaHei` / `SimHei`, CJK serif `SimSun` / `FangSong` / `KaiTi` (their macOS counterparts `PingFang SC` / `Heiti SC` / `Songti SC` are preview aliases, never the named face; a CJK deck that also sets Latin lines pairs both in one stack — `SimSun, Cambria` — so the theme's latin and ea slots differ), Traditional Chinese sans `Microsoft JhengHei`, serif `PMingLiU` / `DFKai-SB`, Japanese sans `Yu Gothic` / `Meiryo`, serif `Yu Mincho`, Korean sans `Malgun Gothic`, serif `Batang` (text on another locale's CJK face takes that locale's glyph forms), Arabic `Segoe UI` / `Tahoma` / `Times New Roman` (one face carries both the Latin and Arabic text), Devanagari and other Indic scripts `Nirmala UI` / `Mangal`, Thai `Leelawadee UI` / `Tahoma`, Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond` (`Georgia` sets old-style figures whose digits sit at different heights — a hero-number or data role needs lining figures: `Times New Roman`, `Cambria`, or any listed sans or mono), mono `Consolas` / `Courier New`, math `Cambria Math` (formula preview runs only), display `Impact` / `Arial Black`. Let the locked style's character pick the axis and lead the title — `Microsoft YaHei` / `Arial` are the neutral members, never the automatic lead; a neutral sans title where the style asks for character is the failure to avoid. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.**Role extension after confirmation**: while composing the roster, add a lowercase snake_case role with an exact stack only for a recurring role that materially needs a different family (`annotation`, `footer`, `footnote`, `data`, `emphasis`, `quote`, `code`), coherent with the confirmed heading/body system and locked style; one-off garnish stays omitted and Default names any added role in one compact `Role rationale` line in §IV.@@ -177,6 +177,7 @@ python3 skills/ppt-master/scripts/visualization_recall.py validate \| Subtitle | 1.2–1.5× || Lead / subheading | 1.1–1.4× || Body | 1× |+| Second-language line on a bilingual page | 0.75–0.9× || Annotation | 0.7–0.85× || Footnote / page number | 0.5–0.65× |diff --git a/skills/ppt-master/scripts/preset_shape_svg.py b/skills/ppt-master/scripts/preset_shape_svg.pyindex fff4afd3..4419f837 100644--- a/skills/ppt-master/scripts/preset_shape_svg.py+++ b/skills/ppt-master/scripts/preset_shape_svg.py@@ -322,11 +322,7 @@ def main(argv: Sequence[str] | None = None) -> int:"scope": semantics["scope"],"literal_only": semantics["literal_only"],"adjustments": adjustments,- **(- {"adjustment_notes": semantics["adjustment_notes"]}- if "adjustment_notes" in semantics- else {}- ),+ "adjustment_notes": semantics.get("adjustment_notes"),"connector_preset": connector_preset,"path_count": path_count,"connection_site_count": connection_site_count,diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.pyindex 9bbd2020..6313c785 100644--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py@@ -3479,9 +3479,31 @@ def detect_text_lang(frozenset({'el'}),'el-GR',)+ if (+ default_language+ and language_base(default_language) in _NON_LATIN_SCRIPT_BASES+ and any(ch.isalpha() for ch in text)+ ):+ # A run of Latin letters inside a CJK/Arabic/... deck (an English+ # subtitle, a source line) proofs and reads as English, not as the+ # deck language; digits and punctuation alone keep the deck tag.+ return 'en-US'return default_language or 'en-US'+# Language bases whose script the detector recognises above; a Latin-letter+# run under one of these deck languages is not written in that language.+_NON_LATIN_SCRIPT_BASES = frozenset({+ 'zh', 'ja', 'ko',+ 'ar', 'fa', 'ps', 'sd', 'ug', 'ur',+ 'he', 'yi',+ 'hi', 'mr', 'ne', 'sa',+ 'th',+ 'be', 'bg', 'kk', 'ky', 'mk', 'mn', 'ru', 'sr', 'uk',+ 'el',+})++def _is_grapheme_extend(ch: str) -> bool:"""Return whether ``ch`` extends the preceding rendered character."""cp = ord(ch)diff --git a/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py b/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.pyindex a40d9b40..b580775c 100644--- a/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py+++ b/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py@@ -52,3 +52,14 @@ class TableFallbackFaceTests(unittest.TestCase):if __name__ == "__main__":unittest.main()+++class RunLanguageTests(unittest.TestCase):+ def test_latin_runs_in_a_cjk_deck_are_english(self) -> None:+ from svg_to_pptx.drawingml.utils import detect_text_lang+ self.assertEqual(detect_text_lang("China's NEV Exports 2025", "zh-CN"), "en-US")+ self.assertEqual(detect_text_lang("Sources: CAAM, CPCA", "ar-SA"), "en-US")+ self.assertEqual(detect_text_lang("2025", "zh-CN"), "zh-CN")+ self.assertEqual(detect_text_lang("出口 Exports", "zh-CN"), "zh-CN")+ self.assertEqual(detect_text_lang("Hello", "en-GB"), "en-GB")+ self.assertEqual(detect_text_lang("Xin chào", "vi-VN"), "vi-VN")diff --git a/skills/ppt-master/scripts/text_measure.py b/skills/ppt-master/scripts/text_measure.pyindex e3526b57..d832576c 100644--- a/skills/ppt-master/scripts/text_measure.py+++ b/skills/ppt-master/scripts/text_measure.py@@ -499,13 +499,17 @@ def _outline_candidates(value = _clean_planned_line(field_match.group('value'))if label == 'title':if value and 'title' in candidates:- candidates['title'].append((slide, value))+ candidates['title'].extend(+ (slide, part) for part in _split_joined_blocks(value)+ )line_index += 1continueif label == 'core message':role = 'subtitle' if 'subtitle' in candidates else 'body'if value and role in candidates:- candidates[role].append((slide, value))+ candidates[role].extend(+ (slide, part) for part in _split_joined_blocks(value)+ )line_index += 1continue