short-drama-production README

The project's README from github.com/suihe1/short-drama-production. As one markdown file: README.md.

🎬 Short Drama Production

把 AI 视频生成,升级成可追踪、可审批、可返工的短剧生产管线

License: Apache-2.0 Node.js ≥ 18 Python ≥ 3.10 Tests: 22/22 Default: 16:9

不是再写一条“万能 Prompt”。 这是一个面向 Codex 的 AI 短剧生产总控 skill:把大纲、角色、美术、剧本、导演、技术分镜、H3 任务、声音、粗剪与 QC 串成一条有状态、有依赖、有审批边界的生产链。

内置 MiniMax 官方与 CompShare H3 执行路径;采用 Apache-2.0,可自由二次开发,并按需扩展 ComfyUI API。

AI 短剧 · 短剧skill · MiniMax H3 · Codex Skill · AI Video · ComfyUI


CompShare 注册福利

立即注册 CompShare,领取限时 300 积分 →

当前仓库内置的是 MiniMax 官方接口和 CompShare 参考图任务接口;ComfyUI 属于可扩展接入方向,并非开箱即用的内置节点。价格、积分、适用模型和活动期限可能调整,请以 CompShare 注册页及控制台实时展示为准。

为什么需要它

AI 短剧最难的往往不是“生成一个镜头”,而是让几十个镜头在持续修改后仍然可控。

常见生产问题 Short Drama Production 的处理方式
上游改了人物或场景,下游仍在使用旧素材 记录制品哈希和依赖关系,自动传播 stale 状态并要求重新审批
导演想法、技术分镜和模型提示词互相覆盖 导演意图与技术执行分层,保留偏差审计
一上来批量付费生成,错误被成倍放大 先做高暴露度样片;提交、批量、重试均需要明确确认
“现实主义”只有滤镜,没有真实空间逻辑 在出图前审计功能、设备、拓扑、人流、运行状态和生活痕迹
参考图越堆越多,反而锁死动作或产生多手 区分语义参考与关键帧,按 T2VA / I2VA / FL2VA / L2VA / Ref2VA 分流
音色来源、授权范围和最终母版混在一起 将发现、试听、授权克隆、母版登记与使用范围分开管理
视频“能看”但无法稳定返工 用 production.json 记录任务、审批、失败原因、粗剪和 QC 状态

一条真正可执行的生产链

flowchart LR
    A[需求 / 原著] --> B[大纲]
    B --> C[角色与美术]
    C --> D[剧本]
    D --> E[导演设计]
    E --> F[技术分镜]
    F --> G[H3 样片]
    G --> H{用户审批}
    H -->|通过| I[批量生成]
    H -->|退回| E
    I --> J[粗剪 / 声音 / 字幕]
    J --> K[QC 与返工]
    K --> L[交付]

核心状态只保存在 production.json。专业 JSON 负责内容,总控只保存路径、哈希、依赖、审批和任务状态,避免把大段创作内容重复塞进上下文。

核心能力

可视化故事板 · 免费离线审阅

镜头卡片并列展示构图规划、任务参考素材与生成视频,支持集数/关键词筛选、时间带定位、按规划时长预览、多版本切换和返工笔记导出。新增按段多格图片故事板:审阅版 PNG、模型参考版 PNG、单格 PNG 与镜头映射 JSON;可在页面替换单格图片。缺少媒体时显示占位,模型参考版要求图片齐全并完成人工检查,不调用生成 API。

node scripts/storyboard-view.mjs examples/offline/storyboard.json --out runs/storyboard-demo.html

打开生成的 HTML 即可使用。接入真实项目与功能边界见故事板使用说明。

进入人工审批节点时,agent 应主动打开当前报告、说明本轮范围与检查重点,并在对话中收取结论。用户可直接回复“通过 E01-01 分镜”或按镜号提出修改;不需要自行寻找 HTML 或运行命令。各阶段何时看、看什么、确认后如何继续见审阅交接。页面中的验收框用于导出参考图,不替代项目审批或费用授权。

1. 制片级状态管理

