wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
151 Commits 4 Branches 0 Tags
859cac19a282f98e3195c017f480a91b170990f0
Commit Graph
13 Commits
Author SHA1 Message Date
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 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 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 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 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 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 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 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 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 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 b50eddf2bb feat(layout): 基础布局/导航/页脚/明暗不闪烁 
- BaseLayout：字体三轨统持、viewport-fit=cover、theme-color 双套、skip-link
- Header：≤4 项导航纪律 + sticky 毛玻璃 + aria-current；搜索 icon 占位待 T8
- Footer：ICP 备案链接（法定保留）+ built-from 具名槽位待 T7
- ThemeScript：head 内联先于首帧，手选 > 系统偏好，防白闪

验证: pnpm astro build exit 0；dist/index.html 含 ICP 文案与跳到正文链

Spec: 2026-10-24_add-blog-skeleton
Co-authored-by: GLM-5.3
 2026-10-24 23:09:45 +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