HBAI-Ltd/Toonflow-app

_{此联系方式仅用于商务合作接洽，不提供问题答疑。使用问题欢迎在交流群交流，需求与 BUG 可通过反馈表提交。感谢理解。}

1. 在“隐私与安全性”中允许 Toonflow

如果提示“无法验证开发者”或“Apple 无法检查 App 是否包含恶意软件”，先尝试打开 Toonflow，再前往“系统设置 → 隐私与安全性”，找到 Toonflow 被阻止的提示，点击“仍要打开”，并按提示确认。详见 Apple 官方说明。

2. 仍因系统隔离限制无法打开时，再尝试移除隔离属性

确认应用来自官方发布页，并已放入“应用程序”后，在终端执行以下命令，再重新打开。应用名称或安装位置不同时，请调整路径。

sudo xattr -rd com.apple.quarantine /Applications/toonflow.app

3. 最后手段：临时允许任何来源的 App

前两种方法均无效且确认应用来源可信时，可尝试在终端执行：

sudo spctl --master-disable

随后打开“系统设置 → 隐私与安全性”，在“安全性”中的“允许从以下位置下载的 App”选择“任何来源”（如果系统提供该选项），并按提示确认。不同 macOS 版本的选项与命令支持可能不同。

此操作会放宽所有 App 的安全限制。完成后建议将允许来源恢复为“App Store 和被认可的开发者”。

克隆源码后，在仓库根目录执行：

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
docker compose up -d --build

首次构建会安装依赖并编译内置节点、工具、Web 与 Server。启动后访问 http://127.0.0.1:3000；远程主机可按下方“访问与数据说明”通过 SSH 隧道访问。首次启动会初始化内置插件，并提供 myProject 工作目录。

配置、插件和项目文件保存在 Docker 命名卷 toonflowData 中，挂载至容器的 /app/data/。卷的实际名称带有 Compose 项目前缀；停止或重建容器会保留数据，请勿使用 docker compose down -v，该命令会删除数据卷。

docker compose logs -f toonflow  # 查看日志
docker compose stop             # 停止服务
docker compose start            # 再次启动
docker compose down             # 删除容器，保留数据卷

需要增加项目目录时，可在页面的“选择服务器工作目录”弹窗中点击“新建文件夹”。弹窗也支持文件和文件夹的重命名、删除。也可在服务运行期间通过命令行创建：

docker compose exec toonflow mkdir -p /app/data/workspaces/newProject

备份时先停止服务，复制完成后再启动：

docker compose stop
docker compose cp toonflow:/app/data ./toonflowBackup
docker compose start

安装运行环境：

sudo apt-get update
sudo apt-get install -y git curl unzip ffmpeg
curl -fsSL https://bun.com/install | bash -s "bun-v1.3.14"
export PATH="$HOME/.bun/bin:$PATH"
bun --version

克隆源码并启动：

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
bun install --frozen-lockfile

# 构建内置节点、工具、Web 与 Server
bun run build:server
mkdir -p data/workspaces/myProject
bun run start:server

看到“服务启动成功”后，可在服务器本机访问 http://127.0.0.1:3000。上述命令以前台方式运行，按 Ctrl+C 停止；需要开机自启和进程托管时，可参考 Bun 的 systemd 部署指南，将工作目录设为仓库目录，启动命令设为 Bun 的绝对路径加 run start:server，使用有权读写该目录的用户运行。

致 Toonflow 社区的一封信

130天。 不长，但足够让我们看清楚一些事情。 从第一行代码提交到今天，我们走过了 130天，发布了 20个版本，留下了 800+ 次Commits，写下了 213,765 行代码、640,810 个字符。 两次重构，一套供应商系统，一个我们引以为傲的工作流程。 我们以为这已经足够了。 但它不够。 有人跟我们说，想在 Toonflow 里加一个自己的模块，改半天看不懂。 有人跟我们说，社区太小，遇到问题找不到人。 有人跟我们说，商业条款让他们的项目无法落地。 我们听到了。 这 130 天里，团队成员轮流守在群里，7×24 小时回答每一个问题。没有赞助，没有补贴，全部是我们自己掏腰包支撑的人力成本。 不是因为我们有多少钱。 是因为我们相信这件事值得做。 所以，我们决定进行第三次重构。 Toonflow 的每一次重构，都往更开源更开放的方向发展。 这一次重构，我们选择：彻底开放。 　 一、MIT License 重构完成后我们决定把许可证从 Apache-2.0 更换为 MIT License 并去掉全部的商业附加条款。 它将完全的开放。没有任何的商业限制。 你可以用它做任何事。 　 二、全自由度插件系统 我们要重新设计整个插件架构。 故事板、全景图、时间轴、甚至——小游戏。 只要你想得到，就可以塞进来。 不是 Hack，是设计如此。 　 三、Drizzle ORM + 多数据库支持 升级至 Drizzle ORM。 本地、PostgreSQL、MySQL，按你的需要选择。 二开不再是噩梦。 　 四、Monorepo 全链路打通 插件开发、SDK 集成、发布上线，一条龙。 让贡献变得足够简单，简单到一个人就能做到。 　 五、新模块 无限画布 —— 不止于大，更在于自由 灵感模式 —— 为创作者而生 插件 Hub —— 让好插件被看见 Skill Hub —— 让经验可以传递 供应商 Hub —— 生态从这里开始 完善的 Docker 整合 —— 部署不再是门槛 　 然后，说一件我们一直不太好意思说的事。 重构需要时间。这段时间里，服务器在跑，域名在续费，团队在熬夜，咖啡在涨价。 我们没有融资，没有广告，没有任何隐藏的商业计划。 但我们需要活着，才能继续把这件事做完。 所以我们上线了「Toonflow 官方中转平台」 TF-Router。 说实话，这个平台我们犹豫了很久。 这个平台，不是我们想做的，我们不想因为一个中转平台，让人觉得 Toonflow 开始"恰饭"了。 这个包袱，我们背了很久。 但很多用户没有开白资格，用不上 Seedance 2.0，反复问我们有没有办法。 我们想了很久，没办法最后只能决定搭一个，我们自己和火山签了Seedance年框合同。 同时，我们决定平台活动期间对Seedance 2.0平进平出，不赚一分钱差价。 活动结束后我们会正常收取一点点点点服务费——但现在，先让你们用上再说。 更重要的是——TF-Router平台源码已经全部开源打包【开源地址】。 你不信任我们？没关系，你可以自己看代码，自己部署，自己跑。 这就是我们的态度。 如果你愿意去试用，是对我们目前唯一能支撑下去的方式投一票信任。 如果你不愿意，也没关系，继续用 Toonflow，继续骂我们，继续提需求。 我们都在。 最后说一句真心话 我们只是一群相信「创作工具应该属于每个人」的普通人。 Toonflow 从来不是我们的产品。 它是我们一起写的故事。 第三次重构，不是终点。 是我们重新出发的地方。 感谢每一个用过它、骂过它、给过建议的人。 你们才是让它走到今天的原因。 谢谢你们。