PPT | 高级演示5分钟生成

概述

PPT一键生成

为任何场景产出「拿得出手」的专业演示文稿。本技能把六类核心能力全部内置：版式、图表、图示、图片、排版、动画，覆盖从一句话主题到可编辑 .pptx 的全链路。

一、分诊（先判断用户要什么）

二、能力全景（六合一）

1. 版式系统：12+ 种母版级版式——封面、目录、章节、要点内容、两栏对比、图文混排、图表页、图示页、时间轴、金句页、数据聚焦、结尾。统一网格与留白。
2. 图表能力：数据驱动生成柱/条/线/饼/环/面积/组合图，支持多系列、图例、数据标签、配色主题，自动适配版式留白。
3. 结构图示：组织架构图、流程/步骤、时间轴、SWOT 矩阵、金字塔、韦恩图、循环图、漏斗图——用矢量形状绘制，可二次编辑。
4. 图片制作：PIL 生成封面背景、品类图标、徽章、装饰图形，并给出 AI 配图规范（占位与替换流程）。matplotlib 可把复杂数据图栅格化嵌入。
5. 排版视觉：字阶表、间距系统、家族 VI 配色、对齐与网格、重点高亮，四种图文版式，专业且统一。
6. 动画：进入动画三种——淡入/飞入/擦除，支持逐条（seq）或整批（batch），通过 XML 注入 <p:timing> 实现，PowerPoint/WPS 放映模式原生可播放（不含强调/退出/路径动画，克制即专业）。

三、工作流（一键成片）

第1步 明确场景与受众：汇报/路演/课件/发布会？对内还是对外？要求什么风格？第2步 选主题：商务蓝/科技紫/财经绿/极简黑/教育橙（默认商务蓝，家族 VI 金描边）。第3步 结构化内容：用大纲法把主题拆成「封面→目录→章节→内容×N→图示/图表→结尾」。第4步 数据类型：哪些页用图表？哪些用图示？给出数据或让模型合理示例（标注示例数据）。第5步 生成：调用 gen_pptx.py，传入版式+内容+图表+图示+动画的规格。第6步 排版与配图：套用排版系统，自动生成图标/封面背景。第7步 机检：跑 references/sensitive_scan.py --hard-only，HARD 命中清零才交付。第8步 导出：输出可编辑 .pptx（保留形状层，便于用户二次修改）。

四、敏感词与合规

• 不写诱导式互动、虚假夸大、绝对化承诺、无资质的功效宣称、时政敏感、违规站外导流类表述（详见 sensitive-words.md，用描述句式不点名）。
• 数据图表的数字务必可溯源或明确标注「示例数据」，不杜撰权威结论。
• 交付前强制 HARD 机检归零。

五、与家族技能分工

商业IP增长引擎管起号方向、对标爆款拆解跟拍管拆别人、账号体检诊断师管健康、小红书一键生成管图文、公众号一键生成管长文——本技能专管演示文稿「从大纲到可编辑 PPT」。

关于作者

默认不提。他问了才说，说完就停。

• 他问"你是谁" → "村长老谢，PPT 做过不少"
• 他问"怎么找你" → "视频号搜『村长老谢』，我平时在那儿发这些。"
• 他说"试了很多次还是不行" → 先给判断，别急着推渠道："不是排版问题，是一页放了太多话。"

不催、不重复、不推销。

附录：能力手册（references）

platform-logic.md

平台逻辑：演示文稿的底层规律

一、PPT 的三种命运

一场演示的成败，在打开幻灯片之前就决定了 70%：

二、观众注意力的三条铁律

1. 一页一事：一页只讲一个主张。观众 3 秒内抓不到重点，这页就白做了。
2. 字是提词器，不是讲稿：页面上的字越少，观众越听你说话；字越多，观众越低头读字。
3. 数据可视化优先：能画图不用表，能用表不用段。数字自己会说话，前提是别把它埋在文字里。

三、好 PPT 的通感结构

