setup

用途

这是 Remotion Superpowers 插件的首次运行设置向导，引导用户完成环境检查、项目确认、技能安装、API 密钥配置和 MCP 连接验证，为后续使用视频制作相关命令做好准备。

主要能力

向导按步骤执行以下操作：

1. 检查系统依赖：Node.js >= 18、npm、Python 3 + uv/uvx（推荐，用于 ElevenLabs 和 Pexels MCP 服务器）。
2. 检查当前目录是否包含 remotion.config.ts 或 remotion.config.js，若没有则询问用户创建新项目或导航到已有项目。
3. 安装 Remotion Agent 技能：运行 npx skills add remotion-dev/skills，自动检测已安装的代理（Claude Code、Codex、Gemini CLI、Cursor、Copilot 等）并安装到对应目录。
4. 配置 API 密钥：逐个说明各服务的用途、注册链接、环境变量名，并指导使用 export 命令设置及持久化到 shell 配置文件。涉及密钥包括：
   • KIE_API_KEY（主要，覆盖 Suno 音乐生成、ElevenLabs 音效/TTS、图像/视频生成、字幕生成）
   • TWELVELABS_API_KEY（视频理解，分析素材、检测场景/对象/说话人、生成摘要）
   • PEXELS_API_KEY（免费图库照片和视频，可直接下载 HD/4K 素材）
   • ELEVENLABS_API_KEY（可选，高级语音功能如声音克隆、自定义语音、音频分离）
   • REPLICATE_API_TOKEN（可选，访问 100+ AI 模型进行图像/视频生成、放大等）
5. 重载 shell 并验证环境变量是否设置。
6. 检查 MCP 服务器状态（/mcp），确保所有配置的服务器显示已连接。
7. 打印设置完成摘要，并列出可用命令：
   • 制作命令：/create-video、/create-short
   • 素材命令：/find-footage、/generate-image、/generate-clip
   • 音频命令：/add-voiceover、/add-music、/transcribe
   • 增强命令：/add-captions、/add-transitions
   • 分析命令：/analyze-footage、/review-video

使用方式

在 Remotion 项目目录中运行该设置向导，按步骤操作即可。对于 Gemini CLI 用户，扩展不继承 shell 环境，密钥在安装扩展时提示输入，后续可通过 gemini extensions config remotion-superpowers "KIE API key" 等命令修改。

适用场景

适用于首次安装 Remotion Superpowers 插件后，需要配置开发环境、安装技能、设置 API 密钥并验证 MCP 连接的场景。

限制

• 需要 Node.js >= 18 和 npm；Python 3 与 uv/uvx 为推荐项，用于部分 MCP 服务器。
• 必须在 Remotion 项目目录中运行，否则需先创建或进入项目。
• 部分 API 密钥（ELEVENLABS_API_KEY、REPLICATE_API_TOKEN）为可选，可根据需求跳过。
• 具体收费、价格等信息暂未提供。