wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
237 Commits 5 Branches 0 Tags
9a3a196eeab9f4a73f8dbf83f284f83f8f2ac2f8
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
wait4x 9a3a196eea Update 文章 “writing-template” 2026-11-04 15:25:43 +00:00
wait4xandGLM-5.3 cb44d0b2d2 feat(about): 关于页五方案预览上线 
用户要求 3-5 个方案供审阅：A 白纸单栏 / B 名片双栏 / C 杂志分节 / D 时间线 / E 卡片流，
共用 about.yaml 真实数据。

验证: 构建 exit 0；五案渲染、零溢出

Spec: none (预览页随选型迭代)

Co-authored-by: GLM-5.3
 2026-11-04 23:10:56 +08:00
wait4xandGLM-5.3 129b23cd2b fix(heatmap): 修蛇头坐标轴反了跑出边界；P1 智能寻食蛇落进正式开源页 
用户选定 P1，同时报障「贪吃蛇跑到了窗口之外」。

根因：网格是**列优先**索引（idx → 列=floor(idx/7)、行=idx%7），P1 引擎的 posOf
把 x/y 写反——蛇头 y 会到 676px（网格仅 91px 高），一路走出下边界。
预览页坐标已修正；正式热力图按 P1 落地时直接用正确坐标系。

P1 落进正式开源页（Heatmap.astro）：
- 头（accent 圆点）+ 8 节渐隐拖尾，沿「最近邻路径」只在有贡献的格子间滑行，
  空格不染色（371 格仅 51 天活跃，全网扫描会让蛇 86% 行程空转）
- 吃到的格子点亮 accent；月柱随蛇头所在月份递增点亮
- 路径首尾相接实现无缝循环；离开视口即停；reduced-motion 下头/拖尾隐藏、
  柱子以终态呈现；无 JS 兜底同款（noscript 样式）
- 清理死分支：P1 路径只访问活跃格子，walked 分支永不触发

验证: 构建 51 页 exit 0；E2E 56/56；
      Playwright 实测蛇头 transform 始终在网格包围盒内（x≤676、y≤83 含居中偏移）、
      eaten 递增至 51、月柱 13/13 点亮、reduced-motion 头隐藏柱立起、无 JS 柱立起

Spec: none (P1 为用户已选定方案的落地 + 坐标 bug 修复)

Co-authored-by: GLM-5.3
 2026-11-04 23:04:14 +08:00
wait4xandGLM-5.3 6e343c80dc test(e2e): 书架改「开合翻转」口径，数据板断言更新为 5j 口径 
- 书架（方案 C）：置顶书默认展开是设计行为，点它=收起。原断言误点已展开的
  置顶行断言「变开」→ 必然失败。改为断言开合状态恰好翻转一次
- 数据板断言：5j T2 有意退役 streak/贡献蛇 SVG（信息并入热力图区），原
  「数据板渲染」断言过时；改为断言连续贡献统计条 + 更新时间标注 + 第三方
  资产零命中（含退役的 /github-assets/）

验证: E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs → 56/56 PASS

Spec: none (测试口径随 5j 定稿同步)

Co-authored-by: GLM-5.3
 2026-11-04 23:03:45 +08:00
wait4x f73a1b3e63 Merge branch 'spec/2026-11-03_blog-5j-content-refine' 
Phase 5j 交付：开源页叙述合一（story 单字段 markdown 内联链接）+ 贡献数据去重与时效
（连续贡献改热力图同源本地计算并标注更新时间，贡献蛇与 streak.svg 退役）+
瞬间/书架标题下话语后台可编辑（pages.yaml 单例，字号/颜色/字体三档夹取）+
隐藏开关假开关修复（hidden 真字段 + post-visibility 契约，RSS/sitemap 一并过滤）+
热力图蛇路径优化三案预览（P1 智能寻食/P2 平滑蛇体/P3 分月清扫）。
关于页形态探索拆分为独立包 5k。

Spec: 2026-11-03_blog-5j-content-refine
 2026-11-04 22:29:49 +08:00
wait4xandGLM-5.3 19b765e5b1 chore(spec): 归档 blog-5j——四任务收敛（关于页探索拆出 5k） 
Spec: 2026-11-03_blog-5j-content-refine

Co-authored-by: GLM-5.3
 2026-11-04 22:29:49 +08:00
wait4xandGLM-5.3 6b501fa688 chore(spec): 5j 重划——关于页探索拆出为 5k，勾选收敛 
Spec: 2026-11-03_blog-5j-content-refine

Co-authored-by: GLM-5.3
 2026-11-04 22:24:03 +08:00
wait4xandGLM-5.3 f581f5bc4f docs(content): story/页面说明文案/隐藏语义同步指南（5j T5） 
验证: pnpm astro build exit 0

Spec: 2026-11-03_blog-5j-content-refine (T5)

Co-authored-by: GLM-5.3
 2026-11-04 22:16:46 +08:00
wait4xandGLM-5.3 a2b5755680 docs(content): story 字段/页面说明文案/隐藏语义同步到指南（5j T5） 
- 管理台：开源页「叙述已合一」（推荐改 story 单字段，旧字段标 legacy）、
  新增「页面说明文案」一节（瞬间/书架标题下话语 + 三档样式 + 兜底行为）、
  置顶语义补「隐藏优先」与「多本置顶在书架的默认展开」
- 写作指南：新增「隐藏文章」一节（hidden: true / tags 两种写法、页面仍生成、
  与草稿的区别、隐藏与置顶同开以隐藏为准）

验证: pnpm astro build exit 0

Spec: 2026-11-03_blog-5j-content-refine (T5)

Co-authored-by: GLM-5.3
 2026-11-04 22:16:22 +08:00
wait4x 7401b512e6 Merge branch 'spec/2026-11-03_blog-5j-content-refine' 
Phase 5j 进行中合并（T1/T2/T3 已交付）：开源页叙述合一（story 单字段 markdown）+
贡献数据去重与时效（连续贡献改热力图同源本地计算并标注更新时间，贡献蛇与
streak.svg 退役）+ 瞬间/书架标题下话语改为后台可编辑（pages.yaml 单例，字号/
颜色/字体三档夹取）+ **隐藏开关假开关修复**（hiddenTag 只写没人读的字段导致
隐藏+置顶仍显示并排第一；新增 hidden 真字段与可见性契约 post-visibility，
RSS/sitemap 一并过滤）+ 热力图蛇路径优化三案预览（P1 智能寻食/P2 平滑蛇体/
P3 分月清扫，均带月柱联动）。

Spec: 2026-11-03_blog-5j-content-refine
 2026-11-04 22:01:06 +08:00
wait4x e5f2d0089e Merge remote-tracking branch 'origin/main' into spec/2026-11-03_blog-5j-content-refine 
# Conflicts:
#	content/site/opensource.yaml
#	src/pages/heatmap-preview.astro
 2026-11-04 22:01:06 +08:00
wait4xandGLM-5.3 3151d20c66 chore(spec): 5j 勾选 T2 
Spec: 2026-11-03_blog-5j-content-refine

Co-authored-by: GLM-5.3
 2026-11-04 22:00:15 +08:00
wait4xandGLM-5.3 49acb4cbd1 fix(posts): 隐藏开关是假开关——修「隐藏+置顶仍显示并排第一」；贡献数据去重 
用户实测：「有的文章同时选择了置顶和隐藏，还会显示并置顶」。

根因：后台「隐藏」开关（hiddenTag）是个假开关——它只写 `hiddenTag: true` 这个
没人读的字段，而全站过滤只认 `tags` 里的 `hidden`。于是隐藏从未生效；
叠加置顶后，这篇还在列表最前面。

- 新增 src/lib/post-visibility.ts：可见性契约单一事实源——`!draft && !hidden &&
  !tags.includes('hidden')`（两条通道都认，历史写法兼容）
- postsSchema 增真字段 `hidden`；七处消费点（首页双轨/归档 zh/en/书架/RSS zh/en/
  文章页导航）统一走 isVisiblePost
- 后台假开关 hiddenTag 换成真开关 hidden，hint 写清语义：不进列表/RSS/sitemap，
  页面本身仍生成（链接可分享）；与置顶同时打开时以隐藏为准
- sitemap 过滤隐藏文章（astro.config 配置期扫 frontmatter，两种写法都认；
  内容目录不可读时宁可不排除也不炸构建）

贡献数据去重（5j T2，回答用户「连续贡献是否实时」）：
- 连续贡献不再构建期抓取 streak.svg 快照（不实时、暗色需滤镜、与热力图同源重复），
  改为热力图同一份 GraphQL 日历本地计算（src/lib/heatmap.ts streakStats）：
  当前连续（以最后有贡献日为终点）/ 最长 / 总贡献，界面上标注「数据更新于 X」
- 贡献蛇块与自托管 snake/streak SVG 删除，fetch 脚本 ASSETS 清空，
  build.sh 守卫改为退役说明；开源页数据板整块并入热力图区

验证: 构建 51 页 exit 0；content-lint 52 页 0/0/0；E2E 56/56；
      临时两篇「置顶+隐藏」（新字段/旧 tags 各一）实测——首页/归档/书架/
      双语首页/RSS 双语/sitemap 全部零命中，页面本身仍生成；
      清理后归档首条恢复 writing-template（普通置顶不受影响）；
      开源页 snake/streak 资产零残留、连续统计条与更新时间标注就位

Spec: 2026-11-03_blog-5j-content-refine (T2 + 隐藏 bug 修复)

Co-authored-by: GLM-5.3
 2026-11-04 22:00:15 +08:00
wait4xandGLM-5.3 b3c3bcf49e feat(heatmap): 蛇家族四变体预览 + 后台补齐 story/页面说明文案 
验证: 构建 exit 0；实测 F1 循环（loop 1→2、每轮吃到 51 天）、F2 身长 3→26、
      F3 双头、FJ 柱子随爬行点亮、J 柱联动

Spec: none (预览页随选型迭代)

Co-authored-by: GLM-5.3
 2026-11-04 21:27:13 +08:00
wait4xandGLM-5.3 34a78dacb9 feat(heatmap): 蛇家族四变体 + 补齐后台表单（5j 预览 v3） 
用户选定 F+J 方向，要求蛇能**循环**（学 GitHub README 蛇的节奏），并再看几个新变体。

四个蛇变体：
- F1 循环贪吃蛇：蛇形爬一年，吃到有贡献的日子点亮；到端点停一拍、清空、重新开始，
  无限循环，身体保持 6 节（README 蛇手感）
- F2 生长蛇：每吃到一天长一节（3 → 26 上限），吃完循环重置——"积累"的隐喻最强
- F3 双蛇对开：两条蛇从最早/最新一头相向而吃，在年中交汇
- FJ 蛇 + 月柱联动：蛇爬进某个月，对应柱子同步升起并高亮；爬到年末十二根全立，
  然后回到起点、柱子清零、再来一轮（用户点名要的组合）
- J 单独保留月度柱状图作参考

实现要点：共用一套蛇引擎（蛇形路径 = 按列推进、奇数列反向；轨迹队列控制身长；
到端点判定"本轮结束"→ 900ms 后 reset 并重入）；IntersectionObserver 离开视口即停；
「减少动态效果」下直接呈终态（点亮所有有贡献的格子 + 柱子立起）。

**后台补齐（回答用户"改动同步到后台了吗"——此前确实漏了两处）**：
- 开源页新增「叙述（推荐改这里）」story 字段（双语 markdown，链接内联），
  旧 blurb 标注 legacy
- 新增「瞬间 / 书架 标题下的说明」文件条目：文字（markdown）+ 字号（11–16）
  + 颜色（ink 灰阶四级）+ 字体（12 族下拉），两页独立

验证: 构建 52 页 exit 0；config-check 231 字段 / 73 hint 全过；
      Playwright 实测——F1 身长 6 且 loop 计数 1→2、第 1 轮吃到 51 天；
      F2 身长 3→26、吃掉 38 天；F3 同时 2 个蛇头；FJ 柱子随爬行递增点亮（3→5→7→10）；
      J 柱子升起并悬停联动

Spec: 2026-11-03_blog-5j-content-refine (预览 v3)

Co-authored-by: GLM-5.3
 2026-11-04 21:27:12 +08:00
wait4xandGLM-5.3 d6dfe39db3 feat(heatmap): 热力图六案 v2 预览上线（含贪吃蛇） 
按用户反馈重做：F 贪吃蛇 / G 心跳呼吸 / H 雨滴涟漪 / I 3D 地形 / J 周冠军柱 / K 显微镜。

验证: 构建 exit 0；Playwright 逐案实测动效均生效（蛇 371 格爬完吃到 51 天）

Spec: none (预览页随选型迭代)

Co-authored-by: GLM-5.3
 2026-11-04 20:47:26 +08:00
wait4xandGLM-5.3 d9721cdbd8 feat(heatmap): 热力图方案 v2——六案重做，含「贪吃蛇」（5j 预览迭代） 
用户看过 v1 五案后反馈「不是很满意」，并要求「类似贪吃蛇般的方案」，故重做六案：
F 贪吃蛇 / G 心跳呼吸 / H 雨滴涟漪 / I 3D 地形 / J 周冠军柱 / K 显微镜。

