dsh-ppt 0.8.0 → 0.9.0

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 | image | image-left | image-right | chart`；每页可选 `notes`，表格用 `rows`（首行为表头）。结构化表格自动分页，备注只放第一页。分页后超过 maxSlides 会报错，最多120页。图文、图表、品牌及按页编辑见 `advanced.md`。
-
-## 动效（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 | image | image-left | image-right | chart`；每页可选 `notes`，表格用 `rows`（首行为表头）。结构化表格自动分页，备注只放第一页。分页后超过 maxSlides 会报错，最多120页。图文、图表、品牌及按页编辑见 `advanced.md`。
+
+## 动效（motion）
+
+默认 `motion: on`：HTML 放映有页间淡入与要点逐条入场；PPTX 每页原生淡入转场，`bullets` 页的要点按「点击一次出现一条」放映。交付严肃/打印场景或用户明确要静态时传 `motion: 'off'`（CLI `--motion off`），产物不含任何动画代码。

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

@@ -1,61 +1,61 @@
-# 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；普通演示不要上视频引擎。
+# 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；普通演示不要上视频引擎。