MarcelLeon PPTX 创建、编辑与分析
.pptx/.potx 是包含 OOXML 的 ZIP 包。按任务选择：
| 任务 | 方法 |
|---|---|
| 新建演示稿 | 使用 pptxgenjs |
| 修改现有稿或模板 | 解包 → 调整结构 → 编辑 XML → 清理 → 压缩 |
| 读取内容 | markitdown deck.pptx |
| 观察全稿结构 | python scripts/thumbnail.py deck.pptx deck-thumbs |
脚本路径均相对于本 Skill 目录。
中文任务 few-shot
输入：“把这份 Data Agent 技术方案做成 12 页中文汇报，用公司模板，老板 10 分钟能讲完。”
**执行：**先提炼一条可讲述主线，再用缩略图选择不同模板布局；控制每页一个判断，保留公司母版，补讲稿备注，最后做内容、视觉和文件结构三轮检查。
输入：“roadmap.pptx 太密了，帮我重排但不要改事实。”
**执行：**先抽取文字和缩略图，建立事实清单；只重组层级和布局，不替换数据；输出前逐页渲染并核对原始事实。
可用脚本
| 脚本 | 用途 |
|---|---|
scripts/thumbnail.py deck.pptx prefix |
生成带页码的全稿缩略图网格 |
scripts/add_slide.py unpacked/ slide2.xml --after slideN.xml |
正确复制页面或 layout，并登记所有关系 |
scripts/clean.py unpacked/ |
在页面列表确定后清理孤立页面、媒体和关系 |
scripts/office/validate.py deck.pptx --original src.pptx |
校验 schema、关系、content type、图表和页面 |
scripts/office/soffice.py --headless --convert-to pdf deck.pptx |
在沙箱环境稳定调用 LibreOffice |
从零创建
pptxgenjs 通常已预装。先直接 require("pptxgenjs")，只有导入失败才安装。
高风险规则：
- 添加页面前先设置
pres.layout。LAYOUT_16x9是 10 × 5.625 英寸，LAYOUT_WIDE是 13.333 × 7.5 英寸。 - 颜色只写 6 位十六进制且不带
#；透明度使用对应属性，不写 8 位颜色。 - 不复用会被 pptxgenjs 原地修改的 options/shadow 对象。
- 阴影
offset >= 0；向上投影使用正 offset 配合angle: 270。 - 文本对齐敏感时显式设置
margin: 0。 - 列表使用
bullet: true，不要手写•。 - 每个输出文件使用独立的
new pptxgen()实例。 - 讲稿备注使用
slide.addNotes()，不要放成页面文本框。 - PowerPoint 有原生图表时使用
addChart()；只有原生不支持的 Sankey、网络图等才转图片。 - stacked chart 的
dataLabelPosition只能用ctr、inEnd、inBase；错误配置会损坏文件。 - 组合图使用次坐标轴时，必须同时声明两组
valAxes和catAxes。 - 每次
writeFile()后立即运行validate.py，从生成脚本修问题，不手改打包后的 XML。
编辑现有演示稿
先生成缩略图并传入专属前缀，避免不同演示稿互相覆盖：
python scripts/thumbnail.py template.pptx template-thumbs
python -m markitdown template.pptx
结构编辑工作流：
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
find unpacked -type l -delete
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml
# 在 ppt/presentation.xml 的 <p:sldIdLst> 调整顺序或删除页面
python scripts/clean.py unpacked/
# 编辑 ppt/slides/slideN.xml
(cd unpacked && rm -f ../output.pptx && zip -Xr ../output.pptx .)
python scripts/office/validate.py output.pptx --original deck.pptx
顺序必须是：先新增/删除/排序，再改页面内容。add_slide.py 会复制源页，若先编辑再复制，会意外克隆已改内容。
不要手工复制 slideN.xml。一个页面还涉及 presentation、rels、content type、notes 和媒体关系。
修改模板时：
- 模板槽位多于真实内容时，删除整个对象组，不只清空文字。
- 每个列表项使用独立
<a:p>。 - 替换文本时修改已有 run 的文本，避免
text_frame.text = ...抹掉格式。 - 中文文本前后有空格时使用
xml:space="preserve"。 - 复用模板图标优先复制已有页面或 layout，不重新截图成低清位图。
中文汇报设计
先确定受众、会议时长和单一结论，再设计页面。
- 中文管理汇报优先“结论式标题”，标题直接表达本页判断，不写“项目背景”这类空标签。
- 一页只承担一个主要认知任务；长句拆为短段，正文避免字号过小。
- 公司模板、品牌色和既有版式优先，不以“设计感”为由破坏统一规范。
- 数据页优先原生图表和大数字；流程页用真正有方向的流程，不用无意义 01/02/03 装饰。
- 中文字体必须检查目标机器可用性；不要依赖只在本机安装的字体。
- 视觉母题只选一个，避免卡片、渐变、发光、玻璃效果同时堆叠。
避免常见 AI 幻灯片
- 每页都是“标题 + 三个圆角卡片”。
- 白底紫色渐变、随机装饰圆和无信息价值图标。
- 每页相同版式。
- 过度居中正文。
- 把 markdown、代码围栏或项目符号原样贴进页面。
- 为了填满版面编造数据或口号。
内容与视觉 QA
内容检查：
python -m markitdown output.pptx
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|placeholder"
python scripts/office/validate.py output.pptx
视觉检查：
rm -f slide-*.jpg
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide
ls -1 "$PWD"/slide-*.jpg
逐页检查：
- 文本重叠、裁切和溢出。
- 中文字体替换导致的换行变化。
- 图表标签、单位、图例和数据范围。
- 页面边缘安全距离。
- 模板占位文本、虚构数据和无来源断言。
- 内容主线是否能在用户指定时长内讲完。
修复后必须重新生成 PDF 和全部页面图片，不能只看旧截图。
依赖
pptxgenjs · markitdown[pptx] · Pillow · defusedxml · lxml · LibreOffice · Poppler