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…

What is this?This is a production-control skill for Codex that turns AI short-drama video generation into a trackable, state-based pipeline covering outline, characters, art, script, directing, technical storyboards, MiniMax H3 shot jobs, voice assets, rough cuts and QC.
Is this a standalone app, or something I plug into Codex?It's a Codex skill bundled with seven companion skills, installed as a set of sibling directories; besides a generated offline storyboard review page it has no UI of its own, and all orchestration state lives in a local production.json file.
What do I need installed before I can use it?Node.js 18+ for the core state manager, bridges and the official H3 adapter; Python 3.10+ for the CompShare client; FFmpeg/ffprobe for rough cuts and media checks; plus your own MiniMax, CompShare or Fish Audio API keys kept in environment variables or a local secrets file.
What does it NOT do out of the box?It doesn't bundle any media-generation model, and it doesn't do automatic lip-sync fixing, voice separation, complex multi-track editing, color grading, or frame-by-frame visual QC — those stay external, plugged in via adapters or separate assets.
What is MiniMax H3?It's the multimodal model/API the skill drives for shot generation. The project ships both the official MiniMax interface and a CompShare adapter that can produce 4-30 second clips from image, video or audio references, with built-in pre-checks and polling.
Does it ever spend money without asking me?No — dry-run and pre-checks come first by default, and any paid submission, batch job, retry, or overwrite of a finished cut requires an explicit confirmation each time.
How does the visual storyboard review work?It generates a local offline HTML page where shot cards show composition plans, task reference material, and generated video side by side, with episode/keyword filters, timeline positioning, multi-version switching, and exportable rework notes.
What happens if I change an outline or character after shots are already generated?The system tracks a content hash for every asset; when an upstream file changes, it automatically marks dependent downstream shots as stale and invalidates their prior approvals, so they need to be reviewed again.
Creator
suihe1
Size
1.4 MB
Stars
184
Updated
CommitSep 15
Age
1mo
Commits · 90 Days