wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
215 Commits 4 Branches 0 Tags
7149541a92c4495b13c82d6f1d8d684496e94024
Commit Graph
30 Commits
Author SHA1 Message Date
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 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 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 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 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
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 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 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 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 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 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 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 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 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 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 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 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 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 e185a292c8 feat(i18n): T6 真实翻译入仓与 Phase 3 收敛归档 
- op-artalk 车道：6/6 篇 TMT 翻译入 posts-en（frontmatter 字节级透传），
  幂等复跑 0 API；修复 TMT 1800+ 字符包静默截断（limit 1600 + ratio
  检测 + 二分降级，mock 三场景）
- 标题首字母抛光；T8 staging 21 页 + rollback 绿 + halo 无恙
- spec_verify --all 八项同指纹 exit=0；check 一次收敛；归档

验证: 21 页 build exit 0；/en/ 文章页真实英文内容渲染
      （Under the Veil… 抽检）；幂等 dry-run 6 skip 0 API

Spec: 2026-10-25_add-blog-i18n
Co-authored-by: GLM-5.3
 2026-10-25 09:40:59 +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 382e56431f fix(photos): 入库压缩保留 EXIF 并补未来上传的压缩缺口 
- 迁移器与新增 photos_ingest.py 压缩时显式 exif= 传参（PIL 重存默认
  剥离——此前 21 张已全部丢 EXIF，图库参数条构建期数据源被抽空）
- exif=None 会使 PIL JPEG 保存 len(None) 崩，改条件传参
- photos_ingest.py：幂等入库处理器（长边 2400/q86，>1.5M 才动），
  堵住 gitea/本地上传原图直入仓的缺口（196M 事故成因）
- 重跑迁移：19/21 带 EXIF（2 张原图本无），体积 9.7M

验证: pnpm astro build 11 页 exit 0；EXIF 保留计数 19/21

Spec: none (Phase 2 归档后的独立小修：EXIF 修复 + ingest 补缺)

Co-authored-by: GLM-5.3
 2026-10-25 09:01:07 +08:00
wait4xandGLM-5.3 aea21c8694 feat(migrate): Halo 全量内容迁移（压缩版）——6文/21图/1瞬间 URL 1:1 
- 正文源=线上渲染页（Halo 快照层 patch 残迹：泥潭/赎罪仅 2 字符），
  pandoc html→gfm + tags API 显示名换算后分类：5 书评（五档情绪色）+1 技术
- 图库 21 张：长边 2400/q86 压缩入仓（原图 196M→9.5M——公开仓历史膨胀
  与 nginx 100M 推送上限双杀；原图在 Phase 0 备份 tar 中永久留档）
- 瞬间 1 条；URL 1:1（6 slug 全等，零 301）
- 本提交由 7 个本地提交重写而成（清除已进历史的 196M blob，未推送过）；
  因 reset --soft 暂存竞态，一并包含 spec 归档文件
  （.spec/specs/archive/2026-10-24_migrate-blog-content/）

验证: check_urls.py 6==6；astro build 11 页 exit 0（8.67s）；
      EXIF 管线跑通；staging 更新；halo healthy+200 全程未动

Co-authored-by: GLM-5.3
 2026-10-25 00:39:08 +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