Merge branch 'spec/2026-11-02_blog-5g-pages'

Phase 5g 交付：块式页面构建器（关于页九类区块驱动）+ 样式即数据（theme.yaml + 对比度闸门）+ 首页抽 HomePage 消双份与三字段 + 开源页收尾（README 四级回落/兜底 8 仓/可见性告警）+ 后台文档与 hint（config.yml 重复键结构缺陷修复）+ 字体子集化（汇文 -40%）+ 全站三层排版（富文本/页面级覆盖/艺术字体类）。 Spec: 2026-11-02_blog-5g-pages
2026-11-02 19:20:17 +08:00
commit c772236d1a
@@ -0,0 +1,94 @@
+# 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
+}
+```
@@ -0,0 +1,7 @@
+{"task": "task_0001", "cmd": "E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q \"37/37 PASS\" && grep -q \"discriminatedUnion\" src/content.config.ts && grep -q \"BlockRenderer\" src/components/pages/AboutPage.astro && grep -q \"typeKey\" public/admin/config.yml", "exit": 0, "duration_s": 18.466, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:18:21+00:00"}
+{"task": "task_0002", "cmd": "E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q \"37/37 PASS\" && ls src/components/blocks/ | grep -qC1 \"Cards\\|Timeline\" && grep -q \"image()\" src/content.config.ts", "exit": 0, "duration_s": 17.177, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:18:39+00:00"}
+{"task": "task_0003", "cmd": "E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q \"37/37 PASS\" && test -f content/site/theme.yaml && node scripts/build-perf/contrast-check.mjs dist", "exit": 0, "duration_s": 17.193, "stdout_tail_sha256": "f66c66c7ce879dad3f789790f8607fbd50e7a5a894e12912a55fd47d082e4f77", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:18:56+00:00"}
+{"task": "task_0004", "cmd": "E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q \"37/37 PASS\" && test -f src/components/pages/HomePage.astro && grep -q \"HomePage\" src/pages/en/index.astro", "exit": 0, "duration_s": 17.189, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:19:13+00:00"}
+{"task": "task_0005", "cmd": "E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q \"37/37 PASS\" && python3 -c \"import json;d=json.load(open('src/data/projects-fallback.json'));assert len(d)>=5\"", "exit": 0, "duration_s": 17.214, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:19:30+00:00"}
+{"task": "task_0006", "cmd": "test -f docs/管理台.md && grep -q \"blocks\\|区块\" docs/管理台.md && grep -c \"hint\" public/admin/config.yml | awk '$1>=20'", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "913f5d1da2feaf4deeccc9e55cbb350a20f12b3f507e87be85dbb77fdd3cb9bc", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:19:30+00:00"}
+{"task": "task_0007", "cmd": "test -f scripts/build-perf/subset-fonts.py && python3 -c \"import fontTools; print('fonttools ok')\" && E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q \"37/37 PASS\"", "exit": 0, "duration_s": 17.19, "stdout_tail_sha256": "3bcefe2ef2e30a5bbe067d31368a9765d7843d0cc24738a60c946c020e581348", "tree_fp": "7a7e460dbaff3855c2da899e62a1489b19a1d25a4a91ecfb211fadec40bff343", "at": "2026-11-02T11:19:47+00:00"}
@@ -0,0 +1,84 @@
+# Phase 5g：页面后台化（blocks 模型）与字体子集化 - 项目范围
+
+<!-- spec-format: 2 -->
+
+## 1. 问题定义
+- **项目目标**：①按 docs/research/10 方案 E 把关于页改造成「块式页面构建器」（结构可增删排序）②样式即数据（theme.yaml → 构建期 CSS 变量，含对比度闸门）③首页字段细化并抽 HomePage 消 zh/en 双份 ④开源页收尾（README 缓存/回落/告警）⑤后台文档与 hint 补齐 ⑥字体子集化工具（把艺术字体单页增量从数百 KB 降到数十 KB）
+- **目标用户**：站长（希望整页可编辑、能上更多艺术字体）与读者（版式与可读性不退化）
+- **核心价值**：内容与结构的编辑权交回后台，同时守住灰阶体系/双语/SEO/构建期零运行时四条红线
+
+## 2. 假设与待确认
+
+### 2.1 已确认事实
+- Sveltia 0.252 支持 list 的 types + typeKey（方案 10 §3.4 从本仓 bundle 取证），块模型可行
+- 页面文案 markdown 净化（D1/D2）已在 2cab243 落地（P0 完成）
+- 字体实测：@fontsource CJK 切片粒度导致单页 +163KB~+8605KB；现有 6 自托管族为基线
+
+### 2.2 关键假设
+- 块渲染器受控，破版风险低于整页 HTML 直编（方案 10 §2 对比表）
+- 字体子集化（pyftsubset 按页实际用字）能把艺术字体单页增量压到 ≤150KB 阈值内
+
+### 2.3 待确认问题
+- [x] 关于页整页可编辑路线 → 用户 2026-11-02 批准方案 E（blocks + theme.yaml + 局部自由区）
+- [x] 字体扩充路线 → 先落 6 族，其余按子集化工具就绪后再评估（本包 T7 交付工具）
+
+### 2.4 可选解释与取舍
+- 关于页保留 intro markdown 通道作为 compat（blocks 为空时三级回落：blocks → intro → 默认文案）
+- 样式即数据只开放白名单旋钮（约 12 项），不开放整份 tokens.css
+- 图片只走 Astro image() 管线，禁止块内填外链/绝对路径（schema 层拦）
+
+### 2.5 已证伪路径
+- 整页富文本直编（C 方案）：XSS 面大、无设计兜底，弃
+- 新增 webfont 直接上（不子集化）：单页 +535KB~+8605KB，超阈值，弃（改走 T7 工具）
+
+## 3. 功能范围
+
+### 3.1 核心功能（MVP）
+- [x] T1 blocks 骨架：schema（discriminatedUnion）+ page-blocks.ts + BlockRenderer + prose/tracks/divider 三块 + 后台 types 声明
+- [x] T2 块型扩充：cards/timeline/quote/figure/linklist/cta + 图标键白名单 + 图片 image() 管线
+- [x] T3 样式即数据：theme.yaml + theme.ts + BaseLayout 内联变量 + 对比度闸门脚本
+- [x] T4 首页细化与去重：抽 HomePage.astro 消 zh/en 双份 + 字段细化（projectsLimit/announcement 等）
+- [x] T5 开源页收尾：README 缓存策略/超时/回落矩阵 + fallback JSON 回填 + include 未命中 WARN
+- [x] T6 文档与 hint：docs/管理台.md（块编辑用法）+ 写作指南扩充 + admin 全字段中文 hint
+- [x] T7 字体子集化工具：按页用字裁剪艺术字体为小切片 + build.sh 守卫挂载 + 实测对比
+
+### 3.2 扩展功能
+- 无
+
+### 3.3 不在范围内
+- 换 CMS、页面布局的任意拖拽网格、运行时编辑器
+
+## 4. 最小实现路径
+- 最简单可行方案：块类型先用 3 类跑通闭环（prose/tracks/divider），再扩到 9 类；theme 只做 12 个白名单旋钮
+- 暂不引入：可视化块预览、块级动画配置
+- 不做的抽象：通用页面 DSL（只服务现有页面）
+
+## 5. 技术决策
+- 技术栈：Astro 7.4.4 + zod discriminatedUnion + Sveltia list/types + pyftsubset（fonttools）
+- 证据协议：evidence: runs
+- 本轮允许改动：src/content.config.ts、src/lib/{page-blocks,theme,site-content}.ts、src/components/blocks/*、src/components/pages/{AboutPage,HomePage}.astro、src/pages/{index,en/index,opensource,en/opensource}.astro、src/layouts/BaseLayout.astro、public/admin/*、content/site/*.yaml、scripts/build-perf/*、infra/deploy/build.sh、docs/*、tests/e2e.mjs
+- 本轮不应触碰：nginx/ESA、图库灯箱（GalleryPage/PhotoZoom）、Header/Footer 结构
+- Git integration branch：`spec/2026-11-02_blog-5g-pages`
+
+### 5.1 验证策略
+- 范围级别：package
+- 变更对象：页面数据模型与渲染器、后台配置、样式变量生成、字体产物、文档
+- 快速检查：`pnpm astro build`（node26）
+- 集成检查：`node tests/e2e.mjs`（37 项，本包预期新增块/主题断言）+ content-lint 0/0/0
+- 全项目检查：字体体积账（三页增量）+ 视觉复核（glm-5.3-flash:max，块版式与主题变量双态）；仅在构建链或 BaseLayout 结构再变更时升级范围
+- 升级触发：若 theme 变量波及全局排版（字体字号全站变化）或 blocks 改动触及首页/文章页结构，升级为全站视觉复核与 E2E 全量并记录理由
+
+## 6. 成功标准与验证方式
+- [x] 关于页整页由 yaml blocks 驱动，增删排序生效 -> verify: task_0001
+- [x] 九类块全部可渲染且旧内容零回归（三级回落） -> verify: task_0002
+- [x] theme.yaml 改值 → 产物 CSS 变量变化，对比度闸门拦截不达标 -> verify: task_0003
+- [x] 首页 zh/en 由同一组件渲染且字段可配 -> verify: task_0004
+- [x] 开源页 README 失败矩阵与 fallback 告警可用 -> verify: task_0005
+- [x] 后台文档与 hint 完整 -> verify: task_0006
+- [x] 字体子集化工具把指定字体单页增量压到 ≤150KB -> verify: task_0007
+
+## 7. 风险与约束
+- 灰阶体系与双语红线不变；彩色仅正文强调
+- 块渲染器未知类型跳过 + WARN，绝不炸构建
+- 字体子集化需保证字形覆盖（裁错字会出现豆腐块）→ 断言：子集后页面文本逐字命中
+- 多车道并行：共享文件（content.config.ts/admin config/docs）按 boundary 划界，tokens/global 由 orchestrator 或指定单车道
@@ -0,0 +1,42 @@
+# Phase 5g：页面后台化（blocks 模型）与字体子集化 - 任务拆解
+
+## 使用规则
+- boundary/verify 齐备；verify 只读断言；车道工作树开发禁 git，收编由 orchestrator 统一提交
+- 构建一律 `export PATH="$HOME/.local/node/bin:$PATH"`（Node 26）
+
+## 阶段一：实现
+
+- [x] T1 blocks 骨架（关于页块式页面构建器）
+  - claim: op-gitea
+  - boundary: src/content.config.ts（siteAbout 加 blocks: z.array(discriminatedUnion)）、新增 src/lib/page-blocks.ts（getAboutBlocks：过滤 enabled、未知 type 跳过+WARN、文本 pickBi 回落、块数≤24/单块≤4000 字）、新增 src/components/blocks/{BlockRenderer,Prose,Tracks,Divider}.astro、AboutPage.astro 改由 blocks 驱动（blocks 空→intro markdown→默认文案三级回落）、public/admin/config.yml 加 list+types（typeKey: type）
+  - verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && grep -q "discriminatedUnion" src/content.config.ts && grep -q "BlockRenderer" src/components/pages/AboutPage.astro && grep -q "typeKey" public/admin/config.yml`
+
+- [x] T2 块型扩充与图片管线
+  - claim: op-gitea
+  - boundary: 新增 src/components/blocks/{Cards,Timeline,Quote,Figure,LinkList,Cta}.astro + 图标键白名单（复用 SocialLinks 注册表或新建 icons 注册表）、schema 块型补全（图片字段用 image()，禁止外链字符串）、content/site/assets/ 目录、near docs 图表说明
+  - verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && ls src/components/blocks/ | grep -qC1 "Cards\|Timeline" && grep -q "image()" src/content.config.ts`
+
+- [x] T3 样式即数据（theme.yaml + 对比度闸门）
+  - claim: op-artalk
+  - boundary: 新增 content/site/theme.yaml（12 个白名单旋钮：prose-size/measure/radius/accent/leading 等）、新增 src/lib/theme.ts（getTheme + themeVarsCss 生成 :root:root{…}）、BaseLayout.astro head 内联 theme 变量（构建期静态）、新增 scripts/build-perf/contrast-check.mjs（断言 theme 结果下正文对比度 ≥4.5）、public/admin/config.yml 加 theme 单例、build.sh 守卫挂载
+  - verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && test -f content/site/theme.yaml && node scripts/build-perf/contrast-check.mjs dist`
+
+- [x] T4 首页细化与去重
+  - claim: op-artalk
+  - boundary: 新增 src/components/pages/HomePage.astro（承接现 index.astro 区块逻辑，locale prop）、src/pages/{index,en/index}.astro 改为薄壳、home.yaml 增 projectsLimit / announcement（markdown）/ postsTracks（轨开关细分），site-content 访问器同步
+  - verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && test -f src/components/pages/HomePage.astro && grep -q "HomePage" src/pages/en/index.astro`
+
+- [x] T5 开源页收尾（缓存/回落/告警）
+  - claim: worker-one
+  - boundary: src/lib/site-content.ts（README 缓存策略与超时、回落矩阵）、content/.github-readme.md 与 README HTML 剥离策略（复用 rehype-content-sanitize 已挡危险标签；补: 外链徽章不阻断）、src/data/projects-fallback.json 回填 5-8 条真实仓、projects.ts include 未命中 console.warn
+  - verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && python3 -c "import json;d=json.load(open('src/data/projects-fallback.json'));assert len(d)>=5"`
+
+- [x] T6 文档与后台 hint 补齐
+  - claim: worker-one
+  - boundary: docs/管理台.md（块编辑怎么用、增删排序、预览限制）、docs/写作指南.md（块字段表/受限类/主题项）、public/admin/config.yml 全字段中文 hint（含 T1-T4 新增字段）
+  - verify: `test -f docs/管理台.md && grep -q "blocks\|区块" docs/管理台.md && grep -c "hint" public/admin/config.yml | awk '$1>=20'`
+
+- [x] T7 字体子集化工具
+  - claim: orchestrator
+  - boundary: 新增 scripts/build-perf/subset-fonts.py（pyftsubset 按指定字体 + 页面实际用字生成子集 woff2 + 重写 fonts.css 指向子集文件）、infra/deploy/build.sh 守卫挂载、docs/写作指南加字流程补"子集化"一节
+  - verify: `test -f scripts/build-perf/subset-fonts.py && python3 -c "import fontTools; print('fonttools ok')" && E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS"`
@@ -1,9 +1,17 @@
-# 关于页正文（后台「页面文案 → 关于页」可改，markdown 编辑）
-# intro = 多段 markdown 正文，渲染在「关于」标题下方、名片之前；留空回落默认文案
-# 支持的语法：段落、列表、粗斜体、行内代码、链接（渲染走 Astro 的 markdown 管线）
-intro:
+# 关于页（后台「页面文案 → 关于页」可改）
+# ── 一级：blocks 块式正文（按顺序渲染，可拖拽排序；某块 enabled: false 即隐藏）
+# ── 二级：intro 多段 markdown（仅在 blocks 为空时使用）
+# ── 三级：内置默认文案（两者都空时兜底，构建永不炸）
+layout:
+  # 名片区（头像/名字/身份语/社交）开关：头像等数据事实源在「主页设置」
+  showIdCard: true
+
+blocks:
+  - type: prose
+    width: narrow
+    body:
      zh: |
