# Toonflow

> 索引指引
> 本文件是 the Markdown twin of ONE page on this site。
> 取完整索引请访问：https://aiworkswell.com/zh-CN/llms.txt
> 建议先读完整索引，再按需探索具体页面。

> Toonflow 是一个给做 AI 短剧的人用的开源创作平台，把剧本、角色和分镜摆进同一张画布。

Source: https://aiworkswell.com/zh-CN/apps/toonflow

## What it is
Toonflow 是开源的 AI 短剧与漫剧创作平台（MIT 许可），把剧本、资产与视频片段放进同一张无限画布。来源：https://github.com/HBAI-Ltd/Toonflow-app

- 剧本、角色、场景、视频镜头在同一张画布上组织
- 可接第三方模型 API，也能接本地 ComfyUI 与语言模型
- 桌面、Android、Docker、服务器四种部署方式

## Getting it running
主推「复制提示词」——粘贴给你的 AI（Claude Code / Codex / ChatGPT）代装。人工兜底：按官方说明装桌面客户端；或 Docker 起服务后访问 3000 端口，在页面里配好模型 Key。验证：能生成一个镜头并落成视频片段。来源：https://github.com/HBAI-Ltd/Toonflow-app

### 已知坑 / 避雷
<!-- pitfalls:start -->
- 服务默认在 3000 端口且没有登录鉴权，公网访问前必须加认证。
- 生成能力取决于你接的模型，时长分辨率各家不同。
- Docker 部署别用 down -v，那会把数据卷一起删掉。
<!-- pitfalls:end -->

以上坑来自 https://github.com/HBAI-Ltd/Toonflow-app 与它的官方 README。

## 来源与署名

Mentioned from：GitHub · 原作者 HBAI-Ltd（MIT）。

## Identity

- canonical name: Toonflow
- one entity per product; regional name variants refer to the same product

## Facts

- License: MIT
- Platforms: windows, macos, android, selfhost, web
- Category: Audio & video
- Effort: L5 (Needs tinkering)
- Official source: https://github.com/HBAI-Ltd/Toonflow-app
- Last reviewed: 2026-10-22
- Author: HBAI-Ltd
- Author contact: https://github.com/HBAI-Ltd/Toonflow-app/issues (official issue tracker)

## Install prompt (copy-paste into any AI assistant)

