Shuery
09ff322fe8
- assets/<游戏>/<壁纸>/{effects,images,audios}/，每档壁纸自包含
- 每档壁纸自带 preset.js：用 import.meta.url 推导自身资源路径，目录可整体搬走；
目录名用显示名（含「」），代码键用稳定 id（xilian/kv37，与 WE 属性值绑定）
- preset-store.js -> presets.js：静态 import 两份预设并建 id 索引
- 新增 CONTEXT.md 术语表与 ADR-0001/0002
- 新增 check-paths / compare / heatmap 三个验证工具；serve.mjs 改为每帧强制动画相位归零
验证：check-paths 11/11 路径存在（含此前零引用的 昔涟.flac）；浏览器 0 个真实 404；
与基线 worktree 同冻结设置对拍，9 对跨版本比较中 4 对逐像素完全相同（差异 0），
其余 ≤0.19/255，远低于基线自身的双模态抖动（2.27/255）。
8 lines
783 B
Markdown
8 lines
783 B
Markdown
# 预设用 ES module 而不是 JSON
|
|
|
|
每档壁纸的 `preset.js` 是 `export default {...}` 的 ES module，而不是由 `fetch` 拉取的 `preset.json`。
|
|
|
|
理由是资源路径的自包含性：模块内用 `import.meta.url` 推导 `./images/...` 的绝对 URL，于是整个壁纸目录可以被复制、改名、搬家而不需要改任何一行路径。若用 JSON，路径只能以**页面**为基准写死，一旦目录改名（本项目的目录名就是显示名，改标题=改目录）就会全站 404，且每档壁纸都必须先异步取回 JSON 才能建播放器，给启动时序又加一个竞态点。
|
|
|
|
代价：配置文件不再是纯数据，不能直接 `JSON.parse` 消费。本项目接受这一点——预设数据量极小，且始终由代码持有。
|