-    写作者 · 读者 · 快门按压者，拥抱开源。
+        <span class="font-huiwen c-red">写作者</span> · 读者 · 快门按压者，拥抱开源。

        这里是我三条轨道的公开工作台：**读过的书**留下评注，**写过的代码**进项目墙，**按下的快门**收入图库。

@@ -15,7 +23,7 @@ intro:

        本站本身即开源，构建与发布全链都在仓里。
      en: |
-    Writer · Reader · Shutter-presser, embracing open source.
+        <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** I pressed that land in the gallery.

@@ -26,3 +34,57 @@ intro:
        - Images go to the gallery, with a bit of EXIF and one line of curation

        This site is itself open source — the full build and deploy pipeline lives in the repo.
+
+  - type: tracks
+    title:
+      zh: 兴趣版图
+      en: Interests
+    items:
+      - icon: book
+        name:
+          zh: 阅读
+          en: Reading
+        desc:
+          zh: 文学与戏剧为主，读到哪写到哪。
+          en: Mostly literature and drama; I write as I read.
+      - icon: terminal
+        name:
+          zh: 技术
+          en: Tech
+        desc:
+          zh: Linux、容器与自托管，把家里的小机器折腾成顺手的工具。
+          en: Linux, containers, and self-hosting — turning the little machines at home into handy tools.
+      - icon: camera
+        name:
+          zh: 摄影
+          en: Photography
+        desc:
+          zh: 街拍与山野，随身一台无反，在等光的间隙按快门。
+          en: Street and landscapes with a mirrorless camera, pressing the shutter while waiting for the light.
+
+  - type: prose
+    title:
+      zh: 本站如何构建
+      en: How this site is built
+    body:
+      zh: 页面由 Astro 静态生成，不含运行时框架 JS；内容住在自托管 gitea——本地编辑器与 gitea 网页写的是同一个 git 仓库，push 之后由 homelab 自动构建发布；评论走自托管 Artalk。页脚 built from 一行链到本次构建对应的 commit，构建过程透明可追溯。
+      en: Pages are statically generated by Astro with no runtime framework JS. Content lives on a self-hosted gitea — my local editor and the gitea web UI write to the same git repository, and each push is built and published automatically by the homelab. Comments run on self-hosted Artalk. The built-from line in the footer links to the commit behind this build, keeping the process transparent and traceable.
+
+# ---- 二级回退（blocks 为空时使用）----
+intro:
+  zh: |
+    写作者 · 读者 · 快门按压者，拥抱开源。
+
+    这里是我三条轨道的公开工作台：**读过的书**留下评注，**写过的代码**进项目墙，**按下的快门**收入图库。
+  en: |
+    Writer · 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** I pressed that land in the gallery.
+
+# 页面级排版覆盖（层 2）
+# 页面级排版覆盖（后台「关于页 → 页面排版覆盖」可改）：
+# 整页换字族会带来字体体积成本（如 font-huiwen 整页 ≈694KB），默认留空=全站默认排版
+# typography:
+#   font: font-huiwen   # 字族：font-serif/font-sans/font-kai/font-huiwen/font-kuaile…
+#   accent: c-red       # 强调色类：c-blue/c-red/…（外壳仍灰阶）
+#   scale: 1.05         # 字号缩放 0.8–1.25
@@ -0,0 +1,37 @@
+# 主题旋钮（样式即数据 · 层 4）：只放白名单内的 9 组旋钮。
+# 红线：--measure（版心）与断点/纸墨/code 配色不在此列——它们牵动版面结构与分轨身份。
+# 全部留空 = 沿用 src/styles/tokens.css 的既有值（零配置零变化）。
+# 钳制与单调性在 src/lib/theme.ts 里做：越界值被夹取而非报错，构建不会因主题配置失败。
+
+# ① 强调色（明/暗两值；构建期闸门校验正文对比度 ≥4.5，不达标回落默认）
+accent_light: '#3454d1'
+accent_dark: '#8ea2ff'
+
+# ② 图片圆角（4–16；08 文档裁定上限 14）
+radius_img: 10
+
+# ③ 标题字号（22–32；必须 h1 > h2 > h3，否则整体回落默认）
+text_h1: 27
+text_h2: 22
+text_h3: 19
+
+# ④ 正文字号（16–22）
+prose_size_reading: 20
+prose_size_tech: 19
+
+# ⑤ 正文行高（1.5–2.0）
+leading_reading: 1.75
+leading_tech: 1.7
+
+# ⑥ 间距梯度（8–80；必须严格递增 3 < 4 < 5 < 6，否则回落默认）
+space_3: 16
+space_4: 24
+space_5: 40
+space_6: 64
+
+# ⑦ 段落流距（0–2em）
+flow_p: 0.9
+flow_h2_post: 0.6
+
+# ⑧ 过渡时长（150–600ms）
+dur: 350
@@ -153,6 +153,18 @@ https://astro.build/

 体积账结论（2026-11-02 实测，本地无 gzip 的相对值）：**未使用某字体的页面，字体字节增量恒为 0**（构建期按页子集化 + unicode-range 按需拉取）。汇文采用文风开源的 cn-font-split 切片包（339 片），实测只拉用到字符的 19 片。

