zyc/video-flow-toon

Fork 0

ACT丶流星雨 122d2aa431 修复readme路径问题

2026-05-12 16:27:01 +08:00

41 KiB

Raw Permalink Blame History

| |

TypeScript Node.js Docker Electron

Tech Stack Icons

Visitors

🚀 Комплексная платформа для создания сериалов: от текста до персонажей, от раскадровки до видео — полный AI-конвейер с нулевым порогом входа, повышающий эффективность творчества в 10+ раз!

🌐 Многоязычная поддержка

Toonflow поддерживает интерфейс на следующих языках:

Язык	Language
简体中文	Chinese (Simplified)
繁體中文	Chinese (Traditional)
English	English
ไทย	Thai
Tiếng Việt	Vietnamese
日本語	Japanese
Русский	Russian

💡 Скоро будут добавлены другие языки. Приветствуется помощь с переводами!

🌟 Основные функции

Toonflow — это AI-рабочее место для производства сериалов, выстроенное вокруг полного цикла «планирование → сценарий → раскадровка → вывод», с поддержкой локализации, программируемости и непрерывной итерации.

✅ Бесконечный холст для производства
Организация сценариев, персонажей, раскадровок, материалов и видеоузлов в формате бесконечного холста со свободным редактированием, возможностью отката и параллельным производством, без ограничений линейными шагами.
✅ Трёхуровневая система Agent-взаимодействия
Совместная работа уровня принятия решений, уровня исполнения и уровня контроля, охватывающая декомпозицию задач, генерацию контента, проверку качества и обратную связь для повышения стабильности и согласованности результатов.
✅ Персистентная память Agent
Межсессионная система памяти на основе локального векторного поиска ONNX с поддержкой краткосрочных сообщений, долгосрочных сводок и семантического поиска для обеспечения непрерывности многораундового творчества.
✅ Программируемая система провайдеров
Поддержка написания TypeScript-логики провайдера непосредственно в центре настроек с мгновенным вступлением в силу, без изменения исходного кода или перезапуска, для лёгкой кастомизации и подключения множества моделей.
✅ Адаптация на основе графа событий глав
Автоматическое извлечение и структурированное хранение событий глав оригинального произведения; адаптация сценария с точным вызовом контекста по графу событий для уменьшения потери информации в длинных текстах.
✅ Конфигурация навыков (Skill) в файлах
Ключевые промпты ScriptAgent и ProductionAgent вынесены в Markdown-файлы навыков с поддержкой онлайн-редактирования и быстрой настройки.

📦 Сценарии применения

Создание коротких видеороликов
Эксперименты по экранизации романов
Инструменты AI-адаптации литературы
Разработка сценариев и быстрое прототипирование
Генерация видеоматериалов

🔰 Руководство по использованию

Быстрый старт

Запустите приложение и войдите (учётные данные по умолчанию: admin / admin123).
В центре настроек выполните конфигурацию провайдеров моделей (текстовые/изображения/видеомодели).
Создайте новый проект и импортируйте оригинальное произведение, выполните извлечение событий глав.
Перейдите в ScriptAgent для генерации сюжетного каркаса, стратегии адаптации и структурированного сценария.
Переключитесь в ProductionAgent для организации раскадровок, материалов и видеоузлов на бесконечном холсте.
Выполните узловую точную настройку изображений раскадровки, после чего верните их на рабочее место для склейки видео и экспорта.

📺 Видеоурок

https://www.bilibili.com/video/BV1oXD7BqEqJ

Toonflow: быстрый старт с AI-видео за 12 минут 👉 Нажмите для просмотра

📱 Отсканируйте QR-код в WeChat для просмотра

📸 Скриншоты и видео демонстрации

Следующие скриншоты и видео взяты из AI-сериала-демо, созданного с помощью Toonflow. Весь процесс занял около 2 часов, включая генерацию сценария, создание раскадровки и монтаж.

🎬 Демо-видео

https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9

Если видео не воспроизводится, скачайте его

Информация о демо

Параметр	Значение
Время производства	Около 2 часов
Видеомодель	Seedance 2.0
Модель изображений	GPT Image 2
Языковая модель	Claude Opus 4.6
Общая длительность	Около 2 минут (исходно 3 мин, вырезано около 1 мин неудачных дублей)

