写分镜（paint-mv-storyboard）

分镜是整支 MV 的设计文件，也是每个章节子代理的任务书。画风固定、内容跟着歌词走：水彩加墨线的绘本画风、 镜头语言和规则都照原作；构思、角色、场景、道具全部从这首歌的歌词里来，每首歌重新设计。

原作的分镜在 pdoom-storyboard.md，动笔前完整读一遍，用它校准野心和细节密度：每一行都是一个 具体、好笑、能一眼看懂的动作，而不是"主角很开心"。但它的舞台剧构思、Clawd、研究员、剧场和计量器都是为那首歌 （一首唱给 AI 的歌）设计的，学它的方法，不要搬它的内容。

输入

• src/song.js（时长、BPM、首拍 offset）、src/lyrics.js（每句起止时间）、assets/analysis.json（每小节响度 bars， 以及 downbeat：小节从哪一拍开始）。
• 歌词本身：讲了什么故事、情绪怎么走、出现了哪些人/动物/物件/地点/梗。原作的每个镜头都是把一句歌词的意思或梗画出来。
• 用户给的方向。没有就用默认方向：每句歌词都有有趣的画面和转场；可爱、卡通、色彩欢快、动画活泼、每个镜头都有事发生、 大胆有野心；少字。

步骤

1 · 分段 → 章节

1. 标出段落：前奏（0 到第一句）、主歌、副歌（重复出现的那组歌词）、桥段、间奏、尾奏。bars 里的响度跳变帮你找段落边界。
2. 一个段落一个章节。太长（> 约 25 s）可以拆，太短（< 约 8 s）并到相邻章节。原作：前奏 1.5 s 并进第 1 章， 四段主歌 + 四段副歌各一章，尾奏一章，共 9 章。
3. 章节边界落在段落开始处（通常是该段第一句歌词的开始，或间奏开始）。章节必须首尾相接铺满 0 到结尾； 最后一章的结束写 DUR + 1。
4. 标出每章第一拍的拍号：n = ceil((start - offset) / beat)，写进歌曲信息表，方便子代理写 B(n)。

2 · 构思（The idea）

从歌词出发找一个贯穿全片的点子：歌在讲什么、情绪怎么走、哪一句最有分量。把歌变成有升级、有反转的故事， 并且首尾呼应：开头和结尾是同一个画面。原作的答案是"一场失控的舞台剧"：以彩绘幕布开场、以同一块幕布收尾， 最后一句 "Was it all for show?" 是反转，镜头拉开，整场末日原来是一出戏。那是那首歌的解法；新歌要找自己的， 分量相当的点子。

写下两条贯穿规则（原作原文的意思，每首歌都适用）：

• 每个镜头都要有事发生：角色做了什么，某样东西坏了、变了、追了、掉了。
• 少字：用画面和表演讲笑话。全片只用少数几个大拟声字，极少用一个短词或符号。不要给东西贴标签、不要说明文字、 不要重复歌词的牌子（卡拉 OK 已经有了）。字多的画面更难看，拿不准就不写。片名如果出现，画进场景里（开场或结尾的画面里）， 不做字幕卡。

3 · 从歌词设计角色

1. 从歌词里找出：唱歌的"我"、被唱给的"你"、歌词点名或暗示的其他人、动物、物件、怪物，以及值得拟人化的抽象概念。
2. 定阵容，宁少勿多：
   • 主角 1–2 个，贯穿全片（通常是"我"和"你"）。可以有成长或变化的弧线（原作的 Clawd 从显示器上的小不点一路长到星球大小， 揭晓时变回可爱尺寸）。
   • 群演：主角造型的变体（换色、戴帽子、缩小），当伴舞、路人、合唱团（原作的小 Clawd 剧团）。
   • 客串：每段主歌从歌词里引出一个，登场一次；构思里有大合影或谢幕时全部回来。
   • 反复出现的象征（可选）：歌词里有"不断加码的东西"或反复的动作时才设，每段副歌升级一次（原作把 "I'm upping my P(doom)" 画成舞台上每段副歌都被打气的温度计）。温度计的样子正合适时用引擎的计量器（SONG.meter）； 否则设计一个专属道具。
