dsh-ppt 0.4.4 → 0.5.0

package/skills/dsh-ppt/SKILL.md

@@ -1,69 +1,69 @@
----
-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), 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**。本文件只做路由与纪律；具体规则按需读取 `references/`。
-
-## 触发条件
-
-用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料，或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
-
-## 执行纪律（每次都要遵守）
-
-- 一页一个观点；标题是判断句，不是名词短语。
-- 内容语言由你撰写；`lang` 只决定界面文字。
-- 先选主题再构建；不确定就用默认 `data`。
-- 交付前逐项过一遍文末「质量门禁」。
-
-## 核心流水线
-
-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 条，中文每条 ≤ 20 字、英文 ≤ 12 词。
-- [ ] HTML 与 PPTX 使用同一主题，配色一致。
-- [ ] 主题色对比度足够（深底浅字或浅底深字）。
-- [ ] 中文内容无错别字；英文标题用 Title Case。
-- [ ] 最后一页有可执行的行动号召，不只是「谢谢」。
-- [ ] 文件已写到用户工作区，路径为绝对路径。
-
-## 跨 harness 安装
-
-把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录即可（只依赖 Node 20+）：
-
-| Agent | 技能目录 |
-| --- | --- |
-| DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
-| Claude Code | `~/.claude/skills/` |
-| Cursor | `.cursor/skills/` |
-| Gemini CLI | `~/.gemini/skills/` |
-| OpenAI Codex | `~/.codex/skills/` |
-
-一次编写，处处可用。
+---
+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), 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**。本文件只做路由与纪律；具体规则按需读取 `references/`。
+
+## 触发条件
+
+用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料，或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
+
+## 执行纪律（每次都要遵守）
+
+- 一页一个观点；标题是判断句，不是名词短语。
+- 内容语言由你撰写；`lang` 只决定界面文字。
+- 先选主题再构建；不确定就用默认 `data`。
+- 交付前逐项过一遍文末「质量门禁」。
+
+## 核心流水线
+
+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 条，中文每条 ≤ 20 字、英文 ≤ 12 词。
+- [ ] HTML 与 PPTX 使用同一主题，配色一致。
+- [ ] 主题色对比度足够（深底浅字或浅底深字）。
+- [ ] 中文内容无错别字；英文标题用 Title Case。
+- [ ] 最后一页有可执行的行动号召，不只是「谢谢」。
+- [ ] 文件已写到用户工作区，路径为绝对路径。
+
+## 跨 harness 安装
+
+把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录即可（只依赖 Node 20+）：
+
+| Agent | 技能目录 |
+| --- | --- |
+| DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
+| Claude Code | `~/.claude/skills/` |
+| Cursor | `.cursor/skills/` |
+| Gemini CLI | `~/.gemini/skills/` |
+| OpenAI Codex | `~/.codex/skills/` |
+
+一次编写，处处可用。

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

