dsh-ppt 0.21.0 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.en.md +18 -17
  3. package/README.md +16 -15
  4. package/docs/COACHING.md +14 -13
  5. package/docs/DATA.md +8 -8
  6. package/docs/REFERENCE.en.md +17 -19
  7. package/docs/REFERENCE.zh.md +16 -18
  8. package/docs/USAGE.en.md +107 -60
  9. package/docs/USAGE.md +115 -84
  10. package/docs/VALIDATION.md +2 -0
  11. package/docs/VISUAL.md +27 -20
  12. package/docs/WORKBENCH.md +17 -6
  13. package/docs/assets/intro/screen-en.webp +0 -0
  14. package/docs/assets/intro/screen-zh.webp +0 -0
  15. package/lib/client.js +941 -132
  16. package/lib/coaching.d.ts +1 -1
  17. package/lib/coaching.js +25 -12
  18. package/lib/config.d.ts +2 -0
  19. package/lib/config.js +30 -2
  20. package/lib/execution.d.ts +2 -1
  21. package/lib/execution.js +21 -1
  22. package/lib/tools.d.ts +1 -1
  23. package/lib/tools.js +151 -24
  24. package/lib/types.d.ts +108 -8
  25. package/lib/visual.d.ts +3 -1
  26. package/lib/visual.js +40 -13
  27. package/lib/workbench-language.js +45 -9
  28. package/lib/workbench.d.ts +5 -0
  29. package/lib/workbench.js +485 -9
  30. package/package.json +9 -4
  31. package/skills/dsh-ppt/SKILL.md +56 -54
  32. package/skills/dsh-ppt/package.json +1 -1
  33. package/skills/dsh-ppt/references/advanced.md +122 -41
  34. package/skills/dsh-ppt/references/copywriting.md +63 -41
  35. package/skills/dsh-ppt/references/data.md +83 -36
  36. package/skills/dsh-ppt/references/syntax.md +157 -28
  37. package/skills/dsh-ppt/references/themes.md +90 -41
  38. package/skills/dsh-ppt/references/troubleshooting.md +21 -16
  39. package/skills/dsh-ppt/scripts/build-deck.mjs +67 -28
  40. package/skills/dsh-ppt/scripts/deck-absorb.mjs +1029 -0
  41. package/skills/dsh-ppt/scripts/deck-advanced.mjs +406 -99
  42. package/skills/dsh-ppt/scripts/deck-core.mjs +568 -717
  43. package/skills/dsh-ppt/scripts/deck-data-view.mjs +30 -11
  44. package/skills/dsh-ppt/scripts/deck-data.mjs +35 -5
  45. package/skills/dsh-ppt/scripts/deck-director.mjs +1717 -0
  46. package/skills/dsh-ppt/scripts/deck-layouts.mjs +4557 -0
  47. package/skills/dsh-ppt/scripts/deck-media.mjs +1408 -86
  48. package/skills/dsh-ppt/scripts/deck-themes.mjs +1503 -0
  49. package/skills/dsh-ppt/scripts/deck-visual.mjs +133 -31
@@ -1,81 +1,83 @@
1
1
  ---
2
2
  name: dsh-ppt
3
- 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 套视觉主题、页间转场与要点入场动画,中英双语。"
4
- compatibility: "Node ^22.19.0 or >=24.0.0. Images/charts use @office-kit/pptx@0.21.0; optional data models use jsep@1.4.0 and csv-parse@6.1.0. Optional PNG/PDF renderer: @deepseek-ai/libreoffice-kit@0.2.3 (bundled by DSH 0.2.2+; 0.1.5 also supported). Cross-harness: copy the full directory and run npm install --ignore-scripts there."
3
+ description: "Turn one sentence, a Markdown document, structured slides, or a reference .pptx into a world-class presentation deck: standalone HTML web slideshow + 100% native-editable PPTX + project manifest. Features Zero-Question Scenario Auto-Direction (theme: auto), 18 curated themes (12 daylight projector-safe + 6 dark elevation), 6 distinct Master Chrome Skeletons, 24 native-editable layouts & pro diagrams (Gantt, Architecture, Harvey Matrix, TAM Concentric, Org Tree, Bento, KPI, 2x2 Matrix, Timeline/Process/Flywheel, Booktabs 3-line tables, Chart-Split), 16 industry blueprints, 13 Economist/FT-grade charts (including vector Waterfall), deep external .pptx skeleton absorption (ppt_absorb / referencePptx / cloneStructure), data provenance, and bilingual ZH/EN support. 中文:把一句话、文档、数据或参考 PPTX 变成大师级演示文稿(独立 HTML 放映 + 100% 原生可编辑 PPTX),内置零追问智能审美导演、18 套明暗主题、6 套母版骨架、24 种原生版式与专业图示、16 套行业蓝图、13 类出版级图表与外部 PPTX 骨架吸收。"
4
+ compatibility: "Node ^22.19.0 or >=24.0.0. Images/charts/PPTX absorption use @office-kit/pptx@0.21.0; optional data models use jsep@1.4.0 and csv-parse@6.1.0. Optional PNG/PDF renderer: @deepseek-ai/libreoffice-kit@0.2.3 (bundled by DSH 0.2.2+; 0.1.5 also supported). Cross-harness: copy the full directory and run npm install --ignore-scripts there."
5
5
  allowed-tools: "Bash, Read, Write, Edit"
6
6
  ---
7
7
 
8
8
  # dsh-ppt
9
9
 
10
- 一句话或一篇文档 → 完整演示文稿:**独立 HTML 网页放映 + 可编辑 PPTX**。本文件只做路由与纪律;具体规则按需读取 `references/`。
10
+ 一句话、一篇文档、一组数据或一份参考 `.pptx` → **大师级可交付演示文稿(独立 HTML 网页放映 + 100% 原生可编辑 PPTX + 工程 JSON)**。本文件负责审美总纲、路由与交付纪律;具体语法与色板按需读取 `references/`。
11
11
 
12
12
  ## 触发条件
13
13
 
14
- 用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料,或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
14
+ 用户要做 PPT / 幻灯片 / 演示文稿 / deck / keynote / 汇报 / 述职 / 提案 / 路演 / 答辩 / 课件 / 培训材料,或希望吸收某份参考 `.pptx` 的母版配色与风格来制作新文稿。
15
15
 
16
- ## 执行纪律(每次都要遵守)
16
+ ## 核心审美哲学:品味内建(零品味负担)
17
+
18
+ 普通用户无法分辨底层版式栅格、对比度或图表噪音——**你就是首席艺术总监,默认输出必须直接达到麦肯锡咨询 / Apple 发布会 / Nature 学术答辩 / 现代故宫霁蓝政务水准**:
17
19
 
