wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
179 Commits 5 Branches 0 Tags
bdaf02f9cae774e2a094eb716a95be3f0eddab56
Commit Graph
7 Commits
Author SHA1 Message Date
wait4xandGLM-5.3 bdaf02f9ca fix(opensource): 项目墙卡片左对齐与 bio 间隙兜底（视觉终审二轮） 
Finding 1（P1）项目墙卡片内容被居中：
- 根因是全局 `.tap { display:inline-flex; align-items:center; justify-content:center }`
  沿列向 flex 的交叉轴生效，`.repo`（scoped）只赢下 display 没接管 align-items，
  于是标题与「● 语言 ★ n」行落在卡中部、卡片间左缘参差
- `.repo` 显式 align-items: stretch + text-align: left；实测四张卡的
  .repo-name 与 .repo-meta 左缘全部 313px（= 卡左 296 + 内距 16 + 边框 1）

Finding 2（P2）bio 破折号间隙修在数据不在模板：
- 原靠 opensource.yaml 串前导空格产生间隙，后台清空走兜底串时缺陷回归
- 模板改为 `{a}{' '}{blurbAfter.trim()}`：间隙由模板保证，数据怎么改都不会贴链接

验证: 构建 51 页 exit 0；content-lint 0/0/0；spec_verify 七项 exit=0（新指纹
      62086ce4cccd）；check 收敛；DOM 实测对齐与间隙均符合预期

Spec: 2026-11-02_blog-5h-content-social (视觉终审二轮)

Co-authored-by: GLM-5.3
 2026-11-02 21:14:37 +08:00
wait4xandGLM-5.3 c7d1e7b975 fix(moments): 评论流键从 #<slug> 改为虚拟路径，避免键被截断 
实测发现 `#` 在查询串里是 fragment 分隔符：裸传 `/moments/#2026-11-02` 会被服务端
截断成页面级键 `/moments/`（生产 Artalk 实测，响应里 key 变成 "/moments/"），
后果是所有瞬间共用同一个评论流、pv 也串在一起。

- page_key 改为虚拟路径 `/moments/<slug>/`（生产实测键原样保留，零转义风险；
  将来真做单条瞬间页时键天然对齐）
- spec 与 runs.jsonl 口径同步（七项 verify 在新指纹下重跑全绿）

验证: 构建 51 页 exit 0；产物含 /moments/2026-11-02/ 键；content-lint 0/0/0；
      spec_verify 七项 exit=0；check 收敛

Spec: 2026-11-02_blog-5h-content-social (T3 修正)

Co-authored-by: GLM-5.3
 2026-11-02 21:05:51 +08:00
wait4xandGLM-5.3 550f6d15b4 chore(spec): 5h 任务全勾与运行证据入库 
- tasks.md 七任务全勾；spec.md 功能框与成功标准全勾
- §5.1 全项目检查补升级条件（触及 BaseLayout/全局样式或 Artalk 接管层才升级）
- runs.jsonl 记录七项 verify 全部 exit=0（含本包新增的 E2E 46 项口径）
- content/.link-cache.json：链接卡片缓存随新文章构建刷新（入仓保证构建确定性）

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

Co-authored-by: GLM-5.3
 2026-11-02 21:01:47 +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
wait4xandGLM-5.3 63c9c8ad4a feat(counts): 浏览/评论徽标接入文章与瞬间页，修同载双计（5h T4） 
用户要「加一个访客数量、评论数量，采用类似于开源页面从 GitHub 移植过来的那个
眼睛图标」——落地为 ViewMeta 本地 SVG 徽标，无第三方图片依赖。

接入（op-artalk 车道）：
- 文章详情页 reading/tech 两分支各挂一枚 mode="page"（两分支互斥，同页仅一处计数）
- ArtalkComments 顶部旧的纯文本 pv 行与自成一套的 bumpPv 脚本整段删除，改为
  readonly chip：评论区只读展示，不再各计一次
- 瞬间页顶部整页 pv 行同样改 chip；每条瞬间卡片底部为 readonly 徽标

组件修复（本人，op-artalk 实测揪出）：
- **同载双计**：脚本既注册 astro:page-load 又立即调用 run()，首屏两者都会触发
  → 每元素 POST 两次、浏览量翻倍（实测 15→17→19 每载 +2）。加每元素一次性
  守卫后 1/2/3 每载 +1；软导航新元素仍照常计数
- **同页两枚数字差 1**：readonly 实例独立 GET 到的 pv 可能比计过数的少 1；
  改为同键存在 page 实例时 readonly 让位，由 page 实例回填同一份结果
- page 实例请求失败时释放兄弟自读，避免评论区永远停在「–」

验证: 构建 exit 0；E2E 37/37；Playwright 拦截对账——
      每载 POST=1、同页两枚徽标文本一致（101/101）、刷新后累计 2、
      接口全挂时两枚均显示占位「–」不报错

Spec: 2026-11-02_blog-5h-content-social (T4)

Co-authored-by: GLM-5.3
 2026-11-02 20:29:44 +08:00
wait4xandGLM-5.3 8e74bead62 feat(moments): 瞬间富文本与逐条评论（5h T2/T3） 
瞬间文字从纯文本直出升级到与文章同级表达力，每条动态获得独立评论流。

T2 富文本：
- text 在 frontmatter 预渲染成 momentId → html 的 Map（renderRich 是 async，
  模板内不能 await），模板只此一处 set:html 且喂的是净化产物
- 走与全站文案同一条管线：markdown → 内容净化（标签/属性/协议三层白名单）
  → class 白名单 35 项，故 <span class="c-blue font-kai"> 生效、
  <script> 整棵子树被丢弃（实测）
- 纯文本老数据零回归：无 markdown 的 text 得到单个 <p>，与旧直出视觉等价
- 卡片内富文本首尾 margin 归零、段间半档、列表缩进 1.35em，15px/ink-2 基调不变

T3 逐条评论：
- 新增 MomentComments.astro：<details> 折叠，**展开才拉 Artalk 并 init**
  （未展开连 Artalk.js 都不下载，时间线一屏十几条不白付成本）
- page_key = /moments/#<slug>，中英双语共用同一评论流（与文章页同策略）
- pvAdd: false 且复用 ViewMeta readonly 计数：读者开评论不会虚增浏览数
- 5s 兜底失败提示 + 重试；软导航回页对已展开的框补挂
- Playwright 实测同页两个容器各自 init 成功（各渲染 31 个 atk-* 节点，无异常），
  故无需降级；若日后内存吃紧可对上一实例调 destroy() 一行切换

验证: 构建 exit 0；E2E 37/37（快照口径）；临时瞬间实测 markdown 粗体、
      彩色+楷体类保留、行内码、<script> 净化丢弃、details 与 /moments/# 键、
      ViewMeta 只读挂载全部命中（验收数据已还原）

Spec: 2026-11-02_blog-5h-content-social (T2/T3)

Co-authored-by: GLM-5.3
 2026-11-02 20:20:31 +08:00
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