夜雨聆风
Jellyfish（AI短剧工厂）开源项目完整介绍
Jellyfish 是 Forget‑C 开发的一站式 AI 竖屏/微短剧工业化生产工具，核心解决 AI 视频生成中角色/场景漂移，打通从剧本到成片的全流程闭环，开源免费、可本地部署。
一、项目基础信息
仓库：https://github.com/Forget‑C/Jellyfish 协议：Apache‑2.0（可商用、可二次开发） 状态：活跃开发，核心流程已跑通 定位：AI Short Drama Studio，短剧工业化流水线 核心价值：极致一致性 + 全流程可视化 + 资产复用
二、核心定位与解决痛点
解决 AI 短剧最大痛点：人物变脸、场景突变、风格不统一 把零散 AI 工具整合成一条流水线，不用在多平台切换 降低门槛：个人/小团队低成本批量出专业竖屏短剧
三、完整生产流程（端到端闭环）
剧本输入 → 智能精简 → 智能分镜提取 角色/场景/道具一致性管理（全局种子+统一风格） AI 视频批量生成（对接主流视频模型） 可视化分镜编辑 + 镜头语言精细控制 多轨后期剪辑（视频/音频/字幕/音效） 一键导出成片（适配抖音/快手/Reels）
四、核心功能模块
1. 项目管理
全局种子、统一风格、防漂移强制继承 项目仪表盘、章节统计、多项目管理
2. 章节拍摄工作台
三栏式布局：剧本大纲 → 分镜编辑 → 属性面板 批量操作、实时预览、分镜多版本管理
3. 分镜精细控制
景别、角度、运镜、情绪、时长、氛围、对白 首尾关键帧独立提示词、隐藏分镜、镜头节奏控制
4. 高级生成控制
参考图跨分镜复用 ControlNet 骨骼/深度、智能对口型 多模型切换、时长自定义
5. 资产管理（核心亮点）
双层库：项目资产库 + 全局资产库 角色/场景/道具/服装/提示词模板全生命周期管理 智能提取+手动关联，确保全程一致不漂移
6. 提示词模板库
分镜/角色/场景/视频/配乐/音效模板 一键初始化新章节，大幅提效
7. 视频后期剪辑
时间线编辑、多轨音视频 素材拖拽、转场/配乐/音效、直接导出成片
8. Agent 工作流
剧情提取、角色提取、分镜建议 节点式可视化编排，类似 Dify 工作流
9. 模型管理
支持 OpenAI/Claude/通义/混元 等文本大模型 对接 Midjourney、Runway、Kling、Luma 等图/视频模型 分类管理、快速测试、设默认模型
五、技术栈
前端：React 18 + TypeScript + Vite + Ant Design/Tailwind 状态：Redux Toolkit / Zustand 工作流：React Flow 后端：FastAPI / Node.js / NestJS / Spring Boot 存储：MySQL + RustFS（S3 兼容） AI 层：对接多厂商大模型 API
六、部署与启动
Docker 一键启动（推荐）
cp deploy/compose/.env.example deploy/compose/.envdocker compose --env-file deploy/compose/.env -f deploy/compose/docker-compose.yml up --build前端：http://localhost:7788 后端：http://localhost:8000（Swagger 文档 /docs）
开发环境（前后端分离）
后端：cd backend → uv sync → uv run uvicorn app.main:app --reload 前端：cd front → pnpm install → pnpm dev
七、适用人群
短剧/微短剧创作者、MCN/影视工作室批量生产 个人低成本试水竖屏短剧 教育/培训机构做教学短视频 品牌/电商做剧情类产品宣传片
八、开发规范
Git 提交格式： [类型] 摘要，类型仅限 feat/fix/docs/style/refactor 等已配置 Git Hooks 强制校验，保证提交规范 PR 会自动校验提交信息格式
九、当前进度
✅ 已完成：项目管理、模型管理、工作台基础交互、全局一致性控制 🚧 进行中：完整分镜编辑、视频生成、高级提示词模板、批量渲染
十、亮点总结
防漂移：全局种子+统一风格+资产复用，解决 AI 视频最大痛点 全流程：剧本→分镜→生成→剪辑→导出，一站式闭环 可视化：所见即所得，非技术人员也能上手 开源免费：可本地部署、无订阅费、可商用 工业化：适合个人到工作室批量生产短剧
GitHub：https://github.com/Forget-C/Jellyfish