18
- - 默认直接交付成品,不自动触发 AI 预审或答辩。用户可在设置页成品下载区主动开启两个可选模式;选择模型、范围与调用上限后再发送材料。AI 演练不等于事实核验,不编造实验、数据或引用;采纳建议另存副本,原件保留。
19
- - 用户需要 AI 看图检查时,可在 DSH 设置 → 演示文稿 → 视觉检查与修复主动开启。它需要支持图片输入的模型与官方渲染引擎,修复只调整排版、另存副本并复查。AI 未发现问题不等于人工验收;模型调用失败、输出截断、停止和未检查页面必须如实说明,不能声称视觉通过。
20
- - 数字溯源和现场推演也按需启用。提供 `dataModel` 与结构化 `slides` 的 `{{metricId}}` 绑定;先读 `references/data.md`。源事实必须对应真实材料行或单元格;用户假设用 `kind:input` 标注,禁止虚构来源。修改数据先 `ppt_data(action:preview)`,展示指标与页面差异,得到确认后携带原预览凭证和修订号保存;默认新副本。离线 HTML 参数必须回存确认后才能交付对应静态 PPTX。
20
+ 1. **零追问场景定调(Zero-Question Auto-Director)**:用户说“帮我做个汇报 PPT”时,**不要反问一堆设计参数**。直接根据内容语义识别六大画像(商业咨询、政务述职、学术答辩、科技路演、教育讲义、人文品牌),传 `theme: 'auto'` 或显式匹配 18 套大师主题(含 `keynote-light`、`financial-ft`、`medical-clean`、`luxury-noir`)。**明亮投影优先**:会议室汇报、政企述职、学术答辩、教学课件一律优先选用 12 套浅底主题(通用默认 `consulting` 蔚蓝战略),绝不在常规办公场景盲目套用纯黑赛博风 `data`!并按场景自动匹配 **6 套差异化母版骨架(`chromeStyle`:`consulting-classic` / `keynote-spatial` / `editorial-folio` / `saas-bento` / `academic-minimal` / `gov-ceremonial`)**,彻底告别「一套模板换 14 种颜色」。
21
+ 2. **结论先行(Action Titles)**:除封面、目录与章节页外,每页标题必须是**完整的结论判断句**(如「异步评审将工程师周均例会耗时压缩 75%」),严禁使用「项目背景」「数据分析」「周末到馆人次」等空洞名词标签。
22
+ 3. **版式节奏与反要点墙(Anti-Bullet-Wall)**:优先传**结构化 `slides`**(或使用 `::: kpi / cards / comparison / process / matrix / callout / gantt / architecture / harvey / tam / org` 指令)充分利用 **24 套原生版式与专业图示**。**整套文稿严禁连续超过 2 页使用普通 `bullets` 要点列表**;8 页以上文稿须有节奏地交替视觉密度(指标用 `kpi`、排期用 `gantt`、系统分层用 `architecture`、竞品能力用 `harvey`、市场空间用 `tam`、组织团队用 `org`、并列支柱用 `cards[pillars/bento]`、痛点整改用 `comparison[issue-action]`、演进/闭环用 `process[timeline/steps/flywheel]`、四象限用 `matrix`、数据配洞察用 `chart-split`、学术对比用 `table[booktabs]` 三线表)。
23
+ 4. **出版级图表与三线表**:单系列图表自动隐藏冗余图例,使用 `highlight: 'max' | 'last'` 突出焦点色柱、其余灰阶退后,直接显示数据标签,左下角附 `source` 数据来源;学术与严谨数据对比使用无竖线的 `booktabs` 三线表。
24
+ 5. **双轨深层吸收优质 PPT**:无外部模板时调用内置 **18 套大师主题**、**6 套母版骨架**与 **16 套行业结构蓝图**;用户提供参考 `.pptx` 时先调 `ppt_absorb` 或直接传 `referencePptx` 自动提取并净化母版色板、字体、Logo、骨架特征(`extractedSkeleton`)、推荐骨架(`recommendedChrome`)与逐页分布(`slideSkeleton`),传 `cloneStructure: true` 可将 Markdown 大纲直接映射到吸收出的逐页版式序列与母版骨架!
21
25
 
22
- - 修改工程先 `ppt_check`。外部编辑过的 HTML/PPTX、缺少成品校验记录的旧工程不可覆盖;告知用户 `saveAs:true` 只从 JSON 另存新副本,原件保留,Office 手工修改不会导入。不得绕过校验或自行篡改校验值。
26
+ ## 执行纪律(每次都要遵守)
23
27
 
24
- - 一页一个观点;标题是判断句,不是名词短语。
25
- - 内容语言由你撰写;`lang` 只决定界面文字。
26
- - 先选主题再构建;不确定就用默认 `data`。
27
- - 交付前逐项过一遍文末「质量门禁」。
28
- - 目标是可用成品:先组织真实内容,再调用生成器;未填模板必须标注草稿,不编造缺失事实。
29
- - 渲染报告缺失字体时,替换为环境和接收方机器可用字体,重新生成并逐页检查;未解决需标注字体问题,不能声称已验收。
28
+ - **默认零额外模型开销直接交付**:不自动触发 AI 预审、模拟答辩或视觉看图修复。用户可在 DSH 设置页主动开启可选 AI 预审/答辩或「视觉检查与修复」(支持最高 24 页全量审查与 12 种无损版式/字号修复);AI 演练不等于事实核验,不编造实验、数据或引用;采纳建议默认另存副本,原件保留。模型失败、截断、停止或未检查页面必须如实说明,不能声称视觉通过。
29
+ - **数字溯源与推演纪律**:需要解释数字来源或现场滑块推演时,提供 `dataModel` 并在 `slides`(含 `items`、`takeaway`、`source`、`chart`)绑定 `{{metricId}}`;先读 `references/data.md`。`source` 必须对应真实材料行或单元格,假设用 `kind: 'input'` 标注,禁止虚构来源。修改数据先 `ppt_data(action: 'preview')`,展示差异并获确认后带凭证 `apply`(默认 `saveAs: true`)。
30
+ - **工程安全与版本锁**:修改已有工程先 `ppt_check` 获取当前 `revision` 与页面 ID。外部手工改过的 HTML/PPTX 或缺少校验记录的旧工程不可覆盖;告知用户 `saveAs: true` 仅从 JSON 另存新副本,Office 手工修改不会回导。严禁绕过校验或篡改摘要。仅吸收外部 `.pptx` 的视觉风格(`ppt_absorb` / `referencePptx`),不直接就地编辑任意外部 `.pptx` 正文。
31
+ - **字体与跨平台零缺字**:正文最小字号硬底线 `13.5pt`,超长内容必须拆页而非强行缩字。若 `ppt_render` 报告 `missingFonts` 非空,必须替换为环境与接收方可用字体(Windows `Microsoft YaHei`、macOS `PingFang SC`/`Songti SC`、Linux `Noto Sans/Serif CJK SC`),重新生成并逐页复核;未解决前不得声称已验收。CLI 与工具报错信息统一为中文。
32
+ - **语言分工**:`lang`(`zh | en | bilingual`)仅控制播放器界面与默认标签;正文与双语表达由你在写作阶段完成。
30
33
 
31
34
  ## 核心流水线
32
35
 
