ClawHub

aippt

Other

这是一个自动为用户生成 PPT 演示文稿的技能，可依据用户特殊要求如：篇幅、场景、语气，角色等描述以及根据用户的文件（包含 docx、图片等多格式文件）一键生成 PPT 演示文稿。触发词：自动生成一份PPT、生成一份PPT、创建一份PPT、自动创建一份PPT、生成一个PPT、创建一个PPT、自动生成PPT、自动创建PPT。

Install

openclaw skills install aippt

自动生成 PPT 演示文稿技能

  • 接口文档： aippt 文档
  • AIPPT_ACCESS_TOKEN：从官方网站，个人中心中获取。
  • 文件解析：需要用户安装阅读文件技能（该技能无需单独安装），用来解析用户指定的文件内容。

环境变量设置

AIPPT_ACCESS_TOKEN

  1. 当下面的 AIPPT_ACCESS_TOKEN 为空时，需要从官方网站，个人中心中获取。
  2. 当下面的 AIPPT_ACCESS_TOKEN 是 "your-actual-access-token" 时，需要用户从官方网站，个人中心中获取。
  3. 当下面的 AIPPT_ACCESS_TOKEN 是其他值时，直接使用该值。
export AIPPT_ACCESS_TOKEN="your-actual-access-token"

生成流程

Step 1: 根据用户的输入，优化提示词

  • 角色设定：演讲家。
  • 场景设定：会议宣讲。
  • 语气设定：专业、正式。
  • 语言设定: 根据用户的输入语言，默认值为中文。
  • 篇幅：当用户输入中有“篇幅”、“页数”或其他相关关键词时，需要根据用户的输入，调整生成的 PPT 演示文稿的篇幅。

注意事项

  • 当用户指定了具体的文件时，内容需要覆盖文件的全部内容，不能只覆盖文件的部分内容。
  • 当用户未指定具体文件时，根据用户的输入，总结一个标题。

Step 2：生成Markdown内容

  1. 对用户的内容仔细分析，并根据第一步的优化提示词成最终的Markdown内容。
  2. Markdown结构如下：
# 标题
> 标题说明
## 章节标题
> 章节标题说明
### 小节标题
> 小节标题说明
- 内容项标题：内容项内容
###### 总结
  1. 用户确认Markdown内容：需要用户确认生成的Markdown内容是否符合要求。

大纲要求

  • {# 标题} 不能为空。
  • {> 标题说明} 可以为空。
  • {## 章节标题} 不能超过 8 个。
  • {> 章节标题说明} 可以为空。
  • {### 小节标题} 不能为空。
  • {> 小节标题说明} 可以为空。
  • **{内容项标题}**不能为空。
  • {内容项内容} 不能为空。
  • {内容项标题：内容项内容}个数限制：每个小节下最少有 1 个内容项，最多可以有 5 个内容项，但不能超过 6 个。
  • {###### 总结} 全文只能有 1 个总结，字数在 100-200 个字之间。 总结示例：
###### 福布斯 AI50 榜单展现了全球 AI 产业的核心格局。从融资规模看，OpenAI 是全球最大的 AI 公司，融资规模超过 100 亿美元......

注意事项

  • 当用户指定的具体文件内容过多 并且 8个章节无法满足要求时，可以规划处更多的 小节 来满足内容覆盖全文的要求。
  • {内容项标题：内容项内容} ：当{内容项内容}有具体的数字是，内容项标题需要对数字进行整理，并输出一个显眼的{内容项标题}，例如："项目完成达100%"。
  • {内容项内容} ：
  1. 当用户指定了具体文件时，每项{内容项内容}不能超过 30 个字，内容字数在20-30字为最佳长度（字数不包含{内容项标题}的字数）。
  2. 当用户未指定具体文件时，内容字数不少于 20 字，不超过30字（字数不包含{内容项标题}的字数）。
  • {###### 总结} ：开头以 {######} 开头，不能有 "总结" 两个字，6个 "#"，不能多也不能少。

Step 3：选择一个模板

模板规则：模板每页数量为 10 个，可以通过 --page 参数指定页码，默认值为 1。 调用脚本: get_tpl_list.py 获取可用的 PPT 模板。

python3 get_tpl_list.py --page=$page --num=10

列表展示

  • 展示字段：序号、模板名称、热度、预览图片。
  • 预览图片：使用 picture 字段，示例：预览。
  • 图片链接：保证图片链接的完整性。
  • 点击预览：点击预览图片，会在浏览器中打开预览页面。 | 序号 | 模板名称 |热度| 预览 | | --- | --- | --- | --- | | 1 | 模板1 | 100 | 预览 |

注意事项

  • 模板ID：长度32位，保持模板ID的完整性。
  • 图片链接：保证图片链接的完整性，避免链接失效导致预览失败。
  • 图片链接格式：图片链接格式为 https://ppt-img.7niuai.com/{32位字符串}/{32位字符串}_picture.jpg。

Step 4：获取PPT的下载链接

调用脚本： generate_by_content.py 获取PPT的下载链接。

python3 generate_by_content.py --tpl_id=$tpl_id --markdown_content="Markdown内容"

注意事项

  • 链接的根域名：链接的根域名是 https://jcppt.com/。
  • 检查Markdown内容是否符合要求：确保Markdown内容符合要求，否则会导致生成失败。
  • {tpl_id} 是模版ID，不能为空。
  • 链接： 需要对链接进行URLENCODE编码。
  • 不要为用户直接打开浏览器：用户需要手动点击链接，打开浏览器。
  • 链接显示： 链接以Markdown格式呈现，用户需要手动点击链接。
  • 链接完整性：
  1. 链接示例：https://jcppt.com/preview-in-ai/ed4d5e71ff632cfef4e6e5d97807e7e6?title=%E8%84%91%E6%9C%BA%E6%8E%A5%E5%8F%A3%E6%8A%80%E6%9C%AF&tplid=b308ae8fa5550166065b695782c3a5da
  2. 链接中的 preview-in-ai/ed4d5e71ff632cfef4e6e5d97807e7e6 中的 ed4d5e71ff632cfef4e6e5d97807e7e6 是一个32位的字符串。
  3. 链接中的 tplid=b308ae8fa5550166065b695782c3a5da 中的 b308ae8fa5550166065b695782c3a5da 是一个32位的字符串。