Finderchangchang / brewreel

# 精酿 · BrewReel
**便宜模型也能出合格视频：给素材，一条命令出片。**
为什么是精酿 · 快速开始 · 宣传片 · 口播配画面 · 讲课视频 · 文档 · English
**宣传片**：一份产品简报 → 竖版宣传片（9:16）
**口播配画面**：一段口播 `talk.mp4` → 配好画面的口播（动效卡片 / AI 画面）
**讲课视频**：一份讲稿或 brief → 16:9 讲解课（可切竖版）
 原名 promo-video-skill / 蒸馏视频，旧地址自动跳转。 
## 为什么是精酿
**便宜模型只填表，不写代码。** 宣传片填 `storyboard.json`，口播填 `broll.json`，讲课填 `lesson.json`：挑版式、填文字。所以 DeepSeek 这类模型也能出合格片。
**合规和质检先拦一遍。** 广告法、行业规则、数字出处、版式、动效有没有停死，有一项不过就不出片。
**开源，可以商用。** Apache-2.0。分发时注明出处。渲染出的视频不要求署名。
## 快速开始
**装依赖。**
 [code] 
**宣传片**（`examples/ledger.json`）
 [code] 
校验通过后出片，要几分钟，最后一行是「交付： 」。`--out` 不能指向仓库里面。
**口播配画面**
 [code] 
项目目录里放好 `talk.mp4`。本机转写，动效画面直接画；AI 画面先占位，不花钱。
**讲课视频**（`examples/lesson/mascot-demo.json`，mock 配音）
 [code] 
用占位配音看版式和节奏，不花配音费。成功时最后一行是「交付：」。
需要 Node.js 18+、Python 3.10+；Windows 只支持 x64。平台、环境变量和完整说明见 安装与上手。
## 宣传片
**你给什么**：一份产品简报。
**你得到什么**：竖版宣传片（9:16；`journey` 默认 4:5）。
**一条命令**：`node scripts/make.mjs examples/ledger.json --out ../brewreel-out/ledger`
实验写法 `scene.json`：模型写语义，引擎算样子。`node scripts/scene/make-scene.mjs examples/scene/c-techbrief.json --out ../brewreel-out/scene --voice-provider mock`。说明见 场景。
- 3 种配方：`cards` 卡片信息流（默认，9:16）、`quiz` 答题互动（9:16）、`journey` 角色漫游（默认 4:5，也可 9:16）。
- 6 个行业：软件、餐饮、电商实物、成人职业培训、生活美容、文旅住宿。各带广告法和行业规则。不做医疗美容、处方药 / 药品、K12 学科培训、保健品功效宣称、烟草。
- 配音可选 MiniMax、阿里云、火山引擎。镜头时长跟着旁白，字幕逐字点亮，配乐在人声处压低。
- 数据图表有条形、折线、点图、堆叠、环形。图上的数必须能在引用的事实原文里找到。见 dataChart。
- 校验自查有 ✗ 不出片。配乐现场合成，卡着镜头切点；字幕可选中文或英文。cards 默认 6 套主题，另有 12 套可选，见 配色。
详细说明 → 功能
## 口播配画面
 看演示视频 
**你给什么**：一段口播 `talk.mp4`。
**你得到什么**：配好画面的口播。动效卡片不花钱；AI 画面要先估价、人审。
**一条命令**：`node scripts/talk.mjs path/to/project --out ../brewreel-out/talk`
- 本机用 SenseVoice（FunAudioLLM / 阿里通义实验室，由 sherpa-onnx 运行）转写。已有 `talk.srt` 不会被覆盖。
- 动效画面五种：关键词、清单、步骤、数字、对比。字只能照抄原话，脚本逐字核对，不花钱。
- 动效卡片默认跟着主风格配色。加 `--motion-look cutpaper-meadow` 或 `cutpaper-dusk` 换成剪纸拼贴：纸纹底、手剪卡片，说到重点词卡片抛起再落下。也不花钱。见 动效外观。
- AI 画面用 MiniMax H3，全片共用 `broll/character.json` 里的一个机器人：积木风（`wood-blocks`，默认）、黏土定格（`clay-stopmotion`）、分层纸艺（`paper-layers`）。手绘线稿（`ink-sketch`）只能占位预览。默认最多 2 段。
**风格工厂。** 用一句话描述一种 AI 画面风格。脚本写配置、出参考图、看图打分、做一张静态试拍。看图会看错，最后要人看。人自己跑 `node scripts/broll/approve-style.mjs `，AI 助手不许替人运行。欢迎把批准后的风格用 Pull Request 贡献回来。见 风格工厂。
**花钱和人审**：AI 画面先加 `--provider minimax-h3 --dry-run` 估价，加上 `--yes` 才生成。正式片要人自己跑 `node scripts/broll/approve.mjs --out `。`talk.mjs` 不会替你跑，批准命令只能人跑。
详细说明 → 口播配画面
## 讲课视频
**你给什么**：一份讲稿 `lesson.json`，或一份 brief。
**你得到什么**：16:9 讲解课。可以另出竖版切片和封面。
**一条命令**：`node scripts/lesson/make-lesson.mjs examples/lesson/mascot-demo.json --out ../brewreel-out/first-lesson --voice-provider mock --no-bgm`
- 20 种版式，4 套主题：`paper` 卷宗（普法默认）、`lecture` 讲台（其余默认）、`product` 产品、`editorial` 杂志（只能手选，不能用于普法）。
- 可以带讲解员和品牌包装。预设卡通不花钱。不写品牌也能出片。
- 改完一页后用同一个输出目录再跑，没改的页会复用。
- 普法没有有效审稿记录就不出片。技术课不强制。AI 助手不能替人签字。
- 领域包：`tech` 技术讲解，`legal` 普法。普法的法条只从已核对的《民法典》语料回填。
**花钱和人审**：照片建角色要本人同意，照片会发给 MiniMax 做识别，会花钱。没有当次明确要求不要跑。未确认的角色不能正式出片，确认只能人跑。
详细说明 → 讲课视频
## 让 AI 助手来做
Claude Code 把仓库放到 `~/.claude/skills/brewreel/`，Codex 等放到 `~/.agents/skills/brewreel/`。说要做什么。技能开头按你给的材料分流到宣传片、口播配画面或讲