wait4x/blog - blog - wait4x git

216 Commits 4 Branches 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
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
wait4xandGLM-5.3	26bbb66a72	feat(typography): 16 类语义色板（8 色相×2 档）+ 字体回退升级 + 面板 v2 - 颜色：c-{blue,teal,green,yellow,orange,red,pink,purple} × {标准,soft} 共 16 类；tokens 明暗各一套值，32 项浏览器实测对比度 4.50–11.73（零失败）；黄色压到 #7a5900（原色白底仅 ~1.8:1）、黄/粉 soft 压深留余量 - 使用纪律入档：彩色只作用于正文强调，站点外壳（导航/页脚/按钮/背景/边框）保持灰阶，单页彩色强调建议 ≤3 处 - 字体：3/4 回退类升级为「自托管优先 + 系统兜底」（font-song→Noto Serif SC、 font-kai-sys→霞鹜文楷、font-hei-sys→Noto Sans SC，+0.0KB 跨设备一致）；仿宋无 OFL 自托管包（fandol/朱雀仿宋均无版本）→ 纯系统回退，缺口待决策 - webfont 候选全部按体积账否决并留档：霞鹜文楷 Light 用到页 +8605KB、站酷小薇 +648KB、得意黑/更纱/汇文无可用 npm 包；根因=@fontsource CJK 切片粒度 - 可视化面板 v2：33 项（8 字族 + 25 颜色），颜色项带 16px 色块预览、字体项带示例字形「秋海」并标注自托管/优先/系统；桩 CMS 7 项验证全过 - 白名单放行 25 色类 + 8 字族类；docs 三表（灰阶层级/语义色板含对比度/字体含许可证与体积账）更新车道：op-artalk（改口径后重跑，实测表齐全）；收编复验：CSS 16 色类定义与白名单一致、暗态值在 [data-theme="dark"] 段、字体回退类 computed 生效、构建 48 页、E2E 37/37 验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 抽查彩色类与字体回退 computed Spec: none (排版色板与字体回退，车道级交付) Co-authored-by: GLM-5.3	2026-11-02 17:14:12 +08:00
wait4xandGLM-5.3	2cab243891	feat(typography): 可视化排版选择器（Sveltia inline 组件）+ 颜色扩充 + 方案 10 - 可视化选择（核心痛点解决）：Sveltia 原生支持 registerEditorComponent 的 inline 形态且 onInsert 能拿到 selectedText → 实现「选中文字 → Insert ▸ 排版 → 选字体/颜色 → 自动包 span class」完整链路；因 inline 组件只能进 Insert 菜单（field-based 虽可上工具栏但拿不到 selectedText），两个独立组件会互相抢 pattern 匹配，故收敛为单入口 + 18 项分组面板（键盘可达/Esc 取消/ onEdit 回填当前类） - public/admin/typography-classes.js 为单一事实源（扩展与文档共用） - 颜色扩充 4 类：ink-warm / ink-cool / ink-faint / ink-accent-soft，全部亮暗双态实测 ≥4.5:1（ink-faint 取白底达标的最淡值 4.69/4.75） - 字体：体积账否决 webfont 新增（@fontsource zcool-xiaowei 用到即 +647.7KB，远超 150KB 阈值；smiley-sans 无可用版本、sarasa 包为空壳），改为落地 4 个系统回退类（font-song/font-kai-sys/font-hei-sys/font-fangsong，零下载，文档注明依赖访客设备） - 白名单 17 类同步；docs/写作指南.md 三表更新 - docs/research/10-页面后台化方案.md：五方案对比 + 推荐方案 E（页面骨架 blocks / 区块字段 / 局部自由区 / 样式即数据四层）+ 关于页九类区块 + 消毒与验收断言 + 分阶段清单（约 7.2d）验证: 16/16 颜色 computed 与对比度实测；选择器 7/7（桩 CMS 覆盖注册/插入/ 编辑三层）；构建 48 页 exit 0；E2E 37/37 Spec: none (排版能力 + 方案文档) Co-authored-by: GLM-5.3	2026-11-02 16:57:54 +08:00

Author

SHA1

Message

