@biunow/agent-biuvibe 0.0.0-stage → 1.0.0

package/engine/.claude/skills/weilanx-creator-blackgold-video/references//345/215/241/347/202/271/344/270/216/351/237/263/346/225/210.md

@@ -0,0 +1,56 @@
+# 配乐卡点与音效
+
+## we-never 网格（统一配乐，已授权 2026-10-11）
+
+```ts
+export const BAR = (102.52 - 17.45) / 40;   // 两个重拍相隔正好 40 小节，一小节约 2.127 秒
+export const BAR0 = 17.45 - 8 * BAR;          // 第 0 拍 ≈ 0.44 秒
+export const BEAT = BAR / 4;
+export const fbt = (b: number) => fr(BAR0 + BEAT * b);   // 第 b 拍的帧
+export const fb = (k: number) => fbt(4 * k);              // 第 k 小节
+HIT = fb(8)        // 17.45 秒，第 32 拍
+HIT2 = fb(48)      // 102.52 秒，第 192 拍（配乐换气后整段重新进来）
+DARK_FROM = fr(16.7); DARK_FROM2 = fr(101.75); FREEZE = 3
+DURATION = fr(beatSec(256) + 1)   // ≈ 137.5 秒
+```
+
+## 实测重音（测试里 ±2 帧核对）
+
+| 段落 | 拍号 | 秒 |
+|---|---|---|
+| 开场第一组 | 0 / 5 / 7 / 8 | 0.44 / 3.09 / 4.16 / 4.69 |
+| 开场第二组 | 11 / 13 / 15 / 16 | 6.28 / 7.35 / 8.41 / 8.94 |
+| 回落段 11 下硬拍（10–15 dB 跳变） | 165 · 167 · 168 ／ 171 · 173 · 175 · 176 ／ 181 · 183 · 184 ／ 187 | 88.16 · 89.23 · 89.76 · 91.35 · 92.42 · 93.48 · 94.01 · 96.67 · 97.73 · 98.27 · 99.86 |
+| 强拍（换镜头、关键数字） | 80 / 85 / 88 / 104 / 112 / 117 / 120 / 128 / 133 / 136 / 144 | — |
+
+**硬拍一拍一个动作**：回落段 11 下，ep36 是「双数下按拉杆、单数下冲到食槽」，对账卡每下跳一次数；下一期按选题换成「出一次价」「亮一个人」「多一个旁观者」。
+
+## 重拍前后
+
+- 重拍前约 0.75 秒（`DARK_FROM`）起整体收暗到 94% 黑（`pow(…, 0.7)`），最后 3 帧画面静止（`ff = min(f, HIT − FREEZE)`）。
+- 重拍帧：标题 / 锚词 **+2 帧必须已经亮**（`SparkTitle instant`、`GlowSmash`）。
+- 每小节第一拍整屏轻推 1.2%，两个重拍 4%（`barPunch`，从 `src/library/lamplight/scenes` 引；字幕在推的那层外面）。
+
+## 音效（`audio/episodes/<期>.mjs`，照 ep36）
+
+`cutMusic({track: 'we-never', start: 0, duration: DURATION, ep, fadeIn: 0.02, fadeOut: 2})` 成功后 `makeTacticalSfx(EP)`（借 riser），再用 ffmpeg `aevalsrc` 合成本期的：
+
+| 名字 | 用途 | 音量 |
+|---|---|---|
+| room | 极轻粉噪底噪，整片 | 0.5 |
+| impact | 两个爆点、关键结论（第 8、32、120、152、192、216 拍） | 爆点 0.66–0.7，其余 0.4–0.45 |
+| riser | 两个爆点前 2 秒 | 0.55–0.6 |
+| chime | 数字亮起、天平落定、结论（落在强拍上） | 0.35–0.45 |
+| **本期动作音** | 模型里的动作，卡开场四连和回落段硬拍。ep36：press 拉杆咔哒（0.5–0.7）、drop 食粒落槽碎响（0.45–0.6）、run 小碎步（0.6） | — |
+| 共享 whoosh / paper | 换章、引文出现 | 0.22–0.3 |
+
+动作音按选题设计：拍卖 → 木槌 / 硬币；旁观者 → 心跳 / 呼救声的抽象音（不要真人声）；天平 → 金属轻碰。合成后 `alimiter=limit=0.5` 压峰。
+
+## 响度自查
+
+- 整片约 −15.5 LUFS（ep36 −15.4）、真峰值 ≤ −1 dBFS（ep36 −1.7）。超了找峰值所在 0.1 秒窗口，通常是 impact + 动作音 + 配乐重音叠在同一拍，压低或去掉 impact。
+- 高频小音效（铃、碎响、咔哒）用 1.2–5 kHz 带通比前后能量，要高出 10 dB 以上；全频 RMS 会被配乐重音淹掉、量不准：
+  ```sh
+  ffmpeg -nostats -ss <秒> -t 0.2 -i a.wav -af "highpass=f=1200,lowpass=f=5000,volumedetect" -f null - 2>&1 | grep mean_volume
+  ```
+- **听不到声音要如实说**，只报数字。

package/engine/.claude/skills/weilanx-creator-blackgold-video/references//345/260/201/351/235/242/344/270/216/345/217/221/345/270/203.md

