wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
231 Commits 5 Branches 0 Tags
19b765e5b1c52508a1749cb5d135f4aa7317b80d
Commit Graph
7 Commits
Author SHA1 Message Date
wait4xandGLM-5.3 49acb4cbd1 fix(posts): 隐藏开关是假开关——修「隐藏+置顶仍显示并排第一」；贡献数据去重 
用户实测：「有的文章同时选择了置顶和隐藏，还会显示并置顶」。

根因：后台「隐藏」开关（hiddenTag）是个假开关——它只写 `hiddenTag: true` 这个
没人读的字段，而全站过滤只认 `tags` 里的 `hidden`。于是隐藏从未生效；
叠加置顶后，这篇还在列表最前面。

- 新增 src/lib/post-visibility.ts：可见性契约单一事实源——`!draft && !hidden &&
  !tags.includes('hidden')`（两条通道都认，历史写法兼容）
- postsSchema 增真字段 `hidden`；七处消费点（首页双轨/归档 zh/en/书架/RSS zh/en/
  文章页导航）统一走 isVisiblePost
- 后台假开关 hiddenTag 换成真开关 hidden，hint 写清语义：不进列表/RSS/sitemap，
  页面本身仍生成（链接可分享）；与置顶同时打开时以隐藏为准
- sitemap 过滤隐藏文章（astro.config 配置期扫 frontmatter，两种写法都认；
  内容目录不可读时宁可不排除也不炸构建）

贡献数据去重（5j T2，回答用户「连续贡献是否实时」）：
- 连续贡献不再构建期抓取 streak.svg 快照（不实时、暗色需滤镜、与热力图同源重复），
  改为热力图同一份 GraphQL 日历本地计算（src/lib/heatmap.ts streakStats）：
  当前连续（以最后有贡献日为终点）/ 最长 / 总贡献，界面上标注「数据更新于 X」
- 贡献蛇块与自托管 snake/streak SVG 删除，fetch 脚本 ASSETS 清空，
  build.sh 守卫改为退役说明；开源页数据板整块并入热力图区

验证: 构建 51 页 exit 0；content-lint 52 页 0/0/0；E2E 56/56；
      临时两篇「置顶+隐藏」（新字段/旧 tags 各一）实测——首页/归档/书架/
      双语首页/RSS 双语/sitemap 全部零命中，页面本身仍生成；
      清理后归档首条恢复 writing-template（普通置顶不受影响）；
      开源页 snake/streak 资产零残留、连续统计条与更新时间标注就位

Spec: 2026-11-03_blog-5j-content-refine (T2 + 隐藏 bug 修复)

Co-authored-by: GLM-5.3
 2026-11-04 22:00:15 +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 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 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
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 725bfde21f feat(geek): 极客层 P0 四件套——键盘/构建透明/页面转场/项目墙 
- Keyboard：? 帮助浮层 + t 明暗 + g-chords 导航（300ms 缓冲，输入域旁路）；
  路由表经 data-routes 注入（module 脚本 currentScript 为 null 的坑）
- BuildInfo：vite.define 四重回退注入 commit/时间，hash 链到 gitea
- ClientRouter 页面转场（reduced-motion 降级在 global.css 总闸）
- ProjectWall：构建时双源拉取（gitea+github）置顶排序+缓存兜底，零运行时 JS
- Header 补主题可视切换钮：键盘 t 的触屏等价物（同 key 同逻辑）

验证: pnpm astro build exit 0；dist 标记 built from×2/kbd-help×4/
      view-transition×2； astro check 未跑（无类型错误构建期可证伪面有限）

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