GitHub 趋势 · 第 95 期

15,544 星的 AI 短剧工厂,代码停了三个月,README 一直在更

#AI短剧#开源许可#趋势精读

先给判断

Toonflow 值得看,因为它把小说 → 剧本 → 分镜 → 角色 → 视频这条链路做成了一个跨平台桌面端,而且把授权条款一条条写在了 LICENSE 里,而不是藏在官网某个角落。

但它不是那种本地跑模型、断网也能用的软件。它是编排层:三条外部模型服务是硬前置,README 把它们列在「前置条件」里,一条都没省略。

还有一件更值得先看的事 —— 这个仓库的 src/ 停在 6 月 8 日,此后的提交没有一条碰过它。后面单独说。

痛点:卡点从来不是没工具

想把一本小说或者一份剧本批量变成可发的短剧,最容易低估的其实不是分镜,是账单。编排工具把「AI 编剧、智能分镜、角色与视频生成」都做成了界面,但大模型、视频模型、图片模型这三条线,钱和额度得你自己接进去。Toonflow 的 README 把这件事说得很直白:一次小说转剧本的调用,作者给出的报价是每次约 6.4 毛钱

项目是什么

仓库描述原文是 Toonflow 是开源一站式 AI 短剧创作工具,将小说、剧本快速转化为动画短剧,功能点是 AI 编剧、智能分镜、角色与视频生成,交付形态是跨平台桌面端。作者在 README 里给自己的定位是「一站式短剧工程」,原文写法是:

🚀 一站式短剧工程:从文本到角色,从分镜到视频,0门槛全流程AI化,创作效率提升10倍+!

技术栈取自 README 原表,整理如下:

类别技术
运行时Node.js 23.11.1+
语言TypeScript 5.x
后端框架Express 5
数据库SQLite(better-sqlite3 / knex)
AI 集成Vercel AI SDK(OpenAI / Anthropic / Google / DeepSeek / 智谱 / MiniMax / 通义千问 / xAI)
本地推理@huggingface/transformers(ONNX)
实时通信Socket.IO
桌面客户端Electron 40
图像处理Sharp
容器化Docker

注意 AI 集成那一行:它接的是别家的模型服务,本地推理只有一个 ONNX 运行时。所以「0门槛」这个说法要按它自己的前置条件来读。

核心能力

上手:前置条件 + README 原命令

先把 README 的「前置条件」三条原样抄下来,这是能不能跑起来的分水岭:

✅ 大语言模型 AI 服务接口地址
✅ Sora 或豆包视频服务接口地址
✅ Nano Banana Pro 图片生成模型服务接口

本地 Docker 构建与云服务器部署的命令,均逐字取自 README:

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

yarn docker:local

docker build -t toonflow .
docker run -d -p <本地端口>:10588 -v <本地数据路径>:/app/data toonflow

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
npm install -g yarn pm2

yarn install
yarn build
pm2 start pm2.json

开发态三种启动方式与打包命令同样来自 README:

yarn dev       # 仅后端 API(端口 10588)
yarn dev:gui   # Electron 桌面客户端
yarn start     # 生产模式
yarn dist:win / yarn dist:mac / yarn dist:linux

README 自己对 yarn dev 加了一句警告,原文是:此命令仅启动后端 API 服务(端口 10588)不包含前端页面。直接访问 10588 只能调接口,看不到界面。

另外 README 的「方式一:在线部署」整节只有一句话:待完善,暂时使用本地构建。 所以想省事的话,直接去 Release 页下安装包,别走在线部署。

首次登录的默认凭据也印在 README 里:账号 admin,密码 admin123。装完第一件事就是改掉它。

src/ 停在 6 月 8 日,之后的提交没有一条碰过它

这个项目最新的正式版是 v1.1.8,发布于 2026-06-08;而 src/ 目录最后一次改动也是 2026-06-08。用 commits API 带上 path 过滤查 src/,返回的最新一条提交就停在 v1.1.8 那一天。

那之后仓库还在动吗?在动。抓最近一页 15 条提交,全部晚于 v1.1.8 的发布日期,但内容是这样分布的:

