wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
181 Commits 4 Branches 0 Tags
52188d5b120fea6a2e9aea61bcbbf300a25f1440
Commit Graph
56 Commits
Author SHA1 Message Date
wait4xandGLM-5.3 bdaf02f9ca fix(opensource): 项目墙卡片左对齐与 bio 间隙兜底（视觉终审二轮） 
Finding 1（P1）项目墙卡片内容被居中：
- 根因是全局 `.tap { display:inline-flex; align-items:center; justify-content:center }`
  沿列向 flex 的交叉轴生效，`.repo`（scoped）只赢下 display 没接管 align-items，
  于是标题与「● 语言 ★ n」行落在卡中部、卡片间左缘参差
- `.repo` 显式 align-items: stretch + text-align: left；实测四张卡的
  .repo-name 与 .repo-meta 左缘全部 313px（= 卡左 296 + 内距 16 + 边框 1）

Finding 2（P2）bio 破折号间隙修在数据不在模板：
- 原靠 opensource.yaml 串前导空格产生间隙，后台清空走兜底串时缺陷回归
- 模板改为 `{a}{' '}{blurbAfter.trim()}`：间隙由模板保证，数据怎么改都不会贴链接

验证: 构建 51 页 exit 0；content-lint 0/0/0；spec_verify 七项 exit=0（新指纹
      62086ce4cccd）；check 收敛；DOM 实测对齐与间隙均符合预期

Spec: 2026-11-02_blog-5h-content-social (视觉终审二轮)

Co-authored-by: GLM-5.3
 2026-11-02 21:14:37 +08:00
wait4xandGLM-5.3 c7d1e7b975 fix(moments): 评论流键从 #<slug> 改为虚拟路径，避免键被截断 
实测发现 `#` 在查询串里是 fragment 分隔符：裸传 `/moments/#2026-11-02` 会被服务端
截断成页面级键 `/moments/`（生产 Artalk 实测，响应里 key 变成 "/moments/"），
后果是所有瞬间共用同一个评论流、pv 也串在一起。

- page_key 改为虚拟路径 `/moments/<slug>/`（生产实测键原样保留，零转义风险；
  将来真做单条瞬间页时键天然对齐）
- spec 与 runs.jsonl 口径同步（七项 verify 在新指纹下重跑全绿）

验证: 构建 51 页 exit 0；产物含 /moments/2026-11-02/ 键；content-lint 0/0/0；
      spec_verify 七项 exit=0；check 收敛

Spec: 2026-11-02_blog-5h-content-social (T3 修正)

Co-authored-by: GLM-5.3
 2026-11-02 21:05:51 +08:00
wait4xandGLM-5.3 d4fe273812 fix(visual): 修视觉终审的折行/豆腐块与灰阶纪律违规 
视觉终审（glm-5.3-flash:max）判 BLOCK，逐条修完并复测。

P1 阻断：
- 瞬间页日期折成两行（`2026-` / `04-29`）：日期列复用 var(--space-5)=40px，
  而 10 字符 mono 日期需 ≈75px 且缺 nowrap。抽 --tl-rail(5.4rem) 统一驱动
  轨道宽度与两处偏移，加 nowrap；实测日期单行（高度 20px）且圆点与卡片对齐

P2 交付可见破形：
- 关于页「关于我」行首 emoji 在无彩色 emoji 字体的环境渲染成黑方块：
  正文行首 emoji 全部去掉（改纯文字段落），并给 --font-serif/--font-sans
  链尾补 Apple/Segoe/Noto emoji 回退——用户内容里的 emoji（瞬间、书评）
  同样不再落豆腐块

移动端导航两字折行（开/源、文/章）：
- ≤450px 的 overflow-x 内滚从未生效：flex 子项默认可压缩，中文词被压到就地
  折行。给 nav ul > li 加 flex:none + .nav-link nowrap；实测 360/390/430
  三档全部单行（Range.getClientRects 计数逐项验证）

灰阶纪律：
- 项目墙原来按 GitHub linguist 给每个仓染语言色点，开源页铺 15 个仓 = 15 种
  彩色，破「外壳灰阶、彩色只作正文强调」红线 → 统一改灰阶点，语言靠文字承载
- 语言占比并列（Python/TypeScript 各 36%）只有第一名着色，读起来像谁领先 →
  判定改为「百分比等于最大值者一并着色」

版式与文案细节：
- prose 标题到正文比 tracks 多一档（16+16=32 vs 16）→ .sec-title + .prose-body
  margin-top: 0
- 开源页 bio 破折号贴链接（`blog—— Astro`）→ 破折号前补空格
- 页脚 built from<hash> 缺空格（Astro 吃掉换行处空白）→ 显式 {' '}
- 新增一条真实瞬间（含青色楷体富文本）替代只有占位串的样本，让评论区与标签行
  的间距可在真实数据下验收

验证: 构建 51 页 exit 0；content-lint 51 页 0/0/0；E2E **46/46 PASS**；
      390px 四页 scrollWidth == innerWidth（无横向滚动）；
      导航 360/390/430 全部单行；日期单行；config-check 全过

Spec: 2026-11-02_blog-5h-content-social (视觉修复)

Co-authored-by: GLM-5.3
 2026-11-02 20:56:00 +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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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