Skip to content
Back to search

NanoBanana-PPT-Skills

NanoBanana PPT Skills 基于 AI 自动生成高质量 PPT 图片和视频的强大工具,支持智能转场和交互式播放

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/op7418--nanobanana-ppt-skills/badge.svg)](/listings/op7418--nanobanana-ppt-skills)

HTML

<a href="/listings/op7418--nanobanana-ppt-skills"><img src="/api/listings/op7418--nanobanana-ppt-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 674 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # PPT Generator Pro - Claude Code Skill
  2. ## 📋 元数据
  3. - **Skill 名称**: ppt-generator-pro
  4. - **版本**: 2.0.0
  5. - **描述**: 基于 AI 自动生成高质量 PPT 图片和视频,支持智能转场和交互式播放
  6. - **作者**: 歸藏
  7. - **标签**: ppt, presentation, video, ai, nano-banana, kling-ai, image-generation
  8. ## ✨ 功能特性
  9. ### 核心功能
  10. - 🤖 **智能文档分析** - 自动提取核心要点,规划 PPT 内容结构
  11. - 🎨 **多风格支持** - 内置渐变毛玻璃、矢量插画两种专业风格
  12. - 🖼️ **高质量图片** - 使用 Nano Banana Pro 生成 16:9 高清 PPT
  13. - 🎬 **AI 转场视频** - 可灵 AI 生成流畅的页面过渡动画
  14. - 🎮 **交互式播放器** - 视频+图片混合播放,支持键盘导航
  15. - 🎥 **完整视频导出** - FFmpeg 合成包含所有转场的完整 PPT 视频
  16. ### 新功能 (v2.0)
  17. - 🔄 **首页循环预览** - 自动生成吸引眼球的循环动画
  18. - 🎞️ **智能转场** - 自动生成页面间的过渡视频
  19. - 🔧 **参数统一** - 自动统一所有视频分辨率和帧率
  20. ## 📦 系统要求
  21. ### 环境变量
  22. **必需:**
  23. - `GEMINI_API_KEY`: Google AI API 密钥(用于生成 PPT 图片)
  24. **可选(用于视频功能):**
  25. - `KLING_ACCESS_KEY`: 可灵 AI Access Key
  26. - `KLING_SECRET_KEY`: 可灵 AI Secret Key
  27. ### Python 依赖
  28. ```bash
  29. pip install google-genai pillow python-dotenv
  30. ```
  31. ### 视频功能依赖
  32. ```bash
  33. # macOS
  34. brew install ffmpeg
  35. # Ubuntu/Debian
  36. sudo apt-get install ffmpeg
  37. ```
  38. ## 🚀 使用方法
  39. ### 在 Claude Code 中调用
  40. ```bash
  41. /ppt-generator-pro
  42. ```
  43. 或直接告诉 Claude:
  44. ```
  45. 我想基于以下文档生成一个 5 页的 PPT,使用渐变毛玻璃风格。
  46. [文档内容...]
  47. ```
  48. ## 📝 Skill 执行流程
  49. ### 阶段 1: 收集用户输入
  50. #### 1.1 获取文档内容
  51. **选项 A: 文档路径**
  52. ```
  53. 用户: 基于 my-document.md 生成 PPT
  54. → 使用 Read 工具读取文件内容
  55. ```
  56. **选项 B: 直接文本**
  57. ```
  58. 用户: 我想生成一个关于 AI 产品设计的 PPT
  59. 主要内容:
  60. 1. 现状分析
  61. 2. 设计原则
  62. 3. 案例研究
  63. ```
  64. **选项 C: 主动询问**
  65. ```
  66. 如果用户未提供内容,询问:
  67. "请提供文档路径或直接粘贴文档内容"
  68. ```
  69. #### 1.2 选择风格
  70. 扫描 `styles/` 目录,列出可用风格:
  71. ```python
  72. # 自动检测风格文件
  73. styles = ['gradient-glass.md', 'vector-illustration.md']
  74. ```
  75. **如果有多个风格,使用 AskUserQuestion:**
  76. ```markdown
  77. 问题: 请选择 PPT 风格
  78. 选项:
  79. - 渐变毛玻璃卡片风格(科技感、商务演示)
  80. - 矢量插画风格(温暖、教育培训)
  81. ```
  82. #### 1.3 选择页数范围
  83. 使用 AskUserQuestion 询问:
  84. ```markdown
  85. 问题: 希望生成多少页 PPT?
  86. 选项:
  87. - 5 页(5 分钟演讲)
  88. - 5-10 页(10-15 分钟演讲)
  89. - 10-15 页(20-30 分钟演讲)
  90. - 20-25 页(45-60 分钟演讲)
  91. ```
  92. #### 1.4 选择分辨率
  93. ```markdown
  94. 问题: 选择图片分辨率
  95. 选项:
  96. - 2K (2752x1536) - 推荐,快速生成
  97. - 4K (5504x3072) - 高质量,适合打印
  98. ```
  99. #### 1.5 是否生成视频(可选)
  100. 如果配置了可灵 AI 密钥,询问:
  101. ```markdown
  102. 问题: 是否生成转场视频?
  103. 选项:
  104. - 仅图片(快速)
  105. - 图片 + 转场视频(完整体验)
  106. ```
  107. ### 阶段 2: 文档分析与内容规划
  108. #### 2.1 内容规划策略
  109. 根据页数范围,智能规划每一页内容:
  110. **5 页版本:**
  111. 1. 封面:标题 + 核心主题
  112. 2. 要点 1:第一个核心观点
  113. 3. 要点 2:第二个核心观点
  114. 4. 要点 3:第三个核心观点
  115. 5. 总结:核心结论或行动建议
  116. **5-10 页版本:**
  117. 1. 封面
  118. 2-3. 引言/背景
  119. 4-7. 核心内容(3-4 个关键观点)
  120. 8-9. 案例或数据支持
  121. 10. 总结与行动建议
  122. **10-15 页版本:**
  123. 1. 封面
  124. 2-3. 引言/目录
  125. 4-6. 第一章节(3 页)
  126. 7-9. 第二章节(3 页)
  127. 10-12. 第三章节/案例研究
  128. 13-14. 数据可视化
  129. 15. 总结与下一步
  130. **20-25 页版本:**
  131. 1. 封面
  132. 2. 目录
  133. 3-4. 引言和背景
  134. 5-8. 第一部分(4 页)
  135. 9-12. 第二部分(4 页)
  136. 13-16. 第三部分(4 页)
  137. 17-19. 案例研究
  138. 20-22. 数据分析和洞察
  139. 23-24. 关键发现和建议
  140. 25. 总结与致谢
  141. #### 2.2 生成 slides_plan.json
  142. 创建 JSON 文件:
  143. ```json
  144. {
  145. "title": "文档标题",
  146. "total_slides": 5,
  147. "slides": [
  148. {
  149. "slide_number": 1,
  150. "page_type": "cover",
  151. "content": "标题:AI 产品设计指南\n副标题:构建以用户为中心的智能体验"
  152. },
  153. {
  154. "slide_number": 2,
  155. "page_type": "content",
  156. "content": "核心原则\n- 简单直观\n- 快速响应\n- 透明可控"
  157. },
  158. {
  159. "slide_number": 3,
  160. "page_type": "content",
  161. "content": "设计流程\n1. 用户研究\n2. 原型设计\n3. 测试迭代"
  162. },
  163. {
  164. "slide_number": 4,
  165. "page_type": "data",
  166. "content": "用户满意度\n使用前:65%\n使用后:92%\n提升:+27%"
  167. },
  168. {
  169. "slide_number": 5,
  170. "page_type": "content",
  171. "content": "总结\n- 以用户为中心\n- 持续优化迭代\n- 数据驱动决策"
  172. }
  173. ]
  174. }
  175. ```
  176. **重要:** 将此文件保存到:
  177. - 独立使用:`./slides_plan.json`
  178. - Skill 模式:`.claude/skills/ppt-generator/slides_plan.json`
  179. ### 阶段 3: 生成 PPT 图片
  180. #### 3.1 确定工作目录
  181. **独立模式:**
  182. ```bash
  183. cd /path/to/ppt-generator
  184. ```
  185. **Skill 模式:**
  186. ```bash
  187. cd ~/.claude/skills/ppt-generator
  188. ```
  189. #### 3.2 执行生成命令
  190. ```bash
  191. python generate_ppt.py \
  192. --plan slides_plan.json \
  193. --style styles/gradient-glass.md \
  194. --resolution 2K
  195. ```
  196. **或使用 uv run(推荐):**
  197. ```bash
  198. uv run python generate_ppt.py \
  199. --plan slides_plan.json \
  200. --style styles/gradient-glass.md \
  201. --resolution 2K
  202. ```
  203. **参数说明:**
  204. - `--plan`: slides 规划 JSON 文件路径
  205. - `--style`: 风格文件路径
  206. - `--resolution`: 分辨率(2K 或 4K)
  207. - `--template`: HTML 模板路径(可选)
  208. #### 3.3 监控生成进度
  209. 脚本会输出进度信息:
  210. ```
  211. ✅ 已加载环境变量: /path/to/.env
  212. 📊 开始生成 PPT 图片...
  213. 总页数: 5
  214. 分辨率: 2K (2752x1536)
  215. 风格: 渐变毛玻璃卡片风格
  216. 🎨 生成第 1 页 (封面页)...
  217. 提示词已生成
  218. 调用 Nano Banana Pro API...
  219. ✅ 第 1 页生成成功 (32.5 秒)
  220. 🎨 生成第 2 页 (内容页)...
  221. ✅ 第 2 页生成成功 (28.3 秒)
  222. ...
  223. ✅ 所有页面生成完成!
  224. 📁 输出目录: outputs/20260112_143022/
  225. ```
  226. ### 阶段 4: 生成转场提示词(视频模式需要)
  227. **这是 Skill 的核心优势**:我(Claude Code)会分析生成的 PPT 图片,为每个转场生成精准的视频提示词。
  228. #### 4.1 读取并分析 PPT 图片
  229. 我会读取所有生成的图片:
  230. ```python
  231. # 自动读取输出目录中的所有图片
  232. slides = ['slide-01.png', 'slide-02.png', ...]
  233. ```
  234. #### 4.2 分析图片差异并生成提示词
  235. 对于每对相邻图片,我会:
  236. 1. **视觉分析**:理解两张图片的布局、元素、色彩差异
  237. 2. **生成预览提示词**:为首页创建可循环的微动效描述
  238. 3. **生成转场提示词**:详细描述如何从起始帧过渡到结束帧
  239. **示例输出:**
  240. ```json
  241. {
  242. "preview": {
  243. "slide_path": "outputs/.../slide-01.png",
  244. "prompt": "画面保持封面的静态构图,中心的3D玻璃环缓慢旋转..."
  245. },
  246. "transitions": [
  247. {
  248. "from_slide": 1,
  249. "to_slide": 2,
  250. "prompt": "镜头从封面开始,玻璃环逐渐解构,分裂成透明碎片..."
  251. }
  252. ]
  253. }
  254. ```
  255. #### 4.3 保存提示词文件
  256. 我会将生成的提示词保存到:
  257. ```
  258. outputs/TIMESTAMP/transition_prompts.json
  259. ```
  260. **关键优势:**
  261. - ✅ 不需要单独的 Claude API 密钥
  262. - ✅ 提示词针对实际图片内容定制
  263. - ✅ 考虑文字稳定性,避免视频模型弄模糊文字
  264. - ✅ 符合渐变毛玻璃风格的视觉语言
  265. ### 阶段 5: 生成转场视频(可选)
  266. 如果用户选择生成视频,使用阶段 4 生成的提示词文件:
  267. ```bash
  268. python generate_ppt_video.py \
  269. --slides-dir outputs/20260112_143022/images \
  270. --output-dir outputs/20260112_143022_video \
  271. --prompts-file outputs/20260112_143022/transition_prompts.json
  272. ```
  273. **生成内容:**
  274. - 首页循环预览视频(`preview.mp4`)
  275. - 页面间转场视频(`transition_01_to_02.mp4` 等)
  276. - 交互式视频播放器(`video_index.html`)
  277. - 完整视频(`full_ppt_video.mp4`)
  278. ### 阶段 6: 返回结果
  279. #### 6.1 仅图片模式
  280. ```
  281. ✅ PPT 生成成功!
  282. 📁 输出目录: outputs/20260112_143022/
  283. 🖼️ PPT 图片: outputs/20260112_143022/images/
  284. 🎬 播放网页: outputs/20260112_143022/index.html
  285. 打开播放网页:
  286. open outputs/20260112_143022/index.html
  287. 播放器快捷键:
  288. - ← → 键: 切换页面
  289. - ↑ Home: 回到首页
  290. - ↓ End: 跳到末页
  291. - 空格: 暂停/继续自动播放
  292. - ESC: 全屏切换
  293. - H: 隐藏/显示控件
  294. ```
  295. #### 5.2 视频模式
  296. ```
  297. ✅ PPT 视频生成成功!
  298. 📁 输出目录: outputs/20260112_143022_video/
  299. 🖼️ PPT 图片: outputs/20260112_143022/images/
  300. 🎬 转场视频: outputs/20260112_143022_video/videos/
  301. 🎮 交互式播放器: outputs/20260112_143022_video/video_index.html
  302. 🎥 完整视频: outputs/20260112_143022_video/full_ppt_video.mp4
  303. 打开交互式播放器:
  304. open outputs/20260112_143022_video/video_index.html
  305. 播放逻辑:
  306. 1. 首页: 播放循环预览视频
  307. 2. 按右键 → 播放转场视频 → 显示目标页图片(2 秒)
  308. 3. 再按右键 → 播放下一个转场 → 显示下一页图片
  309. 4. 依此类推...
  310. 视频播放器快捷键:
  311. - ← → 键: 上一页/下一页(含转场)
  312. - 空格: 播放/暂停当前视频
  313. - ESC: 全屏切换
  314. - H: 隐藏/显示控件
  315. ```
  316. ## 🔧 环境变量配置
  317. ### .env 文件位置
  318. Skill 会按以下顺序查找 `.env` 文件:
  319. 1. **脚本所在目录** - `./ppt-generator/.env`
  320. 2. **向上查找项目根目录** - 直到找到包含 `.git` 或 `.env` 的目录
  321. 3. **Claude Skill 标准位置** - `~/.claude/skills/ppt-generator/.env`
  322. 4. **系统环境变量** - 如果以上都未找到
  323. ### .env 文件示例
  324. ```bash
  325. # Google AI API 密钥(必需)
  326. GEMINI_API_KEY=your_gemini_api_key_here
  327. # 可灵 AI API 密钥(可选,用于视频功能)
  328. KLING_ACCESS_KEY=your_kling_access_key_here
  329. KLING_SECRET_KEY=your_kling_secret_key_here
  330. ```
  331. ## ⚠️ 错误处理
  332. ### 常见错误及解决方案
  333. **1. API 密钥未设置**
  334. ```
  335. 错误: ⚠️ 未找到 .env 文件,尝试使用系统环境变量
  336. 未设置 GEMINI_API_KEY 环境变量
  337. 解决:
  338. 1. 创建 .env 文件
  339. 2. 添加 GEMINI_API_KEY=your_key_here
  340. ```
  341. **2. Python 依赖缺失**
  342. ```
  343. 错误: ModuleNotFoundError: No module named 'google.genai'
  344. 解决: pip install google-genai pillow python-dotenv
  345. ```
  346. **3. FFmpeg 未安装**
  347. ```
  348. 错误: ❌ FFmpeg 不可用!
  349. 解决: brew install ffmpeg # macOS
  350. sudo apt-get install ffmpeg # Ubuntu
  351. ```
  352. **4. API 调用失败**
  353. ```
  354. 错误: API 调用超时或失败
  355. 解决:
  356. 1. 检查网络连接
  357. 2. 确认 API 密钥有效
  358. 3. 稍后重试
  359. ```
  360. **5. 视频生成失败**
  361. ```
  362. 错误: 可灵 AI 密钥未配置
  363. 解决:
  364. 1. 如果只需要图片,跳过视频生成步骤
  365. 2. 如果需要视频,配置 KLING_ACCESS_KEY 和 KLING_SECRET_KEY
  366. ```
  367. ## 🎨 风格系统
  368. ### 已内置风格
  369. #### 1. 渐变毛玻璃卡片风格 (`gradient-glass.md`)
  370. **视觉特点:**
  371. - Apple Keynote 极简主义
  372. - 玻璃拟态效果
  373. - 霓虹紫/电光蓝/珊瑚橙渐变
  374. - 3D 玻璃物体 + 电影级光照
  375. **适用场景:**
  376. - 科技产品发布
  377. - 商务演示
  378. - 数据报告
  379. - 企业品牌展示
  380. #### 2. 矢量插画风格 (`vector-illustration.md`)
  381. **视觉特点:**
  382. - 扁平化矢量设计
  383. - 统一黑色轮廓线
  384. - 复古柔和配色
  385. - 几何化简化
  386. **适用场景:**
  387. - 教育培训
  388. - 创意提案
  389. - 儿童相关
  390. - 温暖品牌故事
  391. ### 添加自定义风格
  392. 1. 在 `styles/` 目录创建新的 `.md` 文件
  393. 2. 按照现有风格格式编写
  394. 3. Skill 会自动识别并提供选择
  395. ## 📊 技术细节
  396. ### API 配置
  397. **Nano Banana Pro(图片生成):**
  398. - 模型:`gemini-3-pro-image-preview`
  399. - 比例:`16:9`
  400. - 响应模式:`IMAGE`
  401. - 分辨率:2K (2752x1536) 或 4K (5504x3072)
  402. **可灵 AI(视频生成):**
  403. - 模式:专业模式(professional)
  404. - 时长:5 秒
  405. - 分辨率:1920x1080
  406. - 帧率:24fps
  407. **FFmpeg(视频合成):**
  408. - 编码:H.264
  409. - 质量:CRF 23
  410. - 帧率:24fps(统一)
  411. - 分辨率:1920x1080(统一)
  412. ### 性能指标
  413. **生成速度:**
  414. - PPT 图片:~30 秒/页(2K)| ~60 秒/页(4K)
  415. - 转场视频:~30-60 秒/段
  416. - 视频合成:~5-10 秒
  417. **文件大小:**
  418. - PPT 图片:~2.5MB/页(2K)| ~8MB/页(4K)
  419. - 转场视频:~3-5MB/段(1080p,5 秒)
  420. - 完整视频:~12-20MB(5 页 PPT + 转场)
  421. ## 📁 文件组织
  422. ### 输出目录结构
  423. **仅图片模式:**
  424. ```
  425. outputs/20260112_143022/
  426. ├── images/
  427. │ ├── slide-01.png
  428. │ ├── slide-02.png
  429. │ └── ...
  430. ├── index.html # 图片播放器
  431. └── prompts.json # 提示词记录
  432. ```
  433. **视频模式:**
  434. ```
  435. outputs/20260112_143022_video/
  436. ├── videos/
  437. │ ├── preview.mp4 # 首页循环预览
  438. │ ├── transition_01_to_02.mp4
  439. │ ├── transition_02_to_03.mp4
  440. │ └── ...
  441. ├── video_index.html # 交互式播放器
  442. └── full_ppt_video.mp4 # 完整视频
  443. ```
  444. ## 🎯 最佳实践
  445. 1. **文档质量**:输入文档内容越清晰结构化,生成的 PPT 质量越高
  446. 2. **页数选择**:根据文档长度和演示场景合理选择页数
  447. 3. **分辨率选择**:日常使用推荐 2K,重要展示场合可选 4K
  448. 4. **视频功能**:首次使用建议先尝试仅图片模式,熟悉后再使用视频功能
  449. 5. **提示词调整**:查看 `prompts.json` 了解生成逻辑,可手动调整后重新生成
  450. ## 📝 使用示例
  451. ### 示例 1: 快速生成
  452. **用户输入:**
  453. ```
  454. 我需要基于这份会议纪要生成一个 5 页的 PPT,使用矢量插画风格。
  455. 会议主题:Q1 产品路线图规划
  456. 参与人:产品团队
  457. 讨论内容:
  458. 1. 用户反馈汇总
  459. 2. 新功能优先级
  460. 3. 技术可行性评估
  461. 4. Q1 里程碑
  462. 5. 下一步行动项
  463. ```
  464. **Skill 执行:**
  465. 1. 收集输入(已提供内容)
  466. 2. 确认风格(矢量插画)
  467. 3. 确认页数(5 页)
  468. 4. 确认分辨率(询问用户)
  469. 5. 生成 slides_plan.json
  470. 6. 执行生成命令
  471. 7. 返回结果
  472. ### 示例 2: 完整流程
  473. **用户输入:**
  474. ```
  475. 基于 AI-Product-Design.md 文档,生成一个 15 页的 PPT,使用渐变毛玻璃风格,需要转场视频。
  476. ```
  477. **Skill 执行:**
  478. 1. 读取文档内容
  479. 2. 确认风格(渐变毛玻璃)
  480. 3. 确认页数(15 页)
  481. 4. 确认分辨率(询问用户)
  482. 5. 确认生成视频(是)
  483. 6. 分析文档,规划 15 页内容
  484. 7. 生成 slides_plan.json
  485. 8. 生成 PPT 图片
  486. 9. 生成转场视频
  487. 10. 合成完整视频
  488. 11. 返回所有结果
  489. ## 🔄 更新日志
  490. ### v2.0.0 (2026-01-12)
  491. - 🎬 **新增视频功能**
  492. - 可灵 AI 转场视频生成
  493. - 交互式视频播放器
  494. - FFmpeg 完整视频合成
  495. - 首页循环预览视频
  496. - 🔧 **优化视频合成**
  497. - 自动统一分辨率和帧率
  498. - 修复视频拼接兼容性问题
  499. - 静态图片展示时间改为 2 秒
  500. - 🔑 **改进环境变量**
  501. - 智能查找 .env 文件
  502. - 支持多种部署模式
  503. - 自动向上查找项目根目录
  504. - 📚 **文档完善**
  505. - 重命名为 SKILL.md(符合官方规范)
  506. - 更新所有路径和命令
  507. - 添加视频功能使用指南
  508. ### v1.0.0 (2026-01-09)
  509. - ✨ 首次发布
  510. - 🎨 内置 2 种专业风格
  511. - 🖼️ 支持 2K/4K 分辨率
  512. - 🎬 HTML5 图片播放器
  513. - 📊 智能文档分析
  514. ## 📄 许可证
  515. MIT License
  516. ## 📞 技术支持
  517. - 项目架构:参见 `ARCHITECTURE.md`
  518. - API 管理:参见 `API_MANAGEMENT.md`
  519. - 环境配置:参见 `ENV_SETUP.md`
  520. - 安全说明:参见 `SECURITY.md`
  521. - 完整文档:参见 `README.md`
