nanobanana-ppt-visualizer

# PPT 视觉增强工具 ## 任务目标 - 本 Skill 用于：为 PPT 内容生成高质量视觉呈现，包括图片渲染、交互式播放器和视频合成 - 能力包含：风格化图片生成、HTML 播放器生成、视频素材管理、FFmpeg 视频合成 - 触发条件：用户需要为 PPT 内容添加视觉效果，或与 ppt-generator Skill 协同工作 ## 前置准备 - 依赖说明：scripts 脚本所需的依赖包 ``` pillow>=9.0.0 python-dotenv>=0.19.0 ``` - 系统依赖：FFmpeg（可选，用于视频合成功能） ```bash # Ubuntu/Debian sudo apt-get install ffmpeg # macOS brew install ffmpeg ``` ## 操作步骤 ### 标准流程（与 ppt-generator 协同） #### 步骤 1：获取 PPT 内容（协作模式） 1. 与 ppt-generator Skill 协同： - ppt-generator 负责：主题分析、内容规划、结构设计 - 输出格式：符合规范的 JSON 数据（详见 [references/ppt_structure_guide.md](references/ppt_structure_guide.md)） 2. 接收 JSON 数据，包含： - metadata：标题、作者、主题、关键词 - slides：每页的布局、标题、内容、图片标注 #### 步骤 2：选择视觉风格 1. 扫描 `assets/styles/` 目录，列出可用风格： - `gradient-glass.md`：渐变毛玻璃风格（科技感、商务） - `vector-illustration.md`：矢量插画风格（温暖、教育） 2. 根据内容主题和场景推荐合适的风格 3. 智能体生成图片描述提示词，参考风格模板 #### 步骤 3：生成视觉素材 1. **图片生成**（使用智能体能力）： - 根据每页内容和风格模板，生成图片描述 - 使用智能体的图像生成能力创建图片 - 保存为 slide-01.png, slide-02.png 等 2. **可选：视频生成**（需要可灵 AI API）： - 如果用户需要视频转场，调用可灵 AI API - 生成首页预览视频和页面转场视频 - 使用 `scripts/video_materials.py` 管理视频素材 #### 步骤 4：生成播放器 1. 调用 `scripts/generate_viewer.py` 生成 HTML 播放器： - 支持图片轮播、键盘导航、全屏播放 - 支持视频+图片混合播放（如果生成了视频） 2. 输出交互式播放器，可直接在浏览器中预览 #### 步骤 5：视频合成（可选） 1. 如果生成了视频素材，调用 `scripts/video_composer.py`： - 使用 FFmpeg 合成完整视频 - 统一分辨率和帧率 - 输出 full_ppt_video.mp4 ### 独立使用模式 当用户直接提供 PPT 内容（JSON 格式）时： 1. 读取用户提供的 JSON 文件或内容 2. 执行步骤 2-5，生成视觉呈现 ## 协同工作流程 ### 与 ppt-generator Skill 配合 `...