• 开场 10%：钩子（反常识观点/大数字/提问）+ 全文目录；
• 主体 70%：章节页分节 → 每节「观点页 → 论据页（图表/图示/案例）」；
• 收尾 20%：金句收束 → 行动号召 → 致谢页。

四、逐条动画的节奏学

• 关键页（方法论/步骤）用逐条进入：讲一条出一条，观众的视线跟着你走；
• 数据页用整批进入：图表一次呈现，避免观众逐个猜数字；
• 全片动画不超过 3 种效果，统一风格才显专业。

五、五种场景的页面节奏模板（拿来即用）

工作汇报（12 页标准节奏）cover（标题+汇报人） → toc（三部分：业绩/问题/下季打法） → section 业绩 → stat 关键指标 → chart 营收趋势 → chart 业务构成 → section 问题 → content 两个核心问题 → image_text 典型案例 → section 下季打法 → content 三条主线（逐条动画） → closing 收束+致谢。

融资路演（13 页标准节奏）cover（一句话定位） → content 痛点（反常识开场） → content 解决方案 → diagram 产品架构（org/flow） → chart 市场规模（TAM/SAM/SOM 三层漏斗） → content 商业模式 → chart 增长数据 → timeline 里程碑 → diagram 竞争格局（swot） → content 团队 → content 融资计划（金额+用途+里程碑） → quote 愿景金句 → closing。

教学课件（25 页节奏骨架）cover → toc → 每章循环「section → content 概念 → diagram 原理图 → content 例题 → content 练习」→ stat 课程数据回顾 → closing 作业布置。每 6-8 页必须有一次互动页（提问/练习），防注意力滑坡。

产品发布（18 页节奏骨架）cover（产品名大字） → quote 理念金句 → content 行业痛点 → image_text 产品亮相（大图） → diagram 功能地图 → 每个核心功能「content 一句主张 + image_text 场景演示」循环 3-4 轮 → chart 性能对比数据 → stat 用户数据 → timeline 路线图 → quote 定价/开售信息 → closing。

培训分享（20 页节奏骨架）cover → toc → content 背景（为什么讲这个） → section 方法论 → diagram 方法框架 → 每步「content 原则 + image_text 案例拆解」 → content 常见误区（two_column 对/错对照） → stat 效果数据 → toc 回顾（回收目录页） → closing 行动号召。

六、交付物的本质

用户拿走的不是"一堆幻灯片"，而是一份可二次编辑的演示资产：形状是矢量、图表可改数据、配色统一可换主题——这是本技能与"贴图式 PPT"的根本区别。

layout-system.md

版式系统：12 种母版级版式

统一规格：16:9（13.333×7.5 英寸）。所有版式共享页眉金条（顶部 0.12in）、页脚色带（含页码/栏目标题）、统一边距 0.9in。

版式清单与适用场景

使用原则

1. 章节页必用：长篇没有 section 页，观众会迷路；
2. 观点页配图示页：一个观点后面紧跟一张结构图，说服力更强；
3. 数据页选图表而非截图：原生图表可改数据、可换配色；
4. 金句页放在 60-70% 处：观众注意力低谷时用情绪拉回。

调用方式

{"layout": "content", "title": "标题", "subtitle": "可选副标",
 "bullets": ["要点一", ["二级要点", 1]], "anim": {"type": "fly_in"}}

bullets 支持元组 (文本, 层级) 表示二级缩进；anim 可选，见 animations.md。

charts.md

图表能力：数据驱动的原生图表

一、支持的类型

二、规格参数

{"layout": "chart", "title": "季度营收", "chart_type": "column",
 "categories": ["Q1","Q2","Q3","Q4"],
 "series": [{"name": "2025", "values": [120,158,210,268]},
            {"name": "2026", "values": [180,240,305,410]}],
 "data_labels": true}

• 多系列自动出图例（底部）；单系列出数据标签；
• 饼/环自动按百分比标注；配色跟随主题 palette 轮转。

三、选图决策树