Date

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

wait4xandGLM-5.3

26bbb66a72

feat(typography): 16 类语义色板（8 色相×2 档）+ 字体回退升级 + 面板 v2

- 颜色：c-{blue,teal,green,yellow,orange,red,pink,purple} × {标准,soft}
  共 16 类；tokens 明暗各一套值，32 项浏览器实测对比度 4.50–11.73（零失败）；
  黄色压到 #7a5900（原色白底仅 ~1.8:1）、黄/粉 soft 压深留余量
- 使用纪律入档：彩色只作用于正文强调，站点外壳（导航/页脚/按钮/背景/边框）
  保持灰阶，单页彩色强调建议 ≤3 处
- 字体：3/4 回退类升级为「自托管优先 + 系统兜底」（font-song→Noto Serif SC、
  font-kai-sys→霞鹜文楷、font-hei-sys→Noto Sans SC，+0.0KB 跨设备一致）；
  仿宋无 OFL 自托管包（fandol/朱雀仿宋均无版本）→ 纯系统回退，缺口待决策
- webfont 候选全部按体积账否决并留档：霞鹜文楷 Light 用到页 +8605KB、站酷小薇
  +648KB、得意黑/更纱/汇文无可用 npm 包；根因=@fontsource CJK 切片粒度
- 可视化面板 v2：33 项（8 字族 + 25 颜色），颜色项带 16px 色块预览、字体项带
  示例字形「秋海」并标注自托管/优先/系统；桩 CMS 7 项验证全过
- 白名单放行 25 色类 + 8 字族类；docs 三表（灰阶层级/语义色板含对比度/字体
  含许可证与体积账）更新

车道：op-artalk（改口径后重跑，实测表齐全）；收编复验：CSS 16 色类定义与
白名单一致、暗态值在 [data-theme="dark"] 段、字体回退类 computed 生效、
构建 48 页、E2E 37/37

验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 抽查彩色类与
      字体回退 computed

Spec: none (排版色板与字体回退，车道级交付)

Co-authored-by: GLM-5.3

2026-11-02 17:14:12 +08:00

wait4xandGLM-5.3

2cab243891

feat(typography): 可视化排版选择器（Sveltia inline 组件）+ 颜色扩充 + 方案 10

- 可视化选择（核心痛点解决）：Sveltia 原生支持 registerEditorComponent
  的 inline 形态且 onInsert 能拿到 selectedText → 实现「选中文字 → Insert ▸
  排版 → 选字体/颜色 → 自动包 span class」完整链路；因 inline 组件只能进
  Insert 菜单（field-based 虽可上工具栏但拿不到 selectedText），两个独立组件
  会互相抢 pattern 匹配，故收敛为单入口 + 18 项分组面板（键盘可达/Esc 取消/
  onEdit 回填当前类）
- public/admin/typography-classes.js 为单一事实源（扩展与文档共用）
- 颜色扩充 4 类：ink-warm / ink-cool / ink-faint / ink-accent-soft，全部亮暗
  双态实测 ≥4.5:1（ink-faint 取白底达标的最淡值 4.69/4.75）
- 字体：体积账否决 webfont 新增（@fontsource zcool-xiaowei 用到即 +647.7KB，
  远超 150KB 阈值；smiley-sans 无可用版本、sarasa 包为空壳），改为落地 4 个
  **系统回退类**（font-song/font-kai-sys/font-hei-sys/font-fangsong，零下载，
  文档注明依赖访客设备）
- 白名单 17 类同步；docs/写作指南.md 三表更新
- docs/research/10-页面后台化方案.md：五方案对比 + 推荐方案 E（页面骨架 blocks
  / 区块字段 / 局部自由区 / 样式即数据四层）+ 关于页九类区块 + 消毒与验收断言
  + 分阶段清单（约 7.2d）

验证: 16/16 颜色 computed 与对比度实测；选择器 7/7（桩 CMS 覆盖注册/插入/
      编辑三层）；构建 48 页 exit 0；E2E 37/37

Spec: none (排版能力 + 方案文档)

Co-authored-by: GLM-5.3

2026-11-02 16:57:54 +08:00