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 处引用自包含。
2.6 KiB
2.6 KiB
15 — single 分发目录名改成 single-<游戏id>-<壁纸id>
Status: resolved Type: task
需求
single 的发布目录结构调整：single-game-name
改动
| 旧 | 新 | |
|---|---|---|
| 单档 | wallpaper-<壁纸id> |
single-<游戏id>-<壁纸id> |
| 游戏合集 | collection-<游戏id> |
不变 |
| 全部合集 | collection-all |
不变 |
实际产物：
dist/releases/single-hsr-kv37
dist/releases/single-hsr-xilian
dist/releases/collection-hsr
dist/releases/collection-all
一处代码改动（tools/build.ts）：
dir: `single-${wallpaper.gameId}-${wallpaper.id}`,
为什么用 id 而不是 meta.name：kv37 的 meta.name 是 「成为昨天的明天」。
目录名带中文与 「」 与项目既有约定（"目录名与选择键一律用 id，不用显示名，避免中文路径"）冲突，
而 wallpapers/<游戏>/<壁纸> 这两级目录本来就是 id。所以 game = gameId、name = 壁纸 id。
改名本身是小事，暴露出的东西是大事
改完重建，pnpm check 全绿，但 smoke-dev 报了 12 处失败、smoke-sim 直接抛异常。
根因：调试服在启动时把 dist-map.json 读进内存，之后一直用那一份。
磁盘上已经是 single-hsr-kv37，服务端还按 wallpaper-kv37 校验 → 整档 404。
这不是改名带来的新问题，是一直存在的：加一档新壁纸、加一个游戏、甚至改个分发目录名，
都必须重启调试服才认。索引页（indexPage()）本来就是每次重读，只有 handle() 用了启动时那份——
两处不一致才是真正的问题。
现在 handle() 每次请求重读 dist-map.json。这个文件很小，调试服也不在乎这点开销。
顺带
.scratch/ 里 11 个脚本硬编码了旧目录名，全部更新；CONTEXT.md 与 ADR 0005 / 0007 同步。
确认过没有任何代码按目录名前缀反推类型（那样改名会静默失效），类型一律走 dist-map.json 的 type 字段。
验证
pnpm check：4 个分发全部按新名构建，check:dist通过- 调试服：冒烟、浏览器冒烟、面板还原度、热更新全过（重启后）
- 四档自包含包
file://全过（新目录名） - 静态托管预览全过
test-sim-gate/test-inline-guard/test-transform-module全过- 发布产物差异仍只来自
use_custom_audio；6 组渲染与重构前逐像素相同 single-hsr-kv37的目录结构确认：index.html/project.json/preset.js/scripts//styles//images//effects//audios/