PPT-diff — PPT 修改前后对比工具

对比两版 PPT（.pptx），自动标出所有差异。提供三种模式：生成带彩色标记的 PPT 直接查看修改位置、在 PowerPoint 里逐条弹窗审阅接受/拒绝、输出 HTML 报告存档或分享。

三种工作模式

模式	命令	适用场景
A：生成标记版 PPT	pptx_annotator.py	快速预览所有修改位置，把标注文件发给别人看
B：交互式逐条审阅	ppt_review.py	逐条在 PPT 里弹窗对比旧/新内容，点 [是/否] 接受或拒绝，最终生成定稿
C：HTML 差异报告	main.py	输出网页版左右对照报告，适合存档或发给不看 PPT 的人

模式 A：生成带标记的 PPT

python scripts/pptx_annotator.py 旧版.pptx 新版.pptx

输出 *_annotated.pptx，在原 PPT 上叠加彩色虚线框/残影标记，不改原布局。

模式 B：逐条审阅修订

python scripts/ppt_review.py 旧版.pptx 新版.pptx

自动打开 PowerPoint → 跳到第 1 处修改位置 → 弹出对话框对比旧/新内容 → 点 [是] 接受 / [否] 拒绝 → 自动跳到下一处 → 全部审阅完保存为 *_accepted.pptx

模式 C：HTML 差异报告

python scripts/main.py 旧版.pptx 新版.pptx

输出网页报告（ppt_diff_report.html），左右对照逐页文本差异，支持按状态筛选。

标记说明

标记	含义
🟡 顶部琥珀色横幅	本页有几处变更
🔴 红色虚线框 + 红点	文字被修改
🟢 绿色虚线框 + 绿点	文字新增
🟣 紫色虚线框 + 紫点	文字被移动
🔴 粉色块 + 红字（原位）	文字被删除（残影保留）
🟣 紫色横幅	整页移动
🟢 绿色横幅	整页新增
🔴 红色横幅	整页删除

依赖

pip install python-pptx pywin32

原理

1. 内容对齐：按文本相似度匹配两版对应页面
2. 形状匹配：先按位置匹配，再按文本内容二次匹配（移动不误报）
3. 视觉标记：在原位加虚线框/残影/圆点，不改变原布局