3. 每个角色写一份风格简报：是什么、性格、一眼认得出的剪影、主色/暗色/亮色（和调色弧线协调、和背景拉开）、 一两个标志特征、脸（深色缝眼或点眼加奶油色高光、简单的嘴、腮红）、和其他角色的大小关系。画风规则见 paint-mv-animate/characters.md 第 1 节。
4. 引擎自带的 Clawd 和研究员是原作那首歌的演员（歌唱给 AI，"你"是 Claude 的吉祥物，"我"是研究员）。 新歌不要默认沿用，只有歌词确实指向它们（AI、机器人、科研题材）或用户要求时才用。

原作怎么把歌词变成角色（学方法）：

歌词	角色
"sparks of AGI in your eyes"（"你"是 AI）	Clawd：Claude 的吉祥物，方块身体
唱歌的"我"	研究员：白大褂、圆眼镜、乱发
"See through the shoggoth's lies"	戴笑脸面具的多眼果冻怪，面具会滑落
"Sydney, please let me free"	心形眼、带蝴蝶结的粉色 Clawd，把"我"关进心形鸟笼
"Gato, please don't let me go"	"gato" 是猫：长出猫耳猫尾的 Clawd，被激光点分心而松手
"Post-Chinchilla, super-dense"	把 token 塞满腮帮的龙猫

4 · 场景与串联规则（What ties it together）

• **布景而不是卡片。**每章发生在一个地方（从这一章歌词的意象里选），相机在其中移动。建议给副歌定一个"主场景"， 每段副歌回到那里并逐次加码（原作的主场景是剧场舞台：派对 → 焰火和蛇怪 → 回形针洪水 → 红色警报）。
• **有动机的转场。**只在几个章节交界用笔刷擦除（原作 4 处：开场 → 第 1 章，以及每段副歌 → 下一段主歌），写进 SONG.wipes。 其余交界、以及章节内部，都用动作带过切点（原作：大嘴吞掉镜头变黑、火箭、坠落、钻进眼睛、泡泡戳破、炸弹白闪、砸穿地板、摔门）。 可用手法清单见 paint-mv-animate/techniques.md 第 5 节。
• **情绪变形。**角色的脸从不硬切：眼睛挤闭、身体压扁拉伸、弹出一个小符号（汗珠、闪光、爱心、"!"），再睁开新的眼睛。
• **相机。**每个镜头都有推、摇、俯仰、甩、缩放或卡拍震动。
• **调色弧线。**跟着歌的情绪走，每章一个调色（原作：暖奶油与台灯 → 天蓝 → 太空紫与金 → 钢灰与爵士蓝 → 数据中心青 → 警报红 → 回到剧场深红与金）。欢快饱和但柔和。
• **主角要大。**副歌和舞蹈镜头里，领舞的主角约占画面高度 40%。

5 · 镜头表

每章一节：## N · 章节名（start–end）· 场景 · 调色，下面一张表：

时间	歌词	镜头	出
起–止	这句歌词	画面里具体发生什么（谁、做什么、哪里好笑、相机怎么动、哪个动作卡在拍上）	怎么带进下一个镜头（普通切镜写 —）

• 基本上一句歌词一个镜头；超过约 4 s 的句子可以拆成两镜；间奏写成舞蹈或动作镜头（歌词列写 —）。
• 镜头时间用歌词起始时间（或它之前的那一拍），长度 1.4–4 s。
• 镜头写"发生了什么"，并且一眼能懂：一个清晰的焦点动作，大轮廓。镜头内容来自这句歌词的意思或梗。
• 章节最后一镜的"出"必须和下一章第一镜的开场对上（同一种颜色/遮罩/动作）。

