PPTX批量格式化修复

PPT/PPTX 批量格式化修复工具，涵盖两大核心能力：(1) 字号统一修复 — 全片扫描文字字号，低于阈值的统一调至16pt（可配置），自动启用换行防止溢出，修正超出版面边界的形状；(2) 页码批量删除 — 多格式页码检测与删除（X/Y、纯数字、幻灯片编号占位符），不误删章节标记。 触发场景：修改PPT字号/调整字体大小/确保不低于16号字；删除页码/去页码/去掉页数；批量PPT格式化/修复PPT排版。 触发词：字号修复、调整字号、不低于16号字、字体太小、删除页码、去页码、PPT批量处理、修复PPT。

PPTX 批量格式化修复技能

功能概览

功能	脚本	说明
字号统一修复	scripts/fix_fonts.py	扫描全片，<阈值的 run 调至目标字号，启用 word_wrap，修正边界溢出
页码格式检测	scripts/detect_pagenum.py	扫描 X/Y、纯数字、幻灯片编号占位符三种页码
页码批量删除	scripts/remove_pagenum.py	三步清理：X/Y 格式 → 布局占位符 → 右下角纯数字

核心原则

1. 只改格式，不动内容 — run.font.size 修改，run.text 绝不触碰
2. 非破坏性操作 — 始终先输出到工作区，确认后再覆盖原文件
3. 阈值保持层级差异 — 仅调整低于阈值的字号，原本更大的保持不动
4. 不误删页码 — 章节标记（如"01""02"）≠ 页码，位置+格式双重判断

Python 环境

C:/Users/admin/.workbuddy/binaries/python/envs/default/Scripts/python.exe

已预装 python-pptx。若缺失，执行：

/c/Users/admin/.workbuddy/binaries/python/versions/3.13.12/python.exe -m pip install --target /c/Users/admin/WorkBuddy/{session}/.packages python-pptx

---

工作流一：字号修复

Step 1 — 确认需求

询问用户：

• 目标字号（默认 16pt）
• 涉及文件路径
• 是否需要同时检测页码

Step 2 — 执行修复

C:/Users/admin/.workbuddy/binaries/python/envs/default/Scripts/python.exe \
  scripts/fix_fonts.py <输入pptx> <输出pptx> [--min-size 16]

脚本自动完成：

• run.font.size < Pt(min_size) → 设为 Pt(min_size)
• 启用 text_frame.word_wrap = True
• 修正超出幻灯片边界的形状（宽度/高度约束）

Step 3 — 验证

修复后逐页校验：

1. 所有 run.font.size ≥ Pt(min_size)
2. 所有形状 left + width <= slide_width 且 top + height <= slide_height

验证通过后覆盖桌面原文件。

注意事项

• 文本框架的 auto_size 在修复后可能失效，因 PPT 渲染引擎会重新计算
• 若部分文本框在修复后文字被截断，需手动微调（约 5% 概率）
• 含有大量嵌入表格的幻灯片，字号修复需单独处理表格单元格

---

工作流二：页码删除

Step 1 — 检测页码

C:/Users/admin/.workbuddy/binaries/python/envs/default/Scripts/python.exe \
  scripts/detect_pagenum.py <pptx路径>

输出：页码格式、所在页面、形状名称、位置坐标、布局占位符信息。

Step 2 — 执行删除

C:/Users/admin/.workbuddy/binaries/python/envs/default/Scripts/python.exe \
  scripts/remove_pagenum.py <输入pptx> <输出pptx>

安全策略：先输出到工作区，确认无误后覆盖。

页码格式与判断规则

格式	示例	判断条件	处理方式
X/Y	1/100, 2/100	正则 ^\d{1,3}\s*/\s*\d{1,4}$	删除形状
纯数字（右下角）	1, 2	left > W*0.55 且 top > H*0.70	删除形状
幻灯片编号占位符	母版/布局中的 SLIDE_NUMBER	placeholder_format.type == 13	从布局中删除

不删除的情况：

• 章节编号（通常位于左上角或内容区，非右下角）
• 内容中的数字（如"2026年""第3章"）
• 非纯数字的文本（如"Page 1"）

---

批量处理

当用户提供多个文件时：

1. 逐个执行修复/删除脚本
2. 全部完成后汇总结果
3. 提示用户确认，再统一覆盖

错误处理

错误	处理
文件被占用 (PermissionError)	提示关闭 PowerPoint/WPS，换临时路径输出
未检测到页码	用 detect_pagenum.py 全面扫描；或请用户截图说明页码样式
python-pptx 缺失	按上方 Python 环境说明安装
字号修复后文字溢出	微调对应文本框宽度，或提示用户手动调整