Детализация затрат

Тип модели	Стоимость
Языковая модель	~ ¥10
Видеомодель (полная генерация)	~ ¥120
Модель изображений	менее ¥1
Итого	~ ¥130

Примечание: Исходное разрешение демо — 1080×1882, опубликованная версия сжата до 480p. В случае нарушения авторских прав просьба свяжитесь с нами для удаления.

🚀 Установка

Предварительные требования

Перед установкой и использованием программного обеспечения подготовьте следующее:

✅ Адрес API-интерфейса большой языковой модели AI
✅ Адрес API-интерфейса видеосервиса Sora или Doubao
✅ API-интерфейс сервиса генерации изображений Nano Banana Pro

Локальная установка

1. Загрузка и установка

Операционная система	GitHub	Примечание
Windows	Release	Официальный установочный пакет
Linux	Release	Официальный установочный пакет
macOS	Release	Официальный установочный пакет

Caution

Пользователям MacOS необходимо перейти в Настройки → Конфиденциальность и безопасность, чтобы настроить безопасность, иначе приложение может не открыться из-за проблем с сертификатом.

Справочная статья на Zhihu: https://www.zhihu.com/question/433389276

Из-за ограничений среды Gitee OS и ограничений на размер загружаемых файлов Release, ссылки для скачивания с Gitee Release временно не предоставляются.

2. Запуск сервиса

После завершения установки запустите программу, чтобы начать использование.

⚠️ Первый вход
Логин: admin
Пароль: admin123

Развёртывание через Docker

Предварительные требования

Установлен Docker (версия 20.10+)

Способ 1: Онлайн-развёртывание

В разработке. Пока используйте локальную сборку.

Способ 2: Локальная сборка

Соберите проект из исходного кода. Подходит для разработчиков или пользователей, уже клонировавших репозиторий. Для этого требуется локально установленный git:

# Клонируйте проект (пропустите, если уже есть)
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

# Локальная сборка и запуск через docker-compose
yarn docker:local

# Или соберите вручную
docker build -t toonflow .
docker run -d -p <локальный_порт>:10588 -v <локальный_путь_данных>:/app/data toonflow

# После этого страница будет доступна по пути /web/index.html на соответствующем порту
# Например: http://localhost:10588/web/index.html

Описание портов сервиса

Порт	Назначение	Маппинг при развёртывании
`10588`	Веб-интерфейс	`10588:10588`

Описание переменных окружения:

Переменная	Описание
`NODE_ENV`	Среда выполнения, `prod` — производственная среда
`PORT`	Порт прослушивания сервиса (по умолчанию 10588)
`OSSURL`	Адрес доступа к файловому хранилищу для статики

Облачное развёртывание

1. Требования к серверу

ОС: Ubuntu 20.04+ / CentOS 7+
Node.js: 24.x (рекомендуется, минимум 23.11.1+)
Память: 2GB+

2. Развёртывание на сервере

1. Установка окружения

# Установка Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
# Установка Yarn и PM2
npm install -g yarn pm2

2. Развёртывание проекта

Клонирование с GitHub:

cd /opt
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

Клонирование с Gitee (рекомендуется для Китая):

cd /opt
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

3. Настройка PM2

Создайте файл pm2.json:

{
  "name": "toonflow-app",
  "script": "data/serve/app.js",
  "instances": "max",
  "exec_mode": "cluster",
  "env": {
    "NODE_ENV": "prod",
    "PORT": 10588,
    "OSSURL": "http://127.0.0.1:10588/"
  }
}

Описание переменных окружения:

Переменная	Описание
`NODE_ENV`	Среда выполнения, `prod` — производственная среда
`PORT`	Порт прослушивания сервиса
`OSSURL`	Адрес доступа к файловому хранилищу для статики

4. Запуск сервиса

pm2 start pm2.json
pm2 startup
pm2 save

5. Часто используемые команды

pm2 list              # Просмотр процессов
pm2 logs toonflow-app # Просмотр логов
pm2 restart all       # Перезапуск сервиса
pm2 monit             # Панель мониторинга

⚠️ Первый вход
Логин: admin
Пароль: admin123