33
- 1. **Probe 需求**:读入用户的句子/文档,确定听众、目标、语气。一句话输入不要反问,直接按发布场景推断。
34
- 2. **Outline 大纲**:产出 5–12 页大纲(封面 → 问题/背景 → 方案/论点 3–6 页 → 证据 → 行动号召 → 结束页)。
35
- → 写大纲与正文前先读 `references/copywriting.md`。
36
- 3. **Theme 主题**:调 `ppt_themes`(DSH)或 `node scripts/build-deck.mjs --list-themes`(跨 harness)。
37
- → 拿不准选哪套时读 `references/themes.md` 的情绪决策树。
38
- 4. **Build 生成**:
39
- - DSH 内:调 `ppt_create`,大纲写成 Markdown 传 `content`(推荐),或传结构化 `slides`。
40
- - 跨 harness:`node <skill-dir>/scripts/build-deck.mjs --title "标题" --content deck.md --theme data --lang zh --out dist`。
41
- - 动效默认开(页间转场 + 要点逐条入场);严肃/打印场景传 `motion: 'off'`。
42
- → 用表格 / 金句 / 备注 / 结构化 slides 前读 `references/syntax.md`。
43
- 5. **Verify 校验与修正**:调 `ppt_check` 检查具体页;在浏览器操作放映、总览和备注,查看图片/图表。若可选官方引擎可用,调 `ppt_render` 读取最终 PPTX 生成逐页 PNG/PDF,逐页看画面。修正用 `ppt_edit`,以 `expectedRevision` 防冲突;需要时 `ppt_undo`。修改后重新渲染,以收据复核当前文件。文件头/结构通过不等同于视觉验收,静态估算、渲染、视觉检查必须分开说明。
44
- 6. **Deliver 交付**:给用户三个绝对路径,说明 HTML 直接放映(← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印),PPTX 用 PowerPoint / WPS / Keynote 打开(备注在演示者视图可见,bullets 页放映时逐条点击出现)。DSH 用户也可在「设置 → 演示文稿」修改文字、替换 PNG/JPEG、移动/复制/删除页面、撤销和下载最新文件;已有 JSON 工程先 `ppt_check` 才会出现在项目列表。`ppt_edit.order` 使用每个稳定页面 ID 各一次;`duplicate`、`remove` 使用修改前的页码或稳定 ID,复制保留图片/图表/备注,最终保留 1–120 页。结构与正文修改可合为一次撤销。
36
+ 1. **Probe & Auto-Direct 定调**:读入用户句子/文档/数据,静默判定听众与六大画像(见 `references/themes.md`)。若用户给了参考 `.pptx`,调 `ppt_absorb` 查看提取结果或在创建时传 `referencePptx`。一句话输入不反问,直接推断并生成完整成品。
37
+ 2. **Storyline & Choreography 叙事与排布**:先读 `references/copywriting.md`。按金字塔原理 / SCQA 组织 5–16 页大纲,为每页撰写结论先行 Action Title、章节面包屑 `kicker`(如 `01 · 市场诊断`,禁止满屏重复「要点」)、底栏核心结论 `takeaway` 与数据出处 `source`,并规划多版式交替节奏。可调 `ppt_templates` 参考 **16 套行业结构蓝图**(`weekly | defense | project | pitch | consulting | keynote | gov-report | workshop | architecture-review | financial-earnings | medical-case | postmortem | marketing-campaign | promotion-review | legal-compliance | creative-lookbook`)。
38
+ 3. **Theme 选主题与骨架**:不确定时在 `ppt_create` 传 `theme: 'auto'`(自动路由至明亮高质感场景主题与匹配骨架),或从 **18 套内置主题**中精确指定(调 `ppt_themes` 查看),并可通过 `brand.chromeStyle` 或单页 `chrome` 覆盖 6 套母版骨架。
39
+ - **重要 CLI 差异**:跨 harness 直接运行 `build-deck.mjs` 时,裸 CLI 缺省 `--theme` 为兼容旧脚本仍回退 `data`,因此 **CLI 调用请务必显式传 `--theme auto` 或具体场景主题 ID(如 `--theme consulting` / `--theme exec-jilan`)**!
40
+ 4. **Build 生成**:先读 `references/syntax.md`(用到图表/多图/外源母版/编辑时读 `references/advanced.md`)。
41
+ - **推荐方式(DSH 内)**:调 `ppt_create`,优先传结构化 `slides`(精确控制 **24 种原生版式**含 `gantt / architecture / harvey / tam / org / kpi / cards / comparison / matrix / process / chart-split / table[booktabs] / callout`),或传带 `:::` 指令与 `**加粗引导词**:说明` 的 Markdown `content`。
42
+ - **跨 harness CLI**:`node <skill-dir>/scripts/build-deck.mjs --title "标题" --slides @slides.json --theme auto --lang zh --out dist`(吸收参考模板并克隆结构可加 `--reference-pptx ref.pptx --clone-structure`;显式骨架用 `--chrome academic-minimal`;仅提取风格用 `--absorb ref.pptx`)。
43
+ - 动效默认 `motion: 'on'`(HTML 页间淡入 + PPTX 要点点击逐条出现);严肃政企公文、学术打印或归档传 `motion: 'off'`。
44
+ 5. **Verify 校验与看图修正**:调 `ppt_check` 检查结构、字数密度、WCAG 对比度与 `SLOP-01..10` 审美告警。若安装了 `@deepseek-ai/libreoffice-kit`,调 `ppt_render` 生成逐页 PNG/PDF 并附 `renderReceipt` 复检,逐张用看图工具核查画面(0 缺字、0 溢出、0 遮挡、0 冗余图例)。微调文字、切换主题或版式用 `ppt_edit`(带 `expectedRevision`),需要时 `ppt_undo`。静态估算、渲染成功与视觉验收必须分开如实陈述。
45
+ 6. **Deliver 交付**:向用户提供 `.html`、`.pptx`、`.json` 三个绝对路径,说明 HTML 快捷键(`← →` 翻页 · `F` 全屏 · `G` 总览 · `S` 演讲者备注 · `P` 打印)及 PPTX 100% 原生可编辑特性(形状、卡片、三线表、图表工作簿、瀑布桥与备注均可在 PowerPoint / WPS / Keynote 直接编辑);提示 DSH 工作台支持「风格与母版(Style Studio)」一键换肤、拖拽吸收 `.pptx` 与单页版式切换。
45
46
 
46
47
  ## 按需装载索引
47
48
 
48
- | 何时读 | 文件 | 内容 |
49
+ | 何时必读 | 参考文件 | 核心内容 |
49
50
  | --- | --- | --- |
