Menu
从文稿内容生成专业 PPTX 演示文稿，支持用户提供的模板/参考图风格提取、AI 配图（siliconflow-img-gen）和素材图库（pexels/pixabay）。纯 Python 生成，无需 Google/ChatGPT API。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
软件著作权登记全流程：从代码仓/目录生成程序鉴别材料（源程序文档）、 软件操作手册、申请填报信息 Markdown，并可辅助在线填报。 当用户需要申请软件著作权、生成软著材料时触发。
维护 business-developer 的 SQLite 追踪数据库，记录已探索的创作者（模式一）和已互动的帖子（模式二），避免重复追踪和重复互动。
通过自媒体平台搜索内容，在评论区以留言/回复/私信等方式拓展潜在客户或进行品牌宣传。用于 HEARTBEAT 定时任务。
维护 business-developer 的 SQLite 情报采集数据库，记录已采集的信息内容，避免重复采集，支持按日查询已采集情报。
定时监控特定信源（自媒体账号/网页），按预设标准提取商业情报，生成简报或报告。用于 cron 定时任务。
通过自媒体平台按搜集策略探索潜在客户——策略 A 分析帖子发布者画像，策略 B 从评论区挖掘潜客。用于 HEARTBEAT 定时任务。
| name | ppt-maker |
| description | 从文稿内容生成专业 PPTX 演示文稿，支持用户提供的模板/参考图风格提取、AI 配图（siliconflow-img-gen）和素材图库（pexels/pixabay）。纯 Python 生成，无需 Google/ChatGPT API。 |
| metadata | {"openclaw":{"emoji":"📊","requires":{"bins":["python3"]},"primaryEnv":"SILICONFLOW_API_KEY"}} |
从文稿内容生成专业 .pptx 演示文稿。支持：
siliconflow-img-gen 生成封面及内容页配图（替换 Google/ChatGPT API）pip install python-pptx pillow
本脚本依赖 python-pptx；建议安装 pillow 以便生成时保持图片比例。若 python-pptx 未安装，脚本会提示安装命令。
用户提供文稿 + 可选模板
│
▼
┌───────────────────┐
│ Step 1: 风格分析 │ ← 若有模板 PPTX：运行 extract 命令提取主题
│ │ ← 若有参考截图：LLM 分析配色/布局
│ │ ← 若无模板：使用默认主题或与用户确认风格
└────────┬──────────┘
│
▼
┌───────────────────┐
│ Step 2: 大纲生成 │ ← LLM 分析文稿结构，规划每页内容与布局
│ │ ← 确定哪些页面需要配图
└────────┬──────────┘
│
▼
┌───────────────────┐
│ Step 3: 配图准备 │ ← AI 图：siliconflow-img-gen（16:9 封面/内容插图）
│ │ ← 素材图：pexels-footage / pixabay-footage（可选）
│ │ ← 用户图：直接引用用户提供的图片路径
└────────┬──────────┘
│
▼
┌───────────────────┐
│ Step 4: PPTX 生成 │ ← 组装 JSON 配置，运行 generate_pptx.py
│ │ ← 输出 .pptx 文件
└────────┬──────────┘
│
▼
交付 PPTX 文件
生成前为每页写出最小版式契约，不能只写“左文右图”这种粗略描述：
safe_area：若模板有 logo/活动标题/页眉，正文标题必须从页眉安全区以下开始（通常 top >= 1.2in）。content_grid：定义每页的列中心、图片高度、标题基线、说明文字基线。asset_fit：每张图必须使用 contain 或 cover，禁止默认拉伸；人物组图优先同高、同 top、同 caption baseline。reading_order：先标题，再解释句，再主视觉；不要把补充说明压到图片上。risk_items：列出本页最容易错的对象，如二维码、截图、长标题、三列人物图、结束页金句。硬规则：同一页中承担同一角色的图片/卡片/标题，必须共享精确尺寸或精确中心线。不能靠“看起来差不多”。
python3 ./scripts/generate_pptx.py \
--extract-style \
--template /path/to/template.pptx
输出模板的主题信息（配色、字体、布局）。将提取的颜色映射到 JSON 配置的 theme 字段。
若 python-pptx 未安装，脚本返回 error 提示。此时询问用户是否安装，或改用 LLM 分析模式（见 1c）。
使用 LLM 分析截图的视觉风格，提取：
{
"colors": {
"primary": "#1E3A8A",
"accent": "#E94560",
"background": "#FFFFFF",
"text": "#1F2937"
},
"layout": "标题左上 + 内容居中",
"typography": "标题加粗 36px + 正文 18px"
}
将提取的配色映射到 config JSON 的 theme 字段。
向用户确认风格方向：
primary_color: "1A3C6E"）primary_color: "0F172A", accent_color: "38BDF8"）primary_color: "1A1A1A", background_color: "FFFFFF"）LLM 分析文稿内容，输出每页的结构规划：
1. 封面页（cover）
- 标题：{主标题}
- 副标题：{副标题}
- 配图：AI 生成抽象科技背景
2. 目录页（toc）
- 章节：{3-5 个章节}
3. 章节分隔页（section）
- "01 市场概览"
4-N. 内容页（content / two_column / image_full）
- 标题 + 要点 + 配图位置
N+1. 结束页（ending）
将大纲展示给用户确认后再继续。
| 图片类型 | 首选方案 | 备选方案 |
|---|---|---|
| 封面背景图 | siliconflow-img-gen | 纯色背景 |
| 概念插图 | siliconflow-img-gen | pexels/pixabay 素材 |
| 数据图表 | 用户提供 | pexels/pixabay 素材 |
| 产品截图 | 用户提供 | — |
| Logo / 二维码 | 用户提供 | — |
# 封面背景（16:9）
python3 ../siliconflow-img-gen/scripts/gen.py \
--prompt "抽象科技背景，{主题描述}，{主色调}渐变，现代简洁，适合PPT封面，16:9横幅" \
--image-size 1664x928 \
--out-dir ./tmp/ppt-images
# 内容页插图（16:9）
python3 ../siliconflow-img-gen/scripts/gen.py \
--prompt "{页面主题}概念插图，扁平化设计风格，{主色调}主色调，简洁专业" \
--image-size 1664x928 \
--out-dir ./tmp/ppt-images
生成后必须验证：检查图片不是纯色白板（siliconflow 偶发异常），异常则重试（最多 3 次）。
# pexels-footage
python3 ../pexels-footage/scripts/search.py --query "business meeting" --orientation landscape
# pixabay-footage
python3 ../pixabay-footage/scripts/search.py --query "technology abstract" --orientation horizontal
参考 references/slide-layouts.md 了解每种 slide type 的 JSON 格式。
将 Step 1 的主题 + Step 2 的大纲 + Step 3 的图片路径组装为完整 JSON：
{
"theme": {
"primary_color": "1A3C6E",
"secondary_color": "16213E",
"accent_color": "E94560",
"background_color": "FFFFFF",
"text_color": "333333",
"heading_font": "Microsoft YaHei",
"body_font": "Microsoft YaHei"
},
"slides": [
{
"type": "cover",
"title": "季度业务汇报",
"subtitle": "Q1 2026 工作总结",
"author": "业务拓展部",
"background_image": "./tmp/ppt-images/00.png",
"background_color": "1A3C6E"
},
{
"type": "toc",
"title": "目录",
"items": ["市场概览", "业绩亮点", "问题与挑战", "下季度规划"]
}
]
}
将 JSON 写入文件（如 ./tmp/slides-config.json）。
python3 ./scripts/generate_pptx.py \
--config ./tmp/slides-config.json \
--output ./output/presentation.pptx
# 若有模板 PPTX 需要继承母版/布局
python3 ./scripts/generate_pptx.py \
--config ./tmp/slides-config.json \
--output ./output/presentation.pptx \
--template /path/to/template.pptx
生成后立刻运行几何检查，先修机器能确定的问题，再做视觉判断：
python3 ./scripts/check_layout.py ./output/presentation.pptx \
--header-safe-top-in 1.1
检查不通过时不要交付，必须回到 JSON/脚本修正后重新生成。这个脚本会抓：
若视觉设计确实需要例外，必须在交付说明里写清楚，并确认渲染图没有真实缺陷。
不要只写“整体还行/更协调了”。视觉复查必须按页输出缺陷表：
| slide | defect | fix | status |
|---|---|---|---|
| 02 | 标题压到 logo/页眉线 | 标题下移到 safe area | fixed |
| 04 | 三张人物图 top 不齐 | 统一图片 top 和 height | fixed |
视觉复查的硬失败项：
.pptx 文件已生成且大小合理（非空）scripts/check_layout.py，结果必须为 ok./tmp/ppt-images/ 和 ./tmp/slides-config.json），除非用户要求保留| type | 用途 | 关键字段 |
|---|---|---|
cover | 封面 | title, subtitle, author, background_image |
toc | 目录 | title, items[] |
section | 章节分隔 | number, title, subtitle |
content | 标准内容 | title, body, bullets[], image, image_position |
two_column | 双栏对比 | left_title, left_body[], right_title, right_body[] |
image_full | 全图展示 | image, title, caption |
ending | 感谢页 | title, subtitle, contact, qr_image |
详细 JSON 格式与示例见 references/slide-layouts.md。
siliconflow-img-gen 生成图片时设置 inline env var（SILICONFLOW_API_KEY=... python3 ...），API key 已在系统环境中scripts/check_layout.pytype 字段# 前缀（python-pptx 要求）scripts/check_layout.py 且无 error