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 处引用自包含。
8 lines
1.1 KiB
Markdown
8 lines
1.1 KiB
Markdown
# 资源按 游戏/壁纸 分层，显示名做目录、id 做键
|
|
|
|
已发布作品（workshopid 3604974793）原先把两套壁纸的资源混在 `assets/{images,effects,audios}/` 三个平铺目录里，加第三档就必须靠文件名前缀认领。我们改为每档壁纸自包含：`assets/<游戏>/<壁纸>/{effects,images,audios}/`，并让每档壁纸自带一份 `preset.js`。
|
|
|
|
关键取舍是**目录名用显示名（含 `「」` 等符号），而代码里的键用 ASCII 的预设 id**。反过来做（目录名用 id）会让目录结构在 WE 的文件夹里毫无可读性；统一用显示名做键则会在改标题时打断老用户已保存的预设选择。所以两者各司其职：显示名服务于人，id 服务于 WE 属性与用户设置，二者用 `preset.js` 里的 `id` 字段绑定。
|
|
|
|
保留了 `effects/`、`images/`、`audios/` 这三层同名子目录，是为了让 Spine 骨架 JSON 里的 `"images": "../images/"` 相对路径一字不改。（**已被 ADR 0008 取代**：现在是 `spines/<骨架名>/` + `scene/`，骨架 JSON 那个前缀归零。）
|