Shuery/SpineWallpaper
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
10 Commits 1 Branch 0 Tags
3f11426964c282708d9480ca7f43865048d06038
Commit Graph
6 Commits
Author SHA1 Message Date
Shuery 3f11426964 feat: TS 构建管线、Spine 抓取器与 wallpapers/ 唯一真相来源 
把项目从「手写 dist/」改成「wallpapers/ 是唯一真相来源，dist/ 由 pnpm build 生成」，
并补上配套的类型、门禁与抓取器。一次提交落地整条管线，因为拆开会留下不能构建的中间态。

- src/：运行时与模拟器源码（TS，strict），编译到 build/ 再拷进各分发
- tools/：build / dev / check-{syntax,paths,dist}，以及抓取器与回归门禁 tools/checks/
  （.scratch/ 下那批一次性脚本移入 tools/checks/ 并入库为长期门禁）
- wallpapers/：七档壁纸的源数据 + README.md（id/音频/预设的完整规范）
- docs/adr/0005-0008：构建管线与分发拓扑、模拟器契约、自包含 sim、每骨架资源布局
- .gitignore：排除 .scratch/ 的参考资料副本（上游 spine 整仓克隆 ~1.2 GB、
  抓取侦查数据 ~680 MB）与调试转储；这些是本地调查材料，补偿会让仓库无法克隆
- 归一化 .gitignore/CONTEXT.md 行尾（工作区 CRLF、索引 LF 造成的整文件假 diff）

同时修掉三档卡住构建的未完工壁纸：
- kv45 的 meta.json 里 id 还是抓取期场景名 scene_main，经 downloader promote 正名为 kv45
- shajin / zhigengniao_juheye 的 meta.json 误用了骨架描述文件（name/spine/animations/pages）、
  且都缺 preset.template.json；现按规范重建：骨架沉到 spines/<名>/（spine-ts 按 atlas 所在
  目录解析贴图页）、补上元数据与单骨架预设，并清掉 zhigengniao 骨架里指向作者机的绝对路径
- 顺带 promote 已在 sources.yml 里的 kv46（月升之前，与兽共舞）

pnpm check 五道门全绿：10 个分发 / 7 档壁纸 / 141 处引用自包含。
 2026-10-02 01:27:02 +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 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