@@ -0,0 +1,68 @@
+# 封面、发布文案、字幕稿
+
+## 3:4 封面（代码渲染）
+
+不用 AI 生图：中文一个字都不会错，画风和片子一致。照 `src/episodes/ep36-boxed-pigs/CoverTall.tsx`（1080×1440 的 `Still`）：
+
+- **上半标题字牌**：系列小字「黑金光影 · <领域>」（36px，灰，字距 12）→ 金色大标题（宋体 Black 176px，`#ffe9b0` + 多层金色光晕，和 `SparkTitle` 一致）→ 米白问句副题（92px，两行，关键词用青色发光）→ 红框钩子条（52px，一句戳痛点的话，不换行）。
+- **下半主视觉**：把片中的舞台放进 `Stage`（1920×1080 舞台用 `left` / `top` / `scale` 裁进竖版），取最有戏的一刻（ep36：大猪甩汗奔跑 + 小猪趴着打呼）。动画帧取一个好看的固定值（`T = 47`）。
+- **压暗层**：上半渐变压暗；底部一条压暗带。
+- **底部一行结论数字**：灰色说明 + Garamond 大号金字（ep36「跑断腿 vs 躺着，净得 4 : 4」），必须和片中某句一致。
+- 在 `src/Root.tsx` 的 `09-黑金光影风` 文件夹里注册 `<Still id="<期>-cover-tall" …>`。
+
+```sh
+npx remotion still src/index.ts <期>-cover-tall <素材目录>/封面-3x4.png --timeout=120000 --log=error
+```
+
+渲完 Read 看：标题无压字、钩子条不换行、主视觉不被标题挡住、底部数字不压角色。
+
+## 字幕稿 + SRT
+
+```sh
+node .claude/skills/weilanx-creator-blackgold-video/scripts/subtitles.mjs <期> <素材目录>
+```
+
+产出 `字幕稿.md`（序号 | 时间 | 中文 | English）和 `字幕.srt`（双语两行）。标题卡、锚词爆点自动写成「标题：副题」「锚词（术语）」。
+
+## 发布文案（`<素材目录>/发布文案.md`，结构照 ep36）
+
+```markdown
+# <期> 发布文案
+
+## 标题
+[和封面一致的悬念问句]（与封面一致；悬念提问式，N 字）
+
+## 备选标题
+- [反常识提问，钩子落在观众的处境]
+- [结果先行，答案留到片里]
+
+## 描述
+[开场白描，2 句]
+
+两分钟讲清楚「<模型名>」：
+· [出处：年份 + 谁 + 做了什么 + 原文结论]
+· [规则和数字]
+· [推导两三步，带术语]
+
+[结论那句 + 反面情况]
+[重新定义锚词那两句]
+
+[评论区问题]？评论区说说。
+
+资料来源：[作者, 题目, 期刊 卷:页 (年份)；书名 + 章节表号]。画面、动画和字幕全部用代码一帧一帧画出来，[舞台]为示意。
+
+## 话题
+#<模型名> #博弈论 / #经济学 / #心理学 … #冷知识 #知识视频 #涨知识 #Vibe知识大赏
+
+---
+
+## 发布前核对（内部，不要发出去）
+- 每个数字的出处、核对情况（原文 / 摘要 / 自己算 / 示意）、测试位置
+- 原实验和课本说法的差异；有意没说的
+- 标题和事实的口径（会被挑刺的地方怎么回复）
+- 封面数字对应片中哪一句
+- 配乐：we-never，用户确认已授权（2026-10-11）
+- 片尾没有下期预告
+```
+
+封面、发布文案、字幕稿、字幕.srt 都复制到 `<成片目录>/`。

package/engine/.claude/skills/weilanx-creator-blackgold-video/references//347/224/273/351/235/242/344/270/216/351/225/234/345/244/264.md

@@ -0,0 +1,56 @@
+# 画面与镜头
+
+## 内容 → 组件（`src/library/blackgold/`）
+
+| 要表达的 | 组件 |
+|---|---|
+| 底色、质感 | `SmokeBg`（`tone` 暖 / 红，反面情况用红）、`Grain` |
+| 旁白 | `BGCaption`（y 950、size 56；最后一句问题 y 560、size 76 居中）；普通句 `out = 下一句开始 − 12`，话说一半随收暗退场 |
+| 章节、出处 | `ChapterTag` 左上、`CiteLine` 顶部（作者 · 年份 / 期刊 卷 : 页） |
+| 标题爆点 | `SparkTitle instant` + `FormulaField`（items 写本题的公式碎片） |
+| 锚词爆点 | `GlowSmash` + 背后一个和锚词同义的图形（「等」→ `TickRing`） |
+| 一个会动的小世界 | `pen.tsx`：`PigPen`（拉杆—管子—食槽）、`GlowPigG`（呼吸、眨眼、`sweat`、`zzz`、`eat`、`speed`）、`track` 跑位、`ShockG`、`LightMotesG`；人物题用 `GlowPawnG` / `Booth` / `Silhouettes` |
+| 规则、结局 | `GlowCard` + 本期的卡片内容（ep36 `OutcomeCard`） |
+| 2×2 博弈 | `PayoffMatrix`（箭头沿格子边缘，`hi` 标均衡）、`cellText` 由 `payoff()` 算 |
+| 两个选项比大小 | `BalanceScale`（`phases` 一拍换一次数值，往大的一边沉） |
+| 加减法 | `PelletStack`（`leave` 颗变汗珠飞走） |
+| 硬拍上累加的数 | `Ledger`（`bumps` 那一帧闪一下，`hiCol` 大号金字） |
+| 分布、比例、曲线 | `GlowBars`、`NeonLines`、`DotRing`、`CellGrid`、`TileSeq` |
+| 中央一句话 | `CenterWord` |
+
+## 每期都要有的「出彩设计」（3～5 个，只属于这个选题）
+
+用户 2026-10-13 明确要求：不要只拼素材包，要为选题设计体验感。套路（详见配方卡「出彩的手法」）：
+
+1. **一个舞台贯穿全片**：开场、回落段、结尾回到同一个小世界，推导段只是离开一会儿。
+2. **角色有生命**：呼吸、眨眼、甩汗、打呼、吃东西掉碎屑——先让观众对角色有情绪。
+3. **把推理变成实物**：比较 → 天平；减法 → 东西飞走；累计 → 对账卡；陷阱 → 红烟 + 灯闪。
+4. **硬拍推动数字**：回落段每一下硬拍都改变一个数，让观众亲眼看到结论成立。
+5. **连续长镜头转场**：推理收尾时镜头推进结论那一格（ep36：`transform-origin` 设在纳什均衡格中心、最后 20 帧放大 6 倍淡出），下一镜头从 1.25 倍落回 1 倍。
+6. **反面情况要有感官**：0 : 0 时灯接触不良（`flicker`）、肚子「咕……」。
+
+做完把通用的挪进 `src/library/blackgold/`（`pen.tsx` 就是 ep36 沉淀出来的），补 `src/library/README.md` 和配方卡。
+
+## 版式
+
+- 字幕区 y > 880 留给字幕；舞台地面 `FLOOR_Y = 800`，舞台元素别压进字幕区。
+- 顶部 0–200 给 `ChapterTag` / `CiteLine` / `Ledger`；有对账卡时把舞台整体 `translateY(40) scale(0.94)`（原点底部中间）让出顶部。
+- 收益矩阵靠左（x ≈ 400），右边留给天平（cx ≈ 1500）；均衡标签在矩阵右侧，天平在标签出现前淡出。
+- 两个角色挨着时，大的放后面、小的画在前面，脚底中心至少隔开两者半宽之和（ep36 初版大猪压住小猪）。
+
+## ep36 踩过的坑
+
+- 标题在重拍 +2 帧还没亮 → `SparkTitle` 加 `instant`。
+- `TickRing` 半径太小压住术语小字 → r ≥ 400。
+- 天平数字压在吊绳上 → 数字放秤盘里（`top: ey + 62`）。
+- 对账卡、食粒在 0.4 倍缩略图里太小 → 对账卡数字 54 / 76px、食粒 58px。
+- Root 里有风格 `<Folder>`，新一期要注册进 `09-黑金光影风`，不要跟在别的风格最后一期后面。
+
+## 自查清单（看 `qa.mjs` 拼图时逐条过）
+
+- 文字重叠、出画、折行（标题、卡片、天平标签、对账卡）；舞台元素压进字幕区
+- 该出现的东西都出现了（每个元素的出场帧在镜头范围内）；角色互相遮挡
+- 爆点：−16 已开始收暗、−3 静止、+2 标题 / 锚词已经亮
+- 中段抽帧：角色在跑、天平在晃、数字在跳，动画不是静止的
+- 示意画面有「示意」标注；出处行写对作者、年份、卷页
+- 响度约 −15.5 LUFS、峰值 ≤ −1 dBFS

