wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
185 Commits 5 Branches 0 Tags
36643f5cf087b9f8b46f598516b30c6b80fe9e6b
Commit Graph
18 Commits
Author SHA1 Message Date
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 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 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 a761cf8129 feat(papers): 论文内置阅读——arXiv iframe 零再分发合规方案 
Agensh（arXiv 2609.26781）在线研读页：/papers/agensh/ 双轨薄壳
_PaperView 共享视图+六词条；信息条含标题/作者/abs 链接/授权声明
（arXiv nonexclusive-distrib 1.0，非本站托管）/下载钮。

合规红线：许可证禁第三方再分发→仓内零 PDF 副本，iframe 直嵌
arxiv（实测无 X-Frame-Options）；微信 webview 前置 UA 检测加
is-wechat 类、iframe 不挂 src 零无用请求、兜底卡指引右上角浏览
器打开；非微信 data-src 懒挂载+9s 弱兜底+noscript 兜底。正文
入口卡双轨已渲染。

车道：op-gitea（专项四断言+E2E 34/34）；收编复验六断言全过
（iframe/授权/微信降级/en/入口卡/零 PDF）

验证: E2E 34/34；微信 UA 模拟 is-wechat=true src 空 提示在；
      git status 零 .pdf

Spec: none (论文阅读页，车道级交付)

Co-authored-by: GLM-5.3
 2026-11-02 08:41:39 +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 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 215760c38a style(nav): en 开源词条 Open Source→Projects——窄屏免内滚 
390-430px 尾部主题钮原本需导航内滚一滑才可见；短词省 35px，
三宽度全直显（用户拍板）。页面标题与热力图词条不动，仅导航。

验证: en@390/410/430 主题钮右缘全在屏内+页面零溢出实测；E2E
      33/33 PASS

Spec: none (单词条更名，宽度收益实测)

Co-authored-by: GLM-5.3
 2026-10-25 22:32:02 +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 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 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 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 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 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