wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
169 Commits 5 Branches 0 Tags
ed473e996a3707f98015a40e4388aa4fa58b79ac
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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
wait4xandGLM-5.3 5be09b6f32 fix(admin): 后台后端改博客域同源反代——绕开 git 域 522 
git.wait4x.online 公网 522（源站侧待查）卡死 Sveltia 登录。
config.yml backend 改 base_url=https://wait4x.online/gitea +
api_root=.../api/v1；新增运维脚本给博客 vhost 加 /gitea/ 反代
→127.0.0.1:13020（Host 伪 git 域、no-store、noindex；幂等+-t 门
禁+回滚+双口径终验）。同源后 CORS 问题一并消失。

验证: yaml 解析过；pnpm astro build；bash -n 过

Spec: none (后台可用性修复)

Co-authored-by: GLM-5.3
 2026-11-02 11:18:35 +08:00
wait4xandGLM-5.3 de42fed52e fix(ops): /admin/ 404 修复脚本——location 块补 root 
病根：博客 vhost 的 root 写在 location / 内（launch.sh 静态切换设
计），nginx 的 location 不向上继承 root，故后来加的 location
/admin/ 块落到默认根目录 → 404（用户打不开后台的直接原因）。
脚本幂等重写 admin 块（root+index+noindex 局部），-t 门禁+回滚+
双口径终验。

验证: bash -n 语法过；本地 dist/admin 三件齐全（config/index/js）

Spec: none (运维修复脚本)

Co-authored-by: GLM-5.3
 2026-11-02 11:13:09 +08:00
wait4xandGLM-5.3 845c45aa11 feat(admin): Sveltia 加 posts 集合——文章与书封纳入后台管理 
内容管理闭环补齐：文章（三轨，书=reading 轨同集合）可在后台新建
/编辑/上传书封；media 指 content/posts/assets（public ./assets，书封
上传即自动写路径）；含标题/日期/分轨/标签/情绪色/原书作者/策展
描述/书封/隐藏/草稿/正文全字段。英文仍走 TMT 预翻译入仓，不进
后台防误改译文。

验证: yaml 解析三集合 posts/moments/photos；pnpm astro build 通过
      （admin 静态产物含新 config）

Spec: none (后台集合扩展)

Co-authored-by: GLM-5.3
 2026-11-02 11:10:00 +08:00
wait4xandGLM-5.3 0e06c25f67 feat(gallery): 灯箱 v2.2 定版——一律侧栏 200px+长文策略+六条 polish 
布局统一（视觉轨像素实测裁定 A 改窄变体：侧栏方案让照片比底
栏方案大 39%/22%）：≥820 全比例右侧栏 200px（舞台恰 1080×720
零信箱）、竖横顶部统一 26px；<820 底部抽屉。EXIF 两行折行+分段
span（字段级 nowrap+::before 绑后段符号——一刀治悬空/断点丢符/
间距不对称三症状）；caption clamp 4 行+展开（桌面 60dvh/移动
40dvh 内滚，锁 --fig-h 保证展开前后图区几何不变）；移动底条
flex 复活+箭头同排+EXIF 两行；提示胶囊移动挂顶+触屏文案；820
计数间隙 14px；全量左对齐（孤字居中终止）。

车道：op-artalk（专项 8/8×3 轮+E2E 37/37）；视觉轨道三轮裁定
（需修→复检→定版），EXIF 间距自验 5.2px 对称、换行对 1（镜头
名独占行，非缺陷）

验证: E2E 37/37；EXIF 三段宽 measured（5.2px 对称/符号 ::before
/无悬空）；移动 flex+提示顶挂实测；五档几何（1280 横竖/820/768/390）

