wait4x/blog - blog - wait4x git

185 Commits 4 Branches 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
wait4xandGLM-5.3	59eda420b3	perf(fonts): 字体子集化工具 + 汇文明朝单页 -40%（694KB→420KB） - 新增 scripts/build-perf/subset-fonts.py：读字体 CSS 的 @font-face （unicode-range）→ 扫内容收集实际用字 → 逐片交集裁切（pyftsubset --flavor=woff2）→ 空片丢弃、重写 src 只留自产 woff2；支持 --chars-from/--chars-mode(all\|headings)/--min-bytes/--merge - 实测口径修正后结论（关键）：汇文明朝原 694KB/页 → 子集 420KB/页（-40%，真收益，已接入）；站酷快乐体 163KB → 177KB（+9%，字跨片分散致片数增加，不启用，保留原 @fontsource 源） - merge 模式（合并单文件）标记实验性：fontTools.merge 对 CJK 切片字表冲突敏感，实测产出异常，生产不用 - 三处实现坑入档：①hast 与 @fontsource CSS 一个 face 常带多格式（woff2+woff），只替换首个 url 会残留失效引用（首版缺 58 个 .woff） → 改整段替换 src；②无 unicode-range 的 face 需按全范围处理，否则原样保留同样残留引用；③裸跑 pyftsubset 需 fonttools+brotli 验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 实测汇文 694KB→420KB 且字体栈生效（WF-Hwmc 命中） Spec: 2026-11-02_blog-5g-pages (T7) Co-authored-by: GLM-5.3	2026-11-02 18:13:47 +08:00
wait4xandGLM-5.3	3822e150a8	feat(typography): 首批 6 字族落地（新增汇文明朝/站酷快乐）+ 13 款候补清单 - 新增两款自托管字族：font-huiwen（汇文明朝体，文风开源 cn-font-split 339 片切片包，用到页 +535KB、按需拉取实测 19/339 片）｜font-kuaile （站酷快乐体 +163KB）——补齐「宋明气质」与「轻松标题」两个字体缺口 - 首批 6 族全部 OFL-1.1 且允许 web 嵌入；未用字体的页面增量恒 +0.0KB （按页子集化生效） - 候补 13 款逐款标注「许可证 + web 嵌入」：HarmonyOS Sans/MiSans/OPPO Sans/阿里普惠体（免费商用 + 明确允许嵌入，但 npm 无包/整包过大）、得意黑/更纱/站酷高端黑/花园明朝（OFL 但无可用 npm 分发）、霞鹜文楷 Light（+8605KB 否决）、演示悠然小楷（"个人免费"常禁 @font-face，风险） - docs 写入「加字四步流程」（核双授权 → 装包或放 public/fonts → 加类+ 白名单+面板项 → 跑体积账） - 可视化面板 35 项（10 字族 + 25 颜色）；白名单放行 10 字族类 - 资产：public/fonts/hwmc（339 woff2 13MB + fonts.css 162KB）入仓车道：op-artalk；收编复验：构建 48 页、E2E 37/37、两款新字体 computed 与切片按需加载实测（hwmc/27、52 等 20 个请求）验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 新字体 computed + 字体请求观测 Spec: none (字体扩展，车道级交付) Co-authored-by: GLM-5.3	2026-11-02 17:47:13 +08:00

Author

SHA1

Message

Date

wait4xandGLM-5.3

59eda420b3

perf(fonts): 字体子集化工具 + 汇文明朝单页 -40%（694KB→420KB）

- 新增 scripts/build-perf/subset-fonts.py：读字体 CSS 的 @font-face
  （unicode-range）→ 扫内容收集实际用字 → 逐片交集裁切（pyftsubset
  --flavor=woff2）→ 空片丢弃、重写 src 只留自产 woff2；支持
  --chars-from/--chars-mode(all|headings)/--min-bytes/--merge
- 实测口径修正后结论（关键）：汇文明朝原 694KB/页 → 子集 420KB/页
  （-40%，真收益，已接入）；站酷快乐体 163KB → 177KB（+9%，字跨片
  分散致片数增加，**不启用**，保留原 @fontsource 源）
- merge 模式（合并单文件）标记实验性：fontTools.merge 对 CJK 切片字表
  冲突敏感，实测产出异常，生产不用
- 三处实现坑入档：①hast 与 @fontsource CSS 一个 face 常带多格式
  （woff2+woff），只替换首个 url 会残留失效引用（首版缺 58 个 .woff）
  → 改整段替换 src；②无 unicode-range 的 face 需按全范围处理，否则
  原样保留同样残留引用；③裸跑 pyftsubset 需 fonttools+brotli

验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 实测汇文
      694KB→420KB 且字体栈生效（WF-Hwmc 命中）

Spec: 2026-11-02_blog-5g-pages (T7)

Co-authored-by: GLM-5.3

2026-11-02 18:13:47 +08:00

wait4xandGLM-5.3

3822e150a8

feat(typography): 首批 6 字族落地（新增汇文明朝/站酷快乐）+ 13 款候补清单

- 新增两款自托管字族：font-huiwen（汇文明朝体，文风开源 cn-font-split
  339 片切片包，用到页 +535KB、按需拉取实测 19/339 片）｜font-kuaile
  （站酷快乐体 +163KB）——补齐「宋明气质」与「轻松标题」两个字体缺口
- 首批 6 族全部 OFL-1.1 且允许 web 嵌入；未用字体的页面增量恒 +0.0KB
  （按页子集化生效）
- 候补 13 款逐款标注「许可证 + web 嵌入」：HarmonyOS Sans/MiSans/OPPO
  Sans/阿里普惠体（免费商用 + 明确允许嵌入，但 npm 无包/整包过大）、
  得意黑/更纱/站酷高端黑/花园明朝（OFL 但无可用 npm 分发）、霞鹜文楷
  Light（+8605KB 否决）、演示悠然小楷（"个人免费"常禁 @font-face，风险）
- docs 写入「加字四步流程」（核双授权 → 装包或放 public/fonts → 加类+
  白名单+面板项 → 跑体积账）
- 可视化面板 35 项（10 字族 + 25 颜色）；白名单放行 10 字族类
- 资产：public/fonts/hwmc（339 woff2 13MB + fonts.css 162KB）入仓

车道：op-artalk；收编复验：构建 48 页、E2E 37/37、两款新字体 computed
与切片按需加载实测（hwmc/27、52 等 20 个请求）

验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 新字体 computed
      + 字体请求观测

Spec: none (字体扩展，车道级交付)

Co-authored-by: GLM-5.3

2026-11-02 17:47:13 +08:00