50
- | 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
51
- | 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
52
- | 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
53
- | 图片/图表/模板/品牌/编辑/渲染 | `references/advanced.md` | 参数、限制、草稿与成品、收据语义 |
54
- | 数字溯源与现场推演 | `references/data.md` | 来源绑定、公式、更新预览与离线参数回存 |
55
- | 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
56
-
57
- ## 质量门禁(交付前逐项确认)
58
-
59
- - [ ] 页数 3–60,首屏是封面,末屏是结束页。
60
- - [ ] 每页有明确标题;bullets 页 1–8 条,中文每条 ≤ 20 字、英文 ≤ 12 词。
61
- - [ ] HTML 与 PPTX 使用同一主题,配色一致。
62
- - [ ] 主题色对比度足够(深底浅字或浅底深字)。
63
- - [ ] 中文内容无错别字;英文标题用 Title Case。
64
- - [ ] 最后一页有可执行的行动号召,不只是「谢谢」。
65
- - [ ] 文件已写到用户工作区,路径为绝对路径。
66
- - [ ] 没有未填模板;保留真实数据来源,检查每页画面而非只检查生成成功。
67
- - [ ] 图片嵌入成功,图表与原始数据一致;渲染收据匹配最终 PPTX,说明尚未验证的部分。
51
+ | 写大纲、标题与正文前 | `references/copywriting.md` | 六大画像叙事骨架、Action Title 写法、字数预算、反空话与双语规范 |
52
+ | 选主题、配色、骨架或吸收母版 | `references/themes.md` | 18 套大师主题色板(12 浅 6 深)、6 套母版骨架(Chrome)、18 语义 Token、六大画像选型树 |
53
+ | 写结构化 `slides` 或扩展 Markdown | `references/syntax.md` | 24 套原生版式与专业图示 + `variant`、统一 `items` 结构、`:::` 容器指令、三线表与 `takeaway` |
54
+ | 图表、图片、吸收 `.pptx`、编辑与渲染 | `references/advanced.md` | 13 类出版级图表、瀑布图、`ppt_absorb`/`referencePptx`/`cloneStructure`、16 套蓝图、Vision QA 与 CLI |
55
+ | 数字溯源、公式与现场推演 | `references/data.md` | `dataModel` 源绑定、公式约束、全字段 `{{metricId}}` 联动与预览确认流 |
56
+ | 遇到报错或渲染异常 | `references/troubleshooting.md` | 症状 → 根因与处理速查表 |
57
+
58
+ ## 质量与反土味门禁(SLOP-01..10,交付前逐项核对)
59
+
60
+ - [ ] **SLOP-01 结论标题**:内容页与图表页标题均为完整判断句(Action Title),无「项目背景 / 数据图表 / 总结」等纯名词短标题。
61
+ - [ ] **SLOP-02 章节面包屑**:`kicker` 体现章节脉络(如 `01 · 增长引擎`),未连续多页硬编码重复「要点 / Point」。
62
+ - [ ] **SLOP-03 拒绝要点墙**:单页普通 bullets ≤ 5 条;无连续 > 2 页 `bullets` 版式,并列信息已升格为 `kpi / cards / comparison / process / matrix`。
63
+ - [ ] **SLOP-04 字号与字数底线**:正文绝不低于 `13.5pt`;单条要点中文 ≤ 24 字(英文 ≤ 14 词),卡片正文中文 ≤ 40 字,引导词使用 `**关键词**:说明` 形成层级。
64
+ - [ ] **SLOP-05 图文对齐与呼吸感**:配图采用圆角细框对齐或 `split-bleed` 半屏出血,正文列垂直居中,无「左上角两行字 + 大片死白」。
65
+ - [ ] **SLOP-06 出版级图表与三线表**:单系列图表无冗余图例,网格线 ≤ 5 条细灰线,关键柱已用 `highlight` 聚焦并带直接数值标签;学术表格采用 `booktabs` 无竖线三线表;数据页左下角有真实 `source` 说明(未虚构出处)。
66
+ - [ ] **SLOP-07 投影安全与对比度**:会议/政务/学术/培训优先浅底主题;政务风杜绝刺眼纯红底配黄字;正文与背景对比度 ≥ 4.5:1,HTML 与 PPTX 主题完全一致。
67
+ - [ ] **SLOP-08 版式多样性**:≥ 6 页的文稿至少组合 4 种不同版式原型,封面与封底不误印页码。
68
+ - [ ] **SLOP-09 可执行收尾**:`closing` 页包含明确的下一步行动号召(CTA / 里程碑 / 联络方式),绝不仅写两个字「谢谢」。
69
+ - [ ] **SLOP-10 真实性与跨平台完备**:无未填占位草稿(除非用户明确要求空模板并标注 `draft`),全部产物为工作区绝对路径;若已运行渲染,确认 `missingFonts: []` 且收据匹配最新 PPTX。
68
70
 
69
71
  ## 跨 harness 安装
70
72
 
71
- 把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录,使用 Node `^22.19.0 || >=24.0.0`,在该目录运行 `npm install --ignore-scripts`。纯文本可直接运行;图片/图表/品牌导出需要 Office Kit,PNG/PDF 需另外安装可选官方引擎:
73
+ 把整个 `skills/dsh-ppt` 目录复制到目标 Agent 的技能目录,在 Node `^22.19.0 || >=24.0.0` 下执行 `npm install --ignore-scripts`。18 套主题与 19 套零依赖原生版式/图示纯 Node 内置模块即可运行;图片、13 类图表与外部 `.pptx` 吸收使用已声明的 `@office-kit/pptx@0.21.0`;PNG/PDF 渲染按需安装 `@deepseek-ai/libreoffice-kit`:
72
74
 
73
- | Agent | 技能目录 |
75
+ | Agent | 技能目录 / 安装命令 |
74
76
  | --- | --- |
75
- | DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
76
- | Claude Code | `~/.claude/skills/` |
77
- | Cursor | `.cursor/skills/` |
78
- | Gemini CLI | `~/.gemini/skills/` |
79
- | OpenAI Codex | `~/.codex/skills/` |
77
+ | DeepSeek Harness | `dsh plugin --profile desktop add dsh-ppt`(网页版用 `web`) |
78
+ | Claude Code | `~/.claude/skills/dsh-ppt` |
79
+ | Cursor | `.cursor/skills/dsh-ppt` |
80
+ | Gemini CLI | `~/.gemini/skills/dsh-ppt` |
81
+ | OpenAI Codex | `~/.codex/skills/dsh-ppt` |
80
82
 
