最近重新整理了一下本站,这次的特别之处在于:我没有像过去那样一个文件一个文件地慢慢改,而是直接把 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 不一定让每个系统都需要重写,但它确实会改变我们维护系统的方式。