Shuery
3f11426964
把项目从「手写 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 处引用自包含。
2.3 KiB
2.3 KiB
06 打包 v3 并重新发布
Status: resolved（第 4 步为人工步骤，待用户执行）
步骤与结果
-
project.json：version升到 3；描述新增"可切换各预设自带的背景音乐""自适应窗口比例"； 新增bgmcombo 与bgm_note。核对：preset的 combo 取值仍是xilian/kv37（用户已保存的设置依赖它，绝不能改）。完成。 -
preview.gif：原 160×160 / 50 帧 / 25fps / 2.0s / 821 KB，超推荐值 500 KB。 重新压缩命令（结果可复现）：ffmpeg -y -i dist/preview.gif -filter_complex ` "[0:v]fps=12.5,split[a][b];[a]palettegen=max_colors=128:stats_mode=full[p];[b][p]paletteuse=dither=none" ` -loop 0 .scratch/pv-I.gif Copy-Item .scratch/pv-I.gif dist/preview.gif -Force（不能把输入输出写成同一个文件，ffmpeg 会拒绝；必须先输出到临时文件再覆盖。） 即"每 2 帧取 1 帧 + 128 色 + 不抖动"，逐帧与源帧像素完全相同（第 k 帧对原第 2k 帧， 抽查 0/6/12/18/24 帧全部 SSIM 1.0、max|diff| 0），只是时间采样率减半： 160×160 / 25 帧 / 12.5fps / 2.0s / 347 KB。完成。 注：减色到 96/64/48 色收效甚微（604/519/474 KB）——体积由帧间变化量主导，不由调色板主导， 所以走帧采样率这条路更划算。
-
全量验收（
node tools/checks/test-acceptance.mjs）：全部通过- 总体积 96.94 MB / 33 个文件——未超已发布的 v2（104.98 MB），音频走无损后仍比 v2 小
- 0 死文件
- 音频格式不变式：xilian 两个音源均为
flac、pv37.mp3保持 mp3、已无.ogg/.opus残留、preset.js引用的音源路径全部可达 project.json解析正常、version 3、bgm 存在、preset 取值未变- 21:9 / 16:9 / 9:16 三种比例：播放器就绪、可见矩形比例与画布一致、0 控制台报错 / 0 异常
- 预设往返 10 次：自定义音源与音量 0.2 均未丢失，仍在持续绘制，0 未捕获异常
-
上传到 Workshop：人工步骤，需要用户操作。 本次为破坏性较小的重构（16:9 逐像素不变），但 21:9 / 9:16 下构图按设计改变，建议在 超宽屏与竖屏各看一眼再发布。