最近重新整理了一下本站,这次的特别之处在于:我没有像过去那样一个文件一个文件地慢慢改,而是直接把 AI 当成了结对工程师来用。

这件事本身也挺适合作为一篇记录。毕竟本站从 2016 年开始存在,中间经历过 Hexo、Hugo、主题迁移、Docker 化、Nginx 配置调整,也算是一个小型但长期运行的个人项目。以前每次改版,最大的成本并不是写几行 CSS,而是重新进入上下文:目录结构是什么、主题怎么覆盖、哪些文件会影响构建、哪些配置不能乱动。

这次 AI 帮我把这个成本降了很多。

没有推翻 Hugo

一开始我也在想,既然现在有 AI Coding,是不是已经不需要 Hugo 这种静态站点系统了。让 AI 直接写一个静态页面,似乎也能很快完成。

但真正拆开来看,Hugo 仍然有价值。它负责的是长期内容管理:Markdown、文章列表、多语言、RSS、sitemap、分类标签、URL 结构和静态构建。这些能力不是 AI 写几个 HTML 文件就能自然获得的。

所以最后选择的是一个更稳妥的方向:保留 Hugo 作为内容底座,同时用 AI 来重写关键页面和视觉表达。

这次没有动文章系统,也没有丢掉 PaperMod 主题,而是在 Hugo 的模板覆盖机制上做定制:

  • 新增自定义首页模板 layouts/index.html
  • 新增关于页模板 layouts/about.html
  • 新增站点扩展样式 assets/css/extended/ai-site.css
  • 保留原来的文章、分类、标签、RSS 和多语言能力

这样改完以后,站点仍然是 Hugo 站点,但首页和关于页已经不再像默认主题。

AI 参与了什么

这次 AI 做得比较好的地方,不是“替我生成一段好看的文案”,而是完整参与了工程过程。

它先读了仓库结构,确认这是一个 Hugo + PaperMod + Nginx 的静态站点。然后根据现有配置判断应该走模板覆盖,而不是直接复制一整套主题出来改。这个判断很重要,因为个人站点最怕的就是为了一个页面效果,把后续维护复杂度拉高。

接着它生成了首页和关于页的模板。首页突出我现在的定位:AI 技术专家、AI 方向探索、Agent 架构和 AI Coding。关于页则改成了更像个人资料页的结构,左侧是身份摘要和社交入口,右侧继续使用 Markdown 内容。

样式部分也没有另起炉灶,而是利用 PaperMod 已有的扩展入口。PaperMod 会自动打包 assets/css/extended/*.css,所以只需要新增一份 CSS,就能在不破坏主题主体的情况下实现定制。

人还是要把关

当然,AI 不是一次就能把所有东西做到合适。

比如首页里最初出现过“从旧文章继续往前写”这种有点别扭的表达,也出现过“能真正落地的 AI 系统”这种偏口号的模块。它们不是错误,但放在个人站首页上就显得不够自然。

这些地方还是需要人来判断语气、审美和个人表达是否贴合自己。经过几轮调整后,文案改成了更直接的“最近更新”,右侧模块也改成了“AI、Agent 与编码工作流”,下面列出 AI 应用、Agent、编码三个具体方向。

这也是我对 AI Coding 目前比较真实的感受:它很适合承担结构化执行、上下文整理、模板改造、样式落地和验证工作,但最终的取舍仍然要由人负责。

验证也很重要

这次改版不只是生成文件,还做了本地构建和浏览器检查。

Hugo 构建使用了:

cd index
hugo --gc --minify

页面预览使用:

hugo server

此外还用浏览器检查了桌面和移动端布局,重点看有没有横向溢出、文字是否挤压、首页首屏是否能露出下一段内容。最后发现移动端 hero 区域过长,于是隐藏了一部分次要信息,让首屏更轻一些。

这些验证步骤以前也会做,但有 AI 在旁边时,它可以更快地把问题定位到具体模板或 CSS 规则上。

一点感受

这次重构让我更确定一件事:拥抱 AI 不是把原来的工程体系全部扔掉,而是让 AI 进入已有体系,帮我们更快理解、修改和验证它。

Hugo 没有过时,Markdown 没有过时,静态站点也没有过时。变化的是,过去需要我自己慢慢翻文档、找模板、调样式的过程,现在可以变成一场更高效的协作。

AI 不一定让每个系统都需要重写,但它确实会改变我们维护系统的方式。