dsh-ppt 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.4.0
+
+- **动效（motion，默认开）**：HTML 放映页间淡入 + 要点按序逐条入场（打印自动兜底为静态）；PPTX 每页原生淡入转场，`bullets` 页按段落构建、放映时点击一次出现一条要点（PowerPoint「出现，按段落」标准时序）。
+- **`motion` 开关**：`ppt_create` 新增 `motion: 'on' | 'off'`，CLI 新增 `--motion on|off`；`off` 时产物不含任何动画代码，适合严肃/打印场景。manifest 记录该开关。
+- **技能文件瘦身**：SKILL.md 收敛为触发条件 + 执行纪律 + 六步流水线 + 按需装载索引 + 质量门禁；新增 `references/syntax.md`（Markdown 解析、表格/金句/备注语法、结构化 slides、motion）与 `references/troubleshooting.md`；写作规则去重归口 `references/copywriting.md`，hyperframes 视觉联动并入 `references/themes.md`。
+- 动效相关测试 8 例（转场/时序树/点击节点计数/静态开关/CLI/工具层），全套 42/42 通过。
+
+## 0.3.0
+
+- **演讲者备注**：结构化 `slides` 的 `notes` 字段与 Markdown `<!-- 备注: ... -->` 注释都会成为该页备注；HTML 放映按 `S` 键（或右下角「备注」按钮）呼出备注面板；PPTX 生成原生 `notesSlide` + `notesMaster` 部件，PowerPoint 演示者视图直接可用。
+- **新增 `quote` 金句版式**：`>` 引用块自动识别，末行 `—— 出处` 识别为署名；HTML 与 PPTX 双端实现。
+- **新增 `table` 表格版式**：Markdown 表格（`| ... |`）自动识别，PPTX 用原生 `a:tbl` 图形帧（主题色表头 + 隔行着色），限 9 行 8 列。
+- 版式集合扩为 `cover | section | bullets | statement | quote | table | closing`；结构化 `slides` 增加 `rows` 字段。
+- 无表格数据的 `table` 页自动退化为要点页，避免空白版式。
+- 新特性测试 8 例（解析/规范化/HTML/PPTX 部件/端到端）。
+
+## 0.2.1
+
+- 修复 PPTX zip 中央目录 local header 偏移恒为 0 导致 PowerPoint 提示修复的问题（issue #1/#3，社区 PR #2 同修法）。
+
 ## 0.2.0
 
 - 新增 `defaultTheme` / `defaultLang` 配置，作为 `ppt_create` 未显式传参时的默认值。

package/README.en.md

@@ -4,7 +4,7 @@
 
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
-> **One sentence or one document → a complete presentation**: HTML web slideshow + PPTX export, 5 visual themes, bilingual Chinese/English.
+> **One sentence or one document → a complete presentation**: HTML web slideshow + PPTX export, 5 visual themes, slide transitions + bullet entrance animations, bilingual Chinese/English.
 
 DeepSeek Harness (DSH) presentation skill + tool plugin: turns a sentence, a paragraph, or a Markdown document into a ready-to-present **HTML slideshow** and an editable **PPTX**. Pure Node, **zero runtime dependencies**, one codebase for Windows / macOS / Linux.
 
