契约先行(sdk-interface.d.ts+镜像 additive):白名单新增恰等键族 save:{gameId}:{versionId}(≤65536 码元,
写入必须 {schemaVersion≥1, data} 信封,宿主闸 fail-closed);idle: 族 4096 逐字不动;弃多 key 分片。
宿主闸抽纯函数模块 storageGate.ts(四闸合一可 node 直测);save-progress 插件 v1.0.0→v1.1.0 additive:
setVersioned/getVersioned 逐级迁移/缺级兜底/降档读新档不毁档/无版本旧档按 0 版进链+探针两计数。
证据:插件单测 18/18、game-runtime 31/31、宿主闸负向演示脚本入仓真跑全断言过、vue-tsc+vite build 绿。
三书 M 门影子存档降级口径解除条件就位(卡牌 M2/割草 M4/夜市 M5 切换)。设计页 docs/plans/2026-07-06-002。
1.6 KiB
1.6 KiB
SIZES.md —— 发行版字节预算实测(增量法,core-protocol-v0)
由
scripts/size.mjs在集成段(mini-desktop)生成。勿手改,改源后重跑覆盖。 口径:esbuildbundle+minify+format=iife+target=es2019+sourcemap=false; gz =zlib.gzipSync(buf,{level:9})(等价gzip -9);增量法 = 基线壳→+core→逐插件叠加,差值为各件净增。
| 叠加项 | 累计 raw | 累计 gz | 增量 raw | 增量 gz | gz 预算 | 判定 |
|---|---|---|---|---|---|---|
| 基线壳 | 0 | 0 | — | — | — | 基准 |
| +core | 9959 | 3655 | 9959 | 3655 | — | — |
| +example | 10503 | 3895 | 544 | 240 | 2048 | ✔ ≤2048 |
| +audio-music | 17029 | 6134 | 6526 | 2239 | 12288 | ✔ ≤12288 |
| +collision | 22253 | 8291 | 5224 | 2157 | 8192 | ✔ ≤8192 |
| +gamefeel | 26267 | 9496 | 4014 | 1205 | 4096 | ✔ ≤4096 |
| +hud-ui | 31560 | 11305 | 5293 | 1809 | 4096 | ✔ ≤4096 |
| +palette-post | 36467 | 12990 | 4907 | 1685 | 8192 | ✔ ≤8192 |
| +particles-juice | 40779 | 14575 | 4312 | 1585 | 10240 | ✔ ≤10240 |
| +physics-lite | 43285 | 15521 | 2506 | 946 | 6144 | ✔ ≤6144 |
| +runtime-probe | 46246 | 16736 | 2961 | 1215 | 6144 | ✔ ≤6144 |
| +save-progress | 52198 | 18656 | 5952 | 1920 | 2048 | ✔ ≤2048 |
| +scene-fsm | 53526 | 19126 | 1328 | 470 | 3072 | ✔ ≤3072 |
| +session-score | 54484 | 19450 | 958 | 324 | 2048 | ✔ ≤2048 |
| +timer-scheduler | 55937 | 19897 | 1453 | 447 | 3072 | ✔ ≤3072 |
合计插件 gz 增量 ≈ 16242B(自律线 60K;超 60K 须创始人显式放行,执行版 §5)。