+**再裁一刀（按本站实际用字子集化）**：切片包本身粒度粗（一片含数百字），只做标题/短句的艺术字体往往只用到几十个字符。`scripts/build-perf/subset-fonts.py` 读字体 CSS 的 `@font-face`、收集内容里真实出现的字符、逐片求交集后用 `pyftsubset` 重写——实测汇文整页 **694KB → 420KB**（约 −40%）。命令：
+
+```bash
+python3 scripts/build-perf/subset-fonts.py \
+  --css node_modules/@fontsource/huiwen-mincho/index.css \
+  --out public/fonts/subset/huiwen \
+  --chars-from content/posts content/moments content/site/*.yaml
+# 可选：--chars-mode all|headings（只统计标题字）、--min-bytes 4096（小于该值的片不裁）
+```
+
+子集化产物输出到 `--out` 指定目录（如 `public/fonts/subset/`）；把它接进站点（构建链挂守卫 + 字体 CSS 指向子集）是独立一步，接线后随构建自动生成，未接线前需手动跑。**换字/加字后重跑一次**，否则新字会回落到下一个切片或系统字体。
+
 ### 候补字体清单（未落地，加一款约"一条命令 + 一次体积账"）

 | 字体 | 许可证 | 允许 webfont 嵌入 | 未落地原因 |
