ArcReel

ArcReel 是一款基于 Claude Agent SDK 构建的开源 AI 视频生成工作台。它通过多智能体协作（Multi-Agent Collaboration），将复杂的视频制作流程自动化，实现了从长篇小说/文本到完整短视频的一键式生产。

ArcReel 的核心优势在于其模块化架构、多供应商支持以及对角色/场景一致性的精细控制，旨在解决当前 AI 视频生成中常见的“上下文断裂”和“工作流碎片化”问题。

核心能力

1. AI Agent 驱动的全自动流水线

基于 Claude Agent SDK，ArcReel 编排了 Skill（技能） 与 Subagent（子智能体） 的协作网络：

• 编排 Skill (manga-workflow)：作为“导演”，负责检测项目状态（如角色设计、分集规划、资产生成），并调度对应的子智能体。支持断点续传和任意阶段介入。
• 聚焦 Subagent：每个子智能体只专注一项任务（如提取角色特征、规范化剧本），处理完后返回精炼摘要给主 Agent，有效保护上下文窗口，避免信息过载。
• 人机协作确认：在每个关键阶段（如剧本定稿、角色定型），主 Agent 会暂停并等待用户确认，确保创作方向可控。

2. 极致的视觉一致性控制

• 角色设计图 (Character Sheet)：AI 首先生成标准化的角色设计图，后续所有分镜和视频生成都严格参考此图，确保主角形象跨镜头不变。
• 线索追踪 (Clue Tracking)：自动标记关键道具、场景元素为“线索”，在生成过程中强制保持这些元素的视觉连贯性。
• 风格参考图：上传一张风格图，AI 自动分析并将其美学特征应用到全项目，统一视觉基调。

3. 多供应商灵活切换

ArcReel 不绑定单一模型，支持全局或项目级切换供应商，并内置费用追踪与预估：

• 图像生成：Gemini (Nano Banana), 火山方舟 (Seedream), Grok (Imagine), OpenAI (GPT Image)。
• 视频生成：Gemini (Veo 3.1), 火山方舟 (Seedance), Grok (Imagine Video), OpenAI (Sora 2)。
• 文本/逻辑：Gemini, 火山方舟 (Doubao), Grok, OpenAI (GPT-5.4)。
• 自定义供应商：支持接入任何 OpenAI/Google 兼容 API（如 Ollama, vLLM），自动发现模型并分配媒体类型。

4. 两种内容模式

• 说书模式 (Narration)：按朗读节奏拆分片段，适合解说类、纪录片风格视频。
• 剧集动画模式 (Drama)：按场景和对话结构组织，适合剧情短片、动漫风格视频。

5. 完善的工程化特性

• 异步任务队列：支持 RPM 速率限制、Image/Video 独立并发通道、Lease-based 调度，确保高负载下的稳定性。
• 版本历史与回滚：每次重新生成自动保存版本，支持一键回滚到任意历史状态。
• 剪映草稿导出：直接导出 compatible with CapCut/Jianying 5.x/6+ 的草稿 ZIP 包，方便后期微调。
• OpenClaw 集成：提供 API Key 和 Skill 定义，可通过 OpenClaw 等外部 Agent 平台以自然语言驱动视频创作。

技术架构

快速开始

1. 默认部署 (SQLite)

适合个人试用和本地开发。

git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy
cp .env.example .env
# 编辑 .env 设置 AUTH_PASSWORD (可选，未设置则自动生成)
docker compose up -d

访问 http://localhost:1241，使用用户名 admin 和 .env 中的密码登录。

2. 生产部署 (PostgreSQL)

适合团队协同和高并发场景。

cd ArcReel/deploy/production
cp .env.example .env
# 务必设置 POSTGRES_PASSWORD
docker compose up -d

3. 初始配置

登录后前往 设置页 (/settings)：

1. ArcReel 智能体：配置 Anthropic API Key（用于驱动主控 Agent）。
2. AI 生图/生视频：配置至少一个供应商的 API Key（如 Gemini, 火山方舟等）。

典型工作流

1. 导入小说：上传 TXT/PDF 小说，选择“剧集动画模式”。
2. 渐进式分集：Agent 探测小说结构，建议断点，用户确认后物理切分章节。
3. 角色设计：Agent 提取主要角色特征，生成角色设计图，用户确认/修改。
4. 剧本生成：针对每一集，Agent 生成详细分镜剧本，包含画面描述、台词、运镜指令。
5. 资产生成：
   • 分镜图：基于角色设计图和剧本，批量生成分镜图片。
   • 视频片段：将分镜图转化为视频，保持角色和道具一致性。
6. 成片合成：自动拼接视频片段，添加配音（TTS）和背景音乐。
7. 导出：下载 MP4 或导出剪映草稿进行最终精修。

为什么选择 ArcReel？

• 告别碎片化工具：无需在 Midjourney, Runway, ElevenLabs 之间手动倒腾文件，全流程自动化。
• 一致性难题的解决方案：通过角色设计图和线索追踪，显著减少 AI 视频的“闪烁”和“变脸”问题。
• 成本可控：内置多供应商费用追踪和预估，避免账单 surprise。
• 开放与可扩展：开源代码，支持自定义供应商和 OpenClaw 集成，适合开发者二次开发。