ppt — 代码生成专业 PPT

代码画 PPT，不拖模板：可复跑（改数据重跑脚本）、可进 git、坐标精确到 0.01 英寸；无所见即所得，靠 Step 4 渲染核查兜底。

Step 1 · 取材与文案（禁止编造）

先答受众三问再动笔：给谁看（外行 / 内行 / 客户）？观众对项目已知道什么？看完要能复述哪三句话？答案写在文案稿头部，之后所有取舍用它裁决。

素材只取项目真实资料（README / CLAUDE.md / docs / 数据后台，按类型选源）。没有出处的数字不进 PPT；观众不需要的事实不进正文——内部指标（函数数、API 常数、内部代号）默认出局，受众是内行才留。

挖内容，不摘名词：光收数字和功能名不算取材。按 PPT 类型挖，技术/产品：设计决策 + 效果对比；作品集：作品细节与取舍；数据报告：口径与基线；叙事品牌：人物、场景、转折。

大纲先于逐页：挖完先写叙事大纲——一条主线（整份 PPT 只论证一件事）+ 开篇三答（是什么 / 给谁 / 解决什么）+ 每页在论证链里的角色（承接上页什么、铺垫下页什么）。概念先解释后使用，禁前向引用；连续两页互不承接 = 重排。逐页文案稿（标题 + 要点 + 口播稿；口播稿生成时进 notes() 演讲者备注，是介绍成片工作流的文案源与现场讲稿）挂在大纲下写，标题要参与递进，不是各自成立的口号。

两遍成稿：第一遍写足——完整叙述体，假设观众零基础，把是什么、给谁、解决什么讲透，允许长；第二遍才打磨——先 humanizer 去味、再按下面四条修剪。humanizer 是打磨器不是初稿模板，初稿就按它的标准写只会又瘦又跳、没讲清楚就开喊口号。

1. 不许空转：要点带细节（功能带设计理由或效果、数据带口径），裸名词陈列删掉
2. 数字带语境：数值 + 口径 + 构成或对比，且是观众在乎的数字；挖不到语境的数字不当主视觉
3. 每页 ≥3 件可溯源的具体事实；遮住排版只读文字，是在『讲』不是『列清单』
4. 槽位规则：大字槽（封面主标题 / 尾页大字 / 章节名）只放主张句或身份句（有观点、念出来像口号）；域名、版本号、日期、统计数字一律退副题 / 元信息位

风格黑话零容忍，分两层：商业八股（赋能 / 闭环 / 沉淀 / 矩阵 / 生态 / 一站式 / 端到端）直接删；技术行话（API 常数 / 内部函数名 / 体系代号 / 实现细节）按受众过滤，外行 PPT 要么删要么当页用人话解释。数字优先于形容词；标题写观点不写名词短语；破折号中英双禁。重要项目文案稿先给用户过目再排版。

Step 2 · 设计系统（写代码前定案，全程不改）

Step 3 · 生成

1. pip install python-pptx -i https://pypi.tuna.tsinghua.edu.cn/simple（首次）
2. 复制 templates/primitives.py + animate.py 到目标项目 scripts/，写 gen-<name>-deck.py
3. 坐标用表达式算（如 Inches(0.55 + i * 3.13)），不写魔法数；塞文本前 check_fit() 预检，[FIT-WARN] 即拆行 / 拆页

动画（可选；Windows + MS Office + pywin32）。默认 auto_deck() 全代劳（封面级联 / 卡片 float_up / 数字 zoom / 链路 wipe / 表格行 0.06s 快级联 / 章节序号 wipe up），手动只做微调：

anim = Anim(prs)
anim.auto_deck()                       # 全份 PPT 自动编排
anim.fx(footer, 'fade', dur=0.4)       # 特殊元素补一枪
anim.chart(gf, 'series')               # 原生图表按系列擦入
P.set_transition(prs, 'fade')          # 统一转场（morph 页自动跳过）
P.auto_show(prs)                       # 口播稿估时自动换页：整份 PPT 自动播完，录屏即粗片
prs.save('deck.pptx')
anim.apply('deck.pptx')                # 必须在 save 后；COM 写入 + 读回自验证
# 微调：anim.stagger(P.shape_groups(s, 'card'), 'float_up', step=0.12)
# 增长叙事（morph 真补间，占连续两页，auto 自动跳过；生效验证 EntryEffect==3954；2019+，WPS 降级 fade）：
P.growth_chart(prs, 6, 'Growth', '标题', cats, vals, highlight=2)   # 柱/条
P.growth_line(prs, 8, 'Trend', '标题', cats, vals, highlight=5)     # 折线
P.growth_donut(prs, 10, 'Mix', '标题', cats, vals)                  # 占比环