@@ -14,6 +14,10 @@ DeepSeek Harness (DSH) presentation skill + tool plugin: turns a sentence, a par
 | --- | --- |
 | `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
 | `ppt_themes` tool | Lists the 5 built-in themes and their best use cases |
+| 7 layouts | cover / section / bullets / statement / **quote** / **table** / closing |
+| Speaker notes | `<!-- note: ... -->` comments or the `notes` field: press `S` in the HTML player; native PPTX notes slides (presenter view) |
+| Motion | On by default: HTML slide-in transitions + staggered bullet entrances; native PPTX fade transitions + click-to-reveal bullets. `motion: 'off'` / `--motion off` for a fully static deck |
+| Markdown extras | Tables (`\| ... \|`), blockquotes (`>`), and note comments are auto-detected into matching layouts |
 | `dsh-ppt` skill | A complete six-step SOP registered into DSH |
 | Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
 | Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
@@ -26,7 +30,7 @@ Example:
 
 ## Compatibility
 
-Verified against `@deepseek-ai/dsh@0.1.2-alpha.2` on 2026-08-31. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+Verified against `@deepseek-ai/dsh@0.1.2-alpha.3` on 2026-09-01. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
 
 ## Installation
 

package/README.md

@@ -2,7 +2,7 @@
 
 # dsh-ppt
 
-> **一句话 / 一篇文档 → 完整演示文稿**：HTML 网页放映 + PPTX 导出，5 套视觉主题，中英双语。
+> **一句话 / 一篇文档 → 完整演示文稿**：HTML 网页放映 + PPTX 导出，5 套视觉主题，页间转场 + 要点入场动画，中英双语。
 
 ![npm version](https://img.shields.io/npm/v/dsh-ppt?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-ppt) ![license](https://img.shields.io/npm/l/dsh-ppt) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ppt?style=social)
 
@@ -16,6 +16,10 @@ DSH（DeepSeek Harness）演示文稿技能 + 工具插件：把一句话、一
 | --- | --- |
 | `ppt_create` 工具 | Markdown / 结构化 slides → `*.html` + `*.pptx` + `*.json` 三件套 |
 | `ppt_themes` 工具 | 列出 5 套内置主题与适用场景 |
+| 7 种页型 | 封面 / 章节 / 要点 / 核心观点 / **金句** / **表格** / 结束页 |
+| 演讲者备注 | `<!-- 备注: ... -->` 或 `notes` 字段：HTML 按 `S` 呼出，PPTX 原生备注页（演示者视图） |
+| 动效（motion） | 默认开：HTML 页间淡入 + 要点逐条入场；PPTX 原生转场 + 要点逐条点击显现；`motion: 'off'` / `--motion off` 产出纯静态 |
+| Markdown 进阶 | 表格（`\| ... \|`）、引用金句（`>`）、备注注释自动识别成对应页型 |
 | `dsh-ppt` 技能 | 完整 SOP 注册进 DSH：从一句话到成品 deck 的六步流水线 |
 | 裸 SKILL.md | 把 `skills/dsh-ppt/` 复制到 Claude Code / Cursor / Gemini CLI / Codex 即可跨 harness 使用 |
 | 视觉引擎 | 复用 hyperframes 视觉风格库，5 套主题 HTML 与 PPTX 同源同色 |
@@ -28,7 +32,7 @@ DSH（DeepSeek Harness）演示文稿技能 + 工具插件：把一句话、一
 
 ## 兼容性
 
-在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+在 `@deepseek-ai/dsh@0.1.2-alpha.3` 上验证（2026-09-01 全量冒烟通过）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
 
 ## 安装
 

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * dsh-ppt —— 演示文稿技能 + 工具插件（v0.1.0）。
+ * dsh-ppt —— 演示文稿技能 + 工具插件。
  *
  * 一句话或一篇 Markdown 文档 → 完整演示文稿三件套：
  *   deck.html  独立网页放映（无外链）
@@ -157,10 +157,11 @@ export function apply(ctx, config = {}) {
         description: 'Build a complete presentation deck from one sentence or a Markdown document and write three artifacts to outputDir: a standalone HTML web slideshow, an editable 16:9 PPTX, and a deck.json manifest. Five built-in visual themes are available (see ppt_themes). content is Markdown text (recommended); advanced callers may pass structured slides instead. 中文：把一句话或一篇 Markdown 文档生成完整演示文稿，写入 outputDir 三个文件：独立 HTML 网页放映、可编辑 16:9 PPTX、deck.json manifest；内置 5 套视觉主题。',
         parameters: compileParameters({
             title: { type: 'string', required: true, description: 'Deck title (used for the cover and file names).' },
-            content: { type: 'string', required: true, description: 'Markdown content: one sentence, a paragraph, or a full document. First # heading becomes the cover title; ## headings become slides; -/* lists become bullets. Required unless slides is provided.' },
+            content: { type: 'string', required: true, description: 'Markdown content: one sentence, a paragraph, or a full document. First # heading becomes the cover title; ## headings become slides; -/* lists become bullets; | ... | tables become table slides; > blockquotes become quote slides; <!-- 备注: ... --> comments become speaker notes. Required unless slides is provided.' },
             theme: { type: 'string', description: 'Visual theme id: swiss / velvet / data / soft / bold. Default data. See ppt_themes.' },
             lang: { type: 'string', description: 'UI language of the generated player: zh (default), en, or bilingual. Content language is whatever you write.' },
-            slides: { type: 'array', items: { type: 'object', additionalProperties: true }, description: 'Optional structured slides: [{ layout: cover|section|bullets|statement|closing, title, subtitle, kicker, bullets: [] }]. Use this for precise control instead of content.' },
+            motion: { type: 'string', enum: ['on', 'off'], description: 'Slide transitions plus bullet entrance animations: on (default) or off for a fully static deck.' },
+            slides: { type: 'array', items: { type: 'object', additionalProperties: true }, description: 'Optional structured slides: [{ layout: cover|section|bullets|statement|quote|table|closing, title, subtitle, kicker, bullets: [], rows: [][] (for table), notes: "speaker notes" }]. Use this for precise control instead of content.' },
             outputDir: { type: 'string', description: 'Directory to write the files into. Default: session working directory (or the plugin outputDir config).' },
             fileName: { type: 'string', description: 'Base file name for the three artifacts. Default: sanitized deck title.' },
         }),
@@ -183,6 +184,7 @@ export function apply(ctx, config = {}) {
                 slides: hasSlides ? args.slides : undefined,
                 theme: typeof args.theme === 'string' && args.theme.trim() !== '' ? args.theme.trim() : (resolved.defaultTheme || undefined),
                 lang: typeof args.lang === 'string' && args.lang.trim() !== '' ? args.lang.trim() : (resolved.defaultLang || undefined),
+                motion: args.motion,
                 outputDir: typeof args.outputDir === 'string' && args.outputDir.trim() !== '' ? args.outputDir.trim() : (resolved.outputDir || undefined),
                 fileName: typeof args.fileName === 'string' && args.fileName.trim() !== '' ? args.fileName.trim() : undefined,
                 maxSlides: resolved.maxSlides,

package/lib/types.d.ts

@@ -28,6 +28,8 @@ export interface PptCreateArgs {
     slides?: PptSlideSpec[];
     theme?: string;
     lang?: string;
+    /** 页间转场与要点入场动画：on（默认）/ off。 */
+    motion?: 'on' | 'off';
     outputDir?: string;
     fileName?: string;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ppt",
-  "version": "0.2.1",
-  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题，可配置默认主题/语言，中英双语，SKILL.md 双格式跨 harness。",
+  "version": "0.4.0",
+  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题与页间转场/要点入场动画（motion 可关），可配置默认主题/语言，中英双语，SKILL.md 薄路由 + references 按需装载，跨 harness。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/skills/dsh-ppt/SKILL.md

@@ -1,93 +1,59 @@
 ---
 name: dsh-ppt
-description: "Turn one sentence or a Markdown document into a complete, presentation-ready deck: a standalone HTML web slideshow plus an editable PPTX export, with 5 built-in visual themes (Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type) and bilingual Chinese/English support. Use when the user asks for a PPT, slides, deck, keynote, 演示文稿, 幻灯片, 汇报, 提案, 路演, 培训材料, or wants to turn a document into a presentation. 中文：把一句话或一篇文档变成完整演示文稿（HTML 网页放映 + PPTX 导出），内置 5 套视觉主题，中英双语。"
+description: "Turn one sentence or a Markdown document into a complete, presentation-ready deck: a standalone HTML web slideshow plus an editable PPTX export, with 5 built-in visual themes (Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type), slide transitions + bullet entrance animations (motion, on by default), and bilingual Chinese/English support. Use when the user asks for a PPT, slides, deck, keynote, 演示文稿, 幻灯片, 汇报, 提案, 路演, 培训材料, or wants to turn a document into a presentation. 中文：把一句话或一篇文档变成完整演示文稿（HTML 网页放映 + PPTX 导出），内置 5 套视觉主题、页间转场与要点入场动画，中英双语。"
 compatibility: "DSH plugin runs in-process with zero runtime dependencies. The standalone CLI needs Node.js >= 20. Cross-harness: copy this skill directory into any Agent Skills directory."
 allowed-tools: "Bash, Read, Write, Edit"
 ---
 
 # dsh-ppt
 
-一句话或一篇文档 → 完整演示文稿：**独立 HTML 网页放映 + 可编辑 PPTX**。这是从内容到成品的完整 SOP；DSH 内安装插件后调用 `ppt_create` / `ppt_themes` 工具，其他 harness 复制本目录并运行 `scripts/build-deck.mjs`。
+一句话或一篇文档 → 完整演示文稿：**独立 HTML 网页放映 + 可编辑 PPTX**。本文件只做路由与纪律；具体规则按需读取 `references/`。
 
 ## 触发条件
 
-- 用户要求做 PPT、幻灯片、演示文稿、deck、keynote、汇报、提案、路演、培训材料。
-- 用户给了一句话、一段文字或一篇 Markdown 文档，希望变成可放映/可分享的演示。
-- 用户提到导出 PPTX 或网页版幻灯片。
+用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料，或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
 
-## 核心流水线（每次执行）
+## 执行纪律（每次都要遵守）
 
-1. **Probe 需求**：读入用户的句子/文档。确定听众、目标（说服/汇报/教学/发布）、语气与情绪基调。一句话输入不要反问，直接按发布场景推断并产出完整内容。
-2. **Outline 大纲**：产出 5–12 页大纲。每页只讲一个观点；页型组合固定为：封面 → 问题/背景 → 方案/论点（3–6 页）→ 证据/案例 → 行动号召 → 结束页。每页要点不超过 6 条，每条不超过 20 字（中文）或 12 词（英文）。
-3. **Theme 主题**：调用 `ppt_themes`（DSH）或 `node scripts/build-deck.mjs --list-themes`（跨 harness）选择视觉主题。情绪 → 主题映射见 `references/themes.md`；默认 `data`（技术/AI），高管汇报用 `velvet`，数据报表用 `swiss`，温暖叙事用 `soft`，大声量发布用 `bold`。
-4. **Build 生成**：
-   - DSH 内：调用 `ppt_create`，把大纲写成 Markdown 传 `content`（推荐），或直接传结构化 `slides`。
-   - 跨 harness：`node <skill-dir>/scripts/build-deck.mjs --title "标题" --content deck.md --theme data --lang zh --out dist`
-   - 输出三件套：`*.html`（双击即放映）、`*.pptx`（可编辑）、`*.json`（manifest）。
-5. **Verify 校验**：确认 HTML 页数与大纲一致、标题/要点无截断；PPTX 文件头为 `PK`（zip）。DSH 内用文件工具读取确认；跨 harness 用 `unzip -l deck.pptx | grep presentation.xml` 或 PowerShell `Expand-Archive` 抽查。
-6. **Deliver 交付**：给用户三个绝对路径，并说明：HTML 浏览器直接打开（方向键翻页、F 全屏、G 总览、P 打印/另存 PDF）；PPTX 用 PowerPoint / WPS / Keynote 打开。
-
-## 内容写作规则
-
-- 一句话输入也要「完整」：封面 = 标题 + 那句话；核心观点页 = 原句放大；结束页 = 谢谢/行动号召。若用户要求更丰富，先自行扩写成 6–10 页大纲再构建。
 - 一页一个观点；标题是判断句，不是名词短语。
-- 正文用短句；先结论后理由；数字和对比比形容词更有说服力。
-- 中英双语：`lang` 只决定界面文字（页码/主题标签/结束页），**内容语言由你撰写**。要求双语时，优先每页中文标题 + 英文副标题，或直接生成两份 deck（`--lang zh` 与 `--lang en`）。
-- 更多规则见 `references/copywriting.md`。
-
-## 主题选择
-
-内置 5 套主题（源自 hyperframes 视觉风格库）：
-
-| 主题 ID | 名称 | 情绪 | 适用 |
-| --- | --- | --- | --- |
-| `data` | 数据漂移 | 未来/沉浸 | AI、技术发布、研究（默认） |
-| `swiss` | 瑞士脉冲 | 精准/理性 | 数据、SaaS、开发者工具 |
-| `velvet` | 天鹅绒标准 | 高级/克制 | 高管汇报、品牌、融资路演 |
-| `soft` | 柔和信号 | 温暖/人本 | 品牌故事、培训、个人分享 |
-| `bold` | 极繁大字 | 大声/动能 | 产品发布、活动、大事件 |
-
-完整色板与反模式见 `references/themes.md`。
-
-## 视觉引擎复用（hyperframes）
+- 内容语言由你撰写；`lang` 只决定界面文字。
+- 先选主题再构建；不确定就用默认 `data`。
+- 交付前逐项过一遍文末「质量门禁」。
 
-如果 `hyperframes` 技能已安装，生成前先读它的 `visual-styles.md` / `house-style.md` 作为视觉判断依据；本技能的 5 套主题就是把其中 Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type 五套风格落成确定性 HTML+PPTX 实现。需要高级动画视频版时，才转用 hyperframes；普通演示不要上视频引擎。
+## 核心流水线
 
-## 结构化 slides（高级用法）
-
-`ppt_create` 的 `slides` 与 CLI `--slides` 接受 JSON 数组：
-
-```json
-[
-  { "layout": "cover", "title": "标题", "subtitle": "副标题", "kicker": "开场" },
-  { "layout": "section", "kicker": "01", "title": "背景" },
-  { "layout": "bullets", "title": "三个论点", "bullets": ["论点一", "论点二", "论点三"] },
-  { "layout": "statement", "title": "核心观点一句话", "subtitle": "支撑说明" },
-  { "layout": "closing", "title": "谢谢", "subtitle": "行动号召" }
-]
-```
-
-`layout` 仅限 `cover | section | bullets | statement | closing`。Markdown 输入不够精确时，用结构化 slides 重写。
+1. **Probe 需求**：读入用户的句子/文档，确定听众、目标、语气。一句话输入不要反问，直接按发布场景推断。
+2. **Outline 大纲**：产出 5–12 页大纲（封面 → 问题/背景 → 方案/论点 3–6 页 → 证据 → 行动号召 → 结束页）。
+   → 写大纲与正文前先读 `references/copywriting.md`。
+3. **Theme 主题**：调 `ppt_themes`（DSH）或 `node scripts/build-deck.mjs --list-themes`（跨 harness）。
+   → 拿不准选哪套时读 `references/themes.md` 的情绪决策树。
+4. **Build 生成**：
+   - DSH 内：调 `ppt_create`，大纲写成 Markdown 传 `content`（推荐），或传结构化 `slides`。
+   - 跨 harness：`node <skill-dir>/scripts/build-deck.mjs --title "标题" --content deck.md --theme data --lang zh --out dist`。
+   - 动效默认开（页间转场 + 要点逐条入场）；严肃/打印场景传 `motion: 'off'`。
+   → 用表格 / 金句 / 备注 / 结构化 slides 前读 `references/syntax.md`。
+5. **Verify 校验**：确认 HTML 页数与大纲一致、标题无截断、PPTX 文件头为 `PK`。
+6. **Deliver 交付**：给用户三个绝对路径，说明 HTML 直接放映（← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印），PPTX 用 PowerPoint / WPS / Keynote 打开（备注在演示者视图可见，bullets 页放映时逐条点击出现）。
+
+## 按需装载索引
+
+| 何时读 | 文件 | 内容 |
+| --- | --- | --- |
+| 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
+| 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
+| 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
+| 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
 
 ## 质量门禁（交付前逐项确认）
 
 - [ ] 页数 3–60，首屏是封面，末屏是结束页。
-- [ ] 每页有明确标题；bullets 页 1–8 条。
+- [ ] 每页有明确标题；bullets 页 1–8 条，中文每条 ≤ 20 字、英文 ≤ 12 词。
 - [ ] HTML 与 PPTX 使用同一主题，配色一致。
 - [ ] 主题色对比度足够（深底浅字或浅底深字）。
 - [ ] 中文内容无错别字；英文标题用 Title Case。
+- [ ] 最后一页有可执行的行动号召，不只是「谢谢」。
 - [ ] 文件已写到用户工作区，路径为绝对路径。
 
-## 故障排查
-
-| 症状 | 处理 |
-| --- | --- |
-| `ppt_create` 不存在 | 本插件未安装；用 `node <skill-dir>/scripts/build-deck.mjs` 裸 CLI 生成同样三件套 |
-| 未知主题 | `ppt_themes` 或 `--list-themes` 看可用 ID；不要猜 |
-| 内容超过 60 页 | 合并论点，或拆成多个 deck；`maxSlides` 默认 60 |
-| PPTX 打不开 | 确认文件完整（zip 头 `PK`）；Office 首次打开空白版式属正常，编辑视图可用 |
-| 双语界面 | `lang: bilingual` 只双语化界面；内容双语由 agent 在写作阶段完成 |
-
 ## 跨 harness 安装
 
 把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录即可（只依赖 Node 20+）：

package/skills/dsh-ppt/references/copywriting.md

@@ -30,18 +30,9 @@
 - 英文标题用 Title Case；术语首现给中文+英文，如「检索增强生成（RAG）」。
 - 双语时不要逐句直译，按目标语言习惯重写。
 
-## Markdown 输入规范
-
-`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown：
-
-- 第一个 `# 标题` 会成为封面标题；其后的段落/列表成为封面副标题来源。
-- 每个 `## 小节`（或更深标题）生成一页：
-  - 有 `- ` / `* ` / `1.` 列表 → `bullets` 页；
-  - 无列表且无正文 → `section` 过渡页；
-  - 有正文段落 → 正文拆句后作为 bullets。
-- 没有标题的纯文本：第一段第一句为封面副标题，后续段落按 5 句一组拆成要点页。
-- 只有一句话：自动生成「封面 → 核心观点 → 结束页」三页。
-- 需要更精细控制时使用结构化 `slides` JSON，不要和 Markdown 混用。
+## Markdown 与结构化输入
+
+解析规则、表格/金句/备注语法与结构化 `slides` JSON 见 `syntax.md`。
 
 ## 示例
 

