AI 真人短剧剪辑软件 — 从剧本文本到成片导出的全流程自动化生产工具
⚠️ 项目状态：因个人原因，本项目暂时停止更新。 代码已完整开源，欢迎 fork 和基于此项目继续开发。
FirstEdit 是一款开源桌面应用，专注于真人短剧的工业化生产。输入小说或剧本，AI 自动完成剧本工程化、角色资产提取、智能分镜编排、素材并行生成（文生图/图生视频/TTS），最终输出可发布的短剧成片。
基于 Electron + React + Python FastAPI 三层架构，支持接入 Claude / GPT / DeepSeek / 可灵 / 即梦 / 火山引擎等主流 AI 供应商。
- 剧本工程化 — 小说/剧本输入，AI 提取故事骨架、章节事件图谱、结构化剧本
- 角色资产包 — 角色参考图、衍生形象（换装）、视觉提示词管理
- 智能分镜 — AI 拆解分镜序列，镜头语言设计，无限画布编排
- 多模型调度 — 多供应商负载均衡 + 故障转移（轮询/随机/加权/最少负载）
- 提示词工程 — Jinja2 模板管理，在线编辑，版本控制
- 候选-确认模式 — AI 产出候选，用户确认后入库，防止重复漂移
| 层 | 技术 | 用途 |
|---|---|---|
| 桌面外壳 | Electron 33+ | 跨平台桌面运行时 |
| 构建工具 | electron-vite 3 | Vite 官方 Electron 集成 |
| 前端框架 | React 19 + TypeScript | UI 渲染 |
| 状态管理 | Zustand 5 | 轻量状态管理 |
| 样式 | Tailwind CSS 4 | 原子化 CSS |
| 数据库 | SQLite + better-sqlite3 + Drizzle ORM | 本地持久化 |
| Python 后端 | FastAPI | AI 模型网关、Pipeline 引擎 |
| AI 供应商 | OpenAI 兼容 / Gemini / Volcengine / Vidu 等 | LLM / 文生图 / 图生视频 / TTS |
三层进程架构：
前端渲染进程 (React UI)
↕ IPC
Electron 主进程 (Node.js — 项目管理/数据库/Sidecar 管理)
↕ 本地 HTTP
Python Sidecar (FastAPI — AI 网关/Pipeline/提示词引擎)
↕ HTTPS
外部 AI 服务 (LLM / 文生图 / 图生视频 / TTS)
- Node.js 22+
- Python 3.13+（推荐使用 uv 管理）
- Windows / macOS / Linux
# 安装前端依赖
npm install
# 安装 Python 依赖
cd python-sidecar
uv sync
cd ..# 方式一：同时启动前端 + Python 后端（两个终端）
npm run dev # 启动 Electron + Vite
npm run dev:python # 启动 FastAPI (127.0.0.1:8765)
# 方式二：仅前端（Electron 自动拉起打包的 Python sidecar）
npm run devnpm run build:win # Windows
npm run build:mac # macOS
npm run build:linux # Linuxfirst-edit/
├── electron/ # Electron 主进程
│ ├── main.ts # 主进程入口
│ ├── preload.ts # 预加载脚本（安全 IPC 桥）
│ ├── ipc/ # IPC 处理器
│ ├── services/ # 业务服务
│ └── db/ # 数据库层（Drizzle schema + 迁移）
├── src/ # 前端渲染进程（React）
│ ├── components/ui/ # UI 基础组件
│ ├── pages/ # 功能页面
│ ├── stores/ # Zustand 状态
│ └── services/ # IPC 调用封装
├── python-sidecar/ # Python AI 后端
│ └── app/
│ ├── routers/ # API 路由（AI 网关/健康检查/Pipeline）
│ ├── pipeline/ # Pipeline 责任链引擎
│ ├── candidates/ # 候选-确认管理
│ ├── model_router/ # 多模型负载均衡
│ ├── prompts/ # 提示词模板管理
│ └── providers/ # AI 供应商适配器
├── shared/ # 前后端共享类型
├── docs/
│ └── screenshots/ # README 界面截图
└── LICENSE # AGPL-3.0
| 类型 | 供应商 |
|---|---|
| LLM | Claude / GPT / DeepSeek / 通义 / 智谱 / Gemini / MiMo |
| 文生图 | Flux / SDXL / GPT-Image / 即梦 / 火山 Seedream |
| 图生视频 | 可灵 / 即梦 / Sora / Seedance / Vidu |
| TTS | OpenAI TTS / MiMo TTS |
所有供应商通过统一抽象层对接，支持自定义 Base URL 和 API Key。
| 阶段 | 内容 | 状态 |
|---|---|---|
| Phase 1 | 基础骨架 + 项目 CRUD + SQLite + UI 框架 | ✅ 完成 |
| Phase 2 | 剧本编辑器 + AI 供应商配置 + LLM 对接 + 角色资产管理 | ✅ 完成 |
| Phase 3 | 分镜编排 + AI 分镜生成 + 文生图/图生视频 + 任务队列 | ✅ 完成 |
| Phase 4 | 人脸一致性 + TTS 声音克隆 + 对口型 + 审片 Agent | ⏸️ 暂停 |
| Phase 5 | 时间线编辑器 + 自动拼接/转场 + 字幕 + FFmpeg 导出 | ⏸️ 暂停 |
| Phase 6 | 多语言 + 性能优化 + 打包 + 文档教程 | ⏸️ 暂停 |
本项目因个人原因暂时停止维护，不接受 PR。欢迎 fork 后独立开发，衍生项目请遵循 AGPL-3.0 协议。
AGPL-3.0 — 后端、前端、Python sidecar 全部开源，衍生项目必须同样开源。