# 超时空要塞：可曾记得爱 WebGL3D 还原

**Repository Path**: az13js/macross-dyrl-3d

## Basic Information

- **Project Name**: 超时空要塞：可曾记得爱 WebGL3D 还原
- **Description**: 让DeepSeek V4.1 Flash根据动画MV，复原《超时空要塞：可曾记得爱》主题曲。代码文件全部0人工，由AI自行实现。仓库不含《超时空要塞：可曾记得爱》剧场版主题曲.mp4文件。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-22
- **Last Updated**: 2026-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 超时空要塞 · 可曾记得爱 — WebGL 3D 还原

把《超时空要塞：可曾记得爱》剧场版主题曲（6:23）用**浏览器内的程序化 3D**重建为一段跟随音乐播放的
音乐影像。

不是逐帧描摹，而是：**分析原片 → 提取主体与配色 → 用代码搭出可复用的 3D 部件 → 编排成分镜时间线 →
对齐到歌曲节拍 → 在浏览器里播放**，并用无头浏览器反复做视觉检验。

> **关于本项目**
>
> 主体代码由 **DeepSeek V4.1 Flash** 生成。诚实说，目前的视觉效果还比较**粗糙**——
> 部件到位了，但审美还没到位：比例、光影、情绪浓度都还在"能跑"而非"好看"的区间。
>
> 这份 README 记录的是**工程过程**（怎么分析、怎么测、怎么调出一个能跑的系统），
> 而不是**艺术结论**。如果有人接手并想把它做到"值得看"，最值得花时间的地方是：
> 配色微调、材质质感、动画节奏的呼吸感、以及每一下闪光和每个部件的入场缓动。
>
> 代码本身是干净的、可测试的、结构清晰的；但"结构清晰"不等于"好看"——
> 它只是一个让人能继续打磨的起点。

```
原片 1920×1080 / 23.976fps / 6:23
   │
   ├─ ffmpeg 场景检测 ──▶ 343 个剪辑点、344 个镜头（中位数 0.25s）
   ├─ 音频分析      ──▶ 109.05 BPM（置信度 0.98）、696 拍
   ├─ 主体裁切      ──▶ 人物 / 标志 / 舞台 / 光斑 / 机械
   └─ 配色聚类      ──▶ 采样色（k-means）+ 目测色（可追溯来源）
                │
                ▼
   22 个精选分镜（覆盖全曲）· 14 个 3D 场景 · 25 个可复用部件
```

---

## 快速开始

```bash
npm install                # 只装 three（已用国内镜像 registry.npmmirror.com）
npm test                   # 299 个单元测试（纯 Node，不需要 GPU）
npm run smoke              # 22 项端到端检查：真实浏览器里跑活页面（需 firefox + geckodriver）
npm run serve              # http://127.0.0.1:8080/web/index.html
```

播放页支持实时调节画质档位、分辨率上限、细节倍率与音频开关。时间轴可拖动。

**URL 即配置**（这让任何一帧都可被精确复现，也是自动化视觉检验的基础）：

| 参数 | 含义 |
| --- | --- |
| `?t=93.4` | 渲染该时刻的单帧后停止（静帧模式） |
| `?shot=closeup` | 渲染该分镜的中点 |
| `?tier=draft` | `draft` / `low` / `medium` / `high` / `ultra` |
| `?w=1280&h=720` | 强制画布尺寸 |
| `?detail=0.6` | 细节倍率 0.1–3 |
| `?maxPixels=230400` | 渲染缓冲像素上限 |
| `?audio=0` `?ui=0` | 关闭音频 / 关闭界面（用于截图） |

---

## 目录结构

```
src/
  core/          纯逻辑，无 DOM / 无 three.js 依赖，全部可单测
    easing.js      缓动、插值、与帧率无关的阻尼
    rng.js         确定性随机（保证同一场景每次生成完全一致）
    timeline.js    分镜时间线、节拍吸附、摄影机采样
    quality.js     画质档位、渲染尺寸解析、自适应分辨率
    palette-data.js 重建配色表（每个色值都标注来源）
    engine.js      WebGL 渲染器与分镜生命周期（唯一有浏览器依赖的模块）
  parts/         可复用 3D 部件（只造几何，不知道分镜与时间）
    kit.js         赛璐璐材质、描边、几何工厂、动画钩子
    stage.js       标志圆盘、聚光灯、舞台
    space.js       金色光斑、星空、地球、星云
    minmay.js      主角（比例表 + 姿势表 + 面部）
    mecha.js       VF-1 女武神、SDF-1 马库罗斯、Regult
    zentradi.js    天顶星战士、生物战舰、巨像
    fx.js          开场递物、能量光束、爆炸、HUD
    interior.js    舰桥、弹射甲板、战术网格
  shots/         编排层
    scenes.js      把部件组合成“有灯光的布景”
    timeline-data.js 22 个分镜的数据、节拍网格
web/             静态站点（无构建步骤，用 importmap 直接跑 ES 模块）
tools/           可复用的 Node 命令行工具（分析任意视频）
scripts/         静态服务器、无头截图、场景探针
test/            299 个单元测试
scripts/smoke.mjs 活页面端到端检查（22 项）
docs/            架构、视觉风格、分镜表、工具说明
skills/          可跨 Agent 复用的技能文档
```

---

## 三层验证，各有一个盲区

| 层 | 命令 | 覆盖 | 盲区 |
| --- | --- | --- | --- |
| 单元测试 | `npm test` | 纯逻辑、几何、时间线、DSP | 看不见 DOM |
| 静帧截图 | `npm run capture` | 渲染结果、构图、配色 | 跑 `?ui=0`，不建控制面板、不走播放 |
| 活页面 smoke | `npm run smoke` | 面板、播放、跳转、画质切换、id 唯一性、控制台 | 不检查画面好不好看 |

补上第三层是因为前两层有一个共同空洞，而一个真实缺陷正好落在里面：
`index.html` 调了 `boot()`，`app.js` 又自动 boot 了一次，应用初始化两遍。第二次把
`getElementById('audio')` 解析成第一次刚注入面板的「Audio」复选框（id 重复，且复选框在文档顺序里更靠前）。
后果不止是点击 Play 抛 `audioEl.play is not a function` —— 复选框的 `paused` 是 `undefined`，
于是第二个渲染循环每帧把 `undefined` 写进节目时钟，**播放和跳转其实完全不动**（`t` 恒为 0）。

当时的临时验证脚本用了 `?audio=0`，恰好绕开了出错分支。
教训：验证脚本的参数不能恰好避开你要验证的代码 —— 现在 `smoke.mjs` 特意开着音频，
并断言「时钟确实前进了」，而不只是「没抛异常」。

## 工具（对任意视频都可复用）

```bash
# 一次性结构分析：元数据 + 剪辑点 + 接触表 + 主体裁切 + 配色 + 节拍
node tools/analyze.mjs "<video>" --out analysis \
  --subject "minmay=13.5,0.45,0.16,0.11,0.14"

# 只取配色：把指定时刻的指定区域做 k-means 聚类
node tools/palette.mjs "<video>" --out analysis/palette \
  --region "hair=13.5,0.45,0.16,0.11,0.14" \
  --region "dress=13.5,0.43,0.50,0.14,0.18"

# 量一个部件：按颜色分类原片像素、按“她本人的身高”换算成厘米，并把分类结果染回
# 画面上（网格线每 0.05 身高一条，一条一个颜色）—— 数字必须能和它描述的那张图对上
node tools/measure.mjs --time 13.5 --region 0.40,0.02,0.24,0.97 \
  --crown 238 --sole 1045 --out analysis/ref

# 看程序化贴图长什么样（脸、机身蒙皮、舰体、甲板、屏显……）
node scripts/textures.mjs --size 320 --only face

# 扫描所有部件，找出"内外翻"的实体（会静默地整个不可见）
node scripts/winding.mjs

# 把一个模型转起来看：借场景的灯光，绕中心点转 N 个视角拼一张图
node scripts/study.mjs --shot macrossWide --around 0,4,12 --radius 60 --views 4

# 或者让它自己去找：不用猜坐标，按名字定位再取景
node scripts/study.mjs --shot battleWide --object regult --pick 1 --views 3

# 无头渲染接触表（视觉检验）
node scripts/capture.mjs --tier draft --w 480 --h 270     # 每个场景一帧
node scripts/capture.mjs --all-shots --tier draft          # 每个分镜一帧
node scripts/capture.mjs --times 3,12,25,40 --tile 400     # 指定时刻

# 自由相机：把镜头怼到模型上，不用往时间轴里塞调试分镜
node scripts/capture.mjs --shot closeup --cam 0,1.45,0.44 --look 0,1.40,0 --w 700 --h 700

# 问渲染器“画面上到底是什么”
node scripts/inspect.mjs --shot closeup --dump
node scripts/inspect.mjs --shot closeup --grid --probe 0,0
```

---

## 细节：不是"更粗糙地神似"

"追求神似"不等于"模型可以糙"。第一版每个部件都是裸图元堆的，看起来像
blockout；现在每个模型都按动画师本人的规则重建，只是执行到位了。

关键在于这台机器上**决定帧率的是 draw call，不是三角形**：

| 手段 | VF-1 战斗机 |
|---|---|
| 合并批次（顶点色） | 22 mesh / 528 tri → 29 mesh / **5284 tri** |
| 程序化贴图 | 蒙皮分件、舱盖框、尾喷口花瓣，零额外几何 |
| `loft` 放样 | 机身、机翼、垂尾、FAST 背包都是真体积 |

细节涨十倍，draw call 几乎不变。契约见 `docs/DETAIL_KIT.md`。

顺带找出了一个从第一版就在的隐形 bug：`taperedBox` 的面表是反的，整个机甲
舰队一直在渲染成**黑色剪影**——不报错、测试全过、截图里看着"像是那么回事"。
`scripts/winding.mjs` 用有符号体积一次就扫出来了。

### 两个模型的返工，以及它们教了什么

**SDF-1 曾经是一块平滑灰板。** 原因不是细节不够，而是两个可以量出来的错误：
贴图元素只有 1.1 px（512 的图铺在 24 单位舰体上，而舰体在画面里只有 150–300 px，
采样落进 mip 2–3 被均值抹平），整张图的值域只有 1.75:1。现在贴图按
「甲板带 / 舷侧带 / 龙骨带」先立值域，所有细部放大到 20–70 px。
同时按实片把舰体改成**深灰**：原片里 SDF-1 是逆光下的近黑剪影，第一版按飞行器
涂装的直觉做成了浅灰，于是它浮在光斑前面像一块浅色板而不是一艘战舰。
舷侧截面从 `sq: 3.3` 改到 `sq: 6.2` ——`sq` 的刻度是反直觉的，
3.3 的截面角点只比正圆远 14%，那就是一根管子。

**交接镜头的两只手曾经是两团棕色肉块。** 手指半径 0.031、间距 0.069，
只有 0.007 的缝，而且没有任何墨线，四根手指因此融成一块板；
所有测试都通过，因为每个 `finger0..3` 对象都在。现在指缝有顶点间距断言守住，
墨线用 `outlineTree` 补上，肤色也按实片拉开成浅桃与棕褐两档。

两件事都不是"再多加点细节"能解决的。这也是 `scripts/study.mjs` 存在的原因：
修模型需要一个能把它转起来看的工具，而 `capture` 只回答"这个镜头成立吗"。

### 第三个隐形 bug：端盖是反的

`loft` 在 `axis: 'z'` 时两端的盖子朝内，所以项目里每一个 `axis: 'z'` 放样体
都缺两个面。它躲过了所有检查，因为**体积是全曲面的和**：端盖贡献的不是 0，
而是**负的**那一份，实体总的有符号体积仍然是**正的** —— 而 `winding.mjs`
当时的判据就是"正数即朝外"。同一根圆柱，`axis: 'y'` 量出包围盒的 0.780，
`axis: 'z'` 量出 0.260，正确答案是 0.785。

现在 `orientationErrors()` 逐件数"同向重复的有向边"：闭合且一致定向的曲面上
每条边恰好被遍历两次且方向相反，某一片翻转后它的边会在同一方向上重复。
这是局部判据，与体积无关。检查挂在 `setPieceValidator()` 上、发生在**合并之前**，
因为合并后的批次是若干独立实体的并集，杆件在节点处的重合顶点会造成大量假阳性。

## 设计取舍

**神似优先于形似。** 手绘赛璐璐和 3D 渲染的成像方式不同，逐像素对齐只会得到一个别扭的模型。
所以这里复刻的是**动画师的规则**而不是画面：6.5 头身、以眼睛为主的脸、把头发画成几块大色块并加一道
硬高光、用反向外壳描边。凡是继续加细节只会掉进恐怖谷的地方就停手。

**344 个镜头不逐个还原。** 原片的碎切是为了拼接手绘原画，不是为了被复刻。这里用 22 个精选分镜覆盖
全曲，保留原作的情绪弧线：递物 → 标志升起 → 她开口 → 机库揭示 → 女武神出击 → 天顶星 → 舰上演唱会
→ 决战 → 尾声。

**分镜是数据，部件是代码。** 一个分镜就是一个普通对象（用哪个场景、摄影机怎么走、姿势怎么变），
不含 three.js 对象、不含闭包。正因如此，整条剪辑结构可以在 Node 里断言：无缝隙、单调、
每个边界都落在节拍上。

**颜色要有出处。** `src/core/palette-data.js` 里每个色值都标注 `sampled`（ffmpeg 裁切 + k-means 采样）
或 `estimated`（目测），并写明来源。没有一个是凭空编的。

详见 [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)、[`docs/VISUAL_STYLE.md`](docs/VISUAL_STYLE.md)、
[`docs/SHOT_LIST.md`](docs/SHOT_LIST.md)、[`docs/TOOLING.md`](docs/TOOLING.md)。

---

## 验证状态

四层验证，各自盲区不同，最后一层是这一轮补上的：

| 层 | 命令 | 现在的结果 |
| --- | --- | --- |
| 单元测试 | `npm test` | **419 通过 / 0 失败** |
| 真实页面冒烟 | `npm run smoke` | **22/22 通过** |
| 绕序扫描 | `node scripts/winding.mjs --detail 1/3/4` | 三个档位都**没有内外翻、没有反向面片** |
| 画面 | `node scripts/capture.mjs --all-shots --tier medium` | **22/22 分镜**全部渲染 |

另外几件为「看清楚」而造的工具：

* `scripts/study.mjs` —— 把单个模型转起来看。**明美「从每个角度看都还行」这件事，
  是靠它才第一次成立的**：之前只有正面一个机位，而她是秃的。
* `scripts/inspect.mjs --find` —— 量主体在画面里占多大。一次 22 分镜扫描当场抓出
  两个没人量过的取景 bug。
* `tools/facegrid.mjs` —— 把人脸参考帧、实拍渲染、`paintFace()` 纹理并排归一化到
  同一个人脸框。它把「感觉哪里不对」变成「0.28 对 0.44」。这一轮中庭偏长、眼睛偏小
  两个结论都是它给的数。
* `scripts/textures.mjs --only eyeSurface` / `--only hairSurface` —— 单独看睫毛占多少、
  虹膜多大、高光带画在哪一行。改画家之前先看纹理，比渲染一帧再猜快得多。
* `analysis/faceprobe.mjs <png> <y> <x0> <x1>` —— 读**渲染出来的**像素，并算「周边 / 中央」
  的亮度比。贴图上的 0.82 到屏幕上会变成 0.93（toon 分档 + 光照把一个值压平），
  所以「脸是平的」只能在渲染上量。
* `analysis/mouthprobe.mjs` —— 对着嘴打一条射线，**报出第一个面的名字**。嘴里有唇、墨线、
  腔体、内唇四层，一张渲染图分不清那块深色是谁；这个工具直接说是谁。
* `analysis/facebox.mjs` —— 在脸框里找**暗色连通块**，按脸框比例报出每块的包围盒。它的第一条
  结论就推翻了一个假设：实片的「最大连续皮肤块」是从**眉毛下面**开始的（刘海和眉毛把皮肤
  切碎了），所以拿它当归一化基准会把眼睛放到框顶。
* `analysis/fringeprobe.mjs` —— 把一帧里的一条横带按明度切成「发 / 皮肤」，报出发绺的
  **根数、宽度、皮肤缝宽**和发梢的错落深度，并打一份 ASCII 图。**按色相切是切不动的**：
  受光的发绺是蓝的、背光的是近黑的，而刘海底下的额头是一块暖褐 —— 色相测试在一片
  有十来根发丝的刘海上只找到两根。

### 明美的脸：从「贴上去」到「做出来」

要求是明确的：**不要只是弄个贴图，要有形状**。原先整张脸只活在 `paintFace()` 里，
而贴图只改颜色不改形状 —— 正脸看着对，一转到侧面就是一张印上去的面具。

| 现在的做法 | 承担什么 |
| --- | --- |
| `sculptSkull()` 顶点位移 | 眼窝、眉弓、鼻梁与鼻头、苹果肌、唇丘、下巴 |
| `resampleSkull()` | 10 行剖面 → 28 段；网格必须比它承载的特征更细，否则每个特征渲染成一块硬边多面体 |
| `symmetriseNormals()` | `computeVertexNormals` 按面积加权，而四边形的对角线镜像后不保持 —— 中线法线因此偏 0.09，脸上出现一条不存在的折痕 |
| `eyeDomeGeometry()` + 眼睑 | 眼睛是实体，才有轮廓和高光；画上去的眼睛一转头就滑到脸颊上 |
| 上下唇 `tube` | 4–6 mm 的起伏，让嘴有唇线和唇间的折痕 |

眼窝、眉弓这些是**对颅骨表面的偏离**，所以用位移做：没有接缝、不 z-fighting、不花 draw call。
鼻子和嘴唇需要自己的轮廓，所以是真几何体。

### 明美：头发的高光带一直没画出来

动画头发上那条硬边高光，在这个项目里是一块平铺的 `ribbon` —— 而它**从加进去那天起
就没有在任何一张图里出现过**。它位于头顶接近水平的地方，平铺的条带从平视角度是侧面朝前、
面积为零。它一直在场景图里，所以清单数得到，只有眼睛看得出它不在。

现在是**凸起 + 贴图**两样：发罩轮廓上的一段径向凸起（形状），加一张带子的贴图
（颜色）。带子只跨正面，且贴在按**归一化高度**重写过的 `v` 上。

**由此抓到的大 bug**：贴图被乘了两次 —— 头发渲染出来是 `#1c4f92` 的平方，
实测 (0,6,33)，而受光的基础色应该是 (26,66,122)。脸材质上早就写着这条注释，
下一个带贴图的材质照样踩了 —— 所以现在有一条测试盯着它。

> 这里的「带子」在近景第七轮被推翻了：带子这个模型本身就会在某个角度只剩一个端面可见。
> 现在画的是颅顶的一块**软场**，理由与四次失败都记在同一节的注释里（见「近景第七轮」）。

### 明美：身体这一轮才有人管

脸做了五轮，裙子、手臂、腿一轮都没有。转一圈看，问题很集中：

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 裙子是个**灯罩** | `ruffle` 的褶深只有 `depth: 0.1`，也就是 ±5% 的涟漪 —— 够打断一条高光，不够成形 | `depth: 0.26`（±13%），并把下摆半径按褶深缩小，让**褶峰**落在实测轮廓上 |
| 裙子是**从膝盖以下全是靴子** | 小腿那一段整段用的 `bootMat` | 小腿是皮肤，靴筒是另做的一段，从腿肚中间往下 —— 参考里是**光腿 + 中筒靴** |
| 脚踝上有一圈**皮肤缝** | 靴筒到 -0.35 结束，踝关节在 -0.385 | 靴筒盖过踝关节；浅色滚边从脚踝移到**靴口** |
| 肩是**方的**，像垫肩 | 袖子 `sq: 2.05` 加 7 瓣扇贝边 | `sq: 1.8`，去掉扇贝边 —— 泡泡袖是个软圆顶 |
| 脖子像**一根杆** | 上一轮为了近景把它收到 0.029 | 0.032 |

顺带把 draw call 从 110 压到 **104**：耳朵（参考里根本看不见，渲染里也看不见）删掉，
鼻孔合成一笔，四条裙摆滚边合成一笔。这个预算是硬的 —— 软件渲染上 draw call 就是帧时间。

### 明美：嘴和鼻孔也是形状了

上一轮把脸做成了形体，还剩两处是贴图：

* **唱歌的嘴**是一块平面，上面画着张开的嘴，靠 beat 缩放淡入。嘴是个洞 —— 洞有深度、
  有暗的内部、有会掉下去的下唇。现在上唇固定、下唇**平移**下落、中间露出暗色口腔，
  里头有牙齿和舌头。（踩坑记录：下唇挂在铰链下方，绕铰链**旋转只能让它上升**。）
* **鼻孔**画上去就是两个点。现在是鼻底后面两个不受光的小坑，从下往上看不再是空的。

### 明美这一轮改了什么

浏览器里看近景体验不好，于是从八个角度转着看了一遍。查出来的问题按严重程度：

| 问题 | 根因 | 表现 |
| --- | --- | --- |
| 除正面外**整个头是秃的** | 发罩是 `top`→`hem` 的**直线弦**，在凸面上落在颅骨**里面**；而且忽略了颅骨截面的 `oz` 后移 | 六个角度全是光头顶 |
| 后脑一整块**纯黑** | 反向外壳描边在薄壳上会画出壳的**内表面**，而发罩顶上有个 2 cm 的洞 | 帽檐似的墨色盖住后脑（颜色正好是 `#0a0d14`） |
| 眼睛**包到头两侧** | UV 的 `u` 沿**角度**线性，投影到屏幕是 `sin`，15% 处画的特征渲染在 26% | 「眼睛像护目镜」 |
| 脸部**没有下巴** | 头是光滑椭球；且脖子只有 0.06 长，**下巴低于肩线** | 脸像一块板，头是搁在胸口的球 |
| 头发是**青绿色** | 早期取样区把头发和橄榄色背景平均到了一起 | 识别特征错了 |
| 脸侧两条**黑线** | `hairFall` 比发罩宽 10 mm，它的描边外壳从壳里顶出来 | 近景最刺眼的瑕疵 |
| 特写**切掉眼睛** | 头整体抬高 0.12 后，分镜机位还盯着旧的 y=1.34 | 画面里只有下巴、脖子和肩膀 |
| 收尾镜头一块**钢架挡在她前面** | 灯光桁架直径 6.2、高 24，退到 21 单位必然隔着它看 | 全片最后一个画面是格子 |

顺带修正的两个**数值**错误：裙子实测是身高的 **0.36**，不是之前记录的 0.58；
原来的 0.88 单位下摆让她在远景里像一座婚礼蛋糕。`docs/TOOLING.md` 与
`docs/DETAIL_KIT.md` 里记了每个坑的判据。

### 明美：这一轮从「有形状」做到「看得出是一张脸」

**嘴有两个**是这一轮的起点。上一轮把嘴做成了腔体，但脸皮上那张**画出来的嘴线**
还在原地：贴图不会跟着下巴动，所以 beat 一落，建模的下唇往下走、画上去的笑线不动，
于是她同时有两张嘴 —— 上面一张宽 grin，下面一张小嘴，中间露着口腔和舌头。

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| **两张嘴** | 嘴线是贴图，下唇是几何：两者永不可能同步 | 嘴线是几何（一根深色细管），**挂在上唇**那一半 —— 动的只有下唇，这正是 cel 嘴的画法 |
| **嘴永远张不开** | 颅骨是**闭合曲面**：放在它后面的「口腔」隔着一堵不透明的墙，下唇落下只露出更多皮肤 | `sculptSkull` 在嘴上挖了一个 **8 mm 深的凹坑**，口腔放进凹坑里。闭合时嘴唇盖住坑口，张开时坑口就是那张暗色的嘴 |
| **下巴太长、鼻子太靠下** | `FACE_LAYOUT` 的 `nose/mouth` 沿用了早期目测值 | 用放大到同一人脸框的实片比对（`tools/facegrid.mjs`）：片子是鼻 0.42 / 嘴 0.60，模型是 0.50 / 0.80 —— 中庭长了三分之一。现在 0.50 / 0.645 |
| 脸侧两条**像皱纹的斜线** | 两道 2 px 墨线画在**脸颊中段**（下颌线该在轮廓上，不在面中） | 删掉，换成两片柔和的下颌阴影 |
| 额头上一道**发箍** | 高光带画在 `v=0.27`（靠近头顶）且两半在正面接缝处留了 13% 的空档 | 降到 `v=0.33`，两半在接缝处同高同厚连成一条，脊高从 4.2 mm 减到 2.6 mm |
| 刘海像**梳子** | 五片 25–35 mm 宽的三角板，还各自带一层锯齿 | 十一条 8–15 mm 的**细长发绺**（`blade` 八点带弧度、尖端两点），发际线改成正弦波 |
| 眼睛**小且分得太开** | 每只 29% 脸宽、间距 31%，是玩偶的比例 | 每只 34% 脸宽、间距 14%（实片比例）；虹膜填满眼裂、睫毛是**上眼睑**的一条厚边，下眼睑只留一丝 |
| 眼下一道**眼袋** | 上下眼睑的半径给反了：厚的那条画在**下缘** | 上睑厚、下睑薄，且上睑抬到睫毛**上方**当褶皱 |
| 近景**肤色发闷** | 场景 key 1.02：物理光照下漫反射要除以 π，1.0 的 key 只给出约三分之一的 albedo；实测 `#d4bda4` 渲染成 `#a0785a` | key 提到 1.62，脸回到调色板本身的值 |
| 侧发是**两块直板** | 七段 loft，最宽 5 cm，底端平切 | 沿曲线扫出的**锥形发绺**，脸颊处外扩、发梢收到尖端；半径压在 0.022 以内，否则内缘会盖住脸颊 |