package/skills/dsh-ppt/references/syntax.md

@@ -0,0 +1,44 @@
+# dsh-ppt 输入语法参考（Markdown / 结构化 slides / 动效）
+
+只在需要查具体语法时读本文件；常规流程在 SKILL.md。
+
+## Markdown 解析规则
+
+`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown：
+
+- 第一个 `# 标题` 会成为封面标题；其后的段落/列表成为封面副标题来源。
+- 每个 `## 小节`（或更深标题）生成一页：
+  - 有 `- ` / `* ` / `1.` 列表 → `bullets` 页；
+  - 无列表且无正文 → `section` 过渡页；
+  - 有正文段落 → 正文拆句后作为 bullets。
+- 没有标题的纯文本：第一段第一句为封面副标题，后续段落按 5 句一组拆成要点页。
+- 只有一句话：自动生成「封面 → 核心观点 → 结束页」三页。
+- 需要更精细控制时使用结构化 `slides` JSON，不要和 Markdown 混用。
+
+## 进阶语法（自动识别）
+
+- **表格**：`| 列 | 列 |` 连续行（第二行 `| --- | --- |` 分隔线）→ 独立 `table` 页（主题色表头，限 9 行 8 列）。数据对比优先用表格，别堆要点。
+- **金句**：`>` 引用块 → 独立 `quote` 页；最后一行写 `—— 出处` 会成为署名。
+- **演讲者备注**：`<!-- 备注: 这页要讲的内容 -->`（或 `<!-- note: ... -->`）附着到该页。备注不进正文：HTML 放映按 `S` 呼出备注面板，PPTX 写入原生备注（演示者视图可见）。为汇报/演讲类 deck 主动写备注（口径、数据出处、应答预案）。
+
+## 结构化 slides（高级用法）
+
+`ppt_create` 的 `slides` 与 CLI `--slides` 接受 JSON 数组：
+
+```json
+[
+  { "layout": "cover", "title": "标题", "subtitle": "副标题", "kicker": "开场", "notes": "开场先自我介绍 30 秒" },
+  { "layout": "section", "kicker": "01", "title": "背景" },
+  { "layout": "bullets", "title": "三个论点", "bullets": ["论点一", "论点二", "论点三"] },
+  { "layout": "table", "title": "业绩对比", "rows": [["大区", "营收"], ["华东", "1.2 亿"]], "notes": "强调华东增速" },
+  { "layout": "quote", "title": "慢就是快。", "subtitle": "创始人" },
+  { "layout": "statement", "title": "核心观点一句话", "subtitle": "支撑说明" },
+  { "layout": "closing", "title": "谢谢", "subtitle": "行动号召" }
+]
+```
+
+`layout` 仅限 `cover | section | bullets | statement | quote | table | closing`；每页可选 `notes`（演讲者备注），`table` 页用 `rows`（首行为表头）。Markdown 输入不够精确时，用结构化 slides 重写。
+
+## 动效（motion）
+
+默认 `motion: on`：HTML 放映有页间淡入与要点逐条入场；PPTX 每页原生淡入转场，`bullets` 页的要点按「点击一次出现一条」放映。交付严肃/打印场景或用户明确要静态时传 `motion: 'off'`（CLI `--motion off`），产物不含任何动画代码。

package/skills/dsh-ppt/references/themes.md

@@ -53,3 +53,7 @@
 5. 情绪是大音量/发布会 → `bold`
 
 无法判断时用 `data`，不要自造主题 ID。
+
+## 视觉引擎复用（hyperframes）
+
+如果 `hyperframes` 技能已安装，生成前先读它的 `visual-styles.md` / `house-style.md` 作为视觉判断依据；本技能的 5 套主题就是把其中 Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type 五套风格落成确定性 HTML+PPTX 实现。需要高级动画视频版时，才转用 hyperframes；普通演示不要上视频引擎。

package/skills/dsh-ppt/references/troubleshooting.md

@@ -0,0 +1,13 @@
+# dsh-ppt 故障排查
+
+只在交付异常时读本文件。
+
+| 症状 | 处理 |
+| --- | --- |
+| `ppt_create` 不存在 | 本插件未安装；用 `node <skill-dir>/scripts/build-deck.mjs` 裸 CLI 生成同样三件套 |
+| 未知主题 | `ppt_themes` 或 `--list-themes` 看可用 ID；不要猜 |
+| 内容超过 60 页 | 合并论点，或拆成多个 deck；`maxSlides` 默认 60 |
+| PPTX 打不开 | 确认文件完整（zip 头 `PK`）；Office 首次打开空白版式属正常，编辑视图可用 |
+| 双语界面 | `lang: bilingual` 只双语化界面；内容双语由 agent 在写作阶段完成 |
+| 放映没有动画 | `motion` 被设为 `off`；默认 `on` 时 HTML 有转场、PPTX 要点逐条点击出现 |
+| HTML 打印要点缺失 | 打印样式已强制显示全部要点；若仍缺失检查浏览器是否屏蔽了动画样式 |

package/skills/dsh-ppt/scripts/build-deck.mjs

@@ -16,7 +16,7 @@ import { resolve as resolvePath } from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { buildDeck, listThemes, THEME_IDS, DEFAULT_THEME } from './deck-core.mjs'
 
-const HELP = `dsh-ppt v0.1.0 —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导出
+const HELP = `dsh-ppt —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导出
 
 用法：
   node build-deck.mjs --title <标题> --content <Markdown 或文件路径> [选项]
