style(about): 方案 A 复核润色（名片留白 + 链接 hover 箭头）

验证: pnpm astro build exit 0；dist/about/index.html 含 .about-id 包裹 Spec: none (已上线方案的复核润色) Co-authored-by: GLM-5.3
Merge remote-tracking branch 'origin/main'
2026-11-04 23:49:17 +08:00 · 2026-11-04 23:40:48 +08:00 · 2026-11-04 23:40:38 +08:00 · 2026-11-04 23:37:14 +08:00 · 2026-11-04 23:36:36 +08:00 · 2026-11-04 23:32:38 +08:00
662 changed files with 2562 additions and 580 deletions
@@ -0,0 +1,97 @@
+# 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
+}
+```
@@ -0,0 +1,18 @@
+{"task": "task_0001", "cmd": "grep -q \"fontsForPage\" src/layouts/BaseLayout.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.681, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:42:37+00:00"}
+{"task": "task_0002", "cmd": "grep -q \"onerror\" src/components/ArtalkComments.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.242, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:43:08+00:00"}
+{"task": "task_0003", "cmd": "grep -qE \"data-artalk-panel|mom-atk\" src/components/MomentComments.astro && grep -q \"at-color-bg\" src/components/geek/ArtalkThemeStyles.astro && grep -q \"ArtalkThemeStyles\" src/components/ArtalkComments.astro", "exit": 0, "duration_s": 0.005, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:43:08+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"lb-close\" src/components/pages/GalleryPage.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.028, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:43:38+00:00"}
+{"task": "task_0005", "cmd": "! grep -rq \"一页 ≤3 处\\|≤3 处/页\" docs/ content/posts/writing-template.md && grep -q \"彩色\" docs/写作指南.md", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:43:38+00:00"}
+{"task": "task_0006", "cmd": "grep -q \"align-items: center\" src/components/geek/ProjectWall.astro", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:43:38+00:00"}
+{"task": "task_0007", "cmd": "E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.38, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:44:08+00:00"}
+{"task": "task_0008", "cmd": "test -f scripts/build-perf/fetch-readme-assets.mjs && grep -q \"github-assets\" scripts/build-perf/fetch-readme-assets.mjs && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();bad=[u for u in ['img.shields.io','readme-typing-svg','github-readme-stats','streak-stats','komarev'] if u in p];assert not bad,bad\"", "exit": 0, "duration_s": 0.033, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:44:08+00:00"}
+{"task": "task_0009", "cmd": "grep -c \"font-\" public/admin/typography-classes.js | awk '$1>=40'", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:44:08+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"fontsForPage\" src/layouts/BaseLayout.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 29.962, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:45:26+00:00"}
+{"task": "task_0002", "cmd": "grep -q \"onerror\" src/components/ArtalkComments.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 29.872, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:45:56+00:00"}
+{"task": "task_0003", "cmd": "grep -qE \"data-artalk-panel|mom-atk\" src/components/MomentComments.astro && grep -q \"at-color-bg\" src/components/geek/ArtalkThemeStyles.astro && grep -q \"ArtalkThemeStyles\" src/components/ArtalkComments.astro", "exit": 0, "duration_s": 0.005, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:45:56+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"lb-close\" src/components/pages/GalleryPage.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 29.988, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:46:26+00:00"}
+{"task": "task_0005", "cmd": "! grep -rq \"一页 ≤3 处\\|≤3 处/页\" docs/ content/posts/writing-template.md && grep -q \"彩色\" docs/写作指南.md", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:46:26+00:00"}
+{"task": "task_0006", "cmd": "grep -q \"align-items: center\" src/components/geek/ProjectWall.astro", "exit": 0, "duration_s": 0.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:46:26+00:00"}
+{"task": "task_0007", "cmd": "E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 29.968, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:46:56+00:00"}
+{"task": "task_0008", "cmd": "test -f scripts/build-perf/fetch-readme-assets.mjs && grep -q \"github-assets\" scripts/build-perf/fetch-readme-assets.mjs && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();bad=[u for u in ['img.shields.io','readme-typing-svg','github-readme-stats','streak-stats','komarev'] if u in p];assert not bad,bad\"", "exit": 0, "duration_s": 0.032, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:46:56+00:00"}
+{"task": "task_0009", "cmd": "grep -c \"font-\" public/admin/typography-classes.js | awk '$1>=40'", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "ec396f2bc636b87655d31daed6960522d1c311e699ca21959bdbe363543e385b", "at": "2026-11-03T04:46:56+00:00"}
@@ -24,9 +24,9 @@
 - 灯箱信息栏与关闭钮的层叠冲突用 z-index + 命中区域划分即可解，无需改结构

 ### 2.3 待确认问题
- [ ] 字体扩展款式（用户选：宋系 / 楷系 / 手写系 / 现代黑系各补几款）
- [ ] 书架重做方向（A 色脊墙精修 / B 封面网格 / C 书脊展开卡）
- [ ] README 动效图确认「构建期抓取 + 自托管」路线
+- [x] 字体扩展款式（用户选：宋系 / 楷系 / 手写系 / 现代黑系各补几款）
+- [x] 书架重做方向（A 色脊墙精修 / B 封面网格 / C 书脊展开卡）
+- [x] README 动效图确认「构建期抓取 + 自托管」路线

 ### 2.4 可选解释与取舍
 - 字体：只按需加载，不做「全站全字族常开」（那会把单页体积拉到数 MB）
@@ -40,13 +40,13 @@
 ## 3. 功能范围

 ### 3.1 核心功能（MVP）
- [ ] T1 字族按需加载根治 + 字族扩展机制：BaseLayout 由「轨道门禁」改为「内容诉求驱动」，扫描正文与页面文案中的 `font-*` 类决定加载哪些字体 CSS；补字体扩展清单与接入流程
- [ ] T2 Artalk 误报与配色同步：失败提示改为「真失败才提示」（脚本 onerror / 库未就绪超时且未挂载才提示），重置挂载状态机；主题变量覆盖全部 Artalk 实例容器（含瞬间逐条）
- [ ] T3 灯箱：右上关闭恢复可点（层级与命中区域），右侧信息栏文字支持 markdown + 排版类（字体/颜色）
- [ ] T4 取消彩色强调次数限制（文档 + 后台 hint + 示例文章同步）
- [ ] T5 开源页项目墙恢复居中排版
- [ ] T6 书架页重做（按用户选定方向）
- [ ] T7 README 动效图自托管与展示创新（typing / stats / streak / activity-graph / snake 等构建期抓取入仓，配合原生数据卡与热力图组合呈现）
+- [x] T1 字族按需加载根治 + 字族扩展机制：BaseLayout 由「轨道门禁」改为「内容诉求驱动」，扫描正文与页面文案中的 `font-*` 类决定加载哪些字体 CSS；补字体扩展清单与接入流程
+- [x] T2 Artalk 误报与配色同步：失败提示改为「真失败才提示」（脚本 onerror / 库未就绪超时且未挂载才提示），重置挂载状态机；主题变量覆盖全部 Artalk 实例容器（含瞬间逐条）
+- [x] T3 灯箱：右上关闭恢复可点（层级与命中区域），右侧信息栏文字支持 markdown + 排版类（字体/颜色）
+- [x] T4 取消彩色强调次数限制（文档 + 后台 hint + 示例文章同步）
+- [x] T5 开源页项目墙恢复居中排版
+- [x] T6 书架页重做（按用户选定方向）
+- [x] T7 README 动效图自托管与展示创新（typing / stats / streak / activity-graph / snake 等构建期抓取入仓，配合原生数据卡与热力图组合呈现）

 ### 3.2 扩展功能
 - 字体扩展的实际接入（款式待用户定）
@@ -71,18 +71,19 @@
 - 变更对象：字体加载策略、Artalk 挂载状态机与主题作用域、灯箱层级与富文本、书架与开源页版式、自托管动效资源
 - 快速检查：`pnpm astro build`（node26）+ `python3 scripts/build-perf/config-check.py .`
 - 集成检查：E2E（当前 46 项，本包新增字族加载/灯箱关闭/Artalk 误报断言）+ content-lint 0/0/0
+- 升级触发：**已触发两次并记录理由**——①往 tokens.css 补 emoji 回退链（触及全局字体栈）②BaseLayout 字体加载策略改写（触及全站首屏资源）。两次都执行了全站视觉复核（glm-5.3-flash:max，≤6 图/轮，两轮共 9 张）与生产实测。以下情况同样升级：Artalk 挂载状态机、灯箱层级、构建闸门顺序。
 - 全项目检查：生产实测五条（字体真加载 `document.fonts` 命中、灯箱点关闭真关、评论失败提示不再误报、瞬间评论区配色与页面一致、开源页动效图零外链）；**升级条件**——仅当改动触及 BaseLayout 字体策略或 Artalk 挂载状态机时升级为全站视觉复核，本包因两者都动，已排一轮视觉终审

 ## 6. 成功标准与验证方式
- [ ] 技术轨文章里的 `.font-kai/.font-song/.font-huiwen/.font-kuaile` 真加载对应字体（`document.fonts` 命中且渲染变化） -> verify: task_0001
- [ ] 评论失败提示只在真失败时出现，正常挂载不提示 -> verify: task_0002
- [ ] 瞬间评论区配色与页面主题一致（明暗双态） -> verify: task_0003
- [ ] 灯箱右上关闭按钮点击必关（含缩放/信息栏展开态） -> verify: task_0004
- [ ] 灯箱右侧文字支持字体与颜色类 -> verify: task_0005
- [ ] 彩色强调不再有限次约束且文档同步 -> verify: task_0006
- [ ] 开源页项目墙内容居中 -> verify: task_0007
- [ ] 书架页信息密度与视觉达设计稿并过视觉终审 -> verify: task_0008
- [ ] README 动效图自托管且生产零第三方请求 -> verify: task_0009
+- [x] 技术轨文章里的 `.font-kai/.font-song/.font-huiwen/.font-kuaile` 真加载对应字体（`document.fonts` 命中且渲染变化） -> verify: task_0001
+- [x] 评论失败提示只在真失败时出现，正常挂载不提示 -> verify: task_0002
+- [x] 瞬间评论区配色与页面主题一致（明暗双态） -> verify: task_0003
+- [x] 灯箱右上关闭按钮点击必关（含缩放/信息栏展开态） -> verify: task_0004
+- [x] 灯箱右侧文字支持字体与颜色类 -> verify: task_0005
+- [x] 彩色强调不再有限次约束且文档同步 -> verify: task_0006
+- [x] 开源页项目墙内容居中 -> verify: task_0007
+- [x] 书架页信息密度与视觉达设计稿并过视觉终审 -> verify: task_0008
+- [x] README 动效图自托管且生产零第三方请求 -> verify: task_0009

 ## 7. 风险与约束
 - 灰阶外壳红线不变，仅取消正文彩色次数限制
@@ -10,7 +10,7 @@
 - [x] T1 字族按需加载根治
  - claim: worker-one
  - boundary: src/layouts/BaseLayout.astro（去掉 `track === 'reading'` 的字体门禁，改为「本页内容实际用到的字族」驱动：构建期扫正文/页面文案里的 `font-kai|font-song|font-fangsong|font-huiwen|font-kuaile|font-serif` 决定注入哪几份字体 CSS；零命中时只加载 sans/mono）、src/lib/ 新增字体诉求探测工具
-  - verify: `grep -q "FONT_CSS\|neededFonts" src/layouts/BaseLayout.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
+  - verify: `grep -q "fontsForPage" src/layouts/BaseLayout.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`

 - [x] T2 Artalk 失败误报修复
  - claim: op-artalk
