wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
199 Commits 4 Branches 0 Tags
18ea5b17b8eb993c310443b226d179557ff3c6d8
Commit Graph
92 Commits
Author SHA1 Message Date
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 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 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
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
wait4xandGLM-5.3 f8add5ad15 feat(deploy): 裸 clone 构建改造与 en/archives 补页（T1/T4） 
- build.sh：构建源改 ~/docker_apps/blog/build-repo（fetch+reset 硬跟
  origin/main，匿名 fetch）——线上=远端 main 确定性闭环，Sveltia 保存
  即自动上线生效；stamp 记录构建 commit；node_modules 留仓内做增量
  （loader 逻辑变更时须清 node_modules/.astro——EXIF 教训已注）
- en/archives/index.astro 补缺（此前 404）：PostList locale 复用 +
  译题映射；三级目录 import 深度坑再犯一次（已修）

验证: bash infra/deploy/build.sh → staging 29 html @0e792a7（裸 clone
      实测）；build 本地 28+1 页；E2E 30/30 PASS

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

Co-authored-by: GLM-5.3
 2026-10-25 19:23:40 +08:00
wait4xandGLM-5.3 cef648db9a fix(exif): 构建 EXIF 提取全线复活——拦截式 loader + 数据仓清障 
- 根因双层：①包装层 post-load 的 store.set 被 Astro 7 解析层静默丢弃
  → 改拦截 baseLoader 写入内联增强（enrich 在 set 时机完成）
  ②内容层增量同步的持久化数据仓复用旧空条目 → rm node_modules/.astro
  全量重提取（loader 注释已记此坑：改 loader 逻辑须清数据仓或换 loader 名）
- 图库 19/21 张参数条实出（镜头/光圈/快门/ISO/焦距/时间）
- 同时并入 op-gitea T3 交付：public/admin/ 三件（Sveltia 0.252 pinned
  自托管）+ gitea [cors] 台账；其发现的 title omit 坑已在 config 修正

验证: build 28 页；dist/gallery data-exif 19 条含 ISO；E2E 30/30 PASS
      （staging 29 html）

Spec: 2026-10-25_add-terminal-books-admin

Co-authored-by: GLM-5.3
 2026-10-25 13:46:56 +08:00
wait4xandGLM-5.3 40346c3f21 fix(books): 泥潭策展语与回退契约实现；自托管仓星标语义 
- BooksPage 实现 schema 注释承诺的 description 回退（正文首段去记号
  取 60 字）——视觉复核抓到的"文档说了代码没做"缺口
- 泥潭补人工策展语（回退之上）；自托管仓星标改 self-hosted 徽标
  （gitea 无 star 真值，★0 语义突兀——视觉复核次要备注）

验证: build 28 页 exit 0；dist/books 含泥潭策展语；dist/opensource
      self-hosted 徽标与 ★57 并存实测

Spec: 2026-10-25_add-terminal-books-admin

Co-authored-by: GLM-5.3
 2026-10-25 13:46:56 +08:00
wait4xandGLM-5.3 90574edce7 feat(pages): /books 书架与 /opensource 开源页——导航第四项（T2/T5） 
- BooksPage：色脊排版卡（mood 竖脊+文楷书名+作者+三行截断策展语）
  × 年份分组规整网格；zh/en 双路由；阅读轨标题旁「书架 →」入口
- /opensource：全量仓墙（ProjectWall 加 limit prop，首页精选 6 不变）
  + 热力图 + 本站开源叙事段；导航第四项「开源」（i18n nav_opensource）
- 五书 frontmatter 策展字段（含泥潭=刘楚昕）

验证: build 28 页 exit 0；books/opensource zh/en 五路由产物断言过；
      五书卡与作者 grep 在案；E2E 30/30 PASS

Spec: 2026-10-25_add-terminal-books-admin

Co-authored-by: GLM-5.3
 2026-10-25 13:46:56 +08:00
