Shuery/SpineWallpaper
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9 Commits 1 Branch 0 Tags
b8eee05d780c8eeb6f7f63f98f3f8201e22e99b6
Commit Graph
9 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Shuery b8eee05d78 chore: dist/ 改为构建产物，从版本库摘除 
用户裁定：dist 是产物，不是源码。构建管线与产物拓扑见并发的重构所写的 ADR 0005。

- `git rm -r --cached dist`——只摘索引，**磁盘文件原样保留**。摘除前 dist/ 有 33 个跟踪文件。
- 一并纳入 .gitignore 中已有的 `dist/` 规则（该规则由并发的重构写入），使摘除真正生效；
  否则这些文件会以未跟踪身份继续堆在 git status 里。同时纳入的还有 `node_modules/`
  与 `.scratch/dist-baseline/` 两条同类忽略规则。
- 之前的两次提交（`eb56efb`、`0ca78ed`）按旧约定把 dist/ 收进了版本库，本次把定位纠回来。
  **历史里的 dist blob 不删**：需要旧版产物或那份无损音频时仍可从历史取回。
  源码侧的真相现在是 `src/` + `wallpapers/` + `tools/`。

只做索引层面的摘除，不触碰其它任何改动——同一工作区里还有一个重构在实时写盘。
 2026-09-20 00:17:33 +08:00
Shuery 0ca78ed117 feat: 音频改回无损 FLAC（用户决定：壁纸在本地，不计体积） 
撤销 issue 02 里的音频转码，把两条 FLAC 放回 dist。

- 恢复方式是**字节级还原**而非重新编码：masters/ 里两份文件的 git 对象哈希与基线
  `d8c7e49:dist/assets/audios/*.flac` 完全一致，即与已发布的 v2 是同一份文件。
  因此本次提交不新增任何 blob 存储——这两份内容早已在仓库历史里。
- `preset.js` 的音源指向改回 `.flac`。`pv37.mp3` 保持原样：它**没有无损源**，
  把有损数据转封装成 FLAC 只会涨体积，而一个 bit 的信息都不会回来。
- 体积基准由「≤35 MB」改为「不超过已发布的 v2（104.98 MB）」，实际 **96.94 MB**，
  比 v2 还小（图片部分的无损 WebP 收益仍在），不引入新的上传或订阅风险。

顺带修掉一个自己引入的 bug：改 `preset.js` 时漏写了文件名里的 `「」`，
浏览器请求 404 → `<audio>` 在 **64 ms** 内报 `MediaError.code = 4`（SRC_NOT_SUPPORTED），
看上去像"CEF 不支持 FLAC"，实际是路径不存在。判定方法记进 ADR 0004：
把同一份字节交给 `decodeAudioData`，能解出正确时长就说明解码器没问题，问题在传输或路径。

验证：
- `test-props`：CEF 支持 audio/flac、无解码错误、readyState=4、时长 205.1 s，14 项音源断言全过。
- `test-acceptance` 新增第 ⑤ 节音频格式不变式：xilian 两个音源全为 flac、无 `.ogg`/`.opus`
  残留、`preset.js` 引用的每个音源文件都存在；三种比例 0 报错；预设往返不丢音频设置。
- 分带能量实测：FLAC 高频平滑延伸到 22 kHz（20–22 kHz 处 −50 dB），无有损断崖；
  与 Opus 版逐带相差 0.0–0.3 dB。即这是一个由偏好驱动、而非由测量差异驱动的决定。
 2026-09-19 20:36:58 +08:00
Shuery eb56efbd9e feat: 比例适配、bgm 音源选择与 fps 限流，打包 v3 
取景（issue 04）
- 新增 viewport-fitter.js：让立绘层缩放跟随背景图的 cover 缩放——背景放大多少倍、
  特效就放大多少倍。原先背景走 cover、立绘层走 contain，比例一变两者就分叉。
  16:9 下与作者设定逐像素一致（kv37 为 0 差异）。实测证伪了"contain 会裁掉作者视口"
  这个最初的判断：contain 在任何比例下都完整含住作者视口。
- 应用方式为原地改写 config.viewport 字段后调 setViewport()，不重建播放器；
  维护挂在 config.frame 上按画布比例增量进行（config.success 早于 setViewport，拿不到视口）。

WE 属性（issue 05）
- project.json 新增 bgm combo（所有壁纸音源的并集 + 「随预设」）；所选项不属于当前壁纸时
  音频回落该壁纸默认，选择本身保留。
- fps 限流包裹实例 drawFrame 并接管排程。修掉两个实测缺陷：朴素丢帧会把 rAF 抖动放大成
  整拍丢失（目标 30fps 实测只有 22.5fps）；fps:0 被真值判断吞掉导致无法取消限流。

打包（issue 06）
- project.json version 升至 3 并更新描述；preset 的 combo 取值保持 xilian/kv37 不变。
- preview.gif 821 KB → 347 KB（每 2 帧取 1 帧 + 128 色不抖动，逐帧与源帧像素完全相同）。
- index.html 加内联 favicon，消除 CEF 自动请求 /favicon.ico 造成的 404 报错。

其它
- dist/scripts/wallpaper-engine.js 移到 tools/：它没有任何入口引用，且环境判据依赖真实 WE
  并不存在的 wallpaperRegisterListener，一旦按它自己的说明挂进 index.html 会在生产环境自我激活。
- 修正死文件检查：原检查会拿文件名匹配到文件自身的内容，使这类文件漏网。
- 新增离线算式验证与 resize / 属性 / 全量验收三套浏览器测试脚本。
 2026-09-19 20:29:25 +08:00
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 a391021041 perf: 体积从 105.1 MB 降到 28.9 MB（音频转 Opus、图片无损 WebP） 
- 两首 flac 母带移入 masters/（gitignore，不入库），转 Opus 128k VBR：3.35 + 3.16 MB
- xilian 三张真 PNG RGBA → 无损 WebP（3.39→1.80、5.01→2.83、3.38→1.76 MB）
- kv37_xilian.png → 无损 WebP 5.13→2.75 MB
- kv37 五张图本来就是 WebP（扩展名误写成 .png），本次只改名并把 atlas 页名改为 .webp
- 删除死文件 dist/jsconfig.json
- 新增 tools/rawdiff.mjs（区分可见差异与仅透明下差异）、tools/atlas-pages.mjs

验证：check-paths 11/11；0 个非 favicon 的 404；无损 WebP 可见像素 0 差异；
libwebp 会改写完全透明像素下的 RGB（xilian 三图 32-49% 像素），渲染级对拍
与 PNG 版相差 0.052/255、热力图全空，确认未因 Linear 过滤渗色。
 2026-09-19 19:41:41 +08:00
Shuery 8ad177c822 docs: 优化工作台的 spec 与 6 个实施 issue（.scratch/wallpaper-optimization/） 
按本仓 issue-tracker 约定落盘：spec.md 记决策与验收，issues/NN-*.md 一步一票。
01 已完成，02-06 待做。
 2026-09-19 19:27:47 +08:00
Shuery 09ff322fe8 refactor: 资源按 游戏/壁纸 分层，预设拆进各自壁纸目录 
- 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）。
 2026-09-19 19:26:46 +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
Shuery d8c7e492f7 chore: 基线 — 已发布壁纸现状原样入库（未做任何改动） 
dist/ 为 Wallpaper Engine 网页壁纸「【崩坏：星穹铁道】昔涟」(workshopid 3604974793, version 2)，
含两套预设 xilian / kv37，总计 105.1MB。本次提交不做任何修改，仅作为后续优化的对拍基线。
 2026-09-19 19:08:49 +08:00