dsh-ppt 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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 演示者视图直接可用。

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.
 
@@ -16,6 +16,7 @@ DeepSeek Harness (DSH) presentation skill + tool plugin: turns a sentence, a par
 | `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 |

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)
 
@@ -18,6 +18,7 @@ DSH（DeepSeek Harness）演示文稿技能 + 工具插件：把一句话、一
 | `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 使用 |

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * dsh-ppt —— 演示文稿技能 + 工具插件（v0.1.0）。
+ * dsh-ppt —— 演示文稿技能 + 工具插件。
  *
  * 一句话或一篇 Markdown 文档 → 完整演示文稿三件套：
  *   deck.html  独立网页放映（无外链）
@@ -160,6 +160,7 @@ export function apply(ctx, config = {}) {
             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.' },
+            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.3.0",
-  "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,101 +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 总览、S 演讲者备注、P 打印/另存 PDF）；PPTX 用 PowerPoint / WPS / Keynote 打开（备注在演示者视图可见）。
-
-## 内容写作规则
-
-- 一句话输入也要「完整」：封面 = 标题 + 那句话；核心观点页 = 原句放大；结束页 = 谢谢/行动号召。若用户要求更丰富，先自行扩写成 6–10 页大纲再构建。
 - 一页一个观点；标题是判断句，不是名词短语。
-- 正文用短句；先结论后理由；数字和对比比形容词更有说服力。
-- 中英双语：`lang` 只决定界面文字（页码/主题标签/结束页），**内容语言由你撰写**。要求双语时，优先每页中文标题 + 英文副标题，或直接生成两份 deck（`--lang zh` 与 `--lang en`）。
-- 更多规则见 `references/copywriting.md`。
-
-## Markdown 进阶语法（自动识别）
-
-- **表格**：`| 列 | 列 |` 连续行（第二行 `| --- | --- |` 分隔线）→ 独立 `table` 页（主题色表头，限 9 行 8 列）。数据对比优先用表格，别堆要点。
-- **金句**：`>` 引用块 → 独立 `quote` 页；最后一行写 `—— 出处` 会成为署名。
-- **演讲者备注**：`<!-- 备注: 这页要讲的内容 -->`（或 `<!-- note: ... -->`）附着到该页。备注不进正文：HTML 放映按 `S` 呼出备注面板，PPTX 写入原生备注（演示者视图可见）。为汇报/演讲类 deck 主动写备注（口径、数据出处、应答预案）。
-
-## 主题选择
-
-内置 5 套主题（源自 hyperframes 视觉风格库）：
-
-| 主题 ID | 名称 | 情绪 | 适用 |
-| --- | --- | --- | --- |
-| `data` | 数据漂移 | 未来/沉浸 | AI、技术发布、研究（默认） |
-| `swiss` | 瑞士脉冲 | 精准/理性 | 数据、SaaS、开发者工具 |
-| `velvet` | 天鹅绒标准 | 高级/克制 | 高管汇报、品牌、融资路演 |
-| `soft` | 柔和信号 | 温暖/人本 | 品牌故事、培训、个人分享 |
-| `bold` | 极繁大字 | 大声/动能 | 产品发布、活动、大事件 |
-
-完整色板与反模式见 `references/themes.md`。
+- 内容语言由你撰写；`lang` 只决定界面文字。
+- 先选主题再构建；不确定就用默认 `data`。
+- 交付前逐项过一遍文末「质量门禁」。
 
-## 视觉引擎复用（hyperframes）
+## 核心流水线
 
-如果 `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": "开场", "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 重写。
+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.2.0'
+export const DECK_VERSION = '0.3.0'
 
 // ---------------------------------------------------------------------------
 // 主题
@@ -206,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) => {
@@ -626,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) {
@@ -646,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 = {
@@ -659,6 +667,7 @@ export function buildDeck(options = {}) {
     title,
     theme: theme.id,
     language: language.id,
+    motion,
     slideCount: deck.slides.length,
     slides: deck.slides,
   }
@@ -696,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
@@ -735,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;
@@ -826,11 +845,12 @@ body.overview #notes-panel{display:none !important}
 @media print{
   html,body{height:auto;overflow:visible;background:#fff}
   .slide{position:relative;display:block !important;height:100vh;page-break-after:always;padding:48px}
+  ${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">
@@ -979,7 +999,7 @@ 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
   }
   const notesAttr = typeof slide.notes === 'string' && slide.notes.trim() !== ''
@@ -1209,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" ' +
@@ -1221,6 +1281,7 @@ 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>'
 }
 
@@ -1530,6 +1591,7 @@ 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) => {
@@ -1555,7 +1617,7 @@ export function buildPptx(manifest, themeInput, languageInput) {
   }
   slides.forEach((slide, index) => {
     const hasNotes = noteIndexes.includes(index)
-    entries.push({ name: 'ppt/slides/slide' + (index + 1) + '.xml', data: slideXml(slide, index, slides.length, theme, language.id) })
+    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) })