ArcReel

核心能力

工作流程

graph TD
    A["📖 上传小说"] --> B["🔍 全局角色/线索提取"]
    B --> C["✂️ 分集规划与切分"]
    C --> D["📝 剧本预处理与 JSON 生成"]
    D --> E["👤 生成角色设计图"]
    D --> F["🔑 生成线索设计图"]
    E --> G["🖼️ 生成分镜图 / 宫格图"]
    F --> G
    G --> H["🎬 生成视频片段"]
    H --> I["🎞️ FFmpeg 合成最终视频"]
    H --> J["📦 导出剪映草稿"]

快速开始

⚠️ 操作系统：推荐 Linux / macOS / WSL2 / Docker。Windows 原生可运行项目创建与基础流程，但 Bash 沙箱、bwrap 等 POSIX-only 隔离机制会自动降级，生产部署仍建议 WSL2 或 Docker Desktop

默认部署（SQLite）

git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy
cp .env.example .env
docker compose up -d
# 访问 http://localhost:1241

生产部署（PostgreSQL）

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

首次启动后，使用默认账号登录（用户名 admin，密码在 .env 中通过 AUTH_PASSWORD 设置；未设置则首次启动时自动生成并回写到 .env），前往 设置页（/app/settings）完成配置：

1. ArcReel 智能体 — 配置驱动 AI 助手的供应商凭据，支持 Anthropic 官方及多种兼容供应商，自定义 Base URL 与模型
2. AI 生图/生视频/生文本 — 配置至少一个供应商的 API Key（Gemini / 火山方舟 / Grok / OpenAI / Vidu / 阿里百炼 / MiniMax / 可灵），或添加自定义供应商

📖 详细步骤请参考 完整入门教程

功能特性

• 完整生产流水线 — 小说 → 剧本 → 角色设计 → 分镜图片 → 视频片段 → 成片，一键编排
• 多智能体架构 — 编排 Skill 检测项目状态并自动调度聚焦 Subagent，每个 Subagent 独立完成一项任务后返回摘要
• 沙箱化 Agent 运行环境 — Agent 工具调用默认运行在 bwrap 沙箱内，文件系统、网络、子进程能力按白名单授权；Linux/macOS 自动启用，Windows 原生不支持沙箱时自动降级
• 多供应商支持 — 图片/视频/文本生成支持 Gemini、火山方舟、Grok、OpenAI、Vidu、阿里百炼、MiniMax、可灵 等预置供应商（各供应商支持的模态有所不同），全局/项目级可切换；AI 助手凭据同样支持多供应商配置
• 自定义供应商 — 接入任何 OpenAI 兼容 / Google 兼容 API（如 Ollama、vLLM、第三方中转），自动发现可用模型并分配媒体类型，与预置供应商享有同等功能
• 三种内容模式 — 说书模式（narration）按朗读节奏拆分片段，剧集动画模式（drama）按场景/对话结构组织，广告/短片模式（ad）按目标时长生成带货镜头、单集直达单视频
• 三种视频生成模式 — 图生视频（分镜图驱动）/ 宫格生视频（多分镜合成 grid_4/6/9，拆分作首尾帧）/ 参考生视频（直接以角色/场景/道具资产图生成视频，跳过分镜步骤）
• 多种剧本源 — 既可从小说原文改编，也可直接导入成品剧本（screenplay）：逐字保留台词与画外音，按作者人物表提取角色，群演空镜不建资产
• 广告/短片项目 — 面向带货短片的项目类型：上传产品多图并生成标准产品参考图，一键生成八段式带货镜头脚本，产品镜头全程锚定真品，导出剪映自带口播字幕轨
• 旁白配音（TTS） — 设置页配置音色与语速，分镜逐段试听、一键补齐全集，智能体一句话即可生成全集；支持阿里百炼 Qwen3 TTS 与任意 OpenAI 兼容 TTS，导出剪映草稿自带逐段旁白音轨
• 渐进式分集规划 — 人机协作切分长篇小说：一次规划一批剧情完整的集，Agent 建议断点、用户确认后物理切分，一句话意见即可整批重排，按需制作
• 风格参考图 — 上传风格图，AI 自动分析并统一应用到所有图片生成，确保全项目视觉一致
• 角色一致性 — AI 先生成角色设计图，后续所有分镜和视频均参考该设计
• 线索追踪 — 关键道具、场景元素标记为"线索"，跨镜头保持视觉连贯
• 版本历史 — 每次重新生成自动保存历史版本，支持一键回滚
• 多供应商费用追踪 — 图片/视频/文本全部纳入费用计算，按供应商分策略计费，不同币种分别统计
• 费用预估 — 生成前预估项目/单集/单镜头费用，三级下钻展示预估与实际费用对比
• 剪映草稿导出 — 按集导出剪映草稿 ZIP，支持剪映 5.x / 6+（操作指南）
• 多 API Key 管理 — 每个供应商支持配置多个 API Key 并切换激活，支持 Google Vertex AI 凭证上传
• 多语言界面 — 前后端全面国际化，支持多语言切换
• 项目导入/导出 — 整个项目打包归档，方便备份和迁移

供应商支持

ArcReel 通过统一的 ImageBackend / VideoBackend / TextBackend 协议，支持多个预置供应商和自定义供应商，可在全局或项目级别切换：

图片供应商

视频供应商

文本供应商

自定义供应商

除预置供应商外，可接入任何 OpenAI 兼容 或 Google 兼容 API：

• 在设置页添加自定义供应商，填入 Base URL 和 API Key
• 自动调用 /v1/models 发现可用模型，按名称推断媒体类型（图片/视频/文本）
• 与预置供应商享有同等功能：全局/项目级切换、费用追踪、版本管理

供应商选择优先级：项目级设置 > 全局默认。切换供应商时通用设置（分辨率、宽高比、音频等）直接沿用，供应商特有参数保留。

交流群

扫码加入飞书交流群，获取帮助和最新动态：

AI 助手架构

ArcReel 的 AI 助手基于 Claude Agent SDK 构建，采用编排 Skill + 聚焦 Subagent 的多智能体架构：

flowchart TD
    User["用户对话"] --> Main["主 Agent"]
    Main --> MW["manga-workflow<br/>编排 Skill"]
    MW -->|"状态检测"| PJ["读取 project.json<br/>+ 文件系统"]
    MW -->|"dispatch"| SA1["analyze-characters-clues<br/