Shuery
0ca78ed117
撤销 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。即这是一个由偏好驱动、而非由测量差异驱动的决定。
4.9 KiB
4.9 KiB
02 体积：音频转码 + 未引用资源归位
Status: resolved，但音频转码已被推翻（见文末「修订」）；图片部分保持有效
现状
dist合计 105.1 MB，其中音频占 77.3 MB：昔涟立绘/audios/「再度和你」.flac37.3 MB / 205.1 s / 1.52 Mbps昔涟立绘/audios/昔涟.flac37.7 MB / 186.7 s / 1.69 Mbps（此前零引用，现已声明为第二音源）「成为昨日的明天」/audios/pv37.mp32.3 MB / 81 s
- CEF 的解码白名单含 vorbis / libopus / flac / mp3 / pcm_*（不含 aac，
m4a大概率不可用）。
步骤
- 无损母带移出
dist/，存到masters/（已 gitignore，不入库）。 - 两首 flac 转 Opus（
libopus128k VBR）。保留pv37.mp3原样。 - 核对转码未截断、无解码错误。
- 图片转码仅在对拍证明无可见差异后决定（atlas 页要整组转，并同步改
.atlas里的页名）。
验收
dist总体积 ≤35 MB。check-paths全绿；转码后的音频可完整解码。- 每个比例的对拍像素无回归。
结果
dist 105.1 MB → 28.92 MB。
- 音频：
再度和你.ogg3.35 MB、昔涟.ogg3.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"，
实际是路径不存在。排查时靠三条证据把方向掰了回来：
decodeAudioData直接解同一份字节 → 成功（205.056 s / 48 kHz / 2 声道），证明解码器没问题；<audio>指向正确 URL 与 blob URL → 都正常出loadedmetadata；- 页面自身元素的时间线里有一条 404，且
currentSrc结尾是再度和你.flac——少了「」。
结论：MediaError.code=4 要先查 404，再怀疑格式支持。 收尾时已在 test-acceptance.mjs
第 ⑤ 节加了不变式——preset.js 引用的每个音源必须真实存在——防止再犯。