package/engine/.claude/skills/weilanx-creator-blackgold-video/references//351/200/211/351/242/230/344/270/216/350/204/232/346/234/254.md

@@ -0,0 +1,59 @@
+# 选题、事实、选题与分镜脚本
+
+## 好选题 = 三样都有
+
+1. **一个人人有过的处境**，而且直觉是错的：干活多的吃亏（智猪博弈）、找对象该何时定（37% 法则）、人越多越没人管（旁观者效应）。
+2. **一个能画出来的模型**：收益矩阵、天平、点阵、网络、曲线、一个小世界（猪圈、拍卖台、隔间）。抽象到画不出来的不做。
+3. **能查到原文的数字或原话**：论文摘要、原书段落、教材表格。没有一手出处的流行说法（「眼镜蛇效应」这类轶事）不当事实讲。
+
+选题池：`materials/09-黑金光影风/选题.md`（⭐ 先做）。参考视频讲过的不撞：囚徒困境、一报还一报、鹰鸽博弈、维克里拍卖、空间囚徒困境网格、公地悲剧、猜平均数的 2/3。
+
+## 事实
+
+- **论文**：读到摘要（ScienceDirect / PubMed / 期刊页）；原话要引用就照摘要原文。只读到摘要的细节，字幕不能说得比摘要更具体。
+- **教材 / 原书**：读到原段落（网络副本可以），写清版本和表号（ep36：Rasmusen《Games and Information》§1.4 表 1.6）。
+- **同一个模型多个版本数字不同**（ep36 网上有一版是小猪先到吃 6 份）：取权威教材那一版，在核对清单里注明另一版存在。
+- **原实验和课本说法的差异**要在片里体现（ep36：原文是 dominant / subordinate，1979 段写「强的那只 / 弱的那只」，课本那段才说大猪小猪）。
+- **能算的就算**：收益、均衡、概率、比例写成 `timeline.ts` 里的函数，测试复算；画面上的累计数（ep36 对账卡）注明是按规则累加的示意。
+- **哲学题**（荒诞、虚无、悲观、斯多葛……）的「事实」是原著原话：找到原著章节（原文或通行中译本），字幕里的引文标书名和章节；不替哲学家说他没说过的话，流传的「名言」查不到出处就不用。
+- 一个选题至少 2 个来源，至少 1 个是同行评审论文或权威教材原文。
+
+## 锚词
+
+2～4 个字，是这个模型落在普通人生活里的**处境或动作**，不是术语：智猪博弈 →「等」，最优停止 →「37%」，旁观者效应 →「别人会管」，一美元拍卖 →「停不下」。
+
+出现四次：钩子第三句（`〔〕`金）、推导中段一次、第 192 拍大字砸出（下配「术语 · English」）、结尾重新定义（「等不是懒，是算出来的」）。
+
+## 章节骨架（拍号固定，照 ep36）
+
+| 拍 | 段落 | 做什么 |
+|---|---|---|
+| 0–24 | 钩子 | 第一秒就有发光的视觉锚点；三句把现象演出来（第二人称或「一个猪圈：…」这种白描）；开场两组四连重音（0/5/7/8、11/13/15/16）每下一个动作 |
+| 24 | 话说一半 | 「你猜，最后是谁吃亏了——」以「——」结尾，随收暗退场 |
+| 32 | 爆点 1 | 金粒子聚成标题（`SparkTitle instant`）+ 漂浮公式；不放字幕 |
+| 36–64 | 第 1 章：出处 | 原始实验 / 原始故事；`ChapterTag` + `CiteLine`（作者 · 年份 · 期刊卷页） |
+| 64–96 | 第 2 章：规则和数字 | 规则卡、结局卡（`GlowCard`） |
+| 96–160 | 第 3 章：推导 | 模型图（矩阵、天平、曲线），一步一拍点亮；术语用【】青色 |
+| 160–188 | 回落段 | 11 下硬拍 = 模型在小世界里一遍遍运行，每下推动一个数（对账卡） |
+| 188 | 话说一半 | 「它的全部本事，只有一个字——」 |
+| 192 | 爆点 2 | 锚词砸出 + 同义图形（「等」配表盘刻度环）+ 术语小字；不放字幕 |
+| 200–224 | 结论 | 把结论变成看得见的数（食粒柱 4 : 4）；反面情况（都不做 → 0 : 0） |
+| 224–240 | 重新定义锚词 | 「小猪敢躺，是因为有大猪在跑」「等不是懒，是算出来的」 |
+| 240–片尾 | 评论区问题 | 大号居中字幕，人人有答案（「你身边，谁是大猪，谁是小猪？」），舞台压暗；不做下期预告 |
+
+## 字幕规则
+
+- 每句中文 ≤ 18 字（不算标点、空格和【】〔〕〖〗标记），英文意译、比中文短更好。
+- 每句挂在拍点上，停 1～2 小节；推导段可以 4 拍一句（`它跟着按，净得 1；等着，净得 4。`）。
+- 数字统一用阿拉伯数字，负号用「−」。
+- 只有 `HALF_BEATS` 两句以「——」结尾；最后一句以「？」结尾。
+- 爆点那一拍 `CUES` 写 `[拍, null, '']`，同一行 `// 说明`。
+
+## `文案与卡点.md` 结构（ep36 那份是模板）
+
+1. 一句话：作品 ID、规格、配乐。
+2. 锚词「X」：四个出现位置。
+3. 卡点表：拍 | 秒 | 配乐 | 画面。
+4. 事实清单：说法 | 出处 | 核对（读到原文 / 摘要 / 自己算 / 示意）。
+5. 有意不说的：原实验和课本的差异、查不到原文的流行说法、标题的口径。
+6. 本期专属的出彩设计（3～5 条）。

