web-font/task.md

3.4 KiB
Raw Blame History

任务:字体子集化持续优化(/loop 持续循环)

角色

你是本仓库(web-font)的性能优化工程师。核心资产是 backend/font_util/font.ts 的 fontSubset(含 TTF/CFF/GSUB/GPOS 子集化与纯 JS WOFF2 编码器),前端 SDK 在 packages/,基准测试为 基准测试.test.ts(puppeteer 无头渲染 + SSIM)。

目标(按优先级)

  1. 正确性不可破:任何改动后基准必须全 PASS,且与改动前基线对比——输出字节应逐字节一致或差异可解释,SSIM 不低于该用例历史值
  2. 性能:继续压缩子集化耗时(avg 与 min 都要看,min 才是真本事,avg 含噪声),以及输出体积
  3. 能力扩展:见「待探索方向」,完成一项验证一项

验收流程(每轮改动必须走完)

  1. 改动前先跑一次基准留存基线:pnpx tsx ./基准测试.test.ts
  2. 小步改动:一次只改一个热点,禁止混合多项优化
  3. 改动后再跑基准,与步骤 1 结果逐用例对比:
    • 耗时:avg 下降或持平即合格;波动大时跑两次交叉验证(参考 benchmark_results/BASELINE_2026-08-27.md 的 min1/min2 对照法)
    • 字节:逐用例对比输出 bytes,不一致必须能解释(如重映射后序列化更紧凑)并写进日志
    • SSIM:不得低于该用例历史值。注意:篆体用例历史 min=0.9876 是原字体光栅化固有差异(已三重验证),不是回归,不要试图"修"它
  4. TS 改动执行 pnpm tsc --noEmit 确认无类型错误(类型错误≈逻辑错误)
  5. 全部通过后才写入 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。

待探索方向

  1. 前端 SDK 扫描策略可配置化(packages/webfont-sdk):目前定时器扫描文本,增加配置项支持三种模式——定时扫描(默认)/ 用户事件触发 / 用户直接传文本(零扫描,demo 场景响应最快)
  2. profile 驱动的剩余热点:FiraCode-代码(GSUB 密集)与千字文 woff2(轮廓点多)仍是相对最慢用例,值得继续下钻
  3. 输出体积:子集 TTF/WOFF2 做表级体积分析,寻找无损压缩空间
  4. 无方向可做时:跑多字体鲁棒性扫描补测试覆盖(注意区分原字体缺字与真回归),而不是为优化而优化