# brewreel

Adopt this skill: https://proskills.md/skills/other/finderchangchang-brewreel

Page: https://proskills.md/skills/other/finderchangchang-brewreel
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 14986
upstream: https://github.com/finderchangchang/brewreel/blob/HEAD/SKILL.md

```text
---
name: brewreel
description: 精酿 · BrewReel：做竖版产品宣传短片（1080x1920，15–45 秒，抖音/视频号/小红书）。用户要做产品宣传片、推广短视频、App 介绍视频、功能演示视频、上新短片、带货片头时使用。支持软件、餐饮、电商实物、教培、美业、文旅住宿六个行业，支持中英双语。你只写一份分镜 JSON（storyboard.json），画面由现成镜头组件画，校验脚本拦规则和行业合规，一条命令出片（带原创配乐和音效，可选 MiniMax / 阿里云 / 火山引擎配音）。
license: Apache-2.0
metadata:
  version: 0.5.1
---

# 精酿 · BrewReel：产品宣传短片

你只做两件事：**挑镜头**、**填文字**。不写代码，不改 `template/`、`scripts/`、`industries/` 里的任何文件，不写坐标、帧数、颜色值。

下文 `<SKILL>` = 本文件所在目录。命令都用 Node 22 / Python 3.10 跑。English speaker or English video needed → read `<SKILL>/SKILL.en.md` instead.

## 流程

0. **选风格**（`meta.style`，不写就是 `cards`）。先看产品属于哪一类，再读 `<SKILL>/styles/<风格>/STYLE.md` 和 `recipes.md`：

   | 风格 | 状态 | 适合什么产品 |
   |---|---|---|
   | `cards` 卡片信息流（默认） | 可用 | 单一卖点、要讲流程、要演示界面、实物门店；六个行业都支持 |
   | `quiz` 答题互动 | 可用 | 有常见误解、能出一道选择题的产品（外语短语、功能被误会、菜名名不副实、反常识知识点）。三套模板见 `styles/quiz/recipes.md`，样例在 `styles/quiz/examples/`。`meta.theme` 可选 `sage-pine` / `rice-soy` / `ash-teal`（不写：餐饮用 `rice-soy`，其余用 `sage-pine`）；`phraseTitle.params.voice` 选口吻 `exam` / `chat` / `show`（不写按行业选），题号签、回放标题、印章、评论提示这些固定句式跟着口吻走，也可以在镜头里直接写字覆盖；提问句和评论提示自己写，别抄同类视频的套话（Q14 会提醒）；clip 台词不许说出答案 |
   | `journey` 角色漫游 | 可用 | 内容多、类别清楚的产品（内容平台、功能多的软件、多门店多品类、课程体系、一条游线）。一站一个类别 / 功能 / 景点；三套模板和每拍字段见 `styles/journey/recipes.md`，样例在 `styles/journey/examples/`。默认 `meta.aspect: "4:5"`，也可 `9:16`；背景 `opening.params.skyline` 选 `modern` / `street` / `oldtown`（古城古镇题材必须 oldtown），街区道具要和内容对得上；开场小引写路线或看点（如「这趟车停 5 站」），别套「跟 X 一口气…」（J18 会提醒）；配色 `post-green`（默认）/ `plum-ticket`；价格、时间、总量数字只能抄 `meta.facts` |

   - 拿不准就用 `cards`，不用写 `meta.style`。开发中的风格校验会拦。
   - `meta.aspect`：`9:16`（默认，1080x1920）或 `4:5`（1080x1350）。`cards` 只支持 9:16，不用写。
   - 下面第 1–12 步是 `cards` 的写法。用别的风格时，镜头和字段以那个风格的 `recipes.md` 为准；行业合规、`meta.facts`、禁止事项、出片命令照旧。
   - **风格镜头的字段一律写在 `params` 里**，镜头顶层只有 `type`、`dur`、`params`。例（journey）：`{"type": "district", "dur": 4, "params": {"category": "预算提醒", "title": "月底前三天，提醒你收手", "scene": "phone"}}`。`meta.theme` 是 cards 的配色，别的风格按它自己的 recipes 写或不写；`cta` 这类可选字段不需要就整个删掉，不要写空字符串。
1. **定行业和语言**。
   - `meta.industry`：`software`（默认）/ `food`（餐饮）/ `ecommerce`（电商实物）/ `education`（教培）/ `beauty`（美业）/ `travel`（文旅住宿）。选错行业，能用的镜头和合规规则都会不对。
   - `meta.lang`：`zh`（默认）/ `en`。视频要出英文字幕、用户是英文用户，就写 `en`（用法见第 5 步）。
   - 行业不是 software → **先读 `<SKILL>/industries/<industry>/recipe.md`**（英文项目读 `recipe.en.md`）：里面有这个行业推荐的镜头组合、`brief-template.md`（这个行业简报要问哪些栏目）、`test-brief.md`/`expected.md`（合规红线举例）。跳过这一步很容易写出会被拦的内容。
2. **读简报**。按对应 `brief-template.md` 的栏目理解；缺「产品名 / 一句话卖点 / 痛点场景 / 核心动作 / 2–4 个卖点」就先问，别瞎编数据和功能。
   - `meta.product` 照抄简报的产品名，全片（hook 胶囊、片尾 brand）只用这一个名字，片尾 `brand` 必须和它一字不差。
   - `meta.action`：**必填**，一句话「用户做什么 → 产品给出什么」（如「拍小票 → 自动填好金额和分类」），不上画面。演示类镜头（chat/phone/mockApp/photoShot）的画面文字要体现这个动作，校验会核对。
   - 简报「获取方式」有内容 → 原样写进 `meta.cta`，片尾 `cta` 照抄它；简报写「无」→ 两处都不写。**不要自己编**「应用商店搜 XX」。
   - 简报里没有的功能不要写进卖点和片尾。
   - 简报「数字和来源」有内容 → 每条抄进 `meta.facts`，格式是 `[{"id":"f1","text":"原话…","source":"来源"}]`（**不是纯字符串数组**）：
     - `source` **必填**：照抄简报写的来源（「2026-09 价目表」「后台统计至 8 月」）；简报没写来源就写 `"简报未注明来源"`。不许自己编来源，也不许自己编 fact。
     - `quote` 可选：简报里的那句原话，逐字照抄。
     - 画面上任何带单位的数字（时长、百分比、倍数、人数、金额）都要能在 facts 里找到同样的数字，没有一律报错；确实没给数据就写定性说法，别编数字。
     - 镜头 `params.refs: ["f1"]` 把某个说法（如「现做」、compare 的 stat/level、meter 的读数）和某条 fact 关联起来。
   - **示例数据和效果说法分开**（校验会拦）：
     - text 或 source 里带「示例 / 演示 / 模拟 / 虚构」的 fact 是示例数据，**不能给效果说法作依据**。效果说法 = compare 的 stat/level、counter 的数、meter 往「变好」方向摆、字幕和卖点里的百分比/倍数、「省 / 缩短 / 提升」带的时长和金额。
     - 界面里只能用示例数字时（简报没给真数据）：meta 写 `"demoData": true`，`meta.disclaimer` 写「演示画面，数据为示例」。示例数字只能出现在 mockApp/phone/chat/priceCard 等演示界面和价格条款里。
     - 简报没给效果数据 → compare 只比做法（items 写「少 3 步」「不用切窗口」），不写 stat 数字和 level；不用 counter。
     - 速度说法（「几秒」「秒出」「即刻」「瞬间」「零等待」「instantly」）必须有一条真实 fact 带秒级耗时，否则报错。「马上试试」这类行动号召不算。
   - **限定语跟着数字走**（校验会拦）：屏幕上的数字对上某条 fact 时，fact 里跟着它的条件要在同一镜（字幕、卡片或底部提示条）写出来：
     - 日期范围照抄：fact 写「周日至周四 328 元」，画面就写「周日至周四」，不能改成「平日」「周一到周四」。
     - 券后 / 满减 / 会员价、「N 元起」、附加费金额、活动时间、预约、节假日不可用，一个都不能丢。例：「券后29.9元」不能写成「到手价29.9元」。
     - fact 只说「保温 6 小时」，画面不能写「全天保温」；fact 写了固定退房时间，画面不能写「灵活退房」。
   - **全片同一件事的耗时只用一个数**：counter 写 3 分钟，别处就不能写「秒出」「3 秒」；钩子写「半天」，counter 的旧值也得是半天。校验会拦。`compare` 同一栏的 `stat` 和 `items` 也不能自相矛盾（如左栏又写「5 分钟」又写「三天」）。
   - 想覆盖默认 15–45 秒的总时长范围（如行业推荐结构要 27 秒以上），写 `meta.durationRange: [15, 60]` 这样的两元素数组。
   - 底部需要常驻小字提示（如「限时活动，以团购详情页为准」），写 `meta.notices`：字符串数组，最多 3 条，合并成一行显示在底部。notices 别和 `meta.disclaimer` 说同一句话（都写「演示」就算重复，校验会拦）。
3. **建目录，登记素材**：`promo/<片名英文>/`，分镜写在 `promo/<片名英文>/storyboard.json`。用户给的截图/录屏/logo/照片复制进同一目录。
   - 用到照片的镜头（`photoShot`、`beforeAfter`、`storeCard.photo`）：每个文件都要登记在 `meta.assets`：
     `"assets": [{"src": "photos/dish.jpg", "source": "merchant"}]`。`source` 只能是 `merchant`（商家实拍）/ `illustration`（插画、示意图）/ `screenshot`（软件截图）。
   - 截图不能放进 photoShot；插画不能标「实拍」；不到 2KB、短边不到 300px、仓库自带示例图、`_dev/` 下的文件都算占位图，会被拦。
   - `beforeAfter` 的两张必须是**同一位顾客的两张不同照片**：都登记 `merchant`，`kind` 分别写 `customer-before` / `customer-after`，`pair` 写同一个值（如 `"A"`）。同一张图、改名复制的图都会被拦。
   - **商家没有可用照片**：photoShot 的 media 写 `{"source": "drawn", "tag": "示意", "illust": "<插画 id>"}` 用插画兜底，校验会放行并列进「需人工复核」。不写「实拍」「顾客授权」，不设 consent。商家给了照片却一张没用，才会被拦。
4. **选主题**（`meta.theme`）：
   - 情感、社交、生活 → `warm-emotion`
   - 开发者、AI、硬核工具 → `tech-dark`
   - 健康、学习、记账、轻工具 → `fresh-light`
   - 办公、B 端、效率 → `business-blue`
   - 节日、促销、上新 → `festival-red`
   - 高端、极简、设计 → `mono-premium`
   有品牌色就写 `meta.brandColor`（#RRGGBB），它只换强调色。
5. **挑 5–9 个镜头**（镜头说明看 `<SKILL>/shots.md`，18 个镜头一览表在最上面；用 quiz / journey 时镜头换成那个风格的，字段照第 0 步写进 `params`）。`hook` 必须第 1 镜（2–3 秒），`endCard` 必须最后 1 镜（4 秒）。
   **必须有一镜演示核心动作**（第 2 步写的 `meta.action`），按行业用不同的镜头，校验会拦：
   - **software、education（界面类）**：`chat` 写 messages + panel（提问 → 回答）；或 `mockApp` 写 input（用户输入/提问）+ 结果（dashboard 的 stat、editor 的 items、done）；有截图用 `phone`。
     - 核心动作是发消息/回复的产品 → 必须有 chat（或 phone 真截图）；不是聊天类的产品 → 别用 chat 演。
     - `mockApp kind:"form"` 只给本来就是填表的产品，别拿表单顶替核心动作。
     - mockApp dashboard 的 `input` 和 `stat.label` 要问答对得上（问「上月广州新增多少商户」，stat 就写「上月广州新增商户」）；items 别写「数据」「信息」「内容」这种占位词。
   - **food、ecommerce、beauty、travel（实物/门店类）**：**不许用 mockApp 编 App 界面**（点单页、预订页都不行）。全片至少一镜 `photoShot`（实拍或插画兜底）或 `beforeAfter`，再配 steps / priceCard 讲清楚。
   `meta.industry` 决定哪些镜头能用（见 `industries/<industry>/rules.json` 的 `enabledShots`，或直接看 recipe.md），选了不开放的镜头校验会报错。7 个行业镜头（software 默认不开）：
   - `photoShot` 实拍照片/短视频（菜品、商品、作品、房间、公区、后厨）
   - `priceCard` 价目表；`storeCard` 门店/地图/预订；`reviewCard` 真实顾客评价（原文摘录，不能改写得更夸张）
   - `factSheet` 参数表/开箱清单/课程大纲/考试信息/色卡；`credCard` 资历/荣誉卡
   - `beforeAfter` 前后对比滑块（**只有美业开放**，要 `consent:true` + `retouched:false`）
   中间按产品类型选镜头，**别套固定模板**，`features` 卖点卡不是必选。两条硬要求（校验会提醒）：
   - **中段至少 1 镜来自 {compare, steps, phone, meter}**；
   - **quickList 和 counter 不同时用**（两个都用，片子就长成 hook → quickList → mockApp → counter → endCard 那个人人都一样的模板）。
   software 行业可选的组合（挑一种，再按产品改；其他行业直接照 `industries/<industry>/recipe.md` 的推荐结构改）：
   - **C 端情感/社交**（聊天、情感、陪伴）：hook(bubble) → chat 演示（写成 2–3 句字幕）→ meter 或 compare 讲「这句话的分量」→ quickList 快切 → endCard
   - **工具提效**（写作、记账、发布、剪辑）：hook(stat) → compare 讲「以前 vs 现在」→ mockApp editor/form 演示「输入 → 结果」→ steps 讲怎么用 → endCard；或 hook → quickList 讲麻烦 → mockApp → steps → endCard
   - **B 端数据/办公**（报表、会议、CRM）：hook(icon 或 split) → phone 截图圈注或 mockApp dashboard 带 input「问一句 → 出数」→ compare 讲做法差别 → steps → endCard；只有简报给了耗时数字才用 counter（那就别再用 quickList）
   - hook 的 `visual` 同一批片子别总用一种：一条扎心消息用 bubble，有真数字用 stat，说一处风景/一样东西用 illust，痛点 vs 产品用 split。compare 写了 level 时，`tone: good` 那栏要在这把尺子上占优（写 `higherIs` 说清越高越好还是越差）。
   总时长 20–30 秒最好（允许 15–45，或 `meta.durationRange` 的自定义范围）。同一种镜头别连着用。相邻两镜 mood 差别别超过 0.5（中间插一镜过渡），否则背景会硬切。
6. **写字幕**（每镜的 `caption`）：一镜一句话，抖音式大字，**说给观众听，不描述画面怎么动**（❌「卡片一张张出，讲它能做什么」这是镜头说明，不是字幕）。
   - 中文：最多 2 行，用 `\n` 换行；每行 ≤12 个汉字（字母数字算半个）。`meta.lang: "en"` 时英文字幕按拉丁字符数折算（约中文限制的 1.8 倍），具体数字看 `docs/shots/<type>.en.md`
   - `{}` 包住最关键的 2–5 个字，变强调色；每条最多 1 处
   - hook 的 caption = 封面标题，写用户的痛点或反常识问题
   - endCard 不写 caption，口号写在 `params.slogan`
   - **同一句字幕最多停 5 秒**。超过 5 秒的镜头（如 8–10 秒的 chat），caption 写成 2–3 句的数组，按拍平分这一镜：
     `"caption": ["先别急着发，\n对方要的是{你的在乎}", "挑一条填进输入框，\n发不发{你决定}"]`
   - 字幕要讲用户的处境或产品带来的变化，和前后镜头接得上；画
```