wait4xandGLM-5.3 3bd8369eda feat(books): 五书策展字段与泥潭作者；顺带入 T1 终端页文件 
- schema 加 description/bookAuthor 可选；五书补字段（一句话策展评语
  + 原书作者；泥潭=刘楚昕 用户提供）
- 任务包入 T5 /opensource 独立页（用户追加需求，方案 A 复用扩展）
- 因 add -A 顺带包含 op-artalk 车道已自验 12/12 的 src/pages/terminal.astro
  （T1 交付物，验收随后）

验证: grep bookAuthor content/posts/*.md 五篇命中；schema 可选字段
      对既有构建零破坏

Spec: 2026-10-25_add-terminal-books-admin

Co-authored-by: GLM-5.3
 2026-10-25 13:46:56 +08:00
wait4xandGLM-5.3 76b6b6b022 fix(polish): 视觉终审两阻塞+两建议——胶囊真挂载与图注字面量化 
- 灯箱：.lb-act class+图标真实挂载（T1 的 python replace 对 i18n 化后
  文案静默失配成死代码——replace 无 assert 的教训）；清 560px 媒体
  查询内整段重复规则
- 样张图注：斜体行内裸 <video>/<audio> 字面量化（markdown 渲染成
  真元素：黑盒+吞文字）；指南加图注警示
- Artalk 建议项：输入框边界加深一档（--line 白底近不可见）；暗色
  发送按钮换深字（白字压浅底 2.4:1 低于 AA）

验证: build 23 页；样张页 video 元素 2→1（幽灵元素消失）；
      node tests/e2e.mjs 30/30 PASS；复验图 18/19 待视觉确认

Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 12:20:42 +08:00
wait4xandGLM-5.3 80ab3ee3f3 feat(atalk): 评论区美化——CSS 加载缺陷修复与 tokens 主题接管（T2） 
- 缺陷修复（op-gitea 车道发现）：Artalk JS 不自动注入样式，评论区自
  上线起一直跑 UA 默认样式——mount() 补挂 dist/Artalk.css，onload 后
  init（失败降级不阻塞评论可用）
- 主题接管：18 个 --at-color-* 变量全套映射站点 tokens（var() 引用，
  明暗随 [data-theme] 自动翻转）；init 锁 darkMode:false 防双暗叠加
- 气质层：8px 圆角/squircle 头像/时间戳与 UA 转 JetBrains Mono/
  正文链接 underline 纪律/弹层选择器 body 前缀提特异性

验证: build 23 页 exit 0；--at-color-main:var(--accent) 入产物；
      生产页注入同款 CSS 探针矩阵全中（亮 #3454d1/暗 #8ea2ff）；
      双态截图 /tmp/e2e-shots/at-polish-{light,dark}.png 待视觉终审

Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 12:08:10 +08:00
wait4xandGLM-5.3 a4388df35e fix(media): 详情页路径全量+prev/next 滤 hidden（op-artalk 车道指正） 
- getStaticPaths 恢复只滤 draft：hidden 样张需出静态页（可访问不列出）
- prev/next 从 hidden 过滤后的导航数组取位：真实文章上下篇不链样张

验证: build 23 页；media-sample zh/en 双页产物在；/media/ 绝对引用 ✓；
      首页与 RSS 零 media-sample 泄漏

Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:53:22 +08:00
wait4xandGLM-5.3 71a799bd97 feat(media): hidden 标签过滤与指南 public/media 约定（T5 补） 
- 首页/归档/RSS（zh+en）集合查询统一 draft+hidden 双过滤——样张
  永久保留为可访问不列出的活样例（回归测试资产）
- 写作指南视音频段更正：raw HTML 相对路径不走资产管线（实测），
  媒体放 public/media/{slug}/ 用绝对 /media/ 引用，与仓外 store
  同命名空间

验证: pnpm astro build exit 0（hidden 过滤后样张退出列表与 RSS）

Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:50:53 +08:00
wait4xandGLM-5.3 19ffcf180b feat(media): 灯箱动作胶囊化与正文三媒样式段（T1/T3） 
- 原图/下载：裸链 → 与 lbnav 同语言的胶囊按钮（图标+文字+暗底描边）
- global.css 媒体段：正文 img 圆角限宽、*斜体独立段*图注约定、
  video/audio 全宽样式（raw HTML 直书方案，指南随后）

验证: pnpm astro build 21 页 exit 0

Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:45:06 +08:00
wait4xandGLM-5.3 59b7baae51 chore(spec): 归档 fix-site-polish——四缺陷+双轨验证六任务收敛 
Spec: 2026-10-25_fix-site-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:30:40 +08:00
wait4xandGLM-5.3 86e8009f34 fix(polish): en 首页按 zh 全结构重写——PostList locale 化与版面平权 
- PostList 组件加 locale prop（轨道标签走字典、en 链接 /en/ 前缀）
- en/index 镜像 zh 结构：名片区三图标（GitHub/RSS/邮箱）+ 文章列表
  + 最新影像（latest-head space-between + 4 列瓷砖网格，修复上轮
  粘连与整宽竖排两处硬伤）+ 热力图 + 项目墙，区块顺序与 zh 一致
- 闭环截图：zh 滚动至热力图锚点（修复验证缺口）

验证: pnpm astro build 21 页 exit 0；node tests/e2e.mjs 30/30 PASS

Spec: 2026-10-25_fix-site-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:23:30 +08:00
wait4xandGLM-5.3 ebafa415b2 fix(polish): 视觉复核三轮——热力图末列可见与 en 首页版面平权 
- 热力图：桌面 10px 格+2px 缝收进版心（53 列 634px 无横滚——唯一有
  数据的最新列曾被裁在滚出区呈空表）；移动端锚定 scrollLeft 到最新列
- en 首页补 IdCard 名片区 + Latest photos 影像条（视觉复核版面平权建议）
- en/index 重复导入 getCollection 修复（构建炸点）

验证: pnpm astro build 21 页 exit 0；node tests/e2e.mjs 30/30 PASS
      （新构建全链）

Spec: 2026-10-25_fix-site-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:12:04 +08:00
wait4xandGLM-5.3 e21fac7e1d fix(polish): 视觉复核二轮六项——网格单一高度源/导航i18n/热力图缓存等 
- 图库：li 去 aspect-ratio（与行跨度双高度约束竞争=列洞根因面），
  img 改 object-fit cover 填满；截图前整页滚动触发懒加载
- Header：导航标签按 locale 取字典（en 页曾是中文）；图标钮暗色
  提色去底块（视觉复核 02/12 的灰块）
- 热力图：构建期模块级缓存，zh/en 两页共享一次抓取（en 页曾空格）
- en 首页移除机器翻译横幅（文章级标注才是本意）；面板居中；计数器
  文字投影
- Artalk E2E 报 fetch 失败定性为测试环境跨域（127.0.0.1 页面拉
  wait4x.online API），生产同源不受影响——上线后专项验证

验证: pnpm astro build 21 页 exit 0；node tests/e2e.mjs 30/30 PASS
      （新构建全链重跑，含滚动后 21/21 图库断言）

Spec: 2026-10-25_fix-site-polish

Co-authored-by: GLM-5.3
 2026-10-25 10:57:16 +08:00
wait4xandGLM-5.3 7a2880b65d fix(polish): 上线四缺陷修复——明暗委托/灯箱常开/评论站点名/书评宋体 
- 明暗切换：document 级委托（软导航换 DOM 后元素级监听全丢）；
  E2E 再抓一坑：SVGElement 非 HTMLElement 实例，守卫用 Element 基类
- 图库：#lb 无条件 display:flex 覆盖 UA 隐藏 → 灯箱"永远打开"盖全页；
  改 #lb:not([open]) 显式 none；时间戳标题清空；灯箱打磨（切换钮
  实底阴影/n/21 计数器/空标题隐藏/原图链接暗底亮蓝）
- 评论：site 'wait4x'→'wait4x.online' 对齐 Artalk 服务端（404 根因）
- 书评字体：文楷→思源宋（@fontsource 预分片）；文楷降级金句 --font-kai
- 数据：21 张照片组修正 street→landscape（迁移器收到内部组 id 的坑）
- 新增 tests/e2e.mjs：Playwright 30 项全功能 E2E

验证: node tests/e2e.mjs 30/30 PASS（含软导航后明暗切换回归项）

Spec: 2026-10-25_fix-site-polish

Co-authored-by: GLM-5.3
 2026-10-25 10:46:03 +08:00
wait4xandGLM-5.3 fb97d76ddb feat(launch): 命令面板+预发布验收+上线脚本（T1/T4/T5） 
- T1 (op-gitea 车道)：CommandPalette 三层（动作 theme/lang/rss+导航
  zh/en+Pagefind 搜索），Ctrl K 与 / 入口，document 级委托修 ClientRouter
  换页绑定失效；连带修复动态结果节点的 scoped CSS 失效潜伏 bug
- T4：preflight.sh 17 项全绿（产物/hreflang/双轨/微信 UA 200/
  responsive 11/halo 无恙/回滚前置）；headless 渲染经 c4ai 复核
  （en 书评页全文+标注+ICP 实测在案）
- T5：launch.sh/rollback.sh 双向 dry-run 绿 + 上线检查单（linger/
  ESA 刷新/验证 URL/回滚路径）

验证: build 21 页 exit 0；command-palette+cmd-item zh/en 断言；
      bash scripts/preflight.sh ALL OK；launch/rollback dry-run exit 0

Spec: 2026-10-25_add-blog-launch
Co-authored-by: GLM-5.3
 2026-10-25 09:52:50 +08:00
wait4xandGLM-5.3 938558ad4c feat(launch): 热力图与 webhook 发布闭环（T2/T3） 
- T2 (op-artalk 车道)：gitea heatmap 构建期拉取+fallback+空态三保险，
  53×7 灰阶格复用 tokens（亮暗自动），日界锚定 Asia/Shanghai，零 JS，
  zh/en 首页挂载；fallback 经死端点实测不破构建
- T3：webhook_receiver.py（HMAC 强制+main-only+构建锁）以 systemd
  --user 常驻 13021；gitea hook 注册（events=push, branch=main）
- 三个深坑：gitea 容器回宿主须走桥网关 IP 而非 127.0.0.1；gitea 28
  egress 拦私网须 ALLOWED_HOST_LIST（ALLOWLIST 是废弃名）；systemd
  用户服务缺用户 PATH 致 build 静默失败（stamp 不更新即症状）

验证: 测试投递 202→构建→staging 戳更新（09:48:37 实测）；
      dist 热力图 376 格真数据（9 次贡献）zh/en 双页

Spec: 2026-10-25_add-blog-launch
Co-authored-by: GLM-5.3
 2026-10-25 09:49:19 +08:00
wait4xandGLM-5.3 4aa79fca06 feat(i18n): UI 字典串接与三页薄化——/en/ 全站落成 
- op-gitea 车道：ui.ts 扩 26 键（占位 {n}/{title}/{exif} 约定），五组件
  locale prop 串接，zh 零回归（48 键/18 页实测）
- orchestrator 收尾：gallery/moments/about 三页 body 提取为
  components/pages/*Page（zh/en 薄页双路由），/en/ 全家福 21 页
- 提取工程三坑入库：HTML 注释不可进 frontmatter 模块区；搬移脚本会吃
  开栏 ---；单级页面搬二级目录后 import 全线差一层

验证: astro build 21 页 exit 0；/en/ 七类路由产物断言过；en 页
      ICP 备案保留；zh 侧文案抽查不变

Spec: 2026-10-25_add-blog-i18n
Co-authored-by: GLM-5.3
 2026-10-25 09:26:14 +08:00
wait4xandGLM-5.3 c74815b516 feat(i18n): /en/ 双语骨架——路由/切换/hreflang/回退/AI 标注 
- astro i18n（zh 默认无前缀，en /en/）+ locale.ts 路径工具
- Header 语言切换（同路径跨前缀跳转，预构建毫秒级）
- /en/index + /en/archives/{slug}（postsEn 优先，缺译回退 zh 正文
  + AiTranslatedBadge 虚线标注 TMT）；en RSS（标题回退同策略）
- BaseLayout hreflang 双向 + x-default 指向 zh 源
- posts-en 集合（postsSchema.extend locked 润色锁）
- 坑：ts 端点文件误带 --- 开头会以 undefined:2:7 报 Unexpected token

验证: astro build 18 页 exit 0；/en/ 六文章路由+首页+rss 产物断言过；
      zh 侧零回归（11 页不变）；hreflang 抽查 dist/index.html

Spec: 2026-10-25_add-blog-i18n
Co-authored-by: GLM-5.3
 2026-10-25 09:20:16 +08:00
wait4xandGLM-5.3 44bfb23efb feat(gallery): 原图查看与下载——仓外 originals store 双轨制 
- git 仓只进压缩版（构建用）；原图落 ~/docker_apps/blog/photos-originals/
  （迁移器/ingest 双入口写入，幂等），build.sh 独立 rsync 到
  staging/photos-originals/（同一静态根，零 nginx 改动）
- lightbox 增「原图」（新标签全尺寸）+「下载」（download 属性带文件名）
- 原图持久保障：store + Phase 0 备份 tar 双留档；存量 21 张已回填（196M）

验证: astro build 11 页 exit 0；dist/gallery 含 lb-original×2 与
      photos-originals 引用；staging/photos-originals 21 张实测

Spec: none (用户功能补req：原图查看/下载，跨 Phase 独立小特性)

Co-authored-by: GLM-5.3
 2026-10-25 09:12:26 +08:00
wait4xandGLM-5.3 4694428614 feat(search): 站内搜索/RSS/sitemap/Artalk 懒挂载 
- astro-pagefind：构建期索引；SearchDialog 首开懒加载 + 200ms 防抖，
  入口=Header 钮 + 键盘 /（P0 键位集补全）
- @astrojs/rss：posts 全量（draft 排除），双语分流留 Phase 3
- @astrojs/sitemap：sitemap-index 产出
- ArtalkComments：IntersectionObserver 进入视口才拉 Artalk.js，
  pageKey=/archives/{slug}/（中英共键，评论不分裂）

验证: pnpm astro build exit 0；dist/pagefind 目录 + rss.xml +
      sitemap-index.xml 三件断言过

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-25 00:13:29 +08:00
wait4xandGLM-5.3 945a9ee610 feat(pages): 五页型落地——首页/文章双模板/图库 masonry/瞬间/关于 
- 首页：名片+身份陈述空槽+按年分组分轨列表（情绪色/mono标签）+影像格+项目墙
- 文章 /archives/{slug}（与 Halo 旧 URL 1:1）：reading→衬线纸墨 / tech→
  TOC 侧栏(≥1120 sticky)+2px 进度条+Artalk 容器占位
- 图库：grid masonry（构建期 aspect-ratio 零 JS）+原生 dialog lightbox
  （←→/Esc+EXIF 底栏）+分组筛选
- 瞬间时间线 / 关于（三轨版图+构建说明）
- sharp ^0.35.5 入依赖（Astro 7 不内置，astro:assets 缩略图管线前提）
- 裸 blockquote 默认吃 A 墨线样式（markdown 原生输出无类名的缝隙）
- 车道 30min 超时，产物完整，主会话补 sharp+断言脚本递归修正后收编

验证: pnpm astro build exit 0（7 页）；五路由产物断言过；
      scripts/check-responsive.sh 11/11 ok（1120/820/760/560 全档）

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-25 00:11:34 +08:00
wait4xandGLM-5.3 80ff67e8fa feat(content): 三集合 schema 与 EXIF 构建期补全（T4 车道收编） 
- src/content.config.ts（Astro 7 唯一合法路径，旧 config.ts 会抛
  LegacyContentConfigError——车道实测发现，经批复的边界修正）
- posts（category→track 派生单源）/moments（text-image 互斥 refine）/
  photos（json sidecar + jpg，exif 构建期 exifr 补全、frontmatter 可覆盖）
- 样例：书评+技术文各 1、瞬间 3、照片 3（横竖方三比例，EXIF 三路径覆盖）
- 附带 scripts/check-responsive.sh（T9 预置，随 T6 产物生效）
- 车道 30min 超时于过度验证循环，产物完好，主会话收编续跑

验证: pnpm astro build exit 0（1.63s，含三集合加载）

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:36:59 +08:00
wait4xandGLM-5.3 725bfde21f feat(geek): 极客层 P0 四件套——键盘/构建透明/页面转场/项目墙 
- Keyboard：? 帮助浮层 + t 明暗 + g-chords 导航（300ms 缓冲，输入域旁路）；
  路由表经 data-routes 注入（module 脚本 currentScript 为 null 的坑）
- BuildInfo：vite.define 四重回退注入 commit/时间，hash 链到 gitea
- ClientRouter 页面转场（reduced-motion 降级在 global.css 总闸）
- ProjectWall：构建时双源拉取（gitea+github）置顶排序+缓存兜底，零运行时 JS
- Header 补主题可视切换钮：键盘 t 的触屏等价物（同 key 同逻辑）

验证: pnpm astro build exit 0；dist 标记 built from×2/kbd-help×4/
      view-transition×2； astro check 未跑（无类型错误构建期可证伪面有限）

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:13:23 +08:00
wait4xandGLM-5.3 b50eddf2bb feat(layout): 基础布局/导航/页脚/明暗不闪烁 
- BaseLayout：字体三轨统持、viewport-fit=cover、theme-color 双套、skip-link
- Header：≤4 项导航纪律 + sticky 毛玻璃 + aria-current；搜索 icon 占位待 T8
- Footer：ICP 备案链接（法定保留）+ built-from 具名槽位待 T7
- ThemeScript：head 内联先于首帧，手选 > 系统偏好，防白闪

验证: pnpm astro build exit 0；dist/index.html 含 ICP 文案与跳到正文链

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:09:45 +08:00
wait4xandGLM-5.3 ee53279822 feat(fonts): 字体三轨预分片自托管接入 
- lxgw-wenkai-screen-webfont + @fontsource/noto-sans-sc(400/500/700)
  + @fontsource/jetbrains-mono(400/700)，均 OFL
- unicode-range 按需加载 + font-display swap；家族名与 tokens 栈首一致
- 教训：包 css 不能经 .css 文件 ESM import，须组件 frontmatter 持有

验证: pnpm astro build exit 0；dist woff2 分片 399 个（>50 门槛）

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:08:36 +08:00
wait4xandGLM-5.3 4cb1c85cc3 feat(design): 设计 tokens 与全局样式——丙路线「灰阶骨架×分轨正文」 
- tokens.css：四档灰阶/单强调蓝/蓝黑暗色/纸墨面板/情绪色五档/
  字体三轨栈/排版三角(书评20-1.75-720 技术19-1.7)/唯一缓动曲线
- global.css：轻量reset/双轨正文(.prose-reading/.prose-tech)/
  引文A墨线+D金句62px水印/终端风代码块/::selection半透明/
  560px降档18px/动效总闸prefers-reduced-motion

验证: pnpm astro build exit 0；参数与调研报告 §3 一一对应

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:07:11 +08:00
wait4xandGLM-5.3 eeb9bde121 feat(skeleton): Astro 7.3.8 项目初始化（pnpm+TS strict） 
- astro 锁 7.3.8：7.4 起 engines 要求 node>=22.23.4，宿主 22.22.3 差一档
- minimal 骨架：单页占位 + site=https://wait4x.online，集成留 T8 按任务接入

验证: pnpm astro build exit 0（1 page built）

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:07:11 +08:00