这个博客从一个刻意很小的表面开始:文章是本地 MDX 文件,路由静态生成,元数据来自类型化的 frontmatter。目标是让发布流程尽量稳定、可预测。

为什么静态优先

个人博客默认不需要数据库。本地内容让写作流程贴近代码,每篇文章都有可审查的历史记录,也让构建结果更容易预测。

内容管线会在页面层读取之前验证每篇文章:

type PostFrontmatter = {
  title: string;
  description?: string;
  date: string;
  category: string;
  tags: string[];
};

这意味着归档页、标签页、RSS、站点地图和 Open Graph 元数据都来自同一个可信来源。

之后可以扩展什么

当前版本刻意不加入账户、评论和数据库。等到真实工作流需要这些能力时再添加也不晚。在那之前,网站保持可移植且运行成本很低。