2. 导演与技术分镜分层

3. 现实题材真实性门

4. MiniMax H3 多模态执行

5. 声音资产管理

6. 粗剪、QC 与成本边界

快速开始

1. 安装

仓库包含生产总控和七个配套 skill。推荐从仓库根目录安装到一个新的 skills 目录,先预览再写入:

node scripts/install-bundle.mjs --dest <项目目录>/.agents/skills
node scripts/install-bundle.mjs --dest <项目目录>/.agents/skills --apply

八个 skill 安装为同级目录,保留跨 skill 引用。目标中已有同名目录时整次安装拒绝覆盖;更新前先备份旧版本,或安装到新的项目目录。单独使用总控时,也可只复制本仓库的 SKILL.md、agents、assets、references、scripts 和 LICENSE。

运行环境:

2. 在 Codex 中调用

首次安装,建议先运行免费离线演练:

node scripts/doctor.mjs
node scripts/offline-demo.mjs

检查器报告本机依赖;示例生成生产报告,并演示“大纲修改 → 剧本过期”。不需要 API 密钥,不调用生成接口。详见首次运行与依赖说明。

$short-drama-production 为这个项目建立 16:9 短剧生产状态,先检查现有制品和依赖,不提交任何付费任务。

你也可以直接要求它继续项目、检查状态、分析上游变更影响、准备 H3 样片或组织粗剪。

3. 使用命令行检查状态

node scripts/production-kit.mjs init <project-dir> --title <剧名> --source <源文件> --aspect 16:9
node scripts/production-kit.mjs status <project>/production.json
node scripts/production-kit.mjs validate <project>/production.json
node scripts/production-kit.mjs refresh <project>/production.json
node scripts/production-kit.mjs render <project>/production.json > production-report.md

完整命令和数据结构见 SKILL.md 与 references/。

两条分镜接入路线

路线 适用情况 行为
导演桥接 已有 director-package.json 用 storyboard-bridge.mjs 保留导演意图与偏差审计,再同步 H3 任务
标准分镜包 已有 novel-storyboard export/manifest.json 直接用 jobs-sync-package 接入,不再重复经过桥接器

两条路线是替代关系,不会把同一批分镜重复导入。

执行适配器

组件 已实现能力 当前边界
MiniMax 官方 H3 多模态参考、预检、确认提交、轮询、下载 需自行提供官方密钥
CompShare H3 本地参考图内嵌、预检、Context-IR、确认提交;输出时长 4–30 秒 当前适配器仅支持参考图任务
Fish Audio 音色发现、试听、授权克隆、母版登记 不替代声音授权判断
FFmpeg 顺序粗剪计划、显式执行、基础媒体 QC 不提供复杂多轨剪辑与调色

安全设计

项目结构

short-drama-production/
├── SKILL.md                         # Codex 入口与核心工作规则
├── LICENSE                          # Apache License 2.0
├── agents/
│   └── openai.yaml                  # Skill UI 元数据
├── references/                      # 按阶段加载的专业工作流说明
├── scripts/
│   ├── production-kit.mjs           # 状态、依赖、审批和任务总控
│   ├── storyboard-bridge.mjs        # 导演包桥接
│   ├── h3-official.mjs              # MiniMax 官方 H3 适配器
│   ├── compshare-h3.py              # CompShare H3 适配器
│   ├── fish-voice.mjs               # Fish Audio 声音适配器
│   ├── post-kit.mjs                 # 粗剪与基础 QC
│   └── selftest.mjs                 # 确定性回归测试
└── README.md

验证

node scripts/selftest.mjs
node scripts/reality-gate-test.mjs
node scripts/storyboard-view-test.mjs
node scripts/post-workflow-test.mjs
node scripts/bundle-test.mjs
python scripts/compshare-offline-test.py
python scripts/compshare-h3.py --help

当前发布包包含 22 项核心确定性测试,覆盖初始化、依赖失效、审批、两条分镜接入路线、H3 预检、CompShare 时长边界、声音登记与粗剪;真实性投产门和可视化故事板另有独立离线测试。

