WIP-343① · 微信开发者工具主包实包补测 · 机位代跑命令(扣子一号 · 2026-09-15)
依据:WIP-343①波波欠账③「代理值 2884KB 不能判实包」+ 刘总冻结档位 recommended 3072KB(D2 §7)
⚠️ 沙箱无微信开发者工具(GUI)/无上传密钥,实包只能在持有工具的机位实测(本文件自带判据与回执格式)
一、为什么必须实包(口径)
- 代理体积 =
miniprogram/miniprogram/ 全文件求和(排除 mock/)= 2884KB(2026-09-15 复跑确认,commit 9eb7d22a) - 微信实包受
ignoreUploadUnusedFiles / minified / 分包折叠影响,代理 ≠ 实包;硬约束 =「实包 ≤2048KB 须微信开发者工具实测」列 335 发布阻断判据(D2 §7) - 档位:总包 recommended 3072KB(余量 = 3072 − 实包);实包 ≤2048 = 解锁硬约束
二、测试步骤(机位)
方法 A(推荐 · 开发者工具「上传」对话框)
- 本机拉到仓库,安装依赖:
cd miniprogram && pnpm install - 用微信开发者工具打开
miniprogram/(appid 已配 wx7ec46db1834dbd14) - 工具栏「上传」(不开「浏览」也行),弹出框「选择上传版本」左下角即显示主包大小、分包大小(精确到 KB)
- 若仅想看体积不想真上传:点「更改」→ 上传对话框的「代码分析」页同样可选
方法 B(CI · miniprogram-ci preview,需上传密钥)
WEAPP_UPLOAD_KEY=/path/to/private.wx7ec46db1834dbd14.key \
node scripts/upload_weapp_experience.js 0.1.x "343①实包补测预览"
# 或 cli 预览:微信开发者工具 CLI
"/Applications/wechatwebdevtools.app/Contents/MacOS/cli" preview --project miniprogram --compile-condition '{"pathName":"pages/index/index"}'
三、判据(PASS/FAIL)
| 指标 | 口标 | 判定 |
| 主包实包体(KB) | ≤2048 | <2048=PASS(解锁硬约束);≥2048=FAIL(335 阻断,需分包) |
| 总包实包(主+分包,KB) | ≤3072 | ≤3072=PASS;>3072=FAIL(超出 recommended 档) |
| 代理基线回归 | =2884KB(±漂移须解释) | 复跑 bash scripts/mainpack_size_check.sh 对比 |
四、回执格式(机位跑完贴 TASKS WIP-343① 行尾)
【343①实包回执 · 机位】时间=?:主包=?KB / 分包=?KB / 总=?KB;工具=开发者工具CI/上传框
判定=PASS/FAIL(≤2048 解锁 / ≤3072 合规);代理回归=?KB(对比 2884)
截图挂 evidence/c1/343/realpack.png(可选)
【343①实包回执 · 一号复核】代理 2884 复跑一致;口径与 3072/2048 判据对齐 —— 署名:扣子一号
五、当前证据(沙箱可做部分)
- 代理基线复跑:
bash scripts/mainpack_size_check.sh → 2884KB(commit 9eb7d22a,TOP 大文件 texts.ts 44KB / logo 36KB / home.wxss 24KB / draft logo 24KB)——与波波 09-14 及不符点无新增,未分包(app.json 无 subPackages,113 页全在主包) - ⚠️ 代理 2884 对 3072 档余量仅 188KB → 实包若 >2884 将超 3072,且 113 页未分包是主因,强烈建议分包入 335 前置整改(即使实包≤2048,总包大概率逼近 3072)