42 lines
2.6 KiB
Markdown
42 lines
2.6 KiB
Markdown
# 优化已发布的网页壁纸（workshopid 3604974793）
|
||
|
||
在**不重写播放器**的前提下，就地优化现有 `dist/` 作品：资源分层、体积、健壮性、比例适配、属性扩展，最后重新打包发布 v3。
|
||
|
||
## 背景与约束（已确认）
|
||
|
||
- 原样入库的基线是 commit `d8c7e49`（105.1 MB），期间不做"顺手重构"。
|
||
- 已发布作品，`project.json` 里 combo 选项的 `value`（`xilian` / `kv37`）**不可改**，否则老用户已保存的预设选择会失效。
|
||
- 音源与音量是**用户级覆盖**，切换预设不得清掉；接受有损音频，无损母带留在 dist 之外。
|
||
- 图片转 WebP 只在 AB 对拍证明肉眼无差别后才做，否则保留 PNG。
|
||
- 适配目标：任何比例下主体完整、底部对齐、无空边。
|
||
- 验收：0 个死文件；总体积 ≤35 MB；3 种比例干净；0 个 console 报错；预设往返不丢音源设置；连续 20 次切换无内存增长。
|
||
|
||
## 决策记录
|
||
|
||
| 主题 | 决定 | 记录位置 |
|
||
| --- | --- | --- |
|
||
| 资源分层 | `assets/<游戏>/<壁纸>/{effects,images,audios}/`，每档壁纸自包含 | `docs/adr/0001-resource-layout.md` |
|
||
| 目录名 vs 键 | 目录名用显示名（含 `「」`），代码键用稳定 id | 同上 |
|
||
| 预设形式 | 每档壁纸一份 `preset.js`（ES module + `import.meta.url`） | `docs/adr/0002-preset-as-es-module.md` |
|
||
| 术语 | 一档壁纸（Wallpaper）= 用户可见选项；预设（Preset）= 它的配置实体 | `CONTEXT.md` |
|
||
| 音源作用域 | combo 列表为全局并集；切壁纸时若当前音源不属于新壁纸，回落"随预设" | 本 spec |
|
||
|
||
## 验证台（后续每一步都用它）
|
||
|
||
`tools/serve.mjs` 起本地服务并注入驱动（模拟 WE 下发用户属性、冻结动画相位、藏 canvas 取参考帧），
|
||
`tools/cdp.mjs` + `tools/shot.mjs` 走 CDP 真实时间截图，`tools/diff.mjs` / `compare.mjs` / `heatmap.mjs` 做像素差分，
|
||
`tools/check-paths.mjs` 静态校验预设里声明的每个路径是否存在。
|
||
|
||
判定标准：以"与基线逐像素完全相同的对数"和噪声底（约 0.1/255）为准；基线自身存在约 2.3/255 的双模态抖动，不能拿单次差异下结论。
|
||
|
||
## 步骤
|
||
|
||
| # | 步骤 | 状态 |
|
||
| --- | --- | --- |
|
||
| 01 | 资源按 游戏/壁纸 分层，预设拆进各自壁纸目录 | 完成（`09ff322`） |
|
||
| 02 | 体积：音频转码 + 未引用资源归位 | 待做 |
|
||
| 03 | 健壮性：初始化状态机、死代码、用户级覆盖语义 | 待做 |
|
||
| 04 | 比例适配：按容器比例重算视口 | 待做 |
|
||
| 05 | WE 属性扩展：音源 combo、fps 限制 | 待做 |
|
||
| 06 | 打包 v3 并重新发布 | 待做 |
|