README.md · README · 871 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # NanoBanana PPT Skills
  2. > 基于 AI 自动生成高质量 PPT 图片和视频的强大工具,支持智能转场和交互式播放
  3. <div align="center">
  4. ![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)
  5. ![License](https://img.shields.io/badge/license-MIT-green.svg)
  6. ![Python](https://img.shields.io/badge/python-3.8+-green.svg)
  7. **创作者**: [歸藏](https://github.com/op7418)
  8. [效果演示](#-效果演示) • [功能特性](#-功能特性) • [一键安装](#-一键安装) • [作为 Skill 使用](#-作为-claude-code-skill-使用) • [使用指南](#-使用指南) • [视频功能](#-视频功能) • [架构文档](ARCHITECTURE.md) • [常见问题](#-常见问题)
  9. </div>
  10. ---
  11. ## 🎬 效果演示
  12. <div align="center">
  13. https://github.com/user-attachments/assets/b394de21-2848-489a-8d33-a8e262e60f60
  14. *AI 自动生成 PPT 并添加流畅转场动画 - 从文档分析到视频合成一键完成*
  15. </div>
  16. ---
  17. ## 📖 简介
  18. NanoBanana PPT Skills 是一个强大的 AI 驱动的 PPT 生成工具,能够:
  19. - 📄 **智能分析文档**,自动提取核心要点并规划 PPT 结构
  20. - 🎨 **生成高质量图片**,使用 Google Nano Banana Pro(Gemini 3 Pro Image Preview)
  21. - 🎬 **自动生成转场视频**,使用可灵 AI 创建流畅的页面过渡动画
  22. - 🎮 **交互式视频播放器**,支持键盘控制、循环预览、智能转场
  23. - 🎥 **完整视频导出**,一键合成包含所有转场的完整 PPT 视频
  24. ### 🎨 视觉风格
  25. **渐变毛玻璃卡片风格**
  26. - 高端科技感,Apple Keynote 极简主义
  27. - 3D 玻璃物体 + 霓虹渐变
  28. - 电影级光照效果
  29. - 适合:科技产品、商务演示、数据报告
  30. **矢量插画风格**
  31. - 温暖扁平化设计,复古配色
  32. - 黑色轮廓线 + 几何化处理
  33. - 玩具模型般的可爱感
  34. - 适合:教育培训、创意提案、品牌故事
  35. ---
  36. ## ✨ 功能特性
  37. ### 🎯 核心能力
  38. - 🤖 **智能文档分析** - 自动提取核心要点,规划 PPT 内容结构
  39. - 🎨 **多风格支持** - 内置 2 种专业风格,可无限扩展
  40. - 🖼️ **高质量图片** - 16:9 比例,2K/4K 分辨率可选
  41. - 🎬 **AI 转场视频** - 可灵 AI 生成流畅的页面过渡动画
  42. - 🎮 **交互式播放器** - 视频+图片混合播放,支持键盘导航
  43. - 🎥 **完整视频导出** - FFmpeg 合成包含转场的完整 PPT 视频
  44. - 📊 **智能布局** - 封面页、内容页、数据页自动识别
  45. - ⚡ **快速生成** - 2K 约 30 秒/页
  46. ### 🆕 视频功能(v2.0)
  47. - 🎬 **首页循环预览** - 自动生成吸引眼球的循环动画
  48. - 🎞️ **智能转场** - 自动生成页面间的过渡视频
  49. - 🎮 **交互式播放** - 按键翻页时播放转场视频,结束后显示静态图片
  50. - 🎥 **完整视频导出** - 合成包含所有转场和静态页的完整视频
  51. - 🔧 **参数统一** - 自动统一所有视频分辨率和帧率,确保流畅播放
  52. ### 🛠️ 技术亮点
  53. - ✅ Google Nano Banana Pro(Gemini 3 Pro Image Preview)图像生成
  54. - ✅ 可灵 AI API 集成(视频生成、数字人、主体库)
  55. - ✅ FFmpeg 视频合成与参数统一
  56. - ✅ 完整的提示词工程和风格管理系统
  57. - ✅ 安全的 .env 环境变量管理
  58. - ✅ 模块化设计,易于扩展
  59. ---
  60. ## 🚀 一键安装
  61. ### 方法一:Claude Code 自动安装(推荐)
  62. **只需复制以下提示词,发送给 Claude Code,它会自动完成全部安装!**
  63. ```
  64. 请帮我安装 NanoBanana PPT Skills:
  65. 1. 克隆项目并进入目录:
  66. git clone https://github.com/op7418/NanoBanana-PPT-Skills.git
  67. cd NanoBanana-PPT-Skills
  68. 2. 创建 Python 虚拟环境:
  69. python3 -m venv venv
  70. source venv/bin/activate # Windows: venv\Scripts\activate
  71. 3. 安装依赖:
  72. pip install google-genai pillow python-dotenv
  73. 4. 配置 API 密钥 - 创建 .env 文件:
  74. cp .env.example .env
  75. 5. 编辑 .env 文件,填入我的 API 密钥:
  76. GEMINI_API_KEY=YOUR_GEMINI_API_KEY
  77. KLING_ACCESS_KEY=YOUR_KLING_ACCESS_KEY
  78. KLING_SECRET_KEY=YOUR_KLING_SECRET_KEY
  79. 注意:
  80. - GEMINI_API_KEY: Google AI API 密钥(必需,用于生成 PPT 图片)
  81. - KLING_ACCESS_KEY 和 KLING_SECRET_KEY: 可灵 AI 密钥(可选,用于生成转场视频)
  82. 6. 验证安装:
  83. python3 generate_ppt.py --help
  84. 完成后,告诉我安装结果和如何使用。
  85. 我的 API 密钥:
  86. - GEMINI_API_KEY: YOUR_GEMINI_API_KEY_HERE
  87. - KLING_ACCESS_KEY: YOUR_KLING_ACCESS_KEY_HERE (可选)
  88. - KLING_SECRET_KEY: YOUR_KLING_SECRET_KEY_HERE (可选)
  89. ```
  90. **使用说明**:
  91. 1. 先获取 API 密钥:
  92. - **必需**: [Google AI API 密钥](https://aistudio.google.com/apikey)
  93. - **可选**: [可灵 AI API 密钥](https://klingai.com)(用于视频转场功能)
  94. 2. 复制上面的提示词
  95. 3. 将 `YOUR_GEMINI_API_KEY_HERE` 等替换为你的真实 API 密钥
  96. 4. 发送给 Claude Code
  97. 5. Claude Code 会自动执行所有安装步骤并告知结果
  98. ### 方法二:手动安装
  99. 如果你想手动安装,按照以下步骤操作:
  100. #### 1. 克隆项目
  101. ```bash
  102. git clone https://github.com/op7418/NanoBanana-PPT-Skills.git
  103. cd NanoBanana-PPT-Skills
  104. ```
  105. #### 2. 创建虚拟环境
  106. ```bash
  107. python3 -m venv venv
  108. source venv/bin/activate # Windows: venv\Scripts\activate
  109. ```
  110. #### 3. 安装依赖
  111. ```bash
  112. pip install google-genai pillow
  113. ```
  114. 如果需要视频功能,还需要安装 FFmpeg:
  115. ```bash
  116. # macOS
  117. brew install ffmpeg
  118. # Ubuntu/Debian
  119. sudo apt-get install ffmpeg
  120. # Windows
  121. # 下载 FFmpeg 并添加到系统 PATH
  122. ```
  123. #### 4. 配置 API 密钥
  124. **推荐方式:.env 文件(已内置支持)**
  125. ```bash
  126. # 复制示例文件
  127. cp .env.example .env
  128. # 编辑 .env 文件
  129. nano .env # 或使用你喜欢的编辑器
  130. ```
  131. 在 `.env` 文件中填入你的 API 密钥:
  132. ```bash
  133. # Google AI API 密钥(必需)
  134. GEMINI_API_KEY=your_gemini_api_key_here
  135. # 可灵 AI API 密钥(可选,用于视频转场功能)
  136. KLING_ACCESS_KEY=your_kling_access_key_here
  137. KLING_SECRET_KEY=your_kling_secret_key_here
  138. ```
  139. **替代方式:系统环境变量**
  140. ```bash
  141. # zsh 用户 (macOS 默认)
  142. echo 'export GEMINI_API_KEY="your-api-key-here"' >> ~/.zshrc
  143. source ~/.zshrc
  144. # bash 用户
  145. echo 'export GEMINI_API_KEY="your-api-key-here"' >> ~/.bashrc
  146. source ~/.bashrc
  147. ```
  148. #### 5. 验证安装
  149. ```bash
  150. python3 generate_ppt.py --help
  151. ```
  152. 应该显示帮助信息,表示安装成功。
  153. ---
  154. ## 🎯 作为 Claude Code Skill 使用
  155. NanoBanana PPT Skills 完全支持 Claude Code Skill 标准,可以直接通过 Claude Code 调用。
  156. ### 快速安装为 Skill
  157. **方法一:Claude Code 自动安装为 Skill(最简单)**
  158. **只需复制以下提示词,发送给 Claude Code,它会自动完成 Skill 安装!**
  159. ```
  160. 请帮我将 NanoBanana PPT Skills 安装为 Claude Code Skill:
  161. 1. 创建 Skill 目录:
  162. mkdir -p ~/.claude/skills/ppt-generator
  163. 2. 克隆项目到 Skill 目录:
  164. git clone https://github.com/op7418/NanoBanana-PPT-Skills.git ~/.claude/skills/ppt-generator
  165. 3. 进入目录并安装依赖:
  166. cd ~/.claude/skills/ppt-generator
  167. python3 -m venv venv
  168. source venv/bin/activate
  169. pip install google-genai pillow python-dotenv
  170. 4. 配置 API 密钥:
  171. cp .env.example .env
  172. 然后编辑 .env 文件,填入我的 API 密钥:
  173. GEMINI_API_KEY=YOUR_GEMINI_API_KEY
  174. KLING_ACCESS_KEY=YOUR_KLING_ACCESS_KEY
  175. KLING_SECRET_KEY=YOUR_KLING_SECRET_KEY
  176. 5. 验证安装:
  177. python3 generate_ppt.py --help
  178. 完成后,告诉我如何在 Claude Code 中使用这个 Skill。
  179. 我的 API 密钥:
  180. - GEMINI_API_KEY: YOUR_GEMINI_API_KEY_HERE
  181. - KLING_ACCESS_KEY: YOUR_KLING_ACCESS_KEY_HERE (可选)
  182. - KLING_SECRET_KEY: YOUR_KLING_SECRET_KEY_HERE (可选)
  183. ```
  184. **方法二:使用安装脚本**
  185. ```bash
  186. # 克隆项目
  187. git clone https://github.com/op7418/NanoBanana-PPT-Skills.git
  188. cd NanoBanana-PPT-Skills
  189. # 运行安装脚本
  190. bash install_as_skill.sh
  191. ```
  192. 安装脚本会自动:
  193. 1. 创建 `~/.claude/skills/ppt-generator/` 目录
  194. 2. 复制所有必要文件
  195. 3. 安装 Python 依赖
  196. 4. 引导配置 API 密钥
  197. **方法三:手动安装**
  198. ```bash
  199. # 1. 创建 Skill 目录
  200. mkdir -p ~/.claude/skills/ppt-generator
  201. # 2. 克隆项目到 Skill 目录
  202. git clone https://github.com/op7418/NanoBanana-PPT-Skills.git ~/.claude/skills/ppt-generator
  203. # 3. 安装依赖
  204. cd ~/.claude/skills/ppt-generator
  205. pip install google-genai pillow python-dotenv
  206. # 4. 配置 API 密钥
  207. cp .env.example .env
  208. nano .env # 填入你的 API 密钥
  209. ```
  210. ### 环境变量配置
  211. Skill 会智能查找 `.env` 文件,按以下优先级:
  212. 1. **脚本所在目录** - `~/.claude/skills/ppt-generator/.env`
  213. 2. **向上查找项目根目录** - 直到找到包含 `.git` 或 `.env` 的目录
  214. 3. **用户主目录** - `~/.env`
  215. 4. **系统环境变量** - 作为最后的备选方案
  216. **推荐配置方式:**
  217. ```bash
  218. # 在 Skill 目录下创建 .env 文件
  219. cat > ~/.claude/skills/ppt-generator/.env << EOF
  220. # Google AI API 密钥(必需)
  221. GEMINI_API_KEY=your_gemini_api_key_here
  222. # 可灵 AI API 密钥(可选,用于视频功能)
  223. KLING_ACCESS_KEY=your_kling_access_key_here
  224. KLING_SECRET_KEY=your_kling_secret_key_here
  225. EOF
  226. ```
  227. ### 在 Claude Code 中使用
  228. 安装完成后,直接在 Claude Code 中调用:
  229. ```bash
  230. /ppt-generator-pro
  231. ```
  232. 或者告诉 Claude:
  233. ```
  234. 我想基于以下文档生成一个 5 页的 PPT,使用渐变毛玻璃风格。
  235. [文档内容...]
  236. ```
  237. Claude 会自动:
  238. 1. 分析文档内容
  239. 2. 询问风格、页数、分辨率等选项
  240. 3. 生成 slides_plan.json
  241. 4. 调用 generate_ppt.py 生成图片
  242. 5. (可选)生成转场视频
  243. 6. 返回结果路径
  244. ### Skill 模式 vs 独立模式
  245. | 特性 | Skill 模式 | 独立模式 |
  246. |------|-----------|---------|
  247. | 安装位置 | `~/.claude/skills/ppt-generator/` | 任意目录 |
  248. | 调用方式 | `/ppt-generator-pro` 或自然语言 | 手动执行 Python 脚本 |
  249. | 文档分析 | Claude 自动分析 | 需手动准备 JSON |
  250. | 交互体验 | 对话式,自动询问选项 | 命令行参数 |
  251. | .env 位置 | Skill 目录或项目根目录 | 脚本所在目录 |
  252. | 适用场景 | 日常使用,快速生成 | 批量生成,自动化脚本 |
  253. ### 详细使用文档
  254. 完整的 Skill 使用文档请参考 [SKILL.md](SKILL.md),包含:
  255. - 完整的执行流程
  256. - 用户输入收集策略
  257. - 内容规划方法
  258. - 错误处理指南
  259. - 最佳实践建议
  260. ---
  261. ## 💡 使用指南
  262. ### 基础使用:生成 PPT 图片
  263. #### 1. 准备内容规划文件
  264. 创建 `my_slides_plan.json`:
  265. ```json
  266. {
  267. "title": "AI 产品设计指南",
  268. "total_slides": 5,
  269. "slides": [
  270. {
  271. "slide_number": 1,
  272. "page_type": "cover",
  273. "content": "标题:AI 产品设计指南\n副标题:构建以用户为中心的智能体验"
  274. },
  275. {
  276. "slide_number": 2,
  277. "page_type": "content",
  278. "content": "核心原则\n- 简单直观\n- 快速响应\n- 透明可控"
  279. },
  280. {
  281. "slide_number": 3,
  282. "page_type": "content",
  283. "content": "设计流程\n1. 用户研究\n2. 原型设计\n3. 测试迭代"
  284. },
  285. {
  286. "slide_number": 4,
  287. "page_type": "data",
  288. "content": "用户满意度\n使用前:65%\n使用后:92%\n提升:+27%"
  289. },
  290. {
  291. "slide_number": 5,
  292. "page_type": "content",
  293. "content": "总结\n- 以用户为中心\n- 持续优化迭代\n- 数据驱动决策"
  294. }
  295. ]
  296. }
  297. ```
  298. #### 2. 生成 PPT 图片
  299. ```bash
  300. python3 generate_ppt.py \
  301. --plan my_slides_plan.json \
  302. --style styles/gradient-glass.md \
  303. --resolution 2K
  304. ```
  305. #### 3. 查看结果
  306. ```bash
  307. # 在浏览器中打开图片播放器
  308. open outputs/TIMESTAMP/index.html
  309. ```
  310. ### 高级使用:生成带转场视频的 PPT
  311. #### 1. 生成 PPT 图片
  312. ```bash
  313. python3 generate_ppt.py \
  314. --plan my_slides_plan.json \
  315. --style styles/gradient-glass.md \
  316. --resolution 2K
  317. ```
  318. #### 2. 使用 Claude Code 生成转场提示词(必需)
  319. 在 Claude Code 中执行:
  320. ```
  321. 我刚生成了 5 页 PPT 图片在 outputs/TIMESTAMP/images 目录下。
  322. 请帮我分析这些图片,为每个页面转场生成视频提示词,
  323. 保存为 outputs/TIMESTAMP/transition_prompts.json
  324. ```
  325. Claude Code 会:
  326. 1. 读取所有 PPT 图片
  327. 2. 分析每两页之间的视觉差异
  328. 3. 生成精准的转场描述
  329. 4. 保存为 JSON 文件
  330. #### 3. 生成转场视频
  331. ```bash
  332. python3 generate_ppt_video.py \
  333. --slides-dir outputs/TIMESTAMP/images \
  334. --output-dir outputs/TIMESTAMP_video \
  335. --prompts-file outputs/TIMESTAMP/transition_prompts.json
  336. ```
  337. 这会生成:
  338. - 首页循环预览视频
  339. - 每个页面间的转场视频
  340. - 交互式视频播放器 HTML
  341. - 完整视频 (full_ppt_video.mp4)
  342. #### 4. 播放交互式视频 PPT
  343. ```bash
  344. open outputs/TIMESTAMP_video/video_index.html
  345. ```
  346. **播放逻辑**:
  347. 1. 首页:播放循环预览视频
  348. 2. 按右键:播放转场视频 → 显示目标页图片(停留 2 秒)
  349. 3. 再按右键:播放下一个转场视频 → 显示下一页图片
  350. 4. 依此类推...
  351. #### 4. 导出完整视频(可选)
  352. 交互式播放器会自动生成完整视频:
  353. ```bash
  354. # 视频文件
  355. outputs/TIMESTAMP_video/full_ppt_video.mp4
  356. ```
  357. 完整视频包含:
  358. - 首页预览(如果有)
  359. - 转场视频 01→02
  360. - 第 2 页静态(2 秒)
  361. - 转场视频 02→03
  362. - 第 3 页静态(2 秒)
  363. - ...
  364. ---
  365. ## 🎬 视频功能
  366. ### 转场视频生成
  367. 使用可灵 AI 自动生成页面间的转场视频:
  368. ```bash
  369. python3 generate_ppt_video.py \
  370. --slides-dir outputs/20260111_160221/images \
  371. --output-dir outputs/20260111_video \
  372. --mode professional \
  373. --duration 5
  374. ```
  375. **参数说明**:
  376. - `--slides-dir`: PPT 图片目录
  377. - `--output-dir`: 输出目录
  378. - `--mode`: 转场模式(`professional` 或 `creative`)
  379. - `--duration`: 转场视频时长(秒,默认 5)
  380. ### 交互式播放器
  381. 生成的 `video_index.html` 支持:
  382. | 功能 | 快捷键 | 说明 |
  383. |------|--------|------|
  384. | 下一页 | `→` `↓` | 播放转场视频,然后显示下一页 |
  385. | 上一页 | `←` `↑` | 返回上一页(直接显示) |
  386. | 首页 | `Home` | 返回首页预览 |
  387. | 末页 | `End` | 跳到最后一页 |
  388. | 播放/暂停 | `空格` | 暂停/继续当前视频 |
  389. | 全屏 | `ESC` | 切换全屏模式 |
  390. | 隐藏控件 | `H` | 隐藏/显示控制提示 |
  391. ### 完整视频合成
  392. 使用 FFmpeg 自动合成完整视频:
  393. ```python
  394. from video_composer import VideoComposer
  395. composer = VideoComposer()
  396. composer.compose_full_ppt_video(
  397. slides_paths=[...],
  398. transitions_dict={...},
  399. output_path='output.mp4',
  400. slide_duration=2, # 每页停留 2 秒
  401. include_preview=True,
  402. preview_video_path='preview.mp4',
  403. resolution='1920x1080',
  404. fps=24
  405. )
  406. ```
  407. **特性**:
  408. - 自动统一所有视频的分辨率和帧率
  409. - 保持宽高比,添加黑边
  410. - 支持预览视频循环
  411. - 高质量 H.264 编码
  412. ---
  413. ## 🎨 风格库
  414. ### 已内置风格
  415. #### 1. 渐变毛玻璃卡片风格 (`gradient-glass.md`)
  416. **视觉特点**:
  417. - Apple Keynote 极简主义
  418. - 玻璃拟态效果
  419. - 霓虹紫/电光蓝/珊瑚橙渐变
  420. - 3D 玻璃物体 + 电影级光照
  421. **适用场景**:
  422. - 🚀 科技产品发布
  423. - 💼 商务演示
  424. - 📊 数据报告
  425. - 🏢 企业品牌展示
  426. #### 2. 矢量插画风格 (`vector-illustration.md`)
  427. **视觉特点**:
  428. - 扁平化矢量设计
  429. - 统一黑色轮廓线
  430. - 复古柔和配色
  431. - 几何化简化
  432. **适用场景**:
  433. - 📚 教育培训
  434. - 🎨 创意提案
  435. - 👶 儿童相关
  436. - 💖 温暖品牌故事
  437. ### 添加自定义风格
  438. 1. 在 `styles/` 目录创建新的 `.md` 文件
  439. 2. 按照模板编写风格定义(参考现有风格)
  440. 3. 直接使用新风格生成 PPT
  441. ---
  442. ## 📚 项目结构
  443. ```
  444. ppt-generator/
  445. ├── README.md # 本文件
  446. ├── API_MANAGEMENT.md # API 密钥管理指南
  447. ├── ENV_SETUP.md # 环境变量配置指南
  448. ├── SECURITY.md # 安全最佳实践
  449. ├── .env.example # 环境变量模板
  450. ├── .env # 实际环境变量(不提交到 Git)
  451. ├── .gitignore # Git 忽略规则
  452. │
  453. ├── generate_ppt.py # PPT 图片生成脚本
  454. ├── generate_ppt_video.py # 视频生成主脚本
  455. ├── kling_api.py # 可灵 AI API 封装
  456. ├── video_composer.py # FFmpeg 视频合成
  457. ├── video_materials.py # 视频素材管理
  458. ├── transition_prompt_generator.py # 转场提示词生成器
  459. │
  460. ├── styles/ # 风格库
  461. │ ├── gradient-glass.md # 渐变毛玻璃卡片风格
  462. │ └── vector-illustration.md # 矢量插画风格
  463. │
  464. ├── templates/ # HTML 模板
  465. │ ├── viewer.html # 图片播放器
  466. │ └── video_viewer.html # 视频播放器
  467. │
  468. ├── prompts/ # 提示词模板
  469. │ └── transition_base.md # 转场提示词基础模板
  470. │
  471. └── outputs/ # 生成结果(自动创建)
  472. ├── TIMESTAMP/ # 图片版本
  473. │ ├── images/ # PPT 图片
  474. │ ├── index.html # 图片播放器
  475. │ └── prompts.json # 生成提示词记录
  476. └── TIMESTAMP_video/ # 视频版本
  477. ├── videos/ # 转场视频
  478. ├── video_index.html # 视频播放器
  479. └── full_ppt_video.mp4 # 完整视频
  480. ```
  481. ---
  482. ## 🔧 配置选项
  483. ### 分辨率选择
  484. | 分辨率 | 尺寸 | 文件大小 | 生成速度 | 推荐场景 |
  485. |--------|------|----------|----------|----------|
  486. | 2K | 2752x1536 | ~2.5MB/页 | ~30秒/页 | 日常演示、在线分享 ✅ |
  487. | 4K | 5504x3072 | ~8MB/页 | ~60秒/页 | 打印输出、大屏展示 |
  488. ### 视频参数
  489. | 参数 | 默认值 | 说明 |
  490. |------|--------|------|
  491. | 分辨率 | 1920x1080 | 统一为 1080p,兼容可灵视频 |
  492. | 帧率 | 24fps | 统一帧率,确保流畅拼接 |
  493. | 静态图片时长 | 2秒 | 每页停留时间 |
  494. | 转场视频时长 | 5秒 | 可灵生成的转场时长 |
  495. ### 页数建议
  496. | 页数范围 | 演讲时长 | 适用场景 |
  497. |----------|----------|----------|
  498. | 5 页 | 5 分钟 | 电梯演讲、快速介绍 |
  499. | 5-10 页 | 10-15 分钟 | 标准演示、产品介绍 |
  500. | 10-15 页 | 20-30 分钟 | 深入讲解、培训课程 |
  501. | 20-25 页 | 45-60 分钟 | 完整培训、研讨会 |
  502. ---
  503. ## ❓ 常见问题
  504. ### Q: 如何获取 API 密钥?
  505. **A**:
  506. - **Google AI API**: 访问 [Google AI Studio](https://aistudio.google.com/apikey),登录后即可创建
  507. - **可灵 AI API**: 访问 [可灵 AI 开放平台](https://klingai.com),注册并创建应用获取密钥
  508. ### Q: 是否必须配置可灵 AI 密钥?
  509. **A**: 不是必须的。
  510. - **只生成 PPT 图片**:只需要 GEMINI_API_KEY
  511. - **生成转场视频**:需要 KLING_ACCESS_KEY 和 KLING_SECRET_KEY
  512. ### Q: 视频合成失败怎么办?
  513. **A**: 检查以下几点:
  514. 1. FFmpeg 是否已安装(`ffmpeg -version`)
  515. 2. 视频文件是否存在且完整
  516. 3. 磁盘空间是否充足
  517. 4. 查看详细错误信息
  518. ### Q: 如何修改静态图片展示时间?
  519. **A**: 在 `video_composer.py` 中修改 `slide_duration` 参数(默认 2 秒)
  520. ### Q: 转场视频生成很慢怎么办?
  521. **A**: 可灵 AI 生成视频需要一定时间(通常 30-60 秒/段)。可以:
  522. - 减少转场数量
  523. - 使用较短的转场时长
  524. - 分批生成
  525. ### Q: 可以导出为 PDF 吗?
  526. **A**: 可以。
  527. 1. 在浏览器中打开 `index.html`
  528. 2. 按 `Cmd+P` (Mac) 或 `Ctrl+P` (Windows)
  529. 3. 选择"另存为 PDF"
  530. ### Q: 生成的内容可以商用吗?
  531. **A**: 请查阅相关服务条款:
  532. - [Google AI 使用条款](https://ai.google.dev/terms)
  533. - [可灵 AI 使用条款](https://klingai.com/terms)
  534. 一般情况下,你拥有生成内容的使用权。
  535. ---
  536. ## 🛡️ 安全说明
  537. ### API 密钥安全
  538. 本项目采用 `.env` 文件管理 API 密钥,确保安全:
  539. - ✅ `.env` 文件已在 `.gitignore` 中,不会提交到 Git
  540. - ✅ 代码中无硬编码密钥
  541. - ✅ 支持系统环境变量作为备用方案
  542. - ✅ `.env.example` 提供配置模板
  543. **最佳实践**:
  544. ```bash
  545. # ✅ 正确:使用 .env 文件
  546. cp .env.example .env
  547. # 编辑 .env 填入真实密钥
  548. # ❌ 错误:直接在代码中写密钥
  549. GEMINI_API_KEY = "AIzaSy..." # 永远不要这样做!
  550. ```
  551. ### 提交前检查
  552. ```bash
  553. # 验证没有密钥泄露
  554. grep -r "AIzaSy\|ak-" --exclude-dir=.git --exclude-dir=venv .
  555. # 应该无输出
  556. # 检查 .env 文件是否被排除
  557. git status
  558. # 确认 .env 不在待提交列表中
  559. ```
  560. 详细说明请查看:
  561. - **API_MANAGEMENT.md** - API 密钥管理完整指南
  562. - **ENV_SETUP.md** - 环境变量配置指南
  563. - **SECURITY.md** - 安全最佳实践
  564. ---
  565. ## 📝 更新日志
  566. ### v2.0.0 (2026-01-11)
  567. - 🎬 **新增视频功能**
  568. - 可灵 AI 转场视频生成
  569. - 交互式视频播放器(视频+图片混合)
  570. - FFmpeg 完整视频合成
  571. - 首页循环预览视频
  572. - 🔧 **优化视频合成**
  573. - 自动统一分辨率和帧率
  574. - 修复视频拼接兼容性问题
  575. - 静态图片展示时间改为 2 秒
  576. - 🐛 **Bug 修复**
  577. - 修复预览模式状态管理问题
  578. - 修复 FFmpeg 滤镜参数格式错误
  579. - 📚 **文档更新**
  580. - 全面改写 README
  581. - 新增视频功能使用指南
  582. - 更新 API 密钥配置说明
  583. ### v1.0.0 (2026-01-09)
  584. - ✨ 首次发布
  585. - 🎨 内置 2 种专业风格
  586. - 🖼️ 支持 2K/4K 分辨率
  587. - 🎬 HTML5 图片播放器
  588. - 📊 智能文档分析
  589. - 🔐 安全的环境变量管理
  590. ---
  591. ## 🤝 贡献指南
  592. 欢迎贡献!你可以:
  593. ### 添加新风格
  594. 1. Fork 本项目
  595. 2. 在 `styles/` 创建新风格文件
  596. 3. 参考现有风格编写提示词
  597. 4. 测试生成效果
  598. 5. 提交 Pull Request
  599. ### 报告问题
  600. 在 [GitHub Issues](https://github.com/op7418/NanoBanana-PPT-Skills/issues) 提交问题,请包含:
  601. - 错误信息
  602. - 操作步骤
  603. - 系统环境
  604. - 日志文件(如有)
  605. ---
  606. ## 📄 许可证
  607. MIT License
  608. Copyright (c) 2026 歸藏
  609. Permission is hereby granted, free of charge, to any person obtaining a copy
  610. of this software and associated documentation files (the "Software"), to deal
  611. in the Software without restriction, including without limitation the rights
  612. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  613. copies of the Software, and to permit persons to whom the Software is
  614. furnished to do so, subject to the following conditions:
  615. The above copyright notice and this permission notice shall be included in all
  616. copies or substantial portions of the Software.
  617. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  618. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  619. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  620. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  621. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  622. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  623. SOFTWARE.
  624. ---
  625. ## 🙏 致谢
  626. - **Google Gemini Team** - 提供强大的 Nano Banana Pro 图像生成模型
  627. - **可灵 AI 团队** - 提供高质量的视频生成服务
  628. - **FFmpeg 项目** - 提供强大的视频处理工具
  629. - **开源社区** - 提供的各种工具和灵感
  630. ---
  631. ## 📞 联系方式
  632. - **创作者**: 歸藏
  633. - **GitHub**: [@op7418](https://github.com/op7418)
  634. - **Issues**: [GitHub Issues](https://github.com/op7418/NanoBanana-PPT-Skills/issues)
  635. ---
  636. <div align="center">
  637. **⭐ 如果这个项目对你有帮助,请给一个 Star!**
  638. Made with ❤️ by 歸藏 | Powered by Google Gemini & 可灵 AI & FFmpeg
  639. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.