Vibe知识大赏 · 精品知识短片工作室

一期 = 一个知识点 → 一条有旁白的精品短片（默认 16:9 1080p60）。时长由用户定：先按复杂度给四档建议（速览 / 精讲 / 标准 / 深挖），每档写清能讲多细、要砍什么（references/13-duration.md）。 引擎复用 ai-teardown 的 cine（旁白驱动的 seek(t) 代码成片），本 skill 加四样东西：6 种脚本母版（讲法）、风格库（长相 + 讲法，styles/，44 套 · 8 个家族已验证（每个家族至少 3 套） + 用户自己的风格）、知识片组件库 know.js、Renoise 增强层（图 / 视频 / 配乐 / 音效）。

一期 = 母版 × 风格 × 手法（≤2）× 档位。风格分 8 个家族：东方、暗场概念、明亮流行、印刷与纸、图解与设计、剪辑与纪实、电影感、游戏；其中敦煌壁画、青花、木刻、半调拼贴、长卷、铜版博物是增强档风格（每段约 2 张生图）。风格可以用库里的、改成自己的、或从空白做（references/09-style-studio.md）。

两档制作（references/08-tiers.md）：

• 基础档 · 0 积分：Opus 手写 SVG 分层插画 + 粒子 / 3D + 数据组件，小米 MiMo 配音（限免），默认 BGM（见下），earshot 代码音效（references/10-earshot.md，两档通用）。
• 增强档 · 按镜头挑：只把代码做不好的镜头（写实场景、最需要被记住的 1–3 个时刻、真实运动）交给 Renoise，其余照样代码。轻 ≈25–40 / 标准 ≈250–300 / 旗舰 ≈600–700 积分，每次先报价再生成。
• 同一份 film.js 两档通用（ENH 开关：plate/vclip ↔ layers）。

BGM（强制，2026-10-28 起，两档通用）

每条视频都必须有这首 BGM，音量统一（用户规定）。唯一例外：用户在对话里明确要求换曲——那条音乐写 bgm: true, user_request: "用户原话"，它就当 BGM，vibe-bgm 让位，音量照样校准；没写原话的一律不认。强制在混音环节完成：finish.py 打了 bgm_force.py 钩子——film.js 没放 BGM 就自动按片长补上；其他 ≥20 秒的整段配乐（Lyria、曲库）一律停用；BGM 音量不看 film.js 写的 gain，统一校准到「说话时比人声低 10 dB」（用户要求音量高一点；停顿处自动抬起约 2–4 dB），gain_curve 只保留起伏形状。qa.py 会检测成片里有没有这首 BGM，没有就报 ⚠⚠，不能交付。

所有知识大赏默认用同一首 BGM：assets/music/vibe-bgm.m4a（用户指定，112.9 BPM，160 秒，节拍网格在同名 .json）。配音定稿后一条命令按片长裁好，切点都在小节线上，开头照原曲、结尾接原曲的自然淡出，片子更长时按 8 小节循环：

$CINE_PY ~/.claude/skills/vibe-knowledge/tools/fit_bgm.py $L/assets/audio/bgm.wav --lesson $L --tail 3   # 总长 = 旁白 + 尾卡
# 同时输出 bgm.beats.json（成片里每一拍 / 每一小节的秒数），film.js 想卡点就读它

film.js 里：music.push({ src: P("audio/bgm.wav"), from: 0, at: 0, dur: END + TAIL, gain_curve: [[0, -11], [END, -11], [END + TAIL, -8]], fade_in: 0.3, fade_out: 1.8 })（旁白段 finish.py 会自动再压低）。 不再生成 Lyria 整段配乐（生成了也会被强制停用）；Renoise 只用来做短音效。

首次使用与风格推荐（先做这一步）

• 首次使用（~/.vibe-knowledge/welcomed 不存在）：先跑 python3 ~/.claude/skills/vibe-knowledge/tools/welcome.py，生成并打开本地「风格图鉴」（~/Desktop/vibe-knowledge/风格图鉴/index.html：风格快闪片、样片集、按家族分组的风格卡、三种开口方式、两档、流程），然后在对话里用 5–6 句话介绍：母版 × 风格 × 档位、8 个家族各举一两套、三种开口方式，最后问「想先做哪个选题？」。风格库更新后用 --force 重新生成。
• 用户给了选题：先跑 python3 ~/.claude/skills/vibe-knowledge/tools/recommend.py "<选题>"，拿到 3 套推荐后用 AskUserQuestion 问（推荐第一的排第一、标「（推荐）」、description 写理由和搭配母版；preview 写一句画面描述和风格图路径），同时用 SendUserFile 把 3 张风格图发给用户对照。用户点名了风格就跳过推荐。推荐到增强档风格时，在选项 description 里写明「需生图，约 8 积分/段」。
• 风格目录的唯一来源是 styles/catalog.json（推荐、图鉴、快闪片都读它）；加新风格时同步 catalog.json、STYLE.md、still.jpg。

