3.3 KiB
3.3 KiB
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 增量提议
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
遗留事项
- 无；问题处置见下方结构化区块
问题处置
{
"issues": [],
"version": 1
}