PPTX 技能
快速参考
| 任务 | 指引 |
|---|---|
| 读取/分析内容 | python -m markitdown presentation.pptx |
| 在现有模板上编辑 | 先读 editing.md |
| 从零创建新稿 | 先读 pptxgenjs.md |
读取内容
# 文本抽取
python -m markitdown presentation.pptx
# 幻灯片缩略图总览
python scripts/thumbnail.py presentation.pptx
# 原始 XML
python scripts/office/unpack.py presentation.pptx unpacked/
编辑工作流
完整细节在 editing.md。默认执行顺序：
- 用
thumbnail.py先理解模板结构与视觉密度 unpack -> 调整页面结构/对象 -> 内容替换 -> clean -> pack- 出图后做人眼 QA，再回改
从零创建
完整约束在 pptxgenjs.md。
没有模板且用户要全新设计时，按该文档执行。
设计原则（必须避免“流水线 AI 幻灯片”）
开始前
- 先选“有主题感”的配色，不要默认蓝白模板
- 视觉权重遵循 60/30/10（主色/辅色/强调）
- 统一视觉母题（例如圆角卡片、图标圆章、单侧粗边）并贯穿全稿
版式与信息组织
每页至少有一个视觉锚点（图、图标、图表、几何块），不要纯文字页。
常用结构：
- 左文右图双栏
- 图标 + 标题 + 描述条目
- 2x2/2x3 卡片网格
- 半屏大图 + 信息覆盖
数据展示建议：
- 大数字 KPI（60-72pt）
- 对比列（before/after、方案 A/B）
- 时间线或流程箭头
排版与间距
- 标题 36-44pt，正文 14-16pt，说明 10-12pt
- 最小页边距 0.5"
- 区块间距统一 0.3"-0.5"
常见反模式（禁止）
- 每页都同一版式
- 正文居中排（正文与列表应左对齐）
- 字号层级不明显
- 低对比文本或低对比图标
- 只做“标题 + 子弹点”
- 用标题下划线装饰（典型 AI 痕迹）
QA（强制步骤）
默认假设首版一定有问题，目标是“找 bug”，不是“证明没问题”。
内容 QA
python -m markitdown output.pptx
检查：
- 内容缺失、错别字、顺序错误
- 模板残留占位词（如
xxxx、lorem ipsum）
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"
视觉 QA（建议用子代理或独立视角）
先转图片再审：
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide
重点检查：
- 重叠、穿插、截断
- 过密间距与对齐漂移
- 边缘安全距离不足（< 0.5"）
- 低对比可读性
- 占位文本残留
验证循环
- 生成 -> 出图 -> 检查
- 列问题清单
- 修复
- 对受影响页面复检
- 至少完成一轮“修复 + 回归”后再宣布完成
转图片
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide
只重渲某一页：
pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed
依赖
pip install "markitdown[pptx]"：文本抽取pip install Pillow：缩略图工具npm install -g pptxgenjs：从零生成- LibreOffice：通过
scripts/office/soffice.py做 PDF 转换 - Poppler：
pdftoppm导出图片