**贪吃蛇（F）的关键设计判断**：真实数据 371 格里只有 51 天有贡献（总 306 次），
若照 GitHub 的做法"只吃有贡献的格子"，蛇有 86% 的行程毫无反馈、看起来像卡住。
改为「爬过即留淡色轨迹 + 有贡献处强调色加重」，并把节奏 55ms→30ms（371 格约 11 秒
爬完一年），末尾给出「走过 371 格，吃到 51 天」的收束统计。

其余五案：
- G 心跳呼吸：按当日贡献量给每格不同的呼吸时长（3.4s→1.2s），纯 CSS 合成层动画
- H 雨滴涟漪：以「最后一次贡献」为圆心按距离错峰扩散，扫过闪一下；可重播
- I 3D 地形：贡献量当海拔（translateZ 0–14px），指针倾斜整块网格
- J 周冠军柱：月度总计柱状图，进视口逐根升起，悬停柱子联动高亮该月所有格子
- K 显微镜：指针处浮起圆镜，放大 5×5 邻域（用数据档位绘制）+ 日期与次数

六案共同约束：accent 只做高亮不参与数据编码（数据仍由 ink 四档承载）、
reduced-motion 全部静态、离开视口即停（IntersectionObserver）、零第三方依赖。

验证: 构建 52 页 exit 0；content-lint 52 页 0/0/0；Playwright 逐案实测——
      F 蛇身逐格推进至 371/371、吃到 51 天、读数实时更新；
      G 52 格动画 hmBreath 时长生效（2.6/3.35/3.06s…）；
      H wrap.play 且 animationName=hmWave；
      I .hg-raise 有 translateZ 且容器 matrix3d 倾斜；
      J 柱子 grow 后高 14px、13 个月、悬停联动 28 格；
      K 圆镜 25 个迷你格 + 日期读数 + 焦点格 1；
      390 零横向溢出；reduced-motion 下 breath none / 蛇静态全亮 / 地形无倾斜

Spec: 2026-11-03_blog-5j-content-refine (热力图预览 v2)

Co-authored-by: GLM-5.3
 2026-11-04 20:47:25 +08:00
wait4xandGLM-5.3 1a486a20d2 chore(spec): 5j 勾选 T1/T3 
Spec: 2026-11-03_blog-5j-content-refine

Co-authored-by: GLM-5.3
 2026-11-04 20:14:59 +08:00
wait4xandGLM-5.3 58baad5a7b feat(content): 瞬间/书架标题下的话语改为后台可编辑（5j T3） 
用户原话：「瞬间、书架大标题下的话语我从哪里去改？包括其字号颜色还有字体」——
此前这两行是硬编码（瞬间来自 i18n 字典、书架是组件里的字面量），后台完全改不了。

- 新增 sitePages 单例（content/site/pages.yaml）+ pageNote() 访问器：note 走富文本
  行内管线，空则回落内置默认（原硬编码两句逐字搬入 PAGE_NOTE_DEFAULTS）
- 样式只开放三档并全部夹取：size 11–16px、color 仅 ink-1..ink-4、font 仅排版类白名单
  —— 后台可填任意值，不能让它破版或染色
- **关键坑**：字体类不能只挂 class——global.css 的 .font-kai/.font-sans 全挂在富文本
  容器作用域（.prose-*/.rich/.mom-text/.prose-body），裸 .page-note.font-kai 拿不到
  规则（实测第一次无效，仍是 Noto Sans）。改为复用 fontVarFor() 产出 inline
  font-family，class 仅作语义
- 书架与瞬间各自独立配置；默认值取「改造前外观」（均 font-sans）

验证: 构建 exit 0；content-lint 52 页 0/0/0；E2E 56/56；
      实测（只改 books 样式）书架 computed = 16px / rgb(51,52,58) / Ma Shan Zheng，
      瞬间保持 13px / ink-4 / Noto Sans（两页互不影响）；
      op-gitea 侧另测：仅改文本、整段删 style（与基线逐字段一致）、非法值
      （size:40/color:red/font 乱写）全部安全回落

Spec: 2026-11-03_blog-5j-content-refine (T3)

Co-authored-by: GLM-5.3
 2026-11-04 20:14:59 +08:00
wait4xandGLM-5.3 6b2e4d8666 feat(opensource): 热力图五方案动效预览上线 
用户要求「热力图可以有更多的动效，而不是静态的一张图」，先上线五案供选型：
A 入场波纹 / B 光标光晕 / C 年度回放 / D 连续电流 / E 悬停周详情。
均守灰阶红线、reduced-motion 静态化、零第三方依赖。

验证: 构建 exit 0；content-lint 52 页 0/0/0；Playwright 逐案实测动效均生效
      （A hmRise 0.42s、B 光晕读数、C 第 10 周回放、D 12 格 hmFlow、E 整列 lift）

Spec: none (预览页需先上线供用户选择)

Co-authored-by: GLM-5.3
 2026-11-04 20:09:54 +08:00
wait4xandGLM-5.3 7e0167a8bb feat(opensource): 热力图五方案预览 + 开源页叙述合一（5j T1 + 预设） 
用户两项新需求：
①「开源页的叙述为什么要区分链接前和链接后？完全可以用 markdown 富文本统一替代」
②「热力图可以有更多的动效，而不是静态的一张图，探索相关方案供我审阅」

T1 叙述合一：
- opensource.yaml 新增 story（双语 markdown，链接内联），blurb/blurb_after 保留为
  legacy（story 为空时才用）→ 旧 yaml 零回归
- site-content 访问器取 story，GithubProfile 走 renderRich 行内模式；markdown 生成的
  裸 <a> 补 .pf-bio :global(a) 样式，与 .pf-link 观感一致
- 实测产物：pf-bio 内联 <a> 渲染成功、pf-link 拼接痕迹 0 处

热力图五方案预览（/heatmap-preview/，供用户选型）：
- 新增 geek/HeatGrid.astro：可复用网格渲染件（371 格带 --c/--r 供错峰延迟），
  沿用线上同款 ink 灰阶（accent 只做高亮，不参与数据编码）
- A 入场波纹（视口内一次性斜向漫过）、B 光标光晕（radial-gradient 跟随 + 日期读数）、
  C 年度回放（滑块 scrub + 累计计数 + 自动播放）、D 连续电流（最近连续段流光 +
  连续天数大数）、E 悬停周详情（整列抬起 + 周合计/最好一天面板）
- 五案均守灰阶红线、均在 prefers-reduced-motion 下静态化、零第三方依赖、无常驻 rAF
- **两处真坑**：①网格是子组件渲染，页面级 scoped 样式够不到其内部元素 → 与格内元素
  相关的选择器必须 :global()（否则 A 的动画与 E 的抬列静默不生效）②「当前连续」按
  今天起算会得 0（今天尚未贡献）→ 改为以最后一个有贡献的日子为终点往回数，并标注
  「截至 <日期>」

另修 E2E 过时断言：书架改版为抽书阅读后，原「年份折叠组」断言必然失败，
改为「抽书行渲染 + 点击可抽开」（56/56 PASS）

验证: 构建 51 页 exit 0；content-lint 52 页 0/0/0；E2E 56/56；
      Playwright 逐案实测：A 动画 hmRise 0.42s 且播完 opacity=1、B 光晕 opacity=1
      并显示「日期 · 次数」、C 拖到第 10 周读数与淡出正确、D 12 格流光 hmFlow +
      连续 5 天（截至 2026-10-24）、E 整列 lift matrix(…,-2)；390 零横向溢出；
      reduced-motion 下动画 none、光晕 display:none

Spec: 2026-11-03_blog-5j-content-refine (T1 + 热力图预览)

Co-authored-by: GLM-5.3
 2026-11-04 20:09:10 +08:00
wait4x 545c91a0ff Update 文章 “writing-template” 2026-11-03 06:44:46 +00:00
wait4x 7149541a92 Update 文章 “mian-sha” 2026-11-03 06:42:54 +00:00
wait4x a868bf94fd Update 文章 “shu-zui” +1 2026-11-03 06:42:01 +00:00
wait4x a46430b088 Update 文章 “ni-tan” +1 2026-11-03 06:40:43 +00:00
wait4x 1ce9cd65ea Update 文章 “mian-sha” +1 2026-11-03 06:39:33 +00:00
wait4x 6e4d6c2f88 Update 页面文案 “opensource” 2026-11-03 06:38:05 +00:00
wait4x 6abca9f412 Merge branch 'spec/2026-11-02_blog-5i-fonts-polish' 
Phase 5i 交付：字体切换失效根治（按内容诉求注入字体 CSS，此前四份字体 CSS 被
关在阅读轨分支里，技术轨与全站页面从不加载）+ 六款自托管 OFL 字族（@fontsource
切片粒度不达标→改原始 TTF 字频序细切，单页增量 27–46KB 全过闸门）+ 评论失败提示
误报的状态机修复 + 瞬间评论区配色同步（Artalk .artalk 类的 CDN 样式平级压制）+
灯箱右上关闭被全高侧栏遮挡修复 + 灯箱 caption 支持字体与颜色 + 取消彩色强调次数
限制 + 开源页项目墙恢复居中 + README 动效自托管与数据板 + 书架定稿方案 C（抽书
阅读、置顶图标化、多本置顶默认展开）。

Spec: 2026-11-02_blog-5i-fonts-polish
 2026-11-03 12:47:54 +08:00
wait4x c9fb46f5a9 Merge remote-tracking branch 'origin/main' into spec/2026-11-02_blog-5i-fonts-polish 
# Conflicts:
#	docs/管理台.md
 2026-11-03 12:47:53 +08:00
wait4xandGLM-5.3 edc34a8a8c chore(spec): 归档 blog-5i——九任务收敛 
Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 12:47:13 +08:00
wait4xandGLM-5.3 83e0b863fc chore(spec): 5i 勾选 T7/T9（九任务全勾） 
Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 12:35:20 +08:00
wait4xandGLM-5.3 9df86cb05b feat(fonts): 新增六款自托管字族（体积闸门内）（5i T9） 
用户拍板「字族扩展都补」。六款按三类各两款落地，全部单页增量 ≤150KB：
小薇（文学·宋体气质）、新晰黑（文学·现代黑）、得意黑（标题）、庆科黄油（标题·圆润）、
马善政毛笔与柳建毛草（书法），许可证均 OFL。

关键取舍：@fontsource 官方中文切片粒度太粗（每片约 33 字、单片 40KB+），一句话命中
7 片即 308–442KB/页，四款全部超闸门；即便用 subset-fonts.py 按站内用字重裁仍剩
205–346KB（笔画类字族单片就 50KB）。故改为从 google/fonts 取原始 TTF，按**字频序
细切**（约 19 字/片、单片 2–12KB），每族 99–100 片、族总量 0.5–1.2MB，浏览器只拉
命中的片。四个 @fontsource 依赖随之移除，package.json 净零变更。

实测单页增量（一句话场景）：xiaowei 44.9KB / huangyou 27.1KB / mashanzheng 45.7KB /
liujianmaocao 30.0KB / smiley 27.1KB / neoxihei 30.0KB——全部 PASS；
六族同页共 105KB。

接线（一处漏就静默失效，踩过两次）：
- rehype-class-whitelist 放行新类（不放行则 span 的 class 被整条剥掉，页面有字没脸）
- site-content 的 ALLOWED_PAGE_FONTS 与后台排版下拉同源补齐（三处下拉 + hint）
- font-needs 扩六个 key，保证「内容用到才加载」的按需契约继续成立
- global.css 六组规则含 .mom-text 作用域（5h 补的瞬间作用域不能漏）
- typography-classes.js（后台可视化面板单一事实源）35→42 项
- subset-fonts.py 新增 --split-ttf / --slices / --order-from（hwmc 的 --css 用法未动）

覆盖边界（已在 docs 与后台 hint 写明）：切片只含站内用字（约 1900 字），
新写生僻字会回落系统字族，需按 docs 命令重切。

验证: 构建 50 页 exit 0；content-lint 51 页 0/0/0；config-check 211 字段/66 hint；
      六类逐项 getComputedStyle 首项 = ZCOOL XiaoWei / ZCOOL QingKe HuangYou /
      Ma Shan Zheng / Liu Jian Mao Cao / Smiley Sans / LXGW Neo XiHei（6/6）；
      六族全部出现在 document.fonts；首页字体请求数保持 17（零回归）

Spec: 2026-11-02_blog-5i-fonts-polish (T9)

Co-authored-by: GLM-5.3
 2026-11-03 12:35:20 +08:00
wait4xandGLM-5.3 d096d45c58 feat(books): 书架定稿方案 C——抽书阅读 + 多本置顶默认展开 
用户拍板选 C，置顶标记改为向上箭头图标（不写文字），并确认支持多本置顶。

- 抽书列表：情绪色脊 + 定宽标题列 + 展开 chevron，details 原生展开看封面与简介
- 置顶：所有 pinned 书排最前且默认展开，标记换成 ↑+横线 图标
- 删除一次性预览路由 /books-preview/ 与其 lint 白名单

验证: 构建 exit 0；content-lint 53 页 0/0/0；Playwright 实测展开/箭头旋转/
      作者列对齐/390 无溢出；两本临置顶实测均排前且同时展开

Spec: none (先行上线，完整 5i 包仍在 spec/2026-11-02_blog-5i-fonts-polish)

Co-authored-by: GLM-5.3
 2026-11-03 12:28:30 +08:00
