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
refactor(svg-authoring): adopt compact presets in templates and guidance
hugohe328f2dfa4c817
diff --git a/docs/faq.md b/docs/faq.mdindex 445b37ed..76c44ef3 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -242,7 +242,7 @@ Want to turn a PPT you love into a reusable template for PPT Master? Here's how:The recommended input is the original `.pptx`. PPT Master extracts theme identity, declared Master/Layout topology, placeholder metadata, native-shape evidence, and reusable assets. `standard` and `fidelity` use the source as visual reference and author a new SVG roster plus a new Master/Layout/slot system; they neither preserve nor distill source topology. `mirror` instead restores source slide order, Master/Layout identities and parentage, placeholder facts, and supported visuals without semantic synthesis. Fixed Master/Layout group wrappers are mechanically expanded into direct atoms because structural layers cannot be `<g>`.-Large imported SVGs may contain native-shape metadata, hidden carriers, and preview fingerprints. That lossless representation stays in the temporary analysis workspace, while the model reads a lightweight inspection projection. The projection is never an export source. `standard` / `fidelity` use compact canonical metadata. Mirror materializes from the lossless source, reuses only metadata already supported by the converter on unchanged Slide-local/slot objects, and keeps an SVG fallback for unsupported or edited objects.+Large imported SVGs may contain native-shape metadata, hidden carriers, and preview fingerprints. That lossless representation stays in the temporary analysis workspace, while the model reads a lightweight inspection projection. The projection is never an export source. `standard` / `fidelity` author project-canonical SVG and use compact authored-preset groups only for exact registered preset matches. Mirror materializes from the lossless source, reuses only metadata already supported by the converter on unchanged Slide-local/slot objects, and keeps an SVG fallback for unsupported or edited objects.If no source PPTX exists, screenshots of the key page types still work — cover, TOC, chapter, content, and closing — but geometry, fonts, and inheritance must then be inferred visually.diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.mdindex 8c44289c..64d156ee 100644--- a/docs/powerpoint-svg-mapping.md+++ b/docs/powerpoint-svg-mapping.md@@ -54,8 +54,8 @@ See [`canvas-formats.md`](../skills/ppt-master/references/canvas-formats.md) for|---|---|---|---|---|| Free-design deck structure | `pptx_structure.mode: flat`; page content remains slide-local | One clean project Master and one Blank Layout, with represented objects on slides | `Native-stable` package topology for the flat route | No authored Master/Layout/layer/placeholder metadata is allowed || Template-backed deck structure | `pptx_structure.mode: structured` plus explicit Master/Layout/page assignments | Declared `p:sldMaster`, `p:sldLayout`, registrations, and slide parentage | `Native-stable` within the explicit structure contract | The exporter never guesses a Master, Layout, or placeholder topology |-| Slide Master | Root Master identity plus atomic `data-pptx-layer="master"` objects | Reusable Master part and picker identity | Source structure is restored by template/import workflows | Master atoms must be direct, stable, and identical across their slides |-| Slide Layout | Root Layout identity plus atomic `data-pptx-layer="layout"` objects | Reusable Layout part under one Master | Source Layouts can be restored; adaptive authoring may allocate a new Layout | Reuse a Layout key only when its fixed atoms and slot contract are identical |+| Slide Master | Root Master identity plus atomic `data-pptx-layer="master"` objects; one validated compact authored-preset `<g>` counts as one semantic atom | Reusable Master part and picker identity | Source structure is restored by template/import workflows | Master atoms must be direct, stable, and identical across their slides; ordinary or expanded authored groups do not qualify |+| Slide Layout | Root Layout identity plus atomic `data-pptx-layer="layout"` objects; one validated compact authored-preset `<g>` counts as one semantic atom | Reusable Layout part under one Master | Source Layouts can be restored; adaptive authoring may allocate a new Layout | Reuse a Layout key only when its fixed atoms and slot contract are identical; ordinary or expanded authored groups do not qualify || Strict template Layout | Selected prototype contract | Existing declared Layout topology is preserved | `Native-stable` when the page follows the prototype | Fixed Layout atoms and slot structure may not change || Adaptive template Layout | Selected Master plus an explicit current or newly declared Layout | A new Layout identity may be created when reusable structure changes | `Native-stable` after the lock and page mapping are updated | Never mutate a reused Layout key silently || Slide background fill outside structured mode | First eligible full-canvas `<rect>`, direct or in a simple single-child group, with a registered solid, linear/radial gradient, or preset-pattern fill | Native slide `p:bg` | Fidelity follows the corresponding paint row below | Transform, filter, clip, rounding, visible stroke, or an unmapped fill prevents promotion |@@ -68,7 +68,7 @@ See [`canvas-formats.md`](../skills/ppt-master/references/canvas-formats.md) for| Date, footer, and slide-number placeholders | Structured text slots | `p:ph` types `dt`, `ftr`, and `sldNum`, with matching Layout header/footer flags | `Native-stable` | Placeholder indices must be unique and legal || Picture placeholder | Structured slot with one image or supported crop carrier | `p:ph` type `pic` | `Native-stable` within the picture contract | The slot must contain exactly one compatible direct carrier || Chart or table placeholder | Structured slot with one matching native-object carrier | `p:ph` type `chart` or `tbl` | `Native-stable` only on native Chart/Table export | Requires valid JSON metadata and `--native-charts-and-tables` |-| Generic object placeholder | One compatible carrier, or an explicit composite proxy binding | `p:ph` type `obj` | Native binding; composite visible content remains ordinary shapes | Composite slots must use the registered proxy downgrade |+| Generic object placeholder | One compatible carrier—including one validated compact authored-preset `<g>`—or an explicit composite proxy binding | `p:ph` type `obj` | Native binding; composite visible content remains ordinary shapes | Composite slots must use the registered proxy downgrade; expanded authored groups are not single-object carriers || Media placeholder | One image or supported crop carrier | `p:ph` type `media` | Native placeholder binding only | It does not synthesize video or audio from decorative SVG content || Empty text placeholder | Empty or whitespace-only marked text carrier | Invisible U+200B run at the legal 1 pt minimum, producing one native text shape | `Native-stable` | Do not add a dummy dash, sub-1 pt text, or background-colored visible glyph || Page role such as cover/content/ending | Flat-route root `data-pptx-page-role` compiler hint | Routing/validation hint; not a native PowerPoint page type | No independent OOXML object | Structured pages use explicit Master/Layout identity instead |@@ -87,19 +87,24 @@ Internal identifiers and PowerPoint display names are separate concerns: Master| Circle or ellipse | `<circle>` or `<ellipse>` | `a:prstGeom prst="ellipse"` | `Native-stable` | Bounds and radii must be finite and positive where required || Straight line | `<line>` | Editable line/freeform shape | `Native-normalized` | Browser-only line effects are rejected || Arrowhead line | `<line>` or supported path with registered start/end markers | Native DrawingML line head/tail ends | `Native-normalized`; marker size is approximate | Marker definitions must follow the conditional marker contract |-| Native connector | Authored preset connector fragment with connector metadata | `p:cxnSp` | Imported connectors retain compact connector metadata | `Native-stable` for the registered preset/connector schema |+| Native connector | Compact project-authored preset group with connector metadata and direct visible paths | `p:cxnSp` | Imported connectors retain the expanded round-trip evidence needed for source topology | `Native-stable` for the registered preset/connector schema || Freeform shape | `<path>` | `p:sp` with `a:custGeom` | Imported custom geometry reconstructs as a path | `Native-normalized`; SVG arcs are converted to cubic segments || Polygon | `<polygon>` | Closed custom geometry | `Native-normalized` | Points must be finite and valid || Polyline | `<polyline>` | Open custom geometry | `Native-normalized` | Points use the same finite, registered grammar as other generated geometry |-| PowerPoint preset shape | Registry-generated authored preset fragment | One editable preset `p:sp` | Preset identity and adjustments can survive import/export | Use [`preset_shape_svg.py`](../skills/ppt-master/scripts/preset_shape_svg.py); do not hand-invent metadata |-| Imported preset shape | Import metadata plus its visible SVG fallback | Restored preset when the payload is valid and unchanged | `Native-stable` within the import contract | Unsupported presets remain explicit diagnostic fallbacks, not guessed geometry |-| Action button shape | Authored `actionButton*` preset fragment | Visual preset geometry only | Shape geometry can round-trip | No click action, navigation target, or hyperlink is created |+| PowerPoint preset shape | Registry-generated compact `<g>` with preset intent/base paint and direct visible `<path>` children | One editable preset `p:sp` | Preset identity and adjustments can survive import/export | Quality check and export rerender the registry dynamically; canonical authoring has no hidden carrier, preview wrapper, or stored preview hash |+| Imported preset shape | Expanded import/round-trip group with a hidden native carrier, visible preview evidence, and freshness metadata | Restored preset when the payload is valid and unchanged | `Native-stable` within the import contract | Unsupported presets remain explicit diagnostic fallbacks, not guessed geometry |+| Action button shape | Compact authored `actionButton*` preset group | Visual preset geometry only | Shape geometry can round-trip | No click action, navigation target, or hyperlink is created || Group | `<g>` | `p:grpSp`, or a documented flatten/collapse for a special carrier | Grouped content can reconstruct as `<g>` | Structural atoms and placeholder contracts override ordinary grouping || Reused local symbol | Registered same-document `<use>` contract or project icon placeholder | Expanded editable shapes in the generated slide | Original symbol graph is not promised on import | External use, unsupported symbol features, and structural metadata reuse are rejected || Icon | `<use data-icon="library/name">` resolved by the project icon pipeline | Editable vector primitives/group after expansion | Reconstructed geometry, not the original library reference | Icon identifiers are case-sensitive and must exist in the synchronized library || SmartArt / DiagramML | No main SVG object mapping | Main redesign route may rebuild the meaning with ordinary shapes | `Direct preservation` in native/template routes; otherwise a preview or explicit fallback | Do not label a decorative group as native SmartArt |-Preset-shape selection and its exact atomic fragment contract are documented in [`native-shape-authoring.md`](../skills/ppt-master/references/native-shape-authoring.md).+Project-authored presets deliberately use a compact representation, while PPTX+import keeps the expanded evidence needed for lossless round-trip decisions.+The exact machine contract remains in+[`shared-standards.md`](../skills/ppt-master/references/shared-standards.md), and+preset selection and authoring behavior are documented in+[`native-shape-authoring.md`](../skills/ppt-master/references/native-shape-authoring.md).## 4. PowerPoint text features@@ -219,11 +224,11 @@ The importer reconstructs supported PowerPoint semantics into the same project v| PowerPoint source object | Project SVG reconstruction ||---|---|-| Preset shape | SVG primitive/path plus compact preset metadata when supported |+| Preset shape | Expanded preset group with native carrier and visible preview evidence when supported || Custom geometry | `<path>` || Text body | `<text>` and `<tspan>` runs/paragraphs || Picture | `<image>`, or the registered nested crop representation |-| Connector | Line/path plus connector metadata |+| Connector | Expanded line/path preview plus connector/frame/topology evidence || Group | `<g>` || Supported native table/chart | Visible fallback plus native-object metadata || Unsupported graphic frame or SmartArt | Explicit preview, placeholder, or unsupported status |diff --git a/docs/roadmap.md b/docs/roadmap.mdindex 1bd8182c..60c64d08 100644--- a/docs/roadmap.md+++ b/docs/roadmap.md@@ -86,7 +86,7 @@ The past two months' structural capability growth. Single flags / incremental po- **Native package structure + mode-specific template creation** — deck/layout-template SVG pages declare their final Master/Layout identity while they are authored. Fixed Master/Layout visuals are root-level atoms, reusable slots are bounded top-level groups with real carriers or an explicit composite proxy, and zero-slot Layouts remain valid. Structured export deterministically compiles only that contract and performs final package read-back; it never promotes repeated chrome or infers placeholders. Flat free-design/brand-only export keeps all content Slide-local while replacing the stock Office scaffold with one clean project-owned Master and Blank Layout plus a deck-named current-lock theme. It removes title/body and other stock content, prunes unused Layouts, and retains only the standard date/footer/slide-number capability hooks. Both generated routes write the locked title plus a deterministic nine-level body hierarchy into Master `p:txStyles`, preserving paragraph and bullet settings. `standard` / `fidelity` author new SVG rosters and new Master/Layout systems without preserving or distilling source topology. `mirror` restores the complete supported source graph—including definition-only prototypes for unused Layouts—without semantic synthesis; fixed-layer source groups are mechanically expanded into direct atoms. Lossless imports stay in analysis and lightweight projections stay inspection-only. Library and project outputs share required `templates/`, optional `images/` / `icons/`, and optional on-demand review output in `exports/`; only library registration differs. Legacy baseline/template/preserve SVG packages first run `restore-pptx-structure`. Raw one-off PPTX filling remains `template-fill-pptx`.-- **Native-preset authoring guidance strengthened across roles** — using a real PowerPoint preset (`prstGeom`, with adjustment handles and the non-flat-card look) is reaffirmed as the default for stock geometry (block arrows, chevrons, banners, callouts, flowchart nodes, stars), not an exception. Presets are helper-generated per page (`preset_shape_svg.py`), so the guidance lives in the prompt layer, not in template exemplars: the Executor now reaches for presets inside the per-page authoring ritual — decided by object intent at draw time, never by scanning finished paths — with the accurate paint boundary spelled out (a gradient fill/stroke or pattern fill stays ordinary SVG because the helper paints `none` or a solid HEX on both fill and stroke only). The Strategist primes it upstream by appending a non-destructive `native-preset candidate` note to a §VII page's Usage, triggered by the page plan rather than a template's name; the Executor still selects the exact preset, frame, and paint. Baking preset fragments into `templates/charts/` was evaluated and rejected — a frozen frame/fingerprint invites verbatim copy, which the authoring contract forbids+- **Native-preset authoring guidance strengthened across roles** — using a real PowerPoint preset (`prstGeom`, with adjustment handles and the non-flat-card look) is reaffirmed as the default for stock geometry (block arrows, chevrons, banners, callouts, flowchart nodes, stars), not an exception. New pages and project-owned templates use the compact atomic `<g>` emitted by `preset_shape_svg.py`: the group owns the preset metadata and base paint once, while its direct visible paths are registry-derived layers with only necessary per-layer paint overrides. The authoring form has no hidden carrier, preview wrapper, or stored fingerprint; it is helper-only, and any change to preset, frame, adjustments, or paint regenerates the whole group instead of editing paths or metadata. A matching compact fragment may therefore live in `templates/charts/` when it expresses an intentional stock shape. The Executor still decides by object intent at draw time rather than scanning finished paths, and the paint boundary remains narrow: gradient fill/stroke or pattern fill stays ordinary SVG. PPTX import and `mirror` keep the separate expanded lossless representation. The Strategist continues to prime likely pages with a non-destructive `native-preset candidate` note; the Executor selects the exact preset, frame, and paint---@@ -96,7 +96,7 @@ Directions actively underway or up next, with no committed timeline.- **Real-usage calibration of multi-deck intake and material divergence (just landed)** — multi-deck combined intake (`<stem>` prefixing + a `decks[]` merge index) and the material-divergence free-text field (under §c audience) both shipped (see "2026-06" above); next is calibration from real usage: same-stem collisions across decks currently let the later one overwrite the former — whether dedupe / numbering is needed awaits signal; and whether the Strategist reads the free-text intent accurately, and whether the "facts stay sourced" line holds when the user asks for free reshaping, awaits real generation. Neither gets a mechanical threshold added pre-emptively- **Real-deck calibration of the illustration capability (mechanism + deployment layer, just landed)** — the slice pipeline, the edge-quality hardening, and the decision layer (style propensity / motif through-line / roles map — see "2026-06" above) have all shipped; next is calibration from real usage: whether one sheet sliced into many cells holds style / palette consistency and how robust the `--alpha` soft mask is against irregular composition inside a cell, the offline readiness-gate manual-place + re-slice experience, whether propensity flips the styles it should, whether the motif reads as a designed system rather than over-decoration on real decks, and whether the source boundary holds (no silent AI on `provided` / `web`). No mechanical threshold / quota added pre-emptively; if same-size tiles really recur, consider a narrower lint then-- **Native drop-shadow on presets — deferred as a separate enhancement** — a supported drop-shadow can technically coexist with a native preset (the effect inherits to the hidden carrier and exports as `prstGeom` + `outerShdw`), but only with exact nesting: an id'd logical group wrapping a **no-id single-child** `<g filter="url(#id)">`. The naive form (filter on the top-level id'd group) silently emits a double `outerShdw`, and `shared-standards` currently forbids a filter on a multi-element `<g>`. So presets-with-shadow is deliberately not folded into the current preset guidance — shadowed stock shapes conservatively stay ordinary SVG. Doing it right needs a precise structure spec plus a `shared-standards` / `native-shape-authoring` sweep, and possibly a checker rule to catch the double-shadow; taken up only on real signal+- **Native drop-shadow on authored presets — deferred as a separate enhancement** — the compact authored-preset `<g>` is a closed semantic atom and currently admits only its registered preset metadata, base paint, and direct registry paths; `filter` / effect metadata is not part of that authoring contract. The converter may expand the atom into its established carrier/preview transport internally, but that implementation detail is not a source-SVG API. Imported PPTX and `mirror` may retain supported source effects in the separate expanded lossless representation; that does not widen new authoring. Until a precise preset-effect contract and matching checker coverage exist, a stock shape that needs a shadow conservatively stays ordinary SVG. This remains signal-driven rather than an implied capability- Otherwise: the mode / visual-style validation and calibration is settled (see "2026-06" above) — the structure (5 modes + 18 visual-styles + custom) is locked, the four adjacent pairs are consolidated into one Close-calls table, and the four calibration tightenings have landed. Future direction is driven by real usage signal and feedback; long-running improvements are under "Ongoing maintenance" below, and evaluated-out directions under "Non-goals"---diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 97869d1d..8b52b329 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -502,7 +502,7 @@ These direct routes share some analysis primitives with the main pipeline, espec**Why per-element dispatch, not whole-file translation.** SVG's hierarchical model maps cleanly onto DrawingML's group / shape / picture types — there's no need for a holistic optimizer that re-plans the slide. Each shape kind gets its own narrow translator, which keeps each translator simple enough to debug and unit-test in isolation. The output quality of a slide is the sum of independent local conversions; that property is fragile under whole-file translation but robust under element dispatch.-**Why imported and authored shape metadata are separate.** A lossless imported SVG may need native-shape metadata, hidden carriers, and preview fingerprints to recover an advanced PowerPoint shape. That representation stays in the temporary analysis workspace. `svg_authoring_view.py` creates a lightweight inspection projection without opaque payload or duplicate hidden carriers; the projection is never an export source. `standard` / `fidelity` use compact canonical metadata. Mirror materializes from the lossless source and may reuse converter-supported metadata on unchanged Slide-local/slot objects; fixed structural layers remain direct atoms, and unsupported or edited objects keep their current SVG fallback.+**Why imported and authored shape metadata are separate.** A lossless imported SVG may need native-shape metadata, hidden carriers, and preview fingerprints to recover an advanced PowerPoint shape. That representation stays in the temporary analysis workspace. `svg_authoring_view.py` creates a lightweight inspection projection without opaque payload or duplicate hidden carriers; the projection is never an export source. `standard` / `fidelity` author project-canonical SVG and use the compact authored-preset group only for exact registered preset matches. Mirror materializes from the lossless source and may reuse converter-supported metadata on unchanged Slide-local/slot objects; fixed structural layers remain direct atoms, and unsupported or edited objects keep their current SVG fallback.**Why there is only one PPTX compiler route.** Native export reads authored SVGs and translates supported SVG elements into DrawingML shapes. The normal deck path reads `svg_output/`; when requested, create-template invokes the same structured compiler on validated template prototypes to produce `exports/<id>_template_preview.pptx` as review evidence. The project does not package whole-slide SVG media or alternate raster renderings into a second PPTX. `svg_final/` is still generated on every standard deck run, but it is a self-contained visual-preview artifact rather than a PPTX source; users may insert it as an SVG picture, while PowerPoint's manual Convert to Shape command remains outside the supported contract.diff --git a/docs/templates-architecture.md b/docs/templates-architecture.mdindex d0b51372..28b0e3e0 100644--- a/docs/templates-architecture.md+++ b/docs/templates-architecture.md@@ -65,7 +65,7 @@ Both roots have the same core shape:Empty optional directories are omitted; do not add placeholder files. An on-demand preview PPTX is derived review evidence, not a source template asset. Step 3 reads the workspace root and consumes `templates/` plus any existing `images/` and `icons/`; it ignores `exports/`. Library `exports/` directories are Git-ignored.-PPTX import uses a two-level metadata model. The temporary lossless SVG keeps native-shape metadata, hidden carriers, and preview evidence; `svg_authoring_view.py` creates a lightweight model-facing projection without opaque payload or duplicate hidden carriers. The projection is never an export source. Authored modes use compact canonical metadata. Mirror may reuse converter-supported metadata on unchanged Slide-local/slot objects; fixed structural layers remain direct atoms, and unsupported or edited objects keep their SVG fallback. Export compiles only the declared SVG structure and never infers ownership.+PPTX import uses a two-level metadata model. The temporary lossless SVG keeps native-shape metadata, hidden carriers, and preview evidence; `svg_authoring_view.py` creates a lightweight model-facing projection without opaque payload or duplicate hidden carriers. The projection is never an export source. Authored modes use project-canonical SVG and compact authored-preset groups only for exact registered preset matches. Mirror may reuse converter-supported metadata on unchanged Slide-local/slot objects; fixed structural layers remain direct atoms, and unsupported or edited objects keep their SVG fallback. Export compiles only the declared SVG structure and never infers ownership.Both scopes retain `kind: layout` or `kind: deck` in portable frontmatter. `output_scope` and `target_project` stay in the workflow brief and are not persisted into `design_spec.md`.diff --git a/docs/templates-guide.md b/docs/templates-guide.mdindex 2d44365e..b4037568 100644--- a/docs/templates-guide.md+++ b/docs/templates-guide.md@@ -172,7 +172,7 @@ This is the most easily confused decision when deriving a template.**About sprite sheets**: PPTX-exported assets are often a single large image referenced from multiple slides, each cropping a different region via nested `<svg viewBox=...>` wrappers. In `fidelity` and `mirror` modes this nesting must be preserved — you cannot flatten it to a bare `<image>`, or the crop is lost and the page misaligns. The workflow validates this automatically.-**About native PowerPoint shapes**: the lossless import SVG stays in the temporary analysis workspace, while the model works from a lightweight projection that omits opaque payload and duplicate hidden carriers. The projection is never an export source. Authored modes use compact canonical metadata. Mirror may reuse converter-supported metadata on unchanged Slide-local/slot objects; fixed Master/Layout layers remain direct atoms, and unsupported or edited objects keep the current SVG fallback.+**About native PowerPoint shapes**: the lossless import SVG stays in the temporary analysis workspace, while the model works from a lightweight projection that omits opaque payload and duplicate hidden carriers. The projection is never an export source. Authored modes use project-canonical SVG and compact authored-preset groups only for exact registered preset matches. Mirror may reuse converter-supported metadata on unchanged Slide-local/slot objects; fixed Master/Layout layers remain direct atoms, and unsupported or edited objects keep the current SVG fallback.**Mirror graph boundary**: mirror preserves the complete supported source Master/Layout graph. It emits one complete prototype per source slide and one definition-only `layout_<layout_key>.svg` prototype for every source Layout unused by those slides. The latter registers in PowerPoint through the independent Layout roster without becoming a published page; its parent Master is retained with it. Preflight stops only when required source facts or supported geometry are missing, never merely because a Layout is unused.diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 37c70084..9b63edaf 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -246,7 +246,7 @@ beautify 和主管线的一句话判别:**原来的分页是要保留的信息**最推荐的方式是直接给原始 `.pptx` 文件**。PPT Master 会提取主题色、字体、Master/Layout、placeholder type/idx、原生形状信息和可复用图片资源。`standard` 与 `fidelity` 把来源当作视觉参考,重新设计 SVG roster 和新的 Master/Layout/slot 系统,不保留、也不蒸馏来源拓扑。`mirror` 则按来源页序恢复 Master/Layout 身份与父子关系、placeholder 事实和受支持的视觉对象,不做语义归纳。由于结构层禁止 `<g>`,来源 Master/Layout 的 group wrapper 只允许机械展开成直接原子。-完整导入 SVG 可以保留高级 PowerPoint 形状所需的 metadata、隐藏 carrier 和预览指纹,但模型只读取轻量 inspection projection;projection 永远不是导出源。`standard` / `fidelity` 使用紧凑 canonical metadata。Mirror 从无损来源物化,只在未改的 Slide-local/slot 对象上复用转换器已经支持的 metadata;不支持或已修改的对象保留当前 SVG fallback。+完整导入 SVG 可以保留高级 PowerPoint 形状所需的 metadata、隐藏 carrier 和预览指纹,但模型只读取轻量 inspection projection;projection 永远不是导出源。`standard` / `fidelity` 创作项目规范化 SVG,只有精确匹配已登记 preset 时才使用 compact authored-preset 组。Mirror 从无损来源物化,只在未改的 Slide-local/slot 对象上复用转换器已经支持的 metadata;不支持或已修改的对象保留当前 SVG fallback。没有源 PPTX 时,截图集也能跑(`cover.png` / `toc.png` / `chapter.png` / `content.png` / `closing.png`),但保真度会明显下降。建议优先找原始 PPTX。diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.mdindex 9222e50b..49887b7b 100644--- a/docs/zh/powerpoint-svg-mapping.md+++ b/docs/zh/powerpoint-svg-mapping.md@@ -54,8 +54,8 @@ PowerPoint 意图|---|---|---|---|---|| 自由设计演示文稿结构 | `pptx_structure.mode: flat`;页面内容保持 Slide-local | 一个干净的项目 Master 和一个 Blank Layout,已表达对象留在 Slide | flat 路线包拓扑为 `Native-stable` | 禁止编写 Master/Layout/layer/placeholder metadata || 基于模板的演示文稿结构 | `pptx_structure.mode: structured` 加显式 Master/Layout/页面分配 | 声明的 `p:sldMaster`、`p:sldLayout`、注册与 Slide 父子关系 | 在显式结构合同内为 `Native-stable` | 导出器绝不猜测 Master、Layout 或占位符拓扑 |-| 幻灯片母版 | 根 Master 身份加原子级 `data-pptx-layer="master"` 对象 | 可复用 Master part 与 picker 身份 | 源结构由模板/导入工作流恢复 | Master atom 必须为直接、稳定对象,并在所属页面间一致 |-| 幻灯片版式 | 根 Layout 身份加原子级 `data-pptx-layer="layout"` 对象 | 某个 Master 下的可复用 Layout part | 可恢复源 Layout;adaptive 创作可分配新 Layout | 仅当固定 atom 和 slot 合同完全相同时才复用 Layout key |+| 幻灯片母版 | 根 Master 身份加原子级 `data-pptx-layer="master"` 对象;一个校验通过的 compact authored-preset `<g>` 计为一个 semantic atom | 可复用 Master part 与 picker 身份 | 源结构由模板/导入工作流恢复 | Master atom 必须为直接、稳定对象,并在所属页面间一致;普通组或 expanded authored 组不具备该资格 |+| 幻灯片版式 | 根 Layout 身份加原子级 `data-pptx-layer="layout"` 对象;一个校验通过的 compact authored-preset `<g>` 计为一个 semantic atom | 某个 Master 下的可复用 Layout part | 可恢复源 Layout;adaptive 创作可分配新 Layout | 仅当固定 atom 和 slot 合同完全相同时才复用 Layout key;普通组或 expanded authored 组不具备该资格 || strict 模板 Layout | 选中的原型合同 | 保留现有已声明 Layout 拓扑 | 页面遵循原型时为 `Native-stable` | 不得改变固定 Layout atom 和 slot 结构 || adaptive 模板 Layout | 选定 Master 加显式的当前或新声明 Layout | 可在可复用结构变化时创建新 Layout 身份 | 更新 lock 与页面映射后为 `Native-stable` | 绝不默默改变已复用 Layout key || structured 模式以外的 Slide 背景填充 | 第一个合格的全幅 `<rect>`,可直接位于根下或位于简单单子组中,使用已登记纯色、线性/径向渐变或预设图案填充 | Slide 的原生 `p:bg` | 保真度遵循下文对应 paint 行 | transform、filter、clip、圆角、可见 stroke 或未映射 fill 会阻止提升 |@@ -68,7 +68,7 @@ PowerPoint 意图| 日期、页脚与页码占位符 | 结构化文本 slot | `dt`、`ftr` 与 `sldNum` 类型 `p:ph`,带匹配的 Layout 页眉/页脚标志 | `Native-stable` | 占位符 index 必须唯一且合法 || 图片占位符 | 含一个图片或受支持 crop carrier 的结构化 slot | `pic` 类型 `p:ph` | 在图片合同内为 `Native-stable` | slot 必须恰好含一个兼容的直接 carrier || 图表或表格占位符 | 含一个匹配原生对象 carrier 的结构化 slot | `chart` 或 `tbl` 类型 `p:ph` | 仅原生 Chart/Table 导出时为 `Native-stable` | 需要合法 JSON metadata 与 `--native-charts-and-tables` |-| 通用对象占位符 | 一个兼容 carrier,或显式复合 proxy binding | `obj` 类型 `p:ph` | 原生 binding;复合可见内容仍为普通 shape | 复合 slot 必须使用已登记 proxy 降级方案 |+| 通用对象占位符 | 一个兼容 carrier(可为一个校验通过的 compact authored-preset `<g>`),或显式复合 proxy binding | `obj` 类型 `p:ph` | 原生 binding;复合可见内容仍为普通 shape | 复合 slot 必须使用已登记 proxy 降级方案;expanded authored 组不能作为单对象 carrier || 媒体占位符 | 一个图片或受支持 crop carrier | `media` 类型 `p:ph` | 仅为原生占位符 binding | 不会从装饰性 SVG 内容生成视频或音频 || 空文本占位符 | 空或仅空白的已标记 text carrier | 使用合法 1 pt 下限的不可见 U+200B run,生成一个原生文本 shape | `Native-stable` | 不得添加假破折号、小于 1 pt 的文字或与背景同色的可见字符 || cover/content/ending 等页面角色 | flat 路线根 `data-pptx-page-role` 编译提示 | 路由/校验提示;不是 PowerPoint 原生页面类型 | 没有独立 OOXML 对象 | structured 页面改用显式 Master/Layout 身份 |@@ -87,19 +87,19 @@ PowerPoint 意图| 圆或椭圆 | `<circle>` 或 `<ellipse>` | `a:prstGeom prst="ellipse"` | `Native-stable` | 需要时,bounds 和 radius 必须有限且为正 || 直线 | `<line>` | 可编辑 line/freeform shape | `Native-normalized` | 拒绝浏览器专属 line 效果 || 带箭头的线 | 带已登记起点/终点 marker 的 `<line>` 或受支持 path | 原生 DrawingML 线首/线尾 | `Native-normalized`;marker 大小为近似 | marker 定义必须遵循条件 marker 合同 |-| 原生连接符 | 带 connector metadata 的已创作 preset connector 片段 | `p:cxnSp` | 导入 connector 保留紧凑 metadata | 已登记 preset/connector schema 内为 `Native-stable` |+| 原生连接符 | 带 connector metadata 和直接可见 path 的项目创作 compact preset 组 | `p:cxnSp` | 导入 connector 保留源拓扑往返所需的 expanded 证据 | 已登记 preset/connector schema 内为 `Native-stable` || 任意多边形 | `<path>` | 带 `a:custGeom` 的 `p:sp` | 导入自定义几何重建为 path | `Native-normalized`;SVG arc 转为三次曲线段 || 多边形 | `<polygon>` | 闭合自定义几何 | `Native-normalized` | points 必须有限且合法 || 折线 | `<polyline>` | 开放自定义几何 | `Native-normalized` | points 使用与其他生成几何相同的有限、已登记语法 |-| PowerPoint 预设形状 | 由 registry 生成的 authored preset 片段 | 一个可编辑 preset `p:sp` | preset 身份与 adjustment 可以经导入/导出保留 | 使用 [`preset_shape_svg.py`](../../skills/ppt-master/scripts/preset_shape_svg.py);不得手工发明 metadata |-| 导入的预设形状 | 导入 metadata 加可见 SVG fallback | payload 合法且未改变时恢复 preset | 在导入合同内为 `Native-stable` | 不支持的 preset 保留为显式诊断 fallback,不猜测几何 |-| 动作按钮形状 | authored `actionButton*` preset 片段 | 仅生成可见 preset 几何 | 形状几何可往返 | 不创建单击动作、导航目标或超链接 |+| PowerPoint 预设形状 | 由 registry 生成的 compact `<g>`,由该组承载 preset 意图与基础 paint,并直接包含可见 `<path>` 子元素 | 一个可编辑 preset `p:sp` | preset 身份与 adjustment 可以经导入/导出保留 | 质检与导出动态重渲染 registry;规范创作表达不含隐藏 carrier、preview wrapper 或已存储 preview hash |+| 导入的预设形状 | 含隐藏原生 carrier、可见 preview 证据与新鲜度 metadata 的 expanded 导入/往返组 | payload 合法且未改变时恢复 preset | 在导入合同内为 `Native-stable` | 不支持的 preset 保留为显式诊断 fallback,不猜测几何 |+| 动作按钮形状 | compact authored `actionButton*` preset 组 | 仅生成可见 preset 几何 | 形状几何可往返 | 不创建单击动作、导航目标或超链接 || 组 | `<g>` | `p:grpSp`,或对特殊 carrier 执行文档化的 flatten/collapse | 分组内容可重建为 `<g>` | 结构 atom 与 placeholder 合同优先于普通分组 || 复用本地 symbol | 已登记的同文档 `<use>` 合同或项目 icon placeholder | 在生成 Slide 中展开为可编辑 shape | 回导不承诺恢复原 symbol 图 | 拒绝外部 use、不受支持的 symbol 能力和结构 metadata 复用 || 图标 | 由项目图标管线解析的 `<use data-icon="library/name">` | 展开后的可编辑矢量原语/组 | 重建几何,不恢复原图标库引用 | 图标标识区分大小写,必须存在于已同步图标库 || SmartArt / DiagramML | 无主 SVG 对象映射 | 主重设计路线可以用普通 shape 重建语义 | 原生/模板路线中为 `Direct preservation`,否则为 preview 或显式 fallback | 不得将装饰性组标记为原生 SmartArt |-preset 形状选择与精确原子片段合同见 [`native-shape-authoring.md`](../../skills/ppt-master/references/native-shape-authoring.md)。+项目创作 preset 有意采用 compact 表达,而 PPTX 导入继续保留无损往返裁决所需的 expanded 证据。精确机器合同仍属于 [`shared-standards.md`](../../skills/ppt-master/references/shared-standards.md),preset 选择与创作行为见 [`native-shape-authoring.md`](../../skills/ppt-master/references/native-shape-authoring.md)。## 4. PowerPoint 文本功能@@ -219,11 +219,11 @@ sidecar 工作流见 [`animations.md`](../../skills/ppt-master/references/animat| PowerPoint 源对象 | 项目 SVG 重建 ||---|---|-| 预设形状 | SVG 原语/path,受支持时加紧凑 preset metadata |+| 预设形状 | 受支持时重建为含原生 carrier 与可见 preview 证据的 expanded preset 组 || 自定义几何 | `<path>` || 文本体 | `<text>` 与 `<tspan>` run/段落 || 图片 | `<image>`,或已登记嵌套 crop 表达 |-| 连接符 | 线/path 加 connector metadata |+| 连接符 | expanded 线/path preview 加 connector/frame/topology 证据 || 组 | `<g>` || 受支持原生表格/图表 | 可见 fallback 加原生对象 metadata || 不支持的 graphic frame 或 SmartArt | 显式 preview、placeholder 或 unsupported 状态 |diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.mdindex f6753777..26751865 100644--- a/docs/zh/roadmap.md+++ b/docs/zh/roadmap.md@@ -86,7 +86,7 @@- **原生 package 结构 + 按模式创建模板** — deck/layout-template SVG 页面在创作时就声明最终 Master/Layout 身份。固定 Master/Layout 视觉是根级原子,可复用槽位是带真实 carrier 或显式 composite proxy 的有界顶层 group,零槽位 Layout 也合法。`structured` 导出只确定性编译该合同并执行最终 package 回读;不提升重复 chrome,也不推断 placeholder。`flat` 自由设计 / brand-only 导出则保持所有内容 Slide-local,同时把 stock Office 脚手架替换成一个属于项目的干净 Master、一个 Blank Layout 和按 deck 命名的当前 lock 主题;删除 title/body 等 stock 内容、裁掉未使用 Layout,仅保留标准日期、页脚和页码能力钩子。两条生成路线都把锁定 title 与确定性的九级 body 层级写入母版 `p:txStyles`,同时保留段落和项目符号设置。`standard` / `fidelity` 重新创作 SVG roster 和新的 Master/Layout 系统,不保留、也不蒸馏来源拓扑。`mirror` 恢复完整且受支持的来源图谱,包括未使用 Layout 的定义专用原型;固定结构层的来源 group 只允许机械展开成直接原子,不做语义归纳。无损导入保留在分析区,轻量 projection 仅供检查。`library` 与 `project` 都要求 `templates/`,`images/` / `icons/` 可选,`exports/` 仅在按需生成评审文件时出现;只有全局注册不同。旧 baseline/template/preserve SVG 包先运行 `restore-pptx-structure`;原始 PPTX 的一次性回填仍走 `template-fill-pptx`。-- **原生预设授权引导跨角色强化** — 用真正的 PowerPoint 预设(`prstGeom`,带调节手柄、非扁平卡片外观)被重申为库存几何(块箭头、chevron、横幅、标注、流程节点、星形)的**默认**而非例外。预设是每页由 helper(`preset_shape_svg.py`)现生成的,所以引导落在提示词层而非模板示范:Executor 现在在逐页作图仪式内主动够预设——按对象意图在画图当下决定,绝不扫描已完成路径——并写明准确的 paint 边界(渐变填充/描边或 pattern 填充保持普通 SVG,因为 helper 只对 fill 和 stroke 画 `none` 或纯色 HEX)。Strategist 在上游预热:给 §VII 页面的 Usage **追加**一条非破坏性的 `native-preset candidate` 注记,按页面计划而非模板名触发;Executor 仍自定具体预设、frame 与 paint。把预设片段烤进 `templates/charts/` 经评估否决——冻死的 frame/fingerprint 会诱导原样复制,违反授权契约+- **原生预设创作引导跨角色强化** — 用真正的 PowerPoint 预设(`prstGeom`,带调节手柄、非扁平卡片外观)被重申为库存几何(块箭头、chevron、横幅、标注、流程节点、星形)的**默认**而非例外。新页面与项目自有模板使用 `preset_shape_svg.py` 输出的 compact 原子 `<g>`:group 只写一次 preset metadata 与基础 paint,直接可见 path 是 registry 派生层,只保留必要的分层 paint 覆盖。创作形式没有 hidden carrier、preview wrapper 或持久化 fingerprint;只允许通过 helper 生成,preset、frame、adjustment 或 paint 任一变化都整体重生成,不手改 path 或 metadata。因此,当 compact 片段明确表达所需库存形状时,可以保存在 `templates/charts/` 中。Executor 仍按对象意图在画图当下决定,绝不扫描已完成路径;paint 边界保持收窄:渐变填充/描边或 pattern 填充仍用普通 SVG。PPTX 导入与 `mirror` 继续使用另一套 expanded 无损表达。Strategist 仍给可能适用的 §VII 页面追加非破坏性的 `native-preset candidate` 注记;具体 preset、frame 与 paint 由 Executor 选择---@@ -96,7 +96,7 @@- **多 deck intake 与材料发散度的真实使用校准(刚落地)** — 多 deck 合并 intake(`<stem>` 前缀 + `decks[]` 合并索引)与材料发散度自由文字项(§c 受众下)均已上线(见上「2026-06」),接下来按真实使用信号校准:多份源 deck 同名(stem 冲突)的处理目前是后者覆盖前者,是否需要去重 / 加序号待信号;发散度的自由文字让 Strategist 判得准不准、放开写时「事实守源」边界守不守得住,待真实生成验证。两者都不预先加机械阈值- **插画能力(机制 + 部署层)的真实 deck 校准(刚落地)** — 切片管线、边缘质量收紧,以及决策层(风格倾向 / 贯穿母题 / 角色地图,见上「2026-06」)均已上线,接下来按真实使用信号校准:一次大图切多格的风格 / 色板一致性与 `--alpha` 软蒙版对格内不规则构图的鲁棒性、离线 readiness gate 的手动放图 + 重切体验、风格倾向是否翻对了该翻的风格、母题在真实 deck 上读成「设计系统」还是「过度装饰」、以及 source 边界(provided/web 不静默生成 AI)守得住否。不预先加机械阈值 / 配额;同尺寸瓷砖若真反复出现再考虑更窄的 lint-- **预设上的原生投影——作为独立增强延后** — 受支持的投影技术上能与原生预设共存(效果继承到 hidden carrier,导出为 `prstGeom` + `outerShdw`),但只有精确嵌套才对:带 id 的逻辑组包一层**无 id 单子** `<g filter="url(#id)">`。天真写法(filter 挂在顶层带 id 组上)会静默产生双 `outerShdw`,且 `shared-standards` 目前禁止在多元素 `<g>` 上加 filter。因此预设带阴影刻意不并入当前预设引导——带阴影的库存形状保守留普通 SVG。要做对需精确结构规范 + `shared-standards` / `native-shape-authoring` 全仓 sweep,可能再加一条 checker 规则抓双阴影;按真实信号再启动+- **创作预设上的原生投影——作为独立增强延后** — compact authored-preset `<g>` 是封闭的语义原子,当前只允许已登记的 preset metadata、基础 paint 和直接 registry path;`filter` / effect metadata 不在创作合同内。转换器可能在内部把该原子展开为既有 carrier/preview 传输结构,但那是实现细节,不是源 SVG 接口。PPTX 导入与 `mirror` 可以在另一套 expanded 无损表达中保留受支持的来源效果,但这不会放宽新创作合同。在形成精确的 preset-effect 合同并补齐 checker 覆盖前,需要阴影的库存形状保守留普通 SVG;是否扩展继续以真实需求为依据,不把它表述成现有能力- 其余:mode / visual-style 体系的验证与校准已收口(见上「2026-06」),结构(5 mode + 18 visual-style + custom)定型、四对近邻消歧并成一张 Close-calls 表、四项校准收紧已落地。后续方向由真实使用信号与反馈驱动;长期改进见下「持续维护方向」,已评估不做的见「明确不做」---diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex 7933ba11..87ede261 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -504,7 +504,7 @@ PowerPoint 的 DrawingML 是 SVG 表达力的严格子集,因此主编译路**为什么是逐元素派发而不是整体翻译。** SVG 的层级模型干净地映射到 DrawingML 的 group / shape / picture 类型——不需要一个全局优化器去重新规划幻灯片。每种形状都有自己窄的翻译器,简单到能单独调试和单元测试。一张幻灯片的最终质量等于这些独立局部转换之和;这个性质在整体翻译下脆弱,在元素派发下稳健。-**为什么导入型与生成型 metadata 分层。** 导入 PPTX 时,完整 SVG 可以携带高级形状所需的 metadata、隐藏 carrier 和预览指纹,但这类载荷不适合直接进入模型上下文。authoring projection 会非破坏性地移除大体积载荷,只保留可见几何和紧凑意图,而且永远不是导出源。`standard` / `fidelity` 使用 compact canonical metadata。Mirror 从无损来源物化,可在未改的 Slide-local/slot 对象上复用转换器已经支持的 metadata;固定结构层保持直接原子,不支持或已修改的对象保留当前 SVG fallback。+**为什么导入型与生成型 metadata 分层。** 导入 PPTX 时,完整 SVG 可以携带高级形状所需的 metadata、隐藏 carrier 和预览指纹,但这类载荷不适合直接进入模型上下文。authoring projection 会非破坏性地移除大体积载荷,只保留可见几何和紧凑意图,而且永远不是导出源。`standard` / `fidelity` 创作项目规范化 SVG,只有精确匹配已登记 preset 时才使用 compact authored-preset 组。Mirror 从无损来源物化,可在未改的 Slide-local/slot 对象上复用转换器已经支持的 metadata;固定结构层保持直接原子,不支持或已修改的对象保留当前 SVG fallback。**为什么只有一条 PPTX 编译路线。** Native 导出把作者 SVG 中受支持的元素逐个翻译成 DrawingML 形状。常规 deck 路线读取 `svg_output/`;用户需要时,create-template 对通过校验的模板原型调用同一 structured 编译器,生成 `exports/<id>_template_preview.pptx` 作为审阅证据。项目不会把整页 SVG 媒体或另一套位图渲染打包成第二类 PPTX。`svg_final/` 仍由常规 deck 的强制后处理生成,但只承担自包含视觉预览和 SVG 图片插入,不为 PowerPoint 手工“转换为形状”提供兼容兜底。diff --git a/docs/zh/templates-architecture.md b/docs/zh/templates-architecture.mdindex 060f975a..1b60f145 100644--- a/docs/zh/templates-architecture.md+++ b/docs/zh/templates-architecture.md@@ -67,7 +67,7 @@ native_structure_mode: structured空的可选目录直接省略,不添加占位文件。按需生成的预览 PPTX 是派生审阅证据,不是模板源资产。Step 3 读取工作区根目录,只消费 `templates/` 及实际存在的 `images/`、`icons/`,不会复制或使用 `exports/`;全局库下的 `exports/` 统一由 Git 忽略。-原生形状 metadata 采用两级模型。完整导入 SVG 保存 native metadata、隐藏 carrier 和预览证据;轻量 authoring projection 移除大体积载荷与重复 carrier,只供模型检查,永远不是导出源。创作模式使用紧凑 canonical metadata。Mirror 可在未改的 Slide-local/slot 对象上复用转换器已经支持的 metadata;固定结构层保持直接原子,不支持或已修改的对象保留 SVG fallback。导出只编译声明的结构,不推断归属。+原生形状 metadata 采用两级模型。完整导入 SVG 保存 native metadata、隐藏 carrier 和预览证据;轻量 authoring projection 移除大体积载荷与重复 carrier,只供模型检查,永远不是导出源。创作模式使用项目规范化 SVG,只有精确匹配已登记 preset 时才使用 compact authored-preset 组。Mirror 可在未改的 Slide-local/slot 对象上复用转换器已经支持的 metadata;固定结构层保持直接原子,不支持或已修改的对象保留 SVG fallback。导出只编译声明的结构,不推断归属。两种范围都在可移植 frontmatter 中保留 `kind: layout` 或 `kind: deck`。`output_scope` 与 `target_project` 只属于工作流简报,不写入 `design_spec.md`。diff --git a/docs/zh/templates-guide.md b/docs/zh/templates-guide.mdindex 515c4d06..eaa98bc5 100644--- a/docs/zh/templates-guide.md+++ b/docs/zh/templates-guide.md@@ -172,7 +172,7 @@ PPT Master 的“模板”是一份**结构 + 风格**的预设包:每张 SVG**关于精灵图**:PPTX 导出的素材常常是**一张大图 + 多页通过 viewBox 裁剪不同区域**。`fidelity` 和 `mirror` 模式下必须保留这层嵌套 `<svg viewBox=...>` 包装,不能扁平化为单张 `<image>`——否则裁剪信息丢失,画面会错位。工作流会自动校验这一点。-**关于 PowerPoint 原生形状**:完整导入 SVG 保留在临时分析工作区,模型读取的是移除 opaque payload 和重复 carrier 的轻量 projection;projection 永远不是导出源。创作模式使用紧凑 canonical metadata。Mirror 可在未改的 Slide-local/slot 对象上复用转换器已支持的 metadata;固定 Master/Layout 层保持直接原子,不支持或已修改的对象保留当前 SVG fallback。+**关于 PowerPoint 原生形状**:完整导入 SVG 保留在临时分析工作区,模型读取的是移除 opaque payload 和重复 carrier 的轻量 projection;projection 永远不是导出源。创作模式使用项目规范化 SVG,只有精确匹配已登记 preset 时才使用 compact authored-preset 组。Mirror 可在未改的 Slide-local/slot 对象上复用转换器已支持的 metadata;固定 Master/Layout 层保持直接原子,不支持或已修改的对象保留当前 SVG fallback。**Mirror 图谱边界**:mirror 保留完整且受支持的来源 Master/Layout 图谱。它为每张来源 Slide 输出一个完整原型,并为未被任何来源 Slide 使用的 Layout 额外输出一个定义专用的 `layout_<layout_key>.svg`。后者通过独立 Layout roster 注册进 PowerPoint,不会变成发布页面;其父 Master 也随之保留。预检只在必要来源事实或受支持几何缺失时停止,不会仅因 Layout 未使用而停止。diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 12da2ca3..a6a3ca3c 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -92,7 +92,7 @@ description: >| `${SKILL_DIR}/scripts/slice_images.py` | Slice one AI illustration sheet into individual spot-illustration elements || `${SKILL_DIR}/scripts/svg_authoring_view.py` | Create a lightweight non-destructive inspection projection of PPTX-imported SVGs; never a release source || `${SKILL_DIR}/scripts/svg_quality_checker.py` | SVG quality check |-| `${SKILL_DIR}/scripts/preset_shape_svg.py` | Print one registry-backed native PowerPoint preset fragment to stdout for hand-authored SVG insertion |+| `${SKILL_DIR}/scripts/preset_shape_svg.py` | Print one compact registry-backed native PowerPoint preset `<g>` to stdout for page or template insertion || `${SKILL_DIR}/scripts/total_md_split.py` | Speaker notes splitting || `${SKILL_DIR}/scripts/finalize_svg.py` | SVG post-processing (unified entry) || `${SKILL_DIR}/scripts/svg_to_pptx.py` | Export to PPTX |diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex be6b7d29..bfad2a33 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -98,7 +98,7 @@ This section applies only to deck/layout template routes. `page_layouts` selects**Hard rule — root identity**: A `page_pptx_layouts` row binds the page to one key in `pptx_layouts`; that unique definition supplies its Master key, Layout picker name, and prototype source. Put the declared Master key/name and Layout key/name on the root SVG. A Layout key belongs to exactly one Master and remains globally unique.-**Hard rule — atomic fixed layers**: Every `data-pptx-layer="master|layout"` visual is one direct root child that compiles to one DrawingML object. A marked `<g>` is forbidden. When reconstructing source PPTX groups, recursively push supported transforms, paint, opacity, and z-order into atomic children. Repeat the identical ordered Master atom contract on every page using that Master and the identical ordered Layout atom contract on every page sharing that `(master, layout)` pair.+**Hard rule — atomic fixed layers**: Every `data-pptx-layer="master|layout"` visual is one direct root semantic atom that compiles to one DrawingML object. An ordinary marked `<g>` is forbidden; one validated compact authored-preset `<g>` emitted by `preset_shape_svg.py` is the sole group exception because it compiles to one native shape. When reconstructing source PPTX groups, recursively push supported transforms, paint, opacity, and z-order into atomic children. Repeat the identical ordered Master atom contract on every page using that Master and the identical ordered Layout atom contract on every page sharing that `(master, layout)` pair.**Hard rule — PowerPoint paint order**: Direct children appear in this order: Master background atoms, Layout background atoms, optional Slide background, remaining Master atoms, remaining Layout atoms, then slot groups and Slide-local content groups. Backgrounds are the inheritance plane beneath all shapes.@@ -248,7 +248,7 @@ Before drawing each page, look up its entry in `page_charts` to decide which cha## 3. Execution Guidelines- **Proximity**: group related elements with tight spacing; separate unrelated groups-- **Element grouping (Mandatory)**: wrap every logical Slide-local content unit — title, core-message line, each content block, card, list item, and diagram — in a top-level `<g id="...">` with a descriptive id. Flat free-design/brand-only pages use ordinary semantic groups for every logical unit. On structured template pages, slot `<g>` elements are already semantic groups and direct Master/Layout atoms are the required exception to grouping. Authored native preset fragments (`preset_shape_svg.py`) already are one atomic `<g id>` each and count as one ordinary content group; keep their labels in a sibling parent `<g>`.+- **Element grouping (Mandatory)**: wrap every logical Slide-local content unit — title, core-message line, each content block, card, list item, and diagram — in a top-level `<g id="...">` with a descriptive id. Flat free-design/brand-only pages use ordinary semantic groups for every logical unit. On structured template pages, slot `<g>` elements are already semantic groups and direct Master/Layout atoms are the required exception to grouping. Authored native preset fragments (`preset_shape_svg.py`) already are one atomic `<g id>` each and count as one ordinary content group. When a preset needs labels or decorations, put the preset and those siblings inside a separate parent content group; never put them inside the preset group itself.- **Spec adherence**: follow color, layout, canvas format, and typography in the spec- **Template structure**: if templates exist, inherit the visual framework- **Main-agent ownership**: SVG generation must run in the main agent (not sub-agents) — pages share upstream context for cross-page visual continuity@@ -284,9 +284,10 @@ This automatic decision applies only before drawing a new object. Do not scanexisting SVG, classify path contours, or upgrade ordinary SVG during export.**Hard rule**: do not hand-write `data-pptx-authoring`, `data-pptx-prst`,-`data-pptx-frame`, adjustment, carrier, preview, or fingerprint metadata. The-helper generates them atomically from the shared 187-shape registry. Rerun the-helper when geometry or paint changes.+`data-pptx-frame`, adjustment metadata, or registry paths. The helper generates+one compact atomic `<g>` from the shared 187-shape registry, with semantic+metadata and base paint written once. Rerun the helper when geometry or paint+changes; never edit one of its direct paths.For chart-template and diagram authoring, thin relationships use ordinary`<line>` / supported open `<path>` geometry with registered arrow markers;diff --git a/skills/ppt-master/references/native-shape-authoring.md b/skills/ppt-master/references/native-shape-authoring.mdindex 93938aca..c0f6fcbf 100644--- a/skills/ppt-master/references/native-shape-authoring.md+++ b/skills/ppt-master/references/native-shape-authoring.md@@ -2,10 +2,10 @@# Native Preset Shape Authoring Reference-Use this reference during Executor SVG construction when one standard-PowerPoint shape can express one complete geometric object. The helper does-not create the preset shape's own `p:txBody`; keep visible text outside the-atomic fragment.+Use this reference during Executor SVG construction or project-owned canonical+template maintenance when one standard PowerPoint shape can express one+complete geometric object. The helper does not create the preset shape's own+`p:txBody`; keep visible text outside the atomic fragment.## 1. Selection Gate@@ -19,14 +19,15 @@ Apply this decision order before drawing a stock geometric object.| Condition | Action ||---|---|| Plain rectangle, symmetric rounded rectangle, circle, or ellipse | Write the ordinary SVG primitive; the exporter already emits an editable native shape. |-| One DrawingML preset exactly expresses the intended object | Run `preset_shape_svg.py render`, then insert its complete stdout fragment into the hand-authored page. |+| One DrawingML preset exactly expresses the intended object | Run `preset_shape_svg.py render`, then insert its complete stdout fragment into the hand-authored page or canonical template. || The visual meaning or contour exceeds one stock shape | Write ordinary `<path>` / `<polygon>` geometry; export keeps it as editable custom geometry. || The shape only resembles a preset | Keep ordinary SVG; never infer a preset from contour similarity. || Mirror/preserve input already owns native-shape metadata | Keep the existing object and metadata; never reselect its preset. |**Hard rule**: `preset_shape_svg.py` is the only authoring entry for`data-pptx-authoring="preset"`. Never add `data-pptx-prst`, frame, adjustment,-carrier, preview, or fingerprint attributes to a hand-written path.+or registry path data by hand. Insert the helper's complete compact `<g>` and+rerun the helper whenever its geometry or paint changes.---@@ -77,8 +78,10 @@ preserve/mirror round-trip contract.## 3. Fragment Generation-Run one command for one selected object. Colors must come from the current-page's re-read `spec_lock.md`.+Run one command for one selected object. Generated project pages take colors+from the current page's re-read `spec_lock.md`; `create-template` takes colors+from the confirmed brief and template `design_spec.md`. Mirror/preserve input+keeps the source object's paint instead of regenerating this authored form.```bashpython3 ${SKILL_DIR}/scripts/preset_shape_svg.py render rightArrow \@@ -106,33 +109,52 @@ and a visible stroke. It exports as an unconnected `p:cxnSp`; a connectorpreset can never be authored as an ordinary `shape`.**Hard rule — stdout-only exception**: the helper prints one deterministic-`<g>` fragment. Read that output and insert it with the normal page-`apply_patch` edit. Do not redirect it into `svg_output/`, loop over pages,-batch shapes, or let it choose layout. The main Agent still authors every-complete SVG page sequentially.+`<g>` fragment. Read that output and insert it with the normal page/template+`apply_patch` edit. Do not redirect it into `svg_output/`, loop over pages or+templates, batch shapes, or let it choose layout. The main Agent still authors+every complete SVG page sequentially and maintains each reusable template+explicitly.---## 4. Atomic Fragment Contract-The helper emits one logical group containing exactly one hidden native carrier-and one complete visible preview.+The helper emits one compact logical group. Metadata and base paint are written+once on the group; its direct children are the visible paths regenerated from+the locked preset registry.| Component | Ownership ||---|---|-| Logical `<g data-pptx-authoring="preset">` | Stable id, object kind, preset, frame, adjustments, and preview fingerprint. |-| `path[data-pptx-part="geometry"]` | Native PowerPoint export authority; hidden from the browser. |-| `g[data-pptx-part="geometry-preview"]` | Browser-visible preset drawing. |-| `path[data-pptx-part="geometry-detail"]` | One visible layer per DrawingML path, including path-level fill/stroke behavior. |--**Hard rule**: treat the returned group as atomic. Put labels, icons, or other-decorations beside it in a parent `<g>`, never inside the preset group.+| Logical `<g data-pptx-authoring="preset">` | Stable id, object kind, preset, frame, adjustments, and explicit local base paint. |+| Direct `<path>` children | Ordered browser-visible registry layers. A child writes only a path-specific fill/stroke override when the preset requires one. |+| Deliberately absent transport fields | No hidden carrier, preview wrapper, `data-pptx-part`, or stored fingerprint belongs in project-authored SVG. Those fields remain part of expanded PPTX import/round-trip transport. |++**Hard rule**: treat the returned group as atomic. Keep it as the content group+when it stands alone. When it needs labels, icons, or other decorations, put+the preset and those siblings in a separate parent content group; never put+them inside the preset group itself. Do not edit the direct paths; they are+validation evidence generated from the registry, not a freehand contour+surface.++Canonical page/template authoring also keeps paint and opacity off ancestor+groups that contain the preset. Compatible ancestor paint still exports under+the general SVG composition rules, but the checker warns because the atom is no+longer paint-self-contained; rerun the helper with channel alpha instead.++On a structured template, a validated authored-preset group is one semantic+atom. It may be Slide-local, the single carrier of an `object` slot, or a direct+Master/Layout fixed atom. This narrow exception does not permit ordinary nested+`<g>` structures in Master/Layout layers or placeholder carriers. The template+workflow may add the registered structural ownership attributes to the complete+helper group; it still must not alter preset metadata, paint, or direct paths.**Frame coordinate space**: `--frame x y w h` is expressed in the coordinatespace where you insert the fragment. At the page root that is page coordinates;inside a `<g transform="translate(…)">` use **group-local** coordinates — theancestor transform stacks on top, so page-absolute values would double-offset-the shape off-canvas.+the shape off-canvas. Keep the helper's exact space-separated ordinary-decimal+`data-pptx-frame` spelling; compact authoring does not accept alternate numeric+spellings.**Regeneration rule**: rerun the helper when preset, frame, adjustment, fill,stroke, or stroke width changes. Moving, scaling, rotating, or flipping the@@ -140,7 +162,12 @@ complete logical group is allowed; zero-scale transforms and shear/skew areforbidden, and the transformed frame must remain inside DrawingML's coordinaterange. Stroke width must remain inside DrawingML's line-width range. To freelyedit the contour, replace the whole fragment with ordinary SVG rather than-modifying a `geometry-detail` path.+modifying a generated direct path.++For a canonical reusable template, the complete helper fragment may remain as+an executable exemplar. A final-page adaptation may copy it unchanged only+when all registry metadata, frame, adjustments, and paint remain unchanged;+otherwise regenerate the complete compact group.---@@ -152,9 +179,13 @@ modifying a `geometry-detail` path.| Connector attachment | Authoring helper v1 creates an unconnected `p:cxnSp` and does not accept endpoint/site metadata. Do not hand-add it. The imported-shape contract may preserve an attachment that already exists in a source PPTX; creating a new attached connector is currently unsupported. || Action button behavior | `actionButton*` presets map visual geometry only. No action, navigation target, or hyperlink is created automatically. || Gradient/pattern paint | Authoring helper v1 accepts solid HEX paint only. Use ordinary SVG when a complex paint treatment is essential. |-| Multi-path darken/lighten | Browser preview uses the shared normalized paint behavior from the PPTX importer. |-| External edits | Any preview or semantic mismatch fails quality check and export; regenerate the fragment. |--**Validation**: `svg_quality_checker.py` independently rerenders every authored-preset from registry metadata and compares the carrier, visible layers, style,-and fingerprint before export.+| Multi-path darken/lighten | Direct visible layers use the shared normalized paint behavior from the PPTX importer. Their registry-derived HEX values are authorized derivatives of the locked base color, not spec-lock drift. |+| Expanded compatibility | Existing helper-authored carrier/preview fragments remain readable as ordinary Slide-local input and receive a non-blocking migration warning; they do not become structured fixed atoms or object-slot carriers. Imported expanded fragments remain the lossless mirror/preserve form. |+| External edits | Any registry-path, style, or semantic mismatch fails quality check and export; regenerate the fragment. |++**Validation**: `svg_quality_checker.py` independently rerenders every compact+authored preset from registry metadata and compares its direct visible paths+and paint. The exporter performs the same validation, then expands the compact+group only in memory to reuse the lossless native-shape conversion path.+Compatible expanded authored input remains under its separate carrier/preview+freshness contract.diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.mdindex e1272fa0..4d3696b3 100644--- a/skills/ppt-master/references/shared-standards.md+++ b/skills/ppt-master/references/shared-standards.md@@ -275,15 +275,18 @@ attributes, and no separate source-payload opt-in marker exists.|---|---|| Lossless import SVG | Keep complete native payload, hidden carriers, and preview evidence in the temporary analysis workspace. This is the round-trip source, not the model-facing authored page. || Lightweight authoring projection | Exclude opaque payload and duplicate hidden carriers from model context while retaining visible shape intent and logical ids needed to locate an adopted object in the lossless import. It is not an export source. |-| `standard` / `fidelity` output | Use compact canonical metadata for newly authored shapes; do not transplant opaque import payload or source topology. |-| `mirror` output | Keep supported imported metadata only on unchanged Slide-local/slot objects. Expand fixed Master/Layout group wrappers into direct atoms while preserving source ownership, paint order, and visible appearance. |+| `standard` / `fidelity` output | Use the compact authored-preset contract (§1.5) for newly authored stock shapes; do not transplant opaque import payload or source topology. |+| `mirror` output | Keep the expanded lossless representation and supported imported metadata only on unchanged Slide-local/slot objects. Expand fixed Master/Layout group wrappers into direct semantic atoms while preserving source ownership, paint order, and visible appearance. |**Hard rule — structural-layer boundary**: An unchanged imported logical objectmay keep currently supported metadata while it remains Slide-local or inside a-slot. A logical `<g>` cannot be assigned to Master/Layout because those layers-require direct atoms. Mechanically expand a fixed-layer source group into direct-atoms, rebuilding a preset when supported and otherwise retaining the visible-SVG fallback. Do not use this normalization to change ownership or appearance.+slot. An imported logical `<g>` cannot be assigned to Master/Layout because+those layers require direct semantic atoms. Mechanically expand a fixed-layer+source group into direct atoms, rebuilding a preset when supported and+otherwise retaining the visible SVG fallback. A newly authored compact preset+`<g>` from §1.5 is the sole group exception: validation proves that it compiles+to exactly one native shape/connector. Do not use this normalization to change+ownership or appearance.**Hard rule — selective payload**: Do not copy every imported metadata block intoan authored template. Keep the full lossless import SVG separately as the@@ -327,21 +330,22 @@ reconstruction are also normalized rather than byte-identical OOXML.### 1.5 Authored Native PowerPoint Presets (Conditional Contract)-New SVG pages may opt one complete geometric object into a native DrawingML-preset through the deterministic fragment helper. Selection behavior lives in+New SVG pages and project-owned canonical reusable templates may opt one+complete geometric object into a native DrawingML preset through the+deterministic fragment helper. Selection behavior lives in[`native-shape-authoring.md`](./native-shape-authoring.md); this section owns-the machine contract. This is compact canonical authoring metadata: it describes-the intended preset, frame, adjustments, paint, and preview fingerprint without-embedding source OOXML or relying on an imported-payload marker.+the machine contract. This compact canonical form describes the intended+preset, frame, adjustments, and paint once, keeps only registry-generated+visible SVG paths, and embeds no source OOXML or serialized preview fingerprint.| Metadata / structure | Required behavior ||---|---|-| `data-pptx-authoring="preset"` | Appears on the logical group and hidden carrier; distinguishes the strict new authoring contract from legacy/imported metadata. |+| `data-pptx-authoring="preset"` | Appears once on the logical `<g>`; distinguishes strict project authoring from legacy/imported metadata. || `data-pptx-object` | `shape` or `connector`; connector-family presets must use `connector`, and `connector` must use a connector-family preset. Authored connectors require `fill="none"` plus a visible stroke and export as unconnected `p:cxnSp`. |-| `data-pptx-prst`, `data-pptx-frame`, `data-pptx-av-*` | Generated together from the locked registry; group and carrier values must be identical. |-| One direct `path[data-pptx-part="geometry"]` | Hidden native export authority; carries the same semantics and solid paint used for regeneration. |-| One direct `g[data-pptx-part="geometry-preview"]` | Complete browser-visible preview with one ordered detail path per registry path. |-| `data-pptx-preview-sha256` | Identical on group/carrier and equal to an independent registry rerender of metadata, paint, and preview. |+| `data-pptx-prst`, `data-pptx-frame`, `data-pptx-av-*` | Generated together from the locked registry and written once on the logical group. The frame is the helper's exact four-part, space-separated ordinary-decimal spelling and remains authoritative even when visible path bounds differ; commas, scientific notation, leading `+`, and redundant decimal spellings are rejected. |+| Local `fill` / `stroke` plus supported paint attributes | Base paint is written once on the group; a visible stroke also carries an explicit width. Canonical page/template authoring keeps channel paint local. Compatible ancestor paint/opacity may compose under the general SVG rules and receives a recommendation warning. |+| Ordered direct `<path>` children | Browser-visible registry layers only. Each child writes just its required path-level fill/stroke override; labels and decorations stay outside the atomic group. |+| No carrier / wrapper / fingerprint | `data-pptx-part`, hidden geometry carriers, preview wrappers, and `data-pptx-preview-sha256` belong to expanded import/compatibility transport, not canonical project authoring. |Generate one fragment at a time:@@ -355,26 +359,53 @@ python3 ${SKILL_DIR}/scripts/preset_shape_svg.py render rightArrow \```**Hard rule — helper-only metadata**: never add or edit authored preset-metadata on a hand-written leaf. The helper output is atomic. Regenerate it-when preset, frame, adjustment, fill, stroke, or stroke width changes. Replace-the whole fragment with ordinary SVG when free contour editing is required.+metadata or registry paths by hand. The compact helper output is atomic.+Regenerate it when preset, frame, adjustment, fill, stroke, or stroke width+changes. Replace the whole fragment with ordinary SVG when free contour editing+is required.++Template ownership metadata is orthogonal to preset geometry. After inserting+the complete helper output, `create-template` may add only the registered+`data-pptx-layer`, `data-pptx-editable`, `data-pptx-placeholder-carrier`, or+`data-pptx-role` attribute needed by the surrounding structured contract. It+must not change preset/frame/adjustment/paint metadata or any direct path.++**Reusable-template boundary**: a project-owned canonical template may retain+one complete helper-generated atomic fragment when the stock preset is an exact+semantic match and its paint stays inside the authoring boundary below. The+fragment is an executable exemplar and one semantic atom, not a freely editable+template primitive. It may be Slide-local, the one carrier of an `object` slot,+or a direct Master/Layout fixed atom. An adaptation may reuse it unchanged only+when preset, frame, adjustments, and paint are unchanged; otherwise regenerate+the whole fragment with the helper.+Imported, mirror, and third-party templates are never upgraded by contour+inference.**Hard rule — visible page closure**: the helper prints a complete visiblefragment to stdout; export never invents its preview. The main Agent inserts-that output into the hand-authored page. The helper cannot write a project,-select layout, or generate a page.+that output into the hand-authored page or canonical reusable template. The+helper cannot write a project, select layout, or generate a page.**Authoring paint boundary**: v1 accepts `none` or six-digit solid HEX fill andstroke, optional fill/stroke opacity, stroke width, line cap, and line join.-Colors come from `spec_lock.md`. Use ordinary SVG for gradients, patterns,-filters, or other treatments outside this narrow contract.+Generated pages take colors from `spec_lock.md`; `create-template` authored+templates take them from the confirmed brief and template `design_spec.md`.+Use ordinary SVG for gradients, patterns, filters, or other treatments outside+this narrow contract. Registry-derived multi-path darken/lighten colors are+authorized derivatives of the locked base paint and do not count as color+drift. Mirror preserves source paint under §1.4 instead.**Validation**: quality check and export both rerender authored fragments from-`preset + frame + adjustments + carrier paint`. They require one carrier, one-preview, equal group/carrier semantics, exact ordered registry paths, and a-matching fingerprint. Preview edits, metadata-only edits, unknown adjustments,-out-of-range frames/transforms, zero-scale transforms, and shear/skew fail-closed.+`preset + frame + adjustments + group paint` and compare every visible path and+path-level paint override directly. Registry-path edits, geometry metadata that+leaves those paths stale, unknown adjustments, out-of-range frames/transforms,+zero-scale transforms, and shear/skew fail closed. Export expands the validated+compact group only in memory and reuses the lossless native-shape conversion+path. Older authored carrier/preview fragments remain compatible as ordinary+Slide-local input and+receive a non-blocking migration warning; they do not gain the new compact+group's structured-atom exception. `pptx_to_svg` expanded output remains the+lossless round-trip form and is not warned as authored input.**Fidelity boundary**: an unchanged authored fragment is `Native-stable` asone `p:sp` or `p:cxnSp`. Text remains outside the atomic fragment and may export@@ -525,7 +556,10 @@ Wrap logically related Slide-local elements in top-level `<g id="...">` groups.| Page footer | Page number + branding || Decorative cluster | Related decorative shapes (rings, dots, orbs) |-An authored native preset fragment (§1.5) is already an atomic `<g id>` and counts as one content group; keep its labels / decorations in a sibling parent `<g>`, never inside the preset group.+An authored native preset fragment (§1.5) is already an atomic `<g id>` and+counts as one content group. Keep it top-level when it stands alone. When it+needs a label or decoration, place the preset and those siblings inside a+separate parent content group; never put them inside the preset group itself.**Forbidden**:@@ -1590,8 +1624,8 @@ prototype size remain unchanged.| `data-pptx-master-name="Default Master"` | root `<svg>` | Sets the Master picker/display name || `data-pptx-layout="content"` | root `<svg>` | Binds the slide to one generated reusable layout key || `data-pptx-layout-name="Title and Content"` | root `<svg>` | Sets the PowerPoint layout-picker name; defaults from the layout key |-| `data-pptx-layer="master"` | direct atomic visual child | Moves one repeated static object/background into the named Slide Master; `<g>` is forbidden |-| `data-pptx-layer="layout"` | direct atomic visual child | Moves one repeated static object/background into the selected Layout; `<g>` is forbidden |+| `data-pptx-layer="master"` | direct semantic atom | Moves one repeated static object/background into the named Slide Master; ordinary `<g>` is forbidden, while one validated compact authored-preset `<g>` (§1.5) is an atomic exception |+| `data-pptx-layer="layout"` | direct semantic atom | Moves one repeated static object/background into the selected Layout; ordinary `<g>` is forbidden, while one validated compact authored-preset `<g>` (§1.5) is an atomic exception || `data-pptx-layer="slide"` | direct full-canvas solid `<rect>` only | Writes a one-page override as Slide `p:bg` || `data-pptx-placeholder="..."` | direct slot `<g id>` | Declares a reusable Layout slot whose visible content remains Slide-local || `data-pptx-placeholder-bounds="x y width height"` | slot `<g>` | Supplies the positive reusable design-zone frame in SVG user units |@@ -1628,7 +1662,7 @@ and visible-stroke rects also remain ordinary objects.| `date`, `footer`, `slide-number` | one `<text data-pptx-placeholder-carrier="true">` | `dt`, `ftr`, `sldNum` || `picture` | one `<image>` or supported imported crop `<svg>`, marked as carrier | `pic` || `chart`, `table` | one matching `data-pptx-replace-with` marker group, marked as carrier | `chart`, `tbl` |-| `object` | one text, image, or basic SVG shape marked as carrier; alternatively the slot group declares `binding="proxy"` | `obj` |+| `object` | one text, image, basic SVG shape, or validated compact authored-preset `<g>` marked as carrier; alternatively the slot group declares `binding="proxy"` | `obj` || `media` | one `<image>` or supported imported crop `<svg>`, marked as carrier | `media` |**Text slot carrier**: A multiline text placeholder must remain one@@ -1678,12 +1712,18 @@ fails export without replacing the requested output.**Static structure consistency**: Repeat the same master element ids on everyslide and the same layout element ids on every slide sharing a layout. Theirgenerated OOXML must be identical within the affected master/layout group.-Static structure may carry shapes, text, or images; non-image/external relationships are rejected. Every static object is atomic; a `<g data-pptx-layer="master|layout">` is forbidden. A full-canvas first rect may be marked as a Master or Layout background.+Static structure may carry shapes, text, or images; non-image/external+relationships are rejected. Every static object is atomic. An ordinary+`<g data-pptx-layer="master|layout">` is forbidden; the validated compact+authored-preset group from §1.5 is the sole group exception because it compiles+to one native object. A full-canvas first rect may be marked as a Master or+Layout background.**Native object slot carriers**: `chart` / `table` slots require`--native-charts-and-tables`; fallback groups contain several shapes and cannot map to onePowerPoint placeholder. `object` is the generic PowerPoint content slot and-uses either one carrier object or the explicit composite proxy downgrade. `media` currently binds+uses either one carrier object—including one validated compact authored-preset+group—or the explicit composite proxy downgrade. `media` currently bindsan authored image/crop to a native `media` placeholder; it does not synthesizevideo or audio media from a decorative SVG group.diff --git a/skills/ppt-master/references/template-designer.md b/skills/ppt-master/references/template-designer.mdindex 8eb11c72..e4d82761 100644--- a/skills/ppt-master/references/template-designer.md+++ b/skills/ppt-master/references/template-designer.md@@ -53,11 +53,26 @@ Use `summary.md` only for orientation. Open screenshots or the original PPTX onl| Mode | Output structure contract ||---|---|-| `standard` / `fidelity` | Author new SVG prototypes and an intentional new Master/Layout/slot system. Source visual language and assets may guide the design, but source ownership, keys, picker names, parent relationships, placeholders, and repeated Slide-local elements do not define or seed the output topology. Use compact canonical metadata for authored objects. |-| `mirror` | Restore the source graph one-to-one: keep source Master/Layout identities and parentage, slide assignments, placeholder type/index/bounds, and supported visual/native-object facts. Mechanical normalization maps fixed-layer source groups into the direct atoms required by the current explicit SVG contract while preserving ownership, paint order, and appearance; it must not semantically redesign the graph. |+| `standard` / `fidelity` | Author project-canonical SVG prototypes and an intentional new Master/Layout/slot system. Source visual language and assets may guide the design, but source ownership, keys, picker names, parent relationships, placeholders, and repeated Slide-local elements do not define or seed the output topology. Use the compact authored-preset group only for exact registered preset matches. |+| `mirror` | Restore the source graph one-to-one: keep source Master/Layout identities and parentage, slide assignments, placeholder type/index/bounds, and supported visual/native-object facts. Preserve the expanded lossless representation required for supported native-object round trips. Mechanical normalization maps fixed-layer source groups into the direct atoms required by the current explicit SVG contract while preserving ownership, paint order, and appearance; it must not semantically redesign the graph. |Every page remains a complete standalone SVG preview.+**Authored preset rule**: In `standard` / `fidelity`, when one registered+PowerPoint preset exactly expresses one complete object, use+`preset_shape_svg.py` as defined by+[`native-shape-authoring.md`](./native-shape-authoring.md). Its compact+canonical `<g>` is one semantic atom after validation: it may remain+Slide-local, serve as the one direct carrier of an `object` slot, or carry+Master/Layout fixed-layer ownership. This is the only `<g>` exception to the+fixed-layer atomicity rule; ordinary groups remain forbidden there. Preset+paint comes from the confirmed brief and this template's `design_spec.md`+color scheme. Do not copy an expanded import carrier/preview/fingerprint+bundle into an authored template. `mirror` instead preserves the supported+expanded lossless source representation. The exact syntax and validation+contract remain owned by+[`shared-standards.md`](./shared-standards.md) and the native-shape reference.+**Hard rule — complete mirror graph**: Restore every supported source Layout,including Layouts unused by source Slides. Emit one complete source-pageprototype per source Slide and one definition-only@@ -263,7 +278,7 @@ The imported PPTX has a different authority level in each replication mode.| Mode | Required behavior ||---|---|-| `standard` | Use source visuals/assets as references, then author the compact canonical roster and its Master/Layout/slot structure from the confirmed brief. Do not preserve or distill source topology. |+| `standard` | Use source visuals/assets as references, then author the project-canonical roster and its Master/Layout/slot structure from the confirmed brief. Do not preserve or distill source topology. || `fidelity` | Use the complete visual roster as design reference, then author a broader canonical roster and its own Master/Layout/slot structure. Match the source visual language closely, but do not cluster, merge, or split source Layouts into output families. || `mirror` | Restore source pages, inheritance, placeholders, native objects, and visuals from the lossless import. Do not simplify, redesign, rename structure, or infer new common structure. |@@ -280,14 +295,15 @@ template.|---|---|---|| Lossless import SVG | Round-trip and mirror-restoration source | Retain complete imported metadata, native object boundaries, hidden carriers, and source-scope identity. It is authoritative for mirror restoration. || Lightweight authoring projection | Model-readable inspection surface | Omit opaque native payload and duplicate hidden carriers from model context; retain visible shape intent and logical ids needed to locate an adopted object in the lossless import |-| `standard` / `fidelity` output | Newly authored contract | Use compact canonical metadata for new shapes. Reuse exported image/vector assets, not opaque source shape payload or source topology. |-| `mirror` output | Restored contract | Keep currently supported imported metadata on unchanged Slide-local/slot objects. Normalize fixed structural layers into direct atoms from the lossless source. The projection never becomes the restoration source. |+| `standard` / `fidelity` output | Newly authored contract | Use `preset_shape_svg.py` compact canonical `<g>` output for exact preset matches, with paint from the confirmed brief / `design_spec.md`; use ordinary project SVG for other geometry. Reuse exported image/vector assets, not opaque source shape payload or source topology. |+| `mirror` output | Restored contract | Keep the expanded lossless representation and currently supported imported metadata on unchanged Slide-local/slot objects. Normalize fixed structural layers into semantic atoms from the lossless source. The projection never becomes the restoration source. |**Validation**: Mirror does not silently use stale metadata or a lightweightprojection. If an imported object cannot use the converter's supported nativemetadata after normalization, keep its current SVG fallback and report the-limitation. `standard` / `fidelity` regenerate compact canonical shapes instead-of transplanting opaque source payload. `data-pptx-replace-with` remains+limitation. For exact registered preset matches, `standard` / `fidelity`+regenerate the compact helper group instead of transplanting opaque source+payload; other geometry stays ordinary project SVG. `data-pptx-replace-with` remainsreserved for optional PowerPoint-native Chart/Table replacement markers.**Explicit template SVG contract**:@@ -295,7 +311,7 @@ reserved for optional PowerPoint-native Chart/Table replacement markers.| Authored/restored fact | Template SVG declaration ||---|---|| Master/Layout identity | Root `data-pptx-master` / `data-pptx-master-name` plus `data-pptx-layout` / `data-pptx-layout-name`; authored keys for `standard` / `fidelity`, source keys for `mirror` |-| Authored Master/Layout visual | In `standard` / `fidelity`, use a direct atomic child with `data-pptx-layer="master|layout"` and `data-pptx-editable="false"`; `<g>` is forbidden for a structural layer |+| Authored Master/Layout visual | In `standard` / `fidelity`, use a direct atomic child with `data-pptx-layer="master|layout"` and `data-pptx-editable="false"`. An ordinary `<g>` is forbidden; one validated compact canonical authored-preset `<g>` is a semantic atom and is the sole group exception. || Restored Master/Layout visual | In `mirror`, recursively expand each fixed-layer source group into direct atoms with the same Master/Layout ownership, transforms, styles, paint order, and appearance; semantic regrouping is forbidden || Content slot | Direct `<g id>` with `data-pptx-placeholder` and explicit `data-pptx-placeholder-bounds`; `standard` / `fidelity` author the slot, while `mirror` preserves source type/index/bounds and carrier identity || Page-only background | Direct full-canvas solid rect with `data-pptx-layer="slide"` |@@ -305,7 +321,14 @@ Repeat inherited visuals in every standalone SVG so browser preview remains comp**Forbidden — legacy structure contract**: Do not carry `data-pptx-layout-kind`, `distilled`, `utility`, unmapped `baseline`, `preserve`, or direct atomic placeholders into a reusable template package. Route that source through [`restore-pptx-structure`](../workflows/restore-pptx-structure.md) first.-**Composite slot boundary**: A normal slot group has exactly one compatible direct carrier. Only a genuinely composite region may declare `data-pptx-placeholder="object"` with `data-pptx-placeholder-binding="proxy"`; the visible group stays Slide-local and export creates a hidden transparent binding proxy. Do not use proxy binding as the default template slot form.+**Composite slot boundary**: A normal slot group has exactly one compatible+direct carrier. A validated compact canonical authored-preset `<g>` counts as+one carrier for an `object` slot because it compiles to one native shape; an+ordinary multi-object `<g>` does not. Only a genuinely composite region may+declare `data-pptx-placeholder="object"` with+`data-pptx-placeholder-binding="proxy"`; the visible group stays Slide-local+and export creates a hidden transparent binding proxy. Do not use proxy binding+as the default template slot form.In `mirror`, preserve imported placeholder types, indices, bounds, and carrieridentity exactly when the importer supports them. Do not replace source@@ -515,7 +538,7 @@ templates/- [x] Placeholder markers are clear and standardized for `standard` / `fidelity`; mirror preserves literal source text plus source placeholder type/index/bounds- [x] Every SVG is a complete preview with explicit root Master/Layout identity and `native_structure_mode: structured`; authored modes use canonical fixed layers/slots, while mirror preserves source ownership and mechanically expands fixed-layer groups into direct atoms- [x] Authored `standard` / `fidelity` Layout keys are non-duplicative; mirror keeps distinct source Layout identities even when their current visible contracts are equivalent-- [x] Model context used lightweight projections; lossless imports remained authoritative for mirror restoration, while `standard` / `fidelity` used compact canonical authored metadata+- [x] Model context used lightweight projections; lossless expanded imports remained authoritative for mirror restoration, while `standard` / `fidelity` used helper-generated compact canonical preset groups and `design_spec.md` paint- [x] Both scopes route bitmaps to `images/` and copy extracted icons to both `templates/icons/` and runtime `icons/`- [ ] **Next step**: Validate assets, optionally export a review PPTX, then register only library scope```diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.mdindex b09b9dbe..5c5fd48e 100644--- a/skills/ppt-master/scripts/README.md+++ b/skills/ppt-master/scripts/README.md@@ -90,7 +90,8 @@ python3 scripts/template_preview_pptx.py <legacy_template_workspace> --visual-onof PPTX-imported SVGs. It removes embedded `txbody` payloads,duplicate hidden geometry carriers, and import-identity attributes from thecopy while retaining visible fallback geometry, text, images, stable element-ids, root Master/Layout markers, and supported compact native-shape intent.+ids, root Master/Layout markers, and selected native-shape intent for+inspection.Relative local image references are rewritten so the projected copy stillrenders from its new location. The full imported SVG remains unchanged and isthe evidence source for mirror restoration; the projection is inspection-only.@@ -131,7 +132,19 @@ python3 scripts/preset_shape_svg.py describe rightArrowpython3 scripts/preset_shape_svg.py render rightArrow --id process-arrow --frame 120 180 240 96 --fill '#2563EB'```-The helper never writes a page or project file. Select one exact semantic stock-shape match, inspect the emitted fragment, and insert it into the hand-authored SVG with the normal patch workflow. Keep ordinary rectangles, ellipses, freeform geometry, charts, icons, and ambiguous silhouettes as regular SVG. See [`references/native-shape-authoring.md`](../references/native-shape-authoring.md) for the selection and metadata contract.+The helper never writes a page or project file. Select one exact semantic+stock-shape match, inspect the emitted fragment, and insert it into the+hand-authored SVG with the normal patch workflow. Its project-authored output+is one compact atomic `<g>` with direct registry-generated visible paths;+quality check and export rerender the registry instead of relying on a hidden+carrier, preview wrapper, or stored preview fingerprint. PPTX import and+round-trip SVGs deliberately keep their expanded carrier/preview evidence and+are not rewritten into this authored form. Keep ordinary rectangles, ellipses,+freeform geometry, charts, icons, and ambiguous silhouettes as regular SVG.+See [`references/shared-standards.md`](../references/shared-standards.md) for+the normative contract and+[`references/native-shape-authoring.md`](../references/native-shape-authoring.md)+for selection and authoring guidance.Post-processing and export:@@ -148,7 +161,7 @@ python3 scripts/svg_to_pptx.py <project_path>For SVG-authoring routes, `svg_output/` is the complete visible page-design source: every exported text, image, shape, background, and template-derived layout element is present in the page SVG or explicitly referenced by it. Export may translate represented content into Master/Layout/Slide parts or native objects, but it does not retrieve missing visible content from templates or planning files. Speaker notes, animation, narration, transitions, `template-fill-pptx`, and `native-enhance-pptx` remain separately owned capabilities.-Native `svg_to_pptx.py` release export reads the project's explicit structure mode. Free-design and brand-only projects use `flat`, omit Master/Layout mappings and SVG structure metadata, keep every represented object Slide-local, and materialize one clean project-owned Master plus one Blank Layout from the current color/typography lock. Stock content placeholders and unused built-in Layouts are removed; only the standard date/footer/slide-number capability hooks remain. Deck/layout template projects use `structured`: each project supplies unique Master/Layout definitions and one Layout assignment per generated page before SVG generation, and every SVG root repeats its assigned identity. A template-backed definition may remain unused and still register without a published carrier slide. Fixed Master/Layout visuals are direct atomic children; reusable slots are top-level groups with positive design-zone bounds plus one compatible carrier. Composite `object` regions use explicit proxy binding, and zero-slot Layouts are valid.+Native `svg_to_pptx.py` release export reads the project's explicit structure mode. Free-design and brand-only projects use `flat`, omit Master/Layout mappings and SVG structure metadata, keep every represented object Slide-local, and materialize one clean project-owned Master plus one Blank Layout from the current color/typography lock. Stock content placeholders and unused built-in Layouts are removed; only the standard date/footer/slide-number capability hooks remain. Deck/layout template projects use `structured`: each project supplies unique Master/Layout definitions and one Layout assignment per generated page before SVG generation, and every SVG root repeats its assigned identity. A template-backed definition may remain unused and still register without a published carrier slide. Fixed Master/Layout visuals are direct semantic atoms; ordinary groups are invalid there, while one validated compact authored-preset `<g>` is the sole group exception because it compiles to one native shape. Reusable slots are top-level groups with positive design-zone bounds plus one compatible carrier. Composite `object` regions use explicit proxy binding, and zero-slot Layouts are valid.Structured template export compiles only the declared structure, maps locked typography/colors into PowerPoint defaults, creates the named Master/Layout parts, and reads the package back before publication. It never clusters pages, promotes repeated chrome heuristically, or invents placeholders. Flat export is the normal free-design/brand-only route: it creates only the clean project-owned shell and performs no promotion or deduplication of Slide content.diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 8d692bcd..286838f9 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -27,8 +27,7 @@ The projected copy:- removes source-object identity/style/hash attributes that are only useful toan exact import round trip;- keeps visible paths, text, images, stable ids, Master/Layout root markers,- and supported compact `data-pptx-object` / `data-pptx-prst` /- `data-pptx-frame` intent; and+ and selected native-shape intent useful for inspection; and- rewrites relative local asset references for the projection's new location.The complete imported SVG remains the evidence source for mirror restoration.@@ -37,6 +36,18 @@ projection is deliberately not a template generator, not a replacement forthe explicit Master/Layout restoration workflow, and not a supported releaseinput to `svg_to_pptx.py`.+This projection is separate from canonical preset authoring. New project SVGs+and project-owned templates use the compact authored form: one atomic+`<g data-pptx-authoring="preset">` owns the preset intent and base paint, with+the registry-generated visible `<path>` layers as direct children. Quality+check and export rerender the locked registry to validate that group, so the+compact form has no hidden carrier, preview wrapper, or serialized preview+fingerprint. `pptx_to_svg.py` continues to emit the expanded carrier/preview+evidence required for import and round-trip decisions. The normative boundary+is owned by [`shared-standards.md`](../../references/shared-standards.md), with+authoring guidance in+[`native-shape-authoring.md`](../../references/native-shape-authoring.md).+## Recommended PipelineRun these steps in order:@@ -102,7 +113,7 @@ Behavior:- For PPTX template-import workspaces, use `-s svg-flat` when you need a visual round-trip check. The layered `svg/` tree is the machine-readable template source and intentionally does not inline inherited master / layout decoration into each slide.- Native mode is strict about unsupported visual SVG elements: if a visual element cannot be represented or safely preserved, export fails with the SVG file, element tag, and position instead of silently dropping content.- Omitting `--pptx-structure` reads `spec_lock.md`. Free-design and brand-only releases declare `mode: flat`, omit Master/Layout mappings and SVG structure metadata, and materialize one clean project-owned Master plus one Blank Layout from the current lock. Deck/layout template releases declare `mode: structured` with complete unique `pptx_masters` / `pptx_layouts` rosters and one `page_pptx_layouts` assignment per page. A template-backed Layout definition may remain unused by pages and still register in the final package.-- On structured template routes, every page root repeats Master/Layout keys and picker names. Master/Layout fixed visuals are direct atomic children; layer `<g>` elements are invalid.+- On structured template routes, every page root repeats Master/Layout keys and picker names. Master/Layout fixed visuals are direct semantic atoms. Ordinary layer `<g>` elements are invalid; one validated compact authored-preset `<g>` emitted by `preset_shape_svg.py` is the sole group exception because it compiles to one native shape.- On structured template routes, each normal slot is a direct root `<g id>` with semantic type, positive design-zone bounds, and exactly one compatible carrier. Composite `object` slots use explicit proxy binding; zero-slot Layouts are valid. Flat pages keep all SVG objects Slide-local.- Flat export maps locked typography/colors into a clean project-owned theme/Master, removes stock content placeholders and unused built-in Layouts, retains only the standard date/footer/slide-number capability hooks, and keeps one Blank Layout without promoting Slide content. Structured export additionally creates one reusable Layout per declared key and reopens the package to verify the full Presentation → Master → Layout → Slide graph, fixed-object order, placeholder identities/bounds, carrier bindings, hidden proxies, and zero-slot Layouts.- Template `page_layouts` remains input provenance. Strict preserves the prototype contract; adaptive retains its Master and may use a new Layout identity only when fixed Layout atoms or slot topology/bounds change.@@ -190,9 +201,12 @@ Checks include:Warnings are advisory: they require no modification or acknowledgement and donot affect the command's zero exit status. Only errors block the quality gate.-Template mode accepts compact canonical preset shapes marked with-`data-pptx-authoring="preset"`. It validates the explicit structured SVG-contract; it does not implement a separate source-payload opt-in marker.+Template mode accepts the same compact canonical preset groups as generated+pages: one atomic `<g data-pptx-authoring="preset">` with direct visible paths.+It validates those paths dynamically against the locked registry and does not+require an import-style carrier, preview wrapper, fingerprint, or a separate+source-payload opt-in marker. Exact syntax remains owned by the linked+standards rather than this pipeline overview.## `svg_position_calculator.py`diff --git a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.mdindex 045be757..32c38f09 100644--- a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md+++ b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md@@ -278,13 +278,16 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr|---|---|---|| 基础节点与容器 | `<rect>`、`<circle>`、`<ellipse>` | 导出为原生可编辑 Shape || 细关系线或方向箭头 | `<line>`;折线路径优先拆成少量线段,仅末段带已登记 marker | 导出为静态可编辑线形状,不创建 `p:cxnSp` |-| 实心块箭头、chevron、标准流程节点 | 模板只表达结构与视觉意图 | 生成实际页面时,若纯色 preset 精确匹配,则调用 `preset_shape_svg.py` 生成普通 `shape`;不得把 helper 片段冻结进模板 |+| 实心块箭头、chevron、标准流程节点 | 当纯色 preset 精确匹配时,保存 `preset_shape_svg.py` 生成的完整 compact 原子 `<g>` | group 只写一次 metadata / 基础 paint,直接可见 path 是 registry 层且只带必要的分层 paint 覆盖;改动 preset、frame、adjustment 或 paint 时必须整体重新生成 || 自定义轮廓、品牌图形、数据几何 | `<path>`、`<polygon>` | 导出为可编辑 `p:sp/a:custGeom`,无需伪装成 preset || 数据图表 | SVG Shape fallback;符合合同的模板可带 chart replacement marker | 默认仍为 Shape 图表;仅显式 opt-in 时替换为 native Chart |-**硬规则**:图表模板不得包含 `data-pptx-object="connector"`、Connector-端点 attachment metadata,或 helper 生成的 authored-preset carrier。-概念流程图、架构图、关系图也不得添加+**硬规则**:图表模板不得包含 `data-pptx-object="connector"` 或 Connector+端点 attachment metadata。authored preset 只能粘贴 helper 输出的完整 compact+原子 `<g>`:不得手写或局部修改 metadata / path,也不得加入 hidden carrier、+preview wrapper 或 fingerprint。修改时整体重生成。PPTX 导入与 `mirror` 的+expanded 无损表达属于独立合同,不得复制为新模板创作格式。概念流程图、+架构图、关系图也不得添加`data-pptx-replace-with="chart"`。来源 PPTX 已有 Connector 的导入/回导保真属于独立合同,不通过模板示例扩张到新页面创作。@@ -383,7 +386,7 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr- [ ] 主要元素有语义化 `<g id="...">`- [ ] `svg_quality_checker.py` 对目标模板通过;通用 SVG 合同不在本清单复述- [ ] 细关系箭头使用普通 line/path Shape,不含 Connector 或 attachment metadata-- [ ] helper 生成的 preset 片段未冻结进模板;实心 stock shape 在实际页面中按 frame/paint 重新生成+- [ ] authored preset 是 helper 输出的完整 compact 原子 `<g>`;无 carrier / preview wrapper / fingerprint,且 metadata / path 未手改- [ ] 只有受支持的数据图表/文本表格使用 replacement marker;概念图示不冒充 native Chart### 阴影diff --git a/skills/ppt-master/templates/charts/README.md b/skills/ppt-master/templates/charts/README.mdindex db0d847d..a3e0132b 100644--- a/skills/ppt-master/templates/charts/README.md+++ b/skills/ppt-master/templates/charts/README.md@@ -23,9 +23,15 @@ independently editable PowerPoint shapes:arrow markers; they remain static editable shapes and do not create nodeattachment or automatic routing.- Use a stock PowerPoint preset for a solid block arrow, chevron, or standard- flowchart node only when adapting the selected template into the final page.- Generate that page-specific fragment with `preset_shape_svg.py`; never freeze- its frame/fingerprint-bearing output inside a reusable chart template.+ flowchart node when it exactly expresses the intended object. A template may+ retain the complete compact atomic `<g>` generated by `preset_shape_svg.py`,+ so direct export preserves the native preset identity. The group owns the+ metadata and base paint once; its direct visible paths are registry-derived+ layers with only necessary per-layer paint overrides. It has no hidden+ carrier, preview wrapper, or stored fingerprint. If preset, frame,+ adjustments, or paint changes, regenerate the whole group instead of editing+ metadata or paths. PPTX import and `mirror` retain their separate expanded+ lossless representation; do not copy that transport form into new templates.- Keep custom contours, branded geometry, and data-driven marks as ordinary`<path>` / `<polygon>` geometry. They still export as editable DrawingMLshapes; native preset identity is not required for editability.diff --git a/skills/ppt-master/templates/charts/chevron_chain_with_tail.svg b/skills/ppt-master/templates/charts/chevron_chain_with_tail.svgindex 927fe363..b15447f2 100644--- a/skills/ppt-master/templates/charts/chevron_chain_with_tail.svg+++ b/skills/ppt-master/templates/charts/chevron_chain_with_tail.svg@@ -60,15 +60,25 @@<!-- ===== Primary Activities: 5 chevrons, stride 180, rect width 175, point overhang 25 ===== --><g id="primary"><!-- Chev 1: rect 60-235, flat left, point at 260 -->- <path d="M 60 380 H 235 L 260 432 L 235 484 H 60 Z" fill="#E0E7FF"/>+ <g id="primary-chevron-01" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="homePlate" data-pptx-frame="60 380 200 104" data-pptx-av-adj="val 24038" fill="#E0E7FF" stroke="none">+ <path d="M 60 380 L 235 380 L 260 432 L 235 484 L 60 484 Z"/>+ </g><!-- Chev 2: rect 240-415, notch 265, point at 440 -->- <path d="M 240 380 H 415 L 440 432 L 415 484 H 240 L 265 432 Z" fill="#C7D2FE"/>+ <g id="primary-chevron-02" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="chevron" data-pptx-frame="240 380 200 104" data-pptx-av-adj="val 24038" fill="#C7D2FE" stroke="none">+ <path d="M 240 380 L 415 380 L 440 432 L 415 484 L 240 484 L 265 432 Z"/>+ </g><!-- Chev 3: rect 420-595, notch 445, point at 620 -->- <path d="M 420 380 H 595 L 620 432 L 595 484 H 420 L 445 432 Z" fill="#E0E7FF"/>+ <g id="primary-chevron-03" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="chevron" data-pptx-frame="420 380 200 104" data-pptx-av-adj="val 24038" fill="#E0E7FF" stroke="none">+ <path d="M 420 380 L 595 380 L 620 432 L 595 484 L 420 484 L 445 432 Z"/>+ </g><!-- Chev 4: rect 600-775, notch 625, point at 800 -->- <path d="M 600 380 H 775 L 800 432 L 775 484 H 600 L 625 432 Z" fill="#C7D2FE"/>+ <g id="primary-chevron-04" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="chevron" data-pptx-frame="600 380 200 104" data-pptx-av-adj="val 24038" fill="#C7D2FE" stroke="none">+ <path d="M 600 380 L 775 380 L 800 432 L 775 484 L 600 484 L 625 432 Z"/>+ </g><!-- Chev 5: rect 780-955, notch 805, point at 980 -->- <path d="M 780 380 H 955 L 980 432 L 955 484 H 780 L 805 432 Z" fill="#E0E7FF"/>+ <g id="primary-chevron-05" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="chevron" data-pptx-frame="780 380 200 104" data-pptx-av-adj="val 24038" fill="#E0E7FF" stroke="none">+ <path d="M 780 380 L 955 380 L 980 432 L 955 484 L 780 484 L 805 432 Z"/>+ </g></g><!-- ===== Margin Tail: full-height wedge merging both halves into one outcome point ===== -->diff --git a/skills/ppt-master/templates/charts/pipeline_with_stages.svg b/skills/ppt-master/templates/charts/pipeline_with_stages.svgindex 63124527..ae8aa0ad 100644--- a/skills/ppt-master/templates/charts/pipeline_with_stages.svg+++ b/skills/ppt-master/templates/charts/pipeline_with_stages.svg@@ -30,7 +30,9 @@</text><!-- ==================== Left Row Label (Stages) ==================== --><rect x="30" y="150" width="30" height="30" rx="6" fill="#334155"/>- <path d="M 36 162 H 47 V 158 L 55 165 L 47 172 V 168 H 36 Z" fill="#FFFFFF"/>+ <g id="pipeline-stages-label-arrow" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="rightArrow" data-pptx-frame="36 158 19 14" data-pptx-av-adj1="val 42857" data-pptx-av-adj2="val 57143" fill="#FFFFFF" stroke="none">+ <path d="M 36 162 L 47 162 L 47 158 L 55 165 L 47 172 L 47 168 L 36 168 Z"/>+ </g><text x="45" y="350" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="800" fill="#0F172A" letter-spacing="4" transform="rotate(-90, 45, 350)">PIPELINE STAGES</text><!-- ==================== Main Pipeline Frame ==================== --><rect x="100" y="150" width="1150" height="36" fill="#F8FAFC" rx="8"/>@@ -144,14 +146,24 @@<text x="1135" y="525" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="15" font-weight="800" fill="#BE123C">Products</text><!-- ==================== Stage Arrows ==================== --><g fill="#CBD5E1">- <path d="M 315 376 L 328 376 L 328 368 L 345 380 L 328 392 L 328 384 L 315 384 Z"/>- <path d="M 545 376 L 558 376 L 558 368 L 575 380 L 558 392 L 558 384 L 545 384 Z"/>- <path d="M 775 376 L 788 376 L 788 368 L 805 380 L 788 392 L 788 384 L 775 384 Z"/>- <path d="M 1005 376 L 1018 376 L 1018 368 L 1035 380 L 1018 392 L 1018 384 L 1005 384 Z"/>+ <g id="stage-arrow-01-02" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="rightArrow" data-pptx-frame="315 368 30 24" data-pptx-av-adj1="val 33333" data-pptx-av-adj2="val 70833" fill="#CBD5E1" stroke="none">+ <path d="M 315 376 L 328 376 L 328 368 L 345 380 L 328 392 L 328 384 L 315 384 Z"/>+ </g>+ <g id="stage-arrow-02-03" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="rightArrow" data-pptx-frame="545 368 30 24" data-pptx-av-adj1="val 33333" data-pptx-av-adj2="val 70833" fill="#CBD5E1" stroke="none">+ <path d="M 545 376 L 558 376 L 558 368 L 575 380 L 558 392 L 558 384 L 545 384 Z"/>+ </g>+ <g id="stage-arrow-03-04" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="rightArrow" data-pptx-frame="775 368 30 24" data-pptx-av-adj1="val 33333" data-pptx-av-adj2="val 70833" fill="#CBD5E1" stroke="none">+ <path d="M 775 376 L 788 376 L 788 368 L 805 380 L 788 392 L 788 384 L 775 384 Z"/>+ </g>+ <g id="stage-arrow-04-05" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="rightArrow" data-pptx-frame="1005 368 30 24" data-pptx-av-adj1="val 33333" data-pptx-av-adj2="val 70833" fill="#CBD5E1" stroke="none">+ <path d="M 1005 376 L 1018 376 L 1018 368 L 1035 380 L 1018 392 L 1018 384 L 1005 384 Z"/>+ </g></g><!-- ==================== Bottom Flow Diagram ==================== --><rect x="30" y="610" width="30" height="30" rx="6" fill="#334155"/>- <path d="M 36 622 H 47 V 618 L 55 625 L 47 632 V 628 H 36 Z" fill="#FFFFFF"/>+ <g id="end-to-end-label-arrow" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="rightArrow" data-pptx-frame="36 618 19 14" data-pptx-av-adj1="val 42857" data-pptx-av-adj2="val 57143" fill="#FFFFFF" stroke="none">+ <path d="M 36 622 L 47 622 L 47 618 L 55 625 L 47 632 L 47 628 L 36 628 Z"/>+ </g><text x="45" y="675" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="800" fill="#0F172A" transform="rotate(-90, 45, 675)">END TO END</text><rect x="100" y="610" width="1150" height="90" rx="8" fill="none" stroke="#E2E8F0" stroke-width="2"/><text x="675" y="632" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="700" fill="#64748B" letter-spacing="0.5">Origin: Raw Data ————— 5-Stage Processing ————— Destination: Business Products</text>diff --git a/skills/ppt-master/templates/charts/process_flow.svg b/skills/ppt-master/templates/charts/process_flow.svgindex 9a33aab7..72aa83b0 100644--- a/skills/ppt-master/templates/charts/process_flow.svg+++ b/skills/ppt-master/templates/charts/process_flow.svg@@ -56,7 +56,9 @@<!-- ==================== Process Nodes ==================== --><g id="processFlowNodes"><!-- Start Node -->- <rect x="60" y="160" width="140" height="80" rx="40" fill="#334155" filter="url(#cardShadow)" />+ <g id="process-start-node" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="flowChartTerminator" data-pptx-frame="60 160 140 80" fill="#334155" stroke="none">+ <path d="M 82.52 160 L 177.48 160 A 22.52 40 0 0 1 177.48 240 L 82.52 240 A 22.52 40 0 0 1 82.52 160 Z"/>+ </g><text x="130" y="198" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="18" font-weight="800" fill="#FFFFFF" text-anchor="middle">Start</text><text x="130" y="218" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" font-weight="600" fill="#94A3B8" text-anchor="middle">Initiation</text><!-- Requirements Node -->@@ -65,7 +67,9 @@<rect x="330" y="210" width="80" height="20" rx="10" fill="#1D4ED8" fill-opacity="0.5" /><text x="370" y="224" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" font-weight="600" fill="#DBEAFE" text-anchor="middle">1-2 Days</text><!-- Decision Node -->- <path d="M 620,150 L 700,200 L 620,250 L 540,200 Z" fill="#F59E0B" filter="url(#cardShadow)" />+ <g id="process-decision-node" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="flowChartDecision" data-pptx-frame="540 150 160 100" fill="#F59E0B" stroke="none">+ <path d="M 540 200 L 620 150 L 700 200 L 620 250 Z"/>+ </g><text x="620" y="196" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="16" font-weight="800" fill="#FFFFFF" text-anchor="middle">Feasible?</text><text x="620" y="216" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" font-weight="700" fill="#FEF3C7" text-anchor="middle">Review</text><!-- Solution Design Node -->@@ -89,7 +93,9 @@<rect x="575" y="370" width="90" height="20" rx="10" fill="#FFEDD5" /><text x="620" y="384" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" font-weight="700" fill="#9A3412" text-anchor="middle">Adjust Scope</text><!-- Complete Node -->- <rect x="1060" y="480" width="140" height="80" rx="40" fill="#334155" filter="url(#cardShadow)" />+ <g id="process-complete-node" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="flowChartTerminator" data-pptx-frame="1060 480 140 80" fill="#334155" stroke="none">+ <path d="M 1082.52 480 L 1177.48 480 A 22.52 40 0 0 1 1177.48 560 L 1082.52 560 A 22.52 40 0 0 1 1082.52 480 Z"/>+ </g><text x="1130" y="518" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="18" font-weight="800" fill="#FFFFFF" text-anchor="middle">Complete</text><text x="1130" y="538" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="12" font-weight="600" fill="#94A3B8" text-anchor="middle">Deployment</text></g>@@ -99,7 +105,9 @@<text x="160" y="495" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="15" font-weight="800" fill="#0F172A" text-anchor="middle">Legend</text><rect x="80" y="520" width="30" height="20" rx="4" fill="#3B82F6" /><text x="125" y="535" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#475569">Process Step</text>- <path d="M 95,555 L 115,565 L 95,575 L 75,565 Z" fill="#F59E0B" />+ <g id="legend-decision-node" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="diamond" data-pptx-frame="75 555 40 20" fill="#F59E0B" stroke="none">+ <path d="M 75 565 L 95 555 L 115 565 L 95 575 Z"/>+ </g><text x="125" y="570" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#475569">Decision Node</text><rect x="80" y="590" width="30" height="20" rx="4" fill="#FFFFFF" stroke="#F97316" stroke-width="2" /><text x="125" y="605" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="13" font-weight="600" fill="#475569">Exception / Loop</text>diff --git a/skills/ppt-master/templates/charts/pyramid_chart.svg b/skills/ppt-master/templates/charts/pyramid_chart.svgindex f233cfac..062b2251 100644--- a/skills/ppt-master/templates/charts/pyramid_chart.svg+++ b/skills/ppt-master/templates/charts/pyramid_chart.svg@@ -40,15 +40,25 @@<!-- ==================== Pyramid Object ==================== --><g><!-- L1 (Base) -->- <polygon points="144,500 576,500 624,580 96,580" fill="#06B6D4" />+ <g id="pyramid-level-1" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="trapezoid" data-pptx-frame="96 500 528 80" data-pptx-av-adj="val 60000" fill="#06B6D4" stroke="none">+ <path d="M 96 580 L 144 500 L 576 500 L 624 580 Z"/>+ </g><!-- L2 -->- <polygon points="198,410 522,410 570,490 150,490" fill="#0EA5E9" />+ <g id="pyramid-level-2" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="trapezoid" data-pptx-frame="150 410 420 80" data-pptx-av-adj="val 60000" fill="#0EA5E9" stroke="none">+ <path d="M 150 490 L 198 410 L 522 410 L 570 490 Z"/>+ </g><!-- L3 -->- <polygon points="252,320 468,320 516,400 204,400" fill="#3B82F6" />+ <g id="pyramid-level-3" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="trapezoid" data-pptx-frame="204 320 312 80" data-pptx-av-adj="val 60000" fill="#3B82F6" stroke="none">+ <path d="M 204 400 L 252 320 L 468 320 L 516 400 Z"/>+ </g><!-- L4 -->- <polygon points="306,230 414,230 462,310 258,310" fill="#6366F1" />+ <g id="pyramid-level-4" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="trapezoid" data-pptx-frame="258 230 204 80" data-pptx-av-adj="val 60000" fill="#6366F1" stroke="none">+ <path d="M 258 310 L 306 230 L 414 230 L 462 310 Z"/>+ </g><!-- L5 (Top) -->- <polygon points="360,140 408,220 312,220" fill="#7C3AED" />+ <g id="pyramid-level-5" data-pptx-authoring="preset" data-pptx-object="shape" data-pptx-prst="triangle" data-pptx-frame="312 140 96 80" fill="#7C3AED" stroke="none">+ <path d="M 312 220 L 360 140 L 408 220 Z"/>+ </g></g><!-- Connection Anchor Dots --><g>diff --git a/skills/ppt-master/workflows/create-template.md b/skills/ppt-master/workflows/create-template.mdindex d8c6a860..094311f6 100644--- a/skills/ppt-master/workflows/create-template.md+++ b/skills/ppt-master/workflows/create-template.md@@ -382,7 +382,19 @@ The role interprets the package according to replication mode:| `standard` / `fidelity` | Newly authored SVGs based on the confirmed brief and visual references | Design an intentional new Master/Layout/slot system. Source topology is neither preserved nor distilled into the output. || `mirror` | Lossless imported SVG/native-structure evidence | Restore source pages, Master/Layout identities and parentage, placeholder identity/bounds, ownership, and supported native-object metadata one-to-one. Lightweight projections are inspection views only. |-**Hard rule — mode-specific authorship**: `standard` and `fidelity` author new SVG documents and compact canonical metadata. `mirror` restores the lossless source contract and may only normalize transport details required by the current compiler. Mirror never performs commonality extraction, semantic synthesis, merge/split, promotion/demotion, renaming, or re-parenting.+**Hard rule — mode-specific authorship**: `standard` and `fidelity` author new+project-canonical SVG documents. When one registered PowerPoint preset exactly+expresses one complete object, they use the compact canonical+`<g>` emitted by `preset_shape_svg.py`, following+[`native-shape-authoring.md`](../references/native-shape-authoring.md); its+paint comes from the confirmed brief and template `design_spec.md`. After+inserting the complete helper group, add only the registered structural+attributes required by its Master/Layout or object-slot role; geometry and+paint changes require a new helper render. `mirror` restores the expanded+lossless source contract and may only normalize transport details required by+the current compiler. Mirror never performs commonality+extraction, semantic synthesis, merge/split, promotion/demotion, renaming, or+re-parenting.**Hard rule — multi-Master package boundary**: More than one Master is valid only when `mirror` restores the source graph or an authored template intentionally defines distinct reusable design families. `standard` / `fidelity` must not create one Master per Layout or duplicate equivalent Masters merely for organization. Every declared Master must own at least one emitted Layout, and every declared Layout must be selected by at least one prototype SVG so the complete graph can be compiled and verified.@@ -395,11 +407,22 @@ The role interprets the package according to replication mode:SVG authors own the semantic roster, parentage, picker names, direct atoms, and slots. The exporter owns OOXML part cloning, Theme isolation, relationship registration, and package identity. Do not encode package repair workarounds in individual template SVGs.-Do not package `native_structure.json` or `source_template.pptx` as template inputs. In `standard` / `fidelity`, author Master/Layout direct atoms and bounded slot groups deliberately from the intended reusable behavior. In `mirror`, use the lossless layered and flat SVGs plus inheritance/native facts to preserve source ownership. Recursively expand fixed Master/Layout group wrappers only because the structured contract requires direct atoms; preserve transforms, styles, paint order, and appearance, and never flatten or regroup by semantic judgment.+Do not package `native_structure.json` or `source_template.pptx` as template inputs. In `standard` / `fidelity`, author Master/Layout direct semantic atoms and bounded slot groups deliberately from the intended reusable behavior. A validated compact canonical authored-preset `<g>` compiles to one native shape and therefore counts as one semantic atom; it may own a Master/Layout fixed layer or serve as the one direct carrier of an `object` slot. Ordinary groups are not structural atoms or single-object carriers. In `mirror`, use the lossless layered and flat SVGs plus inheritance/native facts to preserve source ownership. Recursively expand fixed Master/Layout group wrappers only because the structured contract requires semantic atoms; preserve transforms, styles, paint order, and appearance, and never flatten or regroup by semantic judgment.`design_spec.md §V` records the newly authored roster for `standard` / `fidelity`. For `mirror`, add the `Source Restoration Map` required by [template-designer.md](../references/template-designer.md), with one row per source slide and its preserved Master/Layout assignment. Do not add a synthesis-decision table.-**Native-shape metadata boundary**: The lightweight authoring projection removes opaque payload only from model context; it never becomes the restoration source. `standard` / `fidelity` use compact canonical shapes and assets rather than copied source payload. `mirror` reuses only native metadata already supported by the converter on unchanged Slide-local/slot objects. Fixed layers are normalized to direct atoms; unsupported or edited objects keep the current SVG fallback and are reported rather than silently replaced by stale metadata.+**Native-shape metadata boundary**: The lightweight authoring projection+removes opaque payload only from model context; it never becomes the+restoration source. `standard` / `fidelity` use helper-generated compact+canonical preset groups and project SVG/assets rather than copied source+payload. `mirror` preserves the expanded lossless representation and reuses+only native metadata already supported by the converter on unchanged+Slide-local/slot objects. Fixed layers are normalized to semantic atoms;+unsupported or edited objects keep the current SVG fallback and are reported+rather than silently replaced by stale metadata. Do not reproduce the preset+syntax here; its single authority is+[`shared-standards.md`](../references/shared-standards.md), with selection and+usage guidance in the native-shape reference.Downstream, both template-adherence choices use `pptx_structure.mode: structured`. `page_layouts` selects one complete authoring prototype per page, `pptx_masters` / `pptx_layouts` declare unique reusable definitions, and `page_pptx_layouts` assigns generated pages. Strict preserves the selected prototype contract. Adaptive keeps its Master and may explicitly create and assign a new Layout key/name while authoring the page that needs it. A retained Layout may remain unassigned while still registering through its definition SVG. A mirror-created package does not force a future generated deck to keep the source page count or order.@@ -430,7 +453,7 @@ Mirror mode does not simplify the visual target or synthesize layer ownership. T1. `design_spec.md` — **personality only**. Required sections: Template Overview, Color Scheme, Signature Design Elements, Page Roster (matching the actual SVG files on disk). Skip Typography / Assets / Placeholder Overrides when they would just restate defaults. Declare portable brief frontmatter; `register_template.py` consumes it only in library scope. **Do not** restate generic SVG constraints, layout pattern libraries, font-size ratio bands, the canonical placeholder table, or content methodology — those are sourced from `shared-standards.md` / `design_spec_reference.md` / `strategist.md` and are already in the downstream reader's context. Full scope rule and skeleton: [template-designer.md §1](../references/template-designer.md#1-must-generate-design_specmd).2. Page roster — see [Page Roster](../references/template-designer.md#page-roster) for `standard` / `fidelity` / `mirror` mode rosters, variant naming, and TOC handling3. Placeholder vocabulary — pages should adopt the conventional names (`{{TITLE}}`, `{{CONTENT_AREA}}`, ...) when they fit. Full reference: [Placeholder Reference](../references/template-designer.md#4-placeholder-reference-canonical-convention-overridable-per-template). When a template style legitimately needs different vocabulary (consulting → `{{KEY_MESSAGE}}`, branded cover → `{{BRAND_LOGO}}`), declare a `placeholders:` block in `design_spec.md` frontmatter so the registrar and quality checker treat it as the template's authoritative contract. **Avoid** one-off indexed families such as `{{CHAPTER_01_TITLE}}` — use the indexed TOC pattern instead.- - `{{...}}` placeholders are the authoring vocabulary used to generate final slide content. Each emitted SVG also carries the native reconstruction contract: root Master/Layout key/name, direct atomic Master/Layout elements, and direct slot `<g>` elements with explicit design-zone bounds plus exactly one compatible carrier. Composite regions use only the explicit `object` + `proxy` downgrade. Minimal structural `data-pptx-role` hints are added only when specialized metadata cannot express required behavior. Both strict and adaptive downstream set `mode: structured` and require complete `page_layouts`, `page_pptx_layouts`, `pptx_masters`, and `pptx_layouts` from planning onward.+ - `{{...}}` placeholders are the authoring vocabulary used to generate final slide content. Each emitted SVG also carries the native reconstruction contract: root Master/Layout key/name, direct atomic Master/Layout elements, and direct slot `<g>` elements with explicit design-zone bounds plus exactly one compatible carrier. A validated compact canonical authored-preset `<g>` counts as one semantic atom or one `object` carrier; ordinary groups do not. Composite regions use only the explicit `object` + `proxy` downgrade. Minimal structural `data-pptx-role` hints are added only when specialized metadata cannot express required behavior. Both strict and adaptive downstream set `mode: structured` and require complete `page_layouts`, `page_pptx_layouts`, `pptx_masters`, and `pptx_layouts` from planning onward.4. Template assets (optional) — both scopes apply the same `templates/` / `images/` / dual-icon routing defined above**Hard rule — placeholder examples are executable defaults**: In authored@@ -470,7 +493,7 @@ python3 skills/ppt-master/scripts/svg_quality_checker.py "<template_workspace>/t- enforce roster ↔ `design_spec.md` consistency as **errors** (orphan files / missing files break the template contract and, in library scope, the target kind's index)- emit advisory **warnings** when a page lacks a conventional placeholder — these are hints, not failures. Declare a `placeholders:` block in `design_spec.md` frontmatter to silence them when your template intentionally uses a different vocabulary- require every SVG root to declare one output Master and Layout; zero-slot Layouts are valid-- reject Master/Layout `<g>` elements, nested structure markers, missing slot bounds, and carrier-bound slots without exactly one compatible carrier+- reject ordinary Master/Layout `<g>` elements, nested structure markers, missing slot bounds, and carrier-bound slots without exactly one compatible carrier; a validated compact canonical authored-preset `<g>` is the sole fixed-layer group exception and may be one `object` carrier- validate cross-page Master equality plus same-key Layout atom/slot equality- warn when distinct Layout keys have identical static framing/slot contracts. Resolve this for `standard` / `fidelity`; mirror may retain the distinct source identities and records that fact in its Source Restoration Map@@ -487,8 +510,8 @@ This checker validates the authoring contract, not the compiled OOXML package. T- [ ] Placeholder names follow the canonical convention where applicable; templates with intentionally different vocabularies (e.g. `{{KEY_MESSAGE}}` instead of `{{PAGE_TITLE}}`) should declare a `placeholders:` frontmatter block to silence advisory warnings- [ ] Asset files referenced by SVGs exist at their resolved paths. In both scopes, bitmap references resolve through `../images/`; no bitmap remains accidentally stranded in `templates/`- [ ] `design_spec.md` frontmatter declares `native_structure_mode: structured`; no `native_structure.json` or `source_template.pptx` is packaged-- [ ] Every SVG root declares Master/Layout key and picker names; Master/Layout visuals are direct atoms, never `<g>`, and obey the explicit paint-order contract. Structural `data-pptx-role` is used only when specialized metadata cannot express required package/page-number/animation behavior-- [ ] Every slot is a direct `<g id>` with explicit design-zone bounds and exactly one compatible direct carrier, or an explicit composite `object` proxy; zero-slot Layouts remain valid+- [ ] Every SVG root declares Master/Layout key and picker names; Master/Layout visuals are direct semantic atoms and obey the explicit paint-order contract. Ordinary `<g>` elements remain forbidden there; a validated helper-generated compact canonical preset `<g>` is the sole group exception because it compiles to one native shape. Structural `data-pptx-role` is used only when specialized metadata cannot express required package/page-number/animation behavior+- [ ] Every slot is a direct `<g id>` with explicit design-zone bounds and exactly one compatible direct carrier, or an explicit composite `object` proxy. A validated compact canonical preset `<g>` may be the one carrier of an `object` slot; an ordinary multi-object group may not. Zero-slot Layouts remain valid- [ ] For `standard` / `fidelity`, every placeholder bound is the complete editable box rather than the current marker text's tight bounds; general body/object carriers begin at the upper-left and only intentional short focal roles remain centered- [ ] `standard` / `fidelity` output SVGs and their Master/Layout/slot contracts were newly authored without preserving or distilling source topology- [ ] Every additional authored Master represents a distinct reusable design family, not one Layout or an equivalent duplicate; every declared Master owns at least one emitted Layout and every declared Layout has at least one emitted prototype