@@ -27,6 +27,7 @@ const HELP = `dsh-ppt v0.1.0 —— 一句话 / 一篇文档 → HTML 放映 + P
   --slides <json>     结构化 slides JSON（可选，与 --content 二选一）
   --theme <id>        视觉主题：${THEME_IDS.join(' / ')}（默认 ${DEFAULT_THEME}）
   --lang <id>         界面语言：zh / en / bilingual（默认 zh）
+  --motion <on|off>   页间转场与要点入场动画（默认 on；off 产出纯静态）
   --out <dir>         输出目录（默认当前目录）
   --file <name>       文件名前缀（默认取标题）
   --list-themes       列出内置主题
@@ -39,7 +40,7 @@ const HELP = `dsh-ppt v0.1.0 —— 一句话 / 一篇文档 → HTML 放映 + P
 `
 
 export function parseArgv(argv) {
-  const args = { content: '', slides: null, lang: 'zh', theme: DEFAULT_THEME, out: '.', file: '', title: '' }
+  const args = { content: '', slides: null, lang: 'zh', theme: DEFAULT_THEME, motion: undefined, out: '.', file: '', title: '' }
   const positional = []
   for (let i = 0; i < argv.length; i += 1) {
     const raw = String(argv[i])
@@ -59,6 +60,7 @@ export function parseArgv(argv) {
     else if (key === '--slides') args.slides = JSON.parse(nextValue())
     else if (key === '--theme') args.theme = nextValue()
     else if (key === '--lang') args.lang = nextValue()
+    else if (key === '--motion') args.motion = nextValue()
     else if (key === '--out') args.out = nextValue()
     else if (key === '--file') args.file = nextValue()
     else positional.push(raw)
@@ -105,6 +107,7 @@ export async function main(argv = process.argv.slice(2), io = {}) {
     slides,
     theme: args.theme,
     lang: args.lang,
+    motion: args.motion,
     outputDir: resolvePath(args.out || '.'),
     fileName: args.file,
   }

package/skills/dsh-ppt/scripts/deck-core.mjs

@@ -18,7 +18,7 @@ import { mkdirSync, writeFileSync } from 'node:fs'
 import { resolve as resolvePath } from 'node:path'
 import { deflateRawSync } from 'node:zlib'
 
-export const DECK_VERSION = '0.1.0'
+export const DECK_VERSION = '0.3.0'
 
 // ---------------------------------------------------------------------------
 // 主题
@@ -133,10 +133,14 @@ export const LANGUAGES = {
       slide: '第',
       of: '/ 共',
       theme: '主题',
-      help: '← → 翻页 · F 全屏 · G 总览 · P 打印',
+      help: '← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印',
       coverKicker: '开场',
       pointKicker: '要点',
       statementKicker: '核心观点',
+      quoteKicker: '金句',
+      tableKicker: '数据',
+      notesLabel: '演讲者备注',
+      notesToggle: '备注',
       closingTitle: '谢谢',
       closingSubtitle: '讨论与问答',
       generatedBy: '由 dsh-ppt 生成',
@@ -149,10 +153,14 @@ export const LANGUAGES = {
       slide: 'Slide',
       of: '/',
       theme: 'Theme',
-      help: '← → navigate · F fullscreen · G overview · P print',
+      help: '← → navigate · F fullscreen · G overview · S notes · P print',
       coverKicker: 'Opening',
       pointKicker: 'Key point',
       statementKicker: 'Core idea',
+      quoteKicker: 'Quote',
+      tableKicker: 'Data',
+      notesLabel: 'Speaker notes',
+      notesToggle: 'Notes',
       closingTitle: 'Thank You',
       closingSubtitle: 'Discussion & Q&A',
       generatedBy: 'Generated with dsh-ppt',
@@ -165,10 +173,14 @@ export const LANGUAGES = {
       slide: '第',
       of: '/ 共',
       theme: '主题 · Theme',
-      help: '← → 翻页 · F 全屏 · G 总览 · P 打印',
+      help: '← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印',
       coverKicker: '开场 · Opening',
       pointKicker: '要点 · Key point',
       statementKicker: '核心观点 · Core Idea',
+      quoteKicker: '金句 · Quote',
+      tableKicker: '数据 · Data',
+      notesLabel: '演讲者备注 · Speaker notes',
+      notesToggle: '备注 · Notes',
       closingTitle: '谢谢 · Thank You',
       closingSubtitle: '讨论与问答 · Q&A',
       generatedBy: '由 dsh-ppt 生成 · Generated with dsh-ppt',
@@ -194,6 +206,13 @@ export function resolveLanguage(input) {
   return language
 }
 
+export function resolveMotion(input) {
+  if (input === undefined || input === null || input === '') return true
+  if (input === true || input === 'on') return true
+  if (input === false || input === 'off') return false
+  throw new Error('dsh-ppt：未知 motion 值 "' + String(input) + '"，可选：on / off（默认 on）')
+}
+
 export function listThemes(lang = 'zh') {
   const pick = (pair) => (lang === 'en' ? pair.en : pair.zh)
   return THEME_IDS.map((id) => {
@@ -285,7 +304,49 @@ function chunk(items, size) {
 // ---------------------------------------------------------------------------
 
 function createSection(heading = '', level = 0, coverOnly = false) {
-  return { heading, level, coverOnly, bullets: [], paragraphs: [] }
+  return { heading, level, coverOnly, bullets: [], paragraphs: [], quote: [], table: null, notes: [] }
+}
+
+function splitTableRow(line) {
+  const trimmed = line.trim()
+  const match = /^\|(.+)\|$/.exec(trimmed)
+  if (match === null) return null
+  return match[1].split('|').map((cell) => cell.trim())
+}
+
+function isTableSeparator(cells) {
+  return cells.length > 0 && cells.every((cell) => /^:?-{2,}:?$/.test(cell) || /^:?-+:?$/.test(cell))
+}
+
+const NOTES_COMMENT = /^<!--\s*(?:notes?|备注)\s*[:：]\s*([\s\S]*?)\s*-->$/
+
+function quoteSlideFrom(section, ui) {
+  const lines = [...section.quote]
+  let attribution = ''
+  const attrMatch = /^(?:——|—|--|-)\s*(.+)$/.exec(lines[lines.length - 1] ?? '')
+  if (attrMatch !== null && lines.length > 1) {
+    attribution = attrMatch[1]
+    lines.pop()
+  }
+  return { layout: 'quote', kicker: ui.quoteKicker, title: truncate(lines.join(' '), 220), subtitle: attribution }
+}
+
+function tableSlideFrom(section, ui) {
+  const table = section.table
+  const rows = [table.header, ...table.rows]
+    .slice(0, 9)
+    .map((row) => row.slice(0, 8).map((cell) => truncate(cell, 60)))
+  const heading = section.heading || ui.tableKicker
+  return { layout: 'table', kicker: heading, title: heading, rows }
+}
+
+/** 把一个 section 里的金句/表格拆成独立页；备注附着到第一张产出页。 */
+function specialSlidesFor(section, ui) {
+  const out = []
+  if (section.quote.length > 0) out.push(quoteSlideFrom(section, ui))
+  if (section.table !== null) out.push(tableSlideFrom(section, ui))
+  if (out.length > 0 && section.notes.length > 0) out[0].notes = section.notes.join('\n')
+  return out
 }
 
 export function parseMarkdownDeck(titleInput, content, lang = 'zh') {
@@ -347,6 +408,38 @@ export function parseMarkdownDeck(titleInput, content, lang = 'zh') {
       continue
     }
 
+    // 演讲者备注：`<!-- 备注: ... -->` / `<!-- note: ... -->` 附到当前页
+    const notesMatch = NOTES_COMMENT.exec(line)
+    if (notesMatch !== null && notesMatch[1].trim() !== '') {
+      if (current === null) current = createSection()
+      current.notes.push(notesMatch[1].trim())
+      continue
+    }
+
+    // Markdown 表格：连续的 | ... | 行，第二行是分隔线
+    const tableCells = splitTableRow(line)
+    if (tableCells !== null) {
+      if (current === null) current = createSection()
+      if (isTableSeparator(tableCells)) continue
+      if (current.table === null) {
+        current.table = { header: tableCells.map((cell) => stripInlineMarkdown(cell)), rows: [] }
+      } else if (current.table.rows.length < 12) {
+        current.table.rows.push(tableCells.map((cell) => stripInlineMarkdown(cell)))
+      }
+      continue
+    }
+
+    // 金句：`>` 引用块（最后一行 `—— 出处` 识别为署名）
+    const quoteMatch = /^>\s?(.*)$/.exec(line)
+    if (quoteMatch !== null) {
+      const quoted = stripInlineMarkdown(quoteMatch[1])
+      if (quoted !== '') {
+        if (current === null) current = createSection()
+        current.quote.push(quoted)
+      }
+      continue
+    }
+
     const paragraph = stripInlineMarkdown(line)
     if (paragraph === '') continue
     if (current === null) current = createSection()
@@ -404,24 +497,31 @@ export function parseMarkdownDeck(titleInput, content, lang = 'zh') {
     }))
     const firstSentence = ordered[0]?.sentences[0] ?? ''
     if (coverSubtitle === '') coverSubtitle = truncate(firstSentence, 180)
-    const rest = ordered.flatMap((group, groupIndex) => {
+    const bodySlides = []
+    let pointIndex = 0
+    ordered.forEach((group, groupIndex) => {
+      const specials = specialSlidesFor(group.section, ui)
+      bodySlides.push(...specials)
       const sentences = (groupIndex === 0 && !coverSubtitleConsumed) ? group.sentences.slice(1) : group.sentences
-      return chunk(sentences, 5)
+      for (const points of chunk(sentences, 5)) {
+        pointIndex += 1
+        const slide = {
+          layout: 'bullets',
+          kicker: ui.pointKicker + ' ' + pointIndex,
+          title: truncate(points[0], 40) || ui.pointKicker + ' ' + pointIndex,
+          bullets: points,
+        }
+        if (specials.length === 0 && group.section.notes.length > 0) slide.notes = group.section.notes.join('\n')
+        bodySlides.push(slide)
+      }
     })
     slides.push({ layout: 'cover', kicker: ui.coverKicker, title: coverTitle || 'Untitled', subtitle: coverSubtitle })
-    if (rest.length === 0) {
+    if (bodySlides.length === 0) {
       if (coverSubtitle !== '') {
         slides.push({ layout: 'statement', kicker: ui.statementKicker, title: coverSubtitle, subtitle: coverTitle || 'Untitled' })
       }
     } else {
-      rest.forEach((points, index) => {
-        slides.push({
-          layout: 'bullets',
-          kicker: ui.pointKicker + ' ' + (index + 1),
-          title: truncate(points[0], 40) || ui.pointKicker + ' ' + (index + 1),
-          bullets: points,
-        })
-      })
+      slides.push(...bodySlides)
     }
     slides.push({ layout: 'closing', title: ui.closingTitle, subtitle: coverTitle || 'Untitled' })
     return { title: coverTitle || 'Untitled', subtitle: coverSubtitle, slides }
@@ -430,18 +530,23 @@ export function parseMarkdownDeck(titleInput, content, lang = 'zh') {
   slides.push({ layout: 'cover', kicker: ui.coverKicker, title: coverTitle || 'Untitled', subtitle: coverSubtitle })
   let pointIndex = 0
   for (const section of bodySections) {
+    const notes = section.notes.join('\n')
+    const specials = specialSlidesFor(section, ui)
+    slides.push(...specials)
     if (section.heading === '') {
       const points = [...section.bullets, ...section.paragraphs]
         .flatMap((part) => splitSentences(part))
         .slice(0, 8)
       if (points.length > 0) {
         pointIndex += 1
-        slides.push({
+        const slide = {
           layout: 'bullets',
           kicker: ui.pointKicker + ' ' + pointIndex,
           title: truncate(points[0], 40) || ui.pointKicker + ' ' + pointIndex,
           bullets: points,
-        })
+        }
+        if (specials.length === 0 && notes !== '') slide.notes = notes
+        slides.push(slide)
       }
       continue
     }
@@ -450,16 +555,20 @@ export function parseMarkdownDeck(titleInput, content, lang = 'zh') {
       ...section.paragraphs.flatMap((part) => splitSentences(part)),
     ].slice(0, 8)
     if (points.length > 0) {
-      slides.push({ layout: 'bullets', kicker: section.heading, title: section.heading, bullets: points })
-    } else {
-      slides.push({ layout: 'section', kicker: section.heading, title: section.heading })
+      const slide = { layout: 'bullets', kicker: section.heading, title: section.heading, bullets: points }
+      if (specials.length === 0 && notes !== '') slide.notes = notes
+      slides.push(slide)
+    } else if (specials.length === 0) {
+      const slide = { layout: 'section', kicker: section.heading, title: section.heading }
+      if (notes !== '') slide.notes = notes
+      slides.push(slide)
     }
   }
   slides.push({ layout: 'closing', title: ui.closingTitle, subtitle: coverTitle || 'Untitled' })
   return { title: coverTitle || 'Untitled', subtitle: coverSubtitle, slides }
 }
 
-const SLIDE_LAYOUTS = new Set(['cover', 'section', 'bullets', 'statement', 'closing'])
+const SLIDE_LAYOUTS = new Set(['cover', 'section', 'bullets', 'statement', 'closing', 'quote', 'table'])
 
 function normalizeSlide(raw, index) {
   const source = (raw !== null && typeof raw === 'object') ? raw : {}
@@ -468,6 +577,8 @@ function normalizeSlide(raw, index) {
   const subtitle = stripInlineMarkdown(source.subtitle ?? '')
   const kicker = stripInlineMarkdown(source.kicker ?? '')
   const text = stripInlineMarkdown(source.text ?? '')
+  // 备注保留换行（放映面板与备注页都按原文显示），只做转义，不做 Markdown 清洗
+  const notes = String(source.notes ?? '').trim()
   let bullets = []
   if (Array.isArray(source.bullets)) {
     bullets = source.bullets.map((item) => stripInlineMarkdown(String(item))).filter(Boolean)
@@ -475,9 +586,29 @@ function normalizeSlide(raw, index) {
     bullets = splitSentences(source.bullets)
   }
   if (layout === 'statement' && title === '' && text !== '') {
-    return { layout, kicker, title: text, subtitle: subtitle || '', bullets }
+    return { layout, kicker, title: text, subtitle: subtitle || '', bullets, ...(notes !== '' ? { notes } : {}) }
   }
-  return { layout, kicker, title, subtitle, text, bullets }
+  if (layout === 'quote') {
+    const quoteText = title !== '' ? title : text
+    if (quoteText === '') return { layout: 'statement', kicker, title: subtitle, subtitle: '', bullets, ...(notes !== '' ? { notes } : {}) }
+    return { layout, kicker, title: truncate(quoteText, 220), subtitle, ...(notes !== '' ? { notes } : {}) }
+  }
+  if (layout === 'table') {
+    let rows = []
+    if (Array.isArray(source.rows)) {
+      rows = source.rows
+        .map((row) => (Array.isArray(row) ? row : [row]).map((cell) => stripInlineMarkdown(String(cell))))
+        .filter((row) => row.some((cell) => cell !== ''))
+        .slice(0, 9)
+        .map((row) => row.slice(0, 8).map((cell) => truncate(cell, 60)))
+    }
+    if (rows.length === 0) {
+      // 没有表格数据的 table 页退化成要点页，避免产出空白版式
+      return { layout: 'bullets', kicker, title, subtitle, bullets, ...(notes !== '' ? { notes } : {}) }
+    }
+    return { layout, kicker: kicker || title, title, rows, ...(notes !== '' ? { notes } : {}) }
+  }
+  return { layout, kicker, title, subtitle, text, bullets, ...(notes !== '' ? { notes } : {}) }
 }
 
 export function normalizeSlides(rawSlides, maxSlides = 60) {
@@ -502,6 +633,7 @@ export function normalizeBuildOptions(options = {}) {
   if (title === '') throw new Error('dsh-ppt：title 不能为空')
   const theme = resolveTheme(options.theme)
   const language = resolveLanguage(options.lang)
+  const motion = resolveMotion(options.motion)
   const maxSlides = clampInt(options.maxSlides, 60, 3, 120)
   let deck
   if (Array.isArray(options.slides) && options.slides.length > 0) {
@@ -522,12 +654,12 @@ export function normalizeBuildOptions(options = {}) {
   if (deck.slides.length < 1) throw new Error('dsh-ppt：没有可生成的幻灯片')
   const outputDir = resolvePath(String(options.outputDir ?? '.').trim() || '.')
   const fileName = sanitizeFileName(options.fileName ?? title)
-  return { title, theme, language, deck, outputDir, fileName }
+  return { title, theme, language, motion, deck, outputDir, fileName }
 }
 
 export function buildDeck(options = {}) {
   const normalized = normalizeBuildOptions(options)
-  const { title, theme, language, deck, outputDir, fileName } = normalized
+  const { title, theme, language, motion, deck, outputDir, fileName } = normalized
   mkdirSync(outputDir, { recursive: true })
 
   const manifest = {
@@ -535,6 +667,7 @@ export function buildDeck(options = {}) {
     title,
     theme: theme.id,
     language: language.id,
+    motion,
     slideCount: deck.slides.length,
     slides: deck.slides,
   }
@@ -572,6 +705,16 @@ export function renderHtml(manifest, theme, language) {
   const t = theme
   const lang = language
   const ui = lang.ui
+  const motion = manifest.motion !== false
+  const motionCss = motion
+    ? `body.motion .slide.is-active{animation:slide-in .45s cubic-bezier(.22,.8,.36,1)}
+@keyframes slide-in{from{opacity:0;transform:translateY(24px)}to{opacity:1;transform:none}}
+body.motion .bullets li{
+  opacity:0;animation:bullet-in .55s cubic-bezier(.22,.8,.36,1) forwards;
+  animation-delay:calc(var(--i, 0)*90ms + .12s);
+}
+@keyframes bullet-in{from{opacity:0;transform:translateY(14px)}to{opacity:1;transform:none}}`
+    : ''
   const slides = manifest.slides.map((slide, index) => renderHtmlSlide(slide, index, ui, lang.id)).join('\n')
   const themeLabel = t.name[lang.id] ?? t.name.en
   const total = manifest.slides.length
@@ -611,8 +754,8 @@ body{
     radial-gradient(36% 30% at 12% 86%, ${hexToRgba(t.palette.accent2, t.dark ? 0.16 : 0.12)}, transparent 70%),
     radial-gradient(70% 60% at 50% 50%, ${hexToRgba(t.palette.panel, 0.55)}, transparent 100%);
 }
-.slide.is-active{display:flex;animation:slide-in .45s cubic-bezier(.22,.8,.36,1)}
-@keyframes slide-in{from{opacity:0;transform:translateY(24px)}to{opacity:1;transform:none}}
+.slide.is-active{display:flex}
+${motionCss}
 .kicker{
   color:var(--accent);font-weight:700;letter-spacing:.18em;text-transform:uppercase;
   font-size:clamp(12px,1.3vw,18px);margin-bottom:22px;
@@ -647,6 +790,28 @@ h2{font-size:clamp(34px,5vw,82px);max-width:20ch}
 .closing h1,.closing .statement-title{font-size:clamp(52px,9vw,148px)}
 .closing .subtitle{color:var(--accent);font-weight:700}
 .cover h1{font-weight:900}
+.quote-mark{
+  font-family:var(--font-heading);font-size:clamp(90px,13vw,210px);line-height:.62;
+  color:var(--accent);margin-bottom:clamp(14px,2vw,30px);
+}
+.quote-text{
+  font-family:var(--font-heading);font-size:clamp(26px,4.2vw,62px);line-height:1.28;
+  font-weight:700;max-width:22ch;margin:0;
+}
+.quote-attr{color:var(--muted);margin-top:clamp(18px,2.6vw,34px);font-size:clamp(15px,1.8vw,26px);letter-spacing:.04em}
+table.deck-table{
+  border-collapse:collapse;margin-top:clamp(20px,3vw,42px);width:100%;max-width:1120px;
+  font-size:clamp(13px,1.55vw,23px);
+}
+.deck-table th{
+  background:var(--accent);color:var(--bg);text-align:left;font-weight:700;
+  padding:.6em .9em;letter-spacing:.02em;
+}
+.deck-table td{
+  padding:.55em .9em;border-bottom:1px solid color-mix(in srgb, var(--muted) 34%, transparent);
+  color:var(--fg);
+}
+.deck-table tbody tr:nth-child(even){background:color-mix(in srgb, var(--panel) 62%, transparent)}
 #progress{position:fixed;top:0;left:0;height:3px;width:0;background:var(--accent);z-index:30;transition:width .25s}
 #hud{
   position:fixed;right:22px;bottom:18px;z-index:30;display:flex;gap:14px;align-items:center;
@@ -658,42 +823,71 @@ h2{font-size:clamp(34px,5vw,82px);max-width:20ch}
   padding:7px 13px;font:inherit;cursor:pointer;
 }
 #hud button:hover{border-color:var(--accent);color:var(--accent)}
+#notes-panel{
+  position:fixed;left:0;right:0;bottom:0;z-index:40;display:none;
+  background:color-mix(in srgb, var(--panel) 96%, black 4%);
+  border-top:2px solid var(--accent);
+  padding:16px clamp(22px,4vw,64px) 20px;max-height:38vh;overflow:auto;
+}
+body.notes-open #notes-panel.has-notes{display:block}
+#notes-panel .notes-label{
+  color:var(--accent);font-weight:700;letter-spacing:.14em;text-transform:uppercase;
+  font-size:12px;margin-bottom:8px;
+}
+#notes-text{white-space:pre-wrap;line-height:1.65;font-size:15px;color:var(--fg)}
 body.overview .slide{display:flex !important;position:relative;inset:auto;width:100%;height:100vh}
 body.overview{overflow:auto}
 body.overview #progress,body.overview #hud{position:fixed}
+body.overview #notes-panel{display:none !important}
 @media (max-width:640px){
   #hud{right:12px;bottom:10px;gap:8px;font-size:11px}
 }
 @media print{
   html,body{height:auto;overflow:visible;background:#fff}
   .slide{position:relative;display:block !important;height:100vh;page-break-after:always;padding:48px}
-  #progress,#hud{display:none !important}
+  ${motion ? 'body.motion .bullets li{opacity:1 !important;animation:none !important}' : ''}
+  #progress,#hud,#notes-panel{display:none !important}
 }
 </style>
 </head>
-<body>
+<body class="${motion ? 'motion' : 'no-motion'}">
 <div id="progress" aria-hidden="true"></div>
 ${slides}
 <div id="hud" aria-live="polite">
   <span id="counter">${ui.slide} 1 ${ui.of} ${total}</span>
   <span id="theme-label">${ui.theme} · ${escapeHtml(themeLabel)}</span>
+  <button id="notes-toggle" title="S">${escapeHtml(ui.notesToggle)}</button>
   <button id="fullscreen" title="F">⛶</button>
 </div>
+<div id="notes-panel" aria-live="polite">
+  <div class="notes-label">${escapeHtml(ui.notesLabel)}</div>
+  <div id="notes-text"></div>
+</div>
 <script>
 (() => {
   const slides = Array.from(document.querySelectorAll('.slide'));
   const counter = document.getElementById('counter');
   const progress = document.getElementById('progress');
   const fullscreenBtn = document.getElementById('fullscreen');
+  const notesPanel = document.getElementById('notes-panel');
+  const notesText = document.getElementById('notes-text');
+  const notesBtn = document.getElementById('notes-toggle');
   let index = 0;
   const total = slides.length;
   const ui = ${JSON.stringify(ui).replace(/</g, '\\u003c')};
 
+  function refreshNotes() {
+    const notes = slides[index]?.dataset.notes || '';
+    notesPanel.classList.toggle('has-notes', notes !== '');
+    notesText.textContent = notes;
+  }
+
   function go(next) {
     index = (next + total) % total;
     slides.forEach((slide, i) => slide.classList.toggle('is-active', i === index));
     counter.textContent = ui.slide + ' ' + (index + 1) + ' ' + ui.of + ' ' + total;
     progress.style.width = ((index + 1) / total * 100) + '%';
+    refreshNotes();
     document.title = (index + 1) + ' / ' + total + ' · ' + ${JSON.stringify(manifest.title).replace(/</g, '\\u003c')};
     try { history.replaceState?.(null, '', '#slide-' + (index + 1)); } catch { /* file:// 下个别浏览器可能拒绝 */ }
   }
@@ -713,6 +907,8 @@ ${slides}
     } else if (event.key.toLowerCase() === 'g') {
       document.body.classList.toggle('overview');
       go(index);
+    } else if (event.key.toLowerCase() === 's') {
+      document.body.classList.toggle('notes-open');
     } else if (event.key.toLowerCase() === 'p') {
       window.print();
     }
@@ -738,6 +934,10 @@ ${slides}
     else document.exitFullscreen?.();
   });
 
+  notesBtn.addEventListener('click', () => {
+    document.body.classList.toggle('notes-open');
+  });
+
   const start = Number.parseInt(location.hash?.replace('#slide-', ''), 10);
   go(Number.isInteger(start) ? start - 1 : 0);
 })();
@@ -771,6 +971,25 @@ function renderHtmlSlide(slide, index, ui, langId) {
         '<div class="statement-title">' + escapeHtml(title || slide.text || '') + '</div>' +
         (subtitle !== '' ? '<div class="subtitle">' + escapeHtml(subtitle) + '</div>' : '')
       break
+    case 'quote':
+      inner = '<div class="kicker">' + escapeHtml(kicker || ui.quoteKicker) + '</div>' +
+        '<div class="quote-mark" aria-hidden="true">\u201C</div>' +
+        '<blockquote class="quote-text">' + escapeHtml(title || slide.text || '') + '</blockquote>' +
+        (subtitle !== '' ? '<div class="quote-attr">\u2014\u2014 ' + escapeHtml(subtitle) + '</div>' : '')
+      break
+    case 'table': {
+      const rows = Array.isArray(slide.rows) ? slide.rows : []
+      const head = rows[0] ?? []
+      const body = rows.slice(1)
+      inner = '<div class="kicker">' + escapeHtml(kicker || ui.tableKicker) + '</div>' +
+        (title !== '' && title !== kicker ? '<h2>' + escapeHtml(title) + '</h2>' : '') +
+        '<table class="deck-table"><thead><tr>' +
+        head.map((cell) => '<th>' + escapeHtml(cell) + '</th>').join('') +
+        '</tr></thead><tbody>' +
+        body.map((row) => '<tr>' + row.map((cell) => '<td>' + escapeHtml(cell) + '</td>').join('') + '</tr>').join('') +
+        '</tbody></table>'
+      break
+    }
     case 'closing':
       inner = '<h1>' + escapeHtml(title || ui.closingTitle) + '</h1>' +
         (subtitle !== '' ? '<div class="subtitle">' + escapeHtml(subtitle) + '</div>' : '') +
@@ -780,10 +999,13 @@ function renderHtmlSlide(slide, index, ui, langId) {
     default:
       inner = '<div class="kicker">' + escapeHtml(kicker) + '</div>' +
         '<h2>' + escapeHtml(title) + '</h2>' +
-        '<ul>' + bullets.map((bullet) => '<li>' + escapeHtml(bullet) + '</li>').join('') + '</ul>'
+        '<ul>' + bullets.map((bullet, bulletIndex) => '<li style="--i:' + bulletIndex + '">' + escapeHtml(bullet) + '</li>').join('') + '</ul>'
       break
   }
-  return '<section class="slide slide--' + escapeHtml(slide.layout || 'bullets') + '" data-index="' + number + '">' +
+  const notesAttr = typeof slide.notes === 'string' && slide.notes.trim() !== ''
+    ? ' data-notes="' + escapeHtml(slide.notes) + '"'
+    : ''
+  return '<section class="slide slide--' + escapeHtml(slide.layout || 'bullets') + '" data-index="' + number + '"' + notesAttr + '>' +
     '<div class="slide-inner">' + inner + '</div></section>'
 }
 
@@ -862,6 +1084,42 @@ function accentBarXml(id, name, box, color) {
     '<p:txBody><a:bodyPr/><a:lstStyle/><a:p/></p:txBody></p:sp>'
 }
 
+/** 原生 OOXML 表格（graphicFrame + a:tbl）：首行主题色表头，隔行面板色。 */
+function tableGraphicXml(id, name, box, rows, theme) {
+  const p = theme.palette
+  const font = pptxFontName(theme.fonts.body)
+  const safeRows = rows.length > 0 ? rows : [['']]
+  const cols = Math.max(1, safeRows[0].length)
+  const colW = Math.floor(box.w / cols)
+  const grid = Array.from({ length: cols }, () => '<a:gridCol w="' + colW + '"/>').join('')
+  const rowH = 420000
+  const cellXml = (text, fill, color, bold) =>
+    '<a:tc><a:txBody><a:bodyPr anchor="ctr"/><a:lstStyle/><a:p><a:pPr algn="l"><a:buNone/></a:pPr>' +
+    '<a:r><a:rPr lang="zh-CN" sz="1400" b="' + (bold ? 1 : 0) + '" dirty="0">' +
+    '<a:solidFill><a:srgbClr val="' + hex(color) + '"/></a:solidFill>' +
+    '<a:latin typeface="' + escapeXml(font) + '"/><a:ea typeface="' + escapeXml(font) + '"/></a:rPr>' +
+    '<a:t>' + escapeXml(text) + '</a:t></a:r></a:p></a:txBody>' +
+    '<a:tcPr marL="91440" marR="91440" anchor="ctr">' +
+    (fill !== '' ? '<a:solidFill><a:srgbClr val="' + hex(fill) + '"/></a:solidFill>' : '<a:noFill/>') +
+    '</a:tcPr></a:tc>'
+  const trs = safeRows.map((row, rowIndex) => {
+    const padded = Array.from({ length: cols }, (_, i) => row[i] ?? '')
+    const cells = rowIndex === 0
+      ? padded.map((c) => cellXml(c, p.accent, p.bg, true)).join('')
+      : padded.map((c) => cellXml(c, rowIndex % 2 === 1 ? p.panel : '', p.fg, false)).join('')
+    return '<a:tr h="' + rowH + '">' + cells + '</a:tr>'
+  }).join('')
+  const height = Math.max(1, safeRows.length) * rowH
+  return '<p:graphicFrame>' +
+    '<p:nvGraphicFramePr><p:cNvPr id="' + id + '" name="' + escapeXml(name) + '"/>' +
+    '<p:cNvGraphicFramePr><a:graphicFrameLocks noGrp="1"/></p:cNvGraphicFramePr><p:nvPr/></p:nvGraphicFramePr>' +
+    '<p:xfrm><a:off x="' + box.x + '" y="' + box.y + '"/><a:ext cx="' + box.w + '" cy="' + height + '"/></p:xfrm>' +
+    '<a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table">' +
+    '<a:tbl><a:tblPr firstRow="1" bandRow="1"/>' +
+    '<a:tblGrid>' + grid + '</a:tblGrid>' + trs + '</a:tbl>' +
+    '</a:graphicData></a:graphic></p:graphicFrame>'
+}
+
 function slideShapeList(slide, index, total, theme, langId) {
   const p = theme.palette
   const font = pptxFontName(theme.fonts.heading)
@@ -914,6 +1172,31 @@ function slideShapeList(slide, index, total, theme, langId) {
         paragraphXml(subtitle, { size: 1800, color: p.muted, font: theme.fonts.body }),
       ]))
     }
+  } else if (slide.layout === 'quote') {
+    shapes.push(textShapeXml(idBase + 1, 'Quote mark', { x: 900000, y: 1050000, w: 1700000, h: 1900000 }, [
+      paragraphXml('\u201C', { size: 9600, color: p.accent, bold: true, font }),
+    ]))
+    shapes.push(textShapeXml(idBase + 2, 'Quote', { x: 1050000, y: 2550000, w: 10100000, h: 2600000 }, [
+      paragraphXml(title || slide.text || '', { size: 3000, color: p.fg, bold: true, font }),
+    ]))
+    if (subtitle !== '') {
+      shapes.push(textShapeXml(idBase + 3, 'Attribution', { x: 1070000, y: 5300000, w: 9000000, h: 600000 }, [
+        paragraphXml('\u2014\u2014 ' + subtitle, { size: 1600, color: p.muted, font: theme.fonts.body }),
+      ]))
+    }
+  } else if (slide.layout === 'table') {
+    const hasTitle = title !== '' && title !== kicker
+    if (kicker !== '') {
+      shapes.push(textShapeXml(idBase + 1, 'Kicker', { x: 900000, y: 420000, w: 10000000, h: 420000 }, [
+        paragraphXml(kicker, { size: 1400, color: p.accent, bold: true, font: theme.fonts.body }),
+      ]))
+    }
+    if (hasTitle) {
+      shapes.push(textShapeXml(idBase + 2, 'Title', { x: 900000, y: 920000, w: 10300000, h: 800000 }, [
+        paragraphXml(title, { size: 3400, color: p.fg, bold: true, font }),
+      ]))
+    }
+    shapes.push(tableGraphicXml(idBase + 3, 'Table', { x: 900000, y: hasTitle ? 1950000 : 900000, w: 10300000 }, Array.isArray(slide.rows) ? slide.rows : [], theme))
   } else if (slide.layout === 'closing') {
     shapes.push(textShapeXml(idBase + 1, 'Title', { x: 1050000, y: 2300000, w: 10200000, h: 1700000 }, [
       paragraphXml(title || '谢谢', { size: 5200, color: p.fg, bold: true, align: 'ctr', font }),
@@ -946,8 +1229,48 @@ function slideShapeList(slide, index, total, theme, langId) {
   return shapes.join('')
 }
 
-function slideXml(slide, index, total, theme, langId) {
+/**
+ * 原生逐条点击显现动画（PowerPoint「出现，按段落」的标准时序树）：
+ * bldP 把正文文本框标记为按段落构建，主序列里每条要点一个点击节点。
+ */
+function bulletTimingXml(spid, clicks) {
+  let id = 2
+  const nextId = () => { id += 1; return String(id) }
+  const clickPars = []
+  for (let i = 0; i < clicks; i += 1) {
+    clickPars.push(
+      '<p:par><p:cTn id="' + nextId() + '" fill="hold"><p:stCondLst><p:cond delay="indefinite"/></p:stCondLst><p:childTnLst>' +
+      '<p:par><p:cTn id="' + nextId() + '" presetID="1" presetClass="entr" presetSubtype="0" fill="hold" grpId="0" nodeType="clickEffect">' +
+      '<p:stCondLst><p:cond delay="0"/></p:stCondLst><p:childTnLst>' +
+      '<p:set><p:cBhvr><p:cTn id="' + nextId() + '" dur="1" fill="hold"><p:stCondLst><p:cond delay="0"/></p:stCondLst></p:cTn>' +
+      '<p:tgtEl><p:spTgt spid="' + spid + '"/></p:tgtEl>' +
+      '<p:attrNameLst><p:attrName>style.visibility</p:attrName></p:attrNameLst></p:cBhvr>' +
+      '<p:to><p:strVal val="visible"/></p:to></p:set>' +
+      '</p:childTnLst></p:cTn></p:par>' +
+      '</p:childTnLst></p:cTn></p:par>',
+    )
+  }
+  return '<p:timing><p:tnLst><p:par>' +
+    '<p:cTn id="1" dur="indefinite" restart="never" nodeType="tmRoot"><p:childTnLst>' +
+    '<p:seq concurrent="1" nextAc="seek"><p:cTn id="2" dur="indefinite" nodeType="mainSeq"><p:childTnLst>' +
+    clickPars.join('') +
+    '</p:childTnLst></p:cTn>' +
+    '<p:prevCondLst><p:cond evt="onPrev" delay="0"><p:tgtEl><p:sldTgt/></p:tgtEl></p:cond></p:prevCondLst>' +
+    '<p:nextCondLst><p:cond evt="onNext" delay="0"><p:tgtEl><p:sldTgt/></p:tgtEl></p:cond></p:nextCondLst>' +
+    '</p:seq></p:childTnLst></p:cTn></p:par></p:tnLst>' +
+    '<p:bldLst><p:bldP spid="' + spid + '" grpId="0"/></p:bldLst></p:timing>'
+}
+
+function slideXml(slide, index, total, theme, langId, motion) {
   const p = theme.palette
+  let motionXml = ''
+  if (motion) {
+    motionXml = '<p:transition spd="med"><p:fade/></p:transition>'
+    const bullets = Array.isArray(slide.bullets) ? slide.bullets : []
+    if (slide.layout === 'bullets' && bullets.length >= 2) {
+      motionXml += bulletTimingXml((index + 1) * 10 + 3, bullets.length)
+    }
+  }
   return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
     '<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" ' +
     'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" ' +
@@ -958,37 +1281,97 @@ function slideXml(slide, index, total, theme, langId) {
     slideShapeList(slide, index, total, theme, langId) +
     '</p:spTree></p:cSld>' +
     '<p:clrMapOvr><a:overrideClrMapping bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/></p:clrMapOvr>' +
+    motionXml +
     '</p:sld>'
 }
 
-function slideRelXml() {
+function slideRelXml(hasNotes, slideIndex) {
+  const notesRel = hasNotes
+    ? '<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide" Target="../notesSlides/notesSlide' + slideIndex + '.xml"/>'
+    : ''
   return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
     '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' +
     '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>' +
+    notesRel +
     '</Relationships>'
 }
 
-function presentationXml(slideCount) {
+function presentationXml(slideCount, hasNotesMaster) {
   const slideIds = Array.from({ length: slideCount }, (_, i) =>
     '<p:sldId id="' + (256 + i) + '" r:id="rId' + (i + 2) + '"/>').join('')
+  const notesMasterId = hasNotesMaster
+    ? '<p:notesMasterIdLst><p:notesMasterId id="2147483649" r:id="rId' + (slideCount + 2) + '"/></p:notesMasterIdLst>'
+    : ''
   return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
     '<p:presentation xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" ' +
     'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" ' +
     'xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">' +
     '<p:sldMasterIdLst><p:sldMasterId id="2147483648" r:id="rId1"/></p:sldMasterIdLst>' +
     '<p:sldIdLst>' + slideIds + '</p:sldIdLst>' +
+    notesMasterId +
     '<p:sldSz cx="' + EMU_W + '" cy="' + EMU_H + '" type="screen16x9"/>' +
     '<p:notesSz cx="6858000" cy="9144000"/>' +
     '</p:presentation>'
 }
 
-function presentationRelXml(slideCount) {
+function presentationRelXml(slideCount, hasNotesMaster) {
   const slideRels = Array.from({ length: slideCount }, (_, i) =>
     '<Relationship Id="rId' + (i + 2) + '" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide' + (i + 1) + '.xml"/>').join('')
+  const notesMasterRel = hasNotesMaster
+    ? '<Relationship Id="rId' + (slideCount + 2) + '" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" Target="notesMasters/notesMaster1.xml"/>'
+    : ''
   return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
     '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' +
     '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster" Target="slideMasters/slideMaster1.xml"/>' +
     slideRels +
+    notesMasterRel +
+    '</Relationships>'
+}
+
+function notesMasterXml() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
+    '<p:notesMaster xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" ' +
+    'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" ' +
+    'xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">' +
+    '<p:cSld><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>' +
+    '<p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>' +
+    '</p:spTree></p:cSld>' +
+    '<p:clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/>' +
+    '<p:notesStyle><a:lvl1pPr><a:defRPr sz="1200"/></a:lvl1pPr></p:notesStyle>' +
+    '</p:notesMaster>'
+}
+
+function notesMasterRelXml() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' +
+    '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" Target="../theme/theme1.xml"/>' +
+    '</Relationships>'
+}
+
+function notesSlideXml(notes) {
+  const paragraphs = String(notes ?? '').split('\n')
+    .filter((line) => line.trim() !== '')
+    .map((line) => '<a:p><a:r><a:rPr lang="zh-CN" sz="1200" dirty="0"/><a:t>' + escapeXml(line) + '</a:t></a:r></a:p>')
+    .join('')
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
+    '<p:notes xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" ' +
+    'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" ' +
+    'xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">' +
+    '<p:cSld><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>' +
+    '<p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>' +
+    '<p:sp><p:nvSpPr><p:cNvPr id="2" name="Slide Image Placeholder 1"/><p:cNvSpPr/><p:nvPr><p:ph type="sldImg"/></p:nvPr></p:nvSpPr><p:spPr/></p:sp>' +
+    '<p:sp><p:nvSpPr><p:cNvPr id="3" name="Notes Placeholder 2"/><p:cNvSpPr/><p:nvPr><p:ph type="body" idx="1"/></p:nvPr></p:nvSpPr><p:spPr/>' +
+    '<p:txBody><a:bodyPr/><a:lstStyle/>' + paragraphs + '</p:txBody></p:sp>' +
+    '</p:spTree></p:cSld>' +
+    '<p:clrMapOvr><a:overrideClrMapping bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/></p:clrMapOvr>' +
+    '</p:notes>'
+}
+
+function notesSlideRelXml(slideIndex) {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' +
+    '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="../slides/slide' + slideIndex + '.xml"/>' +
+    '<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" Target="../notesMasters/notesMaster1.xml"/>' +
     '</Relationships>'
 }
 
@@ -1070,9 +1453,14 @@ function themeXml(theme) {
     '</a:theme>'
 }
 
-function contentTypesXml(slideCount) {
+function contentTypesXml(slideCount, noteIndexes) {
   const overrides = Array.from({ length: slideCount }, (_, i) =>
     '<Override PartName="/ppt/slides/slide' + (i + 1) + '.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slide+xml"/>').join('')
+  const notesOverrides = noteIndexes.map((index) =>
+    '<Override PartName="/ppt/notesSlides/notesSlide' + (index + 1) + '.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.notesSlide+xml"/>').join('')
+  const notesMasterOverride = noteIndexes.length > 0
+    ? '<Override PartName="/ppt/notesMasters/notesMaster1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.notesMaster+xml"/>'
+    : ''
   return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
     '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">' +
     '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>' +
@@ -1083,7 +1471,9 @@ function contentTypesXml(slideCount) {
     '<Override PartName="/ppt/theme/theme1.xml" ContentType="application/vnd.openxmlformats-officedocument.theme+xml"/>' +
     '<Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/>' +
     '<Override PartName="/docProps/app.xml" ContentType="application/vnd.openxmlformats-officedocument.extended-properties+xml"/>' +
+    notesMasterOverride +
     overrides +
+    notesOverrides +
     '</Types>'
 }
 
@@ -1106,12 +1496,12 @@ function coreXml(title) {
     '</cp:coreProperties>'
 }
 
-function appXml(slideCount) {
+function appXml(slideCount, notesCount) {
   return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
     '<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties" ' +
     'xmlns:vt="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes">' +
     '<Application>dsh-ppt</Application><PresentationFormat>Widescreen</PresentationFormat>' +
-    '<Slides>' + slideCount + '</Slides><Notes>0</Notes><HiddenSlides>0</HiddenSlides>' +
+    '<Slides>' + slideCount + '</Slides><Notes>' + notesCount + '</Notes><HiddenSlides>0</HiddenSlides>' +
     '</Properties>'
 }
 
@@ -1201,23 +1591,38 @@ function crc32(buffer) {
 export function buildPptx(manifest, themeInput, languageInput) {
   const theme = themeInput?.id ? themeInput : resolveTheme(themeInput)
   const language = languageInput?.id ? languageInput : resolveLanguage(languageInput)
+  const motion = manifest.motion !== false
   const slides = manifest.slides
+  const noteIndexes = []
+  slides.forEach((slide, index) => {
+    if (typeof slide.notes === 'string' && slide.notes.trim() !== '') noteIndexes.push(index)
+  })
+  const hasNotesMaster = noteIndexes.length > 0
   const entries = [
-    { name: '[Content_Types].xml', data: contentTypesXml(slides.length) },
+    { name: '[Content_Types].xml', data: contentTypesXml(slides.length, noteIndexes) },
     { name: '_rels/.rels', data: rootRelXml() },
-    { name: 'docProps/app.xml', data: appXml(slides.length) },
+    { name: 'docProps/app.xml', data: appXml(slides.length, noteIndexes.length) },
     { name: 'docProps/core.xml', data: coreXml(manifest.title) },
-    { name: 'ppt/presentation.xml', data: presentationXml(slides.length) },
-    { name: 'ppt/_rels/presentation.xml.rels', data: presentationRelXml(slides.length) },
+    { name: 'ppt/presentation.xml', data: presentationXml(slides.length, hasNotesMaster) },
+    { name: 'ppt/_rels/presentation.xml.rels', data: presentationRelXml(slides.length, hasNotesMaster) },
     { name: 'ppt/slideMasters/slideMaster1.xml', data: slideMasterXml(theme) },
     { name: 'ppt/slideMasters/_rels/slideMaster1.xml.rels', data: slideMasterRelXml() },
     { name: 'ppt/slideLayouts/slideLayout1.xml', data: slideLayoutXml(theme) },
     { name: 'ppt/slideLayouts/_rels/slideLayout1.xml.rels', data: slideLayoutRelXml() },
     { name: 'ppt/theme/theme1.xml', data: themeXml(theme) },
   ]
+  if (hasNotesMaster) {
+    entries.push({ name: 'ppt/notesMasters/notesMaster1.xml', data: notesMasterXml() })
+    entries.push({ name: 'ppt/notesMasters/_rels/notesMaster1.xml.rels', data: notesMasterRelXml() })
+  }
   slides.forEach((slide, index) => {
-    entries.push({ name: 'ppt/slides/slide' + (index + 1) + '.xml', data: slideXml(slide, index, slides.length, theme, language.id) })
-    entries.push({ name: 'ppt/slides/_rels/slide' + (index + 1) + '.xml.rels', data: slideRelXml() })
+    const hasNotes = noteIndexes.includes(index)
+    entries.push({ name: 'ppt/slides/slide' + (index + 1) + '.xml', data: slideXml(slide, index, slides.length, theme, language.id, motion) })
+    entries.push({ name: 'ppt/slides/_rels/slide' + (index + 1) + '.xml.rels', data: slideRelXml(hasNotes, index + 1) })
+    if (hasNotes) {
+      entries.push({ name: 'ppt/notesSlides/notesSlide' + (index + 1) + '.xml', data: notesSlideXml(slide.notes) })
+      entries.push({ name: 'ppt/notesSlides/_rels/notesSlide' + (index + 1) + '.xml.rels', data: notesSlideRelXml(index + 1) })
+    }
   })
   return buildZip(entries)
 }