这个工具解决什么问题
写汇报最费时间的从来不是内容，是排版。内容往往早就在笔记软件里写好了：一级标题、几条要点，清清楚楚。可要把这份大纲变成能投出去的 PPT，就得在演示软件里一页页新建幻灯片、把标题粘上去、把要点粘进正文框、调小字号、加项目符号、再检查有没有哪页的字溢出到页面外。真正折磨人的是「一致性」——第 3 页的字号跟第 7 页不一致、第 5 页忘了加项目符号、封面标题和内容页标题的字重不统一，这些小毛病投到大屏上全都会被放大。如果汇报每周都有，这套动作每周都要重来一遍；如果只是内部过一下进度，花两小时调版式更不划算。市面上的 AI 生成工具能替你写内容，但多数要在线、要账号，还得把内部数据传上去——而这件活本来只是「把已经写好的字，按统一规矩摆到页面上」，完全不需要联网，也不需要 AI。
- 原来的做法：在演示软件里逐页新建幻灯片，把大纲里的标题和要点一条条粘进去，再逐页调字号、加项目符号、对齐文本框；换一次汇报就重来一遍，还常常出现字号不统一、要点溢出到页外。
- 用这个工具：把大纲粘进窗口，选配色和每页要点数，点「生成 PPTX」。程序按 # 标题分页、按 - 自动生成要点，超页自动续页，字号按内容量自动挑（不会溢出到页脚），另存成 .pptx 后双击就能用演示软件继续改。
- 省下来的：本机实测：7 页的示例大纲从点按钮到文件落盘 5.8 毫秒，40 页的大纲 13.1 毫秒，生成的 .pptx 分别 15.3 KB 和 61.5 KB。省下的不是生成时间，而是「逐页摆版式」这一两个小时——生成完只剩改措辞。
技术实现
这个工具没有一个第三方依赖，.pptx 是程序自己按 OOXML 规范一个字节一个字节写出来的。原因很实际：写 PPT 的库（比如 python-pptx）会连带拉进 lxml、Pillow，编译出来的 exe 从 8 MB 涨到 40 MB 以上，而且任何一次依赖升级都可能让老用户双击报错。手写 XML 的代价是要自己把 OOXML 的骨架搭对——[Content_Types].xml、_rels/.rels、presentation.xml、slideMaster、slideLayout、theme、每一页的 slide.xml 各自的 rels，一共十来种部件，任何一个部件的命名空间、元素顺序或 id 编号写错，演示软件都会弹「文件已损坏，需要修复」。所以生成逻辑是先算清页面结构，再按固定模板拼装，最后用 zipfile 以「先写临时文件、成功后再改名」的方式落盘。排版上不依赖演示软件的自动缩放：normAutofit 只在编辑时生效，打开时不一定重算，一旦溢出就压到页脚，所以字号由 _fit_size() 事先估算好。
- 手写 OOXML 包，而不是依赖 python-pptx：一个 .pptx 本质是个 zip，里面必须同时存在 [Content_Types].xml（声明每个部件的类型）、_rels/.rels（指向主文档）、ppt/presentation.xml（页序与版面尺寸）、slideMaster + slideLayout + theme（母版、版式、配色字体）、以及每页的 slideN.xml 与它自己的 rels。本工具在 outline_core.py 里把这十来种部件各自写成一个函数，组装时统统用 zipfile 以 DEFLATE 压缩写入。为了兼容国产办公套件，连纯装饰用的矩形都补了一个空的 A 段落（部分解析器对缺少 txBody 的形状会报警）。
- 页序 id 用 Office 惯例值，避免「文件已损坏」：presentation.xml 里 sldMasterId 从 2147483648 起、sldId 从 256 起，这是 Office 自己生成文件时的惯例。sldId 一旦小于 256 或重复，PowerPoint 打开时会直接判定包结构非法。同样地，theme 的 fmtScheme 里 fillStyleLst / lnStyleLst / effectStyleLst / bgFillStyleLst 的元素个数在 schema 里是写死的（3/3/3/3），少一个多一个都不行——这类约束不会在报错信息里告诉你，只能靠对规范的理解避开。
- 字号由内容量算出来，不交给自动缩放：_fit_size() 先把每条要点按「中文记 1.0 个字宽、英文数字记 0.55」估算成总字宽，再按 box 宽度算折成几行，行高取字号的 1.35 倍，加上段前距，得出这一页的总高度；从 20pt 往下一档档试，第一个能塞进可用高度 94% 的字号就是结果。这样 3 条要点的页会用 20pt，塞了 10 条长句的页会自动降到 12pt 左右，全篇不会出现「某页字特别小」或「要点压到页脚」。
- 分页规则只认三种标记，其余一律当要点：解析器只认三件事：# 开头是新的一页；- * • + 或 1. / 一、 开头是要点；行首缩进两个空格是二级要点。其余非空行一律按要点处理，宁可多一条要点，也不静默丢掉用户写的字。这套规则刻意做得「笨」——从 Word、笔记软件、微信里粘出来的文本格式千奇百怪，规则越宽松，用户越不用改格式。
- 封面副标题的判定：要区分「第一条要点」和「副标题」：解析时 _strip_bullet() 会额外返回一个「这一行有没有列表记号」的布尔值。只有不带记号的纯文字行才会被当成封面副标题；如果用户写完标题直接跟「- 要点」，那条要点不会被误吃掉——这是自测里专门覆盖的边界（早期版本就踩过，第一条要点会消失）。
- 先写 .part 再改名，失败不留半截文件：写 zip 时先写到 <文件名>.part，全部部件写完才 os.replace 成正式的 .pptx。半截的 .pptx 双击打不开，用户会以为工具坏了，而且原来那份同名文件已经被覆盖——这两种情况都很难向用户解释，所以干脆不给它发生的机会。写文件被占用（比如文件正在演示软件里开着）时抛 PermissionError，界面会提示「关掉那个文件再试一次」。
技术栈：Python 3.8+、tkinter 窗体、标准库零依赖、手写 OOXML（Office Open XML）、zipfile 打包、PyInstaller 单文件
已知局限：只处理「标题 + 要点」这一种结构，不解析表格、图片、SmartArt；封面没有配图位；色调固定三套（商务蓝 / 石墨灰 / 墨绿），不做自由配色；单次建议不超过 200 页（超过会自动截断，避免误粘整本书导致卡顿）。生成的是标准 .pptx，可以继续在 PowerPoint / WPS 里改任何文字，但本工具不做动画与切换效果。
同类软件对照
下面几款都是公开可查的同类软件，定位各不相同。这里只说明各自的定位，以及本工具在其中的位置，方便你判断哪一类更契合自己的用法。
| 软件 | 它的定位 | 本工具的定位 |
|---|---|---|
| Microsoft PowerPoint（大纲视图） | 完整的演示文稿软件，自带大纲视图，可以把大纲层级直接转成幻灯片 | 本工具不替代演示软件，只负责「把纯文本大纲先排成统一版式」，产出 .pptx 后仍在演示软件里编辑 |
| WPS 演示 | 国产办公套件的演示模块，提供模板库与大纲导入 | 本工具不做模板库，只做一种稳定的版式；不依赖任何办公软件即可生成文件 |
| Gamma | 在线 AI 演示文稿生成服务，按主题自动生成内容与版式 | 本工具不生成内容、不联网、不需要账号，内容完全由你提供，产出本地文件 |
| Marp | 用 Markdown 写幻灯片的开源工具，面向技术写作与编辑器工作流 | 本工具是窗口程序，粘文本点按钮即可，不需要编辑器插件或构建流程，输出的是 .pptx 而不是网页 |
以上仅作定位对照，各软件的可用性、授权方式与功能范围请以其官方页面为准。
操作教程
- 打开程序
解压后双击「大纲转PPT.exe」，出现一个窗口：左边是大纲编辑区，右边是页面结构预览。窗口里已经载入了一份示例大纲，可以先点「生成 PPTX」看看效果。
预期结果：窗口正常打开，右侧预览显示「共 7 页 · 22 条要点」 - 把大纲粘到左边（或点「导入大纲文件」）
在记事本、Word、笔记软件里写好大纲，整段复制，粘到左边编辑区。格式只有三条：# 开头是新的一页，- 或 1. 开头是要点，行首缩进两个空格是二级要点。也可以点「导入大纲文件」直接读 .txt / .md。
预期结果：右侧预览随输入实时刷新，每一行显示页码、页面标题、这一页有几条要点 - 选配色、定每页要点数
顶部「配色」下拉里选商务蓝 / 石墨灰 / 墨绿；「每页要点」设成 3 到 12，超过这个数量的页面会自动拆成「标题（续 2）」这样的续页。需要一页「谢谢观看」就勾上「加结束页」。
预期结果：预览里的页数随设置变化，配色名显示在预览区上方 - 选输出目录，点「生成 PPTX」
默认输出到桌面，点「选择…」可以换目录。然后点右下角「生成 PPTX」，进度条走完会弹窗告诉你生成了几页、文件多大、存在哪里。
预期结果：弹窗显示「已生成 N 页的演示文稿」和完整路径，状态栏同步显示页码数与文件大小 - 打开检查，再继续改
点「打开演示文稿」直接用系统默认程序打开；点「打开所在文件夹」定位到文件。生成的每一行文字都是普通文本框，可以在演示软件里继续改措辞、换图、加页。
预期结果：演示软件正常打开，无「需要修复」提示，标题与要点都能选中编辑
常见问题
技术实现与后续维护
工具由两部分组成：界面（tkinter）与核心（纯逻辑，不 import 任何界面库）。核心部分可以在没有窗口的环境下单独调用与测试，所以每次改动都能用 tests/selftest.py 里的 28 项断言先跑一遍——解析规则、分页、OOXML 包结构、文件名清洗、字号估算都覆盖到了。后续维护的重点在两处：一是 OOXML 部件，任何一处命名空间或元素顺序写错都会让文件打不开，改动后必须用演示软件实际打开验证；二是分页与字号估算这两个「靠经验」的算法，改规则时同步补自测用例。
技术构成：
src/outline2pptx_gui.py—— tkinter 窗体：工具条、大纲编辑区、页面结构预览、生成线程与状态反馈src/outline_core.py—— 核心逻辑：大纲解析分页、字号估算、OOXML 部件拼装、zip 落盘tests/selftest.py—— 无界面自测：28 项断言覆盖解析规则、包结构、文件名清洗与字号估算
运行环境：
运行环境：Windows 10/11 64 位。运行版是 PyInstaller 打的单文件 exe，双击即用，不需要安装 Python 或任何运行库；生成 .pptx 的过程完全在本机完成，不联网。开发环境需要 Python 3.8+（tkinter 为标准库自带），无第三方依赖。
可扩展方向：
- 增加更多配色与字号方案（改 THEMES 字典即可，一处配置全局生效）
- 支持二级/三级要点更深层级（当前两级，扩展点在 parse_outline 与 _content_xml）
- 支持在页脚加公司名、页码格式、日期（_content_xml 里加一个文本框）
- 支持套用外部 .pptx 模板（需要解析模板的 slideMaster 与 theme，工作量较大）
- 支持从 Markdown 的表格生成表格页（需要新增 table 部件）
- 支持批量：一个目录下多个 .txt 各生成一份 pptx
本工具免费提供使用，但不对外分发源码。如果你需要在本工具基础上做功能调整、对接内部系统或长期维护，可以联系我们做二次开发，源码与工程文档可在定制合作中一并交付。
需要其它功能？可以定制
这个工具只做一件事：临时要做汇报，内容都有、就是没版式：手上一份 Word 或笔记里的大纲，复制进 PowerPoint 后每页都要重新挪标题、调字号、加项目符号，20 页要磨一两个小时。如果你的场景还需要别的处理，可以联系我们做二次开发，按你的实际数据格式和流程定制。
常见的定制需求：
- 按公司 VI 配色与字体生成，页脚带部门名与保密标识
- 从 Excel 的一列标题自动批量生成多份汇报骨架
- 生成后自动套用指定模板，并加上目录页与章节过渡页
- 把生成逻辑接进内部系统，做成网页版的「一键出稿」
- 联系方式：邮箱/微信见站内「联系我们」页面，或在本文下方留言
- 定制说明：请附上你的数据样例（脱敏即可）和期望结果，方便快速评估工作量
- 交付形式：定制项目可交付可执行程序，按需一并交付源码与工程文档，支持长期维护
使用说明与免责声明
- 本工具在本地运行，不联网、不上传任何数据到服务器。
- 涉及文件改写的功能，请在使用前备份原始文件。
- 软件完全免费，可自由使用与转发，请勿用于倒卖。
- 因误操作造成的数据问题请自行承担。