wait4xandGLM-5.3 073e124344 feat(books): 书架定稿方案 C——抽书阅读 + 多本置顶默认展开 
用户 2026-11-03 拍板：选方案 C，「指定换成一个向上的箭头即可，不用表示为文字」，
并问是否支持多个置顶（答：支持，已实现并实测）。

- BooksPage 重写为抽书列表：情绪色脊 + 定宽标题列 + 作者 + 展开 chevron，
  details 原生展开显示封面与简介，零 JS
- 置顶标记改为图标：↑ + 横线的「回到顶部」字形，不写「置顶」二字，
  与右侧 chevron 形状区分；title/aria 仍带「置顶」以便读屏
- 多本置顶：所有 pinned: true 的书排在最前（沿用 sortPosts 契约）且全部
  默认展开；实测两本同时置顶 → 序列前两位、两条都 open、两个图标
- 展开/收起用 chevron（收起朝下、展开旋转 180°），reduced-motion 下不旋转
- 移动端：标题列自适应、作者隐藏、简介与封面改纵向堆叠
- 删除一次性预览路由 /books-preview/ 与 content-lint 的临时白名单；
  文档补「书架页置顶图标语义 + 多本置顶」

验证: 构建 exit 0；content-lint 53 页 0/0/0；Playwright 实测 5 行/作者列 x 唯一/
      标题零截断/点击展开且 chevron 旋转 179°/390 无溢出；
      临时两本置顶实测：顺序前两位、两条 open、图标 2 个（数据已还原）

Spec: 2026-11-02_blog-5i-fonts-polish (T7 定稿)

Co-authored-by: GLM-5.3
 2026-11-03 12:27:00 +08:00
wait4xandGLM-5.3 d6e08a29f9 feat(books): 预览页新增 D 方案（封面网格 × 抽书），C 改置顶默认展开 
验证: 构建 53 页 exit 0；Playwright 实测 C/D 各自唯一展开项 = 置顶书，
      D 5 格 / 3 列 / 置顶角标 1、1280 与 390 零横向溢出

Spec: none (预览页随选型迭代，正式改动在 spec/2026-11-02_blog-5i-fonts-polish)

Co-authored-by: GLM-5.3
 2026-11-03 12:15:50 +08:00
wait4xandGLM-5.3 18ea5b17b8 feat(books): 新增 D 方案（封面网格 × 抽书），C 改置顶默认展开 
用户反馈「B 和 C 都不错，C 方案可以默认展开置顶的书目」——故：
- 新增方案 D：格子仍是 B 的封面网格，但每格用原生 details 抽开成详情卡，
  置顶书默认展开、封面左上角带置顶角标；零 JS
- C 的默认展开从「第一行」改为「置顶书目」（frontmatter pinned: true，与文章
  置顶同一字段同一排序契约），行内显示置顶徽标
- 当前没有书被置顶，预览页用最新一本演示并明示（真实使用由后台开关决定）

验证: 构建 53 页 exit 0；Playwright 实测 C/D 各自唯一展开项 = 置顶书（等待戈多）、
      D 5 格 / 1 置顶 / 3 列 / 角标 1、1280 与 390 零横向溢出

Spec: 2026-11-02_blog-5i-fonts-polish (T7 预览迭代)

Co-authored-by: GLM-5.3
 2026-11-03 12:15:34 +08:00
wait4xandGLM-5.3 d119d6b555 feat(books): 书架三案按视觉复核修订后更新预览页 
长标题/作者裁切、卡片参差、4+1 孤儿位、抽书页无展开暗示等缺陷已修，
用户可直接在 /books-preview/ 看修订版。

Spec: none (预览页随选型迭代，正式改动在 spec/2026-11-02_blog-5i-fonts-polish)

Co-authored-by: GLM-5.3
 2026-11-03 11:55:33 +08:00
wait4xandGLM-5.3 31fb52cb06 feat(books): 书架三案按视觉复核修完（长标题裁切/参差/孤儿位/无暗示） 
视觉复核逐案挑出的缺陷全修：
A 竖排色脊：书名/作者按脊内竖向容量确定性截断（此前 10 字书名与 9 字作者挤成
  第二窄列被 40px 脊宽裁掉）；脊顶上留 10px hover 余量 + 底部基线；情绪色混色
  从 16% 提到 26% 并加内描边（淡紫脊原本在白底上几乎消隐，墙被读断）；短标题脊
  补竖排年份填白；移动端脊高 120→172 保持 1:4 书脊比例，不再退化成矮胖色块
B 封面网格：改 3 列（5 本排 3+2，消掉 4+1 孤儿位）；标题定两行高、卡片等高
  （实测同行 394px 一致），同排基线不再锯齿；占位卡从单字换成竖排书名，视觉
  重量向真封面靠拢
C 抽书阅读：首行默认展开 + 每行加「封面与简介 ▾」暗示（此前收起态没有任何可点
  信号，看着像静态列表）；去掉恒为同值的年份列；标题改定宽列 + 省略号（实测
  作者列 x 全部 518，消除锯齿）；作者前加「·」并与标题拉开色阶；色条加宽成贯通行
  高的窄脊

验证: 构建 exit 0；content-lint 54 页 0/0/0；Playwright 实测 A 标题/作者零裁切、
      B 三列且同行等高 394、C 作者列全对齐 518 且首行展开、390 下脊高 172 不溢出

Spec: 2026-11-02_blog-5i-fonts-polish (T7 预览修订)

Co-authored-by: GLM-5.3
 2026-11-03 11:55:32 +08:00
wait4xandGLM-5.3 6061c16396 test(e2e): 覆盖 5i 的字体加载/评论不误报/灯箱关闭/开源页动效（46→55 项） 
新增九条断言，把本包修的四类回归固化成门禁：
- 字体真加载：技术轨文章的 document.fonts 必须含 LXGW WenKai Screen 与 WF-Hwmc
  （此前「class 在、计算值对、字体集里没有」是静默失效，只有这条能抓到）
- 评论不误报：进视口挂载后 #artalk-retry 必须保持 hidden，且容器打上 mounted 标记
- 灯箱关闭：点 #lb-close 后 dialog 必须变 closed（此前被右侧全高侧栏吃掉点击，
  表现是点了没反应，只能靠这条兜住）
- 开源页：零第三方外链图 + 打字机存在 + 数据板有自托管资产

验证: E2E_BASE=http://127.0.0.1:18934 node tests/e2e.mjs → 55/55 PASS

Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 11:50:10 +08:00
wait4xandGLM-5.3 cfe508ff14 fix(opensource): 修视觉终审的四个 P1 与灰阶/对齐细节 
视觉终审对开源页改版判「需修」，逐条修完并量化复验。

P1-1 数据板空档与三段右缘不齐：streak 只占半栏、snake 通栏 → 右侧空 306px。
- 网格改 `repeat(auto-fit, minmax(320px, 1fr))`，仅一张非通栏卡时加 `.pf-card-solo`
  （`grid-column: 1/-1`），语言条去掉 max-width
- 实测：统计行/语言条/数据板右缘统一 959px，streak 卡宽 298→638

P1-2 卡内 SVG 文字不可读：streak 固有 495px 被压到 298px（0.6×），14px 标签变 8.4px。
- 卡改全宽后 1:1 渲染（实测 rendered=495=natural）；抓取参数把次级灰换成站点 ink：
  亮色 #3f424a（10.05:1）、暗色 #b9bec8（9.07:1），旧值 #9aa0aa 仅 2.63:1

P1-3 移动端打字机折行推挤：390 下第 4 句 260px > 可用 230px 必折两行，
min-height:1.6em 挡不住 → 每轮下推 21px 再弹回。
- `@media(max-width:560px){.typing{min-height:calc(1.6em*2)}}`（实测 42px 恒定零推挤）
- 光标收成 2px 竖条 + baseline 对齐（原来是 0.5em 实心块，两行时被拉到行间）
- typing 第 4 句裁短（中文 ≤16 字、英文 ≤36 字符）

P1-4 streak 卡入场动画空壳帧：SVG 内 fadein 序列（环 0.4s/数字 0.6s/…/1.2s）+ lazy
加载 → 用户先看到 0.5–1.5s 半成品，截图也会随机拍到空卡。
- 抓取脚本新增 freezeAnimations()：剥掉全部 animation 声明、opacity:0 改 1、
  删除 @keyframes；重抓后 grep animation:/opacity: 0 均为 0（streak 各 6KB、
  snake 35KB→20KB）

P2 一并：
- streak 亮色容器 grayscale(1) 回到灰阶基调；暗色蛇卡改 grayscale+invert+contrast+
  brightness 组合，空网格不再与底色同色
- 项目墙描述 text-wrap: pretty（长描述末行孤词）
- 统计口径注释改为「三格」，不硬塞第 4 格（贡献数已由热力图承载）
- 社交图标行负 margin 做光学对齐

附：content-lint 增加 SKIP_ALL 白名单（一次性预览路由 /books-preview/ 无 en 对应页，
语言切换链接会误报断链+配对缺）

验证: 构建 51 页 exit 0；content-lint 54 页 0/0/0；E2E 46/46；
      Playwright 实测三段右缘 959 一致、streak 1:1、1280/390 零横向溢出、
      移动打字机高度 42px 恒定、光标 2px、项目墙 text-wrap=pretty

Spec: 2026-11-02_blog-5i-fonts-polish (T8 修复)

Co-authored-by: GLM-5.3
 2026-11-03 11:48:25 +08:00
wait4xandGLM-5.3 b8c5e1c86e feat(books): 书架三方案预览页先行上线（临时路由） 
用户要「直接查看网页」来选方案，故本页单独先部署；其余改版（字体按需加载、
灯箱关闭与 caption 排版、评论误报、开源页动效）仍在验证分支，选定方案后一并
合并并删掉本临时路由。

Spec: none (预览页需先上线供用户选择，其余改动仍在 spec/2026-11-02_blog-5i-fonts-polish 验证)

Co-authored-by: GLM-5.3
 2026-11-03 11:42:25 +08:00
wait4xandGLM-5.3 907f64472a feat(books): 书架改版三方案预览页（临时路由） 
用户要求「书架页多做出几个方案让我直接查看网页供我选择」，故先并陈三案：
A 竖排色脊墙（书脊 writing-mode 竖排、情绪色即是视觉线索）
B 封面网格（封面为主角，无封面用色脊占位 + 首字，悬停浮起并显出简介）
C 抽书阅读（一排书脊，点开原生 details 抽书，显示封面/简介/入口）

同一份数据渲染三案（posts category=reading），页顶 sticky 锚点跳转。
用户选定后：把选中方案落进 BooksPage.astro 并删除本临时路由。

验证: 构建 exit 0；dist/books-preview 27KB；Playwright 实测三案均渲染
      （脊 5 / 卡 5 / 抽书行 5）、1280 与 390 均零横向溢出、破图 0

Spec: 2026-11-02_blog-5i-fonts-polish (T7 预览)

Co-authored-by: GLM-5.3
 2026-11-03 11:41:10 +08:00
wait4xandGLM-5.3 6293fe25d5 chore(spec): 5i 勾选 T1 
Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 11:28:51 +08:00
wait4xandGLM-5.3 8d82aab213 fix(fonts): 字体切换真加载——按内容诉求注入，含瞬间排版类作用域缺口（5i T1） 
用户实测「字族渲染没有成功，尤其是字体的切换」。根因不是字体没做，是加载门禁错：
BaseLayout 把 serif/kai/kuaile/hwmc 四份字体 CSS 全关在 `track === 'reading'` 分支里，
技术轨文章与全站页面（默认 track='tech'）从不加载它们——于是 `.font-kai` 计算值虽是
`"LXGW WenKai Screen"`，但该 @font-face 根本不在文档字体集里，浏览器静默回退系统宋体。

- 新增 `src/lib/font-needs.ts`：`fontsFromText()` 纯函数 + `fontsForPage(pathname, track)`
  按路径取该页内容（文章正文 / home.yaml / about.yaml / opensource.yaml / 全部瞬间文本）
  与页面静态诉求（reading→serif；书架标题写死楷体→kai 等）算出所需字族集合
- BaseLayout 改为逐项按需注入（非阻塞 preload+onload 写法保留），noscript 同步；
  汇文明朝仍走 public 手工切片路径，network/font-display 未动
- **顺手补掉 5h 遗留的用户可见缺口**：瞬间富文本容器 class 是 `mom-text`，而全局排版类
  规则只覆盖 `.prose-*/.rich/.prose-body` → 瞬间里写 `font-kai`/`c-teal` 一直只有 class
  没有样式（新瞬间正是这么写的，用户看到的就是"没变色没换字"）。global.css 给 38 处
  选择器组补 `.mom-text`
- 另修自写 bug：en 路由切分 `slice(3)` 残留前导 `/` 导致 en 页按需字体全部落空，改 `slice(4)`

验证: 构建 exit 0（content-lint 51 页 0/0/0）；E2E 46/46；Playwright 实测
      技术轨文章 document.fonts 命中 LXGW WenKai Screen / WF-Hwmc / ZCOOL KuaiLe /
      Noto Serif SC，`.font-kai` 计算族 = LXGW 且 check=true；
      首页仍为基线（零增量）；瞬间页因有 font-kai 内容而命中 LXGW；
      书评页只拉 serif（41 片，0 kai 0 汇文）

