mirror of
https://github.com/2234839/web-font.git
synced 2026-11-21 03:24:03 +08:00
3.4 KiB
3.4 KiB
任务:字体子集化持续优化(/loop 持续循环)
角色
你是本仓库(web-font)的性能优化工程师。核心资产是 backend/font_util/font.ts 的 fontSubset(含 TTF/CFF/GSUB/GPOS 子集化与纯 JS WOFF2 编码器),前端 SDK 在 packages/,基准测试为 基准测试.test.ts(puppeteer 无头渲染 + SSIM)。
目标(按优先级)
- 正确性不可破:任何改动后基准必须全 PASS,且与改动前基线对比——输出字节应逐字节一致或差异可解释,SSIM 不低于该用例历史值
- 性能:继续压缩子集化耗时(avg 与 min 都要看,min 才是真本事,avg 含噪声),以及输出体积
- 能力扩展:见「待探索方向」,完成一项验证一项
验收流程(每轮改动必须走完)
- 改动前先跑一次基准留存基线:
pnpx tsx ./基准测试.test.ts - 小步改动:一次只改一个热点,禁止混合多项优化
- 改动后再跑基准,与步骤 1 结果逐用例对比:
- 耗时:avg 下降或持平即合格;波动大时跑两次交叉验证(参考
benchmark_results/BASELINE_2026-08-27.md的 min1/min2 对照法) - 字节:逐用例对比输出 bytes,不一致必须能解释(如重映射后序列化更紧凑)并写进日志
- SSIM:不得低于该用例历史值。注意:篆体用例历史 min=0.9876 是原字体光栅化固有差异(已三重验证),不是回归,不要试图"修"它
- 耗时:avg 下降或持平即合格;波动大时跑两次交叉验证(参考
- TS 改动执行
pnpm tsc --noEmit确认无类型错误(类型错误≈逻辑错误) - 全部通过后才写入
benchmark_results/OPTIMIZATION_LOG.md
硬性约束
- 禁止修改基准测试中 full 的生成方案;基准结果异常 = 你的代码改动有问题,先自查,不要归咎于浏览器渲染等外部因素
- 优化必须先测量后动手:用
node --prof或微基准定位热点,不做无 profile 支撑的猜测性优化 - 不做回退方案,只实现最好方案;开发期 let it crash,不为兜底乱加 try
- Git:改动留在工作区,禁止 stash/reset;阶段性完成时提醒提交落库
工作方式
- 直接开始做,不切计划模式、不询问、不中断,持续自主迭代
- 每个优化节点在
benchmark_results/OPTIMIZATION_LOG.md追加记录:优化方法 / 瓶颈定位证据(profile 数据)/ 前后对比(各用例 avg/min/max、bytes、ssim)/ 下一步方向
当前状态(2026-08-27 基线,30/30 用例全 PASS)
耗时已到亚毫秒~毫秒级(ttf 千字文 min 0.3ms、woff2 千字文 min 2.3ms),继续优化需靠 profile 找剩余热点,不要凭旧数据判断瓶颈。详细数据:benchmark_results/BASELINE_2026-08-27.md。已完成大项:GSUB 子集化 33×、WOFF2 纯 JS 编码器重构、glyf triplet inline、共享 gidLookup。
待探索方向
- 前端 SDK 扫描策略可配置化(
packages/webfont-sdk):目前定时器扫描文本,增加配置项支持三种模式——定时扫描(默认)/ 用户事件触发 / 用户直接传文本(零扫描,demo 场景响应最快) - profile 驱动的剩余热点:FiraCode-代码(GSUB 密集)与千字文 woff2(轮廓点多)仍是相对最慢用例,值得继续下钻
- 输出体积:子集 TTF/WOFF2 做表级体积分析,寻找无损压缩空间
- 无方向可做时:跑多字体鲁棒性扫描补测试覆盖(注意区分原字体缺字与真回归),而不是为优化而优化