# 06 打包 v3 并重新发布

Status: resolved（第 4 步为人工步骤，待用户执行）

## 步骤与结果

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 下构图按设计改变，建议在
   超宽屏与竖屏各看一眼再发布。