## File: README.md
upstream: https://github.com/finderchangchang/brewreel/blob/HEAD/README.md

````text
<div align="center">

<img src="docs/images/logo.png" width="120" alt="精酿 · BrewReel" />

# 精酿 · BrewReel

**便宜模型也能出合格视频：给素材，一条命令出片。**

[![Version](https://img.shields.io/badge/%E7%89%88%E6%9C%AC-v0.16.0-1f6feb?style=flat-square)](CHANGELOG.md) [![Stars](https://img.shields.io/github/stars/Finderchangchang/brewreel?style=flat-square&logo=github&label=Stars)](https://github.com/Finderchangchang/brewreel/stargazers) [![License](https://img.shields.io/github/license/Finderchangchang/brewreel?style=flat-square)](LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-%E6%8F%92%E4%BB%B6-4D6BFE?style=flat-square)](#在-deepseek-harness-里用)

[为什么是精酿](#为什么是精酿) · [快速开始](#快速开始) · [宣传片](#宣传片) · [口播配画面](#口播配画面) · [讲课视频](#讲课视频) · [文档](#文档) · [English](README.en.md)

<img src="docs/images/readme-modes.png" width="860" alt="宣传片、口播配画面、讲课视频" />

**宣传片**：一份产品简报 → 竖版宣传片（9:16）
**口播配画面**：一段口播 `talk.mp4` → 配好画面的口播（动效卡片 / AI 画面）
**讲课视频**：一份讲稿或 brief → 16:9 讲解课（可切竖版）
<sub>原名 promo-video-skill / 蒸馏视频，旧地址自动跳转。</sub>

</div>

## 为什么是精酿

**便宜模型只填表，不写代码。** 宣传片填 `storyboard.json`，口播填 `broll.json`，讲课填 `lesson.json`：挑版式、填文字。所以 DeepSeek 这类模型也能出合格片。

**合规和质检先拦一遍。** 广告法、行业规则、数字出处、版式、动效有没有停死，有一项不过就不出片。

**开源，可以商用。** Apache-2.0。分发时注明出处。渲染出的视频不要求署名。

## 快速开始

**装依赖。**

```bash
git clone https://github.com/Finderchangchang/brewreel.git
cd brewreel/template && npm install && npx remotion browser ensure
cd .. && pip install numpy scipy imageio-ffmpeg
```

**宣传片**（`examples/ledger.json`）

```bash
node scripts/validate.mjs examples/ledger.json
node scripts/make.mjs examples/ledger.json --out ../brewreel-out/ledger
```

校验通过后出片，要几分钟，最后一行是「交付：<mp4 路径>」。`--out` 不能指向仓库里面。

**口播配画面**

```bash
node scripts/talk.mjs path/to/project --out ../brewreel-out/talk
```

项目目录里放好 `talk.mp4`。本机转写，动效画面直接画；AI 画面先占位，不花钱。

**讲课视频**（`examples/lesson/mascot-demo.json`，mock 配音）

```bash
node scripts/lesson/make-lesson.mjs examples/lesson/mascot-demo.json --out ../brewreel-out/first-lesson --voice-provider mock --no-bgm
```

用占位配音看版式和节奏，不花配音费。成功时最后一行是「交付：」。

需要 Node.js 18+、Python 3.10+；Windows 只支持 x64。平台、环境变量和完整说明见 [安装与上手](docs/quickstart.md)。

## 宣传片

<p align="center"><img src="docs/images/readme-hero.gif" width="720" alt="cards、数据图表、quiz、journey" /></p>

**你给什么**：一份产品简报。

**你得到什么**：竖版宣传片（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`。说明见 [场景](docs/scene.md)。

- 3 种配方：`cards` 卡片信息流（默认，9:16）、`quiz` 答题互动（9:16）、`journey` 角色漫游（默认 4:5，也可 9:16）。
- 6 个行业：软件、餐饮、电商实物、成人职业培训、生活美容、文旅住宿。各带广告法和行业规则。不做医疗美容、处方药 / 药品、K12 学科培训、保健品功效宣称、烟草。
- 配音可选 MiniMax、阿里云、火山引擎。镜头时长跟着旁白，字幕逐字点亮，配乐在人声处压低。
- 数据图表有条形、折线、点图、堆叠、环形。图上的数必须能在引用的事实原文里找到。见 [dataChart](docs/shots/dataChart.md)。
- 校验自查有 ✗ 不出片。配乐现场合成，卡着镜头切点；字幕可选中文或英文。cards 默认 6 套主题，另有 12 套可选，见 [配色](styles/cards/THEMES.md)。

详细说明 → [功能](docs/features.md)

## 口播配画面

<p align="center"><img src="docs/images/talk-intro.png" width="720" alt="口播配画面示意，没有真人出镜" /></p>

<p align="center"><a href="https://github.com/Finderchangchang/brewreel/releases/download/v0.9.0/brewreel-v0.9.0-talk-demo.mp4">看演示视频</a></p>

**你给什么**：一段口播 `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` 换成剪纸拼贴：纸纹底、手剪卡片，说到重点词卡片抛起再落下。也不花钱。见 [动效外观](docs/motion-looks.md)。
- AI 画面用 MiniMax H3，全片共用 `broll/character.json` 里的一个机器人：积木风（`wood-blocks`，默认）、黏土定格（`clay-stopmotion`）、分层纸艺（`paper-layers`）。手绘线稿（`ink-sketch`）只能占位预览。默认最多 2 段。

**风格工厂。** 用一句话描述一种 AI 画面风格。脚本写配置、出参考图、看图打分、做一张静态试拍。看图会看错，最后要人看。人自己跑 `node scripts/broll/approve-style.mjs <id>`，AI 助手不许替人运行。欢迎把批准后的风格用 Pull Request 贡献回来。见 [风格工厂](docs/style-factory.md)。

**花钱和人审**：AI 画面先加 `--provider minimax-h3 --dry-run` 估价，加上 `--yes` 才生成。正式片要人自己跑 `node scripts/broll/approve.mjs <项目目录> --out <仓库外目录>`。`talk.mjs` 不会替你跑，批准命令只能人跑。

详细说明 → [口播配画面](docs/broll.md)

## 讲课视频

<p align="center"><img src="docs/images/lesson-layouts.webp" width="720" alt="讲课视频四种版式：法条卡、对比、流程、大数字" /></p>

**你给什么**：一份讲稿 `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 做识别，会花钱。没有当次明确要求不要跑。未确认的角色不能正式出片，确认只能人跑。

详细说明 → [讲课视频](docs/lesson.md)

## 让 AI 助手来做

Claude Code 把仓库放到 `~/.claude/skills/brewreel/`，Codex 等放到 `~/.agents/skills/brewreel/`。说要做什么。技能开头按你给的材料分流到宣传片、口播配画面或讲课视频。

- **想改哪里，说一句话**：`node scripts/revise.mjs <分镜/讲稿/broll.json> "第三镜慢一点，开头换成提问"`。便宜模型只改你说的那几处，改完先校验，宣传片先出改动镜头的静帧。见 [安装与上手](docs/quickstart.md)。
- **可调项**：宣传片分镜写 `meta.tweak` 调节奏、字号、标题字体，每一镜可以换背景图。见 [功能](docs/features.md)。
- **强模型的自由镜头**：Codex、Claude Code 这类会写代码的模型，可以在宣传片里自己写一镜动画（`custom`），字仍从分镜里读、校验照跑。便宜模型不要用。见 [自由镜头](docs/custom-shot.md)。

### 在 DeepSeek Harness 里用

仓库自带插件 `dsh-brewreel`。7 个工具管宣传片的校验、出片和核对。注册进去的技能说明也会分流：口播配画面写 `broll.json`、跑 `scripts/talk.mjs`；风格工厂读 `docs/style-factory.md`、跑 `scripts/broll/new-style.mjs`；讲课视频读 `lesson/SKILL-lesson.md`、跑 `scripts/lesson/make-lesson.mjs`。这三件不走那 7 个工具。安装和版本要求见 [安装与上手](docs/quickstart.md#在-deepseek-harness-里用)。

## 文档

| 文档 | 讲什么 |
|---|---|
| [安装与上手](docs/quickstart.md) | 平台、环境、口播命令、风格工厂、DeepSeek Harness |
| [功能](docs/features.md) | 配方、配音、行业、校验 |
| [口播配画面](docs/broll.md) | 只放一段口播，配动效画面或 AI 画面 |
| [风格工厂](docs/style-factory.md) | 一句话造一种 AI 画面风格，人批准 |
| [讲课视频](docs/lesson.md) | 讲解课、课程、普法、教程 |
| [动效外观](docs/motion-looks.md) | 剪纸拼贴等动效卡片外观 |
| [截图](docs/gallery.md) | 三种宣传片配方的画面 |
| [它怎么工作](docs/how-it-works.md) | 从简报到成片的步骤 |
| [常见问题](docs/faq.md) | 配乐、环境、出片时碰到的问题 |
| [已知限制](docs/limitations.md) | 还不能直接发的原因，和测试方法 |
| [更新日志](CHANGELOG.md) | 每个版本改了什么 · [历史版本](https://github.com/Finderchangchang/brewreel/releases) |
| [贡献说明](CONTRIBUTING.md) | 怎么交一份宣传片配方 |

官网：[首次出片指南](https://brewreel.com/guides/first-promo-video.html) · [产品简报模板](https://brewreel.com/guides/product-brief.html)。仓库里的通用模板：[brief-template.md](brief-template.md)。

## 已知限制

- **还是预览版。** 不建议把成片不经人工修改直接对外发布。当成初稿，看完再改再发。
- **有的接入还没真实跑过。** 阿里云和火山引擎配音还没用真实 key。DeepSeek Harness 插件还没接真实 DeepSeek 模型。MiniMax 配音用真实 key 出过片。
- **没有实拍就只能插画。** 不做医疗美容、处方药 / 药品、K12 学科培训、保健品功效宣称、烟草。

测试方法和仍存在的问题见 [已知限制](docs/limitations.md)。

## 交流群 / 需求收集

**如需联系，请公众号私信。** 合作、赞助、反馈都走公众号私信。暂时还没有精酿 · BrewReel 的专属交流群。

<p align="center"><img src="docs/images/contact/wechat-mp.png" width="180" alt="公众号二维码" /></p>

**问题反馈走 [GitHub Issues](https://github.com/Finderchangchang/brewreel/issues)**：误伤或漏拦的校验规则、渲染出错、看着别扭的画面，附上分镜 JSON 和报错最好（别贴 API Key）。

想听真实需求：你想给什么产品做片？缺哪种配方、哪个行业？哪条合规规则误伤了你？公众号私信或开 issue 都行。

## ❤️赞助商

> 想出现在这里？加微信 **jskjkf007**，添加时请备注「BrewReel 商务合作」。

## ☕ 请我喝杯咖啡

如果精酿帮你省下了一晚上剪片的时间，欢迎请我喝杯咖啡。每一份配方都是一杯杯咖啡熬出来的：这杯续上，下一份配方就调得快一点；哪天仓库里突然多了一个新风格，多半是这杯起了作用 😄

<p align="center">
  <img src="docs/images/contact/wechat-donate-v3.png" width="260" alt="微信赞赏码（姓名已隐去）" />
</p>

<p align="center"><sub>量力而行，不用有压力；点个 Star、提个 issue，或者给我看看你酿的片子，我一样开心。</sub></p>

## 姊妹项目

同一作者放在 [jev-chat](https://github.com/jev-chat) 组织下的开源项目：

- [Jev 聊天助手](https://github.com/jev-chat/jev-chat-jarvis)：装在手机上的「对话副驾」，在受支持的聊天 App 里帮你读懂对方、给出回复建议并填入输入框，发不发由你。
- [Jev 聊天助手 macOS 版](https://github.com/jev-chat/jev-chat-jarvis-mac)：微信消息意图识别悬浮窗，看屏 + 本地小模型判断意图和风险，再按话术生成回复候选，纯只读。
- [Jev 聊天助手 Windows 版](https://github.com/jev-chat/jev-chat-windows)：微信 Windows 4.x 旁挂的回复辅助，窗口截图 + 本地离线 OCR，3 条候选一键填入，发送永远手动。

## 版权与许可

Copyright © 2026 Finderchangchang。代码以 [Apache-2.0](LICENSE) 协议开源，另见 [NOTICE](NOTICE) 和 [THIRD_PARTY_LICENSE
````
