推荐一个可见的 AI 漫剧工业化生产线 —— 而且越来越不止于漫剧,任何想用生成模型讲的视觉故事都可以在这里做。它有两张面孔,共用一个资产库和一个智能体:
无限画布:节点式创作台,图片、视频、音频、3D 场景、剧本在画布上自由生成、编辑、连线,满意的结果再写回剧集。这是我们自己现在做创作的主战场,也是项目正在全力投入的方向。

剧集流水线:丢进一本原稿或剧本,DramaClaw 接管全部繁重工作:结构化故事、规划剧集、生成剧本、绘制分镜与首帧、合成配音、剪成成片。
内置智能体虾导横跨两边:回答关于项目的问题、推进流水线任务,还能替你在画布上搭建并运行节点图。

它为创作者、独立工作室以及创意工程师而生 —— 在自己的机器上跑完整个「漫剧智造工厂」,不必拼接十几个割裂的工具,也不必把素材交给一个看不见内部的黑盒云服务。虽然以漫剧为核心,同一套画布和流水线同样能产出短视频广告、电商带货视频等其它视觉内容。

其团队已用这条流水线产出了多部商业级短剧,包括《归灵司》《鲁班》《师兄你怎么不舔了》《天命不可欺》(连载至58集)《乌龙仙途》等,以及非遗主题宣传片《㑇舞》。
二、核心功能
两大核心模块 + 一个智能体组成:
1. 无限画布(Infinite Canvas)
一个节点式视觉工作台,自由组合图像、视频、音频、3D 场景和脚本,满意后可"提交"回剧集流水线。包含:

2. 自动化流水线
从剧本文本导入到成片输出,整条流水线分为 Ingest → Plan → Produce → Deliver 四个阶段共 16 步,每步都是独立接口,可顺序跑、跳步跑、从任意检查点恢复:

模块中文昵称功能说明剧本解析虾料上传小说/剧本(支持 Fountain 格式),自动解析章节结构,构建故事图谱(角色关系、时间线、出场频次、情绪曲线);提供改编/直译/分镜稿三种剧本模式资产库虾塘角色、场景、道具、声线四类核心资产统一管理;每个角色有独立肖像、造型变体、专属声线;场景支持正面/背面/360°全景图;解决跨集"身份一致性"问题分镜首帧虾镜按节拍点生成分镜图;线稿先行——先出线稿草图确认构图,再进入精细渲染,大幅降低返工算力成本;支持网格切分和图像池选优配音合成—情绪感知配音,支持多服务商切换(核心为 IndexTTS2),每个角色固定专属音色视频合成与导出—多镜头组装、视频+字幕(SRT)导出、完整资产包导出视觉风格—上传参考图提取风格参数,全项目统一应用任务中心—后台任务状态/进度/日志/取消/重试,支持断点续跑
### 3. AI 智能体
内置的"AI导演"智能体:

三、项目亮点
一个在画布上干活的智能体。 通用节点画布什么都能连,但不知道什么是剧集、角色、镜头;剧集工具懂行,却把你锁在向导里。虾画给你自由画布,节点和技能都懂剧;虾导正在被做成替你铺图、跑图、审图的那个人。

为小说转短剧而生。 通用的工作流工具确实可以把节点拼起来,但它们不知道「剧集节拍」是什么,不懂为什么角色的跨场景身份一致性那么重要,也不会在图像 + 配音 + 剪辑里去守护一整章节的情绪弧。

画布与流水线并行,而不是二选一。 大多数工具要么给你一张自由的节点画布,要么给你一个死板的向导。也可以让两者作为双轨跑在同一个资产库上:在画布上探索,把成立的结果提交进剧集,再把剧集投影回画布。智能体在两边都能干活。

每一步皆可拆解。 每个阶段都是一个独立的异步任务,各有独立接口。你可以顺序跑、跳步跑、中途续跑,这套工具本身就是产品 —— 里面不藏黑箱。
可自托管,模型中立。 你的原稿、你的角色、你的模型、你的服务器。需要最好的效果时用闭源大模型;需要完全可控时切到开放权重模型。
1. 确定性生产,告别"抽卡式"生成
不同于通用 AI 工具"给描述→随机出图"的抽卡模式,DramaClaw 采用资产先行策略——先建资产库锁定角色/场景/道具/声线的身份锚点,再做内容生产,确保第1集和第100集的角色、场景高度一致。

2. 导演世界(3GS)—— 建立空间坐标系
给核心场景构建虚拟三维片场,锁定空间结构、人物站位和镜头机位,像真实影视拍摄一样控制机位和走位,从根源上解决镜头切换时的穿帮问题(光线翻转、人物位置错乱、道具变形等)。

3. 线稿先行,降本增效
不直接生成高清图,先出线稿草图确认构图、角色位置、镜头意图,确认无误后再渲染。把返工成本卡在最便宜的阶段——构图错了改线稿只需几秒,渲染错了重跑则是真金白银。官方宣称将高品质漫剧制作成本压缩至约 20 元/分钟,一部漫剧总成本仅几百元。

4. 双轨并行:流水线 + 无限画布

