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
docs(templates): add user-facing templates guide; recommend PPTX import
hugohe336e75080486a
diff --git a/README.md b/README.mdindex 460229f8..fa7742f1 100644--- a/README.md+++ b/README.md@@ -38,6 +38,8 @@ English | [中文](./README_CN.md)Drop in a PDF, DOCX, URL, or Markdown — get back a **natively editable PowerPoint** with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.+> **Template Replication** — hand the AI any `.pptx` you like and say "replicate it as a template via `/create-template`" — you get a layout set PPT Master can invoke directly. Theme colors, fonts, master/layout structure, reusable images, even sprite-sheet crop relationships are extracted straight from OOXML, so covers, chapter dividers and decoration-heavy pages all reproduce reliably. You're no longer limited to the built-in templates: a company brand deck, a client's winning template, or any high-quality reference can become a private template in your own library. See [Templates Guide →](./docs/templates-guide.md).+> **Animations** — exported decks support **page transitions** and **per-element entrance animations** as real OOXML, not embedded video. By default, elements cascade in automatically on slide entry — no clicking needed. Plays natively in PowerPoint and Keynote, no extra tooling. See [Animations & Transitions →](./skills/ppt-master/references/animations.md).> **Narration & Video** — generate per-slide voice narration from the speaker notes (`edge-tts` by default, optional cloud TTS providers for high-quality narration), embed the audio back into the PPTX, and let PowerPoint export the deck as an MP4 video — synced narration + transitions, no third-party tools. See [Audio Narration & Video Export →](./docs/audio-narration.md).@@ -256,7 +258,7 @@ PPT Master reads the current process environment first, then the first `.env` fo| 🆚 | [Why PPT Master](./docs/why-ppt-master.md) | How it compares to Gamma, Copilot, and other AI tools || 🪟 | [Windows Installation](./docs/windows-installation.md) | Step-by-step setup guide for Windows users || 📖 | [SKILL.md](./skills/ppt-master/SKILL.md) | Core workflow and rules |-| 🎨 | [Create a Custom Template](./skills/ppt-master/workflows/create-template.md) | Standalone workflow for building your own brand or industry template |+| 🎨 | [Templates Guide](./docs/templates-guide.md) | Use, derive (the focus), and template boundaries; covers `standard` vs `fidelity` modes || 📐 | [Canvas Formats](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9, Xiaohongshu, WeChat, and 10+ formats || 🎬 | [Animations & Transitions](./skills/ppt-master/references/animations.md) | Page transitions and per-element entrance animations || 🎙️ | [Audio Narration & Video Export](./docs/audio-narration.md) | TTS narration in 90+ locales, embed audio, export as MP4 |diff --git a/README_CN.md b/README_CN.mdindex 3534e1db..cfebf6ce 100644--- a/README_CN.md+++ b/README_CN.md@@ -38,6 +38,8 @@丢进一份 PDF、DOCX、网址或 Markdown,拿回一份**原生可编辑的 PowerPoint**——真正的形状、真正的文本框、真正的图表,不是图片。点击任何元素即可编辑。+> **模板复刻** —— 把任何一份你喜欢的 `.pptx` 丢给 AI,一句"用 `/create-template` 复刻成模板",就能拿到一套可被 PPT Master 直接调用的页面布局——主题色、字体、母版/版式结构、复用图片、甚至精灵图裁剪关系都按 OOXML 真实抽取,封面/章节/装饰繁复的页面都能稳定还原。从此你不再受限于内置模板:公司品牌 deck、客户中标模板、找的高质量参考稿,都能一键变成你的私人模板库。详见 [模板指南 →](./docs/zh/templates-guide.md)。+> **动画** —— 导出的 deck 支持**页间转场**和**页内元素入场动画**,输出为真正的 OOXML 动画(不是嵌入视频)。默认进入页面后元素按顺序自动级联入场,无需点击;在 PowerPoint 和 Keynote 中原生播放,无需额外工具。详见 [转场与动画使用指南 →](./docs/zh/animations.md)。> **旁白与视频** —— 把演讲者备注按页生成语音旁白(默认 `edge-tts`,也可配置云端 TTS 获得高质量音色),把音频嵌回 PPTX,再用 PowerPoint 自带"导出视频"产出带旁白和转场的 MP4,全程无需第三方工具。详见 [音频旁白与视频导出 →](./docs/zh/audio-narration.md)。@@ -260,7 +262,7 @@ PPT Master 会优先读取当前进程环境变量,然后按顺序读取第一| 🆚 | [为什么选 PPT Master](./docs/zh/why-ppt-master.md) | 与 Gamma、Copilot 等工具的对比 || 🪟 | [Windows 安装指南](./docs/zh/windows-installation.md) | Windows 用户手把手安装教程 || 📖 | [SKILL.md](./skills/ppt-master/SKILL.md) | 核心流程与规则 |-| 🎨 | [创建自定义模板](./skills/ppt-master/workflows/create-template.md) | 独立工作流,构建你自己的品牌或行业模板 |+| 🎨 | [模板指南](./docs/zh/templates-guide.md) | 选用、派生新模板(重点)、模板边界;含 standard / fidelity 模式选型 || 📐 | [画布格式](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9、小红书、朋友圈等 10+ 种格式 || 🎬 | [转场与动画](./docs/zh/animations.md) | 页间转场和页内元素入场动画 || 🎙️ | [音频旁白与视频导出](./docs/zh/audio-narration.md) | 90+ 语种 TTS 旁白、音频嵌入 PPTX、导出为 MP4 |diff --git a/docs/templates-guide.md b/docs/templates-guide.mdnew file mode 100644index 00000000..9629e96e--- /dev/null+++ b/docs/templates-guide.md@@ -0,0 +1,151 @@+# Templates Guide: Use, Derive, and Boundaries++A PPT Master "template" is a **structure + style** preset bundle: a set of page layout SVGs (cover / chapter / TOC / content / ending and their variants), a `design_spec.md` design specification, and matching assets (logos, backgrounds, decorative imagery). It is **not** a PowerPoint Slide Master, and **not** just a color palette — it is a reusable page-skeleton bundle the workflow can invoke directly.++This guide answers three questions:++1. [How do I use an existing template?](#1-use-an-existing-template)+2. [How do I turn someone else's PPT — or my own brand — into a template? (the focus)](#2-derive-a-new-template-the-focus)+3. [What are the limits of templates?](#3-template-boundaries)++---++## 1. Use an existing template++### How to trigger++The workflow **defaults to free design** — it will not ask whether you want a template. To enter the template flow, give an explicit trigger in chat:++| Trigger type | Example |+|--------------|---------|+| Name a specific template | "use the mckinsey template for this report" |+| Name a style / brand reference | "McKinsey style" / "Google style" / "academic defense look" |+| Ask for a list | "what templates are available?" |++On a hit, the AI reads [`templates/layouts/layouts_index.json`](../skills/ppt-master/templates/layouts/layouts_index.json), copies the matching template's SVGs, `design_spec.md`, and assets into the project's `templates/` directory, then proceeds to the Strategist phase.++### Template catalog++Full index in [`templates/layouts/README.md`](../skills/ppt-master/templates/layouts/README.md), grouped by Brand / General / Scenario / Government / Special, with primary color and use cases per entry. 21 templates currently shipped, covering McKinsey, Google, Anthropic, China Merchants Bank, PowerChina, CATARC, government blue/red, medical, psychology, pixel-retro and more.++### Free design vs template++Free design is **not** "no style" — the AI designs a fresh visual system **for that specific deck** based on its content. A template **reuses an already-defined structure and style**. Both involve real design work; the difference is whether the style is improvised or preset.++> Rule of thumb: clear content direction + strong brand or scenario constraints (consulting reports, government briefings, defenses) → use a template. Essay-like content where atmosphere matters more (magazine, documentary narrative) → free design usually works better.++---++## 2. Derive a new template (the focus)++Turn a PPT you like, a brand guideline, or an existing PPTX file into a PPT Master template. This is the core of this guide.++### Entry point: the `/create-template` workflow++Full spec in [`workflows/create-template.md`](../skills/ppt-master/workflows/create-template.md). This section is the user-facing short version — in your IDE, just say:++```+Please use the /create-template workflow to generate a new template based on the reference materials below.+```++The workflow will then **mandatorily** confirm a template brief with you before doing anything (this gate cannot be skipped).++### Step 1 — Prepare reference material++**Strongly recommended: hand over the original `.pptx` file.** The current PPTX import pipeline achieves near-high-fidelity reconstruction — the workflow uses [`pptx_template_import.py`](../skills/ppt-master/scripts/pptx_template_import.py) to read OOXML directly, extracting theme colors, fonts, master/layout structure, and reusable image assets (including sprite-sheet crop relationships), then hands the package to Template_Designer which rebuilds clean, maintainable SVGs. Covers, chapter dividers, and decoration-heavy pages all reproduce reliably. This is by far the most dependable derivation path today.++You can also design from scratch from a brand guideline: provide a logo, primary color HEX, fonts, tone description, and a few mood references — the AI will design the page skeletons on the spot. This suits brands that don't yet have a finished PPT, only a VI manual.++> **Fallback when no source PPTX exists**: a screenshot set (`cover.png` / `chapter.png` / `content.png` / `closing.png`, ...) still works, but fidelity drops noticeably — decoration, fonts, and layout details all rely on the AI's visual inference. Use `.pptx` whenever you can. Screenshots are better used as annotation alongside a PPTX ("this is the look I want") than as the sole reference.++### Step 2 — The template brief (mandatory confirmation)++The workflow does not silently infer values — before generation it lists these items and waits for your reply:++| Field | Notes |+|-------|-------|+| **Template ID** | Directory / index key. Prefer ASCII slug like `acme_consulting`; non-ASCII names work but must be filesystem-safe |+| **Display name** | Human-readable name for documentation |+| **Category** | One of `brand` / `general` / `scenario` / `government` / `special` |+| **Use cases** | Annual report / consulting / defense / government briefing / ... |+| **Tone summary** | One line, e.g. "modern, restrained, data-driven" |+| **Theme mode** | Light / dark / gradient / ... |+| **Canvas format** | Default `ppt169` (16:9); specify other formats up front |+| **Replication mode** | `standard` (default 5-page roster) / `fidelity` (preserve every distinct layout from a `.pptx` source) — `fidelity` requires a `.pptx` reference |+| **Visual fidelity** | (required when a reference exists) `literal` (reproduce original geometry / decoration / sprite crops as-is) or `adapted` (use reference for tone and structure but allow design evolution). Cover / chapter / ending are usually `literal` |+| **Keywords** | 3–5 tags for index lookup |+| Theme color / design notes / asset list | Optional — can be auto-extracted from the source |++After confirmation the workflow echoes the finalized brief and emits the marker `[TEMPLATE_BRIEF_CONFIRMED]`. Subsequent steps only run after that marker. **This is a hard gate — no brief, no generation.**++> Why so strict? Because a template is a library asset that future projects will reuse. Getting it right once is far cheaper than regenerating after the fact.++### Step 3 — `standard` or `fidelity`?++This is the most easily confused decision when deriving a template.++| | **standard** | **fidelity** |+|---|---|---|+| Output pages | 5 (cover / chapter / TOC / content / ending) | every distinct layout in the source PPTX is preserved |+| Best for | You want "tone + basic skeleton" to generate brand-new decks later | The source PPTX itself is a richly customized layout library and every variant matters |+| Typical use | Building a base brand template | Replicating a 20-variant government briefing layout set |+| Requires PPTX source? | No | **Yes** |+| Decoration complexity | Usually simpler | Must preserve sprite-sheet (cropped image) structure |++**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` mode 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.++### Step 4 — Registration and discovery++After generation, the workflow:++1. Runs [`svg_quality_checker.py`](../skills/ppt-master/scripts/svg_quality_checker.py) (hard gate — no entry without passing)+2. Registers the template ID in [`layouts_index.json`](../skills/ppt-master/templates/layouts/layouts_index.json)+3. Syncs the table in [`templates/layouts/README.md`](../skills/ppt-master/templates/layouts/README.md)++Once registered, any future project can invoke it by saying "use the `<your_template_id>` template".++### What a derived template looks like++```+skills/ppt-master/templates/layouts/<your_template_id>/+├── design_spec.md # design spec; §VI lists every page+├── 01_cover.svg+├── 02_chapter.svg+├── 02_toc.svg # optional+├── 03_content.svg+├── 03a_content_two_col.svg # variant in fidelity mode+├── 04_ending.svg+├── logo.png # brand asset+└── bg_pattern.jpg+```++Page SVGs use a unified placeholder convention (`{{TITLE}}`, `{{CHAPTER_TITLE}}`, `{{PAGE_TITLE}}`, `{{CONTENT_AREA}}`, ...) that the Strategist phase fills with content.++### Project-level customization vs global template++Don't confuse the two:++- **Derive a new template** = enter the global library at `skills/ppt-master/templates/layouts/`, available to all future projects+- **Project-level customization** = edit only the SVGs under `projects/<project>/templates/` for this one deck; not registered, no impact elsewhere++`/create-template` is for the former. For the latter, just edit the SVGs in the project directory directly — no workflow needed.++---++## 3. Template boundaries++Common misconceptions to avoid:++- **A template is not a PowerPoint Slide Master.** PPT Master outputs native DrawingML shapes and does not depend on the PowerPoint master mechanism. The template is an SVG skeleton, translated to PPTX shapes at export time+- **A template is not a "style skin".** It bundles structure (which blocks per page, how information is hierarchized) with style (colors, fonts, decoration). Trying to swap "skin" without structure tends to put the information architecture and the visuals at odds+- **A template does not make content decisions for you.** The Strategist still decides per-page which layout to use and whether to extend a variant. Templates offer candidates, not predetermined results+- **`fidelity` mode is not pixel-perfect copying.** Even with `literal` fidelity, the AI still strips noise and unnecessary repetition — geometry stays, redundancy goes++---++## Related docs++- [`workflows/create-template.md`](../skills/ppt-master/workflows/create-template.md) — full workflow spec (AI-facing)+- [`templates/layouts/README.md`](../skills/ppt-master/templates/layouts/README.md) — current template catalog+- [`references/template-designer.md`](../skills/ppt-master/references/template-designer.md) — Template_Designer role definition and SVG technical constraints+- [FAQ: how do I create a custom template?](./faq.md) — short FAQ versiondiff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex db15119f..170a9488 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -110,9 +110,9 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger o**第一步 — 准备参考材料**-最简单的方式是将参考 PPT 的关键页面类型分别截图保存:欢迎页、目录页、章节页、内容页、结尾页。将截图放到同一个文件夹中,并使用规范的文件名(如 `cover.png`、`toc.png`、`chapter.png`、`content.png`、`closing.png`)。+**最推荐的方式是直接给原始 `.pptx` 文件**。当前的 PPTX 导入管线能做到接近高保真还原——PPT Master 会从 PPTX 中提取主题色、字体、母版/版式结构、可复用图片资源(包括精灵图裁剪关系),再用这些素材重建出干净可维护的模板。封面、章节、装饰繁复的页面都能稳定还原,这是目前最靠谱的派生路径。-如果你已经有原始 `.pptx` 模板文件,也可以把它作为参考源一并提供。PPT Master 会先从 PPTX 中提取可复用的背景图、logo、主题色和字体信息,再把这些素材用于模板重建。+没有源 PPTX 时,截图集也能跑(`cover.png` / `toc.png` / `chapter.png` / `content.png` / `closing.png`),但保真度会明显下降。建议优先找原始 PPTX。**第二步 — 让 AI 创建模板**diff --git a/docs/zh/templates-guide.md b/docs/zh/templates-guide.mdnew file mode 100644index 00000000..ee0b3e93--- /dev/null+++ b/docs/zh/templates-guide.md@@ -0,0 +1,151 @@+# 模板指南:选用、派生与边界++PPT Master 的"模板"是一份**结构 + 风格**的预设包:包含若干页面布局 SVG(封面/章节/目录/内容/结尾及其变体)、`design_spec.md` 设计规范,以及配套素材(logo、背景、装饰图)。它不是 PPTX 母版,也不是单纯的配色方案——而是一组可被工作流直接复用的页面骨架。++本文回答三个问题:++1. [怎么用已有模板?](#一选用已有模板)+2. [怎么把别人的 PPT / 自己的品牌做成模板?(重点)](#二派生新模板重点)+3. [模板的边界是什么?](#三模板的边界)++---++## 一、选用已有模板++### 触发方式++工作流**默认走自由设计**——不会主动问你要不要用模板。要进入模板流程,在对话里给出明确触发即可:++| 触发类型 | 例子 |+|----------|------|+| 直接点名 | "用 mckinsey 模板做这份报告" |+| 风格类比 | "麦肯锡那种风格" / "Google style" / "学术答辩样式" |+| 列清单 | "有哪些模板可以用?" |++命中后,AI 会读取 [`templates/layouts/layouts_index.json`](../../skills/ppt-master/templates/layouts/layouts_index.json),把对应模板的 SVG、`design_spec.md` 和素材复制到当前项目的 `templates/` 目录,再进入策略师阶段。++### 现有模板一览++完整索引见 [`templates/layouts/README.md`](../../skills/ppt-master/templates/layouts/README.md),按"品牌 / 通用 / 场景 / 政企 / 特殊"分类,每条都标注了主色和适用场景。当前共 21 套,覆盖麦肯锡、Google、Anthropic、招商银行、中国电建、中汽研、政府蓝/红、医学院、心理学、像素复古等。++### 自由设计 vs 模板++自由设计不是"没有风格",而是 AI 根据你的内容**为这一份 deck 现场设计**视觉系统;模板则是**沿用一套已经定型的结构和风格**。两条路都不会少做"设计",区别只在于风格是即兴还是预设。++> 经验:内容方向明确、品牌或场景有强约束(咨询报告、政府汇报、答辩)→ 用模板。内容偏散文式、视觉氛围更重要(杂志风、纪录式叙事)→ 自由设计往往效果更好。++---++## 二、派生新模板(重点)++把你自己喜欢的 PPT、品牌指南、或一份现成的 PPTX,做成 PPT Master 可调用的模板。这是本文的核心。++### 入口:`/create-template` 工作流++完整规范见 [`workflows/create-template.md`](../../skills/ppt-master/workflows/create-template.md)。本节是面向用户的简要版本——你只需要在 IDE 对话里说:++```+请用 /create-template 工作流,基于下面的参考材料生成一个新模板。+```++接下来工作流会**强制**先和你确认一份模板简报(不允许跳过)。++### 第一步:准备参考材料++**强烈推荐:直接给原始 `.pptx` 文件。** 当前的 PPTX 导入管线已经做到接近高保真还原——工作流会用 [`pptx_template_import.py`](../../skills/ppt-master/scripts/pptx_template_import.py) 直接读取 OOXML,提取主题色、字体、母版/版式结构、可复用图片资源(包括精灵图裁剪关系),再交给 Template_Designer 重建出干净可维护的 SVG。封面、章节、装饰繁复的页面都能稳定还原,这是目前最靠谱的派生路径。++也可以基于品牌指南从零设计:提供 logo、主色 HEX、字体、调性描述、几张氛围参考图,AI 会现场设计页面骨架。适合品牌方还没有成型 PPT、只有 VI 手册的场景。++> **没有源 PPTX 时的兜底**:截图集(`cover.png` / `chapter.png` / `content.png` / `closing.png` 等)也能跑,但保真度会明显下降——装饰、字体、版式细节都靠 AI 视觉推断。能拿到 `.pptx` 就尽量用 `.pptx`。截图更适合作为标注辅助("这页是我想要的样子")混进 PPTX 一起给。++### 第二步:模板简报(强制确认环节)++工作流不会偷偷推断——它会在动手前向你列出以下条目,等你确认或补全:++| 字段 | 说明 |+|------|------|+| **模板 ID** | 目录名 / 索引键。优先 ASCII slug,如 `acme_consulting`;中文品牌名也行,但要文件系统安全 |+| **显示名称** | 文档中的人类可读名 |+| **类别** | `brand` / `general` / `scenario` / `government` / `special` 五选一 |+| **适用场景** | 年报 / 咨询 / 答辩 / 政府汇报…… |+| **调性概要** | 一句话,如"现代克制、数据驱动" |+| **主题模式** | 浅色 / 深色 / 渐变…… |+| **画布格式** | 默认 `ppt169`(16:9),其他格式需提前指定 |+| **复刻模式** | `standard`(默认 5 页基本套)/ `fidelity`(保留 PPTX 源里所有不同版式)—— `fidelity` 必须有 `.pptx` 源 |+| **保真级别** | (有源时必填)`literal`(按原样复刻几何/装饰/精灵图裁剪)/ `adapted`(借结构和调性、允许设计演化)。封面 / 章节 / 结尾通常用 `literal` |+| **关键词** | 3–5 个标签,用于索引检索 |+| 主题色 / 设计风格 / 素材清单 | 可选,可让 AI 从源里自动提取 |++确认后,工作流会回显一份完整简报并写入标记 `[TEMPLATE_BRIEF_CONFIRMED]`,从这一刻起后续步骤才会启动。**这是一个硬门——简报没确认,不会开始生成**。++> 为什么这么严?因为模板是入库资产,未来会被复用。一次说清楚,比生成完再返工便宜得多。++### 第三步:选 standard 还是 fidelity?++这是派生模板里最容易混淆的决策。++| | **standard** | **fidelity** |+|---|---|---|+| 输出页数 | 5 页(封面/章节/目录/内容/结尾) | 源 PPTX 里所有不同版式都保留 |+| 适合场景 | 你只需要"调性 + 基本骨架",未来用模板生成全新 deck | 源 PPTX 本身就是高度定制的版式库,每种版式都有用 |+| 典型例子 | 给品牌做基础模板 | 复刻一套政府汇报模板的 20 种章节版式 |+| 必须有 PPTX 源吗 | 否 | **是** |+| 装饰复杂度 | 通常较简洁 | 需要保留精灵图(sprite sheet)裁剪等结构 |++**关于精灵图**:PPTX 导出的素材常常是**一张大图 + 多页通过 viewBox 裁剪不同区域**。`fidelity` 模式下必须保留这层嵌套 `<svg viewBox=...>` 包装,不能扁平化为单张 `<image>`——否则裁剪信息丢失,画面会错位。工作流会自动校验这一点。++### 第四步:注册与发现++模板生成完,工作流会:++1. 跑 [`svg_quality_checker.py`](../../skills/ppt-master/scripts/svg_quality_checker.py) 验证(硬门,不通过不入库)+2. 把模板 ID 注册到 [`layouts_index.json`](../../skills/ppt-master/templates/layouts/layouts_index.json)+3. 同步 [`templates/layouts/README.md`](../../skills/ppt-master/templates/layouts/README.md) 表格++注册完毕,下次任何项目里你说"用 `<你的模板 ID>` 模板",工作流就能找到它。++### 派生后的目录长什么样++```+skills/ppt-master/templates/layouts/<your_template_id>/+├── design_spec.md # 设计规范,§VI 列出全部页面+├── 01_cover.svg+├── 02_chapter.svg+├── 02_toc.svg # 可选+├── 03_content.svg+├── 03a_content_two_col.svg # fidelity 模式下的变体+├── 04_ending.svg+├── logo.png # 品牌素材+└── bg_pattern.jpg+```++页面 SVG 里使用统一的占位符约定(`{{TITLE}}`、`{{CHAPTER_TITLE}}`、`{{PAGE_TITLE}}`、`{{CONTENT_AREA}}` 等),策略师阶段会按内容填充。++### 项目级一次性定制 vs 全局模板++二者别搞混:++- **派生新模板** = 入全局库,在 `skills/ppt-master/templates/layouts/` 下,未来所有项目都能调用+- **项目级定制** = 只在 `projects/<project>/templates/` 里改这一份 deck 的页面,不入库、不影响其他项目++`/create-template` 工作流只做前者。后者直接在项目目录里改 SVG 即可,不需要走这个流程。++---++## 三、模板的边界++避免常见误解:++- **模板 ≠ 母版(Slide Master)**。PPT Master 的输出是原生 DrawingML 形状,不依赖 PowerPoint 母版机制。模板是 SVG 骨架,最终在导出阶段被翻译为 PPTX 形状+- **模板不是"风格皮肤"**。它包含结构(页面有几块、信息层级如何分布)+ 风格(配色、字体、装饰),两者不可分割。试图只换"皮肤"不换结构,往往会让信息架构和视觉打架+- **模板不会替你做内容决策**。策略师仍然会按内容判断每页用哪个版式、要不要扩展为变体,模板提供候选,不预设结果+- **`fidelity` 模式不等于像素级搬运**。即便是 `literal` 保真,AI 仍会把杂质和不必要的重复结构清理掉——载体保留几何,但不照抄冗余++---++## 相关文档++- [`workflows/create-template.md`](../../skills/ppt-master/workflows/create-template.md) — 完整工作流规范(面向 AI 执行)+- [`templates/layouts/README.md`](../../skills/ppt-master/templates/layouts/README.md) — 现有模板一览+- [`references/template-designer.md`](../../skills/ppt-master/references/template-designer.md) — 模板设计师角色定义和 SVG 技术约束+- [常见问题:如何制作自定义模板](./faq.md#q-如何制作自定义模板) — FAQ 简版