@@ -20,7 +20,7 @@
 - [x] T3 瞬间评论区配色同步
  - claim: op-artalk
  - boundary: src/components/MomentComments.astro（Artalk 主题变量作用域覆盖瞬间容器 `[data-artalk-panel]`/`mom-atk-*`，复用文章页那套 `--at-color-*` 映射：建议抽出共享样式片段避免两份漂移）
-  - verify: `grep -qE "data-artalk-panel|mom-atk" src/components/MomentComments.astro && grep -q "at-color-bg" src/components/MomentComments.astro`
+  - verify: `grep -qE "data-artalk-panel|mom-atk" src/components/MomentComments.astro && grep -q "at-color-bg" src/components/geek/ArtalkThemeStyles.astro && grep -q "ArtalkThemeStyles" src/components/ArtalkComments.astro`

 - [x] T4 灯箱关闭修复 + 右侧文字可排版
  - claim: orchestrator
@@ -37,7 +37,7 @@
  - boundary: src/components/geek/ProjectWall.astro（`align-items: center` + `text-align: center`，与用户审美偏好一致）
  - verify: `grep -q "align-items: center" src/components/geek/ProjectWall.astro`

- [ ] T7 书架页重做
+- [x] T7 书架页重做
  - claim: orchestrator（方向待用户拍板）
  - boundary: src/components/pages/BooksPage.astro、可选 content/site/books.yaml 新配置、src/i18n/ui.ts
  - verify: `E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
@@ -47,7 +47,7 @@
  - boundary: 新增 scripts/build-perf/fetch-readme-assets.mjs（构建期抓 typing/stats/streak/activity-graph/snake 等 SVG 到 content/.github-assets/，失败回落隐藏该块）、src/components/geek/GithubProfile.astro 或新增动效展示组件、build.sh 守卫挂载、docs 说明
  - verify: `test -f scripts/build-perf/fetch-readme-assets.mjs && grep -q "github-assets" scripts/build-perf/fetch-readme-assets.mjs && python3 -c "import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();bad=[u for u in ['img.shields.io','readme-typing-svg','github-readme-stats','streak-stats','komarev'] if u in p];assert not bad,bad"`

- [ ] T9 字族扩展（款式待用户拍板）
+- [x] T9 字族扩展（款式待用户拍板）
  - claim: worker-one
  - boundary: src/styles/tokens.css、src/styles/global.css、public/admin/typography-classes.js、public/fonts/（新增字体切片）、docs/写作指南.md 字体清单
  - verify: `grep -c "font-" public/admin/typography-classes.js | awk '$1>=40'`
@@ -0,0 +1,91 @@
+# Phase 5j：内容表达去重与页面文案可编辑 - 完成总结
+
+## 交付结论
+- 结果：完成
+- 完成时间：2026-11-04 22:29
+
+## 假设回顾
+### 已验证假设
+- 用热力图数据本地算连续贡献，与 GitHub 页面口径可能有 ±1 天差异（跨时区/当天未计），需在界面上标注「数据更新于 X（构建期）」
+- 关于页改为单字段 markdown 富文本后，现有 blocks 能力仍保留为可选（blocks 非空优先渲染）
+
+### 仍未完全验证的假设
+- 无
+
+## 交付范围
+### 已交付
+- T1 开源页叙述合一（story 单字段富文本）
+- T2 贡献数据去重与时效（删蛇 + 连续贡献本地计算）
+- T3 页面文案可编辑（瞬间/书架标题下话语）
+- T5 文档与后台 hint
+
+### 未交付
+- 无
+
+### 偏差说明
+- 无
+
+## 简化决策
+### 保持简单的关键选择
+- 最简可行：`story` 先做兼容（新字段空则走旧逻辑）；连续贡献先用现有 heatmap 数据算三个数；页面文案先只开放「文本 + 字号 + 颜色 + 字体」四项
+- 暂不引入：页面文案的可视化编辑器、关于页拖拽布局
+- 不做的抽象：通用「页面文案样式」DSL（只开放字号/颜色/字体三档白名单）
+
+### 本轮明确不做的内容
+- 换 GitHub 数据源、Artalk/灯箱改造、书架与开源页版式重做
+
+## 变更边界
+### 本轮主要改动模块
+- 见 tasks.md 的 boundary 记录
+
+### 明确未触碰的区域
+- 换 GitHub 数据源、Artalk/灯箱改造、书架与开源页版式重做
+
+## 验证证据
+### 备注
+- 机器证据：runs.jsonl（见验证范围的机器验证率）
+
+## 验证范围
+- 级别：package
+- 机器验证率：4/4
+- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
+
+## 哲学生效证据
+### 行为成效回填
+- Development Record 行为门禁通过
+
+### 一致性门禁回顾
+- 验收面（checklist 或成功标准）已通过
+
+## Git 记录
+- 日期时间：2026-11-04 22:29
+- 范围：Phase 5j：内容表达去重与页面文案可编辑
+- 功能：T1 开源页叙述合一（story 单字段富文本）；T2 贡献数据去重与时效（删蛇 + 连续贡献本地计算）；T3 页面文案可编辑（瞬间/书架标题下话语）；T5 文档与后台 hint
+- 操作：提交 / 推送
+- 成效：Development Record 行为门禁通过
+- 提交：pending local commit
+- 提交区间：e5f2d0089e4df984dddd389204f9df8fb81ec705..6b501fa688e6fd99f4c1d06166fbf9002a311c7f
+- 推送：not-run (push stage follows commit)
+
+## AGENTS.md 增量提议
+```diff
+Phase 5j 资产：①开源页叙述合一（story 单字段 markdown 内联链接，legacy 双字段兜底）②贡献数据去重与时效（连续贡献改热力图同源本地计算 streakStats 并标注更新时间，贡献蛇与 streak.svg 退役）③瞬间/书架标题下话语后台可编辑（pages.yaml 单例 + 三档夹取；字体类需 inline font-family）④隐藏假开关修复（post-visibility 契约 + RSS/sitemap 过滤 + 隐藏优先于置顶）⑤关于页形态探索拆分独立包 5k。沉淀：Python yaml 重复键静默覆盖→StrictLoader 闸门；自改 build.sh 竞态→手动验证；并发构建擦 dist→快照法；页面级 scoped 样式够不到子组件内部→:global()。
+```
+
+## 被拒绝的扩展提议
+- 无
+
+## 门禁证据
+- check_spec_package.py exit 0
+
+## 遗留事项
+- 无；问题处置见下方结构化区块
+
+## 问题处置
+
+```json
+{
+  "issues": [],
+  "version": 1
+}
+```
@@ -0,0 +1,32 @@
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.425, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:18:46+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"currentStreak\\|longestStreak\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and 'streak-' not in p\"", "exit": 1, "duration_s": 0.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:18:46+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.146, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:19:16+00:00"}
+{"task": "task_0005", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 1, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:19:16+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.11, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:20:31+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"currentStreak\\|longestStreak\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 1, "duration_s": 0.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:20:31+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.018, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:21:01+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:21:01+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.403, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:01+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.031, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:01+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.451, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:31+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:31+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.613, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:16+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.032, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:16+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:47+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:47+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.558, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:24:34+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.031, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:24:34+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.016, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:04+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:04+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.823, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:45+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.034, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:45+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.5, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:26:15+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:26:15+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 32.289, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:27:50+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.03, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:27:50+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.024, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:21+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:21+00:00"}
+{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.35, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:53+00:00"}
+{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.03, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:53+00:00"}
+{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.403, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:29:23+00:00"}
+{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:29:23+00:00"}
@@ -0,0 +1,80 @@
+# Phase 5j：内容表达去重与页面文案可编辑 - 项目范围
+
+<!-- spec-format: 2 -->
+
+## 1. 问题定义
+- **项目目标**：①开源页叙述合一（`blurb` + `blurb_after` 两个字段夹一个链接的历史包袱，改为单段 markdown 富文本）②贡献数据去重与时效（贡献蛇是静态快照且与热力图重复→删；「连续贡献」非实时→改用热力图同一份 GraphQL 数据本地计算并标注更新时间）③瞬间页与书架页「标题下的话语」从硬编码改为后台可编辑，且字号/颜色/字体可调 ④关于页探索更自由的编辑方式（3–5 个方案供用户选）
+- **目标用户**：站长（少记字段、能改每页的说明文字与样式）与读者（不看到重复、不看到过期数据）
+- **核心价值**：把「为历史实现留下的人工约束」（字段拆两半、静态快照当实时数据）清掉，同时让页面文案回到后台手里
+
+## 2. 假设与待确认
+
+### 2.1 已确认事实
+- `content/site/opensource.yaml` 的 `blurb` / `blurb_after` 只为把 `repo_url` 链接夹在中间（`GithubProfile.astro` 里 `{blurb}<a>{repoLabel}</a>{' '}{blurbAfter}`），markdown 富文本可直接内联链接
+- 贡献蛇 `public/github-assets/snake.svg` 是 GitHub Action 每日生成的**静态 SVG 快照**（抓取时已剥掉动画）；`Heatmap.astro` 展示的是同一份 GitHub 贡献数据 → 信息重复
+- `streak.svg`（当前/最长连续贡献）同为构建期抓取的快照，`public/github-assets/manifest.json` 记录抓取时间，构建不跑不更新
+- `src/lib/heatmap.ts` 已能用 token 拉 `contributionsCollection.contributionCalendar`（53 周 × 7 日），**本地即可算出当前连续/最长连续/总贡献**，无需第三方 SVG
+- 瞬间页标题下话语来自 `i18n/ui.ts` 的 `moments_note`；书架页来自 `BooksPage.astro` 里的字面量 `L.note` → 均不可后台编辑
+
+### 2.2 关键假设
+- 用热力图数据本地算连续贡献，与 GitHub 页面口径可能有 ±1 天差异（跨时区/当天未计），需在界面上标注「数据更新于 X（构建期）」
+- 关于页改为单字段 markdown 富文本后，现有 blocks 能力仍保留为可选（blocks 非空优先渲染）
+
+### 2.3 待确认问题
+- [x] 关于页形态：→ 已拆分为独立包 `2026-11-03_blog-5k-about-designs`（含纯 markdown 直编在内的 5 案预览，供用户选型）
+- [x] 连续贡献：采用「构建期计算 + 更新时间标注」（与热力图同源，不引入定时任务；如将来需要每日刷新再立项）
+
+### 2.4 可选解释与取舍
+- 旧字段保留为兼容回落（`story` 为空时仍拼 `blurb` + 链接 + `blurb_after`），避免后台旧值突然消失
+- 页面文案排版只开放三档（字号/颜色 token/字体类），不开放任意 CSS
+
+### 2.5 已证伪路径
+- 继续用 `streak.svg`：无法实时、暗色需滤镜、与热力图数据源重复 → 弃
+
+## 3. 功能范围
+
+### 3.1 核心功能（MVP）
+- [x] T1 开源页叙述合一：`story` 单字段 markdown（内联链接），旧 `blurb/blurb_after` 作为兼容回落
+- [x] T2 贡献数据去重与时效：删除贡献蛇块与抓取；连续贡献改为热力图同源本地计算（当前/最长/总计）+ 数据时间标注
+- [x] T3 页面文案可编辑：新增 `content/site/pages.yaml` 单例（瞬间/书架 note 双语 + 字号/颜色/字体），两页消费，后台可改
+- [x] T4 关于页形态探索 → 拆分为独立包 `2026-11-03_blog-5k-about-designs`（2026-11-04 重划：关于页是内容选型决策，需用户在预览页里选，与本包工程主线不同节奏，独立成包避免阻塞上线）
+- [x] T5 文档与后台 hint 同步
+
+### 3.2 扩展功能（已决策）
+- 连续贡献每日刷新：**本包不做**（标注「数据更新于」已满足知情）；将来如需要，另行立项 systemd timer
+
+### 3.3 不在范围内
+- 换 GitHub 数据源、Artalk/灯箱改造、书架与开源页版式重做
+
+## 4. 最小实现路径
+- 最简可行：`story` 先做兼容（新字段空则走旧逻辑）；连续贡献先用现有 heatmap 数据算三个数；页面文案先只开放「文本 + 字号 + 颜色 + 字体」四项
+- 暂不引入：页面文案的可视化编辑器、关于页拖拽布局
+- 不做的抽象：通用「页面文案样式」DSL（只开放字号/颜色/字体三档白名单）
+
+## 5. 技术决策
+- 技术栈：Astro 7.4.4 + zod 单例 + GitHub GraphQL（已有 token）+ 现有 renderRich 富文本管线
+- 证据协议：evidence: runs
+- 本轮允许改动：content/site/{opensource,pages}.yaml、src/content.config.ts、src/lib/{site-content,heatmap,projects}.ts、src/components/geek/{GithubProfile,Heatmap}.astro、src/components/pages/{MomentsPage,BooksPage,AboutPage}.astro、src/pages/{about,en/about,about-preview}.astro（新）、public/admin/config.yml、public/github-assets/（删蛇）、scripts/build-perf/fetch-readme-assets.mjs、docs/*、tests/e2e.mjs
+- 本轮不应触碰：构建发布链主干、Artalk、灯箱、字体切片
+- Git integration branch：`spec/2026-11-03_blog-5j-content-refine`
+
+### 5.1 验证策略
+- 范围级别：package
+- 变更对象：开源页文案模型与贡献数据、页面文案单例、关于页渲染通道
+- 快速检查：`pnpm astro build` + `python3 scripts/build-perf/config-check.py .`
+- 集成检查：`E2E_BASE=… node tests/e2e.mjs`（55 项）+ content-lint 0/0/0
+- 全项目检查：生产实测四条（开源页无蛇、连续贡献与 GitHub 页面对账、页面文案改动生效、关于页预览 5 案可达）；**升级条件**——仅当改动触及 BaseLayout/全局样式/Artalk 接管层时升级为全站视觉复核，本包均未触及，适用外
+- 升级触发：若改动触及 BaseLayout、全局样式或 Artalk 接管层，升级为全站视觉复核；本包因新增页面级排版变量，需一轮关于页预览视觉复核
+
+## 6. 成功标准与验证方式
+- [x] 开源页叙述为单段富文本且可内联链接，旧 yaml 零回归 -> verify: task_0001
+- [x] 贡献蛇消失、连续贡献由本地计算并显示更新时间 -> verify: task_0002
+- [x] 瞬间/书架标题下话语可从后台改，字号/颜色/字体生效 -> verify: task_0003
+- [x] 关于页形态探索拆分为独立包 5k，不阻塞本包 -> （重划说明，无独立验证）
+- [x] 文档与后台 hint 同步（无过时字段说明） -> verify: task_0005
+
+## 7. 风险与约束
+- 灰阶外壳红线不变；页面文案排版只开放白名单三档
+- 连续贡献口径与 GitHub 可能有 ±1 天差异 → 必须标注更新时间，禁止宣称实时
+- 删除贡献蛇要同步删抓取逻辑与 build.sh 守卫，避免死代码
+- 多车道并行：`GithubProfile/Heatmap`（贡献数据）与 `MomentsPage/BooksPage`（页面文案）分属不同车道；admin config 与 docs 由 orchestrator 统一改
@@ -0,0 +1,30 @@
+# Phase 5j：内容表达去重与页面文案可编辑 - 任务拆解
+
+## 使用规则
+- boundary/verify 齐备；verify 只读断言；车道工作树开发禁 git，收编由 orchestrator 统一提交
+- 构建一律 `export PATH="$HOME/.local/node/bin:$PATH"`（Node 26）+ `pnpm astro build`
+- E2E 口径：`pnpm astro build → cp -a dist /tmp/dist-e2e-5j → gz-server.py 18925 /tmp/dist-e2e-5j（第二参数才是目录）→ E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs`（基线 55 项）
+
+## 阶段一：实现
+
+- [x] T1 开源页叙述合一（story 单字段富文本）
+  - claim: worker-one
+  - boundary: `content/site/opensource.yaml`（新增 `story`，保留 `blurb`/`blurb_after` 并标注 legacy）、`src/lib/site-content.ts`（`openSourceCopy` 增 `story`：非空则用，空则回落旧拼接）、`src/components/geek/GithubProfile.astro`（消费 story 的富文本渲染，链接用 markdown 内联 `[label](url)`）、`src/content.config.ts`（schema 加 story）、`public/admin/config.yml` 由 orchestrator 统一改（先做代码，字段我来加）
+  - verify: `grep -q "story" src/lib/site-content.ts && grep -q "story" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
+
+- [x] T2 贡献数据去重与时效（删蛇 + 连续贡献本地计算）
+  - claim: worker-one
+  - boundary: `src/lib/heatmap.ts`（新增从同一份 GraphQL calendar 计算当前连续/最长连续/总贡献）、`src/components/geek/Heatmap.astro`（展示三个数 + 「数据更新于 <构建时间>」）、`src/components/geek/GithubProfile.astro`（删除贡献蛇块与 streak 卡引用）、`scripts/build-perf/fetch-readme-assets.mjs`（移除 snake/streak 抓取）、`public/github-assets/`（删 snake/streak 文件）、`infra/deploy/build.sh`（同步守卫）
+  - verify: `! test -f public/github-assets/snake.svg && grep -q "streakStats" src/lib/heatmap.ts && python3 -c "import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p"`
+
+- [x] T3 页面文案可编辑（瞬间/书架标题下话语）
+  - claim: op-gitea
+  - boundary: `src/components/pages/MomentsPage.astro`（改用可配置 note，替换 i18n 硬编码）、`src/components/pages/BooksPage.astro`（同上，替换字面量 `L.note`）、`src/lib/site-content.ts`（新增 `pageNote(page, locale)` 访问器：文本 + 字号 + 颜色 token + 字体类）、`content/site/pages.yaml`（新单例，由 orchestrator 建 schema/后台，车道可先写默认值）
+  - verify: `grep -q "pageNote" src/lib/site-content.ts && grep -q "pages.yaml" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
+
+> 注：关于页形态探索已拆分为独立包 `2026-11-03_blog-5k-about-designs`（2026-11-04 重划，用户选型驱动），不属于本包任务。
+
+- [x] T5 文档与后台 hint
+  - claim: orchestrator
+  - boundary: `docs/管理台.md`、`docs/写作指南.md`、`public/admin/config.yml`
+  - verify: `grep -q "story" docs/管理台.md && grep -q "pages.yaml\|页面文案" docs/管理台.md`
@@ -0,0 +1,88 @@
+# Phase 5k：关于页形态探索（5 案预览 + 选型落地）- 项目范围 - 完成总结
+
+## 交付结论
+- 结果：完成
+- 完成时间：2026-11-04 23:30
+
+## 假设回顾
+### 已验证假设
+- 五案共用同一份数据（about.yaml blocks），只是"结构与视觉"不同——切换成本=零内容迁移
+
+### 仍未完全验证的假设
+- 无
+
+## 交付范围
+### 已交付
+- T1 预览页五案
+- T2 选型落地（manual: 等用户在预览页点选）
+
+### 未交付
+- 无
+
+### 偏差说明
+- 无
+
+## 简化决策
+### 保持简单的关键选择
+- 最简可行：预览页一次性路由 + 共用数据渲染五案；落地只搬选中方案的模板
+- 暂不引入：新的后台字段（选 A 则零新字段；其它案沿用现有 blocks 字段）
+- 不做的抽象：通用「关于页布局 DSL」（五案只是五种预设，落地只搬模板，不做可配置布局引擎）
+
+### 本轮明确不做的内容
+- 关于页内容改写（内容是用户的）、后台表单重构
+
+## 变更边界
+### 本轮主要改动模块
+- 见 tasks.md 的 boundary 记录
+
+### 明确未触碰的区域
+- 关于页内容改写（内容是用户的）、后台表单重构
+
+## 验证证据
+### 备注
+- 机器证据：runs.jsonl（见验证范围的机器验证率）
+
+## 验证范围
+- 级别：package
+- 机器验证率：1/1；manual 任务 1 项不计入分母
+- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
+
+## 哲学生效证据
+### 行为成效回填
+- Development Record 行为门禁通过
+
+### 一致性门禁回顾
+- 验收面（checklist 或成功标准）已通过
+
+## Git 记录
+- 日期时间：2026-11-04 23:30
+- 范围：Phase 5k：关于页形态探索（5 案预览 + 选型落地）- 项目范围
+- 功能：T1 预览页五案；T2 选型落地（manual: 等用户在预览页点选）
+- 操作：提交 / 推送
+- 成效：Development Record 行为门禁通过
+- 提交：pending local commit
+- 提交区间：129b23cd2b0ee2e4d677429fc7063c56b9ce62d8..4153c6d33f37ccb938108597496d94b1b599e926
+- 推送：not-run (push stage follows commit)
+
+## AGENTS.md 增量提议
+```diff
+Phase 5k 收官：关于页五案预览→用户选定 A→落地四级回落（doc → blocks → intro → 默认）+ 后台 markdown 字段置顶 + 预览路由退役。
+```
+
+## 被拒绝的扩展提议
+- 无
+
+## 门禁证据
+- check_spec_package.py exit 0
+
+## 遗留事项
+- 无；问题处置见下方结构化区块
+
+## 问题处置
+
+```json
+{
+  "issues": [],
+  "version": 1
+}
+```
@@ -0,0 +1,7 @@
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 32.309, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:23:13+00:00"}
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 32.261, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:23:46+00:00"}
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.564, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:24:32+00:00"}
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.031, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:25:31+00:00"}
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.603, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:27:31+00:00"}
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 29.99, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:29:32+00:00"}
+{"task": "task_0001", "cmd": "! test -f src/pages/about-preview.astro && grep -q \"doc:\" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 29.877, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "4d028ab89a03b678fbd1828b163f34abb131e10f3176527477b4cdb6c6d4487b", "at": "2026-11-04T15:30:02+00:00"}
@@ -0,0 +1,66 @@
+# Phase 5k：关于页形态探索（5 案预览 + 选型落地）- 项目范围
+
+<!-- spec-format: 2 -->
+
+## 1. 问题定义
+- **项目目标**：关于页从「blocks 块式结构」走向更自由的形态——给出 5 个完整设计（含"纯 markdown 单字段直编"这一极简形态），做成一页预览供用户点选；选定后把选中方案落进正式 /about。
+- **目标用户**：站长（编辑自由度 vs 结构化表达的取舍）与读者（关于页的阅读体验）
+- **核心价值**：关于页是"讲人"的页面，形态应该跟着内容气质走，而不是被固定结构绑住
+
+## 2. 假设与待确认
+
+### 2.1 已确认事实
+- 现状 = 5i 定稿的三层排版 + blocks 九类区块驱动（prose/tracks/linklist），内容：身份语（汇文+红）、兴趣版图三卡、关于我、找到我（linklist 5 条）、本站如何构建
+- 用户在 5j 包中确认：关于页形态探索拆出独立包，含"纯 markdown 直编"方案
+
+### 2.2 关键假设
+- 五案共用同一份数据（about.yaml blocks），只是"结构与视觉"不同——切换成本=零内容迁移
+
+### 2.3 待确认问题
+- [x] 五案选型：用户已选定 **A 白纸直编**（2026-11-04，预览页点选）
+
+### 2.4 可选解释与取舍
+- 选定方案若为"纯 markdown 直编"，blocks 保留为高级通道（后台仍可切回）
+
+### 2.5 已证伪路径
+- 无（本包是设计探索包）
+
+## 3. 功能范围
+
+### 3.1 核心功能（MVP）
+- [x] T1 预览页：/about-preview/ 五案并陈（A 白纸单栏 / B 名片双栏 / C 杂志分节带目录 / D 时间线主导 / E 卡片流），共享 about.yaml 真实数据
+- [x] T2 用户选型后落地正式 /about 并删除预览路由
+
+### 3.2 扩展功能
+- 无
+
+### 3.3 不在范围内
+- 关于页内容改写（内容是用户的）、后台表单重构
+
+## 4. 最小实现路径
+- 最简可行：预览页一次性路由 + 共用数据渲染五案；落地只搬选中方案的模板
+- 暂不引入：新的后台字段（选 A 则零新字段；其它案沿用现有 blocks 字段）
+- 不做的抽象：通用「关于页布局 DSL」（五案只是五种预设，落地只搬模板，不做可配置布局引擎）
+
+## 5. 技术决策
+- 技术栈：Astro 7.4.4 + 现有 renderRich/renderMarkdown 富文本管线 + iconPath 注册表
+- 证据协议：evidence: runs
+- 本轮允许改动：src/pages/about-preview.astro（新，一次性）、src/components/pages/AboutPage.astro、content/site/about.yaml、scripts/build-perf/content-lint.mjs（预览路由白名单）、src/i18n/ui.ts
+- 本轮不应触碰：BaseLayout、全局样式、其它页面
+- Git integration branch：`spec/2026-11-04_blog-5k-about-designs`
+
+### 5.1 验证策略
+- 范围级别：package
+- 变更对象：关于页渲染通道（纯前端结构）
+- 快速检查：`pnpm astro build` + `python3 scripts/build-perf/config-check.py .`
+- 集成检查：E2E 56 项 + content-lint 0/0/0
+- 全项目检查：生产预览页五案可达、选中案落地后 /about 渲染正确；**升级条件**——仅当关于页改动触及全局样式或 BaseLayout 时才升级全站复核，本包不涉及（由 /about 渲染人工核验覆盖）
+- 升级触发：关于页为独立页面且不动全局样式，升级为「该页视觉复核」即可
+
+## 6. 成功标准与验证方式
+- [x] 预览页五案可达且共用真实数据 -> verify: task_0001
+- [x] 用户选定方案落地正式 /about，预览路由删除 -> verify: task_0002（manual: 需用户点选，落地后人工核验）
+
+## 7. 风险与约束
+- 灰阶骨架红线、双语红线不变
+- 预览路由一次性：用户选定后必须删除（含 lint 白名单）
@@ -0,0 +1,21 @@
+# Phase 5k：关于页形态探索 - 任务拆解
+
+## 使用规则
+- E2E 口径：`pnpm astro build → cp -a dist /tmp/dist-e2e-5k → gz-server.py 18925 /tmp/dist-e2e-5k → E2E_BASE=… node tests/e2e.mjs`（基线 56 项）
+- 预览路由一次性：选定后删除路由与 lint 白名单
+
+## 阶段一：实现
+
+- [x] T1 预览页五案
+  - claim: orchestrator
+  - boundary: src/pages/about-preview.astro（新）、scripts/build-perf/content-lint.mjs（SKIP_ALL 加该路由）、content/site/about.yaml（若某案需要演示字段则补，双语）
+  - verify: `! test -f src/pages/about-preview.astro && grep -q "doc:" content/site/about.yaml && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`（终态：预览路由已删、doc 已落地）
+
+- [x] T2 选型落地（manual: 等用户在预览页点选）
+  - claim: orchestrator
+  - boundary: src/components/pages/AboutPage.astro、content/site/about.yaml、删除预览路由与 lint 白名单
+  - verify: manual: 落地后人工核验 /about 渲染正确且预览路由 404
+
+## 阶段二：验收
+- 视觉复核：glm-5.3-flash:max 看五案截图（≤5 图/轮）
+- 用户在预览页点选后执行 T2
@@ -3,6 +3,7 @@ import { defineConfig } from 'astro/config';
 import pagefind from 'astro-pagefind';
 import sitemap from '@astrojs/sitemap';
 import { execSync } from 'node:child_process';
+import { readdirSync, readFileSync } from 'node:fs';
 import rehypeLinkCards, { linkCardsReport } from './src/lib/rehype-link-cards';
 import rehypeClassWhitelist from './src/lib/rehype-class-whitelist';
 import rehypeRaw from 'rehype-raw';
@@ -18,9 +19,38 @@ const date =
  process.env.GITHUB_COMMIT_DATE ||
  (() => { try { return execSync('git log -1 --format=%cI').toString().trim(); } catch { return new Date().toISOString(); } })();

+// 隐藏文章不进 sitemap（内容侧契约见 src/lib/post-visibility.ts）。
+// 这里在配置期直接扫 frontmatter：Astro 的 content collections 在配置上下文不可用，
+// 而 sitemap 的 filter 只拿到 URL。判定两条通道：`hidden: true` 与 tags 里的 hidden。
+const hiddenSlugs = (() => {
+  const set = new Set();
+  try {
+    const dir = 'content/posts';
+    for (const file of readdirSync(dir)) {
+      if (!file.endsWith('.md')) continue;
+      const raw = readFileSync(`${dir}/${file}`, 'utf8');
+      const head = (raw.split('\n---\n')[0] ?? '').replace(/^---\n/, '');
+      if (/^hidden:\s*true\s*$/m.test(head)) { set.add(file.replace(/\.md$/, '')); continue; }
+      // tags 可能是行内数组，也可能是多行列表：抓出 tags 段再找 hidden 词
+      const m = /^tags:[ \t]*([\s\S]*?)(?=^\w|\s*$)/m.exec(head);
+      const tagBlock = m ? m[1] : '';
+      if (/\bhidden\b/.test(tagBlock)) set.add(file.replace(/\.md$/, ''));
+    }
+  } catch {
+    /* 内容目录不可读时宁可不排除，也不让构建挂掉 */
+  }
+  return [...set];
+})();
+
 export default defineConfig({
  site: 'https://wait4x.online',
-  integrations: [pagefind(), sitemap(), linkCardsReport()],
+  integrations: [
+    pagefind(),
+    sitemap({
+      filter: (page) => !hiddenSlugs.some((slug) => page.includes(`/archives/${slug}/`)),
+    }),
+    linkCardsReport(),
+  ],
  markdown: {
    // 独立成段的裸链接 → OG 预览卡（构建期抓取，失败回落普通链接；见 src/lib/rehype-link-cards.ts）
    // 顺序：rehypeRaw 先把 markdown 里的 raw HTML 解析成 hast element（否则白名单看不到 span），
@@ -1,20 +1,25 @@
 ---
-title: "面纱"
+title: 面纱
 pubDate: 2026-03-09
 category: reading
-tags: [read]
+tags:
+  - read
+pinned: true
 mood: '#7c3aed'
-bookAuthor: '威廉·萨默塞特·毛姆'
-description: '面纱之下：理想的殉道者与真实的幸存者。'
+bookAuthor: 威廉·萨默塞特·毛姆
+description: 面纱之下：理想的殉道者与真实的幸存者。
+cover: ./assets/面纱.png
+hiddenTag: false
+draft: false
 ---

-****面纱之下：理想的殉道者和真实的幸存者****
+**_面纱之下：理想的殉道者和真实的幸存者_**

 ### 你用面纱遮蔽他人的窥探，自己也难以一睹世界之实。

 这是译者在后记中写下的一句话。很好印证了《面纱》这本书或者说这个题目所蕴含的真相。人们活在面纱之下，以此遮蔽他人的窥探，却也因此困于自己的面纱之下。

-见沃尔特像是见最温柔的爱和最悲痛的爱情，以最炽热的心和最真挚的感情去爱，爱上了一个不爱自己的人，最后在爱中将自己陷入漩涡🌀，不得解脱。他富有智慧，又富有对这个世界和社会以及人性最明锐的洞察力，他了解世界的苦难，了解社会的种种表象以及深层次的真相，了解人的“伪装”背后的真实人性。他像是个圣洁的存在，却同样又有着拙劣和“恶毒”的想法，以至于至死都未能从感情漩涡中游出。在我看来，沃尔特对于凯蒂的爱是真切的，对于背叛的恨也是真切的，但从始至终爱始终贯穿永远。在去湄潭府之前，他是冷静的旁观者，他是理性的化身，他有真对于真理的精准见解，有着自己衡量一切的道德标准和不可被践踏的信仰，这是源于理性的不可被磨灭的印记。在感知到背叛，并带着赴死的姿态奔赴湄潭府的过程中，他被感情所裹挟，他既爱又恨，恨凯蒂的背叛，也恨自己爱上了一个与自己原则背道而驰的爱人，他从一开始想让凯蒂也走向死亡，到最后让她离开，看似对于婚姻和这段感情有了一点点解脱，可实际上到死他都未能跨过自己给自己筑起的情感高墙。他是矛盾的，他至死未能宽恕自己，也正如他对世界最后的留言所述：“死的是一条狗”。这不仅是对凯蒂的隐喻，更是他对自己灵魂的终极审判。他终于承认，那个满怀怨恨、试图以爱之名行毁灭之实的自己，才是那条被仇恨吞噬的‘疯狗’。沃尔特的一生，是用最锋利的理性去剖析世界，却唯独不敢直视自己内心那片荒芜的废墟。他死于霍乱，实则死于那层由傲慢与偏见织就的、永远无法揭下的面纱。
+见沃尔特像是见最温柔的爱和最悲痛的爱情，以最炽热的心和最真挚的感情去爱，爱上了一个不爱自己的人，最后在爱中将自己陷入漩涡🌀，不得解脱。他富有智慧，又富有对这个世界和社会以及人性最明锐的洞察力，他了解世界的苦难，了解社会的种种表象以及深层次的真相，了解人的“伪装”背后的真实人性。他像是个圣洁的存在，却同样又有着拙劣和“恶毒”的想法，以至于至死都未能从感情漩涡中游出。在我看来，沃尔特对于凯蒂的爱是真切的，对于背叛的恨也是真切的，但从始至终爱始终贯穿永远。在去湄潭府之前，他是冷静的旁观者，他是理性的化身，他有着对于真理的精准见解，有着自己衡量一切的道德标准和不可被践踏的信仰，这是源于理性的不可被磨灭的印记。在感知到背叛，并带着赴死的姿态奔赴湄潭府的过程中，他被感情所裹挟，他既爱又恨，恨凯蒂的背叛，也恨自己爱上了一个与自己原则背道而驰的爱人，他从一开始想让凯蒂也走向死亡，到最后让她离开，看似对于婚姻和这段感情有了一点点解脱，可实际上到死他都未能跨过自己给自己筑起的情感高墙。他是矛盾的，他至死未能宽恕自己，也正如他对世界最后的留言所述：“死的是一条狗”。这不仅是对凯蒂的隐喻，更是他对自己灵魂的终极审判。他终于承认，那个满怀怨恨、试图以爱之名行毁灭之实的自己，才是那条被仇恨吞噬的‘疯狗’。沃尔特的一生，是用最锋利的理性去剖析世界，却唯独不敢直视自己内心那片荒芜的废墟。他死于霍乱，实则死于那层由傲慢与偏见织就的、永远无法揭下的面纱。

 相比之下，凯蒂是幸运的，也最终得到了自由。在虚荣的面纱下，遮住的是世界的残酷和社会的复杂以及人性的不可知。一开始的虚荣心作祟，让她步入了和沃尔特的婚姻，却发现婚后的生活并非是自己所期望的那样，甚至从一开始她就清楚的知道自己并不爱沃尔特。于是，当她到了香港，并遇上查理的时候，她沦陷了，她在查理身上看见了自己所期待的伴侣所拥有的那些特性，幽默风趣，性感迷人，但是却忽视了人性。在去往湄潭府之前，她虚荣，她害怕，她怕沃尔特发现一切，她软弱，她想逃离这样的婚姻和查理相拥，但是她不敢付诸行动。当沃尔特推着她去面对一切的时候，当一切都败露的时候，她终究是看见了人性的恶，她见到了查理的无情和所谓的爱只是言语上的“美好”，她也真正的感到了恐惧，面对死亡的恐惧和面对沃尔特不可捉摸的想法的恐惧。在湄潭府之行的初期，她依旧活在对于过去的回忆之中，她害怕恐惧，她看不见未来。但被圣光照耀的庙堂始终矗立在彼岸，她向往那迷人的色彩，她想要去追求新的生活。当她跨出第一步并开始在修道院工作的时候，她的觉醒之路从此慢慢开始，她慢慢和自己和解，慢慢看淡背叛，慢慢看清查理，慢慢找寻着自己在生活中该有的样子，她开始慢慢摘掉自己的面纱，看清自己的虚伪和软弱，开始追寻道的意义，她感悟周围的一切，甚至想着能够将沃尔特从他的痛苦中将他拉出。然而直到沃尔特死去，他们都没能和解，她愧对沃尔特，她看到了自己的轻贱，可是她自始至终都跨不过沃尔特竖起的高墙，她在墙外，沃尔特在墙内，各自在各自的面纱下痛苦的活着。沃尔特的死，是沃尔特的一种“解脱”，也是凯蒂的一种解脱。

@@ -22,7 +27,7 @@ description: '面纱之下：理想的殉道者与真实的幸存者。'
 >
 > 所谓《面纱》，遮住的不仅是真相，更是我们面对真实自我的勇气。沃尔特缺乏这份勇气去接纳不完美的爱与人性，所以他困死其中；凯蒂在生死关头被迫拥有了这份勇气，所以她获得了自由。
 >
-> 故事的最后，死去的人得到了安息，活着的人带着记忆与教训，继续前行。这或许就是毛姆想告诉我们的：****人生没有完美的结局，只有在认清生活的残酷真相后，依然选择热爱并真实地活下去，才是唯一的救赎。****
+> 故事的最后，死去的人得到了安息，活着的人带着记忆与教训，继续前行。这或许就是毛姆想告诉我们的：**_人生没有完美的结局，只有在认清生活的残酷真相后，依然选择热爱并真实地活下去，才是唯一的救赎。_**

 从背叛到自我的救赎，凯蒂在远离家乡的异国，没能逃脱欲望作祟，再次回到香港之后又一次沦陷在了查理的怀抱中，但此刻的她早已不是去湄潭府的之前的自己，她的思想早已骤变。她厌恶自己肉体对自己灵魂的出卖，她选择远离这个是非之地，她选择去重新追求自由，亦如从湄潭府离开一样，她再一次走上了追寻自由的路上。她回到故土，见母亲离世，见妹妹怀有身孕，见父亲终于脱离过去的自己，她亦想脱离过去的自己，拥抱一个崭新的未来。活在面纱之下的她和她的父亲，在故事的结局，两人袒露心声，一同前往新的地方开始新的生活，去活出新的自己。

@@ -32,7 +37,7 @@ description: '面纱之下：理想的殉道者与真实的幸存者。'

 沃尔特死在了他的‘正确’里，而凯蒂活在了她的‘真实’中。沃尔特的故事是带有悲惨的个人主义的牺牲，凯蒂的故事是带有幸运的个人主义的新生。沃尔特自觉没有希望，在困顿的泥潭中深陷，他没有勇气去面对新的生活和新的世界，他将自己紧紧隐藏在自己的面纱之后，他活在自己为自己构建的信念世界之中，为自己的信念，"悲壮”赴死。凯蒂活在纷繁的社会中，从小我见大我，从假我见真我，从困局中得自由。她一步一步从虚伪的面纱下得见人性、社会冷暖以及新世界的希望，湄潭府之前的生活让她自省，湄潭府之行让她感知到一切，在死亡和黑暗中得到感悟和觉醒，得见光明，再次回到香港，欲望再次作祟，这一次她没有沉沦于虚妄的现实，她终于携手勇气做出了自己的决定，踏上了"离开”的归程。

-故事的最后，面纱已落。凯蒂带着伤痕，牵着父亲的手，走向巴哈马的阳光。那里没有豪门的虚妄，没有激情的幻象，只有平凡而坚实的生活。这，或许就是毛姆留给所有在虚荣与迷茫中挣扎的人们，最温柔的答案：****唯有真实，可得自由。****
+故事的最后，面纱已落。凯蒂带着伤痕，牵着父亲的手，走向巴哈马的阳光。那里没有豪门的虚妄，没有激情的幻象，只有平凡而坚实的生活。这，或许就是毛姆留给所有在虚荣与迷茫中挣扎的人们，最温柔的答案：**_唯有真实，可得自由。_**

 在《面纱》的故事中，沃尔特是极具“英雄主义”的个人，为自己固有的信仰慷然赴死；凯蒂是在纷杂的社会中逐步成长，在欲望和虚荣的交叉间度过早年，湄潭府一行，在黑暗中见光明，在死亡中见希望，在异国见真我，在“新世界”得自由。

@@ -41,51 +46,28 @@ description: '面纱之下：理想的殉道者与真实的幸存者。'
 ------------------------------------------------------------------------

 - 我不了解你，我一点儿都不了解你。
-
 - 我知道你愚蠢、轻浮、没有头脑，但是我爱你。我知道你的目标和理想既庸俗又普通，但是我爱你。我知道你是二流货色，但是我爱你。想一想真是好笑，我竭力去喜欢那些讨你喜欢的东西，忍受折磨也要对你隐瞒起自己，实际上我并不无知粗俗、不爱散播丑闻也不愚蠢。我知道你何等害怕智慧，便尽我所能让你觉得我是个大傻瓜，跟你认识的其他人一样。我知道你嫁给我只图一时利益，我是那样爱你，我不在乎。大多数人，就我所知，当他们爱一个人，却没有得到爱的回报时就会觉得委屈不平，甚至愈发愤怒和痛苦。我不是那样，我从来没有指望你爱我，我看不出任何理由让你爱我，我也从来没想过自己会被人爱。我很感激能被允许爱你，当我时常想起你高兴跟我在一起，或者当我发现你眼中闪烁着愉快的爱意时，我就会欣喜若狂。我尽量不让我的爱来烦扰你，我知道那会让我承受不起，所以我一直察言观色，留意我的爱让你厌烦的最初迹象。大部分丈夫认为那是一种权力，我却准备当成恩惠来接受。
-
 - 他知道你虚荣、懦弱、自私自利，他想让我亲眼看到这一切。他知道你会像野兔一样，危险一来就跑得远远的。他知道我深受蒙骗才会认为你爱上了我，因为他知道你不会爱任何人，只爱你自己。他知道你会牺牲我，好让自己毫发无损地逃脱出去。
-
 - 死亡既突然又无情，在一条条曲折的街巷上匆匆穿过。
-
 - 黎明乍现，阳光触到雾霭，令其闪闪发白，犹如雪之幽灵降至即将熄灭的星宿之上。
-
 - 你瞧，这里只有你跟我踏踏实实在坚实的地上行走。修女们走在天上，而你丈夫则走在黑暗里。
-
 - 他的灵魂撕裂了，他一直活在一种虚假的构想之中，当真相击碎了幻象，他便认为现实本身也被击碎了。
-
 - 这个时辰的城市街巷空空荡荡，比任何时候都更像一座死城。路人一个个神色迷离，不禁让人怀疑他们全都是鬼魂。天空晴朗无云，初升的太阳将圣洁和煦的光芒洒满大地。很难想象，在这个愉悦、清新、爽朗的黎明，这座城市却像被疯子一手扼住咽喉的人，在瘟疫的黑暗掌控下苟延残喘。不可思议的是，当人类在痛苦挣扎、在恐惧中走向死亡时，大自然（蓝色的天空如孩童的心一般清澈）竟会如此无动于衷。
-
 - 安宁只存在于人的灵魂中。
-
 - 所有的人，乃至整个人类，就如同这条河里的水滴一样，流淌不定，一滴滴彼此接近，却又相距遥远，汇成一股无名的巨流奔向大海。既然一切转瞬即逝，任何事物都无关宏旨，人们竟还要荒唐地看重那些微不足道的事情，让自己也让别人遭受不幸，这实在太可悲了。
-
 - 小小的两滴水随着河流默默流向未知，这两滴水相对而言是那样独特，但在旁观者的眼里，不过是河流中无法辨识的组成部分。
-
 - 我又明白什么呢，生命是那么奇特。我觉得自己就像个一辈子都住在小池塘边上的人，突然间看见了大海，让我有点喘不过气来，但心里又充满了喜悦。我不想死，想活下去，于是感到一股新的勇气。我就好像那些老水手，起航驶向尚未发现的海洋，我的灵魂渴求未知的一切。
-
 - 小小的两滴水默默地、默默地流向那黑暗、永恒的大海。
-
 - 道。我们有些人在鸦片中寻找道，有些人在上帝那儿，有些人寻求威士忌，或去爱里寻找。这道终归只有一条，可它不通向任何地方。
-
 - 这一切既新奇又感人，她的心灵犹如一片平静而灰暗的大海，波浪起伏，蔚然壮观，阴郁浩瀚令人畏惧，突然间，一缕阳光投射过来，让一切变得活泼、友好而快乐。
-
 - 人生何其短暂，世界本来就充满了苦痛，人们却还要折磨自己，这岂不太可怜了吗？
-
 - 她的性格就像一片乡野，初见时感觉辽阔而冷漠，但不久就会在巍峨山岭的褶皱间发现一个个掩映在果树丛中的欢腾的村庄，看见郁郁葱葱的草地上欢快流淌的一条条小河。这番宜人的景象会让你惊奇，甚至熨帖安心，但远处狂风劲吹的黄褐色高地尚不足以使你感到自如自在。
-
 - 只有一种办法赢得人心，那就是让自己成为人们会去爱的人。
-
 - 我说不清。我不知道她们追求幻觉这一点是否真的那么重要，还是这种生活本身就很美好。我有个想法，唯一让我们有可能不带嫌恶地关注我们所生活的这个世界的，就是人类不断从混沌中创造出的美。他们描绘的画，他们谱出的乐曲，他们写的书，还有他们的生活。这一切中，最富于美的就是美好的生活，那是件完美的艺术品。
-
 - 道就是道路和行道者。那是一条永恒的路，所有的生命存在行走其上，但它并非由生命存在所创造，因为它本身便是生命存在。它什么都是，又什么都不是。万物由道所生，与道相符，最后万物又回归于道。它是一块方形却无四角，是种声音却不被聆听，是幅图画却未有形状；它是一张巨大的网，网眼阔如海洋，却什么都无法穿过；它是万物寻求庇护的避难所；它无处可寻，但你‘不窥牖’便可‘见天道’；它要人学会欲无所欲，让一切顺其自然。谦卑者尽得保全，屈身者终将直立。‘祸兮，福之所依；福兮，祸之所伏’；但谁能说清什么时候会出现转折点？追求柔慈之人会如小孩子一样平和。柔慈为进攻者获取胜利，为守卫者求得保全。战胜自己的人最为强大。
-
 - 自由！这便是一直萦绕在她心中的念头。尽管未来仍旧模糊，这一念头却像河上的薄雾，在清晨阳光的照耀下焕发虹彩。自由！不仅仅是挣脱烦恼的束缚，解除那让她消沉的伴侣关系的自由。自由！不仅是逃离死亡威胁的自由，更是逃离让她降低人格的爱情，逃脱所有精神束缚的自由，一种抽离出肉体的精神的自由。与自由相伴的，还有勇气，以及无论发生什么都毫不在乎的坚强气质。
-
 - 她以为自己变了，以为自己意志坚强，会以一个冷静自持的女人的面目回到香港。心中掠过一个个崭新的念头，就像阳光下翻飞的黄色蝴蝶，让她对美好的未来充满期望。自由就像光的精灵召唤她，整个世界犹如一片广袤的平原，任她迈着轻快的步子昂首前行。她原以为自己已摆脱了肉欲和卑劣的情爱，足以过上一种纯洁健康的精神生活。她曾将自己比作黄昏时分悠然飞跃稻田的白鹭，它们就像安闲自处的头脑中翩然翱翔的片片思绪，可实际上她却仍是欲望的奴隶。
-
 - 我有希望，也有勇气。
-
 - 你用面纱遮蔽他人的窥探，自己也难以一睹世界之实。

 ------------------------------------------------------------------------
@@ -1,11 +1,16 @@
 ---
-title: "泥潭"
+title: 泥潭
 pubDate: 2026-02-09
 category: reading
-tags: [read]
-mood: '#166534'
-bookAuthor: '刘楚昕'
-description: '迷失于黑夜时，不妨抬头看看星空。'
+tags:
+  - read
+pinned: false
+mood: '#686868'
+bookAuthor: 刘楚昕
+description: 迷失在黑夜中时，不妨抬头看看星空；如果不知道该相信什么，人应当面对自己的良知。
+cover: ./assets/泥潭.png
+hiddenTag: false
+draft: false
 ---

 ### 迷失在黑夜中时，不妨抬头看看星空；如果不知道该相信什么，人应当面对自己的良知。
@@ -1,11 +1,16 @@
 ---
-title: "赎罪"
+title: 赎罪
 pubDate: 2026-02-26
 category: reading
-tags: [read]
-mood: '#9f1239'
-bookAuthor: '伊恩·麦克尤恩'
-description: '因一个人、一张图、一句台词，看了一本书。'
+tags:
+  - read
+pinned: false
+mood: '#bf002f'
+bookAuthor: 伊恩·麦克尤恩
+description: 亲爱的塞西莉亚，我们缘分未尽
+cover: ./assets/赎罪.png
+hiddenTag: false
+draft: false
 ---

 ### 你要回来，我会等你。
@@ -1,10 +1,15 @@
 ---
-title: "写作模板：这篇文章本身就是模板"
+title: 写作模板：这篇文章本身就是模板
 pubDate: 2026-11-02
 category: tech
-tags: [写作, 模板]
+tags:
+  - 写作
+  - 模板
 pinned: true
 description: 一篇文章演示全站可用的排版能力：标题层级、彩色强调、字族、引用、代码窗、表格、图、链接卡、折叠。复制它开始写新文。
+hidden: true
+draft: false
+hiddenTag: true
 ---

 这篇不是教程，是**可复制的模板**。下面每一节都在真跑——你看到的效果，就是 Markdown 源码能产出的效果。写新文章时，把本文件复制一份、改个 slug、删掉不需要的段落即可。
@@ -1,11 +1,66 @@
 # 关于页（后台「页面文案 → 关于页」可改）
-# ── 一级：blocks 块式正文（按顺序渲染，可拖拽排序；某块 enabled: false 即隐藏）
+# ── legacy：blocks 块式正文（doc 非空时不渲染；保留作结构化备选通道）
 # ── 二级：intro 多段 markdown（仅在 blocks 为空时使用）
 # ── 三级：内置默认文案（两者都空时兜底，构建永不炸）
 layout:
  # 名片区（头像/名字/身份语/社交）开关：头像等数据事实源在「主页设置」
  showIdCard: true

+doc:
+  zh: |
+    <span class="font-huiwen c-red">写作者</span> · 读者 · 快门按压者，拥抱开源。
+
+    这里是我三条轨道的公开工作台：**读过的书**留下评注，**写过的代码**进项目墙，**按下的快门**收入图库。
+
+    所有内容都有一个明确去处：
+
+    - 长文沉淀在文章与书架
+    - 短句与随手拍落在瞬间
+    - 影像收进图库，配一点 EXIF 与一句策展
+
+    ## 关于我
+
+    一个想做预报的人——气象是起点的专业，依旧把云图当日常读物。写代码是第二条主线：Linux、容器与自托管，把日常工具一件件磨顺手。作品大多在 [wait4x.online](https://wait4x.online/)。信条：**拥抱开源，热爱开源**。
+
+    ## 找到我
+
+    - [本站](https://wait4x.online/)
+    - [邮件](mailto:X@alumni.nudt.edu.cn)
+    - [GitHub](https://github.com/wait4xx)
+    - [自托管 gitea](https://git.wait4x.online/wait4x/blog)
+    - [RSS](/rss.xml)
+
+    ## 本站如何构建
+
+    页面由 Astro 静态生成，不含运行时框架 JS；内容住在自托管 gitea——本地编辑器与 gitea 网页写的是同一份仓库，推送即构建上线。排版三件套（字体子集化、灰阶骨架、双层明暗）也都在仓里，欢迎按 F12 随便看。
+  en: |
+    <span class="font-huiwen c-red">Writer</span> · Reader · Shutter-presser, embracing open source.
+
+    This is the public workbench of my three tracks: **books** that left notes, **code** that reaches the project wall, and **shutters** that land in the gallery.
+
+    Everything has a clear destination:
+
+    - Long-form writing goes to posts and the bookshelf
+    - Short lines and snapshots land in moments
+    - Images go to the gallery, with EXIF and a line of curation
+
+    ## About me
+
+    An aspiring forecaster — meteorology was where I started, and I still read cloud charts for fun. Coding is the second thread: Linux, containers, and self-hosting, polishing everyday tools one by one. Most of my work lives at [wait4x.online](https://wait4x.online/). Motto: **embrace open source, love open source**.
+
+    ## Find me
+
+    - [This site](https://wait4x.online/)
+    - [Email](mailto:X@alumni.nudt.edu.cn)
+    - [GitHub](https://github.com/wait4xx)
+    - [Self-hosted gitea](https://git.wait4x.online/wait4x/blog)
+    - [RSS](/rss.xml)
+
+    ## How this site is built
+
+    Static pages by Astro, no client-side framework JS; content lives in my self-hosted gitea — the local editor and the gitea web UI write to the same repo, and a push builds the site. The typography stack (font subsetting, greyscale skeleton, dual light/dark) is all in the repo — view source freely.
+
+# ---- blocks 块式通道（legacy：doc 非空时不渲染；后台仍可编辑，留作结构化备选）----
 blocks:
  - type: prose
    width: narrow
@@ -1,6 +1,6 @@
 tagline:
-  zh: 写作者 · 读者 · 快门按压者，拥抱开源。
-  en: Writer · Reader · Shutter-presser — embracing open source.
+  zh: 拥抱开源，热爱开源
+  en: Embracing open source, loving open source.
 latestPhotos: 4
 perTrackLimit: 6
 sections:
@@ -13,9 +13,6 @@ socials:
  - label: GitHub
    url: https://github.com/wait4xx
    icon: github
-  - label: RSS
-    url: /rss.xml
-    icon: rss
  - label: 邮件
    url: mailto:X@alumni.nudt.edu.cn
    icon: email
@@ -1,4 +1,3 @@
-# 打字机动效文案（档案卡顶部逐字轮播；每行双语，最多 6 行；留空用内置默认三行）
 typing:
  - zh: 气象出身，写代码为乐
    en: Trained in meteorology, coding for fun
@@ -6,25 +5,27 @@ typing:
    en: Self-hosting whatever can be self-hosted
  - zh: 拥抱开源，热爱开源
    en: Embrace open source, love open source
-  - zh: 把读过的书、按下的快门都放进同一个工作台
-    en: Books read and shutters pressed, gathered in one workbench
+  - zh: 书与快门都在一个工作台
+    en: Books and shutters, one workbench

+# 开篇叙述（5j T1）：markdown 富文本，链接内联写 `[文字](url)`。
+# 非空时整段走富文本管线（净化 + 排版类白名单），**取代**下面的 blurb + repo_* + blurb_after 拼接。
+story:
+  zh: "本站本身即开源：[git.wait4x.online/wait4x/blog](https://git.wait4x.online/wait4x/blog) —— Astro SSG、双写作流、构建发布全链皆在仓中。以下是我在自托管 gitea 与 GitHub 上的全部公开仓库，以及最近一年的贡献活动。"
+  en: "This site is itself open source: [git.wait4x.online/wait4x/blog](https://git.wait4x.online/wait4x/blog) — the Astro SSG, dual-writing workflow, and the full build & deploy pipeline live in the repo. Below are all my public repositories on self-hosted gitea and GitHub, plus contributions from the past year."
+
+# ---- legacy（story 为空时才用）----
+# 下面四个字段是 5j 之前「两半夹链接」的写法，保留只为旧 yaml / 回退演示；新改动请一律写 story。
 blurb:
  zh: 本站本身即开源：
  en: 'This site is itself open source:'
 repo_url: https://git.wait4x.online/wait4x/blog
 repo_label: git.wait4x.online/wait4x/blog
+# legacy：story 为空时接在 story 占位处拼接（见上方 blurb 注释）
 blurb_after:
  zh: —— Astro SSG、双写作流、构建发布全链皆在仓中。以下是我在自托管 gitea 与 GitHub 上的全部公开仓库，以及最近一年的贡献活动。
  en: — the Astro SSG, dual-writing workflow, and the full build & deploy pipeline live in the repo. Below are all my public repositories on self-hosted gitea and GitHub, plus contributions from the past year.
 mode: all
 sort: pinned-first
 perSource: github
-intro_from: "off"
-
-# ---- 开篇来源说明（2026-11-02 Phase 5h）----
-# 开篇已改原生 GitHub 档案卡（头像 / 统计四格 / 语言占比灰阶条），不再渲染 README 原文。
-# intro_from: "off"      = 用档案卡 + 上面的 blurb（当前）
-# intro_from: github-readme = 构建期取 wait4xx/wait4xx 的 README 原样渲染（**不推荐**：
-#   会引入 7 类第三方外链图，慢网或被墙时整片空白；README 用 <div align="center"> 居中，
-#   本站不认该属性 → 居中失效。这正是当初"内容没居中、图片不显示"的根因。）
+intro_from: 'off'
@@ -0,0 +1,21 @@
+# 页面标题下的说明文案（瞬间 / 书架）：文字、字号、颜色、字体都在这里改。
+# 缺省即回落内置默认，删字段不会破版。
+# 说明：color 取 tokens 里的灰阶层级（ink-1..ink-4）；font 取排版类白名单里的字体类。
+
+moments:
+  note:
+    zh: 零碎的记录：随手拍、一句话感想、开源动态。
+    en: 'Fragmented notes: casual shots, one-liners, and open-source updates.'
+  style:
+    size: 13
+    color: ink-4
+    font: font-sans
+
+books:
+  note:
+    zh: 点一行展开封面与简介 · 置顶的书默认展开
+    en: 'Tap a row for the cover and blurb · pinned books start open'
+  style:
+    size: 13
+    color: ink-4
+    font: font-sans   # 与改造前一致；想用楷体改成 font-kai
@@ -14,10 +14,19 @@ cp content/posts/writing-template.md content/posts/my-new-post.md
 模板本身是一篇真文章（线上读：`/archives/writing-template/`），每节都在跑一种能力，你看到的效果就是源码的效果：标题层级、彩色强调、字族切换、引用、列表、代码窗条、表格、图片放大、链接卡片、`<details>` 折叠、分隔线。

 写之前只需记住三条纪律：
- **彩色不限次数**（2026-11-02 用户拍板取消原「一页 ≤3 处」限制）：正文想用多少处颜色都可以；仍守的是另一条——**外壳灰阶**（导航/页脚/按钮/背景不染色），因为外壳是气质，正文是表达
+- **彩色不限次数**（2026-11-02 用户拍板取消原来的"一页最多三处"）：正文想用多少处颜色都可以；仍守的是另一条——**外壳灰阶**（导航/页脚/按钮/背景不染色），因为外壳是气质，正文是表达
 - **整页换字族要谨慎**：会给访问者拉一份中文字体（汇文明朝整页约 420KB，已子集化）
 - **折叠放细节不放结论**：`<details>` 里的内容可能永远没人展开

+## 隐藏文章（两种写法，任选其一）
+
+不想让某篇出现在首页/归档/书架/RSS/sitemap：
+- frontmatter 写 `hidden: true`（后台有开关）
+- 或在 `tags` 里加一个 `hidden`
+
+页面本身仍会生成，链接可以直接分享给别人；想连页面都不生成，用 `draft: true`（草稿）。
+**隐藏与置顶同开时，以隐藏为准**（2026-11-04 修复：此前隐藏开关是假的，隐藏+置顶会照样显示还排第一）。
+
 ## 置顶文章

 首页、归档、书架三处列表默认按日期倒序。想让某篇长期排在最前，frontmatter 加一行：
@@ -201,6 +210,31 @@ python3 scripts/build-perf/subset-fonts.py \

 子集化产物输出到 `--out` 指定目录（如 `public/fonts/subset/`）；把它接进站点（构建链挂守卫 + 字体 CSS 指向子集）是独立一步，接线后随构建自动生成，未接线前需手动跑。**换字/加字后重跑一次**，否则新字会回落到下一个切片或系统字体。

+### 5i 字族扩展六款（2026-11-03，全站共 12 族）
+
+| 类名 | 字体 | 适用场景 | 许可证 / 来源 | 切片 | 单页增量（实测） |
+|---|---|---|---|---|---|
+| `font-xiaowei` | 站酷小薇 ZCOOL XiaoWei | 文学味标题、书摘 | OFL-1.1 / google/fonts `ofl/zcoolxiaowei` | 100 片 | 44.9KB |
+| `font-huangyou` | 站酷庆科黄油体 | 圆润标题、栏目名 | OFL-1.1 / `ofl/zcoolqingkehuangyou` | 100 片 | 27.1KB |
+| `font-mashanzheng` | 马善政毛笔楷书 | 书法短句、题记 | OFL-1.1 / `ofl/mashanzheng` | 100 片 | 45.7KB |
+| `font-liujianmaocao` | 柳建毛草 | 草书点缀（只宜 1-2 字） | OFL-1.1 / `ofl/liujianmaocao` | 100 片 | 30.0KB |
+| `font-smiley` | 得意黑 Smiley Sans（Oblique） | 现代倾斜标题、强调句 | OFL-1.1 / `atelier-anchor/smiley-sans` v2.0.1 | 100 片 | 27.1KB |
+| `font-neoxihei` | 霞鹜新晰黑 LXGW Neo XiHei | 比思源黑更清晰的正文黑体 | OFL / `lxgw/LxgwNeoXiHei` | 96 片 | 30.0KB |
+
+- 六款均按**站内用字**细切（约 19 字/片，单片 2–12KB），且只在内容里写到对应类时才加载（探测在 `src/lib/font-needs.ts`）——首页、归档列表这类无字体类的页面**零增量**。
+- **覆盖边界**：切片只含站内出现过的字（当前约 1900 字）。新写了字典外的新字（尤其生僻字）要先重跑切片，否则该字回落系统字族。
+- **重切命令**（字体源文件不入仓，按需从上面的来源下载）：
+
+```bash
+python3 scripts/build-perf/subset-fonts.py \
+  --split-ttf /path/to/YourFont.ttf --family "Font Family Name" \
+  --slices 100 --order-from public/fonts/subset/hwmc/fonts.css \
+  --out public/fonts/<shortname> \
+  --chars-from 'content/posts/*.md' 'content/site/*.yaml' 'content/moments/*.md'
+```
+
+- **体积闸门**：单页增量 >150KB 必须子集化或降级。本次六款实测 27–46KB（单句场景）全部达标；@fontsource 官方中文包切片粒度约 33 字/片、单片 40KB+，一句话就 300–440KB/页，**已弃用**（改从原始 TTF 细切）。
+
 ### 候补字体清单（未落地，加一款约"一条命令 + 一次体积账"）

 | 字体 | 许可证 | 允许 webfont 嵌入 | 未落地原因 |
@@ -271,7 +305,7 @@ text: 今天把**置顶**做完了，顺手试了 <span class="c-teal">彩色</s
 ---
 ```

