DramaClaw - 工业化短剧生产线
从剧本到成片的一条龙 AIGC 视频引擎，让普通创作者也能拥有大厂级的工业化短剧生产流水线。
- Star 数
- ★ 6.3k
- 最近更新
- 3 天前
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 0/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 独立小说创作者：将长篇网络小说批量转化为多集短剧视频，无需手动拆解章节或绘制分镜。
- 不适合
- 不愿使用官方 DC 密钥或自备 OpenAI 兼容端点的用户
- 计划把软件作为托管服务转售的团队：Elastic 2.0 禁止
这个 Agent 能做什么，适合哪些场景？
DramaClaw 是一个源码可用的工业化短剧生产线，输入小说稿件后自动完成角色提取、分集规划、剧本生成、分镜与首帧绘制、配音合成与最终剪辑。它面向创作者、独立工作室和创意工程师，支持自托管部署，将整个短剧工厂运行在自己的基础设施上。核心能力包括小说解析与故事图谱、资产库与形象一致性、分集规划、多模式剧本生成、线稿分镜系统、情感感知配音、视频合成导出，以及 X 导演智能体等。所有推理通过远程 OpenAI 兼容网关完成，本地无需 GPU，轻量部署。
DramaClaw 读取用户输入的小说稿件，构建可查询的字符、关系和时间线图谱。通过其 REST API（端口 8780）和 Web UI（端口 8080）运行一系列异步任务：分集规划、剧本生成（自适应/直译/分镜模式）、基于节拍的分镜图生成、使用 IndexTTS2 的配音合成，以及最终视频和字幕文件（SRT）的组装和导出。它配备资源库以管理角色、场景、道具和语音，保持跨集的身份一致性；Director World（3GS）锁定空间结构和镜头位置以实现场景一致性；Xia Director 作为对话式生产助手；Task Center 支持生成任务的状态查看、重试和断点续跑。所有状态和媒体存储在本地文件系统的 'ce-data' 卷中，无需外部数据库。
- 独立小说创作者：将长篇网络小说批量转化为多集短剧视频，无需手动拆解章节或绘制分镜。
- 小型广告工作室：利用同一流水线生成短广告、电商产品视频，仅需调整剧本和风格模板。
- 乙女游戏团队：使用分镜生成、语音合成和资产库来创建互动剧情的内容素材。
- 创意工程师：通过自托管管道和 OpenAI 兼容网关集成自定义模型，部署在自己的服务器上。
- 影视制作公司：利用 Director World 和无限画布功能进行迭代式视觉探索，确保场景和角色一致性。
如何安装或部署这个 Agent？
推荐使用 Docker 安装：克隆仓库，复制 .env.example 为 .env 并设置 PROMPT_EXPORT_PASSWORD，然后运行 docker compose up -d --build。也可使用 release 版本的 docker-compose.release.yml 文件（curl 下载），无需本地构建，镜像已发布到 Docker Hub。本地开发需 Python 3.11-3.12、uv 和 ffmpeg，运行 uv sync 后使用 uv run novelvideo api --port 8780 启动。
如何使用这个 Agent？
启动后打开 http://localhost:8080，在设置中选择模型配置，粘贴从 https://relayclaw.cdnfg.com 获取的 DC key（或配置自己的 OpenAI 兼容端点）。在主界面创建项目，上传小说稿件，然后按顺序运行各步骤：解析、规划、剧本、分镜、配音、合成。也可通过 REST API（端口 8780）以编程方式驱动，或使用 X 导演智能体对话推进任务。
这个 Agent 有哪些优点和局限？
- 端到端工业化流水线：从剧本到成片一站式完成，各步骤可独立运行和断点续跑。
- 源码可自托管：提供 Docker 一键部署，全部数据存储在本机文件系统，隐私可控。
- 模型中立：通过 OpenAI 兼容网关连接各种文本、图像、视频和语音模型，支持自备端点。
- 丰富的专业功能：包括形象一致性、场景一致性（3GS）、无限画布双模式工作流、导演智能体等。
- 默认依赖 DramaClaw 官方网关（relayclaw.cdnfg.com），自建网关需自行配置复杂映射。
- 需要获取官方 DC key，自托管时可能产生费用或需要额外设置。
- 本地运行模型需额外安装 GPU 和 CUDA，且官方文档未详细说明。
- 许可证为 Elastic 2.0，禁止转售托管服务，可能不适合某些商业用途。
这个 Agent 与同类方案有什么区别？
与其他工具相比，DramaClaw 强调完整的短剧生产闭环，包括资产库、场景一致性、导演世界、Xia 导演智能体、无限画布和双模式工作流，且提供源码可自托管，这是许多现有工具（如 L*TV、R*Hub、S*ko）不具备的。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| DramaClaw - 工业化短剧生产线 当前 | 0 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 6.3k | 3 天前 | Python | — |
| Auto Browser | 62 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 908 | 今天 | Python | OpenAI API · Claude API |
| ByteChef | 53 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 1k | 今天 | Java | OpenAI API · Claude API |
| SandBase Harness | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 639 | 7 天前 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据不足：仓库未提供权限模型、用户确认机制、数据流透明性、敏感数据处理、依赖安全审计、外部影响控制、回滚机制或来源归属的明确说明。所有信任相关标准均因缺乏证据而评为0。
证据不足：未提供自一致性、依赖可用性或失败消息的明确证据。尽管存在测试文件，但未提供执行结果或可靠性保证。
证据不足：README描述了广泛场景，但未提供能力边界、触发精度或环境适配的详细说明。
证据不足：README提供了安装说明和文档链接，但未提供信息架构、命名稳定性、示例/FAQ、已知限制、版本变更日志或维护责任的明确证据。许可证元数据为NOASSERTION，但README声明了Elastic License 2.0。
证据不足：README声称具有产出可用性和边际价值，但未提供成本效益分析或实际产出验证。
证据不足：README中的声明缺乏可追溯性，未提供跨来源佐证，也未区分事实与推断。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 仓库未提供AGENTS.md清单，且发布者身份未经验证，需谨慎对待。
- 许可证元数据为NOASSERTION，与README声明的Elastic License 2.0不一致，需核实。
- 依赖项包含多个未固定版本的包，存在供应链风险。
- README中的功能声明缺乏可验证的测试或执行证据。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
v2.0.6 User-facing Highlights (zh) - 视频延长: 支持在已配置相应模型时延长画布中的视频，并保留原视频画幅。 - 视频画质与帧率增强: 可通过已配置的模型调整视频分辨率和帧率，并选择智能插帧等处理方式。 - 音视频分离输出 MP3: 提取的音频改为 MP3 格式，便于用作支持该格式的模型参考音频。 User-facing Highlights (en) - Video extension: Extend a canvas video when a compatible model is configured, while preserving its aspect ratio. - Video quality and frame-rate enhancement: Use configured models to adjust resolution and frame rate, including frame interpolation. …在 GitHub 查看 ↗ -
发布说明摘录
v2.0.5 User-facing Highlights (zh) - 素材归档更完整: 视频、图片和音频生成结果支持归档后的交付与访问，减少临时结果链接失效带来的影响。 - 参考素材提前校验: 虾画生成前会检查参考素材的时长等限制，并标出不符合要求的文件，方便及时调整。 - 新增灵山图片模型: 社区版新增 LingShan G25 Fast 和 LingShan G25 Pro 图片模型配置。 - 账号与充值体验改进: 密码账号支持首次绑定手机号，并新增积分充值和独立结账流程。 User-facing Highlights (en) - More reliable archived media: Generated videos, images, and audio can be delivered from archives, reducing reliance on expiring result links. - Earlier reference validation: XiaHua checks reference media limits before generation and identifies files that need adjustment. …在 GitHub 查看 ↗ -
发布说明摘录
--- attention: medium --- v2.0.4 User-facing Highlights (zh) - 新增越南语界面: DramaClaw 现已提供完整的越南语界面，并修正英文剧本格式指引和多语言回退逻辑，让更多社区用户可以直接使用熟悉的语言完成创作。 - 支持可选手机号验证码登录: 部署方启用对应入口后，用户可以通过手机号和验证码登录并设置密码；登录能力默认受开关控制，不影响现有部署。 - 跨项目媒体引用更安全: 虾画会识别来自其他项目的图片和视频引用，阻止无效引用继续写入，并为历史遗留引用提供复制到当前项目的一键修复入口。 - 本地 CE 启动更省配置: 本地启动现在默认使用社区版，不再要求额外声明版本；并发初始化配置时也会自动重试。 - 画布任务计费参数更加准确: 画布主线生成任务会携带完整的模型计费参数，减少预估与实际结算不一致的情况。 User-facing Highlights (en) …在 GitHub 查看 ↗