Spec: 2026-11-02_blog-5i-fonts-polish (T1)

Co-authored-by: GLM-5.3
 2026-11-03 11:28:51 +08:00
wait4xandGLM-5.3 029633f00f chore(spec): 5i 勾选 T6/T8 
Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 11:24:29 +08:00
wait4xandGLM-5.3 0ff4ede91f feat(opensource): 项目墙恢复居中，README 动效以自托管方式回归（5i T6/T8） 
用户两项要求：开源页 Projects「依旧采取居中即可，不用左对齐」；README 迁移后
「很多图片元素还有一些 svg 基本上都摒弃了，可以在 readme 的基础上进行再创新，
保留那些动效的图，以及创新更多一些显示方式」。

T6 项目墙居中：`.repo` 从 align-items:stretch/text-align:left 改回 center/center，
`.repo-desc` 加 max-width:34em 防居中后长描述散架；语言点保持灰阶（与对齐无关）。

T8 动效回归（零运行时外链）：
- 新增 geek/TypingLines.astro：自绘打字机（SSR 先出首行防闪白，JS 逐字打出/删除/
  轮播，光标 CSS 闪烁，prefers-reduced-motion 与单条文案时保持静态，min-height
  防抖，astro:page-load 重挂兼容软导航）——替代 readme-typing-svg 外链，且跟随主题
- 新增 scripts/build-perf/fetch-readme-assets.mjs：抓 stats/top-langs/streak/snake
  到 public/github-assets/（10s 超时 + UA、透明底、亮暗两套站点色），产物入仓保证
  离线可构建；单资产失败保留旧文件、无旧文件则该卡不渲染
- GithubProfile 新增「数据板」：灰阶 hairline 卡 + mono 小标题 + 2 列网格（移动单列），
  与原生统计四格、语言占比、热力图组合成展示区；贡献蛇在暗色加 grayscale+invert
  滤镜（SVG 内部是自带绿阶，直接贴暗底刺眼）
- build.sh 只做存在性守卫 + 缺资产 WARN，**不挂抓取**（发布链不被外网抖动拖累）
- 后台开源页新增 typing 字段（list，zh/en 双语，≤6 条，summary 取 zh）+ schema 声明

验证: 构建 51 页 exit 0；config-check 211 字段/66 hint 全过；E2E 46/46；
      产物断言第三方外链零命中、本地引用 streak-light/streak-dark/snake；
      Playwright 实测打字机文本 900ms 内变化（动效在跑）、streak naturalWidth=495、
      snake=880、暗色自动切 streak-dark、项目墙 center/center、1280 与 390 均零横向溢出

备注: github-readme-stats 今日全局 503，stats/top-langs 两卡按契约跳过（原生四格与
      语言条已覆盖同一信息）；服务恢复后跑一次 fetch-readme-assets.mjs 即自动补上。

Spec: 2026-11-02_blog-5i-fonts-polish (T6/T8)

Co-authored-by: GLM-5.3
 2026-11-03 11:24:28 +08:00
wait4xandGLM-5.3 23303bd39a chore(spec): 5i 勾选 T2-T5 
Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 11:18:36 +08:00
wait4xandGLM-5.3 31eb44caee fix(comments): 评论失败提示误报与瞬间评论区配色脱同步（5i T2/T3） 
用户实测：「评论区总是显示加载失败，但是实际上是正常显示的，另外瞬间的评论区
的颜色和主题色不同步」。

T2 误报根因：软导航/二次挂载时 `#artalk-lib` 脚本标签已在 DOM，但 `window.Artalk`
尚未就绪，旧代码直接 `initArtalk()` → `!lib` 分支 `showRetry(true)` → 失败提示
永久显示；随后库加载完成、评论正常渲染，提示却留在页面上。
- 脚本标签在但库未就绪 → 等它的 load 事件再 init，不再立即判失败
- 失败提示只留真失败：script.onerror，或超时且确实未挂载
- `mounting` 在所有成功/失败路径复位（旧代码失败后永真，把 IO/锚点/滚底/重试全堵死）
- 成功路径清提示；三条触发路径与重试钮、astro:page-load 复核全部保留

T3 配色脱同步：18 个 `--at-color-*` 映射原先只写在 `#artalk-container` 作用域，
瞬间容器是 `mom-atk-<slug>` 不在其内 → 回落到 Artalk 默认白底。
- 抽成共享片段 geek/ArtalkThemeStyles.astro（两处引用，杜绝双份漂移）
- **额外挖出的第 4 个坑**：Artalk init 成功会给容器加 `.artalk` 类，其 CDN 样式表
  里 `.artalk{--at-color-bg:#fff}` 与裸属性选择器 `[data-artalk-panel]` 同特异性
  且后加载 → 平级后来居上。瞬间容器选择器加 `body` 前缀 (0,1,1) 压住；
  文章页是 `#artalk-container`(1,0,0) 本来就压得住，所以只有瞬间翻白

验证: 构建 exit 0；E2E 46/46；我独立复测——
      ① 文章页挂载成功且 #artalk-retry 保持 hidden
      ② 连发 3 次 astro:page-load 仍不误报、仍挂载
      ③ 瞬间评论区明暗两态 --at-color-bg 实测 rgb(255,255,255)/rgb(25,29,35)
         分别等于 --bg，容器带 .artalk 类（说明是 init 后真态）

Spec: 2026-11-02_blog-5i-fonts-polish (T2/T3)

Co-authored-by: GLM-5.3
 2026-11-03 11:18:35 +08:00
wait4xandGLM-5.3 5c015c6577 docs(writing): 取消彩色强调次数限制，补灯箱 caption 排版说明 
用户原话：「色彩强调不要设置限制，取消一页不超过三处的限制」。原「一页 ≤3 处」
是文档纪律（代码层从未硬性拦截），故改动集中在文档、模板文章与后台提示：

- 写作指南 / 管理台：改为「彩色不限次数」，同时明确仍守的另一条红线是
  **外壳灰阶**（导航/页脚/按钮/背景不染色）——外壳是气质，正文是表达
- 写作模板文章中英双语同步：章节改名「想用多少用多少」，删掉"三处之后不再上色"
  的示范约束，表格里「一页 ≤3 处」改为「不限次数（外壳仍灰阶）」
- 顺带补灯箱 caption 文档：照片说明支持 markdown + 排版类，深底自动取暗档；
  以及灯箱四种关闭路径（右上 ×、Esc、点背景、1× 时点图）

验证: 构建 exit 0；全仓 grep 「≤3 处/页」只剩「已取消」的历史说明

Spec: 2026-11-02_blog-5i-fonts-polish (T5)

Co-authored-by: GLM-5.3
 2026-11-03 11:18:14 +08:00
wait4xandGLM-5.3 138d3d976b fix(gallery): 修灯箱右上关闭点不动，caption 支持字体与颜色 
用户实测：「图库中的图片点击查看之后，点击右上角的关闭无法关闭，其次就是右侧
的文字是否支持字体的更换和颜色的更换」。

关闭失灵的根因（生产实测取证）：桌面端信息栏 `.lb-l2` 是 top:0→bottom:0 的
右侧全高侧栏（宽 200px），且 DOM 顺序在关闭钮之后；`document.elementFromPoint`
在按钮中心命中 `.lb-meta.lb-l2` —— 点击被侧栏吃掉，`lb.close()` 永不触发
（实测 Playwright 点击 #lb-close 30s 超时、dialog 保持 open）。给 `#lb-close`
提层级 z-index:12 后「点击 → open=false」通过。

caption 富文本：
- 照片 caption 走全站同一条管线（markdown → 内容净化三层白名单 → class 白名单），
  构建期预渲染成 HTML 挂在卡片的 data-caption-html 上，换图时写 innerHTML
- 灯箱容器加 `.rich`，global.css 的 .rich .c-blue / .rich .font-kai 才生效（此前
  只有触发类名的选择器、容器无 .rich 前缀，故颜色字体都不生效）
- 深底适配：灯箱内的彩色取柔和对暗底的档位；段间距收紧、首尾不撑高
- 容器由 <p> 改 <div>：caption 可含多段落，<p> 套 <p> 会被浏览器拆散

验证: 构建 exit 0；生产同款探针实测关闭生效（此前超时）；
      注入测试 caption 后产物含 class="c-blue"（保留）、font-kai（保留）、
      **加粗**→<strong>、<script> 被净化丢弃（验收数据已还原）

Spec: 2026-11-02_blog-5i-fonts-polish (T4)

Co-authored-by: GLM-5.3
 2026-11-03 11:18:13 +08:00
wait4xandGLM-5.3 d30b5decbb docs(spec): Phase 5i 立项——字体加载根治与交互缺陷修复 
七项用户实测问题的取证结论写入 spec：字体切换失效根因是 BaseLayout 把四份
字体 CSS 关在 track==='reading' 里（技术轨与全站页面从不加载）；Artalk 失败提示
误报源于软导航后脚本标签存在但库未就绪即判失败；灯箱右上关闭被 .lb-meta 命中
遮挡（elementFromPoint 实测）。任务拆 9 项，字族款式与书架方向待用户拍板。

Spec: 2026-11-02_blog-5i-fonts-polish

Co-authored-by: GLM-5.3
 2026-11-03 11:03:32 +08:00
wait4x 2526b98323 Update 页面文案 “home” 2026-11-03 02:41:48 +00:00
wait4xandGLM-5.3 36643f5cf0 chore(spec): 合入 CMS 侧内容编辑并解决 opensource.yaml 冲突 
合远端 main（后台 CMS 期间产出 3 个「Update 页面文案」提交）时的两处冲突：

- blurb_after：取 CMS 版本（用户的编辑为准）；折号间隙已由模板
  `{a}{' '}{blurbAfter.trim()}` 保证，不再依赖数据前导空格
- opensource.yaml 尾部：CMS 侧把 perSource 改成 github、intro_from 切到
  github-readme。**perSource 尊重用户选择**；intro_from 改回 "off" 并补注释——
  本阶段的目的正是用原生档案卡替换 README 原样渲染（README 带 7 类第三方外链图，
  且 `<div align="center">` 在本站失效，正是用户报告的「没居中、图片不显示」根因）。
  想回退在后台把该字段切回 github-readme 即可。

顺带对齐：关于页「找到我」的邮箱原来是 admin@wait4x.online（我拟的），
改为与站点 socials 一致的 X@alumni.nudt.edu.cn，避免出现一个不存在的地址。

验证: 构建 51 页 exit 0；content-lint 51 页 0/0/0；config-check 全过；
      E2E 46/46 PASS

Spec: 2026-11-02_blog-5h-content-social

Co-authored-by: GLM-5.3
 2026-11-02 21:21:41 +08:00
wait4x 52188d5b12 Merge branch 'spec/2026-11-02_blog-5h-content-social' 
Phase 5h 交付：文章置顶（sortPosts 统一口径 + 灰阶 pin 徽标 + 后台开关）、瞬间富文本（复用净化管线，字体与颜色可换）、瞬间逐条评论（展开才挂 Artalk，评论键用虚拟路径避开 # 截断）、浏览/评论计数徽标（眼睛+气泡本地 SVG，修同载双计与同页数字不一致）、开源页去 README 外链依赖（原生 GitHub 档案卡 + 语言占比灰阶 + 修 GitHub API 无 token 被打满）、关于页承接个人叙述、写作模板示例文章（中英双语，本身即置顶活样本），以及视觉终审两轮修复（日期折行、emoji 豆腐块、移动导航折行、灰阶纪律清剿）。

Spec: 2026-11-02_blog-5h-content-social
 2026-11-02 21:16:43 +08:00
wait4xandGLM-5.3 fef2de1d37 chore(spec): 归档 blog-5h——七任务收敛 
Spec: 2026-11-02_blog-5h-content-social

Co-authored-by: GLM-5.3
 2026-11-02 21:16:42 +08:00
wait4xandGLM-5.3 bdaf02f9ca fix(opensource): 项目墙卡片左对齐与 bio 间隙兜底（视觉终审二轮） 
Finding 1（P1）项目墙卡片内容被居中：
- 根因是全局 `.tap { display:inline-flex; align-items:center; justify-content:center }`
  沿列向 flex 的交叉轴生效，`.repo`（scoped）只赢下 display 没接管 align-items，
  于是标题与「● 语言 ★ n」行落在卡中部、卡片间左缘参差
- `.repo` 显式 align-items: stretch + text-align: left；实测四张卡的
  .repo-name 与 .repo-meta 左缘全部 313px（= 卡左 296 + 内距 16 + 边框 1）

Finding 2（P2）bio 破折号间隙修在数据不在模板：
- 原靠 opensource.yaml 串前导空格产生间隙，后台清空走兜底串时缺陷回归
- 模板改为 `{a}{' '}{blurbAfter.trim()}`：间隙由模板保证，数据怎么改都不会贴链接

验证: 构建 51 页 exit 0；content-lint 0/0/0；spec_verify 七项 exit=0（新指纹
      62086ce4cccd）；check 收敛；DOM 实测对齐与间隙均符合预期

Spec: 2026-11-02_blog-5h-content-social (视觉终审二轮)

Co-authored-by: GLM-5.3
 2026-11-02 21:14:37 +08:00
wait4xandGLM-5.3 c7d1e7b975 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
 2026-11-02 21:05:51 +08:00