三个能复用的判据，都写进了测试：

* **量间隙要在同一站（同一个 `x`）上量。** 下唇包围盒的**顶**来自它抬起的嘴角，
  而嘴线包围盒的**底**来自它下凹的中点 —— 用包围盒比会读出一个并不存在的 5 mm 缝，
  照着「修」就把嘴在每一帧都张开 5 mm。这个坑在同一轮里踩了两次，现在测试逐点比。
* **`tube` 的 `squash` 缩放的是**高度**。** 环是 `normal*cos + binormal*sin*squash`，
  水平路径的 `normal` 就是脸的 `z`：`r` 是唇的**突出量**，`r*squash` 才是唇的**高度**。
  历次都取 `squash < 1`（比高更厚的珠子），所以嘴唇盖不住自己的凹坑 —— 只有把唇
  做对形状，嘴才可能闭上。
* **画家的输出要能看。** `scripts/textures.mjs` 现在也能预览 `hairSurface` 和
  `eyeSurface`：睫毛占多少、虹膜多大，看纹理比看渲染快一个数量级。

### 明美：这一轮修的是侧面和背面 —— 以及一个被忽略的比例

上一轮的整改都发生在**正面**：嘴、眼、刘海。这一轮一开始把镜头绕到背后，问题就换了：

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 长发是一块**黑板** | 整块头发是**一个 loft**：两条垂直的边、一条水平的底边，五片平板贴在上面也没救 —— **剪影就是物体本身**，表面细节改变不了它 | 改成**五束锥形发绺**：各有长度、外撇与后飘，前短后长、参差收尾，底下留一层薄基座填缝。四张连续图（发梢高度差 > 5 cm）由测试守着 |
| 背后一道**蝴蝶结** | 高光是一条平贴的 `ribbon`。发绺是**五条各自鼓起**的曲面，一条平板不可能同时贴合五条 —— 陷进这条、浮出那条，露出来的是板子的形状 | 高光**画进发绺**：`paintHairSurface` 增加 `ring` 模式（横向铺满整张图 = 绕发绺一圈），每束自带，不花 draw call、不会 z-fighting |
| 侧发像两只**猪尾巴** | 发绺起点在发罩**外面** 1.5 cm，顶端圆帽悬在空中 | 位置改成**推导值**：发罩最宽处是 `skullRadiusAt(y).rx + inflate`（y=0.02 时 0.1025），所以发绺挂在 `FACE_HALF_WIDTH + 0.004` 就始终在壳内，只在鬓角下摆（y=-0.05）以下才露出来 —— 侧发本来就该从这里出现 |
| 脖子**长了一倍**（近景的第三个画面都是脖子） | 早期「没有脖子」的修正**过头**：下巴抬到肩线上方 14 cm，是 0.6 个头 | 按实片量：下巴到领口 = **0.145 个头**（3.4 cm）。改过头两次（0.09 太短、0.35 太长），所以现在**由测试守这个比值**，不再靠眼睛 |
| 下颌**又宽又重** | 嘴的高度上还保留着颧骨的 89% 宽度（实片是 75%），下巴 77%（实片 58%） | 按实片收窄中下段；下巴那一行**不动** —— 收它得到的是尖 V，不是柔和的 U |
| 裙子像**婚礼蛋糕** | 裙子半径是按 1.69 单位的身高量的；脖子一改，人矮了 6 cm，同样的绝对尺寸就相对大了 4% —— 正是实片 0.39 与渲染 0.44 的差 | 收一档并抬高下摆 3 cm，露出实片里那段小腿 |

近景里另外三处「没有形体」的地方，也在这一轮补上：鼻子只有一片弱wash（现在是明确的
鼻头 + 鼻底阴影 + 一侧的投影 + 更深的鼻孔），人中补了一道淡影；上唇从突出 2 mm 收到
1.4 mm —— 2 mm 时唇峰正对 key 光，toon 材质的最亮一档直接过曝，嘴上出现一条**白带**。

顺带修掉的两个取景问题：`closeup` / `finaleClose` 的机位原本盯着旧的头高（y=1.47 / 1.43），
头一降低就会切掉头顶 —— 两个机位按新的头心（1.41 / 1.37）重新对准。

**这一轮最值钱的一条经验**，是「镜头要绕着看」这件事本身：上一轮八个角度拍的是**头**，
这一轮拍的是**头发背面**和**整个人**，两次拍到的是完全不同的问题。

### 明美：这一轮修的是「身体」，也就是那些没人量过绝对尺寸的地方

前两轮都在头脸。这一轮量身体，抓到的问题几乎都是**形状对、尺寸错**——单个部件看着都合理，
整体却是错的：

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 手只有**一半大** | 手掌 3.2 cm + 手指 4.4 cm = 7.6 cm 的手，放在 162 cm 的人身上；实片里她按麦克风的手**几乎和脸一样长** | 按「腕到指尖 ≈ 脸长」重建：掌 6.5、指 5.5、拇指 4.5 cm（13 cm）。**手小是最响的「人偶」信号**，而它在任何单件尺寸上都看不出来 |
| 手腕一圈**黑带** | 手挂在肘下 -0.2，而前臂的 loft 到 -0.19 就结束 —— 4 mm 的缝；前臂带反向外壳描边，**描边是放大的副本**，副本没被下一个部件盖住的地方就会印出来 | 手掌向上**插进**前臂 2 cm，缝没了，外壳的边缘也被盖住 |
| 腰上的**蝴蝶结在背后** | 建模时放在 `z = -0.096`（背侧），本片没有任何一个机位看得见它；而实片里它是整身服装上**最大**的一件饰物（13.5 s 参考帧里约 16 cm 宽） | 挪到右胯前方，改成「两个斜向环 + 结 + 两条垂尾」——原来两片平板侧对 sash，渲染出来像贴了个口袋 |
| 裙摆的**碎方块** | 每个裙层的下摆是 ±13% 的褶，而饰边是一条**等半径的圆环**：圆环在褶峰之内、褶谷之外，只在两者恰好相等的地方冒出来 | 饰边改成**同 lobes / 同 depth / 同相位的 ruffle**，整体比裙层外 3% —— 现在是连续的扇贝饰边 |
| 拇指像**尖刺** | 旋转角让它直着横伸出去 | 转向前方、贴着掌面 |

三条新测试守的是**位置和比值**，而不是「好不好看」：手长 / 脸长 ∈ [0.45, 0.75]；
饰边半径的起伏 > 8%（圆环会被这一条抓住）；蝴蝶结 `z > 0.06` 且在某一侧胯上、宽度 > 12 cm。
这类量正是前面几轮反复改错的量：单件看着对，整体不对。

### 明美：这一轮把「衣服上的花纹」从几何搬回贴图，并修掉三处印出来的描边

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 胸前像一只**紫色的蛾子** | 珠子 0.016 半径又按 y 拉 1.25 = 3.2×4 cm，在胸像近景里占掉五分之一件胸衣；两条 1.8 cm 的细吊带正好成了它的两只翅膀 | 珠子收到 1.5 cm 的圆宝石，吊带加宽到 2.4 cm（**布带**才能让人看出胸衣是「被吊住」的），蝴蝶结挪到宝石**下方**并改用紫色（原来在宝石正后方，完全被挡住；改白色后又成了两块纸片） |
| 胸衣上两道**黑色短横** | `waist` 与 `pelvis` 都在衣服**里面**，却各自带反向外壳描边 —— 描边是放大的副本，副本没被外衣盖住的地方就印出来 | 从描边清单里删掉这两件：剪影由胸衣和裙子承担，衣服下面的身体不需要墨线 |
| 裙摆上一排**碎方块／虚线** | 饰边做成几何，错了两次：等半径圆环只在半径恰好相等处露出（十个方块）；换成同相位 ruffle 后仍然断成虚线，因为**裙层本身是向下外扩的，而饰边不是**，两个面在中途相交 | 饰边从来就不是一个独立物体 —— 实片里它是缝在下摆上的一条布。现在**画进裙层贴图**（`loft` 的 `v` 是截面参数、`ruffle` 从下摆往上建，所以 `v=0` 就是下摆，对应纹理第 0 行）。不会 z-fighting、不会被自己所在的布挡住、**省掉一次 draw call** |
| 眼里两滴**白色泪珠** | 高光半径是虹膜的 0.3，越过睫毛顶到眼白上；另外眼白在外眼角露出一大块，而实片那里是睫毛 | 高光收到 0.21 并移进虹膜上三分之一（第三个最弱的直接删掉）；虹膜整体向外移一点，睫毛的眼尾wing 加长盖住外眼角 |
| 刘海正中一个**「M」形缺口** | 发绺半宽 6–8 mm、间距 13 mm，刚好相切不相交，每个缝都是一块露出的额头 | 全部加宽三分之一，相邻发绺互相叠压；发尾该分开的地方仍然分开 |

`paintCloth` 那条经验值得单独记：**位置能算就不要猜**（`v=0` 是哪一端是能从 `loft` 与 `ruffle` 的约定推出来的），
而**花纹能画就不要建几何** —— 一条缝在布上的饰带，建出来就一定会和它所在的布打架。

### 明美：靴子是一双脚，不是一个锥筒 —— 顺带量出一个低了 4.5 cm 的裙摆

上一轮末尾记着「靴子和脚只是两根粉色管子」。这一轮先量再改，量出来的比预想的多。

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 脚是**两块漂在旁边的椭圆**，和靴筒完全断开 | 脚建在 `footY + 0.028` 并沿 **-z** 铺开 —— 踝关节**上方** 2.8 cm、朝**后**。放样出来的形状是对的，位置全错 | 脚沿 **+z** 从脚跟铺到脚尖，长 20 cm（身高的 12%），脚踝柱高 7.2 cm，**鞋底落在 y = 0** |
| 鞋底**悬空一厘米** | 位置由 `-shinLen` 推，而 `shinLen = P.knee - P.ankle` 用的是**名义**膝高 0.46，链条里实际落在 0.45 | 由链条推导：`floorY = -(P.hip - 0.04 - thighLen)`。远景看不见、近景一眼看见 —— **能算的不要猜** |
| 靴筒是一根**等锥度的管子** | 没有靴口，也没有脚踝 | 靴口做成**翻折**：顶部截面藏在腿里（半径 0.0245 < 小腿的 0.027，端盖埋在腿内所以印不出来），往下鼓到 0.033 再收到 0.024。靴口 / 小腿 = 1.24，实片量出来 1.25 |
| 正面看**脚不像脚** | 脚朝正前方时长度被完全透视压缩，剩下一个桩 | 五个姿势的髋关节加 `TOE_OUT = 0.3`（约 17°）外八。实片每个表演帧都是外八站姿 —— 而这是**姿势**，不是几何 |
| 裙摆**低了 4.5 cm** | 上一轮已经「抬高 3 cm」，但抬到 45.5 cm；同一帧量两次都说 52 cm（腰下 0.49 单位，或身高的 0.32） | 只动最下一层的下摆（`-0.43 → -0.385`）。露出来的小腿从 21 cm 回到 27 cm —— 这一段正是实片留白最多的地方 |

顺带把靴子加进描边清单（`bootShaft*` / `bootFoot*`）：靴子的「形」几乎全在边缘上 —— 靴口、
脚踝、脚尖 —— 而在此之前它一条墨线都没有。四个外壳换来的是近景里一条真正的轮廓线
（draw call 净减 2，明美 103）。

**这一轮最值钱的不是靴子，是量具。** 第一版测量脚本把橄榄色的舞台地板判成了「皮肤」
（r-g 39、g-b 11 正好落在皮肤的阈值里），于是画面里最宽的那条「腿」是背景板。第二版按行只打印
一个 x 区间，把**两只靴子合并成了一只 11.6 cm 宽、比她大腿还粗的靴子**。第三版做两件事：
按**连通段**打印，并把分类结果**染回画面上**（`tools/measure.mjs` 写出的 mask 图，网格线按身高的 0.05
一条、每条一个颜色）—— 数字必须能和它描述的那张图对上。两次错误都表现得像一张合理的表格。

### 明美：近景的第一轮 —— 把「嘴」从一道标记改回一张嘴

目标里最硬的一条是「近景要好看」。用 `scripts/study.mjs` 把她转八个角度、再单看嘴和眼，
问题最集中的地方是**脸**，而脸里最坏的是**嘴**：

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 嘴是一道**品红色的涂抹** | 宽度是脸宽的 **0.29**（实片 105.5s 是 0.20）。两个 9 mm 高的嘴唇盖不住一个 88% 宽的暗腔，于是墨线、暗腔、牙各自露出来，在 40 cm 处读成一撇品红加几块暗红碎屑 | `mouthHalfW` 0.145 → **0.10**（脸宽的 0.20）；腔体收到 76% 宽、更浅、再后退 1 mm；牙片收到半宽并压暗（`#efe9dd` → `#d6ccbd`） |
| 墨线是**脸上最亮的东西** | `lipLine` 是 `#8a3f48` —— 在一个「淡肤 + 灰粉」的调色板里，玫瑰色的一条线是下半张脸最亮的值，读起来像**画在脸上**而不是**脸上的一道褶** | 再暗一档到 `#5a2730`，并写明它是「比 lip 低两个值」 |
| 下唇和上唇一个颜色 | 实片里上唇是皮肤 + 墨线，**下唇**才带颜色；这个不对称正是「一张嘴」而不是「一道缝加一根条」的来源 | 下唇改用 `minmay.lip` |

新测试守的是比值：嘴宽 / 脸宽 ∈ [0.16, 0.25]（实片 0.20）。

### 明美：近景第二轮 —— 眼睛的「圆窗」和脸颊的「一整片平面」

同一批近景暴露的问题按影响排序，这一轮动前两条：

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 眼睛像一个**又高又圆的窗**，四周一圈有棱角的肤色环 | 眼**本身**的尺寸和形状是对的（6.3 × 4.3 cm 的杏仁，和实片 1.4:1 一致）；错的是**眼睑圈** —— 它在眼睛上弧之上抬了 `0.3 × 半高`（≈7 mm）、半径 2.1→3.3 mm，横向还放大到 1.06 倍：等于在眼睛外面又套了一个更圆的眼睛。而 `seg(ctx, 8, 4)` 让这条弧成了多边形，「环」的棱角就来自这里 | 眼睑改成**一条贴着睫毛的窄褶**：抬 0.12 半高、厚 1.7 mm、横向 1.04，分段 8 → 14。眼睛回到杏仁 |
| 眼球**鼓在脸外面** | 穹顶顶点 = 边框 + 0.26 × 半高 = 脸上方 4.7 mm，而眼窝才凹 6 mm —— 眼是**搁**在脸上的球，不是嵌进去的画 | 穹顶 0.26 → **0.16** 半高（顶点 2.4 mm，约等于眼睑厚度），眼窝自己的阴影负责剩下的事 |
| 脸颊**是一整片平面** | `sculptSkull` 的特征表里全是**能叫出名字**的东西（眼窝、眉骨、鼻梁、卧蚕、嘴、下巴），它们**之间**的区域留给原始椭球 —— 1/4 侧面因此从鼻子到耳朵一路平滑地转过去，像一张印了五官的面具 | 补三对场：**颧骨** +3.8 mm（面框 0.34 处、眼睛外半侧下方）、**颧下凹** −2.2 mm（0.55）、**下颌棱** +2.2 mm（0.80）。量级按这张表的尺度来：鼻子才 7.5 mm |

| 脸上有一块块**直角浅色斑**（近景最显眼的一处） | 先排除：贴图干净（512×640 放大看全是软wash）、本项目**从不投影**（`preset.shadows` 没人读）、像素探针指着 `skull` 本身。真因是 **toon 分档边界落在过大的四边形上**：颅骨 28×44 的分段在 18.5 cm 的头上是 5×6 mm 一格，近景里就是 20 px，几乎平的颧骨上「一整格一起跨档」，边就是直的 | 颅骨分段 28×44 → **48×64**（一格约 2.5 mm）。方块消失，分档边界变成曲线；三角数增加不影响预算（预算是 draw call，这是一个网格） |

顺带发现：穹顶的**厚度**和它的**凸起**原本是同一个数（`−0.7d`），于是「把眼睛压平贴脸」会同时把它压成一张纸，
侧面一转轮廓就消失 —— 测试以正确的理由失败了。现在厚度由半高定（后框放在 `−(d + 0.17h)`，总厚 0.49h），
前面平、后面仍是个实体。

**还没完，而且我知道下一步该动哪里。**

1. ✅ 眼睛的尺寸/凸出 —— 第 1 轮改完。
2. ✅ 脸颊的体积 —— 第 1 轮补了三对场；1/4 侧面仍偏平，下一轮继续加。
3. ✅ 脸上的直角浅色块 —— 第 2 轮定位为分档+粗网格，加密颅骨解决。
   **脸上的浅色块清掉了，但脸本身一直是「一个色」** —— 第 9 轮量出来：外颊比脸中央还亮（1.03），
   等于没有受光/暗面之分；现在 0.82，见「近景第九轮」。
4. ✅ 鼻子 —— 第 3 轮：补上鼻头高光（原先**三个阴影、零高光**），鼻孔从两颗暗球缩到实片的三分之一。
5. ✅ 嘴 —— 第 3 轮补鼻头/鼻孔，第 5、6 轮把上下唇咬合、唇线中段不再加粗。
6. ✅ 头发的硬边与色块 —— 第 7 轮，见下。

### 明美：近景第七、八轮 —— 头发的高光不是一条带子，发片也不是一块板

这一轮的起点是上一轮交接下来的那张诊断，而诊断本身错了一半：**问题不在「带子被发片切断」**，
在于「带子」这个模型从一开始就是错的。

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 3/4 后视角下，头顶浮着一块**有直边的亮片** | 高光画成 `v` 方向的带子、`u` 方向在太阳穴附近**收成一个尖**。从 yaw 150 看过去，这条带子唯一可见的部分就是它的**尖端** —— 一块躺在大片头发中间、四周没有过渡的亮斑。凡是带尖的形状都会被读成「贴上去的东西」，位置摆得再对也一样 | 高光改成**颅顶的一块软场**（`Raster.wash`，无边界）：正面最亮、向两侧与脑后连续衰减。没有端点，就没有能被侧看的边 |
| 侧后方看到的**矩形色块** | 同一件事的另一面：这条带子的两端是直的 | 同上；软场在 `u` 上是连续的 |
| 背面是一个**直边的大拱**：两侧是竖直线，宽处有一个硬角 | 长发的发片 `PROFILE` 在 `t = 0.12…0.68` 之间把 `kr` 保持在 1.0→1.06→0.94 —— 它在**自身长度的七成里一直保持满宽**，只在最后 30% 收成一个尖。五片并排，轮廓就是五条平行竖线加五个硬角；这是一块「带尖的板」 | 改成**叶子形**：最宽点在 `t = 0.3`，之后单调收窄（0.75 处 0.60、0.9 处 0.32）。轮廓从拱变成束 |

**四条带子都没成，第五条更糟 —— 全记在 `paintHairSurface` 的注释里**：
①`v` 方向的整环（绕到后脑勺的一圈）；②两个以 u=0.14/0.86 为中心的闭合块，中间那 13% 的空档正是**额头正中**，
读成「挖了个缺口」的发箍；③两半在接缝处相接、到太阳穴收成尖（就是上线的那一版，被 3/4 视角抓住）；
④把带子做成 `u` 方向周期、彻底没有端点 —— 这一条是**最糟的**：等宽等高、连续绕头一圈，就是**发箍**，
转盘四个角度同时看到一顶头冠。实片 104 s 的侧脸画的根本不是带子，是**颅顶偏前的一大片软渐变**，
三面都没有边界。所以第五版直接画场。

**软的也有软的坑，而且踩了两次。** 第一次把场放在 `bandV − 0.09`（发际线上方 4.8 cm 的颅顶），
正面**完全看不见** —— 那个高度朝上，3 档 toon 把它压到最暗的一档，贴图里的亮色乘上最暗档还是暗色；
第二次在场下缘加了一道**描出来的细月牙**（实片确实有这道硬边），它让 `u` 方向的最大相邻列亮度差到了 **12.8 级** ——
和第三条带子的尖是同一个毛病，只是小一个数量级。月牙删掉，硬边交给 toon 分档：软场过三档 ramp 本来就会自己长出边，
而且长在正确的高度上。

两条修复各有一个测试守着，而且都验证过**能抓住旧版本**：

- `the hair sheen is a field on the crown with no edge to see edge-on` —— 把整圈的「高光量」拉成一条曲线，
  要求接缝两侧（`u` 首尾列）差 < 6、**任意相邻列**差 < 6、正面比背面亮 20 以上、峰值 > 50。
  旧的收尖带子在这里是 **46 级**的断崖。
- `each lock of the hair fall tapers...` —— 量的是发片**自身**的半厚（`(max−min)/2`，不是 `max|x|`；
  后者会把 `ox` 外张算进宽度，最外那片就会在半径只剩 0.65 时报 0.83），要求 `t=0.7` 处不超过最宽处的 0.75、
  `t=0.98` 处不超过 0.25。旧的板子在 `t=0.7` 是 **0.86**。

**这一轮没做完的**：高光目前只在发罩上，而**刘海与侧发是另外的网格**（`hairMat`，没有贴图），
所以颅顶那片亮区到发际线就停了 —— 实片里它是一直盖到刘海上的。

### 明美：近景第八轮 —— 把高光接到刘海上去，以及「机械上一样」不等于「看起来一样」

上一轮留下的那条：颅顶的软场到发际线就没了，下面挂着一排深色发片，而实片里的高光**一直盖到刘海上**。

接到刘海上有两个障碍，一个大一个小：

| 障碍 | 根因 | 现在 |
| --- | --- | --- |
| 发片根本没有可用的 UV | `blade()` 用 `ExtrudeGeometry`，它的 `WorldUVGenerator` 把形状**自身的 x/y（世界单位）**直接写进 `uv`。3 cm 的刀片因此只用到贴图的 3%，再配上 `RepeatWrapping`，等于「每一单位长度铺一张」——第一次给发片挂贴图，发片上下出现了**十一条纹** | 新增 `boxUVs(geo)`：按包围盒把 `uv` 归一化到 0..1，`v` 沿**向下**（`DataTexture` 的 `flipY = false`，所以栅格第 0 行就是 `v = 0`，与 `faceV` 的约定一致） |
| 发罩的 `v` 是「颅骨上的高度」，发片的 `v` 是「刀片自身的长」 | 两者不是同一个轴，共用一张贴图只会把高光放到「刀片恰好开始的地方」 | 新增 `paintHairTip`：同一件事换个坐标读 —— **高光在根部**（`v = 0` 最亮，`v ≈ 0.55` 回到基色，尖端进深色 wash）。`wash` 的圆心放在贴图**上边界之外**，整张图因此是单调的，不会在中间长出第二条高光边 |

**然后又踩了一个「机械上一样」的坑。** 侧发是 `tube`，它的 `v` 也是沿路径从根部往下 ——
和刀片情形**完全一样**，所以我顺手也给它挂上了。渲染里它变成一条**贴着下巴的浅色长条**：
发绺上半段整个落在高光色上，而它后面的长发是暗的，眼睛抓到的就是这条发绺的轮廓。
实片里鬓角垂下来的那一绺是头上**最暗**的一大块（刘海的投影里）。所以侧发**留在平的 `hairMat`**，
理由写在代码里 —— 这一条同样由测试守着（断言侧发材质**没有** `map`）。

工具也跟着补了：`scripts/textures.mjs --only hairTip` 现在能单独看这张 32×96 的衰减图。

### 明美：近景第九轮 —— 那张脸是**一层平涂**，不是一块平面

近景里最刺眼的一处不是某个五官，是**整张脸只有一个色**。这一轮先把它量出来，再改。

**量具**：把 `paintFace` 画进一张 256×320 的 `Raster`，直接读像素，按「周边 / 中央」的亮度比说话。
改之前的结果是 ——

| 位置 | 与脸中央的亮度比 |
| --- | --- |
| 外颊 | **1.031** |
| 太阳穴 | 1.017 |
| 下颌侧 | 0.969 |

**外面比中间还亮**，所以脸上根本不存在「受光面 / 暗面」的分界，一整张脸是一块平面。
根因有两条，第二条是这一轮真正学到的：

1. **太阳穴那对场画在贴图外面**：圆心 `x = -0.04W` 和 `1.04W`、半径 `0.28W`，走到 0.13W 的颊上
   已经花掉三分之二，再乘 0.58 强度和 1.2 的 `power`，剩下一声耳语。
2. **腮红把那片阴影又稀释回去了。** `wash` 累加的是**加权平均颜色**：腮红和阴影场重叠时，
   它不是「给阴影加暖」而是「把阴影拉回腮红色」。所以太阳穴那一点无论把阴影场推到多强
   都亮着 **5 级** —— 场早就饱和了（`k = min(1, a)`），再加权重买到的是颜色不是明度。
   腮红因此缩小、减弱、挪开：它是一块**颊上的斑**，不是半张脸的底色。

**目标值是实片自己给的**，不是口味：105.5 s 侧过脸的那一帧，暗面在红通道是亮面的 **0.78**、
绿通道 **0.70**。正面比侧脸温和，所以测试卡在 **0.86**，而现在三个位置是 0.823 / 0.830 / 0.852。
同一条测试还要求**下巴仍是下半脸最亮的地方**（0.013 高于中央，否则下颌场会把整个下半脸吃掉），
以及**贴图上不能出现硬边** —— 相邻列最大跳变 < 8 级。第二条是防着「下一轮直接描一条线」：
这道折痕在历史上去掉过一次（见 `paintFace` 里那段「下颌是阴影不是描线」），
一个 19 岁的人被两条从鼻翼到下巴的线画成 40 岁。