5. 自托管、模型中立
四、项目目录结构
dramaclaw/
├── .hermes/ Hermes Agent 插件与技能
├── LICENSES/ 许可证文件(Elastic-2.0、Apache-2.0)
├── assets/ 项目图片资源、架构图、合作伙伴logo
├── deploy/ 部署配置(沙箱环境)
├── docs/ 文档(英文/中文/越南语/泰语)
│ ├── en/ 英文文档(快速开始、配置、架构、指南)
│ ├── zh/ 中文文档
│ └── changes/ 版本变更记录
├── examples/ 示例代码(如 Seedance2 快速Demo)
├── frontend/ 前端项目(React + Vite + TypeScript)
│ ├── src/ 前端源码
│ ├── public/ 静态资源
│ ├── docker/ 前端 Docker / Nginx 配置
│ ├── package.json 前端依赖
│ └── vite.config.ts Vite 构建配置
├── readme/ 多语言 README(中文/越南语/泰语)
├── scripts/ 工具脚本(构建、检查、迁移、合规等)
├── src/
│ └── novelvideo/ 🐍 后端核心源码(Python包)
│ ├── agents/ AI Agent 模块(角色规划、剧本写作、提示词构建等)
│ ├── api/ FastAPI 接口层(路由、认证、WebSocket、Schema)
│ │ └── routes/ API 路由
│ ├── audio/ 音频处理(IndexTTS2 配音任务)
│ ├── backup/ 数据备份与恢复
│ ├── chat/ 虾导聊天服务(Hermes集成、MCP、WebSocket)
│ ├── cognee/ 知识图谱(小说解析、章节检测、实体抽取)
│ ├── director_world/ 导演世界(3D高斯泼溅、全景图、空间编排)
│ ├── export/ 成片导出(剧集组装)
│ ├── freezone/ 虾画无限画布(节点管理、图片/视频/音频/文本节点)
│ ├── generators/ 生成器(图片、视频、TTS、网格切分、视频合成)
│ ├── ports/ 端口/适配器层(认证、任务、投影、生命周期)
│ ├── prompts/ 提示词模板
│ ├── render_plan/ 渲染计划
│ ├── security/ 安全(操作认证、沙箱包装)
│ ├── seedance2_i2v/ Seedance 2.0 图生视频集成
│ ├── services/ 业务服务(角色/道具提升、风格服务、占位符等)
│ ├── shared/ 共享工具(计费错误、环境守卫、节点身份等)
│ ├── skills/ 画布技能(导演技能、场景目录)
│ ├── storage/ 存储层(媒体中继)
│ ├── styles/ 风格预设
│ ├── task_backend/ 任务后端(队列、生产者/消费者、运行器、签名)
│ ├── utils/ 工具函数(媒体IO、日志、缩略图、路径解析等)
│ ├── verification/ 验证层(帧校验、草图评分、连续性验证、一致性守门)
│ └── workflows/ 工作流(剧本写作)
├── tests/ 测试用例(覆盖API、服务、合约、合规等大量测试)
├── docker-compose.yml Docker Compose 源码构建配置
├── docker-compose.release.yml Docker Compose 镜像部署配置(推荐快速启动)
├── Dockerfile 后端 Docker 构建文件
├── pyproject.toml Python 项目配置(依赖管理,uv)
├── uv.lock uv 依赖锁定文件
├── .env.example 环境变量示例
├── DESIGN.md 设计文档
└── README.md 项目主说明
五、技术栈
后端
类别技术语言Python 3.11–3.12包管理uv(Astral 高性能 Python 包管理器)Web 框架FastAPI(REST API)+ Gunicorn(WSGI 服务器)数据库SQLite(本地文件,无需 Postgres/MySQL)任务队列进程内 inline 执行(无需 Redis/Celery/Ray),自带任务信封签名机制AI 模型网关dramaclaw-gateway(基于 New API fork,Go 语言,支持 OpenAI/Claude/Gemini 兼容格式转换)视频处理FFmpeg(视频合成、编码、字幕)3D/空间Gaussian Splatting(3DGS)、PanoSharp、360°全景、PlayCanvas音频IndexTTS2(语音合成)视频模型Seedance 1.0/1.5/2.0/2.5 系列、Hailuo、Kling、Sora 等(通过网关接入)图像模型LingShan-G2、LingShan-NB-2(自研灵山大模型)、gpt-image 等协议集成MCP(Model Context Protocol)对外开放
前端
类别技术框架React 19 + TypeScript 5.8构建工具Vite 6 + pnpm 11UI 组件Radix UI、Base UI、shadcn/ui样式Tailwind CSS 4、class-variance-authority、tailwind-merge、Geist/Inter 字体状态管理Zustand 5路由TanStack Router数据请求TanStack React Query 5、ky(HTTP 客户端)节点画布@xyflow/react(React Flow,无限画布核心)2D 图形Konva.js + react-konva(线稿编辑器)3D 图形PlayCanvas、Photo Sphere Viewer(360°全景)、OGL(轻量WebGL)动画Framer Motion、GSAP、Lenis(平滑滚动)、border-beam视频/音频处理FFmpeg.wasm(浏览器端 FFmpeg)、lamejs、mediabunny表单React Hook Form + zod(校验)国际化i18next + react-i18nextMarkdownreact-markdown + remark-gfm测试Vitest + Testing Library + MSW + jsdomWeb 服务器(生产)Nginx(反向代理 /api 和静态资源)
部署与基础设施
六、本地快速部署启动
有两种部署方式,推荐使用 Docker 镜像方式,最快 5 分钟可跑起来。
环境要求
项目最低要求CPU/内存≥ 2 vCPU / 4 GB(模型推理在云端,本地不跑模型)GPU不需要(标准流水线全程免显卡;可选的 3DGS 世界特性需要 GPU+CUDA)磁盘几 GB(镜像 + 生成媒体文件)系统macOS / Windows(Docker Desktop + WSL2)/ LinuxDockerDocker + docker compose 插件网络能访问外网(连接模型网关)端口8080(网页UI)、8780(REST API)、3000(网关管理后台,默认仅本机)
方式一:Docker 镜像部署(最快,推荐新手)
无需克隆源码,直接拉取官方发布镜像:
1. 创建工作目录**mkdir dramaclaw && cd dramaclaw
2. 下载 docker-compose.release.yml 和 .env.example
curl -sSL https://raw.githubusercontent.com/dramaclaw/dramaclaw/main/docker-compose.release.yml -o docker-compose.yml
curl -sSL https://raw.githubusercontent.com/dramaclaw/dramaclaw/main/.env.example -o .env
3. 修改配置(至少修改 PROMPT_EXPORT_PASSWORD 为非默认值)
用编辑器打开 .env,找到 PROMPT_EXPORT_PASSWORD=change_me 改成你自己的密码
sed -i 's/PROMPT_EXPORT_PASSWORD=change_me/PROMPT_EXPORT_PASSWORD=your_password_here/' .env
4. 国内用户(可选):如果拉取 Docker Hub 慢,在 .env 中添加以下三行使用阿里云镜像:
DRAMACLAW_IMAGE_PREFIX=claymore-registry.cn-chengdu.cr.aliyuncs.com/dramaclaw
DRAMACLAW_VERSION=2.0.4
DRAMACLAW_GATEWAY_VERSION=v1.0.0-rc.24-dramaclaw.2
5. 启动服务(首次会拉取镜像,约几分钟)
docker compose up -d
6. 查看运行状态(三个服务 api/newapi/web 均为 running 即成功)
docker compose ps
启动成功后:
- 打开 http://localhost:8080 进入应用界面
- REST API 地址:http://localhost:8780
方式二:源码构建部署(适合开发者/二次开发)
1. 克隆主仓库和网关仓库(需并排克隆)
git clone clone dramaclaw
2. 准备配置文件
cp .env.example .env
编辑 .env,至少修改 PROMPT_EXPORT_PASSWORD 为非默认值
3. 构建并启动所有服务
docker compose up -d --build
仅重新构建后端/前端
docker compose up -d --build api web
仅重新构建网关
docker compose up -d --build newapi
方式三:本地开发模式(uv + Python,无需 Docker)
1. 克隆代码
git clone
cd dramaclaw
2. 创建虚拟环境并安装依赖(需先安装 uv: https://docs.astral.sh/uv/)
uv sync
3. 配置环境变量
cp .env.example .env
编辑 .env,修改 PROMPT_EXPORT_PASSWORD
4. 启动后端 API(任务默认进程内执行,无需 Redis/Celery)
uv run novelvideo api --port 8780
5. 新开终端,启动前端开发服务器
cd frontend
pnpm install
pnpm dev
6. (可选)启动内置模型网关,使用 Docker 运行:
mkdir -p state/newapi
docker run -d --name dramaclaw-gateway -p 127.0.0.1:3000:3000 \
-v "$PWD/state/newapi:/data" \
claymorelab/dramaclaw-gateway:v1.0.0-rc.24-dramaclaw.2
开发模式下,前端通常在 http://localhost:5173(Vite 默认端口),后端在 http://localhost:8780。
启动后配置模型
首次打开 http://localhost:8080,进入 设置 → 模型配置,三选一:
- 官方模式(推荐):粘贴你的 DC Key(在 https://relayclaw.cdnfg.com 获取),开箱即用,无需配置模型映射
- 自定义模式:一键初始化内置的 dramaclaw-gateway 网关,然后在网关管理后台添加你自己的模型渠道(API Key、模型ID),支持 ComfyUI、MiniMax/海螺、火山引擎/豆包/Seedance、fal.ai、阿里/可灵/即梦、Vertex AI/Gemini、OpenAI/Sora、Suno 等
- 本地+官方混合模式:主流程用官方渠道,额外渠道通过内置网关接入
常用运维命令
查看日志
docker compose logs -f api 查看后端日志
docker compose logs -f web 查看前端日志
docker compose logs -f newapi 查看网关日志
停止服务
docker compose down
停止并删除数据卷(⚠️ 会清空所有项目数据)
docker compose down -v
更新到最新版本(镜像模式)
docker compose pull
docker compose up -d