6 · 歌曲信息（写在分镜最前面，给子代理看）

时长、BPM、拍长、小节长、首拍 offset 和拍点公式 OFF + n × BEAT、每章的起止时间/第一拍拍号/场景/调色/入场方式、 SONG.wipes、计量器窗口与数值（如果用）、"卡拉 OK 条盖住底部 y≈975–1070"。

7 · 落到项目

1. src/song.js：wipes 填笔刷擦除的章节交界时间。用计量器时 meter 填窗口 [start, end, 起始%, 结束%] （每段副歌一个窗口，数值逐段升级）、meterLabel 填标签；不用就保持 [] 和 ''。窗口内角落会自动出现小计量器， 镜头里画了 meterProp 时自动隐藏。

2. 章节存根：每章建 src/ch/cNN_name.js（NN 两位序号，name 英文小写），先用占位镜头，保证全片能渲染：

   // c02_chorus1: Chorus 1 (23.0–38.5). Rooftop at night, indigo and gold. Storyboard § 2.
   (() => {
     const B = n => OFF + n * BEAT;                       // song time of beat n
     function stub(t) { placeholder(t); }
     chapter('chorus1', 23.0, 38.5, [[23.0, stub]]);
   })();
   

3. studio.html：在 <!-- chapters: ... --> 注释下面按时间顺序每章加一行 <script src="src/ch/cNN_name.js"></script>。

4. 检查：node render.mjs --sheet=<每章中点>,<每个 wipe 时刻> --out=out/check/stubs.jpg，应看到各章占位画面、 擦除转场和卡拉 OK，渲染日志里没有 [page error]。

5. 主要角色和共享场景的代码（src/characters.js、src/sets.js）在下一阶段按 paint-mv-animate/characters.md 实现， 见 paint-mv 第 4 步。

STORYBOARD.md 模板

# 《歌名》：分镜

## 歌曲信息
- 时长 … s · … BPM · 拍长 … s · 小节 … s · 首拍 … s，拍点 = offset + n × beat
- 卡拉 OK 条在有歌词时盖住底部 y≈975–1070
- 笔刷擦除（SONG.wipes）：…；计量器（SONG.meter）：不用 / [start, end, 起始%, 结束%] …

| 章 | 文件 | 时间 | 第一拍 | 场景 | 调色 | 入场 |
|---|---|---|---|---|---|---|

## 构思
…（从歌词来的点子、怎么升级、结尾反转、首尾呼应的画面）

**每个镜头的规则：**有事发生。
**少字：**…

## 角色
| 谁 | 歌词依据 | 造型（风格简报） | 作用与弧线 | 实现 |
|---|---|---|---|---|
| … | "…" | 剪影、主色/暗/亮、标志特征、脸 | … | characters.js `name()` / c03 `CAST.name` |

## 场景与串联规则
- 各章场景 · 副歌主场景 · 反复出现的象征（如有）
- 有动机的转场 · 情绪变形 · 相机 · 调色弧线 · 主角要大

---

## 1 · 章节名（0–…）· 场景 · 调色
| 时间 | 歌词 | 镜头 | 出 |
|---|---|---|---|

交付前自查

• 章节首尾相接铺满全片，边界与 SONG.wipes 一致，最后一章到 DUR + 1
• 构思、角色、场景都能在歌词里找到依据；没有照搬原作的舞台剧、Clawd、研究员、计量器（除非歌词指向或用户要求）
• 每个角色有风格简报；主角 1–2 个、客串每段主歌一个，数量克制
• 每句歌词都有镜头，每个镜头都有具体动作，没有"标签/说明文字"类的字
• 每章一个场景；副歌有主场景并逐次加码
• 每个章节交界都写了"出"，并与下一章开场对上
• 结尾反转与开场首尾呼应
• song.js、章节存根、studio.html 已更新，存根联系表渲染正常