### 明美：近景第十轮 —— 边界是**画出来的**，但要画成「侧平面」，不是画成一圈

第九轮结束时留下的那句：色阶有了，**边界还是软场自己长出来的形状**。这一轮把它换成一条明确的曲线。

做法照抄刘海阴影的成例：软场继续负责**明度**，`poly` 负责**边**。曲线从实片正面近景读出来 ——
从发际的太阳穴出发，贴着外眼角（眼睛自己的框是 `eyeCentre ± eyeHalfW` = 0.07…0.41，边界走它的内侧），
在颧骨下方收进来、到嘴的高度，再放出去到下颌角。

**第一版画错了，而且渲染一看就知道错在哪：** 曲线绕过了下巴，于是脸的四周闭合成**一圈**阴影，
中间那块亮面变成圈里的一个圆斑 —— 那张图读起来是**络腮胡**。赛璐璐的脸是每侧一块**侧平面**，
下巴下面是另一块更软的场（`H * 1.04` 那道 wash 就是干这个的），不是一整圈轮廓线。
曲线因此停在下颌角。

软场顺带全部回撤（太阳穴 1→0.6、外颊 0.8→0.5、下颌 1→0.6、颏下 1→0.7），把主明度让给多边形 ——
否则饱和的软场已经把外侧压到暗色，再叠一个同色的多边形，**边上一点变化都没有**，
第一次量出来最大跳变只有 **1.6 级**。

测试也跟着换了一种问法。第九轮那条是「贴图上不许有硬边」，它防的是「直接描一条线」，
但**边界本来就该是个跳变**，所以那条断言在正确的实现上必然失败。现在问的是**边在哪**：

| 面框位置 | 曲线给的 u | 量到的 u | 跳变 |
| --- | --- | --- | --- |
| 0.34 | 0.175 | 0.174 | 7.8 级 |
| 0.48 | 0.135 | 0.135 | 9.8 级 |
| 0.62 | 0.155 | 0.154 | 10.1 级 |
| 0.78 | 0.225 | 0.240 | 9.8 级 |

跳变**两头都卡**：小于 4 级说明根本没有边，大于 30 级说明那是墨线 ——
而横过凸起脸颊的一条墨线，正是这个函数里删过一次、把 19 岁画成 40 岁的那道折痕。
再加一条位置不变式：**0.90 处必须没有边**（跳变 < 5 级），也就是「停在下颌角」这件事本身。

### 明美：近景第十一轮 —— 脸颊**确实**有起伏，但下颌那一段是一条直线（以及一次没做成的修改）

清单上剩的第一条是「1/4 侧脸的脸颊几何体积」。这一轮先造量具，再决定动不动。

**量具**：在**脸颊自己的方位角**（正面偏左 42°）上，逐环取颅骨顶点的法线倾角与半径。
关键是「自己的方位角」——颧骨场在 x ≈ 0.055 处，而**环上最宽的那一点是头的侧面**（x ≈ 0.0926），
在那里量，有没有颧骨都是同一条单调曲线。

量出来的结构：

| 环 | y（头局部） | 法线倾角 | 半径 |
| --- | --- | --- | --- |
| 颧骨 | -0.0131 | +17.8° | 0.0972 |
| 颧下凹 | -0.0448 | −23.7° | 0.0928 |
| 下颌棱 | -0.0830 | −25.5° | 0.0769 |

**颧骨 → 颧下凹：32 mm 里转了 41.6°，半径差 4.4 mm。**这一对是**真的**，不是椭球自己的曲率。
**颧下凹 → 下颌棱：38 mm 里只转了 1.7°** —— 也就是说下半张脸从颧下凹到下巴是**一条直线**，
而那正是 3/4 视角看的那一块。

**所以试了一改：下颌棱 2.2 mm → 4.2 mm。**结果量具**不认**：半径只从 0.0769 动到 0.0780（+1.1 mm），
转角从 −1.7° 变成 −0.4°（更平）。**量具不认的改动就不提交** —— 已回滚（`git checkout src/parts/minmay.js`），
这一条留在清单上，并且这次留下的是一个**能证伪的量具**，而不是又一次猜测。

留下来的是一条新测试：在同一个方位角上，**颧骨必须让表面转过 30° 以上、必须比颧下凹高 3 mm 以上、
并且必须在它上面**。这三条守住的是前面几轮补的那三对场 —— 在此之前，
`test/parts.test.js` 里的二面角测试只给**粗糙度**设了上界，把脸重新磨回椭球**照样全绿**。

### 明美：近景第十二轮 —— 把嘴放到 4 倍镜下，然后**没有**提交改动

最后一轮清单上剩的第二条是「嘴的上唇读不出来」。这一轮把它放到 4 倍最近邻放大镜下，
和我们自己的渲染并排看 —— 于是问题**不是**上唇，是下半部分：

| | 实片（105.5 s 正脸，张嘴唱） | 我们（`finaleClose` 的近景机位） |
| --- | --- | --- |
| 上缘 | 一条有轻微弓形的墨线，**两端有角勾** | 有，形状也对 |
| 墨线下 | 一条**浅色上齿**带横过开口 | 无 |
| 开口内 | 深栗色内壁 | 有，但**是个菱形**，下尖 |
| 下唇 | **红色在开口内**，上界是深色内壁、下界是皮肤，**到不了嘴角** | 一道**横贯整个嘴宽的红条**，两端尖、中下有个缺口 —— 读起来是**领结** |

也就是说：红的那块**不是**「开口里的下唇内面」，而是**挂在开口下面的一根横杆**。
嘴角在实片里是归墨线的。

**试着把下唇两端从 0.96 收到 0.84**（让它不到嘴角）。渲染**几乎没变化** ——
说明那片红主要不是下唇管的端头，而是被深色腔体从中间遮住之后**露在两侧**的另一块面。
**量不出效果的改动就不提交**，已 `git checkout` 回滚。这条留在清单上，并且这次留下的是
「红块的身份是什么」这个问题，而不是一个猜错的参数。

**（与第十一轮同一条规矩：量具不认 / 渲染不认的改动一律回滚。两轮各留下一个被证伪的假设，
这件事本身比两次「看起来好点了」有用。）**

### 明美：近景第十三轮 —— 眼睛是**一团深色**，红在开口**里面**，脸是**两个面**

这一轮的起点不是清单，是一句「还是不太美」和一篇讲 2D 转 3D 的通论（`analysis/temp.txt`）。
通论里能用在**已经有模型**的人身上的只有三条：**眼珠是灵魂**、**脸上的阴影要当图形画**、
**五官是画在脸上的所以要服从同一套底片**。于是这一轮先把「美不美」换成三个能量的量，
再去动它们 —— 三个量各配一个**能抓住旧版本**的测试。

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 眼睛是一颗**玻璃珠**：淡蓝的虹膜 + 一颗大白球 | `minmay.eye` 是早期目测的 `#2f6f8f`，而画家又在虹膜下半混了 66% 的 `#d8f8ff`。把一只眼放大到像素级（105.5 s 与 106 s），实片画的是**一团近乎全黑的虹膜**，两颗高光**在下半**而不是贴在睫毛下，虹膜的颜色只在**下缘一道月牙**上看得出来 | 虹膜体 `#123b3f`（近黑），下缘 `#3f9f86` 的月牙，瞳孔占虹膜 0.46，两颗高光落在下内侧，睫毛加厚三分之一。**`stris` 删掉** —— 那是给球体编的纹理，在这个尺度上只是在给那团黑起毛 |
| 下唇是**一根红条**挂在嘴下面 | 上一轮留下的问题（「红块的身份是什么」）在这里有了答案：实片里**外面那层下唇是皮肤**，粉色是**开口里面的下唇内面**。模型把这两件事**装反了** | 外下唇改用皮肤材质（与上唇同一个 `material` 实例），粉色作为**开口内的下唇内面**加进口腔批次。**闭合时它在唇的后面（射线打不到），张开时它是射线穿过开口打到的第一个面** —— 测试就是这么写的，不是比坐标 |
| 上下唇是**两个鼓包**（近景读成「小胡子」） | 唇是 3 mm 高、9 mm 宽的管：足够盖住洞，也足够**接住主光**，于是上唇成了一块受光的丘 | 半径 3 mm → 1.6 mm、`squash` 1.5 → 2.8。**高度一个毫米没动**（盖住空腔、张开的 9 mm 全靠它），动的只是**凸起** —— 唇变成一张宽而平的形，墨线仍是唇间那道最前的线 |
| 脸上的阴影**只在四周**，中间是一整片 | 边场全是「脸颊、太阳穴、下颌」这一路**周边**阴影 —— 那是「正面打光的头」的模型，不是这个角色的。实片 105.5 s 的正脸是**两个面**：下半张脸（颊、下巴、鼻梁）是亮面，**整块上半脸**（额头、两个眼窝、颧骨）是一整片暖色，边界从太阳穴起、从每只眼睛下面走过、贴着鼻子两侧上来、越过鼻梁 | 新增一条**画出来的边界**（`BOUNDARY` 表），下半是亮面、上半是暖面；鼻梁正中是一道**亮脊**（边界在中间抬高，正是实片的样子）。鼻子同步收小：上一版把它加强成了一条从眼睛拖到嘴的**污渍**，现在是**三个互不相邻的小标记**（鼻侧、鼻下、鼻头一点光） |
| 近景的肤色**发橙发暗** | **调色板是从「已经打过光的画面」里取的**，而场景的主光又是暖奶油 `#ffe9c4` —— 暖色被叠了两次。渲染像素实测：颊部 (183,148,111)，是采样肤色 `#d4bda4` 的 **0.86 / 0.78 / 0.68**，而实片自己受光的颊是 (210,195,171) | 主光改成近白 `#fffdf7`、强度 1.62 → **2.25**：颊部落到 (203,174,145)（0.96 / 0.92 / 0.88），**色相回来了**，橙味没了。轮廓光**仍然是暖的** —— 那是 1980 年代演唱会的样子，而且它长在剪影上、不长在脸上。这条由一个**算辐照度**的测试守着：打到正脸的光必须接近中性，且总量落在 1.6–2.6 |

**量具是这一轮真正留下的东西**，因为「不美」本身不是能改的东西：

* `analysis/faceprobe.mjs` —— 把**渲染出来的像素**按行读出来，并算出「周边 / 中央」的亮度比。
  在这之前，第九、十轮量的一直是**贴图**（0.82），而屏幕上看到的是贴图 × toon 分档 × 光照：
  渲染实测 **0.93**，也就是说「脸是平的」这件事在贴图上根本量不到。改完是 **0.845**，
  实片自己的暗面是 0.78 / 0.70，正面脸没有侧脸那么极端 —— 这正是第十轮那条测试的取值理由。
* `analysis/mouthprobe.mjs` —— 从正面打一条射线进嘴，**报出第一个面的名字**。上一轮「红块的身份」
  之所以猜错两次，就是因为渲染出来的深色图形分不清是腔体、内唇还是阴影；现在它报的是
  `mouthRoot/lowerJaw/lowerLip@+35.5mm` 这种能直接读的答案。
* `tools/facegrid.mjs --image` —— 把实片和**我们的渲染**归一到同一个脸框并排（`analysis/r1_grid4.png`）。
  上一条通论说「要补 45 度、仰视、低头」，这张图先补上了**同一角度、同一比例**这一条：
  鼻子的位置一对就发现两张脸其实是齐的（0.42 / 0.42），偏的是**值**，不是**位置**。

**这一轮没做完的，以及下一轮该动哪里：**

1. **刘海还是锯齿。** 十一条发绺是**等宽**的三角板，边缘是直的；实片的刘海是**粗细不一、
   尖端错落**的细发丝（`analysis/ref/zoom_face_135.png`）。这是脸上最后一块「不像手绘」的地方，
   而且它是**形状**问题，不是贴图问题 —— 按第七、八轮的路子，得先给 `blade()` 一张
   **沿长度变化的宽度表**。
2. **眉毛仍然缺席。** 实片里眉毛从刘海缝隙里露出来（`analysis/ref/zoom_eyes_106.png` 里看得很清楚），
   而现在脸上一根都没有。它要画在 `paintFace` 上（是画，不是几何），位置在眼睛上缘与发际之间 ——
   而那个区间现在只有 0.01 个脸高，所以这件事**必须和刘海一起做**。
3. **上半脸那条边界还是偏「带子」。** 实片的边界是绕着每只眼睛的曲线，我们的是一条基本等高的线。
   测试只钉住了「眼睛下面是 0.30–0.50、鼻梁比它高 0.03」这两件事，中间的形状还是自由的
   —— 下一轮把它读成一条真正的曲线（每只眼睛包一圈）。

### 明美：近景第十四轮 —— 刘海是**一层暗色**，而它由**值不同的发绺**构成

上一轮留下的头一条是「刘海还是锯齿」。这一轮先给它造量具，再造结论 —— 而量出来的第一件事
是**上一轮的判断只说对了一半**。

**量具**：`analysis/fringeprobe.mjs`。它把一帧里的一条横带按**明度**切成「发 / 皮肤」
（按色相切是不行的：受光的发绺是蓝的，背光的是近黑的，而刘海底下的额头是一块暖褐色 ——
色相测试在一片有十来根发丝的刘海上只找到两根），逐行给出**发绺的根数、每根多宽、皮肤缝多宽**，
再给一份 ASCII 的图，最后统计发梢的**错落深度**。

| 量到的东西 | 实片（105.5 s，`analysis/ref/frame1055.png`） | 我们 |
| --- | --- | --- |
| 越过额头的发绺 | 每 137 mm 内 5–6 根，即**每 23–27 mm 一根** | 11 根在 136 mm 上，**每 13.6 mm 一根** |
| 单根宽度 | **3–20 mm，多数 5–14 mm** | `w` 是**半**宽 7.8–11 mm = **16–22 mm 宽** |
| 发梢的错落 | 30–60 mm（有的到眉毛，有的刚到发际） | 14 mm |
| 发色 | 冠 `#03488f`（亮蓝）、**刘海 `#0a1c32` 与 `#1b0605`（近黑藏青）**、后发 `#071c3d` | 刘海渲染出来 **L 61–80**，而发罩是 94–105 |

也就是说：**代码的注释里写着「实片是 8–14 mm 的窄发绺」，表里填的却是 7.8–11 mm 的「半宽」**
—— 一半的量纲错，戴了整整七轮。而比宽度更响的是**值**：实片的刘海是头上最暗的东西，
我们的是一层中等蓝，「布褶」这个读法主要来自这里。

| 问题 | 根因 | 现在 |
| --- | --- | --- |
| 刘海是一层**中等蓝的布褶** | `paintHairTip` 是照第八轮那张 104 s 的帧写的（那一帧高光铺满可见发量），于是把冠上的高光**接到发绺上**。105.5 s 一量：冠是 `#03488f`、发绺是 `#0a1c32`／`#1b0605` —— 两者**不是同一个值** | 发绺底色改 `minmay.hairShadow` 再往亮蓝混五分之一；**高光留在发罩上**，也就是实片放它的地方 |
| 两根发绺**交叉之后就并成一根** | 十一条发绺共用一个材质：没有墨线、也没有值差，眼睛没有东西可以把它们分开 | 第二条材质（同一张 `paintHairTip` 从更暗的底色画，**不是**在贴图上再乘一次色），表里四根标 `deep: true` 作底层 |
| 发梢是**三角形的**，不是发丝 | 轮廓在 68% 处还留着 87% 的宽度，最后 32% 收成尖 —— 第七轮给长发发片改过同样的毛病（「一块带尖的板」→ 叶子形），刘海没跟上 | 改成**叶子形**：最宽点在 28%，之后单调收窄到尖 |
| 侧面看刘海是**一块黑板** | 发绺是 **11 mm 厚**的挤出体，还站在发罩自己的半径上（比额头高 1 cm） | 厚度 11 → **5 mm**，位置往头心收 7%；侧脸里它从一块板变成一条贴额的暗色锯齿 |
| 头顶一排**黑斑** | 发绺的顶端往上伸 18 mm，越过了颅骨收窄的高度，于是从发罩里**顶出来** | 顶端从 +12 mm 收到 +4 mm |

**还有一条改动没提交。** 顺着「冠太亮」想到去改发罩贴图的暗场（半径 0.5H → 0.58H、
强度 0.72 → 0.95），渲染出来**逐像素比对最大只差 14 级、平均 0.35 级** —— 在这个机位上
等于没有。按第十二轮那条规矩（量不出的改动不提交）已 `git checkout` 回滚，理由写在这里：
**发罩前端在这个高度上落在贴图的 `v < 0.33`，也就是「冠」而不是「刘海」，那里本来就不该暗。**

**测试换了一种问法。** 第八轮那条「刘海把冠上的高光带下来」现在问的是**值的关系**：
发绺贴图的平均明度必须低于发罩的 0.75 倍（实片的冠/刘海比就是这个量级），
并且发绺材质必须**多于一种**（一根发绺和另一根同值时，交叉就看不见了）。
UV 盒、侧发不带贴图这两条旧断言原样保留 —— 它们守的是别的东西。

**这一轮没做完的：**

1. **发绺还不够「细」。** 宽度从 16–22 mm 收到了 11–20 mm，实片是 5–14 mm。真正要动的是
   **根数**（11 → 14–16）和**倾向**（实片的发绺从头顶的发旋往外斜，我们的十一根全是垂直的）。
   这一轮试过 10 根窄发绺，渲染出来是「蓝尖牙」—— 原因是窄发绺在发际处就分开了缝，
   而实片是**上密下疏**（发根互相压着，只有下段才分开）。下一轮要把「上密」做成
   沿长度的宽度表，而不是靠加宽根部。
2. **眉毛仍然缺席**（上一轮的清单第二条），而刘海一改，眼睛上缘到发际之间那 0.01 个脸高
   更没有位置了 —— 它要等第 1 条把刘海的下缘做出疏密之后才能插进去。
3. 上半脸那条边界仍是「带子」（上一轮清单第三条），这一轮没动。

### 明美：近景第十五轮 —— 发绺是**两种尺寸**，而暗面边界**绕着每只眼睛**

上一轮的清单第一条（发绺要更细）和第三条（上半脸边界还是「带子」）在这一轮一起动了。
两条都用同一套办法：先在实片上量出结构，再让几何或贴图去复现那个结构。

**刘海**：上一轮把发绺从 16–22 mm 收到 11–20 mm，但**根数没动**（11 根 / 136 mm）。
把实片的图逐行读出来（`analysis/fringeprobe.mjs` 的 ASCII 图）之后，结构其实是**两种尺寸**：

| 行 | 实片 | 现在 |
| --- | --- | --- |
| 发际下方（y 282） | 10–42 mm 的**块**，缝只有 3–10 mm（几乎是实的） | 根宽 19 mm、间距 9–19 mm —— **发际是一条实带** |
| 往下三分之一（y 312） | 5–25 mm 的发绺，缝 11–30 mm | 体宽 8 mm / 细丝 3.6 mm，缝 7–22 mm |
| 底部 | 长短错落 30–60 mm | 长锁 38–40 mm、细丝 16–24 mm |

所以这一轮的做法是：**14 根发绺分两种尺寸**（8 根 11.6 mm 的宽锁 + 6 根 4.8 mm 的细丝），
两根宽锁之间**留两处空位**（x −0.023 与 +0.033，都不在正中 —— 第一版把空位留在正中，
渲染出来是一个「美人尖」缺口），并且**根部的宽度一直保持到发际下方 6 mm 才收**。
最后这一条是关键：上一轮把收窄写成「自身长度的百分比」，短发绺还没到发际就已经收完了，
于是发际处全是缝 —— 那版渲染出来是五颗蓝尖牙。

**上半脸的暗面**：上一轮的边界表是一条从太阳穴平着升到鼻梁的折线（五个点），
渲染出来是一条**斜带**。实片的边界是一条有**转折**的曲线：从太阳穴进来、在眼睛外半边
下面压到最低、到内眼角**急转向上**，正是这个转折把眼窝围起来。现在是十个点 + `catmullRom`
平滑（折线的九个拐角在这个尺度上会被读成**脸颊上的折痕** —— 和当初删掉那两道墨线是同一个毛病）。

**渲染上量到的效果**（`analysis/faceprobe.mjs`）：颊部的「周边 / 中央」比从上一轮的
**0.845** 落到 **0.810**（R 0.893 / G 0.776），实片自己是 0.78 / 0.70。

**这一轮改掉了一条测试的「问法」，而它之前问错了东西。** 上一轮的
「上半脸是第二个面」那条测试，在一条竖列里找**向下**的最大跳变，把它当成「眼睛下面的边界」——
而阴影面从上面进入时才是向下跳，**离开它的下边界是向上跳**。它实际量到的是**周边平面**
在 f≈0.38 的那条边，正好落在断言的 0.30–0.50 里，于是**测试通过而描述的形状是错的**。
现在量的是向上跳（下边界），并且加了一条「额头必须属于这个面」。同时周边平面那条测试
的扫描起点从画面正中改到 u = 0.3 —— 新的鼻侧转折在 u≈0.35 处产生了一条**合法**的值跳变，
从正中扫过去会先撞上它。

**这一轮没能做成的一件事，值得记下来：眉毛。** 实片里眉毛在刘海缝隙里露出来（`analysis/ref/
zoom_eyes_106.png`），位置在**脸框的 v ≈ 0.0–0.08**。为此写了 `analysis/facebox.mjs`
（在脸框里找暗色连通块，按脸框比例报出每块的框），它给出的第一条结论就推翻了原来的想法：
**实片的「最大连续皮肤块」是从眉毛下面开始的** —— 刘海和眉毛把皮肤切碎了，所以那个框本身
不能用来定位。真正卡住的地方是几何：我们的上眼睑（`upperLid`）顶到脸框的 v ≈ 0.00，
眼睛上缘到发际之间**一个毫米都不剩**。要给眉毛位置，就得把眼睛往下挪（实片的眼睛中心在
「颅顶到下巴」的 0.40，我们是 0.43 —— 也就是说往下挪 3% 个头高**同时更接近实片**），
但那会动 `FACE_LAYOUT` 与所有依赖它的测试，所以留作下一轮的第一件事。

### 明美：近景第十六轮 —— 嘴是一道线，不是一块**石膏**（以及一次渲染上量不到的眉毛实验）

上一轮结尾说下一轮的第一件事是眉毛。这一轮先做了那个实验，**它失败了，而且失败得很有信息量**；
失败之后剩下的一半时间用来修一个在最近几张近景里越来越刺眼的东西：嘴。

**先说嘴。** 把嘴放到 800 px 下量：唇在渲染里是 **L 181–182**，而紧挨着它的皮肤是 **169–177** ——
**一块比周围亮 5–12 级的、形状规整的补丁**。在近景里这不是「嘴唇」，是**贴在脸上的一块石膏**，
中间再穿一道墨线。根因是两条：

1. **唇是凸的、而且离脸 1.6 mm** —— 凸起正对主光，toon 分档把它放进最亮一档，而它周围的脸
   （带着画上去的人中与下唇阴影）低一档；
2. **它是 `minmay.skin` 本身**，也就是说没有任何东西去抵消这一档。

改法是把两件事分开守：**高度**（盖住空腔、决定下颌 9 mm 落下时开口多大）一个毫米不动，
**凸起**从 1.6 mm 收到 1.1 mm（`squash` 2.8 → 4.1），墨线同步从 1.2/2.6 mm 收到 0.9/1.7 mm；
唇的材质改成**皮肤的半色调**（往 `skinShadow` 混 22%）。改完唇是 **172–173**，周围 169–174 ——
补丁没了，嘴回到「一道线 + 一层很浅的唇形」。新测试分开断言这两个量：
**覆盖 > 7 mm 且凸起 < 2.5 mm**。

**踩到的坑（值得记）**：`mixColor()` 返回的是 **sRGB 字节数组 `[r,g,b,a]`**，而
`THREE.Color.set()` **不认数组** —— 它静默不动。第一次改完渲染**逐像素完全一致**，
打印材质颜色才发现还是 `#d4bda4`。材质颜色要走 `setRGB(r/255, g/255, b/255, SRGBColorSpace)`
（仓库里 `detail.js` 的 vertex-colour 路径就是这么写的）。

**再说眉毛：三次渲染，两次逐像素零差异。**

上一轮的结论是「要眉毛就得把眼睛往下挪」。这一轮照做了：`eyeMid` 0.16 → 0.19，
再在 `paintFace` 里画一对眉（位置 f −0.014…0.016、墨色取实片采样的 `#050001`/`#bd6847` 的暖黑）。
渲染出来**一对眉只看得见两三段碎屑**，像被谁划了两道。把眉加粗 50%、加深，再渲染 ——
**整帧逐像素最大差 0、平均 0**：那就是说，改的那点东西**一个像素都没有出现**。

于是去量它为什么没出现：眉画在贴图的 f −0.014…0.016，而贴图的 **f = 0 就是发际线** ——
眉有一半在发际线以上（那里被发帽盖着），另一半正好落在**刘海的根部**上。
而第十五轮为了让发际「是一条实带」，把发绺根部放宽到 19 mm、并且**一直保持到发际下方 6 mm** ——
那条实带正好压住眉毛唯一能存在的那 3 mm。

对照实片的同一份图（`analysis/fringeprobe.mjs`）：实片的发际是**密而不封**的 ——
10–42 mm 的块之间**留着 3–10 mm 的皮肤缝**，眉毛就是从那些缝里露出来的
（`analysis/ref/zoom_eyes_106.png` 里看得很清楚：发丝**压在**眉毛上，眉毛在缝里断开）。
我们的发际是**封死**的，所以眉毛不是「画得不对」，是**没有地方可露**。