- `text` 支持 markdown（`**加粗**`、列表、`> 引用`）与**同一套排版类**（字体/颜色），因为走的是与全站文案相同的净化管线：危险标签整棵丢弃，只放行 35 项白名单类
+- `text` 支持 markdown（`**加粗**`、列表、`> 引用`）与**同一套排版类**（字体/颜色），因为走的是与全站文案相同的净化管线：危险标签整棵丢弃，只放行 42 项白名单类
 - 一条瞬间 = 一行时间线卡片，**每条都带独立评论区**（展开才挂载，双语页共用同一评论流，评论不分裂）
 - 每条的「浏览 / 评论」数字是只读统计（不会因为别人点开评论而虚增浏览）
 - `text` 与 `image` 至少填一项；图片建议先压缩
@@ -24,13 +24,24 @@
 - **文章英文版**：不在后台写。跑 `python3 scripts/translate/translate_posts.py` 生成 `content/posts-en/` 同名文件；手写润色过的译文在 frontmatter 写 `locked: true`，翻译脚本会无条件跳过它。
 - **保存即提交**：后台保存等于向仓库提交，push 后约 10 秒自动构建上线。

+## 页面说明文案（5j 新增：瞬间 / 书架）
+
+「页面文案」新增 `content/site/pages.yaml`（后台「瞬间 / 书架 标题下的说明」）：那一行字的文字（markdown，支持排版类）、
+字号（11–16）、颜色（灰阶四级）、字体（12 族下拉）都在这里改，两页互相独立。
+
+兜底行为：任何字段清空/删掉都回落内置默认；越界值（如字号填 40、颜色乱写）
+会被自动夹取或回落，不会破版。
+
 ## 文章置顶（5h 新增）

 文章编辑页有一个「置顶」开关。打开后这篇文章排在首页分轨、归档、书架三处列表的最前面，列表里显示一个灰阶「置顶」小徽标。

 语义边界（刻意如此，别当 bug 报）：
 - **只影响列表顺序**：`pubDate` 不变、URL 不变、RSS 里的时间序列不变，订阅者不会看到时间错乱