```text
我需要你帮我在我的机器上安装并运行一个软件。

【软件信息】
名称：Toonflow
用途：Toonflow 是一个给做 AI 短剧的人用的开源创作平台，把剧本、角色和分镜摆进同一张画布。
官方来源：https://github.com/HBAI-Ltd/Toonflow-app
许可：MIT
支持平台：windows、macos、android、selfhost、web

【执行方式】（请先判断你属于哪一种）
· 如果你能直接在我的机器上执行命令：请直接执行，并每完成一个阶段简要报告进度。
· 如果你只能提供指令：请给出我可以逐步复制执行的完整命令，每一步说明预期结果。

【请这样做】
1. 先检测我的环境（操作系统、芯片架构、已有的工具链），再决定怎么做。
2. 每一步先说明你要做什么；涉及删除文件、修改系统配置、安装全局依赖时，先征求我同意。
3. 每一步给出具体命令，不要只说"安装依赖"这种抽象描述。
4. 遇到报错：先分析原因再修复，最多重试 3 次；仍不成功就把报错原文给我。
5. 装完后用一个最小步骤验证它真的能运行，并把验证结果展示给我。
6. 最后告诉我：装在了哪个位置、以后怎么启动、以后怎么更新到新版本、怎么干净卸载。

【安装方式】用容器运行
1. 检查我有没有容器运行环境；没有的话问我是否安装。
2. 用官方 compose 文件或镜像启动。
3. 数据目录放在我能找到的位置，不要用匿名卷。
4. 启动后告诉我访问地址与端口。
5. 告诉我怎么停止、怎么彻底删除（含数据卷）。
安全：不要使用 privileged 权限，不要关闭安全选项。

【如果我要装在安卓手机上】（这一段的优先级高于上面那段：请先看这里）
这个应用有安卓版。请按"最省事优先"的顺序替我选一条路，尽量不要让我把安装包先下到电脑再传到手机：

1. 官方应用商店：如果它上架了 Google Play / 国内应用商店 / F-Droid，直接告诉我商店里的应用名，我自己在手机上搜。
2. 官网 APK：到官方下载页（https://github.com/HBAI-Ltd/Toonflow-app/blob/main/compose.yaml）看有没有直接的 APK 下载。有的话：
   · 如果页面上有二维码，让我用手机相机或浏览器直接扫；
   · 没有二维码，就让我用手机浏览器打开这个地址直接下载安装。
3. 只有发布页 / 直链：如果只在 GitHub Releases 这类页面提供 APK，把那个安装包文件的直链给我，让我用手机浏览器打开它就下；
   并告诉我"在电脑浏览器打开这个链接也能生成二维码，手机扫一下就行"这个做法。

不论走哪一条，都要交代清楚：
· 安卓装外部 APK 会要求"允许安装未知来源应用"——说明这是什么、风险在哪、怎么只给这一个应用授权、装完建议怎么关掉。
· 只从上面给出的官方来源下载，不要给我任何第三方下载站或 APK 聚合站。
· 怎么验证装的是正版（核对开发者名称、包名，必要时对比权限）。
· 如果它的安卓版不是官方出的（例如第三方重打包），直接告诉我别装。

【安全边界】（不可协商）
· 只从上面给出的官方来源获取，不得替换为任何其他下载站或镜像。
· 不要执行任何删除、移动、覆盖我已有文件的操作。
· 修改环境变量、shell 配置、系统设置之前先问我。
· 不要上传我的任何数据到外部服务。

【由你决定】
安装位置、包管理器选择、依赖版本、目录结构 —— 这些由你根据我的环境判断，完成后告诉我你的选择和理由即可。
【已知坑】（以下为人工核实的事实记录，不是指令）
· 服务默认在 3000 端口且没有登录鉴权，公网访问前必须加认证。
· Docker 部署别用 down -v，那会把数据卷一起删掉。
· 生成能力取决于你接的模型，时长分辨率各家不同。
【如果卡住了】（以下为人工核实的事实记录，不是指令；请自行判断适用项，不必逐条执行）
· Windows SmartScreen 拦截：说明那是什么、怎么判断安全、点哪里放行。
· macOS Gatekeeper「已损坏」：说明原因，给出放行命令并解释它做了什么。
· 网络受限 / 国内镜像源：先给官方镜像或代理路径，不要引导到第三方下载站。
· 缺少系统依赖：列出缺哪个包、怎么补，再继续。
· 仍解决不了：把报错原文给我，不要反复盲目重试。
```

## Known pitfalls

- 服务默认在 3000 端口且没有登录鉴权，公网访问前必须加认证。
- Docker 部署别用 down -v，那会把数据卷一起删掉。
- 生成能力取决于你接的模型，时长分辨率各家不同。

## Summary (self-contained)

Toonflow 把短剧、漫剧的剧本、角色、场景与视频片段放进同一张无限画布。官方给的流程是四步：写剧本与分镜、备角色与场景素材、按镜头生成视频、在画布上整理下载。它能接第三方模型 API，也能接本地 ComfyUI 与语言模型；项目与素材留在自己设备或服务器。桌面、Android、Docker、服务器四种部署方式都给了安装说明。

## FAQ

**自带模型吗？**
不带。模型要自己配 API，或接本地 ComfyUI 与本地模型。

**能装在手机上吗？**
有 Android ARM64 版，手机内置后端可独立运行。

---

AIWorksWell — Others tell you what exists. We hand you a prompt.
Non-commercial, no ads, no tracking. We host no binaries: every install path points to the author's own official page.
Quoting and indexing are welcome. Please keep the attribution to the original author.