wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
195 Commits 4 Branches 0 Tags
907f64472a022e3388dce26190afe43e60dcbf48
Commit Graph
14 Commits
Author SHA1 Message Date
wait4xandGLM-5.3 8d82aab213 fix(fonts): 字体切换真加载——按内容诉求注入，含瞬间排版类作用域缺口（5i T1） 
用户实测「字族渲染没有成功，尤其是字体的切换」。根因不是字体没做，是加载门禁错：
BaseLayout 把 serif/kai/kuaile/hwmc 四份字体 CSS 全关在 `track === 'reading'` 分支里，
技术轨文章与全站页面（默认 track='tech'）从不加载它们——于是 `.font-kai` 计算值虽是
`"LXGW WenKai Screen"`，但该 @font-face 根本不在文档字体集里，浏览器静默回退系统宋体。

- 新增 `src/lib/font-needs.ts`：`fontsFromText()` 纯函数 + `fontsForPage(pathname, track)`
  按路径取该页内容（文章正文 / home.yaml / about.yaml / opensource.yaml / 全部瞬间文本）
  与页面静态诉求（reading→serif；书架标题写死楷体→kai 等）算出所需字族集合
- BaseLayout 改为逐项按需注入（非阻塞 preload+onload 写法保留），noscript 同步；
  汇文明朝仍走 public 手工切片路径，network/font-display 未动
- **顺手补掉 5h 遗留的用户可见缺口**：瞬间富文本容器 class 是 `mom-text`，而全局排版类
  规则只覆盖 `.prose-*/.rich/.prose-body` → 瞬间里写 `font-kai`/`c-teal` 一直只有 class
  没有样式（新瞬间正是这么写的，用户看到的就是"没变色没换字"）。global.css 给 38 处
  选择器组补 `.mom-text`
- 另修自写 bug：en 路由切分 `slice(3)` 残留前导 `/` 导致 en 页按需字体全部落空，改 `slice(4)`

验证: 构建 exit 0（content-lint 51 页 0/0/0）；E2E 46/46；Playwright 实测
      技术轨文章 document.fonts 命中 LXGW WenKai Screen / WF-Hwmc / ZCOOL KuaiLe /
      Noto Serif SC，`.font-kai` 计算族 = LXGW 且 check=true；
      首页仍为基线（零增量）；瞬间页因有 font-kai 内容而命中 LXGW；
      书评页只拉 serif（41 片，0 kai 0 汇文）

Spec: 2026-11-02_blog-5i-fonts-polish (T1)

Co-authored-by: GLM-5.3
 2026-11-03 11:28:51 +08:00
wait4xandGLM-5.3 36643f5cf0 chore(spec): 合入 CMS 侧内容编辑并解决 opensource.yaml 冲突 
合远端 main（后台 CMS 期间产出 3 个「Update 页面文案」提交）时的两处冲突：

- blurb_after：取 CMS 版本（用户的编辑为准）；折号间隙已由模板
  `{a}{' '}{blurbAfter.trim()}` 保证，不再依赖数据前导空格
- opensource.yaml 尾部：CMS 侧把 perSource 改成 github、intro_from 切到
  github-readme。**perSource 尊重用户选择**；intro_from 改回 "off" 并补注释——
  本阶段的目的正是用原生档案卡替换 README 原样渲染（README 带 7 类第三方外链图，
  且 `<div align="center">` 在本站失效，正是用户报告的「没居中、图片不显示」根因）。
  想回退在后台把该字段切回 github-readme 即可。

顺带对齐：关于页「找到我」的邮箱原来是 admin@wait4x.online（我拟的），
改为与站点 socials 一致的 X@alumni.nudt.edu.cn，避免出现一个不存在的地址。

验证: 构建 51 页 exit 0；content-lint 51 页 0/0/0；config-check 全过；
      E2E 46/46 PASS

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

Co-authored-by: GLM-5.3
 2026-11-02 21:21:41 +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
wait4x cdd9c61641 Update 页面文案 “home” 2026-11-02 11:47:24 +00:00
wait4x e1fc8bd64c Update 页面文案 “opensource” 2026-11-02 11:45:26 +00:00
wait4x cc12e016ab Update 页面文案 “opensource” 2026-11-02 11:42:51 +00: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 aaa9cd9274 feat(typography): 全站三层排版——富文本/页面级覆盖/艺术字体类 
- 层 1 所有页面文案改富文本：site-content 新增 renderRich(md,{inline})
  复用既有全管线（raw→内容净化→class 白名单→链接卡片）；接入
  home.tagline/subtitle、opensource.blurb、about.intro、blocks prose；
  新增 .rich 容器作用域并与 .prose-body 合并（77 处选择器覆盖四类容器）
  坑：renderRich 输出 <p> 塞进 <p class="tagline"> 会被浏览器拆散 →
  行内场景用 {inline:true} 剥外层 <p>
- 层 2 页面级排版覆盖：三单例加 typography{font?,accent?,scale?}，读取器
  pageTypography() 走白名单（10 字族 / 18 色类，scale 夹 0.8–1.25，清单外
  忽略）；页面容器挂 .page-typo + CSS 变量 --page-font/--page-accent/
  --page-scale，不动全站 tokens；后台三页加「页面排版覆盖」下拉
- 层 3 艺术字体：新增 font-art-kuaile（快乐体专用类，字距微调），白名单与
  可视化面板同步；站酷高端黑/阿里妈妈东方大楷/演示悠然小楷因无 npm 包或
  嵌入条款风险进候补清单
- 默认值清理：about.yaml 的 typography 测试值（整页汇文）清为注释示例——
  整页换字族会带来 694KB 字体成本，默认留空=全站默认排版

验证: 构建 48 页 exit 0；E2E 37/37；三页 page-typo 挂载与变量实测、四页
      （图库/书架/文章/装备）隔离为 0、font-art-kuaile 生效、about 清空后
      无覆盖

Spec: none (排版三层，先于 5g 的任务；T3/T4 另行交付)

Co-authored-by: GLM-5.3
 2026-11-02 18:40:32 +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 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
wait4x 5c814f0866 Update 页面文案 “opensource” 2026-11-02 06:59:40 +00: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