95 lines
3.3 KiB
Markdown
95 lines
3.3 KiB
Markdown
# 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
|
|
}
|
|
```
|