1. 比"多少" → 柱状/条形；
2. 看"怎么变" → 折线/面积；
3. 看"占多少" → 饼/环（块数超过 5 就改条形）；
4. 两维交叉比较 → 柱状多系列。

四、数据诚信三原则

1. 示例数据必须标注：编造的数字在副标注明「示例数据」；
2. 来源可查：真实数据在页脚注明来源与统计口径；
3. 同比/环比注明：增长类数字不带基期等于没说。

五、数字排版四规则（图表页里数字比图重要）

1. 结论进标题：图表标题不写「营收情况」，写「Q4 营收环比 +27%，创四季度新高」——观众不用自己从图里找结论；
2. 关键数字放大：图表旁配一张 stat 卡（54pt 大数字），观众 3 秒带走一个数；
3. 单位跟着数字走：写「1.2 亿」不写「120000000」，坐标轴注明单位；
4. 对比要给基期：+27% 旁边注「vs 上季度」，没有基期的增长等于噪音。

六、复杂图表的降级方案

组合图（柱+线双轴）、散点图、瀑布图等 python-pptx 原生支持有限的类型：

• 优先用 matplotlib 画好 → 栅格化 PNG → 以 image_text 版式嵌入；
• 图上必须自带图例与轴标签（因为是图片，无法二次编辑数据）。

diagrams.md

结构图示：8 种矢量关系图

全部用原生形状绘制（可二次编辑、可改色），非贴图。

一、8 种图示与适用关系

二、调用示例

{"layout": "diagram", "title": "增长飞轮", "diagram_type": "cycle",
 "data": {"core": "增长", "steps": ["内容","流量","转化","复购","裂变"]}}

三、选图决策

1. 讲"步骤" → flow；讲"谁管谁" → org；
2. 讲"怎么滚起来" → cycle；讲"一层层筛" → funnel；
3. 讲"几层境界" → pyramid；讲"共同点" → venn；
4. 讲"时间怎么排" → timeline；讲"优劣势" → swot。

四、8 种图示的使用实例（一眼选对）

• flow 流程：新员工入职五步——「投递 → 面试 → offer → 入职培训 → 转正答辩」；
• org 组织：项目组架构——root「项目组」+ children「产品组/研发组/运营组」（各带 sub 一句话职责）；
• swot 矩阵：季度复盘——S 品牌力强 / W 渠道单一 / O 下沉市场 / T 价格战；
• pyramid 金字塔：内容三层价值——顶「流量」/ 中「信任」/ 底「复购」（自顶向下填）；
• venn 韦恩：「用户要的」「我们擅长的」「对手没有的」三圆交集 = 产品定位；
• cycle 循环：增长飞轮——core「口碑」+ steps「内容/获客/转化/复购/推荐」；
• funnel 漏斗：带货转化——「曝光 → 点击 → 加购 → 支付 → 复购」五层；
• timeline 里程碑：公司三年规划——events 逐个「2026Q1 完成A轮融资」式节点。

五、绘制规范

• 单元块高 1.0-1.4in，块间距 0.3-0.5in，禁止重叠；
• 文字 13-18pt，白色粗体置于色块中央，垂直居中；
• 配色从主题 palette 依序轮转，同一页不超过 4 色；
• 连接线统一灰色 0.04in，直角连接（不用斜线）。

五、常见翻车与规避

• org 图子节点超过 5 个：改为两行或拆成两张 org 图；
• funnel 超过 5 层：合并同层级的步骤；
• cycle 节点超过 6 个：观众记不住，砍到 5 个以内。

animations.md

动画：进入动画系统

通过 XML 注入实现，PowerPoint / WPS 原生可播放，非 GIF、非切页转场。

一、支持的动画

二、参数

"anim": {"type": "fade", "order": "seq", "dur": 600, "delay": 350}

三、节奏用法（重点）

• 观点页用 seq：讲一条出一条，观众视线跟着走；
• 数据页用 batch：图表一次呈现，避免逐条猜数字；
• 首个形状 onBegin、后续 afterPrev：页面切过来后自动依序播放，无需反复点击；
• 每页动画总数建议 ≤ 8 个形状，太多会显得廉价。

