非 DEMO 级 Remotion 视频制作-模板

快速开始

1. 克隆项目并安装

# 克隆项目
git clone https://github.com/smartdddlab/remotion-template my-video --depth=1 && cd my-video && pnpm i

注意:如果没有 pnpm ，请使用npm install 进行安装

2. 配置 MiniMax API Key

项目已预置 MCP 配置，只需替换 API Key：

1. 获取 API Key: MiniMax 开放平台
2. 替换配置中的 API Key：
   • OpenCode 用户: 编辑 .opencode/opencode.jsonc 中的 MINIMAX_API_KEY
   • Claude Code 用户: 编辑 .mcp.json 中的 MINIMAX_API_KEY

3. 一句话创建视频

使用 OpenCode 或 Claude Code 输入：

样例1：中国风视频

基于 "docs/跳跳糖.md" 创作符合中国风的视频

样例2：自动风格视频

使用 @docs/当你连上Wi-Fi的瞬间，空气里发生了什么.md 文案创作一个新视频

4. 查看最终生成的视频

在 public 目录下，找到生成的视频文件。

开发命令

pnpm install      # 安装依赖
pnpm run dev     # 启动开发预览
pnpm run render  # 渲染视频

更新 remotion-dev/skills

npx skills add remotion-dev/skills

详细指南

• AGENTS.md - AI 助手工作流程
• MiniMax MCP 官方指南

特性

• 高可用性：非 DEMO 级模板，可直接用于生产环境
• AI 驱动工作流：基于 AGENTS.md 规范，自动化视频制作全流程
• 一步到位实现：完整支持 Canvas 粒子系统、Three.js 3D、Lottie 动画、SVG 动画等高级技术
• 自动化素材生成：集成 MiniMax MCP 和 baoyu-skills，自动生成音频和图像素材
• 智能风格处理：支持文化/时代/流派三维风格体系，自动识别、推荐、映射和冲突检测
• 质量保证：内置质量检查流程和验证脚本
• 三层文档体系：AGENTS.md（工作流程）+ TECH_GUIDE.md（技术细节）+ templates/（实现方案）

是什么 & 不是什么

✅ 是什么

• 一个生产级 Remotion 视频制作模板
• AI 辅助的高效视频开发工作流
• 完整实现复杂视觉效果的技术方案
• 自动化素材生成和验证的完整工具链

❌ 不是什么

• 不是教学性质的 DEMO 项目
• 不是需要手动处理每个细节的低效方案
• 不是简化版的实现示例
• 不是只能处理简单场景的工具

常见问题

• **chrome-headless-shell下载失败: 手动下载:https://storage.googleapis.com/chrome-for-testing-public/134.0.6998.35/mac-x64/chrome-headless-shell-mac-x64.zip 后，改名解压缩到 node_modules/.remotion/chrome-headless-shell