**结论与下一轮的做法**：眉毛与「发际是一条实带」这两个要求**直接冲突**，出路是让发际
**密而不封**（3–8 mm 的窄缝，而不是现在的 0）。这一轮试过把细发丝的根部收窄去开缝，
缝是开了，但眉的位置仍被宽锁的根部盖着 —— 需要的是**把缝放在眉的正上方**（按眉的 x 定位），
这是下一轮的第一件事。这次的实验已 `git checkout` 回滚（渲染上量不到），只留下这条结论。

### 明美：近景第十七轮 —— 发际**密而不封**，中庭按**眼睛**而不是发际量

上一轮留下的两件事：眉毛要有地方露（发际现在是封死的），以及脸看着还长。这一轮两件都动了，
一件成了、一件**量出了它为什么成不了**。

**发际开缝。** 第十五轮为了让发际「是一条实带」，把发绺根部放宽到 2.4 倍（19–28 mm）——
效果是有，但那是一堵**墙**。实片的同一份图里，发际是**密而不封**的：10–42 mm 的块之间
留着 3–10 mm 皮肤缝（`analysis/fringeprobe.mjs`）。发绺的**体宽**本来就已经是 19 mm 间距上的
11.6 mm 宽锁，所以根部只要 15% 的外扩，缝就自然出现 —— 不需要加宽根部来「补墙」。

渲染上量到的差别：开缝前在发际下方那一行**一个缝都没有**；开缝后是 **2–13 mm 的缝**。
（实片同一行是 5–6 段、每 137 mm 一个缝；我们仍是 1–2 段每 198 mm —— **还是偏密**，
这一条留在清单上。）

**眉毛：这次量出了它为什么还是不出现。** 上一轮的结论是「眼睛要往下挪」。这一轮把 `eyeMid`
从 0.16 挪到 0.18、又把眉画在 f 0.004–0.032，渲染出来仍然只有**几片碎屑**。拿数字去问：

* 上眼睑（`upperLid`）的顶边在 `eyeMid − eyeHalfV + 0.12 × eyeHalfV` —— 把 `eyeMid` 挪到 0.18
  之后它在 **f = 0.012**；而发际线是 **f = 0**。
* 也就是说眼睛上方**只剩 1.8 mm**，而一道能读出来的眉在这个尺度上要 **5 mm 左右**。

所以要让眉出现，只有三条路：把眼睛**缩小**（可是实片的眼睛比我们**大**：0.34 的眼高对 0.30）、
把眼睛再往下挪 **9 mm**（`eyeMid` ≈ 0.22，脸会明显变长），或者**按动画惯例把眉画在头发上**
（「透明刘海」）。这三条都不是这一轮该顺手做的，所以眉的绘制与眼睛的移动**已回滚**
（渲染上量不到效果的改动不提交），留下的是上面这三个数与三条路。

**中庭：量错了锚点。** 这一轮真正的收获在这里。之前所有比例都写在 `FACE_LAYOUT` 的
**发际→下巴**框里，而 `tools/facegrid.mjs` 在实片上检出的框**是从眼睛上缘开始的**
（刘海和眉毛把眼睛以上的皮肤切碎，最大连续皮肤块就从睫毛开始）。换成同一个锚点：

| | 眼上缘 | 鼻 | 嘴 | 下巴 |
| --- | --- | --- | --- | --- |
| 实片 105.5 s | 0.00 | **0.42** | **0.60** | 1.00 |
| 这一轮之前 | 0.01 | 0.50 | 0.645 | 1.00 |
| 现在 | 0.01 | **0.45** | **0.617** | 1.00 |

也就是说鼻子低了 **0.08 个框**、嘴低了 0.045 —— 这正是近景里「下半张脸长」的来源。
`FACE_LAYOUT.nose` 0.50 → **0.46**、`mouth` 0.645 → **0.62**，并且新测试**按眼睛上缘**来断言
（这样它不依赖刘海恰好挂在哪里）。

### 明美：近景第十八轮 —— 虹膜是**椭圆**，因为它要填满的那个开口是椭圆

这一轮从「脸上还剩哪块最不像实片」问起。把眼睛单独放大对了一遍，答案是**眼白**：
渲染里每只眼睛的**内眼角有一大块奶白色楔形**，是脸上仅次于脸颊的第二大浅色块 ——
而实片的眼白只剩内眼角一丝和下面一条线。

**根因是形状，不是颜色。** 虹膜一直是「半径 = 眼高一半的**圆**」，而眼睛的外框
（`EYE_OUTLINE`）是 **2.8 个半宽 × 2.0 个半高**的杏仁 —— 一个半径 1.0 的圆**在几何上不可能**
盖住 2.8 宽的开口，两个角必然露白。实片放大到像素级：虹膜是一个**横椭圆**，
横跨整个开口，上缘被睫毛切掉、下缘被下眼睑切掉。

| | 之前 | 现在 |
| --- | --- | --- |
| 虹膜 | 圆，半径 = 0.5 眼高 | **椭圆**，`rx = 0.78 × 半宽`、`ry = 1.03 × 半高`（实片量到 0.82） |
| 眼白 | 内眼角一大块楔形 | 内眼角一丝 + 下缘一条 |
| 下缘月牙 | 一段圆弧 | 椭圆下缘**两条椭圆之间的月牙**（外 0.96 / 内 0.62） |
| 虹膜下半 | 抬起场强度 0.5 | 0.62（虹膜变大后原来的强度显得更黑） |

新断言是**一个区间**而不是一个点：虹膜在全宽上占 **0.62–0.92** ——
太窄说明又变回圆，太宽说明把眼白吃光了。

**下一轮的第一件事（这一轮量出来但没动）**：**刘海盖住了眼睛的上半**。
在左眼那一列上量发梢的深度（`analysis/fringeprobe.mjs` 的 tips 直方图），
我们的发梢最深**落到眼睛中线以下**，而实片的发梢停在眼睛上三分之一。
眼睛是脸上最要紧的东西，而它现在一半藏在头发后面 —— 这是下一轮要处理的
（做法是把**眼睛正上方那几根**发绺单独缩短，而不是把整套发绺变短）。

### 明美：近景第十九轮 —— 刘海的长度也要**按位置分档**（眼睛是脸上最不能藏的东西）

上一轮量出「刘海盖住眼睛上半」，这一轮按那一句去改。根因很具体：
发绺的**宽度**早就按位置分了档（宽锁 + 细丝 + 两处空位），
而**长度**一直是一张和位置无关的表 —— 最长的那几根（从发际量 34–40 mm）**越过了眼睛中线**
（中线在发际下 24 mm），实片的发梢停在眼睛上三分之一。

改法就是**把长度也按 x 分档**，而 x 的分界来自眼睛自己的框（`FACE_LAYOUT` 推出来）：

| 位置 | 之前 | 现在 |
| --- | --- | --- |
| 眼睛上方（\|x\| ≥ 0.017） | 19–40 mm（中线下 36 mm） | **12–21 mm**（发际下 8–16 mm） |
| 两眼之间（鼻梁上方） | 16–34 mm | **26–34 mm**（实片最长的那一点就在这附近） |

宽度一个毫米没动，所以发际的密度与上一轮开的 5–7 mm 缝都保留 —— 这一轮改的只是
**每一根挂多长**，而它现在和「挂在哪里」有关。

**新断言量的是位置关系，不是数字**：把眼睛自己的框、发际线都从几何里推出来，
对每一根落在眼睛框内的发绺断言两件事 —— **它必须挂进眼睛（下探到眼睛上缘以下至少 4 mm）**，
**而且必须停在眼睛中线上方**。阈值的取法写进了测试里的注释：眼睛上缘只在发际下 1.5 mm，
所以「挂进眼睛上三分之一」这种说法在这个比例下几乎等于在量发际 ——
真正错的是「挂到中线」，那条线才是断言该守的。

### 明美：近景第二十轮 —— 上半脸那块暗面**够到脸颊上了**（把它抬回实片的位置）

这一轮把「还差在哪」重新对了一遍：把实片 105.5 s 和我们的渲染归一到同一个脸框并排
（`tools/facegrid.mjs --image`，`analysis/r8_grid.png`）。看得最清楚的一条是：
**我们上半脸那块暖色暗面一直铺到颧骨上**，而实片的暗面在眼睛下面**就停了** ——
在同一个脸框上，实片的边界在 **0.36**，我们在 **0.46**，差的这 0.10 个脸高
正好是「眼窝有阴影」和「脸脏」的区别。

**这次不是目测，是量出来的。** 在实片那一帧上沿一条颊部竖线找「暗→亮」的台阶：

* `x=862`，y 385→401：`159 → 161 → 176 → 194 → 195` —— 台阶落在 **y=393**；
* 换成发际→下巴的框：**(393−280)/311 = 0.363**。

于是 `BOUNDARY` 表整条抬高（0.40–0.46 → 0.32–0.38），边界下的软垫场也从 `faceV(0.44)`
挪到 `faceV(0.36)`。渲染上量到的变化：颊部的「周边/中央」比从 **0.810 回到 0.865** ——
也就是说**脸变亮了**，而那 0.81 是上一轮用「把暗面铺大」换来的、实片并没有的暗。

顺带改掉一条**问得不对的测试**：周边平面那条测试从 u = 0.3 起扫，而抬高后的上半脸边界
在 f = 0.34 那一行正好落在 u ≈ 0.29 —— 扫过去先撞到它。改成从 **u = 0.26** 起扫
（周边平面定义在外颊上，就从外颊起扫），并把「颧骨比眼窝亮」的取样行从 0.4 挪到 0.25
（0.4 现在已经在边界下面，两边都是亮面，量不出对比）。

### 明美：近景第二十一轮 —— 鼻子是一个**填色的形状**，不是两点加一片雾

上一轮的清单第一条是「鼻子仍然太弱」。把实片和我们的鼻子**按同一物理尺度**并排
（都用她本人的脸高换算，`analysis/r9_nose_ab3.png`），差别一眼就清楚了：
**实片的鼻子是一块画出来的实心形** —— 约 28 mm 宽、16 mm 高的圆角梯形，有明确的外轮廓；
我们的在那张图里几乎只有两个点加一片雾。

**前两次尝试的失败方式都记在代码注释里**，因为它们定义了这个测试：

1. 三个 0.9 强度的叠加场 → 从眼睛拖到嘴的一**条污渍**（读成脏）；
2. 三个互不相邻的小标记 → 在 800 px 下就是**平皮肤上的两个点**。

**这次量的是颜色。** 实片鼻子的填充是 `#b76e45`（28%）与 `#9d562c`（19%），
底色（受光皮肤）是 `#d7bda1` —— 也就是 **0.68**；而调色板里的 `skinShadow`（`#b28c72`）
是灰紫色，**饱和度到不了那里**。所以鼻子的暗色是往实片自己的 `#a85a2c` 混 70% 得到的。

| | 现在 |
| --- | --- |
| 形体 | 一个**填色的圆角梯形**（`r.poly`）—— 第一版是三角形，读成脸上的**箭头**，所以顶边改平、最宽点放在鼻翼 |
| 填充 | 实片自己的暖暗色，alpha 0.6 |
| 下缘 | 一道**近黑的线**（`#79310c` 那一档）—— 实片靠它让鼻头**坐在**脸上，而不是浮着 |
| 鼻梁 | 一条**窄**的受光脊（0.018W），这是它不被读成对称团块的原因 |
| 鼻翼 | 两个小标记，压深到 0.5 |

渲染上量到的：鼻尖那一行，填充最深 **L 103–134** 对颊部 **184** —— **0.56–0.73**，
实片是 0.68。新断言量的是**关系**：最深值必须低于颊部的 0.7（否则「不存在」）、
高于 0.3（否则「是个洞」），并且**同一行上必须有 ≥12 px 连续**的暗值 ——
**两个点过不了这一条**，而这正是这条断言存在的理由。

顺带修掉一条连带失效的取样：「上半脸边界绕眼」那条测试原来在 u = 0.5 上找鼻梁的边界，
而鼻子的画现在占住 u 0.43–0.57，那一列量到的是**鼻子自己的边**。改成在 **u = 0.42**
（鼻梁旁边）取，理由写进了注释。

### 明美：近景第二十二轮 —— 下巴是**实片的两倍宽**，而这次量具是新造的

这一轮换了问法：不再看「哪里不好看」，而是量**宽度剖面** —— 皮肤在每一层的宽度占最宽一层的比例。
量具是 `analysis/facebox.mjs` 新加的一段：先取**最大连通皮肤块**，再逐行给出宽度。

| 脸高位置 | 实片（105.5 s） | 我们（改前） |
| --- | --- | --- |
| 颧骨 0.30 | 0.88 | 0.98 |
| 嘴 0.60 | 0.80 | 0.79 |
| 下颌 0.82 | 0.59 | 0.71 |
| 下巴 0.93 | 0.38 | 0.51 |
| 下巴尖 0.97 | 0.29 | 0.38 |

**嘴以上都是对的，最后两行不对** —— 下巴那一行是实片的两倍宽（0.35 对 0.26）。
`SKULL_SECTIONS` 的最后三行因此收窄（下巴 0.030 → **0.024**、次末行 0.044 → 0.037、
第三行 0.058 → 0.053）。渲染上量的剖面在 0.82/0.88/0.93/0.97 四处分别从
0.81/0.76/0.69/0.63 收到 **0.76/0.68/0.60/0.53**。

**量具自己踩的坑（记在工具里）**：第一版剖面取「每一行最左和最右的皮肤像素」，
而我们渲染的背景里那些**暖色 bokeh 光盘也过皮肤测试**，于是它们把**下颌**量成了整张脸最宽的一行。
改成先取最大连通块、再在块内量。**但这仍不能直接比**：她的**脖子是皮肤、和下颌连在一起**，
检测器会一路跟下去 —— 所以「渲染出来的下巴宽度」量到的其实是脖子。
真正能比的只有**表**（`SKULL_SECTIONS`），所以新断言就是对着表写的：
下巴必须 **< 0.30** 且 **> 0.18**（小于就成尖，大于就回到原来的宽下巴），
并且从颧骨往下**单调收窄**（一个软 U 不能在半路鼓出来）。

### 明美：近景第二十三轮 —— 眉毛试了**四种配置**，四种都量了；留下的是眼睛

这一轮集中攻眉毛（清单上唯一「实片有、我们没有」的五官）。前两轮已经把两个卡点量清楚了：
**发际缝**（第十六轮逐像素零差异 → 第十七轮把发绺根部收到 15% 外扩，开出 5–7 mm 缝）和
**眼睛上方的净空**（上眼睑顶边 = `eyeMid − eyeHalfV + 0.12·eyeHalfV`，在 0.16 时是 **f = 0.003 ——
在发际线以上**，也就是说整块额头本来是眼睛的）。这一轮把眼睛往下挪、把发绺在眉毛那一段收窄，
一共试了四种：

| 配置 | 眉毛可见像素 | 读起来是什么 |
| --- | --- | --- |
| `eyeMid` 0.20 + 原来的密刘海 | 359 | 两三段细碎屑，像皮肤上的**褶** |
| `eyeMid` 0.23（净空 7.7 mm） | 509 | 仍然碎，脸同时被拉长 |
| `eyeMid` 0.20 + 眉部稀疏刘海（10 根 / 7.6 mm） | 372 | 斜向的**划痕**，刘海同时变稀 |
| 再把眉部发绺收到 5.2 mm | 449 | 缝里能看到小段深色，**刘海已经不像刘海** |

结论是结构性的，不是参数没调好：**眉毛能存在的那条带子**（发际线 → 上眼睑顶边）在
`eyeMid` 0.19 时只有 **2.5 mm**、0.20 时 3.2 mm，而发绺把它切成宽 5–7 mm 的碎片 ——
碎片的尺寸（约 3×6 mm）与实片自己的眉毛碎片同量级，但实片的发绺只有 2–4 mm 宽，
所以它的碎片是**连贯的弧**，我们的是一道道划痕。讲道理的三条出路（缩小眼睛、眼睛再下移 9 mm、
或按动画惯例把眉画在头发上）都不该在这一轮顺手做，**四种配置全部回滚**。

**留下的是一条眼睛的改动，而且它是这一轮唯一有依据的东西。** 为了让眉毛有地方，
眼睛必须往下挪；而把眼睛往下挪、放大一点点，**本身就更接近实片**：

* 实片的眼睛占脸框 **0.34**，我们原来 0.30；
* 实片的眼睛中心在「颅顶→下巴」的 **0.40**，`eyeMid` 0.16 时我们的是 0.46。

所以 `eyeHalfV` 0.15 → **0.16**、`eyeMid` 0.16 → **0.19** 都保留（渲染对比见
`analysis/r11_eye_ab.png`：眼睛更大、略低，脸更像动画少女而不是娃娃）。

**顺带修掉一条被这次移动「量错」的测试。** 「颧骨让表面转弯」那条在固定的 0.34/0.55 两行取样，
而眼睛下移 0.03 个脸框会把**眼窝那个 36 mm 的凹**带到颧骨那一行 —— 于是它量出 2.4 mm
（原来 3.8 mm）：**颧骨没变，尺子变了**。现在它**沿颊部走向找**半径的极大与极小来量起伏，
而「转弯」仍按实片画的那一段（0.34 → 0.55）量 —— 因为**半径的峰值和法线的峰值不在同一行**：
法线在 0.30–0.34 就开始转，轮廓最宽点要到 0.40。

### 明美：近景第二十四轮 —— 鼻子的**面积**才是那把尺子

上一轮留下的是鼻子「读成一个圆按钮」。这一轮换了量法：不再只看**最深值**，
而是同时看**鼻子那块面积上的平均值**与**填充像素的平均值** —— 而这两个数实片自己给了：

| | 实片 105.5 s | 第一版填色 | 现在 |
| --- | --- | --- | --- |
| 鼻子区域平均 / 颊部 | **0.89** | 0.93 | **0.88** |
| 填充像素平均 / 颊部 | **0.56** | 0.75 | **0.59** |

「最深值」只说明形状够深，**不说明盖了多少面积** —— 第一版填色深的地方够深，但整块面积偏亮，
读出来就是一只带阴影的浅色按钮。这一轮补了三件事：

1. **鼻梁**：从两眼中线往下到鼻头的一条窄暗带（实片那只鼻子的左上缘就是一条画出来的线）——
   没有它，鼻子的形**挂在额头上**；
2. **轮廓**：沿底边与两侧各一道近黑的线（底边 0.5，两侧 0.28）—— 只有底边时，填充仍然渗进脸颊；
3. **颜色**：把填充从「往 `#a85a2c` 混 70%」换成「往 `#8a4218` 混 75%」。
   这一条是被数出来的：**光提高 alpha 是没用的** —— 从 0.74 提到 0.82，面积均值只动了 0.02，
   因为 toon 分档早就把这块填充放进下面那一档了；**要动的是颜色本身**。

顺带试过**把多边形不平滑**（理由是「赛璐璐的鼻子是有棱角的」）——渲染出来像**一栋房子**，
比它替换掉的那只「灯泡」更糟，已回滚；注释里记了这一条。

### 明美：近景第二十五轮 —— 脸的阴影是**赭红**，不是灰紫（一个从第一版就在的目测值）

这一轮的入口是一个很旧的东西：调色板里的 `minmay.skinShadow`。它是 `'estimated'`，
写的是「脖子与下巴下面」，值 `#b28c72` —— 一块**灰紫**。而把实片同一帧的阴影量一遍：

```
node tools/palette.mjs film.mp4 --region temple=105.5,0.435,0.27,0.02,0.02
  -> #b96543 (65%)          太阳穴
--region underChin=105.5,0.465,0.50,0.02,0.015
  -> #ba6e53 (30%)          下颌下面
```

两处都是**赭红**（terracotta），像素级的取样也一致（眼下那块面 `#bd926b`、眉下 `#ba6d46`）。
灰紫的阴影配暖色的皮肤，正是整张脸在实片旁边显得「发闷」的来源 ——
**这个值从第一版起就没有人量过**，它一直只被当成一个「差不多的暗色」。

改成两个样本的共同值 **`#b8714f`**，来源标 `sampled` 并把两条命令写进调色板。
它一处改动，全身跟着变：脸上所有的暗场与描边、脖子的材质、以及唇的**半色调**
（往 `skinShadow` 混 22%）—— 渲染对比见 `analysis/r13_ab.png`：脸的暗面从灰紫变成暖赭，
整张脸立刻不那么「蒙灰」。

**连带改了一条测试的阈值**：唇的半色调与肤色的距离从 0.12 放到 0.18 ——
调色板这个值一改，混合色在**线性空间**里离底色更远了（屏幕上仍是同一个「暗一档的肤色」），
真正要守的那条（离唇色 > 0.3）没有动。

### 明美：近景第二十六轮 —— 下唇的投影**画在了唇底下**（而 wash 到不了那个值）

上一轮之后，下半张脸最空的一块是嘴下面。量出来是这样：

| 位置 | 实片 105.5 s | 我们（改前） |
| --- | --- | --- |
| 下唇正下方那块（占颊部） | **0.53** | 0.89–0.97 |

**0.53 是下半张脸上最强的一个值** —— 它是让嘴「坐在脸上」的那道投影。而我们的那道场，
从加进去那天起就写在 `mouth + 0.05`（嘴线下方 7.6 mm），**而下唇是一根从同一条线垂下来的
9 mm 高的管** —— 投影正好画在唇底下，被唇自己盖住了。

这一轮做了两步，第二步才是这一轮真正的发现：

1. **往下挪**（到 `mouth + 0.10`，也就是闭着的唇下面皮肤真正露出来的地方），"
   渲染只从 0.89 动到 0.83；
2. **发现 wash 到不了那个值**：把这道场加到 0.9 强度、颜色换成往 `#8a4218` 混 42% 的重色，
   渲染也只到 **0.80**，而**贴图里已经是皮肤的 0.75** —— 也就是说**贴图背着的一个阴影，
   渲染没接住**。原因和鼻子那块填色是同一个：**三档 toon ramp 之下一块中间调的场活不下来**。
   所以它改成**画出来的形状**（和刘海投影同一个办法）：一道上缘贴着唇、中间更厚的月牙，
   不透明度 0.72。

渲染上量到的：那块区域从 0.89 → **0.79**（实片 0.53，仍是「更淡但存在」而不是「没有」）。
新测试量三件事：那道月牙必须在 **f 0.67–0.80** 之间最深（唇在 0.62、9 mm 高），
必须低于颊部的 0.82，**而且唇自己占的那一条必须仍然是亮的** —— 最后这条正是防着
「又把投影画回唇底下」。

### 明美：近景第二十七轮 —— 侧发是**一层**，不是一条带子

这一轮换了看法：不看单张近景，而是把**分镜本身**放大看（`analysis/r15_shot_big.png`）。
在那个构图里最刺眼的东西不是五官，是**脸两旁那两条蓝带子** —— 从太阳穴垂到锁骨，
宽度不变、两条边笔直。实片的侧发是**三到四束发绺、发梢落在不同高度**，
所以轮廓在下行时会**断两次**。

侧发本身是扫出来的锥形发绺（第十一轮改过一次），半径从 0.021 收到 0.003 ——
**一根**管子：在 640 px 下它就是一条等宽带子。这一轮在旁边加**第二束**：
更短（到下颌为止）、更窄（半径 0.012 对 0.021）、更靠外 4 mm、更靠后 8 mm，
用同一个平发色材质（理由与那一段的长注释相同：太阳穴上垂下来的发绺在刘海投影里，
给它高光就会变成一条贴在腮边的浅色贴片）。

> 这一束的位置试了两次。第一次放在长绺**里面**（x 0.003→0.004），渲染出来**看不见** ——
> 从正面完全被长绺挡住。要让它出现在轮廓里，它的**下半段必须走到长绺外缘之外**
> （x 0.006→0.019）。这也正是新断言量的东西：**第二束的发梢必须比长绺高 2 cm 以上**
> （轮廓要断），并且两束都必须在脸自身半宽之外（不能盖住脸颊 —— 那条是第十一轮
> 「脸被窗帘围住」的教训）。

draw call 从 104 到 **107**（预算是硬的 110），四个角度、两个分镜、绕序扫描都过了。

### 明美：近景第二十八轮 —— 发际是**密而小缝**，不是疏而大洞

上一轮之后回头量发际（`analysis/fringeprobe.mjs`，这次量的是**分镜里**的发际行）：

| | 实片 105.5 s | 我们（改前） | 现在 |
| --- | --- | --- | --- |
| 发块宽度 | 10–42 mm | 85–94 mm | 30–69 mm |
| 块间皮肤缝 | 3–10 mm | **14–40 mm** | **4.6–19.4 mm** |
| 一行上的块数 | 5–6 / 137 mm | 3 / 280 mm | **6 / 280 mm** |

也就是说：不是「太密」，而是**太粗** —— 少数几块大质量、之间留着一两个大洞。
实片是许多小块、每块之间一条窄缝。改法很简单：**把两处大洞各填一根细发绺**
（第十五轮为了让眉毛露出来而空出来的那两个位置，`x −0.023` 与 `+0.033`）——
18 mm 的洞变成两条约 7 mm 的缝，落在实片的 3–10 mm 里。

新断言量的是**相邻发绺的间距**：必须 **< 14 mm**（不许有洞）且 **> 3 mm**（不许并成一块）——
这两条正好是这次「填洞」与第十五轮那次「开洞」各自越界的方向。

**顺带记一笔预算**：加了这一根（两处）之后，明美的网格数到 **109**，预算是硬的 110 ——
下一轮如果要再加几何，得先把 13 片刘海合并成按材质的两批（会省下约 11 个 draw），
这一步记在下面的清单里。

### 明美：近景第二十九轮 —— 眼睛**小了 22%**：这次是把两张脸按眼睛对齐全量了一遍

