2b58331261
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>
110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# 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 / 参考图
|
||
```
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npx next dev --webpack
|
||
```
|
||
|
||
打开 http://localhost:3000
|
||
|
||
> ⚠️ Next.js 16 的 Turbopack 在部分 Windows 环境会 panic（`failed to create whole tree`），所以使用 `--webpack` 启动。
|
||
|
||
可用路由：
|
||
|
||
- `/` — 首页
|
||
- `/dashboard` — 项目工作台
|
||
- `/showcase` — UI 展示
|
||
|
||
---
|
||
|
||
## 技术栈
|
||
|
||
- **Frontend**：Next.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（角色/场景图，跨集复用）
|
||
└── Episode（EP01, EP02 ...）
|
||
├── script.md
|
||
├── 流水线状态
|
||
└── 各阶段输出文件
|
||
```
|
||
|
||
---
|
||
|
||
## 更多文档
|
||
|
||
- [PRD.md](./PRD.md) — 完整产品需求
|
||
- [UI-Design-System.md](./UI-Design-System.md) — 设计系统
|
||
- [DEV-LOG.md](./DEV-LOG.md) — 开发日志
|
||
- [seedance视频生成文档.md](./seedance视频生成文档.md) — Seedance API 接入
|