NanoBanana PPT Skills 使用说明

1. 它解决什么问题

用 Google Gemini 3 Pro Image（Nano Banana Pro） 把文档/大纲变成 16:9 高清幻灯片图片，并可选 可灵 AI 生成页间转场视频，FFmpeg 合成完整演示视频。

与归藏 HTML Deck 不同，NanoBanana 偏 Keynote 级视觉出图 + 视频路演：

• 智能分析文档 → 规划 slides_plan.json
• 2K/4K 单页图片（~30 秒/页 @ 2K）
• 渐变毛玻璃 / 矢量插画两套专业风格
• v2.0：首页循环预览、交互式 video_index.html、一键 full_ppt_video.mp4

2. 环境要求

3. 安装

快速克隆

git clone https://github.com/op7418/NanoBanana-PPT-Skills.git
cd NanoBanana-PPT-Skills
python3 -m venv venv && source venv/bin/activate
pip install google-genai pillow python-dotenv
cp .env.example .env
# 编辑 .env 填入 GEMINI_API_KEY
python3 generate_ppt.py --help

安装为 Claude Code Skill（推荐）

bash install_as_skill.sh
# 或
mkdir -p ~/.claude/skills/ppt-generator
git clone https://github.com/op7418/NanoBanana-PPT-Skills.git ~/.claude/skills/ppt-generator
cd ~/.claude/skills/ppt-generator && pip install google-genai pillow python-dotenv
cp .env.example .env

Cursor 项目级： 复制到 <project>/.cursor/skills/ 或 .claude/skills/，保留 SKILL.md 与脚本。

.env 示例

GEMINI_API_KEY=your_gemini_api_key_here
KLING_ACCESS_KEY=your_kling_access_key_here   # 可选
KLING_SECRET_KEY=your_kling_secret_key_here   # 可选

Skill 会按顺序查找：脚本目录 → 项目根 → ~/.claude/skills/ppt-generator/.env → 系统环境变量。

4. 使用流程（六阶段）

Claude Code 调用

/ppt-generator-pro

或自然语言：

基于 AI-Product-Design.md 生成 10 页 PPT，渐变毛玻璃风格，2K，需要转场视频。

5. 命令行示例

仅图片：

python generate_ppt.py \
  --plan slides_plan.json \
  --style styles/gradient-glass.md \
  --resolution 2K

图片 + 转场视频：

python generate_ppt_video.py \
  --slides-dir outputs/20260112_143022/images \
  --output-dir outputs/20260112_143022_video \
  --prompts-file outputs/20260112_143022/transition_prompts.json

一键脚本：

bash run.sh

6. 内置风格

自定义：在 styles/ 新建 .md，Skill 自动识别。

渐变毛玻璃： Apple Keynote 极简、3D 玻璃 + 霓虹渐变、电影级光照

矢量插画： 扁平复古配色、黑色轮廓线、几何简化

7. 输出结构

仅图片：

outputs/20260112_143022/
├── images/slide-01.png ...
├── index.html          # 图片播放器
└── prompts.json

视频模式：

outputs/..._video/
├── videos/preview.mp4, transition_01_to_02.mp4 ...
├── video_index.html    # 交互式播放器
└── full_ppt_video.mp4  # 完整合成

播放器快捷键

8. Prompt 示例

5 页快速（矢量插画，仅图）：

基于 Q1 产品路线图会议纪要生成 5 页 PPT：
1 用户反馈 2 新功能优先级 3 技术评估 4 Q1 里程碑 5 行动项
矢量插画风格，2K，不要视频。

15 页 + 转场（毛玻璃）：

读取 product-whitepaper.md，15 页渐变毛玻璃，4K，需要可灵转场和完整 MP4。

Antigravity 工作流： 见仓库 ANTIGRAVITY_WORKFLOW.md。

9. 技术参数

10. 平台支持

11. 适合 / 不适合

✅ 科技 Keynote 风路演、精美页图 + 转场视频、文档快速可视化、社媒向幻灯片视频

❌ 需要原生可编辑 PPTX（→ Gorden / Aham / PPTAgent）

❌ 无 API 密钥或纯浏览器一键出稿

❌ 大段表格数据精确排版（偏视觉叙事）

12. 与归藏 PPT Skill 对比

同一作者（歸藏），可按场景互补使用。

13. 常见问题

Q：输出是 PPTX 吗？

否。PNG + HTML；视频模式另含 MP4。如需 PPTX 需另做转换。

Q：没有可灵密钥能用吗？

能。只配置 GEMINI_API_KEY 即可出图与 index.html 播放。

Q：ModuleNotFoundError: google.genai

pip install google-genai pillow python-dotenv

Q：FFmpeg 不可用

macOS: brew install ffmpeg；Ubuntu: sudo apt-get install ffmpeg

14. 延伸阅读

• README.md
• SKILL.md
• QUICKSTART.md
• ARCHITECTURE.md
• API_MANAGEMENT.md