这是一个面向 OpenAI Codex 的“剪纸/拼贴风格广告制作”Skill 仓库，目标是在 Codex desktop/CLI 中完成从创意、脚本、分镜、关键帧、动画、旁白、音乐音效、合成到 MP4 质检的完整广告生产流程。项目以 JavaScript 脚本和 Codex Skill 文档为核心，支持本地 FFmpeg/Node 工作流，也可选接入 Seedance、即梦、MiniMax、ElevenLabs 等外部服务；声音克隆方案指定为 Apple Silicon Mac 上的 IndexTTS-2 MLX，本仓库不包含模型权重、声音素材或 API Key。
适用领域
AI 广告制作 / 短视频生产 / Codex Skill / AI Agent 工作流 / 剪纸拼贴风格视觉生成 / 视频动画与合成 / TTS 与声音克隆 / 音频混音与音效制作 / MP4 质检与交付 / 品牌营销素材自动化
配置难度
中等。熟悉 Codex、命令行、Node.js、FFmpeg 的开发者上手较快；如果只使用本地静态/分层动画流程，难度较低。若要接入外部视频生成服务、本地 IndexTTS-2 声音克隆、音频混音和最终质检，则需要一定的多媒体处理、环境配置和合规意识。
商业价值
该仓库的商业价值主要体现在降低广告短片生产成本和缩短从创意到成片的周期。对创业团队、独立开发者、营销团队和内容工作室来说，它可以把原本分散在文案、分镜、配音、动画、剪辑、质检中的流程整合成 Codex 可执行的标准化工作流，适合快速制作产品宣传片、社媒广告、概念提案或客户样片。MIT 许可证也有利于企业内部定制和二次开发。但在正式商业投放前，仍需要人工把关品牌一致性、素材授权、声音授权、广告合规和平台审核要求。
01
技术亮点
- 完整覆盖广告生产链路：创意、脚本、分镜、关键帧、动画、旁白、音乐、音效、合成、MP4 质检。
- 面向 Codex Skill 设计，安装后可通过自然语言直接调用。
- 中文 README 和工作流说明较完整，适合中文开发者上手。
- 支持不依赖 API Key 的本地基础流程，降低试用门槛。
- 可选集成多个视频生成和 TTS 服务，适合根据预算和质量要求灵活选择。
- 内置 IndexTTS-2 MLX 本地声音克隆方案，适合 Apple Silicon Mac 用户保护声音数据隐私。
- 强调授权声音、AI 旁白披露和隐私检查，合规意识较强。
- 提供 examples、references、scripts 等目录，便于复制模板和自动化执行。
- MIT 许可证，对二次开发和商业集成较友好。
- 仓库有 246 stars 和 32 forks，说明具备一定社区关注度。
02
目标用户
- 使用 OpenAI Codex desktop/CLI 的开发者
- 需要快速制作产品广告短片的独立开发者或创业团队
- 营销团队、品牌设计师、视频创作者
- 熟悉命令行和基础 Node.js/FFmpeg 的技术型创作者
- 希望在本地完成 AI 旁白或声音克隆的 Apple Silicon Mac 用户
- 想把广告制作流程模板化、自动化的内容生产团队
03
配置要求
- 主要运行环境为 OpenAI Codex desktop/CLI。
- 基础依赖包括 Node.js 和 FFmpeg。
- macOS 用户可通过 Homebrew 安装依赖。
- 仅使用静态关键帧、分层动画和最终合成时不需要 API Key。
- Seedance、即梦、MiniMax、ElevenLabs 等外部生成服务为可选通道，需要用户自己的服务账号和 API 权限。
- 外部服务密钥应通过环境变量提供，仓库不包含 API Key。
- 本地声音克隆依赖 solar2ain/mlx-indextts 的 IndexTTS-2 MLX 实现，适合 Apple Silicon Mac。
- IndexTTS-2 模型和运行时默认下载到 `~/.local/share/paper-collage-ad/mlx-indextts/`。
- 用户必须自行提供已获授权的参考声音，建议为 6–12 秒清晰单人语音。
- 参考声音、声纹文件和生成旁白应保存在用户项目目录，不应提交到公开 Git 仓库。
- 第三方模型、字体、音乐、素材和 API 服务需要遵守各自许可证与服务条款。
04
适用场景
- 为一个产品生成 30–60 秒剪纸拼贴风格广告
- 从产品资料中提炼视觉隐喻并生成广告创意脚本
- 生成带时间码的分镜、对白和关键帧描述
- 基于真实品牌资产制作统一风格的广告画面
- 使用分层 PNG、FFmpeg 或外部视频生成服务制作动画
- 使用普通 TTS 或本地 IndexTTS-2 MLX 克隆授权声音生成旁白
- 为广告添加背景音乐、纸张拟音和动作音效
- 最终输出 H.264/AAC MP4 并进行流级验证
- 为客户交付广告视频前执行隐私检查，避免泄露声音、模型、密钥或素材
05
部署与配置
- 确认已安装 OpenAI Codex desktop 或 CLI。
- 全局安装：执行 `git clone https://github.com/Jane-xiaoer/paper-collage-ad-codex.git ~/.codex/skills/paper-collage-ad`，安装后对当前用户所有 Codex 项目可用。
- 项目内安装：执行 `mkdir -p .codex/skills`，然后 `git clone https://github.com/Jane-xiaoer/paper-collage-ad-codex.git .codex/skills/paper-collage-ad`，仅当前项目可用。
- 重启 Codex 或开启新任务。
- 在 Codex 中输入类似：`用 paper-collage-ad 给这个产品制作一条有趣的 45 秒剪纸广告。`
- macOS 基础依赖安装：执行 `brew install ffmpeg node`。
- 执行 `bash scripts/check-deps.sh` 检查依赖。
- 如需本地声音克隆，在 Apple Silicon Mac 上执行 `bash scripts/setup-indextts2-mlx.sh` 安装 IndexTTS-2 MLX 运行时和模型。
- 在广告项目中创建 `assets/voice-reference/`、`assets/voice-model/`、`assets/voice-final/` 等目录，并放入已授权的参考声音。
- 执行 `bash scripts/prepare-indextts2-voice.sh <project>/assets/voice-reference/reference.wav <project>/assets/voice-model/speaker-v2.npz --i-have-permission` 生成本地声纹。
- 复制旁白清单模板：`cp examples/voice-manifest.indextts2.json <project>/manifests/voice.indextts2.json`。
- 执行 `node scripts/narrate-indextts2.mjs --manifest <project>/manifests/voice.indextts2.json` 生成分镜旁白 WAV。
- 建议复制隐私忽略模板：`cp examples/project.gitignore <project>/.gitignore`。
- 公开发布前执行 `bash scripts/privacy-check.sh` 检查是否包含声音、模型、密钥、渲染结果或隐私文件。
06
风险与注意事项
- 高度依赖 OpenAI Codex 环境，不适合完全脱离 Codex 使用的用户。
- 本地声音克隆主要面向 Apple Silicon Mac，Windows、Linux 或非 Apple Silicon 用户可能需要自行适配。
- 视频生成、TTS、音乐素材等外部服务存在费用、额度、地区可用性和服务条款限制。
- 声音克隆涉及肖像权、声音权、授权与披露要求，商业使用时需要严格合规。
- 第三方模型权重、字体、音乐、素材许可证需要用户自行核查，否则可能存在版权风险。
- AI 生成广告可能与品牌调性、法务要求或平台广告审核规则不完全匹配，需要人工审核。
- 自动化合成流程可能受到素材格式、帧率、音频采样率、FFmpeg 参数等影响，复杂项目需要调试。
- README 展示的是流程型 Skill，不一定提供开箱即用的完整 GUI 产品。
- 如果用户未正确配置 `.gitignore` 或未执行隐私检查，可能误提交参考声音、声纹、API 密钥或成片素材。
2026-07-17
第29名
新收录 · github_search
2026-07-16
第25名
新收录 · github_search
2026-07-15
第30名
新收录 · github_search