- 多篇同时置顶时，置顶组内部仍按日期倒序
+- **与「隐藏」同开时以隐藏为准**：后台的「隐藏」开关（5j 起是真字段）会把这篇从列表/RSS/sitemap 里拿掉，页面本身仍可分享
+- **支持多篇/多本同时置顶**：置顶组内部仍按日期倒序；书架页（/books）里每个置顶的书评都会排在前面并**默认展开**
+- **置顶 + 隐藏同时打开时，以隐藏为准**（5j 修复：此前隐藏开关只写一个没人读的字段，导致隐藏+置顶的文章照样显示还排第一）
+- 书架页用「↑ + 横线」的回到顶部图标表示置顶（不写文字），与右侧展开箭头形状不同，不会混读
 - 关掉开关立即恢复时间序，没有"冷却期"

 ## 瞬间（5h 起与文章同级）
@@ -39,7 +50,7 @@

 - markdown：`**加粗**`、`*斜体*`、列表、`> 引用`、`` `行内代码` ``
 - 排版类 HTML：`<span class="c-blue font-kai">彩色 + 楷体</span>`（可用类清单见写作指南「文章排版类」一节，与文章完全同一份白名单）
- 彩色**不再限次**（原「≤3 处/页」已取消）；仍守外壳灰阶：导航/页脚/按钮/背景不染色
+- 彩色**不再限次**（原来的"一页最多三处"已取消）；仍守外壳灰阶：导航/页脚/按钮/背景不染色

 **每条瞬间自带评论区**：时间线卡片下方有「评论」折叠条，读者点开才加载评论（不点开不为它付任何加载成本）。中文页与英文页共用同一条评论流，语言切换不会丢评论。