正好 5 + 1 + 1 + 1 + 1 + 6 = 15 条,覆盖了最近这一页的全部提交。换句话说:从 6 月中旬到 8 月底这两个多月里,src/ 一行没动,README、证书图片和赞助信息一直在更。这不是我在推测 —— 提交信息原文就是「更新README」「补全证书图片」「新增秘塔赞助」。

发布节奏这一层的数字也对不上:仓库里能打到的 tag 首页就有 15 个(最早到 v1.0.5),而带安装包的 Release 只有 6 个,从 v1.1.3(2026-04-10)到 v1.1.8(2026-06-08)两个月发完;而 star 已经到 15,544。发布节奏和热度曲线在这一段时间里是分开走的。

维度实测值
Star(API 实测)15,544
Fork2,793
Watcher(subscribers)70
未关闭 issue4
最近一次提交2026-08-26
src/ 最近一次改动2026-06-08
最近一次发版v1.1.8,2026-06-08

Star 和订阅数放在一起看更清楚:15,544 : 70,差不多 222 : 1。未关闭 issue 只有 4 条,issue 密度约 0.026%。这两个数不矛盾 —— 它们合起来说明的是:绝大多数人是收藏了这个方向,而不是装了它在用、并且会回来提问题。

许可:Apache-2.0 后面还跟着一份商业协议

GitHub 的 license 字段给出的是 Apache-2.0,但 LICENSE 文件一共 14,536 字节。标准 Apache-2.0 全文大概 11 KB 出头,多出来的那部分是一个独立的「补充协议」章节,中英双语,分四节。只看平台字段会漏掉它,所以这一节建议直接打开 LICENSE 读到底。

其中两条我按原文抄下来。分发门槛这条:

若您将本软件或其衍生版本以产品形式分发、销售或提供给两个及以上独立的第三方主体使用
(无论采用买断、订阅、授权或任何其他商业模式),均须事先取得 HBAI-Ltd 的书面商业授权。

内部使用的例外也是原文:

五个以内(含五个)的法人主体作为联合运营方共同使用本软件,
且不向联合体以外的第三方分发或提供服务的,视为内部使用,无需商业授权。

授权定价表(README 与 LICENSE 两处口径一致):

阶段年销售额年费
扶持期< ¥10 万免费
初创期¥10–50 万¥5,000 / 年
成长期¥50–150 万¥20,000 / 年
规模期¥150–500 万¥80,000 / 年
企业级> ¥500 万面议

最值得注意的是第四节。这个项目此前用的是 AGPL-3.0,换成 Apache-2.0 + 商业协议之后,作者专门写了一段不追溯条款,原文是:

本协议变更生效日期(v1.0.8 正式发布日)前,基于 AGPL-3.0 条款使用 Toonflow 的用户,
其现有使用行为不受本协议变更的约束,继续按 AGPL-3.0 条款执行。

把存量用户继续按旧协议执行写进 LICENSE 本身,在这类项目里不常见。换个角度看也很直白:AGPL 时代的分叉义务比现在重,作者用一条不追溯条款把存量用户摘出去,新用户则按 Apache-2.0 加商业协议走。

还有一个细节:LICENSE 的 Apache 附录样板没有填。那一段现在仍然是原文占位符 Copyright [yyyy] [name of copyright owner],没有替换成实际的年份和版权方。协议正文写得越细,这个没填的占位符就越显眼。

体积与下载量:产物是仓库的 7.4 倍

v1.1.8 一共 6 个安装包,合计约 2.14 GB;而仓库自身 282,777 KB,约 276 MB。产物是仓库体积的约 7.4 倍,方向上是典型的编译型分发 —— 源码不大,编出来的东西大。

安装包大小下载量
Windows x64264 MB19,553
Windows arm64273 MB2,058
macOS arm64 (dmg)285 MB3,635
macOS x64 (dmg)298 MB1,811
Linux x86_64 (AppImage)512 MB1,161
Linux arm64 (AppImage)512 MB1,116

下载量合计 29,334 次,其中 Windows x64 一个包占了 66.7%(19,553 ÷ 29,334)。macOS 那边 Apple Silicon 是 Intel 的约 2 倍(3,635 对 1,811)。也就是说:这个跨平台桌面端的真实用户主力是 Windows。