核心主张（不能丢）

1. 精品标准是硬门槛（references/02-premium.md）：三层构图、没有静止超 3 秒的画面、每章一个「王炸」镜头（增强档 Renoise 动态镜头 / 基础档代码粒子、视差）、分层声音、整期一个视觉系统。
2. 没出处不上屏：数字、人名、年份、引文全部进 facts.md；示意画面标明；分歧两说并列。
3. 旁白讲故事，画面给关键词：画面字 ≤8 字一组、同屏最多两组；整句交给旁白和自动字幕。
4. 先猜后讲、标题延后、一个主道具贯穿、结尾回问（母版共用规则，references/01-templates.md）。
5. 旁白对位硬规则：没念到不露面、计数在念到时落定、强调有预算、最长静止 ≤3 秒（references/11-absorbed.md 第一节）。
6. 能代码就代码，花积分先确认：Renoise 只补代码做不好的镜头；所有生成先列表报价，用户在对话里明确同意才提交（references/04-renoise.md、08-tiers.md）。配音用小米 MiMo（限免）。

工作区

python3 ~/.claude/skills/vibe-knowledge/tools/new_film.py <期号> --template A --title "本福特定律"
#   默认工作区 ~/Desktop/vibe-knowledge、系列 vk；第一次会自动建 cine 系列、装 know.js、给录制工具打补丁、放用户克隆音色
S=~/Desktop/vibe-knowledge/examples/vk; L=$S/lessons/<期号>

依赖：ai-teardown skill（cine 引擎、make_lesson 配音）、CINE_PY（numpy scipy pillow playwright 的 Python；本机是 /usr/local/bin/python3.12，跑之前 PYTHONPATH= 清空，否则会加载坏掉的 PIL）、MiMo 密钥 ~/.config/ai-teardown/mimo.env、Renoise MCP（只有增强档需要；缺的话按 references/04-renoise.md「接入 Renoise」一节引导，注册链接原样给 https://renoise.ai/mcp?utm_medium=xcom&utm_source=official ）、ffmpeg、swiftc（OCR）。

流水线（三个确认点）

常用命令

cd ~/Desktop/vibe-knowledge; S=examples/vk; L=$S/lessons/<期号>
python3 scripts/tts_mimo.py $L/narration.json $L/build --gap 0.2 --lead 0.3 --qa --jobs 2 > $L/voice.log 2>&1   # 配音 + 逐字对齐 + 回读（拍间只留 0.2 秒，别用 make_lesson 默认的 0.8）
python3 scripts/speed.py $L 1.1                                        # 需要时整体提速，目标 5.5–6 字/秒
(cd $S && python3 tools/check_timings.py <期号>)                       # 对齐有没有断
python3 ~/.claude/skills/vibe-knowledge/tools/voice_post.py $L         # 人声后期（克隆音色定稿那条 EQ + 压缩）
python3 ~/.claude/skills/vibe-knowledge/tools/clip2frames.py $L/assets/clips/v01.mp4 $L/assets/clips/v01   # 视频拆帧 → 打印帧数
cd $S && $CINE_PY cine/tools/stills.py <期号> lessons/<期号>/stills/sheet.png 1 B01+1 B02.title B05.count+0.5 …
echo "<期号>|<片名>|<封面秒>" >> cine/queue.txt   # 只能追加！queue.txt 多会话共用
pgrep -f cine/tools/queue.sh || CINE_PY=$CINE_PY cine/tools/queue.sh   # 已有队列在跑就别再起第二个，否则两路录制写坏同一个 picture.mp4
python3 ~/.claude/skills/vibe-knowledge/tools/qa.py lessons/<期号>/build/lesson<期号>.mp4
python3 ~/.claude/skills/vibe-knowledge/tools/cover_first.py <成片.mp4> cover_16x9.jpg <交付.mp4>   # 封面接成开头帧（0.5 秒），每期交付必做

voice.log 里回读 <95% 的拍删掉 build/audio/<拍>.* 重配；专名用 lexicon 写读音。

参考文件

cine 引擎本身的契约、组件、渲染队列、坑：~/.claude/skills/ai-teardown/references/10-cine.md（改引擎前必读）。