81
- 一次编写,处处可用。
83
+ 一次编写,处处交付大师级品味。
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-ppt-skill",
3
- "version": "0.16.0",
3
+ "version": "0.22.0",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "description": "Standalone dsh-ppt skill dependencies for image/chart export",
@@ -1,41 +1,122 @@
1
- # 图文、图表、工程编辑与渲染
2
-
3
- Agent 先准备实际内容,再生成可放映 HTML 与可编辑 PPTX。用户无需填写 JSON。以下是工具接口参考。
4
-
5
- ## 创建
6
-
7
- `ppt_templates` 提供 weekly、defense、project、pitch 四种结构参考。`ppt_create` 的 `template` 单独使用时生成待填草稿,返回 `deliveryStatus:draft`;提供完成的 content/slides 才能开始成品验收。
8
-
9
- `slides` 新增 image/image-left/image-right/chart 布局。图片示例:`{layout:"image-left",title:"新版流程更短",image:{src:"assets/flow.png",alt:"新版流程截图",fit:"contain"},bullets:["可直接生成","可修改指定页"]}`。PNG/JPEG 本地路径按会话 cwd 解析,亦支持 data URI;每张5MiB/3200万像素、合计32MiB。图片嵌入工程和输出,移动原文件后仍可使用。contain完整显示,cover居中裁切。外链/SVG需先由明确授权的其他工具准备,不自动下载。
10
-
11
- 图表示例:`{layout:"chart",title:"完成量逐月增加",chart:{kind:"column",categories:["七月","八月","九月"],series:[{name:"完成量",values:[3,5,9]}],unit:"项"}}`。支持 column/bar/line/pie,也可用带表头 rows。长度必须一致,值必须有限;pie仅一个非负系列、正总和。原生PPTX图表包含编辑数据工作簿,HTML有SVG与读屏数据表。
12
-
13
- 共享品牌 `brand:{primaryColor:"#2C9F87",fontFamily:"Microsoft YaHei",logo:"logo.png",footer:"产品团队 · 2026"}`。还可设背景/文字色及name。选择接收方可用字体;字体诊断不自动安装字体。
14
-
15
- ## 修改与撤销
16
-
17
- 先 `ppt_check {deckPath:"report.json"}` 取得当前revision和页面ID。修改:`ppt_edit {deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"新标题",bullets:["事实一","行动"]}}]}`。slide为1起始页码或ID,其他页保留;重复指定页拒绝。可单独修改brand;brand:null清空品牌,logo:null清空Logo,空footer清空页脚。
18
-
19
- 复制与删除:`ppt_edit {deckPath:"report.json",expectedRevision:0,duplicate:[2],remove:[3]}`。两组引用都按修改前的1起始页码或稳定ID解析;副本紧跟原页,获得新ID,并保留图片、图表和备注。同一页不能同时复制和删除,不能重复指定,最终保留1–120页。可与edits和order合为一次修改,先编辑/排序,再复制/删除;order仍需包含每个原始页面ID各一次。
20
-
21
- 编辑会原子更新整套HTML/PPTX/JSON,失败回滚。历史最多20次。`ppt_undo {deckPath:"report.json",expectedRevision:1}` 恢复上次状态,包含页面结构、图片/图表/品牌;revision继续增长,旧修改不可覆盖撤销。仅编辑本插件JSON工程,不导入任意外部PPTX进行修改。表格扩大到需要分页时会要求另建文稿。
22
-
23
- ## 检查与渲染
24
-
25
- `ppt_check` 定位页面问题,包括密度、估计溢出、7–8列表格14pt、图片缺失/损坏/分辨率、图表标签和对比度。6列以内原生表格17pt。静态估算不能保证字体或视觉布局。
26
-
27
- 可选安装 `npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.2.3`(DSH 0.2.2 起内置该版本,0.1.5 亦兼容)。Windows还需相应架构的VC++v14运行库。`ppt_render {pptxPath:"report.pptx",format:"both"}` 读取最终PPTX,输出PNG/PDF/收据,不改源文件。默认png,width默认1440(320–3840),timeoutMs默认120000(1000–300000);最多120页,输入64MiB、输出128MiB、单张16MP。缺失引擎返回unavailable及安装说明,普通创建仍可用。
28
-
29
- 查看每页PNG及HTML,必要时在实际PowerPoint/WPS检查编辑、备注和动画。LibreOffice不保证与Office逐像素一致,PNG/PDF不保留动画。成功渲染仍为 `visual:not-verified`,不会自动声称视觉通过。
30
-
31
- 把返回receiptPath传给 `ppt_check {deckPath:"report.json",renderReceipt:".../render-receipt.json"}`。源文件与所有输出的摘要必须匹配;修改/删除后失效,重新渲染。收据是本地完整性记录,非签名证明。
32
-
33
- ## CLI
34
-
35
- `--slides @slides.json`、`--brand @brand.json`、`--template weekly`。
36
-
37
- `--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`。
38
-
39
- `--check report.json`、`--render report.pptx --format both`、`--check report.json --render-receipt receipt.json`。
40
-
41
- 默认渲染目录在PPTX旁;显式 `--out` 指定基目录,已有目录追加后缀。引擎不可用/静态错误/显式收据失效返回非零退出码。
1
+ # 出版级图表、图文精裱、母版吸收、编辑与视觉核验(高级参考)
2
+
3
+ Agent 先提炼真实内容与数据结论,再通过结构化参数生成可放映 HTML 与 100% 原生可编辑 PPTX。用户无需手写 JSON。
4
+
5
+ ---
6
+
7
+ ## 一、16 套高品味行业结构蓝图(`ppt_templates`)
8
+
9
+ 调 `ppt_templates` 可查看 16 套内置叙事与版式骨架(前 8 套兼容经典场景,后 8 套为高频垂直行业蓝图):
10
+ - **经典 8 套**:`weekly`(周报复盘)、`defense`(学术答辩)、`project`(项目汇报 · 含 `gantt` 排期)、`pitch`(创业路演 · 含 `tam` + `harvey`)、`consulting`(战略咨询)、`keynote`(产品发布)、`gov-report`(政务述职)、`workshop`(培训工坊)
11
+ - **新增 8 套**:`architecture-review`(技术架构评审)、`financial-earnings`(季度财报与业绩会)、`medical-case`(临床病例研讨)、`postmortem`(线上故障复盘)、`marketing-campaign`(品牌营销与增长战役)、`promotion-review`(个人述职与晋升答辩)、`legal-compliance`(法务合规与风控审计)、`creative-lookbook`(高端品牌策展与画册)
12
+
13
+ > 注意:`ppt_create` 仅传 `template` 而不提供实际 `content` / `slides` 时,仅生成带占位的待填草稿(返回 `deliveryStatus: "draft"`);必须组织好真实业务内容再生成,方能进入成品验收(`ready`)。
14
+
15
+ ---
16
+
17
+ ## 二、13 类出版级图表与图表洞察分栏(`chart` & `chart-split`)
18
+
19
+ 支持 **13 种 `chart.kind`**:
20
+ 1. **柱条对比**:`column`(簇状柱形)、`bar`(横向条形)、`stacked-column`(堆积柱形)、`stacked-bar`(堆积条形)、`percent-column`(百分比堆积柱形)、`percent-bar`(百分比堆积条形)
21
+ 2. **趋势面积**:`line`(折线图)、`area`(面积图)
22
+ 3. **份额结构**:`doughnut`(**推荐**:62% 内径环形图,中心展示汇总指标)、`pie`(饼图,仅限单一非负系列且正总和)
23
+ 4. **相关性与双轴**:`scatter`(散点图)、`combo`(柱线复合双轴图:在 `series[i]` 上指定 `chartKind: 'column' | 'line'` 与 `secondaryAxis: true`)
24
+ 5. **咨询瀑布桥**:`waterfall`(财务/增长增减拆解桥:HTML 输出高精 SVG + 读屏数据表,PPTX 输出 **100% 原生可编辑矢量圆角柱 + 虚线连接桥 + 正负号数值标签**,跨 PowerPoint / WPS / LibreOffice 零兼容死角;可通过 `totalIndices: [0, 4]` 指定起止汇总柱)
25
+
26
+ ### 经济学人 / 麦肯锡图表造型法则(内置默认生效)
27
+ ```json
28
+ {
29
+ "layout": "chart-split",
30
+ "variant": "chart-left",
31
+ "kicker": "02 · 渠道增长归因",
32
+ "title": "Q4 到馆人次较 Q1 翻倍,社区亲子活动贡献核心跃升",
33
+ "chart": {
34
+ "kind": "column",
35
+ "subtitle": "单位:人次 · 2026 年第 1–4 周实测",
36
+ "categories": ["第 1 周", "第 2 周", "第 3 周", "第 4 周"],
37
+ "series": [{ "name": "到馆人次", "values": [42, 55, 63, 78] }],
38
+ "unit": "人次",
39
+ "highlight": "max",
40
+ "showValues": true
41
+ },
42
+ "items": [
43
+ { "tag": "核心驱动", "title": "第 4 周峰值达 78 人次", "text": "周末亲子共读专场带动单周环比增长 **+23.8%**" },
44
+ { "tag": "复购留存", "title": "旧书流转率 68%", "text": "二次到馆家庭占比突破六成" }
45
+ ],
46
+ "takeaway": "建议将亲子共读固定为双周常设栏目,支撑下季度场均 85 人次目标。",
47
+ "source": "数据来源:社区图书馆门禁签到统计(2026.03)"
48
+ }
49
+ ```
50
+ - **去冗余图例**:`series.length === 1` 时自动隐藏单系列图例,彻底告别多余色块说明。
51
+ - **一主多灰聚焦(`highlight`)**:支持传索引(如 `3` 或 `[0, 3]`)或 `'max' | 'last'`;焦点柱使用主题 `chartFocal` 高亮色,其余对照柱自动退为柔和 `chartNeutral` 灰阶。
52
+ - **直接数值标签与淡化网格**:≤ 8 个类别默认开启柱顶直接数值标签(`showValues: true`),水平网格线精简至 ≤ 5 条 `0.75pt hairline` 细线。
53
+ - **长标签防歪头**:当类别文字过长(中文 > 6 字 / 英文 > 10 字符)或类别数 > 7 时,自动或优先使用横向 `bar` 条形图,拒绝 45° 斜排字。
54
+
55
+ ---
56
+
57
+ ## 三、图文精裱与多图画册(`image` / `image-left` / `image-right`)
58
+
59
+ - **本地嵌入与尺寸边界**:PNG / JPEG 本地路径按会话 `cwd` 解析(亦支持 `data:` URI);单张 ≤ 5 MiB / 3200 万像素,全稿合计 ≤ 32 MiB。图片直接打包进 HTML 与 PPTX,移动原文件后仍可独立放映。外链或 SVG 请先用经授权的工具转为本地 PNG/JPEG,引擎不自动联网下载。
60
+ - **版式变体**:
61
+ - `image-left` / `image-right`:`variant: 'framed'`(默认圆角细框精裱,正文列自动垂直居中)或 `'split-bleed'`(50% 半屏无边距出血大图,杂志大片感)。
62
+ - `image`:`variant: 'framed' | 'full-bleed' | 'gallery'`;传 `images: [{ src, alt, caption }, ...]`(2–3 张)可排版并列作品集或实验定性对比图。
63
+
64
+ ---
65
+
66
+ ## 四、外部参考 `.pptx` 深层骨架吸收与品牌定制(`ppt_absorb` & `brand`)
67
+
68
+ 1. **提取外部 `.pptx` 母版风格与骨架(`ppt_absorb`)**:
69
+ - 调用:`ppt_absorb { pptxPath: "corp-template.pptx" }`(CLI:`--absorb corp-template.pptx`)。
70
+ - 纯离线读取主题 12 色槽(含 DrawingML `lumMod / lumOff / tint / shade / satMod` 子变换解析)、西文与东亚字体族、母版背景、内嵌 Logo、母版骨架特征(`extractedSkeleton: { cornerStyle, hasTopBanner, hasSideSpine, masterShapeCount }`)、推荐母版骨架(`recommendedChrome`)与逐页版式推演(`slideSkeleton[]`),经 `sanitizeAbsorbedTheme()` 自动完成 WCAG 对比度净化与刺眼大红底降级。
71
+ 2. **一键套用参考 `.pptx` 与结构克隆(`referencePptx` & `cloneStructure`)**:
72
+ - 在 `ppt_create` 或 `ppt_edit` 中直接传 `referencePptx: "corp-template.pptx"`(CLI:`--reference-pptx corp.pptx`),自动将该模板净化后的色板、字体与母版 Logo 应用到整套文稿。
73
+ - 若同时传 `cloneStructure: true`(CLI:`--clone-structure`),将把 `recommendedChrome` 写入 `brand.chromeStyle`,并把 Markdown 正文页面直接映射到吸收出的 `slideSkeleton` 版式序列!
74
+ 3. **显式共享品牌(`brand`)**:
75
+ - `brand: { name: "星尘科技", primaryColor: "#0057B8", backgroundColor: "#FFFFFF", textColor: "#0F172A", chromeStyle: "consulting-classic", fontFamily: "Microsoft YaHei", logo: "assets/logo.png", footer: "战略规划部 · 内部资料" }`。
76
+ - 引擎通过 `deriveBrandedTheme()` 自动重算表面层级、淡网格线与次级墨色,杜绝浅底黑网格线冲突。
77
+
78
+ ---
79
+
80
+ ## 五、按页编辑、整套换肤、追加页面与撤销(`ppt_edit` & `ppt_undo`)
81
+
82
+ 1. **先查后改**:调 `ppt_check { deckPath: "report.json" }` 获取当前 `revision` 与稳定页面 `id`。
83
+ 2. **原子编辑(`ppt_edit`)**:
84
+ - **单页局部补丁 `edits`**:支持修改 `title, subtitle, kicker, takeaway, source, layout, variant, chrome, tableStyle, bullets, items, columns, rows, image, images, chart, notes, visual`(`slide` 传 1 起始页码或稳定 ID)。
85
+ - **整套换肤与品牌更新**:顶层可传 `theme: "exec-jilan"`、`referencePptx: "ref.pptx"` 或 `brand`(`brand: null` 清空品牌,`logo: null` 清空 Logo)。
86
+ - **追加、复制、排序与删除**:`append: [slide1, ...]`(单次追加 1–5 页新页面)、`duplicate: [2]`、`remove: [4]`、`order: [id1, id2, ...]`(包含全部原始页面 ID 各一次;执行顺序:先编辑/排序,再复制/删除/追加,最终保留 1–120 页)。
87
+ - 每次修改原子重写 HTML / PPTX / JSON,失败自动回滚,保留最近 20 步历史。
88
+ 3. **一键撤销(`ppt_undo`)**:`ppt_undo { deckPath: "report.json", expectedRevision: 1 }` 完整恢复上一状态(含主题、页面结构、图表、图片与数据模型),`revision` 单调递增。
89
+
90
+ ---
91
+
92
+ ## 六、渲染核验与双层 AI 视觉/叙事闭环(`ppt_check` & `ppt_render`)
93
+
94
+ 1. **静态与审美门禁(`ppt_check`)**:自动检测字数溢出估算、表格列宽、图片完整性、WCAG 对比度以及 `SLOP-01..10` 审美规范(名词弱标题、版式单一、冗余图例等)。
95
+ 2. **LibreOffice 真实画面渲染(`ppt_render`)**:
96
+ - 调用 `ppt_render { pptxPath: "report.pptx", format: "both" }` 输出逐页 PNG(默认宽 `1440px`)、PDF 与 `render-receipt.json`,不改动源 PPTX,并检查 `missingFonts`(验收要求 `missingFonts: []`)。
97
+ - 将 `receiptPath` 回传给 `ppt_check { deckPath: "report.json", renderReceipt: "..." }` 校验源文件与渲染图哈希一致;任何后续编辑都会使旧收据失效,必须重新渲染。
98
+ 3. **可选双层 Vision QA 与高管叙事教练(DSH 工作台按需开启)**:
99
+ - **Vision QA(最高 24 页全量看图修复)**:不仅检测溢出/裁切,还审查层级、留白、对比度与版式节奏,并通过 **12 种零文本篡改动作**(`title-size, body-size, chart-label-size, chart-horizontal, chart-highlight, image-contain, swap-image-side, density-mode, table-style, switch-layout, split-bullets, split-table`)自动另存精修副本,100% 不改动任何业务文字与数字。
100
+ - **AI 预审与答辩教练**:针对 `executive | investor | academic | technical | client | management | general` 听众画像,审查 `storyline`(Action Title 与金字塔逻辑)、`expression`、`logic` 与 `evidence`,严格遵守数字 Token 守恒锁。
101
+
102
+ ---
103
+
104
+ ## 七、CLI 速查(`scripts/build-deck.mjs`)
105
+
106
+ ```bash
107
+ # 智能场景导演一键生成(CLI 建议显式传 --theme auto 或具体主题 ID)
108
+ node scripts/build-deck.mjs --title "年度述职" --content deck.md --theme auto --lang zh --out dist
109
+
110
+ # 结构化 slides + 吸收外部参考 PPTX 母版并克隆骨架与 chromeStyle
111
+ node scripts/build-deck.mjs --title "战略规划" --content deck.md --reference-pptx corp.pptx --clone-structure --out dist
112
+ node scripts/build-deck.mjs --title "学术答辩" --slides @slides.json --chrome academic-minimal --theme academic --out dist
113
+
114
+ # 仅解析并查看外部 PPTX 的净化色板、字体与版式摘要
115
+ node scripts/build-deck.mjs --absorb corp.pptx
116
+
117
+ # 编辑、撤销、静态检查与渲染收据核验
118
+ node scripts/build-deck.mjs --edit dist/deck.json --edits @edits.json --revision 0
119
+ node scripts/build-deck.mjs --undo dist/deck.json --revision 1
120
+ node scripts/build-deck.mjs --render dist/deck.pptx --format both
121
+ node scripts/build-deck.mjs --check dist/deck.json --render-receipt dist/deck-render/render-receipt.json
122
+ ```
@@ -1,59 +1,81 @@
1
- # dsh-ppt 幻灯片写作规则(中英双语)
1
+ # dsh-ppt 大师级幻灯片叙事与写作规范(金字塔原理 · 六大画像 · 双语)
2
2
 