@@ -65,6 +76,15 @@ caption: 落日把海与城一齐烫成金箔，**这一帧等了二十分钟**
 2. 图片字段 → 资产库上传 jpg（与 sidecar 同目录落位，零重压缩）
 3. Save → 自动 commit + 构建 → 画廊出现（EXIF 构建期自动提取，exif 字段留空即可）

+## 关于页正文（5k 起：方案 A 白纸直编）
+
+「页面文案 → 关于页」最上面是「**整页正文**」一个 markdown 字段：想写什么写什么、
+想多长写多长，支持排版类（字体/颜色）与 `##` 小标题。保存后整页就渲染这一段
+（身份名片仍在顶部）。
+
+下面的「块式结构」是 legacy 通道：只有当「整页正文」清空时才会显示，
+老内容已迁移进正文，平时不用管它。四级回落：整页正文 → 块式结构 → intro → 内置默认。
+
 ## 块编辑：关于页的块式页面构建器

 关于页（`content/site/about.yaml`）的正文由 **blocks 列表**构成，后台里是一串可拖拽排序的卡片。每个块都有「显示」开关；关掉只是不渲染，块本身留在数据里。
@@ -152,6 +172,10 @@ blocks:
 | `postsTracks` | `{reading, tech, photo}` 布尔 | 全开 | 关掉某轨，该轨文章不在首页列出（归档页仍可见） |

 ### 开源页（opensource.yaml）
