开源项目解析
BigBanana AI Director
一站式 AI 短剧 / 漫剧工作台,四阶段:剧本 → 视觉资产 → 分镜制作 → 导出。
明确反对「抽卡」带世界观锚点已宣布不再同步源码
许可证附加条件:不可商用;且 README 明说后续只发 Docker 镜像、不再同步源码
读懂层
2 张 · 架构图 / 流程图
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
四个 Stage 组件串成流程(StageScript / StageAssets / StageDirector / StageExport),项目状态在 App 根组件,1 秒防抖自动存进 IndexedDB。模型分 chat / image / video 三类可各自配。
它管哪几个决定
自持能力
权重在不在本地只能调接口
种子能不能填不可填
换掉它要动几处几处
画面全在云端;chat / image / video 三类模型可分别配
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1拉官方 Docker 镜像别去编译源码 —— README 明说部署与升级以官方镜像为准
- 2配三类模型chat / image / video 分开配,可以混不同供应商
- 3按四个 Stage 往下走剧本 → 资产 → 分镜 → 导出。资产要先补齐,它整套设计都建立在这一步上
改哪个文件能改什么
docker-compose.yaml**这是仓库现在的主角** —— 部署入口src/Stage*.tsx四个阶段各一个组件(历史参考版本)src/storageServiceIndexedDB 存取。数据在浏览器里坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
想看新版源码没有了。README:「后续功能更新将只通过官方 Docker 镜像提供,不再同步公开源码」
数据安全项目数据主要保存在本地浏览器环境中 —— 清缓存或换机器就没了
生成图片失败issue #25:做角色和场景时生成图片失败(已关闭)
许可证CC BY-NC-SA 4.0 禁止商业使用;商业版另有源码交付,但那是另一条路
教程
没找到官方口径的教程 —— 官方只给了 README。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
BigBanana(大香蕉)AI Director — AI 漫剧工场 > AI 一站式短剧/漫剧生成平台 · 工业化工作流 > *Industrial AI Motion Comic & Video Workbench* 新手课程:First Class · AI 短剧第一课 第一次做 AI 短剧/漫剧,不知道从哪里开始? 可以购买配套课程 《First Class:AI 短剧第一课》,系统学习创作方法,再结合 BigBanana 工作台动手实践。 查看课程介绍并购买 → TL;DR(30 秒了解本项目) | 问题 | 答案 | | BigBanana 是什么? | 一款 AI 漫剧/短剧工业化生产工作台,别名「大香蕉 AI Director」。覆盖剧本、角色、分镜、关键帧、视频、配音、成片导出的完整链路。 | | 和「一句话生成」工具有什么不同? | 它反对「抽卡式」生成,采用 Script-to-Asset-to-Keyframe 工作流:先把角色和场景资产锁死,再用首尾关键帧控制镜头,而不是靠提示词碰运气。 | | 最适合谁? | 需要角色长期一致的连载创作者、网文 IP 改编团队、有剧本意识且愿意做轻量微调的内容工作室。 | | 不适合谁? | 只想点一次按钮就出爆款、完全不愿做分镜或台词微调的用户。这是工业化生产工具,不是一键生成玩具。 | | 免费吗? | 软件本身免费(Docker 镜像 / 客户端 / 在线版均无授权费)。AI 模型调用按实际用量付费,通过 API Key 自行配置。 | | 能用在哪里? | 在线版(浏览器直接开)、Docker 自托管、Windows / macOS 桌面客户端,共三种方式。 | | 数据存在哪? | 主要保存在本地浏览器环境(IndexedDB),不上传服务器,角色 IP 与创意留在创作者手里。 | 什么是 BigBanana AI Director BigBanana AI Director(中文名:大香蕉 AI 漫剧工场) 是一个 AI 一站式短剧/漫剧生成平台,面向创作者,实现从灵感到成片的高效生产。 它摒弃了传统的「抽卡式」生成,采用 "Script-to-Asset-to-Keyframe" 的工业化工作流:通过深度集成 AntSK API 的先进 AI 模型,实现 「一句话生成完整短剧,从剧本到成片全自动化」,同时精准控制角色一致性、场景连续性与镜头运动。 一句话理解它解决的核心问题 AI 漫剧最致命的痛点不是画质、不是配音,而是角色一致性——换个镜头就变脸,观众瞬间出戏。BigBanana 正是冲着这个问题设计的:先有演员和片场,再开机。 它和其他 AI 漫剧工具的区别 | 对比维度 | 常见 AI 工具(可灵 / 即梦等生成类) | BigBanana AI Director | | 定位 | 图像/视频生成核心,单图或单段产出 | 工业化全链路生产工作台 | | 角色稳定性 | 多次生成容易变脸换人 | 定妆照 + 衣橱系统 + 上下文感知,三重约束锁定形象 | | 工作方式 | 偏单张图/单段视频生成 | 剧本 → 资产 → 关键帧 → 成片一体化流程 | | 视频控制 | 主要依赖文字描述,结果不稳定 | 首尾关键帧明确起止画面,中间由模型插值 | | 场景延续性 | 难以保证连续性 | 场景概念图统一光影与风格,资产跨集复用 | | 输出定位 | 更偏社交内容快速分享 | 可衔接 Premiere / Resolve 等专业后期流程 | | 数据处理 | 常依赖云端上传 | 浏览器本地存储,隐私更稳 | | 自动化程度 | 高(但可控性低) | 中高(需手动微调,可控性最高) | > 一句话总结:BigBanana 不是最自动化的 AI 漫剧工具,但它是目前最可控的方案之一。 版本发布说明 由于近期出现大量抄袭、搬运不署名,且个别情况较为恶劣,后续版本将仅通过官方 Docker 镜像发布,不再继续公开同步源码。 当前仓库保留为公开说明与历史参考版本,实际部署、更新与运行请以 docker-compose.yaml 和官方镜像为准。 我们仍然针对商业版用户提供完整源码交付。 界面展示 项目管理 项目概览与小说导入 世界观构建 Phase 01: 叙事规划 Phase 02: 一致性资产 Phase 03: 镜头制作 Phase 04: 成片交付 提示词管理 核心理念:关键帧驱动 (Keyframe-Driven) 传统的 Text-to-Video 往往难以控制具体的运镜和起止画面。BigBanana 引入了动画制作中的 关键帧 (Keyframe) 概念: 1. 先画后动:先生成精准的起始帧 (Start) 和结束帧 (End)。 2. 插值生成:利用 Veo 模型在两帧之间生成平滑的视频过渡。 3. 资产约束:所有画面生成均受到「角色定妆照」和「场景概念图」的强约束,杜绝人物变形。 角色一致性的三重保障 这是 BigBanana 的核心竞争力,也是 AI 漫剧能否连载的关键: | 机制 | 作用 | | 第一重:定妆照系统 | 为每个角色生成标准参考图,作为全片视觉锚点,所有镜头生成都参考这张「脸」。 | | 第二重:衣橱系统 | 同一角色可配置多套造型(日常装、战斗装、受伤状态),所有变体基于 Base Look 生成,保持面部特征不变。换衣服不换人。 | | 第三重:上下文感知生成 | 生成镜头时自动读取当前场景图、角色当前服装参考和道具参考。不是每个镜头从零开始,而是「知道」前面的剧情。 | 核心功能模块 项目级工作流 (Project Workspace) * 项目中心 (Project Hub):集中管理最近项目、账号入口、模型配置、全局资产库,以及整库数据导入导出。 * 项目概览 (Project Overview):按「项目 → 季 → 集」组织内容,支持整篇小说导入并自动拆分多集草稿,也支持整项目备份导出。 * 项目资源与世界观 (Project Resources & Worldview):在单集制作前先沉淀角色 / 场景 / 道具资源,以及地图、区域、地点、音乐风格等世界观锚点,这些信息会持续注入后续剧情、资产和镜头生成。 Phase 01: 叙事规划 (Narrative Planning) * 结构化剧本生成:输入故事大纲、小说片段或单集创意,AI 自动拆解出角色、场景、道具、镜头等结构化结果。 * 配置驱动生成:可设置语言、目标时长、视觉风格和模型组合,统一控制后续全链路输出。 * AI 续写与手动精修:支持对剧本正文、角色视觉描述、镜头动作、台词和提示词进行续写、改写与逐项手动编辑。 * 全自动计划预审:在正式批量生成前,系统会先给出全自动生产方案,允许你逐镜头决定使用「九宫格分镜」还是「首尾帧」链路。 Phase 02: 一致性资产 (Consistency Assets) * 角色一致性定妆:为每个角色生成标准参考图,并通过衣橱系统维护多套造型的一致身份。 * 场景 / 道具资产化:不仅生成核心场景图,也能为可复用道具建立独立提示词、参考图和形体参考。 * 资产库复用:支持从项目资源或跨项目资产库选择角色、场景、道具,减少重复搭建。 * 批量补齐缺失资产:可一键补齐角色、场景、道具的缺失图片,为后续镜头制作准备稳定上下文。 Phase 03: 镜头制作 (Shot Workbench) * 网格化镜头工作台:全景式管理所有镜头,逐镜头查看叙事动作、角色、场景和道具上下文。 * 关键帧精控 ……(后略,见原文)
判断
优势
- 「不抽卡」这条路线是明写的:资产先行 + 关键帧控制,而不是重摇到满意
- 带世界观锚点(地图、区域、地点、音乐风格),长剧集之间能接得上
- 可一键补齐缺失的角色 / 场景 / 道具图
- 视频模型支持面广(自述 Sora-2、Veo-3.1、Vidu、Seedance 2.0 等)
局限
- CC BY-NC-SA 4.0,不可商用
- 后续版本只通过官方 Docker 镜像发布,不再同步公开源码 —— README 原话,理由是「出现大量抄袭、搬运不署名」。当前仓库「保留为公开说明与历史参考版本」
- 数据存在浏览器 IndexedDB,换机器就没了,适合个人轻量用
- issue #1「代码和界面看起来很眼熟呀」 —— 出处问题被公开问过(已关闭)
不适用
想长期跟着源码走的人 —— 它已经宣布不再同步源码了,你读到的是历史版本。
同管这些决定的其它项目
ComfyUI节点式工作流底座。图像 / 视频 / 音频 / 3D / 文本共用一个底座。…Wan2.2文生 / 图生 / 语音驱动 / 角色动画替换,480P–720P。五个变体。…HunyuanVideo腾讯的开源视频生成模型,文生视频与图生视频。720×1280、129 帧。…FramePack把 13B 视频模型压进 6GB 显存的桌面程序。图生视频,一分钟长度、30 帧。…LTX-VideoLightricks 的视频生成模型,主打快。文生 / 图生 / 视频续写,默认 1…MiniMax H3全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz…ControlNet给扩散模型加条件控制。九种结构信号:Canny 边缘、直线、HED 边界、涂鸦、人体…IP-Adapter用图片当提示词,锁住风格或人物。仅 22M 参数。…InstantID一张脸照做身份保持生成,零样本、免调优。…Real-ESRGAN通用图像 / 视频超分修复,支持 2× / 3× / 4×,含动漫专用与轻量模型。…Practical-RIFE视频插帧:在两帧之间算出中间帧,把 24 帧的片子补成 48、60 帧。作者是 RI…CodeFormer人脸修复:把糊掉、压坏、老照片里的脸修回来。图片与视频都能做。…kohya sd-scripts训练脚本集:覆盖 SD1.x/2.x、SDXL、SD3/3.5、FLUX.1;202…musubi-tuner视频模型的 LoRA 训练器。同一套代码训 Wan 2.1/2.2、HunyuanV…Ollama一条命令在本机跑开源大模型。写脚本、翻译这两段靠它才不出本机。…DiffSynth-Studio魔搭扩散模型工程框架,覆盖图像、视频、音乐推理与训练;近期加入 FLUX.3、MOS…MoneyPrinterTurbo给个主题或关键词,一键出高清短视频,含字幕与配音。…NarratoAI用大模型一键解说并剪辑现成视频。…火宝短剧基于 AI 的一站式短剧生成平台,从剧本到成片全自动化。…ToonflowAI 创作平台:无限画布、AI Agent、可视化工作流,支持图像、视频、分镜和短剧…infinite-canvas面向 AI 创作的无限画布工作台:生图、参考图编辑、视频生成、Agent 助手、画布…open-ai-canvas面向 AI 影视创作的无限画布:多模态生成、分镜编排、素材管理、Agent 工作流。…VOZEB PRO把统一创作 Agent、画布、短剧生产线、素材库和商业运营后台放进同一套 Next.…OpenMontage让 Agent 编排视频生产:通过声明式流水线组织素材、生成、字幕、音频与合成。…video-shotcraft为 Claude Code / Codex 提供产品宣传片镜头配方,以网页截图与文案…Generative Media Skills给 Agent(Claude Code / Cursor / Gemini CLI)…乘风视频剪辑 Skills用 Claude Code Skills 做的视频剪辑 Agent。中文侧最成型的一…OpenChatCut对话式视频剪辑器,本地优先。你说「第二条音轨第 8 秒加个故障转场」,它就去改那一刀…video-podcast-maker给编码 Agent 用的 skill:给一个主题,出一条 4K 带解说的讲解片。11…motion-skills动效技能索引:55 个技能分成 18 个安装包,覆盖短视频、数据动画、网页动效、3D…ComfyUI-ManagerComfyUI 的节点管理器:装节点、装模型、修依赖、查注册表。ComfyUI 生态…ComfyUI-WanVideoWrapper把 Wan 系列模型接进 ComfyUI 的节点包。社区里跑 Wan 的事实标准封装…ComfyUI 官方工作流模板ComfyUI 内置的那批官方工作流模板与子图蓝图的真身仓库。…waoowaoo把一部小说灌进去,自动拆角色、拆场景、出分镜,再合成整集短剧。中英双界面。…JellyfishAI 短剧的端到端工作台:从剧本进,到分镜、角色一致性管理、出片、导出。…魔因漫创桌面端 AI 影视工具(Electron):剧本 → 角色 → 场景 → 导演 → …ClipForge带货短视频专用的一站式工具:上传商品图,自动提炼卖点、写种草脚本、配音配字幕加背景乐…短视频工厂跨平台桌面应用:给提示词文本加分镜素材,自动剪出产品营销或泛内容短视频。集成文案生成…AI YouTube Shorts Generator把一条长视频切成一批排好序的竖屏短片:用语言模型找高光片段、用 Whisper 转写…Open AI UGC生成 UGC 风格的口播广告:用多个视频模型出真人感的 AI 演员念你的脚本。定位是…ViGenAiR把一条已有的视频广告用生成式 AI 重新剪成适配不同版位与时长的多条。…LiveTalking实时交互流式数字人引擎,音视频同步对话。支持 ernerf、musetalk、wav…Seedance 2.0 Prompt Skills给 Agent 装的 Seedance 2.0 提示词技能:讲输入约束、@ 引用语法…Drama Skills面向编剧与漫剧工作室的短剧创作流水线:十个技能把一个点子或一部长篇材料,一路做成分集…Seedance2 Storyboard Generator开源剧情剧本技能:把故事拆成分镜,并整合成 Seedance 2.0 认的结构化提示…AI Shortfilm Prompts一个 Claude Code 技能:把任意一个想法变成电影语言的、模型直接能用的视频…Awesome Seedance 2 Prompts整理好的 Seedance 2.0 视频提示词库,README 自述逾六千条,覆盖电…歸藏的提示词库中文 AI 圈里流传最广的个人提示词仓库之一,存放作者为各家模型撰写的提示词。…MidJourney 风格与关键词参考一份带示例图的风格与关键词对照表:同一个提示词加不同风格词,画面变成什么样,逐个列出…AI Visual Prompt Cookbook171 套结构化提示词风格、342 张预览;JSON 模板支持 v2.1 / v2.…PromptLensAI 视频提示词分析工具:丢进一条别人的视频,反推出它的提示词与创作脚本,并做画面分…Prompt Engineering Guide提示词工程的系统性指南:教程、论文、课程笔记与可运行的示例。不针对视频,讲的是提示词…蓝书 AI 视频工具包AI 视频提示词、技能与方法论工具包。2026-10-10 README 自述:60…
github README 原文 + GitHub API + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。