前十轮的比较一直用 `tools/facegrid.mjs` 的归一化，而那个工具的基准是**检出到的皮肤框** ——
对有刘海的她来说，这个框的顶边落在刘海缝里，于是**纵向位置一直对不齐**（第二十轮已经记过一次）。
这一轮换了一个**可验证的对齐**：以**眼睛中心到下巴**的距离为基准，把两张脸缩放到同一比例再并排
（`analysis/r17_aligned2.png`）。基准本身可以逐个特征核对：实片是 228 px、我们是 275 px。

对齐之后第一眼看到的事情，是**眼睛小了**：

| | 实片 | 我们（对齐后） |
| --- | --- | --- |
| 眼睛高度 / 眼到下巴 | 0.79 | **0.61** |
| 虹膜宽度 | ~39 mm | ~34 mm |

也就是说**相对这张脸，眼睛小了约 22%** —— 而「眼珠是二次元的灵魂」正是 `analysis/temp.txt`
第一条里的话。`eyeHalfV` 0.16 → **0.19**、`eyeMid` 0.19 → **0.22**（眼睛变大同时略下移，
上缘落在发际下 4.5 mm，刘海正好压在它的上三分之一 —— 和实片一样）。

**这次连带出了两处「量错了」的地方，都是同一个原因：眼窝跟着眼睛走。**

* 眼窝那个凹的纵向半径是 `EYE_RY × 1.5`，眼睛变大变低之后，这个凹压到了**颧骨那一行**上 ——
  颊部的转角从 34° 掉到 23°，「颧骨让表面转弯」当场失败。改法：**颧骨那三对场跟着眼睛下移**
  （0.34/0.55/0.80 → 0.39/0.60/0.84），并把这个乘数收到 1.3。理由写进代码：
  **颧骨长在眼睛外角下面，锚点是眼睛，不是脸框。**
* 那条测试量的「转弯」原本从**半径的峰值**起算，而**法线的峰值和半径的峰值不在同一行** ——
  表面在 0.34–0.38 就转过去了（颧骨顶），轮廓最宽要到 0.46 才到。锚在半径峰值上，
  等于**从转完之后才开始数**，于是一条转 33° 的颊部只报 18°。现在锚在**法线峰值**上。

### 明美：近景第三十轮 —— 唱歌的嘴**在屏幕上没有张开**：两个新量具，和一条还没走完的路

这一轮的目标是「唱歌的嘴」。实片 105.5 s（张嘴唱）在嘴的中线上量到 **10.5 mm 高的暗腔**；
我们在同一位置只有 **约 1 mm**。查下去的过程比结论有用，因为**每一步都在推翻上一步**：

1. **先怀疑脉冲**。算出 t = 34.415 正好落在节拍上（0.302 + 62×0.55021 = 34.41502），
   于是在**页面上**直接问：新加的 `window.__DSH_BEATNEAR__(t)` 报
   `nearest 34.41502, dt −0.00002, count 696` —— **脉冲确实是 1.0**，这条路排除。
2. **再造一个「问页面」的量具**：`analysis/jawcheck.mjs` 打开同一帧、**在同一个页面里**
   截图并查询 `window.__DSH_FIND__` 报出的部件世界包围盒（下巴组、墨线、腔体、内唇）。
   于是发现：**下巴确实在动** —— 在 t = 34.0（脉冲约 0.35）与 t = 34.415（脉冲 1.0）之间，
   下唇的顶边相对墨线**下落了约 10 mm**。
3. **于是去问渲染**：把腔体临时染成**纯绿**再渲染同一帧 —— 绿色只出现在**墨线的弓形上方**
   （几像素），墨线**下面**是**皮肤色**。也就是说：几何张开了、腔体也在，但**开口里看到的是
   颅骨的底**（肤色），而不是腔体的暗色。

**这一轮踩进去的坑也记下来**，因为它会骗下一轮的自己：中途我用「把下巴位移写成 0」来验证
代码是否生效，渲染**逐像素完全一致**，于是我一度以为「浏览器里根本没跑这段代码」——
**真正的原因是我自己把那行改成了 0**，后面的三次实验都建立在那个改动上。
把源码 `git checkout` 回去之后，页面查询显示下巴一直在动。

**留在仓库里的**：`window.__DSH_BEATNEAR__`（页面自己用的节拍网格与最近节拍，
把「算出来的脉冲」和「这个页面算出来的脉冲」分开）与 `analysis/jawcheck.mjs`
（同一页面内截图 + 查询部件包围盒）。**下一轮从这里接**：腔体在开口里看不到，
要么是它相对颅骨凹底的位置不对（射线检测说它在前面，渲染说不是），
要么是开口里另有一层几何盖住了它 —— 这两个量具正好能回答。

### 明美：近景第三十一轮 —— 页面里的「同一帧」：查询、重渲、截图三件事要在一次载入里做完

上一轮留下的问题是「唱歌的嘴在屏幕上没有张开」。这一轮把上一轮造的两个量具用到底，
并补上第三个 —— 它让「**问状态**」和「**看像素**」不再可能来自两帧：

* `window.__DSH_API__`（新）：still 模式下把页面 api 挂到 window 上，于是工具可以
  **在截图之前再渲染一次同一帧**（`renderAt(t)` 会重新施加动画并绘制）。之前
  `jawcheck.mjs` 的截图来自 `captureFrame` 的渲染，查询来自之后的场景状态 —— 两者
  理论上同一帧，但**没有任何东西保证它**，而这一轮恰恰卡在这个缝里。

这一轮量到并且可以确定的两件事：

1. **脉冲确实是 1.0**：`__DSH_BEATNEAR__(34.415)` 报 `nearest 34.41502, dt −0.00002` ——
   页面自己的网格与算术一致；
2. **场景里的嘴确实张开了**：同一次载入里，下唇网格的顶边比墨线的底边低 **约 5 mm**
   （t = 34.0 时两者相差 +5 mm，即闭合），也就是说下巴位移、旋转都在跑。

**但渲染出来的那一列像素仍然是「唇」**：把颅骨临时染成纯蓝之后，开口那几行是
**(198,162,133)** —— 唇自己的半色调，既不是颅骨（蓝）也不是腔体（本可以是绿）。
也就是说：**几何张开了、查询说张开了，像素却是闭合的样子**，
这一轮没能把这三者调和；留下的正是能做这件事的工具（查询 + 重渲 + 截图，一次载入）。

（另记一条**自己踩的坑**：中途为了验证「下巴那行代码是否生效」我把它改成了 0，
于是渲染逐像素一致，我一度以为浏览器里根本没跑那段代码 —— 真正的原因是我自己改的那行。
三次实验都建在它上面，全部作废。）

### 明美：近景第三十二轮 —— 把「渲染器不肯显示的那条性质」**用测试钉住**

上一轮留下的矛盾没有解开：**场景说嘴张开了，像素说没有**。这一轮又试了三件事，都不成立，
于是把力气花在**把那条性质写成测试**，让矛盾的两端有一个共同的裁判。

试过的三件事（都回滚）：

1. **把腔体往前挪**（3 mm → 1.5 mm）、**把凹槽收窄加深**（`ry` 0.012 → 0.010、`d` −0.0075 → −0.0095）、
   嘴唇加高（`LIP_SQUASH` 4.1 → 5.7，唇高 9 → 12.6 mm）——目标是让「窗口」更浅、
   腔体更容易被看见。渲染**毫无变化**（开口列仍然是唇的肤色），而且闭合时唇盖不住窗口，
   「粉色在开口里」那条测试当场失败；
2. **把开口画在颅骨贴图上**（动画师的做法：把开口画在脸上，再把唇盖上去）——
   渲染出来**闭合时那颗深色会从唇下露出一个点**（盖不住），而张开时也看不到（下巴没到位）；
3. **换一个「纯 singClose 姿势 + 脉冲 1」的帧**（t = 32.764，正好是节拍且姿势在轨迹起点）——
   那一列根本没有嘴（头的位置不同）。

**留下的是一条断言**（`test/parts.test.js`）：在嘴的中线上打一条射线 ——
**静止时必须落在唇上，满脉冲时必须落在腔体或口腔内部**。它现在**通过**：
也就是说**几何是对的**，渲染器（或捕获路径）没有把它画出来。这样下一次无论朝哪边动手，
都有一个不会跟着变的裁判：几何这边已经达标，问题在「画」的那一侧。

### 明美：近景第三十三轮 —— 眼睛上方的刘海是**一条实带**，实片是**细丝**

唱歌的嘴那条线暂时搁下（第三十二轮已把「几何对、渲染错」钉成断言）。这一轮回到对齐图
（`analysis/r21_aligned.png`，按眼睛到下巴对齐），**右图最刺眼的一处**是眼睛上方的刘海：
我们是一条**实心的黑带**，实片是**细发丝、丝间露出皮肤、眼睛的顶边看得见**。

量到的是宽度：眼睛上方每根发绺 **8 mm** 宽（`w` 0.0040），在 9.3–19 mm 的间距上，
**丝间的缝只有 2–4 mm** —— 640 px 下就是一条带子。这一轮把眼睛上方那九根收到 **5.2 mm**
（`w` 0.0026），缝变成 **4–14 mm**，正好落在第二十八轮那条断言（相邻发绺间距 3–14 mm）里，
也落在实片的 3–10 mm 里。长度没有动（第十九轮定的「停在眼睛上三分之一」）。

渲染对比见 `analysis/r21_aligned2.png`：额头的皮肤从丝间透出来，眼睛的顶边不再被一条带子压住。

### 明美：近景第三十四轮 —— **整张脸宽了 15%**：一个从第一版就在、却从没量过的常量

这一轮做的是「把两张图对齐之后再量**宽度**」（对齐基准仍是眼睛到下巴，第三十二轮起用的那套）。
量法：在两张图上都取**过脸中心的那条皮肤行程**的宽度。

| | 实片 105.5 s | 我们 |
| --- | --- | --- |
| 颧骨一行的可见脸宽 | **145 mm** | **184–193 mm** |
| 连头发在内的头宽 | 166 mm | 约 200 mm |

也就是说 `PROPORTIONS.headWidth = 0.185` 这个**从第一版就写在那里、注释里没有任何出处**的常量，
让**颅骨自己**就占满了实片留给「头 + 头发」的总宽度 —— 这是「脸宽」这个印象的根源，
改五官是改不掉的。实片的比例是 **150 / 215 ≈ 0.70**（我们 0.79）。

**试过、并且证明「必须单独一轮来做」**：把 `headWidth` 改成 **0.160**（−15%）之后：

* 渲染上的脸宽确实从 215 → **187 mm**（方向对）；
* 但**嘴立刻散架** —— 闭合时上下唇之间出现 **−2.2 mm** 的缝。原因很清楚：
  `buildFace` 里嘴的**宽度**来自 `FACE_HALF_WIDTH`（随头颅缩放），而**半径与抬升**
  （`INK_R`/`LIP_R`/`LIP_LIFT`/`INK_LIFT`/`LIP_DROP`）是**米**，不随头颅缩放；
* 把这一组常量按 `MS = headWidth / 0.185` 一起缩放之后，缝从 −2.6 收到 **−2.2 mm**，
  还差 2.2 mm；再用手调 `LIP_DROP` 把这 2.2 mm 补上，**缝闭合了，但开口没了**
  （「开口里必须看到腔体」那条断言当场失败）—— 说明**唇的静止位置与开口的高度是同一根绳子**，
  在窄脸上必须重新排布stations，而不是补一个常数。

四条相关断言（闭合缝 ±1.5 mm、开口射线、粉色在开口里、颏下阴影）现在都在原始状态通过。
**下一轮就从「把 `headWidth` 收 15% + 在窄颅骨上重排嘴的 stations」这一件事开始** ——
这是目前量到的最大一处与实片的差距，比任何一处五官都大。

### 明美：近景第三十五轮 —— 头宽收 15%：一个常量改了，**「米」和「脸的比例」要分开**

上一轮量到 `PROPORTIONS.headWidth = 0.185` 让**颅骨自己**占满了实片留给「头 + 头发」的宽度
（可见脸宽 184–193 mm 对实片 145 mm）。这一轮把它落到 **0.160**，并把随之暴露的
**一整套「以米为单位、按旧头宽写死」的数**处理干净：

| 渲染上的可见脸宽 | 改前 | 改后 | 实片 |
| --- | --- | --- | --- |
| 颧骨一行 | 176–193 mm | **148–162 mm** | 145 mm |

三件事必须一起改，缺一件就有断言红：

1. **脸上的雕形足迹**（`sculptSkull` 的 `rx`/`ry`）：它们是**米**，而位置来自 `xOf/yOf`（已随脸缩放）——
   头一窄，眼窝、嘴的凹、下巴的软垫都变成「按 15% 宽的脸定的尺寸」。循环里统一乘 `FACE_K`。
   **但颧骨那两对例外**：它的起伏就是实片画的那条线，足迹一缩，颊部转角从 33° 掉到 25.7° ——
   所以那两个 `rx`/`ry` 在表里先除以 `FACE_K`，让循环还原成作者写下的数。
2. **嘴的所有绝对尺寸**（`INK_R`/`LIP_R`/`RADII`/`INK_Y`/`LIP_LIFT`/`INK_LIFT`/`LIP_DROP`
   以及腔体、舌、齿、内唇的位置与半径）：嘴的**宽度**来自 `FACE_HALF_WIDTH`（随头缩放），
   这些却是米 —— 不缩，闭合时上下唇差 2.6 mm，缩了之后再把 `LIP_DROP` 定到 **0.0004 × MS**，
   四条嘴部断言全部转绿（闭合缝 ±1.5 mm、开口射线必须命中腔体/内唇、粉色在开口里、
   颏下阴影）。
3. **深度 `d` 也跟着缩放**（`d × FACE_K`）—— 因为凹的深浅与脸的尺度同源；唯一例外仍是颧骨。

不改任何测试阈值。`npm test` **411 通过 / 0 失败**、`smoke` 22/22、绕序扫描无内外翻；
按眼睛对齐的并排图见 `analysis/r23_aligned.png`，分镜见 `analysis/r23_shot_big.png` ——
脸从「宽椭圆」变成实片那样的**竖长椭圆**，头发自然地把脸框住。

### 明美：近景第三十六轮 —— 下眼睑是**一条亮带**，实片那里是**暗边**

上一轮把脸收窄之后，放大看最刺眼的一处是眼睛下面：**一道浅米色的亮带**横在眼下，
像一道疤。它是下眼睑 —— 一直是 0.9 mm 的皮肤色小圆管，而**小凸面管会吃到 toon 分档的最亮一档**，
旁边的脸颊却在下一档，于是「眼睑」读成了「高光」✗。

实片里眼睛下缘是**墨线然后就是皮肤**。所以这一轮把下眼睑的材质换成调色板里的
**`minmay.skinShadow`**（第二十五轮刚从实片取样得到的赭红）—— 同一个色相、低一档，
形状与尺寸一个像素没动。

对比见 `analysis/r24_lid_ab.png`：左边那道浅带消失，右边换成一条暖色的眼缘，
眼睛不再「浮」在脸上。`npm test` **411 通过 / 0 失败**、`smoke` 22/22、绕序扫描无内外翻。

### 明美：近景第三十七轮 —— 虹膜的绿环**是实片的 4–7 倍宽**

眼睛是二次元的灵魂（`analysis/temp.txt` 第一条），所以这一轮**数眼睛里的颜色**：
在各自眼睛的方框内，按同一套判据（暗 / 白 / 绿）统计占比：

| | 实片 105.5 s | 我们（改前） | 现在 |
| --- | --- | --- | --- |
| 绿（`g > 80 且 g > r+20`） | **0.5%** | 2.1–3.6% | 1.7% |

虹膜下方的绿色**新月**原本是「虹膜半径的 0.96 → 0.62」（一条 34% 宽的带），
实片是一条**细环**。改成 **0.96 → 0.80**（16%），绿占比随之从 2.1% 降到 1.7%。

**连带改了一条测试的阈值**（并把理由写进去）：原来断言「这一带里的绿像素 > 80」——
那是按宽环定的；现在同一带里约 1%，与实片的 0.5% 同量级。新阈值 **> 8**，
它仍然守着原来要防的那件事（绿环整个消失），但不再要求实片没有的宽度。

对比见 `analysis/r25_eye_ab.png`（左改前 / 右改后）与 `analysis/r25_face_ab.png`。

### 明美：近景第三十八轮 —— 鼻子**上下颠倒了**：实片是「上亮下暗」

前几轮量鼻子的都是**面积均值**与**填充值**，两个数都对齐了，形状却还是「一块团」。
这一轮换了量法：**沿鼻子自己的中线分三段**量（同一套行、两张图）：

| 鼻子（相对颊部） | 实片 105.5 s | 我们（改前） | 现在 |
| --- | --- | --- | --- |
| 上三分之一 | **1.04**（比颊部还亮） | 浅色按钮时代的 0.6 | **1.00** |
| 中三分之一 | **0.75** | 0.93 | **0.80** |
| 下三分之一 | **0.71** | ~1.0 | **0.72** |

也就是说实片的鼻子是**鼻梁正面受光、鼻头下方落影** —— 而上一次「填色」把它画成了
**上暗下亮**（团块的来源），后来又矫枉过正成「上亮下也亮」。

改法三条：

1. **鼻梁的暗场挪到两侧**（`u 0.468 / 0.532`，各一条窄带）—— 实片那条线本来就画在梁的**侧缘**，
   不是横在上面；
2. **鼻梁正面加一块受光的场**（往白混 55%、强度 0.5）；
3. **下暗部不再用 wash，而是画成形状** —— 取鼻子自己多边形的下半段、在 `ny − 0.012H` 处切开，
   填 `skinShadow` 0.55。wash 试过：强到能压暗鼻身中段时，也把该亮的顶端一起压暗了，
   而实片正是靠**一条画出来的边界**分开这两块。

**顺带修掉两条「拿着旧调色板在量」的测试**：它们把 `#b28c72`（第二十五轮之前的灰紫）
**字面写进** `paintFace`，所以第二十五轮把调色板改成赭红之后，它们量的其实是另一套颜色 ——
一改成当前值就红。修法是**换参考点而不是改阈值**：鼻子的「颊部」参考从最外侧的皮肤
（在暗面里）换成**受光的颧骨**（`u 0.37`，与实片量 0.89 时的取点一致）；
「下巴必须最亮」那条不再与**嘴所在的那一行**比（那一行带着唇的涂装），改成与**下颌侧面**比。

对比见 `analysis/r26_nose_ab.png`。`npm test` **411 通过 / 0 失败**、`smoke` 22/22、绕序扫描无内外翻。

### 明美：近景第三十九轮 —— 虹膜是**一个圆盘**，不是「填满开口」

把两张图按眼睛对齐、再把**同一块方框**里的颜色分类（暗 / 白 / 肤）：

| 眼睛方框内 | 实片 105.5 s | 我们（改前） |
| --- | --- | --- |
| 暗 | 38% | **82%** |
| 白 | 6% | 4% |
| 皮肤 | 55% | **13%** |

把两张图的眼睛放到同一比例下看，差别一眼就清楚：**实片的虹膜是一个圆盘，坐在一大片白色巩膜里**
（两侧和下方都是白的），**我们的虹膜把整个开口填满了**。

上一轮（第二十轮那次）之所以把虹膜做成「开口宽度的 0.78 的椭圆」，是为了修另一个真问题 ——
「半高的小圆留下奶白色楔形，读成瞪眼」。但那个修正**过头了**：椭圆+超高的半高
（`iry = h × 1.03`）让巩膜无处可去。现在改成**开口半高的圆盘**（`irx = iry = h × 0.95`）——
正是实片画法：**睫毛切它的顶、下睑切它的底、白留在两侧**。

新断言没有动：虹膜横跨眼睛宽度的 **0.66**，仍在原来那条 0.62–0.92 的区间里。
对比见 `analysis/r27_eye_ab.png`（同比例两只眼）与 `analysis/r27_aligned2.png`（整脸）。

### 明美：近景第四十轮 —— 眼睛**整体太暗**，睫毛也偏细

继续用同一套「同比例、同判据」的量法，这一轮量**眼睛里暗部的平均值**（眼睛方框内 L < 150 的像素）：

| | 实片 105.5 s | 我们（改前） | 现在 |
| --- | --- | --- | --- |
| 暗部均值 | **67** | 40 | **43** |
| 暗部像素数 | 8669 | 11491 | 11490 |

两条结论：

1. **虹膜整体比实片暗一档**：`deep = mix(iris, '#04090b', 0.5)` 是在调色板本身的
   `minmay.eye`（约 50）上**再压一半**，比实片对「虹膜本体」做的事更狠 —— 实片只在**瞳孔**处
   那么黑。改成 **0.25**。
2. **睫毛比实片细**：同比例下实片最重的地方约是眼睛高度的**三分之一**，我们原来是**五分之一**。
   在虹膜已经变成「白巩膜里的一个圆盘」之后，细的睑线读起来像一个画上去的圆 ✗。
   系数从 `0.11 + 0.5·sin^0.7·(0.34+t)` 提到 `0.135 + 0.58·…`。

（暗部像素数没变 —— 那一项里还混着**刘海垂在眼睛上的暗丝**，不是眼睛本身，
所以这一轮只按「均值」这一项判断。）

对比见 `analysis/r28_eye_ab2.png`（同比例双眼）与 `analysis/r28_aligned2.png`（整脸）。

### 明美：近景第四十一轮 —— 眉毛**确实在头发后面**：这一次是用射线证明的

眉毛是清单上最后一件「实片有、我们没有」的东西。第三十五轮把眼睛放大下移之后，
代码里留下过一句「现在终于有空间了」的注释 —— **这一轮用一个射线探针证明了那句话是错的**。

`.scratch/browprobe2.mjs`：在眉毛所在的那条带（`y = top − faceV(f)·height`，f = 0.01/0.025/0.04）
上，从正前方沿 −z 打射线，看**第一个表面**是什么：

| f | x = −0.052 | −0.042 | −0.032 |
| --- | --- | --- | --- |
| 0.010 | `fringeTip4` | `hairCap` | `hairCap` |
| 0.025 | `fringeTip4` | `hairCap` | `fringeTip6` |
| 0.040 | `fringeTip4` | `fringeTip5` | `fringeTip6` |

**整条带子被头发盖住 —— 而且是发帽（`hairCap`）和发绺一起盖的**。这也解释了两件事：

* 把眉毛画在贴图上，**把颜色换成纯品红也一样**，渲染出来与没有眉毛**逐像素完全一致** ——
  不是「看不清」，是**一个像素都没露出来**；
* 早先那次探针报「第一个表面是颅骨」是**行算错了**（用了发际线当顶点，而 `faceV` 的分数是
  相对于**整个颅骨高度**的），量到了额头更低的位置。

所以结论回到最初那条注释上：**实片 105.5 s 那一帧她的眉毛也被刘海完全盖住**，
唯一露出来的是 13.5 s（动画师特意把刘海画开）。**画上去只会在别的帧里糊成一道黑影**，
不画是对的 —— 这一轮把这句话从「一个印象」变成了**一条可重放的证据**。

（本轮所有实验均已回滚；`npm test` 411 通过、`git status` 干净。留下的探针在 `.scratch/`。）

### 明美：近景第四十二轮 —— 唱歌的嘴**一直是对的**：那六轮量错了帧

第三十轮到第三十二轮留下的结论是「几何对、渲染错」：下巴在动（页面查询）、脉冲是 1.0
（按节拍网格算的）、开口里却看不到暗腔。这一轮把那个结论**推翻了** —— 而且工具是这一轮新加的两个钩子：

* `window.__DSH_JAW__`：直接报 `lowerJaw.position.y` / `rotation.x`，**以及引擎自己算出来的脉冲**
  （`engine.lastPulse`，`renderAt` 里存的一行）；
* 加上 `__DSH_BEATNEAR__`（第三十轮）报的**页面自己的节拍网格**。

在同一帧上把三个数放在一起，答案就出来了：

| t | 最近节拍 | dt | 引擎脉冲 | 下巴 y |
| --- | --- | --- | --- | --- |
| 34.415 | 34.41502 | −0.00002 | **0** | **0** |
| 34.41502 | 34.41502 | 0 | **1** | **−0.009** |

**t = 34.415 比节拍早 20 微秒**：`beatPulse` 只认*已经过去*的那个节拍，
而脉冲的衰减常数是 0.13 s、上一个节拍在 0.55 s 之前 —— 于是 t = 34.415 处脉冲是 **0.014**，
约等于零。**前六轮采样的每一帧都落在这个位置上**（34.0 与 34.415 都不是节拍）。

把帧挪到**正好落在节拍上**（34.41502）再渲染：下巴 −9 mm、旋转 0.16 rad、脉冲 1，
下唇落到下方、**中间露出一条粉色内唇** —— 嘴确实是张开的。

**所以这条线索从来不是渲染 bug，而是采样 bug。** 教训写在这里：判「嘴张开了没有」必须
**在节拍上取帧，并且 `dt ≥ 0`**；`__DSH_BEATNEAR__` 报的 `dt` 为负就说明这一帧在节拍之前。

两个钩子留在仓库里（`src/app.js`、`src/core/engine.js`）；本轮其它实验（画开口、改发绺长度）全部回滚，
`npm test` 411 通过、`smoke` 22/22、绕序扫描无内外翻。

### 明美：近景第四十三轮 —— 张开时开口里**先看到暗腔，再看到粉色下唇**

上一轮弄清楚「帧要取在节拍上」之后，这一轮终于可以在**确认 pulse = 1** 的帧上量开口本身。
量具也换了：`.scratch/mouthprof.mjs` **先找嘴**（在下半张脸里找**暖色的**最暗像素 ——
全画面搜索会先找到头发的墨线，整张脸搜索会先找到睫毛的深蓝），再打印它那一列的剖面。