wait4xandGLM-5.3 550f6d15b4 chore(spec): 5h 任务全勾与运行证据入库 
- tasks.md 七任务全勾；spec.md 功能框与成功标准全勾
- §5.1 全项目检查补升级条件（触及 BaseLayout/全局样式或 Artalk 接管层才升级）
- runs.jsonl 记录七项 verify 全部 exit=0（含本包新增的 E2E 46 项口径）
- content/.link-cache.json：链接卡片缓存随新文章构建刷新（入仓保证构建确定性）

Spec: 2026-11-02_blog-5h-content-social

Co-authored-by: GLM-5.3
 2026-11-02 21:01:47 +08:00
wait4xandGLM-5.3 d4fe273812 fix(visual): 修视觉终审的折行/豆腐块与灰阶纪律违规 
视觉终审（glm-5.3-flash:max）判 BLOCK，逐条修完并复测。

P1 阻断：
- 瞬间页日期折成两行（`2026-` / `04-29`）：日期列复用 var(--space-5)=40px，
  而 10 字符 mono 日期需 ≈75px 且缺 nowrap。抽 --tl-rail(5.4rem) 统一驱动
  轨道宽度与两处偏移，加 nowrap；实测日期单行（高度 20px）且圆点与卡片对齐

P2 交付可见破形：
- 关于页「关于我」行首 emoji 在无彩色 emoji 字体的环境渲染成黑方块：
  正文行首 emoji 全部去掉（改纯文字段落），并给 --font-serif/--font-sans
  链尾补 Apple/Segoe/Noto emoji 回退——用户内容里的 emoji（瞬间、书评）
  同样不再落豆腐块

移动端导航两字折行（开/源、文/章）：
- ≤450px 的 overflow-x 内滚从未生效：flex 子项默认可压缩，中文词被压到就地
  折行。给 nav ul > li 加 flex:none + .nav-link nowrap；实测 360/390/430
  三档全部单行（Range.getClientRects 计数逐项验证）

灰阶纪律：
- 项目墙原来按 GitHub linguist 给每个仓染语言色点，开源页铺 15 个仓 = 15 种
  彩色，破「外壳灰阶、彩色只作正文强调」红线 → 统一改灰阶点，语言靠文字承载
- 语言占比并列（Python/TypeScript 各 36%）只有第一名着色，读起来像谁领先 →
  判定改为「百分比等于最大值者一并着色」

版式与文案细节：
- prose 标题到正文比 tracks 多一档（16+16=32 vs 16）→ .sec-title + .prose-body
  margin-top: 0
- 开源页 bio 破折号贴链接（`blog—— Astro`）→ 破折号前补空格
- 页脚 built from<hash> 缺空格（Astro 吃掉换行处空白）→ 显式 {' '}
- 新增一条真实瞬间（含青色楷体富文本）替代只有占位串的样本，让评论区与标签行
  的间距可在真实数据下验收

验证: 构建 51 页 exit 0；content-lint 51 页 0/0/0；E2E **46/46 PASS**；
      390px 四页 scrollWidth == innerWidth（无横向滚动）；
      导航 360/390/430 全部单行；日期单行；config-check 全过

Spec: 2026-11-02_blog-5h-content-social (视觉修复)

Co-authored-by: GLM-5.3
 2026-11-02 20:56:00 +08:00
wait4xandGLM-5.3 0b0307b12f docs(admin): 补档案卡与计数徽标说明（5h T7 文档收尾） 
- 管理台「开源页」节：说明开篇已改原生 GitHub 档案卡（零第三方图片、
  语言占比灰阶、取数失败只隐藏该项），并把 intro_from: github-readme
  标为「仍可用但不推荐」——点名 7 类外链图与 align 居中失效正是用户
  报告的"没居中/图片不显示"根因
- 新增「浏览与评论计数」节：眼睛/气泡含义、一页只计一次（其余为只读镜像，
  不会出现两个不同数字）、开评论不算浏览、接口挂掉显示「–」不给假零、
  换页重计属定义而非双计

验证: pnpm astro build exit 0

Spec: 2026-11-02_blog-5h-content-social (T7 收尾)

Co-authored-by: GLM-5.3
 2026-11-02 20:37:01 +08:00
wait4xandGLM-5.3 3e377adc7f feat(opensource): 开源页改原生档案卡，个人叙述迁往关于页（5h T5/T6） 
用户原话：开源页开篇是从 GitHub README 直接移植的，「部分内容没有居中，有些图片
也没有正常显示，可以自行进行美化，无需完全一致……有些可以直接移植到关于页面」。

病根：README 是 GitHub 专用 markdown——`<div align="center">` 靠 HTML 属性居中
（本站按普通块渲染，故"没居中"），且依赖 7 类外链图（readme-typing-svg /
shields.io / github-readme-stats / streak-stats / activity-graph / snake /
komarev），慢网或被墙时全空白（故"图片不显示"）。

T5 开源页重构：
- 新增 geek/GithubProfile.astro：头像 / 名字@handle / 定位叙述 / 社交图标 /
  统计四格（followers、公开仓、总星标）/ 语言占比灰阶条（仅第一名 accent，
  其余 tokens 灰阶）——**零外链图、零 iframe、零第三方徽章**
- 语言聚合复用 loadProjects 的结果；followers 与公开仓数走 GitHub REST
- 任一取数失败只隐藏该项（catch + warn），绝不炸构建
- opensource.astro / en：档案卡承接原 README 位置 → 热力图 → 项目墙；
  README 渲染降级为兼容通道（intro_from=off 时不执行），yaml 注释写明
  7 类外链图与 align 失效原因并标「不推荐」
- **修既有隐患**：GitHub API 请求原先不带 token，匿名 60 次/小时在密集构建下
  被打满 → 项目墙退化成兜底 JSON（今天一度只剩 1 条）。现对 api.github.com
  自动附 Bearer（token 读宿主 0600 文件，不入仓），墙恢复 16 条、总星标 0→66、
  语言占比变真值

T6 关于页承接：
- about.yaml blocks 扩为 prose / tracks（兴趣版图）/ prose（关于我）/
  linklist（找到我：本站·邮件·GitHub·自建 gitea·RSS）/ prose（本站如何构建），
  双语齐备；AboutPage 零改动（blocks 早已驱动）
- 原则落地：关于页讲人，开源页讲开源，两边不再重复

验证: 构建 51 页 exit 0；content-lint 51 页 0/0/0；config-check 全过；
      E2E **46/46 PASS**（37 原有 + 本包新增 9 项：置顶顺序与徽标、文章页计数、
      模板彩色与折叠、瞬间评论区与只读计数、关于页块驱动）；
      dist/opensource 七类第三方外链零命中、第三方 img 数 0；数据实值：
      语言占比 Python/TypeScript 各 36%、Shell/Rust/JS 各 9%

Spec: 2026-11-02_blog-5h-content-social (T5/T6)

Co-authored-by: GLM-5.3
 2026-11-02 20:35:56 +08:00
wait4xandGLM-5.3 63c9c8ad4a feat(counts): 浏览/评论徽标接入文章与瞬间页，修同载双计（5h T4） 
用户要「加一个访客数量、评论数量，采用类似于开源页面从 GitHub 移植过来的那个
眼睛图标」——落地为 ViewMeta 本地 SVG 徽标，无第三方图片依赖。

接入（op-artalk 车道）：
- 文章详情页 reading/tech 两分支各挂一枚 mode="page"（两分支互斥，同页仅一处计数）
- ArtalkComments 顶部旧的纯文本 pv 行与自成一套的 bumpPv 脚本整段删除，改为
  readonly chip：评论区只读展示，不再各计一次
- 瞬间页顶部整页 pv 行同样改 chip；每条瞬间卡片底部为 readonly 徽标

组件修复（本人，op-artalk 实测揪出）：
- **同载双计**：脚本既注册 astro:page-load 又立即调用 run()，首屏两者都会触发
  → 每元素 POST 两次、浏览量翻倍（实测 15→17→19 每载 +2）。加每元素一次性
  守卫后 1/2/3 每载 +1；软导航新元素仍照常计数
- **同页两枚数字差 1**：readonly 实例独立 GET 到的 pv 可能比计过数的少 1；
  改为同键存在 page 实例时 readonly 让位，由 page 实例回填同一份结果
- page 实例请求失败时释放兄弟自读，避免评论区永远停在「–」

验证: 构建 exit 0；E2E 37/37；Playwright 拦截对账——
      每载 POST=1、同页两枚徽标文本一致（101/101）、刷新后累计 2、
      接口全挂时两枚均显示占位「–」不报错

Spec: 2026-11-02_blog-5h-content-social (T4)

Co-authored-by: GLM-5.3
 2026-11-02 20:29:44 +08:00
wait4xandGLM-5.3 8e74bead62 feat(moments): 瞬间富文本与逐条评论（5h T2/T3） 
瞬间文字从纯文本直出升级到与文章同级表达力，每条动态获得独立评论流。

T2 富文本：
- text 在 frontmatter 预渲染成 momentId → html 的 Map（renderRich 是 async，
  模板内不能 await），模板只此一处 set:html 且喂的是净化产物
- 走与全站文案同一条管线：markdown → 内容净化（标签/属性/协议三层白名单）
  → class 白名单 35 项，故 <span class="c-blue font-kai"> 生效、
  <script> 整棵子树被丢弃（实测）
- 纯文本老数据零回归：无 markdown 的 text 得到单个 <p>，与旧直出视觉等价
- 卡片内富文本首尾 margin 归零、段间半档、列表缩进 1.35em，15px/ink-2 基调不变

T3 逐条评论：
- 新增 MomentComments.astro：<details> 折叠，**展开才拉 Artalk 并 init**
  （未展开连 Artalk.js 都不下载，时间线一屏十几条不白付成本）
- page_key = /moments/#<slug>，中英双语共用同一评论流（与文章页同策略）
- pvAdd: false 且复用 ViewMeta readonly 计数：读者开评论不会虚增浏览数
- 5s 兜底失败提示 + 重试；软导航回页对已展开的框补挂
- Playwright 实测同页两个容器各自 init 成功（各渲染 31 个 atk-* 节点，无异常），
  故无需降级；若日后内存吃紧可对上一实例调 destroy() 一行切换

验证: 构建 exit 0；E2E 37/37（快照口径）；临时瞬间实测 markdown 粗体、
      彩色+楷体类保留、行内码、<script> 净化丢弃、details 与 /moments/# 键、
      ViewMeta 只读挂载全部命中（验收数据已还原）

Spec: 2026-11-02_blog-5h-content-social (T2/T3)

Co-authored-by: GLM-5.3
 2026-11-02 20:20:31 +08:00
wait4xandGLM-5.3 5bf0c327bf feat(content): 写作模板示例文章与文档（5h T7 主体） 
用户要「在文章中加一篇关于文章书写的模板示例」，故交付一篇**可复制**的模板
文章而非干条文：正文每节都在真跑一种能力，读者看到的效果就是源码的效果。

- content/posts/writing-template.md（zh）与 posts-en 同名 en 版（locked:true
  手写直译，不交给 TMT 重译）：标题层级纪律、彩色强调（一页三处限额）、
  字族（楷/汇文明朝各一处 + 六族清单）、引用/列表/代码窗条/表格/图片放大/
  链接卡片/details 折叠/分隔线
- pinned: true —— 这篇文章同时是置顶功能的活样本（归档首条实测）
- 后台 moments.text 由 text widget 改 markdown widget + 排版类提示：瞬间从此
  与文章同级表达力（字体/颜色/多段），提示里写明外壳灰阶纪律
- docs/写作指南.md 新增三节：写作模板（cp 起步 + 三条纪律）、置顶文章
  （语义边界：只改顺序不改 pubDate/URL/RSS）、瞬间怎么写（富文本 + 逐条评论
  + 只读计数 + text/image 至少一项）

验证: pnpm astro build 51 页 exit 0；content-lint 51 页 0 断链 0 缺图；
      产物断言 c-blue/font-kai/font-huiwen/details/table 全部生效；
      dist/archives 首条 = writing-template（置顶排序生效）

Spec: 2026-11-02_blog-5h-content-social (T7)

Co-authored-by: GLM-5.3
 2026-11-02 20:08:21 +08:00
wait4xandGLM-5.3 6538311387 feat(content): 置顶契约与计数徽标组件（5h T1 契约部分） 
置顶（T1）：
- src/lib/post-order.ts 新增 sortPosts：置顶优先 → pubDate 倒序 → id 兜底，
  把首页双轨/归档/书架四处排序口径收敛到一处
- postsSchema 增 pinned；PostList 三处渲染路径加灰阶 pin 小徽标；后台置顶开关
- 语义边界：只影响列表顺序，不改 pubDate/URL/RSS 时间语义

计数徽标（T4 契约组件）：
- src/components/geek/ViewMeta.astro：眼睛 = 浏览数、气泡 = 评论数，
  本地 SVG + tokens 着色，不引第三方图片
- 数据只用 Artalk 匿名端点：GET comments?limit=1 一次拿到 count 与 page.pv；
  page 模式先 POST pages/pv 计一次浏览，readonly 模式零写入
- SSR 占位「–」：无 JS/接口失败不显示 0 误导读者

验证: pnpm astro build 48 页 exit 0；config-check 208 字段/65 hint 全过；
      sortPosts 四调用点替换后构建通过

Spec: 2026-11-02_blog-5h-content-social (T1 契约)

