# 19 — 单档分发里没有「背景音乐选择」

Status: resolved
Type: bug

## 现象

> 昔涟内有两首背景音乐，怎么没有看到切换选项？

`wallpapers/hsr/xilian/meta.json` 里确实声明了两首（「再度和你」/「昔涟」），
但 `single-hsr-xilian` 的 `project.json` 里**根本没有 `bgm` 属性**，所以那档分发里没有切换入口。

## 根因

`tools/lib/generate.ts` 里：

```ts
if (!isCollection) {
  // 单档分发：只剩一档壁纸，"壁纸预设切换"没有意义。整条属性删掉
  delete properties.preset;
  delete properties.preset_note;
  delete properties.bgm;      // ← 问题在这一行
  delete properties.bgm_note;
}
```

那句注释对**预设切换**成立——只剩一档壁纸，切预设确实没意义。
但它对**背景音乐**不成立：**一档壁纸照样可以带好几首曲子**。两件事被一起删了。

而且 `bgm` 的选项只在 `else`（合集）分支里算，所以即使只删掉 delete，下拉也会是空的。

## 改法

把 `bgmOptions` 的计算提到分支**之外**（单档合集都要算），再按内容决定留不留：

```ts
if (isCollection) {
  // preset 的选项照旧
} else {
  delete properties.preset;
  delete properties.preset_note;
}

// 只剩"随预设"+ 至多一首时这个下拉是句废话（两个选项效果完全一样），删掉。
if (bgmOptions.length <= 2) {
  delete properties.bgm;
  delete properties.bgm_note;
} else {
  (properties.bgm as ComboProperty).options = bgmOptions;
  properties.bgm = orderProperty(...);
}
```

结果：

| 分发 | 音源数 | bgm |
| --- | --- | --- |
| `single-hsr-xilian` | 2 | **有**：随预设 / 「再度和你」 / 昔涟 |
| `single-hsr-kv37` | 1 | 没有（两个选项效果一样，是废话） |
| `collection-hsr` / `collection-all` | 3 | 有（不变） |

`collection-all` 的产物**逐字段未变**：`diff-project` 仍是 14 处差异，与本次无关。

## 为什么之前没人发现

**没有任何断言盯着"用户能不能切歌"这件事。** `test-props.mjs` 验的是 bgm 的**语义**
（选择、跨壁纸回落、优先级），它跑在 `collection-all` 上——那里 bgm 一直是好的。
`test-acceptance.mjs` 也只断言合集分发"bgm 含「随预设」档"。

所以这是一个**只影响单档分发、且只在用户实际去看的时候才暴露**的缺陷。

## 验证

新增两层，都盯着"用户能不能切"：

- `tools/checks/verify-panel.mts` 第 ⑫ 组（浏览器，端到端）：
  - `single-hsr-xilian` 有「背景音乐选择」，下拉里就是 `随预设 / 「再度和你」 / 昔涟`
  - 默认值是 `auto`（随预设）——与合集分发一致，不是"第一首"
  - `single-hsr-kv37` **没有**这个下拉（只有一首）
- `tools/checks/check-single-bgm.mts`（**选项在 ≠ 切得动**）：
  在 `single-hsr-xilian` 里选「昔涟」→ `<audio>.src` 真的变成 `xilian-src.flac`；再选回来 → 变回去。

其余回归全绿：`pnpm check`、调试服与浏览器冒烟、四档自包含包、静态托管预览、sim 门禁、
内联守卫、`test-props` / `test-resize` / `test-acceptance` / `verify-fitter`、
6 组渲染逐像素相同。

## 一点反思

「单档分发只剩一档壁纸，所以切换类的东西都没意义」是个**看起来对、实际不对**的推理：
它把"壁纸维度的切换"和"音源维度的切换"混成了一个。加属性时如果顺手问一句
"这条属性删掉之后，哪个用户可见的功能会消失"，就能避免。