feat: 比例适配、bgm 音源选择与 fps 限流，打包 v3

取景（issue 04）
- 新增 viewport-fitter.js：让立绘层缩放跟随背景图的 cover 缩放——背景放大多少倍、
  特效就放大多少倍。原先背景走 cover、立绘层走 contain，比例一变两者就分叉。
  16:9 下与作者设定逐像素一致（kv37 为 0 差异）。实测证伪了"contain 会裁掉作者视口"
  这个最初的判断：contain 在任何比例下都完整含住作者视口。
- 应用方式为原地改写 config.viewport 字段后调 setViewport()，不重建播放器；
  维护挂在 config.frame 上按画布比例增量进行（config.success 早于 setViewport，拿不到视口）。

WE 属性（issue 05）
- project.json 新增 bgm combo（所有壁纸音源的并集 + 「随预设」）；所选项不属于当前壁纸时
  音频回落该壁纸默认，选择本身保留。
- fps 限流包裹实例 drawFrame 并接管排程。修掉两个实测缺陷：朴素丢帧会把 rAF 抖动放大成
  整拍丢失（目标 30fps 实测只有 22.5fps）；fps:0 被真值判断吞掉导致无法取消限流。

打包（issue 06）
- project.json version 升至 3 并更新描述；preset 的 combo 取值保持 xilian/kv37 不变。
- preview.gif 821 KB → 347 KB（每 2 帧取 1 帧 + 128 色不抖动，逐帧与源帧像素完全相同）。
- index.html 加内联 favicon，消除 CEF 自动请求 /favicon.ico 造成的 404 报错。

其它
- dist/scripts/wallpaper-engine.js 移到 tools/：它没有任何入口引用，且环境判据依赖真实 WE
  并不存在的 wallpaperRegisterListener，一旦按它自己的说明挂进 index.html 会在生产环境自我激活。
- 修正死文件检查：原检查会拿文件名匹配到文件自身的内容，使这类文件漏网。
- 新增离线算式验证与 resize / 属性 / 全量验收三套浏览器测试脚本。

.scratch/wallpaper-optimization/issues/06-package-v3.md

@@ -1,10 +1,34 @@
 # 06 打包 v3 并重新发布
 
-Status: ready-for-agent
+Status: resolved（第 4 步为人工步骤，待用户执行）
 
-## 步骤
+## 步骤与结果
 
-1. `project.json`：`version` 升到 3，更新 `description`（提及新增音源切换等），核对 `properties` 与代码一致。
-2. `preview.gif` 现在 160×160 / 50 帧 / 840 KB——合规（≤256×256、≤1 MB）但超过推荐的 500 KB，重新压缩。
-3. 全量验收：0 死文件、≤35 MB、3 种比例 0 console 报错、预设往返不丢音源设置。
-4. 上传到 Workshop（人工步骤，需要用户操作）。
+1. **`project.json`**：`version` 升到 3；描述新增"可切换各预设自带的背景音乐""自适应窗口比例"；
+   新增 `bgm` combo 与 `bgm_note`。核对：`preset` 的 combo 取值仍是 `xilian` / `kv37`
+   （用户已保存的设置依赖它，绝不能改）。**完成**。
+2. **`preview.gif`**：原 160×160 / 50 帧 / 25fps / 2.0s / **821 KB**，超推荐值 500 KB。
+   重新压缩命令（结果可复现）：
+
+   ```powershell
+   ffmpeg -y -i dist/preview.gif -filter_complex `
+     "[0:v]fps=12.5,split[a][b];[a]palettegen=max_colors=128:stats_mode=full[p];[b][p]paletteuse=dither=none" `
+     -loop 0 .scratch/pv-I.gif
+   Copy-Item .scratch/pv-I.gif dist/preview.gif -Force
+   ```
+
+   （**不能把输入输出写成同一个文件**，ffmpeg 会拒绝；必须先输出到临时文件再覆盖。）
+   即"每 2 帧取 1 帧 + 128 色 + 不抖动"，**逐帧与源帧像素完全相同**（第 k 帧对原第 2k 帧，
+   抽查 0/6/12/18/24 帧全部 SSIM 1.0、max|diff| 0），只是时间采样率减半：
+   160×160 / 25 帧 / 12.5fps / 2.0s / **347 KB**。**完成**。
+   注：减色到 96/64/48 色收效甚微（604/519/474 KB）——体积由帧间变化量主导，不由调色板主导，
+   所以走帧采样率这条路更划算。
+3. **全量验收**（`node .scratch/test-acceptance.mjs`）：**全部通过**
+   - 总体积 **28.52 MB** / 34 个文件（≤ 35 MB）
+   - **0 死文件**
+   - `project.json` 解析正常、version 3、bgm 存在、preset 取值未变
+   - 21:9 / 16:9 / 9:16 三种比例：播放器就绪、可见矩形比例与画布一致、**0 控制台报错 / 0 异常**
+   - 预设往返 10 次：自定义音源与音量 0.2 均未丢失，仍在持续绘制，0 未捕获异常
+4. **上传到 Workshop**：人工步骤，需要用户操作。
+   本次为破坏性较小的重构（16:9 逐像素不变），但 21:9 / 9:16 下构图按设计改变，建议在
+   超宽屏与竖屏各看一眼再发布。