# Phase 5g:页面后台化(blocks 模型)与字体子集化 - 完成总结 ## 交付结论 - 结果:完成 - 完成时间:2026-11-02 19:19 ## 假设回顾 ### 已验证假设 - 块渲染器受控,破版风险低于整页 HTML 直编(方案 10 §2 对比表) - 字体子集化(pyftsubset 按页实际用字)能把艺术字体单页增量压到 ≤150KB 阈值内 ### 仍未完全验证的假设 - 无 ## 交付范围 ### 已交付 - T1 blocks 骨架(关于页块式页面构建器) - T2 块型扩充与图片管线 - T3 样式即数据(theme.yaml + 对比度闸门) - T4 首页细化与去重 - T5 开源页收尾(缓存/回落/告警) - T6 文档与后台 hint 补齐 - T7 字体子集化工具 ### 未交付 - 无 ### 偏差说明 - 无 ## 简化决策 ### 保持简单的关键选择 - 最简单可行方案:块类型先用 3 类跑通闭环(prose/tracks/divider),再扩到 9 类;theme 只做 12 个白名单旋钮 - 暂不引入:可视化块预览、块级动画配置 - 不做的抽象:通用页面 DSL(只服务现有页面) ### 本轮明确不做的内容 - 换 CMS、页面布局的任意拖拽网格、运行时编辑器 ## 变更边界 ### 本轮主要改动模块 - 见 tasks.md 的 boundary 记录 ### 明确未触碰的区域 - 换 CMS、页面布局的任意拖拽网格、运行时编辑器 ## 验证证据 ### 备注 - 机器证据:runs.jsonl(见验证范围的机器验证率) ## 验证范围 - 级别:package - 机器验证率:7/7 - 规则:check 与 done 复用该范围;只有记录升级触发时才执行全项目检查 ## 哲学生效证据 ### 行为成效回填 - Development Record 行为门禁通过 ### 一致性门禁回顾 - 验收面(checklist 或成功标准)已通过 ## Git 记录 - 日期时间:2026-11-02 19:19 - 范围:Phase 5g:页面后台化(blocks 模型)与字体子集化 - 功能:T1 blocks 骨架(关于页块式页面构建器);T2 块型扩充与图片管线;T3 样式即数据(theme.yaml + 对比度闸门);T4 首页细化与去重;T5 开源页收尾(缓存/回落/告警);T6 文档与后台 hint 补齐;T7 字体子集化工具 - 操作:提交 / 推送 - 成效:Development Record 行为门禁通过 - 提交:pending local commit - 提交区间:3822e150a87ac5fee56c9b2724eae23389e7c34e..23b79a2473674e75608736e2cac491b163a49c35 - 推送:not-run (push stage follows commit) ## AGENTS.md 增量提议 ```diff Phase 5g 资产:①块式页面构建器(九类 discriminatedUnion + 宽松分支容错:已知块严格校验、未知块 WARN 丢弃不炸构建);②样式即数据(theme.yaml 九组白名单旋钮 + :root:root 特异性注入 + 产物级对比度闸门,负例 1.61:1 被拦);③首页抽 HomePage 消 zh/en 双份;④字体子集化工具(汇文 694→420KB −40%;快乐体实测反向 −9% 故不启用,结论入档避免后人重试);⑤config.yml 重复键结构缺陷的教训——Python yaml 静默覆盖,必须用 StrictLoader/Node yaml 校验,已固化为 build 闸门 config-check.py;⑥并发构建擦 dist 的解法:build→cp -a dist 快照→快照起服务跑 E2E。 ``` ## 被拒绝的扩展提议 - 无 ## 门禁证据 - check_spec_package.py exit 0 ## 遗留事项 - 无;问题处置见下方结构化区块 ## 问题处置 ```json { "issues": [], "version": 1 } ```