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
feat(native-formula): make editable PowerPoint math the default workflow
hugohe3d36491a3fa8e
diff --git a/AGENTS.md b/AGENTS.mdindex e738cd11..5fcc6b4d 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -67,10 +67,6 @@ python3 skills/ppt-master/scripts/confirm_ui/server.py <project_path> --wait-onl# Image tools and SVG quality checkpython3 skills/ppt-master/scripts/analyze_images.py <project_path>/images-# Formula rendering — manifest written by Default Strategist after confirmation or by the Quick main agent during resource preparation:-python3 skills/ppt-master/scripts/latex_render.py <project_path>-python3 skills/ppt-master/scripts/latex_render.py <project_path> --dry-run-python3 skills/ppt-master/scripts/latex_render.py <project_path> --providers codecogs,quicklatex,mathpad,wikimedia# In-pipeline AI image generation — manifest mode (required, even for 1 image):python3 skills/ppt-master/scripts/image_gen.py --manifest <project_path>/images/image_prompts.jsonpython3 skills/ppt-master/scripts/image_gen.py --render-md <project_path>/images/image_prompts.jsondiff --git a/README.md b/README.mdindex 49330eb0..ec657ed9 100644--- a/README.md+++ b/README.md@@ -326,9 +326,9 @@ The AI handles everything — content analysis, visual design, SVG generation, aYou: Quickly generate a 5-page deck from projects/q3-report/sources/report.pdf — no need to confirm with me```-Whatever you state explicitly is followed; whatever you leave unspecified the agent decides on its own instead of asking. It still converts sources, fills factual gaps, applies the shared visual baseline, and uses images/icons/native shapes/charts/tables/formulas as needed — it drops interaction and durable planning, not presentation capability. It is one-pass and non-resumable, and there is no `svg_final/` preview. Full guide → [Quick mode](./docs/getting-started.md#quick-mode).+Whatever you state explicitly is followed; whatever you leave unspecified the agent decides on its own instead of asking. It still converts sources, fills factual gaps, applies the shared visual baseline, and uses images/icons/native shapes/charts/tables/PowerPoint-native block formulas as needed — it drops interaction and durable planning, not presentation capability. It is one-pass and non-resumable, and there is no `svg_final/` preview. Full guide → [Quick mode](./docs/getting-started.md#quick-mode).-> **Output:** The SVG pipeline has one PPTX converter: it reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. The default Generate flow runs `finalize_svg.py` and produces self-contained previews in `svg_final/`; PowerPoint's manual **Convert to Shape** command is outside the supported contract. Explicit [quick generation](./skills/ppt-master/workflows/profiles/quick-generate.md) skips Strategist, confirmation, `design_spec.md`, `spec_lock.md`, and `finalize_svg.py`: whatever you state explicitly is followed, and whatever you leave unspecified the agent decides directly in one active context. It still converts sources, researches factual gaps, applies shared mode/style/aesthetic guidance, prepares required images/icons/formulas, considers native shapes and data visualizations, hand-authors SVG, passes the lockless Quick final quality check, and exports the final PPTX. It writes no substitute plan and cannot resume after context loss. Ordinary export capabilities remain available as needed, including native chart/table replacement, notes, motion, narration, and diagnostics; notes, custom object animation, and narration start off, and the agent may enable them when the request or deck needs them. A default-path Quick export writes the normal postflight report and snapshots `svg_output/` to `backup/<timestamp>/svg_output/`; an explicit output path keeps the ordinary no-backup behavior. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both chart/table export variants are editable—the distinction is the PowerPoint object model, not editability itself.+> **Output:** The SVG pipeline has one PPTX converter: it reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. The default Generate flow runs `finalize_svg.py` and produces self-contained previews in `svg_final/`; PowerPoint's manual **Convert to Shape** command is outside the supported contract. Explicit [quick generation](./skills/ppt-master/workflows/profiles/quick-generate.md) skips Strategist, confirmation, `design_spec.md`, `spec_lock.md`, and `finalize_svg.py`: whatever you state explicitly is followed, and whatever you leave unspecified the agent decides directly in one active context. It still converts sources, researches factual gaps, applies shared mode/style/aesthetic guidance, prepares required images/icons, authors formulas as native block-equation markers, considers native shapes and data visualizations, hand-authors SVG, passes the lockless Quick final quality check, and exports the final PPTX. It writes no substitute plan and cannot resume after context loss. Formula markers compile their LaTeX payload to editable OMML for PowerPoint 2010+; their ordinary SVG children are preview-only and are discarded during export. Formula rendering and editability in Keynote, WPS, LibreOffice, and other non-PowerPoint clients are not part of this contract. Ordinary export capabilities remain available as needed, including native chart/table replacement, notes, motion, narration, and diagnostics; notes, custom object animation, and narration start off, and the agent may enable them when the request or deck needs them. A default-path Quick export writes the normal postflight report and snapshots `svg_output/` to `backup/<timestamp>/svg_output/`; an explicit output path keeps the ordinary no-backup behavior. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both chart/table export variants are editable—the distinction is the PowerPoint object model, not editability itself.> **Already have a `.pptx` you want to reuse?** Hand the AI that deck plus your material and ask it to "fill this deck with the new content" — it fills text, table, and chart data into your existing design and exports only the pages you pick, staying natively editable. See the [FAQ](./docs/faq.md) and [template-fill workflow](./skills/ppt-master/workflows/template-fill-pptx.md).diff --git a/README_CN.md b/README_CN.mdindex 3ced9fe2..ba74f74c 100644--- a/README_CN.md+++ b/README_CN.md@@ -335,9 +335,9 @@ AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。你:用 projects/q3-report/sources/report.pdf 快速生成一份 5 页 PPT,不用跟我确认```-你明确提的照做,你没提的由 AI 直接定,不再回来问你。它仍会转换来源、补齐事实、应用共享视觉基线,并按需使用图片 / 图标 / 原生形状 / 图表 / 表格 / 公式——省掉的是交互与持久规划,不是 PPT 能力。它是不可续接的一次性生成,也不会产生 `svg_final/` 预览。完整说明 → [快速模式](./docs/zh/getting-started.md#快速模式)。+你明确提的照做,你没提的由 AI 直接定,不再回来问你。它仍会转换来源、补齐事实、应用共享视觉基线,并按需使用图片 / 图标 / 原生形状 / 图表 / 表格 / PowerPoint 原生块级公式——省掉的是交互与持久规划,不是 PPT 能力。它是不可续接的一次性生成,也不会产生 `svg_final/` 预览。完整说明 → [快速模式](./docs/zh/getting-started.md#快速模式)。-> **输出说明:** SVG 管线统一由项目转换器读取 `svg_output/`,生成可直接编辑的原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`。默认 Generate 流程会运行 `finalize_svg.py` 并生成自包含预览 `svg_final/`;PowerPoint 手工“转换为形状”不在支持范围。用户可显式启用[快速生成](./skills/ppt-master/workflows/profiles/quick-generate.md):它跳过 Strategist、确认、`design_spec.md`、`spec_lock.md` 与 `finalize_svg.py`——你明确提出的要求照做,你没提的由 Agent 在一次有效上下文中直接决定;仍按需转换来源、研究事实缺口、应用共享 mode / visual style / 美学规范、准备图片 / 图标 / 公式,并考虑原生形状与数据可视化,随后按规范手写 SVG,通过无锁的 Quick 最终质量检查,再导出最终 PPTX。它不写替代计划,上下文丢失后不能续接。原生图表 / 表格替换、讲稿、动效、旁白和诊断等普通导出能力仍可按需使用;讲稿、自定义对象动画和旁白默认关闭,Agent 可在用户要求或 deck 确有需要时启用。Quick 使用默认输出路径时仍会生成普通 postflight 报告,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;显式指定输出路径时沿用普通流程不创建备份的行为。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;可加 `--native-charts-and-tables`,把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。这两种图表/表格导出变体都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。+> **输出说明:** SVG 管线统一由项目转换器读取 `svg_output/`,生成可直接编辑的原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`。默认 Generate 流程会运行 `finalize_svg.py` 并生成自包含预览 `svg_final/`;PowerPoint 手工“转换为形状”不在支持范围。用户可显式启用[快速生成](./skills/ppt-master/workflows/profiles/quick-generate.md):它跳过 Strategist、确认、`design_spec.md`、`spec_lock.md` 与 `finalize_svg.py`——你明确提出的要求照做,你没提的由 Agent 在一次有效上下文中直接决定;仍按需转换来源、研究事实缺口、应用共享 mode / visual style / 美学规范、准备图片 / 图标,并把公式直接创作为原生块级公式 marker,同时考虑原生形状与数据可视化,随后按规范手写 SVG,通过无锁的 Quick 最终质量检查,再导出最终 PPTX。它不写替代计划,上下文丢失后不能续接。公式 marker 会把 LaTeX payload 编译为 PowerPoint 2010+ 可编辑 OMML;组内普通 SVG 子元素仅供预览,导出时会被丢弃。Keynote、WPS、LibreOffice 等非 PowerPoint 客户端的公式显示与编辑能力不在支持合同内。原生图表 / 表格替换、讲稿、动效、旁白和诊断等普通导出能力仍可按需使用;讲稿、自定义对象动画和旁白默认关闭,Agent 可在用户要求或 deck 确有需要时启用。Quick 使用默认输出路径时仍会生成普通 postflight 报告,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;显式指定输出路径时沿用普通流程不创建备份的行为。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;可加 `--native-charts-and-tables`,把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。这两种图表/表格导出变体都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。> **已有一份想复用的 `.pptx`?** 把那份 deck 连同素材给 AI,说「套模板」即可——它会把新内容(文字、表格、图表数据)填进你现有的设计,只导出你挑选的页面,且保持原生可编辑。详见 [常见问题](./docs/zh/faq.md) 与 [套模板工作流](./skills/ppt-master/workflows/template-fill-pptx.md)。diff --git a/docs/faq.md b/docs/faq.mdindex 3bf931ca..e0c96fd7 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -146,6 +146,18 @@ By default, charts are rendered as **custom-designed SVG graphics** converted toIf your workflow specifically requires Excel-driven data editing or PowerPoint's chart/table-specific controls, export with `--native-charts-and-tables`: supported data charts and pure text-grid tables then ship as **PowerPoint-native Chart / Table objects backed by data** (saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`, keeping the deck's own colors instead of PowerPoint's default theme). The default SVG fallback also becomes editable DrawingML shapes, but it has no chart data workbook or table/chart object model. Native objects may look slightly different across PowerPoint / Keynote / LibreOffice / WPS, so the shape-based route remains the visual-stability default.+## Q: Are formulas editable?++Yes, in PowerPoint. Formula-bearing SVG groups carry source LaTeX and export as+editable PowerPoint OMML block equations; they are not formula screenshots or+picture assets. Raw LaTeX does not render by itself in SVG, so the group also+contains ordinary SVG text/shapes for browser and live preview. Export discards+those preview children when it replaces the group with the native equation.++The native target is PowerPoint 2010+. Formula display and editability in+Keynote, WPS, LibreOffice, and other non-PowerPoint clients are not supported;+PPT Master does not add an image fallback for them.+## Q: Can I change page transitions and element animations?Yes. Page transitions are on by default (`fade` 0.4s); per-element object@@ -228,10 +240,11 @@ Quick creates no `svg_final/` preview.It does not skip preparation or design capability. Source conversion, researchon identified factual gaps, shared aesthetic references, and every resource thedeck needs still run when required: supplied or extracted images,-AI/web/sliced images, project icons, native shapes, charts/tables, rendered-formulas, and the required operational manifests or provenance records. If a-required asset is not ready, it still stops and asks you for it instead of-substituting unrelated material. After preparation, the current agent+AI/web/sliced images, project icons, native shapes, charts/tables, and the+required operational manifests or provenance records. Formulas are authored+directly as PowerPoint-native markers in the affected SVG, not prepared as+image assets. If a required asset is not ready, it still stops and asks you for+it instead of substituting unrelated material. After preparation, the current agenthand-authors `svg_output/` to the shared standards, runs the lockless Quickfinal quality checker, fixes every blocking error, and only then exports thefinal PPTX.diff --git a/docs/getting-started.md b/docs/getting-started.mdindex 6108ee01..b4895590 100644--- a/docs/getting-started.md+++ b/docs/getting-started.md@@ -90,7 +90,7 @@ A bare template name or style phrase is still only a design brief. Quick keepsits lockless flat export, so Layout / Deck prototypes guide the authored pagesbut do not compile into reusable native Master / Layout objects.-It does not skip capabilities: source conversion, research on identified factual gaps, shared aesthetic guidance, and image / icon / native-shape / chart / table / formula preparation and authoring still run as needed. If a required asset is missing, it still stops and asks you for it instead of substituting unrelated material.+It does not skip capabilities: source conversion, research on identified factual gaps, shared aesthetic guidance, image / icon preparation, and native-shape / chart / table authoring still run as needed. Structural formulas are authored directly as native PowerPoint markers rather than prepared as image assets. If a required asset is missing, it still stops and asks you for it instead of substituting unrelated material.Quick is a one-pass profile, not a shortened resumable workflow. It creates no Strategist record, `design_spec.md`, `spec_lock.md`, or substitute page plan; its content/design/resource decisions exist only in the active AI context. If that context is lost before delivery, start Quick again. Operational manifests, quality reports, postflight, and the cold Python audit log may remain, but they cannot reconstruct why the AI designed the deck that way. The profile reduces interaction and durable planning, not the available presentation toolbox or the intended quality bar.diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.mdindex 0c8e2aef..87ff0d98 100644--- a/docs/powerpoint-svg-mapping.md+++ b/docs/powerpoint-svg-mapping.md@@ -8,7 +8,7 @@This guide answers one question from the PowerPoint user's point of view: **for a PowerPoint feature, what project representation owns it, and what survives export or import?** PowerPoint semantics are therefore the primary index. SVG elements appear only as the implementation of a specific PowerPoint capability.-This is a public capability and import-behavior map, not a second generated-SVG syntax specification and not a promise to convert arbitrary SVG or arbitrary OOXML. The canonical generated-authoring contract is the authority set selected through [`shared-standards.md`](../skills/ppt-master/references/shared-standards.md); when generated syntax differs, the applicable module wins. PPTX import recovery modes and user-visible degradation belong to §11 here and to the [conversion command reference](../skills/ppt-master/scripts/docs/conversion.md), while the parser implementation remains the exact source of truth. A feature not listed here is not implicitly supported.+This is a public capability and import-behavior map, not a second generated-SVG syntax specification and not a promise to convert arbitrary SVG or arbitrary OOXML. The canonical generated-authoring contract is the authority set selected through [`shared-standards.md`](../skills/ppt-master/references/shared-standards.md); when generated syntax differs, the applicable module wins. PPTX import recovery modes and user-visible degradation belong to §12 here and to the [conversion command reference](../skills/ppt-master/scripts/docs/conversion.md), while the parser implementation remains the exact source of truth. A feature not listed here is not implicitly supported.The main route compiles **project-canonical SVG**, not general browser SVG:@@ -205,7 +205,21 @@ Imported chart groups classify their visible fallback with `data-pptx-fallback-kThe exhaustive chart/table schemas and supported family list intentionally remain in the [Native Data Interface replacement contract](../skills/ppt-master/references/native-data-interface.md#2-powerpoint-native-chart--table-replacement-markers-opt-in).-## 9. PowerPoint playback and package features+## 9. PowerPoint formulas++| PowerPoint feature | Project representation | PPTX result | Compatibility | Validation boundary |+|---|---|---|---|---|+| Editable block equation | One `<g data-pptx-replace-with="formula">` with explicit bounds, source LaTeX in `<metadata type="application/json">`, and visible SVG preview children | PowerPoint text shape containing `a14:m` plus editable OMML | PowerPoint 2010+ | Independent block formulas and the registered LaTeX subset only; unsupported input fails closed |+| Browser / live preview | Ordinary SVG text and shapes inside the marker group | Discarded when the complete group is replaced by the native equation | Raw LaTeX does not render in SVG | Preview children must express the same equation; they are not a PPTX fallback |+| Non-PowerPoint formula playback | The same native marker; no picture branch | No compatibility fallback is added | Keynote, WPS, LibreOffice, and other clients are outside the formula contract | Do not claim cross-client rendering or editability |++Formula replacement is always active and does not use+`--native-charts-and-tables`. It creates no `formula_manifest.json`, formula+PNG, media relationship, or `mc:Fallback` picture. The JSON LaTeX payload is the+native formula source; SVG children exist only so the authored page remains+visible in browsers before export.++## 10. PowerPoint playback and package featuresThese capabilities belong to PPTX package semantics. Their absence from page SVG is deliberate.@@ -232,19 +246,18 @@ media playback commands.See [Animations & Transitions](./animations.md) (technical source: [`references/animations.md`](../skills/ppt-master/references/animations.md)) and [`audio-narration.md`](./audio-narration.md) for the sidecar workflows.-## 10. Other PowerPoint-native features+## 11. Other PowerPoint-native features| PowerPoint feature | Main-route status | Supported alternative | Boundary ||---|---|---|---|| SmartArt / DiagramML | No native SVG compiler mapping | Reconstruct meaning with shapes, or preserve through a native/template route | A screenshot or fallback must be explicit || OLE or embedded Office object | Unsupported in the SVG route | Direct preservation or a rendered preview | Do not manufacture package relationships from SVG metadata |-| Native equation / OMML | Unsupported in the SVG route | Render a formula asset or preserve native OOXML directly | A rendered formula is a picture, not an editable equation || Video | Unsupported as an SVG-authored media object | Direct preservation or an explicit poster/link workflow outside this contract | A `media` placeholder does not create video || 3D model | Unsupported | Direct preservation or baked preview | No browser-SVG approximation is treated as native 3D || Macro / VBA | Unsupported | Preserve only through a macro-aware direct workflow | The normal generated `.pptx` route does not synthesize VBA || Arbitrary Office extension XML | Unsupported | Direct preservation by an owning native workflow | The SVG compiler has no generic OOXML passthrough |-## 11. Reverse mapping: PPTX to project SVG+## 12. Reverse mapping: PPTX to project SVGThe importer reconstructs supported PowerPoint semantics into the same project vocabulary used by export:@@ -276,7 +289,7 @@ This is semantic projection, not a syntax round trip. Preserving validated sourcEvery successful run writes `<output>/conversion-report.json`. The report records the mode, slide and warning counts, stable reason code, source message, chosen fallback, package part, and—when available—slide index plus shape id/name/kind. Tolerant import is therefore not silent: it maximizes usable output while making every contract recovery reviewable.-## 12. Validation ownership+## 13. Validation ownershipThe four layers have deliberately different jobs:@@ -289,7 +302,7 @@ The four layers have deliberately different jobs:A generated-SVG warning is not permission to guess. It is reserved for a deterministic supported mapping whose spelling or fidelity deserves attention. Missing mappings, invalid units, malformed metadata, broken structure contracts, and potentially repair-triggering generated DrawingML remain errors. Import diagnostics describe explicit loss or normalization of source-owned content; they never authorize the importer to invent unsupported semantics.-## 13. Adding or changing a mapping+## 14. Adding or changing a mappingTreat a mapping change as a compiler change, not as a permissive SVG parser tweak:diff --git a/docs/roadmap.md b/docs/roadmap.mdindex d2ade997..fb4d685d 100644--- a/docs/roadmap.md+++ b/docs/roadmap.md@@ -43,7 +43,7 @@ A presentation is four layers: what is on the slide, how it is arranged, how it| Charts | Systematized | Dedicated authoring reference; SVG by default, native Chart replacement available as an explicit opt-in || Tables | Systematized | Dedicated authoring reference; six cell-grid grammars, native Table replacement on the same opt-in || Diagrams | Systematized | Six relationship atoms — `order`, `link`, `parent`, `membership`, `contrast`, `overlap` |-| Formulas | Bounded by design | Rendered as image assets with `Acquire Via: formula`; never recreated as text. Natively editable formulas are signal-driven |+| Formulas | Implemented with a narrow target | Independent block formulas compile from a strict LaTeX subset to editable PowerPoint OMML; SVG children are preview-only and no formula image fallback is emitted. PowerPoint 2010+ is supported; non-PowerPoint clients are outside the contract || Audio & video | Covered / Signal-driven | Narration audio embeds per slide today; arbitrary video, background music, and media compression are planned modules in the Enhance route || SmartArt, 3D models, OLE objects | Signal-driven | No current authoring path |@@ -117,7 +117,7 @@ One line per month. Full detail lives in the [release notes](https://github.com/|---|---|| 2026-03 | **Native PPTX route takes shape** — the SVG → DrawingML chain becomes usable; chart/layout template indexes ship || 2026-04 | **Pipeline at scale** — topic-only generation, 70 chart templates + three icon libraries, the `spec_lock` cross-page consistency contract, per-element animation and narration/video export |-| 2026-05 | **Visual editing + AI-image systematization** — Live Preview with deterministic in-place editing (built on [@WodenJay](https://github.com/WodenJay)'s [PR #85](https://github.com/hugohe3/ppt-master/pull/85)), template workspaces from PPTX, the rendering × palette × type image system, LaTeX formula rendering |+| 2026-05 | **Visual editing + AI-image systematization** — Live Preview with deterministic in-place editing (built on [@WodenJay](https://github.com/WodenJay)'s [PR #85](https://github.com/hugohe3/ppt-master/pull/85)), template workspaces from PPTX, the rendering × palette × type image system, and the legacy raster LaTeX renderer || 2026-06 | **Mode & visual-style dual catalogs + intake expansion** — 5 narrative modes × 18 visual styles (+ `custom`), content-faithful beautify profile, multi-deck intake, spot-illustration pipeline, web-image quality gates, source-conversion fidelity gains (caption recognition from [@suay1113](https://github.com/suay1113)'s [PR #191](https://github.com/hugohe3/ppt-master/pull/191), hyperlink preservation distilled from [@ZhaoZuohong](https://github.com/ZhaoZuohong)'s [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) || 2026-07 | **Positioning charter + native masters & layouts + token efficiency** ([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0)) — three-pass staged confirmation UI, real `p:sldMaster` / `p:sldLayout` export, `--native-charts-and-tables` opt-in, motion-export hardening, chart template library compacted |diff --git a/docs/rules/prompt-style.md b/docs/rules/prompt-style.mdindex be60a772..875ed749 100644--- a/docs/rules/prompt-style.md+++ b/docs/rules/prompt-style.md@@ -117,7 +117,7 @@ not permit Executor to acquire visual resources.**Hard rule — default pipeline**: downstream freedom exists only in dimensions left open upstream, including fields explicitly labeled `suggestion` or Reference. A named binding outcome retains identity; a broad semantic request or expression recommendation permits in-class choice. Once the plan resolves a binding choice, execution cannot reopen or substitute it. For icons, library/stroke and the prepared-project boundary bind, while per-page choice within the prepared pool is realization. Executor never searches, generates, downloads, syncs, invents, or replaces a resource; missing material returns to Strategist-owned preparation or upstream repair.-**Explicit Quick Generate exception**: [`quick-generate`](../../skills/ppt-master/workflows/profiles/quick-generate.md) removes the separate Strategist/confirmation handoff. The current main agent therefore owns both its active-context decisions and the preparation of project-local sources, images, icons, formulas, and provenance before it begins SVG realization. This exception does not move acquisition into a default-pipeline Executor and does not permit resource reselection while a page is being realized. Explicit user facts, choices, exclusions, and permissions remain upstream authority; unspecified routine choices are resolved automatically without a confirmation stop.+**Explicit Quick Generate exception**: [`quick-generate`](../../skills/ppt-master/workflows/profiles/quick-generate.md) removes the separate Strategist/confirmation handoff. The current main agent therefore owns both its active-context decisions and the preparation of project-local sources, images, icons, and provenance before it begins SVG realization; native formulas are authored directly from exact mathematical content rather than acquired as resources. This exception does not move acquisition into a default-pipeline Executor and does not permit resource reselection while a page is being realized. Explicit user facts, choices, exclusions, and permissions remain upstream authority; unspecified routine choices are resolved automatically without a confirmation stop.> Mnemonic — restaurant contract: the customer supplies initial ingredients and the desired dish; Strategist plans the dish and prepares the complete mise en place; Executor cooks from that prepared inventory. “Mapo tofu” cannot become tomato-and-eggs or tofu soup, while “a tofu dish” leaves deliberate in-class freedom.diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 52efb1a7..be55bde1 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -132,7 +132,7 @@ the inputs or resources needed to build the deck:Source material or topic-> convert/read sources and research identified factual gaps as needed-> resolve mode/style and decide content, page structure, and carriers in active context- -> prepare selected images/icons/formulas and operational manifests+ -> prepare selected images/icons and operational manifests; retain formula LaTeX in active context-> hand-author svg_output/ under the shared SVG standards-> verify data-driven chart coordinates when present-> svg_quality_checker.py --quick-generate --stage final --json@@ -260,7 +260,7 @@ Quick Generate:source material or topic└─> conversion/read + factual-gap research [as needed]└─> active-context mode/style + content/page/carrier decisions- └─> images/ + icons/ + formula/resource manifests [as needed]+ └─> images/ + icons/ + resource manifests [as needed]└─> hand-authored svg_output/├─> verify-charts [only for data-driven chart geometry]└─> svg_quality_checker.py --quick-generate --stage final --json@@ -343,8 +343,9 @@ Two converter design choices still shape the system:other directories on demand. The explicit[`quick-generate`](../skills/ppt-master/workflows/profiles/quick-generate.md)profile omits planning artifacts and `svg_final/`, but its project may still-contain converted sources, analysis, images, icons, rendered formulas, and-required resource manifests. It hand-authors `svg_output/`, writes a lockless+contain converted sources, analysis, images, icons, and required resource+manifests. It hand-authors `svg_output/`, including any native formula markers,+writes a locklessfinal quality report, and retains the ordinary postflight and default-pathbackup around the final PPTX. The audit log and reports preserve tool outcomes,not the AI's design reasoning or a resumable stage state. The default delivery@@ -354,7 +355,7 @@ lifecycle is:|---|---|| `sources/` | archived originals, normalized Markdown, and converter companion files || `analysis/` | machine-extracted facts: PPTX intake bundles and regenerated image analysis |-| `images/` | single runtime image pool for user, extracted, formula, web, AI, sliced, EMF/WMF assets |+| `images/` | single runtime image pool for user, extracted, web, AI, sliced, and EMF/WMF assets || `icons/` | project-local icon set copied by `icon_sync.py`; global library fallback at export exists only for legacy compatibility || `templates/` | copied template specs / SVG references / non-image template assets || `svg_output/` | the only hand-authored SVG source directory |@@ -493,14 +494,22 @@ without interaction, while the Stage-1 communication recommendation is authoredwithout reading those candidates or any template content. The UI confirms thatcommunication contract and the switchable free-design/template choice together;only afterward does the agent install/fuse a non-free selection. Strategist uses-one dependency-ordered two-stage gate. Its `delivery_context` recommendation distinguishes presenter-led, reader-led, hybrid, and recorded/self-running use in one prose field, names the primary context, and records any secondary use; hybrid never stands alone without its lead mode. The prose boxes remain editable and none requires a non-empty answer: confirmation persists the current text exactly, and a cleared value stays empty instead of falling back to the recommendation. Final Stage 2 is authored once from that contract. Strategist first creates exactly three complete, viable, project-fit solutions, then projects each into a custom mode, custom visual style, color, typography, icon, and custom generated-image rendering; the fixed catalogs remain conservative lower-level single-select alternatives. It does not assemble the three solutions afterward from independent component picks or force them into safe / shifted / bold archetypes. After all three bundles are complete, it compares them against the confirmed contract and source, records the strongest overall fit as zero-based `design_directions.selected`, and gives array order no preference meaning. Before reference selection it reads only the three catalog indexes; after each solution's bases are frozen, it reads only the deduplicated selected detail files and completes the custom behaviors. Image source remains an independent judgment, so every solution already has a rendering candidate even when AI imagery is initially not recommended. The preferred top card is marked and applied initially. An inactive top card applies its immutable bundle, each projected custom card becomes editable in place after selection, and all lower controls may diverge; the adjusted active card exposes an explicit restore action, while final state stores only the edited current components. The same stage confirms reading mode, page count, conditional AI acquisition, formula policy, generation mode, the Design Spec review toggle, and whether the agent should proactively generate speaker notes, custom animations, or narration audio. Only after Stage 1 is confirmed, when a template is installed, does Strategist read the project-local workspace and current content, derive **how to apply it**, and expose that plan as editable `template_application` prose; Stage 2 never reselects a template, and the internal reuse/adherence modes stay hidden. Reading mode decides how meaning is carried by page, visuals, presenter, and notes; its cards do not present px values. The browser may apply the deterministic `reading mode → body baseline → unpinned role sizes` dependency locally, while manual size edits pin visible values. It never regenerates Stage 2. The three proactive values are fallback policies, not capability bans: the latest explicit user instruction wins, then final Stage 2, then the fixed defaults `true / false / false`. Strategist still records non-binding Motion suggestions when useful; a suggestion alone does not activate custom-animation execution. Generated images inherit the selected deck color anchors directly; there is no independent image-palette choice. Final state has two equivalent carriers: the default UI path reads `confirm_ui/result.json` exactly once after the final wait, while an explicit chat-only or delegated path retains an equivalent final confirmation summary and may produce no `result.json`. Both paths first resolve and persist every effective production outcome into one `design_spec.md` and complete Gate 1 fidelity. With refinement off, lock authoring proceeds immediately. With `refine_spec: true`, the pipeline stops before `spec_lock.md`; the user may revise any part of that same Design Spec through normal chat for any number of rounds, and explicit approval then releases Gate 2 lock authoring. No second Design Spec or parallel lock is maintained. Normal lock authoring and downstream execution do not reread either confirmation channel. Required manual assets may still introduce their own conditional blocking points, so this is not an exclusive claim over every runtime gate. Project validation requires the compact `audience` / `objective` / `core_message` anchor set under `spec_lock.md ## communication` plus an `Audience move` in every §IX Slide block.+one dependency-ordered two-stage gate. Its `delivery_context` recommendation distinguishes presenter-led, reader-led, hybrid, and recorded/self-running use in one prose field, names the primary context, and records any secondary use; hybrid never stands alone without its lead mode. The prose boxes remain editable and none requires a non-empty answer: confirmation persists the current text exactly, and a cleared value stays empty instead of falling back to the recommendation. Final Stage 2 is authored once from that contract. Strategist first creates exactly three complete, viable, project-fit solutions, then projects each into a custom mode, custom visual style, color, typography, icon, and custom generated-image rendering; the fixed catalogs remain conservative lower-level single-select alternatives. It does not assemble the three solutions afterward from independent component picks or force them into safe / shifted / bold archetypes. After all three bundles are complete, it compares them against the confirmed contract and source, records the strongest overall fit as zero-based `design_directions.selected`, and gives array order no preference meaning. Before reference selection it reads only the three catalog indexes; after each solution's bases are frozen, it reads only the deduplicated selected detail files and completes the custom behaviors. Image source remains an independent judgment, so every solution already has a rendering candidate even when AI imagery is initially not recommended. The preferred top card is marked and applied initially. An inactive top card applies its immutable bundle, each projected custom card becomes editable in place after selection, and all lower controls may diverge; the adjusted active card exposes an explicit restore action, while final state stores only the edited current components. The same stage confirms reading mode, page count, conditional AI acquisition, generation mode, the Design Spec review toggle, and whether the agent should proactively generate speaker notes, custom animations, or narration audio. Formula handling is not a user-selectable production policy: structural mathematics becomes a native formula marker during authoring. Only after Stage 1 is confirmed, when a template is installed, does Strategist read the project-local workspace and current content, derive **how to apply it**, and expose that plan as editable `template_application` prose; Stage 2 never reselects a template, and the internal reuse/adherence modes stay hidden. Reading mode decides how meaning is carried by page, visuals, presenter, and notes; its cards do not present px values. The browser may apply the deterministic `reading mode → body baseline → unpinned role sizes` dependency locally, while manual size edits pin visible values. It never regenerates Stage 2. The three proactive values are fallback policies, not capability bans: the latest explicit user instruction wins, then final Stage 2, then the fixed defaults `true / false / false`. Strategist still records non-binding Motion suggestions when useful; a suggestion alone does not activate custom-animation execution. Generated images inherit the selected deck color anchors directly; there is no independent image-palette choice. Final state has two equivalent carriers: the default UI path reads `confirm_ui/result.json` exactly once after the final wait, while an explicit chat-only or delegated path retains an equivalent final confirmation summary and may produce no `result.json`. Both paths first resolve and persist every effective production outcome into one `design_spec.md` and complete Gate 1 fidelity. With refinement off, lock authoring proceeds immediately. With `refine_spec: true`, the pipeline stops before `spec_lock.md`; the user may revise any part of that same Design Spec through normal chat for any number of rounds, and explicit approval then releases Gate 2 lock authoring. No second Design Spec or parallel lock is maintained. Normal lock authoring and downstream execution do not reread either confirmation channel. Required manual assets may still introduce their own conditional blocking points, so this is not an exclusive claim over every runtime gate. Project validation requires the compact `audience` / `objective` / `core_message` anchor set under `spec_lock.md ## communication` plus an `Audience move` in every §IX Slide block.The three proactive values confirmed in final Stage 2 remain independent rawevidence. In particular, enabling narration may enable the effective SpeakerNotes outcome in the Design Spec, but it never rewrites the raw speaker-noteschoice.-**Image analysis is metadata-first, with a narrow visual fallback.** When images exist, `analyze_images.py` supplies the regenerated measured facts in `analysis/image_analysis.csv`; the CSV is a view over the live `images/` folder, not a durable cache. In the default pipeline, Strategist first resolves supplied images from source placement and nearby prose, captions / alt text / titles, filenames, user notes, existing resource records, and that metadata. It may inspect one specific image only when a material ambiguity remains about selection, factual identity, page role, crop safety, or focal placement—never as a bulk inventory scan. The answer is written into Design Spec §VIII, after which Executor uses the plan and measured geometry without reopening source pixels for semantic discovery. In `quick-generate`, the current agent applies the same bounded analysis while preparing the selected resources from active-context decisions; no Design Spec projection or general resource roster is written. Image to PPTX's normalized page frames are the narrow exception: every frame is inspected once to build source evidence and identify ordinary text, identity or decorative graphics, charts/tables/data graphics, scene regions, and overlap. Later reads stay page/region-local while the current Codex agent prepares registered clean-base and subject/foreground assets through the existing reference-image path. Low-resolution logos, icons, and decorative graphics may be reconstructed only with identity, silhouette, proportions, colors, and wordmarks locked where applicable. Charts, tables, and data graphics cannot use generative reconstruction; they require native objects with verifiable values, exact source assets, or `manual_required`. Multiple non-overlapping objects with padded bounding boxes may share one generation plate before grid slicing or SVG bounding-box cropping creates independent objects. User images, extracted images, web images, AI outputs, formulas, and sliced elements still converge into the same measured fact table.+**Image analysis is metadata-first, with a narrow visual fallback.** When images exist, `analyze_images.py` supplies the regenerated measured facts in `analysis/image_analysis.csv`; the CSV is a view over the live `images/` folder, not a durable cache. In the default pipeline, Strategist first resolves supplied images from source placement and nearby prose, captions / alt text / titles, filenames, user notes, existing resource records, and that metadata. It may inspect one specific image only when a material ambiguity remains about selection, factual identity, page role, crop safety, or focal placement—never as a bulk inventory scan. The answer is written into Design Spec §VIII, after which Executor uses the plan and measured geometry without reopening source pixels for semantic discovery. In `quick-generate`, the current agent applies the same bounded analysis while preparing the selected resources from active-context decisions; no Design Spec projection or general resource roster is written. Image to PPTX's normalized page frames are the narrow exception: every frame is inspected once to build source evidence and identify ordinary text, identity or decorative graphics, charts/tables/data graphics, scene regions, and overlap. Later reads stay page/region-local while the current Codex agent prepares registered clean-base and subject/foreground assets through the existing reference-image path. Low-resolution logos, icons, and decorative graphics may be reconstructed only with identity, silhouette, proportions, colors, and wordmarks locked where applicable. Charts, tables, and data graphics cannot use generative reconstruction; they require native objects with verifiable values, exact source assets, or `manual_required`. Multiple non-overlapping objects with padded bounding boxes may share one generation plate before grid slicing or SVG bounding-box cropping creates independent objects. User images, extracted images, web images, AI outputs, and sliced elements still converge into the same measured fact table.++**Native formulas are authored page objects, not image resources.** The SVG+group stores source LaTeX in a `data-pptx-replace-with="formula"` marker and+contains ordinary SVG text/shapes so browser preview remains visible; raw LaTeX+itself does not render in SVG. Native export discards those children and writes+editable OMML in a PowerPoint text shape. The current contract is independent+block formulas for PowerPoint 2010+ only, with no formula PNG, media+relationship, or image fallback for non-PowerPoint clients.**Retained planning context** carries continuity; the on-demand page projector is only a diagnostic described below.@@ -563,9 +572,9 @@ automatically selects the content, page roster, mode, visual style, and resourceneeds in active context; scans images, icons, qualitative Structure, nativeshapes, charts/tables, formulas, and simple typography/geometry as availablecarriers; prepares the-selected supplied/extracted/AI/web/sliced images, icons, and formulas with their-required operational manifests or provenance records; and then hand-authors-SVG. It does not invoke Strategist, Confirm UI, `design_spec.md`,+selected supplied/extracted/AI/web/sliced images and icons with their required+operational manifests or provenance records; and then hand-authors SVG plus any+native formula markers. It does not invoke Strategist, Confirm UI, `design_spec.md`,`spec_lock.md`, or a substitute planning artifact. These decisions are notrecoverable after context loss.One agent may therefore perform several creative stages in sequence, but their@@ -608,7 +617,7 @@ Several architectural decisions shape this phase:## Image-Text Composition: P / M / A / C-Whenever the image/formula branch is active, its compact placement vocabulary in [`references/image-layout-patterns.md`](../skills/ppt-master/references/image-layout-patterns.md) is read alongside the layout math. Its current patterns are organized by composition responsibility:+Whenever the image branch is active, its compact placement vocabulary in [`references/image-layout-patterns.md`](../skills/ppt-master/references/image-layout-patterns.md) is read alongside the layout math. Native formulas use ordinary page composition plus their marker bounds, not image-resource patterns. The current image patterns are organized by composition responsibility:- **P · Primary Structures** — single-visual, image-as-canvas, and multi-visual page skeletons.- **M · Modifier Layers** — crop/reveal, tone/focus, and framing/placement/depth treatments applied to an existing skeleton.diff --git a/docs/why-ppt-master.md b/docs/why-ppt-master.mdindex 0129baaa..3bdc228e 100644--- a/docs/why-ppt-master.md+++ b/docs/why-ppt-master.md@@ -23,13 +23,14 @@ Editable is already table stakes — exporting each slide as an editable `.pptx`- **Slide masters & layouts** — real `p:sldMaster` / `p:sldLayout` structure with inheritance (on template / structured routes), not the same chrome pasted onto every page- **Native shapes** — preset geometry with working adjustment handles (block arrows, chevrons, callouts, flowchart nodes…), connectors, and freeform paths, not just rectangles- **Native charts & tables, on demand** — data-backed chart and table objects with an Edit-Data workbook when you want them (trade-off note below)+- **Native block equations** — a strict LaTeX subset compiles to editable PowerPoint OMML instead of a formula picture- **The full text, picture, fill, and effect model** — run/paragraph formatting, picture crop and shape-clip, gradients, patterns, outer shadow, glow- **Transitions, entrance / emphasis / path / exit animation, and speaker notes → voice narration** — real OOXML timing and package parts, not baked-in video- **Template distillation on top** — hand it reference material and it extracts a reusable brand / style / layout / deck template; a layer of reuse built *above* the native primitivesAnd this depth is a **direction of travel, not a fixed list.** The project's north star is to keep converging with PowerPoint itself — an ongoing effort to build and integrate more of its native capabilities, release after release, narrowing the gap between what an AI can generate for you and what you could build by hand in PowerPoint.-So the boundary is honest, and it moves. Some things are out of scope today — **SmartArt** (a closed, brittle object model, deliberately left out and better rebuilt from ordinary native shapes), a few decorative effects (WordArt, reflection, soft edges), and embedded or legacy objects (OLE, video, macros, native equations). What's in and what's out is never hand-waved: the exact, feature-by-feature boundary — native / approximate / bake-required / unsupported — is published in the [PowerPoint ↔ SVG Mapping Guide](./powerpoint-svg-mapping.md).+So the boundary is honest, and it moves. Some things are out of scope today — **SmartArt** (a closed, brittle object model, deliberately left out and better rebuilt from ordinary native shapes), a few decorative effects (WordArt, reflection, soft edges), and embedded or legacy objects (OLE, video, macros). Native equations currently mean independent block formulas targeting PowerPoint 2010+; cross-client formula rendering and editability are not promised. What's in and what's out is never hand-waved: the exact, feature-by-feature boundary — native / approximate / bake-required / unsupported — is published in the [PowerPoint ↔ SVG Mapping Guide](./powerpoint-svg-mapping.md).And out of scope rarely means *can't* — more often it means *not yet* (the timing isn't right) or *not worth it* (for a niche effect, a quick manual tweak in PowerPoint beats the engineering cost). That call is easy to make precisely because PPT Master's output is a high-quality **draft you keep editing, not a sealed final deck** — the last mile is yours by design.diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex bf9293a0..2d4f7fdd 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -148,6 +148,17 @@ PPT Master 本身免费开源,唯一的成本来自你自己的 AI 模型用如果你的工作流明确需要 Excel 驱动的数据编辑或 PowerPoint 的图表/表格专属控制,导出时加 `--native-charts-and-tables`:受支持的数据图表和纯文本表格会以**带数据源的 PowerPoint 原生 Chart / Table 对象**形式导出(保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`,并保留这份 deck 自己的配色,而不是套用 PowerPoint 默认主题)。默认 SVG fallback 同样会转换成可编辑 DrawingML shape,但不具备图表数据工作簿或图表/表格对象模型。原生对象在 PowerPoint / Keynote / LibreOffice / WPS 间可能略有差异,因此形状路线仍是视觉稳定性的默认选择。+## Q: 公式可以编辑吗?++可以,但支持目标是 PowerPoint。含公式的 SVG 组会携带源 LaTeX,并在导出时+转换为可编辑的 PowerPoint OMML 块级公式,而不是公式截图或图片资源。原始+LaTeX 不能直接在 SVG 中显示,因此该组还会包含普通 SVG 文字 / 形状,供浏览器+和实时预览使用;导出器用原生公式替换整个组时会丢弃这些预览子元素。++原生目标为 PowerPoint 2010+。Keynote、WPS、LibreOffice 等非 PowerPoint+客户端中的公式显示与编辑能力不在支持范围内;PPT Master 不为这些客户端附加+公式图片兜底。+## Q: 页面切换和元素动画可以调吗?可以。页间转场默认开(`fade` 0.4s),页内元素对象动画**默认关**——翻到@@ -216,7 +227,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-t**它跳过的是策略师分析、`design_spec.md` / `spec_lock.md` 落盘和分步确认停顿:你明确提出的要求照做;你没提的,当前 Agent 直接决定并继续,不再回来征求同意。** 什么都不提,才是全部由 Agent 决定。它同时跳过 `finalize_svg.py`,因此不生成 `svg_final/` 预览。-它不跳过备料或设计能力:来源转换、已识别事实缺口的研究、共享美学参考,以及生成 deck 所需的资源仍按需准备——用户提供或源文件抽取的图片、AI / 网络 / 切片图片、项目图标、原生形状、图表 / 表格、渲染公式,以及对应的必要运行 manifest 或来源记录。必需素材未就绪时它仍会停下来跟你要,不会拿无关材料顶替。备料完成后,当前 Agent 按共享规范手写 `svg_output/`,运行无锁的 Quick 最终质量检查并修复所有阻塞错误,之后才导出最终 PPTX。+它不跳过备料或设计能力:来源转换、已识别事实缺口的研究、共享美学参考,以及生成 deck 所需的资源仍按需准备——用户提供或源文件抽取的图片、AI / 网络 / 切片图片、项目图标、原生形状、图表 / 表格,以及对应的必要运行 manifest 或来源记录。公式由当前 Agent 直接写成受影响 SVG 中的 PowerPoint 原生 marker,不再作为图片资源准备。必需素材未就绪时它仍会停下来跟你要,不会拿无关材料顶替。备料完成后,当前 Agent 按共享规范手写 `svg_output/`,运行无锁的 Quick 最终质量检查并修复所有阻塞错误,之后才导出最终 PPTX。原生图表 / 表格替换、讲稿、动效、旁白和诊断等普通导出能力仍可按需使用;讲稿、自定义对象动画和旁白默认关闭,Agent 可在用户要求或 deck 确有需要时自动启用,不会打开确认流程。使用默认输出路径时会生成普通 postflight 报告,并把 `svg_output/` 备份到 `backup/`;显式指定输出路径时沿用普通流程不创建备份的行为。页数本身既不会自动触发,也不会阻止快速生成。diff --git a/docs/zh/getting-started.md b/docs/zh/getting-started.mdindex cc00d4d9..4529abdd 100644--- a/docs/zh/getting-started.md+++ b/docs/zh/getting-started.md@@ -89,7 +89,7 @@ Brand / Style / Layout / Deck 工作区 root,它会直接校验、安装并使Quick 保持无锁 flat 导出,因此 Layout / Deck 原型会指导页面创作,但不会编译成可复用的原生 Master / Layout 对象。-它不跳过能力:来源转换、事实缺口研究、共享美学规范,以及图片 / 图标 / 原生形状 / 图表 / 表格 / 公式的准备和创作仍按需运行。必需素材缺失时它会停下来跟你要,不会拿无关材料顶替。+它不跳过能力:来源转换、事实缺口研究、共享美学规范、图片 / 图标准备,以及原生形状 / 图表 / 表格创作仍按需运行。结构性公式直接写成 PowerPoint 原生 marker,不再作为图片素材准备。必需素材缺失时它会停下来跟你要,不会拿无关材料顶替。快速模式是一次性生成,不是缩短后的可续接流程。它不产生 Strategist 记录、`design_spec.md`、`spec_lock.md` 或替代性的页面计划;内容、设计和资源决策只存在于 AI 的当前上下文。交付前一旦丢失该上下文,就重新运行 Quick。资源 manifest、质量报告、postflight 与冷 Python 审计日志可以保留,但无法还原 AI 为什么这样设计。该 profile 省掉的是交互和持久规划,不是 PPT 能力或预期质量标准。diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.mdindex 2834a2bb..d00075f8 100644--- a/docs/zh/powerpoint-svg-mapping.md+++ b/docs/zh/powerpoint-svg-mapping.md@@ -8,7 +8,7 @@本指南从 PowerPoint 使用者的视角回答一个问题:**对于某项 PowerPoint 功能,项目中由什么表达承载,导出或回导时能保留什么?** 因此,PowerPoint 语义是唯一主索引,SVG 元素只作为某项 PowerPoint 能力的具体实现出现。-这是一份公开的能力与导入行为映射表,不是第二份生成 SVG 语法规范,也不承诺转换任意 SVG 或任意 OOXML。规范生成合同由 [`shared-standards.md`](../../skills/ppt-master/references/shared-standards.md) 路由到拆分权威集;生成语法出现差异时,以适用模块为准。PPTX 导入的容错模式与用户可见降级由本文 §11 和[转换命令文档](../../skills/ppt-master/scripts/docs/conversion.md)负责,精确 parser 行为仍以实现代码为真值。本指南未列出的功能不会因此被默认为受支持。+这是一份公开的能力与导入行为映射表,不是第二份生成 SVG 语法规范,也不承诺转换任意 SVG 或任意 OOXML。规范生成合同由 [`shared-standards.md`](../../skills/ppt-master/references/shared-standards.md) 路由到拆分权威集;生成语法出现差异时,以适用模块为准。PPTX 导入的容错模式与用户可见降级由本文 §12 和[转换命令文档](../../skills/ppt-master/scripts/docs/conversion.md)负责,精确 parser 行为仍以实现代码为真值。本指南未列出的功能不会因此被默认为受支持。主路线编译的是**项目规范化 SVG**,而不是通用浏览器 SVG:@@ -199,7 +199,20 @@ PowerPoint 原生 Chart/Table 对象是可选功能。默认导出保留 SVG fal完整图表/表格 schema 和受支持 family 列表有意仅保留在[原生数据接口替换合同](../../skills/ppt-master/references/native-data-interface.md#2-powerpoint-native-chart--table-replacement-markers-opt-in)中。-## 9. PowerPoint 播放与打包功能+## 9. PowerPoint 公式++| PowerPoint 功能 | 项目表达 | PPTX 结果 | 兼容性 | 校验边界 |+|---|---|---|---|---|+| 可编辑块级公式 | 一个带显式边界、在 `<metadata type="application/json">` 中保存源 LaTeX、并含可见 SVG 预览子元素的 `<g data-pptx-replace-with="formula">` | 含 `a14:m` 与可编辑 OMML 的 PowerPoint 文本 shape | PowerPoint 2010+ | 仅支持独立块级公式和已登记 LaTeX 子集;不支持的输入直接失败 |+| 浏览器 / 实时预览 | marker 组内的普通 SVG 文字与形状 | 整组被原生公式替换时丢弃 | 原始 LaTeX 不能直接在 SVG 中渲染 | 预览子元素必须表达同一公式;它们不是 PPTX 兜底 |+| 非 PowerPoint 客户端播放 | 同一个原生 marker;没有图片分支 | 不附加兼容兜底 | Keynote、WPS、LibreOffice 等客户端不在公式合同内 | 不宣称跨客户端显示或编辑能力 |++公式替换始终启用,不使用 `--native-charts-and-tables`。该路径不会创建+`formula_manifest.json`、公式 PNG、media relationship 或作为图片的+`mc:Fallback`。JSON 中的 LaTeX payload 是原生公式源;SVG 子元素只负责让+导出前的作者页面可以在浏览器中看见。++## 10. PowerPoint 播放与打包功能这些能力属于 PPTX 包语义。它们不出现在页面 SVG 中是有意设计。@@ -223,19 +236,18 @@ PowerPoint 原生 Chart/Table 对象是可选功能。默认导出保留 SVG falsidecar 工作流见[转场与动画](./animations.md)(技术规范源为 [`references/animations.md`](../../skills/ppt-master/references/animations.md))与 [`audio-narration.md`](./audio-narration.md)。-## 10. 其他 PowerPoint 原生功能+## 11. 其他 PowerPoint 原生功能| PowerPoint 功能 | 主路线状态 | 受支持的替代方案 | 边界 ||---|---|---|---|| SmartArt / DiagramML | 无原生 SVG 编译器映射 | 使用 shape 重建语义,或通过原生/模板路线保留 | 截图或 fallback 必须是显式的 || OLE 或嵌入 Office 对象 | SVG 路线不支持 | 直接保留或渲染 preview | 不得通过 SVG metadata 制造包 relationship |-| 原生公式 / OMML | SVG 路线不支持 | 渲染公式资产或直接保留原生 OOXML | 渲染公式是图片,不是可编辑公式 || 视频 | 不支持作为 SVG 创作媒体对象 | 直接保留,或本合同之外的显式封面/链接工作流 | `media` 占位符不创建视频 || 3D 模型 | 不支持 | 直接保留或烘焙 preview | 不将浏览器 SVG 近似当作原生 3D || 宏 / VBA | 不支持 | 仅通过感知宏的直接工作流保留 | 普通生成 `.pptx` 路线不生成 VBA || 任意 Office 扩展 XML | 不支持 | 由拥有该语义的原生工作流直接保留 | SVG 编译器不提供通用 OOXML 透传 |-## 11. 反向映射:PPTX 到项目 SVG+## 12. 反向映射:PPTX 到项目 SVG导入器将受支持的 PowerPoint 语义重建为与导出相同的项目词汇:@@ -267,7 +279,7 @@ sidecar 工作流见[转场与动画](./animations.md)(技术规范源为 [`re每次成功转换都会写入 `<output>/conversion-report.json`。报告记录运行模式、Slide 与 warning 数量、稳定原因码、源错误消息、采用的 fallback、包 part,以及可用时的 Slide 序号和 shape id/name/kind。因此,容错导入不是静默吞错:它尽可能保留可用输出,同时让每一次合同降级都可复核。-## 12. 校验职责+## 13. 校验职责四层有意承担不同职责:@@ -280,7 +292,7 @@ sidecar 工作流见[转场与动画](./animations.md)(技术规范源为 [`re生成 SVG 的 warning 不是猜测许可。它只适用于拥有唯一结果的受支持映射,但其拼法或保真度值得注意的情况。缺失映射、非法单位、格式错误 metadata、破损的结构合同,以及可能触发 PowerPoint 修复的生成 DrawingML 仍是 error。导入诊断描述对源内容的显式丢失或规范化,绝不授权导入器虚构不支持的语义。-## 13. 新增或修改映射+## 14. 新增或修改映射应将映射变更视为编译器变更,而不是宽松 SVG parser 调整:diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.mdindex 0559045c..4fdee27c 100644--- a/docs/zh/roadmap.md+++ b/docs/zh/roadmap.md@@ -43,7 +43,7 @@| 图表 | 系统化 | 有专属创作 reference;默认 SVG,原生 Chart 替换为显式 opt-in || 表格 | 系统化 | 有专属创作 reference;六种单元格网格语法,原生 Table 替换走同一 opt-in || 关系图 | 系统化 | 六个关系原子——`order`、`link`、`parent`、`membership`、`contrast`、`overlap` |-| 公式 | 有意边界 | 以 `Acquire Via: formula` 渲染为图片资源,绝不还原成文字;原生可编辑公式属信号驱动 |+| 公式 | 窄范围已实现 | 独立块级公式可从严格 LaTeX 子集编译为可编辑 PowerPoint OMML;SVG 子元素仅供预览,不生成公式图片兜底。支持 PowerPoint 2010+,非 PowerPoint 客户端不在合同内 || 音视频 | 已覆盖 / 信号驱动 | 旁白音频今天逐页嵌入;任意视频、背景音乐与媒体压缩是 Enhance 路线中的 planned 模块 || SmartArt、3D 模型、OLE 对象 | 信号驱动 | 目前没有创作路径 |@@ -117,7 +117,7 @@|---|---|| 2026-03 | **原生 PPTX 路线成形** — SVG → DrawingML 链路可用;图表 / 版式模板索引上线 || 2026-04 | **管线规模化** — 仅凭主题生成、70 个图表模板 + 三套图标库、`spec_lock` 跨页一致性契约、逐元素动画与旁白 / 视频导出 |-| 2026-05 | **可视化编辑 + AI 图片体系化** — Live Preview 确定性原位编辑(基于 [@WodenJay](https://github.com/WodenJay) 的 [PR #85](https://github.com/hugohe3/ppt-master/pull/85))、从 PPTX 创建模板工作区、rendering × palette × type 图片体系、LaTeX 公式渲染 |+| 2026-05 | **可视化编辑 + AI 图片体系化** — Live Preview 确定性原位编辑(基于 [@WodenJay](https://github.com/WodenJay) 的 [PR #85](https://github.com/hugohe3/ppt-master/pull/85))、从 PPTX 创建模板工作区、rendering × palette × type 图片体系、旧版栅格 LaTeX 渲染器 || 2026-06 | **mode 与 visual-style 双 catalog + intake 扩展** — 5 种叙事 mode × 18 种视觉风格(+ `custom`)、内容忠实的美化 profile、多 deck 合并 intake、插画切片管线、网络图片质量闸门、源转换保真提升(图注识别基于 [@suay1113](https://github.com/suay1113) 的 [PR #191](https://github.com/hugohe3/ppt-master/pull/191),超链接保留提炼自 [@ZhaoZuohong](https://github.com/ZhaoZuohong) 的 [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) || 2026-07 | **定位章程 + 原生母版 / 版式 + token 效率**([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0))— 三段式分步确认 UI、真 `p:sldMaster` / `p:sldLayout` 导出、`--native-charts-and-tables` opt-in、动效导出加固、图表模板库压缩 |diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex e84c870e..e7121e4e 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -104,7 +104,7 @@ PPT Master 不以“任意 SVG 都能转成 PPTX”为目标。`svg_output/` 使来源材料或主题-> 按需转换 / 阅读来源,并研究已识别的事实缺口-> 在当前上下文解析 mode / style,并决定内容、页结构和载体- -> 准备实际选中的图片 / 图标 / 公式与操作 manifest+ -> 准备实际选中的图片 / 图标与操作 manifest;公式 LaTeX 保留在当前上下文-> 按共享 SVG 规范手写 svg_output/-> 存在数据驱动图表时校准坐标-> svg_quality_checker.py --quick-generate --stage final --json@@ -220,7 +220,7 @@ Quick Generate:来源材料或主题└─> 转换 / 阅读 + 事实缺口研究 [按需]└─> 当前上下文中的 mode / style + 内容 / 页结构 / 载体决策- └─> images/ + icons/ + 公式 / 资源 manifest [按需]+ └─> images/ + icons/ + 资源 manifest [按需]└─> 手写 svg_output/├─> verify-charts [仅数据驱动图表几何]└─> svg_quality_checker.py --quick-generate --stage final --json@@ -303,7 +303,7 @@ SVG 也是唯一同时满足流程中所有角色需要的格式:**AI 能可显式[`quick-generate`](../../skills/ppt-master/workflows/profiles/quick-generate.md)profile 省略规划产物与 `svg_final/`,但项目中仍可按需存在已转换来源、分析结果、-图片、图标、渲染公式及必要资源 manifest;它会手写 `svg_output/`,生成无锁最终+图片、图标及必要资源 manifest;它会手写 `svg_output/` 及其中的原生公式 marker,生成无锁最终质量报告,并围绕最终 PPTX 保留普通 postflight 与默认路径备份。审计日志和报告只保留工具结果,不记录 AI 的设计理由,也不构成可续接的阶段状态。默认交付生命周期如下:@@ -311,7 +311,7 @@ profile 省略规划产物与 `svg_final/`,但项目中仍可按需存在已|---|---|| `sources/` | 原件归档、归一化 Markdown、转换器伴随文件 || `analysis/` | 机器抽取事实:PPTX intake bundle 与按需重算的图片分析 |-| `images/` | 单一运行时图片池:用户图、抽取图、公式图、网络图、AI 图、切片图、EMF/WMF |+| `images/` | 单一运行时图片池:用户图、抽取图、网络图、AI 图、切片图、EMF/WMF || `icons/` | 由 `icon_sync.py` 复制的项目级图标集;导出时的全局库回退仅用于 legacy compatibility || `templates/` | 复制进项目的模板 spec / SVG reference / 非图片模板资产 || `svg_output/` | 唯一手写 SVG 源目录 |@@ -418,13 +418,20 @@ PPT Master 把拥有 deck 状态的 Strategist、Image_Generator 和 Executor**模板选择与沟通契约在 Stage 1 同时确认。** Step 3 只在内部准备候选;Stage-1 沟通推荐的编写不得读取这些候选或任何模板内容。UI 在同一次提交中确认沟通契约与可切换的自由设计/使用模板选择;只有确认后,Agent 才安装或-合成非自由设计选择。Strategist 采用一个按依赖排序的两阶段 gate。`delivery_context` 在同一个开放文本字段中区分演讲者主导、读者主导、混合、录制/自动播放,明确主要场景并记录可选的次要用途;混合场景不能只写“混合”而不说明由哪一种主导。其中的文本框仍承载可编辑推荐,且没有任何一项要求非空:确认时按当前文本原样保存,清空后的值保持为空,不会回退到推荐内容。最终 Stage 2 只从该契约计算一次,同时确认完整 PPT 方案与生产机制:阅读模式、叙事 mode、页数、成套视觉系统、图片来源、生成图渲染、条件式 AI 图片获取路径、公式策略、生成模式、Design Spec 审核开关,以及 Agent 是否主动生成讲稿、自定义动画和旁白音频。仅在 Stage 1 确认后,存在已安装模板时,Strategist 才读取项目本地工作区和当前内容,推导**如何应用**并以可编辑的 `template_application` 自然语言展示;Stage 2 不会重新选模板,内部复用/遵循模式保持隐藏。阅读模式决定信息由页面、视觉、讲者和备注如何共同承担,其选项卡不展示 px 数值。浏览器可以在本地执行确定性的「阅读模式 → 正文基准 → 未锁定角色字号」联动;手动编辑字号即锁定可见值,不会重新计算 Stage 2。三个主动执行值是用户未明确要求时的兜底策略,不是能力禁用开关;优先级固定为「用户最新明确指令 → 最终 Stage 2 → `true / false / false` 默认值」。Strategist 仍可按内容给出非绑定的 Motion suggestion,建议本身不会启动自定义动画执行。生成图直接继承已选 PPT 色彩锚点,不再单设图片调色选择。最终状态有两个等价载体:默认 UI 路径在最终等待返回后只读取一次 `confirm_ui/result.json`;显式 chat-only 或委托路径保留等价的最终确认摘要,并可不产生 `result.json`。两条路径都会先解析并把生产流程的最终有效结果固化到同一份 `design_spec.md`,再完成 Gate 1 fidelity。未开启 refine 时立即进入 lock 编写;`refine_spec: true` 时,流程会在 `spec_lock.md` 之前暂停,用户可以通过正常聊天任意修改这同一份 Design Spec、迭代任意轮次,明确批准后才释放 Gate 2 并编写 lock。流程不会维护第二份 Design Spec 或并行 lock。正常的 lock 编写与下游执行不再回读确认通道。必需人工素材未就绪仍可能引入条件式阻塞点,因此这里不是对所有 runtime gate 的排他声明。项目校验要求 `spec_lock.md ## communication` 下存在紧凑的 `audience` / `objective` / `core_message` 锚点,并要求 §IX 每个 Slide block 都有 `Audience move`。+合成非自由设计选择。Strategist 采用一个按依赖排序的两阶段 gate。`delivery_context` 在同一个开放文本字段中区分演讲者主导、读者主导、混合、录制/自动播放,明确主要场景并记录可选的次要用途;混合场景不能只写“混合”而不说明由哪一种主导。其中的文本框仍承载可编辑推荐,且没有任何一项要求非空:确认时按当前文本原样保存,清空后的值保持为空,不会回退到推荐内容。最终 Stage 2 只从该契约计算一次,同时确认完整 PPT 方案与生产机制:阅读模式、叙事 mode、页数、成套视觉系统、图片来源、生成图渲染、条件式 AI 图片获取路径、生成模式、Design Spec 审核开关,以及 Agent 是否主动生成讲稿、自定义动画和旁白音频。公式处理不是用户选择的生产策略:结构性数学内容在创作时直接成为原生公式 marker。仅在 Stage 1 确认后,存在已安装模板时,Strategist 才读取项目本地工作区和当前内容,推导**如何应用**并以可编辑的 `template_application` 自然语言展示;Stage 2 不会重新选模板,内部复用/遵循模式保持隐藏。阅读模式决定信息由页面、视觉、讲者和备注如何共同承担,其选项卡不展示 px 数值。浏览器可以在本地执行确定性的「阅读模式 → 正文基准 → 未锁定角色字号」联动;手动编辑字号即锁定可见值,不会重新计算 Stage 2。三个主动执行值是用户未明确要求时的兜底策略,不是能力禁用开关;优先级固定为「用户最新明确指令 → 最终 Stage 2 → `true / false / false` 默认值」。Strategist 仍可按内容给出非绑定的 Motion suggestion,建议本身不会启动自定义动画执行。生成图直接继承已选 PPT 色彩锚点,不再单设图片调色选择。最终状态有两个等价载体:默认 UI 路径在最终等待返回后只读取一次 `confirm_ui/result.json`;显式 chat-only 或委托路径保留等价的最终确认摘要,并可不产生 `result.json`。两条路径都会先解析并把生产流程的最终有效结果固化到同一份 `design_spec.md`,再完成 Gate 1 fidelity。未开启 refine 时立即进入 lock 编写;`refine_spec: true` 时,流程会在 `spec_lock.md` 之前暂停,用户可以通过正常聊天任意修改这同一份 Design Spec、迭代任意轮次,明确批准后才释放 Gate 2 并编写 lock。流程不会维护第二份 Design Spec 或并行 lock。正常的 lock 编写与下游执行不再回读确认通道。必需人工素材未就绪仍可能引入条件式阻塞点,因此这里不是对所有 runtime gate 的排他声明。项目校验要求 `spec_lock.md ## communication` 下存在紧凑的 `audience` / `objective` / `core_message` 锚点,并要求 §IX 每个 Slide block 都有 `Audience move`。最终 Stage 2 确认的三个主动执行值始终保留为相互独立的原始证据。尤其是,启用旁白可以在 Design Spec 中启用 Speaker Notes 的最终有效结果,但绝不会改写原始的备注选择。-**图片分析以重算元数据为先,只保留小范围视觉兜底。** 当项目里存在图片时,`analyze_images.py` 把可度量事实重算到 `analysis/image_analysis.csv`;该 CSV 是实时 `images/` 目录的派生视图,不是持久缓存。默认流程中,Strategist 先根据图片在源文中的位置与前后文、图注 / alt / 标题、文件名、用户说明、已有资源记录和这些元数据判断。只有当某一张具体图片在选用、事实身份、页面角色、裁剪安全或焦点放置上仍有实质歧义时,才可单独查看它,绝不得扫描整个图片目录。结论写入 Design Spec §VIII 后,Executor 只消费该计划与几何数据,不会重新打开源图进行语义探索。`quick-generate` 则由当前 Agent 根据当前上下文决策准备实际选中的资源,并采用同样的有界分析;不写 Design Spec 投影或通用资源清单。图片还原为 PPTX 的规范页面画面是窄例外:每个画面会完整检查一次,以建立源证据并区分普通文字、身份 / 装饰图形、chart / table / data graphic、场景图片与遮挡关系。之后只重开当前页 / 当前区域,并由当前 Codex Agent 通过现有参考图路径准备注册的干净背景层与人物 / 前景层。低清 Logo、图标和装饰只能在锁定身份、轮廓、比例、颜色和字标的前提下参考重建。Chart、table 和 data graphic 禁止生成式重建,必须使用可核对数值的原生对象、精确源资产,或标记 `manual_required`。多个带 padding 包围盒且互不重叠的对象可共用一次生成 plate,再通过 grid slice 或 SVG bbox crop 拆成独立对象。用户图、抽取图、网络图、AI 图、公式图和切片图仍统一汇入同一张可度量事实表。+**图片分析以重算元数据为先,只保留小范围视觉兜底。** 当项目里存在图片时,`analyze_images.py` 把可度量事实重算到 `analysis/image_analysis.csv`;该 CSV 是实时 `images/` 目录的派生视图,不是持久缓存。默认流程中,Strategist 先根据图片在源文中的位置与前后文、图注 / alt / 标题、文件名、用户说明、已有资源记录和这些元数据判断。只有当某一张具体图片在选用、事实身份、页面角色、裁剪安全或焦点放置上仍有实质歧义时,才可单独查看它,绝不得扫描整个图片目录。结论写入 Design Spec §VIII 后,Executor 只消费该计划与几何数据,不会重新打开源图进行语义探索。`quick-generate` 则由当前 Agent 根据当前上下文决策准备实际选中的资源,并采用同样的有界分析;不写 Design Spec 投影或通用资源清单。图片还原为 PPTX 的规范页面画面是窄例外:每个画面会完整检查一次,以建立源证据并区分普通文字、身份 / 装饰图形、chart / table / data graphic、场景图片与遮挡关系。之后只重开当前页 / 当前区域,并由当前 Codex Agent 通过现有参考图路径准备注册的干净背景层与人物 / 前景层。低清 Logo、图标和装饰只能在锁定身份、轮廓、比例、颜色和字标的前提下参考重建。Chart、table 和 data graphic 禁止生成式重建,必须使用可核对数值的原生对象、精确源资产,或标记 `manual_required`。多个带 padding 包围盒且互不重叠的对象可共用一次生成 plate,再通过 grid slice 或 SVG bbox crop 拆成独立对象。用户图、抽取图、网络图、AI 图和切片图仍统一汇入同一张可度量事实表。++**原生公式是页面创作对象,不是图片资源。** SVG group 在+`data-pptx-replace-with="formula"` marker 中保存源 LaTeX,并包含普通 SVG+文字 / 形状,让浏览器预览保持可见;原始 LaTeX 本身不能在 SVG 中显示。原生+导出会丢弃这些子元素,并在 PowerPoint 文本 shape 中写入可编辑 OMML。当前+合同仅支持面向 PowerPoint 2010+ 的独立块级公式,不生成公式 PNG、media+relationship,也不为非 PowerPoint 客户端提供图片兜底。**保留的规划上下文**负责跨页连续性;按需逐页投影只承担下文所述的诊断用途。@@ -479,7 +486,7 @@ Generate 路由会在加载流程前选定一份运行时权威:[`workflows/ge| 打包员 | `svg_to_pptx.py` | 匹配的 final 报告通过后,编译已创作 SVG、校验 package 并发布回执;不修 SVG,不重跑 Checker || 运行记录员 | `workflow_transcript.py`、`workflow_log.py` 与 `validation/workflow.log` | 记录 Python 命令信封、重要标记结果、有限状态样本和省略计数,并接收显式选定的重要非 Python 事项;不决定流程是否可以前进 |-**快速生成把规划职责合并到当前 Agent。** 来源转换、事实缺口研究和资源准备仍按需运行。当前 Agent 在上下文中自动选择内容、页面清单、mode、visual style 和资源需求;把图片、图标、定性 Structure、原生形状、图表 / 表格、公式与纯字体 / 几何作为完整载体菜单进行一次判断;准备实际选中的用户提供 / 来源抽取 / AI / 网络 / 切片图片、图标和公式及其必要操作 manifest 或来源记录,随后手写 SVG;不进入 Strategist、Confirm UI、`design_spec.md`、`spec_lock.md`,也不创建替代规划产物。这些决策在上下文丢失后无法恢复。+**快速生成把规划职责合并到当前 Agent。** 来源转换、事实缺口研究和资源准备仍按需运行。当前 Agent 在上下文中自动选择内容、页面清单、mode、visual style 和资源需求;把图片、图标、定性 Structure、原生形状、图表 / 表格、公式与纯字体 / 几何作为完整载体菜单进行一次判断;准备实际选中的用户提供 / 来源抽取 / AI / 网络 / 切片图片、图标及其必要操作 manifest 或来源记录,随后手写 SVG 与所需原生公式 marker;不进入 Strategist、Confirm UI、`design_spec.md`、`spec_lock.md`,也不创建替代规划产物。这些决策在上下文丢失后无法恢复。因此同一 Agent 可以顺序承担多个创作阶段,但阶段权责不会合并;Checker、Exporter 与运行记录器仍是独立的确定性工具。**默认备料有两个时点。** Topic Research 在最终确认前补充规划所需的事实:只有主题时立即运行;已有材料时先转换 / 阅读,仅在仍有关键事实缺口时补齐,而且不获取任何图片。当前 AI 编辑器若能提供具备网页检索 / 抓取能力并可写入声明输出路径的隔离研究子代理,由主代理定义缺口,子代理写入现有研究及来源产物并只返回回执;否则研究仍在主上下文运行。AI / web / slice 图片只能在最终确认以及完整的 `design_spec.md §VIII` / `spec_lock.md` 之后获取,并在 Executor 开始前进入终态。Strategist 还会在编写最终方案时解析、同步并验证精选项目图标池。Image_Generator、Image_Searcher 与图标同步工具只是 Strategist 负责的备料机制,不是独立决策者。快速生成则由当前 Agent 根据上下文决策按需使用这些备料机制,不插入确认门禁。@@ -518,7 +525,7 @@ Generate 路由会在加载流程前选定一份运行时权威:[`workflows/ge## 图文构图:P / M / A / C-只要图片 / 公式分支被触发,就会把 [`references/image-layout-patterns.md`](../../skills/ppt-master/references/image-layout-patterns.md) 的精简版式词汇与布局计算规范一起读入。当前模式按构图责任组织:+只要图片分支被触发,就会把 [`references/image-layout-patterns.md`](../../skills/ppt-master/references/image-layout-patterns.md) 的精简版式词汇与布局计算规范一起读入。原生公式使用普通页面构图及 marker 自身边界,不走图片资源 pattern。当前图片模式按构图责任组织:- **P · Primary Structures** —— 单图、图作画布与多图系统构成页面骨架。- **M · Modifier Layers** —— 在既有骨架上加入裁切 / 揭示、色调 / 焦点或框饰 / 摆放 / 层次处理。diff --git a/docs/zh/why-ppt-master.md b/docs/zh/why-ppt-master.mdindex 549542f9..d1ca8a09 100644--- a/docs/zh/why-ppt-master.md+++ b/docs/zh/why-ppt-master.md@@ -23,13 +23,14 @@- **母版与版式** —— 真正的 `p:sldMaster` / `p:sldLayout` 继承结构(走模板 / 结构化路线),而不是把同一套页面框架贴到每一页- **原生形状** —— 带可用调节手柄的预设几何(箭头、V 形、标注、流程节点……)、连接线、自由路径,而不只是矩形- **按需的原生图表与表格** —— 需要时就是带「编辑数据」工作簿的数据驱动图表 / 表格对象(取舍见下)+- **原生块级公式** —— 将严格 LaTeX 子集编译为可编辑 PowerPoint OMML,而不是公式图片- **完整的文本 / 图片 / 填充 / 效果模型** —— 段落与文本级格式、图片裁剪与形状裁切、渐变、图案、外阴影、发光- **转场、进入 / 强调 / 动作路径 / 退出动画、演讲者备注 → 语音旁白** —— 都是真正的 OOXML 计时与包内部件,不是烤进去的视频- **在这之上的模板提炼** —— 把参考材料交给它,它能提炼出可复用的 brand / style / layout / deck 模板;这是建立在原生原语**之上**的一层复用能力而这份深度是**一个前进方向,不是一张固定清单。** 项目的北极星是持续向 PowerPoint 本身靠拢——不断开发、集成更多它的原生能力,一个版本接一个版本,缩小「AI 能替你生成的」和「你在 PowerPoint 里手工能做出的」之间的差距。-所以边界是诚实的,而且它在移动。有些能力今天还不在范围内——**SmartArt**(一个封闭、脆弱的对象模型,被刻意排除,其含义更适合用普通原生形状重建)、少数装饰性效果(艺术字、反射、柔化边缘)、以及嵌入 / 遗留对象(OLE、视频、宏、原生公式)。哪些在内、哪些在外从不含糊:逐条的功能对照边界——原生 / 近似 / 需烘焙 / 不支持——都公开在 [PowerPoint ↔ SVG 映射指南](./powerpoint-svg-mapping.md) 里。+所以边界是诚实的,而且它在移动。有些能力今天还不在范围内——**SmartArt**(一个封闭、脆弱的对象模型,被刻意排除,其含义更适合用普通原生形状重建)、少数装饰性效果(艺术字、反射、柔化边缘)、以及嵌入 / 遗留对象(OLE、视频、宏)。当前原生公式专指面向 PowerPoint 2010+ 的独立块级公式,不承诺跨客户端公式显示与编辑。哪些在内、哪些在外从不含糊:逐条的功能对照边界——原生 / 近似 / 需烘焙 / 不支持——都公开在 [PowerPoint ↔ SVG 映射指南](./powerpoint-svg-mapping.md) 里。而且「不在范围内」很少等于「做不到」——更多时候是「时机未到」,或者「性价比不划算」(一个小众效果,去 PowerPoint 里手动改一下,比为它做工程更值)。这个取舍之所以好做,正因为 PPT Master 的产出是一份高质量的**草稿、供你继续修改,而不是封死的成品**——最后一公里本就交给你。diff --git a/skills/ppt-master/references/artifact-ownership.md b/skills/ppt-master/references/artifact-ownership.mdindex 7a65d1b4..a478d2a5 100644--- a/skills/ppt-master/references/artifact-ownership.md+++ b/skills/ppt-master/references/artifact-ownership.md@@ -7,10 +7,11 @@ profile may explicitly omit an artifact without erasing its facts.**Quick Generate projection**: Quick omits confirmation, Design Spec, and lock.Its current main agent reads source/analysis facts, keeps routine decisions in-active context, and prepares the selected images/icons/formulas plus required-operational manifests before SVG authoring. It may also realize charts, tables,-native shapes, and other ordinary authoring capabilities directly from that-context. Exact template workspace roots supplied for the run are validated and+active context, and prepares the selected images/icons plus required+operational manifests before SVG authoring. It realizes native formulas directly+from exact mathematical content under [`native-formula.md`](./native-formula.md),+and may also realize charts, tables, native shapes, and other ordinary authoring+capabilities directly from that context. Exact template workspace roots supplied for the run are validated andinstalled directly; Quick reads only that project-local state and creates noConfirm UI selection artifacts. Those artifacts retain their factual/provenanceroles. Quick writes the same final SVG quality provenance and package postflight@@ -38,8 +39,8 @@ history, or resumable planning state. Context loss restarts the Quick run.| `spec_lock.md` | Execution anchor and routing contract | Machine-readable stable color/type roles, icons, images, page rhythm, charts, `template_reuse_scope`, and the route's PowerPoint structure mode; mirror/layout template routes additionally own input prototypes, the Master roster, and the complete page-to-Master/Layout mapping | Strategist authors the route-specific anchors from the audited Design Spec plus current project/page/template context. Executor retains the complete lock once per valid execution context; local uncertainty consults that retained copy before the owning Design Spec fragment. Sparse page-local color/font garnish needs no lock row; a recurring semantic role or new adaptive Layout identity requires Strategist repair before reuse. || `project_manager.py page-context` stdout | Derived on-demand page context | Read-only model-facing anchor set + current-page delta + fingerprints for large references | Use only for explicit diagnostics/telemetry or an unresolved page/template/chart path-SHA projection. Never edit or persist it as a replacement source of truth, and never run it as a routine pre-page gate. `global` is a bounded anchor set, not a whitelist. `reference_set` carries path/SHA/load policy but never appends reference payloads. || `analysis/page-context/P<NN>.usage.json` | Derived optional context telemetry | Measured on-demand page-context size plus hashes of owning inputs/references | `page-context --record-usage` deterministically replaces only the invoked page's snapshot; `page-context-report` summarizes existing snapshots. Telemetry may be partial. Use token data to evaluate context cost, never as content or an execution contract. |-| `images/` | Runtime image pool | User, extracted, AI, web, formula, slice, EMF/WMF assets | Default Step 5 or Quick Generate resource preparation writes here; `analysis/image_analysis.csv` derives from current contents |-| `images/image_prompts.json`, `image_queries.json`, `image_sources.json`, `formula_manifest.json` | Conditional resource contracts | AI/web/formula execution status and provenance | Create only for a triggered path, including Quick. They guide preparation/attribution, never page design. |+| `images/` | Runtime image pool | User, extracted, AI, web, slice, and EMF/WMF assets | Default Step 5 or Quick Generate resource preparation writes here; `analysis/image_analysis.csv` derives from current contents |+| `images/image_prompts.json`, `image_queries.json`, `image_sources.json` | Conditional resource contracts | AI/web execution status and provenance | Create only for a triggered path, including Quick. They guide preparation/attribution, never page design. || `icons/` | Prepared project icon pool | Bundled icons copied by `icon_sync.py` plus user-provided, template, imported, or custom icon SVGs | SVG authoring may choose any icon in this project-local pool per page; `spec_lock.icons.inventory` indexes the default plan's curated synced bundled pool rather than assigning page usage or defining an exhaustive whitelist. Exporter global fallback is legacy compatibility only. || `${SKILL_DIR}/templates/{brands,styles,layouts,decks}/*_index.json` | Library discovery indexes | The complete registered option source for Default Stage-1 template selection and chat listing | The UI server or chat branch reads these indexes only to populate the Stage-1 choice, after the communication recommendation is authored. Never scan kind directories to add options or use index summaries as Stage-1 planning evidence. Derive a library root from kind + entry id. Exact unregistered roots remain explicit inputs. Quick does not read the catalog. || `templates/` | Project template reference | Stage-1-confirmed non-free selection or Quick direct-input installed specs, one file per selected workspace, optional Layout/Deck SVG prototypes, and non-image assets | Default template-aware Strategist work from Stage 2 onward, Quick's current agent before direct authoring, and every later role read this project-local state only, never the library/external installation root. The active planner reads every installed template Design Spec and an actual SVG roster only for Layout/Deck; Brand and Style are intentionally roster-free. Continuous Executor reuses that context; fresh Executor reads the Design Spec once and each selected complete SVG, when any, only before first use or after its SHA changes. |@@ -54,7 +55,7 @@ history, or resumable planning state. Context loss restarts the Quick run.| `confirm_ui/template_options.json`, `template_selection.json`, `template_handoff.json` | Default UI template-selection sidecar | Agent-authored candidate input, user-confirmed selection written beside the Stage-1 result, and agent-authored installation/free-design completion handoff | Step 3 writes options without launching UI. The Stage-1 submission writes `template_selection.json` alongside `result.json`; template choices never enter the Strategist contract. After installation/free-design closure, `--complete-template-selection` writes the bound handoff. Stage 2 is exposed only after that handoff and a fresh recommendation. Chat/delegated flows retain equivalent state without fabricating UI receipts; Quick creates none. || `confirm_ui/recommendations.stage1.json`, `.stage2.json` | Confirmation proposals | Template-independent communication contract, then template-aware complete solution plus production mechanics | Author the Stage-1 communication recommendation without using candidate indexes or workspaces as evidence; candidate display state may be prepared independently. Its page confirms communication plus template mode/selection in one submission. Create Stage 2 only after the selection is installed or free design closes and the handoff/equivalent state is ready. `template_application` decides only how to use installed project-local state. The active unconfirmed stage may be overwritten; normal progression leaves confirmed Stage 1 intact. || `confirm_ui/result.json` | Confirmation result | Persisted user-confirmed input evidence | Generate Step 4 reads the final object once into active context; Strategist consumes it completely into `design_spec.md`. Normal downstream work does not reopen it; fresh recovery may read it once when no retained final state exists. |-| `svg_output/` | Page-design author source | Main-agent handwritten SVG pages containing the complete visible design | Quality checker and native PPTX export read this as the canonical visual/page-layout source; templates and locks do not add missing visible objects at export |+| `svg_output/` | Page-design author source | Main-agent handwritten SVG pages containing the complete visible design, including each native formula's exact LaTeX marker and ordinary SVG preview | Quality checker and native PPTX export read this as the canonical visual/page-layout source; templates and locks do not add missing visible objects at export. Formula export replaces only its explicit marker subtree under [`native-formula.md`](./native-formula.md). || `notes/total.md` | Conditional speaker-note source | Complete notes before splitting | Step 6 writes only when the effective Speaker Notes outcome is enabled; Step 7.1 splits || `notes/slide_*.md` | Conditional split notes | Per-slide notes generated from `total.md` | Derived by `total_md_split.py` only when speaker notes are enabled || `svg_final/` | Default-only derived visual preview | Self-contained post-processed SVGs that may be opened directly or inserted as SVG pictures | Default rebuilds it from `svg_output/` with `finalize_svg.py`; Quick omits it. Never use it as a supported PPTX source. |diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 9fab0d03..1a40fc65 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -12,7 +12,8 @@ Always-loaded Executor authority for flat SVG page authoring and behavior shared| The mandatory per-page Structure decision finds qualitative geometry | [`executor-structure.md`](./executor-structure.md) || Any semantic cell grid, including a table-family reference | [`executor-table.md`](./executor-table.md) || A page will use a preset pattern fill or an independent object is explicitly selected as native-ready | [`native-data-interface.md`](./native-data-interface.md) before emitting the pattern or replacement metadata |-| Any image/formula | [`executor-image.md`](./executor-image.md) + [`image-layout-spec.md`](./image-layout-spec.md) + [`image-layout-patterns.md`](./image-layout-patterns.md) + [`svg-image-embedding.md`](./svg-image-embedding.md) |+| Any image | [`executor-image.md`](./executor-image.md) + [`image-layout-spec.md`](./image-layout-spec.md) + [`image-layout-patterns.md`](./image-layout-patterns.md) + [`svg-image-embedding.md`](./svg-image-embedding.md) |+| Any structural standalone mathematical expression | [`native-formula.md`](./native-formula.md) before authoring its marker || Any placed image is `Status: Sourced` or its filename has an `image_sources.json` record | [`executor-web-image.md`](./executor-web-image.md), after `executor-image.md` || Effective Speaker Notes outcome is enabled after all SVG pages pass | [`executor-notes.md`](./executor-notes.md) |@@ -20,7 +21,7 @@ Evaluate branches from each object's actual information model, not only from a C> Narrative skeleton and visual aesthetic come from the locked values routed through the [`modes/`](./modes/_index.md) and [`visual-styles/`](./visual-styles/_index.md) indexes. Executor reads one locked preset file or only the exact `*_references` of a custom synthesis; an unreferenced novel custom reads none. [`shared-standards-core.md`](./shared-standards-core.md) supplies the technical boundary plus the fallback visual-quality and leading defaults when those authorities are silent.-**Hard rule — Shape-first page authority**: Every visible object intended for the exported slide MUST exist in the final page SVG or be explicitly referenced by it. Templates and `spec_lock.md` guide construction; they are not export-time overlays for missing visible content. Optional native Chart/Table metadata belongs to an independently selected object and never replaces this visible fallback during authoring; [`native-data-interface.md`](./native-data-interface.md) alone defines that metadata and its export activation.+**Hard rule — Shape-first page authority**: Every visible object intended for the exported slide MUST exist in the final page SVG or be explicitly referenced by it. Templates and `spec_lock.md` guide construction; they are not export-time overlays for missing visible content. Optional native Chart/Table metadata belongs to an independently selected object and never replaces this visible fallback during authoring; [`native-data-interface.md`](./native-data-interface.md) alone defines that metadata and its export activation. Native formulas still require an ordinary SVG preview inside the explicit marker; export replaces only that subtree under [`native-formula.md`](./native-formula.md).**Hard rule — flat PowerPoint structure**: Free-design, brand-only, Style-only, and every `template_reuse_scope: style` project use `pptx_structure.mode: flat`: write no root Master/Layout identity, `data-pptx-layer`, or `data-pptx-placeholder`; every visible object remains Slide-local, and the root declares exactly one canonical `data-pptx-page-role` (`cover` / `toc` / `section` / `content` / `ending`). A Style workspace supplies reusable communication/design direction, composition rhythm, and information-expression defaults without page prototypes. Its identity-adjacent color, typography, icon, and image defaults yield to the final Brand/Deck identity and confirmed project lock. When a Style is installed alongside Layout/Deck, it changes only Direction / method and follows the resolved non-Style structure route. Export materializes one clean project-owned Master plus one Blank Layout from the current lock. Add `data-pptx-role` only to structural page-frame objects whose package, page-number, or animation behavior is not already expressed by specialized metadata; the marked element uses a stable unique `id`. See [`semantic-svg.md`](./semantic-svg.md).@@ -115,7 +116,7 @@ Apply the content-vs-expression contract above within the selected reading mode.- **Sparse display-size exception**: a short non-structural Hero/Display element may use one undeclared size outside all anchor bands at most twice across the deck without a lock row. The third occurrence makes that size recurring: stop and return to Strategist to name the role in the Design Spec and `spec_lock.md`, then read back and validate the affected fragments before reuse. This exception never applies to titles, body copy, subtitles, annotations, footnotes, captions, data labels, or card copy, and nearby sizes must not be introduced to imitate one recurring treatment.- **Outside-band recovery**: for structural text, reflow geometry and use the declared role band locally. For a sparse display occurrence, keep the unitless value and verify that its deck-wide count remains at most two. Never flatten a justified distinction or add a role merely to silence the checker. Mirror pages preserve exact source typography as inherited input.- Images MUST reference files listed under `images`; no invented filenames-- Formula PNGs are images with `Acquire Via: formula`; place a `Rendered` file only from its listed path, use the normal placeholder for `Needs-Manual`, and never recreate the formula as text.+- Keep short inline notation as editable text. For structural block mathematics, load [`native-formula.md`](./native-formula.md), then author exact LaTeX metadata, the marker, and its SVG preview; this is not image acquisition.Return upstream before any derived/accent identity becomes recurring or structural, or when an undeclared display size reaches its third occurrence, then update the retained context under §2.1. Local garnish, same-role `±2`px adjustments, and at most two sparse display-size occurrences need no lock row. Never expand the lock to silence a comparison. New icon acquisition, images, structural fonts, role anchors, and resources keep their preparation/role rules.@@ -298,7 +299,7 @@ test -f "<project_path>/icons/<lib>/<name>.svg"## 5. Font Usage-Read typography from `spec_lock.md`: `<role>_family` → `title_family` / `body_family` → legacy `font_family`; sparse accents follow §2.1 and LaTeX stays PNG.+Read typography from `spec_lock.md`: `<role>_family` → `title_family` / `body_family` → legacy `font_family`; sparse accents follow §2.1. A native formula's SVG preview follows the page treatment, while the exported Office Math object uses its marker style under [`native-formula.md`](./native-formula.md).**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>`.diff --git a/skills/ppt-master/references/executor-image.md b/skills/ppt-master/references/executor-image.mdindex bad57955..0c600054 100644--- a/skills/ppt-master/references/executor-image.md+++ b/skills/ppt-master/references/executor-image.md@@ -4,9 +4,9 @@# Executor Image Branch-Conditional Executor authority for image status handling, placement, crop behavior, formula images, and template-bundled images.+Conditional Executor authority for image status handling, placement, crop behavior, and template-bundled images.-**Trigger**: load for any image/formula in §VIII, the lock, Quick Generate's active-context resource decisions, or a selected template.+**Trigger**: load for any image in §VIII, the lock, Quick Generate's active-context resource decisions, or a selected template.## 1. Image Handling@@ -19,7 +19,6 @@ Handle images by status; enum and lifecycle: [`svg-image-embedding.md`](svg-imag| **Existing** | User-provided | Reference images directly from `../images/` directory || **Generated** | Generated by Image_Generator | Reference from `../images/`; manifest-backed files load [`executor-web-image.md`](./executor-web-image.md) || **Sourced** | Web-acquired by Image_Searcher | Reference from `../images/`. **Read [`image_sources.json`](image-searcher.md) to decide attribution** — load [`executor-web-image.md`](./executor-web-image.md). |-| **Rendered** | Deterministic formula PNG | Reference from `../images/`; use a legal anchor with `meet` (centered default: `xMidYMid meet`) || **Needs-Manual** | Acquisition or suitability remains unresolved | Default uses a placeholder until Step 7. Quick blocks every required row in this status; file presence alone does not bypass it. || **Placeholder** | Not yet prepared | Use dashed border placeholder |@@ -38,8 +37,8 @@ must-use, crop/content, and explicit user/template constraints; expression-onlychanges need no upstream rewrite.**Mandatory — per-page image composition decision**: Using this already-loaded-branch, decide once immediately before geometry on every page containing a-non-formula image and keep the result only in active context:+branch, decide once immediately before geometry on every page containing an+image and keep the result only in active context:`role → direction generator → parent contour → slots/rhythm → crop →image-shape action → labels/overlays → depth/continuity`. Derive the relationshipfrom the communication job, hierarchy, copy, asset ratio/focus, and deck rhythm;@@ -92,5 +91,3 @@ positions and heights must change the source-unit `x`, `y`, `width`, and`height` by the same union-relative mapping, so the gaps remove pixels withoutrescaling the scene. A compound clip on one `<image>` is pattern `#M1-10`, not asubstitute when the objects must remain independently editable or Morphable.--**Formula images — declared-inference fallback for a missing `no-crop` flag**: rows with `Acquire Via: formula` or `Type: Latex Formula` MUST be treated as no-crop. For a rendered file, use dimensions in this order: current `analysis/image_analysis.csv`, `design_spec.md §VIII`, then `images/formula_manifest.json`. For a `Needs-Manual` row, size the dashed placeholder from the planned dimensions in §VIII, then the manifest; the readiness gate re-analyzes the supplied file and reconciles the container before export. Do not normalize all formulas to one height unless the spec explicitly states that layout choice.diff --git a/skills/ppt-master/references/image-base.md b/skills/ppt-master/references/image-base.mdindex ae15b0f3..264bff83 100644--- a/skills/ppt-master/references/image-base.md+++ b/skills/ppt-master/references/image-base.md@@ -8,7 +8,7 @@ Shared baseline for both acquisition paths. Path-specific behavior lives in the## 1. Trigger Condition-Active when at least one resource row has `Acquire Via: ai` / `web` / `slice`, or when any §VIII / Quick active-context resource is a pending prepared derivative. Canonical rows with `user` / `formula` / `placeholder` are tracked but skipped by acquisition roles.+Active when at least one resource row has `Acquire Via: ai` / `web` / `slice`, or when any §VIII / Quick active-context resource is a pending prepared derivative. Canonical rows with `user` / `placeholder` are tracked but skipped by acquisition roles.| Mode | Trigger ||---|---|@@ -28,7 +28,7 @@ Default Generate uses Strategist-owned `design_spec.md §VIII` plus its lock pro**Required per non-skipped row**: `Acquire Via` and `Status`. `Reference` is required for every `web` / `slice` row, every newly authored `ai` row, and every prepared derivative regardless of source class. An existing `ai` row whose `Reference` is omitted or blank may continue only through the declared inference in [`image-generator.md`](./image-generator.md) §8; no other path may infer it.-**Quick Generate ownership**: explicit user assets, URLs, and path instructions win. Otherwise the main agent chooses required `user` / `ai` / `web` / `slice` / `formula` rows and AI path `auto`, without interaction.+**Quick Generate ownership**: explicit user assets, URLs, and path instructions win. Otherwise the main agent chooses required `user` / `ai` / `web` / `slice` rows and AI path `auto`, without interaction.**Mandatory — consume the resolved path**: Default consumes Strategist-chosen §VIII rows; Quick resolves once in active context before preparation. This phase never adds or reselects a treatment:@@ -57,7 +57,7 @@ Choosing `none` is valid. Never bake a native treatment into a derivative.## 3. Path Dispatch-Classify `Reference: Derived from <canonical bare filename>; treatment=<operation>; ...` before `Acquire Via`. Its distinct, non-derived parent must be `user`, `web`, `ai`, or `slice`; reject formula/placeholder parents, chains, cycles, and self-reference. For each Pending row:+Classify `Reference: Derived from <canonical bare filename>; treatment=<operation>; ...` before `Acquire Via`. Its distinct, non-derived parent must be `user`, `web`, `ai`, or `slice`; reject placeholder parents, chains, cycles, and self-reference. For each Pending row:| Row kind / Acquire Via | Load reference | Run | Success status ||---|---|---|---|@@ -67,7 +67,6 @@ Classify `Reference: Derived from <canonical bare filename>; treatment=<operatio| `web` | [`image-searcher.md`](./image-searcher.md) | `image_search.py` | `Sourced` || `slice` | [`image-generator.md`](./image-generator.md) §4.3 | `slice_images.py` after parent AI sheet is `Generated` | `Generated` || `user` | — | — | (already `Existing`) |-| `formula` | — | — | (already `Rendered`) || `placeholder` | — | — | (already `Placeholder`) |> Lazy load: an all-`web` deck never reads `image-generator.md`, and vice versa.@@ -78,7 +77,7 @@ Classify `Reference: Derived from <canonical bare filename>; treatment=<operatio1. Read the Default Design Spec/lock, or reuse Quick's active-context resource/page decisions.2. Separate derivatives before grouping canonical rows by `Acquire Via`; ensure `project/images/` exists.-3. Finish user/formula and triggered ai/web/slice canonical preparation.+3. Finish user and triggered ai/web/slice canonical preparation.4. Materialize only declared derivatives from usable parents, preserve originals, then run `analyze_images.py` once before SVG.---@@ -96,7 +95,7 @@ After all rows reach terminal status:> `Needs-Manual` is terminal for acquisition, not export readiness. A later> supplied/replaced file must be validated and its row reconciled to-> `Existing`, `Generated`, `Sourced`, or `Rendered` with matching evidence.+> `Existing`, `Generated`, or `Sourced` with matching evidence.> Quick blocks every required row that still says `Needs-Manual`, regardless of> whether an unverified candidate file happens to exist. See> [`image-generator.md`](./image-generator.md) §7.diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex 7591148c..b5054e08 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -670,7 +670,7 @@ Triggered automatically when `IMAGE_BACKEND` is not configured (or Path A fails)- Do **not** run `image_gen.py --manifest` in Path B. That command is Path A and may use configured API/proxy backends even when the user confirmed host-native.- Still run `python3 scripts/image_gen.py --render-md project/images/image_prompts.json` so the human-readable sidecar exists without touching any backend.- **Batch for speed, mind the rate**: when the host can run independent tool calls in parallel (e.g. Claude Code issues independent calls concurrently), fire several generations together in modest groups — a few rows at a time (~3–4), not the whole manifest at once — so their latency overlaps without flooding the host's image quota. When the host only runs tools serially, generate one row at a time. This mirrors Path A's default concurrency of 3.-- Outputs **must** land at `project/images/<filename-from-resource-list>`. Match the Image Resource List dimensions when the host supports arbitrary sizes. Hosts with **fixed native resolutions** (common — e.g. ~1672x941 landscape / ~1086x1448 portrait) generate at the closest native size and backfill the actual pixels into the resource list `Dimensions` column — same convention as formula rows ("actual dimensions from formula manifest") and slice rows ("dimensions filled after slicing"). Do **not** upscale the file to fake the requested size (interpolation adds no detail); minor display-side upscaling (up to ~1.3x in practice) may surface as a non-blocking quality-checker warning and requires no acknowledgement.+- Outputs **must** land at `project/images/<filename-from-resource-list>`. Match the Image Resource List dimensions when the host supports arbitrary sizes. Hosts with **fixed native resolutions** (common — e.g. ~1672x941 landscape / ~1086x1448 portrait) generate at the closest native size and backfill the actual pixels into the resource list `Dimensions` column, as slice rows do after slicing. Do **not** upscale the file to fake the requested size (interpolation adds no detail); minor display-side upscaling (up to ~1.3x in practice) may surface as a non-blocking quality-checker warning and requires no acknowledgement.- Mark each item's `status` `Generated` in the manifest the moment its file lands — as each completes, not in one pass at the end (so an interrupted batch leaves accurate state)- Executor downstream is path-agnostic — no spec change required between Path A and Path Bdiff --git a/skills/ppt-master/references/image-layout-patterns.md b/skills/ppt-master/references/image-layout-patterns.mdindex 5a401656..eeb3595d 100644--- a/skills/ppt-master/references/image-layout-patterns.md+++ b/skills/ppt-master/references/image-layout-patterns.md@@ -1,6 +1,6 @@-# Image and Formula Layout Pattern Catalog+# Image Layout Pattern Catalog-Compact composition vocabulary for prepared images, illustrations, and rendered formula assets. Use the patterns as options, not as a checklist.+Compact composition vocabulary for prepared images and illustrations. Use the patterns as options, not as a checklist.---@@ -238,12 +238,10 @@ If motion is enabled, [`animations.md`](./animations.md) owns its implementation| A prepared subject should re-layer over its source | `#A2-03`; keep the base and cutout registered, and insert a native middle layer only when it has a distinct job || A busy visual needs one focal region | `#M2-05`, or prepared `#A3-01` / `#A3-03` when a native contrast treatment is insufficient || A visual argument should build across pages | `#C1-01` + `#P2-01` or `#P2-05`; keep the underlying source and frame stable |-| Formula or technical figure needs explanation | `#P1-12` + `#P2-07` / `#P2-03`; use `#P2-04` only when a second cropped detail is useful, and keep explanatory labels native |+| Technical figure needs explanation | `#P1-12` + `#P2-07` / `#P2-03`; use `#P2-04` only when a second cropped detail is useful, and keep explanatory labels native |**Registration boundary**: registration-dependent effects succeed only when their declared coordinate relationship remains exact. Preserve registration for `#M1-10`, `#A2-02`, `#A3-01`, `#M1-08`, `#A2-03`, `#A3-02`, `#A3-03`, and `#M1-11`; `#M1-09` is the intentional exception.**Source-correspondence boundary**: `#P2-04` reuses one exact source but intentionally changes the detail crop, scale, and placement; preserve the selected-region correspondence instead of forcing page-space registration.-**Formula placement**: treat a rendered formula as a prepared visual asset. Use whitespace patterns such as `#P1-11` or `#P1-12` for isolated derivations, `#P1-07`, `#P2-07`, `#P2-03`, or `#P2-04` for annotated formulas, and `#P3-04` or `#P3-03` for comparisons; keep editable explanatory text native.-All compatibility details remain owned by [`shared-standards-core.md`](./shared-standards-core.md) and its routed references.diff --git a/skills/ppt-master/references/image-layout-spec.md b/skills/ppt-master/references/image-layout-spec.mdindex 6b77bbdb..a02e6588 100644--- a/skills/ppt-master/references/image-layout-spec.md+++ b/skills/ppt-master/references/image-layout-spec.md@@ -2,9 +2,9 @@# Image Layout Specification-Neutral geometry and review rules for every image or rendered-formula placement. This file calculates the selected composition; it never chooses a resource, pattern, or automatic left/right or top/bottom layout.+Neutral geometry and review rules for every image placement. This file calculates the selected composition; it never chooses a resource, pattern, or automatic left/right or top/bottom layout.-**When to run**: whenever an image or rendered formula will be placed. Use the current page composition to select its region first, then apply the relevant single-item, adjacent, overlay, or multi-item calculation below.+**When to run**: whenever an image will be placed. Use the current page composition to select its region first, then apply the relevant single-item, adjacent, overlay, or multi-item calculation below.---@@ -78,18 +78,18 @@ Centered fill uses `ax = ay = 0.5`. SVG realization normally maps this to a lega| Need | Geometry ||---|---|-| Complete source, formula, evidence, or edge content | Contain |+| Complete source, evidence, or edge content | Contain || Region coverage with a focal-safe crop | Fill || Complete source plus a detail view | One contain placement plus a separately justified crop || Irregular or repeated source windows | Apply the selected region math first, then load the owning crop/shape reference |----## 3. Single Image or Formula+## 3. Single ImagePlace a standalone item by applying §2 to its selected region. The region itself comes from the page hierarchy; source ratio determines the item geometry inside it, not the page structure.-For an item adjacent to another region, divide only the available selected region. Let `q_item` and `q_other` be positive visual weights for the image/formula and the other content.+For an item adjacent to another region, divide only the available selected region. Let `q_item` and `q_other` be positive visual weights for the image and the other content.### 3.1 Horizontal adjacency@@ -202,22 +202,7 @@ listed structural role; otherwise use the selected region boundary and omit it.----## 5. Rendered Formula Geometry--Treat a rendered formula as an aspect-ratio source and apply contain within its selected mathematical region. Centering is the default geometric anchor; align to a nearby baseline or relation only when the page composition defines that relationship.--For `n` vertically stacked formula regions with equal lanes:--```text-lane_height = (H - (n - 1) × g) / n-lane_y[i] = y0 + i × (lane_height + g)-```--Contain each formula independently in its lane. When formulas are visual peers, a common effective scale may improve comparison; otherwise let their selected regions reflect their semantic weight and source ratios.-------## 6. Composition Checks+## 5. Composition Checks| Check | Required response ||---|---|@@ -232,7 +217,6 @@ Contain each formula independently in its lane. When formulas are visual peers,| Per-item angles vary without a shared direction or deliberate-disorder rule | Use one parent-group angle, a shared clip-shape direction, curve tangents, or a bounded angle rhythm || The parent contour does not affect silhouette, seam, reveal, or attachment | Remove it or reconstruct the carriers from that contour || A panel depends on shear, skew, or perspective warping | Replace it with 2D quadrilateral carriers and focal-safe crops |-| Formula symbols become unreadable at the intended viewing size | Enlarge its region or restructure the page || Gaps, alignments, or overlaps drift without purpose | Recalculate from the shared region and gap values |The final geometry must express the active page hierarchy, preserve the selected resource relationships, and remain valid under the conditionally loaded technical contracts.diff --git a/skills/ppt-master/references/native-formula.md b/skills/ppt-master/references/native-formula.mdnew file mode 100644index 00000000..30f77c3a--- /dev/null+++ b/skills/ppt-master/references/native-formula.md@@ -0,0 +1,83 @@+# Native Formula Specification++Shared authoring contract for standalone editable PowerPoint formulas generated+from exact LaTeX metadata.++## 1. Trigger and Ownership++**Trigger**: A page contains structural mathematical notation such as a+fraction, radical, integral, n-ary expression, limit, matrix, multiline+derivation, delimiter construction, accent, or complex script.++| Layer | Ownership |+|---|---|+| Default Strategist | Record exact mathematical content as a delimiter-free LaTeX expression body; do not classify or choose its implementation |+| Default Executor | Decide ordinary inline text versus a structural block; for a block, transfer that exact expression into metadata and author the marker plus SVG preview |+| Active Quick context | Perform both content and authoring responsibilities directly |+| SVG-to-PPTX exporter | Compile marker LaTeX to editable Office Math and replace the preview subtree |++Executor normally keeps short variables, percentages, simple assignments, and+notation such as `O(n log n)` as ordinary editable SVG text. The Strategist's+`Mathematical content` field does not pre-decide that classification. Formula+handling is not a user-confirmed policy, image resource, manifest, or+`spec_lock.md images` entry.++---++## 2. Canonical Marker++```xml+<g id="quadratic-formula"+ data-pptx-replace-with="formula"+ data-pptx-x="190" data-pptx-y="245"+ data-pptx-width="900" data-pptx-height="180"+ data-pptx-bounds="190 245 900 180">+ <metadata type="application/json"><![CDATA[+ {"latex":"\\frac{-b \\pm \\sqrt{b^2-4ac}}{2a}",+ "display":"block","font_size":42,"color":"#173B57","align":"center"}+ ]]></metadata>+ <text x="640" y="345" text-anchor="middle"+ font-size="42" fill="#173B57">(-b ± √(b²−4ac)) / 2a</text>+</g>+```++**Hard rule — metadata is truth**: Write one direct+`<metadata type="application/json">` child with non-empty `latex`. Its value is+the expression body only: omit `$...$`, `$$...$$`, `\(...\)`, and `\[...\]`+source delimiters. Current authoring uses `display: block`; `font_size` is+`> 0` and `<= 400` px, `color` is visible, and `align` is `left`, `center`, or+`right`.+Give the group finite `data-pptx-x/y`, positive `data-pptx-width/height`, and+matching root-coordinate `data-pptx-bounds`. The exporter always activates+formula replacement; `--native-charts-and-tables` does not control it.++**Supported subset**: basic text, numbers, operators, Greek/symbol commands,+fractions, radicals, scripts, `\sum` / `\prod` / `\int` with limits, `\left` /+`\right` delimiters, matrix variants, `cases`, `aligned`, text/math styles,+accents, and spacing. Unknown commands or environments fail closed.++**Hard rule — SVG children are preview only**: Author a semantically equivalent+preview with ordinary SVG text/shapes/lines/paths. Do not use `<image>`,+`<foreignObject>`, raw LaTeX text, or another runtime renderer. PPTX export+discards the marker's visible children and inserts one editable Office Math+object; the preview is not packaged as a fallback.++**Compatibility boundary**: Native formula output targets Microsoft PowerPoint+2010+ Office Math. The ordinary child subtree keeps the SVG preview readable,+but a PPTX opened in WPS, Keynote, LibreOffice, or another non-PowerPoint+renderer has no embedded formula fallback and is not guaranteed to display it.++---++## 3. Failure and Validation++**Hard rule — repair LaTeX upstream**: An unsupported command, invalid marker,+or compiler/checker failure blocks the page and returns it from validation to+authoring. Executor rewrites the delimiter-free expression with the supported+LaTeX subset without changing the planned mathematics; if that cannot preserve+the content, return it to the content owner for correction. Never substitute a+PNG, flatten structural math into ordinary text, hand-write OMML, or leave raw+LaTeX visible.++**Validation**: The first-page/final SVG checker validates the marker and+compiles its LaTeX before release; native export repeats validation.diff --git a/skills/ppt-master/references/native-shape-authoring.md b/skills/ppt-master/references/native-shape-authoring.mdindex e61d9461..ca5bba5a 100644--- a/skills/ppt-master/references/native-shape-authoring.md+++ b/skills/ppt-master/references/native-shape-authoring.md@@ -55,7 +55,7 @@ paths or contours, or upgrade ordinary SVG during export.| Stock bent / curved relationship contour | `bentConnector*`, `curvedConnector*` | Prefer when the contour fits and endpoint attachment is not required. The authored object is an unconnected native Connector, so moving nodes does not reroute it. || Stock callout | `wedgeRectCallout`, `wedgeRoundRectCallout`, `wedgeEllipseCallout`, `cloudCallout` | For a brand-specific or custom tail, continue through the Boolean gate; use freeform only if the result still cannot be expressed faithfully. || Stock ribbon or scroll | `ribbon*`, `ellipseRibbon*`, `verticalScroll`, `horizontalScroll` | Select only when the stock contour is visually acceptable. |-| Standalone math symbol | `mathPlus`, `mathMinus`, `mathMultiply`, `mathDivide`, `mathEqual`, `mathNotEqual` | Inline formulas and prose symbols remain text/formula assets. |+| Standalone math symbol | `mathPlus`, `mathMinus`, `mathMultiply`, `mathDivide`, `mathEqual`, `mathNotEqual` | Use only when the symbol itself is a diagram shape; inline notation remains text and structural mathematics follows [`native-formula.md`](./native-formula.md). || Literal Office symbol | `heart`, `sun`, `moon`, `lightningBolt`, `gear6`, `gear9` | Never replace an icon required by `spec_lock.icons`. |Use registry search for a less common literal shape:diff --git a/skills/ppt-master/references/strategist-image.md b/skills/ppt-master/references/strategist-image.mdindex 8e6edcfe..6bf6fb63 100644--- a/skills/ppt-master/references/strategist-image.md+++ b/skills/ppt-master/references/strategist-image.md@@ -2,9 +2,9 @@# Strategist Image Planning-Always-on Stage-2 rendering-candidate extension plus conditional formula assets, confirmed image elaboration, and `design_spec.md §VIII` resource planning.+Always-on Stage-2 rendering-candidate extension plus confirmed image elaboration and `design_spec.md §VIII` resource planning.-**Trigger**: Load before every fresh Stage-2 direction set. Apply §2 first from the rendering index, freeze each direction's exact bases, and only then read the deduplicated selected detail files before completing its behavior. [`strategist.md`](./strategist.md) independently owns source recommendation. A confirmed non-`none` source activates the applicable resource-planning sections; confirmed `none` without formulas stops before resources, while a formula-only path applies §3 and §4 formula rows only. Rendering candidates are authored once before confirmation and never backfilled from a later source toggle.+**Trigger**: Load before every fresh Stage-2 direction set. Apply §2 first from the rendering index, freeze each direction's exact bases, and only then read the deduplicated selected detail files before completing its behavior. [`strategist.md`](./strategist.md) independently owns source recommendation. A confirmed non-`none` source activates the applicable resource-planning sections; confirmed `none` stops before resources. Rendering candidates are authored once before confirmation and never backfilled from a later source toggle.---@@ -32,41 +32,20 @@ The UI hides these candidates while AI is not selected. If the user adds AI, itFor specialized or regulated paper-figure subjects, preserve the prompt depth required by [`image-generator.md`](./image-generator.md) §4.2 rather than shortening to a generic brief. Scan the outline for genuine image-led pages, list the proposed hero pages in Stage-2 `image_notes` so the user can retain, edit, or remove them in the same confirmation, then mark only the confirmed pages' AI rows `page_role: hero_page`; local is the default. `text_policy: embedded` is reserved for stable figure-internal identifiers or lettering deliberately fused into the artwork; page titles, editable data values/labels, and prose remain SVG. Resolve confirmed provided assets through the context-first boundary above before writing §VIII.-## 3. Formula Asset Policy+## 3. Image Resource List-Formula rendering is a conditional choice surfaced in final Stage 2 production confirmation. Recommend one policy and let the user confirm or override it:--| Policy | Behavior | Use |-|---|---|---|-| `mixed` (default) | Render complex expressions to PNG; keep simple inline math as editable text / Unicode | Most academic, engineering, educational, and technical decks |-| `render-all` | Render every formula-worthy expression to PNG | Formula-heavy teaching / research decks where consistency matters more than editability |-| `text-only` | Keep expressions as editable text / Unicode | Business decks, light technical briefs, or an explicit editability preference |--`$...$` / `$$...$$` in source material are input signals only. Never scan output files for dollar-delimited formulas. Fractions, radicals, integrals, sums, limits, matrices, multiline derivations, and complex super/subscripts are formula-worthy; short variables, simple assignments, percentages, and expressions such as `O(n log n)` normally remain text. Never invent an equation for decoration.--For `mixed` or `render-all`, write selected source expressions to `<project_path>/images/formula_manifest.json` before writing the final spec, then run:--```bash-python3 skills/ppt-master/scripts/latex_render.py <project_path>-python3 skills/ppt-master/scripts/analyze_images.py <project_path>/images-```--Follow `latex_render.py --help` for the manifest fields. The renderer writes dimensions, ratio, file, provider, and status back into it. Formula PNGs default to transparent; use an opaque final background only when the asset requires it.--## 4. Image Resource List--Add §VIII rows only for planned images and every selected formula; permitted unused sources create no row. Fill filename, dimensions/ratio, layout suggestion, crop, purpose/type, acquisition, status, reference, and conditional AI fields. `Acquire Via` is `ai`, `web`, `user`, `formula`, `placeholder`, or `slice`; status follows [`svg-image-embedding.md`](./svg-image-embedding.md). Keep any unavailable planned/required asset `Pending` or `Needs-Manual`; never delete or reclassify it to appear complete. After final confirmation, project each placed row into `spec_lock.md images` as `<path> | source=<Acquire Via> | pattern=<Layout pattern> | crop=<adaptive|no-crop>` and omit unplaced source/sheet rows. Preserve exact confirmed `source`/`crop`; keep non-empty `pattern`, including optional catalog ids, as preferred expression rather than locked geometry.+Add §VIII rows only for planned images; permitted unused sources create no row. Fill filename, dimensions/ratio, layout suggestion, crop, purpose/type, acquisition, status, reference, and conditional AI fields. `Acquire Via` is `ai`, `web`, `user`, `placeholder`, or `slice`; status follows [`svg-image-embedding.md`](./svg-image-embedding.md). Keep any unavailable planned/required asset `Pending` or `Needs-Manual`; never delete or reclassify it to appear complete. After final confirmation, project each placed row into `spec_lock.md images` as `<path> | source=<Acquire Via> | pattern=<Layout pattern> | crop=<adaptive|no-crop>` and omit unplaced source/sheet rows. Preserve exact confirmed `source`/`crop`; keep non-empty `pattern`, including optional catalog ids, as preferred expression rather than locked geometry.**Prepared derivatives**: Keep canonical; `Reference`: `Derived from <bare filename>; treatment=<operation>;`. Deterministic child: distinct `.png`, inherits acquisition; §4.4 follows `user`/`ai` above. Lock placed children; [`image-base.md`](./image-base.md) §2–3 owns preparation.-References describe visual intent: AI uses subject + intent + composition without repeating rendering or HEX; web records exact subject, view/mood, focal/quiet region, and crop safety with positive quality cues; Image_Searcher later derives a separate short, specific provider query without rewriting this locked intent, while complete entity names or necessary disambiguation may use more words; formula preserves source LaTeX and placement intent. Any subject direction, focal placement, quiet region, or overlay-safety requirement that must affect acquisition/generation belongs in `Reference` or the matching §IX block, not only in `Layout pattern`.+References describe visual intent: AI uses subject + intent + composition without repeating rendering or HEX; web records exact subject, view/mood, focal/quiet region, and crop safety with positive quality cues; Image_Searcher later derives a separate short, specific provider query without rewriting this locked intent, while complete entity names or necessary disambiguation may use more words. Any subject direction, focal placement, quiet region, or overlay-safety requirement that must affect acquisition/generation belongs in `Reference` or the matching §IX block, not only in `Layout pattern`.-**Prepared-user fast path**: For initial imported or user-supplied assets confirmed as `provided`, copy the exact `Filename` basename and derive `Dimensions` / `Ratio` from that row's EXIF-corrected `Width` / `Height` / native `AspectRatio` in the latest `analysis/image_analysis.csv`; `SourceDisplayRatio` is source-context metadata, not the bitmap crop ratio. Drop source-side directories, set `Acquire Via: user` and `Status: Existing`, and decide the remaining §VIII fields normally. Existing §VIII / lock / provenance-manifest records override this inference. Assets declared as `ai`, `web`, `slice`, `formula`, or manual fulfillment retain that provenance and advance through their own status lifecycle after entering `images/`; location never reclassifies them as `user / Existing`.+**Prepared-user fast path**: For initial imported or user-supplied assets confirmed as `provided`, copy the exact `Filename` basename and derive `Dimensions` / `Ratio` from that row's EXIF-corrected `Width` / `Height` / native `AspectRatio` in the latest `analysis/image_analysis.csv`; `SourceDisplayRatio` is source-context metadata, not the bitmap crop ratio. Drop source-side directories, set `Acquire Via: user` and `Status: Existing`, and decide the remaining §VIII fields normally. Existing §VIII / lock / provenance-manifest records override this inference. Assets declared as `ai`, `web`, `slice`, or manual fulfillment retain that provenance and advance through their own status lifecycle after entering `images/`; location never reclassifies them as `user / Existing`.-**Mandatory**: each placed row, including formulas, gets one executable `Layout pattern`. It is preferred expression, not locked geometry; optional hierarchical ids from the already-read [`image-layout-patterns.md`](./image-layout-patterns.md) must be exact. They are prompt lookup handles for Executor, not exporter effect codes. Executor may adapt the suggestion while preserving resource identity/source, must-use status, crop/content, and explicit user/template constraints; layout-only changes need no upstream rewrite.+**Mandatory**: each placed row gets one executable `Layout pattern`. It is preferred expression, not locked geometry; optional hierarchical ids from the already-read [`image-layout-patterns.md`](./image-layout-patterns.md) must be exact. They are prompt lookup handles for Executor, not exporter effect codes. Executor may adapt the suggestion while preserving resource identity/source, must-use status, crop/content, and explicit user/template constraints; layout-only changes need no upstream rewrite.**Default — action-bearing image plan (may override when restraint better serves the page)**: For a `hero_page` or other image-led row, name an image/content or image/shape action—not position, size, crop, or legibility scrim alone. Plain split and full bleed remain valid when clearest.-Choose narrative intent before dimensions, then apply the already-read [`image-layout-spec.md`](./image-layout-spec.md) to the actual page region. Techniques needing a cutout, blurred crop, or desaturated copy require that prepared asset. Write `Crop Policy: no-crop` whenever cropping could remove required pixels, labels, evidence, identity, or edge content; screenshots, charts, certificates/contracts, dense diagrams, logos, product markings, and formulas are common triggers rather than an exhaustive list. Otherwise write `Crop Policy: adaptive`: Executor may use complete display or a focal-safe crop, and the value never commands cropping. Formula rows use `Type: Latex Formula`, `Acquire Via: formula`, `Crop Policy: no-crop`, and `Rendered` or `Needs-Manual`.+Choose narrative intent before dimensions, then apply the already-read [`image-layout-spec.md`](./image-layout-spec.md) to the actual page region. Techniques needing a cutout, blurred crop, or desaturated copy require that prepared asset. Write `Crop Policy: no-crop` whenever cropping could remove required pixels, labels, evidence, identity, or edge content; screenshots, charts, certificates/contracts, dense diagrams, logos, and product markings are common triggers rather than an exhaustive list. Otherwise write `Crop Policy: adaptive`: Executor may use complete display or a focal-safe crop, and the value never commands cropping.-Judge `text_policy` per AI row using [`image-generator.md`](./image-generator.md) §5.3; paper figures, academic schematics, panel comparisons, and data-axis graphics are positive triggers for reconsidering an all-`none` plan. Step 5 dispatches pending `ai` / `slice` rows to Image_Generator and pending `web` rows to Image_Searcher; formula rows bypass both.+Judge `text_policy` per AI row using [`image-generator.md`](./image-generator.md) §5.3; paper figures, academic schematics, panel comparisons, and data-axis graphics are positive triggers for reconsidering an all-`none` plan. Step 5 dispatches pending `ai` / `slice` rows to Image_Generator and pending `web` rows to Image_Searcher.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex f0499ec9..7a1cd7dd 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -34,7 +34,7 @@ solution + production gate:| Stage | Items | Role ||---|---|---|| **1 — communication contract + template choice** | `primary_language` · `c` audience · open-ended communication intent · audience outcome · core message / delivery context (primary + optional secondary) / artifact afterlife · `content_divergence` (all prose fields may be blank) · `a` canvas · explicit `free_design` or `templates` choice and selected roots | confirmed together; candidate workspaces do not influence the communication recommendation |-| **2 — final solution + production** (authored once from the user's *actual* Stage 1) | reading mode (`delivery_purpose`, PPT only) · `d` mode + visual style · `b` page count · `e` color · `f` icon · `g` typography · `h` image source + generated-image rendering · conditional natural-language template application · formula policy · conditional AI-image acquisition path · generation mode · refine-spec toggle · proactive speaker notes / custom animations / narration audio | derived as one coherent plan from the confirmed contract; internal template exporter modes remain hidden |+| **2 — final solution + production** (authored once from the user's *actual* Stage 1) | reading mode (`delivery_purpose`, PPT only) · `d` mode + visual style · `b` page count · `e` color · `f` icon · `g` typography · `h` image source + generated-image rendering · conditional natural-language template application · conditional AI-image acquisition path · generation mode · refine-spec toggle · proactive speaker notes / custom animations / narration audio | derived as one coherent plan from the confirmed contract; internal template exporter modes remain hidden |Do not force communication intent into one catalog label; Stage 1 records composite intent in prose. Editable prose fields are recommendation drafts, not required inputs: confirmation preserves current text and blanks; never repopulate a cleared field. Stage 2 confirms narrative spine, reading density, page budget, visual system, image direction, production mechanics, and how any installed template should be used. It never chooses or installs a template. Inspect only project-local template spec/prototypes, present one editable application plan, and keep exporter reuse/adherence internal. First author exactly three complete, project-fit solution directions from the confirmed contract and source; only then project each direction into mode, visual style, color, type, icons, and generated-image rendering for lower-level adjustment. Every direction projects a project-specific `custom` mode, `custom` visual style, and `custom` generated-image rendering; the fixed catalogs remain conservative lower-level single-select alternatives. All three must be viable and distinguishable as whole solutions, but do not force safe / shifted / bold archetypes, different catalog bases, or artificial extremes. After all three bundles are complete, compare them against the confirmed contract and source, choose the strongest overall fit, and write its actual zero-based index as `design_directions.selected` (`0`, `1`, or `2`); array order never determines preference. Every direction carries a complete generated-image rendering candidate even when AI imagery is not recommended; `recommend.image_usage` independently decides whether AI is proposed. Generated images inherit deck colors—there is no second image palette. Proactive defaults are speaker notes `true`, custom animations `false`, and narration audio `false`; a prior explicit user instruction overrides the matching recommendation, and effective narration audio requires effective speaker notes. Author each stage once; same-stage edits update only visible browser state through documented deterministic dependencies, without another AI/backend recommendation. Launch/derive/wait mechanics live in [`generate-pptx.md`](../workflows/generate-pptx.md) Step 4; item specs keep `a`–`h`.@@ -251,9 +251,19 @@ pinned, and changing canvas does not secretly rescale it.| Footnote / page number | 0.5–0.65× |Scan §IX before locking. Declare every recurring role, including `lead`, `footnote`, and chart annotations when used; a lead is always at least body size. Give each role one deck-wide anchor and snap derived anchors to clean even px (for body 24, a sound set is title 42, subtitle 32, lead 30, annotation 18, footnote 16). Executor may vary one occurrence within that role's anchor ±2px while preserving hierarchy and readability. A short non-structural Hero/Display size planned for at most two occurrences may remain undeclared; the third planned occurrence makes it recurring and requires an explicit named slot. Structural text never uses this sparse exception.-#### Formula Planning Trigger-Formula policy and formula-asset planning are conditional. [`strategist-image.md`](./strategist-image.md) is already loaded for Stage-2 rendering candidates; if the source contains formula-worthy expressions, or the user explicitly requests formula handling, apply its §3 before confirming the production policy or writing formula rows. Otherwise omit formula planning from the core path.+#### Mathematical Content Planning++Preserve every source-backed equation and its mathematical meaning. In each+applicable §IX page block, record the exact expression under `Mathematical+content` as a LaTeX body without `$...$`, `$$...$$`, `\(...\)`, or `\[...\]`+source delimiters. This field may cover any mathematics that needs exact+preservation; do not classify it as inline or structural or choose its+implementation. Never invent an equation for decoration or create a formula+policy, manifest, PNG, §VIII row, or `spec_lock.md images` entry. Executor owns+the text-versus-native-formula decision and its authoring; if the supported+LaTeX subset cannot preserve the planned content, return here for a+content-level correction.### h. Image Source Recommendation@@ -274,9 +284,9 @@ Formula policy and formula-asset planning are conditional. [`strategist-image.md**Always-on decision module; conditional resource extension**:1. Before authoring Stage-2 directions, read [`strategist-image.md`](./strategist-image.md) plus only [`image-renderings/_index.md`](./image-renderings/_index.md). After the three whole-direction intents exist and their rendering reference ids are frozen, read only those exact sibling files once and author one complete custom rendering inside each direction before deciding whether `recommend.image_usage` includes AI.-2. Independently derive `recommend.image_usage` from source needs. Confirmed non-`none` sources activate the module's resource-planning sections and the image layout references; formulas activate the formula sections even when usage is `none`. Confirmed `none` without formulas writes no image rows, but does not erase the three recommendation-only rendering candidates.+2. Independently derive `recommend.image_usage` from source needs. Confirmed non-`none` sources activate the module's resource-planning sections and the image layout references. Confirmed `none` writes no image rows, but does not erase the three recommendation-only rendering candidates.-The module owns formula policy, AI rendering alternatives, acquisition paths, resource rows, prompt depth, page roles, and placement intent.+The module owns AI rendering alternatives, acquisition paths, resource rows, prompt depth, page roles, and placement intent.### Presentation Capability & Visualization Recall (Non-blocking — Strategist recommends, no user confirmation needed)@@ -484,7 +494,7 @@ final Stage 2 `false`, explicit objects-off, or explicit all-motion-off; only thincludes transitions.1. With Generate Step 4's retained complete final-confirmation state, read `${SKILL_DIR}/templates/design_spec_reference.md`.-2. Compose the whole Design Spec in active context before touching the target path. Create `design_spec.md` once from the schema marker through §X; do not copy a scaffold into the project or patch placeholder fields. Record production mechanics in §I, including one effective outcome plus provenance for Speaker Notes, Custom Animations, and Narration Audio. Resolve them from latest explicit user instruction → matching final Stage 2 proactive value → workflow default `enabled` / `disabled` / `disabled`; Narration Audio enabled requires Speaker Notes enabled without rewriting the raw proactive evidence, and a dependency-driven notes outcome records that provenance. In §IX, create the complete ordered roster; each entry carries layout, title, core message, **Audience move**, complete preferred wording, applicable capability recommendations, visualization/image references, sourced `Fact IDs`, and `Data class: scenario` for invented demo data. After Gate 1 plus conditional refine approval, roster ids/count/order and semantic content are authoritative; non-literal wording, block texture, layout, cover/closing composition, capability recommendations, and image/visualization patterns remain References unless promoted.+2. Compose the whole Design Spec in active context before touching the target path. Create `design_spec.md` once from the schema marker through §X; do not copy a scaffold into the project or patch placeholder fields. Record production mechanics in §I, including one effective outcome plus provenance for Speaker Notes, Custom Animations, and Narration Audio. Resolve them from latest explicit user instruction → matching final Stage 2 proactive value → workflow default `enabled` / `disabled` / `disabled`; Narration Audio enabled requires Speaker Notes enabled without rewriting the raw proactive evidence, and a dependency-driven notes outcome records that provenance. In §IX, create the complete ordered roster; each entry carries layout, title, core message, **Audience move**, complete preferred wording, exact mathematical content when applicable, capability recommendations, visualization/image references, sourced `Fact IDs`, and `Data class: scenario` for invented demo data. After Gate 1 plus conditional refine approval, roster ids/count/order and semantic content are authoritative; non-literal wording, block texture, layout, cover/closing composition, capability recommendations, and image/visualization patterns remain References unless promoted.3. Compare `design_spec.md` against the final confirmation field by field. Repair every omission or deviation before entering an enabled refine-spec review or authoring `spec_lock.md`.4. If enabled, run [`refine-spec`](../workflows/stages/refine-spec.md) after Gate 1; edit only that Design Spec and create no lock before explicit approval.5. Read `${SKILL_DIR}/templates/spec_lock_reference.md`; create the lock once or resynchronize stale derived state from the approved Design Spec and context. Retain identity/refinements and stable roles/routing; omit unnamed page-local values, do not reopen evidence, and make no new recommendation.@@ -500,7 +510,7 @@ includes transitions.| 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 |-| Formula policy, AI-image acquisition path, generation mode, refine-spec toggle | §I records them as production mechanics; their owning Generate stage consumes the Design Spec, and formula policy also shapes §VIII when formula-worthy content exists |+| AI-image acquisition path, generation mode, refine-spec toggle | §I records them as production mechanics; their owning Generate stage consumes the Design Spec || Proactive speaker notes, custom animations, and narration audio | §I records the three resolved effective outcomes with provenance, while §X records enabled note requirements or `Generation: disabled`; they remain outside `spec_lock.md`. §IX Motion suggestions remain optional advice regardless of the animation outcome || Explicit final/literal narration script | §IX segments the argument by semantic scene and gives each segment a supporting visible state; §X records the source plus verbatim policy, and Generate freezes the actual segments in `notes/total.md` after Gate 2 |diff --git a/skills/ppt-master/references/svg-image-embedding.md b/skills/ppt-master/references/svg-image-embedding.mdindex f702454c..1ad5c2af 100644--- a/skills/ppt-master/references/svg-image-embedding.md+++ b/skills/ppt-master/references/svg-image-embedding.md@@ -16,13 +16,12 @@ and filter/clip contracts.| Mode | Resource authority and preparation timing ||---|---|| Default Generate | `design_spec.md §VIII` plus its lock projection; when user-provided images are selected, run `analyze_images.py` after Strategist confirmation and complete the list before Executor |-| Quick Generate | Current main agent's active-context resource decisions; materialize explicit user paths first, resolve unspecified acquisition decisions automatically, and finish user/ai/web/slice/formula preparation before SVG authoring without confirmation or a persisted roster |+| Quick Generate | Current main agent's active-context resource decisions; materialize explicit user paths first, resolve unspecified acquisition decisions automatically, and finish user/ai/web/slice preparation before SVG authoring without confirmation or a persisted roster |```markdown| Filename | Dimensions | Purpose | Type | Layout pattern | Crop Policy | Acquire Via | Status | Reference ||----------|------------|---------|------|----------------|-------------|-------------|--------|-----------|| team.jpg | 800x600 | Team photo | Photography | `#P1-02 image left, copy right` | adaptive | web | Pending | Diverse engineering team in modern office |-| formula_001.png | 736x168 | Page 3 block equation | Latex Formula | formula | no-crop | formula | Rendered | `E = mc^2` |```### Image Status Enum@@ -33,8 +32,7 @@ and filter/clip contracts.| **Failed** | The latest automatic acquisition attempt failed; this is retryable and non-terminal | Step 5 reruns the owning manifest or explicitly resolves the row to `Needs-Manual`; Executor must never treat `Failed` as usable content || **Generated** | AI/slice output exists | Reference from `../images/`; manifest records govern attribution. An `Illustration Sheet` stays in §VIII only as an unplaced slice source || **Sourced** | Web-sourced file exists at expected path | Reference from `../images/`; check `image_sources.json` for `license_tier` — if `attribution-required`, render an inline credit element on the slide (see [`executor-web-image.md`](./executor-web-image.md) §1 and [`image-searcher.md`](./image-searcher.md) §7 for the attribution contract) |-| **Rendered** | Deterministic formula PNG exists at expected path (`Acquire Via: formula`) | Reference from `../images/`; use a legal anchor with `meet` for the complete placement (centered default: `xMidYMid meet`) and do not crop |-| **Needs-Manual** | Automatic acquisition is unavailable/exhausted or the selected path requires manual fulfillment; for `slice`, the parent sheet is unavailable | Default Generate may use a dashed placeholder until its readiness gate. Quick Generate blocks every required row still in this status, even if an unverified candidate file exists; validate a supplied replacement and reconcile it to `Existing`, `Generated`, `Sourced`, or `Rendered` first. For `slice`, supply the parent sheet and rerun `slice_images.py`; do not hand-place individual element files. |+| **Needs-Manual** | Automatic acquisition is unavailable/exhausted or the selected path requires manual fulfillment; for `slice`, the parent sheet is unavailable | Default Generate may use a dashed placeholder until its readiness gate. Quick Generate blocks every required row still in this status, even if an unverified candidate file exists; validate a supplied replacement and reconcile it to `Existing`, `Generated`, or `Sourced` first. For `slice`, supply the parent sheet and rerun `slice_images.py`; do not hand-place individual element files. || **Existing** | User already has image (`Acquire Via: user`) | Place in `images/`, reference with `<image>` || **Placeholder** | Intentionally not prepared yet (`Acquire Via: placeholder`) | Dashed border placeholder; replace later |@@ -48,7 +46,6 @@ and filter/clip contracts.- Quick Generate → current main agent resolves the required resource in active context; explicit user paths/URLs/choices win, unspecified choices use automatic resolution, no interaction or persisted roster2. Prepare project-local resources before SVG authoring:- user → materialize the explicit source under project/images/ → Existing- - formula → write formula_manifest.json and run latex_render.py → Rendered- Pending prepared derivative → follow [`image-base.md`](./image-base.md) §3 before ordinary `Acquire Via` dispatch- Pending / Failed + ai → Image_Generator runs image_gen.py → Generated- Pending / Failed + web → Image_Searcher runs image_search.py → Sourced@@ -58,7 +55,6 @@ and filter/clip contracts.├── Sourced + license_tier=no-attribution → <image href=...> only├── Sourced + license_tier=attribution-required → <image href=...> + small <text> credit element on the slide├── Sourced + license_tier=manual → <image href=...> only (user-supplied --from-url; rights/credit are user responsibility)- ├── Rendered formula → <image href="../images/formula_001.png" preserveAspectRatio="xMidYMid meet" .../>└── Placeholder / Needs-Manual → Dashed border + description text until a supplied file is validated and status is reconciled4. Preview: python3 -m http.server -d <project_path> 8000 → /svg_output/<filename>.svg5. Export:diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.mdindex 253ca2aa..6a2e9c43 100644--- a/skills/ppt-master/scripts/README.md+++ b/skills/ppt-master/scripts/README.md@@ -57,7 +57,7 @@ python3 scripts/update_repo.py| PPTX animations | `pptx_animations.py`, `animation_config.py` | [docs/pptx-animations.md](./docs/pptx-animations.md) || Animation resources | `sound_sync.py` | [sound catalog](../templates/sounds/README.md); [docs/pptx-animations.md](./docs/pptx-animations.md) || Spec maintenance | `update_spec.py`, `visualization_recall.py`; legacy `chart_recall.py` | [docs/update_spec.md](./docs/update_spec.md); [docs/visualization-recall.md](./docs/visualization-recall.md) |-| Image tools | `image_gen.py`, `image_treat.py`, `latex_render.py`, `analyze_images.py`, `gemini_watermark_remover.py` | [docs/image.md](./docs/image.md) |+| Image tools | `image_gen.py`, `image_treat.py`, `analyze_images.py`, `gemini_watermark_remover.py` | [docs/image.md](./docs/image.md) || Maintenance smokes | Inline temporary-project commands | [advanced image and motion](./docs/advanced-image-motion-smoke.md); [mask and gradient](./docs/mask-gradient-smoke.md); [multilingual text](./docs/multilingual-text-smoke.md) || Repo maintenance | `update_repo.py` | README install/update section || Troubleshooting | validation, preview, export, dependency issues | [docs/troubleshooting.md](./docs/troubleshooting.md) |@@ -303,13 +303,16 @@ literal field fallback because they are shared by multiple slides.Image generation:```bash-python3 scripts/latex_render.py <project_path>-python3 scripts/latex_render.py <project_path> --providers codecogs,quicklatex,mathpad,wikimediapython3 scripts/image_gen.py "A modern futuristic workspace"python3 scripts/image_gen.py --list-backendspython3 scripts/analyze_images.py <project_path>/images```+Generated-deck formulas do not use an image command. Author a native formula+marker in the page SVG; `svg_to_pptx.py` compiles its LaTeX metadata to editable+PowerPoint OMML. The retained `latex_render.py` utility is standalone legacy+rasterization only and is not connected to either Generate profile.+Repository update:```bashdiff --git a/skills/ppt-master/scripts/confirm_ui/server.py b/skills/ppt-master/scripts/confirm_ui/server.pyindex 0a250053..1732ffe6 100644--- a/skills/ppt-master/scripts/confirm_ui/server.py+++ b/skills/ppt-master/scripts/confirm_ui/server.py@@ -1286,13 +1286,12 @@ def _stage2_production_recommendations_error(recommend = recommendations.get('recommend')if not isinstance(recommend, dict):recommend = {}- for field in ('formula_policy', 'generation_mode'):- value = recommend.get(field)- if not isinstance(value, str) or not value.strip():- return (- 'Stage 2 recommendations must include non-empty '- f'recommend.{field}'- )+ generation_mode = recommend.get('generation_mode')+ if not isinstance(generation_mode, str) or not generation_mode.strip():+ return (+ 'Stage 2 recommendations must include non-empty '+ 'recommend.generation_mode'+ )refine_spec = recommendations.get('refine_spec')if (not isinstance(refine_spec, dict)@@ -1311,10 +1310,9 @@ def _stage2_production_recommendations_error(def _stage2_production_result_error(result: dict) -> Optional[str]:"""Require every user-confirmed production control in the final payload."""- for field in ('formula_policy', 'generation_mode'):- value = result.get(field)- if not isinstance(value, str) or not value.strip():- return f'final Stage 2 payload must include non-empty {field}'+ generation_mode = result.get('generation_mode')+ if not isinstance(generation_mode, str) or not generation_mode.strip():+ return 'final Stage 2 payload must include non-empty generation_mode'if not isinstance(result.get('refine_spec'), bool):return 'final Stage 2 payload must include refine_spec as a boolean'if _uses_ai_images(result):@@ -2765,6 +2763,10 @@ def create_app(result_file,carry_previous=rec_stage_number > 1,)+ # Formula realization is Executor-owned. Accept the retired field from+ # older recommendations/clients, but never persist it in a new receipt.+ result.pop('formula_policy', None)+ locked_values.pop('formula_policy', None)if rec_stage_number == 1 or not template_required:result.pop('template_application', None)locked_values.pop('template_application', None)diff --git a/skills/ppt-master/scripts/confirm_ui/static/app.js b/skills/ppt-master/scripts/confirm_ui/static/app.jsindex 190086f8..23b3519e 100644--- a/skills/ppt-master/scripts/confirm_ui/static/app.js+++ b/skills/ppt-master/scripts/confirm_ui/static/app.js@@ -104,7 +104,6 @@placeholder_audience: "Who is this deck for?",placeholder_pages: "e.g. 12-15",hex_override: "Custom HEX override:",- formula_policy: "Formula rendering policy",image_ai_path: "AI image source",image_strategy: "Generated image style",image_strategy_empty: "No preset style references are available. You can still use a custom style.",@@ -287,7 +286,6 @@placeholder_audience: "この資料は誰に向けたもの?",placeholder_pages: "例:12-15",hex_override: "カスタムHEXで上書き:",- formula_policy: "数式レンダリング方針",image_ai_path: "AI画像の生成元",image_strategy: "生成画像のスタイル",image_strategy_empty: "プリセットのスタイル見本を利用できません。カスタムスタイルは引き続き使用できます。",@@ -470,7 +468,6 @@placeholder_audience: "这份演示文稿面向谁?",placeholder_pages: "如:12-15",hex_override: "自定义色值覆盖:",- formula_policy: "公式渲染策略",image_ai_path: "生成配图来源",image_strategy: "生成图风格",image_strategy_empty: "当前没有可用的预设风格参考,仍可使用自定义风格。",@@ -653,7 +650,6 @@placeholder_audience: "這份簡報面向誰?",placeholder_pages: "如:12-15",hex_override: "自訂色值覆蓋:",- formula_policy: "公式渲染策略",image_ai_path: "生成配圖來源",image_strategy: "生成圖風格",image_strategy_empty: "目前沒有可用的預設風格參考,仍可使用自訂風格。",@@ -1350,7 +1346,6 @@if (field === "icons") return REC.icons && REC.icons.value;if (field === "image_usage") return REC.images && REC.images.value;if (field === "image_ai_path") return REC.image_ai_path || (REC.images && REC.images.ai_path);- if (field === "formula_policy") return REC.typography && REC.typography.formula_policy && REC.typography.formula_policy.value;if (field === "generation_mode") return REC.generation_mode && REC.generation_mode.value;return REC[field] && REC[field].value;}@@ -3344,13 +3339,6 @@}}- function renderFormulaPolicy(host) {- var sec = section("F", "formula_policy");- enumField(sec, CAT.formula_policy, recOrFirst("formula_policy", CAT.formula_policy),- function () { return STATE.formula_policy; }, function (v) { STATE.formula_policy = v; });- host.appendChild(sec);- }-// Combined color + typography + icon preview — not a separate confirmation, just a// live "overall impression" of the style choices made above. Kept// deliberately abstract (a style chip, not a slide layout); page layout@@ -3922,7 +3910,6 @@host.appendChild(styleGroup);renderImageDirection(host);renderImageProduction(host);- renderFormulaPolicy(host);renderProactiveExecution(host);renderMode(host);renderRefine(host);@@ -4079,7 +4066,6 @@}function initProductionState() {- STATE.formula_policy = pick("formula_policy", CAT.formula_policy);STATE.image_ai_path = pick("image_ai_path", CAT.image_ai_path);STATE.proactive_speaker_notes = booleanRecommendation("proactive_speaker_notes", true);STATE.proactive_custom_animations = booleanRecommendation("proactive_custom_animations", false);diff --git a/skills/ppt-master/scripts/confirm_ui/static/catalogs.json b/skills/ppt-master/scripts/confirm_ui/static/catalogs.jsonindex a6b7b514..47abd322 100644--- a/skills/ppt-master/scripts/confirm_ui/static/catalogs.json+++ b/skills/ppt-master/scripts/confirm_ui/static/catalogs.json@@ -1483,44 +1483,6 @@"desc_ja": "images/image_prompts.jsonにプロンプトを書き出し、ユーザーが外部で生成した画像をproject/images/に配置する方式。"}],- "formula_policy": [- {- "id": "mixed",- "label": "mixed",- "label_zh": "混合",- "label_zh_tw": "混合",- "label_en": "mixed",- "label_ja": "混合",- "desc_zh": "复杂公式渲染为图片;简单行内公式保持为可编辑文本或字符。",- "desc_zh_tw": "複雜公式渲染為圖片;簡單行內公式保持為可編輯文字或字元。",- "desc_en": "Render complex formula-worthy expressions to PNG; keep simple inline math as editable text / Unicode.",- "desc_ja": "複雑な数式はPNG画像として描画し、簡単な行内数式は編集可能なテキスト/Unicode文字のまま残す。"- },- {- "id": "render-all",- "label": "render-all",- "label_zh": "全部渲染",- "label_zh_tw": "全部渲染",- "label_en": "render-all",- "label_ja": "すべて画像化",- "desc_zh": "所有需要按公式处理的表达式都渲染为图片。",- "desc_zh_tw": "所有需要按公式處理的運算式都渲染為圖片。",- "desc_en": "Render every formula-worthy expression to PNG.",- "desc_ja": "数式として扱うべき表現はすべてPNG画像として描画する。"- },- {- "id": "text-only",- "label": "text-only",- "label_zh": "仅文本",- "label_zh_tw": "僅文字",- "label_en": "text-only",- "label_ja": "テキストのみ",- "desc_zh": "不渲染公式;表达式保持为可编辑文本或字符。",- "desc_zh_tw": "不渲染公式;運算式保持為可編輯文字或字元。",- "desc_en": "Do not render formulas; keep expressions as editable text / Unicode.",- "desc_ja": "数式は画像化せず、編集可能なテキスト/Unicode文字のまま保持する。"- }- ],"generation_mode": [{"id": "continuous",diff --git a/skills/ppt-master/scripts/docs/confirm_ui.md b/skills/ppt-master/scripts/docs/confirm_ui.mdindex a25af9d0..0393e8c1 100644--- a/skills/ppt-master/scripts/docs/confirm_ui.md+++ b/skills/ppt-master/scripts/docs/confirm_ui.md@@ -310,7 +310,7 @@ template-selection receipt.- **Enumerable + custom** — canvas / icons retain blank manual inputs. Mode and visual style first show three project-specific `custom` values projected from the complete directions, then the full fixed base catalog as conservative single-select alternatives. Selecting a projected card expands its behavior editor in place; edits change only the current value, while the adjusted active whole-direction card exposes an explicit restore action for the authored text.- **Visual examples for hard-to-name choices** — the full-screen confirmation page loads real SVG page samples from `static/style_previews/` for fixed `visual_style` catalog choices, and renders real sample SVGs from `templates/icons` for `icons`. Project-specific `custom` direction cards show their authored summary instead of requesting a nonexistent preset asset. These thumbnails and summaries make style and icon-library choices visually comparable before the user locks them. Preview copy is fixed role text (big title / section title / body / points), not project content from recommendation files, so users compare visual treatment rather than copywriting. These previews are a confirmation aid only: they do not add fields to recommendation stage files or `result.json`, and they do not replace the later Step 6 live preview.- **Image usage multi-select** — image sources are selected as one or more catalog ids: `ai` = AI-generated, `web` = Web-sourced, `provided` = User-provided, `placeholder` = Placeholder, `none` = No images. `none` is exclusive. A confirmed non-`none` set is the allowed acquisition-source boundary, not a requirement to use every selected source; only explicit `image_notes` wording can require a source, asset, or page role. Recommendation and result values may be a legacy single string, but new files should use an array. When several sources are recommended, write the source ids to `recommend.image_usage` and write the actual usage strategy to `image_notes`, not a custom prose value.-- **Closed enumerable** — PPT reading mode (`delivery_purpose` compatibility key), formula policy / generation mode / refine spec, plus AI source only when image usage includes `ai`. These have no Custom box; out-of-catalog values snap back to the recommended option.+- **Closed enumerable** — PPT reading mode (`delivery_purpose` compatibility key), generation mode / refine spec, plus AI source only when image usage includes `ai`. These have no Custom box; out-of-catalog values snap back to the recommended option.- **Proactive execution booleans** — Final Stage 2 carries top-level `proactive_speaker_notes`, `proactive_custom_animations`, and `proactive_narration_audio` values. Defaults are `true`, `false`, and `false`, respectively. They control what the Agent does proactively only when the user has not explicitly instructed otherwise; the latest explicit user instruction always wins. These three values are raw confirmation evidence: the UI and server neither couple nor rewrite them, and every boolean combination is valid. When narration audio is enabled, Strategist later resolves the effective Speaker Notes outcome to enabled and records `Narration Audio dependency` as its Design Spec provenance. Disabling proactive custom animation does not suppress the Strategist's advisory motion recommendations.- **Open prose** — `audience`, `communication_intent`, `audience_outcome`, `core_message`, `delivery_context`, `artifact_afterlife`, `content_divergence`, and `page_count`. `communication_intent` may carry several purposes plus priority / sequence; common paths appear only as help text. `delivery_context` states one primary presenter-led / reader-led / hybrid / recorded-self-running context plus optional secondary use; a hybrid recommendation names which context leads. `content_divergence` is the source-treatment axis. `page_count` may be a range here; Strategist resolves the exact §IX roster, leaving Executor no pagination latitude.- **Coordinated generative directions** — `design_directions` carries exactly three complete candidates authored top-down from the project contract. Each has a unique stable id and bundles `custom` mode, `custom` visual style, color, typography, icon id, and `custom` generated-image rendering regardless of recommended image source. Its localized note is a compact, user-facing style summary. It may reuse localized display labels from `catalogs.visual_styles` when they describe the result concisely, but those labels are optional vocabulary rather than a selection constraint or required mapping. Otherwise it uses concise natural language and never forces the nearest label. The summary stays within one or two short sentences and does not expose catalog ids or reference mechanics. All three must be viable as whole solutions; they do not need different catalog bases or forced safe / shifted / bold archetypes. After completing all three bundles, Strategist compares them against the confirmed contract and source, then writes the strongest overall fit's zero-based index to `selected`; array position does not determine preference. That bundle becomes the initial default and applies its three custom projections coherently. The page can still render legacy top-level `color`, `typography`, and `image_strategy` candidates, but new staged recommendations use the coordinated bundle.@@ -325,7 +325,7 @@ Direction-local custom projections apply to mode, visual style, and generated-im## Catalogs — `static/catalogs.json` (the finite option universe)-The front-end loads `/api/catalogs` (served by the confirm server) and falls back to the static `/static/catalogs.json` if that route is unavailable. `/api/catalogs` returns the static file **with the `canvas` list synced live from `config.py CANVAS_FORMATS`** — the set of formats and their `dim` come from config (single source of truth, zero drift), while four-language labels / use text stay in catalogs.json (a plain fallback label is synthesized for any new id config adds). Keys: `canvas`, `modes`, `visual_styles` (grouped), `icons`, `image_usage`, `image_ai_path`, `formula_policy`, `generation_mode`, `delivery_purpose`. Each entry is `{ "id", "label", "label_zh", "label_zh_tw", "label_en", "label_ja", ... }`; descriptions use `desc_zh` / `desc_zh_tw` / `desc_en` / `desc_ja`, and `visual_styles` groups use `group_zh` / `group_zh_tw` / `group_en` / `group_ja`. The front-end falls back to legacy `label` / `desc` / `group`, so old catalogs still load, but new user-facing catalog text must cover all four languages (zh / zh-TW / en / ja). English labels should mirror canonical reference names (`pyramid`, `swiss-minimal`, `Path A`, `mixed`, etc.); Simplified Chinese, Traditional Chinese, and Japanese labels should be translated for users. Descriptions render inline after the option title, not as a separate selected-option line. `visual_styles` is `[{ "group", "group_zh", "group_zh_tw", "group_en", "group_ja", "items": [...] }]`. For `canvas` you only need to maintain the four-language labels in catalogs.json; the format set and dimensions are authoritative in `config.py CANVAS_FORMATS`.+The front-end loads `/api/catalogs` (served by the confirm server) and falls back to the static `/static/catalogs.json` if that route is unavailable. `/api/catalogs` returns the static file **with the `canvas` list synced live from `config.py CANVAS_FORMATS`** — the set of formats and their `dim` come from config (single source of truth, zero drift), while four-language labels / use text stay in catalogs.json (a plain fallback label is synthesized for any new id config adds). Keys: `canvas`, `modes`, `visual_styles` (grouped), `icons`, `image_usage`, `image_ai_path`, `generation_mode`, `delivery_purpose`. Each entry is `{ "id", "label", "label_zh", "label_zh_tw", "label_en", "label_ja", ... }`; descriptions use `desc_zh` / `desc_zh_tw` / `desc_en` / `desc_ja`, and `visual_styles` groups use `group_zh` / `group_zh_tw` / `group_en` / `group_ja`. The front-end falls back to legacy `label` / `desc` / `group`, so old catalogs still load, but new user-facing catalog text must cover all four languages (zh / zh-TW / en / ja). English labels should mirror canonical reference names (`pyramid`, `swiss-minimal`, `Path A`, `continuous`, etc.); Simplified Chinese, Traditional Chinese, and Japanese labels should be translated for users. Descriptions render inline after the option title, not as a separate selected-option line. `visual_styles` is `[{ "group", "group_zh", "group_zh_tw", "group_en", "group_ja", "items": [...] }]`. For `canvas` you only need to maintain the four-language labels in catalogs.json; the format set and dimensions are authoritative in `config.py CANVAS_FORMATS`.## Round-trip data contract@@ -363,7 +363,7 @@ run remains inactive. An existing `result.json` outside the current `stage1` /| Recommendation file | Declared stage | Page renders | Button | On submit ||---|---|---|---|---|| `recommendations.stage1.json` + `template_options.json` | `"stage1"` | communication contract — content language; audience; open `communication_intent`; audience outcome; core message / primary delivery context + optional secondary use / artifact afterlife / `content_divergence` (all prose fields may be blank); canvas; free-design/template mode and conditional candidate selectors | **Confirm contract & template choice** | writes Stage-1 `result.json` plus `template_selection.json` in one submission; the page stays open and polls while the agent installs/completes the handoff |-| `recommendations.stage2.json` | `"stage2"` | complete deck solution and production — conditional natural-language template application, reading mode, mode, page count, visual direction, color, icons, typography, image usage/rendering, conditional AI acquisition path, formula policy, proactive notes/custom-animation/narration-audio toggles, generation mode, and Design Spec review toggle | **Confirm final plan** | writes `result.json` `{ stage: "final", status: "confirmed", <all fields> }`, then shuts the page down |+| `recommendations.stage2.json` | `"stage2"` | complete deck solution and production — conditional natural-language template application, reading mode, mode, page count, visual direction, color, icons, typography, image usage/rendering, conditional AI acquisition path, proactive notes/custom-animation/narration-audio toggles, generation mode, and Design Spec review toggle | **Confirm final plan** | writes `result.json` `{ stage: "final", status: "confirmed", <all fields> }`, then shuts the page down |In the UI branch, the AI authors Stage 1 without reading template candidates,then launches the combined page. In chat/delegated confirmation it authors the@@ -436,11 +436,14 @@ The common paths — inform / explain / persuade / decide / align / teach / repoAfter Stage 1 is confirmed, create `recommendations.stage2.json` with the complete solution; leave Stage 1 unchanged (the server folds confirmed communication fields back in when serving the page):**Stage-2 production contract**: the server rejects the recommendation file-unless `recommend.formula_policy`, `recommend.generation_mode`, and boolean-`refine_spec.value` are present; `recommend.image_ai_path` is additionally-required when `image_usage` includes `ai`. Final submission must retain the-corresponding direct values (`formula_policy`, `generation_mode`, boolean-`refine_spec`, and conditional `image_ai_path`) or confirmation is rejected.+unless `recommend.generation_mode` and boolean `refine_spec.value` are present;+`recommend.image_ai_path` is additionally required when `image_usage` includes+`ai`. Final submission must retain the corresponding direct values+(`generation_mode`, boolean `refine_spec`, and conditional `image_ai_path`) or+confirmation is rejected. Formula realization is Executor-owned and is not a+Stage-2 choice. Legacy recommendation/result objects may contain+`formula_policy`; the server tolerates the extra field but does not render or+persist it in a new receipt.```json{@@ -453,7 +456,6 @@ corresponding direct values (`formula_policy`, `generation_mode`, boolean"image_strategy": "custom","image_usage": ["ai", "provided"],"image_ai_path": "auto",- "formula_policy": "mixed","generation_mode": "continuous"},"page_count": { "value": "12-15" },@@ -554,7 +556,6 @@ Template-mode-only Stage-2 fragment:"icons": "tabler-outline","typography": { "name": "...", "heading": { "primary": "...", "english": "...", "css": "..." }, "body": { "primary": "...", "english": "...", "css": "..." }, "body_size": 24, "body_size_unit": "px", "sizes": { "title": 42, "subtitle": 32, "annotation": 18 } },"delivery_purpose": "balanced",- "formula_policy": "mixed","image_usage": ["ai", "provided"],"image_notes": "封面和章节页用 AI 主视觉;产品页优先用户素材,缺口页可用占位符。","image_ai_path": "auto",diff --git a/skills/ppt-master/scripts/docs/image.md b/skills/ppt-master/scripts/docs/image.mdindex 7162831d..eaf03788 100644--- a/skills/ppt-master/scripts/docs/image.md+++ b/skills/ppt-master/scripts/docs/image.md@@ -5,43 +5,25 @@> inputs while delivery writes self-contained SVG previews and native PPTX> media.-Image tools cover formula rendering, prompt-based AI generation, web image search, image inspection, and Gemini watermark removal.+Image tools cover prompt-based AI generation, web image search, image inspection,+and Gemini watermark removal. Native formula authoring belongs to the SVG+pipeline, not the image pipeline.-## `latex_render.py`+## Legacy standalone `latex_render.py`-Manifest-driven LaTeX formula renderer. Default Generate has Strategist write-`images/formula_manifest.json` after Typography confirmation; Quick Generate-has the current agent write the same resource manifest without confirmation.-This script renders only those declared formulas to transparent PNGs and writes-dimensions back into the manifest.+This retained standalone utility renders a user-authored+`images/formula_manifest.json` to PNG. Neither Default nor Quick Generate calls+it, and new projects do not create formula manifests or formula images. The+supported generated-deck path authors a native formula marker in SVG and lets+`svg_to_pptx.py` compile its LaTeX payload to editable PowerPoint OMML.```bashpython3 scripts/latex_render.py <project_path>python3 scripts/latex_render.py <project_path> --dry-run-python3 scripts/latex_render.py <project_path> --providers codecogs,quicklatex,mathpad,wikimedia```-Manifest shape:--```json-{- "providers": ["codecogs", "quicklatex", "mathpad", "wikimedia"],- "items": [- {- "id": "formula_001",- "latex": "E = mc^2",- "display": "block",- "color": "#1D1D1F",- "background": "#FFFFFF",- "transparent": true,- "dpi": 300,- "filename": "formula_001.png"- }- ]-}-```--Output files land directly under `project/images/`. Formula filenames should use a shared `formula_` prefix, e.g. `formula_001.png`. The default provider chain is `codecogs,quicklatex,mathpad,wikimedia`; each provider is tried automatically until one succeeds, and the winning provider is recorded back into the manifest. `--providers` or manifest-level `providers` may override the order, but all four are available as no-key fallbacks. Formula PNGs are transparent by default. `background` is the temporary render matte and local background-removal reference; set `transparent: false` only when an opaque final formula asset is intentional. The script does not scan `spec_lock.md` or source documents for `$...$`; formula selection belongs to the active resource owner.+Use it only for an explicitly requested external raster workflow. It is not a+compatibility fallback for Keynote, WPS, LibreOffice, or another client.## `image_gen.py`diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 10ba0cf3..234c47f7 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -524,6 +524,15 @@ It aggregates:Convert project SVGs into PPTX.+Native block formulas use an explicit replacement marker owned by+[`native-formula.md`](../../references/native-formula.md). The marker stores+source LaTeX in JSON metadata and keeps ordinary SVG text/shapes as its browser+preview. Formula replacement is always active, independent of+`--native-charts-and-tables`: export discards the preview children and writes an+editable PowerPoint 2010+ Office Math object. It emits no formula PNG, media+relationship, or compatibility fallback, and makes no rendering/editability+promise for Keynote, WPS, LibreOffice, or another non-PowerPoint client.+```bashpython3 scripts/svg_to_pptx.py <project_path># Explicit compact image export:@@ -563,8 +572,8 @@ explicit current structured contract remains blocking.Explicit direct generation may use the[`quick-generate`](../../workflows/profiles/quick-generate.md) profile after thecurrent agent has converted/read sources, researched identified factual gaps,-and prepared the required images, icons, formulas, and resource manifests as-needed. That profile skips Strategist, Confirm UI, `design_spec.md`, and+prepared the required images, icons, and resource manifests as needed, and+retained any source LaTeX for direct native-marker authoring. That profile skips Strategist, Confirm UI, `design_spec.md`, and`spec_lock.md`; it does not skip the resources required by the authored pages.After the complete SVG roster exists, run its lockless final checker, thenexport:@@ -584,8 +593,8 @@ custom object animation, and narration start off in Quick and may be enabledwhen needed. The exporter refuses a missing, blocking, non-final, or staleQuick final report before PPTX creation. Default-path output retains the normalpostflight report and `backup/` snapshot; explicit `-o` retains the ordinary-no-backup behavior. Existing source, analysis, image/icon/formula, and-resource-manifest artifacts remain untouched.+no-backup behavior. Existing source, analysis, image/icon, and resource-manifest+artifacts remain untouched; formula source stays inside the authored SVG marker.For generated-project narration, follow the[`generate-audio`](../../workflows/stages/generate-audio.md) stage. It owns voicediff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex e20e55d4..da8f69c5 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -326,15 +326,13 @@"max_tokens": 110000},"route.generate.quick-generate.formula": {- "description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",+ "description": "Quick Generate with direct PowerPoint-native formula marker authoring.","scope": "cumulative","include": ["route.generate.quick-generate",- "stage.generate.executor.image"- ],- "files": [- "skills/ppt-master/scripts/docs/image.md"+ "stage.generate.executor.formula"],+ "files": [],"max_tokens": 110000},"route.generate.quick-generate.ai-two-types": {@@ -386,14 +384,13 @@"max_tokens": 115000},"route.generate.planning-formula": {- "description": "Formula-only planning context, including the shared image/formula layout math and vocabulary.",+ "description": "Formula-bearing planning context; Strategist records exact mathematics without loading image-layout or formula-rendering resources.","scope": "cumulative","include": [- "route.generate.planning",- "stage.generate.strategist.image"+ "route.generate.planning"],"files": [],- "max_tokens": 115000+ "max_tokens": 110000},"route.generate.planning-ai": {"description": "Generate-PPTX planning after AI imagery is confirmed, adding image-layout and resource-planning authorities to the rendering index and already-selected rendering bases.",@@ -538,6 +535,18 @@"files": [],"max_tokens": 165000},+ "route.generate.flat-formula": {+ "description": "Default flat Generate-PPTX context with direct PowerPoint-native formula marker authoring and no image branch.",+ "scope": "cumulative",+ "include": [+ "route.generate.planning-formula",+ "stage.generate.executor.flat",+ "stage.generate.executor.formula",+ "stage.generate.executor.notes"+ ],+ "files": [],+ "max_tokens": 170000+ },"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, the selected preset or exact custom rendering bases, and two local types.","scope": "cumulative",@@ -552,7 +561,7 @@"max_tokens": 205000},"route.generate.flat-in-hand-image": {- "description": "Generate-PPTX context with provided, placeholder, or formula images and no acquisition role.",+ "description": "Generate-PPTX context with provided or placeholder images and no acquisition role.","scope": "cumulative","include": ["route.generate.planning-image",@@ -991,7 +1000,7 @@"max_tokens": 1000},"stage.generate.strategist.image": {- "description": "Conditional Strategist image/formula layout math and compact composition vocabulary; the rendering decision core is already in base planning.",+ "description": "Conditional Strategist image layout math and compact composition vocabulary; the rendering decision core is already in base planning.","scope": "incremental","files": ["skills/ppt-master/references/image-layout-spec.md",@@ -1015,6 +1024,14 @@],"max_tokens": 6750},+ "stage.generate.executor.formula": {+ "description": "Conditional direct authoring contract for PowerPoint-native block formulas.",+ "scope": "incremental",+ "files": [+ "skills/ppt-master/references/native-formula.md"+ ],+ "max_tokens": 1250+ },"stage.generate.executor.image": {"description": "Conditional image embedding and execution rules with the always-read layout math and compact composition vocabulary.","scope": "incremental",@@ -2021,6 +2038,10 @@"glob": "skills/ppt-master/scripts/docs/prompt_audit.md","reason": "Maintainer-only documentation for this audit tool."},+ {+ "glob": "skills/ppt-master/scripts/docs/image.md",+ "reason": "Standalone image-tool command reference; generation roles load the owning image contracts directly, and its formula renderer section is legacy-only."+ },{"glob": "skills/ppt-master/scripts/docs/mask-gradient-smoke.md","reason": "Maintainer-only executable smoke; never loaded by generation roles."diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex d657d3dc..95d38566 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -43,7 +43,6 @@ Start with this exact heading order:| Reading Mode | <text, balanced, presentation, or the active non-PPT equivalent> || Content Strategy | <confirmed material-divergence prose or balanced default> || Design Style | <resolved design direction> |-| Formula Policy | <mixed, render-all, or text-only> || AI Image Acquisition Path | <confirmed path or not applicable> || Generation Mode | <continuous or split> || Spec Refinement | <enabled or disabled> |@@ -179,7 +178,7 @@ in `kebab-case` and add one `Native-ready` map: `<key>=yes|no; ...`. Use `yes`only when editable native output helps. Qualitative relationships/read orderremain unkeyed prose, as do incidental microvisuals.-In §VIII, author every planned or explicitly required resource from the confirmed source boundary. Write one concise, non-empty `Layout pattern` suggestion in ordinary language; optionally cite hierarchical ids from the layout library when they help recall a technique. Set `Crop Policy` to `adaptive` or `no-crop`; set `Acquire Via` to `ai`, `web`, `user`, `formula`, `placeholder`, or `slice`. Preserve unresolved required assets as `Pending` or `Needs-Manual` instead of dropping or reclassifying them.+In §VIII, author every planned or explicitly required resource from the confirmed source boundary. Write one concise, non-empty `Layout pattern` suggestion in ordinary language; optionally cite hierarchical ids from the layout library when they help recall a technique. Set `Crop Policy` to `adaptive` or `no-crop`; set `Acquire Via` to `ai`, `web`, `user`, `placeholder`, or `slice`. Preserve unresolved required assets as `Pending` or `Needs-Manual` instead of dropping or reclassifying them. Native formulas never enter this table or `spec_lock.md images`.§VIII `Layout pattern` is a per-resource preference. When a page uses several images, repeats one image in multiple views, or combines an image with native overlays, describe the page-level relationship and participating resources in §IX `Layout` / `Images`; do not duplicate an unchanged resource row merely to encode animation sequencing.@@ -201,6 +200,7 @@ Write one ordered Slide block per page. Slide count and order must equal §I `Pa- **Title**: <preferred page title>- **Core message**: <one governing assertion>- **Content**: <complete intended on-slide content and hierarchy>+- **Mathematical content**: <exact expression as a delimiter-free LaTeX body; omit when none>## X. Speaker Notes Requirements@@ -228,7 +228,7 @@ never write an empty or `none` placeholder:- **Motion suggestion**: <communication job plus desired page-entry or reveal relationship/order>```-Add `Visualization` / `Images` when a Slide consumes §VII/§VIII or uses a page-local visual model. Name every value-driven geometry, qualitative relationship, cell grid, and child visual here; only independent Chart/Table entries use object keys. Describe qualitative order, linkage, hierarchy, grouping, contrast, overlap, and reading path freely—not as a model name or grammar enum. §IX may choose a custom Chart/Table fallback. Add `Native shape suggestion` only when a preset, stock Connector, or compound silhouette/cutout/intersection/fragment may help; name the semantic result plus candidate family or Boolean operands, never implementation geometry or keys. Executor chooses the primitive, preset, Boolean construction, or necessary freeform. Add `Motion suggestion` whenever transition/reveal advice strengthens communication, regardless of the Custom Animations outcome; state purpose and semantic order/relationship, not registry keys, options, timing, ids, or coverage. The suggestion never activates animation execution by itself, creates content, or binds implementation. Describe required visible image states in `Layout` / `Images` only for an explicit motion requirement or an enabled Custom Animations outcome. Add keyed `Native-ready` only for independent data charts or pure text-grid tables, `Fact IDs` for sourced claims, and `Data class: scenario` for invented demo values. Except on preservation paths, `Cover impact` carries a binding hook and adaptable composition; apply the same split to `Closing impact` only when the deck genuinely resolves. Roster/order/content stay authoritative. §VIII image layout is non-empty free prose with optional library ids; §VII Chart/Table rows are references. Executor owns geometry, hierarchy, treatment, and sparse local garnish.+Add `Mathematical content` whenever a Slide needs a mathematical expression preserved exactly. Store the expression body as valid LaTeX without `$...$`, `$$...$$`, `\(...\)`, or `\[...\]` source delimiters; the field does not classify inline versus structural use. This is content authority for [`native-formula.md`](../references/native-formula.md), not a formula policy, marker, or implementation request; Executor chooses ordinary text versus a structural native formula. Add `Visualization` / `Images` when a Slide consumes §VII/§VIII or uses a page-local visual model. Name every value-driven geometry, qualitative relationship, cell grid, and child visual here; only independent Chart/Table entries use object keys. Describe qualitative order, linkage, hierarchy, grouping, contrast, overlap, and reading path freely—not as a model name or grammar enum. §IX may choose a custom Chart/Table fallback. Add `Native shape suggestion` only when a preset, stock Connector, or compound silhouette/cutout/intersection/fragment may help; name the semantic result plus candidate family or Boolean operands, never implementation geometry or keys. Executor chooses the primitive, preset, Boolean construction, or necessary freeform. Add `Motion suggestion` whenever transition/reveal advice strengthens communication, regardless of the Custom Animations outcome; state purpose and semantic order/relationship, not registry keys, options, timing, ids, or coverage. The suggestion never activates animation execution by itself, creates content, or binds implementation. Describe required visible image states in `Layout` / `Images` only for an explicit motion requirement or an enabled Custom Animations outcome. Add keyed `Native-ready` only for independent data charts or pure text-grid tables, `Fact IDs` for sourced claims, and `Data class: scenario` for invented demo values. Except on preservation paths, `Cover impact` carries a binding hook and adaptable composition; apply the same split to `Closing impact` only when the deck genuinely resolves. Roster/order/content stay authoritative. §VIII image layout is non-empty free prose with optional library ids; §VII Chart/Table rows are references. Executor owns geometry, hierarchy, treatment, and sparse local garnish.For free-design pages, describe `Layout` through relationships, hierarchy, regions, and column spans; do not prescribe element-level `x`, `y`, `width`, or `height` or duplicate the global geometry in §II/§V. Exact coordinates belong to Executor SVG authoring. Preserve literal geometry only when the user explicitly requires it or a mirror/template preservation contract owns it.diff --git a/skills/ppt-master/templates/scaffolds/design_spec.md b/skills/ppt-master/templates/scaffolds/design_spec.mdindex 59da2c97..9c654d61 100644--- a/skills/ppt-master/templates/scaffolds/design_spec.md+++ b/skills/ppt-master/templates/scaffolds/design_spec.md@@ -17,7 +17,6 @@| Reading Mode | [fill] || Content Strategy | [fill] || Design Style | [fill] |-| Formula Policy | [fill] || AI Image Acquisition Path | [fill or not applicable] || Generation Mode | [fill] || Spec Refinement | [fill] |@@ -115,6 +114,7 @@- **Title**: [fill]- **Core message**: [fill]- **Content**: [fill]+- **Mathematical content**: [fill exact delimiter-free LaTeX expression body, or omit]## X. Speaker Notes Requirementsdiff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 2d7e7f14..cb0c897d 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -25,9 +25,9 @@ request does not explicitly select Quick.| Scope | Contract ||---|---|-| Any route that authors or regenerates slide visuals through SVG | `svg_output/` is the complete page-design source: every visible text, image, shape, chart/table fallback, and layout element that should appear on the exported slide is present in that page SVG or referenced by it. |+| Any route that authors or regenerates slide visuals through SVG | `svg_output/` is the complete page-design source: every visible text, image, shape, chart/table fallback, native-formula preview, and layout element that should appear on the exported slide is present in that page SVG or referenced by it. || Templates, `design_spec.md`, and `spec_lock.md` | Authoring/control inputs. They guide SVG creation but MUST NOT supply visible slide content that is absent from the completed SVG during export. |-| Semantic SVG markers | Minimal rendering-neutral compiler hints used only after existing Layout/Layer/Placeholder/Native metadata has been considered. They never replace native SVG geometry, text, styles, grouping, or asset references. |+| Semantic SVG markers | Minimal rendering-neutral compiler hints used only after existing Layout/Layer/Placeholder/Native metadata has been considered. Chart/table markers preserve their visible SVG fallback; a formula marker carries exact LaTeX and explicitly replaces only its own ordinary SVG preview subtree with editable Office Math during PPTX export. || `svg_final/` | Mandatory derived, self-contained SVG visual preview in the default pipeline. It may be opened directly or inserted into PowerPoint as an SVG picture, but it is not a supported PPTX source and carries no manual Convert-to-Shape compatibility contract. Quick-generate skips it. || SVG-to-PPTX export | The only supported generated-PPTX route reads `svg_output/` and maps its content through the project converter to DrawingML/native objects. It compiles only the selected route's explicit structure contract: `flat` keeps represented content Slide-local, while `structured` may place explicitly scoped content in Master/Layout/Slide parts. It MUST NOT infer structure, upgrade `flat`, or invent new visible page content. || Native PPTX routes and presentation-behavior stages | Remain outside SVG page-design closure. `template-fill-pptx`, `native-enhance-pptx`, animations, transitions, speaker notes, narration, and package relationships are not required to round-trip through SVG. |@@ -255,16 +255,16 @@ Then load only the extra role modules triggered by the current plan:|---|---|| Stage 1 is confirmed and its template choice installed a selected Brand/Style/Layout/Deck workspace into this project | `references/strategist-template.md` before Stage 2 || The confirmed Stage-1 `delivery_context` identifies recorded/self-running/video delivery, or input is an explicit final/literal narration script | `references/video-design.md` before the three Stage-2 whole solutions and page roster |-| The confirmed Stage 2 `image_usage` contains a source other than `none`, the user supplied an explicit non-`none` image constraint, or formula-worthy content activates formula planning | `references/image-layout-spec.md` + `references/image-layout-patterns.md` before production detail, formula resources, or §VIII |+| The confirmed Stage 2 `image_usage` contains a source other than `none`, or the user supplied an explicit non-`none` image constraint | `references/image-layout-spec.md` + `references/image-layout-patterns.md` before production detail or §VIII |After Stage 1 and template handoff, load `strategist-image.md` plus only thethree `_index.md` files. Author the three whole solution intents before mappingany component basis. Freeze every referenced mode/style/rendering id from theindexes, then read once only the deduplicated union of those exact detail filesand finish the three custom behaviors. A novel custom reads no detail file.-Confirmed non-`none` or formulas load the layout references and continue into-resource planning; confirmed `none` without formulas writes no image rows while-retaining recommendation-only rendering candidates. Only an installed+Confirmed non-`none` loads the layout references and continues into resource+planning; confirmed `none` writes no image rows while retaining+recommendation-only rendering candidates. Only an installedproject-local template state loads the template module, and only after Stage 1is confirmed; a bare template/style name does not.@@ -312,7 +312,7 @@ Stage-2 summary without fabricating UI results. Silence confirms nothing.| `confirm_ui/template_options.json` | Candidate schema/language plus supplied exact roots; library entries remain server-owned index data | Stage-1 submission writes user-owned `template_selection.json` with `phase: template`, `status: confirmed` || `confirm_ui/recommendations.stage1.json` | Communication contract, `content_divergence`, and canvas only; no template-derived recommendation | The same submission writes `result.json` with `status: stage1-confirmed` || `confirm_ui/template_handoff.json` | Only through `--complete-template-selection`, after the Stage-1 selection and free-design closure or successful installation | `status: ready`, bound to the current selection hash; prerequisite for Stage 2 |-| `confirm_ui/recommendations.stage2.json` | `stage: stage2`; complete deck solution plus conditional AI path, formula policy, generation mode, refine-spec, proactive speaker notes, custom animations, and narration audio | `stage: final`, `status: confirmed` |+| `confirm_ui/recommendations.stage2.json` | `stage: stage2`; complete deck solution plus conditional AI path, generation mode, refine-spec, proactive speaker notes, custom animations, and narration audio | `stage: final`, `status: confirmed` |If the user rejects the current recommendation before confirming it, regenerate by overwriting that same stage file and have the page refresh; do not create revision-suffixed files. This never authorizes one stage file to carry another stage's payload.@@ -415,7 +415,14 @@ For the normal/default `continuous` path, print no split-mode reminder and proce**Mandatory — spec-refinement note** (not another Confirm UI stage): after confirmation details and any split-mode line, append one localized 💡 line offering review of the complete Design Spec before the lock; any part may be revised in chat until explicit approval. Default OFF; only explicit chat opt-in or `refine_spec: true` runs [`refine-spec`](stages/refine-spec.md) after Gate 1. Confirm UI records the toggle; chat fallback prints the same line.-**Formula policy**: Final Stage 2 confirms `mixed`, `render-all`, or `text-only`. The image-decision core is already loaded; when rendering is required, load the conditional image-layout references even if `image_usage` is `none`, then follow [`strategist-image.md`](../references/strategist-image.md)'s formula-resource contract. `text-only` creates no formula image rows.+**Native formula content**: Formula handling is not a confirmation field or an+image-acquisition path. Strategist records exact mathematical content as a+delimiter-free LaTeX expression body in the applicable §IX page block without+classifying its implementation. Executor independently keeps simple inline+notation as text and writes every structural block expression as a native+formula marker under [`native-formula.md`](../references/native-formula.md).+No formula manifest, §VIII resource row, or `spec_lock.md images` entry is+created.**Proactive production decisions**: Final Stage 2 records`proactive_speaker_notes`, `proactive_custom_animations`, and@@ -437,7 +444,7 @@ neither row and ask one question: disable audio too, or retain its requirednotes. Wait, then update both. Before `generate-audio`, create and split noteswhen complete per-slide files are absent.-If the user provided images or formula PNGs were rendered, run analysis **before outputting the design spec**. It writes `analysis/image_analysis.csv` — the authoritative regenerated image-fact view in the `analysis/` folder, which MUST be read before authoring §VIII:+If the user provided images, run analysis **before outputting the design spec**. It writes `analysis/image_analysis.csv` — the authoritative regenerated image-fact view in the `analysis/` folder, which MUST be read before authoring §VIII:```bashpython3 ${SKILL_DIR}/scripts/analyze_images.py <project_path>/images```@@ -468,15 +475,15 @@ state and §X records its source/verbatim policy. After Gate 2, before Step 5 orsplit handoff, write the exact segments once to `notes/total.md`; split them onlyin Step 7.1. This is frozen production input, not a third planning artifact.-**✅ Internal checkpoint — Phase deliverables complete**: facts read; confirmation consumed once; final Stage-2 production fields resolved (formula policy, generation mode, refine-spec, proactive choices, and conditional AI path); Design Spec passed Gate 1; enabled refinement approved; lock derived from it; split handling resolved; communication and every §IX `Audience move` validated. Do not print this checklist; auto-proceed.+**✅ Internal checkpoint — Phase deliverables complete**: facts read; confirmation consumed once; final Stage-2 production fields resolved (generation mode, refine-spec, proactive choices, and conditional AI path); mathematical content recorded where applicable; Design Spec passed Gate 1; enabled refinement approved; lock derived from it; split handling resolved; communication and every §IX `Audience move` validated. Do not print this checklist; auto-proceed.---### Step 5: Image Acquisition Phase (Conditional)-🚧 **GATE**: Step 4 complete; `<project_path>/design_spec.md` and `<project_path>/spec_lock.md` both exist. If either required artifact is missing, stop before any acquisition or generation and follow [`failure-recovery.md`](governance/failure-recovery.md) §3. Formula rows already have `Acquire Via: formula` and status `Rendered` or `Needs-Manual`.+🚧 **GATE**: Step 4 complete; `<project_path>/design_spec.md` and `<project_path>/spec_lock.md` both exist. If either required artifact is missing, stop before any acquisition or generation and follow [`failure-recovery.md`](governance/failure-recovery.md) §3.-> **Trigger**: At least one row in the resource list has `Acquire Via: ai`, `web`, and/or `slice`, or any row is a pending prepared derivative declared by `Reference: Derived from <canonical bare filename>; treatment=...`. A prepared-user-only plan skips this step only when it has no derivative to materialize; `formula` and `placeholder` rows alone do not trigger it. A permitted but unused image source creates no row and does not trigger acquisition. If §VIII omits a source, asset, or page role that `image_notes` explicitly requires, the Design Spec is incomplete; return to Step 4 Gate 1, repair it from the retained final state, and re-author the affected lock anchors from context. Do not reopen `result.json` during this check.+> **Trigger**: At least one row in the resource list has `Acquire Via: ai`, `web`, and/or `slice`, or any row is a pending prepared derivative declared by `Reference: Derived from <canonical bare filename>; treatment=...`. A prepared-user-only plan skips this step only when it has no derivative to materialize; `placeholder` rows alone do not trigger it. A permitted but unused image source creates no row and does not trigger acquisition. If §VIII omits a source, asset, or page role that `image_notes` explicitly requires, the Design Spec is incomplete; return to Step 4 Gate 1, repair it from the retained final state, and re-author the affected lock anchors from context. Do not reopen `result.json` during this check.**Failure recovery**: stop/continue behavior for AI/web/slice/image-readiness failures is defined in [`workflows/governance/failure-recovery.md`](governance/failure-recovery.md). This Step keeps the acquisition procedure.@@ -494,7 +501,7 @@ Then **lazy-load the path-specific reference** for each row that actually needs| `ai` | `references/image-generator.md` | write `<project_path>/images/image_prompts.json`, then follow `image-generator.md §7 Path Selection` (`image_gen.py --manifest` is **Path A only**) || `web` | `references/image-searcher.md` | `python3 ${SKILL_DIR}/scripts/image_search.py ...` (≥2 web rows → `--batch images/image_queries.json`) || `slice` | `references/image-generator.md` §4.3 | derived — **after** the parent `ai` sheet row is `Generated`, run `python3 ${SKILL_DIR}/scripts/slice_images.py <project_path>/images/<sheet>.png --grid RxC --names ... --trim --alpha` (see workflow step 2.5) |-| `user` / `formula` / `placeholder` | (skip) | (skip) |+| `user` / `placeholder` | (skip) | (skip) |A deck with only `ai` rows never loads `image-searcher.md`; a deck with only `web` rows never loads `image-generator.md`. A mixed deck loads both, processes each row through its own path, and writes both `image_prompts.json` and `image_sources.json`.@@ -576,7 +583,8 @@ Keep the core's shared visual-quality defaults and `svg-effects.md` §6.1 Visual| Mandatory per-page Structure decision from §IX is `yes` | `executor-structure.md` before any geometry for the first applicable page || Actual row × column fact grid | `executor-table.md` || Used preset pattern fill, or independent Chart/Table with §IX `<object-key>=yes` | `native-data-interface.md` before that object |-| `spec_lock.md images` / §VIII has an image/formula row, or the template has bundled images | `executor-image.md` + `image-layout-spec.md` + `image-layout-patterns.md` + `svg-image-embedding.md` |+| §IX or current page content contains a structural standalone mathematical expression | `native-formula.md` before authoring its marker |+| `spec_lock.md images` / §VIII has an image row, or the template has bundled images | `executor-image.md` + `image-layout-spec.md` + `image-layout-patterns.md` + `svg-image-embedding.md` || At least one placed image is `Status: Sourced` or its filename has an `image_sources.json` record | `executor-web-image.md` after the image branch || §I records recorded/self-running/video delivery, or §X records a final/literal narration script | `video-design.md` before the first SVG; retain it through notes/motion handling || All SVG pages and SVG quality gates are complete, and the effective Speaker Notes outcome in `design_spec.md §I` is enabled | `executor-notes.md` before generating speaker notes |diff --git a/skills/ppt-master/workflows/governance/failure-recovery.md b/skills/ppt-master/workflows/governance/failure-recovery.mdindex 87bff556..114e1bd3 100644--- a/skills/ppt-master/workflows/governance/failure-recovery.md+++ b/skills/ppt-master/workflows/governance/failure-recovery.md@@ -24,7 +24,7 @@ Global stop/continue rules for all four top-level routes, plus concrete failure| Execution exposes a missing Strategist-owned role/plan detail | Yes for the affected page | Repair affected Design Spec/lock fragments under [`executor-base.md`](../../references/executor-base.md) §2.1 | Only if confirmed intent changes | Step 4 Gate 1/2 → Step 6 current page || Execution context is fresh, resumed, restarted, compacted/summary-only, external, or unknown | Yes until rebuilt | Read complete Design Spec, then lock, once; reload triggered inputs and latest completed SVG when mid-deck | No | Step 6 current page || Step 3 rejects a legacy or incomplete template contract | Yes | Stop template consumption; create a new current workspace through Create Template from the original PPTX/reference, then return with its exact workspace root | Only when required source evidence or template choices are unavailable | Create Template → Generate PPTX Step 3 |-| Formula rendering provider failure | No until the Step 7 readiness gate | Exhaust the provider chain; if unresolved, mark only the affected formula rows `Needs-Manual` and continue | Supply the exact target PNG or change formula policy | Step 4 / Step 7 image readiness gate |+| Native formula marker validation or LaTeX compilation failure | Yes for the affected page | Repair the marker metadata or source LaTeX and rerun the SVG checker; there is no formula-image fallback | Clarify the intended equation only when the source is ambiguous | Active SVG authoring step || AI image generation failure | No | `auto`: follow A → B → Offline Manual. Explicit `api` / `host-native`: retry only that path, then mark the row `Needs-Manual` without switching automated providers | Only when missing files are required before export | Step 5 / Step 7 image readiness gate || Web image search/download failure | No | Adjust query/source per image-searcher rules, then mark `Needs-Manual` if unresolved | Only if the resource is required and no acceptable substitute exists | Step 5 || Slice sheet missing | Yes for derived slice rows | Wait for parent sheet; run `slice_images.py`; rerun image analysis | Yes when sheet was manual/offline | Step 5 slice handling / Step 7 image readiness gate |diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 77bc6d27..9a5267a9 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -24,7 +24,7 @@ Page count alone never activates or blocks this profile.| Execution memory | Keep routine page, visual, and resource decisions only in the current active context; losing that context restarts Quick instead of reconstructing a plan from project files || Inputs | Any supported Generate input; convert/import sources and run bounded factual research when the input requires them || Templates | Directly validate and install at most one exact workspace root per kind supplied for this run; when none are supplied, use free design without catalog selection or Confirm UI |-| Resources | Prepare every project-local image, icon, formula, and required provenance/manifest artifact before its SVG; sound waits for §4 |+| Resources | Prepare every project-local image, icon, and required provenance/manifest artifact before its SVG; author native formula markers directly in the affected SVG; sound waits for §4 || Planning artifacts | Do not author a root project `design_spec.md`, `spec_lock.md`, confirmation payloads, or any substitute planning artifact; installed `templates/design_spec.<kind>.<id>.md` files remain template input || Traceability | Operational resource manifests, checker reports, postflight, and bounded Python command/outcome audit entries may remain, but they do not record the AI's design reasoning or form a resumable generation history || Delivery | Hand-author the resolved SVG roster, run one lockless final checker, skip `finalize_svg.py`, and export the final native PPTX through `--quick-generate` |@@ -274,9 +274,10 @@ the roster after the whole-roster check:communication job, a recognizable invariant, and deliberate variation acrossapplicable page roles; omit it when restraint serves the deck better;- the resource decisions needed for immediate preparation. Required operational- image/formula manifests may carry filenames, page relationship, status, and+ image manifests may carry filenames, page relationship, status, andgeneration/crop/focal cues, but do not create a general resource roster or an- icon-to-page assignment;+ icon-to-page assignment. Keep each selected formula's source LaTeX in active+ context for direct marker authoring; create no formula manifest or image;- the implementation path for each resource. An explicit user path wins;otherwise choose the registered automatic/default path without anotherinteraction.@@ -326,7 +327,7 @@ because Quick is expected to be faster is not.| Values, categories, time, weights, or duration determine mark geometry | Value-driven chart || Sequence, hierarchy, role, region, or relationship determines page-local topology | Qualitative structure || Rows, columns, cells, headers, merges, and alignment form the information model | Cell-grid table |-| Mathematical notation is clearer as typeset math than ordinary text | Rendered formula asset |+| Mathematical notation is clearer as typeset math than ordinary text | PowerPoint-native block formula || Typography, spacing, and simple geometry already carry the message | Use no additional visual carrier |This carrier menu does not satisfy or replace the per-page Structure decision in §3.@@ -367,7 +368,7 @@ Prepare only the resource paths needed by the decided pages:| Supplied/extracted image | Copy the selected file into `images/`; preserve its factual/provenance context and use the measured file rather than an invented substitute || Image-to-PPTX reconstruction asset | In Codex, preserve identity graphics through an exact vector, deterministic redraw, sufficient source asset, or reference-based high-resolution reconstruction; keep data graphics native-and-verified or exact. For scene imagery, build the minimum registered clean-base/midground/subject/foreground group; batch padded-bbox-disjoint objects into one shared plate, then split them with grid slicing or independent nested-SVG bbox crops || Bundled/custom icon | Follow the [icon library contract](../../templates/icons/README.md), choose one coherent primary library, sync a useful project pool covering recurring semantics and likely page-local needs without assigning icons to pages, and choose from that prepared pool during SVG authoring |-| Formula | Follow the [`latex_render.py` contract](../../scripts/docs/image.md), write `images/formula_manifest.json`, run the renderer, and keep the rendered PNG under `images/` |+| Formula | Create no resource file. Retain the exact source LaTeX and author one native formula marker under §3; ordinary SVG children provide the browser preview and are discarded by native export || AI image | Follow `image-base.md` + `image-generator.md`; apply only the chosen rendering preset or exact custom bases, never blend unselected catalog identities, and keep `image_prompts.json` plus its human-readable sidecar || Web image | Follow `image-base.md` + `image-searcher.md`; keep query/status data and `image_sources.json`, including any required on-slide attribution || Illustration slice | Generate or obtain the parent sheet, run `slice_images.py`, and place only the resulting element files |@@ -389,11 +390,12 @@ After image resources change, run `analyze_images.py` soOperational manifests and provenance are resource truth, not a hidden designstrategy.-Every required resource must reach a usable terminal state before its page.-`Needs-Manual` blocks Quick even when an unverified file exists. After manual-supply/replacement, validate evidence and reconcile to `Existing`, `Generated`,-`Sourced`, or `Rendered`; never bypass status by file presence or substitute-unrelated material.+Every required file-backed resource must reach a usable terminal state before+its page. `Needs-Manual` blocks Quick even when an unverified file exists. After+manual supply/replacement, validate evidence and reconcile to `Existing`,+`Generated`, or `Sourced`; never bypass status by file presence or substitute+unrelated material. Native formula markers are authored page content, not+file-backed resources or terminal-status rows.---@@ -414,7 +416,7 @@ without reading or inventing a nearby preset.Do not load `executor-base.md`: it owns Default's persisted-plan handoff,first-page gate, and completion routing. Excluding that file is not a capabilityexclusion; Quick loads the shared and conditional execution authorities here-directly. When any image/formula exists, read once before the first affected+directly. When any image exists, read once before the first affectedpage and reuse throughout the valid execution context:[`executor-image.md`](../../references/executor-image.md),[`image-layout-spec.md`](../../references/image-layout-spec.md),@@ -429,16 +431,18 @@ omit shape-composition reasoning. Reuse it throughout the valid executioncontext; reread only after a known file change or context invalidation.**Mandatory — per-image-page composition decision**: For every page with one-or more non-formula images, after its content and communication move are+or more images, after its content and communication move aredetermined but before choosing geometry, apply[`executor-image.md`](../../references/executor-image.md)'s active image-integrationdecision once. Keep its role, direction source, parentcontour, slot/rhythm system, image/shape action, and any continuity only inactive context; create no artifact, spec, lock, manifest, or extra pass. Adeliberate plain or equal-grid result remains valid when it communicates the-relationship better. Formula-only pages use-[`image-layout-spec.md`](../../references/image-layout-spec.md) without forcing a-multi-image system.+relationship better.++**Mandatory — native block formulas**: Quick creates no formula resource or+manifest; retain exact LaTeX in active context and author the marker plus SVG+preview directly under [`native-formula.md`](../../references/native-formula.md).Image to PPTX replaces this open composition decision for its canonical pageframe: preserve the source geometry, restore text natively, preserve@@ -465,6 +469,7 @@ capability menu, visualization recall, template geometry, or a later check.| A selected primary Chart/Table `family/key` | [`executor-visualization.md`](../../references/executor-visualization.md), then the matching Chart/Table authority || Any actual value-driven geometry, including mini/inset charts and sparklines | [`executor-chart.md`](../../references/executor-chart.md) || Any actual row × column fact grid | [`executor-table.md`](../../references/executor-table.md) |+| Any structural mathematical notation | [`native-formula.md`](../../references/native-formula.md) before authoring its marker || A used preset pattern fill, or one independent Chart/Table object selected as native-ready in active context | [`native-data-interface.md`](../../references/native-data-interface.md) before drawing that object || Any data-driven chart geometry | [`verify-charts.md`](../stages/verify-charts.md) after the complete roster and before the one final checker |@@ -612,7 +617,8 @@ or lock.- [x] All required source/resource preparation is complete- [x] One mode and visual style were resolved, and every catalog source actually used was read- [x] Every page considered the complete visual-carrier menu without a coverage quota-- [x] Every non-formula image-bearing page made its one pre-geometry composition decision+- [x] Every image-bearing page made its one pre-geometry composition decision+- [x] Every selected formula is one checker-valid native marker with a matching visible SVG preview and no formula image resource- [x] Resolved SVG pages and their project-local references exist- [x] Every role declared by an installed template spec is locatable in the finished pages, or its non-use is deliberate — checked per installed spec, not from memory- [x] Every triggered capability-specific preparation and pre-checker verification completeddiff --git a/skills/ppt-master/workflows/stages/resume-execute.md b/skills/ppt-master/workflows/stages/resume-execute.mdindex 141d7aca..78bf023f 100644--- a/skills/ppt-master/workflows/stages/resume-execute.md+++ b/skills/ppt-master/workflows/stages/resume-execute.md@@ -38,7 +38,7 @@ Verify the project's planning-session artifacts before doing anything else:| `<project_path>/spec_lock.md` | Always | Strategist's execution anchors and routing contract; read it completely once in this fresh execution context || `<project_path>/design_spec.md` | Always | Complete approved design narrative and Section IX page outline; read it completely once in this fresh execution context || `<project_path>/notes/total.md` | Design Spec §X records a supplied final/literal narration script | Frozen verbatim narration input; read it once before SVG authoring and never reconstruct it from the planning chat |-| `<project_path>/images/` plus files whose row status requires existence | `spec_lock images` references any image | `Existing` / `Generated` / `Sourced` / `Rendered` files must exist; an absent `Needs-Manual` file remains allowed until the Step 7 readiness gate |+| `<project_path>/images/` plus files whose row status requires existence | `spec_lock images` references any image | `Existing` / `Generated` / `Sourced` files must exist; an absent `Needs-Manual` file remains allowed until the Step 7 readiness gate || `<project_path>/templates/` | `spec_lock page_layouts` references any | Layout / mirror prototypes required by execution || Resolver-returned Chart/Table SVG | `spec_lock page_visualizations` or legacy `page_charts` references a live Chart/Table key | Shared page-local SVG selected through the two live catalogs |@@ -64,7 +64,7 @@ If any required artifact is missing, report it and stop this stage. Do not enter- Missing `design_spec.md` / `spec_lock.md` → use [`failure-recovery.md`](../governance/failure-recovery.md) §3.- Missing frozen `notes/total.md` when §X declares a final/literal script → return to Generate Step 4's prepared final narration branch; never rewrite the script from memory.-- Missing `images/`, or a file whose status requires existence → recover by provenance: an `Acquire Via: user` / `Status: Existing` file is a required manual artifact, so use `failure-recovery.md` §2 and wait for the user to restore that exact file; a template-bundled bitmap returns to [`generate-pptx`](../generate-pptx.md) Step 3 to restore the selected workspace; an AI, web, formula, or slice output uses its matching row in `failure-recovery.md` §1 to reacquire, rerender, or derive it. An absent `Needs-Manual` file is not a Step 1 failure.+- Missing `images/`, or a file whose status requires existence → recover by provenance: an `Acquire Via: user` / `Status: Existing` file is a required manual artifact, so use `failure-recovery.md` §2 and wait for the user to restore that exact file; a template-bundled bitmap returns to [`generate-pptx`](../generate-pptx.md) Step 3 to restore the selected workspace; an AI, web, or slice output uses its matching row in `failure-recovery.md` §1 to reacquire or derive it. An absent `Needs-Manual` file is not a Step 1 failure. Formula markers are SVG authoring content and never create a required image file.- Missing `templates/` inputs → restore the selected workspace through [`generate-pptx`](../generate-pptx.md) Step 3 and [`apply-template-workspace`](apply-template-workspace.md). If the workspace is unavailable or invalid, run Create Template again rather than reconstructing a template inside this stage.---