PPT 工坊 · 零依赖生成与体检
一个本地、离线、零依赖的 PPT 双引擎工具：
- 生成：大纲 / 纯文案 / 演讲稿 → 一键生成 16:9 商务风
.pptx（WPS、Office 都能打开编辑） - 体检：对已有
.pptx做结构体检（文字溢出 / 要点过多 / 错别字 / 广告绝对化用语 / 空页），输出报告 - 修复：错别字等问题词一键批量替换，输出新文件，原文件不动
为什么是"零依赖"
| 别的 PPT 技能 | PPT 工坊 |
|---|---|
要 pip install python-pptx |
✅ 纯 Python 标准库（zipfile+xml） |
| 只认 Windows + PowerPoint（win32com） | ✅ macOS / Linux / Windows 三平台 |
| 输出"脚本+排版建议"让你手做 | ✅ 直接出 .pptx 成品文件 |
| 只生成不检查 | ✅ 生成 + 体检 + 修复闭环 |
快速开始
# 1. 大纲 → PPT（Markdown：# 大标题 + ## 每页标题 + - 要点）
python scripts/ppt_build.py build 大纲.md -o 汇报.pptx
# 2. 换主题（minimal/sunset/ocean/forest/corporate/candy）
python scripts/ppt_build.py build 大纲.md --theme ocean -o 汇报.pptx
# 3. 先看分页方案，不落盘
python scripts/ppt_build.py build 大纲.md --dry-run
# 4. 体检已有 PPT
python scripts/ppt_check.py check 汇报.pptx -o 体检报告.html --out-md 体检报告.md
# 5. 修复错别字（typo = 内置词库；也支持自定义 '误:正'）
python scripts/ppt_check.py fix 汇报.pptx --repl typo -o 汇报_修复后.pptx
# 6. 虚构演示（不碰真实数据）
python scripts/ppt_build.py demo
python scripts/ppt_check.py demo --auto
大纲格式（怎么都行）
# 示例项目《晨光计划》季度汇报 ← 文档大标题（封面用）
## 项目背景与目标 ← 每页一个 ## = 一页
- 面向示例项目组的季度总结
- 目标是验证零依赖生成 PPT 的完整流程
## 核心指标分析
- 营收：¥128.6 万（环比 +18%） ← 含数据自动走「数据页」版式
- 新增用户：24,500（同比 +32%）
## 标题= 一页；每页- 要点最多 7 条（超了自动转两栏版式）- 纯文案（无标题）也能直接转：按空行自动分页
- 演讲稿也能转：
--input-type speech按段落分层
6 套主题
minimal 商务极简 ｜ sunset 暖橙日落 ｜ ocean 深海蓝 ｜ forest 清爽绿 ｜ corporate 深色商务 ｜ candy 糖果色
版式自动分流
封面 → 目录（内容 ≥4 页自动插入）→ 正文（普通页 / 两栏 / 数据页 / 金句页自动识别）→ 结束页
每页带页码与文档页脚。
体检报告
- 文字溢出：按 估算行数 vs 框高 几何粗估（仅提示，供人工确认）
- 要点过多：单页 >8 条
- 错别字：内置常用词库（在次→再次、登陆→登录、做为一个→作为一个…）
- 广告绝对化用语：最 / 第一 / 百分之百 / 独一无二…（宣传场景谨慎使用）
- 空页 / XML 损坏：直接标记
HTML 报告（漂亮卡片式）+ Markdown 报告双输出；退出码 0=全部通过，1=有待处理项（可接 CI）。
诚实边界（先说清）
- 生成的是结构规整的商务版式，不是 AI 设计稿——文案与数据由你（或有模型能力的主机）提供，脚本把内容自动排进规范版式；
- 体检是规则判定（词库 + 几何估算），不是语言模型语义判断——错别字词库是常用高频项，不保证全覆盖；
- 脚本全程本地，不上传、不联网、无第三方依赖。
参考资料
references/使用方法.md— 全参数速查与常见组合references/设计规范.md— 版式规则、配色、字号与间距references/OOXML手写原理.md— 零依赖生成的技术原理与文件结构references/示例数据集说明.md— 演示数据全部虚构的自证
