SpineWallpaper

8 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
Shuery	4662856963	fix: 初始化竞态、用户级覆盖语义与死代码（重构四个控制器）初始化竞态（已实证）：旧 changeConfig() 整个函数体都在 if (this.player) 里，含配置赋值， WE 在 window.load 之前下发属性时被静默丢弃，导致背景/音乐已切到新壁纸、立绘还是旧的。改为「状态先写、应用后置」：index.js 用单一 state 记录（presetId/audioSource/audioVolume）， render() 决定能否立刻应用；setConfig() 无条件记录配置，create() 用记下的配置创建。 - 删除 index.js 里重复的 wallpaperRegisterListener（该 API 在本机 WE 不存在） - 删除 adjustCanvas()：播放器每帧自己做 renderer.resize(1) 且已注册 resize 监听，而它用 getBoundingClientRect() 写 canvas.width 却不乘 DPR，属于有害的重复实现 - 用户级音源/音量覆盖：切壁纸不再清回预设默认值（旧 PresetController 的启发式已移除） - 同源设置改为 no-op：否则两档壁纸共用同一首曲子时一切换就从头播放 - 只在壁纸真的变了才重建播放器，否则拖动音量滑块会触发重新下载 3.6MB 骨架+贴图 - 未知 preset id 保持现状并告警，不再静默回退验证：属性在 DOMContentLoaded 下发时玩家动画正确为 animation(kv37)；用户自定义音源 custom-track.mp3 与音量 0.2 在切壁纸后完整保留；重发同一预设时音乐从 1.3s 连续到 1.9s 未重启；未知 id 不崩。对拍：与重构前同强冻结设置 8 批次 6 配置逐像素完全相同（差异 0）。	2026-09-19 19:53:15 +08:00
Shuery	399f99edd7	test: 零依赖对拍测试台（可在不改 dist/ 的前提下复现 WE 行为） tools/serve.mjs 本地静态服务 + 测试驱动注入（模拟 WE 下发用户属性、冻结动画相位、藏 canvas 取参考帧） tools/cdp.mjs 最小 CDP 客户端（真实时间等待；--screenshot 的虚拟时间会在骨骼加载完成前就耗尽） tools/shot.mjs 截图/取状态，就绪判据可传入 tools/diff.mjs ffmpeg 差分：PSNR / SSIM / 平均亮度差 tools/capture.mjs 对拍矩阵：壁纸 × 分辨率 × (正常, 藏 canvas) 实测：xilian 1920x1080 spine 层贡献 mean\|diff\|=26.1/255，kv37 为 10.2/255，同配置两次截图噪声底 0.68/255。	2026-09-19 19:13:57 +08:00

Author

SHA1

Message

Date

Shuery

4662856963

fix: 初始化竞态、用户级覆盖语义与死代码（重构四个控制器）

初始化竞态（已实证）：旧 changeConfig() 整个函数体都在 if (this.player) 里，含配置赋值，
WE 在 window.load 之前下发属性时被静默丢弃，导致背景/音乐已切到新壁纸、立绘还是旧的。
改为「状态先写、应用后置」：index.js 用单一 state 记录（presetId/audioSource/audioVolume），
render() 决定能否立刻应用；setConfig() 无条件记录配置，create() 用记下的配置创建。

- 删除 index.js 里重复的 wallpaperRegisterListener（该 API 在本机 WE 不存在）
- 删除 adjustCanvas()：播放器每帧自己做 renderer.resize(1) 且已注册 resize 监听，
  而它用 getBoundingClientRect() 写 canvas.width 却不乘 DPR，属于有害的重复实现
- 用户级音源/音量覆盖：切壁纸不再清回预设默认值（旧 PresetController 的启发式已移除）
- 同源设置改为 no-op：否则两档壁纸共用同一首曲子时一切换就从头播放
- 只在壁纸真的变了才重建播放器，否则拖动音量滑块会触发重新下载 3.6MB 骨架+贴图
- 未知 preset id 保持现状并告警，不再静默回退

验证：属性在 DOMContentLoaded 下发时玩家动画正确为 animation(kv37)；
用户自定义音源 custom-track.mp3 与音量 0.2 在切壁纸后完整保留；
重发同一预设时音乐从 1.3s 连续到 1.9s 未重启；未知 id 不崩。
对拍：与重构前同强冻结设置 8 批次 6 配置逐像素完全相同（差异 0）。

2026-09-19 19:53:15 +08:00

Shuery

399f99edd7

test: 零依赖对拍测试台（可在不改 dist/ 的前提下复现 WE 行为）

tools/serve.mjs    本地静态服务 + 测试驱动注入（模拟 WE 下发用户属性、冻结动画相位、藏 canvas 取参考帧）
tools/cdp.mjs      最小 CDP 客户端（真实时间等待；--screenshot 的虚拟时间会在骨骼加载完成前就耗尽）
tools/shot.mjs     截图/取状态，就绪判据可传入
tools/diff.mjs     ffmpeg 差分：PSNR / SSIM / 平均亮度差
tools/capture.mjs  对拍矩阵：壁纸 × 分辨率 × (正常, 藏 canvas)

实测：xilian 1920x1080 spine 层贡献 mean|diff|=26.1/255，kv37 为 10.2/255，
同配置两次截图噪声底 0.68/255。

2026-09-19 19:13:57 +08:00