+**叙述已合一（5j 起）**：改用 `story` 字段（后台显示为「叙述（推荐改这里）」），整段写成 markdown，
+链接直接内联（`[文字](url)`），不再分"链接前/链接后"。旧的两个字段（链接前/链接后）
+只是 legacy——仅当「叙述」为空时才会退回旧拼接，平时不用管它们。
+

 **开篇是原生「GitHub 档案卡」（5h 起）**：头像 / 名字@handle / 定位叙述 / 社交图标 / 统计四格（关注者、公开仓、总星标）/ 语言占比灰阶条（只有第一名用强调色，其余灰阶）。**零第三方图片、零 iframe**。数据失败只隐藏对应数字，不会破版。

@@ -39,12 +39,9 @@ pnpm astro build
 [ -f scripts/build-perf/gen-sw-precache.mjs ] && node scripts/build-perf/gen-sw-precache.mjs dist || echo "[build] sw-precache 生成器未就绪，跳过"
 [ -f scripts/build-perf/inline-home-css.mjs ] && node scripts/build-perf/inline-home-css.mjs || echo "[build] inline-home 脚本未就绪，跳过"

-# README 动效资产（5i T8）：**不在此跑抓取**（避免发布链被外网抖动拖累），只做存在性守卫 + 缺资产告警
-if [ -f public/github-assets/manifest.json ]; then
-  echo "[build] github-assets 就绪：$(find public/github-assets -name '*.svg' | wc -l) 个自托管 SVG"
-else
-  echo "[build] WARN public/github-assets/manifest.json 缺失——开源页数据板将只显示原生统计（可手动跑 node scripts/build-perf/fetch-readme-assets.mjs 补齐）"
-fi
+# README 动效资产（5i 引入、5j T2 退役）：贡献蛇与 streak 快照已删——连续贡献改为
+# 热力图同源本地计算（见 src/lib/heatmap.ts 的 streakStats），界面上标注"数据更新于"。
+# fetch-readme-assets.mjs 保留骨架但 ASSETS 已清空，如将来要加新的自托管资产再启用。

 # 内容 lint（T3）：断链/缺图在部署前拦截；CONTENT_LINT=skip|warn 逃生门见脚本头注
 [ -f scripts/build-perf/content-lint.mjs ] && node scripts/build-perf/content-lint.mjs dist || echo "[build] content-lint 未就绪，跳过"