@@ -168,7 +180,7 @@ https://astro.build/
 | 阿里妈妈东方大楷 / 演示悠然小楷 | 免费商用 / 个人免费 | ⚠️ 需逐款核嵌入条款 | 无包；"个人免费"字体常禁 @font-face |
 | 霞鹜文楷 Light/Bright | OFL-1.1 | ✅ | 实测 **+8605KB**（CJK 切片粒度所致） |

-> 加新字体的流程：①核许可证与 **web 嵌入条款**（很多"个人免费"字体明文禁 @font-face，只能进系统回退）②npm 装或放入 `public/fonts/<family>/`（优选 cn-font-split 类切片包）③`global.css` 加类 + `rehype-class-whitelist` 放行 + `public/admin/typography-classes.js` 加一项 ④跑体积账，超 150KB/页 的要评估是否值得。
+> 加新字体的流程：①核许可证与 **web 嵌入条款**（很多"个人免费"字体明文禁 @font-face，只能进系统回退）②npm 装或放入 `public/fonts/<family>/`（优选 cn-font-split 类切片包）③`global.css` 加类 + `rehype-class-whitelist` 放行 + `public/admin/typography-classes.js` 加一项 ④跑体积账，超 150KB/页 的要评估是否值得；展示类字体再跑一次 `scripts/build-perf/subset-fonts.py` 按实际用字裁切（命令见上节）。

 ```markdown
 <span class="ink-muted">次要说明</span>
@@ -185,6 +197,60 @@ https://astro.build/
 后台编辑器里：**选中文字 → Insert 菜单 → 「排版（字体/颜色）」→ 面板里点一个类**，文字即被 `<span class="…">` 包住；点已套用的片段可改类，Backspace 可整体删除。
 面板里的两类与上表一一对应（字体 8 / 颜色 9），类清单单一事实源在 `public/admin/typography-classes.js`。

+## 三层排版架构（全站，不只文章正文）
+
+**层 1 · 页面文案富文本**：后台「页面文案」里的 tagline / subtitle / blurb / blurb_after / intro / 关于页 blocks 的 prose 块，全部走同一条富文本管线（markdown + raw + 内容净化 + class 白名单 + 链接卡片）。可以直接写：
+
+```yaml
+tagline:
+  zh: '<span class="font-kai c-blue">写作者</span> · 读者 · 快门按压者，拥抱开源。'
+```
+
+渲染入口唯一：`src/lib/site-content.ts` 的 `renderRich()`（行内场景传 `{ inline: true }` 自动剥外层 `<p>`，否则 `<p>` 套 `<p>` 会被浏览器拆散）。
+**不开放**：导航/页脚/按钮等硬编码界面外壳——那是 UI 不是内容。
+
+**层 2 · 页面级排版覆盖**：每个页面单例（`content/site/*.yaml`）可加：
+
+```yaml
+typography:
+  font: font-kai        # 本页正文默认字体类（可选）
+  accent: c-blue        # 本页强调色类（可选）
+  scale: 1.1            # 字号缩放 0.8–1.25（可选）
+```
+
+实现是在该页内容容器上挂 `.page-typo` + CSS 变量（`--page-font / --page-accent / --page-scale`），**不写全站 tokens**——其它页面零影响（已在图库/书架/文章/装备页验证隔离）。白名单外的类名会被忽略。
+后台入口：「页面文案 → 各自页面 → 页面排版覆盖」。
+
+**层 3 · 艺术字体**：`font-art-kuaile`（站酷快乐体，艺术字专用类）。⚠️ **仅用于标题/短句**：艺术字字形大，CJK 切片体积高（实测用到页 +163KB），长段使用会显著抬高单页字体成本。
+
+## 页面块（关于页 blocks，字段速查）
+
+关于页正文可由九个块拼成（后台拖拽排序，每块有「显示」开关）。完整操作见 [管理台](./管理台.md)；这里是写内容时对照的字段表——文本字段一律 `{zh, en}`。
+
+| 块型 | 必填 | 可选 | 一句话 |
+|---|---|---|---|
+| `prose` | `body` | `title`、`width`（narrow/full） | markdown 长文 |
+| `tracks` | `title`、`items[].name` | `items[].icon`、`items[].desc` | 主线/能力面 |
+| `cards` | `items[].title` | `title`、`columns`(2/3)、`items[].desc/href/tag` | 并列卡片墙 |
+| `timeline` | `items[].time`、`items[].title` | `title`、`items[].desc` | 时间线（时间可自由文本） |
+| `quote` | `text` | `cite` | 单句引文 |
+| `figure` | `image` | `alt`、`caption` | 单图（必须上传，禁外链） |
+| `linklist` | `items[].label`、`items[].href` | `title`、`items[].note` | 链接清单 |
+| `cta` | `text`、`href`、`label` | — | 行动按钮 |
+| `divider` | — | `style`（line/space） | 分隔 |
+
+```yaml
+blocks:
+  - type: prose
+    body: { zh: 正文 markdown，可含排版类 span, en: Body markdown }
+  - type: cards
+    columns: 3
+    items:
+      - { title: { zh: 写作, en: Writing }, desc: { zh: 书评与技术文, en: Reviews & tech } }
+```
+
+边界：块数 ≤24、单块文本 ≤4000 字（超限截断并 WARN）；未知块型跳过 + WARN；`blocks` 为空时回落 `intro` markdown，再空回落内置文案。图片字段走 `image()`，只能后台上传进 `content/site/assets/`。
+
 ## 发布提醒

 - push main → webhook 自动构建发布（约 10 秒）
@@ -277,6 +343,9 @@ markdown 原生语法，无需任何配置：
 | `latestPhotos` | 0-6 | 4 | 「最新影像」张数；**0 = 隐藏该区块** |
 | `perTrackLimit` | 4-8 | 6 | 首页阅读/技术两轨各显示条数 |
 | `sections` | `{tracks, photos, heatmap, projects}` 布尔 | 全开 | 区块开关，关掉即不渲染 |
+| `projectsLimit` | 1-99 | 6 | 首页项目墙条数（越界夹取） |
+| `announcement` | `{zh, en}`（markdown 富文本） | 空 | 名片区下方公告；空 = 不渲染 |
+| `postsTracks` | `{reading, tech, photo}` 布尔 | 全开 | 关掉某轨则该轨文章不在首页列出（归档页仍可见） |

 越界值会被夹取（如 perTrackLimit=20 按 8 处理），不报错；**全部留空 = 现有形态不变**。

@@ -1,17 +1,148 @@
 # 管理台（Sveltia CMS）使用指南

 > 地址：`https://wait4x.online/admin/`（页脚「管理」入口）｜ 用途：照片上传与 sidecar 编辑的图形界面 ｜ 保存即 commit 到 main → webhook 自动构建发布（约 10 秒上线）
+>
+> 这份是**操作手册**：每个入口能改什么、字段怎么填、改完会发生什么。写文章正文的排版技巧见 [写作指南](./写作指南.md)——两份分工：这里讲"后台怎么用"，那里讲"正文怎么写"。

 ## 登录

 选 **Sign In with Token** → 用 gitea 的 access token（宿主 `~/docker_apps/gitea/init-templates.txt` 里的 api-token，或 gitea 网页新建 scope=read/write:repository）。token 存浏览器 localStorage，下次免登。

+## 四类内容集合
+
+| 入口 | 文件位置 | 用来放什么 | 关键约束 |
+|---|---|---|---|
+| 文章 | `content/posts/<slug>.md` | 书评 / 技术文 / 摄影札记三轨 | `category` 三选一（`reading` / `tech` / `photo`），首页分轨由它派生 |
+| 瞬间 | `content/moments/*.md` | 一句话 + 一张图的时间线 | `text` 与 `image` **至少填一项**（后台无法表达条件必填，保存前自查） |
+| 照片 | `content/photos/*.json` + 图 | 图库（街拍 / 风景两组） | 标题**必填**（空标题会让构建炸，实测坑）；EXIF 由构建期 loader 自动补全 |
+| 站点页面 | `content/site/*.yaml` | 首页、关于页、开源页、主题 | 后台改的是**单例文件**，没有"新建" |
+
+几条通用规则：
+
+- **双语字段成对出现**：中文 / 英文两个输入框。英文留空不是错误——构建期回落中文并在日志里打 WARN（`[blocks] 缺译…`），页面不会破版。
+- **留空 = 用默认**：任何字段清空都回到仓库自带的默认文案 / 默认值，构建永远成功。想让某段彻底消失，请看字段自带的"留空则不渲染"提示。
+- **文章英文版**：不在后台写。跑 `python3 scripts/translate/translate_posts.py` 生成 `content/posts-en/` 同名文件；手写润色过的译文在 frontmatter 写 `locked: true`，翻译脚本会无条件跳过它。
+- **保存即提交**：后台保存等于向仓库提交，push 后约 10 秒自动构建上线。
+
 ## 照片上传流

 1. 图库照片 → New Entry：填标题（**必填**，空标题会让构建炸——实测坑）、选分组（street/landscape）、可写 alt
 2. 图片字段 → 资产库上传 jpg（与 sidecar 同目录落位，零重压缩）
 3. Save → 自动 commit + 构建 → 画廊出现（EXIF 构建期自动提取，exif 字段留空即可）

+## 块编辑：关于页的块式页面构建器
+
+关于页（`content/site/about.yaml`）的正文由 **blocks 列表**构成，后台里是一串可拖拽排序的卡片。每个块都有「显示」开关；关掉只是不渲染，块本身留在数据里。
+
+两条渲染纪律：
+
+- 列表为空（或全关）时，页面回落到 `intro` 字段的 markdown 正文；`intro` 也空则用内置默认文案。三级回落，任何一级为空都不会出白页。
+- 未知块型（手工编辑 yaml 写错的 `type`）会被**跳过并打印 `[blocks]` 警告**，不会炸构建；块数上限 24，单块文本上限 4000 字，超限截断并 WARN。
+
+九类块与字段（文本字段一律 `{zh, en}` 双语对象）：
+
+| 块型 | 必填 | 可选 | 用途 |
+|---|---|---|---|
+| `prose` 正文 | `body` | `title`、`width`（`narrow` 版心 / `full` 通栏） | markdown 长文，最常用 |
+| `tracks` 版图 | `title`、`items[].name` | `items[].icon`、`items[].desc` | 几条主线 / 能力面，图标白名单外或留空显示首字占位 |
+| `cards` 卡片墙 | `items[].title` | `title`、`columns`（2 或 3，默认 3）、`items[].desc/href/tag` | 并列展示若干条目 |
+| `timeline` 时间线 | `items[].time`、`items[].title` | `title`、`items[].desc` | 时间列是自由文本（`2024 — 2026` 也行） |
+| `quote` 引文 | `text` | `cite` | 单句金句，配 `font-kai` 更出效果 |
+| `figure` 图片 | `image` | `alt`、`caption` | **只能后台上传**（落 `content/site/assets/`，走图片管线），禁止外链 |
+| `linklist` 链接清单 | `items[].label`、`items[].href` | `title`、`items[].note` | 相关阅读 / 外部资源 |
+| `cta` 行动按钮 | `text`、`href`、`label` | — | 一页建议不超过一个 |
+| `divider` 分隔 | — | `style`（`line` 细线 / `space` 纯留白） | 长页分段 |
+
+yaml 形态示例（手工编辑时照此写）：
+
+```yaml
+blocks:
+  - type: prose
+    title: { zh: 关于这个站点, en: About this site }
+    body:
+      zh: 这里写 markdown 正文，支持列表、粗斜体、链接与排版类。
+      en: Markdown body here.
+    width: narrow
+  - type: quote
+    text: { zh: 所谓暮色，就是光慢慢地承认自己要走。, en: Dusk is light admitting it has to go. }
+    cite: { zh: 本站, en: this site }
+  - type: figure
+    image: ./assets/desk.jpg   # 后台会替你写成这个相对路径
+    caption: { zh: 工作台一角, en: A corner of the desk }
+```
+
+其它可用字段：`layout.showIdCard`（关掉则不渲染名片区，默认开）、`typography`（见下一节）。
+
+**预览限制**：后台只提供字段编辑与列表摘要（摘要显示块型名），块的真实排版以下次构建后的页面为准——想调间距 / 字号，请用「主题设置」而不是在块里硬凑空行。
+
+## 页面排版覆盖（每页一处）
+
+首页 / 关于页 / 开源页各自有一个「页面排版覆盖（可选）」对象：
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `font` | 字族下拉（10 项） | 本页**正文**默认字体类 |
+| `accent` | 颜色下拉（18 项） | 本页强调色类 |
+| `scale` | 0.8–1.25 | 字号缩放，1 = 全站默认 |
+
+- 只作用于**该页内容容器**（挂 `.page-typo` + CSS 变量），不写全站 tokens，其它页面零影响。
+- **体积成本提醒**：整页换艺术/展示字族（`font-huiwen` 汇文、`font-kuaile` 快乐体）意味着整页正文都要下载对应切片——单页字体成本会明显抬升，见写作指南的体积账。
+- 白名单外的类名会被忽略（构建期过滤），写错不报错、也不生效。
+
+## 主题设置（全站 17 个旋钮）
+
+「主题设置」入口写 `content/site/theme.yaml`，17 项全部可选，留空 = 仓库默认值。**配错不会炸站**：越界值回落默认，组内单调性被破坏则整组回落。
+
+| 组 | 字段 | 范围 | 约束语义 |
+|---|---|---|---|
+| 强调色 | `accent_light` / `accent_dark` | `#rrggbb` | 明暗各一份；构建期对比度闸门断言正文 ≥4.5:1，不达标构建失败 |
+| 圆角 | `radius_img` | 4–16 | 图片圆角，建议 ≤14 |
+| 标题字号 | `text_h1` / `text_h2` / `text_h3` | h1/h2：22–32，h3：16–32 | **必须严格递减**（h1 > h2 > h3），否则三档一起回落默认 |
+| 正文字号 | `prose_size_reading` / `prose_size_tech` | 16–22 | 书评 / 技术文分轨独立 |
+| 行高 | `leading_reading` / `leading_tech` | 1.5–2.0 | 同上分轨 |
+| 间距梯度 | `space_3` / `space_4` / `space_5` / `space_6` | 8–80 | **必须严格递增**，否则整组回落 |
+| 流距 | `flow_p` / `flow_h2_post` | 0–2（em） | 段间距 / 标题下间距 |
+| 动效 | `dur` | 150–600（ms） | 过渡时长；`prefers-reduced-motion` 下自动归零 |
+
+不能配的东西（有意为止）：版心宽度、断点、纸墨色、代码配色——它们牵动版面结构与分轨身份，属于设计红线。注入方式是构建期内联 `:root:root{…}`，运行时零 JS、零请求。
+
+## 首页与开源页的其余旋钮
+
+### 首页三字段（5g 新增）
+
+| 字段 | 取值 | 默认 | 作用 |
+|---|---|---|---|
+| `projectsLimit` | 1–99 | 6 | 首页项目墙条数（越界夹取） |
+| `announcement` | `{zh, en}` markdown | 空 | 名片区下方公告；**空 = 不渲染**，走富文本管线（可写排版类 span） |
+| `postsTracks` | `{reading, tech, photo}` 布尔 | 全开 | 关掉某轨，该轨文章不在首页列出（归档页仍可见） |
+
+### 开源页（opensource.yaml）
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `pinned` | 仓短名数组 | 置顶顺序即展示顺序 |
+| `mode` | `all` / `only` / `exclude` | 可见性模式 |
+| `include` / `exclude` | 仓短名数组 | 对应模式的白 / 黑名单 |
+| `sort` | `pinned-first` / `stars` / `updated` | 排序 |
+| `perSource` | `both` / `github` / `gitea` | 来源过滤 |
+| `intro_from` | `"off"` / `"github-readme"` | 开篇文案来源（**带引号写**，YAML 1.1 里裸 `off` 是布尔 false） |
+
+**`mode: only` 的"看不见"排查**：构建日志会给每个没显示出来的 include 项打一行 `[opensource] projects：include 里的「X」…`，并区分两种原因——双源结果里根本没有这个仓（拼写 / 私有仓 / 该源刚失败），或者命中了但被 `perSource` 过滤掉。看到哪一行就知道该改什么。
+
+**README 开篇（`intro_from: "github-readme"`）的回落矩阵**，构建日志逐级点名：
+
+1. 取到 → 内容有变化才刷新缓存 `content/.github-readme.md`（入仓，保证构建确定性）
+2. token 缺位 / HTTP 非 2xx / 内容为空 / 超时（10 秒）/ 网络异常 → 改用缓存（日志标注"可能陈旧"）
+3. 缓存也不在 → 回落本文件 `blurb` 的叙述文案
+4. 缓存回写失败（构建仓只读挂载等）→ 只告警，本次渲染照常
+
+token 位在 `~/docker_apps/blog/github-token.txt`（本机，0600）。
+
+**两条已知限制**：
+
+- **README 里的相对链接不重写**（如 `./img/x.png`、`docs/foo.md`）：它们相对 GitHub 仓根解析，在本站没有对应产物，点了多半 404。保原样比猜一个基址可信，所以不做改写。
+- **外部徽章图片加固但不参与构建**：shields.io、readme-typing-svg 这类第三方徽章在构建期**不抓取**，渲染时统一补 `loading="lazy"`（缺 alt 补空），它们慢、被墙或 404 都不影响页面渲染；尺寸已由样式限制在内容宽度内。
+
 ## 纪律（与写作指南同源）

 - **图片体积**：上传前自行压缩（长边 ≤2400px）——Sveltia 内建优化**刻意关闭**（会抹 EXIF 断构建期提取管线）
@@ -33,6 +33,8 @@ pnpm astro build
 # 按页字体 CSS 子集化（车道 A 任务 1）：裁 @font-face 声明数，构建仓与本地同链；
 # 存在性守卫：新文件未推送到 main 前构建仓无此脚本，绝不让发布链因车道在途文件断掉
 [ -f scripts/build-perf/subset-font-css.mjs ] && node scripts/build-perf/subset-font-css.mjs dist || echo "[build] subset 脚本未就绪，跳过"
+[ -f scripts/build-perf/config-check.py ] && python3 scripts/build-perf/config-check.py || echo "[build] config-check 未就绪，跳过"
+[ -f scripts/build-perf/contrast-check.mjs ] && node scripts/build-perf/contrast-check.mjs dist || echo "[build] contrast 脚本未就绪，跳过"
 # 首页阻塞 CSS 内联（车道 D）：守卫先行同上——脚本未到 main 前绝不炸链
 [ -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 脚本未就绪，跳过"
@@ -58,6 +58,29 @@ collections:
      - { label: 草稿, name: draft, widget: boolean, required: false, default: false }
      - { label: 正文, name: body, widget: markdown }

+  # 主题旋钮（样式即数据 · 层 4）：只放白名单内的 9 组，越界值会被构建期钳制
+  - name: site_theme
+    label: 主题设置
+    file: content/site/theme.yaml
+    fields:
+      - { label: 强调色（亮）, name: accent_light, widget: color, required: false, hint: '亮色模式强调色，如 #3454d1；构建期校验正文对比度 ≥4.5' }
+      - { label: 强调色（暗）, name: accent_dark, widget: color, required: false, hint: '暗色模式强调色，如 #8ea2ff' }
+      - { label: 图片圆角, name: radius_img, widget: number, required: false, value_type: int, min: 4, max: 16, hint: '范围 4–16（建议 ≤14）' }
+      - { label: 一级标题字号, name: text_h1, widget: number, required: false, value_type: int, min: 22, max: 32, hint: '22–32，且必须大于 h2' }
+      - { label: 二级标题字号, name: text_h2, widget: number, required: false, value_type: int, min: 22, max: 32, hint: '22–32，必须小于 h1、大于 h3' }
+      - { label: 三级标题字号, name: text_h3, widget: number, required: false, value_type: int, min: 16, max: 32, hint: '16–32，必须小于 h2' }
+      - { label: 书评正文字号, name: prose_size_reading, widget: number, required: false, value_type: int, min: 16, max: 22, hint: '16–22' }
+      - { label: 技术文正文字号, name: prose_size_tech, widget: number, required: false, value_type: int, min: 16, max: 22, hint: '16–22' }
+      - { label: 书评行高, name: leading_reading, widget: number, required: false, value_type: float, min: 1.5, max: 2.0, step: 0.05, hint: '1.5–2.0' }
+      - { label: 技术文行高, name: leading_tech, widget: number, required: false, value_type: float, min: 1.5, max: 2.0, step: 0.05, hint: '1.5–2.0' }
+      - { label: 间距 3, name: space_3, widget: number, required: false, value_type: int, min: 8, max: 80, hint: '8–80，必须 < 间距 4' }
+      - { label: 间距 4, name: space_4, widget: number, required: false, value_type: int, min: 8, max: 80, hint: '8–80，必须 > 间距 3 且 < 间距 5' }
+      - { label: 间距 5, name: space_5, widget: number, required: false, value_type: int, min: 8, max: 80, hint: '8–80，必须 > 间距 4 且 < 间距 6' }
+      - { label: 间距 6, name: space_6, widget: number, required: false, value_type: int, min: 8, max: 80, hint: '8–80，必须 > 间距 5' }
+      - { label: 段间距, name: flow_p, widget: number, required: false, value_type: float, min: 0, max: 2, step: 0.05, hint: '0–2（em）' }
+      - { label: 标题下间距, name: flow_h2_post, widget: number, required: false, value_type: float, min: 0, max: 2, step: 0.05, hint: '0–2（em）' }
+      - { label: 过渡时长, name: dur, widget: number, required: false, value_type: int, min: 150, max: 600, hint: '150–600（毫秒）' }
+
  # 瞬间：随手发（text/image 至少其一——Sveltia 无法表达条件必填，两者都设可选，
  # 保存前自查；pubDate 必填）。图片走图库媒体库（content/photos 同源可复用）
  - name: moments
@@ -120,9 +143,47 @@ collections:
          - label: 身份语
            name: tagline
            widget: object
+            required: false
+            hint: 首页大字身份语（双语，markdown 富文本）；可写 <span class="font-kai c-blue">…</span> 做局部强调
            fields:
              - { label: 中文, name: zh, widget: string, required: false }
              - { label: 英文, name: en, widget: string, required: false }
+          - label: 页面排版覆盖（可选）
+            name: typography
+            widget: object
+            required: false
+            hint: 本页正文默认字体 / 强调色 / 字号缩放（0.8–1.25）；不填用全站默认，只影响本页
+            fields:
+              - label: 正文字体类
+                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]
+              - label: 强调色类
+                name: accent
+                widget: select
+                required: false
+                options: [ink-accent, ink-accent-soft, c-blue, c-blue-soft, c-teal, c-teal-soft, c-green, c-green-soft, c-yellow, c-yellow-soft, c-orange, c-orange-soft, c-red, c-red-soft, c-pink, c-pink-soft, c-purple, c-purple-soft]
+              - { label: 字号缩放, name: scale, widget: number, required: false, value_type: float, min: 0.8, max: 1.25, step: 0.05, hint: '0.8–1.25；1 = 全站默认' }
+          - label: 公告（可选，markdown）
+            name: announcement
+            widget: object
+            required: false
+            hint: 渲染在名片区下方；留空则不显示公告块
+            fields:
+              - { label: 中文, name: zh, widget: markdown, required: false }
+              - { label: 英文, name: en, widget: markdown, required: false }
+          - { label: 项目墙条数, name: projectsLimit, widget: number, required: false, value_type: int, min: 1, max: 99, hint: '首页项目墙显示几条（1–99，缺省 6）' }
+          - label: 轨细分开关（首页文章列表）
+            name: postsTracks
+            widget: object
+            required: false
+            hint: 关掉某轨则该轨文章不在首页列出（全开=现状）
+            fields:
+              - { label: 阅读轨, name: reading, widget: boolean, required: false, default: true }
+              - { label: 技术轨, name: tech, widget: boolean, required: false, default: true }
+              - { label: 照片轨, name: photo, widget: boolean, required: false, default: true }
          - label: 副标题（可选，markdown 短文本）
            name: subtitle
            widget: object
@@ -183,14 +244,280 @@ collections:
      - name: about
        label: 关于页
        file: content/site/about.yaml
+        # 块内图片上传落 content/site/assets/，yaml 写 ./assets/xxx（Astro 图片管线）
+        media_folder: content/site/assets
+        public_folder: ./assets
        fields:
-          - label: 正文（markdown，多段）
-            name: intro
+          - label: 页面块（拖拽排序；每块可折叠）
+            name: blocks
+            widget: list
+            typeKey: type
+            required: false
+            summary: '{{fields.type}}'
+            hint: '点「+ 添加」选块型。关掉某块用该块内的「显示」开关'
+            types:
+              - label: 正文（markdown）
+                name: prose
+                widget: object
+                hint: markdown 正文块；可选小标题与版心/通栏宽度，长文分段改内容用
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 小标题（可选）
+                    name: title
+                    widget: object
+                    required: false
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+                  - label: 正文（markdown）
+                    name: body
                    widget: object
-            hint: 渲染在「关于」标题下方、名片之上；支持段落/列表/粗斜体/链接；留空用默认文案
                    fields:
                      - { label: 中文, name: zh, widget: markdown, required: false }
                      - { label: 英文, name: en, widget: markdown, required: false }
+                  - label: 宽度
+                    name: width
+                    widget: select
+                    required: false
+                    default: narrow
+                    options: [{ label: 版心宽度, value: narrow }, { label: 通栏, value: full }]
+              - label: 版图（图标+名称+描述）
+                name: tracks
+                widget: object
+                hint: 版图块：图标 + 名称 + 描述，适合「几条主线/能力面」式介绍
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 标题
+                    name: title
+                    widget: object
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+                  - label: 条目
+                    name: items
+                    widget: list
+                    summary: '{{fields.name.zh}}'
+                    fields:
+                      - label: 图标
+                        name: icon
+                        widget: select
+                        required: false
+                        options: [book, terminal, camera, code, git, rss, email, github, bilibili, x, star, link]
+                        hint: 白名单外或留空 → 显示首字占位
+                      - label: 名称
+                        name: name
+                        widget: object
+                        fields:
+                          - { label: 中文, name: zh, widget: string, required: false }
+                          - { label: 英文, name: en, widget: string, required: false }
+                      - label: 描述
+                        name: desc
+                        widget: object
+                        required: false
+                        fields:
+                          - { label: 中文, name: zh, widget: text, required: false }
+                          - { label: 英文, name: en, widget: text, required: false }
+              - label: 卡片（2/3 列）
+                name: cards
+                widget: object
+                hint: 卡片墙（2/3 列）：每卡 = 标题 + 描述 + 可选链接/角标
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 标题（可选）
+                    name: title
+                    widget: object
+                    required: false
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+                  - { label: 列数, name: columns, widget: number, required: false, default: 3, min: 2, max: 3, value_type: int }
+                  - label: 卡片条目
+                    name: items
+                    widget: list
+                    summary: '{{fields.title.zh}}'
+                    fields:
+                      - label: 标题
+                        name: title
+                        widget: object
+                        fields:
+                          - { label: 中文, name: zh, widget: string, required: false }
+                          - { label: 英文, name: en, widget: string, required: false }
+                      - label: 描述
+                        name: desc
+                        widget: object
+                        required: false
+                        fields:
+                          - { label: 中文, name: zh, widget: text, required: false }
+                          - { label: 英文, name: en, widget: text, required: false }
+                      - { label: 链接（可选）, name: href, widget: string, required: false }
+                      - label: 角标（可选）
+                        name: tag
+                        widget: object
+                        required: false
+                        fields:
+                          - { label: 中文, name: zh, widget: string, required: false }
+                          - { label: 英文, name: en, widget: string, required: false }
+              - label: 时间线
+                name: timeline
+                widget: object
+                hint: 时间线：一条时间 + 标题 + 描述；时间可写自由文本（如 2024 — 2026）
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 标题（可选）
+                    name: title
+                    widget: object
+                    required: false
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+                  - label: 条目
+                    name: items
+                    widget: list
+                    summary: '{{fields.time}} · {{fields.title.zh}}'
+                    fields:
+                      - { label: 时间, name: time, widget: string, hint: '自由文本，如 2024 — 2026' }
+                      - label: 标题
+                        name: title
+                        widget: object
+                        fields:
+                          - { label: 中文, name: zh, widget: string, required: false }
+                          - { label: 英文, name: en, widget: string, required: false }
+                      - label: 描述（可选）
+                        name: desc
+                        widget: object
+                        required: false
+                        fields:
+                          - { label: 中文, name: zh, widget: text, required: false }
+                          - { label: 英文, name: en, widget: text, required: false }
+              - label: 引文
+                name: quote
+                widget: object
+                hint: 单句引文 + 可选署名；配 font-kai 排版效果更好
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 引文
+                    name: text
+                    widget: object
+                    fields:
+                      - { label: 中文, name: zh, widget: text, required: false }
+                      - { label: 英文, name: en, widget: text, required: false }
+                  - label: 出处（可选）
+                    name: cite
+                    widget: object
+                    required: false
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+              - label: 图片
+                name: figure
+                widget: object
+                hint: 单图 + 可选说明；图片只能后台上传（落 content/site/assets），禁外链
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - { label: 图片（必填，请用后台上传）, name: image, widget: image, hint: '禁止填外链：只能上传（落 content/site/assets/），走 Astro 图片管线' }
+                  - { label: 替代文本（无障碍）, name: alt, widget: string, required: false }
+                  - label: 图注（可选）
+                    name: caption
+                    widget: object
+                    required: false
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+              - label: 链接清单
+                name: linklist
+                widget: object
+                hint: 链接清单（标签 + 链接 + 备注），适合「相关阅读 / 外部资源」
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 标题（可选）
+                    name: title
+                    widget: object
+                    required: false
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+                  - label: 链接条目
+                    name: items
+                    widget: list
+                    summary: '{{fields.label.zh}} → {{fields.href}}'
+                    fields:
+                      - label: 名称
+                        name: label
+                        widget: object
+                        fields:
+                          - { label: 中文, name: zh, widget: string, required: false }
+                          - { label: 英文, name: en, widget: string, required: false }
+                      - { label: 链接, name: href, widget: string }
+                      - label: 备注（可选）
+                        name: note
+                        widget: object
+                        required: false
+                        fields:
+                          - { label: 中文, name: zh, widget: string, required: false }
+                          - { label: 英文, name: en, widget: string, required: false }
+              - label: 行动按钮
+                name: cta
+                widget: object
+                hint: 行动按钮（文案 + 链接 + 按钮字）；一页建议不超过一个
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 说明文字
+                    name: text
+                    widget: object
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+                  - { label: 按钮链接, name: href, widget: string }
+                  - label: 按钮文字
+                    name: label
+                    widget: object
+                    fields:
+                      - { label: 中文, name: zh, widget: string, required: false }
+                      - { label: 英文, name: en, widget: string, required: false }
+              - label: 分隔
+                name: divider
+                widget: object
+                hint: 分隔块：细分隔线或纯留白，给长页分段
+                fields:
+                  - { label: 显示, name: enabled, widget: boolean, required: false, default: true }
+                  - label: 样式
+                    name: style
+                    widget: select
+                    required: false
+                    default: line
+                    options: [{ label: 细分隔线, value: line }, { label: 纯留白, value: space }]
+          - label: 名片区开关
+            name: layout
+            widget: object
+            required: false
+            hint: 关掉则不显示头像/名字/社交（它们的数据在「主页设置」）
+            fields:
+              - { label: 显示名片区, name: showIdCard, widget: boolean, required: false, default: true }
+          - label: 正文回退（blocks 为空时用，markdown，多段）
+            name: intro
+            widget: object
+            required: false
+            hint: 仅在「页面块」为空时渲染；与块同时存在时以块为准
+            fields:
+              - { label: 中文, name: zh, widget: markdown, required: false }
+              - { label: 英文, name: en, widget: markdown, required: false }
+          - label: 页面排版覆盖（可选）
+            name: typography
+            widget: object
+            required: false
+            hint: 本页正文默认字体 / 强调色 / 字号缩放（0.8–1.25）；不填用全站默认，只影响本页
+            fields:
+              - label: 正文字体类
+                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]
+              - label: 强调色类
+                name: accent
+                widget: select
+                required: false
+                options: [ink-accent, ink-accent-soft, c-blue, c-blue-soft, c-teal, c-teal-soft, c-green, c-green-soft, c-yellow, c-yellow-soft, c-orange, c-orange-soft, c-red, c-red-soft, c-pink, c-pink-soft, c-purple, c-purple-soft]
+              - { label: 字号缩放, name: scale, widget: number, required: false, value_type: float, min: 0.8, max: 1.25, step: 0.05 }
      - name: opensource
        label: 开源页
        file: content/site/opensource.yaml
@@ -198,9 +525,29 @@ collections:
          - label: 叙述（链接前）
            name: blurb
            widget: object
+            required: false
+            hint: 富文本（markdown + 排版类），渲染在仓库链接之前
            fields:
              - { label: 中文, name: zh, widget: string, required: false }
              - { label: 英文, name: en, widget: string, required: false }
+          - label: 页面排版覆盖（可选）
+            name: typography
+            widget: object
+            required: false
+            hint: 本页正文默认字体 / 强调色 / 字号缩放（0.8–1.25）；不填用全站默认，只影响本页
+            fields:
+              - label: 正文字体类
+                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]
+              - label: 强调色类
+                name: accent
+                widget: select
+                required: false
+                options: [ink-accent, ink-accent-soft, c-blue, c-blue-soft, c-teal, c-teal-soft, c-green, c-green-soft, c-yellow, c-yellow-soft, c-orange, c-orange-soft, c-red, c-red-soft, c-pink, c-pink-soft, c-purple, c-purple-soft]
+              - { label: 字号缩放, name: scale, widget: number, required: false, value_type: float, min: 0.8, max: 1.25, step: 0.05, hint: '0.8–1.25；1 = 全站默认' }
          - { label: 仓库链接地址, name: repo_url, widget: string, required: false }
          - { label: 仓库链接文字, name: repo_label, widget: string, required: false }
          - label: 叙述（链接后）
@@ -18,6 +18,7 @@ window.TYPOGRAPHY_CLASSES = {
    { cls: 'font-fangsong', label: '仿宋族', family: 'FangSong, STFangsong, serif', kind: '系统回退' },
    { 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: '艺术字' },
  ],
  color: [
    { cls: 'ink-1', label: '最重（标题级）', swatch: '#111113' },