Spec: none (灯箱 v2.2 定版，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 10:30:35 +08:00
wait4xandGLM-5.3 3b951d3de6 feat(archive): 文章折叠——首页 6 篇+归档年月折叠+书架年折叠 
①首页 PostList limit=6 + 「全部文章 →」双轨入口（用户拍板 6 篇）
②/archives 年 <details>（最新年 open，summary「2026 · N 篇」+▸ 自绘
箭头）+ 年内按月分组小标题；零 JS 依赖、内容全在 DOM（SEO
无损）③/books 年折叠（色脊/书封渲染零改动）④E2E +3 断言
（首页≤6+入口/归档 open 唯一+月分组/书架年组不变量）

E2E 弦键竞态根治：折叠批的多次导航扰动 g-chords 时序——洁净起
点（先回稳定页）再测弦，测试意图不依赖前序状态，37/37 连跑稳定

车道：op-gitea（lint 43 页 0/0/0）；收编复验首页 6 行+入口/归档
1 年开 12 月组/书架年折叠/en 轨全过

验证: E2E 37/37 连跑两次；content-lint 0/0/0；首页/归档/书架/
en 四页 playwright 实测

Spec: none (折叠批，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 10:00:45 +08:00
wait4xandGLM-5.3 9702c9faf4 feat(books): 书封接口——schema cover 字段+书架卡封面渲染 
posts schema 加 cover?: image（image() 走 Astro 优化管线，仅阅读
轨消费）；BooksPage 有封面渲染 96/192 两档 Image、无封面优雅回
退现有色脊卡设计（零破坏）；目录 content/posts/assets/books/ 就位；
docs/写作指南.md 补用法节（路径/frontmatter 示例/尺寸建议）。

验证: pnpm astro build；E2E 34/34；现 5 本书全部回退色脊卡渲染
（封面貌 0，待用户加图）

Spec: none (书封接口预留，用户自行加图)

Co-authored-by: GLM-5.3
 2026-11-02 09:12:34 +08:00
wait4xandGLM-5.3 2e33a7cd2e fix(pwa): SW 缓存版本 v2→v3——冲刷主题修复前的旧页缓存 
用户报首页刷新偶现浅色、内页深色。本地/生产双端复测均正确
（首帧即 dark），最可能是 SW 缓存里残留 data-astro-rerun 修复前的
旧首页（无主题脚本）。版本号 bump 强制 activate 清旧缓存。

验证: pnpm astro build；本地四页帧序列实测全 dark

Spec: none (缓存冲刷，环境性症状防御)

Co-authored-by: GLM-5.3
 2026-11-02 09:06:42 +08:00
wait4xandGLM-5.3 3050b0b959 feat(article): 正文图片可放大——PhotoZoom 极简 viewer 双轨挂载 
正文 .prose-reading/.prose-tech 图片单击唤起全屏 dialog：fit-
contain+滚轮光标锚点缩放 1-5x+拖拽（钳制数学与图库 v2 逐行同
源）+双击 1x↔2.5x+Esc/关闭/背景点击关（contain 内容盒几何判
定）；无 EXIF/caption/FLIP（纯图极简，按契约）；document
委托点击软导航后仍生效。

车道：op-artalk（专项 9/9：SVG 架构图唤起/矢量 2.46x 不栅格化/
拖拽钳制/双击回正/Esc/jpg/背景关/软导航）；收编验收四断言+E2E
34/34 全过

验证: 文章 SVG 点击唤起+滚轮放大（naturalWidth 960 矢量源）+Esc
      关闭实测；E2E 34/34

Spec: none (文章图放大，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 08:47:24 +08:00
wait4xandGLM-5.3 a761cf8129 feat(papers): 论文内置阅读——arXiv iframe 零再分发合规方案 
Agensh（arXiv 2609.26781）在线研读页：/papers/agensh/ 双轨薄壳
_PaperView 共享视图+六词条；信息条含标题/作者/abs 链接/授权声明
（arXiv nonexclusive-distrib 1.0，非本站托管）/下载钮。

合规红线：许可证禁第三方再分发→仓内零 PDF 副本，iframe 直嵌
arxiv（实测无 X-Frame-Options）；微信 webview 前置 UA 检测加
is-wechat 类、iframe 不挂 src 零无用请求、兜底卡指引右上角浏览
器打开；非微信 data-src 懒挂载+9s 弱兜底+noscript 兜底。正文
入口卡双轨已渲染。

车道：op-gitea（专项四断言+E2E 34/34）；收编复验六断言全过
（iframe/授权/微信降级/en/入口卡/零 PDF）

验证: E2E 34/34；微信 UA 模拟 is-wechat=true src 空 提示在；
      git status 零 .pdf

Spec: none (论文阅读页，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 08:41:39 +08:00
wait4xandGLM-5.3 bbb52b9e24 docs(post): 删除《单人博客的多智能体工程》（用户拍板） 
与三篇工具详解定位重叠，用户选择保留详解三部曲。删除为单点
操作：无 en 版、无 translation-state 条目、无他文内链引用；构
建 42 页、lint 43 页 0 违例复验通过。

验证: pnpm astro build 42 页；content-lint 0 断链 0 缺图 0 配对
      警告；dist 无残留页

Spec: none (内容删除，用户决策)

Co-authored-by: GLM-5.3
 2026-11-02 08:39:02 +08:00
wait4xandGLM-5.3 8571acdc8b feat(post): 工具三部曲——spec-harness/pi-mesh 全家桶/Agensh 论文笔记 
用户直派车道交付：①Spec Harness 详解（任务包解剖+流水线图，
boundary/verify 实例+12 命令+门禁）②pi-mesh 四件套（stack 图+
合奏循环图+上手安装）③Agensh 论文笔记（三支柱/协作环/规模收
益图，DeLM 血统+issue#13→pi-board 诞生线）。七张自绘 SVG、双
语（en 手写直译 locked:true，禁 TMT 覆盖）。与既有 spec-
workflow-and-mesh（实战复盘向）互补并存。

车道：worker-one（build/lint/外链 curl/视觉两轮 7/7 全绿）；收
编复验 E2E 34/34+lint 43 页 0/0/0

验证: pnpm astro build 39 文；E2E 34/34；content-lint 0/0/0

Spec: none (内容三篇，直派车道收编)

Co-authored-by: GLM-5.3
 2026-11-01 13:35:27 +08:00
wait4xandGLM-5.3 127f349fb2 feat(gallery): 灯箱 v2.1 十项全量——起飞开合/隐层/侧置 meta/HD 
①FLIP 原位起飞/回落（克隆双态矩形插值，关闭回落取缩略图实时
矩形）②背景点击关（containRect 几何判定——img 盒铺满 figure 的
元素链判定失效坑）③chrome 双层淡入+i 键/zoom 自动隐（换片重置）
④相邻预载 ⑤双指缩放 ⑥换片侧向过渡 ⑦缩放指示+首开提示 ⑧竖
图侧置 meta ⑨>1.5x HD 原图交换+404 兜底 ⑩竖拖关闭。reduced-
motion 全豁免；钳制数学保留。

验收三连修：chrome-in 动画 both 填充锁死 opacity（animation:none
掐填充——动画填充压制普通声明的级联陷阱）；× 钮独立于双层
chrome 补隐（全隐口径=只剩图，Esc/i 逃逸）；视觉终审四问修复
后全过（起飞连贯/侧置成立/隐层纯净/亮暗同判）。

车道：op-artalk（专项逐项+E2E 34/34）；收编验收+视觉终审双绿

验证: E2E 34/34；三态隐层 computed 实测（i 隐/复原/zoom 隐全
过）；全隐残留零（×/caption/箭头）；Esc 逃逸 ✓

Spec: none (灯箱 v2.1 定版，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-01 13:21:15 +08:00
wait4xandGLM-5.3 d8997c3c72 feat(gallery): 灯箱 v2 收编——caption 字段全链+21 条视觉轨拟稿 
schema caption?:string（人为描述，注释区别 alt 无障碍语义）+
Sveltia textarea 字段+21 条 json 全量上稿（视觉轨看图代拟策展
语气，用户可后台逐条改）；GalleryPage 灯箱重构与缩放交互已随
44626f8/54769bc 入库，本笔补数据面。

车道：op-artalk（专项 8/8+E2E 34/34）；视觉复核三问 PASS
（舞台纯净/meta 分层/caption 策展语气），唯一需修点=放大态
caption 遮挡→v2.1 ③ zoom 自动隐层已立项在治

验证: E2E 34/34；caption 渲染实测「落日把海与城一齐烫成金
箔…」；content-lint 0/0/0；schema 过构建

Spec: none (灯箱 v2 数据面收编，交互面已在库)

Co-authored-by: GLM-5.3
 2026-11-01 12:51:20 +08:00
wait4xandGLM-5.3 44626f8edc fix(lightbox): 回 1x 自动归中+平移四向钳制（用户实测 bug） 
用户实测：缩放回 100% 图片不回中显示不全；另放大态可拖飞出舞台。
三修：zoomAt next<=1 归零 translate；applyZoom 平移钳制 |t|≤尺
寸差/2（放大态不变量=图盒覆盖舞台而非缩在视口内）；滚轮下限
0.5x→1x（fit 即最小，0.5x 制造偏移态）。mockup 同步三修。

验证: 回 1x transform=none 实测；四角极限拖拽覆盖舞台不变量
全过；E2E 34/34

Spec: none (用户实测 bug 热修，线上 v2+mockup 双修)

Co-authored-by: GLM-5.3
 2026-11-01 12:34:11 +08:00
wait4xandGLM-5.3 54769bcfdf docs(research): 灯箱深度美化探索+可交互 mockup（v2.1 提案） 
五站研究（PhotoSwipe 源码级核对/medium-zoom/Unsplash◐/图虫◐/Flickr）
→ 六维差距 → v2.1 增强提案十项（P0=原位起飞开合+背景点击关；P1=
chrome 双层淡入/相邻预载/双指缩放；P2=换片过渡/缩放指示/长图侧置
meta/HD 交换/竖拖关闭）+ 明确不做清单八条 + 可交互单文件 mockup
（仓内实拍 5 张、13 项交互可点）。

验证: mockup 引用路径 ../content/photos/ 相对仓根可开；文档引文对
PhotoSwipe defaultOptions 源码核对注记

Spec: none (研究文档+设计预览稿，v2.1 立项待用户拍板)

Co-authored-by: GLM-5.3
 2026-11-01 12:09:51 +08:00
wait4xandGLM-5.3 541710b50a feat(post): 单人博客的多智能体工程——spec 与 mesh 实战复盘 
四节+结语：19 连发压力日引入 / spec 任务包（blog-5f 实引 verify
原文与已证伪路径）/ mesh 交通规则（契约式下达-预约拦刀实录-守卫
铁律）/ 纪律从事故长出来（验收先探实值-口径错配-五段式运维-视觉
双轨-解封后 SEO 100）。全部数字与命令对档核验。

车道：worker-one（1906 字/schema 过/lint 0 违例）；收编补引文精度
（T1 verify 对齐原文四条件）

验证: pnpm astro build 36 页；E2E 34/34；content-lint 0/0/0

Spec: none (内容文章，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-01 11:58:42 +08:00
wait4xandGLM-5.3 2b8353837a feat(ops): SEO 解封收尾脚本——default 混合文件逐块精确锚定 
default 内四 server 块共存（三面板+博客），文件级 v3 脚本无法区
分；本脚本按各自 server_name 锚定：面板块补 noindex、博客块加
/admin/ 局部；幂等可重跑、备份出加载路径、nginx -t 失败回滚、
nginx -T 配置级终验（不受边缘缓存干扰）。

验证: bash -n 语法过；锚定正则对 default 实文件 server_name 四行
干跑（面板命中/博客精确/互不误中）

Spec: none (用户操作单自动化收尾件)

Co-authored-by: GLM-5.3
 2026-11-01 11:17:45 +08:00
wait4xandGLM-5.3 3b65cc47ec fix(ops): seo-unblock v3 补——博客主站判定字符类修正 
v2 残留：([[:space:]];|$) 被解析为空格+分号序列而非字符类，-x 兜底
吃行首缩进——admin location 两轮未落。统一 (^|[[:space:];]) 词边界
并显式排除 git 子域。

验证: bash -n 过；判定正则对 /etc/nginx/sites-enabled/default 实文件
干跑（博客行命中/git 行排除双验）

Spec: none (脚本热修 v3 补)

Co-authored-by: GLM-5.3
 2026-11-01 11:16:21 +08:00
wait4xandGLM-5.3 ca7d71325c fix(ops): seo-unblock v3——补回判定反转名单制为 include 圈 
v2 名单制漏 dpanel/ms365/ddns（同 default 文件 include snippet，剥
离后集体失守 noindex，实弹发现）；v3 改凡 include esa-origin-ssl
且非博客主站一律补回，博客判定同步修正字符类。

验证: bash -n 语法过；判定正则对 default 实文件 server_name 复核

Spec: none (脚本热修 v3)

Co-authored-by: GLM-5.3
 2026-11-01 11:16:03 +08:00
wait4xandGLM-5.3 d41fcc058c fix(ops): seo-unblock v2——备份出加载路径+主机判定精确 token 
v1 实弹暴露两缺陷：①.bak-seo 备份留在 sites-enabled/ 内被 nginx
glob 加载→duplicate default server 全链崩；②grep -w 词边界点号
之误，git.wait4x.online 也被当博客主站注入 admin location。
v2：备份入 /tmp 专属目录+回滚后清理（含 v1 遗留）+server_name
精确 token 判定。

验证: bash -n 语法过；dry-run 计划段与判定正则复核

Spec: none (脚本热修：v1 事故根因双修)

Co-authored-by: GLM-5.3
 2026-11-01 11:11:27 +08:00
wait4xandGLM-5.3 50c7595838 feat(ops): SEO 解封一键脚本——预览确认执行自检回滚五段式 
nginx 侧全自动（snippet 剥离/内部 vhost 补回/admin 局部/失败回
滚/源站终验），ESA 三动作打印手动步骤；dry-run 先行+确认门。

验证: bash -n 语法过；dry-run 输出与 Phase 5f T1 操作单变更计划一致

Spec: none (用户操作单自动化，Phase 5f T1 收尾件)

Co-authored-by: GLM-5.3
 2026-11-01 11:06:58 +08:00
wait4xandGLM-5.3 bb29c8abaf fix(deploy): 构建抓取通道可配+构建日志落盘——ESA 522 事故双根治 
- build.sh：BLOG_GIT_URL 环境变量（默认公网，同机构建可指内网
  http://127.0.0.1:13020）；每次构建 remote set-url 后 fetch——
  2026-10-26 事故：ESA 边缘对 git.wait4x.online 522 时公网 fetch
  set -e 静默死，staging 冻结 150s+ 无痕
- webhook_receiver.py：构建输出落盘 ~/docker_apps/blog/build.log
  （capture_output 丢弃=黑洞，本次事故"构建为何没跑"零证据）；
  与运行副本双同步纪律维持
- 宿主 unit 补 BLOG_GIT_URL 内网通道（配置在 unit 不在仓——主机
  特定值不污染仓库默认）

验证: 手动构建实测 stamp=19b2390+robots.txt 352B 上线；18743 测试
      床恢复 200；smoke 对 staging 软门容忍符合 T1 转硬门前设计

Spec: none (发布链通道与可观测性修复，事故驱动)

Co-authored-by: GLM-5.3
 2026-11-01 09:58:47 +08:00
wait4x 19b2390cbf Merge branch 'spec/2026-10-26_blog-5f' 
Phase 5f 交付：SEO 解封仓库侧（robots+操作单）+ localePath 三处一刀治与 canonical 全量 + 构建期内容 lint/生产冒烟 + reader 纯文本模式 + 版式基底（流距 token/灰阶降档/字重/focus ring）+ 首屏 tagline + 图库暗衬底 + 代码块窗条 + 书评纸卡（视觉双轨复核 PASS）。

Spec: 2026-10-26_blog-5f
 2026-11-01 09:51:27 +08:00
wait4xandGLM-5.3 983527a79d chore(spec): 归档 blog-5f——八任务收敛 
Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:51:26 +08:00
wait4xandGLM-5.3 23ea8e5a55 chore(spec): 5.1 归位——全项目检查含升级条件+升级触发双字段 
Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:49:52 +08:00
wait4xandGLM-5.3 57f19d855b chore(spec): 5.1 升级条件措辞对齐门禁 
Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:42:01 +08:00
wait4xandGLM-5.3 a2395be379 chore(spec): T6 verify 管道笔误修正（-q 无输出喂 grep -v 恒退 1） 
Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:40:04 +08:00
wait4xandGLM-5.3 90b8d0fbc0 test(e2e): ? 帮助浮层断言加固——焦点残留竞态三连治 
面板测试后焦点可能残留输入域致 ? 键被吞（今日第三次偶发）：
Esc 收场+activeElement blur+重试三连，3/3 稳定复现。

验证: E2E_BASE=dist 口连跑三轮 34/34 全绿

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:34:47 +08:00
wait4xandGLM-5.3 4e24fe510f chore(spec): verify 命令统一 E2E_BASE 本地 dist 口 
staging=origin/main 纪律下 spec 分支在途代码的 E2E 只能打本地
dist——T2 canonical 断言对 staging 必挂属预期非缺陷。

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:31:48 +08:00
wait4xandGLM-5.3 2bfe2ef3db feat(5f): 代码块窗条+书评纸卡（T5/T6 车道收编，视觉复核 PASS） 
- T5：≥4 行块挂 .code-win 窗条（JS 数行标类+伪元素渲染：语言
  标签取 shiki pre[data-language]+灰阶三点 #30363d 投影法一点化
  三点，弃红黄绿；条 #161b22 恒深区亮暗同判）；单行/2行裸块；
  csge 文 4/18 判定边界实测准确；scoped 够不着 Content 内 pre
  坑用 :global 解
- T6：书评正文圆角纸卡（亮 #f4f4f2/暗 #201d18 暖棕夜灯，零新
  变量吃 T7 已入 tokens；1px hairline 四边抑制长文竖线感；标题
  区外置结构未动）
- 视觉复核（glm-5.3-flash:max 像素级）：T5 四项全 PASS（三点实
  采样无红黄绿、条/点/体 github-dark 同族灰、与块顶圆角对齐）；
  T6 双态 PASS；暗态窗条未入截图框为残留观察项（恒定 CSS 推定
  成立，判词 /tmp/beauty-impl/verdict.md）
- tasks.md T5 verify 落点修正（src/pages/archives，车道如实报
  告）；E2E ? 浮层偶发竞态 2/2 复跑绿

车道：op-artalk（自验 5/5+2/2）；收编验收：窗条 4/18+data-lang+
纸卡双态 computed+视觉双卡 PASS

验证: E2E 34/34 PASS（E2E_BASE=dist 口）；窗条/纸卡 computed 与
      像素采样全对

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:31:22 +08:00
wait4xandGLM-5.3 814b138f89 test(e2e): E2E_BASE 环境变量覆写——本地 dist 口验未推代码 
staging=origin/main 纪律下，spec 分支在途代码的 E2E 只能打本地
dist；此前 BASE 硬编码迫使车道手工绕（T2 收编验收实锤）。

验证: E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 34/34
      PASS（含新 canonical 断言）

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:13:44 +08:00
wait4xandGLM-5.3 c307285a25 fix(i18n): localePath 三处双 en 一刀治+canonical 全量（blog-5f T2/T3 车道收编） 
- T2：localePath 先归一 zh 再拼前缀（Header/CommandPalette/
  BaseLayout 三处 /en/en/ 同源病根一刀），返回值统一尾斜杠；
  BaseLayout 自指 canonical 全量 35 页；E2E 新增 en canonical
  自指断言（33→34）
- T3：content-lint.mjs 零依赖三检（断链 FAIL/缺图 FAIL/zh-en
  配对 WARN；CONTENT_LINT 逃生门；photos-originals 叠加层与
  /admin 单语两误报已修）；prod-smoke.sh 三断言（robots 未落明
  确 FAIL 不静默）；build.sh 守卫行挂载（smoke 对 staging 首版
  容忍，T1 robots 上线后转硬门，触发条件注释在案）
- tasks.md verify 字面量 33→34 联动同步（6 处）

车道：op-gitea（verify 六条实录）；收编验收：E2E 34/34+产物零
/en/en/+lint 0/0/0 实跑复现

验证: node tests/e2e.mjs 34/34 PASS；! grep -r /en/en/ dist/；
      content-lint 三检 0 违例；bash -n+test -x 过

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:12:01 +08:00
wait4xandGLM-5.3 8ec1712135 feat(5f): reader 模式+版式基底+首屏 tagline+图库质感（T4/T7/T8） 
- T4 reader：html.reader 单 class（去装饰非去内容：隐辉光/图标
  钮/pv 行，ICP 合规底线永留；正文字号+1px 行宽 56ch；入场动效
  关）；命令面板 reader 命令+r 键+localStorage；ThemeScript 预绘
  防闪
- T7 基底：--flow-* 五流距变量双轨应用；暗色 hairline 降档；
  页面标题 700→600（裁定 #6 减字重不减号）；focus-visible ring
  统一；列表行距 +2px；--paper/--radius-img/--ease-out 入库
- T8：首页 IdCard slot 落 tagline「写作者 · 读者 · 快门按压者，
  拥抱开源。」；图库暗色 4% 轻衬底+圆角统一（裁定 #4 双模式分判）

验证: E2E 33/33；reader r 键触发+辉光 none+刷新保持实测；流距
      computed 0.6em 实算；tagline 渲染实测

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:09:27 +08:00
wait4xandGLM-5.3 22930cfffd feat(seo): robots.txt 与 SEO 解封操作单（blog-5f T1） 
robots 404 补齐（Allow 全站/Disallow admin+draft/Sitemap 行）；
操作单三步走：nginx snippet 剥 noindex+内部 vhost 补回+admin 局部
保留、ESA purge+TTL+绕缓存、curl 三验证——用户侧执行入口。

验证: T1 verify 命令全过（robots 三断言+操作单节存在）

Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:06:54 +08:00
wait4xandGLM-5.3 5d18591967 chore(spec): blog-5f 任务清单格式修正 
Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:06:02 +08:00
wait4xandGLM-5.3 c1e3d30954 chore(spec): 立项 blog-5f——SEO 解封+功能优化批+美化首批 
Spec: 2026-10-26_blog-5f

Co-authored-by: GLM-5.3
 2026-11-01 09:05:26 +08:00
wait4xandGLM-5.3 975cf5e58b docs(research): 美化方案并入视觉裁定（§6 七问定案） 
两案之争全部落定：首屏=融合（加 tagline 不 banner 化）；纸面板=
选圆角纸卡（书评轨）；代码块=多行窗条+灰阶三点；图库=亮直贴/
暗轻衬底；热力图=亮灰维持暗色补救（绿系亮色不换）；标题 27px
维持（要轻减字重不减号）；灰阶 5 档够用（hairline 更淡+行距微
增）。视觉轨 glm-5.3-flash:max，25 张证据图亮暗双态逐问裁定。

验证: 裁定含信心等级+落地注意+双模式分判；与 §5 问题清单一一
      对应

Spec: none (方案定案文档，待用户审批实施)

Co-authored-by: GLM-5.3
 2026-10-26 23:07:56 +08:00
wait4xandGLM-5.3 7c5455278b docs(research): 美化专项方案（文本轨，K-S 卡片，视觉待验标注） 
现状审计 16 项（间距阶/灰阶档/圆角混用/流距/focus ring/代码块/
纸面板/热力图灰绿之争）× 5 站补充探索（rauno 12 级灰+paco alpha
阶梯+mattdesl 等宽层级+tw93 手写体温+antfu blur-up）× 卡片 K-S
（token 值级改法+computed-style 断言）× 截图问题清单 7 问（交
glm-5.3-flash:max 视觉轨复核中，verdict 合并后定案）。

验证: 截图床 /tmp/beauty-shots 25 张就位；文档 149 行入仓

Spec: none (方案文档文本轨，视觉裁定合并后呈审)

Co-authored-by: GLM-5.3
 2026-10-26 22:55:05 +08:00
wait4xandGLM-5.3 6b35356e91 docs(research): 博客优化方案 v2（深度版，scout max 推理车道） 
六站补面（rauno/diygod/xeiaso/shud.in/vincentwill/sabrina）+
自查实证（生产 SEO 60-63 根因=noindex 封印+robots 404+ESA 30 天
头缓存；localePath 双 en；Artalk 评论数 API 实测；reader 落点
清单）+ 实施卡片 A-J（文件级落点+断言验收+工作量）+ 三批排期 +
明确不做清单。

验证: 关键断言独立复核（nginx snippet noindex 行/robots 404 生产
      curl 实测一致）

Spec: none (方案文档，待用户批 A/B/C/E 立即批后立项)

Co-authored-by: GLM-5.3
 2026-10-26 20:29:05 +08:00
wait4xandGLM-5.3 a9da765cb1 docs(research): 六站博客体验研究与优化方案（scout 车道） 
qh1009/nbfox/yongyuan/阮一峰/antfu/innei 六站直连抓取分析：
共性 12 项（阅读时长/双语互链/纯文本模式/评论数前置/周刊化/
EXIF 元数据卡/归档全量/偏好面板等）+ 差异化护城河 6 项 +
Sveltia vs 主流后台差距与补齐方案 + P0-P2 分级建议表。

验证: 文档 125 行入仓可读；来源快照 /tmp/uxstudy/（会话级）

Spec: none (调研文档，方案待用户审阅后立项)

Co-authored-by: GLM-5.3
 2026-10-26 20:05:00 +08:00
wait4xandGLM-5.3 3941a34f04 feat(pwa): SW 预缓存自动生成 + Sveltia 瞬间管理（池 4/5） 
- gen-sw-precache.mjs post-build：按 dist 产物推导路由重写 dist/sw.js
  预缓存段（AUTO 标记锚定；规则=顶层+/en/ 轨深度≤1、/admin 永不入
  列）——新增顶层页自动进离线包，根治手工清单漏页维护债；实测 19
  路由含 moments 双轨、admin 排除
- build.sh 守卫挂钩（守卫先行纪律）；sw.js 源内兜底清单保留
- Sveltia 加 moments 集合：随手发瞬间（text/image 可选+hint 自查条
  件必填、pubDate 日期件、tags、slug 日期模板）——管理后台从只管
  照片扩到内容面第一步

验证: 产物 sw 19 路由断言全过；E2E 33/33 PASS；yaml 解析过；bash -n 过

Spec: none (离线包自动化+后台扩容，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-26 20:02:32 +08:00
wait4xandGLM-5.3 3a59edc79a feat(nav): 书架进导航（车道 G）——图标钮出舱钉死右侧 
- 评估实数：第 6 项增量 zh +34-44/en +49-51px，旧结构 en 达
  102-125px 滚区且主题钮出首屏——收纳策略=搜索/语言/主题三钮
  移出 nav 滚动区钉死 .nav-actions 常驻右侧，内滚只波及文本项，
  任何宽度三功能钮可见（搜索是移动端主发现路径不可藏）
- nav 序：开源 · 文章 · 书架 · 图库 · 瞬间 · 关于（书架=阅读轨
  延伸紧跟文章）；ui.ts +nav_books/kbd_gs_books
- Keyboard g-chord 增 s 键（g s→书架，双轨前缀路由），帮助表
  按既有 kbd_* 词条模式接入
- E2E en 导航断言扩为 ≥6 且含 /en/books/
- 已知余量：en 390-430 文本区滚 ~114px（词条已最短化，再省需砍
  语义留观）；zh 全宽段 1-16px 基本无感

车道：op-gitea（八格扫描+E2E 33/33）；收编验收：序/双轨 href/
三宽度三功能钮可见性/g s 实跳全过

验证: pnpm astro build exit 0；本地 dist 六项 playwright 全过；
      E2E 33/33（推送后 staging 复验）

Spec: none (导航扩容+出舱策略，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 22:47:17 +08:00
wait4xandGLM-5.3 73c31ffb2a feat(pwa): 瞬间页安装引导与启动快捷方式（车道 H） 
- manifest shortcuts：瞬间直达（/moments/ + 复用 192 图标；lang
  zh 单份中文）
- 安装 CTA：时间线后灰阶虚线小条+ghost 按钮；beforeinstallprompt
  模块级立即绑定（跨软导航存活），三态=可装显示/已装
  （display-mode:standalone 或 iOS standalone）永不显/不支持默认
  hidden；prompt 后 accepted/appinstalled 清引用；文案组件内
  locale 双份
- SW 复核零改动：PRECACHE 已含双轨瞬间、IMMUTABLE 覆盖
  /_astro/ 瞬间图片管线、NEVER_CACHE 拦 pv 走 '–' 降级——三处
  现成正确；离线实证：断网瞬间页 200+时间线完整+pv 降级；图片
  0/0 为数据现状（3 条瞬间均无图），同管线文章页图片离线 1/1
  等价实证成立

车道：op-artalk（自验 11/11）；收编验收：CTA hidden 态+离线 200+
标题+manifest shortcuts 解析实测（首轮探针 context API 误用致假
FAIL，selector 复核全过）

验证: pnpm astro build exit 0；E2E 33/33；断网瞬间页 playwright
      实测 200

Spec: none (PWA 增强：shortcuts+CTA+离线实证，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 22:45:18 +08:00
wait4xandGLM-5.3 215760c38a style(nav): en 开源词条 Open Source→Projects——窄屏免内滚 
390-430px 尾部主题钮原本需导航内滚一滑才可见；短词省 35px，
三宽度全直显（用户拍板）。页面标题与热力图词条不动，仅导航。

验证: en@390/410/430 主题钮右缘全在屏内+页面零溢出实测；E2E
      33/33 PASS

Spec: none (单词条更名，宽度收益实测)

Co-authored-by: GLM-5.3
 2026-10-25 22:32:02 +08:00
wait4xandGLM-5.3 55cfc73cb7 feat(interact): 访问量小字+瞬间时间线动效（车道 F） 
- pv：ArtalkComments/MomentsPage 组件级独立 POST /artalk/api/v2/
  pages/pv（页面加载即计，不等懒加载；POST 天然绕 ESA 边缘缓存）；
  init 加 pvAdd:false 防双计（默认 true 此前评论加载一直在默默计
  数——mian-sha pv=2 即此来源）；双轨 pageKey 分开计数
- 瞬间动效：.tl-item IntersectionObserver 进入视口一次性渐显
  （opacity 0+8px）；降级链=data-mom-anim 前置标记——无 JS/
  reduced-motion/无 IO 三情形标记缺席则初始隐藏不生效；软导航
  astro:page-load 重注册
- Artalk 后台真根因修复（车道侧宿主件，非仓内）：容器日志实锤
  登录从未成功过（12+ 次 401/400，非会话丢失）——CLI 重置密码+
  凭据入 INITIAL-CREDENTIALS.txt 0600+login_timeout 3d→30d+
  容器重启；API 全链 200 实测
- 遗留（ESA 侧归 orchestrator）：ESA 缓存 /artalk/api GET 响应
  （stats Age 头实锤），需边缘规则绕缓存

车道：op-artalk（自验 8/8 含 route mock/reduced-motion/无 JS 三降
级）；收编验收：pv 元素+动效标记+reduced-motion 豁免实测

验证: pnpm astro build exit 0；E2E 33/33；三降级链 playwright 实测

Spec: none (pv+动效，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 22:19:41 +08:00
wait4xandGLM-5.3 d00ca7e447 fix(i18n): 语言轨导航修复+重排，热力图切 GitHub（车道 E） 
- 真 bug（用户实测：切 en 后点板块回中文）：Header nav href 硬编码
  zh 路径，curLocale 只喂了词条——localeOf(Astro.url) 构建期自推断
  +五项+品牌链接全轨化（brand 原指 / 同病同修），aria 同步
- 导航重排（用户拍板）：开源 · 文章 · 图库 · 瞬间 · 关于；瞬间
  新进导航；移动 320-430×双轨八格页面级溢出全 0（内滚阈值 350→450
  +中段地板再收；en 390-430 尾部约 55px 靠内滚——'Open Source'→
  'Projects' 改名可省 35px，留用户拍板）
- 热力图纯切 GitHub（用户拍板）：GraphQL contributionsCollection
  53 周窗口（上海日界）；token=宿主 0600 github-token.txt，缺位→
  WARN 降级样例数据（当前站点即样例）；三级回落 token→样例→空网格
- E2E 新增 2 断言：en 页 nav 全 /en/ 前缀+brand 指 /en/（本 bug
  的回归测试）

车道：op-gitea（自验 33/33）；收编验收：en/zh 序实测+三宽度溢出 0+
E2E 33/33（本地 dist 口径——staging 未含未推代码为既定纪律）

验证: pnpm astro build 34 页 exit 0；node tests/e2e.mjs 33/33；
      en/zh 导航序与 href 前缀 playwright 实测

Spec: none (Header 修复+重排+热力图换源，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 22:19:40 +08:00
wait4xandGLM-5.3 363cc616f7 feat(motion): 动效层三件——背景辉光/入场/心跳，页脚撤双入口 
- 背景鼠标辉光：ink 色 4% 径向渐变跟随（pointer:fine×非
  reduced-motion 才有 JS，raf 节流 document 级监听 VT 存活）——
  丙灰阶语言的"活背景"，触屏/减动效自动隐藏
- 正文入场 rise-in 12px/0.4s（VT 换页自然重放）+ 列表行悬停
  1px 微浮；全量 prefers-reduced-motion 豁免
- 首页"最近心跳"：构建期拉 blog 仓最新 commit（gitea API 8s 超时
  静默降级），脉冲点+相对时长——本站自己的脉搏
- 页脚撤「装备/制作」入口（页面保留，用户决策：只删入口）
- E2E 加固：g-chords 修好后 location.href 与 goto 竞态（en 页弦
  导航迟到提交打断 goto）——中断重试模式
- 过程教训：str.replace 静默无操作再犯（锚点瞄错组件文件）——
  脚本未进产物却报"全落地"，replace 必须 assert 配对 grep 产物

验证: --mx 鼠标双跳 15.6% 实测跟随；E2E 31/31 PASS（竞态重试后
      确定性）；构建 34 页 exit 0

Spec: none (动效层+页脚撤口+测试加固，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 22:09:41 +08:00
wait4xandGLM-5.3 0b6524f53c perf(home): 首屏 eager+关键 CSS 内联，Lighthouse 伪影根因修毕 
- 车道 D 三件收编（op-gitea）：①index.astro 首两图 eager+首图
  fetchpriority=high（Image 默认 lazy 曾压 LCP 至 6.4s，好模式现
  1.3s）②inline-home-css.mjs：BaseLayout 11KB 内联首页 head（省
  发现+下载跳）③build.sh 守卫挂钩
- 诊断结论入档：home 中位漂移根因=测试床伪影（python server 不压
  缩，裸传 67KB vs 生产 gzip 9.2KB；lantern 对未压缩 HTML 流式归因
  双峰 99↔165ms 翻转出两个世界）——gzip 等价口径中位 100
  （FCP 0.9-1.1s/LCP 1.3-1.4s/TBT 0/CLS 0）
- 测试床转正：gz-server.py 泛化入仓（ThreadingHTTPServer+gzip
  [端口 目录] 参数化）——兼治 SW 预缓存风暴竞速（单线程 server
  曾把 E2E /gallery/ networkidle 饿死，实锤于收编验收）
- E2E serviceWorkers:'block'：SW 有专属测试，站点 E2E 求确定性
- 三连否定留档：SW✗/css链✗/子集内联 v3✗（6×63 反例钉死，已
  回滚）——残尾 20% 离群属 lantern trace 抖动，采中位+多轮

车道：op-gitea（过程三连否定+测试床移交）；收编验收：内联 10KB
实出+首图 eager 实证+E2E 31/31（SW 屏蔽后确定性复现）

验证: gz 测试床 18743 gzip 10KB（生产等价口径）；node tests/e2e.mjs
      31/31 PASS；构建+守卫链复跑

Spec: none (性能三件+测试床转正，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 21:37:38 +08:00
wait4xandGLM-5.3 71b8985c17 fix(keyboard): g g chord 不可达——路由判断先于武装分支 
Phase 1 潜伏缺陷：g 键分支先于路由检查 return，第二击 g 永远
重新武装，routes['g']（gallery）全站不可达。修序即愈，g→g 自身
是合法 chord。en 轨随上一提交前缀化后同步受益。

验证: chord 矩阵 5 检（zh/en × g g/g h/g m 实跳目标全中）；
      E2E 31/31 PASS

Spec: none (keydown 分支修序，矩阵测试入档)

Co-authored-by: GLM-5.3
 2026-10-25 21:18:58 +08:00
wait4xandGLM-5.3 3e73fe957e fix(i18n): g-chords 导航目标随轨前缀化——en 页 g h 跳 /en/ 
C 车道已知边界补刀：routes 表构建期按 locale 前缀化，en 页
g-chords 不再跳中文轨。

验证: playwright 双轨 g-chords 实跳（en g h→/en/、zh g g→
/gallery/）；E2E 31/31 PASS

Spec: none (五路由前缀化一行模式，C 车道边界补刀)

Co-authored-by: GLM-5.3
 2026-10-25 21:14:56 +08:00
wait4xandGLM-5.3 810cf44d3d fix(deploy): receiver 改调构建仓自己的 build.sh——发布链执行源归一 
- 架构债（20:31 事故根因层）：receiver 此前执行工作树
  infra/deploy/build.sh，车道在途半成品状态可断生产链——改为
  build-repo/infra/deploy/build.sh（origin/main 硬跟版本），
  构建仓缺失时首克引导（匿名 clone）
- 双副本纪律入档头注：仓内源与 ~/docker_apps/blog/ 运行副本改一
  须同步二并 restart（systemd 跑的是运行副本，漂移即事故）
- 深意：构建脚本演化自此走 git 评审流，main=可部署铁律闭环

验证: 签名 POST 端到端实测（HMAC 构造无 git 污染）：202 queued →
      90s 后 stamp=1fdd0cc；healthz 200；单元 active

Spec: none (发布链架构修正：单执行源切换+端到端实测)

Co-authored-by: GLM-5.3
 2026-10-25 21:12:48 +08:00
wait4xandGLM-5.3 0c569b0b31 feat(i18n): Keyboard 帮助表全量双语——构建期 localeOf 自推断 
- 10 词条+标题+hint 全走 t(key, locale)（ui.ts 新增 kbd_* 11 键，
  零文案字面量复制）；en/terminal 车道的运行时 replaceChildren
  补丁退役（构建期已渲染正确文案）
- hint 行精简：删过程性标注"Phase 4 上线 ~"（~ 并非实际绑定，
  有误导），改 /terminal 彩蛋引导语
- 已知边界另车道：g-chords 路由表仍 zh 路径（en 页 g h 跳 / 而非
  /en/）——routes 表 locale 化待办

车道：op-artalk（自验 7/7：zh/en 深层路由自感知/inField 旁路
（?正常入框不弹层）/blur 回归）；收编验收 dialog 作用域复验全过
（首验 2 FAIL 均系验收方断言姿势：大小写+全 body 作用域，非车道
缺陷——验收先探实值再断言的教训第三次入档）

验证: pnpm astro build 34 页 exit 0；E2E 31/31 PASS；en 深层路由
      /en/terminal/ 帮助表纯英文实测

Spec: none (组件双语化，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 21:12:48 +08:00
wait4xandGLM-5.3 1fdd0cc162 perf(build): 按页字体 CSS 子集化 + gallery 响应式图片阶梯 
- subset-font-css.mjs post-build：扫每页文本（含 attr）+ ui.ts 全
  词条 + Latin/标点永保三防线，命中 unicode-range 才留 @font-face，
  子集按内容哈希去重共享，孤儿原 CSS 清出——全站字体 CSS 6.7→2.6MB
  （61%），mian-sha 声明 101→48/家族
- build.sh 挂载（存在性守卫：车道在途文件不断发布链——20:31 事故
  纪律）
- GalleryPage srcset 阶梯 320/560/720→480/800/1200（首图
  fetchpriority 维持）
- Lighthouse：mian-sha 61→78、gallery 74→79、en 70→83、terminal
  74→88（A11y/BP/SEO 持平；unused-css 370→36KB）
- 过程坑：v1 重写 href 丢前导斜杠致嵌套页 404——v2 只换文件名

车道：op-gitea（A/B 渲染等价证明：serif 916 字 0-miss；分数复采
入 /tmp/e2e-shots/lighthouse-ap/）；收编验收：serif 字形
fonts.check 实测 true、srcset 产出、E2E 31/31

验证: pnpm astro build + subset 跑通 35 页；E2E 31/31 PASS；
      staging 部署后 stamp 复核

Spec: none (构建管线性能二连：post-build 子集化+图片阶梯)

Co-authored-by: GLM-5.3
 2026-10-25 21:05:15 +08:00
wait4xandGLM-5.3 aa050d8035 feat(pages): /stack 装备页 + /colophon 制作页（双语）与页脚入口 
- colophon：五节灰阶数据表讲"这站怎么造的"（build/visual/写作流
  /i18n/features，变字体提速等实数入表）
- stack：homelab/自托管/站点依赖/日常四节（版本号实读
  package.json；硬件细节与 daily 清单 TODO(下轮) 待补）
- Footer 顺手修真缺陷：locale prop 机制存在但从未透传，en 全站
  页脚实为 zh 文案——改 Astro.url.pathname 构建期自推断（localeOf
  复用，显式 prop 优先），零 BaseLayout 改动
- 页脚「装备 · 制作」双入口（en 轨自动 /en/ 前缀）

车道：op-artalk（自验 15/15：双页双语桌面+390 溢出断言+Footer
双轨感知）；收编验收 6 检全过

验证: pnpm astro build 34 页 exit 0；双页双语 390 视口无溢出；E2E
      31/31 PASS

Spec: none (两静态页+Footer 修复，车道级交付)

Co-authored-by: GLM-5.3
 2026-10-25 20:51:02 +08:00
wait4xandGLM-5.3 a347ce8baf feat(pwa): 全站 PWA 化——manifest+Service Worker+图标三件 
- manifest.webmanifest：standalone 双语描述、192/512/maskable 图标
  （favicon.svg 经 sharp 直出）
- sw.js 保守策略：HTML network-first（不比 ESA 边缘更激进，防双重
  陈旧）+ install 预缓存 16 核心路由（SSG 全站 <1MB，全站离线可读）
  + /_astro|fonts|photos 不可变 cache-first + 评论 API/CMS 绕行
- BaseLayout：manifest+双 scheme theme-color+apple-touch-icon+一次性
  SW 注册（controller 守卫×VT 不重跑双保险）
- 踩坑入档：python 单线程 http.server 拖慢 16 并发预缓存，验收须等
  缓存键数稳定（曾误判 install 未跑）；allSettled 静默是调试黑洞，
  install 失败必须探针可见

验证: 离线导航 6 页全 200（预缓存 16 条 500ms 就绪）；node
      tests/e2e.mjs 31/31 PASS；manifest/sw/图标三路由 200

Spec: none (PWA 基建：manifest+SW+图标，离线矩阵入档)

Co-authored-by: GLM-5.3
 2026-10-25 20:49:16 +08:00
wait4xandGLM-5.3 8fe9455c23 perf(fonts): 思源黑/宋切换变字体——CSS 345→106KB 全站提速 
- @fontsource-variable/{noto-sans,noto-serif}-sc 替换静态三档：
  wght 轴单文件覆盖 400-700（font-face 303→101/family）
- tokens 字体栈前插 Variable 族名（旧静态名留兜底链）
- 全站 Lighthouse：home 64→70 / en 73→82 / terminal 79→84 /
  gallery 68→74，FCP 4-6s→2-3.5s（主线程解析减半）
- 已知取舍：mian-sha 字节反增（变体切片 2-4x，55 片 3.4MB）但
  FCP 关键路径不受影响（swap）；按页字体 CSS 子集化立为后续包
- E2E 加固：软导航主题切换断言加 VT 竞态重试（今日第二次偶发，
  隔离 3/3 过=测试姿势问题非产品缺陷）

验证: node tests/e2e.mjs 31/31 PASS；本地 dist Lighthouse 五页型
      对比（lh-var vs lh-local 两轮全量审计）

Spec: none (性能二轮：字体管线单点换包，Lighthouse 前后对照已入档)

Co-authored-by: GLM-5.3
 2026-10-25 20:31:54 +08:00
wait4xandGLM-5.3 b18d019a2e feat(terminal): /en/terminal 双语薄壳——命令行为零分叉 
- terminal.astro 抽 locale prop：frontmatter 静态文案 + script 层
  zh/en 双 DICT（命令描述/ls 路由表/whoami/exit 目标），双轨共享
  一份 chunk；路径守卫 Set{/terminal,/en/terminal}
- en/terminal.astro 四行薄壳 <TerminalPage locale="en" />
- Keyboard 帮助表 terminal 词条按 /en/ 前缀改写（其余表格文案
  双语化留给独立车道，注释已标）

车道：op-artalk（自验 15/15）；收编验收 build+双轨 playwright 过——
首验 FAIL 系验收方误用 textContent 吞了内联脚本中文注释，innerText
复核零中文，非车道缺陷

验证: pnpm astro build 30 页 exit 0（双产物）；双轨 playwright 验收
      （en 可见文案零中文/ls en 路由表/zh 回归/Keyboard 词条）全过

Spec: none (页型双语薄壳，车道级小活)

Co-authored-by: GLM-5.3
 2026-10-25 20:24:13 +08:00
wait4xandGLM-5.3 f57b1bde5f feat(admin): Sveltia 管理台正式收编——页脚入口与使用指南 
- Footer「管理」入口（data-astro-reload 绕 ClientRouter，官方集成守则）
- docs/管理台.md：Token 登录/上传流/纪律（title 必填、内建优化禁用的
  why、删除连带实测行为）/已知限制——试水期结论"值得留"转正

验证: pnpm astro build exit 0；dist 页脚含 /admin/ 入口

Spec: none (收编小特性：入口+文档，单提交意图)

Co-authored-by: GLM-5.3
 2026-10-25 20:16:40 +08:00
wait4xandGLM-5.3 e57c853f20 fix(theme): 软导航主题回退——ThemeScript 补 data-astro-rerun 
- 病根：ClientRouter 软导航换 html 属性把 data-theme 抹回无主题态，
  而内联脚本默认仅首次执行（Astro 规矩：重跑须显式 data-astro-rerun）
  ——切换明暗后一切栏目即回系统默认（用户实测报告）
- 写入端审计：Header/Keyboard t/命令面板/终端四入口均写同一
  localStorage key，无第二套实现，病灶唯一
- E2E 补软导航持久断言（原仅测 reload，漏了真实 bug 场景）

验证: node tests/e2e.mjs 31/31 PASS（软导航后=dark 断言新增）

Spec: none (线上热修：单属性缺陷 + 回归断言)

Co-authored-by: GLM-5.3
 2026-10-25 20:15:06 +08:00
wait4x a10141dfd8 Merge branch 'spec/2026-10-25_add-blog-5c' (archive close) 
Spec: 2026-10-25_add-blog-5c
 2026-10-25 20:02:12 +08:00
wait4xandGLM-5.3 bcfd0c35bf chore(spec): 归档 add-blog-5c——五任务收敛（spec.md 补全后） 
Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 20:02:11 +08:00
wait4x 48a2383efa Merge branch 'spec/2026-10-25_add-blog-5c' (archive close) 
Spec: 2026-10-25_add-blog-5c
 2026-10-25 19:56:43 +08:00
wait4xandGLM-5.3 709b18eb45 chore(spec): 归档 add-blog-5c（5.1 模板占位修正后收敛） 
Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 19:56:43 +08:00
wait4x dd1a59bc21 Merge branch 'spec/2026-10-25_add-blog-5c' 
Phase 5c 交付：裸 clone 构建（Sveltia 自动上线）+ 移动端全站溢出修复（Header clamp 流式化）+ Lighthouse Perf 62→88 字体优化 + en/archives 补页。

Spec: 2026-10-25_add-blog-5c
 2026-10-25 19:52:36 +08:00
wait4xandGLM-5.3 ad731aea69 chore(spec): 归档 add-blog-5c——五任务收敛 
Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 19:52:36 +08:00
wait4xandGLM-5.3 93992cb515 refactor(header): 断点阶梯升级为 clamp 流式自适应（用户设计诉求） 
- 430/370 两档阶梯替换为 clamp() 连续收缩（字号/间距/图标钮随视口
  线性插值）——任意宽度合身，不再逐档打补丁
- <350px 超窄兜底：导航内滚（scrollbar 隐藏）代替页面晃动——页面级
  scrollWidth 恒等视口，任何机型不破版
- 设计哲学入档：布局层早已流式（auto-fill/容器查询），正文排版断点
  是可读性台阶（有意），Header 是最后的固定像素残留——本次归流

验证: 密集扫描 44 检 × 11 宽度档（320-768）全过；E2E 30/30 PASS

Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 19:49:53 +08:00
wait4xandGLM-5.3 2802278be6 fix(mobile): 移动端全站横向溢出修复——Header 三档断点与长词断行 
- B1（移动审计 blocker）：Header 7 项一行在 390px 溢出 51-88px（主题钮
  被推出屏、整页可晃——用户实测报告的"布局存在问题"实锤）→ 430px
  断点收紧（字号/边距/间隙/图标钮 32px）+ 370px 末档（en Open Source
  长词）
- M1：.prose-tech 补 overflow-wrap:break-word（裸长 URL 曾撑破 88px，
  只给了书评轨是漏）
- m1：ProjectWall 标题 i18n（en 页曾硬编码中文）+ locale prop
- m3：列表标题两行钳制（en 长标题截断丢信息）；m4：页脚/pn/书架
  触控目标 ≥24px
- 已知边界：320px 超窄屏 en 仍溢 23px（超出现实机型范围，记录不改）

验证: 移动溢出回归 390/360 × 12 页全过（scrollWidth 断言，曾全站
      51-118px）；E2E 30/30 PASS；技术文长 URL 页 +88→0

Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 19:46:06 +08:00
wait4xandGLM-5.3 147f00fe1c perf(fonts): 字体按轨瘦身与非阻塞加载——Perf 62→88（Lighthouse P0） 
- BaseLayout：8 个字体包 CSS 改 ?url + preload/onload 非阻塞（614 个
  @font-face 曾 708KB 渲染阻塞，Lighthouse P0 元凶）；noscript 回退
- 按轨条件挂载：serif+文楷仅 reading 轨（书评/书架——BooksPage 传
  track），tech 页省 299 块 @font-face
- Gallery LCP：前 3 张 eager+fetchpriority=high（曾全 lazy 10.3s）
- 对比度：PostList .track 与 .post-cat 提 --ink-2（A11y P1）
- favicon.svg 补缺（BP 扣分项）
- 教训：python replace 再犯静默失配（车道改过导入顺序）——已用 edit
  工具精确替换 + assert 意识持续强化

验证: 本地 dist lighthouse 首页 Perf 62→88，render-blocking 无；
      FCP 2.5s/LCP 3.2s；E2E 30/30 PASS（staging）

Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 19:32:53 +08:00