@@ -1,59 +1,59 @@
-# dsh-ppt 幻灯片写作规则（中英双语）
-
-## 结构模板
-
-任何 deck 都遵循同一叙事骨架：
-
-1. **封面**：标题（判断句或名词短语 + 价值承诺）+ 副标题（一句话定位）。
-2. **背景/问题**：现状 → 痛点 → 为什么现在。
-3. **方案/论点**：每个论点一页，先结论后理由。
-4. **证据/案例**：数字、对比、客户/数据点。
-5. **行动号召**：希望听众下一步做什么。
-6. **结束页**：谢谢 + 联系方式或 CTA 重复。
-
-一句话输入的最小完整结构：封面 → 核心观点页 → 结束页。
-
-## 单页规则
-
-- 一个页面只讲一个观点。
-- 标题是完整的判断句，例如「AI 客服把首响时间压缩到 8 秒」，而不是「关于客服」。
-- bullets 1–8 条，中文每条 ≤ 20 字，英文每条 ≤ 12 词。
-- 优先使用数字、对比、动词；避免「赋能、抓手、闭环」等空词。
-- 最后一页要给出可执行的 CTA，不是只写「谢谢」。
-
-## 双语规则
-
-- 插件 `lang` 参数只控制界面（页码/标签/结束页默认文案）；**内容双语由写作阶段完成**。
-- 双语 deck 推荐两种做法：
-  1. 同一页内：中文标题 + 英文副标题；bullets 中文为主，关键词括号英文。
-  2. 两份 deck：同一大纲分别以 `zh` 与 `en` 生成，主题保持一致。
-- 英文标题用 Title Case；术语首现给中文+英文，如「检索增强生成（RAG）」。
-- 双语时不要逐句直译，按目标语言习惯重写。
-
-## Markdown 与结构化输入
-
-解析规则、表格/金句/备注语法与结构化 `slides` JSON 见 `syntax.md`。
-
-## 示例
-
-输入：
-
-```markdown
-# 让会议少一半
-
-用异步决策替代同步例会。
-
-## 问题
-- 工程师每周 6 小时在例会上
-- 决策没有记录，反复讨论
-
-## 方案
-- 会前异步文档 + 24h 评论期
-- 只有分歧项才开会
-
-## 效果
-- 周会从 4 次降到 1 次
-- 决策记录 100% 沉淀
-```
-
-产出：封面 → 问题 → 方案 → 效果 → 结束页，共 5 页，主题可选 `swiss`（数据/效率）或 `soft`（团队协作）。
+# dsh-ppt 幻灯片写作规则（中英双语）
+
+## 结构模板
+
+任何 deck 都遵循同一叙事骨架：
+
+1. **封面**：标题（判断句或名词短语 + 价值承诺）+ 副标题（一句话定位）。
+2. **背景/问题**：现状 → 痛点 → 为什么现在。
+3. **方案/论点**：每个论点一页，先结论后理由。
+4. **证据/案例**：数字、对比、客户/数据点。
+5. **行动号召**：希望听众下一步做什么。
+6. **结束页**：谢谢 + 联系方式或 CTA 重复。
+
+一句话输入的最小完整结构：封面 → 核心观点页 → 结束页。
+
+## 单页规则
+
+- 一个页面只讲一个观点。
+- 标题是完整的判断句，例如「AI 客服把首响时间压缩到 8 秒」，而不是「关于客服」。
+- bullets 1–8 条，中文每条 ≤ 20 字，英文每条 ≤ 12 词。
+- 优先使用数字、对比、动词；避免「赋能、抓手、闭环」等空词。
+- 最后一页要给出可执行的 CTA，不是只写「谢谢」。
+
+## 双语规则
+
+- 插件 `lang` 参数只控制界面（页码/标签/结束页默认文案）；**内容双语由写作阶段完成**。
+- 双语 deck 推荐两种做法：
+  1. 同一页内：中文标题 + 英文副标题；bullets 中文为主，关键词括号英文。
+  2. 两份 deck：同一大纲分别以 `zh` 与 `en` 生成，主题保持一致。
+- 英文标题用 Title Case；术语首现给中文+英文，如「检索增强生成（RAG）」。
+- 双语时不要逐句直译，按目标语言习惯重写。
+
+## Markdown 与结构化输入
+
+解析规则、表格/金句/备注语法与结构化 `slides` JSON 见 `syntax.md`。
+
+## 示例
+
+输入：
+
+```markdown
+# 让会议少一半
+
+用异步决策替代同步例会。
+
+## 问题
+- 工程师每周 6 小时在例会上
+- 决策没有记录，反复讨论
+
+## 方案
+- 会前异步文档 + 24h 评论期
+- 只有分歧项才开会
+
+## 效果
+- 周会从 4 次降到 1 次
+- 决策记录 100% 沉淀
+```
+
+产出：封面 → 问题 → 方案 → 效果 → 结束页，共 5 页，主题可选 `swiss`（数据/效率）或 `soft`（团队协作）。

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

