Animation Editor

2D 动画编辑器，集成 AI 帧生成功能。支持图层管理、骨骼动画、时间轴编辑，并可通过 AI 自动生成动画帧序列。

技术栈

• 前端: Svelte 5 + Vite + Pixi.js 8 + TypeScript
• 后端: Python 3.12 + FastAPI + httpx + Pillow
• 部署: Docker + nginx + supervisord

快速开始

Docker 部署（推荐）

cp .env.example .env   # 按需修改配置
docker-compose up --build

访问 http://localhost:3000

本地开发

前端:

cd frontend
npm install
npm run dev

前端运行在 http://localhost:5173，自动代理 /api 请求到后端。

后端:

cd backend
pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8000

AI 提供商配置

支持三种 AI 提供商，通过 .env 文件配置：

提供商	类型	默认模型	说明
Ollama	本地	llava	默认提供商，需本地运行 Ollama
LM Studio	本地	stable-diffusion-xl	兼容 OpenAI API 格式
Cloud (OpenAI)	云端	dall-e-3	需要 API Key

若未配置任何 AI 提供商（后端未启动），编辑器中 AI 面板将自动隐藏。

项目结构

├── frontend/                # Svelte 前端
│   └── src/lib/
│       ├── components/      # UI 组件（canvas, panels, timeline, ai, export, layout）
│       ├── stores/          # Svelte 5 runes 状态管理
│       ├── services/        # 业务逻辑 & API 调用编排
│       ├── types/           # TypeScript 类型定义
│       └── utils/           # 工具函数（API 客户端、导出、数学计算）
├── backend/                 # FastAPI 后端
│   └── app/
│       ├── routers/         # API 路由（health, ai, images）
│       ├── services/        # AI 提供商实现（Ollama, LM Studio, Cloud）
│       ├── models/          # Pydantic 数据模型
│       └── utils/           # 图片处理
├── docker/                  # Dockerfile, nginx, supervisord 配置
├── docker-compose.yml
└── .env.example             # 环境变量模板

核心功能

• 图层管理 — 多图层编辑，支持资产导入和属性调整
• 骨骼动画 — 2D 骨骼系统，支持关键帧动画
• 时间轴 — 帧级别动画编辑和预览
• AI 帧生成 — 上传基础图片，选择动画类型（行走、奔跑、待机、攻击、跳跃、死亡），AI 自动生成帧序列
• 导出 — 支持 PNG 和 JSON 格式导出