汇报 PPT 内容汇总与整合助手
概览
接收多个 PPT 文件，逐一深度分析，提出汇报逻辑顺序草案（必须等待用户确认），
再将所有 PPT 整合成一份逻辑连贯、重点突出、风格统一的总汇报 PPT。
适用于部门工作汇报、项目结题汇报、年度总结、多来源材料合并汇报等场景。
环境准备
运行前确认 python-pptx 可用（脚本与生成都依赖它）：
python -c "import pptx; print(pptx.__version__)"
若缺失，先安装到隔离环境：pip install python-pptx。
旧版 .ppt 格式不支持，需先提示用户另存为 .pptx 再处理。
本文中 scripts/... 均为相对技能根目录的路径，执行时先解析出本技能的
实际安装路径（~/.workbuddy/skills/report-ppt-integration/），再拼接运行。
五阶段工作流
阶段一：接收与解析
- 收集用户上传的全部
.pptx文件路径。 - 运行解析脚本，一次传入所有文件：
bash
python scripts/extract_ppt.py file1.pptx file2.pptx ... --output extracted.json
脚本输出结构化 JSON：每页的标题、正文要点（含层级）、表格、图片替代文本
（无替代文本则标注「图片内容无法自动识别」）、图表信息、演讲者备注。
解析失败的单个文件会在 error 字段给出原因，其余文件继续处理。
3. 向用户展示读取结果概览，例如：
「已成功读取 5 个 PPT 文件，共计 32 页幻灯片。」
若部分文件失败，如实说明失败文件与原因，并询问是否先处理可读取部分。
阶段二：单文件分析总结
为每个 PPT 生成一张「内容卡片」，汇总后一并呈现给用户。卡片字段：
- 文件名
- 页数
- 核心主题（一句话概括）
- 关键要点列表（每项一句话，依据解析出的正文与表格提炼）
- 重复出现的逻辑线索（时间线 / 流程步骤 / 问题-原因-方案 / 目标-现状-差距 / 数据对比等）
- 与其他 PPT 的关联点
卡片写法示例见 references/workflow-guide.md。此阶段忠实反映原文，不曲解原意。
阶段三：逻辑顺序建议（确认闸门）
- 基于全部内容卡片，提出「总汇报逻辑顺序草案」，包含：
- 推荐的整合顺序（如 PPT2 → PPT1 → PPT4 → PPT3）
- 每个部分在总汇报中的角色（开篇背景 / 现状分析 / 解决方案 / 案例支撑 / 下一步计划等）
- 排序理由（从宏观到落地、从问题暴露到方案闭环、按业务流程阶段等） - 用清晰的编号列表呈现草案，并明确提示：
「请您审阅这个推荐顺序，可以直接批准，也可以告诉我需要如何调整
（如调换顺序、合并某些部分、突出某些重点）。」 - 硬性规则：必须等待用户明确批准或给出修改意见后，才能进入阶段四。
用户提出调整时，更新草案后再等待确认，不得擅自生成。
阶段四：整合生成总 PPT
- 依据已确认的顺序，将各 PPT 内容归纳、合并、去重，统一术语，
提炼为简洁要点，写入整合格式规格 JSON（deck spec）。规格字段与
八种内容页类型（bullets / table / two_col / stat / quote / image /
chart / chart_table）的完整说明见references/design-system.md。 - 运行生成脚本：
bash
python scripts/generate_ppt.py --deck deck_spec.json --output 总汇报.pptx
脚本自动生成：封面 → 目录 → 各章节过渡页 → 核心内容页 → 总结与下一步 → 感谢页，
统一采用商务配色与版式（深藏青主色 + 金色强调，微软雅黑，16:9）。
chart（柱状/饼图）与 chart_table（图表+表格组合）用于数据可视化展示，
图表数值支持字符串格式（如 "180万"），脚本自动转换为数值。
3. 将生成的 .pptx 保存到工作区，用文件呈现工具提供给用户下载。
关键数据与结论必须与原文件一致，不得改写数值。
4. 若环境确实无法运行生成脚本，改为向用户输出完整的 PPT 结构大纲与
每页具体文本内容（格式见 references/workflow-guide.md 的备用大纲模板），
并说明原因。
阶段五：后期微调
生成后主动提示用户：「如果您需要对某些页面进行修改，比如调整标题、增加内容
或改变顺序，请直接告诉我，我会及时更新文档。」
用户提出修改时：更新 deck spec 中的对应幻灯片 → 重新运行生成脚本 → 再次交付。
交互与限制
- 步骤确认：阶段三的草案未经用户明确批准，禁止进入阶段四。任何顺序调整后同样需再确认。
- 信息保真：分析阶段忠实反映各 PPT 内容；整合阶段可合理归纳合并，但关键数据与结论必须与原文件一致。
- 安全与隐私：仅处理用户上传的文件内容，不将数据用于任何其他目的。
- 错误处理：文件损坏、格式不支持、内容读取失败时，清晰告知用户具体问题，并尽可能处理可读取部分。
- 分批处理：文件过多导致一次处理受限时，主动建议分批处理，获得用户同意后执行。
资源
scripts/extract_ppt.py— 多 PPTX 内容解析（标题/要点/表格/图片 alt text/备注 → JSON）scripts/generate_ppt.py— 按 deck spec 生成风格统一的总汇报 PPT（8 种内容页类型，含柱状/饼图图表）references/workflow-guide.md— 内容卡片模板、逻辑线索识别框架、排序理由写法、备用大纲模板references/design-system.md— 设计规范与 deck spec 字段说明（八种内容页类型的 JSON 示例）
