工程实践 / AI/Git 博客

AI/Git 博客的第一原则

为什么第一版选择 Astro、Markdown、GitHub PR 和 Cloudflare Pages,而不是传统 CMS。

为什么不用传统 CMS 起步

第一版博客的目标不是获得一个后台,而是建立一个 AI 可以稳定维护的内容系统。文章、样式、组件、SEO 和发布规则都应该变成文件,接受 Git 的版本管理和审查。

Ghost、WordPress、Directus、Sanity 和 Contentful 都有成熟场景,但它们会把第一版的重点带向后台、数据库、权限和平台绑定。对于个人技术和思考博客,过早引入这些系统会增加维护面。

为什么选择 Astro

Astro 对内容型网站的边界很清楚:Markdown/MDX 文章可以通过 Content Collections 进入统一 schema,页面默认静态生成,必要时再逐步接入动态能力。

这让 AI 有明确的工作对象:

  • 写文章时改 src/content/posts/*.mdx
  • 改视觉时改布局、组件和 CSS
  • 改 SEO 时改 frontmatter 和 metadata
  • 改发布规则时改 GitHub Actions 或 Cloudflare 配置文档

为什么必须保留人工闸门

AI 可以很快生成内容,但生产发布必须有可审阅的中间状态。第一版工作流固定为分支、PR、预览、人工确认、合并发布。

这个流程牺牲了一点速度,但换来了可回滚、可讨论、可验证。博客是长期资产,不应该把生产权限直接交给自动化。

后续扩展顺序

第一版先保持小而稳。后续扩展可以按下面顺序推进:

  1. 站内搜索
  2. 评论和反馈入口
  3. 图片生成、压缩和归档
  4. 从 Obsidian 精选同步文章
  5. Pages CMS 或 Keystatic 后台

每次扩展都应该保持一个原则:内容源仍然可迁移,生产发布仍然需要明确闸门。