[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74121":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":16,"starSnapshotCount":16,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},74121,"NanoBanana-PPT-Skills","op7418\u002FNanoBanana-PPT-Skills","op7418","NanoBanana PPT Skills 基于 AI 自动生成高质量 PPT 图片和视频的强大工具，支持智能转场和交互式播放","",null,"Python",2955,330,7,4,0,26,94,334,78,106.56,false,"main",true,[],"2026-06-12 04:01:13","# NanoBanana PPT Skills\n\n> 基于 AI 自动生成高质量 PPT 图片和视频的强大工具，支持智能转场和交互式播放\n\n\u003Cdiv align=\"center\">\n\n![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.0.0-blue.svg)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)\n![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.8+-green.svg)\n\n**创作者**: [歸藏](https:\u002F\u002Fgithub.com\u002Fop7418)\n\n[效果演示](#-效果演示) • [功能特性](#-功能特性) • [一键安装](#-一键安装) • [作为 Skill 使用](#-作为-claude-code-skill-使用) • [使用指南](#-使用指南) • [视频功能](#-视频功能) • [架构文档](ARCHITECTURE.md) • [常见问题](#-常见问题)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🎬 效果演示\n\n\u003Cdiv align=\"center\">\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb394de21-2848-489a-8d33-a8e262e60f60\n\n*AI 自动生成 PPT 并添加流畅转场动画 - 从文档分析到视频合成一键完成*\n\n\u003C\u002Fdiv>\n\n---\n\n## 📖 简介\n\nNanoBanana PPT Skills 是一个强大的 AI 驱动的 PPT 生成工具，能够：\n\n- 📄 **智能分析文档**，自动提取核心要点并规划 PPT 结构\n- 🎨 **生成高质量图片**，使用 Google Nano Banana Pro（Gemini 3 Pro Image Preview）\n- 🎬 **自动生成转场视频**，使用可灵 AI 创建流畅的页面过渡动画\n- 🎮 **交互式视频播放器**，支持键盘控制、循环预览、智能转场\n- 🎥 **完整视频导出**，一键合成包含所有转场的完整 PPT 视频\n\n### 🎨 视觉风格\n\n**渐变毛玻璃卡片风格**\n- 高端科技感，Apple Keynote 极简主义\n- 3D 玻璃物体 + 霓虹渐变\n- 电影级光照效果\n- 适合：科技产品、商务演示、数据报告\n\n**矢量插画风格**\n- 温暖扁平化设计，复古配色\n- 黑色轮廓线 + 几何化处理\n- 玩具模型般的可爱感\n- 适合：教育培训、创意提案、品牌故事\n\n---\n\n## ✨ 功能特性\n\n### 🎯 核心能力\n\n- 🤖 **智能文档分析** - 自动提取核心要点，规划 PPT 内容结构\n- 🎨 **多风格支持** - 内置 2 种专业风格，可无限扩展\n- 🖼️ **高质量图片** - 16:9 比例，2K\u002F4K 分辨率可选\n- 🎬 **AI 转场视频** - 可灵 AI 生成流畅的页面过渡动画\n- 🎮 **交互式播放器** - 视频+图片混合播放，支持键盘导航\n- 🎥 **完整视频导出** - FFmpeg 合成包含转场的完整 PPT 视频\n- 📊 **智能布局** - 封面页、内容页、数据页自动识别\n- ⚡ **快速生成** - 2K 约 30 秒\u002F页\n\n### 🆕 视频功能（v2.0）\n\n- 🎬 **首页循环预览** - 自动生成吸引眼球的循环动画\n- 🎞️ **智能转场** - 自动生成页面间的过渡视频\n- 🎮 **交互式播放** - 按键翻页时播放转场视频，结束后显示静态图片\n- 🎥 **完整视频导出** - 合成包含所有转场和静态页的完整视频\n- 🔧 **参数统一** - 自动统一所有视频分辨率和帧率，确保流畅播放\n\n### 🛠️ 技术亮点\n\n- ✅ Google Nano Banana Pro（Gemini 3 Pro Image Preview）图像生成\n- ✅ 可灵 AI API 集成（视频生成、数字人、主体库）\n- ✅ FFmpeg 视频合成与参数统一\n- ✅ 完整的提示词工程和风格管理系统\n- ✅ 安全的 .env 环境变量管理\n- ✅ 模块化设计，易于扩展\n\n---\n\n## 🚀 一键安装\n\n### 方法一：Claude Code 自动安装（推荐）\n\n**只需复制以下提示词，发送给 Claude Code，它会自动完成全部安装！**\n\n```\n请帮我安装 NanoBanana PPT Skills：\n\n1. 克隆项目并进入目录：\n   git clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills.git\n   cd NanoBanana-PPT-Skills\n\n2. 创建 Python 虚拟环境：\n   python3 -m venv venv\n   source venv\u002Fbin\u002Factivate  # Windows: venv\\Scripts\\activate\n\n3. 安装依赖：\n   pip install google-genai pillow python-dotenv\n\n4. 配置 API 密钥 - 创建 .env 文件：\n   cp .env.example .env\n\n5. 编辑 .env 文件，填入我的 API 密钥：\n\n   GEMINI_API_KEY=YOUR_GEMINI_API_KEY\n   KLING_ACCESS_KEY=YOUR_KLING_ACCESS_KEY\n   KLING_SECRET_KEY=YOUR_KLING_SECRET_KEY\n\n   注意：\n   - GEMINI_API_KEY: Google AI API 密钥（必需，用于生成 PPT 图片）\n   - KLING_ACCESS_KEY 和 KLING_SECRET_KEY: 可灵 AI 密钥（可选，用于生成转场视频）\n\n6. 验证安装：\n   python3 generate_ppt.py --help\n\n完成后，告诉我安装结果和如何使用。\n\n我的 API 密钥：\n- GEMINI_API_KEY: YOUR_GEMINI_API_KEY_HERE\n- KLING_ACCESS_KEY: YOUR_KLING_ACCESS_KEY_HERE (可选)\n- KLING_SECRET_KEY: YOUR_KLING_SECRET_KEY_HERE (可选)\n```\n\n**使用说明**：\n1. 先获取 API 密钥：\n   - **必需**: [Google AI API 密钥](https:\u002F\u002Faistudio.google.com\u002Fapikey)\n   - **可选**: [可灵 AI API 密钥](https:\u002F\u002Fklingai.com)（用于视频转场功能）\n2. 复制上面的提示词\n3. 将 `YOUR_GEMINI_API_KEY_HERE` 等替换为你的真实 API 密钥\n4. 发送给 Claude Code\n5. Claude Code 会自动执行所有安装步骤并告知结果\n\n### 方法二：手动安装\n\n如果你想手动安装，按照以下步骤操作：\n\n#### 1. 克隆项目\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills.git\ncd NanoBanana-PPT-Skills\n```\n\n#### 2. 创建虚拟环境\n\n```bash\npython3 -m venv venv\nsource venv\u002Fbin\u002Factivate  # Windows: venv\\Scripts\\activate\n```\n\n#### 3. 安装依赖\n\n```bash\npip install google-genai pillow\n```\n\n如果需要视频功能，还需要安装 FFmpeg：\n\n```bash\n# macOS\nbrew install ffmpeg\n\n# Ubuntu\u002FDebian\nsudo apt-get install ffmpeg\n\n# Windows\n# 下载 FFmpeg 并添加到系统 PATH\n```\n\n#### 4. 配置 API 密钥\n\n**推荐方式：.env 文件（已内置支持）**\n\n```bash\n# 复制示例文件\ncp .env.example .env\n\n# 编辑 .env 文件\nnano .env  # 或使用你喜欢的编辑器\n```\n\n在 `.env` 文件中填入你的 API 密钥：\n\n```bash\n# Google AI API 密钥（必需）\nGEMINI_API_KEY=your_gemini_api_key_here\n\n# 可灵 AI API 密钥（可选，用于视频转场功能）\nKLING_ACCESS_KEY=your_kling_access_key_here\nKLING_SECRET_KEY=your_kling_secret_key_here\n```\n\n**替代方式：系统环境变量**\n\n```bash\n# zsh 用户 (macOS 默认)\necho 'export GEMINI_API_KEY=\"your-api-key-here\"' >> ~\u002F.zshrc\nsource ~\u002F.zshrc\n\n# bash 用户\necho 'export GEMINI_API_KEY=\"your-api-key-here\"' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\n```\n\n#### 5. 验证安装\n\n```bash\npython3 generate_ppt.py --help\n```\n\n应该显示帮助信息，表示安装成功。\n\n---\n\n## 🎯 作为 Claude Code Skill 使用\n\nNanoBanana PPT Skills 完全支持 Claude Code Skill 标准，可以直接通过 Claude Code 调用。\n\n### 快速安装为 Skill\n\n**方法一：Claude Code 自动安装为 Skill（最简单）**\n\n**只需复制以下提示词，发送给 Claude Code，它会自动完成 Skill 安装！**\n\n```\n请帮我将 NanoBanana PPT Skills 安装为 Claude Code Skill：\n\n1. 创建 Skill 目录：\n   mkdir -p ~\u002F.claude\u002Fskills\u002Fppt-generator\n\n2. 克隆项目到 Skill 目录：\n   git clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills.git ~\u002F.claude\u002Fskills\u002Fppt-generator\n\n3. 进入目录并安装依赖：\n   cd ~\u002F.claude\u002Fskills\u002Fppt-generator\n   python3 -m venv venv\n   source venv\u002Fbin\u002Factivate\n   pip install google-genai pillow python-dotenv\n\n4. 配置 API 密钥：\n   cp .env.example .env\n\n   然后编辑 .env 文件，填入我的 API 密钥：\n   GEMINI_API_KEY=YOUR_GEMINI_API_KEY\n   KLING_ACCESS_KEY=YOUR_KLING_ACCESS_KEY\n   KLING_SECRET_KEY=YOUR_KLING_SECRET_KEY\n\n5. 验证安装：\n   python3 generate_ppt.py --help\n\n完成后，告诉我如何在 Claude Code 中使用这个 Skill。\n\n我的 API 密钥：\n- GEMINI_API_KEY: YOUR_GEMINI_API_KEY_HERE\n- KLING_ACCESS_KEY: YOUR_KLING_ACCESS_KEY_HERE (可选)\n- KLING_SECRET_KEY: YOUR_KLING_SECRET_KEY_HERE (可选)\n```\n\n**方法二：使用安装脚本**\n\n```bash\n# 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills.git\ncd NanoBanana-PPT-Skills\n\n# 运行安装脚本\nbash install_as_skill.sh\n```\n\n安装脚本会自动：\n1. 创建 `~\u002F.claude\u002Fskills\u002Fppt-generator\u002F` 目录\n2. 复制所有必要文件\n3. 安装 Python 依赖\n4. 引导配置 API 密钥\n\n**方法三：手动安装**\n\n```bash\n# 1. 创建 Skill 目录\nmkdir -p ~\u002F.claude\u002Fskills\u002Fppt-generator\n\n# 2. 克隆项目到 Skill 目录\ngit clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills.git ~\u002F.claude\u002Fskills\u002Fppt-generator\n\n# 3. 安装依赖\ncd ~\u002F.claude\u002Fskills\u002Fppt-generator\npip install google-genai pillow python-dotenv\n\n# 4. 配置 API 密钥\ncp .env.example .env\nnano .env  # 填入你的 API 密钥\n```\n\n### 环境变量配置\n\nSkill 会智能查找 `.env` 文件，按以下优先级：\n\n1. **脚本所在目录** - `~\u002F.claude\u002Fskills\u002Fppt-generator\u002F.env`\n2. **向上查找项目根目录** - 直到找到包含 `.git` 或 `.env` 的目录\n3. **用户主目录** - `~\u002F.env`\n4. **系统环境变量** - 作为最后的备选方案\n\n**推荐配置方式：**\n\n```bash\n# 在 Skill 目录下创建 .env 文件\ncat > ~\u002F.claude\u002Fskills\u002Fppt-generator\u002F.env \u003C\u003C EOF\n# Google AI API 密钥（必需）\nGEMINI_API_KEY=your_gemini_api_key_here\n\n# 可灵 AI API 密钥（可选，用于视频功能）\nKLING_ACCESS_KEY=your_kling_access_key_here\nKLING_SECRET_KEY=your_kling_secret_key_here\nEOF\n```\n\n### 在 Claude Code 中使用\n\n安装完成后，直接在 Claude Code 中调用：\n\n```bash\n\u002Fppt-generator-pro\n```\n\n或者告诉 Claude：\n\n```\n我想基于以下文档生成一个 5 页的 PPT，使用渐变毛玻璃风格。\n\n[文档内容...]\n```\n\nClaude 会自动：\n1. 分析文档内容\n2. 询问风格、页数、分辨率等选项\n3. 生成 slides_plan.json\n4. 调用 generate_ppt.py 生成图片\n5. （可选）生成转场视频\n6. 返回结果路径\n\n### Skill 模式 vs 独立模式\n\n| 特性 | Skill 模式 | 独立模式 |\n|------|-----------|---------|\n| 安装位置 | `~\u002F.claude\u002Fskills\u002Fppt-generator\u002F` | 任意目录 |\n| 调用方式 | `\u002Fppt-generator-pro` 或自然语言 | 手动执行 Python 脚本 |\n| 文档分析 | Claude 自动分析 | 需手动准备 JSON |\n| 交互体验 | 对话式，自动询问选项 | 命令行参数 |\n| .env 位置 | Skill 目录或项目根目录 | 脚本所在目录 |\n| 适用场景 | 日常使用，快速生成 | 批量生成，自动化脚本 |\n\n### 详细使用文档\n\n完整的 Skill 使用文档请参考 [SKILL.md](SKILL.md)，包含：\n- 完整的执行流程\n- 用户输入收集策略\n- 内容规划方法\n- 错误处理指南\n- 最佳实践建议\n\n---\n\n## 💡 使用指南\n\n### 基础使用：生成 PPT 图片\n\n#### 1. 准备内容规划文件\n\n创建 `my_slides_plan.json`：\n\n```json\n{\n  \"title\": \"AI 产品设计指南\",\n  \"total_slides\": 5,\n  \"slides\": [\n    {\n      \"slide_number\": 1,\n      \"page_type\": \"cover\",\n      \"content\": \"标题：AI 产品设计指南\\n副标题：构建以用户为中心的智能体验\"\n    },\n    {\n      \"slide_number\": 2,\n      \"page_type\": \"content\",\n      \"content\": \"核心原则\\n- 简单直观\\n- 快速响应\\n- 透明可控\"\n    },\n    {\n      \"slide_number\": 3,\n      \"page_type\": \"content\",\n      \"content\": \"设计流程\\n1. 用户研究\\n2. 原型设计\\n3. 测试迭代\"\n    },\n    {\n      \"slide_number\": 4,\n      \"page_type\": \"data\",\n      \"content\": \"用户满意度\\n使用前：65%\\n使用后：92%\\n提升：+27%\"\n    },\n    {\n      \"slide_number\": 5,\n      \"page_type\": \"content\",\n      \"content\": \"总结\\n- 以用户为中心\\n- 持续优化迭代\\n- 数据驱动决策\"\n    }\n  ]\n}\n```\n\n#### 2. 生成 PPT 图片\n\n```bash\npython3 generate_ppt.py \\\n  --plan my_slides_plan.json \\\n  --style styles\u002Fgradient-glass.md \\\n  --resolution 2K\n```\n\n#### 3. 查看结果\n\n```bash\n# 在浏览器中打开图片播放器\nopen outputs\u002FTIMESTAMP\u002Findex.html\n```\n\n### 高级使用：生成带转场视频的 PPT\n\n#### 1. 生成 PPT 图片\n\n```bash\npython3 generate_ppt.py \\\n  --plan my_slides_plan.json \\\n  --style styles\u002Fgradient-glass.md \\\n  --resolution 2K\n```\n\n#### 2. 使用 Claude Code 生成转场提示词（必需）\n\n在 Claude Code 中执行：\n\n```\n我刚生成了 5 页 PPT 图片在 outputs\u002FTIMESTAMP\u002Fimages 目录下。\n请帮我分析这些图片，为每个页面转场生成视频提示词，\n保存为 outputs\u002FTIMESTAMP\u002Ftransition_prompts.json\n```\n\nClaude Code 会：\n1. 读取所有 PPT 图片\n2. 分析每两页之间的视觉差异\n3. 生成精准的转场描述\n4. 保存为 JSON 文件\n\n#### 3. 生成转场视频\n\n```bash\npython3 generate_ppt_video.py \\\n  --slides-dir outputs\u002FTIMESTAMP\u002Fimages \\\n  --output-dir outputs\u002FTIMESTAMP_video \\\n  --prompts-file outputs\u002FTIMESTAMP\u002Ftransition_prompts.json\n```\n\n这会生成：\n- 首页循环预览视频\n- 每个页面间的转场视频\n- 交互式视频播放器 HTML\n- 完整视频 (full_ppt_video.mp4)\n\n#### 4. 播放交互式视频 PPT\n\n```bash\nopen outputs\u002FTIMESTAMP_video\u002Fvideo_index.html\n```\n\n**播放逻辑**：\n1. 首页：播放循环预览视频\n2. 按右键：播放转场视频 → 显示目标页图片（停留 2 秒）\n3. 再按右键：播放下一个转场视频 → 显示下一页图片\n4. 依此类推...\n\n#### 4. 导出完整视频（可选）\n\n交互式播放器会自动生成完整视频：\n\n```bash\n# 视频文件\noutputs\u002FTIMESTAMP_video\u002Ffull_ppt_video.mp4\n```\n\n完整视频包含：\n- 首页预览（如果有）\n- 转场视频 01→02\n- 第 2 页静态（2 秒）\n- 转场视频 02→03\n- 第 3 页静态（2 秒）\n- ...\n\n---\n\n## 🎬 视频功能\n\n### 转场视频生成\n\n使用可灵 AI 自动生成页面间的转场视频：\n\n```bash\npython3 generate_ppt_video.py \\\n  --slides-dir outputs\u002F20260111_160221\u002Fimages \\\n  --output-dir outputs\u002F20260111_video \\\n  --mode professional \\\n  --duration 5\n```\n\n**参数说明**：\n- `--slides-dir`: PPT 图片目录\n- `--output-dir`: 输出目录\n- `--mode`: 转场模式（`professional` 或 `creative`）\n- `--duration`: 转场视频时长（秒，默认 5）\n\n### 交互式播放器\n\n生成的 `video_index.html` 支持：\n\n| 功能 | 快捷键 | 说明 |\n|------|--------|------|\n| 下一页 | `→` `↓` | 播放转场视频，然后显示下一页 |\n| 上一页 | `←` `↑` | 返回上一页（直接显示） |\n| 首页 | `Home` | 返回首页预览 |\n| 末页 | `End` | 跳到最后一页 |\n| 播放\u002F暂停 | `空格` | 暂停\u002F继续当前视频 |\n| 全屏 | `ESC` | 切换全屏模式 |\n| 隐藏控件 | `H` | 隐藏\u002F显示控制提示 |\n\n### 完整视频合成\n\n使用 FFmpeg 自动合成完整视频：\n\n```python\nfrom video_composer import VideoComposer\n\ncomposer = VideoComposer()\ncomposer.compose_full_ppt_video(\n    slides_paths=[...],\n    transitions_dict={...},\n    output_path='output.mp4',\n    slide_duration=2,  # 每页停留 2 秒\n    include_preview=True,\n    preview_video_path='preview.mp4',\n    resolution='1920x1080',\n    fps=24\n)\n```\n\n**特性**：\n- 自动统一所有视频的分辨率和帧率\n- 保持宽高比，添加黑边\n- 支持预览视频循环\n- 高质量 H.264 编码\n\n---\n\n## 🎨 风格库\n\n### 已内置风格\n\n#### 1. 渐变毛玻璃卡片风格 (`gradient-glass.md`)\n\n**视觉特点**：\n- Apple Keynote 极简主义\n- 玻璃拟态效果\n- 霓虹紫\u002F电光蓝\u002F珊瑚橙渐变\n- 3D 玻璃物体 + 电影级光照\n\n**适用场景**：\n- 🚀 科技产品发布\n- 💼 商务演示\n- 📊 数据报告\n- 🏢 企业品牌展示\n\n#### 2. 矢量插画风格 (`vector-illustration.md`)\n\n**视觉特点**：\n- 扁平化矢量设计\n- 统一黑色轮廓线\n- 复古柔和配色\n- 几何化简化\n\n**适用场景**：\n- 📚 教育培训\n- 🎨 创意提案\n- 👶 儿童相关\n- 💖 温暖品牌故事\n\n### 添加自定义风格\n\n1. 在 `styles\u002F` 目录创建新的 `.md` 文件\n2. 按照模板编写风格定义（参考现有风格）\n3. 直接使用新风格生成 PPT\n\n---\n\n## 📚 项目结构\n\n```\nppt-generator\u002F\n├── README.md                      # 本文件\n├── API_MANAGEMENT.md              # API 密钥管理指南\n├── ENV_SETUP.md                   # 环境变量配置指南\n├── SECURITY.md                    # 安全最佳实践\n├── .env.example                   # 环境变量模板\n├── .env                          # 实际环境变量（不提交到 Git）\n├── .gitignore                    # Git 忽略规则\n│\n├── generate_ppt.py               # PPT 图片生成脚本\n├── generate_ppt_video.py         # 视频生成主脚本\n├── kling_api.py                  # 可灵 AI API 封装\n├── video_composer.py             # FFmpeg 视频合成\n├── video_materials.py            # 视频素材管理\n├── transition_prompt_generator.py # 转场提示词生成器\n│\n├── styles\u002F                       # 风格库\n│   ├── gradient-glass.md         # 渐变毛玻璃卡片风格\n│   └── vector-illustration.md    # 矢量插画风格\n│\n├── templates\u002F                    # HTML 模板\n│   ├── viewer.html              # 图片播放器\n│   └── video_viewer.html        # 视频播放器\n│\n├── prompts\u002F                      # 提示词模板\n│   └── transition_base.md       # 转场提示词基础模板\n│\n└── outputs\u002F                      # 生成结果（自动创建）\n    ├── TIMESTAMP\u002F               # 图片版本\n    │   ├── images\u002F             # PPT 图片\n    │   ├── index.html          # 图片播放器\n    │   └── prompts.json        # 生成提示词记录\n    └── TIMESTAMP_video\u002F         # 视频版本\n        ├── videos\u002F             # 转场视频\n        ├── video_index.html    # 视频播放器\n        └── full_ppt_video.mp4  # 完整视频\n```\n\n---\n\n## 🔧 配置选项\n\n### 分辨率选择\n\n| 分辨率 | 尺寸 | 文件大小 | 生成速度 | 推荐场景 |\n|--------|------|----------|----------|----------|\n| 2K | 2752x1536 | ~2.5MB\u002F页 | ~30秒\u002F页 | 日常演示、在线分享 ✅ |\n| 4K | 5504x3072 | ~8MB\u002F页 | ~60秒\u002F页 | 打印输出、大屏展示 |\n\n### 视频参数\n\n| 参数 | 默认值 | 说明 |\n|------|--------|------|\n| 分辨率 | 1920x1080 | 统一为 1080p，兼容可灵视频 |\n| 帧率 | 24fps | 统一帧率，确保流畅拼接 |\n| 静态图片时长 | 2秒 | 每页停留时间 |\n| 转场视频时长 | 5秒 | 可灵生成的转场时长 |\n\n### 页数建议\n\n| 页数范围 | 演讲时长 | 适用场景 |\n|----------|----------|----------|\n| 5 页 | 5 分钟 | 电梯演讲、快速介绍 |\n| 5-10 页 | 10-15 分钟 | 标准演示、产品介绍 |\n| 10-15 页 | 20-30 分钟 | 深入讲解、培训课程 |\n| 20-25 页 | 45-60 分钟 | 完整培训、研讨会 |\n\n---\n\n## ❓ 常见问题\n\n### Q: 如何获取 API 密钥？\n\n**A**:\n- **Google AI API**: 访问 [Google AI Studio](https:\u002F\u002Faistudio.google.com\u002Fapikey)，登录后即可创建\n- **可灵 AI API**: 访问 [可灵 AI 开放平台](https:\u002F\u002Fklingai.com)，注册并创建应用获取密钥\n\n### Q: 是否必须配置可灵 AI 密钥？\n\n**A**: 不是必须的。\n- **只生成 PPT 图片**：只需要 GEMINI_API_KEY\n- **生成转场视频**：需要 KLING_ACCESS_KEY 和 KLING_SECRET_KEY\n\n### Q: 视频合成失败怎么办？\n\n**A**: 检查以下几点：\n1. FFmpeg 是否已安装（`ffmpeg -version`）\n2. 视频文件是否存在且完整\n3. 磁盘空间是否充足\n4. 查看详细错误信息\n\n### Q: 如何修改静态图片展示时间？\n\n**A**: 在 `video_composer.py` 中修改 `slide_duration` 参数（默认 2 秒）\n\n### Q: 转场视频生成很慢怎么办？\n\n**A**: 可灵 AI 生成视频需要一定时间（通常 30-60 秒\u002F段）。可以：\n- 减少转场数量\n- 使用较短的转场时长\n- 分批生成\n\n### Q: 可以导出为 PDF 吗？\n\n**A**: 可以。\n1. 在浏览器中打开 `index.html`\n2. 按 `Cmd+P` (Mac) 或 `Ctrl+P` (Windows)\n3. 选择\"另存为 PDF\"\n\n### Q: 生成的内容可以商用吗？\n\n**A**: 请查阅相关服务条款：\n- [Google AI 使用条款](https:\u002F\u002Fai.google.dev\u002Fterms)\n- [可灵 AI 使用条款](https:\u002F\u002Fklingai.com\u002Fterms)\n\n一般情况下，你拥有生成内容的使用权。\n\n---\n\n## 🛡️ 安全说明\n\n### API 密钥安全\n\n本项目采用 `.env` 文件管理 API 密钥，确保安全：\n\n- ✅ `.env` 文件已在 `.gitignore` 中，不会提交到 Git\n- ✅ 代码中无硬编码密钥\n- ✅ 支持系统环境变量作为备用方案\n- ✅ `.env.example` 提供配置模板\n\n**最佳实践**：\n\n```bash\n# ✅ 正确：使用 .env 文件\ncp .env.example .env\n# 编辑 .env 填入真实密钥\n\n# ❌ 错误：直接在代码中写密钥\nGEMINI_API_KEY = \"AIzaSy...\" # 永远不要这样做！\n```\n\n### 提交前检查\n\n```bash\n# 验证没有密钥泄露\ngrep -r \"AIzaSy\\|ak-\" --exclude-dir=.git --exclude-dir=venv .\n# 应该无输出\n\n# 检查 .env 文件是否被排除\ngit status\n# 确认 .env 不在待提交列表中\n```\n\n详细说明请查看：\n- **API_MANAGEMENT.md** - API 密钥管理完整指南\n- **ENV_SETUP.md** - 环境变量配置指南\n- **SECURITY.md** - 安全最佳实践\n\n---\n\n## 📝 更新日志\n\n### v2.0.0 (2026-01-11)\n\n- 🎬 **新增视频功能**\n  - 可灵 AI 转场视频生成\n  - 交互式视频播放器（视频+图片混合）\n  - FFmpeg 完整视频合成\n  - 首页循环预览视频\n- 🔧 **优化视频合成**\n  - 自动统一分辨率和帧率\n  - 修复视频拼接兼容性问题\n  - 静态图片展示时间改为 2 秒\n- 🐛 **Bug 修复**\n  - 修复预览模式状态管理问题\n  - 修复 FFmpeg 滤镜参数格式错误\n- 📚 **文档更新**\n  - 全面改写 README\n  - 新增视频功能使用指南\n  - 更新 API 密钥配置说明\n\n### v1.0.0 (2026-01-09)\n\n- ✨ 首次发布\n- 🎨 内置 2 种专业风格\n- 🖼️ 支持 2K\u002F4K 分辨率\n- 🎬 HTML5 图片播放器\n- 📊 智能文档分析\n- 🔐 安全的环境变量管理\n\n---\n\n## 🤝 贡献指南\n\n欢迎贡献！你可以：\n\n### 添加新风格\n\n1. Fork 本项目\n2. 在 `styles\u002F` 创建新风格文件\n3. 参考现有风格编写提示词\n4. 测试生成效果\n5. 提交 Pull Request\n\n### 报告问题\n\n在 [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills\u002Fissues) 提交问题，请包含：\n- 错误信息\n- 操作步骤\n- 系统环境\n- 日志文件（如有）\n\n---\n\n## 📄 许可证\n\nMIT License\n\nCopyright (c) 2026 歸藏\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and\u002For sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 🙏 致谢\n\n- **Google Gemini Team** - 提供强大的 Nano Banana Pro 图像生成模型\n- **可灵 AI 团队** - 提供高质量的视频生成服务\n- **FFmpeg 项目** - 提供强大的视频处理工具\n- **开源社区** - 提供的各种工具和灵感\n\n---\n\n## 📞 联系方式\n\n- **创作者**: 歸藏\n- **GitHub**: [@op7418](https:\u002F\u002Fgithub.com\u002Fop7418)\n- **Issues**: [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fop7418\u002FNanoBanana-PPT-Skills\u002Fissues)\n\n---\n\n\u003Cdiv align=\"center\">\n\n**⭐ 如果这个项目对你有帮助，请给一个 Star！**\n\nMade with ❤️ by 歸藏 | Powered by Google Gemini & 可灵 AI & FFmpeg\n\n\u003C\u002Fdiv>\n","NanoBanana PPT Skills 是一个基于 AI 自动生成高质量 PPT 图片和视频的强大工具，支持智能转场和交互式播放。其核心功能包括智能文档分析、多风格支持（如渐变毛玻璃卡片风格和矢量插画风格）、高质量图片生成、AI 转场视频、交互式播放器以及完整视频导出。该项目利用了 Google Nano Banana Pro 生成图像，并通过可灵 AI API 实现视频转场动画，同时采用 FFmpeg 进行视频合成。适用于科技产品展示、商务演示、教育培训等场景，能够帮助用户快速创建专业且吸引人的 PPT 内容。",2,"2026-06-11 03:48:55","high_star"]