改前（t = 34.41502，下巴 −9 mm）：

| 行 | 颜色 | 是什么 |
| --- | --- | --- |
| 407–410 | `#3a1119` 系 | 墨线 |
| 411–418 | **(187,95,98)** | **粉色内唇，填满开口** |
| 419–423 | (119,54,61) | 舌 |

实片唱歌的嘴是：**墨线 → 一条牙齿的亮带 → 约 10 mm 的暗腔 → 才是粉色下唇**。
所以把**粉色内唇落到开口的底**（`y −0.005 → −0.008`，高度 0.0024 → 0.0019）。
改后同一列：

| 行 | 颜色 | 是什么 |
| --- | --- | --- |
| 407–410 | (58,17,25) | 墨线 |
| 411–417 | **(58,17,25) 4 mm** | **暗腔** |
| 419–425 | (187,95,98) 2.8 mm | 粉色下唇 |

对比见 `analysis/r31_mouth_ab.png`（上改前 / 下改后）。**测试也随之更新**：
「开口中段」的射线现在应当命中**暗腔**，而「开口底部」的射线才命中粉色 —— 并把这条安排的理由写在测试里。

### 明美：近景第四十四轮 —— 牙齿**根本没进画面**：一个列剖面会骗人

上一轮把开口的剖面量清楚了（墨线 → 4 mm 暗腔 → 粉色下唇）。实片在那条暗腔**上面**还有
**一条牙齿的亮带**，所以这一轮去查牙齿。结论是一条**工具上的教训**：

* 把牙齿染成纯绿再渲染：**131 个绿像素，在 407–412 行** —— 它们*在*画面里，
  但正落在**墨线所在的那几行**上；
* 把它们的 z 从 −5.6 mm 提到 −2.0 mm（原本在腔体前脸 −2.6 mm **之后**，也就是**根本看不见**）
  之后，绿像素仍在 407–412 行；
* 把颜色从 `#d6ccbd` 换成 `#ffffff`，**渲染逐像素不变** —— 因为嘴的内部**没有任何光照到**，
  toon 分档把它放进最低一档，白云石般的白色反照率出来仍是中棕色。

**真正的教训是量法**：上一轮那个「沿嘴中线打印一列」的剖面，
**只穿过墨线最暗的那一列**（x = 324），而牙齿是一条**横带** —— 要判断它在不在，
必须**逐行统计整条开口宽度**（本轮补了这一段：在 x 290–360 上按行分类「亮/暗/粉」，
才看出 409–418 行的「亮像素」其实是**两侧的脸颊**，不是牙齿）。

牙齿要显示出来，只有两条路，都留到下一轮定：

1. **单独给它一个不受光的材质**（+1 draw call —— 而预算是硬的 110，当前 109，要先省出 1 个）；
2. **换一个亮到能在最低档里仍然发白的反照率**（本轮试了 `#ffffff`，不足）。

本轮所有实验已回滚；`npm test` 411 通过、`git status` 干净。

### 明美：近景第四十五轮 —— 牙齿：**不受光的材质 + 挪到腔体前面**，两个都要

上一轮查明牙齿「在画面里但落在墨线的行上、且被 toon 分档压成中棕」。这一轮两条一起修：

1. **嘴的内部改成不受光材质**（`mouthInterior` 那个批量：舌、齿、粉色内唇）——
   嘴里**没有任何光照得到**，toon 分档必然把它放进最低一档。做法是把批量建好后
   **换掉它的材质**（`flatMaterial('#ffffff')` + `vertexColors`），三块各自的颜色按原样显示 ——
   **不加 draw call**（当前 109，硬预算 110）。粉色内唇的渲染值随之从 (187,95,98) 变成
   (196,102,109)，**正好是调色板里的 `#c4666d`**。
2. **牙齿从腔体后面挪到前面**：原本 `z = −5.6 mm`，前脸在 −3.5 mm，而腔体的前脸在 −2.6 mm ——
   它一直在暗腔的**内部**，一个像素都没出现过。挪到 `−2.0 mm`（前脸 −0.4 mm）。

改后同一帧（t = 34.41502，pulse 1）开口里的顺序终于和实片一致：

| 行 | 颜色 | 是什么 |
| --- | --- | --- |
| 404 | (90,39,48) | 墨线 |
| 408–412 | **(214,204,189)** + (58,17,25) | **牙齿** + 暗腔 |
| 414–418 | (58,17,25) | 暗腔 |
| 420–422 | (196,102,109) | 粉色下唇 |

对比见 `analysis/r33_mouth_ab.png`（上：无牙 / 下：有牙）。牙齿**还可以再窄一点**（现在约占开口的
一半宽，实片只是一条窄边）—— 留到下一轮，先记在这里。

### 明美：近景第四十六轮 —— 牙齿收窄到**开口的三分之一**

上一轮把牙齿做出来之后，它占了开口**一半**的宽度（`mw × 0.5`、1.4 mm 高），
而实片只是一条**窄边**。这一轮收成 **`mw × 0.3`、1.0 mm 高** ——
同一帧（t = 34.41502）里，牙齿现在是 x 306–318 的 4 mm 亮条，两侧与下方都是暗腔：

| 行 | 306 | 312 | 318 | 324 | 330 |
| --- | --- | --- | --- | --- | --- |
| 408 | 牙齿 | 牙齿 | 半 | 暗腔 | 暗腔 |
| 410 | 牙齿 | 牙齿 | 牙齿 | 暗腔 | 暗腔 |
| 412 | 牙齿 | 暗腔 | 暗腔 | 暗腔 | 暗腔 |
| 414 | 暗腔 | 暗腔 | 暗腔 | 暗腔 | 暗腔 |

对比见 `analysis/r34_teeth_ab.png`（上：宽条 / 下：窄边）。

（顺带记一条**自己的操作教训**：这一轮前两次「收窄」其实**没有生效** ——
替换用的字符串和文件里的行不一致（少算了 `MS` 之类的后续改动），
`grep` 一查才发现源码根本没变；**改完必须回查源码，而不是只看渲染**。）

### 明美：近景第四十七轮 —— 虹膜**又调暗回去**：上一轮的「变亮」量错了方框

第四十轮把虹膜调亮，依据是「暗部均值 40 对实片的 67」。这一轮按**部件**重新分类
（在各自的眼框里数：巩膜 / 虹膜（青）/ 头发（深蓝）/ 暗）才发现那个方框**把头发算了进去**：

| 眼框内 | 实片 105.5 s | 我们（改前） |
| --- | --- | --- |
| 巩膜（白） | 1087 | 1319 ✓ |
| **虹膜（青）** | **174** | **5349** ✗ |
| 头发（深蓝） | 1356 | 5571 |
| 暗（L<70） | 2983 | 57 |

实片的虹膜是**暗的身体 + 一圈青色边**（青只有 174 像素）；我们的虹膜**整块都是青色**。
所以把 `deep` 混比从 0.25 **改回 0.5**（第四十轮之前的取值），并把虹膜下半的提亮场从 0.62 收到 0.45。
按亮度分桶复核：0–30 档从 2601 涨到 **4184**（实片 2454）—— 现在偏暗的那一侧已经补上。

三只眼并排见 `analysis/r35_iris_ab.png`（左实片 / 中改前 / 右改后）：改后是「暗虹膜 + 青色边」，
与实片同一结构。

### 明美：近景第四十八轮 —— 先把**两个 draw call 省出来**（眼睑合并），再谈发际最后一处洞

这一轮本来要去补发际那条 **17.6 mm** 的缝（实片 3–10 mm），但先撞上预算：加一根发绺会到 **110**，
而 `test/parts.test.js` 的断言是 `draws < 110` ✗。所以这一轮做的是**腾地方**：

**四片眼睑（每只眼上/下各一）合并成两个批量** —— 每个材质一个（上睑用皮肤色、下睑用 `skinShadow`）。
它们从不独立于头运动（眼组只有固定的偏移与偏航），所以几何直接**烘进头空间**再合并：
`109 → 107` 个 draw call。

* 渲染差异：整帧最大通道差 **16**（一个像素）、平均 **0.246** —— 来自合并后**顶点色走 sRGB 直通**
  与原来 toon 材质的细微差别，肉眼不可见；
* 原来那条按名字取 `upperLid-1` 的断言改成取合并后的 `upperLids:solid`，
  **判据没有改**（眼睑必须压在眼上、且不超过眼高的 1.5 倍）；
* 绕序扫描从 79 个开放面变成 **80**（两个新批量替代四个单件）。

**这一轮也把「加一根发绺」试过并回滚**：加在 x=0.0145 之后，发际那一行的量测**完全没变**
（说明那根发绺的梢没到那一行），而 17.6 mm 的缝仍在别处 —— **下一轮先在整张发际图上定位那条缝**，
再决定加在哪，而不是猜一个位置。

### 明美：近景第四十九轮 —— 先在**发际图上量出洞的位置**，再决定加/加长哪一根

上一轮说过「先定位再动手」。这一轮的量具是 `/tmp/hemgaps.mjs`：在**分镜**的发际行上，
把皮肤的每一段行程换算成**世界 x（毫米，脸中心为 0）**。改前（104–112 行）：

| 行 | 最大的皮肤缝 |
| --- | --- |
| 105 | **18.6 mm（x −12…+6）**、14.0 mm（x +11…+24） |
| 112 | 31.6 mm（x −10…+20） |

**位置是两眼中线（x −12…+11）**，也就是「桥」那一段 —— 那里的两根发绺只有 26 / 34 mm 长
（第十九轮为了「停在眼睛上三分之一」把它们截短过 ✗，但**它们并不在眼睛上方**）。
实片恰恰把**最长的发绺放在两眼中线**上，所以这一轮把它们加长到 **40 / 46 mm**：

| 行 | 最大的皮肤缝（改后） |
| --- | --- |
| 105 | **12.1 mm**、13.0 mm |
| 112 | **9.3 mm**、10.2 mm |

**也试过、并被测试当场挡下的一次**：把 x = ±14 mm 那两根也加长 ——
它们落在**眼睛内眼角上方**（眼睛从中心 11 mm 一直延伸到 65 mm），
「眼睛上方的发绺必须停在眼睛上三分之一」那条断言立刻变红 ✓ —— 已回滚，只留下中线的两根。

### 明美：近景第五十轮 —— 整张脸**暗了 22 级**：这一次是把两张脸的**皮肤色调分布**放在一起量

前面几十轮量的都是「某一个部位的值」。这一轮换了**全局量法**（`.scratch/skinhist.mjs`）：
在两张对齐后的脸上，取所有**皮肤像素**，比**亮度十分位分布**与**平均 RGB**：

| | 实片 105.5 s | 我们（改前） | 现在 |
| --- | --- | --- | --- |
| 皮肤像素数 | 50804 | 51194 | 49882 |
| 平均 RGB | (206,176,151) | **(193,152,122)** | **(204,169,144)** |
| 饱和度 r−b | 55 | **72** | **60** |
| 落在第 7 个十分位（L 182–208） | **73%** | **4%** | **51%** |

也就是说：**实片的脸基本上是「一整块受光」的平色**（73% 落在同一个十分位），
而我们的脸暗了约 **22 级**（12%）、并且**更饱和**（r−b 72 对 55）——
这正是「脸上发闷/发脏」的来源，也是任何单个部位的量法都看不见的东西。

改法只有一处：把 `minmay.skin` 的反照率调亮并**轻微去饱和**（`#d4bda4` → `#e6dccc`）。
（先试过「把上脸那块阴影平面的不透明度从 0.54 降下来」—— 整帧最大通道差只有 **7**：
**贴图上的改动会被 toon 分档吃掉**，与牙齿那次是同一个原因，所以只能改反照率本身。）

对比见 `analysis/r38_skin_aligned3.png`：皮肤从(193,152,122)抬到(204,169,144)，
与实片的(206,176,151)相差在 **7 级**以内。

### 明美：近景第五十一轮 —— **头两侧的头发让头宽到 212 mm**（实片约 166）

把上一轮的「整块区域比色调分布」用到头发上（`.scratch/hairhist.mjs`：蓝主导的像素 =
头发，按亮度十分位与平均 RGB 比）：

| | 实片 105.5 s | 我们（改前） |
| --- | --- | --- |
| 对齐裁切里的头发像素 | 15762（16%） | **34663（33%）** |
| 平均 RGB | (23,50,96) | (19,47,85) |
| 皮肤像素（同一裁切） | 50804（51%） | 49882（50%） |

皮肤面积一致、头发却是**两倍** —— 说明**脸一样大，头发多出来一圈** ✓。
顺着这条线去量**头的宽度**（渲染上眼睛那一行的头发左右边缘）：**212 mm** ✗ ——
`PROPORTIONS.headWidth` 是 160，而侧发绺的轴心在颅骨外 4 mm、半径最大 21 mm，
于是每侧多出 27 mm 头发；**实片的侧发大约只有 10 mm 厚**。

改法：侧发绺**内移 10 mm**、半径整体**乘 0.8**（最大 21 → 17 mm）——
渲染上同一行量到 **192 mm**，整个头部轮廓明显收窄（`analysis/r39_lock_ab.png`）。

顺带把上一轮那条全局判据**再核一遍**：皮肤像素 51118、平均 (203,168,143)、饱和度 61 ——
与实片的 50804 / (206,176,151) / 55 仍然对得上 ✓（收窄侧发没有破坏肤色匹配 ✓）。

### 明美：近景第五十二轮 —— 侧发再收一档：头宽 192 → **184 mm**

上一轮把侧发绺内移 10 mm、半径 ×0.8 之后头宽 212 → 192 mm。这一轮再收一档
（轴心再内移 4 mm、半径再 ×0.82，最大 17 → 14 mm）：

| 眼睛那一行的头宽 | 第五十轮前 | 上一轮 | 现在 |
| --- | --- | --- | --- |
| | 212 mm | 192 mm | **184 mm** |

分镜里头的轮廓明显更贴近「头发贴着头」而不是「头发围成一圈」（`analysis/r40_head.png`）。
顺带确认了一件事：**对齐裁切里头发像素数几乎不变（33440 → 33442）** ——
因为那片面积主要由**发帽与刘海**（它们的根在颅骨半径 +10 mm 的壳上）决定，
侧发绺只是贴着它的边缘。所以「头发面积」这条判据量的是**发帽/刘海的覆盖**，
不是侧发的厚度 —— 两条线索要分开跟。

`npm test` 411 通过、`smoke` 22/22、绕序扫描无内外翻、107 个 draw call。

### 明美：近景第五十三轮 —— 眼睛量的是**开口**，不是布局里的高度

第三十二轮（第二十九轮那套）量的是「眼高 / 眼到下巴」，得出「眼睛小了 22%」并把 `eyeHalfV`
从 0.16 提到 0.19。这一轮换成量**开口本身** —— **虹膜 + 巩膜**，也就是观众实际看到的那块：

| 按眼到下巴对齐后 | 实片 105.5 s | 我们（改前） | 现在 |
| --- | --- | --- | --- |
| 开口包围盒 | 146 × 130 px | **165 × 150 px** | 165 × 146 |
| 虹膜+巩膜像素 | 4538 | **8011** | 6861 |
| 长宽比 | 1.12 | 1.10 | 1.13 |

**两次量法的结论相反**，因为它们量的不是一回事：布局里的「眼高」在第三十九轮把虹膜改成
「白巩膜里的圆盘」之后并没有变，但**看得见的开口变大了**（巩膜露出来了）。
以观众看到的东西为准，眼睛偏大 —— 所以 `eyeHalfV` 0.19 → **0.165**、`eyeHalfW` 0.17 → **0.15**。

分镜里脸因此**安静**下来（不再「瞪眼」），`analysis/r41_head.png`。

### 明美：近景第五十四轮 —— 把**眼睛本身的坐标**在实片里定下来（以及两次被污染的测量）

这一轮想把眼睛的尺寸最终定死，结果先花在**找实片的眼睛在哪**上 ——
前几轮用的坐标（x 970–1060、y 340–430）**把下半张脸当成了眼睛**：
按那套坐标采样，得到的是一整片**皮肤色**（203–223）。实片的眼睛其实在 **y 295–360、x 983–1050**：

| 实片右眼（逐点采样） | 结果 |
| --- | --- |
| y 300–348 | 近黑（0–59）：睫毛与虹膜的暗体 |
| y 340–356 | (53,71,70)、(95,98,84)：**虹膜的青色带**只在**下缘** |
| y 364 | (218,195,171)：眼下的皮肤 |

也就是说实片的眼睛是「**暗体 + 下缘一条青**」—— 与我们现在画的结构一致 ✓。

改坐标之后量到：**实片眼睛的暗部约 39 mm 宽**（不过右端仍可能与头发混在一起，
用它下结论之前要先把头发排除）；我们的暗部（虹膜 + 睫毛）是 **22–24 mm**。
按「巩膜在两侧都看得到」（第三十九轮的同比例放大图 ✓）判断，实片的虹膜**小于**整个开口 ✓，
所以 39 mm 更可能是「眼睛整体」而不是「虹膜」——两条线要分开量。

**这一轮试过并回滚**：把眼纹里的虹膜半径从 `h × 0.95` 提到 `h × 1.13`（按 39 mm 反推）——
渲染上的暗部**没有任何变化**（22–24 mm），而「虹膜是暗体 + 下缘亮环」那条断言变红 ✗。
说明 39 mm 这个数被污染了，**不能直接用**。

### 明美：近景第五十五轮 —— 眼睛：**三个窗口，三个答案**，取中间的

把眼睛的尺寸再量一次，这次用**排除刘海与头发**的窗口（实片 x<1055、我们 x 380–470、
y 从睫毛下方起）：

| 量法（都在眼到下巴对齐之后） | 实片 | 我们 |
| --- | --- | --- |
| 「眼高 / 眼到下巴」（第二十九轮） | 0.79 | 0.61 → 结论「小了 22%」 |
| 「虹膜+巩膜的包围盒」（第五十三轮） | 146×130 | 165×150 → 结论「大了 13%」 |
| 「暗部盒子（睫毛+虹膜）」（本轮） | **40×43 mm** | **36×32 mm** → 结论「窄 10%、矮 26%」 |

**三个窗口、三个方向相反或不同的结论**，每一个都自称「量出来的」。诚实的读法是：
眼睛与实片的差距在**四分之一以内**，真正能可靠对比的是**结构** ——
「暗体 + 下缘一条青 + 两侧巩膜」。所以这一轮把 `eyeHalfV` 取在三次测量的**中间**：
0.165（第五十三轮）→ **0.18**，渲染上的暗部盒子 36×32 → **36×34 mm**（实片 40×43）。

分镜见 `analysis/r43_head.png`；`npm test` 411 通过。

### 明美：近景第五十六轮 —— 头发**渲染出来比实片亮 1.8 倍**：沿头顶中线量一条剖面

这一轮用**竖直剖面**量头发（`.scratch/hairprof.mjs`：沿头顶中线，每 7% 高度取该行头发像素的平均亮度）。
按色板里的采样值（`#1c4f92`，实片头顶 `#03488f`）渲染出来：

| 头顶中线（行分数） | 0.02 | 0.09 | 0.16 | 0.31 | 0.45 | 0.89 |
| --- | --- | --- | --- | --- | --- | --- |
| 实片 | 58 | 61 | 56 | — | 55 | — |
| 我们（改前） | **109** | **127** | 115 | 77 | 29 | 57 |
| 我们（改后） | 94 | 121 | 104 | 46 | 27 | 28 |

**头顶亮了将近一倍**，而下方又比实片暗 —— 也就是「亮顶 + 暗底」的强梯度，实片基本是**一整块**
（56–61）+ 一点高光。原因是**朝向**：发帽的上表面正对主光，吃到最亮那一档。
把色板里的 `minmay.hair` 从 `#1c4f92` 压到 **`#0d2547`**（并保留原采样值在注释里），
头顶 127 → **121**、刘海/侧发 77 → **46**、下方 57 → **28** —— 整体变成实片那样的深海军蓝
（`analysis/r44_head.png`）。

**顺带修掉两条「字面写死旧色板」的测试**：`toonMaterial applies colour from a palette path`
与 `flatMaterial …` 把 `#1c4f92` 直接写在断言里 —— 色板一改就红。改成**从 `palette-data` 读**
（`import { color as paletteColor }`），断言的是「材质确实按路径取了色」，而不是某一个具体值。

### 明美：近景第五十七轮 —— 发帽的亮度梯度是**光**，不是画；改法只有一个：不受光

上一轮把发色压暗之后，沿头顶中线的剖面仍是「**上亮下暗**」（头顶 109–127、下缘 27），
而实片基本是一块（56–61）。这一轮查明了原因并修掉：

* 沿中线取样的是**发帽**（`hairCapMat`），它的梯度来自**壳的曲率**——上表面正对主光、
  侧面背光，于是依次吃到 toon 的各档；**贴图上的任何改动都会被档位压平**（本轮试了两次
  改 `paintHairTip`，渲染**逐像素一样的剖面** ✗）。
* 所以把发帽改成**不受光**（`flatMaterial` + 它自己的贴图）：于是**画上去的就是显示的**，
  梯度只剩画家画的那一层（`paintHairSurface` 的高光场 ✓）。
* 再把画家的两处调好：高光强度 1 → **0.6**、下方的暗场 0.72 → **0.85**。

结果：头顶 127 → **91**（实片 61），刘海 46 → 43，下缘 27 → 26，
而且**「前亮后暗」的对比仍在**（那条断言要求 ≥20 级；实片自己的头顶 58 对阴影里的长发 25 ≈ 33 级 ✓）。

对比见 `analysis/r45_head.png`：头发是深海军蓝 + 头顶一层柔和的高光，而不是一条从亮到暗的坡。

### 明美：近景第五十八轮 —— 发帽不受光之后，**画的值就是渲染的值**，于是可以直接对着实片配高光

上一轮把发帽改成不受光，于是「画上去多少 = 显示多少」，亮度不再被 toon 档位压缩 ——
这一轮就用这个直接关系把高光配准。沿头顶中线的剖面（每一行头发像素的平均亮度）：

| 头顶中线（行分数） | 0.02 | 0.09 | 0.16 | 0.24 | 0.31 | 0.45 |
| --- | --- | --- | --- | --- | --- | --- |
| 实片 105.5 s | 58 | 61 | 56 | 35 | — | 55 |
| 上一轮 | 74 | 91 | 80 | 61 | 43 | 26 |
| 现在 | **45** | **50** | **47** | **42** | **36** | **26** |

关键的一条在色板里：`hairHighlight` 是 `#5fa2e0`（**亮度 149**）—— 一个**在量头顶之前**
做的估计值，而实片**最亮的头顶**是 `#03488f`（亮度 71）：所谓「高光」比整帧里最亮的头发还亮，
这正是头顶一直压不下来的原因。改成 **`#1b4a86`**（亮度 77，就是实片那个受光头顶在 0.6 强度 wash
下的等效值），标注也从 `estimated` 改成 `sampled`。

对比见 `analysis/r46_hair_ab.png`（左：改前 / 右：改后）。

### 明美：近景第五十九轮 —— 额头上**头发是实片的四倍**（而「收窄发根」并没有动它）

把「整块区域比构成」用到**额头那一条带**（发际线到眼睛上缘之间）：按同一套判据数
皮肤 / 头发 / 其余。

| 额头带 | 实片 105.5 s | 我们 |
| --- | --- | --- |
| 皮肤 | 39% | 30% |
| **头发** | **8%** | **35%** |
| 其余（背景等） | 53% | 35% |

也就是说实片那条带子**大部分是皮肤**（刘海在那里只是几根细丝 ✓），而我们**三分之一是头发** ——
这正是对齐图里「实片额头露出来、我们被盖住」的来源。

**试过并回滚**：把发绺根部的张开从 `w × 1.15` 收到 `w × 0.85`（根部 6 mm → 4.4 mm）——
额头带的量测**完全没变**（30% / 35%）✗。也就是说**盖住额头的不是发根的张开**，
而是别的部件（发帽的下缘？发绺在壳上的排布？）——本轮想用「把发帽染蓝、发绺染绿」来定位，
**染色替换没有生效**（量到 0% 蓝 0% 绿），所以这条线索留到下一轮：
**先弄清是谁盖住了额头，再决定改哪里**。

### 明美：近景第六十轮 —— 额头是**发绺**盖的（射线证明），而它们的**宽度**几乎不影响它

上一轮的问题是「谁盖住了额头」。这一轮用射线把那条带子逐点问了一遍
（`.scratch/foreheadprobe.mjs`：13 个 x 位置 × 10 行 = 130 条沿 −z 的射线，报第一个表面的名字）：

| 第一个表面 | 命中数 |
| --- | --- |
| **发绺（fringeTip3…13）** | **69（53%）** |
| 发帽（hairCap） | 26（20%） |
| 颅骨（skull，即皮肤） | 25（19%） |
| 眼睑/眼球 | 10（8%） |

**是发绺，不是发帽** —— 这解释了上一轮「收窄发根无效果」：额头那几行落在发绺的**身体**上，
不在根上。顺着这条线再把**发绺本身收窄**（细的 2.6 → 2.0 mm、宽的 4.0 → 3.2 mm，共 11 根）：

* 额头带：头发 35% → **34%**（实片 8%）—— 只动了一点点；
* 渲染上能看出缝略宽（`analysis/r48_forehead_ab.png`，上改前 / 下改后）。

结论：额头被盖住的程度主要由**发绺的根数与间距**决定，而不是宽窄 ——
再往前就要动「少几根 / 拉开间距」，那会改变刘海的性质（第十五、二十八轮特意做过相反方向），
所以这一轮停在这里，把这条权衡记下来：**宽度这条杠杆已经用到头了**。

### 明美：近景第六十一轮 —— 发绺的锥度**是反的**：实片是「上细下宽」