6. Развёртывание фронтенда

Для отдельного развёртывания или кастомизации фронтенда обратитесь к репозиторию фронтенда:

GitHub: Toonflow-web
Gitee: Toonflow-web

💡 Примечание: Данный репозиторий уже содержит скомпилированные фронтенд-ресурсы. Обычным пользователям не требуется отдельно развёртывать фронтенд. Репозиторий фронтенда предназначен только для разработчиков, которым нужна доработка.

🔧 Руководство по процессу разработки

Caution

🚧 Правила отправки PR 🚧

⛔ Ветка master не принимает PR ｜ ✅ Пожалуйста, отправляйте PR в ветку develop

Приветствуется совместное участие разработчиков в создании Toonflow. Если вы заинтересованы, свяжитесь с руководителем ACT в группе общения.

🛠️ Технологический стек

Категория	Технологии
Среда выполнения	Node.js 23.11.1+
Язык	TypeScript 5.x
Бэкенд-фреймворк	Express 5
База данных	SQLite (better-sqlite3 / knex)
AI-интеграция	Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Tongyi / xAI)
Локальный инференс	@huggingface/transformers (ONNX)
Реалтайм-связь	Socket.IO
Десктопный клиент	Electron 40
Обработка изображений	Sharp
Контейнеризация	Docker

Подготовка среды разработки

Node.js: версия 23.11.1 и выше
Yarn: рекомендуется в качестве менеджера пакетов

Быстрый запуск проекта

Клонирование проекта

Клонирование с GitHub:
```
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
```
Клонирование с Gitee (рекомендуется для Китая):
```
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
```
Установка зависимостей

Выполните следующую команду в корневой директории проекта для установки зависимостей:
```
yarn install
```
Запуск среды разработки

Проект состоит из бэкенд-сервиса API и фронтенда. Выберите способ запуска по необходимости:
- Способ 1: Запуск только бэкенда
```
yarn dev
```
  ⚠️ Эта команда запускает только бэкенд-сервис API (порт 10588), не включая фронтенд. При прямом обращении к http://localhost:10588 будут доступны только API, но не полный веб-интерфейс. Для одновременного использования фронтенда запустите его отдельно или используйте режим GUI ниже.
- Способ 2: Запуск Electron-клиента
```
yarn dev:gui
```
  Эта команда одновременно запускает бэкенд и окно Electron Desktop со встроенным фронтендом — готовое решение «из коробки», не требующее дополнительных настроек. Подходит для разработчиков, желающих опробовать все функции.
- Способ 3: Запуск в production-режиме
```
yarn start
```
  Запуск предварительно скомпилированного сервиса в production-режиме (требуется предварительно выполнить yarn build).
Сборка проекта
- Компиляция TypeScript-файлов:
```
yarn build
```
- Сборка исполняемого файла для Windows:
```
yarn dist:win
```
- Сборка исполняемого файла для macOS:
```
yarn dist:mac
```
- Сборка исполняемого файла для Linux:
```
yarn dist:linux
```
Проверка качества кода
- Глобальная проверка синтаксиса и соответствия стандартам:
```
yarn lint
```
Отладочная панель AI (опционально)

Запуск визуального инструмента отладки AI SDK для удобства отладки AI-вызовов:
```
yarn debug:ai
```

Разработка фронтенда

Для изменения фронтенда перейдите в соответствующий репозиторий:

GitHub: Toonflow-web
Gitee: Toonflow-web

После сборки фронтенда скопируйте содержимое директории dist в директорию data/web данного проекта.

Структура проекта

