deep-printfilm
AI漫剧创作平台:输入故事想法,自动生成剧本、分镜、角色图和AI视频片段
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
AI漫剧创作平台:输入故事想法,自动生成剧本、分镜、角色图和AI视频片段
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象一下:你脑海里有一个关于都市爱情或玄幻穿越的短剧故事,但既不会写分镜脚本,也不会用AE/PR,更请不起演员和摄影团队。以前,这只能是一个永远停留在脑海里的幻想。而现在,AI 漫剧工场(Print Film) 告诉你:只需一个故事想法,加上一个 API Key,你就能把文字变成可预览的分镜画面、角色设定图,甚至 AI 生成的视频片段。
短剧赛道在2024—2026年持续爆发,抖音、快手、视频号上充斥着各种"霸总甜宠""战神归来"的短剧内容。这类内容有个共同特点:高度模板化、量产需求强、技术门槛相对低——恰好是 AI 生成内容的最佳应用场景。
AI 漫剧工场的开发者 yuanzhongqiao(GitHub ID: 35392196)瞄准了这个赛道,将整个短剧制作流程拆解成四个 AI 协作阶段,从剧本到成片一气呵成。项目在 GitHub 上获得 1816 颗星、273 个 Fork,印证了社区对 AI + 短剧这个方向的强烈兴趣。商业化方面,开发者也提供了 Windows 桌面客户端和 www.printfilm.com 在线站点,尝试将开源项目转化为可持续运营的产品。
项目采用 TypeScript + React 19 + Vite 6 的现代前端技术栈,通过 Electron 提供跨平台桌面客户端(Windows/macOS),部署侧使用 Nginx + 多阶段 Dockerfile。以下从几个关键维度拆解其架构设计。
项目的核心设计亮点在于 services/adapters/ 目录下的适配器模式。三个核心文件分工明确:
chatAdapter.ts:统一封装 Chat 模型调用(对话、JSON 结构化输出),内置重试机制(maxRetries=3),自动处理 400/401/403 等错误码,对非致命错误执行指数退避重试。imageAdapter.ts:封装图片生成模型,同时支持 /v1/images/generations 和 /v1/chat/completions 两种调用路径,通过 shouldUseImagesGenerationsEndpoint() 判断使用哪种方式,支持参考图(referenceImages)传入。videoAdapter.ts:封装视频生成模型,特别处理了 Sora API 的异步任务机制(resolveSoraVideoDownloadId),支持视频下载进度跟踪。这种适配层设计让项目可以随时切换不同的模型提供商——不绑定任何单一 AI 服务商,用户只需在配置界面填入不同平台的 API Key 即可自由切换。这在 AI API 市场快速变化、各家价格和可用性不稳定的当下,尤为重要。
项目将整个创作流程组织为四步流水线,每个阶段对应一个 React 组件:
| 阶段 | 组件 | 核心功能 |
|---|---|---|
| Phase 01 | StageScript | 剧本与分镜创作:输入故事想法,AI 生成脚本结构化数据和分镜列表 |
| Phase 02 | StageAssets | 角色与场景资产生成:生成角色设计表、服装变体图、场景图 |
| Phase 03 | StageDirector | AI 工作台:逐帧生成关键帧和视频片段 |
| Phase 04 | StageExport | 成片导出:统一预览和下载关键帧、视频和项目资产 |
这种流水线设计的巧妙之处在于模块化——每个阶段的输出可以单独使用,不必强制走完整个流程。只想生成角色设计图?直接跳 Phase 02。想用已有素材做视频?Phase 03 接受外部导入。
项目使用浏览器 IndexedDB(通过 storageService.ts)实现本地项目持久化,所有创作数据保留在用户本地,不上传云端。API Key 也存储在 localStorage,不经过服务端中转。这种设计对创作者隐私保护有重要意义——剧本和创意资产属于创作者的核心竞争力,数据本地化是合理的需求。
答案是:三分钟以内。
项目提供两条完整部署路径:
git clone https://github.com/yuanzhongqiao/deep-printfilm
cd deep-printfilm
docker-compose up -d --build
Dockerfile 采用多阶段构建:第一阶段用 node:20-alpine 安装依赖并执行 npm run build(Vite 打包),第二阶段用 nginx:alpine 托管静态文件并配置反向代理。docker-compose 默认暴露端口 3005,可直接通过 http://localhost:3005 访问。
开发者提供了预编译的 Windows 安装包(AI 漫剧工场 Setup 0.2.0.exe),通过百度网盘分享。无需 GPU,内存仅需 4GB,磁盘 2GB。

图1:模型配置界面 — 支持切换不同 AI 模型服务商

图2:Phase 01 剧本创作 — 输入故事想法,AI 生成结构化脚本

图3:Phase 03 导演工作台 — 逐帧控制关键帧生成
1. API Key 依赖是双刃剑。 项目本身免费开源,但使用需要自备 API Key(GitCC 平台)。GitCC 并非主流大厂 API,文档和稳定性不如 OpenAI 等平台成熟。用户需要额外成本和配置工作。
2. 视频生成质量依赖底层模型。 当前 AI 视频生成在人物动作一致性、场景稳定性上仍有明显局限,最终成片质量不能期望过高。
3. 仅限短剧/漫剧场景。 项目的 UI 交互和 Prompt 工程针对短剧场景高度定制,迁移到其他视频创作场景的适配成本较高。
4. 缺乏团队协作功能。 目前所有数据本地存储,无云端同步和团队协作支持。
AI 漫剧工场的出现,折射出一个更大的趋势:AI 视频生成的民主化正在从"玩具级"向"生产级"演进。当工具把技术门槛降低到"会打字就能用",短剧赛道的创作供给将迎来爆发式增长。
从技术演进角度看,项目采用的"分镜控制 + 视频生成"两阶段方案(先生成关键帧,再生成视频)是一个实用的工程折中——完全依赖 AI 一次性生成高质量视频仍然困难,但通过分镜逐段控制生成过程,可以显著提高成品的可控性。这一思路与 Runway Gen-3、Luma Dream Machine 等产品的关键帧控制功能方向一致。
对于 AI 开发者而言,这个项目提供了一个完整的 TypeScript AI 应用工程范例:多模型适配层设计、React 状态管理、IndexedDB 本地持久化、Docker 容器化部署,全链路覆盖,有较高的参考价值。
git clone https://github.com/yuanzhongqiao/deep-printfilmdocker-compose up -d --buildhttp://localhost:3005
图4:Phase 02 场景生成 — AI 生成的角色设计图和场景图

图5:剧本创作 — AI 生成结构化分镜脚本

图6:项目管理 — IndexedDB 本地存储,保护创作隐私

图7:提示词管理 — 集中编辑和复用 AI 生成 Prompt