seaislee1209 2b58331261 docs: add project README
Brief intro covering the pipeline, directory layout, quick start
(noting the --webpack workaround for the Turbopack panic on Windows),
tech stack, and links to the deeper docs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 19:43:04 +08:00
2026-05-14 16:08:49 +08:00
2026-05-14 16:08:49 +08:00
2026-05-14 16:08:49 +08:00
2026-05-14 16:08:49 +08:00
2026-05-14 19:43:04 +08:00

Air Spark

AI 驱动的动画自动化生产平台 · Air Spark 内部使用

导演通过对话生成剧本,系统自动串联图片生成 → 视频生成 → 拼接,输出完整成片。


核心理念

模型 + Skill = Agent

Skill 即系统提示词,定义 Agent 的行为规则和输出格式。新增内容类型 = 新增 Skill不改代码。


七阶段流水线

Stage 1  剧本对话           screenplay-skill
Stage 2  资产 & 分镜规划     storyboard-skill
Stage 3  片段切分            segmentation-skill
Stage 4  参考图生成          Banana Pro (人设图 / 场景图)
Stage 5  Keyshot 宫格图      空间锚点参考
Stage 6  视频生成            Seedance (提示词 + 参考图)
Stage 7  拼接成片

两条并行线均以剧本为输入:

  • 剧本 → storyboard-skill → Keyshot 宫格图(空间参考)
  • 剧本 → segmentation-skill → 片段提示词 → Seedance

目录结构

.
├── frontend/                    Next.js 16 (App Router) + React 19 + Tailwind v4
├── skills/                      项目 Skill 包(剧本、分镜、切分等)
├── skills-lock.json             Skill 版本锁
├── PRD.md                       产品需求文档
├── UI-Design-System.md          设计系统规范
├── DEV-LOG.md                   开发日志
├── seedance视频生成文档.md       Seedance API 集成参考
└── mook图/                      Mock / 参考图

快速开始

cd frontend
npm install
npx next dev --webpack

打开 http://localhost:3000

⚠️ Next.js 16 的 Turbopack 在部分 Windows 环境会 panicfailed to create whole tree),所以使用 --webpack 启动。

可用路由:

  • / — 首页
  • /dashboard — 项目工作台
  • /showcase — UI 展示

技术栈

  • FrontendNext.js 16.1.6 · React 19.2 · TypeScript 5 · Tailwind CSS v4
  • 图标lucide-react
  • 视频生成:火山引擎 Seedance参见 seedance视频生成文档.md
  • 图像生成Banana Pro
  • 对话/规划Claude通过 Skill 体系驱动)

角色

角色 核心需求
导演 对话写剧本 → 一键触发流水线 → 审核成片
管理员 管理成员、API Key、Skill 配置

内容层级

Project一部动画 IP
├── Asset Library角色/场景图,跨集复用)
└── EpisodeEP01, EP02 ...
    ├── script.md
    ├── 流水线状态
    └── 各阶段输出文件

更多文档

Description
No description provided
Readme 324 KiB
Languages
TypeScript 97.2%
CSS 2.3%
Dockerfile 0.3%
JavaScript 0.2%