效果词表（COM 实测）：fade / wipe / appear / float_up / float_down / zoom / grow_turn / ease_in / split / wheel / stretch；90 年代花活不收。节奏 > 花活：时长 0.40.6s、级联间隔 0.10.2s、一页 ≤2 种效果、页面固定装饰（顶部短杠 / 页码 / 底线）不进动画；数据图表一律 growth_*，原生 chart 仅交付后要在 PowerPoint 改数据时用。

改现有 pptx（脚本改，禁手改，save 到新文件名）：P.deck_replace(prs, {'旧名': '新名'}) 全文替换（含备注）；P.deck_recolor(prs, dict(zip(P.THEMES['warm'].values(), P.THEMES['tech'].values()))) 整份 PPT 换主题。

页面范式（字典非 checklist：按 Step 1 叙事大纲选范式，不为凑范式造内容；同一范式重复用没关系，一份 PPT 集邮式 9 种范式各来一次是能力巡展不是叙事；密度靠 Step 1 喂饱，不靠范式本身）：

Step 4 · 渲染核查（必做，不可跳）

三级管线，自动化优先，人工只看终稿：

① 程序初筛：Office COM 转 PDF（Presentations.Open 后 SaveAs("<输出>.pdf", 32)）→ python <本skill>/templates/verify.py <输出>.pdf。查页级溢出、占位符、对比度 WCAG（≥72pt 装饰大字豁免）；退出码 1 = 有问题，改脚本重跑。

② 视觉盲看：pymupdf 渲 PNG（fitz + get_pixmap(dpi=100)）→ 交无生成上下文的子代理两问：其一逐页查四项（溢出 / 乱码 / 对齐 / 对比度）；其二观众复述测试——只给它前 1/3 页，问「这是什么、给谁用、解决什么问题」，答不出 = Step 1 受众或开篇没做对，打回重写文案再生成。盲看提示里不要预设豁免（不说『这是故意的』）：被页缘裁切的元素、超大低对比装饰字这类可疑形态，同样交新鲜眼光当疑点报。发现问题改脚本重跑，禁手改 pptx。

视觉核查使用实际图片的绝对路径，复查核对当前版本或哈希；遇到具体工具的路径限制时再选兼容路径，不固定要求复制目录。

③ 用户终审：前两级清零机械问题后，用户只看成稿。

Step 5 · 交付

报告：页数 + 页面清单 / 文件路径与大小 / 三级核查结论 / 口播稿页数 / 自动放映总时长 / 生成脚本位置（可复跑）。git 仓库内提交脚本（pptx 产物不进 git）。

边界与坑

• 无 MS Office → Step 4 降级 LibreOffice soffice --convert-to pdf；两者都无 → 明确报告「未做视觉核查」
• GBK 控制台：print 禁用非 ASCII 字符，用 OK
• pptx 原生表格列宽失控 → 一律自绘表格行（box + text 逐行拼）
• 中文缺字形 → run 级设雅黑（primitives 已处理）
• shape_id 每页独立编号不唯一，animate.py 已按 XML 树定位，二次开发勿全局搜 id；pywin32：pip install pywin32 -i https://pypi.tuna.tsinghua.edu.cn/simple
• docx / xlsx 可复用 primitives 思路，但页面范式表仅适用 pptx

当前工作流与归档

content-director 负责受众、材料出处和叙事草案，PPT 保留可编辑幻灯片的交付目标。设计确认后再生成；视频静帧规则不套到 PPT。生成脚本、输入数据、必要素材及其哈希随 recipe 保留，交付清单声明 PPT/PDF/封面；归档恢复校验前不清场。视觉核查与用户终审分别报告。