Co-authored-by: GLM-5.3
 2026-11-02 20:02:08 +08:00
wait4x cdd9c61641 Update 页面文案 “home” 2026-11-02 11:47:24 +00:00
wait4x e1fc8bd64c Update 页面文案 “opensource” 2026-11-02 11:45:26 +00:00
wait4x cc12e016ab Update 页面文案 “opensource” 2026-11-02 11:42:51 +00:00
wait4xandGLM-5.3 ed473e996a fix(admin): 主题设置集合结构修复 + 集合结构构建校验 
用户实测后台报错：「主题设置 集合: The file option content/site/theme.yaml is
invalid. It must be the path to a JSON file」——根因是 site_theme 把 `file:`
直接写在集合层级，而 Decap/Sveltia 的文件集合必须是
`files: [{ name, label, file, format, fields }]` 结构；缺 files 包装时 Sveltia
按单文件变体解析并期待 JSON 路径，故报该错。

- site_theme 改为标准 files 集合（format: yaml 显式声明）
- site_pages 三单例补显式 format: yaml（扩展名推断可用但显式更稳）
- config-check.py 增加结构断言：每个集合必须 folder 或 files 二选一、files
  项必须齐 file/label/fields、file 必须指向真实文件——这类"后台整体打不开"
  的结构错从此在构建期拦截

验证: config-check 五文件全 OK（207 字段/64 hint）+ 结构断言通过；
      pnpm astro build exit 0

Spec: none (后台配置结构修复，构建校验加固)

Co-authored-by: GLM-5.3
 2026-11-02 19:35:28 +08:00
wait4x c772236d1a Merge branch 'spec/2026-11-02_blog-5g-pages' 
Phase 5g 交付：块式页面构建器（关于页九类区块驱动）+ 样式即数据（theme.yaml + 对比度闸门）+ 首页抽 HomePage 消双份与三字段 + 开源页收尾（README 四级回落/兜底 8 仓/可见性告警）+ 后台文档与 hint（config.yml 重复键结构缺陷修复）+ 字体子集化（汇文 -40%）+ 全站三层排版（富文本/页面级覆盖/艺术字体类）。

Spec: 2026-11-02_blog-5g-pages
 2026-11-02 19:20:17 +08:00
wait4xandGLM-5.3 a89c443c25 chore(spec): 归档 blog-5g——七任务收敛 
Spec: 2026-11-02_blog-5g-pages

Co-authored-by: GLM-5.3
 2026-11-02 19:20:17 +08:00
wait4xandGLM-5.3 23b79a2473 chore(spec): blog-5g 全任务勾选（T4 措辞修正） 
Spec: 2026-11-02_blog-5g-pages

Co-authored-by: GLM-5.3
 2026-11-02 19:18:03 +08:00
wait4xandGLM-5.3 8274180f81 docs(admin): 后台文档与 hint 补齐 + 修复 config.yml 重复键结构缺陷（5g T6） 
- docs/管理台.md 扩写 25→156 行（原文要点全保留，131 增 0 删）：四集合
  总表、块编辑九类（字段+示例 yaml+预览限制）、页面排版覆盖（含整页换字体
  的体积成本提醒）、theme 17 旋钮分组约束、首页三字段、开源页六字段 +
  include 未命中排查 + README 回落矩阵四级（把 T5 的"相对链接不重写/
  徽章不阻断"两条限制落到用户文档）
- docs/写作指南.md：首页可配项补三行、新增「页面块」字段速查节（含 ≤24
  块/≤4000 字/未知块跳过/空则回落 intro 的边界）、字体子集化段
  （694KB→420KB −40% + subset-fonts.py 命令）、加字流程第④步挂子集化
- 后台 hint 49→64：九类块型说明、tagline/blurb、font 下拉体积提醒、scale
  取值范围
- **修 config.yml 结构缺陷（重要）**：typography 对象被插进双语字段的
  name: 与 widget: object 之间，导致重复键 widget/fields（后者覆盖前者）→
  后台 tagline/blurb 退化成字符串写入、排版选择器字段被劫持。已挪到双语
  字段之后，恢复 object+zh/en 结构（重复键检测：修前 4 处 → 修后 0）
- 新增 scripts/build-perf/config-check.py：用自定义 StrictLoader 在解析阶段
  对重复键报错（Python 默认 safe_load 静默覆盖是本次漏检根因）+ hint 覆盖
  率体检；build.sh 守卫挂载（[ -f ] 先行，与既有闸门同级）

验证: 构建 48 页 exit 0；E2E 37/37；content-lint 49 页 0/0/0；对比度闸门
      4 项 PASS；config-check 五文件全 OK + 206 字段/64 hint

Spec: 2026-11-02_blog-5g-pages (T6)

Co-authored-by: GLM-5.3
 2026-11-02 19:16:43 +08:00
wait4xandGLM-5.3 3e09a362cc refactor(home): 首页三字段默认值收敛到 SITE_DEFAULTS（5g T4 补） 
- SITE_DEFAULTS 新增 homeProjectsLimit=6 / homeAnnouncement(空) /
  homePostsTracks(全开)，访问器改为引用默认常量而非散落字面量
- 旧 yaml（无三字段）零回归实测：公告不渲染、项目墙默认 6 条、三轨全开

验证: 构建 48 页 exit 0；E2E 37/37（快照口径）

Spec: 2026-11-02_blog-5g-pages (T3/T4 补充)

Co-authored-by: GLM-5.3
 2026-11-02 19:02:41 +08:00
wait4xandGLM-5.3 8debd99e61 feat(theme-home): 样式即数据 + 首页抽组件去重（5g T3/T4） 
【T3 样式即数据】
- content/site/theme.yaml 九组白名单旋钮（accent 明暗两值 / radius_img /
  text_h1-h3 / prose_size_reading|tech / leading_reading|tech /
  space_3-6 / flow_p 与 flow_h2_post / dur）；--measure、断点、纸墨、
  code 配色按方案 §3.6 红线不开放
- src/lib/theme.ts：getTheme() 钳制 + 单调性校验（h1>h2>h3、
  space3<4<5<6 任一不满足整组回落默认）；themeVarsCss() 产出
  `:root:root{…}` 与 `[data-theme="dark"]:root:root{…}`，靠特异性压过
  tokens 的 :root，不依赖注入顺序
- BaseLayout head 内联 `<style is:inline set:html={themeStyle}>`：构建期
  静态、运行时零 JS 零请求
- scripts/build-perf/contrast-check.mjs 读产物断言正文/强调 × 亮暗四项
  ≥4.5:1，不达标 exit 1；build.sh 守卫挂载（[ -f ] 守卫先行）
  实测：默认 12.40/10.53/6.30/7.06 全过；负例 accent #cccccc → 1.61:1 exit 1
  两坑入档：tokens 的 --bg 是 3 位简写需归一化；选 tokens CSS 要用
  `--bg:#` 定义断言（includes('--bg') 会误命中 var(--bg-soft) 引用）
- 后台 theme 单例 17 字段全中文 hint + 取值范围（分组约束写进 hint）

【T4 首页去重与细化】
- 新增 src/components/pages/HomePage.astro 承接全部区块（名片区富文本
  tagline/subtitle/社交、公告、文章列表、最新影像、热力图、项目墙、
  心跳），locale 一统；en 轨吃 postsEn 译题映射、图库链走 /en/gallery/，
  心跳仍仅 zh（零回归）
- 两 index.astro 缩成 4 行薄壳，双份漂移隐患消除
- home.yaml 三字段：projectsLimit(1-99 夹取，缺省 6)、announcement
  （双语 markdown 走 renderRich，空则不渲染）、postsTracks（三轨开关，
  在 HomePage 内过滤而非改 PostList，守边界）

验证: 构建 48 页 exit 0；contrast-check 四项 PASS；E2E 37/37（快照口径）；
      实测 theme 变量内联、公告 markdown 粗体渲染、projectsLimit 限流、
      photo 轨关闭生效；验收数据已还原

Spec: 2026-11-02_blog-5g-pages (T3/T4)

Co-authored-by: GLM-5.3
 2026-11-02 18:58:11 +08:00
wait4xandGLM-5.3 be87917443 chore(spec): 勾选已收编任务 T1/T2/T5/T7（T3/T4/T6 在途） 
Spec: 2026-11-02_blog-5g-pages

Co-authored-by: GLM-5.3
 2026-11-02 18:42:36 +08:00
wait4xandGLM-5.3 aaa9cd9274 feat(typography): 全站三层排版——富文本/页面级覆盖/艺术字体类 
- 层 1 所有页面文案改富文本：site-content 新增 renderRich(md,{inline})
  复用既有全管线（raw→内容净化→class 白名单→链接卡片）；接入
  home.tagline/subtitle、opensource.blurb、about.intro、blocks prose；
  新增 .rich 容器作用域并与 .prose-body 合并（77 处选择器覆盖四类容器）
  坑：renderRich 输出 <p> 塞进 <p class="tagline"> 会被浏览器拆散 →
  行内场景用 {inline:true} 剥外层 <p>
- 层 2 页面级排版覆盖：三单例加 typography{font?,accent?,scale?}，读取器
  pageTypography() 走白名单（10 字族 / 18 色类，scale 夹 0.8–1.25，清单外
  忽略）；页面容器挂 .page-typo + CSS 变量 --page-font/--page-accent/
  --page-scale，不动全站 tokens；后台三页加「页面排版覆盖」下拉
- 层 3 艺术字体：新增 font-art-kuaile（快乐体专用类，字距微调），白名单与
  可视化面板同步；站酷高端黑/阿里妈妈东方大楷/演示悠然小楷因无 npm 包或
  嵌入条款风险进候补清单
- 默认值清理：about.yaml 的 typography 测试值（整页汇文）清为注释示例——
  整页换字族会带来 694KB 字体成本，默认留空=全站默认排版

验证: 构建 48 页 exit 0；E2E 37/37；三页 page-typo 挂载与变量实测、四页
      （图库/书架/文章/装备）隔离为 0、font-art-kuaile 生效、about 清空后
      无覆盖

Spec: none (排版三层，先于 5g 的任务；T3/T4 另行交付)

Co-authored-by: GLM-5.3
 2026-11-02 18:40:32 +08:00
wait4xandGLM-5.3 2f7cbcf7bd feat(about): 块式页面构建器——九类区块 + 三级回落零回归（5g T1/T2） 
- schema：siteAbout 增 layout{showIdCard} + blocks（z.discriminatedUnion
  九类：prose/tracks/cards/timeline/quote/figure/linklist/cta/divider，
  图片字段走 Astro image()）；对未知块型用 z.union([knownUnion,
  z.looseObject({type})]) 复合——已知块严格校验，未知块落宽松分支再由
  访问器 WARN+丢弃（容错与严格校验的张力取舍）
- page-blocks.ts：enabled:false 过滤、未知 type WARN+skip、pickBi 回落
  zh 并 WARN、上限（块≤24/单块文本≤4000，超限截断并 WARN）
- BlockRenderer 统一外壳 `<section class="blk" data-block={type}>`（E2E
  抓手）+ 九个块组件（样式自 AboutPage 原 <style> 搬迁，只吃既有 token）
- AboutPage 三级回落：blocks → intro markdown → 内置默认；legacy
  tracks/build 段整体挪入回退分支（文案逐字一致，零回归）
- 图标白名单 src/lib/icons.ts（12 键，未登记回退首字占位）
- 后台 about 单例四段结构（blocks/layout/intro/typography），块为
  list+types+typeKey，每块带「显示」开关与中文标签

协调报备：车道修了一处跨车道插入事故（T3 把 typography 插进了 intro
的 widget 内导致字段错位），重写为四段正确结构；并发构建擦 dist 的
假失败改用「build→快照 dist→快照起服务跑 E2E」规避（37/37 稳定）