package/engine/.claude/skills/weilanx-creator-blackgold-video/scripts/qa.mjs

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+// 一期的自动自查：抽帧拼图 + 两个爆点的收暗 / 静止 / 爆发 + 整片响度 + 每个音效有没有被配乐盖住。
+//   node .claude/skills/weilanx-creator-blackgold-video/scripts/qa.mjs <期>            # 全部
+//   node .claude/skills/weilanx-creator-blackgold-video/scripts/qa.mjs <期> --frames   # 只抽帧
+//   node .claude/skills/weilanx-creator-blackgold-video/scripts/qa.mjs <期> --audio    # 只测音频
+//   node .claude/skills/weilanx-creator-blackgold-video/scripts/qa.mjs <期> --frames-only=title,hit2   # 只重渲某几个镜头
+//   --loud=impact,press,drop   # 要检查「有没有被配乐盖住」的音效文件名（默认见下面 LOUD）
+// 产物在 /tmp/<期>/qa/：sheet-1.jpg、sheet-2.jpg …（每张 4×4，标了镜头名）、hits.jpg（两个爆点 −16 / −3 / +2 帧）、report.md。
+// 读 src/episodes/<期>/timeline.ts 的 SHOTS、HIT、HIT2、SFX、DURATION、FPS；timeline.ts 里不能 import 别的 .ts / .tsx（Node 只能剥掉本文件的类型）。
+// 运行前先 export NODE_OPTIONS=--max-old-space-size=4096。一次只渲一帧（并发渲染会把内存吃光）。
+import {execFileSync, spawnSync} from 'node:child_process';
+import {existsSync, mkdirSync, writeFileSync} from 'node:fs';
+import {resolve} from 'node:path';
+import {pathToFileURL} from 'node:url';
+
+const [ep, ...flags] = process.argv.slice(2);
+if (!ep) {
+  console.error('用法：node qa.mjs <期> [--frames | --audio | --frames-only=a,b]');
+  process.exit(1);
+}
+const only = flags.find((x) => x.startsWith('--frames-only='))?.split('=')[1]?.split(',');
+const doFrames = !flags.includes('--audio');
+const doAudio = !flags.includes('--frames') && !only;
+const T = await import(pathToFileURL(resolve(`src/episodes/${ep}/timeline.ts`)).href);
+const dir = `/tmp/${ep}/qa`;
+mkdirSync(dir, {recursive: true});
+const run = (cmd, args) => execFileSync(cmd, args, {stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 1 << 28}).toString();
+/** ffmpeg 的统计信息都打在 stderr 上，成功时也要读 stderr */
+const runErr = (cmd, args) => {
+  const r = spawnSync(cmd, args, {maxBuffer: 1 << 28});
+  return String(r.stderr ?? '') + String(r.stdout ?? '');
+};
+const still = (name, frame) => {
+  const out = `${dir}/${name}.jpg`;
+  run('npx', ['remotion', 'still', 'src/index.ts', ep, out, `--frame=${frame}`, '--scale=0.5', '--timeout=120000']);
+  // 左上角写镜头名和帧号，拼图时好对照
+  run('ffmpeg', ['-v', 'error', '-y', '-i', out, '-vf', `drawbox=x=0:y=0:w=330:h=44:color=black@0.7:t=fill,drawtext=text='${name} f${frame}':x=10:y=10:fontsize=24:fontcolor=yellow`, `${out}.tmp.jpg`]);
+  run('mv', [`${out}.tmp.jpg`, out]);
+  return out;
+};
+const sheet = (files, out, cols = 4) => {
+  const n = files.length;
+  const layout = files.map((_, i) => `${i % cols === 0 ? '0' : Array(i % cols).fill('w0').join('+')}_${Math.floor(i / cols) === 0 ? '0' : Array(Math.floor(i / cols)).fill('h0').join('+')}`).join('|');
+  run('ffmpeg', ['-v', 'error', '-y', ...files.flatMap((f) => ['-i', f]), '-filter_complex', n === 1 ? 'null' : `xstack=inputs=${n}:layout=${layout}:fill=black`, out]);
+};
+const report = [`# ${ep} 自查报告`, ''];
+
+if (doFrames) {
+  // 每个镜头取切走前的倒数第 4 帧：这时画面里该出现的东西都应该已经出来了（上一镜头的字幕也已退场）。
+  // 曾经漏过的 bug：节点要等到镜头结束之后才点亮、从头到尾都没露面——只看 3/4 处发现不了
+  const shots = Object.entries(T.SHOTS).filter(([k]) => !only || only.includes(k));
+  const files = [];
+  for (const [k, [a, b]] of shots) {
+    const f = Math.max(a, b - 4);
+    files.push(still(k, f));
+    process.stdout.write(`· ${k} `);
+  }
+  for (let i = 0; i < files.length; i += 16) sheet(files.slice(i, i + 16), `${dir}/sheet-${i / 16 + 1}.jpg`);
+  report.push(`## 抽帧`, '', `每个镜头切走前一帧，拼成 ${Math.ceil(files.length / 16)} 张：${Array.from({length: Math.ceil(files.length / 16)}, (_, i) => `${dir}/sheet-${i + 1}.jpg`).join('、')}`, '');
+  if (!only) {
+    const hits = [];
+    for (const [name, H] of [['hit1', T.HIT], ['hit2', T.HIT2]]) for (const d of [-16, -3, 2]) hits.push(still(`${name}${d > 0 ? '+' : ''}${d}`, H + d));
+    sheet(hits, `${dir}/hits.jpg`, 3);
+    report.push(`两个爆点各 −16 / −3 / +2 帧：${dir}/hits.jpg（应当是 收暗 → 静止 → 已经亮起来）`, '');
+  }
+  console.log('\n抽帧完成');
+}
+
+if (doAudio) {
+  const wav = `${dir}/a.wav`;
+  run('npx', ['remotion', 'render', 'src/index.ts', ep, wav, '--codec=wav']);
+  const eb = runErr('ffmpeg', ['-nostats', '-i', wav, '-af', 'ebur128=peak=true', '-f', 'null', '-']);
+  const I = Number(/I:\s+(-?[\d.]+) LUFS/.exec(eb.split('Summary')[1] ?? '')?.[1]);
+  const peak = Number(/Peak:\s+(-?[\d.]+) dBFS/.exec(eb.split('Summary')[1] ?? '')?.[1]);
+  // band = true 时只量 1.2–5 kHz：铃、咔哒、碎响这类高频小音效全频会被配乐低频淹掉，看频段才准
+  const mean = (t, d, band = false) =>
+    Number(/mean_volume: (-?[\d.]+) dB/.exec(runErr('ffmpeg', ['-ss', String(Math.max(0, t)), '-t', String(d), '-i', wav, '-af', `${band ? 'highpass=f=1200,lowpass=f=5000,' : ''}volumedetect`, '-f', 'null', '-']))?.[1] ?? NaN);
+  report.push('## 音频', '', `- 整片 ${I} LUFS（目标约 −15.5）、真峰值 ${peak} dBFS（不能高于 −1.0）${I > -14.5 || I < -16.5 || peak > -1 ? ' ⚠' : ''}`, '');
+  // 只看「要听得见」的音效：冲击、本期的动作音（按键、落下、铃）；whoosh、paper、room 本来就轻
+  const LOUD = flags.find((x) => x.startsWith('--loud='))?.split('=')[1]?.split(',') ?? ['impact', 'press', 'drop', 'chime', 'bell', 'clink', 'stamp', 'coin', 'tick'];
+  const loud = new RegExp(`/(${LOUD.join('|')})\\.wav$`);
+  const weak = [];
+  for (const [file, at, vol] of T.SFX) {
+    if (!loud.test(file)) continue;
+    const t = at / T.FPS;
+    const rise = mean(t, 0.15) - mean(t - 0.3, 0.15);
+    const riseHi = mean(t, 0.15, true) - mean(t - 0.3, 0.15, true);
+    // 全频高出 4 dB，或者 1.2–5 kHz 高出 6 dB，就算听得见
+    if (!(rise >= 4 || riseHi >= 6)) weak.push(`- ${file.split('/').pop()} @ ${t.toFixed(2)} 秒（音量 ${vol}）：全频只高 ${rise.toFixed(1)} dB、1.2–5 kHz 只高 ${riseHi.toFixed(1)} dB`);
+  }
+  report.push(weak.length ? `被配乐盖住的音效（全频高出不到 4 dB、1.2–5 kHz 也高出不到 6 dB；要么加音量、要么挪开前面的音效）：\n${weak.join('\n')}` : '要听得见的音效都比前一刻明显高出（全频 ≥ 4 dB 或 1.2–5 kHz ≥ 6 dB）。', '');
+  report.push('音量只看数值，听感要让用户自己确认。', '');
+  console.log(`音频：${I} LUFS / 峰值 ${peak} dBFS / 偏弱音效 ${weak.length} 处`);
+}
+
+writeFileSync(`${dir}/report.md`, report.join('\n'));
+console.log(`报告：${dir}/report.md`);
+if (!existsSync(`public/audio/${ep}/bgm.wav`)) console.log('⚠ 还没生成音频：node audio/episodes/<期>.mjs');