顺带一个可以直接复用的对照:macOS 用户装完还要手动处理一次证书。README 的原文是 MacOS 系统请到 设置-隐私与安全性 配置安全性否则可能因证书问题无法正常打开。另外 README 里的 Demo 声明写着 Demo 原始分辨率为 1080×1882,发布版本已压缩至 480p,想看画质的先对一下这个预期。

我的判断:适合谁 / 不适合谁 / 坑

适合谁:已经有稳定的模型额度、要把小说或剧本批量转成短剧的工作室和个人。它的价值是把你从拼装 prompt 和分镜表里解放出来,做成一条可复用的流水线,作者自己在 README 里挂了云端 GPU 的操作教程,说明目标用户是要跑量的。

不适合谁:想让模型跑在自己机器上、不给外部服务付费的人;以及只想先试试看的人 —— 三个前置服务没配好,界面能打开也出不了片。

坑一:许可不是纯 Apache-2.0。你要把它打包成产品卖给两个及以上独立第三方,需要先拿书面商业授权;团队内部用、自己发内容拿分账、个人研究,这几类免费。只读 GitHub 的 license 字段会以为可以随便商用,这是这个项目最容易被误读的一点。

坑二:src/ 已经三个月没动。src/ 停在 2026-06-08,之后的提交里没有一条动过它。这不等于项目死了,但意味着:现在遇到的功能性问题,短期内别指望修;另外它有 4 条未关闭 issue 和 70 个 watcher,提问前先搜一遍,别指望有社区兜底。

坑三:默认凭据是 admin / admin123,而且 README 把云服务器部署写得很完整 —— 意味着直接照抄上线的人会把这套默认密码暴露在公网。

坑四:在线部署还没做。README 的「方式一:在线部署」整节就一句待完善,只能走本地构建或下安装包。

最后给一句公道话:这类项目要有收入来源,把商业授权做成明码标价的分档、并且把不追溯条款写给老用户,比锁住功能再收钱体面得多。值得讨论的只是那条线画在哪 —— 免费交付给你的是一套软件,还是一个演示

数据脚注

仓库:HBAI-Ltd/Toonflow-app · https://github.com/HBAI-Ltd/Toonflow-app

Star 15,544 / Fork 2,793 / Watcher(subscribers)70 / 未关闭 issue 4(GitHub REST API 实测)

许可:Apache-2.0,LICENSE 14,536 字节,标准全文之后追加补充协议、永久免费场景、授权定价、AGPL 用户保护条款四节

语言 TypeScript · 仓库体积 282,777 KB · 创建 2026-01-29 · 默认分支 master · 未归档

最新版 v1.1.8(2026-06-08),6 个安装包合计约 2.14 GB,累计下载 29,334 次

README 多语言版本字节数:泰文 58,539 > 俄文 51,324 > 日文 40,169 > 越南文 38,988 > 英文 34,740 > 简体中文 32,085 > 繁体中文 31,979

本期的候选来自 GitHub 仓库搜索(按方向关键词 + 创建时间过滤),并非当日 Trending 榜单——原因见文末预告

数据来源:GitHub REST API 实测 + 仓库 README / LICENSE 原文 · 抓取时间:2026-09-14 11:0x

本文不构成法律意见;商用前请以仓库内 LICENSE 全文为准

你会把小说转短剧这条链路接给哪一家的模型?如果在意的是不用把自己的稿子发出去,那这个项目可能一开始就不适合你 —— 它的整个链路是建立在外部模型服务之上的。

下期预告:同一批检索里还站着几个方向完全重合的仓库 —— 写小说这一环有 oh-story-claudecode 与 show-me-the-story,短剧成片这一环有 Jellyfish。下一期如果榜单继续被写过的项目占满,就把它们并成一期从小说到成片的横向对比,把它们在故事记忆、分镜结构、模型依赖三件事上的取舍摆到一张表里。

上一期文末预告的开源替代 SaaS 合集(Gauzy / ERPNext / Odoo)这期没有兑现:那个主题不在本轮给定的内容创作方向里,先欠着;本期改从方向检索里取了一个动量与信息密度都更高的新面孔。

#AI短剧#开源许可#趋势精读