📂 build/                    # Результаты компиляции
📂 data/                     # Данные времени выполнения
│  ├─ 📂 models/            # Локальные модели инференса (ONNX)
│  ├─ 📂 oss/               # Объектное хранилище (материалы/персонажи/сцены)
│  ├─ 📂 serve/             # Точка входа production-среды
│  ├─ 📂 skills/            # Промпты навыков Agent
│  └─ 📂 web/               # Скомпилированный фронтенд (встроенный)
📂 docs/                     # Документация
📂 env/                      # Конфигурация окружения
📂 scripts/                  # Скрипты сборки и вспомогательные скрипты
📂 src/
├─ 📂 agents/               # Модули AI Agent
│  ├─ 📂 productionAgent/   # Production Agent
│  └─ 📂 scriptAgent/       # Script Agent
├─ 📂 lib/                  # Общие библиотеки (инициализация БД, формат ответов)
├─ 📂 middleware/            # Промежуточное ПО
├─ 📂 routes/               # Модули маршрутов
│  ├─ 📂 agents/            # Управление памятью Agent
│  ├─ 📂 artStyle/          # Управление художественным стилем
│  ├─ 📂 assets/            # Управление материалами
│  ├─ 📂 assetsGenerate/    # Генерация материалов
│  ├─ 📂 cornerScape/       # Управление раскадровками
│  ├─ 📂 general/           # Общие интерфейсы
│  ├─ 📂 login/             # Аутентификация
│  ├─ 📂 migrate/           # Миграция данных
│  ├─ 📂 modelSelect/       # Выбор модели
│  ├─ 📂 novel/             # Управление романами
│  ├─ 📂 other/             # Прочие функции
│  ├─ 📂 production/        # Управление производством
│  ├─ 📂 project/           # Управление проектами
│  ├─ 📂 script/            # Генерация сценариев
│  ├─ 📂 scriptAgent/       # Интерфейс Script Agent
│  ├─ 📂 setting/           # Системные настройки
│  ├─ 📂 task/              # Управление задачами
│  └─ 📂 test/              # Тестовые интерфейсы
├─ 📂 socket/               # WebSocket-реалтайм-связь
├─ 📂 types/                # Объявления типов TypeScript
├─ 📂 utils/                # Вспомогательные функции
├─ 📄 app.ts                # Точка входа приложения
├─ 📄 core.ts               # Базовая инициализация
├─ 📄 env.ts                # Обработка переменных окружения
├─ 📄 err.ts                # Обработка ошибок
├─ 📄 logger.ts             # Модуль логирования
├─ 📄 router.ts             # Регистрация маршрутов
└─ 📄 utils.ts              # Общие утилиты
📄 Dockerfile                # Файл сборки Docker
📄 electron-builder.yml      # Конфигурация сборки Electron
📄 skillList.json            # Список навыков
📄 LICENSE                   # Лицензия (Apache-2.0)
📄 NOTICES.txt               # Уведомления о сторонних зависимостях
📄 package.json              # Конфигурация проекта
📄 tsconfig.json             # Конфигурация TypeScript

🔗 Связанные репозитории

Репозиторий	Описание	GitHub	Gitee
Toonflow-app	Полный клиент (данный репозиторий, рекомендуется обычным пользователям)	GitHub	Gitee
Toonflow-web	Исходный код фронтенда (для фронтенд-разработчиков)	GitHub	Gitee

💡 Подсказка: Если вы просто хотите использовать Toonflow, скачайте клиент из этого репозитория. Репозиторий фронтенда предназначен только для разработчиков, которым требуется доработка или кастомизация интерфейса.

👨‍👩‍👧‍👦 Группа в WeChat

Помощник для добавления в группу:

Вы также можете присоединиться к Discord, нажав на иконку:

Или перейдя по ссылке-приглашению: https://discord.gg/HEjKmpNpAZ

💌 Контакты

📧 Эл. почта: ltlctools@outlook.com

📜 Лицензия

Toonflow распространяется с открытым исходным кодом по лицензии Apache-2.0 с дополнительным коммерческим соглашением.

Подробности лицензии: https://www.apache.org/licenses/LICENSE-2.0

Дополнительное соглашение

Если данное программное обеспечение распространяется в виде продукта двум и более независимым третьим сторонам, необходимо получить письменное коммерческое разрешение от HBAI-Ltd.
Совместное внутреннее использование ≤ 5 юридическими лицами без предоставления услуг внешним сторонам считается внутренним использованием и не требует разрешения.
Запрещается удалять или изменять идентификационные знаки и информацию об авторских правах Toonflow.

Сценарии постоянного бесплатного использования

✅ Создание контента с помощью Toonflow и получение дохода от платформы
✅ Доработка для внутреннего использования в своей команде
✅ Совместное внутреннее использование ≤ 5 юридическими лицами
✅ Личное обучение, исследования, некоммерческое использование

