98 lines
4.0 KiB
Markdown
98 lines
4.0 KiB
Markdown
# Phase 5i：字体加载根治、交互缺陷修复与书架/开源页再设计 - 完成总结
|
|
|
|
## 交付结论
|
|
- 结果：完成
|
|
- 完成时间：2026-11-03 12:46
|
|
|
|
## 假设回顾
|
|
### 已验证假设
|
|
- 字体按「内容实际用到的字族」按需加载即可兼顾体积与正确性（构建期扫正文/页面文案里的 `font-*` 类）
|
|
- README 动效图均为 SVG（含 SMIL/CSS 动画），可在构建期抓取并自托管，运行时零第三方请求，动效保留
|
|
- 灯箱信息栏与关闭钮的层叠冲突用 z-index + 命中区域划分即可解，无需改结构
|
|
|
|
### 仍未完全验证的假设
|
|
- 无
|
|
|
|
## 交付范围
|
|
### 已交付
|
|
- T1 字族按需加载根治
|
|
- T2 Artalk 失败误报修复
|
|
- T3 瞬间评论区配色同步
|
|
- T4 灯箱关闭修复 + 右侧文字可排版
|
|
- T5 取消彩色强调次数限制
|
|
- T6 开源页项目墙恢复居中
|
|
- T7 书架页重做
|
|
- T8 README 动效图自托管与展示创新
|
|
- T9 字族扩展（款式待用户拍板）
|
|
|
|
### 未交付
|
|
- 无
|
|
|
|
### 偏差说明
|
|
- 无
|
|
|
|
## 简化决策
|
|
### 保持简单的关键选择
|
|
- 最简可行：字体先修门禁（用现有 6 族验证通过），再谈扩展；灯箱只改层级与命中；README 动效先接 3 类（typing / stats / snake），验证体积与稳定性后再补
|
|
- 暂不引入：字体子集化的自动重跑编排、灯箱信息栏的富文本编辑器 UI
|
|
- 不做的抽象：通用「动效资源托管」服务
|
|
|
|
### 本轮明确不做的内容
|
|
- 换 CMS、评论系统替换、Artalk 服务端改造
|
|
|
|
## 变更边界
|
|
### 本轮主要改动模块
|
|
- 见 tasks.md 的 boundary 记录
|
|
|
|
### 明确未触碰的区域
|
|
- 换 CMS、评论系统替换、Artalk 服务端改造
|
|
|
|
## 验证证据
|
|
### 备注
|
|
- 机器证据：runs.jsonl（见验证范围的机器验证率）
|
|
|
|
## 验证范围
|
|
- 级别：package
|
|
- 机器验证率：9/9
|
|
- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
|
|
|
|
## 哲学生效证据
|
|
### 行为成效回填
|
|
- Development Record 行为门禁通过
|
|
|
|
### 一致性门禁回顾
|
|
- 验收面（checklist 或成功标准）已通过
|
|
|
|
## Git 记录
|
|
- 日期时间：2026-11-03 12:46
|
|
- 范围：Phase 5i：字体加载根治、交互缺陷修复与书架/开源页再设计
|
|
- 功能：T1 字族按需加载根治；T2 Artalk 失败误报修复；T3 瞬间评论区配色同步；T4 灯箱关闭修复 + 右侧文字可排版；T5 取消彩色强调次数限制；T6 开源页项目墙恢复居中；T7 书架页重做；T8 README 动效图自托管与展示创新；T9 字族扩展（款式待用户拍板）
|
|
- 操作：提交 / 推送
|
|
- 成效：Development Record 行为门禁通过
|
|
- 提交：pending local commit
|
|
- 提交区间：36643f5cf087b9f8b46f598516b30c6b80fe9e6b..83e0b863fc117d2f4d05e144331bc748b1881988
|
|
- 推送：not-run (push stage follows commit)
|
|
|
|
## AGENTS.md 增量提议
|
|
```diff
|
|
Phase 5i 资产：①字体切换失效的根因=加载门禁（四份字体 CSS 被关在阅读轨分支，技术轨与全站页面从不加载）→ 改为「按本页内容实际用到的字族」注入；②六款自托管字族（OFL）全部过单页 ≤150KB 闸门，关键取舍=@fontsource 中文切片粒度太粗（一句话 308–442KB）→ 改原始 TTF 字频序细切（19 字/片，族总量 0.5–1.2MB）；③评论失败提示误报的状态机修法（脚本标签在但库未就绪即判失败）；④Artalk init 后加 .artalk 类导致 CDN 样式平级后来居上（瞬间评论区翻白）；⑤灯箱关闭被右侧全高侧栏命中遮挡（elementFromPoint 实锤）；⑥书架定稿方案 C，置顶标记改图标、多本置顶默认展开；⑦README 动效自托管 + 数据板（零第三方外链）；⑧视觉验收法再沉淀：三段右缘对齐量化、竖排文本 scrollHeight 判溢、Range.getClientRects 判折行。
|
|
```
|
|
|
|
## 被拒绝的扩展提议
|
|
- 无
|
|
|
|
## 门禁证据
|
|
- check_spec_package.py exit 0
|
|
|
|
## 遗留事项
|
|
- 无；问题处置见下方结构化区块
|
|
|
|
## 问题处置
|
|
|
|
```json
|
|
{
|
|
"issues": [],
|
|
"version": 1
|
|
}
|
|
```
|