AiPPT Skill

通过 AiPPT.cn 开放平台 API，用自然语言对话生成专业 PPT 演示文稿。

概述

本 Skill 集成了 AiPPT.cn 的智能 PPT 生成服务，支持：

• 智能生成 — 输入标题，AI 自动生成大纲、内容、排版
• 文档转PPT — Word、PDF、Markdown、TXT、PPTX、XMind 一键转换
• 参考文档生成 — 以上传文件为素材，围绕指定主题重新生成
• 网页导入 — 从 URL 抓取内容生成 PPT
• 高级配置 — 页数、语言、场景、语气、受众、文本量全部可控
• 模型选择 — 智谱 / DeepSeek / 豆包可切换（部分类型支持）
• 企业模板 — B端专属模板优先推荐
• 自动下载 — 生成完成后默认下载 PPTX 到本地；对话明确要求图片时导出 PNG

前置条件

环境依赖：curl、python3、openssl

API 密钥：通过 OpenClaw 安装后在技能设置中填入，无需手动创建文件。

获取密钥：前往 AiPPT 开放平台 注册开发者账号。

AI 决策入口（每次必走）

每次响应用户 PPT 请求，必须先走以下判断树。

用户发来消息
    ├── 有文件附件？ → 场景二（⚠️ 先询问意图，禁止直接执行）
    ├── 有 URL？     → 场景三（URL 导入）
    └── 只有文字？   → 场景一（标题生成）

场景一：标题/主题生成

触发条件：用户只描述了话题或标题，没有上传文件。

示例：

• "帮我做一个关于人工智能的PPT"
• "生成一份年终总结演示文稿"
• "做个产品发布会的幻灯片"

完整流程（共 7 步）：

1. 创建任务
2. 生成大纲（约 10 秒）
3. ⬇ 清晰展示大纲文本给用户（必须完整输出，格式化为 Markdown 标题层级）
4. 自动继续生成内容（不等用户确认，约 25 秒）
5. 合成 PPT（约 10 秒）
6. 导出
7. 下载 → 返回 PPTX 文件路径

第一次工具调用 — 生成大纲

bash scripts/aippt.sh generate "标题" --outline-only

命令结束后，从输出中找到 outline_ready 那行 JSON，提取 task_id、title、outline 字段。

第一次工具调用结束后：先输出文字，再发起第二次工具调用

🚨 必须按以下顺序执行，不可合并：

1. 结束第一次工具调用
2. 向用户输出文字回复（将大纲格式化为 Markdown 标题层级写入回复，同时说明"正在合成 PPT..."）
3. 再发起第二次工具调用（执行 generate_continue）

✅ 正确：[工具调用1: --outline-only] → [文字输出: 大纲内容] → [工具调用2: generate_continue] ❌ 错误：[工具调用1: --outline-only] → [工具调用2: generate_continue] → [文字输出: 大纲内容]

输出格式示例：

📋 **大纲已生成，正在合成 PPT，请稍候...**

# 标题
## 第一章
### 1.1 小节
### 1.2 小节
## 第二章
...

第二次工具调用 — 合成 PPT（约 60 秒）

bash scripts/aippt.sh generate_continue "\x3Ctask_id>" "\x3Ctitle>"

场景二：文档上传生成（⚠️ 必须先询问）

触发条件：用户上传了 Word、PDF、TXT、Markdown、PPTX 等文件。

禁止直接执行，必须先问用户：

您上传了一份文件，请问想怎么用它生成 PPT？

1. 文档转PPT — 直接提取这份文件的内容生成 PPT （适合：文档本身就是要呈现的内容，例如报告、总结、方案）

2. 参考文档生成 — 以这份文件为背景资料，由您指定主题，AI 重新组织生成 （适合：文档是参考材料，需要 AI 重新理解和表达）

根据用户回答执行：

选择 1 — 文档转PPT（完整流程）

文件类型影响流程：

• 有大纲（.doc/.docx/.pdf/.txt/.pptx/.wps）：先生成大纲展示，再自动合成
• 无大纲（.md/.xmind/.mm）：直接合成，无大纲展示步骤

对于 .doc/.docx/.pdf/.txt/.pptx/.wps：

1. 解析文档并生成大纲+内容（约 30 秒）
2. 获取 PPT 树形结构（generate/data）
3. ⬇ 清晰展示大纲文本给用户（必须完整输出，格式化为 Markdown 标题层级）
4. 自动继续合成 PPT（不等用户确认）
5. 导出
6. 下载 → 返回 PPTX 文件路径

第一次工具调用 — 生成大纲（约 30 秒）

bash scripts/aippt.sh generate_from_file "文件绝对路径" --outline-only

命令结束后，从输出中找到 outline_ready 那行 JSON，提取 task_id、title、outline 字段。

第一次工具调用结束后：先输出文字，再发起第二次工具调用

🚨 必须按以下顺序执行，不可合并：

1. 结束第一次工具调用
2. 向用户输出文字回复（将大纲格式化为 Markdown 标题层级写入回复，同时说明"正在合成 PPT..."）
3. 再发起第二次工具调用（执行 generate_save）

✅ 正确：[工具调用1: --outline-only] → [文字输出: 大纲内容] → [工具调用2: generate_save] ❌ 错误：[工具调用1: --outline-only] → [工具调用2: generate_save] → [文字输出: 大纲内容]

步骤 4+5+6 — 自动继续合成 PPT（不等用户确认，约 40 秒）

bash scripts/aippt.sh generate_save "\x3Ctask_id>" "\x3Ctitle>"

