#博客

不是一篇「怎么拆」的技术文档，而是一篇「为什么拆」的实践记录。当写一句话要先穿过一整套提交仪式，文章和代码就该研究各回各家了。122 篇文章、45 张图，现在住在独立的私有仓库里。

两次更新做的是同一件事。v2.3.0 把散落的旧文章收进七部书系、写了三篇总纲；v2.4.0 给每篇文章加上 TL;DR、阅读路线、继续阅读和内容类型。文章一篇没多，但读完一篇之后你知道下一条路在哪。

到了 118 篇我才承认，之前三年我一直在做错的事：不断写新的。这次改造没加一篇文章，只是把已有的重新组织了一遍。

118 篇文章之后，我不把它叫博客了。栏目、书系、双向链接、Changelog、构建链路——一个个人出版物的内容系统是怎么长出来的。

Astro Content Layer、Cloudflare Pages、GitHub Actions 定时构建、filterPublished 日期过滤——博客的完整技术链路拆解。

v1.9.5 是一次偏「工程化 + 体验打磨」的更新：深色模式支持系统跟随、此刻页新增 GitHub 风格发布热力图、站内搜索支持缩略图与 tag:/category: 筛选、集成 KaTeX 数学公式、新增建文与断链扫描脚本、接入 Lighthouse CI 自动审计，并补全了结构化数据与安全响应头。

给博客加上了「划词高亮 + 读书笔记」（数据只存本地），把站内搜索升级成 Pagefind（中文分词、模糊匹配、全文检索），还顺手修掉了几个藏了很久的 bug。

从旧版 content collections 迁移到 Astro 5 的 Content Layer API，构建速度提升 5 倍，内存少了一半。记录踩坑过程和实际改动。

技术选型的真实教训，从静态博客到自动化部署每一个坑都是成长

每个技术决策背后都有一个没说出口的理由。选 Astro 不是因为它最好，而是因为我受够了每半年换一次框架。选 Cloudflare Pages 不是因为它最快，而是因为免费。

从 Hexo 到 WordPress 到 Hugo 再到 Astro，换了五个主题，跑通了三套部署流程，删掉了两百多篇文章。博客这件事，想明白的比写出来的多。