wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
177 Commits 4 Branches 0 Tags
550f6d15b403b49371a2dba5afe5527697f2e46f
Commit Graph
53 Commits
Author SHA1 Message Date
wait4xandGLM-5.3 550f6d15b4 chore(spec): 5h 任务全勾与运行证据入库 
- tasks.md 七任务全勾；spec.md 功能框与成功标准全勾
- §5.1 全项目检查补升级条件（触及 BaseLayout/全局样式或 Artalk 接管层才升级）
- runs.jsonl 记录七项 verify 全部 exit=0（含本包新增的 E2E 46 项口径）
- content/.link-cache.json：链接卡片缓存随新文章构建刷新（入仓保证构建确定性）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Co-authored-by: GLM-5.3
 2026-11-02 20:02:08 +08:00
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 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 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 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 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 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 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 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
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
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 ad5f9d3d95 chore(spec): 创建 add-blog-5c 任务包（五任务） 
Spec: 2026-10-25_add-blog-5c

Co-authored-by: GLM-5.3
 2026-10-25 19:19:26 +08:00
wait4xandGLM-5.3 0e792a70cc chore(spec): 归档 add-terminal-books-admin——五任务四车道收敛 
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 b789d30a5d chore(spec): 创建 add-terminal-books-admin 任务包（Phase 5b 四任务三车道） 
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 6da2b7cecf chore(spec): 归档 add-media-and-polish——六任务三车道收敛 
spec_verify --all 六项同指纹 exit=0；视觉终审+复验双轮 可上线

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

Co-authored-by: GLM-5.3
 2026-10-25 12:26:56 +08:00
wait4xandGLM-5.3 bbbd4ef11c chore(spec): T1/T3/T4/T5 勾选——媒体支持四任务闭环 
Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:54:30 +08:00
wait4xandGLM-5.3 b0b7e2cd00 chore(spec): 创建 add-media-and-polish 任务包（六任务三车道） 
Spec: 2026-10-25_add-media-and-polish

Co-authored-by: GLM-5.3
 2026-10-25 11:43:33 +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 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 bfda43d7d1 chore(spec): 归档 add-blog-launch（T3 依赖行修正后收敛） 
Spec: 2026-10-25_add-blog-launch

Co-authored-by: GLM-5.3
 2026-10-25 09:54:58 +08:00
wait4xandGLM-5.3 ca829f09c6 chore(spec): 归档 add-blog-launch——Phase 4 六任务收敛 
spec_verify --all 六项同指纹 exit=0；check 收敛；真实 push E2E 见合并后

Spec: 2026-10-25_add-blog-launch

Co-authored-by: GLM-5.3
 2026-10-25 09:53:25 +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 0c54a43bb5 chore(spec): 创建 add-blog-launch 任务包（Phase 4 六任务） 
Spec: 2026-10-25_add-blog-launch

Co-authored-by: GLM-5.3
 2026-10-25 09:41:55 +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 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 cf42081614 chore(spec): 创建 add-blog-i18n 任务包（Phase 3 八任务三车道） 
Spec: 2026-10-25_add-blog-i18n

Co-authored-by: GLM-5.3
 2026-10-25 09:14:47 +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 094f0f0d5b chore(spec): 归档 add-blog-skeleton——Phase 1 十任务收敛交付 
- T1-T10 全勾选，spec_verify --all 十项 exit=0 入 runs.jsonl
- 交付：Astro 7.3.8 全站骨架（tokens/字体分片 399 片/三集合/五页型/
  极客层 P0/pagefind+rss+sitemap/Artalk 懒挂/staging 管线）
- 无头浏览器实测：项目墙双源拉取真实仓（gitea 转公开后自托管卡置顶）

Spec: 2026-10-24_add-blog-skeleton

Co-authored-by: GLM-5.3
 2026-10-25 00:16:22 +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
wait4x ce41c800ba chore(spec): 创建 add-blog-skeleton 任务包（Phase 1 十任务） 
Spec: 2026-10-24_add-blog-skeleton
 2026-10-24 23:00:20 +08:00
wait4xandGLM-5.3 0f7c2dfe5b chore(spec): 归档 add-blog-infra——Phase 0 七任务收敛交付 
- T1-T7 全部勾选，spec_verify --all 七项 exit=0 入 runs.jsonl
- check 门禁收敛；交付：备份三件套/gitea 28.2.0/Artalk 2.10.0/
  git.wait4x.online + /artalk 公网接入/发布链地基与回滚预案
- 生产 Halo 全程未动（healthy + 200 复查通过）
- 含 spec pre-commit/pre-push 门禁钩子入库

Spec: 2026-10-24_add-blog-infra

Co-authored-by: GLM-5.3
 2026-10-24 22:35:24 +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