对于 .md/.xmind/.mm 类文件，直接执行（单步完成，无大纲展示）：

bash scripts/aippt.sh generate_from_file "文件绝对路径"

选择 2 — 参考文档生成

追问用户 PPT 主题，再执行：

bash scripts/aippt.sh generate_with_refer "PPT主题" "文件绝对路径"

⚠️ 参考文档模式 B 端限制（执行前必须检查）

说明：参考文档模式调用的是 B 端专属接口（/api/ai/chat/refer），以上限制来自平台 API 规范，不可绕过。

场景三：网页 URL 导入

触发条件：用户提供了一个网页 URL。

示例：

• "把这篇文章做成PPT：https://..."
• "根据这个页面生成演示文稿"

执行（两步走）：

步骤 1 — 创建任务并生成大纲

# 1a. 创建任务，获取 task_id
task_id=$(bash scripts/aippt.sh create_from_url "https://..." \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['data']['id'])")

# 1b. 抓取页面内容 + 生成大纲（SSE，约 30 秒）
#     脚本输出 outline_ready 步骤（stderr），将大纲格式化展示给用户
bash scripts/aippt.sh link "$task_id" 2>&1 | grep -E '^{' | python3 -c "
import sys,json
for line in sys.stdin:
    try:
        obj=json.loads(line)
        if obj.get('step')=='outline_ready':
            print(obj.get('outline',''))
    except: pass
"

收到 outline_ready 后，将大纲格式化展示给用户，立即执行步骤 2，不等待用户确认。

步骤 2 — 合成 PPT

bash scripts/aippt.sh generate_save "$task_id" "\x3C页面标题>" [template_id] [output_dir] [formats]

企业模板检查（B端客户适用）

在执行生成命令前，先检查是否有企业专属模板：

bash scripts/aippt.sh enterprise_templates

用户选择企业模板时，将模板 ID 和 enterprise 类型传入：

bash scripts/aippt.sh generate "年终总结" \x3Centerprise_tpl_id> ~/Desktop ppt enterprise
bash scripts/aippt.sh generate_from_file report.docx \x3Centerprise_tpl_id> ~/Desktop ppt enterprise

高级配置（可选，提升生成质量）

查询可用选项 ID

bash scripts/aippt.sh senior_options

返回所有配置项和 ID，★ 表示默认值：

使用方式

--options 传 ID 数组，--model 切换 AI 模型：

# 年度总结 + 英语 + 详细文本
bash scripts/aippt.sh generate "Annual Review 2025" --options "[49,34,60]" --model doubao-1.5-pro-32k

# 文件转PPT + 指定场景和语言
bash scripts/aippt.sh generate_from_file report.pdf --options "[49,27,40]"

模型选择

不传 model 时服务端自动选择默认模型。

执行进度反馈

命令运行时，从 stderr 读取进度 JSON 并实时告知用户：

命令参考

一键生成（推荐）

# 从标题生成
bash scripts/aippt.sh generate \x3C标题> [template_id] [output_dir] [formats] [template_type]

# 从文件生成（文档转PPT）
bash scripts/aippt.sh generate_from_file \x3C文件路径> [template_id] [output_dir] [formats] [template_type]

# 参考文档生成（type=17，最多5个文件，每个 ≤ 10MB）
bash scripts/aippt.sh generate_with_refer \x3CPPT主题> \x3C文件1> [文件2..文件5] \
  [--output_dir \x3Cdir>] [--formats \x3Cfmts>] [--template_id \x3Cid>] [--template_type \x3Ctype>]

参数说明：

文件类型与 API 流程对照

模板

分步操作（type=1 标题生成专用）

分步操作（文件 / URL 导入专用）

两步续跑（大纲确认后使用）

生成 / 导出（所有流程通用）

API 流程详解

⚠️ 关键：不同任务类型走完全不同的后端接口，不可混用。 outline 和 content 接口只对 type=1 有效，文件导入任务调用这两个接口会返回"任务不存在"。

流程 A — type=1 标题智能生成

创建任务
  → outline（SSE，约 6s，生成大纲）
  → content（获取 ticket）
  → check 轮询（约 25s，等待内容就绪）
  → save（约 10s）
  → export + 轮询下载
总耗时：约 60–90 秒

流程 B — type=3 Word 文件导入

创建任务（上传 .doc/.docx）
  → word SSE（约 30s，服务端解析 Word + 生成大纲+内容）
  → save（约 10s）
  → export + 轮询下载
总耗时：约 60 秒

流程 C — type=7/4/5 Markdown / XMind / FreeMind

创建任务（传 content 字段，文本内容）
  → save 直接（约 10s，服务端自动从内容生成）
  → export + 轮询下载
总耗时：约 50 秒

流程 D — type=8/9/10 PDF / TXT / PPTX

创建任务（上传文件）
  → save 直接（约 10s）
  → export + 轮询下载
总耗时：约 50 秒

流程 E — type=16 URL 链接导入

创建任务（传 link 字段）
  → link SSE（约 30s，抓取页面 + 生成大纲+内容）
  → save（约 10s）
  → export + 轮询下载
总耗时：约 60 秒

关键接口说明

任务类型对照表

导出格式

错误码

脚本内置 check_resp() 统一处理，所有非0 code 自动映射为中文提示。

文件结构

aippt-skill/
├── SKILL.md              ← 本文件
├── skill.json            ← Skill 元数据 & 触发词
├── scripts/
│   └── aippt.sh          ← API 集成脚本 (v2.9)
├── .env                  ← API 密钥（不要提交到版本库！）
└── .token_cache.json     ← Token 缓存（自动生成）

版本历史