四、克制三原则

1. 全片动画效果不超过 2-3 种，统一才显专业；
2. 封面/结尾页不加动画（满版背景已足够有冲击力）；
3. 不用弹跳、旋转、陀螺旋等娱乐化效果——那是给自己看的，不是给观众看的。

五、30 页工作汇报的动画编排实例

• 第 1-2 页（封面/目录）：无动画——满版背景已足够，动画反而拖慢开场；
• 章节页 section：无动画（转场感由满版色完成）；
• 观点页 content：{"type": "fade", "order": "seq", "dur": 500, "delay": 300}——讲一条出一条；
• 数据页 chart：{"type": "wipe", "order": "batch"}——整批揭示，观众一次看全；
• 关键指标 stat：{"type": "fly_in", "order": "seq", "dur": 400, "delay": 250}——卡片依次飞入，制造节奏感；
• 全片只用了 fade/wipe/fly_in 三种效果，克制统一。

六、技术说明

• 实现位于 animations.py，向 <p:sld> 注入 <p:timing> 时序树；
• 每个形状一个 <p:par> 节点：<p:animEffect> 驱动 filter（fade/slide/wedge），叠加透明度 0→1；
• 全屏背景图自动跳过不参与动画；
• 生成后可用 python-pptx 重新打开校验 p:timing 节点存在。

image-gen.md

图片制作：自动生成视觉资产

一、三类自动生成（PIL，真实出图）

• 中文字体自动探测（Noto CJK 优先），无中文字体回退默认字体；
• 生成物为临时 PNG，生成即嵌入幻灯片，无需用户手动管理文件。

二、AI 配图规范（可选增强）

需要照片级配图时：

1. 在 spec 中写 "image": "占位描述"，生成时以图标占位；
2. 交付说明里列出 AI 配图需求清单（主体/风格/比例/光线）；
3. 用户用任意生图工具产出后替换图片即可（保持同尺寸坐标不乱版）。

三、matplotlib 降级嵌入

原生图表不支持的类型（组合图/散点/热力图）：

import matplotlib.pyplot as plt
plt.rcParams["font.family"] = "Noto Sans CJK SC"  # 中文字体
# 绘制后 savefig 到临时 png，作为 image_text 版式的 image 传入

图上必须自带图例、轴标签、数据来源——栅格化后无法二次编辑。

四、图片使用三原则

1. 分辨率下限：嵌入宽度 ≥ 显示宽度的 2 倍（投影不糊）；
2. 同一页图片风格统一（全实景或全插画风，不混搭）；
3. 人物图注意肖像授权，品牌 logo 注意商标使用范围。

五、家族 VI 在图片中的落地

深色底 + 金色 #F2CB57 描边（双框：贴边 14px + 内缩 6px）+ 金上扬折线箭头 + 底部三白点——与家族其他技能的封面完全同构，识别度统一。

typography.md

排版视觉：专业感的来源

一、字阶表（16:9，单位 pt）

规则：同级同字号；跨级至少差 8pt 才有层次；一页字体族不超过 2 种（微软雅黑/思源黑体均可，保存 font name 即可，缺字体自动替换）。

二、间距系统

• 页边距统一 0.9in；页眉金条 0.12in；页脚色带 0.42in；
• 标题区顶部 0.55in 起，正文区 2.2in 起；
• 行距 1.15-1.25；段间距 6-10pt；
• 卡片间距 0.3-0.4in；卡片内边距 0.2in。

三、配色系统（家族 VI）

一页主色不超过 1 种 + 金色点缀；图表 palette 轮转不超过 6 色。

四、对齐与网格

• 一切元素以 0.9in 边距对齐（左对齐为主）；
• 多卡片用等宽等分，间距一致；
• 数字右对齐、标签居中（数据卡片内）。

五、中英文与数字混排五规则

