演示文稿工程（Deck Engineering）
何时使用
- 从一句话或一份材料做演示：商业汇报、产品发布、投资路演、培训课件、大会演讲
- 已有 PPT 要改：逻辑乱、页面挤、风格不统一、讲的时候找不到话
- 要在三条交付形态里选路：原生 .pptx、零依赖 HTML 单文件、PPT/PDF 逐页讲解成片
- 要做「人感」演示——观众愿意听、听得进，而不是把文档搬上屏
判定（分流相邻技能）：交付物是演示件本身（页、讲义、讲稿）＝ 本技能；交付物是一段成片＝ explainer-video-production；动的是剪辑与调色＝ video-editing-craft；产出是Word／Excel＝ minimax-docx / minimax-xlsx；产出是一张竖版长图＝ wechat-long-image。
触发语（语言信号）
- 中文：做 PPT、演示文稿、幻灯片、路演材料、pitch deck、工作汇报、季度汇报、培训课件、大会演讲、PPT 美化、HTML 演示、PPTX 转网页、逐页讲解
- English: deck, slide deck, presentation design, pitch deck, business review, training slides, HTML slides, PPTX to web, narrated slides
总纲：三条底座
- 逻辑先于视觉，大纲先于渲染。先有故事线（金字塔原理）再谈配色。跳过大纲直接出几十页，返工成本极高——这是一条被反复验证的代价线。
- 一页一主题，标题即观点（Action Title）。标题若是名词短语（「业绩情况」），就是没想清楚这一页要说什么；改成判断句（「Q3 增长靠提价而非量增」）才算立住。
- PPT 是表达工具，不是决策工具。不替用户做战略判断；数据不编造，未提供的一律标注「假设数据」。
一、动工前四问（必做，不可跳）
生成前必须问清；用户答不出的，按下列默认走并明写假设：
| 项 | 问法 | 默认（用户未答时） |
|---|---|---|
| 主题／源材料 | 「主题是什么？还是有现成文档／数据要我用？」 | 无源材料不启动，先索要 |
| 目标听众 | 「讲给谁听——领导、客户、投资方、还是新人？」 | 领导汇报（信息密度中、结论先行） |
| 页数与时长 | 「大概几页？讲多久？」 | 15 页 / 20 分钟（≈每页 80 秒） |
| 风格偏好 | 「商务／活泼／学术？有主色偏好吗？」 | 商务，深蓝主调 ＋ 衬线标题 ＋ 数据强调色 |
> 抽象描述要落成具体方案。用户说「商务感」，给 1–2 个具名方案让他选（如「A：深蓝 ＋ 衬线 ＋ 红色强调；B：石墨灰 ＋ 无衬线 ＋ 橙色强调」），不要反问「您想要什么样的商务感」。
## Deck 确认单
- 主题：
- 源材料：［文件路径／无］
- 听众：［决策层／客户／投资方／学员］
- 页数 / 时长：［ 页 / 分钟］
- 场景类型：［汇报／发布／路演／课件／keynote／模板化输出］
- 风格方案：［具名 A / B］
- 交付形态：［pptx ／ HTML 单文件 ／ 逐页讲解成片］
- 是否需要讲稿 / 演讲模式：［是／否］
- 已知假设数据：［逐条列出］
二、大纲先于渲染：AST 生产契约六件套
生成页面前，先把「生产契约」写出来。六件套的作用是把口头需求变成下游可消费的接口——页、视频、讲稿三条线都从这里取料。
## AST 生产契约（六件套）
### 1. deck_brief.md —— 一页纸的意图
- 受众与场景：
- 讲完希望对方做什么决定 / 记住哪一件事：
- 三句话故事线：① ② ③
- 不讲的：［明确划掉的内容，防跑偏］
### 2. ast_outline.md —— 大纲树
- 章节 → 子章节 → 页
- 每页一行：`[页号] 标题（观点句）｜支撑物（图表／图／引文／案例）`
### 3. slide_plan.json —— 页面规格（机器可读）
```json
[{"no":1,"layout":"title","title":"...","bullets":[],"visual":{"type":"hero","asset":"..."}}]
4. speaker_intent.md —— 每页「讲什么、不念什么」
[页号] 这页的意图：___ ｜ 屏幕上不写但我要说的：___ ｜ 预计停留：__ 秒
5. asset_manifest.md —— 素材清单
[文件名] 用途／出处／许可（自制｜免费商用｜用户提供｜待补）
6. video_slots.json —— 需要动效或成片的页
[{"page":7,"need":"数据增长动画","duration":"8s","fallback":"静态图"}]
> 六件套里**最常被跳过、又最值钱的是 4 与 6**：没有 `speaker_intent` 的演示必然变成念屏幕；没有 `video_slots` 的动效需求会在最后一刻变成惊喜。
---
## 三、页面规格：一页一件事
### 3.1 页面自检六条
| 项 | 阈值 | 不达标怎么办 |
|---|---|---|
| 每页结论 | ≥1 个可带走结论 | 合并页 或 补 Action Title |
| 正文页字数 | ≤50 字 | 砍到图表／图示承载 |
| 每页主视觉 | 恰好 1 个 | 拆页 |
| 标题 | 判断句，≤20 字 | 改写成观点 |
| 层级 | 标题 / 正文 / 注 三级，不超三级 | 删掉第四级 |
| 数据页 | 单位 ＋ 来源齐备 | 补，不能留白 |
### 3.2 版式模板（六种够用）
```markdown
## 页面规格
- 页号：__ ｜ 场景：［汇报/发布/路演/课件/keynote］
- 版式：［标题页 ｜ 结论页 ｜ 图表页 ｜ 对比页 ｜ 流程页 ｜ 金句页］
- Action Title（判断句）：
- 支撑物：［图表类型＋数据源 ／ 图示 ／ 引文 ／ 案例］
- 屏幕文字（≤50 字）：
- 备注（不写屏上、只讲）：
- 停留秒数：
3.3 数据可视化六条硬规
- 柱状／条形：按数值排序（时间序列除外）
- 饼图：切片 ≤6；超 6 改条形
- 折线：线数 ≤4；多的拆图或改小倍数
- 一页一张主图：辅助小图面积不超过主图 1/4
- 单位与来源：坐标轴标单位，页脚标来源与口径
- 零魔数：每个数字都能回到源表；不可回溯的标「估算」
3.4 配色与字体
- 配色：2–3 个主色 ＋ 1–2 个强调色；禁止彩虹。强调色只用于「要对方看的那个数」
- 一致性：字体、配色、图标风格、留白四件套在整套内统一，不东拼西凑
- 字体：中文正文用思源黑体／阿里巴巴普惠体（免费商用）；标题可用站酷系列；不用来路不明的字体
- 留白：页边距不小于页宽 6%；宁可多一页，不要挤一页
四、三条交付路径（先选路，再动手）
| 路径 | 适合 | 优点 | 代价 |
|---|---|---|---|
| A · 原生 .pptx | 需交给他人继续编辑、要打印、企业模板约束 | 可编辑性最好（文字与图表都可改，不全塞图片） | 视觉上限受母版限制 |
| B · 零依赖 HTML 单文件 | 在线演示、要动效、要发链接、要 PDF 导出 | 零依赖、动画丰富、可部署可导出 | 需交代静态资源相对路径与部署方式 |
| C · 逐页配音讲解成片 | 内训、方案宣讲、异步交付 | 原页原版式不用重做，直接逐页配音成片 | 成片不可改；走 explainer-video-production |
三条路径共用同一份 AST 契约——先写契约再选路，否则换路就要返工。
4.1 路径 B：HTML 单文件规范
## HTML Deck 规格
- 单文件零依赖：CSS/JS 内联，不引 CDN（离线可开）
- 尺寸：1280×720（16:9）固定画布，按视口等比缩放
- 翻页：← → / 空格 / 点击；页码与进度条常驻
- 字体：内联或系统字体栈，不依赖本机已装字体
- 动效：仅入场（opacity/transform），时长 0.3–0.5s，不做循环动画
- 交付附带：部署方式、PDF 导出方式、静态资源相对路径说明
- 风格预览：可先生成 3 套风格供选，再定稿
4.2 路径 C：逐页讲解成片规范
- 原页原版式直出，不重排；重排等于重做，且必引入新错
- 每页配音时长按字数估：中文 ≈ 4 字／秒；留 0.5–1 秒页尾静默
- 转场只用硬切或淡入淡出；花哨转场会让人注意转场而不是内容
- 无视频能力的降级：输出逐页讲稿 ＋ 页序表，标注每页时长，交给用户自行录制
五、演讲模式与讲稿
## 演讲模式规格
- 当前页 / 下一页 双栏预览
- speaker notes 按页挂载（来源：speaker_intent.md）
- 计时器：累计时间 ＋ 本页建议停留
- 快捷键：翻页、跳页、黑屏、计时重置
讲稿写作三条：
1. 不念屏幕——屏幕上已写的，讲稿里不重复
2. 每页一句过渡——把「这页讲完了」变成「所以下一页要看的是」
3. 首尾各留一句人话——开场说清「为什么值得听」；结尾说清「现在请你做什么」
六、QA 六查（交付前必跑）
| # | 检查项 | 通过标准 |
|---|---|---|
| 1 | AST 完整保留 | 契约六件套每条都在成品里找得到落点 |
| 2 | 页面可打开、无溢出 | 全页过一遍，无文字压边、无元素重叠 |
| 3 | 素材位有实际文件或清晰 fallback | 不留「待补」空位 |
| 4 | 演讲路径可用 | 备注齐、双栏可切、计时正常（若需） |
| 5 | 部署 / PDF 路径可执行 | 已实测，不是「应该可以」 |
| 6 | 交付 manifest 齐 | 列出所有文件与状态，无遗漏 |
七、量化验收指标
| 指标 | 阈值 |
|---|---|
| 每页可带走结论 | ≥1 |
| 正文页字数 | ≤50 字 |
| 页面主视觉数量 | =1 |
| 饼图切片 / 折线线数 | ≤6 / ≤4 |
| 整套配色 | 主色 2–3 ＋ 强调色 1–2 |
| 数据页来源标注率 | 100% |
| 演讲路径备注覆盖 | 100%（若交付演讲模式） |
| 假设数据标注率 | 100%（凡非用户提供） |
| QA 六查 | 全过 |
| 「待补」空位 | 0 |
八、反例
- 跳过大纲直接生成 30 页——方向错了，返工成本是重做一遍。这是本技能最贵的一条坑。
- 标题写成名词短语（「项目进展」）——观众不知道这页要他记什么。改成「项目延期 2 周，主因是接口联调」。
- 把所有内容塞进一页——字号降到 12pt 以下，等于没有这页。
- 无一级校色意识的配色：直接套用花哨模板的彩虹色，强调色到处都是，等于没有强调。
- 图表不标单位与来源——半年后没人知道那个 38% 是什么口径。
- 全页塞图片（截屏当页用）——用户后续无法微调一个字。
- 把「客户案例」写成示例公司——编造数据是本技能的红线，违反即整份作废重做。
- 用他人平台水印的素材——发布后被限流，且无法解释。
九、边界与可信度
本技能可信度说明
本技能的具体规范（大纲结构、单页信息密度、配色与图表规范、QA 六查）来自已验证的公开实践，可直接使用。三条交付路径中「HTML 单文件」与「逐页讲解成片」的具体实现参数未经逐项校验，属已知缺口，使用时请自行确认。
本技能不做（边界互指）
- 讲解成片的拍摄、合成与 BGM →
explainer-video-production - 剪辑、调色、音频工程、字幕排版 →
video-editing-craft - Word / Excel 文档生成 →
minimax-docx/minimax-xlsx - 公众号竖版长图 →
wechat-long-image - 多篇章带目录页码的整册 PDF →
html-to-pdf-long-book - 单页交互式汇报网页 →
smart-page-localize - 培训课件的教学内容设计（学习目标、练习设计）超出本技能；本技能只管「课件怎么排」
已知缺口
- 「HTML 单文件」与「逐页讲解成片」两条交付路径的具体实现参数未经逐项校验，使用时请自行确认
- 「AST 生产契约六件套」的文件名以本技能 §二 为准；若下游工具链命名不同，按 §二 的语义对齐即可
