wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
149 Commits 4 Branches 0 Tags
c4bdf466144b53d2f90b3b474207d05967628330
Commit Graph
12 Commits
Author SHA1 Message Date
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 227bc24797 build(deps): Node 26.13.0 + Astro 7.4.4 升级（含 exif loader 句柄修复） 
- 宿主 Node 22.22.3 → 用户级安装 26.13.0（~/.local/node），systemd
  unit PATH 前置，CI 构建链同步吃到新版本
- Astro 7.3.8 → 7.4.4（7.4 要求 Node ≥22.23.4，此前升级因 Node 版本
  不足被 CI 拒绝；本次先升 Node 再升框架）
- exif loader 修复：Node 22.23+/26 把"GC 时仍打开的 FileHandle"从警告
  升级为错误，exifr 接收文件路径时自开 fd 不显式关闭 → 全线 content/
  photos/*.jpg 触发构建失败。改为一律 readFile 成 Buffer 再喂 exifr
  （无 fd 参与）

验证: 全量构建 44 页 exit 0（node v26.13.0 + astro 7.4.4）；E2E 37/37；
      content-lint 0/0/0；后处理链（字体子集/首页内联）复跑通过；
      unit PATH 实测已前置 node26

Spec: none (运行时与框架升级，全链验收)

Co-authored-by: GLM-5.3
 2026-11-02 15:27:28 +08:00
wait4xandGLM-5.3 7c1462bde0 fix(admin): 书封上传路径修复——media_folder 相对解析 + Astro 暂留 7.3.8 
- Sveltia 对 folder 集合的 media_folder 按"相对集合目录"解析：写成
  content/posts/assets 会二次嵌套成 content/posts/content/posts/assets
  （用户在后台首次上传书封即踩，文件落错位置 + cover 引用缺失 →
  构建 ImageNotFound，发布链中断）。修为 assets，并把已落错位置的
  书封文件移到 content/posts/assets/
- Astro 7.4.4 需要 Node >= 22.23.4，宿主为 22.22.3：升级将锁死 CI
  构建（实测 CI 报 not supported）。本笔回落到 7.3.8 恢复发布链；
  Node 升级后另行升级 Astro（含全链验收）

验证: pnpm astro build 44 页 exit 0；书封图片入 content/posts/assets/
      与文章 cover 路径一致

Spec: none (后台路径修复 + 依赖回滚)

Co-authored-by: GLM-5.3
 2026-11-02 15:09:03 +08:00
wait4xandGLM-5.3 8f01d825b7 build(deps): Astro 7.3.8 → 7.4.4（同 major 小版本升级） 
- 项目 Phase 1 曾故意锁 7.3.8（Astro 7 换 Rust 版 Sätteri Markdown
  处理器，自定义插件压在 legacy unified 路径上）——现 D 车道已装
  @astrojs/markdown-remark 兜住该路径，升级窗口成熟
- 7.4.x 对本站有实际收益的三项修复：①<Image>/<Picture> 重复 srcset
  候选（图库/书封/OG 卡缩略图大量使用）②ClientRouter 返回导航不再播放
  smooth 滚动动画（本站开 View Transitions）③未使用组件 scoped 样式
  泄漏（与 CSS 体积优化相关）
- 升级后清 node_modules/.astro（渲染缓存）全量重建

验证: 全量构建 45 页 exit 0；E2E 37/37 PASS；content-lint 0/0/0；
      后处理链复跑（字体子集 8.0→3.2MB 60% 裁减、首页 CSS 内联、
      SW 预缓存 19 路由）；回归抽查（图库 srcset 零重复候选=7.4 修复
      实证、灯箱开合、g s 弦、链接卡片渲染）全过

Spec: none (依赖小版本升级，全链验收)

Co-authored-by: GLM-5.3
 2026-11-02 14:58:35 +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 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 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 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 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 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