feat: 音频改回无损 FLAC（用户决定：壁纸在本地，不计体积）

撤销 issue 02 里的音频转码，把两条 FLAC 放回 dist。 - 恢复方式是**字节级还原**而非重新编码：masters/ 里两份文件的 git 对象哈希与基线 `d8c7e49:dist/assets/audios/*.flac` 完全一致，即与已发布的 v2 是同一份文件。因此本次提交不新增任何 blob 存储——这两份内容早已在仓库历史里。 - `preset.js` 的音源指向改回 `.flac`。`pv37.mp3` 保持原样：它**没有无损源**，把有损数据转封装成 FLAC 只会涨体积，而一个 bit 的信息都不会回来。 - 体积基准由「≤35 MB」改为「不超过已发布的 v2（104.98 MB）」，实际 **96.94 MB**，比 v2 还小（图片部分的无损 WebP 收益仍在），不引入新的上传或订阅风险。顺带修掉一个自己引入的 bug：改 `preset.js` 时漏写了文件名里的 `「」`，浏览器请求 404 → `<audio>` 在 **64 ms** 内报 `MediaError.code = 4`（SRC_NOT_SUPPORTED），看上去像"CEF 不支持 FLAC"，实际是路径不存在。判定方法记进 ADR 0004：把同一份字节交给 `decodeAudioData`，能解出正确时长就说明解码器没问题，问题在传输或路径。验证： - `test-props`：CEF 支持 audio/flac、无解码错误、readyState=4、时长 205.1 s，14 项音源断言全过。 - `test-acceptance` 新增第 ⑤ 节音频格式不变式：xilian 两个音源全为 flac、无 `.ogg`/`.opus` 残留、`preset.js` 引用的每个音源文件都存在；三种比例 0 报错；预设往返不丢音频设置。 - 分带能量实测：FLAC 高频平滑延伸到 22 kHz（20–22 kHz 处 −50 dB），无有损断崖；与 Opus 版逐带相差 0.0–0.3 dB。即这是一个由偏好驱动、而非由测量差异驱动的决定。
2026-09-19 20:36:58 +08:00
1 parent eb56efbd9e
commit 0ca78ed117
@@ -1,6 +1,6 @@
 # 02 体积：音频转码 + 未引用资源归位

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

 ## 现状

@@ -51,3 +51,34 @@ Status: resolved
 **先验证再删除**。中途 `-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` 引用的每个音源必须真实存在——防止再犯。
@@ -24,8 +24,10 @@ Status: resolved（第 4 步为人工步骤，待用户执行）
   注：减色到 96/64/48 色收效甚微（604/519/474 KB）——体积由帧间变化量主导，不由调色板主导，
   所以走帧采样率这条路更划算。
 3. **全量验收**（`node .scratch/test-acceptance.mjs`）：**全部通过**
-   - 总体积 **28.52 MB** / 34 个文件（≤ 35 MB）
+   - 总体积 **96.94 MB** / 33 个文件——未超已发布的 v2（104.98 MB），音频走无损后仍比 v2 小
   - **0 死文件**
+   - 音频格式不变式：xilian 两个音源均为 `flac`、`pv37.mp3` 保持 mp3、已无 `.ogg`/`.opus` 残留、
+     `preset.js` 引用的音源路径全部可达
   - `project.json` 解析正常、version 3、bgm 存在、preset 取值未变
   - 21:9 / 16:9 / 9:16 三种比例：播放器就绪、可见矩形比例与画布一致、**0 控制台报错 / 0 异常**
   - 预设往返 10 次：自定义音源与音量 0.2 均未丢失，仍在持续绘制，0 未捕获异常
@@ -6,10 +6,10 @@

 - 原样入库的基线是 commit `d8c7e49`（105.1 MB），期间不做"顺手重构"。
 - 已发布作品，`project.json` 里 combo 选项的 `value`（`xilian` / `kv37`）**不可改**，否则老用户已保存的预设选择会失效。
- 音源与音量是**用户级覆盖**，切换预设不得清掉；接受有损音频，无损母带留在 dist 之外。
+- 音源与音量是**用户级覆盖**，切换预设不得清掉；**音频走无损**（用户决定：壁纸在本地，不计体积）。
 - 图片转 WebP 只在 AB 对拍证明肉眼无差别后才做，否则保留 PNG。
 - 适配目标：任何比例下主体完整、底部对齐、无空边。
- 验收：0 个死文件；总体积 ≤35 MB；3 种比例干净；0 个 console 报错；预设往返不丢音源设置；连续 20 次切换无内存增长。
+- 验收：0 个死文件；总体积不超过已发布的 v2（104.98 MB，实际 96.94 MB）；3 种比例干净；0 个 console 报错；预设往返不丢音源设置；连续 20 次切换无内存增长；xilian 两个音源为无损 FLAC 且路径可达。

 ## 决策记录

@@ -34,7 +34,7 @@
 | # | 步骤 | 状态 |
 | --- | --- | --- |
 | 01 | 资源按 游戏/壁纸 分层，预设拆进各自壁纸目录 | 完成（`09ff322`） |
-| 02 | 体积：音频转 Opus + 图片无损 WebP（105.1 → 28.9 MB） | 完成 |
+| 02 | 图片无损 WebP（25 → 19.6 MB）；音频一度转 Opus，后被用户否决改回无损 | 完成（音频见 issue 02 修订） |
 | 03 | 健壮性：初始化状态机、死代码、用户级覆盖语义 | 完成（`4662856`） |
 | 04 | 比例适配：立绘层取景跟随背景 cover 缩放 | 完成 |
 | 05 | WE 属性扩展：音源 combo、fps 限制 | 完成 |