@@ -1,44 +1,44 @@
-# dsh-ppt 输入语法参考（Markdown / 结构化 slides / 动效）
-
-只在需要查具体语法时读本文件；常规流程在 SKILL.md。
-
-## Markdown 解析规则
-
-`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown：
-
-- 第一个 `# 标题` 会成为封面标题；其后的段落/列表成为封面副标题来源。
-- 每个 `## 小节`（或更深标题）生成一页：
-  - 有 `- ` / `* ` / `1.` 列表 → `bullets` 页；
-  - 无列表且无正文 → `section` 过渡页；
-  - 有正文段落 → 正文拆句后作为 bullets。
-- 没有标题的纯文本：第一段第一句为封面副标题，后续段落按 5 句一组拆成要点页。
-- 只有一句话：自动生成「封面 → 核心观点 → 结束页」三页。
-- 需要更精细控制时使用结构化 `slides` JSON，不要和 Markdown 混用。
-
-## 进阶语法（自动识别）
-
-- **表格**：`| 列 | 列 |` 连续行（第二行 `| --- | --- |` 分隔线）→ 独立 `table` 页（主题色表头；每页 8 行数据，长表格自动续页并重复表头；最多 8 列、每格 60 字符，超限先报错）。数据对比优先用表格，别堆要点。
-- **金句**：`>` 引用块 → 独立 `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`（首行为表头）。结构化表格同样自动分页，备注只放第一页。分页后总页数超过 maxSlides 时会报错，请提高配置上限（最多 120）或拆分文稿。Markdown 输入不够精确时，用结构化 slides 重写。
-
-## 动效（motion）
-
-默认 `motion: on`：HTML 放映有页间淡入与要点逐条入场；PPTX 每页原生淡入转场，`bullets` 页的要点按「点击一次出现一条」放映。交付严肃/打印场景或用户明确要静态时传 `motion: 'off'`（CLI `--motion off`），产物不含任何动画代码。
+# dsh-ppt 输入语法参考（Markdown / 结构化 slides / 动效）
+
+只在需要查具体语法时读本文件；常规流程在 SKILL.md。
+
+## Markdown 解析规则
+
+`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown：
+
+- 第一个 `# 标题` 会成为封面标题；其后的段落/列表成为封面副标题来源。
+- 每个 `## 小节`（或更深标题）生成一页：
+  - 有 `- ` / `* ` / `1.` 列表 → `bullets` 页；
+  - 无列表且无正文 → `section` 过渡页；
+  - 有正文段落 → 正文拆句后作为 bullets。
+- 没有标题的纯文本：第一段第一句为封面副标题，后续段落按 5 句一组拆成要点页。
+- 只有一句话：自动生成「封面 → 核心观点 → 结束页」三页。
+- 需要更精细控制时使用结构化 `slides` JSON，不要和 Markdown 混用。
+
+## 进阶语法（自动识别）
+
+- **表格**：`| 列 | 列 |` 连续行（第二行 `| --- | --- |` 分隔线）→ 独立 `table` 页（主题色表头；每页 8 行数据，长表格自动续页并重复表头；最多 8 列、每格 60 字符，超限先报错）。数据对比优先用表格，别堆要点。
+- **金句**：`>` 引用块 → 独立 `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`（首行为表头）。结构化表格同样自动分页，备注只放第一页。分页后总页数超过 maxSlides 时会报错，请提高配置上限（最多 120）或拆分文稿。Markdown 输入不够精确时，用结构化 slides 重写。
+
+## 动效（motion）
+
+默认 `motion: on`：HTML 放映有页间淡入与要点逐条入场；PPTX 每页原生淡入转场，`bullets` 页的要点按「点击一次出现一条」放映。交付严肃/打印场景或用户明确要静态时传 `motion: 'off'`（CLI `--motion off`），产物不含任何动画代码。

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