@@ -55,7 +55,12 @@ collections:
        widget: string
        required: false
        hint: '填 /media/xxx.jpg（先上传到 public/media 取路径）；缺省浏览器自取首帧'
-      - { label: 隐藏（不进列表/sitemap）, name: hiddenTag, widget: boolean, required: false, hint: '对应 tags 含 hidden；保存后请人工核对' }
+      - label: 隐藏（不进列表 / RSS / sitemap）
+        name: hidden
+        widget: boolean
+        required: false
+        default: false
+        hint: '打开后这篇不进首页/归档/书架/RSS/sitemap，但页面本身仍生成、链接可分享（想彻底不生成请用草稿）。与「置顶」同时打开时以隐藏为准——2026-11-04 修：旧开关只写一个没人读的字段，导致隐藏+置顶的文章照样显示还排第一'
      - { label: 草稿, name: draft, widget: boolean, required: false, default: false }
      - { label: 正文, name: body, widget: markdown }

@@ -143,6 +148,73 @@ collections:
  - name: site_pages
    label: 页面文案
    files:
+      - name: pages
+        label: 瞬间 / 书架 标题下的说明
+        file: content/site/pages.yaml
+        format: yaml
+        hint: 这两页大标题下面那一行字，文字与样式都在这里改
+        fields:
+          - label: 瞬间页
+            name: moments
+            widget: object
+            required: false
+            fields:
+              - label: 说明文字
+                name: note
+                widget: object
+                required: false
+                hint: 支持 markdown 与排版类（字体/颜色）
+                fields:
+                  - { label: 中文, name: zh, widget: markdown, required: false }
+                  - { label: English, name: en, widget: markdown, required: false }
+              - label: 样式
+                name: style
+                widget: object
+                required: false
+                hint: 留空用全站默认；越界值会被自动夹取（不会破版）
+                fields:
+                  - { label: 字号（px，11–16）, name: size, widget: number, required: false, value_type: int, min: 11, max: 16 }
+                  - label: 颜色
+                    name: color
+                    widget: select
+                    required: false
+                    hint: 只开放灰阶层级，避免正文被染色
+                    options: [ink-1, ink-2, ink-3, ink-4]
+                  - label: 字体
+                    name: font
+                    widget: select
+                    required: false
+                    options: [font-sans, font-serif, font-kai, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
+          - label: 书架页
+            name: books
+            widget: object
+            required: false
+            fields:
+              - label: 说明文字
+                name: note
+                widget: object
+                required: false
+                hint: 支持 markdown 与排版类（字体/颜色）
+                fields:
+                  - { label: 中文, name: zh, widget: markdown, required: false }
+                  - { label: English, name: en, widget: markdown, required: false }
+              - label: 样式
+                name: style
+                widget: object
+                required: false
+                hint: 留空用全站默认；越界值会被自动夹取（不会破版）
+                fields:
+                  - { label: 字号（px，11–16）, name: size, widget: number, required: false, value_type: int, min: 11, max: 16 }
+                  - label: 颜色
+                    name: color
+                    widget: select
+                    required: false
+                    options: [ink-1, ink-2, ink-3, ink-4]
+                  - label: 字体
+                    name: font
+                    widget: select
+                    required: false
+                    options: [font-sans, font-serif, font-kai, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
      - name: home
        label: 主页设置
        file: content/site/home.yaml
@@ -169,8 +241,8 @@ collections:
                name: font
                widget: select
                required: false
-                hint: 整页正文换字族；艺术/展示类字族（汇文、快乐体）体积大，单页成本会上升
-                options: [font-serif, font-kai, font-sans, font-mono, font-song, font-kai-sys, font-hei-sys, font-fangsong, font-huiwen, font-kuaile]
+                hint: 整页正文换字族；艺术/展示类字族体积大。5i 新增六款（小薇/庆科黄油/马善政/柳建毛草/得意黑/新晰黑）均按站内用字切片，单页增量 27–46KB；站外用字（生僻字）会回落系统字族，需按 docs 里的命令重切
+                options: [font-serif, font-kai, font-sans, font-mono, font-song, font-kai-sys, font-hei-sys, font-fangsong, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
              - label: 强调色类
                name: accent
                widget: select
@@ -260,7 +332,15 @@ collections:
        media_folder: content/site/assets
        public_folder: ./assets
        fields:
-          - label: 页面块（拖拽排序；每块可折叠）
+          - label: 整页正文（推荐改这里，方案 A 白纸直编）
+            name: doc
+            widget: object
+            required: false
+            hint: '整页就这一个 markdown 字段：想写什么写什么、想多长写多长（支持排版类与 ## 标题）。清空则回落到下面的 blocks 结构化通道'
+            fields:
+              - { label: 中文, name: zh, widget: markdown, required: false }
+              - { label: English, name: en, widget: markdown, required: false }
+          - label: 块式结构（legacy，整页正文为空时才显示）
            name: blocks
            widget: list
            typeKey: type
@@ -523,7 +603,7 @@ collections:
                name: font
                widget: select
                required: false
-                options: [font-serif, font-kai, font-sans, font-mono, font-song, font-kai-sys, font-hei-sys, font-fangsong, font-huiwen, font-kuaile]
+                options: [font-serif, font-kai, font-sans, font-mono, font-song, font-kai-sys, font-hei-sys, font-fangsong, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
              - label: 强调色类
                name: accent
                widget: select
@@ -544,11 +624,19 @@ collections:
            fields:
              - { label: 中文, name: zh, widget: string }
              - { label: English, name: en, widget: string }
-          - label: 叙述（链接前）
+          - label: 叙述（推荐改这里）
+            name: story
+            widget: object
+            required: false
+            hint: '整段叙述写成一个字段即可（markdown + 排版类），链接直接写在句子里：[本站源码](https://git.wait4x.online/wait4x/blog) —— 这样就不用再分"链接前/链接后"。留空时才会退回下面的旧字段拼接'
+            fields:
+              - { label: 中文, name: zh, widget: markdown, required: false }
+              - { label: English, name: en, widget: markdown, required: false }
+          - label: 叙述（旧：链接前）
            name: blurb
            widget: object
            required: false
-            hint: 富文本（markdown + 排版类），渲染在仓库链接之前
+            hint: 'legacy：仅当上面的「叙述」为空时才使用（历史字段，为把仓库链接夹在中间而拆成两半）'
            fields:
              - { label: 中文, name: zh, widget: string, required: false }
              - { label: 英文, name: en, widget: string, required: false }
@@ -562,8 +650,8 @@ collections:
                name: font
                widget: select
                required: false
-                hint: 整页正文换字族；艺术/展示类字族（汇文、快乐体）体积大，单页成本会上升
-                options: [font-serif, font-kai, font-sans, font-mono, font-song, font-kai-sys, font-hei-sys, font-fangsong, font-huiwen, font-kuaile]
+                hint: 整页正文换字族；艺术/展示类字族体积大。5i 新增六款（小薇/庆科黄油/马善政/柳建毛草/得意黑/新晰黑）均按站内用字切片，单页增量 27–46KB；站外用字（生僻字）会回落系统字族，需按 docs 里的命令重切
+                options: [font-serif, font-kai, font-sans, font-mono, font-song, font-kai-sys, font-hei-sys, font-fangsong, font-huiwen, font-kuaile, font-xiaowei, font-huangyou, font-mashanzheng, font-liujianmaocao, font-smiley, font-neoxihei]
              - label: 强调色类
                name: accent
                widget: select
@@ -19,6 +19,13 @@ window.TYPOGRAPHY_CLASSES = {
    { cls: 'font-huiwen', label: '汇文明朝体', family: '"WF-Hwmc", serif', kind: '自托管' },
    { cls: 'font-kuaile', label: '站酷快乐体', family: '"ZCOOL KuaiLe", serif', kind: '自托管' },
    { cls: 'font-art-kuaile', label: '快乐体（艺术·仅标题）', family: '"ZCOOL KuaiLe", serif', kind: '艺术字' },
+    // 5i T9 五款字族扩展（2026-11-03，均 OFL / 免费商用且允许 web 嵌入）
+    { cls: 'font-xiaowei', label: '站酷小薇（文学·宋）', family: '"ZCOOL XiaoWei", serif', kind: '自托管' },
+    { cls: 'font-huangyou', label: '站酷庆科黄油（标题）', family: '"ZCOOL QingKe HuangYou", sans-serif', kind: '自托管' },
+    { cls: 'font-mashanzheng', label: '马善政（书法）', family: '"Ma Shan Zheng", "Kaiti SC", serif', kind: '自托管' },
+    { cls: 'font-liujianmaocao', label: '柳建毛草（草书）', family: '"Liu Jian Mao Cao", "Kaiti SC", cursive', kind: '自托管' },
+    { cls: 'font-smiley', label: '得意黑（斜体标题）', family: '"Smiley Sans", sans-serif', kind: '自托管' },
+    { cls: 'font-neoxihei', label: '霞鹜新晰黑（正文黑）', family: '"LXGW Neo XiHei", "Noto Sans SC", sans-serif', kind: '自托管' },
  ],
  color: [
    { cls: 'ink-1', label: '最重（标题级）', swatch: '#111113' },