3
- ## 结构模板
3
+ 用户把材料交给你时,指望你不仅做排版,更要把零散素材提炼成**逻辑严密、结论先行、视觉张弛有度**的演示叙事。动笔组织大纲与单页文案前,必须遵守本规范。
4
4
 
5
- 任何 deck 都遵循同一叙事骨架:
5
+ ---
6
6
 
7
- 1. **封面**:标题(判断句或名词短语 + 价值承诺)+ 副标题(一句话定位)。
8
- 2. **背景/问题**:现状 → 痛点 → 为什么现在。
9
- 3. **方案/论点**:每个论点一页,先结论后理由。
10
- 4. **证据/案例**:数字、对比、客户/数据点。
11
- 5. **行动号召**:希望听众下一步做什么。
12
- 6. **结束页**:谢谢 + 联系方式或 CTA 重复。
7
+ ## 一、铁律一:结论先行标题(Action Titles · 断言-证据模型)
13
8
 
14
- 一句话输入的最小完整结构:封面 → 核心观点页 → 结束页。
9
+ **普通 PPT 与麦肯锡 / Nature 级 PPT 最大的分水岭就在标题。**
10
+ 除 `cover`(封面)、`agenda`(目录)和 `section`(章节过渡页)外,**每一张内容页、卡片页、表格页和图表页的 `title` 都必须是完整的结论判断句(主谓宾齐全,优先带核心量化结果或因果驱动力),绝不能写空洞的名词分类标签!**
15
11
 
