feat: P4 阶段A+B — data.js 瘦身 116KB(预计算 + css 分离)
执行 ROADMAP 的 S1-P4,按规划的三阶段走,本次完成 A 与 B。 阶段 A · 预计算 scenarios(验证「构建期预计算 + 运行时回退」链路) - tools/precompute.mjs:与 app.js 的 extractScenarios 逻辑完全一致, 构建期算出结果写进 data.components[].scenarios - app.js 加快速路径:优先读 c.scenarios,缺失时回退运行时解析 - 浏览器实测:预计算值与运行时提取值**完全一致**(逐字节比对) - 实测收益有限:仅 4 个组件有 ≥2 场景(场景卡片本就少见), 但链路验证通过,为阶段 C 的 API 预计算铺路 阶段 B · css 源码分离(零风险,css 不参与任何解析) - css 从 data.js 移到 site/sources/<slug>/css.txt(79 个文件) - data.js 里改为 sourcesRef.css 引用,data.json 保持完整(For Agents 承诺) - data.js: 1058 KB → 942 KB(−116 KB) - app.js 新增 srcOf(c, kind) / hasSrc(c, kind): · srcOf 同步返回已有源码,缺失时触发后台 fetch 并缓存 · __aaSrcReady 回调在加载完成后填充代码区 - 修正回调时机 bug:原实现捕获构建时的 current(初始 tab), 导致用户后续切换的 tab 收不到通知。改为回调内实时比对当前 tab 关于 P4 的实测修正(已登记 ROADMAP 规划修正记录) - 规划估计「拆 sources → ~110KB」。实测 css 仅占 119KB/888KB, 且 html/vue2/vue3/jsx 共 765KB 被**渲染期同步消费** (extractComponentAPI 读 vue3/vue2/jsx,extractScenarios 读 html) - 故需分阶段:A+B 先减 116KB,阶段 C 需先预计算 API 表才能分离其余 4 端 新增构建链(两步,不可省第二步) - npm run build:site = build-site.ps1 + precompute.mjs - build-site.ps1 会把 data.js 重写回全量,precompute 才做瘦身 - 已写入 AGENTS.md 的铁律章节(含「只跑第一步会怎样」的后果说明) 验证 - 回归 100%:1003/1003,79 页全通过,N/A 35 - 浏览器实测:展开代码区 → CSS tab → 2121 字符正常显示, Network 出现 sources/button/css.txt 请求 - 预计算 vs 运行时场景提取结果逐字节一致
This commit is contained in:
@@ -50,6 +50,20 @@ PowerShell 5.1 按 ANSI 读无 BOM 文件 —— 脚本里出现非 ASCII 字面
|
||||
- 输出用 `[System.IO.File]::WriteAllText($path, $content, [System.Text.UTF8Encoding]::new($false))` 写无 BOM
|
||||
- `build-site.ps1` 只能在 Windows 跑;CI 需要构建时改用 `runs-on: windows-latest`
|
||||
|
||||
#### 构建链是两步,必须按序执行
|
||||
|
||||
```bash
|
||||
npm run build:site # 等价于下面两步
|
||||
# 1) powershell -NoProfile -ExecutionPolicy Bypass -File build-site.ps1
|
||||
# 2) node tools/precompute.mjs
|
||||
```
|
||||
|
||||
**第 2 步不能省** —— `build-site.ps1` 会把 `data.js` 重写回全量(1058 KB),
|
||||
`tools/precompute.mjs` 才做瘦身(→ 942 KB,把 css 源码移到 `site/sources/<slug>/css.txt`)。
|
||||
只跑第 1 步会导致:`data.js` 变大、且 `sourcesRef` 字段消失 → 详情页代码区缺 CSS tab。
|
||||
|
||||
单独重跑只需 `npm run precompute`。
|
||||
|
||||
### 3. 改结构要改模板
|
||||
|
||||
`tests/<slug>.html` × 79 是**生成物**。改它们没用 —— 下次重跑会被覆盖。
|
||||
|
||||
Reference in New Issue
Block a user