$npx -y skills add Wan-Video/Wan-skills --skill wan-pptx-generator基于阿里云 qwen-doc-turbo 与 Wan2.7-Image 模型,支持将文档、文本或主题描述自动转换为带有 AI 生成图片的专业 PPT 幻灯片。主要覆盖以下场景:1、文档转 PPT——直接传入 PDF、DOCX、TXT、MD 等格式文件生成演示文稿;2、文本转 PPT——根据用户输入的文字内容或主题描述生成幻灯片;3、风格化生成——指定视觉风格(如"哆啦A梦风格")和叙事风格(如"TED 演讲风格")生成 PPT。触发条件:只要用户意图涉及创建、生成、制作 PPT 或演示文稿——无论是直接指令(如"帮我做个 PPT")、文件驱动(如"把这份
| 1 | # Wan PPT Generator(图片PPT 生成技能) |
| 2 | |
| 3 | 使用qwen-doc-turbo,通过直接 API 调用生成 AI 驱动的 PPT 幻灯片图片,背后调度wan2.7-image模型。 |
| 4 | |
| 5 | ## Quick Start |
| 6 | |
| 7 | **1. 配置环境变量** `DASHSCOPE_API_KEY` |
| 8 | **2. 了解能力** → 阅读下文核心能力介绍 |
| 9 | **3. 准备输入** → 文件路径或文本内容二选一 |
| 10 | **4. 运行脚本** → `scripts/pptx_generator.py` |
| 11 | |
| 12 | **核心能力:** |
| 13 | - ✅ **文档转 PPT**:直接传入文件,自动解析并生成幻灯片 |
| 14 | - ✅ **文本转 PPT**:根据文字内容或主题描述生成演示文稿 |
| 15 | - ✅ **风格化生成**:支持指定视觉风格与叙事风格 |
| 16 | - ✅ **AI 图片渲染**:每页幻灯片由 Wan2.7-Image 模型生成高质量配图 |
| 17 | |
| 18 | > 🎉 **限时优惠**:当前通过 qwen-doc-turbo 调用 Wan2.7-Image 图片生成**限时免费**,仅计算文本 Token 费用,欢迎体验! |
| 19 | |
| 20 | ## 环境变量配置 |
| 21 | |
| 22 | 使用前需设置 DashScope API Key: |
| 23 | |
| 24 | **获取 API Key**: |
| 25 | - 访问阿里云百炼控制台:https://bailian.console.aliyun.com/ |
| 26 | - 登录后在 API Key 管理页面创建或获取您的 API Key |
| 27 | |
| 28 | 运行脚本前,请先检查 `DASHSCOPE_API_KEY` 是否已在环境配置 |
| 29 | |
| 30 | |
| 31 | ## 风格选择引导 |
| 32 | 如果用户已经明确说了风格,跳过此菜单直接生成。 |
| 33 | |
| 34 | 当用户没有指定风格,或者说"帮我选一个"、"你来决定"、"有什么风格"时, |
| 35 | 主动展示风格菜单供用户选择,格式如下: |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | 🎨 **请选择您喜欢的 PPT 风格:** |
| 40 | |
| 41 | **🎌 日漫 / 动漫风** |
| 42 | > 哆啦A梦 / 宫崎骏 / 鸟山明 / 龙珠 / 火影忍者 / 海贼王 / 鬼灭之刃 |
| 43 | > 死神 / 灌篮高手 / 一拳超人 / 美少女战士 / 樱桃小丸子 / 银魂 |
| 44 | > 圣斗士 / 阿童木 / 蜡笔小新 / JOJO的奇妙冒险 / 罗小黑 / 3渲2 |
| 45 | |
| 46 | **🦸 欧美漫画风** |
| 47 | > 漫威 / DC / 蝙蝠侠 / X战警 / 罪恶之城 / 地狱男爵 / 美式漫画 |
| 48 | |
| 49 | **🇨🇳 中国风 / 国漫** |
| 50 | > 新中式国潮 / 水墨风 / 敦煌风 / 工笔画 / 浮世绘 / 剪纸风 |
| 51 | > 三毛流浪记 / 老夫子 / 朱德庸 / 镖人 / 风云雄霸天下 |
| 52 | |
| 53 | **🎮 游戏 / 像素风** |
| 54 | > 原神 / 塞尔达 / 我的世界(Minecraft) / 赛博朋克 / 街机 / 像素风 |
| 55 | > 低面建模 / 积木风 / 2.5D / 3D |
| 56 | |
| 57 | **✏️ 插画 / 设计风** |
| 58 | > MBE插画 / 扁平化 / 波普艺术 / 孟菲斯 / 包豪斯 / 苹果设计 |
| 59 | > 材质设计 / 新拟物 / 黏土拟物 / 手绘 / 草图 / 文具手帐 |
| 60 | |
| 61 | **🖼️ 艺术 / 绘画风** |
| 62 | > 油画 / 水彩 / 版画 / 木刻 / 彩绘玻璃 / 超写实 / 超现实 |
| 63 | > 梵高 / 莫奈 / 达芬奇 / 蒙德里安 / 立体主义 / 欧普艺术 |
| 64 | |
| 65 | **🌈 潮流 / 特效风** |
| 66 | > 蒸汽波 / 蒸汽朋克 / 赛璐璐 / 酸性设计 / 故障美学 / 科技未来 |
| 67 | > 哥特风 / 重工业 / 定格动画 |
| 68 | |
| 69 | **📸 复古 / 生活风** |
| 70 | > 胶片复古 / 做旧风 / 怀旧风 / 北欧风 / 奶油风 / 和风侘寂 |
| 71 | > 韦斯安德森 / 宜家 / 维多利亚 / 新艺术 / 大字报 / 杂志排版 |
| 72 | |
| 73 | **🎤 演讲 / 商务风** |
| 74 | > TED风 |
| 75 | |
| 76 | --- |
| 77 | |
| 78 | 直接回复风格名称即可,或者"日漫里选一个最适合的",如果您无法选择,我将自行为您选择最合适的风格制作PPT。 |
| 79 | ## Workflow:PPT 生成流程 |
| 80 | |
| 81 | 1. **判断输入类型** - 根据用户提供的是文件还是文本,选择对应输入方式 |
| 82 | 2. **调用生成脚本** - 调用 `scripts/pptx_generator.py`,传入内容、查询指令和输出目录 |
| 83 | 3. **生成脚本会实时保存结果**: |
| 84 | - 收到大纲 → 保存为 `content.md` |
| 85 | - 收到每页图片 URL → 逐页下载保存为 `1.jpg`、`2.jpg`... |
| 86 | - 收到 PPTX 下载链接 → 下载保存为 `presentation_{timestamp}.pptx` |
| 87 | 4. **展示结果** - 在用户交互界面中显示页面图片预览 |
| 88 | 5. **提示保存** - 告知用户图片链接有效期为 24 小时,建议指定目录长期保存 |
| 89 | |
| 90 | ## Command Line Arguments(命令行参数) |
| 91 | |
| 92 | | 参数 | 简写 | 必填 | 说明 | |
| 93 | |------|------|------|------| |
| 94 | | --content | -c | 否* | PPT 文本内容 | |
| 95 | | --file | -f | 否* | 输入文件路径(支持 pdf、docx、txt、md 等) | |
| 96 | | --query | -q | 是 | 风格与需求描述,如"用哆啦A梦视觉风格和 TED 叙事风格生成 PPT" | |
| 97 | | --mode | -m | 否 | 生成模式,默认为 creative | |
| 98 | | --output-dir | -o | 否 | 输出目录,指定后自动保存大纲、页面图片和 PPTX 文件 | |
| 99 | |
| 100 | *注:`--content` 和 `--file` 至少需要提供一个 |
| 101 | |
| 102 | ## Output Files(输出文件) |
| 103 | |
| 104 | 当指定 `--output-dir` 时,脚本会**实时**将结果保存到输出目录: |
| 105 | |
| 106 | | 文件 | 生成时机 | 说明 | |
| 107 | |------|----------|------| |
| 108 | | `content.md` | 收到大纲时(第 1 次返回) | PPT 大纲与分镜脚本 | |
| 109 | | `1.jpg`, `2.jpg`, ... `N.jpg` | 收到每页图片 URL 时(逐页返回) | 由 Wan2.7-Image 渲染的每页幻灯片预览图,按页码命名 | |
| 110 | | `presentation_{timestamp}.pptx` | 收到 PPTX 下载链接时(最后返回) | 完整的 PowerPoint 文件 | |
| 111 | |
| 112 | ## Usage Examples(使用示例) |
| 113 | |
| 114 | ### 示例 1:传入文件生成 PPT |
| 115 | |
| 116 | ```bash |
| 117 | python3 scripts/pptx_generator.py \ |
| 118 | -f ~/Downloads/document.pdf \ |
| 119 | -q "用哆啦A梦视觉风格和TED叙事风格生成PPT" \ |
| 120 | -m creative \ |
| 121 | -o /path/to/output/dir |
| 122 | ``` |
| 123 | |
| 124 | ### 示例 2:传入文本内容生成 PPT |
| 125 | |
| 126 | ```bash |
| 127 | |
| 128 | python3 scripts/pptx_generator.py \ |
| 129 | -c "产品名称:智能助手。核心功能:自然语言处理、任务自动化、多平台支持。" \ |
| 130 | -q "用极简商务风格和TED叙事风格生成PPT,共5页" \ |
| 131 | -m creative \ |
| 132 | -o /path/to/output/dir |
| 133 | ``` |
| 134 | |
| 135 | ## 生成任务耗时过长及进度追踪 |
| 136 | |
| 137 | 通过日志文件 `scripts/pptx_generator.log` 实时追踪进度。每次运行会先清空日志,再逐条写入带时间戳的日志记录。 |
| 138 | |
| 139 | **重要原则:** 若任务长时间未返回结果,告知用户当前进度并建议稍后查看输出目录。绝对不要私自修改用户需求,例如减少页数或降低生成质量。 |
| 140 | |
| 141 | ## Error Handling(错误处理) |
| 142 | |
| 143 | | 错误 | 原因 | 解决方案 | |
| 144 | |------|------|----------| |
| 145 | | API key not provided | 未设置 API Key | 设置 `DASHSCOPE_API_KEY` 环境变量 |
| 146 | | 请求失败:code=XXX | API 调用失败 | 检查网络连接、API Key 有效性、模型可用性 | |
| 147 | | 解析响应失败 | 响应格式异常 | 查看 `scripts/pptx_generator.log` 获取详细信息 | |
| 148 | | 必须提供 content 或 file | 未提供输入内容 | 使用 `-c` 或 `-f` 参数提供内容 | |
| 149 | | BalanceError | 账户余额不足或后端服务异常 | 检查阿里云账户余额,稍后重试 | |
| 150 | |
| 151 | 详细错误码参考:[DashScope 错误码文档](https://help.aliyun.com/zh/model-studio/developer-reference/error-code) |
| 152 | |
| 153 | |
| 154 | ## 相关文件 |
| 155 | |
| 156 | - 🐍 [pptx_generator.py](scripts/pptx_generator.py) - PPT 生成主脚本 |
| 157 | - 📄 [pptx_generator.log](scripts/pptx_generator.log) - 实时运行日志 |