16
- ## 单页规则
12
+ | 劣质名词标签(严禁 ❌) | 大师级 Action Title(必须 ✅) |
13
+ | --- | --- |
14
+ | 项目背景 / 痛点分析 | 工程师每周耗费 6 小时同步开会,且 80% 决策缺乏书面留痕 |
15
+ | 周末到馆人次 | 周末到馆人次四周内翻倍,第 4 周达 78 人次峰值 |
16
+ | 核心技术架构 | 三层解耦推理管线将首包延迟压至 140ms,吞吐提升 3.2 倍 |
17
+ | 实验结果与消融对比 | 本方法在三项基准全面超越 SOTA,边界约束贡献 +4.8% 增益 |
18
+ | 存在不足与下一步计划 | 针对跨部门协同滞后短板,Q3 将上线统一台账实现闭环督办 |
17
19
 
18
- - 一个页面只讲一个观点。
19
- - 标题是完整的判断句,例如「AI 客服把首响时间压缩到 8 秒」,而不是「关于客服」。
20
- - bullets 1–8 条,中文每条 ≤ 20 字,英文每条 ≤ 12 词。
21
- - 优先使用数字、对比、动词;避免「赋能、抓手、闭环」等空词。
22
- - 最后一页要给出可执行的 CTA,不是只写「谢谢」。
20
+ - **字数与行数控制**:中文标题 **14–32 字**(英文 **8–16 词**),严格控制在 **1–2 行内**;绝不把整段正文塞进标题。
21
+ - **页眉面包屑(`kicker`)与底栏结论条(`takeaway`)配合**:
22
+ - `kicker` 写所属章节或维度(如 `01 · 市场诊断`、`实验验证 · SOTA 对比`),**严禁全篇偷懒写「要点 / Point」**。
23
+ - 复杂图表页、矩阵页或对比页底部可加一行 `takeaway`(如 `核心启示:华东政企客群贡献了 68% 的净增毛利,应优先倾斜交付资源`),让听众 5 秒抓到决策抓手。
23
24
 
24
- ## 双语规则
25
+ ---
25
26
 
26
- - 插件 `lang` 参数只控制界面(页码/标签/结束页默认文案);**内容双语由写作阶段完成**。
27
- - 双语 deck 推荐两种做法:
28
- 1. 同一页内:中文标题 + 英文副标题;bullets 中文为主,关键词括号英文。
29
- 2. 两份 deck:同一大纲分别以 `zh` 与 `en` 生成,主题保持一致。
30
- - 英文标题用 Title Case;术语首现给中文+英文,如「检索增强生成(RAG)」。
31
- - 双语时不要逐句直译,按目标语言习惯重写。
27
+ ## 二、铁律二:六大用户画像叙事骨架与版式编排
32
28
 
33
- ## Markdown 与结构化输入
29
+ 根据用户材料自动套用对应画像的叙事脊梁(亦可调 `ppt_templates` 查看 16 套行业结构蓝图,含 `consulting | gov-report | defense | pitch | keynote | workshop | weekly | project | architecture-review | financial-earnings | medical-case | postmortem | marketing-campaign | promotion-review | legal-compliance | creative-lookbook`):
34
30
 
35
- 解析规则、表格/金句/备注语法与结构化 `slides` JSON 见 `syntax.md`。
31
+ ### 1. 商业战略与管理咨询(`consulting` · 推荐主题 `consulting` / `cobalt-cream`)
32
+ - **叙事骨架(SCQA + 金字塔原理)**:封面 → 执行摘要(`cards[exec-summary]`:顶部总论断 + 下方三大 MECE 支柱) → 现状与核心矛盾(`comparison` 或 `chart-split`) → 战略支柱拆解(`matrix[2x2]`、`chart[waterfall]` 利润/增长拆解桥、`cards[pillars]`) → 财务测算与风险控制(`table[consulting]`) → 实施路线图与行动要求(`process[timeline]` + `closing[cta-cards]`)。
33
+ - **写作调性**:克制、量化、因果清晰;数据页左下角务必注明 `source`(如 `数据来源:销售台账 2026Q1–Q3(脱敏)`;仅填真实来源,严禁编造机构署名)。
36
34
 
37
- ## 示例
35
+ ### 2. 政企汇报、年度总结与党建述职(`gov-exec` · 推荐主题 `exec-jilan` / `exec-palace`)
36
+ - **叙事骨架**:庄重封面 → 年度目录(`agenda`) → 数说总体成效(`kpi[grid]`:3–4 项核心指标完成率与同比增幅) → 重点工作推进(`cards[pillars]` 四梁八柱 / 三大攻坚工程) → 典型亮点与专项突破(`chart-split` 或 `image-right`) → 问题剖析与整改举措(`comparison[issue-action]`:**左列短板痛点 ──▶ 右列整改实招,一一对应**) → 下一阶段工作部署(`process[steps]` + `closing`)。
37
+ - **写作调性**:对仗工整、数据扎实、举措可核查;动效建议设为 `motion: 'off'` 或稳重淡入。
38
38
 