Цены на коммерческое лицензирование

Этап	Годовой объём продаж	Годовая плата
🌱 Поддержка	< ¥100 000	Бесплатная лицензия по запросу
🚀 Старт	¥100 000 – 500 000	¥5 000/год
📈 Рост	¥500 000 – 1 500 000	¥20 000/год
🏢 Масштабирование	¥1 500 000 – 5 000 000	¥80 000/год
🌐 Корпоративный	> ¥5 000 000	Обсуждается

Положение о неретроактивности: Пользователи, использовавшие программное обеспечение на условиях AGPL-3.0 до выхода версии v1.0.8, продолжают действовать в соответствии с AGPL-3.0 и не подпадают под действие изменений данного соглашения.

Полный текст соглашения см. в файле LICENSE.

⭐️ Звёзды

🙏 Благодарности

Благодарим следующие проекты с открытым исходным кодом за мощную поддержку Toonflow:

Express — Быстрый, свободный и минималистичный веб-фреймворк для Node.js
AI SDK — AI-инструментарий для TypeScript
Better-SQLite3 — Высокопроизводительная библиотека привязки SQLite3
Sharp — Высокопроизводительная библиотека обработки изображений для Node.js
Axios — HTTP-клиент на основе Promise
Zod — TypeScript-ориентированная библиотека валидации схем
Socket.IO — Двунаправленный движок реалтайм-коммуникаций
Electron — Кроссплатформенный фреймворк для разработки десктопных приложений
Hugging Face Transformers — Локальная библиотека ML-инференса

Благодарим следующие организации и лица за поддержку Toonflow:

Название	Форма поддержки	Описание	Веб-сайт
SuanNeng Cloud	💻 Спонсорство вычислительных мощностей	Стремится создать более быструю, стабильную и экономичную универсальную платформу API-сервисов для инференса моделей.	Веб-сайт
Atlas Cloud	💻 Спонсорство вычислительных мощностей	Первая в мире универсальная мультимодальная платформа инференса. Диалог, изображения, видео, аудио — всё через единый API. Более 300 моделей, совместимость с OpenAI.	Веб-сайт
Tencent Hunyuan 3D	🌐 Техническая поддержка мировых моделей	AI-движок создания 3D-контента на основе большой модели генерации 3D Tencent Hunyuan версии 2.5 — первая в отрасли универсальная AI-платформа для создания 3D. Поддерживает генерацию 3D из текста и изображений, 3D-анимацию, генерацию текстур и многое другое, включая генерацию 3D из набросков, создание 3D-персонажей и преимущества в создании low-poly моделей.	Веб-сайт

Полный список сторонних зависимостей см. в файле NOTICES.txt

41 KiB Raw Permalink Blame History Unescape Escape

🌐 Многоязычная поддержка

🌟 Основные функции

📦 Сценарии применения

🔰 Руководство по использованию

Быстрый старт

📺 Видеоурок

📸 Скриншоты и видео демонстрации

🎬 Демо-видео

Информация о демо

Детализация затрат

🚀 Установка

Предварительные требования

Локальная установка

1. Загрузка и установка

2. Запуск сервиса

Развёртывание через Docker

Предварительные требования

Способ 1: Онлайн-развёртывание

Способ 2: Локальная сборка

Описание портов сервиса

Облачное развёртывание

1. Требования к серверу

2. Развёртывание на сервере

1. Установка окружения

2. Развёртывание проекта

3. Настройка PM2

4. Запуск сервиса

5. Часто используемые команды

6. Развёртывание фронтенда

🔧 Руководство по процессу разработки

🛠️ Технологический стек

Подготовка среды разработки

Быстрый запуск проекта

Разработка фронтенда

Структура проекта

🔗 Связанные репозитории

👨‍👩‍👧‍👦 Группа в WeChat

💌 Контакты

📜 Лицензия

Дополнительное соглашение

Сценарии постоянного бесплатного использования

Цены на коммерческое лицензирование

⭐️ Звёзды

🙏 Благодарности

copyright © Beijing Ai'a Technology Co., Ltd.

41 KiB

Raw Permalink Blame History