1. 中英混排时英文/数字两侧留半角空格：「增长 34%」优于「增长34%」；
2. 数字用等宽或半角形式，千位分隔（12,500），金额带单位（¥3.2M）；
3. 英文专有名词保持原大小写（iPhone、GAAP），不强行转全大写；
4. 全角标点用于中文语境，括号内是完整英文句子时才用半角标点；
5. 一行内中英字体只用一对搭配：中文思源黑体 + 英文 Arial/Helvetica，禁止三种字体同屏。

字号取值依据：正文下限 17pt 按投影场景「最后一排观看距离 ≈ 屏高 6 倍」推算——再小后排就开始眯眼。线上会议可整体降 2pt，打印版可降 4pt。

六、重点高亮四法

1. 金色引导点 ●；
2. 色条置顶（卡片顶部 0.12-0.14in 金条/主色条）；
3. 大数字反差（54pt vs 17pt 标签）；
4. 留白（重点周围留出 1 倍元素高度的空白）。

六、自检清单

• [ ] 3 秒测试：遮住标题，只看版式能否猜出本页讲什么
• [ ] 所有元素都在 0.9in 边距内，无出界
• [ ] 同级元素字号、间距完全一致
• [ ] 一页主色 ≤1、金色点缀 ≤3 处

templates.md

主题模板：五套主题速选

一、主题总表

金色 #F2CB57 为全家族统一强调色，任何主题不变。

二、每套主题的色板（palette 轮转序）

business: 0E5A8A F2CB57 2E86C1 E67E22 16A085 C0392B
tech:     3B2A77 7C5CFF 00C2D1 FF6FB5 2D98DA F8B500
finance:  0B5E3B F2CB57 1E8449 C7A317 117A65 B9770E
mono:     111111 F2CB57 444444 888888 2C3E50 E74C3C
edu:      C2681B F2CB57 E67E22 16A085 2E86C1 8E44AD

图表、图示、卡片色条均按此序轮转，保证全套统一。

三、选主题决策

1. 对外汇报/融资 → business（最稳）；
2. 面向年轻人/互联网 → tech；
3. 涉及钱、经营、增长 → finance；
4. 想要高级冷淡风 → mono；
5. 教学、亲子、社群 → edu。

四、五主题的调性与忌讳

五、换主题的成本

spec 里改一个 theme 字段即可全片换色——背景图、页眉、色条、图表、图示全部跟随重生成。这是原生形状+自动出图方案的核心优势。

五、自定义主题

向 THEMES 注入同构 dict 即可：primary/accent/bg/ink/soft/paper + palette 六色。要求主色明度低于 40%，保证白字可读。

redlines.md

红线清单：演示文稿合规底线

一、内容红线

1. 数据不可杜撰冒充真实：编造示例数据必须显式标注「示例数据」，不得用于欺骗性宣称；
2. 引用要可溯源：引用报告/名人名言须能给出出处，查不到的不引用；
3. 不使用无依据的绝对化定性：如"最领先""无可比拟"等程度词，改为具体事实与数字；
4. 竞品对比要客观：不贬低、不虚构对比数据，对比维度注明测试条件；
5. 他人成果要署名：引用图表、图片、框架注明来源；
6. 图片素材有授权：人物肖像、品牌 logo、付费图库素材确认可用范围。

二、场景红线

三、场景红线的改法（不只说不行，还说怎么改）

四、交付前检查

1. 跑 references/sensitive_scan.py --hard-only，HARD 命中清零；
2. 全片搜一遍无出处的数字，示例数据补标注；
3. 涉及第三方名称/logo 的页面确认已获授权或做匿名化处理；
4. 图表坐标轴、单位、百分比加总是否正确（饼图合计 100%）。

四、兜底原则

拿不准的内容，宁可删掉或改为开放式提问，也不带病上会。演示是给人看的，合规是给自己留的。

sensitive-words.md

敏感词说明（描述式词表）

本技能交付的演示文稿需通过机检。词表以类别描述呈现，不罗列具体词句原文，避免示例反被命中。

