# 编辑演示文稿
## 基于模板的工作流
当使用现有演示文稿作为模板时:
1. **分析现有幻灯片**:
bash
python scripts/thumbnail.py template.pptx
python -m markitdown template.pptx
查看 `thumbnails.jpg` 以了解布局,查看 markitdown 输出以查看占位符文本。
2. **规划幻灯片映射**:对于每个内容部分,选择一个模板幻灯片。
⚠️ **使用多样的布局** — 单调的演示文稿是常见的失败模式。不要默认使用基本的标题+项目符号幻灯片。积极寻找:
- 多列布局(2列、3列)
- 图像+文本组合
- 全出血图像配文本覆盖
- 引用或标注幻灯片
- 章节分隔符
- 统计/数字标注
- 图标网格或图标+文本行
**避免:** 在每张幻灯片上重复使用相同的文本密集型布局。
将内容类型与布局风格匹配(例如,关键点 → 项目符号幻灯片,团队信息 → 多列,推荐语 → 引用幻灯片)。
3. **解包**:`python scripts/office/unpack.py template.pptx unpacked/`
4. **构建演示文稿**(自己完成,不要使用子智能体):
- 删除不需要的幻灯片(从 `
` 中移除)
- 复制想要重用的幻灯片 (`add_slide.py`)
- 在 `
` 中重新排序幻灯片
- **在第 5 步之前完成所有结构更改**
5. **编辑内容**:更新每个 `slide{N}.xml` 中的文本。
**如果可用,在此处使用子智能体** — 幻灯片是独立的 XML 文件,因此子智能体可以并行编辑。
6. **清理**:`python scripts/clean.py unpacked/`
7. **打包**:`python scripts/office/pack.py unpacked/ output.pptx --original template.pptx`
---
## 脚本
| 脚本 | 用途 |
|--------|---------|
| `unpack.py` | 提取并格式化 PPTX |
| `add_slide.py` | 复制幻灯片或从布局创建 |
| `clean.py` | 移除孤立文件 |
| `pack.py` | 带验证的重新打包 |
| `thumbnail.py` | 创建幻灯片视觉网格 |
### unpack.py
bash
python scripts/office/unpack.py input.pptx unpacked/
提取 PPTX,格式化 XML,转义智能引号。
### add_slide.py
bash
python scripts/add_slide.py unpacked/ slide2.xml # 复制幻灯片
python scripts/add_slide.py unpacked/ slideLayout2.xml # 从布局创建
打印 `
` 以添加到所需位置的 `
` 中。
### clean.py
bash
python scripts/clean.py unpacked/
移除不在 `
` 中的幻灯片、未引用的媒体、孤立的关联关系。
### pack.py
bash
python scripts/office/pack.py