上一轮的射线查明额头是**发绺**盖的，而收窄发绺的宽度几乎不动那个数（35% → 34%）✗。
这一轮顺着往形状看，发现真正的差别在**锥度的方向**：

* **我们**：刀形从**根部最宽**（`wRoot`）单调收到尖端 —— 也就是**最宽的地方正好在额头上** ✗；
* **实片**：每一缕从**分缝处很细**开始，往下**越落越宽**，最后收成尖 ✓ ——
  所以她的额头露得出来，而她的发际线下缘照样是密的 ✓。

于是把刀形的轮廓改写成**水滴**：根部是身体宽度的一半（`w × 0.5`），往下三分之一处最宽
（`w × 1.05`），再收成尖。

对比见 `analysis/r49_fringe_ab.png`（上改前 / 下改后）：改后发丝在分缝处细、往下渐宽，
与实片同一结构；`analysis/r49_head.png` 是整头。

**量测上的诚实记录**：这三次形状改动（根、宽、锥度）在「额头带」那个指标上**都是 35%** ——
说明那条带子的取样行**没有锚在发际线上**（我按手挑的行 ✓，两次锚点还不一致 ✗）。
形状已经按实片改对了，但「额头露出多少」这个数**目前还量不准**，
下一轮要先把它锚在**眼睛上缘**（用眼白/虹膜而不是暗色来定眼睛的顶边，否则睫毛会被当成眼睛）。

### 明美：近景第六十二轮 —— 把额头那条带子**锚在眼睛中心**之后：上一轮的水滴形**确实减半了覆盖**

上一轮承认「额头露出多少量不准」，因为取样行是手挑的。这一轮把它**推导**出来：
眼睛中心是两张图唯一能对齐的点 ✓，而它在发际线下方 0.22 个脸框、在眼睛上缘下方半个眼高 ——
所以带子 = `眼中心 − 0.22×脸框` 到 `眼中心 − 半眼高`，**每一行都是算出来的**（`.scratch/forehead.mjs`）。

| 额头带（锚在眼中心） | 头发占比 |
| --- | --- |
| 实片 105.5 s | **32%** |
| 我们（水滴形之前） | **79%** ✗ |
| 我们（水滴形之后） | **37%** ✓ |

**结论翻案**：上一轮那个「35% 纹丝不动」是**尺子的问题** —— 手挑的行根本没落在额头上 ✓。
用推导出来的带子一量，上一轮的水滴形把额头上的头发从 **79% 减到 37%**，与实片的 32% 只差 5 个点。
同一轮里皮肤的全局均值也复核过：**(202,166,141)** 对实片 **(206,176,151)** ✓，
而且**露出皮肤的面积反而增加**（49882 → 53807 px）—— 正是额头打开的结果 ✓。

分镜见 `analysis/r50_head.png`：刘海在分缝处是细丝、往下渐宽，额头从丝间露出来。

### 明美：近景第六十三轮 —— 在**交付尺度**上重看整张脸：鼻子是**六个记号**、嘴线**是皱眉**、发片**水滴形反了**

前六十二轮都在追单独的测量。这一轮换了做法：先用 `high` 档（`detail: 3`）在分镜机位、1280×720
**交付尺度**上把脸重新渲染一遍，逐张看，再把看出来的问题定位到代码。

> **`draft` 不能用来判断脸。** `draft` 是 `detail: 1`，`has(ctx, 3)` 为假 —— 刘海只留一半发丝、
> 鼻子那圈几何根本不存在。之前所有「看着还行」的印象都来自这个档位。

看出来的第一件事：脸中央是一个**棕色蘑菇 + 两个黑洞**。数了一下，同一个鼻子被画了**六遍**：
`paintFace` 的喙 + 两枚 `noseInk` 鼻翼 + **另两枚 `#6d3b2c`**（画在那个 `{}` 块**外面**，所以前两轮
改鼻子时漏掉了）+ 模型上的**两条 `#6b4436` 鼻翼球** + 一个 loft 鼻楔。

| 部位 | 处理 | 依据 |
| --- | --- | --- |
| 两条 `#6b4436` 鼻翼球 | **删** | 画家已经画了鼻翼，多出来的一对就是「四个洞」 |
| 两条 `#6d3b2c` 圆点 | **删** | 同上，且它在块外，是漏改的 |
| loft 鼻楔 | 保留、改**不受光** | A/B 渲染后只差 **25 px** —— 它几乎不可见 |
| 鼻部雕刻（7.5 mm 鼻尖） | 保留 | A/B 渲染后**没有可见变化** |

也就是说「蘑菇」不是几何、也不是雕刻，**是画出来的那个喙**。于是按实片实测的三段值
（**196 / 141 / 134**，对照脸颊 188）把它压平：底色描边 0.5 → **0.22**，两侧 0.28 → **0.12**，
鼻梁高光 `mix(skin,white,0.55)@0.5` → **`0.4@0.26`**。暗部填充保持 —— 单元测试按实片的
`fill = 0.56` 卡着（第一次改到 0.75 被判失败，填充**必须**是暗的，亮的只该是描边）。

第二件事：**嘴是一条皱眉**。`INK_Y` 是 `[-0.0008, 0.0004, 0.0022, …]` —— 中间比两角**高** 3 mm，
正好是它自己注释「两角比中间高 3 mm」的**反号**。6 倍放大下就是一条两端下垂的黑棒。
翻正之后，两角抬起、下唇跟着抬，开口才成为一条笑的弧。

同一处还发现：唇线**两端是方头**（`[0.0009, INK_R, INK_R, INK_R, 0.0009]` 里两端的 0.0009
**没乘 `MS`**，比中间还粗），于是收成一条**向两端收细的笔画**；`LIP_DROP` 回到 0。

**并且那条缝的测试本身是错的。** 它比的是「窗口内墨线最低点」与「窗口内下唇最高点」——
即**墨线的中间**对**下唇的角**。线是皱眉时两者恰好在同一站位，数字看着对；线一翻成微笑，
下唇的角合法地高过墨线的中间，测试就报「闭嘴漏了 1.8 mm」。改成**逐站位**比较（`tube` 的顶点
是按站位连续排布的，墨线与下唇走同一条 5 站位路径），阈值不变。

嘴里的三块也照着实片重做（`analysis/ref/zoom_mouth_film2.png`，5 倍）：实片的**牙是一大块**
（占开口上部约 40%、宽约 85%），不是一条 1 mm 细边；舌头是**大块鲑红**，不是粉色小珠。
牙加高到 2.2 mm，但**宽度受颅骨凹槽的窗口限制**（约 ±8 mm）—— 第一次放到 `mw*1.5` 时两端戳到
没有暗腔的位置，渲染出来是一根**横在嘴上的白棍**。

第三件事：**刘海是一排细针**。发片主体 1.8–2.0 mm（半宽）排在 9.5 mm 间距上，比缝隙还窄；
而 `blade` 的轮廓是「**发际处最窄**」的水滴形（上一轮为露出额头而改的），恰好让皮肤在发际下方
露成一排三角。实片的图是**反的**：发际处近乎连片（3–13 mm 缝），到下方才分成丝（13–26 mm）。
于是主体加宽到 3.2–5.8 mm（半宽，彼此交叠），水滴形**倒过来**：根部 0.86w→1.0w，最宽点仍在
`y(0.26)`。发帘因此从「梳齿」变成「有缺口的整块」。

第四件事：**上眼睑是一条亮奶油弧**。下眼睑第四十九轮就改成暗调了（注释写得很清楚），上眼睑
仍是 `minmay.skin` —— 一个凸起 1.7 mm 的小管在**凹**下去的眶里必然吃到 toon 最亮档，渲染出来
就是一对**白眉毛**，1× 下把两只眼睛都描了一圈奶油边。改成与下眼睑同源的 `minmay.skinShadow`，
因为实片那里是「墨线之后就是皮肤」，而眶里的一档皮肤本来就是暗的。

**验证**：411 项单测全过（其中两条断言因这一轮被**改写**：缝的逐站位测量、鼻子的填充值）。
肤色统计（只取脸框、去掉背景光斑）median **(211,183,158)** vs 实片 **(211,193,170)**，
L 的 p10/p50/p90 = 163/188/206 vs 实片 181/196/199 —— 中间调接近，**明暗跨度仍大 15%**，
是下一轮的活。交付尺度共 **106 draw**（预算 110），这一轮**没有新增任何网格**。

**还不好看的地方**（下一轮）：① 颊侧/下颌那片暗面**边界是直的硬边**，在 1× 下像贴纸；
② 下半张脸太长、**没有下巴**；③ 嘴在交付尺度下偏小；④ 发帘下缘仍偏「锯齿」。

对照图：`analysis/shots/face-review/face_review_sheet.png`（改前）与
`analysis/shots/face-review/iter7-delivery/closeup.png`（改后，1280×720）。

### 明美：近景第六十四轮 —— 「下巴没有下缘」不是比例问题：那块下颌阴影画在**贴图底边之外**，从来没被采样

第六十三轮把「下半张脸太长」列进了待办。这一轮先量它，量出来的第一件事是**比例本来就是对的**：
`FACE_LAYOUT` 的嘴在眼锚定脸框的 **0.604**，实片是 **0.60** ✓（`test/detail.test.js` 一直在守这个数）。
所以「长」不是长度，是**没有结尾**。

找到的是一个干净的错：`paintFace` 里那块注释写着「Jaw and under-chin … Without it the chin has no
edge and the head ends in a blur」的阴影，位置是 **`y = H * 1.04`** —— 而 `faceMapUVs` 到
`faceV(1)` 就结束了。**它画在贴图底边之外 4%，从来没有一个像素采到过它。** 那句话描述的效果
一直不存在，下巴和脖子因此是同一片浅色，脸没有下缘。

| 贴图上的比值 | 改前 | 改后 | 参照 |
| --- | --- | --- | --- |
| 下巴底 / 中心 | 0.891 | **0.752** | 实片下巴收在阴影里 |
| 下巴 / 下颌侧 | 1.000（一样亮） | **1.006**（最亮处） | 下巴是下半脸最亮 |
| 外颊 / 太阳穴 / 下颌侧 | 0.633 / 0.637 / 0.633 | **0.703 / 0.713 / 0.701** | 实片暗侧 **0.70–0.78** |

第三行是同一轮的另一件事：实片自己的暗侧是 0.70–0.78（`paintFace` 的注释里就写着），而我们的渲染
是 **0.633** —— 深了一档，1× 下读成「贴纸」而不是「转过去的脸」。太阳穴 0.6→**0.44**、外颊
0.5→**0.36**、外围多边形 1.0→**0.72** 之后回到 0.70 ✓。新的下颌阴影**画在贴图内**（`H*0.995` 的场
加一道随下巴形状走的月牙），旧位置那句注释留着，因为它是这块阴影失踪的原因。

**脖子比下巴还宽，而且和脸同色。** 量出来：脖子顶 0.033 半宽 = **66 mm**，下巴（`SKULL_SECTIONS`
最窄一行）0.024 × 截面比 = **45 mm**。比下巴宽的脖子让下巴**没有可以衬出轮廓的东西**；再叠上
「脖子 = 肤色、无阴影」，下巴、脖子、胸口就是一片连续的浅色。改成两段 loft：颈项一段暗调
（`mixColor(skin, skinShadow, 0.5)`），斜方肌与胸口保持肤色；上段收窄到 0.0245/0.025/0.027。

**分割环必须藏在衣领下面。** 第一版复用了 `y: 0.012` 那一环，它在 world **1.312**，而领口在
**1.308** —— 高出 4 mm，于是暗调的下边界成了一条横跨裸颈的**硬直线**，交付尺度下像一条颈圈。
loft 上的材质边界只能是一圈环，环只能靠「藏到东西下面」才消失：加一环 `y: 0.004`（world 1.304）
当分界，现在整段可见的脖子都是暗调，边界落在裙子里。

**验证**：411 项单测全过；交付尺度 **107 draw**（预算 110）、**23 材质**（上限 24）—— 这一轮多花
了一个 draw（脖子拆两段），仍然没有增加任何面数意义上的「细节」。肤色中位数 **(211,182,157)**
vs 实片 **(211,193,170)**：明度接近，**暖度仍高 13 级**（r−b 54 对 41）。

**还不好看的地方**（下一轮）：① 下半张脸仍是一大片均匀皮肤，下巴**没有体积**；② 交付尺度下
**嘴偏小**；③ 侧发在 3/4 视角是一块**直边平板**；④ 皮肤整体偏橙。

对照图：`analysis/shots/face-review/iter11-delivery/closeup.png`（1280×720）与
`analysis/shots/face-review/facegrid_iter9.png`（与原片对齐）。

### 明美：近景第六十五轮 —— 第六十三轮**把刘海加宽是改错了方向**：实片额头的头发是 32%，我从 54% 加到了 64%

第六十三轮看「发帘像梳齿」时，结论是「发片太窄、缝隙和发丝一样宽」，于是把发片主体从 1.8–2.0 mm
（半宽）加宽到 3.2–5.8 mm。这一轮换了参照物之后发现**那是反的**。

新参照：`analysis/ref/face1055_face.png` —— 105.5 s 那一帧的脸**按 1920×1080 原分辨率裁出来放大
2.5 倍**。之前所有比对用的 `face1055_big.png` 是缩小过的，发丝在那里已经糊成一团。这一张能看清：
实片的刘海是**又长又斜、彼此交叠的发绺**，额头上露出大片皮肤；而我们在同一位置的头发是**一片实心
的整块 + 一排三角齿**。

用项目自己的量具（`.scratch/forehead.mjs`，锚在眼中心、带宽是推导出来的）量「额头带里的头发占比」：

| 同一把尺 | 皮肤 | 头发 |
| --- | --- | --- |
| 第六十三轮之前（水滴形、窄发片） | 22% | 54% |
| 第六十三轮之后（加宽后） | 20% | **64%** ✗ |
| 这一轮（回退宽度 + 加长加斜） | **25%** | **59%** |
| 实片（第六十二轮自己的尺，约合本尺 47%） | — | **32%** |

**回退是有代价的**：`the fringe hem has no hole wider than the film's gaps` 要求**至少 12 束**、
中心间距 3–14 mm。我先试了「减到 10 束」，这条断言立刻失败 —— 那条测试编码的正是实片自己的间距
范围，所以**束数不能减，只能减宽度**。宽度回退后发帘重新露出皮肤（20% → 25%），但仍是「一排
垂直的牙」。于是第二步改**形态**：15 束的 `len` 全部加长三分之一、`drift/bend` 同步加大，让每束
在下落时横移 5–8 mm。渲染上从「垂直短齿」变成「斜向长发绺」，尖端落到眼睛上缘 ✓（`the strands
over the eyes stop in the eye's upper third` 仍然通过）。

**下巴这一轮没有解决，但留下两条结论。**
① 「画一个亮的下巴球」是错的：`mix(skin, white, 0.42)` @0.6 渲染出来是一枚**贴在脸上的浅色圆点**，
实片的下巴只比周围略亮一点、而且**宽**；改成宽而柔和的场（`W*0.19`、0.34 强度）之后不再刺眼，
但体积感仍然不足 —— 这是下一轮的活。
② **眉毛这一次用原分辨率确认过了**：`analysis/ref/zoom_brows_film.png` 里眼睛上方那些深色形状
**全是刘海发绺**，没有一条独立的眉线。第四十一轮「眉毛在头发后面」的结论是对的，这一轮曾一度
误判，记在这里以免下次再翻案。

**验证**：411 项单测全过；交付尺度 107 draw / 23 材质（与上一轮持平，这一轮**只改了参数与轮廓**）。

**还不好看的地方**（下一轮）：① 下半张脸仍是均匀皮肤、**下巴没有体积**（这一轮试过两条路都不行）；
② 交付尺度下嘴偏小（而宽度被实片的 0.20 钉住，只能从**嘴唇的形**上做）；③ 侧发在 3/4 视角是
直边平板；④ 皮肤偏橙（r−b 54 对实片 41）。

### 明美：近景第六十六轮 —— 唇下阴影**画在了下唇后面**：下唇是铰链上的几何，它盖住的是 26 mm 而不是 8.6 mm

上一轮留下的「下巴没有体积」，这一轮的结论是：**缺的不是阴影，是唇下那道接触阴影一直没出现**。

先量出来的是几何本身：`.scratch/lipbox.mjs` 打印下唇相对嘴根的位置——闭嘴时 **-9.8 mm**、张嘴时
**-18.9 mm**。而画在 `mouth + 0.07`（唇下 11–17 mm）的那道月牙，在张嘴的帧里正好**被下唇盖住**。
沿中轴逐行比对贴图与渲染（`.scratch/colcompare.mjs`）：

| faceV | 唇下 mm | 贴图 L | 渲染 L |
| --- | --- | --- | --- |
| 0.70 | 12.8 | 214 | **185** |
| 0.74 | 19.1 | **144** | **185** ← 阴影在贴图里，不在画面里 |
| 0.78 | 25.5 | 199 | 163 |

185 正是下唇自己的平涂色 —— 它把阴影挡住了。

**这一轮试了四条路，前三条的失败都记在这里**：
1. **一个亮的下巴球**（`mix(skin,white,0.42)`@0.6）→ 渲染成一枚**贴上去的浅色圆点**；改成宽柔的场
   （`W*0.155`、0.34）后不刺眼，但体积仍不足。
2. **把月牙移到下唇之下**（唇下 27–32 mm）→ 出现了，但和唇之间隔着 13–17 mm 的空白，读成
   **第二条弧**（像双下巴线）。
3. **给下颌加一条阴影管**（跟着铰链动，这才是对的模型）→ **材质槽不够**：`minmay stays within a
   draw-call budget` 卡在 24/24，加一个材质就到 24 ✗。改用**墨线材质**（复用，不新增）→ 渲染成
   一条近黑的宽带，在脸上读成**胡子**（`analysis/shots/face-review/zoom_chin25.png`）。
4. **把色调烘进下唇自己的顶点色** ✓ —— 一个 mesh、一个材质、一个 draw，阴影跟着下颌走。
   `lipMat.vertexColors = true`，唇的高处顶点白、低处顶点是**乘数**；上唇补一条全白顶点色，
   否则共享材质会把它渲成黑色。

**两个技术点值得单独记**：
- **乘数要在线性空间取比**。先写的是 sRGB 字节相除，渲染出来是一块**去饱和的灰**；three 在线性空间
  做乘法，所以正确做法是先把两者都转到线性再相除。
- **顶点色的台阶边界＝圆环的分段数**。8 段的管子上，烘出来的阴影下缘是**锯齿**；把嘴部三条管
  （墨线、上唇、下唇）都提到 14 段才成为一条线。这同时**耦合了缝的测试**：它按站位（ring）逐段
  比较墨线与下唇，所以 `RING` 常量随之从 8 改成 14。

**验证**：410 项单测全过（`the shadow under the lower lip…` 被重写：贴图那一半保留为「唇自己的
footprint 不许被涂暗」，几何那一半随阴影一起搬到了顶点色上）；交付尺度 **107 draw / 23 材质**
—— 与上一轮**完全持平**，这一轮没有新增任何 mesh 或材质。

**还不好看的地方**（下一轮）：① 交付尺度下**嘴偏小**（宽度被实片 0.20 钉住，只能做唇形与开口）；
② 侧发在 3/4 视角是**直边平板**；③ 皮肤偏橙（r−b 54 对实片 41）；④ 下半张脸仍偏平。

对照图：`analysis/shots/face-review/iter28-delivery/closeup.png` 与
`analysis/shots/face-review/zoom_chin28.png`（唇下阴影）。

### 明美：近景第六十七轮 —— 「皮肤偏橙」不是调色板，是**颌下阴影场上溢到下巴**；下唇不该和上唇共用半径表

两轮以来一直挂着的「皮肤偏橙（r−b 54 对实片 41）」，这一轮按**区域**量了一遍
（`.scratch/boxsample.mjs`，脸上取 7 个点）：

| 区域 | 改前 r−b | 改后 r−b |
| --- | --- | --- |
| 脸颊 | 45 | 45（实片约 41–47 ✓） |
| 鼻 | 50 | 50 |
| 颈 | 61 | 50 |
| 颌侧 | 64 | 64（实片自己的暗侧就是这条暖色） |
| **下巴** | **74** ✗ | **61** |

所以暖色**不是整张脸的问题，是下半脸**：那块「颌下阴影」场（`r: W*0.5`、strength 0.62）从贴图
最后一行往上铺，一直铺到嘴的高度，把下巴整个染成了最暖的一块。收成 `r: W*0.42` 并把衰减
从 `power 0.9` 加到 **1.5**（核心更紧、上溢更少），再给下巴的亮区加一点白。全局统计随之落到
**中位 (215,191,168)** 对实片 **(211,193,170)**、暖度 **47** 对 41、p50 **196** 对 196 ✓。

**下唇原来和上唇共用一张半径表，所以下唇最薄的地方正在它中间。** 实片的上唇是**两个峰夹一个
凹**（唇弓），下唇是**单一饱满的弧**——一张表不可能同时是这两样。给下唇自己的表
（`LOWER_RADII`，中间 0.00155 对两端 0.0009），并且**唇线路径按每个站位自己的半径定位**，
所以上缘仍然正好落在墨线上，缝的闭合没有变（逐站位测试原样通过）。

**唇下阴影的取样方式改了三次，三次都是渲染说了算：**
1. **固定高度** → 下唇中间更低，唇的底部从阴影里**戳出来一个淡 V**；
2. **跟着唇的中心线 + 厚带** → 带子均匀了，但下凹的厚带读成**一支箭头**；
3. **跟着中心线 + 薄带（下半部的三分之一）+ 更柔的色调** ✓ —— 才是一条贴着唇下缘的柔影。

**验证**：410 项单测全过；交付尺度 **107 draw / 23 材质**（与上一轮持平——这一轮只改参数、
半径表与顶点色的判定，没有新增 mesh、材质或 draw）。

**还不好看的地方**（下一轮）：① 交付尺度下嘴仍偏小（宽度被实片 0.20 钉住，只能继续做唇形）；
② 侧发在 3/4 视角是**直边平板**；③ 明暗跨度仍大（p10 161 对实片 181）；④ 下半张脸偏平。

对照图：`analysis/shots/face-review/iter34-delivery/closeup.png`、
`analysis/shots/face-review/zoom_mouth34.png`（唇下阴影）、`facegrid_iter34.png`（与原片对齐）。

### 明美：近景第六十八轮 —— 睫毛的公式**峰值在中间**（与它自己的注释相反）；虹膜缩小的尝试**被渲染否决**

把实片和我们的眼睛**按同一尺度并排放大**（`analysis/shots/face-review/eye_ab.png`：左=我们、
右=`analysis/ref/eye_film.png`），差别立刻具体了：实片是**一条越往外眼角越重的睫毛线**，我们是
**横在眼睛上方的一条黑棒**。

原因在代码里，而且和它自己的注释相反：
`0.135 + 0.58 * sin(min(1, t*1.12) * π)^0.7 * (0.34 + t)` —— 这个正弦**在 t=0.5 取最大、到
t≈0.89 回到零**，即睫毛在**眼睑中间最厚、外眼角最薄**，正是那段注释写着要避免的排布。
改成**单调**的 `0.09 + 0.56 * t^1.25`（内眼角 0.09h、外眼角 0.65h），才成为实片那条
「细→粗→飞出去」的线。

同一轮里另两处照着实片改：**高光缩小**（`0.26/0.14` 的虹膜半径 → `0.17/0.10`，并补两枚小点），
**青绿从"一圈边"移到"虹膜中下部"**（那个"抬起场"从 0.45@0.32 提到 0.72@0.52，边环从 0.95 压到
0.62）——实片的绿在中下部，边环只是它的一道边。

**虹膜缩小：量对了，渲染否决。** `paintEyeSurface` 自己的注释写着实片是「嵌在大片眼白里的圆盘，
约 40% 的开口是白的」，而代码把虹膜设成 0.95 个半高（填满开口）。我按注释缩到 **0.58**，
8 倍放大下确实出现了眼白 ✓ ——**但交付尺度下变成一双瞪眼**：实片的眼白之所以大，是因为它的开口是
**窄杏形**（上方睫毛、下方下眼睑），而我们的开口是**圆顶从圆眶里露出的一个圆帽**，同样的比例就
渲染成一整圈奶油色的环（`iter40-delivery`）。退到 0.88 仍是一圈。所以虹膜**还原到 0.95**，
只保留这一轮真正成立的三处（睫毛、高光、青绿）。**要真正拿到那片眼白，得先改开口的形状**
——那是下一轮的活（眼眶/眼睑几何，不是贴图）。

**验证**：410 项单测全过；交付尺度 107 draw / 23 材质（持平）。对照：`eyes_final2.png`
（交付尺度下 改前/改后 的眼睛）。

**还不好看的地方**（下一轮）：① **开口是圆的**，因此拿不到实片那圈眼白——要改眼眶/眼睑几何；
② 侧发在 3/4 视角是直边平板（发帽；发绺在它下面才出现）；③ 明暗跨度仍大（p10 161 对实片 181）。

### 明美：近景第六十九轮 —— 两条挂了很久的「缺陷」都是**量测伪影**：明暗跨度是滤镜造成的，嘴小是**抽帧抽在节拍之间**

**① 「明暗跨度比实片大 15%」是肤色过滤器造成的。**

`.scratch/skinstat.mjs` 用 `r−b ∈ 15..80` 筛皮肤，而这个上限**把实片的暗侧排除在外、却把我们的
暗侧算了进来**（实片的暗侧是 `#ba6d46`，r−b ≈ 116；我们的暗侧 r−b ≈ 64）。把窗口放宽到 130
（暗侧都算进来）重测：