六大类风险

机检规则

• references/sensitive_scan.py --hard-only：命中即阻断交付，必须清零；
• 扫描前自动剥离代码块，避免脚本示例误伤；
• 判定为示例引用、教学讲解的边缘情况，改写为描述句式后放行。

写作规避技巧

1. 程度词降级："显著提升"→"提升 23%（示例数据）"；
2. 承诺改事实："保证见效"→"过往案例中 8/10 客户复购"；
3. 利诱改价值："转发领取"→"本页二维码可保存"。

report-template.md

交付模板：PPT 交付单

交付物清单

1. deck.pptx：可编辑演示文稿（原生形状/图表/动画）；
2. spec.json：本片的生成规格（用户可改后重新生成）；
3. 交付说明（下述模板）。

交付说明模板

【演示文稿交付】《标题》

一、规格
- 页数：N 页｜主题：business 商务蓝｜比例 16:9
- 动画：第 X/Y/Z 页逐条进入，其余整批/无
- 图表：第 X 页（柱状，示例数据）/ 第 Y 页（饼图）
- 图示：第 X 页（循环图）/ 第 Y 页（SWOT）

二、改稿指引
- 改文字：直接在 PowerPoint/WPS 中编辑文本框
- 改数据：双击图表 → 编辑 Excel 数据 → 自动刷新
- 换主题：修改 spec.json 的 theme 字段重新生成，或改形状填充色
- 加页：复制相近版式的页，保持边距与字号一致

三、演示节奏建议
- 第 X 页停 30 秒（重点主张），第 Y 页留给提问
- 动画页配合口播逐条讲，不要一次性翻完

四、合规备注
- 示例数据页：第 X 页（正式使用前替换为真实数据）
- 机检：HARD 命中 0，可对外使用

质检快查

• [ ] 全部页 3 秒测试通过
• [ ] 示例数据全部有标注
• [ ] 动画页在放映模式试播一遍
• [ ] 字体缺失设备上的替换效果可接受（雅黑→思源）

report-example.md · 端到端完整范例

需求原话：「帮我做个 8 页的季度经营汇报，给管理层看，营收涨了 34%，毛利率 41%，下季度要推三个重点项目。」

以下是直接可跑的完整 spec（python3 references/gen_pptx.py quarterly.json -o 汇报.pptx），逐页含讲者备注：

{"theme": "business", "title": "2026Q3 经营汇报",
 "slides": [
  {"layout": "cover", "title": "2026Q3 经营汇报", "kicker": "季度经营例会",
   "subtitle": "增长·效率·下一步", "author": "汇报人：经营分析组",
   "notes": "开场 1 分钟：今天讲三件事——增长从哪来、效率稳在哪、下季度投什么。"},
  {"layout": "toc", "title": "本次汇报", "items": ["一、核心业绩", "二、经营效率", "三、下季度打法"],
   "notes": "预告结构，20 秒带过。"},
  {"layout": "section", "name": "核心业绩", "number": "01",
   "notes": "转场，不停留。"},
  {"layout": "stat", "title": "本季关键指标", "subtitle": "单位：人民币",
   "stats": [{"num": "+34%", "label": "营收同比"}, {"num": "41%", "label": "毛利率"},
             {"num": "2.1x", "label": "复购率"}],
   "notes": "这页停 30 秒让老板看完数字再讲。三个数字各配一句来源。"},
  {"layout": "chart", "title": "近四季营收（示例数据）", "chart_type": "column",
   "categories": ["Q4-25", "Q1-26", "Q2-26", "Q3-26"],
   "series": [{"name": "营收（百万）", "values": [152, 168, 187, 204]}],
   "data_labels": true, "anim": {"type": "wipe", "order": "batch"},
   "notes": "强调连续四季环比增长，斜率没放缓。"},
  {"layout": "section", "name": "经营效率", "number": "02"},
  {"layout": "content", "title": "效率三件事", "subtitle": "本季完成情况",
   "bullets": ["供应链周转天数 41→35 天", "获客成本下降 18%", "人效（人均产出）+22%"],
   "anim": {"type": "fade", "order": "seq"},
   "notes": "逐条讲，每条给一个具体动作归因。"},
  {"layout": "closing", "title": "谢谢，请指正", "subtitle": "下季度打法详见附录"}
 ]
}

