PPT 生成与编辑

目的

为 AI 智能体提供一个可复用的 Python 技能，用于：

• 基于结构化输入创建 PPT 文件。
• 通过文本/图像替换更新已有 PPT 文件。
• 在图像替换过程中保持图像布局稳定（位置与尺寸不变）。

输入

create_ppt

• title：演示文稿标题。
• slides：幻灯片对象数组：
  • title：幻灯片标题。
  • content：字符串或段落列表。
  • image_prompt（可选）：用于图像生成的提示词。

update_ppt

• ppt_path：源 .pptx 文件路径。
• replace_rules：
  • text_replace：文本替换字典。
  • image_replace：图像替换策略字典。

输出

create_ppt

• 返回生成的 .pptx 文件路径。

update_ppt

• 返回：
  • new_ppt_path：新的 .pptx 输出路径。
  • replace_log：按幻灯片分组的替换详情。

模块结构

• main.py：面向智能体调用的外部 API 及示例入口。
• ppt_generator.py：PPT 创建逻辑。
• ppt_editor.py：PPT 文本/图像替换逻辑。
• image_service.py：图像生成抽象层（含 mock 实现及扩展接入点）。
• utils.py：日志记录与路径处理辅助函数。

使用方法

from ppt_skill.main import create_ppt, update_ppt

slides = [
    {
        "title": "Brazil Overview",
        "content": ["Brazil is the largest country in South America."],
        "image_prompt": "Brazil skyline and national flag",
    }
]

ppt_path = create_ppt(title="Brazil Briefing", slides=slides)

result = update_ppt(
    ppt_path=ppt_path,
    replace_rules={
        "text_replace": {"Brazil": "Chile"},
        "image_replace": {"__all__": {"prompt": "Chile skyline and national flag"}},
    },
)
print(result["new_ppt_path"])

注意事项

• 当前 generate_image() 默认使用 mock 后端。
• DALL·E 和 Stable Diffusion 的集成点已预留，标记为 TODO。
• 请保持 API 字段稳定，以保障下游智能体的兼容性。