fix(moments): 评论流键从 #<slug> 改为虚拟路径，避免键被截断

实测发现 `#` 在查询串里是 fragment 分隔符：裸传 `/moments/#2026-11-02` 会被服务端截断成页面级键 `/moments/`（生产 Artalk 实测，响应里 key 变成 "/moments/"），后果是所有瞬间共用同一个评论流、pv 也串在一起。 - page_key 改为虚拟路径 `/moments/<slug>/`（生产实测键原样保留，零转义风险；将来真做单条瞬间页时键天然对齐） - spec 与 runs.jsonl 口径同步（七项 verify 在新指纹下重跑全绿）验证: 构建 51 页 exit 0；产物含 /moments/2026-11-02/ 键；content-lint 0/0/0； spec_verify 七项 exit=0；check 收敛 Spec: 2026-11-02_blog-5h-content-social (T3 修正) Co-authored-by: GLM-5.3
chore(spec): 5h 任务全勾与运行证据入库
2026-11-02 21:05:51 +08:00 · 2026-11-02 21:01:47 +08:00 · 2026-11-02 20:56:00 +08:00 · 2026-11-02 20:37:01 +08:00 · 2026-11-02 20:35:56 +08:00 · 2026-11-02 20:29:44 +08:00
515 changed files with 5763 additions and 514 deletions
@@ -0,0 +1,14 @@
+{"task": "task_0001", "cmd": "E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\" && grep -q \"pinned\" src/content.config.ts && grep -q \"pinned\" src/components/PostList.astro && grep -q \"pinned\" public/admin/config.yml", "exit": 0, "duration_s": 21.239, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T12:58:45+00:00"}
+{"task": "task_0002", "cmd": "E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\" && grep -qE \"renderRich|renderMarkdown\" src/components/pages/MomentsPage.astro && python3 -c \"import yaml;d=yaml.safe_load(open('public/admin/config.yml'));m=[c for c in d['collections'] if c['name']=='moments'][0];t=[f for f in m['fields'] if f['name']=='text'][0];assert t['widget']=='markdown',t\"", "exit": 0, "duration_s": 21.893, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T12:59:07+00:00"}
+{"task": "task_0003", "cmd": "test -f src/components/MomentComments.astro && grep -q \"MomentComments\" src/components/pages/MomentsPage.astro && grep -q \"moments/#\" src/components/MomentComments.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": 21.073, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T12:59:28+00:00"}
+{"task": "task_0004", "cmd": "test -f src/components/geek/ViewMeta.astro && grep -q \"ViewMeta\" src/components/ArtalkComments.astro && grep -q \"ViewMeta\" src/pages/archives/[...slug].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": 23.015, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T12:59:51+00:00"}
+{"task": "task_0005", "cmd": "grep -q \"GithubProfile\" src/pages/opensource.astro && python3 -c \"import re,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','github-readme-activity-graph'] if u in p];assert not bad,bad\"", "exit": 0, "duration_s": 0.03, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T12:59:52+00:00"}
+{"task": "task_0006", "cmd": "python3 -c \"import yaml;d=yaml.safe_load(open('content/site/about.yaml'));types=[b['type'] for b in d.get('blocks') or []];assert 'prose' in types and ('linklist' in types or 'cards' in types),types\" && 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": 21.067, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T13:00:13+00:00"}
+{"task": "task_0007", "cmd": "test -f content/posts/writing-template.md && test -f content/posts-en/writing-template.md && grep -q \"pinned: true\" content/posts/writing-template.md && grep -qE \"font-kai|c-blue\" content/posts/writing-template.md && grep -q \"写作模板\" docs/写作指南.md", "exit": 0, "duration_s": 0.005, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "a4c5572a52c4f546900c03b86c7cfd32056ad32ec27194018ffc175ac700f3c5", "at": "2026-11-02T13:00:13+00:00"}
+{"task": "task_0001", "cmd": "E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\" && grep -q \"pinned\" src/content.config.ts && grep -q \"pinned\" src/components/PostList.astro && grep -q \"pinned\" public/admin/config.yml", "exit": 0, "duration_s": 20.732, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:04:09+00:00"}
+{"task": "task_0002", "cmd": "E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\" && grep -qE \"renderRich|renderMarkdown\" src/components/pages/MomentsPage.astro && python3 -c \"import yaml;d=yaml.safe_load(open('public/admin/config.yml'));m=[c for c in d['collections'] if c['name']=='moments'][0];t=[f for f in m['fields'] if f['name']=='text'][0];assert t['widget']=='markdown',t\"", "exit": 0, "duration_s": 20.695, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:04:30+00:00"}
+{"task": "task_0003", "cmd": "test -f src/components/MomentComments.astro && grep -q \"MomentComments\" src/components/pages/MomentsPage.astro && grep -q 'moments/${slug}/' src/components/MomentComments.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": 20.501, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:04:50+00:00"}
+{"task": "task_0004", "cmd": "test -f src/components/geek/ViewMeta.astro && grep -q \"ViewMeta\" src/components/ArtalkComments.astro && grep -q \"ViewMeta\" src/pages/archives/[...slug].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": 20.83, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:05:11+00:00"}
+{"task": "task_0005", "cmd": "grep -q \"GithubProfile\" src/pages/opensource.astro && python3 -c \"import re,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','github-readme-activity-graph'] if u in p];assert not bad,bad\"", "exit": 0, "duration_s": 0.029, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:05:11+00:00"}
+{"task": "task_0006", "cmd": "python3 -c \"import yaml;d=yaml.safe_load(open('content/site/about.yaml'));types=[b['type'] for b in d.get('blocks') or []];assert 'prose' in types and ('linklist' in types or 'cards' in types),types\" && 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": 21.719, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:05:33+00:00"}
+{"task": "task_0007", "cmd": "test -f content/posts/writing-template.md && test -f content/posts-en/writing-template.md && grep -q \"pinned: true\" content/posts/writing-template.md && grep -qE \"font-kai|c-blue\" content/posts/writing-template.md && grep -q \"写作模板\" docs/写作指南.md", "exit": 0, "duration_s": 0.005, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "f35452f48bd7d96babf34565aeef8d17c25191be02e07d93fd27922795604348", "at": "2026-11-02T13:05:33+00:00"}
@@ -0,0 +1,91 @@
+# Phase 5h：内容表达能力与社交反馈 - 项目范围
+
+<!-- spec-format: 2 -->
+
+## 1. 问题定义
+- **项目目标**：①文章支持置顶（作者指定优先）②瞬间的文字与文章同级表达力（字体可换、颜色可换、多段落/列表/强调）③瞬间每条可独立评论 ④浏览量与评论数用统一的「眼睛/气泡」计数徽标呈现（对齐开源页 GitHub 档案的眼图标语汇）⑤开源页开篇从 GitHub README 直接移植导致：`<div align="center">` 内联对齐失效、shields/vercel/snake/komarev 等外链图在慢网下空白破版、README 的「About Me」与开源页主题无关——重构为原生组件并从 README 解耦 ⑥关于页承接读完 README 后仍想保留的个人叙述 ⑦新增一篇「写作模板」示例文章，把可用排版能力一次演示完
+- **目标用户**：站长（写得更自由，少打字面 HTML）、读者（读到更丰富且不破版的页）
+- **核心价值**：内容表达力与后台编辑力对上，同时把外链依赖与版式事故面砍掉；社交反馈（浏览/评论）在灰阶体系内可量化可见
+
+## 2. 假设与待确认
+
+### 2.1 已确认事实
+- Artalk v2 匿名可读：`GET /artalk/api/v2/comments?site_name=…&page_key=…&limit=1` 返回 `{count, roots_count, page:{pv}}`（生产实测，2026-11-02）；`POST /artalk/api/v2/pages/pv` 返回 `{pv}`（现有组件在用）
+- 富文本管线已存在且已净化：`renderRich`（markdown + rehype-content-sanitize 标签/属性/协议三层白名单）与 `rehype-class-whitelist`（35 项排版类，单一事实源 `public/admin/typography-classes.js`）
+- 现有 6 自托管字族（含 font-huiwen 子集化 420KB 单页）与 16 彩色语义类 + 4 灰阶语义类
+- 开源页 README 现由 `intro_from: "off"` 关闭，缓存文件 `content/.github-readme.md`（3138B）含 6 类外链图（readme-typing-svg / shields.io / github-readme-stats / streak-stats / activity-graph / snake / komarev）
+- 首页/归档/书架三处列表排序均为 `pubDate` 降序，无置顶概念（`grep pinned` 只命中开源页仓库白名单）
+
+### 2.2 关键假设
+- 瞬间富文本走与全站文案同一条净化管线即可满足「字体/颜色可换」且不引入 XSS 面（危险标签整棵丢弃、协议白名单 http/https/mailto）
+- 每条瞬间一个 Artalk page_key（`/moments/<slug>/`）不会与页面级 pv 冲突；Artalk 实例按需挂载（展开才 init）可避免 "one page one Artalk" 的全局实例冲突
+- 开源页可用本地数据（已有 repo 元数据 + GitHub GraphQL 拉取）自绘 followers/stars/语言占比，无需任何第三方徽章服务
+
+### 2.3 待确认问题
+- [x] 瞬间文字是否允许 HTML 类名（字体/颜色）→ 用户原话「字体可换、颜色可换等」，按富文本管线放行 35 项白名单类
+- [x] 开源页要不要与 README 完全一致 → 用户原话「可以自行进行美化，无需完全一致」，按原生组件重构
+- [x] About Me 类内容放哪 → 用户原话「有些可以直接移植到关于页面中」，迁到 about.yaml blocks
+
+### 2.4 可选解释与取舍
+- 置顶只作用于列表排序与视觉标记，不改 URL / 不改 pubDate 语义（订阅源按时间仍正确）
+- 计数徽标一次只拉当前页的 pv（POST 计一次）与评论数（GET 读）；瞬间列表按可视区懒拉，避免 N 次请求把首屏拖慢
+- 开源页保留 `intro_from` 开关作为 compat，但默认 off 且文档标注「不推荐」；README 渲染通道不删除（后台仍可切回）
+
+### 2.5 已证伪路径
+- 直接渲染 README HTML 并试图用 CSS 修 `align="center"`：内联属性与 sanitize 的交互不可控，且外链图仍会空白破版 → 弃，改原生组件
+- 每条瞬间都 init 一个 Artalk 实例常驻：内存与请求成本高、且 Artalk 对多实例的支持未验证 → 改为展开时挂载
+- 用第三方徽章服务显示访客数（komarev 等）：外链依赖 + 灰阶体系外颜色 → 弃，用 Artalk pv 自绘
+
+## 3. 功能范围
+
+### 3.1 核心功能（MVP）
+- [x] T1 文章置顶：posts/postsEn schema `pinned`、四处列表排序（首页双轨/归档/书架）、视觉标记（灰阶 pin）、后台开关
+- [x] T2 瞬间富文本：moments `text` 支持 markdown + 白名单排版类（字体/颜色/强调/多段/列表）、净化管线复用、后台改 markdown 编辑器、旧纯文本零回归
+- [x] T3 瞬间逐条评论：每条 moment 独立 page_key 的 Artalk 评论区（折叠、展开时挂载）、评论数联动、双语页共用同一 key
+- [x] T4 计数徽标：新增 `ViewMeta` 组件（眼睛图标 = 浏览数、气泡图标 = 评论数），接入文章页/瞬间页/关于页/开源页
+- [x] T5 开源页重构：原生 GitHub 档案卡（头像/名字/关注者/星标/语言占比，本地数据自绘）替换 README 外链图；`align` 失效与破图问题消失；README 通道降级为可选
+- [x] T6 关于页承接：把 README 的 About Me / Find Me 迁为 about.yaml blocks（prose + linklist），开源页只留开源相关
+- [x] T7 写作模板示例：中英双语示例文章，演示标题层级/彩色强调/字族/引用/代码/图/表/链接卡片/折叠，并作为置顶功能的活样本；docs 与后台 hint 同步
+
+### 3.2 扩展功能
+- 无
+
+### 3.3 不在范围内
+- 评论回复通知/邮件推送、点赞/投票、阅读进度、站点级总访问量统计（Artalk 无匿名聚合端点）
+
+## 4. 最小实现路径
+- 最简单可行方案：置顶先用 boolean + 排序键；瞬间富文本直接把 `text` 交给既有 `renderRich`；评论用现有 Artalk 组件克隆一份带折叠的；计数徽标只做 pv + count 两个数
+- 暂不引入：置顶权重/多级置顶、瞬间的图片轮播、评论楼中楼定制、开源页的实时 Star 曲线
+- 不做的抽象：通用「内容社交层」框架（只服务现有页面）
+
+## 5. 技术决策
+- 技术栈：Astro 7.4.4 + zod schema + Artalk v2 HTTP API + GitHub GraphQL（已有 token）
+- 证据协议：evidence: runs
+- 本轮允许改动：src/content.config.ts、src/components/{PostList,ArtalkComments}.astro、src/components/pages/{HomePage,MomentsPage,BooksPage}.astro、src/components/geek/{ViewMeta,GithubProfile}.astro（新）、src/pages/archives/[...slug].astro、src/pages/en/archives/[...slug].astro、src/pages/{about,opensource,en/about,en/opensource}.astro、src/lib/{projects,site-content,heatmap}.ts、content/site/{about,opensource}.yaml、content/posts/*（新增示例文章）、content/posts-en/*、public/admin/{config.yml,typography-classes.js}、docs/*、tests/e2e.mjs
+- 本轮不应触碰：nginx/ESA、灯箱与图库（GalleryPage/PhotoZoom）、Header/Footer 结构、构建链顺序、tokens.css/global.css 基础尺度
+- Git integration branch：`spec/2026-11-02_blog-5h-content-social`
+
+### 5.1 验证策略
+- 范围级别：package
+- 变更对象：内容模型（置顶/瞬间富文本）、渲染组件（计数/评论/档案卡）、后台配置、示例内容
+- 快速检查：`pnpm astro build`（node26）+ `python3 scripts/build-perf/config-check.py .`
+- 集成检查：`E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs`（37 项，本包新增置顶顺序/徽标存在/瞬间富文本断言）+ content-lint 0/0/0
+- 全项目检查：生产实测四条（开源页零第三方外链图、瞬间评论可发可见、徽标数值与 Artalk 端点对账一致、关于页承接内容渲染）；**升级条件**——仅当改动触及 BaseLayout/全局样式（tokens/字体栈）或 Artalk 主题接管层时才执行，本包因往 tokens 补 emoji 回退链已触发一次并记录了理由
+- 升级触发：若动到 BaseLayout/全局样式或 Artalk 主题接管层，升级为全站视觉复核（glm-5.3-flash:max，≤6 图/轮）
+
+## 6. 成功标准与验证方式
+- [x] 置顶文章排在列表首位且带可见标记，取消置顶后恢复时间序 -> verify: task_0001
+- [x] 瞬间文字可用字体类与彩色强调，危险标签被净化丢弃，旧纯文本渲染不变 -> verify: task_0002
+- [x] 每条瞬间可展开评论区并成功发帖，双语页共用同一评论流 -> verify: task_0003
+- [x] 文章/瞬间/关于/开源四页显示「浏览数 + 评论数」徽标且数值与 Artalk 一致 -> verify: task_0004
+- [x] 开源页零第三方图片请求，档案卡数据来自本地/GraphQL，居中与破图问题不再出现 -> verify: task_0005
+- [x] README 的个人叙述出现在关于页，开源页只保留开源相关内容 -> verify: task_0006
+- [x] 示例文章渲染全部演示能力且构建通过，docs/hint 同步 -> verify: task_0007
+
+## 7. 风险与约束
+- 灰阶外壳红线不变：徽标图标与数字用 tokens（`--ink-*`/`--line`），不引入第三方彩色徽章
+- 彩色仅正文强调（≤3 处/页）——示例文章本身要守纪律，成为正面样本而非反例
+- 瞬间富文本必须复用 `renderRich` 净化链，禁止新增 set:html 直通路径
+- Artalk 多实例风险：评论区折叠 + 展开挂载，若实测冲突则退回「逐条跳转到锚点页」
+- 双语链路：所有新文案走 `t()`/`pickBi`，en 轨不得出现中文硬编码
+- 多车道并行：content.config.ts / public/admin/config.yml 由 orchestrator 先落契约再放行，车道只改各自 boundary 内文件
@@ -0,0 +1,44 @@
+# Phase 5h：内容表达能力与社交反馈 - 任务拆解
+
+## 使用规则
+- boundary/verify 齐备；verify 只读断言；车道工作树开发禁 git，收编由 orchestrator 统一提交
+- 构建一律 `export PATH="$HOME/.local/node/bin:$PATH"`（Node 26）+ `pnpm astro build`
+- **契约先行**：`src/content.config.ts` 与 `public/admin/config.yml` 由 orchestrator 先落契约（T1 时一并提交），车道不得再改这两个文件；需要新字段一律回报 orchestrator
+- E2E 口径：`pnpm astro build → cp -a dist /tmp/dist-e2e → 用 18925 端口起快照服务 → E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs`
+
+## 阶段一：实现
+
+- [x] T1 文章置顶（契约 + 排序 + 标记 + 后台）
+  - claim: orchestrator
+  - boundary: src/content.config.ts（postsSchema 加 `pinned: z.boolean().optional()`，posts/postsEn 共用）、src/components/PostList.astro（置顶优先排序 + pin 标记）、src/pages/archives/index.astro（排序）、src/components/pages/{HomePage,BooksPage}.astro（排序）、public/admin/config.yml（posts 集合 pinned 开关 + 中文 hint）、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" && grep -q "pinned" src/content.config.ts && grep -q "pinned" src/components/PostList.astro && grep -q "pinned" public/admin/config.yml`
+
+- [x] T2 瞬间富文本（字体可换 / 颜色可换 / 多形式）
+  - claim: worker-one
+  - boundary: src/components/pages/MomentsPage.astro（`text` 由纯文本 `<p>` 改为走 `renderRich` 净化+排版类管线，保留 inline 语义；空文本老数据零回归）、public/admin/config.yml 中 moments 集合 `text` 字段改 markdown widget + 提示可用排版类（**仅在 orchestrator 提交的字段块内改 widget 类型，不改结构**）、docs 提示留给 T7
+  - verify: `E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS" && grep -qE "renderRich|renderMarkdown" src/components/pages/MomentsPage.astro && python3 -c "import yaml;d=yaml.safe_load(open('public/admin/config.yml'));m=[c for c in d['collections'] if c['name']=='moments'][0];t=[f for f in m['fields'] if f['name']=='text'][0];assert t['widget']=='markdown',t"`
+
+- [x] T3 瞬间逐条评论（Artalk 独立 page_key + 折叠懒挂载）
+  - claim: worker-one
+  - boundary: 新增 src/components/MomentComments.astro（折叠 disclosure，展开时首次挂载 Artalk；page_key 约定 `/moments/#<slug>`，en 页同一 key 不分裂；评论数徽标复用 T4 的 ViewMeta 计数接口）、src/components/pages/MomentsPage.astro（每条卡片挂评论区）
+  - verify: `test -f src/components/MomentComments.astro && grep -q "MomentComments" src/components/pages/MomentsPage.astro && grep -q 'moments/${slug}/' src/components/MomentComments.astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
+
+- [x] T4 计数徽标（眼睛图标 = 浏览数，气泡图标 = 评论数）
+  - claim: op-artalk
+  - boundary: src/components/geek/ViewMeta.astro（**契约组件，由 orchestrator 在 T1 提交时一并落盘**，车道只消费不改语义）、src/components/ArtalkComments.astro（pv 小字行改为 ViewMeta，评论数取 `comments?limit=1` 的 count）、src/pages/archives/[...slug].astro、src/pages/en/archives/[...slug].astro（挂 ViewMeta）
+  - verify: `test -f src/components/geek/ViewMeta.astro && grep -q "ViewMeta" src/components/ArtalkComments.astro && grep -q "ViewMeta" src/pages/archives/[...slug].astro && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
+
+- [x] T5 开源页重构（原生 GitHub 档案卡，去外链图依赖）
+  - claim: op-gitea
+  - boundary: 新增 src/components/geek/GithubProfile.astro（头像/名字/简介/关注者/总星标/语言占比，数据来自 projects.ts 与 GraphQL；零第三方图片与徽章）、src/lib/projects.ts（补统计聚合：followers/stars/language 汇总，失败降级不炸构建）、src/pages/opensource.astro、src/pages/en/opensource.astro（用 GithubProfile 替换 readme 渲染段；README 通道保留开关但默认 off 且标注不推荐）、content/site/opensource.yaml（注释说明 intro_from 现状）
+  - verify: `grep -q "GithubProfile" src/pages/opensource.astro && python3 -c "import re,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','github-readme-activity-graph'] if u in p];assert not bad,bad"`
+
+- [x] T6 关于页承接 README 的个人叙述
+  - claim: op-gitea
+  - boundary: content/site/about.yaml（新增 blocks：关于/兴趣 prose、站点与项目 linklist、Find Me 社交块；双语 zh/en；测试值不得留在文件里）、src/pages/about.astro 与 en（仅当块渲染需要时改，优先零改动）
+  - verify: `python3 -c "import yaml;d=yaml.safe_load(open('content/site/about.yaml'));types=[b['type'] for b in d.get('blocks') or []];assert 'prose' in types and ('linklist' in types or 'cards' in types),types" && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
+
+- [x] T7 写作模板示例文章 + 文档与 hint 收尾
+  - claim: orchestrator
+  - boundary: content/posts/writing-template.md、content/posts-en/writing-template.md（en 手写 locked:true 直译，不交给 TMT 重译）、docs/写作指南.md（模板用法 + 排版类清单去重指引）、docs/管理台.md（瞬间富文本/逐条评论/置顶/徽标说明）、public/admin/config.yml（moments text hint、posts pinned 已含）
+  - verify: `test -f content/posts/writing-template.md && test -f content/posts-en/writing-template.md && grep -q "pinned: true" content/posts/writing-template.md && grep -qE "font-kai|c-blue" content/posts/writing-template.md && grep -q "写作模板" docs/写作指南.md`
@@ -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"`
@@ -0,0 +1,66 @@
+<div align="center">
+<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=600&size=26&duration=3000&pause=1000&color=00D9FF&center=true&vCenter=true&random=false&width=620&lines=Hi+there+%F0%9F%91%8B+I'm+wait4x;Open+Source+Enthusiast+%E2%9D%A4%EF%B8%8F;Meteorology+%E2%9B%85" alt="Typing SVG" />
+<br>
+<a href="https://github.com/wait4xx?tab=followers"><img src="https://img.shields.io/github/followers/wait4xx?label=Followers&style=for-the-badge&color=00D9FF&labelColor=0D1117" /></a>
+<a href="https://github.com/wait4xx?tab=stars"><img src="https://img.shields.io/github/stars/wait4xx?label=Stars&style=for-the-badge&color=00D9FF&labelColor=0D1117" /></a>
+<a href="https://github.com/wait4xx"><img src="https://img.shields.io/badge/Open%20Source-%E2%9D%A4%EF%B8%8F-00D9FF?style=for-the-badge&labelColor=0D1117" /></a>
+</div>
+
+---
+
+### 👋 About Me
+
+- ⛅ An aspiring forecaster rooted in **meteorology**.
+- 💻 Passionate about **computer science** and coding.
+- 🌐 My web: **[wait4x.online](https://wait4x.online/)**
+- ⚡ *"Embrace open source, love open source."*
+
+---
+
+### 📊 GitHub Stats
+
+<div align="center">
+  <img height="170" src="https://github-readme-stats.vercel.app/api?username=wait4xx&show_icons=true&hide_border=true&bg_color=0D1117&title_color=00D9FF&icon_color=00D9FF&text_color=C9D1D9&include_all_commits=true&count_private=true&line_height=28" alt="stats" />
+  <img height="170" src="https://github-readme-stats.vercel.app/api/top-langs/?username=wait4xx&layout=compact&hide_border=true&bg_color=0D1117&title_color=00D9FF&text_color=C9D1D9&langs_count=8" alt="top-langs" />
+</div>
+
+<br>
+
+<div align="center">
+  <img src="https://streak-stats.demolab.com?user=wait4xx&hide_border=true&background=0D1117&ring=00D9FF&fire=00D9FF&currStreakLabel=00D9FF&sideLabels=C9D1D9&dates=C9D1D9&currStreakNum=C9D1D9" alt="streak" />
+</div>
+
+---
+
+### 📈 Activity Graph
+
+<div align="center">
+  <img src="https://github-readme-activity-graph.vercel.app/graph?username=wait4xx&bg_color=0D1117&color=C9D1D9&line=00D9FF&point=00D9FF&area=true&area_color=00D9FF&hide_border=true" alt="activity-graph" />
+</div>
+
+---
+
+### 🐍 Contribution Snake
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/wait4xx/wait4xx/output/github-contribution-grid-snake.svg" alt="snake" />
+</div>
+
+> *This snake is auto-fed every day by a GitHub Action in this repo 🍎*
+
+---
+
+### 📫 Find Me
+
+<div align="center">
+<a href="https://github.com/wait4xx"><img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white" /></a>
+<a href="mailto:X@alumni.nudt.edu.cn"><img src="https://img.shields.io/badge/Email-D14836?style=for-the-badge&logo=gmail&logoColor=white" /></a>
+</div>
+
+---
+
+<div align="center">
+  <img src="https://komarev.com/ghpvc/?username=wait4xx&color=00D9FF&style=flat-square&label=%F0%9F%91%80+Visitors" />
+  <br><br>
+  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=14&duration=2000&pause=500&color=8B949E&center=true&vCenter=true&random=false&width=300&lines=Thanks+for+visiting!;See+you+in+the+commits+%F0%9F%8C%BF" alt="footer" />
+</div>
@@ -27,5 +27,12 @@
    "image": "https://astro.build/og/astro.jpg",
    "favicon": "https://astro.build/favicon.svg",
    "ts": 1793593759816
+  },
+  "https://astro.build": {
+    "title": "Astro",
+    "desc": "Astro builds fast content sites, powerful web applications, dynamic server APIs, and everything in-between.",
+    "image": "https://astro.build/og/astro.jpg",
+    "favicon": "https://astro.build/favicon.svg",
+    "ts": 1793621147252
  }
 }
@@ -0,0 +1,10 @@
+---
+pubDate: 2026-11-02
+tags: [站点更新]
+text: |
+  瞬间现在和文章同级表达力：`text` 支持 markdown 与排版类，<span class="c-teal font-kai">这一句是青色 + 楷体</span>，也可以**加粗**。
+
+  另外每条瞬间自带评论区——展开才加载，不刷时间线就不为它付成本。
+---
+
+站点更新记录：瞬间富文本与逐条评论上线。
@@ -0,0 +1,125 @@
+---
+title: "Writing template: this post is the template"
+pubDate: 2026-11-02
+category: tech
+tags: [writing, template]
+pinned: true
+locked: true
+description: One post that exercises every typographic capability on the site — heading levels, colour emphasis, typefaces, quotes, code windows, tables, images, link cards, folding. Copy it to start a new post.
+---
+
+This is not a tutorial — it is a **template you can copy**. Every section below actually runs: what you see is what Markdown produces. To start a new post, copy this file, change the slug, and delete what you do not need.
+
+It is also the live sample for **pinning**: `pinned: true` in the frontmatter lifts a post to the front of the home page, the archive and the bookshelf, while its date, URL and RSS timestamps stay untouched.
+
+## 1. Heading levels and paragraphs
+
+Use `##` for a section and `###` for a subsection. **Never use `#`** — the post title comes from the frontmatter `title`, and a second level-one heading confuses both screen readers and search snippets.
+
+Leave a blank line between paragraphs. Inline you can use **bold**, *italic*, ~~strikethrough~~, `inline code`, and [ordinary links](https://astro.build).
+
+## 2. Colour emphasis: three per page at most
+
+The rule comes from the design baseline: the shell is greyscale, so colour exists to weight one judgement in the body — three per page, maximum. More than that and it turns loud.
+
+<span class="c-blue">First use: state one key conclusion in blue.</span> Then carry on normally.
+
+<span class="c-red">Second use: warn about a trap in red.</span> For example, “after changing a Markdown plugin you must clear `node_modules/.astro`, or the change silently does nothing”.
+
+<span class="c-green">Third use: confirm a working path in green.</span> After three, this section stays uncoloured.
+
+There are eight hues (blue / teal / green / yellow / orange / red / pink / purple), each with a standard and a `-soft` variant, plus four greyscale classes (`ink-muted` / `ink-warm` / `ink-cool` / `ink-faint`) for lowering tone — those do not count against the colour budget.
+
+## 3. Typefaces: change only what you wrap
+
+Body text is sans-serif by default. To give one sentence a different temperament, wrap it:
+
+<span class="font-kai">This sentence is in Kai. Good for epigraphs, quoted lines in a review, or paragraphs that should be read slowly.</span>
+
+<span class="font-huiwen">This sentence is in Huiwen Ming. Over a long paragraph it noticeably slows reading, so use it for short lines only.</span>
+
+Six families are available (`font-kai`, `font-song`, `font-hei-sys`, `font-fangsong`, `font-huiwen`, `font-kuaile`), plus an artistic heading class `font-art-kuaile`. **Mind the weight**: switching a whole page to a family makes every visitor download a CJK font, so avoid changing the body default casually.
+
+### A level-three heading looks like this
+
+One step smaller than level two, bold, with tighter spacing. Use it to split a section into topics.
+
+## 4. Quotes and lists
+
+> Block quotes are for quoting someone. An attribution can follow as italics.
+>
+> — an invented attribution
+
+Unordered list:
+
+- First item
+- Second item, with `inline code`
+- Third item, nested:
+  - Child one
+  - Child two
+
+Ordered lists suit steps:
+
+1. Copy the template
+2. Change the slug and title in the frontmatter
+3. Delete the sections you do not need
+
+## 5. Code blocks
+
+Blocks of four lines or more get a greyscale window bar (three dots); shorter fragments do not, so small snippets do not look like screenshots.
+
+```ts
+// Sort contract: pinned first → newest first → id as a tie-breaker
+export function sortPosts<T extends Post>(posts: T[]): T[] {
+  return [...posts].sort((a, b) => {
+    const pin = Number(b.data.pinned === true) - Number(a.data.pinned === true);
+    return pin !== 0 ? pin : b.data.pubDate.getTime() - a.data.pubDate.getTime();
+  });
+}
+```
+
+Refer to variables inline like `posts`.
+
+## 6. Tables
+
+| Capability | Syntax | Note |
+| --- | --- | --- |
+| Colour emphasis | `<span class="c-blue">` | three per page at most |
+| Typeface | `<span class="font-kai">` | a whole page adds font weight |
+| Image | `![alt](./assets/<slug>/x.jpg)` | see the writing guide for size rules |
+| Video | frontmatter `video:` | lives in public/media, ≤50MB |
+| Link card | a bare URL on its own line | OG fetched at build time, falls back to a plain link |
+
+## 7. Images
+
+Reference images by relative path, stored under `content/posts/assets/<slug>/`; they expand on click and vectors stay sharp:
+
+![Sample image: a greyscale coast](../posts/assets/media-sample/sample-photo.jpg)
+
+## 8. Link cards
+
+A bare URL on its own line becomes an OG preview card at build time; if the fetch fails it degrades to a plain link, never breaking the layout:
+
+https://astro.build
+
+## 9. Folding long content
+
+Long appendices, full logs and big configs can fold away with zero JavaScript, using native `details`:
+
+<details>
+<summary>Open the folded example</summary>
+
+A folded region can hold anything — paragraphs, lists, code blocks.
+
+- Best for “read on demand” detail
+- Not for conclusions (readers may never open it)
+
+</details>
+
+## 10. Closing after the rule
+
+---
+
+Three sentences are enough to close: what this covered, what the reader should take away, and where to go next. The template is not a demand to write ten sections — it is a promise that **the capabilities are at hand when you need to express something**.
+
+Next time, copy this file and delete until only your point remains.
@@ -0,0 +1,33 @@
+---
+title: "字体族样例"
+pubDate: 2026-11-02
+category: reading
+tags: [test, hidden]
+draft: false
+---
+
+字体测试样张（hidden）：验证系统回退字族的渲染。
+
+<p class="font-song">宋体族（系统回退）：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="font-kai-sys">楷体族（系统回退）：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="font-hei-sys">黑体族（系统回退）：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="font-fangsong">仿宋族（系统回退）：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="ink-warm">暖调正文：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="ink-cool">冷调正文：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="ink-faint">最淡可读档：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="ink-accent-soft">弱强调：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="c-blue">蓝色标准：秋天的海面像一块被风抚平的铁皮。</p>
+<p class="c-yellow">黄色标准（已压暗）：秋天的海面像一块被风抚平的铁皮。</p>
+<p class="c-red-soft">红色 soft：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="font-huiwen">汇文明朝体（OFL，切片自托管）：秋天的海面像一块被风抚平的铁皮。</p>
+
+<p class="font-kuaile">站酷快乐体（OFL，艺术字）：秋天的海面像一块被风抚平的铁皮。</p>
@@ -0,0 +1,124 @@
+---
+title: "写作模板：这篇文章本身就是模板"
+pubDate: 2026-11-02
+category: tech
+tags: [写作, 模板]
+pinned: true
+description: 一篇文章演示全站可用的排版能力：标题层级、彩色强调、字族、引用、代码窗、表格、图、链接卡、折叠。复制它开始写新文。
+---
+
+这篇不是教程，是**可复制的模板**。下面每一节都在真跑——你看到的效果，就是 Markdown 源码能产出的效果。写新文章时，把本文件复制一份、改个 slug、删掉不需要的段落即可。
+
+它同时是**置顶功能**的活样本：`frontmatter` 里的 `pinned: true` 会让它排在首页、归档与书架的最前面，而日期、URL、订阅源里的时间都不变。
+
+## 一、标题层级与段落
+
+正文用 `##` 作一级节标题，`###` 作二级。**不要用 `#`**——文章标题由 frontmatter 的 `title` 渲染，正文再写 `#` 会出现两个一级标题，屏幕阅读器与搜索摘要都会困惑。
+
+段落之间空一行即可。行内可以**加粗**、*斜体*、~~删除线~~、`行内代码`，也可以放[普通链接](https://astro.build)。
+
+## 二、彩色强调：一页不超过三处
+
+纪律来自设计基线：站点外壳是灰阶的，颜色只用来给正文某一个判断加重，一页最多三处。超过就变成花哨。
+
+<span class="c-blue">第一处：一个关键结论用蓝色提出。</span> 后面照常叙述。
+
+<span class="c-red">第二处：需要警示的坑用红色。</span> 比如「改完 Markdown 插件必须清 `node_modules/.astro`，否则改动静默不生效」。
+
+<span class="c-green">第三处：确认可行的路径用绿色。</span> 三处之后，本节不再上色。
+
+可用色相共 8 组（blue / teal / green / yellow / orange / red / pink / purple），每组有标准与 `-soft` 两档；另有 4 个灰阶层级类（`ink-muted` / `ink-warm` / `ink-cool` / `ink-faint`）用于降调，不算彩色额度。
+
+## 三、字族：换字体只作用于被包裹的文字
+
+正文默认是无衬线。想给某句话换气质，用类包起来就行：
+
+<span class="font-kai">这一句是楷体。适合题记、书评里引的原句，或者需要慢一点读的段落。</span>
+
+<span class="font-huiwen">这一句是汇文明朝体。长段落用它会明显降低阅读速度，所以只用在短句上。</span>
+
+可用字族共 6 族（`font-kai` 楷、`font-song` 宋、`font-hei-sys` 黑、`font-fangsong` 仿宋、`font-huiwen` 汇文明朝、`font-kuaile` 快乐体），另有 `font-art-kuaile` 艺术字标题类。**注意体积**：整页换字族会让访问者下载一份中文字体，正文默认字体不要轻易改。
+
+### 三级标题长这样
+
+比二级小一档、加粗、上下留白更紧。用于把一节拆成几个小话题。
+
+## 四、引用与列表
+
+> 引用块用于摘录别人的话。署名可以换成斜体放在最后。
+>
+> —— 一句虚构的署名
+
+无序列表：
+
+- 第一项
+- 第二项，可以带 `行内代码`
+- 第三项，可以嵌套：
+  - 子项一
+  - 子项二
+
+有序列表适合步骤：
+
+1. 复制模板
+2. 改 frontmatter 的 slug 与标题
+3. 删掉不需要的段落
+
+## 五、代码块
+
+四行及以上的代码块会带上灰阶窗条（三个点），短代码块不加——避免小片段看着像截图。
+
+```ts
+// 排序契约：置顶优先 → 时间倒序 → id 兜底
+export function sortPosts<T extends Post>(posts: T[]): T[] {
+  return [...posts].sort((a, b) => {
+    const pin = Number(b.data.pinned === true) - Number(a.data.pinned === true);
+    return pin !== 0 ? pin : b.data.pubDate.getTime() - a.data.pubDate.getTime();
+  });
+}
+```
+
+行内提到变量时用 `posts` 这种形式即可。
+
+## 六、表格
+
+| 能力 | 写法 | 注意 |
+| --- | --- | --- |
+| 彩色强调 | `<span class="c-blue">` | 一页 ≤3 处 |
+| 换字族 | `<span class="font-kai">` | 整页换会拉字体体积 |
+| 图片 | `![说明](./assets/<slug>/x.jpg)` | 体积纪律见写作指南 |
+| 视频 | frontmatter `video:` | 放 public/media，≤50MB |
+| 链接卡片 | 裸链接单独成段 | 构建期抓 OG，失败回落普通链接 |
+
+## 七、图片
+
+图片用相对路径引用，挂在 `content/posts/assets/<slug>/` 下，点击可放大（矢量图不糊）：
+
+![示例配图：一片灰阶海岸](./assets/media-sample/sample-photo.jpg)
+
+## 八、链接卡片
+
+一个裸链接单独成段，构建期会抓取 OG 预览生成卡片；抓不到就退回普通链接，不会坏版：
+
+https://astro.build
+
+## 九、折叠长内容
+
+长附录、完整日志、大段配置可以折叠，零 JS，原生 `details`：
+
+<details>
+<summary>展开看一个被折叠的长例子</summary>
+
+折叠区里可以放任何东西——段落、列表、代码块。
+
+- 适合放「按需查看」的细节
+- 不适合放结论（读者可能永远不展开）
+
+</details>
+
+## 十、分隔线之后收尾
+
+---
+
+收尾三句就够：这篇讲了什么、读者该带走什么、下一步去哪。模板不是要你写满十节，而是**在你需要表达时，能力都在手边**。
+
+下一篇开始，复制本文件，删到只剩你要说的。
@@ -1,28 +1,153 @@
-# 关于页正文（后台「页面文案 → 关于页」可改，markdown 编辑）
-# intro = 多段 markdown 正文，渲染在「关于」标题下方、名片之前；留空回落默认文案
-# 支持的语法：段落、列表、粗斜体、行内代码、链接（渲染走 Astro 的 markdown 管线）
+# 关于页（后台「页面文案 → 关于页」可改）
+# ── 一级：blocks 块式正文（按顺序渲染，可拖拽排序；某块 enabled: false 即隐藏）
+# ── 二级：intro 多段 markdown（仅在 blocks 为空时使用）
+# ── 三级：内置默认文案（两者都空时兜底，构建永不炸）
+layout:
+  # 名片区（头像/名字/身份语/社交）开关：头像等数据事实源在「主页设置」
+  showIdCard: true
+
+blocks:
+  - type: prose
+    width: narrow
+    body:
+      zh: |
+        <span class="font-huiwen c-red">写作者</span> · 读者 · 快门按压者，拥抱开源。
+
+        这里是我三条轨道的公开工作台：**读过的书**留下评注，**写过的代码**进项目墙，**按下的快门**收入图库。
+
+        所有内容都有一个明确去处：
+
+        - 长文沉淀在文章与书架
+        - 短句与随手拍落在瞬间
+        - 影像收进图库，配一点 EXIF 与一句策展
+
+        本站本身即开源，构建与发布全链都在仓里。
+      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** I pressed 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 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: About me
+    body:
+      zh: |
+        气象是我起点的专业——一个想做预报的人，依旧把云图当日常读物。
+
+        写代码是第二条主线：Linux、容器、自托管，把日常工具一件件磨顺手。
+
+        作品大多在 [wait4x.online](https://wait4x.online/)。
+
+        信条：**拥抱开源，热爱开源**。
+      en: |
+        Meteorology is where I started — an aspiring forecaster who still reads weather charts for fun.
+
+        Coding is the second thread: Linux, containers, 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**.
+
+  - type: linklist
+    title:
+      zh: 找到我
+      en: Find me
+    items:
+      - label:
+          zh: 本站
+          en: Website
+        href: 'https://wait4x.online/'
+        note:
+          zh: 文章、图库与瞬间
+          en: Posts, gallery and moments
+      - label:
+          zh: 邮件
+          en: Email
+        href: 'mailto:admin@wait4x.online'
+        note:
+          zh: 有话直说
+          en: Say hello directly
+      - label:
+          zh: GitHub
+          en: GitHub
+        href: 'https://github.com/wait4xx'
+        note:
+          zh: 开源项目与提交
+          en: Open-source projects and commits
+      - label:
+          zh: 自托管 gitea
+          en: Self-hosted gitea
+        href: 'https://git.wait4x.online/wait4x/blog'
+        note:
+          zh: 本站源码
+          en: Source of this site
+      - label:
+          zh: RSS
+          en: RSS
+        href: /rss.xml
+        note:
+          zh: 订阅更新
+          en: Subscribe to updates
+
+  - 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: |
    写作者 · 读者 · 快门按压者，拥抱开源。

    这里是我三条轨道的公开工作台：**读过的书**留下评注，**写过的代码**进项目墙，**按下的快门**收入图库。
-
-    所有内容都有一个明确去处：
-
-    - 长文沉淀在文章与书架
-    - 短句与随手拍落在瞬间
-    - 影像收进图库，配一点 EXIF 与一句策展
-
-    本站本身即开源，构建与发布全链都在仓里。
  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.

-    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 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.
+# 页面级排版覆盖（层 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
@@ -4,8 +4,8 @@ blurb:
 repo_url: https://git.wait4x.online/wait4x/blog
 repo_label: git.wait4x.online/wait4x/blog
 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.
+  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=全部（默认） | only=仅 include 列出 | exclude=排除 exclude 列出
@@ -18,5 +18,9 @@ exclude: []
 sort: pinned-first
 # 来源过滤：both=双源合并（默认） | github | gitea
 perSource: both
-# 开篇文案来源：off=用本文件 blurb（默认） | github-readme=构建期取 wait4xx/wait4xx 的 README 渲染
+# 开篇来源（compat，**不推荐开启**）：off=用本文件 blurb + 原生档案卡（默认）
+#   github-readme = 构建期取 wait4xx/wait4xx 的 README 原样渲染在档案卡下方
+#   ⚠ 开启会引入 7 类第三方外链图（readme-typing-svg / shields.io 徽章 / github-readme-stats /
+#   streak-stats / activity-graph / 贡献蛇 / komarev 访客徽章），慢网或被墙时整片空白；
+#   且 README 用 <div align="center"> 居中，本站渲染不认该属性 → 居中失效。内容已由档案卡承接。
 intro_from: "off"
@@ -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
@@ -0,0 +1,394 @@
+# 页面后台化方案：内容 / 布局 / 样式的可编辑边界
+
+> 调研 + 提案，不改代码。基线 = 工作树 2026-11-02（含在途未提交改动）。
+> 口径：所有结论落到本仓文件/字段；"能编辑什么"和"不能编辑什么"同等重要。
+> **在途关系**：工作树里另有一条未提交车道（`git diff --stat`：home.yaml / opensource.yaml / projects.ts / site-content.ts / content.config.ts / ProjectWall.astro / index.astro / en-index / tokens.css / global.css，共 306 增）已落地「首页区块开关 + 开源页可见性 + README 开篇」。本文把它当**既有事实**评估，只补缺口与验收，不重复设计。
+
+---
+
+## 0. 现状盘点（文件级锚点）
+
+| 关注点 | 现有实现 | 位置 |
+|---|---|---|
+| 集合/单例 schema | `siteHome` / `siteAbout` / `siteOpenSource` 三个 `glob(pattern 精确到单文件)` 单例 | `src/content.config.ts:78,114,119` |
+| 后台字段 | `site_pages` 一集合三 files，字段与 schema 一一对应 | `public/admin/config.yml:110-260` |
+| 文案访问层（含字段级回落） | `pick()/pickBi()` + `SITE_DEFAULTS` 逐字对齐历史文案 | `src/lib/site-content.ts:18-62` |
+| markdown 渲染 | `createMarkdownProcessor()` **无参**（关键，见 §7） | `src/lib/site-content.ts:122-127` |
+| 关于页结构 | h1 → intro(markdown) → `IdCard` → tracks(3 条硬编码) → build 段 | `src/components/pages/AboutPage.astro:1-70` |
+| 关于页可变文案 | tracks/build 段全部来自 `t()` 字典（**非后台可改**） | `src/i18n/ui.ts:73-84` |
+| 首页 | 结构化区块：IdCard/PostList/最新影像/Heatmap/ProjectWall/心跳 | `src/pages/index.astro`（zh/en 两份重复） |
+| 开源页 | blurb + Heatmap + ProjectWall(limit 99) | `src/pages/opensource.astro` |
+| 项目数据 | 构建期双源 fetch + 去重 + 过滤/排序 + 仓内 fallback JSON（现仅 1 条 `blog`） | `src/lib/projects.ts:24-134`、`src/data/projects-fallback.json` |
+| README 开篇 | `GET /repos/wait4xx/wait4xx/readme`（Accept raw）+ `content/.github-readme.md` 缓存 | `src/lib/site-content.ts:204-256` |
+| markdown 净化 | 仅文章管线挂了白名单（class/style/on*） | `astro.config.mjs:28`、`src/lib/rehype-class-whitelist.ts` |
+| 设计 tokens | 全部 CSS 变量，明暗双套 | `src/styles/tokens.css`（124 行，含 dark 覆盖） |
+
+**结论**：后台能力当前是「**平铺标量字段**」形态——能改文案与几个开关，不能改**结构、顺序、字段种类**。关于页的骨架（tracks/build 两段）完全在代码与 i18n 字典里，这正是用户"整页可编辑"诉求的断点。
+
+---
+
+## 1. 需求拆解（可验收能力清单）
+
+| 编号 | 能力 | 现状 | 缺口 |
+|---|---|---|---|
+| C1 | 关于页**所有文案**可改（含 tracks/build 段） | intro 可改，其余在 `ui.ts` | 全部结构化区块未入 CMS |
+| C2 | 关于页**结构可改**（增删段、调顺序、开关名片区） | 硬编码 | 无块模型 |
+| C3 | 首页区块开关 / 条数 / 副标题 | 在途已实现（`sections.*`、`perTrackLimit`、`latestPhotos`、`subtitle`） | 缺"展示策略"类字段（见 §6） |
+| C4 | 开源页"展示哪些项目" | 在途已实现（`mode/include/exclude/sort/perSource`） | 语义定稿 + 断言 + 现有 6 条截断副作用（见 §4） |
+| C5 | 开源页开篇 = GitHub profile README | 在途已实现（`intro_from: github-readme`） | 缓存位置被 `git clean` 抹掉（见 §4.4） |
+| C6 | **样式**可调（字体/字号/间距/灰阶/圆角） | 全在 `tokens.css` | 无数据层 |
+| C7 | 双语 en 轨保真 | 字段级 `{zh,en}` + 回落 | 块模型需延续同规矩 |
+| C8 | 构建期零运行时 + SEO/灰阶不回归 | 现状成立 | 需把"不回归"写成断言 |
+
+---
+
+## 2. 五方案对比
+
+| | A 结构化单例字段扩展 | B 块构建器 | C 富文本整页 | D 样式即数据 | E 混合（推荐） |
+|---|---|---|---|---|---|
+| 能力上限 | 低：只能改预定义字段的值 | 高：增删/排序/差异化结构 | 最高：任意内容 | 中：只动感官参数 | 高（结构）+ 中（局部自由） |
+| 破版风险 | 极低 | 低（渲染器受控） | **高**：作者可写出非设计语言结构 | 中（对比度/尺度） | 低-中 |
+| XSS 面 | 0（无 HTML） | 小（组件渲染，URL/图片字段受控） | **大**：`set:html` 直通 | 0 | 小（唯一自由区走净化管线） |
+| 编辑体验 | 顺手但僵硬；20 字段后 config.yml 成清单墙 | 顺手（新增时选块型、拖拽排序） | 最自由但无护栏 | 顺手（几个 color/number） | 顺手（块为主，自由区为辅） |
+| 工作量 | 0.5d/页 | 3-4d（渲染器 + 9 类块 + 后台 types） | 0.5d（已有 intro 通道）但治不住质量 | 1d | 4-5d（含 B+D+净化） |
+| 维护成本 | 每加一项改两处（yml+schema） | 每加块型改三处（yml+schema+组件），但**互不干扰** | 内容问题无代码兜底，靠人审 | 用户改坏颜色需回滚 git | 同 B，另加 token 白名单 |
+| 对我们仓的结论 | **只适合开关/条数**（首页现状即其上限形态），**不作为关于页主路线** | 关于页主力 | **不作为主路线**（灰阶/双语/SEO 三条红线都靠人守） | 采纳为**独立一层**（受限白名单） | **采纳** |
+
+补充结论（逐条）：
+- **A 的极限量化**：`public/admin/config.yml` 现已 260 行、覆盖 4 集合。关于页若走 A（名片/技能卡/时间线各 4-6 字段），预估 +60 行 yml、+40 行 schema、+30 行组件分支；且"某段删掉"只能靠 `enabled: false` 假装，顺序固定。→ 只保留给首页（首页是聚合页，区块种类稳定）。
+- **B 的关键前提**：Sveltia 0.252 支持 **`list` 的 `types` + `typeKey`**（异构块），证据见 §3.4；无此能力则 B 退化成"同构对象列表"（每块字段全冗）。
+- **C 的现实定位**：`about.yaml` 已有 markdown 整块通道（`intro`），可立刻扩成"多段 markdown 长文"。问题：长文无法表达 tracks 卡片（图标+双行）、无法控制段间节奏，且 raw HTML 通道当前**未净化**（§7.1）——直接放开等于开洞。
+- **D 的边界**：可调项必须白名单化（约 12 个），不是整份 tokens.css；`--measure`（9 处引用）、`--accent`（38 处）属高放大倍率旋钮，见 §3.6。
+
+---
+
+## 3. 推荐方案 E：结构与落点
+
+### 3.1 四层数据分层
+
+| 层 | 载体 | 谁能改 | 例子 |
+|---|---|---|---|
+| L1 页面骨架 | `content/site/*.yaml` 的 `blocks: []` | 后台（增删排序） | 关于页整页 |
+| L2 区块字段 | 每块 `type` 决定字段集（zod discriminatedUnion） | 后台 | prose / tracks / cards / timeline / quote / figure / linklist / cta / divider |
+| L3 局部自由区 | `prose` / `richtext` 块内的 markdown（受白名单类 + tag 白名单） | 后台 | 一段带列表的说明 |
+| L4 感官参数 | `content/site/theme.yaml` → 构建期生成 CSS 变量 | 后台（白名单旋钮） | 正文字号、圆角、强调色 |
+
+### 3.2 yaml 结构总览（一眼看全）
+
+```
+content/site/
+├── home.yaml          # 已有：tagline/avatar/favicon/socials/subtitle/latestPhotos/perTrackLimit/sections/*
+│                      # 新增：heroStyle / projectsLimit / photosSource / postsTracks / announcement(markdown)
+├── about.yaml         # 已有：intro{zh,en}（保留为兼容字段，见 §5.5）
+│                      # 新增：layout{showIdCard,container} + blocks:[]
+├── opensource.yaml    # 已有（在途）：blurb/blurb_after/repo_url/repo_label/pinned/mode/include/exclude/sort/perSource/intro_from
+│                      # 新增：projectsTitle / showHeatmap / intro_fallback_blurb（README 取不到时的专用文案）
+└── theme.yaml         # 新增：白名单感官参数（§3.6）
+```
+
+### 3.3 组件与读取层落点（写代码时照此建文件）
+
+| 落点 | 职责 |
+|---|---|
+| `src/lib/page-blocks.ts`（新） | `getAboutBlocks(locale)`：读 `siteAbout` → 过滤 `enabled:false` → 未知 `type` 跳过 + `console.warn` → 文本字段 `pickBi` 回落 zh → 长度上限（块数 ≤ 24、单块文本 ≤ 4000 字） |
+| `src/components/blocks/BlockRenderer.astro`（新） | `switch (block.type)` → 渲染子组件；统一外壳 `<section class="blk" data-block={block.type}>`（**data 属性是 E2E 断言的抓手**） |
+| `src/components/blocks/{Prose,Tracks,Cards,Timeline,Quote,Figure,LinkList,Cta,Divider}.astro`（新） | 每类一个组件，样式从 `AboutPage.astro` 现状 `<style>` 段搬迁（`.sec-title`/`.track-row`/`.track-icon` 原样保留） |
+| `src/components/pages/AboutPage.astro`（改） | 保留 `h1` + 可选 `IdCard`；`blocks` 为空 → `intro` markdown → 若再空则 `SITE_DEFAULTS.aboutIntro`（**零回归三级回落**） |
+| `src/content.config.ts`（改） | `siteAbout` schema 扩展：`blocks` 用 `z.array(z.discriminatedUnion('type',[...]))`，图片字段用 `image()` |
+| `public/admin/config.yml`（改） | `site_pages → about` 加 `blocks` 的 `list`+`types` 声明，`typeKey: type` |
+| `src/lib/site-content.ts`（改） | `renderMarkdown` 补 rehype 插件（§7.2 一笔修两洞） |
+| `src/lib/theme.ts`（新） | `getTheme()` + `themeVarsCss()` 生成 `:root:root{…}` 字符串 |
+| `src/layouts/BaseLayout.astro`（改） | head 内联 `<style set:html={themeVarsCss()}>`（构建期静态，零运行时）；`main` 容器档位由页面 `layout.container` 决定（`.container` / `.container-wide`，`global.css:43-44`） |
+
+### 3.4 Sveltia 0.252 能力边界（本仓 bundle 实测取证）
+
+证据文件：`public/admin/index.html`（pinned 本地 bundle 0.252.0，2.5MB）。
+
+| 能力 | 结论 | 取证 |
+|---|---|---|
+| `list` 异构块（`types` + `typeKey`） | **支持**：新增条目时弹「Select List Type」，按 `name` 选型 | bundle 内 i18n 键 `select_list_type`、`list_type` 组件、`{types, typeKey='type'}` 解析路径 |
+| 内建 widget 全集 | `boolean/color/code/compute/datetime/file/hidden/image/keyvalue/list/map/markdown/number/object/relation/richtext/select/string/text/uuid` | bundle 中 `ok=[…]` 常量 |
+| `richtext`（所见即所得） | 支持，**落盘默认 markdown**（`field_defaults.richtext.format`，非 html） | bundle 中 `t===\`html\`?\`html\`:\`markdown\`` |
+| 嵌套深度硬限制 | **未发现**：bundle 里唯一 `nestedDepth` 属 folder 集合路径深度，与字段嵌套无关 | 全量 grep |
+| `list` 内再放 `list` | 类型表未排除，但**无保证** → 必须做一次 10 分钟后台实测冒烟（见 §8 P1 验收） | — |
+| 拖拽排序 / 每块 summary | 支持（`summary` 模板 + reorder） | 现网 posts/moments 已在用 |
+
+编辑体验判断：`blocks` 用 `types` 后，后台表现为「+ 添加 → 选块型 → 填该块字段」，列表可拖拽，每块可折叠。**代价**：字段标签必须写成中文短标签，否则块型选择弹窗会退化成英文 key。
+
+### 3.5 双语策略（三条路线，选 A）
+
+| 方案 | 做法 | 判断 |
+|---|---|---|
+| **A 字段级 `{zh,en}`（选）** | 每个文本字段仍是 `{zh,en}`，`en` 留空回落 `zh` | 与现状全站一致（`bilingual` schema + `pickBi`），后台一屏可见双语对照；缺点是块内字段数 ×2 |
+| B 两套块数组（`blocks_zh`/`blocks_en`） | 结构可漂移 | **否决**：块数与顺序会分叉，维护地狱 |
+| C en 构建期自动翻译 | 复用 `scripts/translate/` | **否决**：违反构建确定性（产物含未提交内容），且页面级译文无人校对 |
+
+配套：`pickBi` 之外新增构建期**缺译清单**（§7.3 断言 #8），把"哪些 en 字段回落成了 zh"打成 WARN，避免静默全英文页变中文。
+
+### 3.6 样式即数据（L4）边界表
+
+| 允许（12 项） | 形态 | 风险控制 |
+|---|---|---|
+| `--accent` | color（明/暗两值） | 构建期算对比度（对 `--bg`）< 4.5 → 报警并回落默认（红线"全站唯一强调色"只能调色相，不能变多色） |
+| `--radius-img` | number 4-16 | 钳制（08 文档裁定圆角上限 14） |
+| `--text-h1/h2/h3` | number 22-32 | 单调性校验 h1>h2>h3，否则回落 |
+| `--prose-size-reading/tech` | number 16-22 | 钳制 |
+| `--leading-reading/leading-tech` | number 1.5-2.0 | 钳制 |
+| `--space-3/4/5/6` | number 8-80 | 单调递增校验 |
+| `--flow-p` / `--flow-h2-post` | number 0-2（em） | 钳制 |
+| `--dur` | number 150-600（ms） | 钳制 |
+| `--font-*` | select（内置四族，不含任意字体名） | **必须**枚举：任意字体名会让 614 个 @font-face 瘦身成果失效 |
+
+**禁止**：`--measure`（9 处引用，改版心会连带 TOC/图库/首页栅格）、`--bp-*`（断点是媒体查询字面量）、`--code-bg/--code-ink`（Shiki `css-variables` 主题在 `astro.config.mjs` 之外耦合）、`--paper*`（书评纸墨是分轨身份）。
+**注入方式**：`BaseLayout` head 内联 `<style>`，选择器用 `:root:root{…}`（0,2,0）与 `[data-theme="dark"]:root:root{…}`（0,3,0）压过 `tokens.css` 的 `:root`（0,1,0）/`[data-theme="dark"]`（0,1,0）——**不能靠 DOM 顺序**（`global.css` 的 `<link>` 注入位置与 inline `<style>` 的相对次序不可控）。断言：明暗两态 `getComputedStyle(html).getPropertyValue('--accent')` 都等于 yaml 值。
+
+---
+
+## 4. 开源页：项目可见性 + GitHub README
+
+### 4.1 在途现状（已实现，不再设计，只定稿语义）
+
+- 字段：`mode(all|only|exclude)` / `include[]` / `exclude[]` / `sort(pinned-first|stars|updated)` / `perSource(both|github|gitea)` / `pinned[]` / `intro_from(off|github-readme)`（`content/site/opensource.yaml`、`src/content.config.ts:128-138`、`src/lib/site-content.ts:180-201`）。
+- 过滤实现：`perSource` → `mode` → `sort`，**不截断**，上限交给调用方（`src/lib/projects.ts:99-134`；这修掉了旧 `orderPinned` 内 `.slice(0,6)` 导致 `/opensource` 文案说"全部仓库"实际只显示 6 条的旧账）。
+- 匹配键 = **仓库短名**（`name`），跨源同名先去重（同名优先 gitea 叙事，star 取 GitHub 真值，`src/lib/projects.ts:76-88`）。
+
+### 4.2 语义定稿（必须写进后台 hint，否则用户会填错）
+
+1. `mode: only` 时 **忽略** `exclude`；`mode: exclude` 时**忽略** `include`（v1 不做两者求交）。
+2. `include/exclude` 填不存在的名字 = 静默无效（后台无下拉可选，因为仓库清单是构建期才拿到）；→ 建议 P2 阶段把 `widget: string` 改成 `widget: select, options` 的**静态镜像**（yml 里手抄一份当前仓名）不划算，**v1 保持手填 + 构建期 WARN 打印未命中的名字**。
+3. `sort: pinned-first` 仍是默认（首页要"置顶在前"叙事），`sort: stars|updated` 时 `pinned` 让位（现实现如此：`arrange` 里 stars/updated 分支直接 sort，不看 pinned）。
+4. 首页固定 `limit=6`，开源页 `limit=99`（`ProjectWall.astro` props）。若仓库总数 >99 需调大，非阻塞。
+
+### 4.3 是否用 GitHub profile README 作为开源页开篇 —— **可行，推荐按"默认关、用户开"上线**
+
+| 评估项 | 结论 |
+|---|---|
+| 接口 | `GET /repos/wait4xx/wait4xx/readme` + `Accept: application/vnd.github.raw` = 一次请求返回 markdown 原文（现实现已如此，`site-content.ts:235-238`） |
+| 限流 | 认证 5000 req/h；构建按 push 触发（webhook ~10 秒级），每天最多几十次 → 无压力。匿名 60 req/h 会更紧张，**必须走 token** |
+| token | 复用 `~/docker_apps/blog/github-token.txt`（`src/lib/heatmap.ts:21` 同一份，0600，read 权限足够）；**缺位是合法降级路径**，不报错只 WARN |
+| CORS | **不涉及**：node 侧构建期 fetch，不是浏览器请求。（若哪天想做成客户端拉取，CORS 会直接堵死，且违反"构建期零运行时"） |
+| 许可 | 内容属本人 profile 仓（`wait4xx/wait4xx`），无第三方版权问题；README 若嵌第三方徽章图 = 外链图片，**构建期不下载、浏览器直连**，需接受 |
+| 渲染质量 | README 常见 `<p align="center">`、徽章 `<img>`、`<details>`、表格、外链图片的**相对路径**（渲染到 `/opensource/` 下会 404）。现状只做了基础排版类（`opensource.astro` 的 `.readme-intro :global(...)` 段） |
+| 破版风险 | 中：README 常含居中对齐/大标题/emoji 徽章，与"灰阶克制 + 版心 720px"张力大。→ 建议 **P5 做一次视觉复核**，必要时给 `.readme-intro` 加 `img{max-height}`、`h1{display:none}` 折叠 |
+
+**缓存实现缺陷（必改）**：`README_CACHE = 'content/.github-readme.md'`（`site-content.ts:204`）写在仓内，而构建仓每次 `git fetch && reset --hard && git clean -fd`（`infra/deploy/build.sh:26`）会**抹掉未入仓缓存**——即"网络失败回落缓存"这层在生产构建里**永远命中不了**，实际回落链退化为"网络 → 无 → yaml blurb"。
+修法（二选一，推荐后者）：
+- (a) 把缓存文件提交入仓，靠人工/定时提交更新 —— 引入"构建机写仓"脏状态，与"构建仓硬跟 origin/main"纪律冲突；
+- (b) **移到仓外**：`~/docker_apps/blog/github-readme-cache.md`（与 token 同目录，天然持久，不被 clean 波及），TTL 24h（符合 GitHub API 缓存建议），并在 `writeFileSync` 失败时只 WARN。
+
+### 4.4 失败回落矩阵（开源页）
+
+| 失败点 | 现状行为 | 目标 |
+|---|---|---|
+| token 缺位 | WARN → 缓存 → null → 用 yaml blurb | 同（缓存改仓外后才有意义） |
+| README 404 / 仓不存在 | WARN → 缓存 → blurb | 同 |
+| 网络超时 | 现实现**无 AbortSignal 超时**（`projects.ts` 有 10s，README 没有）→ 挂起风险 | 补 `AbortSignal.timeout(8000)` |
+| README 为空 | WARN → 缓存 → blurb | 同 |
+| gitea 源整站 522（历史事故） | `Promise.allSettled` 单源失败不影响另一源 | 保持 |
+| 双源全失败 | 仓内 `projects-fallback.json`（**现仅 1 条**） | 建议 P5 用一次真实构建产物回填 5-8 条 |
+
+---
+
+## 5. 关于页整页化
+
+### 5.1 现有结构 → 区块映射（逐元素，无遗漏）
+
+| 现有元素 | 文案来源 | 现状可否后台改 | 对应块型 |
+|---|---|---|---|
+| `<h1>关于` | `ui.ts:73` | ✗ | 页面 `title` 字段（或沿用字典） |
+| intro 多段 markdown | `about.yaml intro.{zh,en}` | ✓ | **prose 块**（`intro` 字段保留为兼容回退） |
+| 名片区（头像+名字+tagline+社交） | `IdCard` + `home.yaml` | 部分 ✓（tagline/socials 来自 home） | **layout.showIdCard 开关**（不拆成块：头像数据单一事实源在 home.yaml） |
+| 「兴趣版图」标题 | `ui.ts:74` | ✗ | tracks 块的 `title` |
+| 3 条 track（图标+名称+描述） | `ui.ts:75-80` | ✗ | tracks 块的 `items[]`（icon 键 + name/desc 双语） |
+| 「本站如何构建」标题+正文 | `ui.ts:81-83` | ✗ | prose 块的 `title` + `body` |
+
+→ **覆盖现有 About 只需 3 个块**（prose + tracks + prose）。其余块型是为"用户以后想加东西"准备的（§5.2）。
+
+### 5.2 区块类型清单（v1 九类，够用且不失控）
+
+| type | 字段（* = `{zh,en}`） | 说明 |
+|---|---|---|
+| `prose` | `title*?` `body*`(richtext/markdown) `width(narrow|full)` | 主力自由区（受 §7 净化） |
+| `tracks` | `title*` `items[]{icon, name*, desc*}` | 覆盖现有兴趣版图；`icon` 走内置键白名单 |
+| `cards` | `title*?` `columns(2|3)` `items[]{title*, desc*, href?, tag?}` | 技能/资源卡（复用 `.track-row` 视觉语言） |
+| `timeline` | `title*?` `items[]{time, title*, desc*?}` | 经历/项目时间线（复用 `MomentsPage` 的 `.tl-*` 竖线语言） |
+| `quote` | `text*` `cite?` | 复用 `.quote-line` + `--font-kai`（08 文档 D 金卡） |
+| `figure` | `image`(image()) `caption*?` `alt` | 必须走 Astro 图片管线 |
+| `linklist` | `title*?` `items[]{label*, href, note*?}` | 外链清单（比 markdown 裸链接可控） |
+| `cta` | `text*` `href` `label*` | 单按钮行动点（克制：同屏最多 1 个） |
+| `divider` | `style(line|space)` | 节奏控制（非装饰色彩） |
+
+**不做**（放进 §9）：`html` 块、`style` 块、`columns[grid]` 栅格构建器、任意 svg 块。
+
+### 5.3 示例 yaml（直接照抄可跑通现有关于页）
+
+```yaml
+# content/site/about.yaml
+layout:
+  showIdCard: true
+  container: narrow          # narrow=.container(720) / wide=.container-wide(+200px)
+  # 以下为可选：不填则沿用标题「关于」
+  # title: { zh: 关于, en: About }
+blocks:
+  - type: prose
+    title: { zh: '', en: '' }        # 留空不渲染标题
+    width: narrow
+    body:
+      zh: |
+        写作者 · 读者 · 快门按压者，拥抱开源。
+
+        这里是我三条轨道的公开工作台：**读过的书**留下评注，**写过的代码**进项目墙，**按下的快门**收入图库。
+      en: |
+        Writer · Reader · Shutter-presser, embracing open source.
+  - 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 — …' }
+      - icon: camera
+        name: { zh: 摄影, en: Photography }
+        desc: { zh: 街拍与山野……, en: 'Street and landscapes with a mirrorless camera, …' }
+  - type: prose
+    title: { zh: 本站如何构建, en: How this site is built }
+    body:
+      zh: 静态生成，构建即发布；字体自托管，评论自托管，全文索引在构建期生成。
+      en: Statically generated, publish-on-build; self-hosted fonts, comments, and a build-time search index.
+```
+
+`icon` 键白名单（代码侧注册，同 `SocialLinks` 纪律 `src/components/SocialLinks.astro:7-19`）：`book / terminal / camera / code / git / rss / email / github / bilibili / x / star / link`。后台填表外的键 → 渲染纯文字（不破版）。
+
+### 5.4 视觉保留（不动设计体系）
+
+- 类名与样式从 `AboutPage.astro:70-143` **原样搬迁**到 `src/components/blocks/*.astro`：`.sec-title`（mono 14px/ink-3/0.08em）、`.track-row`（1px `--line` + radius 10px + `--space-3/4` 内距）、`.track-icon`（36×36 / `--bg-soft`）。
+- 新增块**只允许**用既有 token；新组件不得引入新颜色字面量（用 `--ink-*`/`--line`/`--bg-soft`）。这条要在评审时按 `grep '#[0-9a-fA-F]\{6\}' src/components/blocks/` 结果把关（`ProjectWall` 的语言色点是既存例外，不得扩散）。
+- 关于页 `--measure` 版心不变（prose 块 `max-width: var(--measure)`，`AboutPage.astro:85`）。
+
+### 5.5 兼容与零回归
+
+- `intro` 字段**不删**：`getAboutBlocks()` 见 `blocks` 缺省/空数组 → 走旧路径（`intro` markdown → 默认文案）。这样 Sveltia 里手滑清空 blocks 不会白页。
+- `t('about_track_*')` 等字典键**不删**：作为 `SITE_DEFAULTS` 的英文默认源；字典继续服务"没有 blocks 的旧数据"。
+- zh/en 双路由共用 `AboutPage.astro`（`src/pages/about.astro`、`src/pages/en/about.astro`），**块数据只存一份**，locale 在读取层选字段 —— 这是 en 轨不漂移的结构保证。
+
+---
+
+## 6. 首页扩展（结构化，不上 blocks）
+
+理由：首页是**聚合页**（列表/影像/热力图/项目墙都是"取集合切片"），块构建器在这里只会增加"选块型 → 填聚合配置"的绕路，且首页 zh/en 是两份重复文件（`src/pages/index.astro` vs `src/pages/en/index.astro`），更适合"字段少而稳"。
+
+| 已有（在途） | 建议补 | 字段形态 | 落地 |
+|---|---|---|---|
+| `tagline` `subtitle` | — | `{zh,en}` | `site-content.ts:160-175` |
+| `sections{tracks,photos,heatmap,projects}` | `heartbeat`（心跳行开关） | boolean | 同上 |
+| `perTrackLimit`(4-8) | `postsTracks`（显示哪几条轨，默认 reading+tech） | select multiple | 需给 `PostList` 加 `tracks` prop |
+| `latestPhotos`(0-6) | `photosSource(curated|latest)`：curated 读 `photos` 集合的 `pinned` 标记 | select | 需给 photos schema 加 `pinned` |
+| — | `heroStyle(idcard|plain)` | select | `IdCard` 加 variant |
+| — | `projectsLimit`(0-8，0=隐藏) | number | 传给 `ProjectWall limit` |
+| — | `announcement`（一段 markdown 短公告，渲染在 tagline 下） | `{zh,en}` markdown | 复用 `renderMarkdown`（须走净化） |
+
+**风险**：`index.astro` 与 `en/index.astro` 是**手抄双份**，任何新字段必须在两处同时接；建议 P4 顺手抽出 `src/components/pages/HomePage.astro`（吃 `locale` prop），双页变薄壳 —— 这是"双语不漂移"的结构性修法，先于新字段做。
+
+---
+
+## 7. 安全与构建可靠性
+
+### 7.1 现状漏洞（三条，均已定位到行）
+
+1. **白名单对页面文案不生效**：`renderMarkdown()` 调 `createMarkdownProcessor()` **无参**（`src/lib/site-content.ts:124`），`@astrojs/markdown-remark` 用默认 `rehypePlugins: []`（`node_modules/.pnpm/@astrojs+internal-helpers@0.13.0/.../markdown.js:21`），且默认 `allowDangerousHtml: true` + 结尾无条件挂 `rehype-raw`（`@astrojs/markdown-remark/dist/index.js:53-56,80`）。→ **`about.yaml` 的 raw HTML 直通 `set:html`**（`AboutPage.astro:20`），`<script>`/`style`/`on*` 全不被剥。文章管线有白名单（`astro.config.mjs:28`），页面文案管线**没有**。
+2. **README 是远程内容**：`githubReadmeMarkdown()` 把网上下来的 markdown 直接进 `set:html`（`src/pages/opensource.astro:17`）。即便 README 属本人仓，也等于把"远程内容"当可信 HTML 处理。
+3. **`style` 属性会用内联样式破灰阶**：现白名单剥 `style`，但只对文章生效；块模型若不统一走净化管线，同样的洞会出现在关于页。
+
+### 7.2 三道防线（按顺序实施）
+
+**D1 修管线（一处修两洞，P0）**
+```ts
+// src/lib/site-content.ts
+const { createMarkdownProcessor } = await import('@astrojs/markdown-remark');
+mdProcessor ??= createMarkdownProcessor({
+  rehypePlugins: [rehypeRaw, rehypeClassWhitelist, rehypeLinkCards], // 与 astro.config.mjs:28 同序
+});
+```
+副作用（正向）：页面 markdown 里的独立成段链接**也会变成 OG 卡片**（`rehypeLinkCards` 现已带 `content/.link-cache.json` 缓存），这是"免费能力"，需在写作指南里说明。
+
+**D2 加 tag 级允许清单（P0，扩展 `src/lib/rehype-class-whitelist.ts` 或新建 `rehype-content-sanitize.ts`）**
+- 允许标签：`p br strong em del code pre blockquote ul ol li a img h2 h3 h4 hr table thead tbody tr th td figure figcaption span div`（**不含** `script style iframe object embed form input link meta svg`）。
+- 属性允许：`a[href,title,rel]`、`img[src,alt,width,height,loading]`、其余仅 `class`（白名单）+ `id`（heading 锚）。
+- 协议允许：`http: https: mailto:` + 站内相对路径；`javascript:`/`data:`（除 `image/*` 小图外）一律剥。
+- 未知块 `type` → 跳过 + WARN，**不炸构建**。
+
+**D3 图片必须走管线（P1，随块模型）**
+- 块内 `image` 字段声明为 `image()`（Astro helper），媒体目录 `content/site/assets`（`public_folder: ./assets`，与 avatar 现状一致，`config.yml:117-118`）。
+- 禁止在块里填 `/media/...` 或外链图（**schema 层拦**：`z.string().refine(s => !/^https?:/.test(s))`，只放行 `image()` 类型）。体积纪律沿用写作指南（单张 ≤1MB）。
+
+### 7.3 验收断言清单（可直接写成 Playwright / grep 断言）
+
+| # | 断言 | 手段 |
+|---|---|---|
+| 1 | 关于页块数与顺序 == yaml（含 `enabled:false` 被滤掉） | `page.locator('[data-block]')` 逐个取 `data-block` 属性拼串比对 |
+| 2 | 零配置零回归：`about.yaml` 只有 `intro` 时，`/about/` 与改动前快照一致 | 旧产物 dist 对比（`diff <(grep -o 'class="[^"]*"' old) new`） |
+| 3 | 注入负向测试：`intro` 写 `<script>alert(1)</script>` 与 `<span style="color:red">` → 构建后 dist 不含 `alert(1)`、不含 `style="color` | `grep -c` 必须为 0 |
+| 4 | 类白名单：`<span class="font-kai foo">` → 只留 `font-kai` | 同上 grep |
+| 5 | 未知块型不炸：yaml 写 `type: not-a-block` → 构建成功 + stderr 含 WARN + 页面无该块 | 手跑一次 build |
+| 6 | 缺译可见：`en` 全空的页面 → 渲染 zh 文案 + 构建 WARN 列出字段路径 | 静态检查 build 输出 |
+| 7 | tokens 生效与压过：明暗两态 `--accent` == yaml 值；`--radius-img` 同 | `getComputedStyle(document.documentElement).getPropertyValue('--accent')` |
+| 8 | 对比度闸门：token 化颜色对 `--bg` ≥4.5:1（含暗色态） | 构建期脚本 `scripts/build-perf/contrast-check.mjs`（相对亮度公式，08 文档同口径） |
+| 9 | 图片走管线：dist 中关于页图片 `src` 含 `/_astro/` 且带 `width/height` | grep |
+| 10 | 项目墙可见性：`mode: only, include: [blog, pi-board]` → dist `/opensource/` 的 `.repo-name` 恰 2 条；`mode: exclude` 同理 | Playwright 计数 |
+| 11 | README 回落：把 token 文件改名后构建 → `/opensource/` 仍出开篇（缓存或 blurb），构建 exit 0 | 手工一次 |
+| 12 | 构建期零运行时：`dist/about/index.html` 新增 inline `<script>` 数为 0（相对基线） | grep 计数对比 |
+
+### 7.4 失败回落纪律（写进读取层，不散在组件里）
+
+| 数据 | 缺省/损坏时 | 目标 |
+|---|---|---|
+| `blocks` 空/缺 | → `intro` → `SITE_DEFAULTS.aboutIntro` | 页面永不空 |
+| 某块缺必填字段 | zod 报错即构建失败（**块内必填**要谨慎：`title` 设 optional，`body` 必填） | 宁可构建失败也不出半块 |
+| 块文本超长 | 读取层截断 + WARN | 防"一顿贴整篇长文" |
+| theme.yaml 非法值 | 钳制/回落默认 + WARN | 绝不让一个 `#zzz` 拖垮构建 |
+| 项目 API 全挂 | fallback JSON | 已有 |
+| README 全挂 | 仓外缓存 → yaml blurb | §4.4 |
+
+---
+
+## 8. 分阶段实施清单
+
+| 阶段 | 内容 | 工作量 | 依赖 | 落地文件 | 验收 |
+|---|---|---|---|---|---|
+| **P0** | 修 markdown 管线（D1）+ tag 白名单（D2）+ 负向断言 #3/#4 | 0.5d | 无 | `src/lib/site-content.ts`、`src/lib/rehype-content-sanitize.ts`(新)、`tests/e2e.mjs` 或 `scripts/build-perf/content-lint.mjs` | 断言 3/4 绿，现有文章渲染零回归 |
+| **P0.5** | 后台实测冒烟：`list` 内嵌 `list`、`richtext` 嵌套在 `object` 内是否可用 | 0.2d | 无（需 token 登录一次） | 无代码，结论回写本文 §3.4 | 能新增/拖拽/保存并构建通过 |
+| **P1** | blocks 骨架：schema + `page-blocks.ts` + `BlockRenderer` + prose/tracks/divider 三块 + 后台 `types` 声明 | 2d | P0、P0.5 | `src/content.config.ts`、`src/lib/page-blocks.ts`、`src/components/blocks/*`、`src/components/pages/AboutPage.astro`、`public/admin/config.yml` | 断言 1/2/5/6 |
+| **P2** | 块型扩充（cards/timeline/quote/figure/linklist/cta）+ 图标键白名单 + 图片走管线（D3） | 1.5d | P1 | 同上 + `content/site/assets/` | 断言 9；视觉复核一轮（glm-5.3-flash） |
+| **P3** | theme.yaml + `theme.ts` + BaseLayout 内联变量 + 对比度闸门脚本 | 1d | P0（净化不相关，可并行） | `content/site/theme.yaml`、`src/lib/theme.ts`、`src/layouts/BaseLayout.astro`、`scripts/build-perf/contrast-check.mjs`、`public/admin/config.yml` | 断言 7/8 |
+| **P4** | 首页字段细化 + 抽 `HomePage.astro` 消双份 | 1d | P0 | `src/components/pages/HomePage.astro`(新)、`src/pages/index.astro`、`src/pages/en/index.astro`、`site-content.ts` | zh/en 区块数一致；开关组合抽测 |
+| **P5** | 开源页收尾：README 缓存移仓外 + 超时 + fallback JSON 回填 5-8 条 + `include` 未命中 WARN | 0.5d | 在途车道合并 | `src/lib/site-content.ts`、`src/data/projects-fallback.json` | 断言 10/11 |
+| **P6** | 文档：`docs/管理台.md`（块编辑怎么用）、`docs/写作指南.md`（受限类 + 块字段）、`public/admin/config.yml` hint 全量中文 | 0.5d | P1-P4 | 三文件 | 后台每字段都有中文 hint |
+
+合计 ≈7.2d（不含视觉复核排队）。**建议顺序**：P0 → P0.5 →（P1 与 P3 可并行）→ P2 → P5 → P4 → P6。P5 最便宜且能立刻消掉在途车道的生产隐患，可提前插队。
+
+---
+
+## 9. 明确不做（附理由）
+
+1. **任意 HTML/`style` 块**：等于把灰阶骨架与 XSS 面交给后台输入；08 文档红线（禁渐变/玻璃/大圆角）无法用代码守住。
+2. **可视化栅格/自由拖拽布局（columns、grid 编辑器）**：Astro 侧要一套运行时布局引擎，违"构建期零运行时"；且移动端塌陷规则无法交给后台。
+3. **可编辑颜色集（多个强调色/任意 hex 用于文本）**：全站唯一强调色是丙路线根基（`tokens.css:21-22`），只允许 `--accent` 一个旋钮并过对比度闸门。
+4. **`--measure` / 断点可调**：`--measure` 9 处引用、断点写死在媒体查询里；改版心会连带 TOC/栅格/图库。
+5. **任意字体名输入**：字体子集化（`scripts/build-perf/subset-font-css.mjs`）依赖固定四族，自由输入会静默失效或拖大 CSS。
+6. **块模型用于首页**：首页是聚合页（§6），结构化字段更稳、更好审。
+7. **`blocks_zh`/`blocks_en` 双数组**：结构会分叉。
+8. **构建期自动翻译页面文案**：破坏构建确定性（产物含未提交内容），且无人校对。译文必须入仓（沿用 `posts-en` 的 `locked: true` 纪律）。
+9. **运行时/客户端渲染页面内容**（含客户端拉 GitHub README）：CORS、SEO、性能三杀。
+10. **后台新建任意页面路由（v1 不做）**：需 `[...slug].astro` + 导航/站点地图/双语配对/`hidden` 语义，收益低于成本；等关于页验证过一轮再议（那时复用同一套 BlockRenderer，成本会低很多）。
+11. **换 CMS / 上 Netlify 式可视化编辑器**：现有 Sveltia 0.252 已支持 `types` 异构列表（§3.4），够用；迁移成本远高于收益。
+12. **每页独立 tokens**（页面级主题覆盖）：双层变量来源会让"某页为什么和别的页不一样"变成排查噩梦；v1 只有全局一套。
+
+---
+
+## 附：待用户拍板的三个岔路
+
+1. **关于页块模型 vs 长文**：块模型（本文推荐，结构可控、视觉一致）vs 单一 markdown 长文（改起来最快，但 tracks 卡片做不出来）。
+2. **README 开篇是否开**：开（省手工维护，但版式受 GitHub README 影响）vs 关（`intro_from: "off"`，全手控）。
+3. **样式旋钮范围**：只给 3 个（accent/radius/字号）还是一整套 12 个（§3.6）——旋钮越多越需要对比度闸门与视觉复核，建议先给 3 个、跑稳一版再扩。
@@ -2,6 +2,36 @@

 > 适用：`content/posts/*.md`（书评与技术轨通用）。资产目录约定 + 三种媒体的写法 + 体积纪律。

+## 写作模板（从这里开始，2026-11-02 起）
+
+别从空白文件起步——**复制现成的模板**：
+
+```bash
+cp content/posts/writing-template.md content/posts/my-new-post.md
+# 改 frontmatter 的 title / pubDate / tags / description，删掉不需要的段落
+```
+
+模板本身是一篇真文章（线上读：`/archives/writing-template/`），每节都在跑一种能力，你看到的效果就是源码的效果：标题层级、三处彩色强调、两族字体、引用、列表、代码窗条、表格、图片放大、链接卡片、`<details>` 折叠、分隔线。
+
+写之前只需记住三条纪律：
+- **彩色 ≤3 处/页**：外壳是灰阶，颜色只用来给某个判断加重；超过就花哨
+- **整页换字族要谨慎**：会给访问者拉一份中文字体（汇文明朝整页约 420KB，已子集化）
+- **折叠放细节不放结论**：`<details>` 里的内容可能永远没人展开
+
+## 置顶文章
+
+首页、归档、书架三处列表默认按日期倒序。想让某篇长期排在最前，frontmatter 加一行：
+
+```yaml
+pinned: true
+```
+
+语义边界（刻意设计成这样）：
+- **只影响列表顺序**，不改 `pubDate`、不改 URL、不影响 RSS 的时间序列（订阅者不会看到时间错乱）
+- 多篇同时置顶时，它们内部仍按日期倒序
+- 列表里会显示一个灰阶「置顶」小徽标，取消置顶后立刻回到时间序
+- 后台「文章」编辑页有「置顶」开关，不必手改 frontmatter
+
 ## 目录约定

 ```
@@ -88,19 +118,100 @@ https://astro.build/

 正文里可用 `<span class="…">` / `<p class="…">` 做**受限**排版。构建期有白名单过滤：**只放行下表类名，其它 class 与 `style`、`on*` 属性一律被剥离**（防注入 + 保护灰阶骨架）。

+### 灰阶层级类（全部实测亮暗对比度 ≥4.5:1）
+
 | 类名 | 作用 |
 |---|---|
-| `ink-1` / `ink-2` / `ink-3` | 指定灰阶层（正文/次要/更淡） |
+| `ink-1` / `ink-2` / `ink-3` | 指定灰阶层（标题/正文/次要） |
 | `ink-muted` | 最淡灰（注释感） |
-| `ink-accent` | 强调色（链接色，仅少量点缀） |
-| `font-serif` | 思源宋（书评正文族） |
-| `font-kai` | 霞鹜文楷（金句族） |
-| `font-sans` | 思源黑（UI/技术族） |
-| `font-mono` | 等宽族（标签/数值） |
+| `ink-faint` | 最淡**可读**档（再淡即不达 AA） |
+| `ink-warm` | 暖调正文（书评气质） |
+| `ink-cool` | 冷调正文（技术气质） |
+| `ink-accent` | 强调（链接色，少量点缀） |
+| `ink-accent-soft` | 弱强调（比强调淡一档） |
+
+### 语义色板（8 色相 × 标准/soft；亮暗各自取值，实测全部 ≥4.5:1）
+
+| 色相 | 标准类 | soft 类 | 亮态对比度（标准 / soft） | 暗态（标准 / soft） |
+|---|---|---|---|---|
+| 蓝 | `c-blue` | `c-blue-soft` | 6.46 / 4.58 | 7.70 / 4.61 |
+| 青 | `c-teal` | `c-teal-soft` | 5.00 / 4.57 | 9.77 / 4.52 |
+| 绿 | `c-green` | `c-green-soft` | 5.38 / 4.67 | 10.38 / 4.67 |
+| 黄 | `c-yellow` | `c-yellow-soft` | 6.45 / 4.57 | 11.73 / 4.52 |
+| 橙 | `c-orange` | `c-orange-soft` | 6.26 / 4.65 | 9.44 / 4.58 |
+| 红 | `c-red` | `c-red-soft` | 6.68 / 4.55 | 7.51 / 4.50 |
+| 粉 | `c-pink` | `c-pink-soft` | 6.96 / 4.73 | 8.87 / 4.52 |
+| 紫 | `c-purple` | `c-purple-soft` | 7.46 / 4.53 | 8.25 / 4.64 |
+
+- 黄色在亮态被压暗到 `#7a5900`（原色在白底只有 ~1.8:1），这是**必须**的：彩色文字要能读
+- `soft` 档是"阈值内最淡值"，适合次要强调；标准档用于关键强调
+
+> **使用纪律（重要）**：彩色**只作用于文章正文的强调文字**。站点外壳（导航、页脚、按钮、背景、卡片边框）一律保持灰阶——整站不因正文用色而花掉。写作时一个页面里的彩色强调建议不超过 3 处。
+
+### 字体类
+
+| 类名 | 作用 | 字体 | 许可证 | 加载 |
+|---|---|---|---|---|
+| `font-serif` | 书评正文族 | Noto Serif SC | OFL-1.1 | 自托管 |
+| `font-kai` | 金句族 | 霞鹜文楷 Screen | OFL-1.1 | 自托管 |
+| `font-sans` | UI/技术族 | Noto Sans SC | OFL-1.1 | 自托管 |
+| `font-mono` | 标签/数值 | JetBrains Mono | OFL-1.1 | 自托管 |
+| `font-song` | 宋体族 | Noto Serif SC 优先，系统宋体兜底 | OFL-1.1 | **自托管优先** |
+| `font-kai-sys` | 楷体族 | 霞鹜文楷优先，系统楷体兜底 | OFL-1.1 | **自托管优先** |
+| `font-hei-sys` | 黑体族 | Noto Sans SC 优先，系统黑体兜底 | OFL-1.1 | **自托管优先** |
+| `font-fangsong` | 仿宋族 | FangSong/STFangsong | — | ⚠️ **纯系统回退**（暂无 OFL 自托管仿宋包） |
+
+### 文学排版类（段落级）
+
+| 类名 | 作用 |
+|---|---|
 | `drop-cap` | 段落首字下沉（书评开篇） |
 | `quote-line` | 金句块（左侧竖线 + 文楷） |
 | `fig-cap` | 图注（居中小字） |

+### 首批字体（已落地，6 族 + 3 档自托管优先）
+
+| 类名 | 字体 | 许可证 | webfont 嵌入 | 用到该字体的页面增量 |
+|---|---|---|---|---|
+| `font-serif` | Noto Serif SC | OFL-1.1 | ✅ OFL 允许 | 基线内 |
+| `font-sans` | Noto Sans SC | OFL-1.1 | ✅ | 基线内 |
+| `font-kai` | 霞鹜文楷 Screen | OFL-1.1 | ✅ | 基线内 |
+| `font-mono` | JetBrains Mono | OFL-1.1 | ✅ | 基线内 |
+| `font-huiwen` | 汇文明朝体（文风切片包 339 片） | OFL-1.1 | ✅ | **535KB** |
+| `font-kuaile` | 站酷快乐体 | OFL-1.1 | ✅ | **163KB** |
+| `font-song` / `font-kai-sys` / `font-hei-sys` | 上述自托管字体优先，系统字族兜底 | OFL-1.1 | ✅ | **+0KB** |
+
+体积账结论（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 嵌入 | 未落地原因 |
+|---|---|---|---|
+| HarmonyOS Sans | 华为字体许可（免费商用） | ✅ 明文允许"嵌入、捆绑、重新分发"，需标注 | npm 无包，官网整包 52MB |
+| MiSans | 小米字体许可（免费商用） | ✅ 官方 FAQ 明确 "embedded fonts: Yes"，需注明 | npm 无包 |
+| OPPO Sans | 免费授权（含商用） | ✅（附带"不向他方提供下载渠道"限制） | npm 无包 |
+| 阿里巴巴普惠体 | 免费商用全场景 | ✅ | npm 无包，9 字重体积巨大 |
+| 得意黑 Smiley Sans | OFL-1.1 | ✅ | 仅 GitHub release 整包，直链在当前网络不可达 |
+| 更纱黑体 Sarasa Gothic / Sarasa Mono | OFL-1.1 | ✅ | npm 包为空壳（需 cli 自生成切片） |
+| 花园明朝 HanaMinA/B | IPA Font License | ✅（允许嵌入） | 无 npm 包，仅兜底用 |
+| 站酷高端黑 / 站酷快乐体（已落） | OFL-1.1 | ✅ | 高端黑无 @fontsource 版本 |
+| 阿里妈妈东方大楷 / 演示悠然小楷 | 免费商用 / 个人免费 | ⚠️ 需逐款核嵌入条款 | 无包；"个人免费"字体常禁 @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/页 的要评估是否值得；展示类字体再跑一次 `scripts/build-perf/subset-fonts.py` 按实际用字裁切（命令见上节）。
+
 ```markdown
 <span class="ink-muted">次要说明</span>
 <span class="font-kai">金句可以换文楷</span>
@@ -111,6 +222,82 @@ https://astro.build/
 - **颜色只能走上面这些类**（内部用 tokens，亮暗双态都可读）；写 `style="color:red"` 会被构建期剔除
 - 斜体就用普通 markdown `*斜体*`——行内强调，不会换行也不会居中

+### 后台可视化选择（推荐，不用写 HTML）
+
+后台编辑器里：**选中文字 → 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），长段使用会显著抬高单页字体成本。
+
+## 瞬间（/moments）怎么写
+
+瞬间与文章一样支持富文本，但入口在后台「瞬间」集合（`content/moments/*.md`）：
+
+```yaml
+---
+pubDate: 2026-11-02
+tags: [随手拍]
+text: 今天把**置顶**做完了，顺手试了 <span class="c-teal">彩色</span>
+---
+```
+
+- `text` 支持 markdown（`**加粗**`、列表、`> 引用`）与**同一套排版类**（字体/颜色），因为走的是与全站文案相同的净化管线：危险标签整棵丢弃，只放行 35 项白名单类
+- 一条瞬间 = 一行时间线卡片，**每条都带独立评论区**（展开才挂载，双语页共用同一评论流，评论不分裂）
+- 每条的「浏览 / 评论」数字是只读统计（不会因为别人点开评论而虚增浏览）
+- `text` 与 `image` 至少填一项；图片建议先压缩
+
+## 页面块（关于页 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 秒）
@@ -203,6 +390,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,186 @@
 # 管理台（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 秒自动构建上线。
+
+## 文章置顶（5h 新增）
+
+文章编辑页有一个「置顶」开关。打开后这篇文章排在首页分轨、归档、书架三处列表的最前面，列表里显示一个灰阶「置顶」小徽标。
+
+语义边界（刻意如此，别当 bug 报）：
+- **只影响列表顺序**：`pubDate` 不变、URL 不变、RSS 里的时间序列不变，订阅者不会看到时间错乱
+- 多篇同时置顶时，置顶组内部仍按日期倒序
+- 关掉开关立即恢复时间序，没有"冷却期"
+
+## 瞬间（5h 起与文章同级）
+
+「瞬间」集合的「文字」字段是 **markdown 编辑器**，与文章同一套表达力：
+
+- markdown：`**加粗**`、`*斜体*`、列表、`> 引用`、`` `行内代码` ``
+- 排版类 HTML：`<span class="c-blue font-kai">彩色 + 楷体</span>`（可用类清单见写作指南「文章排版类」一节，与文章完全同一份白名单）
+- 仍守外壳灰阶纪律：彩色是**强调**不是装饰，一页 ≤3 处
+
+**每条瞬间自带评论区**：时间线卡片下方有「评论」折叠条，读者点开才加载评论（不点开不为它付任何加载成本）。中文页与英文页共用同一条评论流，语言切换不会丢评论。
+
+**每条的浏览 / 评论数字是只读的**：读者点开评论区不会虚增浏览数（只有整页访问才计一次）。
+
 ## 照片上传流

 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）
+
+**开篇是原生「GitHub 档案卡」（5h 起）**：头像 / 名字@handle / 定位叙述 / 社交图标 / 统计四格（关注者、公开仓、总星标）/ 语言占比灰阶条（只有第一名用强调色，其余灰阶）。**零第三方图片、零 iframe**。数据失败只隐藏对应数字，不会破版。
+
+想换那段「定位叙述」，改本文件的 `blurb` + `blurb_after`（双语，后台可改）——它们现在同时供给档案卡与项目墙下方的说明。
+
+下面的 `intro_from: "github-readme"` **仍可用但不推荐**：那会把 GitHub 专用 README 原样渲染，带 7 类外链图（shields.io、readme-typing-svg、github-readme-stats、streak-stats、activity-graph、snake、komarev 访客徽章）与 `<div align="center">` 居中——本站按普通块渲染，故居中失效；外链图在慢网或被墙时全空白。这也是当初"部分内容没居中、有些图片没显示"的根因。
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `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 都不影响页面渲染；尺寸已由样式限制在内容宽度内。
+
+## 浏览与评论计数（5h 新增）
+
+文章页、瞬间页、开源页、关于页都用同一枚灰阶徽标：**眼睛图标 = 浏览数，气泡图标 = 条评论**，数据来自自建 Artalk，不依赖任何第三方徽章服务。
+
+几条行为约定（省得当成 bug）：
+
+- **一页只计一次浏览**：「计一次」发生在这页唯一那个 `page` 模式徽标（文章页在标题下方），同一页其余徽标都是只读镜像，显示的是同一个数字——不会出现"页头 17、评论区 16"
+- **开评论不算浏览**：瞬间逐条徽标是只读的，读者展开评论区不会给那条动态虚增浏览量
+- **接口挂掉显示「–」而不是 0**：宁可留白，也不给读者看一个错误的零
+- **换页重计、同页刷新重计**：这是浏览量的定义，不是重复计数的 bug（软导航回同一页也算新一次访问）
+
 ## 纪律（与写作指南同源）

 - **图片体积**：上传前自行压缩（长边 ≤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 脚本未就绪，跳过"
@@ -16,6 +16,7 @@
    "@fontsource-variable/noto-serif-sc": "^5.3.1",
    "@fontsource/jetbrains-mono": "^5.3.0",
    "@fontsource/noto-sans-sc": "^5.3.1",
+    "@fontsource/zcool-kuaile": "^5.3.0",
    "astro": "^7.4.4",
    "astro-pagefind": "^2.0.1",
    "exifr": "^7.1.3",
@@ -26,6 +26,9 @@ importers:
      '@fontsource/noto-sans-sc':
        specifier: ^5.3.1
        version: 5.3.1
+      '@fontsource/zcool-kuaile':
+        specifier: ^5.3.0
+        version: 5.3.0
      astro:
        specifier: ^7.4.4
        version: 7.4.4(@astrojs/markdown-remark@7.3.5)(@types/node@24.19.2)(yaml@2.9.1)
@@ -265,6 +268,9 @@ packages:
  '@fontsource/noto-serif-sc@5.3.1':
    resolution: {integrity: sha512-nIK2HyNGcUi2TGwIfrk2MItkh0O3Y5+TI8iPfPSzoNY6uyXYfQ9qqch8czk3aa1VhV4EU52uwCYCe1UDKJELpg==}

+  '@fontsource/zcool-kuaile@5.3.0':
+    resolution: {integrity: sha512-jn4vpQ6QSVEckUn7uk5a9XcZMxEksTRqljmeE1VKRGMjGd6VoXdMyLGSdnTXSVwZLCCEHaIcm/2cdQuwvasJ9w==}
+
  '@img/colour@1.1.0':
    resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==}
    engines: {node: '>=18'}
@@ -2113,6 +2119,8 @@ snapshots:

  '@fontsource/noto-serif-sc@5.3.1': {}

+  '@fontsource/zcool-kuaile@5.3.0': {}
+
  '@img/colour@1.1.0': {}

  '@img/sharp-darwin-arm64@0.35.5':
@@ -38,6 +38,7 @@ collections:
      - { label: 日期, name: pubDate, widget: datetime, date_format: 'YYYY-MM-DD', time_format: false, format: 'YYYY-MM-DD' }
      - { label: 分轨, name: category, widget: select, options: [{label: 阅读, value: reading}, {label: 技术, value: tech}, {label: 照片, value: photo}] }
      - { label: 标签, name: tags, widget: list, required: false }
+      - { label: 置顶, name: pinned, widget: boolean, required: false, default: false, hint: '置顶文章排在首页/归档/书架最前；只影响顺序，不改日期、URL 与 RSS 时间语义' }
      - { label: 情绪色（书评色脊）, name: mood, widget: color, required: false, hint: '#RRGGBB，仅阅读轨使用' }
      - { label: 原书作者, name: bookAuthor, widget: string, required: false }
      - { label: 一句话描述（书架策展语）, name: description, widget: text, required: false }
@@ -58,8 +59,36 @@ collections:
      - { label: 草稿, name: draft, widget: boolean, required: false, default: false }
      - { label: 正文, name: body, widget: markdown }

-  # 瞬间：随手发（text/image 至少其一——Sveltia 无法表达条件必填，两者都设可选，
-  # 保存前自查；pubDate 必填）。图片走图库媒体库（content/photos 同源可复用）
+  # 主题旋钮（样式即数据 · 层 4）：只放白名单内的 9 组，越界值会被构建期钳制
+  - name: site_theme
+    label: 主题设置
+    # 文件集合必须是 files: [{file,label,fields}] 结构；把 file 直接写在集合层级会被 Sveltia 判非法（2026-11-02 实测报 "The file option ... is invalid"）
+    files:
+      - name: theme
+        label: 主题设置
+        file: content/site/theme.yaml
+        format: 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
    label: 瞬间
    folder: content/moments
@@ -69,7 +98,11 @@ collections:
    sortable_fields: [pubDate, text]
    fields:
      - { label: 时间, name: pubDate, widget: datetime, date_format: 'YYYY-MM-DD', time_format: false, format: 'YYYY-MM-DD' }
-      - { label: 文字, name: text, widget: text, required: false, hint: '一句话（与图片至少填一项）' }
+      - label: 文字
+        name: text
+        widget: markdown
+        required: false
+        hint: '与图片至少填一项。支持 markdown（**加粗**、列表、> 引用）与排版类 HTML，例如 <span class="c-blue font-kai">彩色+楷体</span>；装饰色仍守“外壳灰阶、彩色只作强调”的纪律'
      - { label: 图片, name: image, widget: image, required: false, hint: '与文字至少填一项；建议先压缩' }
      - label: 标签
        name: tags
@@ -113,6 +146,7 @@ collections:
      - name: home
        label: 主页设置
        file: content/site/home.yaml
+        format: yaml
        # 头像上传落 content/site/assets/，yaml 写 ./assets/xxx（Astro 图片管线优化）
        media_folder: content/site/assets
        public_folder: ./assets
@@ -120,9 +154,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,24 +255,312 @@ collections:
      - name: about
        label: 关于页
        file: content/site/about.yaml
+        format: yaml
+        # 块内图片上传落 content/site/assets/，yaml 写 ./assets/xxx（Astro 图片管线）
+        media_folder: content/site/assets
+        public_folder: ./assets
        fields:
-          - label: 正文（markdown，多段）
+          - 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
+                    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
-            hint: 渲染在「关于」标题下方、名片之上；支持段落/列表/粗斜体/链接；留空用默认文案
+            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
+        format: yaml
        fields:
          - 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: 叙述（链接后）
@@ -8,5 +8,8 @@
  <body>
    <!-- pinned 本地 bundle（0.252.0）：官方模板仅此一个 script，无 CSS link、无 type=module -->
    <script src="./sveltia-cms.js"></script>
+    <!-- 可视化排版选择：类清单（单一数据源）→ 编辑器组件注册（须在 CMS 之后、init 之前注册） -->
+    <script src="./typography-classes.js"></script>
+    <script src="./typography-editor.js"></script>
  </body>
 </html>
@@ -0,0 +1,50 @@
+/**
+ * 排版类清单 —— 单一事实源（后台编辑器面板与文档共用）。
+ * 与 src/styles/global.css 的「受限排版类/语义色板」段、src/lib/rehype-class-whitelist.ts 的白名单三处保持一致：
+ * 加类时三处同改，否则构建期白名单会把新类剥掉。
+ *
+ * swatch / family 仅供**后台面板预览**使用（后台无站点 CSS 变量，故给具体值）：
+ * swatch 取亮态值（后台是浅色 UI），family 为该类的真实字体栈。
+ */
+window.TYPOGRAPHY_CLASSES = {
+  font: [
+    { cls: 'font-serif', label: '思源宋（书评正文）', family: '"Noto Serif SC", Georgia, serif', kind: '自托管' },
+    { cls: 'font-kai', label: '霞鹜文楷（金句）', family: '"LXGW WenKai Screen", "Songti SC", serif', kind: '自托管' },
+    { cls: 'font-sans', label: '思源黑（UI/技术）', family: '"Noto Sans SC", system-ui, sans-serif', kind: '自托管' },
+    { cls: 'font-mono', label: 'JetBrains Mono（等宽）', family: '"JetBrains Mono", ui-monospace, monospace', kind: '自托管' },
+    { cls: 'font-song', label: '宋体族', family: '"Noto Serif SC", "Songti SC", SimSun, serif', kind: '自托管优先' },
+    { cls: 'font-kai-sys', label: '楷体族', family: '"LXGW WenKai Screen", "Kaiti SC", STKaiti, serif', kind: '自托管优先' },
+    { cls: 'font-hei-sys', label: '黑体族', family: '"Noto Sans SC", "PingFang SC", "Microsoft YaHei", sans-serif', kind: '自托管优先' },
+    { 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' },
+    { cls: 'ink-2', label: '正文', swatch: '#33343a' },
+    { cls: 'ink-3', label: '次要（日期/元信息）', swatch: '#6b6e78' },
+    { cls: 'ink-muted', label: '最淡（注释感）', swatch: '#70747c' },
+    { cls: 'ink-warm', label: '暖调正文', swatch: '#3f362e' },
+    { cls: 'ink-cool', label: '冷调正文', swatch: '#2f3742' },
+    { cls: 'ink-faint', label: '最淡可读档', swatch: '#70747c' },
+    { cls: 'ink-accent', label: '强调（链接色）', swatch: '#3454d1' },
+    { cls: 'ink-accent-soft', label: '弱强调', swatch: '#4f66c2' },
+    { cls: 'c-blue', label: '蓝', swatch: '#2456c9' },
+    { cls: 'c-blue-soft', label: '蓝（soft）', swatch: '#4170dd' },
+    { cls: 'c-teal', label: '青', swatch: '#0d7d74' },
+    { cls: 'c-teal-soft', label: '青（soft）', swatch: '#0e847a' },
+    { cls: 'c-green', label: '绿', swatch: '#1f7a3a' },
+    { cls: 'c-green-soft', label: '绿（soft）', swatch: '#22853f' },
+    { cls: 'c-yellow', label: '黄（已压暗）', swatch: '#7a5900' },
+    { cls: 'c-yellow-soft', label: '黄（soft）', swatch: '#926a00' },
+    { cls: 'c-orange', label: '橙', swatch: '#9a4a00' },
+    { cls: 'c-orange-soft', label: '橙（soft）', swatch: '#ba5900' },
+    { cls: 'c-red', label: '红', swatch: '#b32020' },
+    { cls: 'c-red-soft', label: '红（soft）', swatch: '#db3737' },
+    { cls: 'c-pink', label: '粉', swatch: '#a3246a' },
+    { cls: 'c-pink-soft', label: '粉（soft）', swatch: '#ce3386' },
+    { cls: 'c-purple', label: '紫', swatch: '#6a35b8' },
+    { cls: 'c-purple-soft', label: '紫（soft）', swatch: '#8c5ed1' },
+  ],
+};
@@ -0,0 +1,153 @@
+/**
+ * 后台可视化排版选择（Sveltia CMS 自定义编辑器组件）。
+ *
+ * 能力依据（sveltiacms.app/en/docs/api/editor-components，2026-11 核实）：
+ *  - inline 型组件（type:'inline'）在段落内以 pattern 匹配，可与选中文字互转；
+ *  - onInsert({ selectedText }) 拿到编辑器当前选中的文字，返回值经 toInline 生成 Markdown；
+ *  - inline 组件固定在 Insert 菜单下（trigger 对 inline 是文本触发，不能上工具栏）。
+ *
+ * 因此「选中文字 → 套字体/颜色」由**一个「排版」组件 + 自建分组面板**实现：
+ * 两个独立工具栏下拉（字体/颜色）会共用同一 span pattern 互相抢匹配，这里收成一个入口分两组，
+ * 交互上等价（选中 → Insert ▸ 排版 → 选类 → 文字被 <span class> 包住）。
+ * onEdit 支持点开已套用的片段改类。
+ */
+(function () {
+  const CLASSES = window.TYPOGRAPHY_CLASSES;
+  if (!CLASSES || !window.CMS) return;
+
+  /** 自建选择面板：返回 Promise<选中类名 | null>；无依赖、可键盘操作 */
+  function pickClass(current) {
+    return new Promise((resolve) => {
+      const wrap = document.createElement('div');
+      wrap.setAttribute('role', 'dialog');
+      wrap.setAttribute('aria-label', '选择排版');
+      Object.assign(wrap.style, {
+        position: 'fixed', inset: '0', zIndex: '99999', display: 'flex',
+        alignItems: 'center', justifyContent: 'center', background: 'rgba(8,10,14,.55)',
+      });
+      const card = document.createElement('div');
+      Object.assign(card.style, {
+        background: '#fff', color: '#111113', borderRadius: '12px', padding: '18px 20px',
+        width: 'min(560px, 92vw)', maxHeight: '80vh', overflowY: 'auto',
+        boxShadow: '0 8px 32px rgba(0,0,0,.28)', font: '14px/1.5 system-ui, sans-serif',
+      });
+      const title = document.createElement('p');
+      title.textContent = '选择排版（作用于选中文字）';
+      Object.assign(title.style, { margin: '0 0 12px', fontWeight: '600' });
+      card.appendChild(title);
+
+      const buttons = [];
+      const addGroup = (name, list, withSwatch) => {
+        const h = document.createElement('p');
+        h.textContent = name;
+        Object.assign(h.style, { margin: '12px 0 6px', fontSize: '12px', color: '#6b6e78' });
+        card.appendChild(h);
+        const row = document.createElement('div');
+        Object.assign(row.style, { display: 'flex', flexWrap: 'wrap', gap: '8px' });
+        for (const item of list) {
+          const b = document.createElement('button');
+          b.type = 'button';
+          b.dataset.cls = item.cls;
+          b.className = item.cls === current ? 'active' : '';
+          Object.assign(b.style, {
+            display: 'inline-flex', alignItems: 'center', gap: '8px',
+            padding: '6px 12px', borderRadius: '8px', cursor: 'pointer',
+            border: '1px solid ' + (item.cls === current ? '#3454d1' : '#e6e7eb'),
+            background: item.cls === current ? '#eef1fd' : '#fff',
+            color: '#111113', fontSize: '13px',
+          });
+          if (withSwatch) {
+            // 色块预览：直接展示该类在亮态下的实际颜色
+            const chip = document.createElement('span');
+            Object.assign(chip.style, {
+              width: '16px', height: '16px', borderRadius: '4px', flex: 'none',
+              background: item.swatch || '#ccc',
+              border: '1px solid rgba(0,0,0,.12)',
+            });
+            chip.setAttribute('aria-hidden', 'true');
+            b.appendChild(chip);
+          } else {
+            // 字体项：名称 + 用该字体栈渲染的示例字形
+            const sample = document.createElement('span');
+            sample.textContent = '秋海';
+            Object.assign(sample.style, {
+              fontFamily: item.family || 'inherit', fontSize: '15px', lineHeight: '1',
+              padding: '0 4px', borderLeft: '1px solid #e6e7eb', color: '#33343a',
+            });
+            b.appendChild(sample);
+          }
+          const label = document.createElement('span');
+          label.textContent = item.label + (item.kind ? `（${item.kind}）` : '');
+          b.appendChild(label);
+          row.appendChild(b);
+          buttons.push(b);
+        }
+        card.appendChild(row);
+      };
+      addGroup('字体', CLASSES.font, false);
+      addGroup('颜色', CLASSES.color, true);
+
+      const foot = document.createElement('div');
+      Object.assign(foot.style, { marginTop: '16px', display: 'flex', justifyContent: 'flex-end', gap: '8px' });
+      const cancel = document.createElement('button');
+      cancel.type = 'button';
+      cancel.textContent = '取消（Esc）';
+      Object.assign(cancel.style, { padding: '6px 12px', borderRadius: '8px', border: '1px solid #e6e7eb', background: '#fff', cursor: 'pointer' });
+      foot.appendChild(cancel);
+      card.appendChild(foot);
+      wrap.appendChild(card);
+
+      const prevFocus = document.activeElement;
+      const close = (val) => {
+        document.removeEventListener('keydown', onKey, true);
+        wrap.remove();
+        if (prevFocus && prevFocus.focus) prevFocus.focus();
+        resolve(val);
+      };
+      const onKey = (e) => {
+        if (e.key === 'Escape') {
+          e.preventDefault();
+          close(null);
+        } else if (e.key === 'Tab') {
+          // 焦点循环留在面板内
+          const list = [...wrap.querySelectorAll('button')];
+          const first = list[0], last = list[list.length - 1];
+          if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
+          else if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
+        }
+      };
+      wrap.addEventListener('click', (e) => {
+        const t = e.target;
+        if (t === wrap) return close(null);
+        if (t.dataset && t.dataset.cls) close(t.dataset.cls);
+        if (t === cancel) close(null);
+      });
+      document.addEventListener('keydown', onKey, true);
+      document.body.appendChild(wrap);
+      (buttons[0] || cancel).focus();
+    });
+  }
+
+  window.CMS.registerEditorComponent({
+    id: 'typography',
+    label: '排版（字体/颜色）',
+    icon: 'format_paint',
+    type: 'inline',
+    pattern: /<span class="(?<cls>[a-z0-9-]+)">(?<text>[^<]*?)<\/span>/,
+    toInline: ({ cls = '', text = '' }) => `<span class="${cls}">${text}</span>`,
+    toPreview: ({ cls = '', text = '' }) => {
+      const span = document.createElement('span');
+      span.className = cls;
+      span.textContent = text; // DOM 预览：textContent 天然转义
+      return span;
+    },
+    onInsert: async ({ selectedText = '' }) => {
+      const cls = await pickClass(null);
+      return cls ? { cls, text: selectedText } : null;
+    },
+    onEdit: async ({ data }) => {
+      const cls = await pickClass(data.cls);
+      return cls ? { ...data, cls } : null;
+    },
+  });
+})();