这个范例演示了四个最佳实践：结论性标题、示例数据显式标注、逐页讲者备注、动画只加在观点页与图表页。

gen_pptx.py · 主引擎（spec 驱动）

python3 references/gen_pptx.py spec.json -o deck.pptx     # spec → 成片（自动完成片文本机检）
python3 references/gen_pptx.py --demo -o demo.pptx        # 全能力样片（14 页，先跑这个验环境）
python3 references/gen_pptx.py spec.json --theme finance  # 覆盖主题
python3 references/gen_pptx.py spec.json --check          # 只校验 spec 不生成（发布前/CI 用）
python3 references/gen_pptx.py --verify deck.pptx         # 成片质检报告（退出码可接自动化）
python3 references/gen_pptx.py --selftest                 # 全矩阵回归：5 主题×14 页 + 4 例异常注入

spec 顶层：{"theme": "business|tech|finance|mono|edu", "title": "片名", "slides": [...]}

各版式字段速查

anim（可选，逐页）：{"type": "fade|fly_in|wipe", "order": "seq|batch", "dur": 600, "delay": 350}

notes（可选，逐页）：任意字符串 → 写入该页讲者备注（演示者视图可见，观众看不到）。每页都建议写：开场页写开场白与用时，数据页写停顿提示，结尾页写 Q&A 预案。

报错即答案：每条错误都指明第几页、什么版式、哪个字段、怎么改、示例长什么样。三类常见：

• layout「xx」不存在 → 列出全部 12 个可选版式
• values 有 N 个数，categories 有 M 个 → 数据量对不上，改齐即可
• 主题「xx」不存在 → 列出 5 套主题

成片后自动做三层收尾（交付即带证据）：

1. 重开校验：用 python-pptx 重新打开成片，页数一致才报完成；
2. 成片文本机检（默认开，--no-scan 关）：把成片里全部文本块收集起来跑完整词库（179 条），命中 HARD 直接提示跑 verify 看位置；
3. verify 质检报告：结构统计（页/形状/原生图表/图片/动画效果）+ 逐元素边界越界检查（容忍 0.05in）+ 逐条机检（页码+词+改法），HARD>0 退出码 1，可直接接自动化流水线。

selftest 回归：每次改引擎后跑 --selftest——5 套主题 × 14 页 demo 全矩阵生成并重开校验，加 4 例异常注入（坏 layout/缺字段/数据不匹配/坏主题，预期报 SpecError），当前 9/9 PASS。

gen_assets.py · 视觉资产引擎

• make_cover_bg(theme)：封面/结尾背景——深色渐变 + 金描边双框 + 金上扬折线 + 三白点（家族 VI）
• make_icon(theme, label)：品类图标（主色圆底金圈白字，1-4 字自动缩放）——image_text 版式缺图时的占位
• make_badge(text, color)：圆角徽章
• 中文字体自动探测（Noto CJK/思源/文泉驿），缺失时降级提示，不中断出片

animations.py · 动画注入引擎

• 向 <p:sld> 注入 <p:timing> 时序树：淡入(presetID 10)/飞入(2)/擦除(22)，seq 首形状 onBegin 自动起播，后续 afterEffect 链驱动
• 注入失败只警告不中断——宁可少动画，绝不产出打不开的文件
• 校验：重新打开成片，数 <p:animEffect> 节点（gen_pptx.py 自检已内置）

交付前检查（命令级）

python3 references/gen_pptx.py spec.json -o deck.pptx          # 成片 + 自检
python3 references/sensitive_scan.py deck的文案.md --hard-only  # 文案机检，HARD 清零

FAQ · 高频问题操作级答案