wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
97 Commits 4 Branches 0 Tags
3941a34f047600e1b50c27a7e3ec02655fcc4887
Commit Graph
15 Commits
Author SHA1 Message Date
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 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 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 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 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 c1085de1a0 fix(launch): 上线切换脚本 sudo 场景两处致命伤 
- 深度扫描从 server_name 行起算须以 depth=1 为初值（server{ 开栏在
  该行之前；0 起算在下一行即误判闭合，块切片只剩一行导致 location /
  永不匹配——Phase 0 artalk 插入带同款 bug 但恰好落在块顶部而无害）
- STAGING 写死 /home/wait4x 绝对路径（sudo 下 /home/wait4x=/root，计划行
  曾显示 /root/docker_apps/...）

验证: 只读模拟 start=94 end=128（真实闭合行），regex 命中，块内
      artalk/halo 双 location 齐全；用户首跑在断言处安全中止（写入
      前拦截），nginx 配置未受影响

Spec: none (上线脚本热修复，Phase 4 归档后用户执行面缺陷)

Co-authored-by: GLM-5.3
 2026-10-25 10:03:43 +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 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 7b71acf223 feat(deploy): build.sh 落地为真实构建管线（T10 补提交） 
- pnpm install --frozen-lockfile + astro build + rsync staging + 构建戳
- 归档提交时漏加的工作区文件，本提交补齐（内容即 T10 验收对象）

验证: bash infra/deploy/build.sh（7 html 产物 + staging 就位 + rollback 干跑绿）

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-25 00:17:04 +08:00
wait4xandGLM-5.3 f16b9487d3 feat(deploy): 发布链地基三件套——webhook 骨架/构建占位/回滚干跑 
- webhook-receive.sh：HMAC 骨架 + 仅 main 分支触发（干跑验证两条 ref 路径）
- build.sh：锁发布链形态与路径约定，astro 命令留 Phase 1 TODO
- rollback-dryrun.sh：回滚四前置条件验证 + 人为操作手册（秒级回 18090）
- staging 落用户区 ~/docker_apps/blog/www-staging（宿主 sudo 不可用，nginx 以 root 读用户目录无碍）

验证: webhook 干跑 main accepted / non-main ignored；rollback-dryrun
      四要素 ok（halo vhost/容器/响应/staging）

Co-authored-by: GLM-5.3
 2026-10-24 22:10:59 +08:00
wait4xandGLM-5.3 ddcda54f90 feat(gitea): 部署 gitea 28.2.0 并入库接入草稿 
- 容器 gitea/gitea:28.2.0 仅绑 127.0.0.1:13020，管理员 wait4x 经 CLI 创建，
  私有空仓 wait4x/blog 就位（Phase 1 博客源码仓）
- app.ini 种子入库（INSTALL_LOCK 预置，密钥首启生成，快照严禁回覆盖运行时）
- REQUIRE_SIGNIN_VIEW 会 403 匿名 version 端点，与验收冲突已撤，坑记 README
- 凭据不进 git：初始密码并入住主 init-credentials.txt（0600），README 留指引

验证: curl -sf http://127.0.0.1:13020/api/v1/version → {"version":"28.2.0"}；
      docker inspect gitea = running；wait4x/blog private+empty 经 API 查证

Co-authored-by: GLM-5.3
 2026-10-24 22:09:06 +08:00
wait4xandGLM-5.3 aea11469e3 feat(artalk): 部署 Artalk 2.10.0 评论服务并入库接入草稿 
- 容器 artalk/artalk-go:2.10.0 仅绑 127.0.0.1:13030，sqlite 落实例卷
- 子路径 /artalk 经 proxy_pass 尾斜杠剥前缀（官方无 base path 模式），
  nginx 草稿为 location 片段，合并主域 vhost 后需实测 sidebar 内页跳转
- 凭据不进 git：初始密码移实例目录 INITIAL-CREDENTIALS.txt（0600），
  仓库 README 仅留指引（本仓库将公开）

验证: curl -sf http://127.0.0.1:13030/api/v2/conf 返回 2.10.0 JSON；
      docker inspect artalk = running；管理员 wait4xx 经 sqlite 查证落库

Co-authored-by: GLM-5.3
 2026-10-24 22:00:57 +08:00