package/engine/.claude/skills/weilanx-creator-blackgold-video/scripts/subtitles.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// 从一期黑金光影风的 timeline.ts 生成双语字幕稿和 SRT：
+//   node .claude/skills/weilanx-creator-blackgold-video/scripts/subtitles.mjs <期> <输出目录>
+// 产物：<输出目录>/字幕稿.md（序号 | 时间 | 中文 | English）、<输出目录>/字幕.srt（中文一行 + 英文一行）。
+// 读 CUES（[拍号, 中文 | null, 英文]）、cueStart、cueEnd、HALF_BEATS、DARK_FROM、DARK_FROM2、HIT、HIT2、FPS、DURATION、
+// TITLE、TITLE_EN、TITLE_SUB、ANCHOR、TERM。中文为 null 的条目：落在 HIT 上写标题，落在 HIT2 上写锚词 + 术语，其余用源码同一行的 // 注释。
+// Node 24 直接 import .ts（剥掉类型），所以 timeline.ts 不能 import 别的 .ts / .tsx。
+import {mkdirSync, readFileSync, writeFileSync} from 'node:fs';
+import {resolve} from 'node:path';
+import {pathToFileURL} from 'node:url';
+
+const [ep, outDir] = process.argv.slice(2);
+if (!ep || !outDir) {
+  console.error('用法：node subtitles.mjs <期> <输出目录>');
+  process.exit(1);
+}
+const src = resolve(`src/episodes/${ep}/timeline.ts`);
+const T = await import(pathToFileURL(src).href);
+const notes = new Map();
+for (const m of readFileSync(src, 'utf8').matchAll(/\[(\d+),\s*null,\s*'[^']*'\],?\s*\/\/\s*(.+)/g)) notes.set(Number(m[1]), m[2].trim());
+
+const strip = (s) => s.replace(/[【】〔〕〖〗]/g, '');
+const srt = (f) => {
+  const ms = Math.round((f / T.FPS) * 1000);
+  const p = (n, w = 2) => String(n).padStart(w, '0');
+  return `${p(Math.floor(ms / 3600000))}:${p(Math.floor(ms / 60000) % 60)}:${p(Math.floor(ms / 1000) % 60)},${p(ms % 1000, 3)}`;
+};
+const mmss = (f) => {
+  const t = f / T.FPS;
+  return `${String(Math.floor(t / 60)).padStart(2, '0')}:${(t % 60).toFixed(1).padStart(4, '0')}`;
+};
+const half = T.HALF_BEATS ?? [];
+const rows = [];
+T.CUES.forEach(([beat, cn, en], i) => {
+  const a = T.cueStart(i);
+  let e = T.cueEnd(i);
+  if (beat === half[0] && T.DARK_FROM) e = T.DARK_FROM;
+  if (beat === half[1] && T.DARK_FROM2) e = T.DARK_FROM2;
+  if (cn) return rows.push({a, e, cn: strip(cn), en});
+  if (a === T.HIT && T.TITLE) return rows.push({a, e, cn: `${T.TITLE.replace(/\n/g, '')}${T.TITLE_SUB ? `：${T.TITLE_SUB}` : ''}`, en: T.TITLE_EN ?? ''});
+  if (a === T.HIT2 && T.ANCHOR) return rows.push({a, e, cn: `${T.ANCHOR}${T.TERM ? `（${T.TERM.split(' · ')[0]}）` : ''}`, en: T.TERM?.split(' · ')[1] ?? ''});
+  if (notes.has(beat)) rows.push({a, e, cn: `【${notes.get(beat)}】`, en: ''});
+});
+const hits = [T.HIT, T.HIT2].filter((x) => x !== undefined).map(mmss).join('、');
+const md =
+  `# 字幕稿 · ${ep}${T.TITLE ? ` ${T.TITLE.replace(/\n/g, '')}` : ''}\n\n共 ${rows.length} 条 · 时长 ${mmss(T.DURATION)} · 无口播，画面上的双语字幕即旁白${hits ? ` · 爆点 ${hits}` : ''}\n\n` +
+  `| 序号 | 时间 | 中文 | English |\n|---:|:---|:---|:---|\n` +
+  rows.map((r, i) => `| ${i + 1} | ${mmss(r.a)}–${mmss(r.e)} | ${r.cn} | ${r.en} |`).join('\n') +
+  '\n';
+mkdirSync(resolve(outDir), {recursive: true});
+writeFileSync(resolve(outDir, '字幕稿.md'), md);
+writeFileSync(resolve(outDir, '字幕.srt'), rows.filter((r) => !r.cn.startsWith('【')).map((r, i) => `${i + 1}\n${srt(r.a)} --> ${srt(r.e)}\n${r.cn}${r.en ? `\n${r.en}` : ''}\n`).join('\n'));
+console.log(`wrote ${outDir}/字幕稿.md + 字幕.srt（${rows.length} 条，${mmss(T.DURATION)}）`);

package/engine/.claude/skills/weilanx-creator-desk-video/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: weilanx-creator-desk-video
+description: 「暖纸工作台风」口播视频工作流：用户给一个主题（多是「我是怎么用 AI 做 XX 的」「一件事分几步」这类流程拆解），依次写口播稿、复刻音色配音并加速 1.2 倍、转 SRT；或者用户给一段自己录好的真人口播视频，直接转 SRT 并把真人放进左下角出镜小窗做 A-roll / B-roll。在 weilanx-claude-videos 工程里做成横屏 16:9 的口播视频：暖米色点阵纸当工作台（柔光晕 + 漂浮几何），白色窗口卡片和主视觉图形（清单、终端、同心圆、胶片、流程卡）一层层摆上来又滑走，阿里巴巴普惠体粗黑体标题 + 一块朱橙渐变高亮，顶部步骤条随口播推进，右下角像素吉祥物 CC 常驻换表情，字幕在底部；再出 3:4 封面和发布文案，打开 Studio 给用户预览，确认后导出（成片 + 分轨 + 封面 + 字幕稿 + 文案）。用户说「用暖纸风做一期」「做一期流程拆解」「像 dl(4) 那种口播风格做一期」「用工作台风格讲讲 XX」「做一期 XX 分几步」「我录好了口播，用暖纸风做出来」时都用这个 skill。
+---
+
+# 一个主题 / 一段真人口播 → 一期暖纸工作台风口播视频
+
+> **目录约定（2026-10-13 起）**：`materials/` 和 `out/` 按风格分类、风格内从 00 编号，代码里的作品 ID（下文的 `<期>`）不变。下文 `<素材目录>` = `materials/<风格>/<编号-中文短题>/`，`<成片目录>` = `out/` 下同名目录。新一期开工时先建：`bash scripts/ep-dir.sh <期> materials --new <风格目录> <中文短题>`（自动取下一个编号，materials 和 out 一起建）；之后查路径用 `bash scripts/ep-dir.sh <期> materials` / `bash scripts/ep-dir.sh <期> out`。`npm run export -- <期>` 会自动把成片放进 `<成片目录>`。
+> 本 skill 的风格目录是 `07-暖纸工作台风`。
+
+风格配方：`styles/我的风格/暖纸工作台风/README.md`（从一支参考视频蒸馏，参考视频不进 git）；素材包 `src/library/warm-desk/`；口播骨架 `DeskShow`；最小例子 `src/library/previews/WarmDeskShowDemo.tsx`（Studio 里 `library-warm-desk-show`），全部组件一览 `library-warm-desk`，封面 `library-warm-desk-cover`。**真人出镜的样片是 `ep26-opus-video`**（用户认可的版本：左下角出镜小窗、A/B-roll 交替、每个场景一个主视觉），做真人口播时先读它的 `scenes.tsx` 和 `Ep26OpusVideo.tsx`。
+
+这套风格的灵魂：**一张纸、一条步骤线、一个吉祥物**。观众始终知道「现在讲到第几步」（顶部步骤条），每句口播都有一张卡片在桌上发生变化，结论用粗黑体大字 + 朱橙块砸下来。
+
+用户对画面的要求是**丰富、优雅、有设计感**——只摆一张卡片 + 一行字会被说「太素、太单调」。具体做法见下面「画面质量线」和 `references/画面配方.md`。
+
+按第 0～6 步一口气做完，中途不等用户确认，每步做完用一两句话同步进度；第 6 步打开 Studio 后停下，**用户确认后才导出**；不提交 git，除非用户另外要求。动手前先读工程根目录 `CLAUDE.md`、`src/library/README.md`「暖纸工作台风」一节、风格配方卡。所有 npm / npx / node 命令前先 `export NODE_OPTIONS=--max-old-space-size=4096`。
+
+## 依赖（开源版说明）
+
+这个工作流原本串起了作者的几个私人 Skill，仓库里没有带。换成你自己的工具即可，接口只要求「输入文本 / 音频，输出文件」：
+
+| 步骤 | 作者用的私人 Skill | 换成 |
+|---|---|---|
+| 写口播稿 | `weilanx-creator-spoken-script` | 自己写，或让 Agent 按「强钩子开头、句子连贯、不用冒号括号」写 |
+| 配音 | `weilanx-doubao-voice-clone`（豆包复刻音色） | 任何 TTS 或真人录音，输出 wav / mp3 |
+| 字幕 | `weilanx-doubao-voice-srt`（豆包录音识别） | 任何语音识别工具，输出 SRT |
+| 标题 | `dbs-xhs-title`（标题公式库） | 自己起标题，或让 Agent 按「≤ 20 字、留悬念」写 |
+
+真人出镜的 `footage/<期>/host.mp4` 不在仓库里，换成你自己的录像。字幕导入、出片、导出这些工程内的步骤都不依赖上面的私人工具。
+
+## 两种来源
+
+| | 配音口播（默认） | 真人口播（用户给了录好的视频） |
+|---|---|---|
+| 口播 | 第 1～2 步：写稿 → 复刻音色 → 1.2 倍速 | 跳过第 1～2 步，用户的录音就是口播，不加速 |
+| 字幕 | 识别加速后的配音 | 识别原录音（`weilanx-doubao-voice-srt`） |
+| 画面 | 卡片占满主内容区 | 左下角出镜小窗 `HostCam`：A-roll 放大（人是主角）、B-roll 缩小（卡片是主角） |
+| 结构 | 开场钩子 → 摊开过程 → 3～7 步 → 金句 → 关注 | 跟着用户的口播走，同样拆成 开场 / 章节 / 收尾 |
+
+## 规格
+
+| 项 | 默认 |
+|---|---|
+| 画面 | 横屏 1920×1080、30fps，`DeskShow` 骨架，首帧横版封面 `DeskCoverWide`；`decor` 开背景漂浮几何（避开内容区），`push` 默认 2.5% 场景内缓推 |
+| 配色 / 字体 | 唯一强调色朱橙 `#f15a35`（大色块用 `OG` 渐变）；全部阿里巴巴普惠体 3.0（`DF.sans` / `DF.serif` 都指向它，标题 900、字幕 800、卡片 700），本机没装时回落思源黑体 Heavy |
+| 时长 | 2～3 分钟（口播 800～1100 字，加速 1.2 倍后）；用户给了时长或录好了视频，按用户的 |
+| 结构 | 开场钩子 → 「今天把整个过程摊开」→ 3～7 步，每步一个章节大标题 → 收束金句 → 关注卡 |
+| 人声 | **−19 LUFS**（用户嫌 −16 太响），峰值 ≤ −1.5 dBFS |
+| 配乐 | `buildBgm` 合成，`light` / `groove` 为主，**`level: 0.05`**、`depth 0.7`，`DeskShowConfig.bgmVolume: 0.85`（人声 + 配乐合计约 −19 LUFS） |
+| 音效 | 共享音效：卡片落下 `paper` / `pop`，步骤点亮 `ding`，选择 `click`，打字 `type`，揭晓 `magic`，换章 `whoosh`；**音量 0.16–0.26**，宁轻勿重 |
+| 封面 | 3:4 竖版 `DeskCoverTall`（1080×1440，平台单独上传用） |
+
+## 画面质量线（每个场景都要过）
+
+1. **一个主视觉**：每个 B-roll 场景挑一个当主角——信息卡（`props.tsx`：清单、深色终端、表格……）或设计图形（`motifs.tsx`：同心圆、胶片条、图标大卡、流程卡、播放卡、悬念卡、徽章），不要只有一行字。
+2. **一句粗黑体标题**带 `kicker` 小眉标（短橙线 + 灰字），关键词 `〔词〕` 橙块刷入 + 星光。
+3. **层次**：卡片带 `stack` 叠纸或倾斜 ±2°，主视觉旁边放一个辅助元素（标签、胶片条、播放卡、徽章），背景有柔光和漂浮几何。
+4. **动效**：入场都是回弹 + 去模糊（`rise` / `Rise` 已内置），列表从左滑入，图形逐层点亮，挂在 `cw` 的词上；揭晓时 `Sparkle`（放在内容**后面**，DOM 里先画，不然线条压字）。
+5. **不编数据**：缩略图、示意画面用风格配色画极简示意，不放假截图、不编时长和播放量。
+
+## 0. 定期数和目录
+
+- 期号取 `src/episodes/` 里最大的下一个，作品 ID `epNN-英文短名`，下面记作 `<期>`。
+- 素材 `<素材目录>/`，代码 `src/episodes/<期>/`，音频 `public/audio/<期>/`，配乐脚本 `audio/episodes/<期>.mjs`，测试 `tests/episodes/<期>.test.ts`。
+- 选题候选池 `materials/00-公共/选题候选池.md`：开工把那一行改成 🎬，导出后改 ✅ 并填期号。
+
+## 1. 写口播稿（真人口播跳过）
+
+调用 `weilanx-creator-spoken-script` Skill，交代清楚这是「流程拆解」：
+
+- 先抛结果或反差（「你现在看的这条 XX，全是 AI 做的」「我只说了一句话」），再说「今天就把整个过程摊开给你看」。
+- 正文按步骤讲，**步骤名 2～3 个字**（会直接上步骤条和章节标题），每步开头一句「第 N 步」；每步讲：做了什么 → 卡在哪 → 怎么解决的。
+- 结尾一句能当大字的金句（会用橙块高亮其中一个词），再一句关注引导。
+- 存 `<素材目录>/口播稿.txt`（只放能念的正文），回复里贴全文、字数和要核对的事实。
+
+## 2. 配音并加速 1.2 倍（真人口播跳过）
+
+调用 `weilanx-doubao-voice-clone`：
+
+```sh
+python3 scripts/voice.py status
+python3 scripts/voice.py synthesize --text-file <工程>/<素材目录>/口播稿.txt --output <工程>/<素材目录>/<期>-口播-中文标准版.mp3
+ffmpeg -i <素材目录>/<期>-口播-中文标准版.mp3 -filter:a atempo=1.2 -ar 48000 -c:a pcm_s16le <素材目录>/<期>-口播-1.2x.wav
+```
+
+## 3. 转 SRT
+
+调用 `weilanx-doubao-voice-srt`：配音口播识别**已加速**的 `<期>-口播-1.2x.wav`（不要再加速）；真人口播直接识别原录音。用口播稿（有的话）校对用字，每行 6～16 字、去标点。输出 `<素材目录>/字幕.srt` 和 `字幕稿.md`（文件名固定，导出时会复制）。识别和稿子对不上的地方记下来，最后提醒用户去听。
+
+## 4. 建工程
+
+详见 `references/工程模板.md`（文件清单 + 每个文件的模板代码，含真人出镜版）和 `references/画面配方.md`（每类口播内容用哪个组件、主视觉怎么选、版式安全区、节奏和音效）。
+
+1. **人声**：`ebur128` 测响度 → `volume=<增益>dB,alimiter=limit=0.8:level=false` 调到 **−19 LUFS**（±0.5）→ 48kHz 立体声 16-bit → `public/audio/<期>/voice.wav`。真人口播从原视频里抽（`-vn`）。
+2. **出镜视频（真人口播）**：裁成方形、H.264、去音轨 → `public/footage/<期>/host.mp4`（命令见工程模板）；人声只走 `voice.wav`，小窗静音。
+3. **字幕**：`npm run cues -- <素材目录>/字幕.srt src/episodes/<期>/cues.json`；`cues.ts` 里 `VOICE_SECONDS` = 人声时长 + 0.3～0.5 秒，且不短于最后一条字幕结束。
+4. **配乐**：`audio/episodes/<期>.mjs` 写段落表调 `buildBgm({…, level: 0.05})`，只跑 `node audio/episodes/<期>.mjs`。
+5. **场景表**：`src/episodes/<期>/scenes.tsx` 导出 `DeskScene[]`（真人口播再加 `roll: 'A' | 'B'`），每句或每两句口播一个场景，`from = cf(n) − 6`；动画挂 `cf(n)` / `cw(n, '词')`；步骤场景填 `step`，开场和结尾不填（步骤条只在正文出现）；吉祥物表情 `eyes`、跳一下 `hop`、头顶小反应 `emotes` 跟着口播情绪走；每个场景配音效。每个场景过一遍「画面质量线」。
+6. **配置**：`Ep*.tsx` 写 `DeskShowConfig`（`steps`、`cover` 用 `DeskCoverWide` 且 `frames: cf(1) − 5`、`bgmVolume: 0.85`、`decor` 避开内容区）；真人口播加 `overlay`（`HostCam` + `camAt`）、`mascot: {x: 1700, y: 1000, s: 0.75}`。组件接 `mix` 透传给 `DeskShow`（导出分轨要用）。
+7. **竖版封面**：`Cover.tsx` 用 `DeskCoverTall`，在 `Root.tsx` 注册 `<期>-cover-tall` 的 Still，渲染到 `<素材目录>/封面-3x4.png`：`npx remotion still src/index.ts <期>-cover-tall <素材目录>/封面-3x4.png`。
+8. **注册和测试**：`Root.tsx` 注册 `<Composition id="<期>" … defaultProps={{mix: 'all'}}>`；测试照 `references/工程模板.md`（场景按时间递增、步骤号不越界、字幕在时长内、`cw` 的词都在字幕里、音效名存在；真人口播加「小窗始终在左下角」）；`npm run typecheck && npm test`。
+
+## 5. 抽帧自查
+
+- 第 0 帧（封面）、封面淡出那几帧、每个场景 3/4 处各一帧，关键动画中间态（橙块刷到一半、步骤切换那一帧、星光迸发那一帧）也抽；一次只渲一帧：`npx remotion still src/index.ts <期> /tmp/<期>/x.jpg --frame=N --scale=0.5 --timeout=120000`，逐张看。
+- 逐条查 `画面配方.md` 的「自查清单」和上面的「画面质量线」：主视觉有没有、够不够大、星光有没有压字、有没有压到右下角吉祥物区 / 左下角出镜小窗 / 底部字幕区、步骤条是不是跟口播同步、一个画面里是不是只有一种强调色。
+- 发现问题就改，改完再抽帧确认。
+
+## 6. 发布文案 + Studio 预览（然后停下）
+
+- 调用 `dbs-xhs-title` 出标题：主标题 1 个 + 备选 2 个，注明公式编号，含标点不超过 20 字。
+- 描述：钩子一句 → 步骤清单（每步一句做了什么）→ 观众能拿走的做法 → 话题。存 `<素材目录>/发布文案.md`。
+- `lsof -i :3000 -sTCP:LISTEN` 看 Studio 在不在，不在就后台起 `npm run studio`；给 `http://localhost:3000/<期>`。
+- 汇报：字数和时长、人声 / 配乐响度、字幕条数、封面路径、标题和备选、场景表（时间 | A/B | 步骤 | 主视觉）、要核对的事实、TTS 可能读错的地方；**听不到声音要如实说**，只报数字，听感请用户确认。**不要导出**。
+
+## 7. 导出（用户确认后）
+
+`npm run export -- <期>` → `<成片目录>/`：成片（分轨重混限幅）、`stems/`、`封面-3x4.png`、`字幕稿.md`、`发布文案.md`。检查 1920×1080、首帧是封面、约 −19 LUFS、峰值低于 −1 dBFS；成片复制一份到 `<素材目录>/`。
+
+## 收尾登记
+
+- 风格配方卡的期数表补一行，`styles/README.md`「我的风格」表期数栏补上。
+- 新写的通用组件挪进 `src/library/warm-desk/`（信息卡进 `props.tsx`，设计图形进 `motifs.tsx`）并补 `src/library/README.md`。