验证: 构建 48 页 exit 0；E2E 37/37（快照口径）；九类块顺序与配置一致、
      figure 走 /_astro/*.webp 管线、未知块与外链图被拦并 WARN、
      终版 3 块零回归、en 同构、admin about 四段字段齐全

Spec: 2026-11-02_blog-5g-pages (T1/T2)

Co-authored-by: GLM-5.3
 2026-11-02 18:21:33 +08:00
wait4xandGLM-5.3 6096a9dafe feat(opensource): README 四级回落 + 兜底 JSON 8 仓 + 项目可见性告警 
- site-content.ts：README 取数加 AbortSignal.timeout(10s)（原无超时，
  慢端点可卡整条构建）；四级回落矩阵逐级 console.warn 点名原因：
  新鲜网络（内容有变才回写缓存）→ token 缺位/HTTP 非 2xx/空/超时/异常
  时吃缓存 → 缓存亦缺回落 yaml blurb → 缓存回写失败（构建仓只读）仅告警
- README 图片加固：markdown 层给每个 img 补 loading=lazy + 缺省 alt
  （幂等；只动这两个属性，因为过 rehype-content-sanitize 白名单后其余
  属性会被剥）；相对链接不重写，限制写入 JSDoc 与文档
- projects.ts：单源失败点名、双源全失败点名回落 JSON、mode=only 的
  include 未命中双向点名（双源无此仓 / 被 perSource 过滤掉）
- projects-fallback.json：1 → 8 条真实仓（blog / open-earth-data-guide★58
  / AI-CLI / open-earth-data-kit / pi-mesh / pi-board / pi-jobd /
  ai-code-style-kit，字段对齐 RepoCard）

车道：worker-one（T5）；收编复验：E2E 37/37、构建 48 页 0 ERROR、
兜底 JSON 8 条断言过

验证: E2E 37/37 PASS；pnpm astro build 48 页 exit 0；fallback 8 条

Spec: 2026-11-02_blog-5g-pages (T5)

Co-authored-by: GLM-5.3
 2026-11-02 18:13:47 +08:00
wait4xandGLM-5.3 59eda420b3 perf(fonts): 字体子集化工具 + 汇文明朝单页 -40%（694KB→420KB） 
- 新增 scripts/build-perf/subset-fonts.py：读字体 CSS 的 @font-face
  （unicode-range）→ 扫内容收集实际用字 → 逐片交集裁切（pyftsubset
  --flavor=woff2）→ 空片丢弃、重写 src 只留自产 woff2；支持
  --chars-from/--chars-mode(all|headings)/--min-bytes/--merge
- 实测口径修正后结论（关键）：汇文明朝原 694KB/页 → 子集 420KB/页
  （-40%，真收益，已接入）；站酷快乐体 163KB → 177KB（+9%，字跨片
  分散致片数增加，**不启用**，保留原 @fontsource 源）
- merge 模式（合并单文件）标记实验性：fontTools.merge 对 CJK 切片字表
  冲突敏感，实测产出异常，生产不用
- 三处实现坑入档：①hast 与 @fontsource CSS 一个 face 常带多格式
  （woff2+woff），只替换首个 url 会残留失效引用（首版缺 58 个 .woff）
  → 改整段替换 src；②无 unicode-range 的 face 需按全范围处理，否则
  原样保留同样残留引用；③裸跑 pyftsubset 需 fonttools+brotli

验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 实测汇文
      694KB→420KB 且字体栈生效（WF-Hwmc 命中）

Spec: 2026-11-02_blog-5g-pages (T7)

Co-authored-by: GLM-5.3
 2026-11-02 18:13:47 +08:00
wait4xandGLM-5.3 740ec470fa chore(spec): 立项 blog-5g——页面后台化（blocks）与字体子集化 
按 docs/research/10 方案 E 拆七任务：块式页面构建器（T1/T2）、样式即数据
+对比度闸门（T3）、首页抽 HomePage 去双份（T4）、开源页收尾（T5）、文档
与 hint（T6）、字体子集化工具（T7）。三车道分配：op-gitea(T1/T2)、
op-artalk(T3/T4)、worker-one(T5/T6)、orchestrator(T7+统筹验收)。

Spec: 2026-11-02_blog-5g-pages

Co-authored-by: GLM-5.3
 2026-11-02 17:50:19 +08:00
wait4xandGLM-5.3 3822e150a8 feat(typography): 首批 6 字族落地（新增汇文明朝/站酷快乐）+ 13 款候补清单 
- 新增两款自托管字族：font-huiwen（汇文明朝体，文风开源 cn-font-split
  339 片切片包，用到页 +535KB、按需拉取实测 19/339 片）｜font-kuaile
  （站酷快乐体 +163KB）——补齐「宋明气质」与「轻松标题」两个字体缺口
- 首批 6 族全部 OFL-1.1 且允许 web 嵌入；未用字体的页面增量恒 +0.0KB
  （按页子集化生效）
- 候补 13 款逐款标注「许可证 + web 嵌入」：HarmonyOS Sans/MiSans/OPPO
  Sans/阿里普惠体（免费商用 + 明确允许嵌入，但 npm 无包/整包过大）、
  得意黑/更纱/站酷高端黑/花园明朝（OFL 但无可用 npm 分发）、霞鹜文楷
  Light（+8605KB 否决）、演示悠然小楷（"个人免费"常禁 @font-face，风险）
- docs 写入「加字四步流程」（核双授权 → 装包或放 public/fonts → 加类+
  白名单+面板项 → 跑体积账）
- 可视化面板 35 项（10 字族 + 25 颜色）；白名单放行 10 字族类
- 资产：public/fonts/hwmc（339 woff2 13MB + fonts.css 162KB）入仓

车道：op-artalk；收编复验：构建 48 页、E2E 37/37、两款新字体 computed
与切片按需加载实测（hwmc/27、52 等 20 个请求）

验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 新字体 computed
      + 字体请求观测

Spec: none (字体扩展，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 17:47:13 +08:00
wait4xandGLM-5.3 26bbb66a72 feat(typography): 16 类语义色板（8 色相×2 档）+ 字体回退升级 + 面板 v2 
- 颜色：c-{blue,teal,green,yellow,orange,red,pink,purple} × {标准,soft}
  共 16 类；tokens 明暗各一套值，32 项浏览器实测对比度 4.50–11.73（零失败）；
  黄色压到 #7a5900（原色白底仅 ~1.8:1）、黄/粉 soft 压深留余量
- 使用纪律入档：彩色只作用于正文强调，站点外壳（导航/页脚/按钮/背景/边框）
  保持灰阶，单页彩色强调建议 ≤3 处
- 字体：3/4 回退类升级为「自托管优先 + 系统兜底」（font-song→Noto Serif SC、
  font-kai-sys→霞鹜文楷、font-hei-sys→Noto Sans SC，+0.0KB 跨设备一致）；
  仿宋无 OFL 自托管包（fandol/朱雀仿宋均无版本）→ 纯系统回退，缺口待决策
- webfont 候选全部按体积账否决并留档：霞鹜文楷 Light 用到页 +8605KB、站酷小薇
  +648KB、得意黑/更纱/汇文无可用 npm 包；根因=@fontsource CJK 切片粒度
- 可视化面板 v2：33 项（8 字族 + 25 颜色），颜色项带 16px 色块预览、字体项带
  示例字形「秋海」并标注自托管/优先/系统；桩 CMS 7 项验证全过
- 白名单放行 25 色类 + 8 字族类；docs 三表（灰阶层级/语义色板含对比度/字体
  含许可证与体积账）更新

车道：op-artalk（改口径后重跑，实测表齐全）；收编复验：CSS 16 色类定义与
白名单一致、暗态值在 [data-theme="dark"] 段、字体回退类 computed 生效、
构建 48 页、E2E 37/37

验证: pnpm astro build 48 页 exit 0；E2E 37/37；playwright 抽查彩色类与
      字体回退 computed

Spec: none (排版色板与字体回退，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 17:14:12 +08:00
wait4xandGLM-5.3 2cab243891 feat(typography): 可视化排版选择器（Sveltia inline 组件）+ 颜色扩充 + 方案 10 
- 可视化选择（核心痛点解决）：Sveltia 原生支持 registerEditorComponent
  的 inline 形态且 onInsert 能拿到 selectedText → 实现「选中文字 → Insert ▸
  排版 → 选字体/颜色 → 自动包 span class」完整链路；因 inline 组件只能进
  Insert 菜单（field-based 虽可上工具栏但拿不到 selectedText），两个独立组件
  会互相抢 pattern 匹配，故收敛为单入口 + 18 项分组面板（键盘可达/Esc 取消/
  onEdit 回填当前类）
- public/admin/typography-classes.js 为单一事实源（扩展与文档共用）
- 颜色扩充 4 类：ink-warm / ink-cool / ink-faint / ink-accent-soft，全部亮暗
  双态实测 ≥4.5:1（ink-faint 取白底达标的最淡值 4.69/4.75）
- 字体：体积账否决 webfont 新增（@fontsource zcool-xiaowei 用到即 +647.7KB，
  远超 150KB 阈值；smiley-sans 无可用版本、sarasa 包为空壳），改为落地 4 个
  **系统回退类**（font-song/font-kai-sys/font-hei-sys/font-fangsong，零下载，
  文档注明依赖访客设备）
- 白名单 17 类同步；docs/写作指南.md 三表更新
- docs/research/10-页面后台化方案.md：五方案对比 + 推荐方案 E（页面骨架 blocks
  / 区块字段 / 局部自由区 / 样式即数据四层）+ 关于页九类区块 + 消毒与验收断言
  + 分阶段清单（约 7.2d）

验证: 16/16 颜色 computed 与对比度实测；选择器 7/7（桩 CMS 覆盖注册/插入/
      编辑三层）；构建 48 页 exit 0；E2E 37/37

Spec: none (排版能力 + 方案文档)

Co-authored-by: GLM-5.3
 2026-11-02 16:57:54 +08:00
wait4xandGLM-5.3 c5cdcd5bf9 feat(opensource): README 开篇接线+缓存入仓（收编遗漏补齐） 
zh 开源页补收编（此前只提交了 en）：githubReadmeMarkdown + renderMarkdown
接线，content/.github-readme.md 缓存入仓（现状 intro_from=off，开启即生效）。

验证: 构建 48 页 exit 0

Spec: none (收编遗漏补齐)

Co-authored-by: GLM-5.3
 2026-11-02 16:57:53 +08:00
wait4xandGLM-5.3 b0a3881725 fix(security): 页面文案 markdown 管线加标签/属性/协议净化（P0） 
方案 10 §7.1 实锤漏洞：renderMarkdown() 用无参 createMarkdownProcessor，
默认 allowDangerousHtml + 无条件 rehype-raw，页面文案（about intro、开源页
叙述、README）的 raw HTML 直通 set:html——script/style/iframe/on* 全不剥。

- 新增 src/lib/rehype-content-sanitize.ts：标签白名单（不含 script/style/
  iframe/object/form/link/meta/svg 等，危险标签整棵丢弃、未知标签解包保内容）
  + 属性白名单（a[href,title,rel]、img[src,alt,width,height,loading]、class/id）
  + 协议白名单（http/https/mailto + 站内相对 + 小图 data:）
- site-content.ts 插件链与文章管线同序：rehypeRaw → 内容净化 → class 白名单
  → 链接卡片（副作用为正：页面文案里的独立链接也会成 OG 卡片）
- 修两处自身实现坑（实测驱动）：hast 的 class 属性名是 className（按 class
  过滤会把合法排版类一起剃掉）；属性白名单需统一小写比较（驼峰 key 比不到）

验证: 注入载荷实测（<script>/<iframe>/onclick/style="color:red"/
      href="javascript:"）全部剥离、合法 class="ink-2" 与文本保留；
      构建 48 页 exit 0；E2E 37/37

Spec: none (安全修复，方案 P0)

Co-authored-by: GLM-5.3
 2026-11-02 16:57:52 +08:00
wait4xandGLM-5.3 859cac19a2 feat(cms): 首页四项可配 + 开源页项目可见性 + GitHub README 开篇 
- 首页：subtitle（markdown 短文本）｜latestPhotos 0-6（0 隐藏）｜
  perTrackLimit 4-8｜sections{tracks,photos,heatmap,projects} 开关，
  访问器 homeConfig() 夹取越界值，字段级回落默认（零配置=原形态）
- 开源页项目可见性：mode all|only|exclude + include[]/exclude[] +
  sort pinned-first|stars|updated + perSource both|github|gitea；
  projects.ts 加 LoadProjectsOptions + arrange()（来源→可见性→排序）
- 开源页开篇支持 GitHub README：intro_from off|github-readme，构建期
  取 wait4xx/wait4xx README（token 复用宿主 0600 文件）→ 缓存
  content/.github-readme.md 入仓 → renderMarkdown；失败逐级回落
  （缓存 → yaml blurb）。实测取到 3117 字符，现状仍 off 待用户开启
- 修既有 bug：orderPinned 内硬 slice(0,6) 把开源页 limit=99 也截到 6 条
  → 移除，开源页恢复全量 16 条
- 文档：写作指南加首页/项目墙两张字段表（含 YAML 1.1 `off` 需加引号坑、
  README 行为与外部徽章风险说明）

车道：op-gitea（3/3）；收编复验：构建 48 页 + E2E 37/37 + 开源页 16 条 +
首页默认形态（2 轨/热力图/项目墙）无回归

验证: node v26.13.0 构建 48 页 exit 0；E2E 37/37 PASS；playwright 实测

Spec: none (首页与开源页后台扩展，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 16:45:01 +08:00
wait4xandGLM-5.3 8d221ab36e fix(home): 分轨标题贴左——space-between 把中间项挤到正中 
分轨标题行有三个 flex 子项（::before 灰点 + 「阅读/技术」文本 + 右侧
「全部文章 →」），justify-content: space-between 会把中间的标题文本
挤到正中（用户实测"阅读/技术居中了"）。改为 flex-start 贴左 + 链接
margin-left:auto 右推。实测标题距容器左缘 18px（灰点+间距），链接贴右。

验证: pnpm astro build 46 页 exit 0；playwright 实测两段标题 titleLeft=18
      linkRight=0

Spec: none (单点样式修复)

Co-authored-by: GLM-5.3
 2026-11-02 16:39:11 +08:00
wait4xandGLM-5.3 c4bdf46614 fix(ops): .mjs MIME 修复脚本——pdf.js worker 线上加载失败根因 
线上 /_astro/pdf.worker.min.*.mjs 被 nginx 以 application/octet-stream
返回（mime.types 无 mjs 映射），浏览器拒绝以 module worker 加载 →
/papers/ 页 pdf.js 静默回落兜底卡；本地 python 测试床能猜对 MIME 故未
暴露。脚本幂等追加 mjs 到既有 javascript 映射行，-t 门禁+回滚+线上终验。

验证: bash -n 过；线上 worker 头实测 application/octet-stream（病根实证）

Spec: none (运维修复脚本)

Co-authored-by: GLM-5.3
 2026-11-02 16:03:30 +08:00
wait4xandGLM-5.3 280654f9e3 feat(reader): PDF 改 pdf.js 渲染+斜体 bug 根治+评论假挂载修复+排版类 
【T1 PDF 内置阅读重做】iframe 对 arXiv PDF 实测 ERR_ABORTED（浏览器 PDF
插件策略差异）→ pdfjs-dist 6.4.299 客户端 canvas 渲染：只在 /papers/
动态 import（worker ?url 打包，不进全站 bundle）；文档一次取回 + IO
懒渲染（rootMargin 400px）+ 页占位 aspect-ratio 防跳动 + 12s 首屏兜底 +
微信 UA 直接兜底；工具条页码/缩放/翻页/下载/arXiv/授权声明保留。红线：
PDF 由访客浏览器直取 arXiv（CORS * 实测），仓内零副本。真页实测：
13 页 canvas 全绘制、首屏墨迹像素非空、零 console 错误。

【T2 斜体排版 bug 真凶】global.css 的 `.prose-* p > em:only-child
{ display:block; text-align:center }` 图注样式按"斜体独占段"自动命中，
把所有正文独占段斜体变成块级居中。改：图注用显式 .fig-cap 驱动 + 补
em/i { display:inline; font-style:italic } 基线；media-sample 迁移新写法，
指南注明旧写法失效原因。实测独占段与行内斜体均 display:inline/italic。

【T3 评论"假挂载"真 bug】原 initArtalk 一进来就置 mounted=true——脚本
404/被拦截时把空容器误标已挂载，5s 兜底被绕过，正是"评论区一直空着"的
来源之一。改为库就绪才算成功；另加三触发路径（IO 主 + 锚点点击 + 滚到
页底 2s 兜底）、5s 失败提示+重试钮、软导航重挂、成功打
data-artalk-mounted=1 供 E2E。

【T4 文章排版类 + 安全白名单】11 个受限类（ink-1/2/3/muted/accent、
font-serif/kai/sans/mono、drop-cap、quote-line、fig-cap）全走 tokens 禁
任意 hex；新增 rehype-class-whitelist.ts：className 白名单 + 剥离 style
与 on*；实测注入用例只剩 class="ink-2"，style/onclick 全无。新坑入档：
markdown raw HTML 在 hast 是 type:'raw' 节点、白名单插件看不见 span，必须
先 rehype-raw 再过滤 → 插件链 [rehypeRaw, rehypeClassWhitelist,
rehypeLinkCards]。新依赖：pdfjs-dist、rehype-raw。

车道：op-artalk（T1 6/6、T2 2/2、T3 3/3、T4 6/6）；收编复验：build 46 页、
E2E 37/37、四专项 playwright 实测（PDF 13 canvas/斜体 inline/白名单净化/
评论 mounted 标记）

验证: node v26.13.0 + astro 7.4.4 构建 46 页 exit 0；E2E 37/37 PASS

Spec: none (阅读体验四件，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 15:59:28 +08:00
wait4xandGLM-5.3 328ab68f18 feat(cms): 后台扩展五件——关于页 markdown 化/社交/头像/favicon/分轨首页 
- T1 关于页=markdown 文档：about.yaml intro 扩为多段 markdown（zh/en），
  AboutPage 用 @astrojs/markdown-remark 的 createMarkdownProcessor（进程
  内单例复用）+ set:html 渲染，正文 p/ul/strong/a 对齐站点排版；名片与
  技能卡结构不动
- T2 社交链接单一数据源：home.yaml socials[]（label/url/icon）+
  SocialLinks.astro（图标注册表白名单：github/rss/email/bilibili/x，
  未登记 icon 回退纯文字），首页 zh/en 内联硬编码社交块删除
- T3 头像与 favicon 可上传：schema avatar: image()（Astro Image 出 60px
  WebP，未设回退渐变 SVG）；home.yaml favicon → BaseLayout link[rel=icon]
  按扩展名给 type，留空回退 /favicon.svg
- T4 首页分轨：PostList perTrack → 阅读轨/技术轨两段各限 6，各自出口
  （阅读→/books/ 技术→/archives/，en 同构）；E2E 断言改为两段各≤6+各自
  出口+阅读在前
- T5 后台列表日期：posts summary「{{pubDate}} · {{title}}」、moments
  「{{fields.pubDate}} · {{fields.text}}」+sortable；photos 无 frontmatter
  日期（JSON sidecar）保持分组 · 标题并在文档写明原因
- 顺手修 content-lint 漏报：中文文件名在 HTML 里为 %XX 编码，脚本直接
  拼盘上路径导致 6 条"缺图"误报 → 加 decodeURI
- 清理：删除书封误传遗留的双重嵌套目录文件

车道：op-gitea（5/5，build+E2E 37/37+lint 47 页 0/0/0）；收编复验：
build 46 页 + E2E 37/37 连跑（首跑两红为车道并发构建擦 dist 的瞬时态，
复跑绿）

验证: node v26.13.0 + astro 7.4.4 全量构建 46 页 exit 0；E2E 37/37；
      content-lint 0/0/0；books details/命令面板 playwright 实测

Spec: none (后台能力扩展，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 15:46:41 +08:00
wait4xandGLM-5.3 227bc24797 build(deps): Node 26.13.0 + Astro 7.4.4 升级（含 exif loader 句柄修复） 
- 宿主 Node 22.22.3 → 用户级安装 26.13.0（~/.local/node），systemd
  unit PATH 前置，CI 构建链同步吃到新版本
- Astro 7.3.8 → 7.4.4（7.4 要求 Node ≥22.23.4，此前升级因 Node 版本
  不足被 CI 拒绝；本次先升 Node 再升框架）
- exif loader 修复：Node 22.23+/26 把"GC 时仍打开的 FileHandle"从警告
  升级为错误，exifr 接收文件路径时自开 fd 不显式关闭 → 全线 content/
  photos/*.jpg 触发构建失败。改为一律 readFile 成 Buffer 再喂 exifr
  （无 fd 参与）

验证: 全量构建 44 页 exit 0（node v26.13.0 + astro 7.4.4）；E2E 37/37；
      content-lint 0/0/0；后处理链（字体子集/首页内联）复跑通过；
      unit PATH 实测已前置 node26

Spec: none (运行时与框架升级，全链验收)

Co-authored-by: GLM-5.3
 2026-11-02 15:27:28 +08:00
wait4xandGLM-5.3 7c1462bde0 fix(admin): 书封上传路径修复——media_folder 相对解析 + Astro 暂留 7.3.8 
- Sveltia 对 folder 集合的 media_folder 按"相对集合目录"解析：写成
  content/posts/assets 会二次嵌套成 content/posts/content/posts/assets
  （用户在后台首次上传书封即踩，文件落错位置 + cover 引用缺失 →
  构建 ImageNotFound，发布链中断）。修为 assets，并把已落错位置的
  书封文件移到 content/posts/assets/
- Astro 7.4.4 需要 Node >= 22.23.4，宿主为 22.22.3：升级将锁死 CI
  构建（实测 CI 报 not supported）。本笔回落到 7.3.8 恢复发布链；
  Node 升级后另行升级 Astro（含全链验收）

验证: pnpm astro build 44 页 exit 0；书封图片入 content/posts/assets/
      与文章 cover 路径一致

Spec: none (后台路径修复 + 依赖回滚)

Co-authored-by: GLM-5.3
 2026-11-02 15:09:03 +08:00
wait4x 5c814f0866 Update 页面文案 “opensource” 2026-11-02 06:59:40 +00:00
wait4xandGLM-5.3 8f01d825b7 build(deps): Astro 7.3.8 → 7.4.4（同 major 小版本升级） 
- 项目 Phase 1 曾故意锁 7.3.8（Astro 7 换 Rust 版 Sätteri Markdown
  处理器，自定义插件压在 legacy unified 路径上）——现 D 车道已装
  @astrojs/markdown-remark 兜住该路径，升级窗口成熟
- 7.4.x 对本站有实际收益的三项修复：①<Image>/<Picture> 重复 srcset
  候选（图库/书封/OG 卡缩略图大量使用）②ClientRouter 返回导航不再播放
  smooth 滚动动画（本站开 View Transitions）③未使用组件 scoped 样式
  泄漏（与 CSS 体积优化相关）
- 升级后清 node_modules/.astro（渲染缓存）全量重建

验证: 全量构建 45 页 exit 0；E2E 37/37 PASS；content-lint 0/0/0；
      后处理链复跑（字体子集 8.0→3.2MB 60% 裁减、首页 CSS 内联、
      SW 预缓存 19 路由）；回归抽查（图库 srcset 零重复候选=7.4 修复
      实证、灯箱开合、g s 弦、链接卡片渲染）全过

Spec: none (依赖小版本升级，全链验收)

Co-authored-by: GLM-5.3
 2026-11-02 14:58:35 +08:00
wait4x f8562510e6 Update 文章 “hai-feng-zhong-shi-luo-de-xie-se-kui-zeng” +1 2026-11-02 06:55:03 +00:00
wait4x 952e68e6ea Delete 瞬间 “2026-04-29-2” +1 2026-11-02 06:51:59 +00:00
wait4xandGLM-5.3 46d248877f fix(opensource): zh 开源页补 pinned 参数接线（收编遗漏） 
内容管理车道改了 zh/en 双页，收编时只圈了 en 版，zh 版靠默认
PINNED_DEFAULT 兜底（行为等价但接线不一致）。补收编。

验证: pnpm astro build 45 页；E2E 37/37；content-lint 0/0/0

Spec: none (收编遗漏补齐)

Co-authored-by: GLM-5.3
 2026-11-02 12:50:32 +08:00
wait4xandGLM-5.3 f5232b7c03 feat(content): 链接卡片模式——独立成段裸链接转 OG 预览卡 
- rehype-link-cards.ts 构建期插件：段落仅含一个链接才转卡（内联链接
  保持普通样式）；fetch OG/twitter 元信息（UA 伪装、4s 超时、只读前
  200KB）+ favicon 兜底；任何失败回落普通链接，构建绝不因外部站点挂
- content/.link-cache.json 入仓缓存（30 天刷新，构建确定性与零重复
  请求）；单篇上限 10 卡、并发 4，超出回落
- LinkCardStyles.astro 灰阶卡片样式：hairline+圆角、favicon 16px、
  标题一行/描述两行截断、域名 mono、OG 图右侧 88px（无图不占位）、
  hover 1px 微浮（reduced-motion 豁免）、纯 CSS 零 JS
- 安全：抓取内容全 escaping、图片地址仅 http(s)
- @astrojs/markdown-remark 依赖（Astro 7 换默认 markdown 处理器后
  自定义插件必须经此包生效）
- 样张 content/posts/link-cards-test.md（tags 含 hidden，活样例不列出）

修复说明：264148f 提交时误带入 archives 页面对 LinkCardStyles 的
import（两车道共改同一文件），本笔补全组件与插件，恢复构建仓可用。
教训：跨车道共改文件，staged 前必须看 diff 归属。

车道：op-artalk；收编复验：本地构建 45 页 + 卡片渲染（后续专项复验）

验证: pnpm astro build 45 页 exit 0；link-cards 样张页渲染正常

Spec: none (链接卡片，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 12:46:26 +08:00
wait4xandGLM-5.3 264148f0a6 feat(cms): 内容管理闭环——站点单例三件套+文章视频字段 
- A 站点文案单例：content/site/{home,about,opensource}.yaml +
  src/lib/site-content.ts 访问层（字段级回落默认，默认值=原文案逐字
  一致，零回归）；接线主页 tagline（en 首页新增该块）、关于页 intro、
  开源页叙述三段 + PINNED 参数化（projects.ts: loadProjects(pinned)
  /orderPinned，PINNED_DEFAULT 仅缺省兜底）
- loader 语义修正（返工如实入档）：Astro 7 的 file() 把 YAML 顶层对象
  按 Object.entries 拆成多条目（id=key、data=value），单例字段必炸
  schema；改 glob 精确到单文件 = 真单例语义，data 即文件根对象，
  Sveltia 可编辑根字段零嵌套（比包 main: 层的方案后台体验更好）
- B 文章媒体：posts +video/+poster；Sveltia file 字段
  （media_folder=public/media、public_folder=/media、hint ≤50MB）；
  正文后渲染 video controls preload=metadata playsinline，无则不渲染；
  图片链路核对本已一致（./assets 走 Astro 管线）；链接 markdown 原生
- docs/写作指南.md 补「后台上传」节（三类媒体 + 三单例操作 + 体积纪律）

Sveltia 集合：posts / moments / photos / site_pages（三单例）

车道：op-gitea（实测 tagline 改 yaml 产物联动、置空回落默认、pinned
改名排序变、视频临时件渲染全对、构建绿 + lint 45 页 0/0/0）；收编
复验：构建 44 页 + E2E 37/37 + 三 yaml 扁平键就位

验证: pnpm astro build 44 页 exit 0；E2E 37/37 PASS；content-lint
      0/0/0；播放器/单例/置顶 playwright 实测全过

Spec: none (内容管理闭环，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 12:42:10 +08:00