@@ -1,59 +1,61 @@
-# dsh-ppt 内置主题参考
-
-主题系统移植自 hyperframes 技能的 `visual-styles.md` 视觉风格库。每套主题在 HTML 与 PPTX 中使用同一色板、同一字体族、同一情绪规则。
-
-## 速查
-
-| ID | 中文名 | English | 明暗 | 底色 | 前景 | 主强调 | 次强调 | 情绪 | 适用 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `data` | 数据漂移 | Data Drift | 暗 | `#070B14` | `#E8F1FF` | `#7C3AED` | `#06B6D4` | 未来/沉浸 | AI、数据、研究、技术发布 |
-| `swiss` | 瑞士脉冲 | Swiss Pulse | 暗 | `#10151B` | `#F5F7FA` | `#2F6BFF` | `#FFB300` | 精准/理性 | SaaS、数据、开发者工具 |
-| `velvet` | 天鹅绒标准 | Velvet Standard | 暗 | `#111316` | `#F4EFE6` | `#C9A84C` | `#3D4A63` | 高级/克制 | 高管汇报、品牌、融资路演 |
-| `soft` | 柔和信号 | Soft Signal | 亮 | `#FFF8EC` | `#3B2F2A` | `#E58A2F` | `#8FAF8C` | 温暖/人本 | 品牌故事、培训、个人分享 |
-| `bold` | 极繁大字 | Maximalist Type | 暗 | `#0D0D0D` | `#FFFFFF` | `#E63946` | `#FFD60A` | 大声/动能 | 产品发布、活动、大事件 |
-
-## 逐主题说明
-
-### data — 数据漂移（默认）
-
-- 深黑底 + 电光紫 + 青色，细体未来感。
-- 适合 AI / ML / 数据 / 前沿技术；大标题少字，用对比数字。
-- 反模式：不要加多余暖色；不要堆长段落。
-
-### swiss — 瑞士脉冲
-
-- 黑白灰 + 一个电蓝（或琥珀），栅格感、大数字。
-- 适合 SaaS / 指标 / 开发者工具；标题短、要点像 spec。
-- 反模式：不要装饰性渐变文字；不要圆角卡片堆叠。
-
-### velvet — 天鹅绒标准
-
-- 黑、米白、香槟金，衬线标题 + 无衬线正文，宽字距，留白多。
-- 适合高管汇报 / 品牌 / 融资；节奏慢，页数少而精。
-- 反模式：不要动画感强烈的颜色；不要超过一个强调色。
-
-### soft — 柔和信号
-
-- 暖奶油底、深棕字、琥珀 + 鼠尾草绿，亮色唯一浅底主题。
-- 适合品牌故事 / 培训 / 个人分享；文字可以更口语。
-- 反模式：不要用纯黑正文；不要高饱和撞色。
-
-### bold — 极繁大字
-
-- 黑底、正红 + 明黄，超粗标题，字就是视觉主体。
-- 适合产品发布 / 活动 / 大事件；短标题、单页单一冲击。
-- 反模式：不要把页面塞满要点；不要让红黄之外再出现第三种强调色。
-
-## 选主题决策树
-
-1. 情绪是未来/科技 → `data`
-2. 情绪是理性/数据/精准 → `swiss`
-3. 情绪是高级/信任/正式 → `velvet`
-4. 情绪是温暖/人本/故事 → `soft`
-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；普通演示不要上视频引擎。
+# dsh-ppt 内置主题参考
+
+主题系统移植自 hyperframes 技能的 `visual-styles.md` 视觉风格库。每套主题在 HTML 与 PPTX 中使用同一色板、同一字体族、同一情绪规则。
+
+> 想先看效果：运行 `ppt_themes { preview: true, outputDir: "dist" }`，会生成 `themes-preview.html` 与每套主题一张 `theme-<id>.svg`；README/npm 首屏可以直接引用 SVG。
+
+## 速查
+
+| ID | 中文名 | English | 明暗 | 底色 | 前景 | 主强调 | 次强调 | 情绪 | 适用 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| `data` | 数据漂移 | Data Drift | 暗 | `#070B14` | `#E8F1FF` | `#7C3AED` | `#06B6D4` | 未来/沉浸 | AI、数据、研究、技术发布 |
+| `swiss` | 瑞士脉冲 | Swiss Pulse | 暗 | `#10151B` | `#F5F7FA` | `#2F6BFF` | `#FFB300` | 精准/理性 | SaaS、数据、开发者工具 |
+| `velvet` | 天鹅绒标准 | Velvet Standard | 暗 | `#111316` | `#F4EFE6` | `#C9A84C` | `#3D4A63` | 高级/克制 | 高管汇报、品牌、融资路演 |
+| `soft` | 柔和信号 | Soft Signal | 亮 | `#FFF8EC` | `#3B2F2A` | `#E58A2F` | `#8FAF8C` | 温暖/人本 | 品牌故事、培训、个人分享 |
+| `bold` | 极繁大字 | Maximalist Type | 暗 | `#0D0D0D` | `#FFFFFF` | `#E63946` | `#FFD60A` | 大声/动能 | 产品发布、活动、大事件 |
+
+## 逐主题说明
+
+### data — 数据漂移（默认）
+
+- 深黑底 + 电光紫 + 青色，细体未来感。
+- 适合 AI / ML / 数据 / 前沿技术；大标题少字，用对比数字。
+- 反模式：不要加多余暖色；不要堆长段落。
+
+### swiss — 瑞士脉冲
+
+- 黑白灰 + 一个电蓝（或琥珀），栅格感、大数字。
+- 适合 SaaS / 指标 / 开发者工具；标题短、要点像 spec。
+- 反模式：不要装饰性渐变文字；不要圆角卡片堆叠。
+
+### velvet — 天鹅绒标准
+
+- 黑、米白、香槟金，衬线标题 + 无衬线正文，宽字距，留白多。
+- 适合高管汇报 / 品牌 / 融资；节奏慢，页数少而精。
+- 反模式：不要动画感强烈的颜色；不要超过一个强调色。
+
+### soft — 柔和信号
+
+- 暖奶油底、深棕字、琥珀 + 鼠尾草绿，亮色唯一浅底主题。
+- 适合品牌故事 / 培训 / 个人分享；文字可以更口语。
+- 反模式：不要用纯黑正文；不要高饱和撞色。
+
+### bold — 极繁大字
+
+- 黑底、正红 + 明黄，超粗标题，字就是视觉主体。
+- 适合产品发布 / 活动 / 大事件；短标题、单页单一冲击。
+- 反模式：不要把页面塞满要点；不要让红黄之外再出现第三种强调色。
+
+## 选主题决策树
+
+1. 情绪是未来/科技 → `data`
+2. 情绪是理性/数据/精准 → `swiss`
+3. 情绪是高级/信任/正式 → `velvet`
+4. 情绪是温暖/人本/故事 → `soft`
+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

@@ -1,13 +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 打印要点缺失 | 打印样式已强制显示全部要点；若仍缺失检查浏览器是否屏蔽了动画样式 |
+# 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 打印要点缺失 | 打印样式已强制显示全部要点；若仍缺失检查浏览器是否屏蔽了动画样式 |