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）。
38 lines
1.9 KiB
Markdown
38 lines
1.9 KiB
Markdown
# SpineWallpaper（网页壁纸作品）
|
||
|
||
一份已发布的 Wallpaper Engine 网页壁纸，以及围绕它的资源分层与验证约定。这个上下文只关心"一档壁纸由什么组成、怎么被打包和切换"。
|
||
|
||
## Language
|
||
|
||
**作品（Project）**：
|
||
一个 Wallpaper Engine 打包单元，即 `dist/` 整个目录；`project.json` 是它的清单，`index.html` 是它的入口。
|
||
_Avoid_: 工程、站点、应用
|
||
|
||
**游戏（Game）**：
|
||
壁纸所出自的作品名（`崩坏：星穹铁道`），资源分层的第一级，也是目录结构的第一层。
|
||
_Avoid_: 来源、IP
|
||
|
||
**壁纸（Wallpaper）**：
|
||
用户可在 WE 属性里切换的一档壁纸（`昔涟立绘`、`「成为昨日的明天」`）；它的显示名就是它的目录名，可以改。
|
||
_Avoid_: 预设、选项、preset（当指"这一档"本身时）
|
||
|
||
**预设（Preset）**：
|
||
一档壁纸的配置实体，落盘为该壁纸目录下的 `preset.js`，声明这一档要用哪些资源、以什么参数播放。一档壁纸对应且仅对应一个预设。
|
||
_Avoid_: 配置、profile、manifest
|
||
|
||
**预设 id**：
|
||
预设的稳定标识（`xilian`、`kv37`），必须与 WE 属性值一致，永不随显示名变化——已发布作品的用户设置靠它维系。
|
||
_Avoid_: slug、键名、代号
|
||
|
||
**音源（AudioSource）**：
|
||
一首可作背景音乐的曲子。每首曲子归属且只归属一档壁纸；WE 的音源列表是所有壁纸音源声明的并集。
|
||
_Avoid_: BGM、曲目、音频文件
|
||
|
||
**视口（Viewport）**：
|
||
交给 Spine 播放器的世界坐标系矩形，决定构图。它以等比"contain"方式映射到画布：单轴贴边、另一轴会多露出世界，因此负 padding 的裁切只在目标比例下成立。
|
||
_Avoid_: 相机、取景框、裁剪区
|
||
|
||
**对拍（AB capture）**：
|
||
同一壁纸、同一分辨率、同一动画相位下的改动前后像素比对。噪声底约 0.7/255；低于 1 视为无差异。
|
||
_Avoid_: 截图测试、视觉回归
|