推荐搭配

以下配套版本已包含在 skills/,安装器会与总控一起安装:

缺失专业 skill 时仍可用 manual 制品接入总控,但不会冒充拥有对应专业质量门。

当前边界

当前发布版交付本地故事板审阅页面与基于已有单格图的多格 PNG 导出,不自动绘制缺失镜头或提交视频。返工笔记支持导出与合并导入;编辑会话可保存和恢复笔记、替换图片与布局,暂不回写项目。配套 skills 已随仓库分发,安装器和安装后的七套回归测试在 Windows/Linux CI 中验证。

升级后,CompShare 旧导出包需重新导出:新包包含 integrityVersion 和审计快照,防止继续使用已变化的审计。所有检查与示例均可离线运行;GitHub Actions 在 Windows/Linux 上运行离线测试,不配置生成密钥。

本项目不内置媒体生成模型,也不提供自动口型修复、声源分离、复杂多轨剪辑、调色或逐帧视觉检测。它解决的是生产组织、执行约束与可追踪返工;外部生成能力通过适配器或独立制品接入。

License

本项目采用 Apache License 2.0。你可以使用、复制、修改和分发本项目,也可以基于它开发自己的工作流;分发时需遵守许可证中的保留许可证、修改说明及相关声明要求。

short-drama-production (suihe1/short-drama-production)

Searching Database…

Что это?Это навык контроля производства для Codex, который превращает генерацию ИИ-видео коротких драм в отслеживаемый конвейер на основе состояний, охватывающий заявку (outline), персонажей, арт, сценарий, режиссуру, технические раскадровки, задачи шотов MiniMax H3, голосовые материалы, черновой монтаж и контроль качества.
Это отдельное приложение или то, что подключается к Codex?Это навык для Codex в комплекте с семью сопутствующими навыками, устанавливаемый набором соседних каталогов; кроме генерируемой офлайн-страницы просмотра раскадровки собственного интерфейса у него нет, и всё состояние оркестрации хранится в локальном файле production.json.
Что нужно установить, чтобы им пользоваться?Node.js 18+ для основного менеджера состояний, мостов и официального адаптера H3; Python 3.10+ для клиента CompShare; FFmpeg/ffprobe для чернового монтажа и проверки медиафайлов; плюс ваши собственные API-ключи MiniMax, CompShare или Fish Audio, хранящиеся в переменных окружения или локальном файле секретов.
Чего он НЕ делает из коробки?Он не включает ни одной модели генерации медиа и не делает автоматическое исправление липсинка, разделение голосов, сложный многодорожечный монтаж, цветокоррекцию или покадровый визуальный контроль качества — всё это остаётся внешним и подключается через адаптеры или отдельные материалы.
Что такое MiniMax H3?Это мультимодальная модель/API, которой навык управляет для генерации шотов. В проект входят и официальный интерфейс MiniMax, и адаптер CompShare, который умеет создавать клипы длительностью 4–30 секунд из референсов изображения, видео или аудио со встроенными предварительными проверками и опросом статуса.
Тратит ли он деньги, не спрашивая меня?Нет — по умолчанию сначала выполняются dry-run и предварительные проверки, а любая платная отправка, пакетное задание, повтор или перезапись готового монтажа требуют явного подтверждения каждый раз.
Как работает визуальный просмотр раскадровки?Он создаёт локальную офлайн HTML-страницу, где карточки шотов показывают рядом планы композиции, референсные материалы задачи и сгенерированное видео; есть фильтры по эпизодам/ключевым словам, позиционирование на таймлайне, переключение версий и экспортируемые замечания по доработке.
Что будет, если я изменю заявку или персонажа после того, как шоты уже сгенерированы?Система отслеживает хеш содержимого каждого ресурса; когда изменяется вышестоящий файл, зависимые шоты ниже по цепочке автоматически помечаются как устаревшие, а их прежние одобрения аннулируются — их придётся согласовать заново.
Creator
suihe1
Size
1.4 MB
Stars
183
Updated
CommitSep 15
Age
1mo
Commits · 90 Days