| 同一把尺，含暗侧 | p10 | p50 | p90 | 跨度 |
| --- | --- | --- | --- | --- |
| 实片 105.5 s | 123 | 194 | 199 | 1.61 |
| 我们 | **126** | 186 | 207 | **1.64** ✓ |

跨度与暗端都对上了 —— **上一轮那条结论作废**。

**② 「交付尺度下嘴太小」是抽帧抽在节拍之间。**

`beatPulse(beats, t, 0.12)` 只在**节拍后的 0.12 秒内**非零，而一拍是 0.55 秒 —— 嘴每拍只张 0.12 秒。
我上一轮随手抽的 6 帧（36.0 / 36.15 / …）**全部落在节拍之间**，测出来的「开口 4–5 px」其实是
**墨线本身的粗细**。按 `TEMPO`（0.302 + k×0.55021）取准拍点之后：

| 帧 | 开口 |
| --- | --- |
| t = 36.06（拍点） | 刚开 |
| **t = 36.08（拍点 + 0.02 s）** | **完整张开：墨线 + 牙带 + 暗腔 + 鲑红舌头** ✓ |

对照图 `analysis/shots/face-review/mouth_three.png`（上=实片 / 中=我们的拍间帧 / 下=拍点帧）与
`beat_mouths.png`。**嘴的形状是对的**；以后判断嘴，必须先算拍点（`.scratch/apfull.mjs` 量开口高度）。

**③ 腮红从「外颊」移到「苹果肌」。** 原来在 `u = 0.18`，那已经是外围暗面的位置：量出来脸颊
r−b 45，与实片中位一样、并不比别处粉。第一次移到 `faceV 0.58` **又落到了嘴的高度**——
`FACE_LAYOUT` 里嘴就是 0.62；第二次才到眼下（`u 0.28 / faceV 0.42`，即眼中心 0.22 与嘴 0.62 之间）。

**验证**：410 项单测全过；交付尺度 107 draw / 23 材质（持平）。

**还不好看的地方**（下一轮）：① 侧发在 3/4 视角是直边平板（发帽；发绺要到颌下才出现）；
② 眼睛的开口仍是圆的，拿不到实片那圈侧向眼白；③ 鼻梁那道高光在近景里是一条硬边浅色柱。

### 明美：近景第七十轮 —— 眼睛是**圆的**：`eyeHalfV` 是布局用的数，却被当成了眼睛自己的半高

上一轮把「眼睛拿不到实片那圈侧向眼白」列成了待办，这一轮找到了根：

`sculptSkull` 的眼窝和 `buildFace` 的眼穹都用
`FACE_LAYOUT.eyeHalfV * (1 - hairline) * span` 当**眼睛自己的半高**——
算出来 **27.3 mm，而眼宽是 27.8 mm**，也就是说**眼窝、眼穹、眼睑全都是 1.1:1**，是圆的。
眼睛的贴图是 **160×112（1.43:1）**，被拉伸到这块更圆的四边形上，整个特征就比实片圆；
更要紧的是**圆的开口没有"眼角"**，所以上一轮把虹膜缩小之后，眼白只能渲成一整圈环，
而不是实片那样两块侧向的细白。

`eyeHalfV` 是**布局**用的数（把眼睛锚在脸框里、`rel()` 换算用），不该兼作眼睛自己的高度。
引入 `EYE_ASPECT = 1.4`（实片的比例，代码注释里本来就写着「6.3 × 4.3 cm almond，实片自己的
1.4:1」），眼窝与眼穹都从**眼宽**除出来：

| | 改前 | 改后 |
| --- | --- | --- |
| 眼宽 × 眼高 | 27.8 × 27.3 mm（1.02:1） | 27.8 × 19.9 mm（**1.40:1**） |
| 开口 | 圆，没有眼角 | 宽杏形，**内眼角出现眼白** ✓ |

虹膜随之从 `0.95 × 0.95` 改成 **`1.05 × 0.95`**：贴图 160×112 映射到 1.4:1 的穹顶上，
「贴图里的圆」在脸上本来就是椭圆，真正要守的是**比例** —— 实片的虹膜占开口宽的约四分之三、
高几乎占满，而 0.95 的圆只占 66%，这正是眼白渲成两大块楔形的原因。

**验证**：410 项单测全过；107 draw / 23 材质（持平；眼睛只有一个 mesh，改的是它的形状）。
对照：`analysis/shots/face-review/eyes_delivery_ab.png`（交付尺度，上=改前 / 下=改后）、
`eye_ab46.png`（与实片同尺度并排）。

**还不好看的地方**（下一轮）：① 侧发在 3/4 视角是直边平板（发帽；发绺要到颌下才出现）；
② 内眼角的眼白仍比实片大（实片是细月牙）；③ 鼻梁那道高光在近景里是一条硬边浅色柱。

### 明美：近景第七十一轮 —— 鼻子的暗部**填了喙的三分之二**：9 倍下是一片棕色贴片

上一轮列出的「鼻梁高光是一条硬边浅色柱」，放到 9 倍下看
（`analysis/shots/face-review/nose46.png`）才发现真正扎眼的是**暗部填充的面积**：
`cut = ny - H*0.03` 让填充从喙的上三分之一就开始，整个鼻子成了一块**带直上边缘的棕色贴片**
——像贴纸，不像阴影。实片的三段值是 **196 / 141 / 134**：上三分之一是亮的，往下**一起**变暗，
最暗的是**底面**。把裁切线移到喙的**中线**（`ny + H*0.004`）之后，鼻子成了
「亮楔形 + 底面一条暗带」✓，交付尺度下也从"棕色一团"变成"有鼻尖阴影的鼻子"。

**验证**：410 项单测全过（`the nose is a filled shape…` 的**面积**与**填充**两个比值都仍然成立：
暗部只是变小、不是变浅）；107 draw / 23 材质（持平）。
对照：`analysis/shots/face-review/nose_delivery_ab.png`（交付尺度，左=改前 / 右=改后）、
`nose_ab.png`（9 倍）。

**还不好看的地方**（下一轮）：① 侧发在 3/4 视角是直边平板（发帽；发绺要到颌下才出现）；
② 内眼角的眼白仍比实片大（实片是细月牙）；③ 喙的轮廓描边在 9 倍下是断续的（1× 下不可见）。

### 明美：动作第七十二轮 —— 身体的「抖」是**节拍上顶 + 绕脚旋转**；换成髋→膝→脊柱的**重心链**

用户看渲染时说「身体上下抖动、看起来奇怪，动画里是配合身体和腿脚自然左右摇摆」。查下去是两个源：

1. **节拍上顶**：`applyPose` 里 `bob = |sin(t*0.62)|*0.012*e + pulse*0.02*e`。第二项是每拍把**整个人**
   顶起 16 mm（×energy）。而 `beatPulse(beats, t, 0.13)` 在拍点那一帧就是 **1.0**、之后只按 `k²` 衰减
   ——**没有起振**，所以是"一帧跳上去、0.13 秒滑下来"，而一拍是 0.55 秒：**76% 的时间停在原位**。
   逐帧互相关实测：0.13 秒内整体移动 **29 px = 18.7 mm**，在这一取景里是画面高度的 **4.6%**。
2. **绕脚旋转**：`root.rotation.z = shift*0.35` —— 整个人**绕自己的脚**转，重心没有移动、脚在甩、
   头走弧线。

**改成一条链，每一环都在骨架上**（`JOINTS` 里本来就有 `hipL/R`、`kneeL/R`）：

```
髋横移到支撑脚上方  →  骨盆侧倾（支撑侧髋抬起）  →  非支撑膝屈、支撑腿伸直
                   →  脊柱与胸腔反向倾（胸廓留在脚上方）  →  头保持水平
                   →  身体在"完全过到一条腿上"时升高几毫米
```

一个相位驱动全部；**垂直运动放在两倍摇摆频率**上（过支撑腿时升、经过中间时降），因此不再需要
节拍。振幅刻意很小：1.69 m 的人**髋横移 2 cm、起伏 8 mm**（实测两端 6.4 mm）。

| 量 | 改前 | 改后 |
| --- | --- | --- |
| 拍点后 0.13 s 的整体位移 | 18.7 mm（一帧跳起） | **1.9 mm**（只剩摇摆本身的慢速运动）✓ |
| 横移 | 无（只有绕脚旋转） | 髋 **±16 mm**（energy 0.8） |
| 膝 | 不动 | 非支撑膝 0.030 → **0.078**，两侧交替 ✓ |
| 头 | 跟随弧线 | 四段之和互相抵消，**保持水平** ✓ |

**节拍现在只驱动嘴**（`mouth.jaw`），那才是真正跟着唱的东西。

**并且把它编成了测试**：`the sway is a weight shift, and the beat no longer moves the body` ——
断言髋横移 > 3 cm（两端）、两膝各自变化 > 0.03、四段倾角**变化量之和** < 0.02 rad（头保持水平），
以及**同一时刻有/无 pulse 时身体姿态完全相同**。（第一次写时把"四段绝对值之和"当成了判据，
那是错的：姿势本身就带这四个关节的值，要守的是**两端之差**。）

**验证**：411 项单测（新增 1 条）、22 项 smoke 全过；交付尺度 107 draw / 23 材质（持平——只改了
`applyPose` 里的运动学）。对照条：`analysis/shots/face-review/sway/sway_strip2.png`（四个相位：
重心右 / 中间 / 重心左 / 中间）与 `sway_ab.png`（两个极端，含头部）。

### 明美：动作第七十三轮 —— 上一轮的摇摆**让脚在溜冰**：髋横移带着两条腿走，要加**腿部外展**才站得住

第七十二轮把身体改成重心链之后，这一轮去量「腿脚」那一半，量出来的第一件事是**脚在滑**：
`.scratch/feet.mjs` 打印两只 `bootFoot` 的世界 x —— 因为髋的平移会**带着两条腿一起走**，
整个周期里两只靴子**同向**滑了 **53 mm**。全身分镜里那就是溜冰。

真实的身体不是这样：重心过到一条腿上时，**支撑腿在身体下方内收、自由腿外展**，脚是不动的。
所以给两个髋关节加一个反向的外展角去抵消平移。系数**不是推导出来的，是量出来的**：
闭式解（`位移 / 腿长`）假设靴子在髋的轴线上，而它在 ±55 mm 外侧、骨盆还有侧倾 —— 两次渲染
（0.025 剩 11 mm、0.033 剩 24 mm）解出 **0.018**：

| 外展系数 | 一个周期内靴子横滑 |
| --- | --- |
| 0（只有髋平移） | **53 mm** ✗ 溜冰 |
| 0.025 | 11 mm |
| 0.033 | 24 mm（过头了） |
| **0.018** | **4.3 mm** ✓（而且是两脚轻微**张开**：支撑腿伸直、自由腿外展） |

**摇摆曲线也从正弦改了。** `sin` 在**两端最快、中间最慢**，正好和人的重心转移相反：人是
「到位 → 停一下 → 再走」。把 `|sin|` 提到 **0.72 次方**，值被推向 ±1，于是在一条腿上停留更久、
经过中间更快 —— 周期和振幅都没变，读感不同。

**并且把「脚不许滑」写进了测试**（`the sway is a weight shift…` 的第 2 条）：`bootFootL/R` 在
两个极端之间位移必须 < 10 mm，而髋横移必须 > 30 mm。这条断言正是用户要的「配合腿脚」。

**验证**：411 项单测全过；22 项 smoke 全过；107 draw / 23 材质（持平）。
对照：`analysis/shots/face-review/sway2/sway_full.png`（三个相位的躯干）、
`analysis/shots/face-review/sway2/finaleClose.png`（全身，脚是站住的）。

### 明美：动作第七十四轮 —— 手臂**不跟着身体走**、以及「节拍器不是身体」：加滞后拖拽与相位漂移

第七十三轮把重心链补完了，这一轮补两处"自然感"：

**① 手臂原来只由姿势表驱动**，于是躯干在两条**不动的胳膊**下面移动，肩看起来和身体脱开。
真实的肢体是**拖着走的**——所以手臂项取的是位移的**导数**（`cos` 对 `sin`）并加相位滞后，
和头发用的是同一条跟随原则。两个肩关节是**镜像**的，同一个世界方向要取相反的本地符号。

**② 完美的周期本身就是机械感。** `sin(1.15t)` 每一轮都一模一样，无论曲线多好都会读成机器。
改成**相位**漂移：`swayPhase = t*1.15 + 0.35*sin(t*0.21)` —— 身体在约 30 秒的尺度上时快时慢，
像人的注意力在一首歌里游移。用**相位**调制而不是调制**速率**，因为 `t * rate(t)` 的导数并不是
它看起来的那个，速率一变动作就会跳。

实测（`.scratch/swaynode2.mjs`，每 1.15 s 采一次、跨 10 s）：髋横移 ±20 mm 而采样值依次是
19.9 / 4.0 / −19.2 / −12.8 / 15.1 …，说明周期确实不再固定 ✓；肩关节在姿势基值上叠加
±0.024 rad（约 1.4°，手端 ±15 mm）✓；靴子始终在 −62.7…−66.2 mm（**±1.8 mm**）✓ 站住。

**改了一条老测试的测点**：`applyPose writes joint rotations and adds sway` 原来断言
`shoulderR.rotation.z` **精确等于**姿势值 —— 肩关节现在有程序化的拖拽叠加，所以这条"姿势被原样
写入"的性质改在**肘关节**上守（动画从不碰它），肩的行为由 `the sway is a weight shift…` 覆盖。

**验证**：411 项单测、22 项 smoke 全过；107 draw / 23 材质（持平）。
对照：`analysis/shots/face-review/sway3/sway3.png`（三个相位：一侧 / 另一侧 / 回来）。

### 明美：动作第七十五轮 —— 膝盖一弯，**脚在前后方向滑**：给髋配一个反向屈曲

第七十三轮修的是**横向**滑（髋平移带着腿走，53 mm → 4 mm）。这一轮换成**侧面**去看，发现还有
第二个滑：**膝盖是肢体中段的铰链，弯它会把下面的一切都带走**。量出来（`.scratch/kneedir.mjs`）：
自由侧的膝角闭合 0.06 rad 时，那只脚**向后走了 23.5 mm** —— 正面看不出来，3/4 视角就是溜冰。

修法：**在髋上配一半角度、方向相反**（大腿向前、小腿向后），脚就留在原地。于是这条腿读起来
正是它实际的样子：**非支撑侧的膝盖向前**。

| 量的东西 | 改前 | 改后 |
| --- | --- | --- |
| 自由脚前后位移 | 23.5 mm | **1.7 mm** ✓ |
| 自由脚横向位移 | — | 1.8 mm ✓ |
| 自由脚抬起（脚跟离地） | — | **6 mm** ✓（自然的重量转移） |

**测试也扩到两个轴**：`the sway is a weight shift…` 里那条"脚不许滑"现在同时断言 `dx` 与 `dz`
都 < 10 mm —— 原来只守横向，所以这个前后滑能在测试全绿的情况下存在。

**验证**：411 项单测、22 项 smoke 全过；107 draw / 23 材质（持平）。
对照：`analysis/shots/face-review/legs2/legs_side2.png`（侧视两个极端：脚不动、膝有区别）。

### 舞台第七十六轮 —— 「架子」是**几段各挂各的**：架环没在自己的高度上，立柱是两截，整组又被抬高了一次

用户按时间点报的：**19s / 28s / 2m40s / 4m50s 的高度不对（过低）**，而 **49s 是对的**；并且提醒
「这个架子由好几个部分组成，调整高度时注意同步」。四个时间点全部落在 `emblemStage` 场景
（`materialize` / `emblemOrbit` / `emblemOrbit2` / `emblemFinaleA`），49s 是 `hangarReveal` 的小全息台。

量出来是三处各自为政：

| 部件 | 代码里的高度 | 实际落点 |
| --- | --- | --- |
| **架环**（那圈格构） | 唯一写成 `offset: 0` 的部件 | 世界 **1.5–3.6**，而她头顶是 **2.05** ✗ 横穿胸口 |
| **立柱** | 从 `topY + half*1.4` 往上（14→19.5） | 而它的**柱脚**在台面、**拉索**却是从 14 拉到台面 —— 两根短柱 + 两根线，中间空的 |
| **整组** | `buildStage` 又加 `position.y = 2.6` | 两个构建器本来就从**台面**量起，这一下把整套**连同锚点**抬到空中 |

修法就是「一个高度」：架环 `offset: topY`（灯就吊在它下面、立柱从它上面起、拉索从它拉到台面）；
立柱改成**从台面扎到顶帽、穿过架环**（网腹也按全长重排）；`hang = 0`。于是
`lightingTruss` 的包围盒从 `1.52 .. 22.17` 变成 **-0.71 .. 19.57**（最低点落到台面 ✓，最高点仍在顶帽 ✓）。

**49s 没有被改坏**：那个小全息台是 1.5 半径的盘子放在巨大机库里，十四单位高的塔架从来不属于那一帧
（机库的结构由 `buildBackdropRig` 负责）。所以钢架做成**可选**——`buildStage({truss: false})` 保留
灯光、不建钢架，`hangarReveal` 用它，49s 的画面与改前一致 ✓。

**验证**：413 项单测（新增 2 条：`the lighting rig stands on the stage, and every part agrees on the
height` 断言「最低的钢在台面、最高点高过架环、她在架环之内且头顶远低于架环」；以及
`a hologram gets the light without the steel`）、22 项 smoke 全过；舞台 19 draw / 16.6k 三角（持平）。

对照：`analysis/shots/timecheck/rig_before_after.png`（四段 × 改前/改后）、
`analysis/shots/timecheck/c49_ab_final.png`（49s 她周围的前后对比）。

### 舞台第七十七轮 —— 立柱拆掉，改成**上面架空的一圈方框**；框架高度与灯光高度分成两个数

第七十六轮把立柱做成了从台面扎到顶帽的塔架，用户看了说：**「像柱子的不好看，还是放上面架空的四方形好看」**。
所以：

1. **立柱可选，默认不要**（`rig: { masts: 0 }`）。真实的演唱会桁架是**吊装**的——缆绳出画，观众看到的
   就是一圈方框加里面的灯，下面什么都没有。塔架那一版保留给"临时搭起来的舞台"那种读感。
2. **框架高度和灯光高度分成两个参数**：`trussY`（框架挂在哪）默认等于 `topY`（光从哪来）。
   把框架放到 13 会**跑到画面外**（那几个分镜的可视上界只有 4.0–5.0），所以徽章舞台用
   `trussY: 4.2`（吊在她头顶上方一点、在取景内 ✓）、`topY: 13`（光束仍从上方下来 ✓）。

结果：`lightingTruss` 的包围盒 **2.63 .. 5.28**（悬空的一圈 + 吊在框里的灯 ✓），`spotlightRig` 仍是
**0 .. 13.95**（光束从高处下来 ✓）。四个时间点（19s / 28s / 160s / 290s）现在的画面是：上方一圈方框、
下面圆盘与人干净 ✓。

**验证**：413 项单测（第三条新增断言：`trussY` 时框架显著低于灯光高度、框架在她头顶之上、光束仍从
13 左右起始）、22 项 smoke 全过。
对照：`analysis/shots/timecheck/susp2_grid.png`（四个时间点）、
`analysis/shots/timecheck/rig_before_after.png`（塔架版的对照，留给以后参考）。

### 背景第七十八轮 —— 那些一闪一闪的圆圈是**爆炸的光**：每个自己闪、自己灭，不再整片一起闪

用户说：**「整个视频画面里，一闪一闪的圆圈是爆炸的光芒。应该每一个独立、随即闪光并消失，而不是所有
的一起同步地闪光。」**

**先量了"同步"有多严重。** 在 59.72s 那个分镜（`valkyrieFlight`）上，取拍点后 1ms 与 275ms 两帧：
金色像素 **9284 → 14199（+53%）**，整片背景在同一个重拍上一起变亮。原因就是一行代码——
`bokehField` 的材质不透明度被拍脉冲乘了：`mat.opacity = 0.4 + 0.13 * pulse`。散景的每个圆盘在真实
镜头里是**远处某个光源**的失焦像，而这部片子里远处的光源就是爆炸：每一次都是**独立的一件事**——
亮一下，就没了。爆炸不看拍子。

**改法：给每个圆盘一个自己的钟**（`aFlash = (相位, 频率, 占空比, 底色)`，`patchPointsTwinkle`）：

- 顶点着色器里每个点自己算 `pow(1 - fract(t * rate + phase) / duty, decay)`——除了时钟本身，
  这个式子里**没有任何东西是点与点共享的**，所以"独立"是构造出来的，不是调出来的；
- 碎片着色器里 `vTwinkle` 乘在这个圆盘自己的 alpha 上：底色为 0 的圆盘在两次闪光之间**彻底消失**
  （这就是"闪光并消失"）；`vHeat` 再给闪光本身的颜色过曝一下，并按 `1 - base` 加权——
  只有真的灭掉的那些才会闪到爆；
- 闪光同时把圆盘**撑大**（爆炸在镜头里会胀开），倍率也挂在 `vHeat` 上，理由同上。

**近景层是劈开的，这是算术不是口味。** 近处那 15% 的圆盘占了整片**三分之一的光**，而一个"有 70%
时间不亮"的圆盘只贡献 30% 的光：如果每个都灭，画面就会丢掉三分之二的**金色雾**——而雾正是参考里
一直在的东西。所以近景层一半是**爆炸**（底色 0，闪完就没），一半托着雾（底色 0.78–0.9，会闪但不
会走）；中景 0.72–0.85、远景 0.88–1.0（细粒几乎常亮），各自闪各自的。不透明度 0.4 → **0.5** 把雾
补回原来的量级（托雾的圆盘现在渲染在 0.39–0.5，正是老场所在的那一档），而爆炸的光是**加在这之上**，
不是把整片抬亮。

**验证**（`node .scratch/bokehflash.mjs` 把着色器那四行 GLSL 用 JS 重写，再走一遍场自己的属性）：

| 指标 | 改前 | 改后 |
| --- | --- | --- |
| 拍点上 / 拍点后 275ms 的场能量 | **1.33×**（整片同步闪） | **1.00×**（与拍子无关） |
| 4 秒内场能量漂移 | — | 0.89–1.02×（各自为政的抖动） |
| 场平均光通量 vs 全静止场 | 100% | **78%**，再乘 0.5/0.4 的不透明度补偿 ≈ **98%** |
| 相位覆盖率 | — | 900 个圆盘 900 个不同相位，最大空隙 < 0.02 周期 |
| 天空区域的金色像素（改前 vs 改后 4 帧） | 781 | 819 / 839 / 696 / 768（各自抖动，均值同级） |

**419 项单测**（新增 6 项：相位/频率两两不同且铺满整个周期、拍点上与拍点后的场能量差 < 6%、爆炸盘
会真的归零而托雾盘不会、劈开后场的平均光通量仍在全静止场的 70–130%、补丁**串在**尺寸补丁之上且
`uTwinkleHot` 在碎片着色器里也声明了、three.js r180 的 `ShaderLib.points` 仍带着两个锚点以便升级时
立刻发现）、**22 项 smoke** 全过。

> 插曲：第一版补丁只在顶点着色器声明了 `uTwinkleHot`，碎片着色器用它 → 链接失败、整片背景黑掉。
> 是 `capture.mjs` 把 `'uTwinkleHot' : undeclared identifier` 打出来才发现的（截图脚本会转发页面
> 控制台），**没有任何一个只看源码文本的单测能发现它**——所以这个断言的注释里写着它是被渲染抓到的。

对照：`analysis/shots/twinkle/ab.png`（拍点上的前后对比）、
`analysis/shots/twinkle/ab2.png`（改前 1 帧 vs 改后 3 帧，同为背景密度）、
`analysis/shots/twinkle/strip/sky4.png`（同一块天空 0.4s 一帧 × 4：哪个圆盘亮、哪个灭了，每帧都不同）。

## 已知限制

- **音乐与影像不同步到帧**：影像时钟跟随 `<audio>`，误差在一帧量级；分镜边界对齐到 109.05 BPM 的
  节拍网格（相位 0.302s）。
- **节拍倍频歧义**：从音频本身无法区分 84 与 168 BPM。工具会同时给出 `alternatives`，
  本曲按 109.05 BPM 使用（见 `docs/TOOLING.md`）。
- **软件渲染**：本机 Firefox 走 llvmpipe。默认档位会据此自动降到 `draft`；有独显时可直接选 `high`。
- **描边是分档的**：`withOutlines` 由 `segments >= 0.7` 决定，所以 `draft`（0.6）**完全没有墨线**。
  判断「墨线对不对」必须在 `medium` 以上做（`node scripts/study.mjs --tier medium …`）；
  所有截图脚本默认走 `draft`，所以这一轮之前没有任何一张渲染图带墨线。
- **`preset.shadows` 是个空开关**：`quality.js` 里 `medium` 以上标着 `shadows: true`，但
  `renderer.shadowMap.enabled` 在 `engine.js` 里被写死为 `false`，没有任何代码读这个字段 ——
  也就是说本项目**从不投影**。近景里那些直角浅色块因此不是阴影（排查见「近景第二轮」一节）。
- **近景里的 toon 分档边界**：褶与脸颊上那些锯齿/直边暗块来自 3 档 toon 着色在近平面上的分界，
  不是阴影也不是贴图接缝。分镜远景不可见，`--tier medium` 的近景可见。
- **人物是风格化的**，不是写实建模；侧脸与手势的可读性弱于正面。

## 环境备注

- ffmpeg / firefox 在本机是 **snap** 包：有独立 `/tmp`，所以所有临时路径必须放在 `$HOME` 下；
  `firefox --headless --screenshot` 在 snap 沙箱里不产出文件，因此截图走 WebDriver 协议。
- npm 已配置 `registry.npmmirror.com`。除 `three` 外无任何运行时依赖。