Shuery
3f11426964
把项目从「手写 dist/」改成「wallpapers/ 是唯一真相来源，dist/ 由 pnpm build 生成」，
并补上配套的类型、门禁与抓取器。一次提交落地整条管线，因为拆开会留下不能构建的中间态。
- src/：运行时与模拟器源码（TS，strict），编译到 build/ 再拷进各分发
- tools/：build / dev / check-{syntax,paths,dist}，以及抓取器与回归门禁 tools/checks/
（.scratch/ 下那批一次性脚本移入 tools/checks/ 并入库为长期门禁）
- wallpapers/：七档壁纸的源数据 + README.md（id/音频/预设的完整规范）
- docs/adr/0005-0008：构建管线与分发拓扑、模拟器契约、自包含 sim、每骨架资源布局
- .gitignore：排除 .scratch/ 的参考资料副本（上游 spine 整仓克隆 ~1.2 GB、
抓取侦查数据 ~680 MB）与调试转储；这些是本地调查材料，补偿会让仓库无法克隆
- 归一化 .gitignore/CONTEXT.md 行尾（工作区 CRLF、索引 LF 造成的整文件假 diff）
同时修掉三档卡住构建的未完工壁纸：
- kv45 的 meta.json 里 id 还是抓取期场景名 scene_main，经 downloader promote 正名为 kv45
- shajin / zhigengniao_juheye 的 meta.json 误用了骨架描述文件（name/spine/animations/pages）、
且都缺 preset.template.json；现按规范重建：骨架沉到 spines/<名>/（spine-ts 按 atlas 所在
目录解析贴图页）、补上元数据与单骨架预设，并清掉 zhigengniao 骨架里指向作者机的绝对路径
- 顺带 promote 已在 sources.yml 里的 kv46（月升之前，与兽共舞）
pnpm check 五道门全绿：10 个分发 / 7 档壁纸 / 141 处引用自包含。
3.5 KiB
19 — 单档分发里没有「背景音乐选择」
Status: resolved Type: bug
现象
昔涟内有两首背景音乐，怎么没有看到切换选项？
wallpapers/hsr/xilian/meta.json 里确实声明了两首（「再度和你」/「昔涟」），
但 single-hsr-xilian 的 project.json 里根本没有 bgm 属性，所以那档分发里没有切换入口。
根因
tools/lib/generate.ts 里：
if (!isCollection) {
// 单档分发：只剩一档壁纸，"壁纸预设切换"没有意义。整条属性删掉
delete properties.preset;
delete properties.preset_note;
delete properties.bgm; // ← 问题在这一行
delete properties.bgm_note;
}
那句注释对预设切换成立——只剩一档壁纸，切预设确实没意义。 但它对背景音乐不成立：一档壁纸照样可以带好几首曲子。两件事被一起删了。
而且 bgm 的选项只在 else（合集）分支里算，所以即使只删掉 delete，下拉也会是空的。
改法
把 bgmOptions 的计算提到分支之外（单档合集都要算），再按内容决定留不留：
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 组渲染逐像素相同。
一点反思
「单档分发只剩一档壁纸，所以切换类的东西都没意义」是个看起来对、实际不对的推理： 它把"壁纸维度的切换"和"音源维度的切换"混成了一个。加属性时如果顺手问一句 "这条属性删掉之后，哪个用户可见的功能会消失"，就能避免。