ArcReel：小说与剧本进去、剪映草稿出来，Agent 编排在中间，改过的版本要挂它的署名
今天拆的是 ArcReel：一个自托管的 AI 视频产线工作台，小说、剧本或商品素材进去，角色资产、分集、分镜和视频片段出来，最后还能落成一份继续可改的剪映草稿；文章给全它在链条上的位置、Docker 上手路径、十处已知阻塞，以及那份 AGPL 署名条款和按秒算的模型账。
ArcReel 把自己写成「AI Agent 驱动的开源可自部署视频工作台」：小说、成品剧本或商品素材进去，角色、场景、道具资产、分集、分镜和视频片段出来，最后还能落成一份可以继续改的剪映草稿。1 2026-10-04 查时 5,280 star / 1,040 fork / 1,883 次提交 / 62 个 tag / 61 个 release / 63 个分支 / 27 位贡献者，AGPL-3.0，Python 占 71%、TypeScript 占 27.9%，默认分支 main，主分支最后一次提交在 2026-10-03 23:53（UTC+08）。2
这个仓库 2026-02-07 建仓，最近五周发了五个版本：v0.28.0 在 2026-08-30，v0.32.0 在 2026-10-02 15:46（UTC+08）。3 v0.32.0 的版本亮点把这一轮的主线写得很清楚：集页新增剪辑视图，成片在本地渲染，也可以导出剪映草稿；Agent 能新建和批量编辑剪辑时间线，看素材时读的是拼好的联系表；「分集」视图取代了原来的「源文件」页。3
写这个项目的人很少：Pollo3470 一个人 1,612 次提交，dependabot 185 次，release-please 机器人 28 次，其余十来位人类贡献者加起来不到 50 次。4 官方镜像 arcreel/arcreel 到 2026-10-04 共 12,716 次拉取，最后更新在 2026-10-02。5
它在链条上站在哪一层
前面十九期按层摆下来，位置已经比较满：HyperFrames 和 Remotion 守着渲染底座，hypit 是一种工作流描述语言，OpenChatCut 与 Diffusion Studio 是编辑器，Toonflow 是无限画布工作台，video-use 是装进编码 Agent 的剪辑技能包，ViMax 自己重写了一套 Agent runtime，OpenCreator 只做 Codex 外面那层壳。
ArcReel 落在「一条产线整体产品化」这一格。渲染这一步它用随包的 ffmpeg，字幕用随包的思源黑体画进画面；Agent 循环交给 Anthropic 的 Claude Agent SDK 跑；它自己负责的是项目状态、任务队列、资产库、费用账和两条导出。6
它跟第 17 期的 Toonflow 在同一层，入口的样子不同。Toonflow 把剧本、角色三视图和 3D 导演台摊在一张无限画布上，7 ArcReel 的界面是一串列表页——角色集、场景库、道具库、分集、分镜、剪辑时间线——小说原文要先被切成集，再逐集往下走。
对外的接入口它留了两个。一个是公开的 Agent 技能仓库 ArcReel/skills（MIT），一条
npx skills add ArcReel/skills 就能把「适配自定义调用端点」这类技能装进 Claude Code；8 另一个是远端 MCP 端点 <你的地址>/mcp，用 arc- 前缀的 API Key 接入，外部 Agent 可以进来读写同一个项目。9它在这一层怎么做事
Agent Runtime 分三段。编排 Skill 判断项目当前状态、选择下一步、调用确定性工具、分发子智能体，需要拍板的地方停下来等确认；聚焦子智能体各管一件事，旁白/解说片段拆分、剧情演绎剧本规范化、参考生视频单元拆分、单集结构化剧本、资产生成、审片各有一个，大量原文和中间推理留在子智能体内部，主 Agent 只收摘要和结果引用；读文件、建任务、查状态、合成视频、导出归档这类确定性操作交给工具执行，不交给语言模型自由生成。6
生成侧是三套独立通道：图像、视频、音频各有自己的并发上限，任务状态落库，进程重启后还能接着轮询；任务身份、持久化状态和供应商任务 ID 一起用，避免同一个分镜重复扣费。6
供应商被抽象成四类后端：TextBackend、ImageBackend、VideoBackend、AudioBackend，参数、时长、参考图数量、异步状态、计费单位这些差异封在适配器里。6 设置页里预置了 Gemini、火山方舟、Grok、OpenAI、Vidu、阿里百炼、MiniMax、可灵 Kling、Agnes，也可以自己写一份 OpenAI 兼容或 Google 兼容的端点，声明式地填提交与轮询的取值路径。10
产出有两条路。一条是本地渲染成片，一条是导出剪映草稿，把片段、截取、原声音量、转场、字幕、旁白和 BGM 变成一份能在剪映里继续改的工程。6 项目里每次重新生成都留成一个新版本，旧版本不覆盖，可以回滚；被改动过的素材会让下游产物读成「过期」，等着你决定要不要重做。6
docs/assets/screenshots/hero.webp：左上是一个叫《赡养人类》的项目第 1 集，中间是分镜列表与当前分镜图，右侧是 ArcReel Agent 的对话和它刚交出的第一集完成报告。顶栏三格写着预估 $5.44、已花 CN¥3.66 + $0.40、剩余 $5.04——费用追踪就长在制作界面上。11你要给什么，它交回什么
| 你提供 | 它交回 |
|---|---|
| 一台能跑 Docker 的机器（Linux、macOS、WSL2 或 Docker Desktop），2 GB 可用内存起步，默认流程走远程 API，用不着本机 GPU12 | 一个自托管的 Web 工作台，默认监听 1241 端口，登录名默认 admin12 |
| 两套凭据：一套给 Agent 做对话与编排，一套给生成模型，文本、图像、视频、TTS 分别配13 | 一条从原文到成片的产线，每个阶段可审核、可中断恢复、可回滚版本6 |
| 一段小说、一份成品剧本，或一组商品素材，格式限 .txt / .md / .docx / .epub / .pdf，扫描版 PDF 要先做 OCR13 | 角色、场景、道具三套资产图，分集与结构化剧本，分镜图，视频片段，旁白音轨11 |
| 两次定死的选择：创建项目时选创作类型（旁白/解说、剧情演绎、广告/短片）与生成模式（分镜图生视频、参考生视频），创建后都改不了13 | 一张费用面板：图片、视频、文本、音频的预估与实际调用，设置页里还能按时间和供应商查13 |
| 本机剪映草稿目录的路径，以及本地剪映是 5.x 还是 6+14 | 一份解压进草稿目录就能打开的剪映工程，或者一条渲染好的成片6 |
docs/assets/screenshots/video-units.webp：左栏是 38 集的分集列表，中间第 31 集被拆成 20 个视频单元，顶部进度显示 20/20；当前单元的右侧逐条列出镜头五的景别、构图、运镜和台词锚点。你要给的是一段能读的原文，它交回的是逐条落位的分镜与台词。11最短上手路径
官方主推 Docker 那一条，四行命令：
git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy
cp .env.example .env
docker compose up -d.env 里建议主动填 AUTH_PASSWORD 和 AUTH_TOKEN_SECRET（后者用 openssl rand -hex 32 生成），起完访问 http://localhost:1241，健康检查是 curl -f http://localhost:1241/health。官方给的预期是首次部署加配置 10～20 分钟。12第二步在设置页里配两套凭据。Agent 那套负责对话、原文分析、分集规划、脚本规划和编排，生成那套按模态分开填文本、图像、视频和 TTS 供应商。13 两套各管一段：只配 Agent 那一套，出图和出视频的入口不会亮；只配生成供应商，项目里的 Agent 起不来。13
第三步建项目。要选两组东西，创建后都改不了：创作类型决定剧本结构和制作流程，生成模式决定视频拿分镜图当首帧、还是直接拿资产图当参考。13
第四步验证。官方建议第一次只传一段短内容、跑 2～4 个分镜，别拿整部长篇去试。12 想省钱，就先跑不花钱的环节——内容分析、资产定义、脚本规划——确认样子对了再碰视频。
会卡住的地方
API Key 写进
.env，服务会直接拒绝启动。 症状是容器起不来，日志让你把凭据迁到 Web 设置页。触发条件是你习惯把 ANTHROPIC_API_KEY、ARK_API_KEY、GEMINI_API_KEY 这类变量写进部署环境。部署文档列了十来个变量，父进程环境里只要有一个非空值，服务就拒绝启动，Vertex 凭据同样要走设置页上传。9 你能做的：把这些变量从环境里清掉，改到设置页逐条保存。Agent 沙箱会把启动卡在门口。 症状是容器反复重启，日志里出现
SANDBOX_UNAVAILABLE 或 SANDBOX_BWRAP_BROKEN。触发条件是宿主机限制了 user namespace，或者 AppArmor 策略拦住了 bwrap。本地跑要自己装 bubblewrap 和 socat；官方 Compose 为了让容器里的沙箱跑起来，给 Agent 开了 seccomp:unconfined、apparmor:unconfined 和 NET_ADMIN 三项，文档同时提醒这已经比普通 Web 应用权限高。9 你能做的：按启动日志修宿主机配置，别改成特权模式绕过去。Windows 原生环境没有 bwrap，会自动降级成受限的命令白名单，只保证项目创建和基础流程，官方建议换 WSL2 或 Docker Desktop。13升上去就回不来。 症状是想退回旧版时，旧版读不了升级后的数据。触发条件是升级完成后想回退。部署文档写明 ArcReel 不支持降级，升级会改写数据根布局、数据库结构和项目结构，回到旧版本要停机并恢复升级前的备份；迁移中途失败时服务会停在启动阶段，项目目录一个字节都不动，按日志处理完再重启即可续跑。9 你能做的：升级前把数据根和数据库一起备份，媒体文件和数据库要落在同一时点。
两套凭据，缺一套当天开不了工。 症状是 Agent 能聊天，点生成却没结果，或者反过来。触发条件是你只配了一边，或者凭据存了却没点「激活」——预置供应商可以存多条凭据，运行时只用标记为激活的那一条，测试连接通过也算不上激活。13 你能做的：先在设置页发一条简单消息验证 Agent，再去图像和视频那两栏各跑一次。
连接检查通过，离能生成还差得远。 症状是测试连接全绿，一上批量任务就成片失败。触发条件是你把连通性当成了能力证明。FAQ 列出连通性检查覆盖不到的四类东西：模型的生成权限、余额与并发额度；参考图、尾帧、分辨率和时长的限制；自定义模型的媒体类型与调用端点；异步任务的轮询和结果下载。13 你能做的：拿 2～4 个分镜先把这条路走通，再决定要不要批量。
读超时那一下，钱可能已经花出去了。 症状是任务显示失败，供应商控制台里却躺着一笔已经计费的任务。触发条件是提交请求之后发生读超时。FAQ 把这种状态写成「上游已经创建并计费，但 ArcReel 没收到响应」，提醒不要连续盲目重试；已经进入运行的任务不能取消，会照常跑完并照常计费。13 同一位文档还区分了两种情况：视频在供应商那边生成成功、只是没下载回来时，任务面板会给一个「重试下载」，它接续原来那笔任务、只重取产物、不再计费；回到生成入口重做则是新的一笔。13 你能做的：超时了先去供应商控制台核一遍，再决定从哪个入口恢复。
跨镜头的一致性仍然要人盯着。 症状是分镜图里的角色对不上资产库，场景资产图里冒出了人物，换了角色资产图之后旧分镜不会自动更新。触发条件是你没审资产就先批量生成，或者指望模型严格照提示词来。FAQ 把这几条都写着：场景资产图的提示词要求画面里不出现人物，图片模型仍可能不完全遵守；改过角色资产图，要重新生成受影响的分镜和视频；相邻分镜会把上一张分镜当作衔接参考，两段独立生成的视频仍可能接不上。13 仓库里也躺着一份同方向的报告：一位用火山方舟的用户在 2026-08-05 提交 #1661，说分镜生成锚不住角色、场景和道具库里的内容，随机生成得完全不符合设定，助手一分析就卡死掉线，这条到今天仍是开放状态。15 你能做的：先审资产再批量生成分镜；想让视频直接复用角色原声，要把项目设成参考生视频模式，因为分镜图生视频这一支不支持参考音频。13
剪映草稿那一头，只认中国大陆版剪映。 症状是解压完在剪映草稿列表里看不到，或者打开后少了片段。触发条件是你用的是 CapCut，剪映版本和下载时选的那项对不上，或者压缩包多套了一层目录。导出指南写明当前导出面向中国大陆版剪映桌面端，CapCut 的兼容性尚未验证；剪辑时间线里还有视频单元没有可用视频时，「出片」按钮点不动。14 你能做的：下载时把草稿目录和剪映版本都填对，解压后让文件夹直接落在草稿目录下，再重启剪映。
它按单一可信操作员设计，别直接摊到公网。 症状是同事要账号，或者你把 1241 端口发布到外网。触发条件是你把它当多人协作平台。部署文档写明 PostgreSQL 生产部署不提供用户隔离，也不做按用户划分的项目授权；官方 Compose 默认把 1241 端口发布到宿主机所有网卡，远程访问要自己加反向代理和 HTTPS，并关掉 SSE 代理缓冲、把读取超时设长。9 你能做的：一个人或一支彼此信任的小团队用；远程部署时把端口映射改成只监听回环地址。
公开议题列表里大半是维护者自己的施工单。 症状是你想按 issue 排错，翻到的全是别人的工作票。触发条件是直接打开 open 列表。2026-10-04 时开放议题 103 条，最新十几条都是同一份施工计划 [Spec #2991] 的拆解票，十八条里多数带
ready-for-agent 标签并标着 Blocked，创建时间是十几个小时前。16 真实用户的报错集中在 6 到 9 月：#1078 说三本小说一本都没跑通，Agent 不按章节切分，还把原文删改、对话遗漏（2026-07-09）；17 #2399 说脚本生成一直 connection error，重试 12 次没有结果（2026-09-07）；18 #2249 说火山 Seedance 2.0 把 AI 生成的真人参考图判成隐私内容直接拒绝（2026-08-31）。19 你能做的：按 Bug 前缀和日期筛议题，排障的起点放在项目自带的那份常见问题上。
许可与真实成本
仓库是 AGPL-3.0，另附一份 NOTICE 写明按许可证第 7 条追加的条款：修改过的版本必须在「适当的法律声明」和界面上的显著位置保留一行「Powered by ArcReel — https://github.com/ArcReel/ArcReel」，呈现界面的修改版还要保留指向原仓库的可见链接，并按第 7(c) 条标明自己做了哪些改动。20 这条对读者的实际含义是：自己部署自己用不受影响，把它改成白标产品对外提供就要带着这行署名。ArcReel 这个名称与 Logo 另算，不在 AGPL 的授权范围内；组织没法接受 AGPL 义务时，README 与 FAQ 都给了同一个入口，写信谈商业授权。13
软件本身不收费，也没有价目表。钱花在两处：Agent 那一层走你自己的 Anthropic 官方服务或兼容服务，生成那一层按模态分给各家供应商，各按各的价目结算。13 要一个能核对的单价，只能去供应商那边取。
火山方舟的官方文档里挂着一条限时优惠：Seedance 2.0 mini 与 2.0 fast 在 480p、720p 两档按刊例价打折，mini 四折、720p 最低约 0.2 元每秒，fast 七五折、720p 最低约 0.6 元每秒；活动期是北京时间 2026-08-07 14:00 到 10-07 14:00，只面向企业用户，且达到规定的 token 用量上限后恢复刊例价。21 按最低档折算，一分钟 720p 视频段的模型账约 12 元——今天离优惠结束还有三天。
走 Google 那条路，官方价目表上 Veo 3.1 标准档每秒 0.40 美元（720p 与 1080p）、4K 每秒 0.60 美元，Fast 档 0.10 / 0.12 / 0.30 美元，Lite 档 0.05 / 0.08 美元；图像这边 Nano Banana 2 一张 1K 图 0.067 美元，Nano Banana 初代一张 0.039 美元。22 同样按一分钟算，标准档 1080p 的视频段约 24 美元。这些是服务商的标价，跟 ArcReel 无关，也不含重跑和返工的倍数。
它自己那套费用追踪有明确的边界，FAQ 与供应商文档都写了：预估依据模型的价格声明和项目结构，跟供应商最终账单是两码事；自定义供应商没填价格、供应商没返回用量、或者价格没登记时，费用可能不完整，也可能显示为 0；不同币种分开统计，官方提醒不要直接相加。1013
还有一处要先分清楚：README 顶部那几行是赞助位。秘塔科技的 MiniMax H3 标着 768P 0.09 元每秒、2K 0.15 元每秒，另两家是 Fluxion AI 和 OfoxAI。11 那是广告位上的报价，跟项目的定价无关，项目本身也没有定价。
和之前几期放在一起看
| 方案 | 你给它什么 | 它给你什么 | 它在这一层 | 许可与公开体量 |
|---|---|---|---|---|
| ArcReel | 一台能跑 Docker 的机器、两套模型凭据、一段原文 | 资产、分集、分镜、视频，加一份能继续改的剪映草稿 | 自部署的产线工作台 | AGPL-3.0 附第 7 条条款，5,280 star1 |
| Toonflow（第 17 期） | 一台机器、四类模型 Key、逐段授权 | 一张可继续编辑的无限画布工程 | 编排与工作台 | MIT，16,402 star7 |
| ViMax（第 18 期） | 三类模型接口、一个工程目录、按天排的时间 | 从想法或剧本推到多镜头成片的一条产线 | 自带 Agent runtime 的多 Agent 编排 | MIT，12,538 star23 |
| OpenCreator（第 19 期） | macOS 或 Windows 机器、一个可用的 Codex 登录态 | 十项创作工具加一个 Agent 会话 | Codex 之上的宿主外壳 | Apache-2.0，12,583 star24 |
| OpenChatCut（第 16 期） | 素材与一句自然语言 | 可撤销的真时间线工程 | 编辑器加 MCP | AGPL-3.0，2,097 star25 |
| hypit（第 15 期） | 一条参考视频 | 可重跑的 SVML 作品源码 | 工作流描述语言 | 改过的 Apache-2.0，19,032 star26 |
| HyperFrames（第 14 期） | 一份 HTML / CSS 工程 | 逐帧拍出来的 mp4 | 渲染底座 | Apache-2.0，56,301 star27 |
| OpenStoryline（第 6 期） | 素材与一份 config.toml | 一条 18 节点的成片产线 | 自带 Agent 的产线 | Apache-2.0，3,456 star28 |
| video-use（第 2 期） | 一个装满素材的文件夹 | 读着词级转写稿剪出来的 final.mp4 | 编码 Agent 的剪辑技能包 | MIT，27,968 star29 |
| Diffusion Studio（第 13 期） | 一份 JSX 时间线 | 同一份文件上的协同编辑 | 编辑器 | MPL-2.0，3,207 star30 |
| Remotion | 一份 React 工程 | 程序化生成的视频 | 渲染底座 | 自订许可（GitHub 识别为 NOASSERTION），61,709 star31 |
表里每个数字都是 2026-10-04 当天从各仓库重新取的。
今天该不该动手
今天就装。 你手上已经有一段小说或一份成品剧本，想把它一路推到成片；工作机是 Linux、macOS 或 WSL2，愿意用 Docker 起服务；你要的产出是一份之后还能在剪映里改的工程，而不是一条不能再动的 mp4。这一类人今天装最划算：镜像现成，最新一版两天前发的，最近五周发了五个版本，3 默认流程走远程 API，机器不挑显卡。12
先收藏。 你在 Windows 原生环境上工作，沙箱会降级，官方建议换 WSL2 或 Docker Desktop；13 你要的是团队多人共用同一个实例，而它按单一可信操作员设计，PostgreSQL 部署也不给用户隔离；9 你期待它把一部长篇一口气做完而不用你审——FAQ 自己写着，长篇内容仍要人工审核分集、角色资产和关键剧情节点。13 这几类人今天装了，多半也要停在半路。
跳过。 你的目标只是从一段提示词到一个 mp4，用不着资产库、分集和剪辑时间线这些中间态，装它反而要多维护一套 Docker 和两套凭据；你要把它白标成对外服务，又不愿承担 AGPL-3.0 的源码开放义务，也不想走商业授权；再或者你只在手机或平板上做内容，它目前没有原生 App。13
References
- 1ArcReel/ArcReel
github.com
- 2Commits · ArcReel/ArcReel
github.com
- 3Releases · ArcReel/ArcReel
github.com
- 4Contributors · ArcReel/ArcReel
api.github.com
- 5arcreel/arcreel · Docker Hub
hub.docker.com
- 6架构说明 · ArcReel 文档
docs.arc-reel.com
- 7HBAI-Ltd/Toonflow-app
github.com
- 8ArcReel/skills
github.com
- 9部署与运维 · ArcReel 文档
docs.arc-reel.com
- 10供应商与模型配置 · ArcReel 文档
docs.arc-reel.com
- 11README · ArcReel/ArcReel
github.com
- 12完整入门教程 · ArcReel 文档\
docs.arc-reel.com
- 13常见问题 · ArcReel 文档\
docs.arc-reel.com
- 14剪映草稿导出 · ArcReel 文档\
docs.arc-reel.com
- 15#1661 · ArcReel/ArcReel
github.com
- 16Issues · ArcReel/ArcReel
github.com
- 17#1078 · ArcReel/ArcReel
github.com
- 18#2399 · ArcReel/ArcReel
github.com
- 19#2249 · ArcReel/ArcReel
github.com
- 20NOTICE · ArcReel/ArcReel
github.com
- 21创建视频生成任务 · 火山方舟
volcengine.com
- 22Gemini Developer API pricing
ai.google.dev
- 23HKUDS/ViMax\
github.com
- 24krillinai/OpenCreator\
github.com
- 250xsline/OpenChatCut\
github.com
- 26hypit-ai/hypit\
github.com
- 27heygen-com/hyperframes\
github.com
- 28FireRedTeam/FireRed-OpenStoryline\
github.com
- 29browser-use/video-use\
github.com
- 30diffusionstudio/editor\
github.com
- 31remotion-dev/remotion\
github.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.