39
- 输入:
39
+ ### 3. 学术科研、论文汇报与毕业答辩(`academic` · 推荐主题 `academic`)
40
+ - **叙事骨架(Assertion-Evidence)**:学术封面(含论文题目、作者/导师/单位信息) → 研究背景与现有方法局限(`comparison[versus]`) → 本文核心贡献(`cards[numbered]`,严格 ≤ 3 条) → 方法总体框架与推导(`process[steps]` 管线 + `callout[formula]` 核心公式/定理定义) → 主实验对比(`table` 设 `tableStyle: 'booktabs'` **无竖线学术三线表**,最优指标用 `**加粗**` 标出) → 消融实验与案例可视化(`chart-split` / `image[gallery]`) → 结论与未来展望(`callout[takeaways]` + `closing`)。
41
+ - **写作调性**:严谨客观,保留材料中的真实误差范围(如 `82.1 ± 0.3`)与文献引用标记(`[1] Author et al., 2025`),绝不捏造 baseline 数值。
40
42
 
41
- ```markdown
42
- # 让会议少一半
43
+ ### 4. 科技产品发布与融资路演(`tech-pitch` · 推荐主题 `linear-dark` / `cobalt-cream`)
44
+ - **叙事骨架(Sequoia Pitch Arc)**:高张力价值封面 → 行业剧变与真实痛点(`statement` + `kpi`) → 产品亮相与核心交互(`image-left` 边框样机 / `cards[bento]` 非对称特性网格) → 技术壁垒与架构分层(`process[layers]`) → 商业化增长牵引力 Traction(`chart` 设 `highlight: 'last'`) → 竞品差异化矩阵(`matrix[2x2]` 或 `table`) → 里程碑路线图与合作/融资诉求(`process[timeline]` + `closing[cta-cards]`)。
43
45
 
44
- 用异步决策替代同步例会。
46
+ ### 5. 教育培训、知识科普与课程讲义(`education` · 推荐主题 `course-sage` / `soft`)
47
+ - **叙事骨架(Mayer 多媒体认知原则)**:课程封面 → 本节学习目标(`agenda[cards]`) → 核心概念引入与定义(`callout[definition]`) → 分步拆解演练(`process[steps]`,每步不超过 1 个新概念) → 正误做法对照(`comparison[do-dont]`:左列 ✓ 推荐做法 vs 右列 ✗ 常见误区) → 课堂小结与课后行动清单(`callout[takeaways]` + `closing`)。
45
48
 
46
- ## 问题
47
- - 工程师每周 6 小时在例会上
48
- - 决策没有记录,反复讨论
49
+ ### 6. 人文创意、品牌提案与杂志风视觉(`editorial` · 推荐主题 `editorial-forest` / `cartesian`)
50
+ - **叙事骨架**:杂志扉页封面(`cover[editorial]`) → 时代情绪洞察(`statement[editorial-asymmetric]` 大留白宣言) → 受众人物画像与核心主张(`quote` 金句页 + `cards[bento]`) → 视觉大片与触点呈现(`image-right[split-bleed]` 半屏无边距出血大图 + `image[gallery]` 画册联排) → 传播节奏与合作落地(`process[timeline]` + `closing`)。
49
51
 
50
- ## 方案
51
- - 会前异步文档 + 24h 评论期
52
- - 只有分歧项才开会
52
+ ---
53
53
 
54
- ## 效果
55
- - 周会从 4 次降到 1 次
56
- - 决策记录 100% 沉淀
57
- ```
54
+ ## 三、铁律三:版式节奏状态机与字数预算(拒绝文字墙)
58
55
 
59
- 产出:封面 → 问题 → 方案 → 效果 → 结束页,共 5 页,主题可选 `swiss`(数据/效率)或 `soft`(团队协作)。
56
+ ### 1. 节奏交替硬规则(Pacing Engine)
57
+ - **禁止连续单调**:同一具体 `layout` 不得连续出现 2 次(长表格自动续页除外);普通 `bullets` 版式全篇占比应 `< 25%`,**绝不允许连续出现超过 2 页 `bullets`**。
58
+ - **视觉呼吸交替**:高密度页(`table`、`matrix`、4 卡 `bento`、`chart-split`)之后,优先衔接中低密度视觉锚点页(`kpi`、`section`、`statement`、`quote`、`image-left/right`、`process`)。
59
+ - **一句话极简输入**:仅有一句话时,保持「`cover` 封面 → `statement` 核心观点宣言 → `closing` 行动号召」精炼 3 页闭环,不强行注水凑页数。
60
+
61
+ ### 2. 结构化引导词与各版式字数上限
62
+ 列表与卡片正文统一采用 **`**加粗短引导词**:具体事实说明`** 格式(如 `- **首响提速 93%**:AI 预分流将平均等待从 120 秒压至 8 秒`),引擎会在 HTML 与 PPTX 中自动渲染为「主色粗体引导词 + 次级色正文」双层级:
63
+
64
+ | 元素 / 版式槽位 | 中文预算上限 | 英文预算上限 | 超限处理原则 |
65
+ | --- | --- | --- | --- |
66
+ | `cover.title`(封面主标题) | ≤ 18 字/行,最多 2 行 | ≤ 10 词/行,最多 2 行 | 提炼主标题,修饰语移入 `subtitle` |
67
+ | `slide.title`(Action Title) | 14–32 字(≤ 2 行) | 8–16 词(≤ 2 行) | 删去铺垫套话,直接保留核心判断 |
68
+ | `bullets`(单页要点列表) | 3–5 条,每条 ≤ 24 字 | 3–5 条,每条 ≤ 14 词 | > 5 条拆成两页或升格为 `cards` / `process` |
69
+ | `kpi`(大数字指标卡,2–4 张) | `value` ≤ 8 字符;说明 ≤ 22 字 | `value` ≤ 8 chars;说明 ≤ 14 词 | 单位拆入 `unit`,同比拆入 `delta`(如 `+34% YoY`) |
70
+ | `cards` / `matrix`(卡片与象限) | 标题 ≤ 10 字;正文 ≤ 40 字 | 标题 ≤ 6 词;正文 ≤ 24 词 | 提炼关键词短句,严禁在卡片里塞长自然段 |
71
+ | `table`(对比表格) | 每页 ≤ 8 行数据、≤ 6 列最佳(硬上限 8 列、60 字符/格) | 同左 | 数值列带明确单位,> 8 行由引擎自动续页并重复表头 |
72
+
73
+ ---
74
+
75
+ ## 四、反空话黑名单与中英双语规范
76
+
77
+ 1. **禁用互联网黑话与公文废话**:删掉无信息量的「赋能、抓手、闭环、颗粒度、组合拳、生态化反、全方位多维度」,全部替换为**可观测的动作、对象与变化量**(例如把「全方位赋能客服闭环」改为「覆盖售前询价与售后退换 2 大链路,人工转接率下降 41%」)。
78
+ 2. **双语写作规则**:
79
+ - 插件 `lang: 'zh' | 'en' | 'bilingual'` 只决定界面控件与页码标签语言,**幻灯片内容语言完全由你撰写**。
80
+ - **单页双语推荐结构**:中文 Action Title + 精炼英文 `kicker` 或 `subtitle`;专业术语首次出现采用「中文全称(English Acronym)」,如「检索增强生成(RAG)」。
81
+ - **纯英文文稿规则**:标题采用 Sentence case(现代科技/学术,如 * Edge caching cuts p99 latency by 62%*)或规范 Title Case(正式商业封面),切忌生硬逐字机翻。