ArcReel 视频创作工作台
将小说经智能体流程制作成分镜与短视频的自托管工作台。
- Star 数
- ★ 6.2k
- 最近更新
- 今天
- License
- AGPL-3.0
- 主语言
- Python
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 独立短视频创作者想把一部长篇小说逐集规划、确认后制作，而不是一次性生成全部内容。
- 不适合
- 希望开箱即用、不愿配置 Docker 与多家供应商密钥的个人用户
- 组织政策禁止采用 AGPL-3.0 附加条款的商业团队
- 源码审查
- 52/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
ArcReel 是一个自托管的 Web 视频创作工作台，将小说或已完成剧本组织为角色与线索资产、剧本、分镜图、视频片段和最终成片。前端采用 React 19，服务端采用 FastAPI，并以 Claude Agent SDK 运行由编排 Skill 与聚焦 Subagent 组成的助手流程。系统通过 ImageBackend、VideoBackend 和 TextBackend 支持多家图像、视频与文本服务商，也允许接入 OpenAI 兼容或 Google 兼容 API。GenerationQueue 将图像、视频和音频任务分通道调度，并提供 RPM 限制、lease-based 调度和断点续传；Web UI 通过 SSE 展示任务状态。默认可通过 Docker Compose 部署为 SQLite 版本，生产部署可使用 PostgreSQL，最终可用 FFmpeg 合成视频或按集导出剪映草稿。
用户上传小说后，manga-workflow 先读取 project.json 和文件系统检测项目阶段，再按需 dispatch analyze-characters-clues、split-narration-segments、normalize-drama-script、create-episode-script 等 Subagent。它可生成角色和线索设计图、分镜图或宫格图，再调用配置的 ImageBackend、VideoBackend、TextBackend 生成素材；视频可采用图生视频、宫格生视频或参考生视频模式。GenerationQueue 处理各媒体生成任务，ProjectManager 管理文件系统和版本历史，UsageTracker 按供应商追踪费用。完成的视频片段可由 FFmpeg 合成为成片，也可导出剪映 5.x/6+ 草稿 ZIP；外部 Agent 平台可通过 Bearer API Key 调用 POST /api/v1/agent/chat，并从 /skill.md 获取 Skill 定义。
- 独立短视频创作者想把一部长篇小说逐集规划、确认后制作，而不是一次性生成全部内容。
- 动画工作室需要先建立角色、场景或关键道具参考图，再在多个镜头中保持视觉连续性。
- 带货团队需要上传产品多图，生成八段式带货镜头脚本，并导出含口播字幕轨的剪映草稿。
- 已有成品剧本的制作者希望导入 screenplay，保留台词和画外音后继续生成资产与视频。
- 自托管团队希望在项目级或全局级切换 Gemini、火山方舟、Grok、OpenAI、Vidu、阿里百炼、MiniMax、可灵或自定义兼容服务商。
- 使用 OpenClaw 等外部 Agent 平台的团队希望用自然语言创建项目、生成剧本和制作视频。
如何安装或部署这个 Agent？
推荐在 Linux、macOS、WSL2 或 Docker 环境部署。执行：
git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy
cp .env.example .env
docker compose up -d然后访问 http://localhost:1241。生产版使用 PostgreSQL：进入 deploy/production，复制 .env.example 为 .env，设置 POSTGRES_PASSWORD，再执行 docker compose up -d。首次登录用户名为 admin；密码由 .env 的 AUTH_PASSWORD 设置，未设置时首次启动会自动生成并写回 .env。
如何使用这个 Agent？
登录后打开 /app/settings。先在“ArcReel 智能体”中配置 Anthropic 官方或兼容服务商的凭据、Base URL 和模型；随后至少为图像、视频或文本配置一个服务商 API Key，或添加自定义 OpenAI 兼容/Google 兼容服务商。创建项目后上传小说、成品剧本或产品图片，选择说书、剧集动画或广告/短片模式，并按助手在阶段间展示的摘要确认下一步。待分镜与视频任务完成后，在工作台预览素材、查看 SSE 任务状态和版本历史，使用 FFmpeg 合成成片或导出剪映草稿。
这个 Agent 有哪些优点和局限？
- 覆盖从小说/剧本输入到角色设计、分镜、视频片段、FFmpeg 合成和剪映草稿导出的明确生产链路。
- 以 ImageBackend、VideoBackend、TextBackend 统一多供应商能力，并支持自定义 OpenAI 兼容和 Google 兼容 API。
- 助手采用编排 Skill 加聚焦 Subagent 的分工，长篇原文保留在 Subagent 内，主 Agent 接收摘要并在阶段间等待确认。
- 任务队列区分图像、视频和音频通道，包含 RPM 限速、lease-based 调度和断点续传。
- 支持项目级与全局级供应商切换、版本回滚和按供应商的费用追踪与预估。
- 实际生成依赖至少一个外部服务商的 API Key；不同服务商支持的模态、参数和费用并不相同。
- 生产部署需要 PostgreSQL，默认部署虽使用 SQLite，仍需 Docker、Docker Compose 和网络连接。
- Windows 原生环境会自动降级，Bash 沙箱与 bwrap 等 POSIX-only 隔离机制不受支持；生产环境建议 WSL2 或 Docker Desktop。
- 项目采用 AGPL-3.0，并带有 NOTICE 中的附加条款；不接受该许可证义务的组织需另行处理商业使用。
- README 仅明确列出 OpenClaw 的外部 Agent 集成，未说明其他 Agent 平台的等价接入方式。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ArcReel 视频创作工作台 当前 | 52 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 6.2k | 今天 | Python | OpenAI API · Claude API |
| waoowaoo AI 影视 Studio | 证据不足 | 自托管服务免费 + 模型费 | ★ 15k | 1 个月前 | TypeScript | — |
| OpenMontage 影视工坊 | 47 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 18 | 1 天前 | Python | — |
| ReelMimic 影片風格複製工作台 | 50 · 缺口较多 | — | ★ 1.8k | 1 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 提到默认管理员密码生成、AUTH_PASSWORD 设置、AUTH_ENABLED=false 的警告，以及 SECURITY.md 中关于不支持多租户隔离的说明，表明对权限和敏感数据处理有一定考虑。但未发现明确的 least privilege 设计（如最小权限角色）、用户确认机制（如生成前确认）、数据流透明性（如数据流向图）或敏感数据加密存储的细节。依赖安全方面，有 CodeQL 和 Trivy 扫描工作流，但未提供漏洞修复策略或依赖锁定细节。外部影响方面，提到第三方服务依赖，但未明确限制或审计。回滚方面，README 提到版本历史和项目归档，支持回滚。来源归属方面，有 LICENSE 和 NOTICE，但未明确第三方代码归属。扣分原因：缺乏具体实现细节，多为断言性描述。
证据显示：README 和 pyproject.toml 中依赖版本明确，测试配置（pytest markers）和 CI 工作流（test.yml）存在，表明有一定自洽性。但未提供失败消息的具体示例或错误处理策略。依赖可用性方面，依赖列表完整，但未说明版本兼容性或锁定机制。扣分原因：静态审查无法验证运行时行为，且失败消息细节缺失。
证据显示：README 明确列出了多种工作流（小说改编、短视频、广告）和目标用户（创作者、运营者、贡献者），能力边界（如不支持多租户、Windows 部分支持）有说明。触发精度方面，提到 Agent 检测项目阶段并委派子代理，但未提供具体触发条件。环境适配方面，支持 Docker、SQLite/PostgreSQL、多平台镜像。扣分原因：触发精度描述模糊，缺乏具体规则。
证据显示：README 提供了详细的信息架构（文档索引、快速开始、架构图），安装说明（Docker Compose、环境变量）清晰，命名稳定（版本号由 release-please 管理），示例和 FAQ 存在，已知限制明确，许可证为 AGPL-3.0，有 CHANGELOG 和版本管理。维护责任方面，有 CONTRIBUTING.md 和社区渠道，但未明确维护者身份或责任声明。扣分原因：维护责任描述不明确。
证据显示：README 描述了输出可用性（可编辑的 CapCut 草稿、视频导出），边际价值（从内容到成片的完整流程），成本效益（成本估算和实际使用跟踪）。但缺乏实际用户反馈或性能数据。扣分原因：静态审查无法验证实际效果，且缺乏量化指标。
证据显示：README 中的功能描述与代码结构（如 provider 抽象、队列）有一定对应，但未提供具体实现链接或测试结果。跨来源佐证方面，有 CI 徽章和 Codecov 链接，但未提供具体数据。事实与推断分离方面，README 区分了功能描述和限制，但未明确标注哪些是推断。扣分原因：缺乏可追溯的具体证据，多为断言。
- 静态审查无法验证运行时行为，所有评分基于文件内容推断。
- 未发现明确的用户确认机制，生成操作可能自动执行，需谨慎配置。
- 敏感数据处理细节不足，建议审查代码确认 API 密钥存储方式。
- 依赖安全扫描存在，但未提供漏洞修复策略，需关注依赖更新。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
[0.35.0](https://github.com/ArcReel/ArcReel/compare/v0.34.0...v0.35.0) (2026-11-01) 🌟 版本亮点 * 项目回收站： 在项目中删除的内容不再直接清除，会在项目回收站中保留 30 天，期间可以恢复；Agent 删除的内容同样如此。删除的整个项目会出现在项目列表页的「已删除项目」中，也保留 30 天。需要立即释放磁盘空间时，可以彻底删除。 * 文件视图： 新增文件视图，可以按目录查看项目中的全部文件和占用空间，并把不再使用的旧媒体移入项目回收站。 * Agent 审图： Agent 可以查看生成的资产图和分镜图，发现问题时建议重新生成。 * 稳定性： 大项目批量出片时，服务不再因卡顿崩溃重启。Docker 部署重启后，登录密码不再改变，已登录用户也不会掉线。 ✨ 新功能 …在 GitHub 查看 ↗ -
发布说明摘录
[0.34.0](https://github.com/ArcReel/ArcReel/compare/v0.33.0...v0.34.0) (2026-10-24) 🌟 版本亮点 * 模型目录： 新增统一的模型目录。内置供应商、自定义供应商和 Agent 都从这里读取模型的能力和价格，并自动同步官方最新数据。所有模型集中在「供应商」页面管理，支持获取、添加、启用和停用，也可以自行修改模型信息和价格。如果原来的默认模型已经下架，升级后会自动换成当前在售的模型。 * 计费： 生成调用和 Agent 会话的参考费用改为按模型目录中的价格计算。查不到价格的调用会标为「未定价」，不再套用其他模型的价格。使用记录新增「生成调用」和「Agent 会话」两个视图。 * 升级提示： 自定义供应商模型之前手动填写的价格，升级后会被清除。如果实际价格与官方价格不同，可以通过倍率调整。 * 协议与端点： 新增 Anthropic Messages、OpenAI Responses、Gemini 视频等调用端点，以及百炼、Gemini 和 MiniMax 的语音合成。自定义供应商可以为每个模型单独修改请求地址，使用非标准路径的服务也能接入。 …在 GitHub 查看 ↗ -
发布说明摘录
[0.33.0](https://github.com/ArcReel/ArcReel/compare/v0.32.0...v0.33.0) (2026-10-08) 🌟 版本亮点 * 界面整体改版： 全部页面基于 shadcn/ui 重做，布局、视觉和操作方式统一。窗口较小时，弹窗的标题和按钮也始终可见。 * 保存与离开提示： 编辑内容统一为先修改、再保存。离开页面或切换选中项时，如有未保存的修改会先提示，不再静默丢弃。 * 工作区与 Agent 面板： Agent 悬浮球改为顶栏开关，项目菜单改为可搜索的项目切换器。Agent 的工具调用等过程收为单行显示，提问时问题显示在输入框位置。 * 项目页面： 项目大厅改为海报卡片，最近有改动的项目排在最前；概览改为单列的故事设定页；分集视图改为分集目录与原文并排；剧集页头精简为两行。 * 分镜与资产： 分镜编辑与设定集重新排版，各类资产使用同一个详情面板编辑。项目资产新增删除入口，删除前会列出仍在引用该资产的集。 * 设置位置调整： 外部 Agent 接入改为设置页，原「API 密钥」改称「访问令牌」。GitHub 访问代理和官方服务开关移到市场的「设置」标签页。项目设置改为侧栏分页。 …在 GitHub 查看 ↗
常见问题
需要自己提供模型密钥吗？
能否不使用预置服务商？
/v1/models 发现模型，并按名称推断图片、视频或文本媒体类型。