slidespeak-editor

SlideSpeak Presentation Editor

编辑现有的 PowerPoint 文件，通过替换指定形状（shape）的内容来实现批量修改和个性化定制。

API 文档: https://docs.slidespeak.co/basics/api-references/edit-presentation/

API 规范摘要

端点

POST https://api.slidespeak.co/api/v1/presentation/edit

请求格式

• Content-Type: multipart/form-data
• Headers: X-API-Key: YOUR_API_KEY

必需参数

1. pptx_file (file): 要编辑的 PowerPoint 文件
2. config (json): 包含替换配置的 JSON 对象

Config 结构

{
  "replacements": [
    {
      "shape_name": "TARGET_SHAPE_NAME",
      "content": "新内容"
    }
  ]
}

响应格式

{
  "url": "https://slidespeak-pptx-writer.s3.amazonaws.com/xxx.pptx"
}

使用场景

1. 批量个性化生成

• 模板化 PPT 批量生成（如销售提案、客户报告）
• 替换客户名称、数据、徽标等

2. 内容更新

• 更新现有 PPT 的特定部分
• 修改标题、副标题、正文内容

3. 多语言版本生成

• 基于一个模板生成不同语言版本
• 保持布局和设计不变

4. 数据驱动的报告

• 从数据库读取数据填充到 PPT 模板
• 自动生成周期性报告

使用流程

步骤 1: 准备模板 PPT

在 PowerPoint 中为需要替换的形状命名：

1. 选择形状（文本框、标题等）
2. 右键 → "选择窗格"（Selection Pane）
3. 重命名形状为有意义的名称（如 TARGET_TITLE、TARGET_SUBTITLE、CLIENT_NAME 等）

命名建议：

• 使用清晰的前缀：TARGET_, DATA_, CLIENT_
• 使用描述性名称：TITLE, SUBTITLE, CONTENT, DATE
• 避免使用特殊字符和空格

步骤 2: 识别需要替换的形状

在使用 skill 之前，需要知道模板中的 shape 名称。可以：

1. 手动在 PowerPoint 中查看（选择窗格）
2. 使用 Python 脚本提取（见 helper scripts）
3. 与模板创建者确认约定的命名规范

步骤 3: 准备替换内容

根据业务需求准备替换内容：

replacements = [
    {
        "shape_name": "CLIENT_NAME",
        "content": "ABC公司"
    },
    {
        "shape_name": "REPORT_DATE",
        "content": "2024年第四季度"
    },
    {
        "shape_name": "KEY_METRIC_1",
        "content": "销售额: ¥1,234,567"
    },
    {
        "shape_name": "SUMMARY_TEXT",
        "content": "本季度业绩表现优异，同比增长35%。主要驱动因素包括：新产品线推出、市场份额扩大、客户满意度提升。"
    }
]

步骤 4: 调用编辑工具

使用 slidespeak_edit 工具：

slidespeak_edit(
    pptx_file_path="/path/to/template.pptx",  # 模板文件路径
    config={
        "replacements": [
            {
                "shape_name": "CLIENT_NAME",
                "content": "ABC公司"
            },
            {
                "shape_name": "REPORT_TITLE",
                "content": "2024 Q4 业绩报告"
            },
            # ... 更多替换
        ]
    },
    save_dir="./outputs/edited_ppt"  # 保存目录
)