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(typography): require concrete font selections
hugohe3dedcdd6f24fd
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 22a0a41a..f193da07 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -281,9 +281,9 @@ test -f "<project_path>/icons/<lib>/<name>.svg"## 5. Font Usage-Typography comes from `spec_lock.md`: `<role>_family` wins; otherwise titles use `title_family`, body/support `body_family`, then legacy `font_family`. Sparse accents follow §2.1. LaTeX renders stay PNG, not `code_family`.+Read typography from `spec_lock.md`: `<role>_family` → `title_family` / `body_family` → legacy `font_family`; sparse accents follow §2.1 and LaTeX stays PNG.-**Default — font-family inheritance (may override where needed)**: Put the common stack on root `<svg>`; matching descendants omit it. Override at the nearest clear `<g>`, `<text>`, or `<tspan>`. Change placement, never lock selection.+**Default — locked-stack realization (may vary treatment)**: Express the Design Spec Character Reference through scale, weight, spacing, color, and composition; keep the locked family. Put the common stack on root `<svg>`, omit matching descendants, and override at the nearest clear `<g>`, `<text>`, or `<tspan>`.**Missing required field — `typography.font_family`** → stop and return to Generate Step 4 / [`strategist.md`](strategist.md) §6.2 to repair `spec_lock.md`; do not infer a stack from `design_spec.md`.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex cea3128d..6a8ef644 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -212,12 +212,12 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre**Family selection**:-- User or active template typography is authoritative. Otherwise ≥3 Stage-2 directions include concord (safe) and contrast (tension); never add a separate font-choice round or pair near-duplicate title/body families.-- Every Stage-2 direction carries `heading` / `body` `cjk`, `latin`, `css`, and positive `body_size`; repeat user/template-fixed stacks.-- Keep stacks to four families or fewer. A brand/web face may lead only after user-confirmed target installation/approved install; PPT Master does not embed fonts. Otherwise export a safe face and keep the unavailable face as Design Spec reference.-- Avoid near-equivalent role splits such as YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, or Times New Roman↔Times. Counterparts may aid SVG/browser preview; CSS tails are not deterministic PowerPoint fallbacks.-- **Default — one language-matched concord candidate (may override for confirmed identity)**: without user/template typography, every Stage-2 set includes at least one target-approved safe heading/body system—Simplified Chinese `Microsoft YaHei` + `Arial`; Traditional Chinese `Microsoft JhengHei` + `Arial`; Japanese `Meiryo` + `Arial`; Korean `Malgun Gothic` + `Arial`; Latin-script `Arial` with a target-locale EA fallback for required `cjk`. Build hierarchy through size, weight, spacing, color, and composition; this is a candidate, not a mandate.-- **Reference — not a constraint**: shifted/bold directions may use purposeful serif×sans, calligraphic×sans, display×neutral, or sans×mono contrast. Never change family merely to avoid YaHei/Arial; expressive CJK faces may start regular and gain hierarchy through scale, spacing, color, or layout.+- User/template typography wins. Otherwise ≥3 Stage-2 directions include safe concord and purposeful contrast; no extra font round or near-duplicate pair.+- A category may explain candidate `note`, never replace the choice. Before Stage 2, resolve concrete `heading` / `body` `cjk`, `latin`, `css`, and positive `body_size`; `name` labels the pair and Custom fills all four faces. Repeat fixed stacks.+- Resolve by language/target: installed/approved faces may lead; otherwise use a safe face and express character via scale, weight, spacing, color, composition. Fonts are not embedded; unavailable options are post-export Typography upgrade References after target installation, never stacks/lock.+- Avoid near-equivalent roles such as YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, or Times New Roman↔Times. Preview counterparts/CSS tails are not deterministic PowerPoint fallbacks.+- **Default — language-matched safe concord (unless identity is confirmed)**: Include one approved heading/body stack—zh-CN `Microsoft YaHei` + `Arial`; zh-TW `Microsoft JhengHei` + `Arial`; ja `Meiryo` + `Arial`; ko `Malgun Gothic` + `Arial`; Latin `Arial` plus locale EA when needed. This is one candidate, not a mandate.+- **Reference — not a constraint**: Internal recall, never Confirm UI options: neutral sans, humanist sans, editorial serif, display/expressive, mono/data. Map neutral/humanist → safe sans; editorial → safe serif; display → approved face or treated safe sans/serif; mono/data → safe Latin mono + EA companion. Use display mainly for covers/dividers/short titles and mono/data for code/data/coordinates/short labels.**Strategist-owned role extension after confirmation**: Reuse confirmed heading/body families for recurring roles; differentiate with size, weight, color, spacing, or treatment. Add a lowercase snake_case role and exact stack only for function or confirmed visual-style/brand need (e.g. code, tabular data, brand), not recurrence alone. Keep it coherent without reopening confirmation; add one `Role rationale` only with an additional family.@@ -453,7 +453,7 @@ includes transitions.| Communication contract and `content_divergence` | §I records the confirmed contract; §IX realizes every stated purpose, outcome, priority, and source-treatment constraint || Canvas, reading mode, and page count | §I records the confirmed input and exact resolved count; §IX contains that many ordered pages. Executor produces exactly one output slide per entry, in order || Mode, visual style, palette, and generated-image rendering | §I and §III record the selected direction as identity anchors; named core roles stay stable while page-local expression remains contextual |-| Typography, including Strategist-derived recurring family overrides and every visible role size | §IV records the confirmed heading/body stacks, any recurring support-role stacks justified by §IX, and exact `body`, `title`, `subtitle`, and `annotation` anchor values; never discard a declared role override or re-derive a confirmed anchor |+| Typography, including Strategist-derived recurring family overrides and every visible role size | §IV records Character/upgrade References, resolved heading/body stacks, recurring support-role stacks justified by §IX, and exact `body`, `title`, `subtitle`, and `annotation` anchors; never discard a declared role override or re-derive a confirmed anchor || Icons | §VI uses the confirmed library or confirmed no-icon/custom path || Confirmed image-source set, `image_notes`, and AI strategy | §VIII uses only permitted sources and includes every explicitly required source, asset, or page role; a permitted but unused source needs no row || Natural-language template application | §I records it and the relevant layout/prototype choices realize it without silently dropping a requested use or exclusion |diff --git a/skills/ppt-master/scripts/confirm_ui/server.py b/skills/ppt-master/scripts/confirm_ui/server.pyindex 11193556..c8693cc7 100644--- a/skills/ppt-master/scripts/confirm_ui/server.py+++ b/skills/ppt-master/scripts/confirm_ui/server.py@@ -782,18 +782,7 @@ def _stage2_solution_error(result: dict) -> Optional[str]:'typography',require_sizes=True,)- typography_custom = (- isinstance(typography, dict)- and typography.get('name') == 'custom'- and str(typography.get('custom') or '').strip()- and _positive_number(typography.get('body_size'))- and isinstance(typography.get('sizes'), dict)- and all(- _positive_number(typography['sizes'].get(role))- for role in _TYPOGRAPHY_SIZE_ROLES- )- )- if typography_error and not typography_custom:+ if typography_error:return typography_errorreturn Nonediff --git a/skills/ppt-master/scripts/confirm_ui/static/app.js b/skills/ppt-master/scripts/confirm_ui/static/app.jsindex e8d330a0..1812fdba 100644--- a/skills/ppt-master/scripts/confirm_ui/static/app.js+++ b/skills/ppt-master/scripts/confirm_ui/static/app.js@@ -119,7 +119,7 @@size_role_subtitle: "subtitle",size_role_annotation: "annotation",custom_typography: "Custom typography",- custom_typography_placeholder: "Type your font plan, e.g. Heading: Georgia + KaiTi; Body: Microsoft YaHei + Arial…",+ custom_typography_repair: "Complete the four concrete font names to continue.",custom_color: "Custom color",custom_color_placeholder: "Describe your colors in words, e.g. deep navy primary, warm orange accent, white background — or paste HEX values…",role_background: "bg",@@ -266,7 +266,7 @@size_role_subtitle: "サブタイトル",size_role_annotation: "注釈",custom_typography: "カスタムタイポグラフィ",- custom_typography_placeholder: "フォント案を入力 — 例:見出し:Georgia + 游明朝 / 本文:游ゴシック + Arial…",+ custom_typography_repair: "続行するには、4つの具体的な書体名を入力してください。",custom_color: "カスタム配色",custom_color_placeholder: "配色を言葉で説明 — 例:濃紺をメインに暖色オレンジのアクセント、背景は白 — またはHEX値を貼り付け…",role_background: "背景",@@ -413,7 +413,7 @@size_role_subtitle: "副标题",size_role_annotation: "注释",custom_typography: "自定义字体方案",- custom_typography_placeholder: "输入字体方案,如:标题用楷体;正文用微软雅黑…",+ custom_typography_repair: "请补全四个具体字体名称后继续。",custom_color: "自定义配色",custom_color_placeholder: "用文字描述配色,如:深蓝主色、暖橙强调、白色背景——或直接粘贴 HEX 值…",role_background: "背景",@@ -1659,6 +1659,7 @@if (isFinite(raw)) typ.sizes[role] = roundSize(raw);});}+ if (typographyFamiliesComplete(typ)) delete typ.custom;// delivery_purpose is PPT-only; drop it on non-PPT canvases where it has// no meaning and was never shown.if (!isPptCanvas(payload.canvas)) delete payload.delivery_purpose;@@ -1807,6 +1808,21 @@return primary + ", " + fallback;}+ function typographyFamiliesComplete(typography) {+ typography = normTypography(typography || {});+ return ["heading", "body"].every(function (role) {+ var font = typography[role] || {};+ return ["cjk", "latin", "css"].every(function (field) {+ return !!String(font[field] || "").trim();+ });+ });+ }++ function typographyNeedsConcreteRepair() {+ return !!(STATE.typography && STATE.typography.name === "custom" &&+ !typographyFamiliesComplete(STATE.typography));+ }+function sampleText(role, script) {if (role === "heading") return t(script === "latin" ? "preview_latin_title" : "preview_big_title");return t(script === "latin" ? "preview_latin_body" : "preview_body_intro");@@ -1826,13 +1842,30 @@}function renderTypography(host) {- var cands = typographyRecommendationCandidates();+ var cands = typographyRecommendationCandidates().filter(typographyFamiliesComplete);var sec = section(7, "sec_type");+ if (stageNumber(REC) >= 3 && typographyNeedsConcreteRepair()) {+ setSectionNote(sec, t("custom_typography_repair"));+ }var grid = el("div", "font-grid");- var customInput = el("textarea", "text-input custom-typography-input");- customInput.rows = 2;- customInput.placeholder = t("custom_typography_placeholder");- customInput.style.display = "none";+ var customFields = el("div", "custom-typography-fields");+ var customInputs = {};+ var customLegacyNote = el("div", "toggle-desc custom-typography-legacy");+ customFields.appendChild(customLegacyNote);+ customFields.style.display = "none";++ function syncCustomInputs() {+ var typography = STATE.typography || {};+ customLegacyNote.textContent = String(typography.custom || "").trim();+ customLegacyNote.style.display = customLegacyNote.textContent ? "block" : "none";+ ["heading", "body"].forEach(function (role) {+ var font = typography[role] || {};+ ["cjk", "latin"].forEach(function (script) {+ var input = customInputs[role + "_" + script];+ if (input) input.value = font[script] || "";+ });+ });+ }function selectFont(idx) {var c = normTypography(cands[idx] || {});@@ -1848,7 +1881,7 @@sizes: Object.assign({}, prev.sizes || {})};if (sizeInput) sizeInput.value = STATE.typography.body_size || "";- customInput.style.display = "none";+ customFields.style.display = "none";grid.querySelectorAll(".font-card").forEach(function (card, i) { card.classList.toggle("selected", i === idx); });refreshSizeInputs(); // fill any role with no value yet; never overwrites existing valuesrefreshStylePreview();@@ -1856,18 +1889,29 @@function selectCustomTypography() {var prev = STATE.typography || {};+ var prevHeading = prev.heading || {};+ var prevBody = prev.body || {};STATE.typography = {name: "custom",- custom: customInput.value || "",- heading: {},- body: {},+ heading: {+ cjk: prevHeading.cjk || "",+ latin: prevHeading.latin || "",+ css: prevHeading.css || "sans-serif"+ },+ body: {+ cjk: prevBody.cjk || "",+ latin: prevBody.latin || "",+ css: prevBody.css || "sans-serif"+ },body_size: prev.body_size || "",sizes: Object.assign({}, prev.sizes || {}) // switching font family must not drop sizes};+ if (prev.custom) STATE.typography.custom = prev.custom;grid.querySelectorAll(".font-card").forEach(function (card) { card.classList.remove("selected"); });customCard.classList.add("selected");- customInput.style.display = "block";- customInput.focus();+ customFields.style.display = "grid";+ syncCustomInputs();+ customInputs.heading_cjk.focus();refreshSizeInputs();refreshStylePreview();}@@ -1893,12 +1937,31 @@customCard.addEventListener("click", selectCustomTypography);grid.appendChild(customCard);sec.appendChild(grid);- customInput.addEventListener("input", function () {- if (!STATE.typography || STATE.typography.name !== "custom") selectCustomTypography();- STATE.typography.custom = customInput.value;- refreshStylePreview();+ [+ ["heading", "cjk", "Microsoft YaHei"],+ ["heading", "latin", "Arial"],+ ["body", "cjk", "Microsoft YaHei"],+ ["body", "latin", "Arial"]+ ].forEach(function (config) {+ var role = config[0], script = config[1];+ var field = el("label", "custom-typography-field");+ field.appendChild(el("span", "hex-cell-label", t("font_" + role) + " · " + t(script)));+ var input = el("input", "text-input");+ input.type = "text";+ input.placeholder = config[2];+ input.addEventListener("input", function () {+ if (!STATE.typography || STATE.typography.name !== "custom") return;+ if (!STATE.typography[role]) {+ STATE.typography[role] = { css: "sans-serif" };+ }+ STATE.typography[role][script] = input.value;+ refreshStylePreview();+ });+ customInputs[role + "_" + script] = input;+ field.appendChild(input);+ customFields.appendChild(field);});- sec.appendChild(customInput);+ sec.appendChild(customFields);var sizeField = el("div", "subfield");sizeField.appendChild(el("div", "subfield-label", t("font_body_size")));@@ -2026,14 +2089,18 @@host.appendChild(sec);var selIdx = -1;- if (STATE.typography && STATE.typography.name) cands.forEach(function (c, i) {+ if (STATE.typography && STATE.typography.name !== "custom") cands.forEach(function (c, i) {if ((localized(c, "name") || c.name) === STATE.typography.name) selIdx = i;});if (selIdx >= 0) selectFont(selIdx);else if (STATE.typography && STATE.typography.name === "custom") {- customInput.value = STATE.typography.custom || "";+ ["heading", "body"].forEach(function (role) {+ if (!STATE.typography[role]) STATE.typography[role] = {};+ if (!STATE.typography[role].css) STATE.typography[role].css = "sans-serif";+ });customCard.classList.add("selected");- customInput.style.display = "block";+ customFields.style.display = "grid";+ syncCustomInputs();}}@@ -2542,7 +2609,13 @@if (previewHost) renderStylePreview(previewHost);if (previewHost) renderImageStrategyPreview(previewHost);// Stage 3 contains production mechanics only. It summarizes the- // confirmed image source but does not reopen aesthetic decisions.+ // confirmed image source and reopens typography only to repair a+ // legacy prose-only Custom result that cannot be final as-is.+ if (typographyNeedsConcreteRepair()) {+ var repairStyleGroup = el("div", "style-group");+ renderTypography(repairStyleGroup);+ host.appendChild(repairStyleGroup);+ }renderImageProduction(host);renderFormulaPolicy(host);renderProactiveExecution(host);@@ -2664,6 +2737,7 @@body_size: t0.body_size || typographyBodySize(REC.typography),sizes: Object.assign({}, t0.sizes || {})};+ if (t0.custom) STATE.typography.custom = t0.custom;// Guarantee a body baseline even when a candidate omitted body_size, on// any canvas (PPT → px default by purpose, non-PPT → px from canvas height),@@ -2789,22 +2863,14 @@var customPalette = color.name === "custom" && String(color.custom || "").trim();var typography = payload.typography || {};- var completeFontRole = function (role) {- var font = typography[role] || {};- return ["cjk", "latin", "css"].every(function (field) {- return !!String(font[field] || "").trim();- });- };- var completeFamilies = completeFontRole("heading") && completeFontRole("body");- var customFamilies = typography.name === "custom" &&- String(typography.custom || "").trim();+ var completeFamilies = typographyFamiliesComplete(typography);var sizes = typography.sizes || {};var completeSizes = positiveNumber(typography.body_size) &&["title", "subtitle", "annotation"].every(function (role) {return positiveNumber(sizes[role]);});var valid = (completePalette || customPalette) &&- (completeFamilies || customFamilies) && completeSizes;+ completeFamilies && completeSizes;if (!valid) {document.getElementById("confirm-status").textContent = t("design_system_required");}diff --git a/skills/ppt-master/scripts/confirm_ui/static/style.css b/skills/ppt-master/scripts/confirm_ui/static/style.cssindex 58ed6ec7..3670b606 100644--- a/skills/ppt-master/scripts/confirm_ui/static/style.css+++ b/skills/ppt-master/scripts/confirm_ui/static/style.css@@ -557,7 +557,13 @@ textarea.text-input { resize: vertical; line-height: 1.5; }}.font-sample-heading { font-size: 24px; font-weight: 700; line-height: 1.3; }.font-sample-body { font-size: 14px; color: #333; margin-top: 4px; }-.custom-typography-input { margin-top: 8px; min-height: 58px; resize: vertical; }+.custom-typography-fields {+ grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));+ gap: 10px;+ margin-top: 8px;+}+.custom-typography-legacy { grid-column: 1 / -1; }+.custom-typography-field { display: flex; flex-direction: column; gap: 4px; }.custom-color-input { margin-top: 8px; min-height: 58px; resize: vertical; }.image-strategy-custom-input { margin-top: 8px; min-height: 72px; resize: vertical; }.image-usage-notes-input { min-height: 64px; resize: vertical; }diff --git a/skills/ppt-master/scripts/docs/confirm_ui.md b/skills/ppt-master/scripts/docs/confirm_ui.mdindex f7d19fc3..a6e92914 100644--- a/skills/ppt-master/scripts/docs/confirm_ui.md+++ b/skills/ppt-master/scripts/docs/confirm_ui.md@@ -182,7 +182,7 @@ After Stage 1 is confirmed, create `recommendations.stage2.json` with the comple"secondary_accent": "#4A7BB5", "body_text": "#1D2430"} },"typography": {- "name_zh": "清晰无衬线",+ "name_zh": "微软雅黑 + Arial","heading": { "cjk": "Microsoft YaHei", "latin": "Arial", "css": "sans-serif" },"body": { "cjk": "Microsoft YaHei", "latin": "Arial", "css": "sans-serif" },"body_size": 24@@ -228,9 +228,9 @@ After Stage 2 is confirmed, create `recommendations.stage3.json` with production- `recommend.image_usage` should be an array of source ids when more than one source applies, e.g. `["ai", "provided"]`. A single string is still accepted for backward compatibility. Do not write bare `"custom"` and do not encode a mixed-source plan as prose here; write the prose to top-level `image_notes.value`.- `image_notes` is the initial strategy note shown under the image source chips. Use it for page-role guidance and constraints: which source applies where, what to avoid, which user assets are authoritative, how realistic / abstract the imagery should be, and what can remain as placeholders. It is intent guidance, not a separate finite option.- When confirmed Stage-2 `image_usage` includes `ai`, Stage 3 sets `recommend.image_ai_path` to one of `auto` / `api` / `host-native` / `manual`. Stage 2 never asks for the acquisition mechanism while the user is still deciding the image role.-- **Color candidates carry the user-facing core `palette`**: `background`, `secondary_bg`, `primary`, `accent`, `secondary_accent`, and `body_text`. The page renders every role as a labelled swatch with its HEX value visible, and offers per-role override inputs for precise single-role edits, plus a **Custom color card with a free-text box** (parallel to the custom typography box) — the user can describe the palette in words or paste HEX values instead of filling each role; this writes `color: { "name": "custom", "custom": "<text>" }` to `result.json` for the AI to interpret. Legacy `text` is accepted as an alias for `body_text`, but new files should write `body_text`. Strategist derives secondary text, borders, state colors, and visual-style neutral tiers while writing `design_spec.md`, then projects the machine values to `spec_lock.md`; those are not user-facing confirmation choices.+- **Color candidates carry the user-facing core `palette`**: `background`, `secondary_bg`, `primary`, `accent`, `secondary_accent`, and `body_text`. The page renders every role as a labelled swatch with its HEX value visible, and offers per-role override inputs for precise single-role edits, plus a **Custom color card with a free-text box** — the user can describe the palette in words or paste HEX values instead of filling each role; this writes `color: { "name": "custom", "custom": "<text>" }` to `result.json` for the AI to interpret. Legacy `text` is accepted as an alias for `body_text`, but new files should write `body_text`. Strategist derives secondary text, borders, state colors, and visual-style neutral tiers while writing `design_spec.md`, then projects the machine values to `spec_lock.md`; those are not user-facing confirmation choices.- **Candidate display text may be multilingual**: color / typography candidates can provide `name_zh` / `name_en` / `name_ja` and `note_zh` / `note_en` / `note_ja`; the page falls back to legacy `name` / `note`. Labels resolve in the page language first, then fall back across the others (a `ja` page: ja → en → zh; zh/en pages keep their zh↔en fallback and try `_ja` last), so when `lang` is `ja` always include the `_ja` variants — otherwise the candidate labels render in English.-- **Typography candidates split CJK and Latin** for both `heading` and `body`; `css` is the fallback preview stack. Each candidate includes topic-matched sample text. Stage 2 is authored once with a reading-mode baseline of `text` 20 · `balanced` 24 · `presentation` 32 px on PPT. Font cards choose family / character and preserve the current sizing state; they do not introduce a competing size recommendation. The page writes px directly. `delivery_purpose` remains the compatibility key only.+- **Typography candidates** expose concrete CJK/Latin `heading` / `body` faces; localized `name` labels the pairing and `css` only previews. A category may explain rationale, never replace the UI choice. Custom requires all four faces and the same stacks, not category prose; a legacy prose-only result reopens these fields before final confirmation. Include topic samples. PPT baselines are `text` 20 · `balanced` 24 · `presentation` 32 px; cards preserve sizes and submit px. `delivery_purpose` remains a compatibility key.- **Per-role size override** (parallel to color's per-role HEX override): besides `body_size`, the page exposes editable inputs for `title` / `subtitle` / `annotation`. The browser applies one documented deterministic dependency chain: `reading mode → body baseline → unpinned role sizes` (role ramp: `body ×` the §g ratios). Changing reading mode updates the body and all unpinned roles locally; changing body updates unpinned roles locally. Editing body or a role pins that value, so later reading-mode changes do not overwrite it. Font / direction-card selection preserves all current sizes. This is a browser-only state update: it performs no fetch, asks the backend to author no new recommendations, and a re-render preserves exactly what the user sees. Each role input is labelled as px and shows an approximate pt equivalent (`1px = 0.75pt`) for orientation. The final values are written to `result.json` as `typography.sizes: { "title", "subtitle", "annotation" }` in **px** — every canvas, no pt and no `sizes_pt` provenance. These confirmed values are Strategist input anchors: the completed page plan may add recurring roles, and downstream execution owns bounded per-occurrence treatment. Candidate `sizes` remain accepted for compatibility, but the fresh Stage-2 baseline is normalized through the same local ramp before first render.- **`delivery_purpose` compatibility key / Reading mode** (enumerable, PPT only) decides where meaning is carried, not merely how large type is: `text` makes pages self-contained with complete sentences, short prose, captions, tables, and necessary detail; `balanced` shares explanation between page and presenter; `presentation` uses one idea, concise claims, and visual evidence while speech / notes carry the detail. It therefore governs page grammar, granularity, density / rhythm, and note burden. Reading-mode cards intentionally show **no px value**; the typography section owns the separately visible body / role sizes and applies any local default. It is surfaced in Stage 2 beside the visual system, separate from communication intent. `recommend.delivery_purpose` pre-selects one; `result.json` retains the key, while `spec_lock.md` uses canonical `consumption_mode`. Non-PPT canvases omit it.- **Combined style preview** — a compact live "overall impression" strip sits just above the color section and is **sticky**: it pins under the topbar so it stays visible while the user scrolls through the color / icon / typography sections, keeping the picking controls and their combined effect on screen together. It applies the currently selected color palette **and** typography (heading sample in `primary` over `background`, body sample in `body_text`, an `accent` bar, a `secondary_bg` chip) and repaints on every color / HEX-override / font / `body_size` change. It does not replace the per-candidate swatches or font samples (those stay for picking); it is deliberately an abstract style chip, **not** a slide-layout preview — page layout preview remains the live-preview server's job (Step 6). No schema field; it derives entirely from the existing color + typography selections.diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex 81f91e06..87c8007c 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -93,11 +93,12 @@ Use these exact subsections and field shapes:### Font Plan-| Role | Chinese | English | Fallback tail |-| --- | --- | --- | --- |-| Title | <family> | <family> | <fallback> |-| Body | <family> | <family> | <fallback> |+| Role | Character (Reference) | Chinese | English | Fallback tail |+| --- | --- | --- | --- | --- |+| Title | <category/modifier> | <family> | <family> | <fallback> |+| Body | <category/modifier> | <family> | <family> | <fallback> |+- **Typography upgrade (Reference)**: <post-export role substitution after target installation; omit if none>- **Title stack**: <complete ordered stack>- **Body stack**: <complete ordered stack>@@ -135,7 +136,7 @@ Use these exact subsections and field shapes:| --- | --- | --- |```-Preserve the confirmed Title/Body system, then add every Strategist-established recurring family override justified by the completed page plan. Append the same semantic role to the Font Plan table and add `- **<Role> stack**: <complete ordered stack>`. Typical optional roles include `Annotation`, `Footer`, `Footnote`, `Data`, `Emphasis`, `Quote`, and `Code`; add only roles that recur and intentionally differ. Add one compact `Role rationale` only when at least one such override is declared; otherwise omit it. The rationale does not become a lock field. Do not collapse distinct Title/Body stacks or discard a declared optional role. Treat every Font Size Hierarchy value as a role anchor: Executor may adjust one occurrence within anchor `±2px`; a short non-structural Hero/Display size may stay unlisted only while the same value is planned at most twice, and its third occurrence needs a named row. Add every recurring palette role and typography-size anchor established by the plan; do not enumerate one-off paint or font-family garnish. For confirmed custom directions, add the applicable `Mode References`, `Mode Behavior`, `Visual Style References`, and `Visual Style Behavior` lines under Theme Style. Include `Stroke Width` under §VI only for a stroke library. `simple-icons` may accompany the one primary bundled library and is recorded only when real brand marks were selected. The icon table records planned usage, but user-provided, template-carried, imported, custom, and other prepared SVGs under the project `icons/` directory remain usable without being forced into that stylistic selection. Leave the §VI table empty when no icons are used.+Preserve Title/Body characters and resolved stacks; omit blank Typography upgrade and never place it in a stack. For each justified recurring family override, add the role to Font Plan plus `- **<Role> stack**: <complete ordered stack>`. Possible roles are `Annotation`, `Footer`, `Footnote`, `Data`, `Emphasis`, `Quote`, and `Code`; add only recurring, intentional differences. Add non-locked `Role rationale` only for an extra family. Do not collapse distinct Title/Body stacks or discard a declared optional role. Each Font Size Hierarchy value is a role anchor: Executor may vary one occurrence `±2px`; a short non-structural Hero/Display size may stay unlisted only while the same value is planned at most twice, and its third occurrence needs a named row. Add every recurring palette role and typography-size anchor established by the plan; do not enumerate one-off paint or font-family garnish. For confirmed custom directions, add the applicable `Mode References`, `Mode Behavior`, `Visual Style References`, and `Visual Style Behavior` lines under Theme Style. Include `Stroke Width` under §VI only for a stroke library. `simple-icons` may accompany the one primary bundled library and is recorded only when real brand marks were selected. The icon table records planned usage, but user-provided, template-carried, imported, custom, and other prepared SVGs under the project `icons/` directory remain usable without being forced into that stylistic selection. Leave the §VI table empty when no icons are used.When §VIII contains any `Acquire Via: ai` row, add this subsection under §III and preserve the complete confirmed AI direction:diff --git a/skills/ppt-master/templates/scaffolds/design_spec.md b/skills/ppt-master/templates/scaffolds/design_spec.mdindex 8572d78e..f2909ba0 100644--- a/skills/ppt-master/templates/scaffolds/design_spec.md+++ b/skills/ppt-master/templates/scaffolds/design_spec.md@@ -58,17 +58,14 @@### Font Plan-| Role | Chinese | English | Fallback tail |-| --- | --- | --- | --- |-| Title | [fill] | [fill] | [fill] |-| Body | [fill] | [fill] | [fill] |-| Emphasis | [fill] | [fill] | [fill] |-| Code | [fill] | [fill] | [fill] |--- Title: [fill]-- Body: [fill]-- Emphasis: [fill or same as Body]-- Code: [fill]+| Role | Character (Reference) | Chinese | English | Fallback tail |+| --- | --- | --- | --- | --- |+| Title | [fill] | [fill] | [fill] | [fill] |+| Body | [fill] | [fill] | [fill] | [fill] |++- **Typography upgrade (Reference)**: [fill post-export substitution by role after target installation, or omit]+- **Title stack**: [fill]+- **Body stack**: [fill]### Font Size Hierarchydiff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.mdindex 82bfdaac..7314e514 100644--- a/skills/ppt-master/templates/spec_lock_reference.md+++ b/skills/ppt-master/templates/spec_lock_reference.md@@ -72,7 +72,7 @@ Structured section value shapes:Project each §VII `Page | Template | Usage` row's first two fields into `page_charts`; Usage stays in the Design Spec. This is a page-local reference, not a type/geometry lock. Keys must exist in `charts/charts_index.json`; no-match stays in §IX.-Typography projection is role-for-role, not a lossy summary:+Typography projection excludes Character/upgrade References:| Design Spec §IV declaration | `spec_lock.md` field || --- | --- |