# 02 体积：音频转码 + 未引用资源归位

Status: resolved，但**音频转码已被推翻**（见文末「修订」）；图片部分保持有效

## 现状

- `dist` 合计 105.1 MB，其中音频占 77.3 MB：
  - `昔涟立绘/audios/「再度和你」.flac` 37.3 MB / 205.1 s / 1.52 Mbps
  - `昔涟立绘/audios/昔涟.flac` 37.7 MB / 186.7 s / 1.69 Mbps（此前零引用，现已声明为第二音源）
  - `「成为昨日的明天」/audios/pv37.mp3` 2.3 MB / 81 s
- CEF 的解码白名单含 vorbis / libopus / flac / mp3 / pcm_*（不含 aac，`m4a` 大概率不可用）。

## 步骤

1. 无损母带移出 `dist/`，存到 `masters/`（已 gitignore，不入库）。
2. 两首 flac 转 Opus（`libopus` 128k VBR）。保留 `pv37.mp3` 原样。
3. 核对转码未截断、无解码错误。
4. 图片转码**仅在对拍证明无可见差异后**决定（atlas 页要整组转，并同步改 `.atlas` 里的页名）。

## 验收

- `dist` 总体积 ≤35 MB。
- `check-paths` 全绿；转码后的音频可完整解码。
- 每个比例的对拍像素无回归。

## 结果

`dist` 105.1 MB → **28.92 MB**。

- 音频：`再度和你.ogg` 3.35 MB、`昔涟.ogg` 3.16 MB，均通过完整解码与电平检查。
  `昔涟.flac` 源文件末尾一帧损坏（186.671 s 处 invalid frame header），但全长音频都在。
- 图片：**全部走无损 WebP**（放弃有损路线，因为目标已达成，没必要冒险）。
  - xilian 三张真 PNG RGBA → 无损 WebP：3.39→1.80、5.01→2.83、3.38→1.76 MB
  - `kv37_xilian.png` → 无损 WebP 5.13→2.75 MB
  - kv37 的五张图**本来就是 WebP，只是扩展名写成 `.png`**，本次只改名——这也顺带证明 WebP 在本机 WE 环境可用（线上版本一直在用）
  - atlas 页名同步改为 `.webp`（`tools/atlas-pages.mjs`；注意这两个 .atlas 是 CRLF 行尾）
- 删除死文件 `dist/jsconfig.json`；`README.txt` 是 Workshop 描述（BBcode），保留。

## 验证

- `check-paths`：11/11 声明路径存在。
- 浏览器：0 个非 favicon 的 404。
- 无损 WebP 与源 PNG 的可见像素 **0 差异**。libwebp 会改写完全透明像素下的 RGB
  （`tools/rawdiff.mjs` 证实 xilian 三张图有 32–49% 像素属此类），而本项目贴图是 Linear 过滤、
  透明像素 RGB 会渗进边缘，所以额外做了渲染级对拍：与 PNG 版同冻结设置相比
  **0.052/255、热力图全空**，确认无渗色。
- 全尺寸矩阵留档于 `tools/shots/step02/`。

## 教训

**先验证再删除**。中途 `-preset default` 让无损编码退化成有损（产物只剩 0.03–0.54 MB），
而源 PNG 当时已被删除；只因为源都在 git 里（`09ff322`）才得以还原。
另外 `-quality` 在这个 ffmpeg 的 libwebp 封装里被忽略，要用 `-q:v`；`-exact` 选项不存在。

## 修订：音频改回无损（用户决定）

用户要求「音频可使用无损格式，这个壁纸本身就在本地，无需考虑大小」。
于是**撤销本文第 2 步的音频转码**，把两条 FLAC 放回 `dist`。

- 恢复方式是**字节级还原**，不是重新编码：`masters/` 里那两条 FLAC 的 git 对象哈希
  与基线 `d8c7e49:dist/assets/audios/*.flac` **完全一致**，即与已发布的 v2 装的是同一份文件。
- `preset.js` 的音源指向随之改回 `.flac`；`pv37.mp3` **没有无损源**，保持原样（也一直是 mp3）。
- 体积基准由「≤35 MB」改为「不超过已发布的 v2（104.98 MB）」。实际 **96.94 MB**——
  比 v2 还小（图片那部分的无损 WebP 收益仍在），所以**不引入新的上传/订阅风险**。
- 图片部分**不受影响**：无损 WebP 本来就不牺牲画质，没有取舍可撤。

### 关于"转成无损"的边界

`pv37.mp3` 不能靠转封装变成无损：把有损数据装进 FLAC 只会让 2.3 MB 涨到十几 MB，
而一个 bit 的信息都不会回来。要它无损，只能换一个无损源文件。

### 踩到的坑：文件名里的「」

`「再度和你」.flac` 的**文件名带 `「」`**（v2 就是如此）。改完 `preset.js` 后我漏写了这两个字符，
浏览器请求 `再度和你.flac` → 服务端 404 → `<audio>` 在 **64 ms** 内直接报
`MediaError.code = 4`（SRC_NOT_SUPPORTED）。这个错误码极具误导性：看起来像"CEF 不支持 FLAC"，
实际是路径不存在。排查时靠三条证据把方向掰了回来：

1. `decodeAudioData` 直接解同一份字节 → 成功（205.056 s / 48 kHz / 2 声道），证明解码器没问题；
2. `<audio>` 指向正确 URL 与 blob URL → 都正常出 `loadedmetadata`；
3. 页面自身元素的时间线里有一条 **404**，且 `currentSrc` 结尾是 `再度和你.flac`——少了 `「」`。

结论：**`MediaError.code=4` 要先查 404，再怀疑格式支持。** 收尾时已在 `test-acceptance.mjs`
第 ⑤ 节加了不变式——`preset.js` 引用的每个音源必须真实存在——防止再犯。