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

fix(typography): require concrete font selections

hugohe3dedcdd6f24fd
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 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.md
index 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.py
index 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_error
return None
diff --git a/skills/ppt-master/scripts/confirm_ui/static/app.js b/skills/ppt-master/scripts/confirm_ui/static/app.js
index 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 values
refreshStylePreview();
@@ -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.css
index 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.md
index 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.md
index 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.md
index 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 Hierarchy
diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.md
index 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 |
| --- | --- |