写在前面:把博客变成一张会生长的书桌
以前更新个人博客,往往要经历一串并不浪漫的步骤:想选题、写草稿、找图片、改格式、检查路径、运行 Hexo、再推送到 GitHub。任何一个环节卡住,原本的表达欲就会被消耗掉一半。于是我开始想:如果把 Codex 当成一个博客工作台,让它帮我处理那些重复、琐碎、但又不能马虎的事情,会不会让写作重新变得轻盈一点?
这篇文章就是一次完整记录:如何使用 Codex 辅助更新一个基于 Hexo 和 GitHub Pages 的个人博客。它不是让 AI 代替我表达,而是让 AI 帮我整理工具、守住规则、搭起文章骨架,最后把更多精力留给真正重要的内容。
一、先给 Codex 一份项目规则
对个人博客来说,最重要的不是“自动化越多越好”,而是要保证博客仍然由自己掌控。尤其是旧文章、主题配置、部署配置这些文件,一旦被误改,排查起来会很麻烦。所以我会先在项目根目录放一个 AGENTS.md,把操作边界写清楚。
可以写成这样:
1 | # AGENTS.md |
这份规则像是一道护栏。Codex 可以大胆帮我写、帮我整理、帮我检查,但它知道哪些地方不能随便碰。对于个人博客来说,这种“有边界的自动化”比无脑全自动更可靠。
二、确认博客的基本结构
Hexo 博客的文章通常放在 source/_posts/ 目录中,图片可以放在 source/image/ 或者与文章配套的资源目录里。Codex 在动手之前,最好先看一眼项目结构,确认这是不是一个标准 Hexo 项目。
常见结构大概如下:
1 | my-blog/ |
其中最需要谨慎对待的是 _config.yml、themes/、public/ 和 .deploy_git/。前两个影响网站配置和外观,后两个通常是构建或部署产生的结果。日常写文章时,一般不需要碰它们。
三、让 Codex 按已有文章格式写新文章
一个博客的风格,往往藏在细节里:标题怎么写、标签怎么放、分类怎么命名、封面图字段叫什么。我的博客文章一般会使用这样的 Front Matter:
1 |
|
有了这些信息,Hexo 才知道文章标题、发布日期、分类标签和封面图片。以后每次新增文章时,Codex 可以先参考旧文章格式,再生成新的 Markdown 文件。这样博客不会变成东一块西一块的拼贴,而是保持统一的样子。
四、用“草稿优先”的流程更新博客
我更推荐把 Codex 的工作流设计成下面这样:
- 提出主题:告诉 Codex 想写什么、面向谁、希望什么风格。
- 生成草稿:Codex 新增 Markdown 文件和必要配图。
- 本地预览:运行 Hexo 预览页面效果。
- 用户确认:检查标题、内容、图片和排版。
- 发布上线:确认无误后再提交、推送和部署。
这个流程的好处是,它既能享受自动化的效率,又不会失去对博客的控制权。尤其是个人博客,本质上还是自己的表达空间,不应该被工具牵着走。
五、一个实际可用的提示词模板
如果以后想让 Codex 帮忙写文章,可以直接使用类似下面的提示词:
1 | 请为我的 Hexo 博客新增一篇中文文章。 |
这个提示词的重点不是“写得更长”,而是把边界说清楚。主题、分类、文件位置、权限范围、发布动作,都提前说明,后面的协作就会顺很多。
六、必要时让 Codex 帮忙检查构建
文章生成后,可以让 Codex 执行一次本地构建检查。Hexo 项目常用命令如下:
1 | npm install |
如果只是检查文章能不能正常生成,通常运行下面这个就够了:
1 | npx hexo generate |
如果想在浏览器里预览效果,可以启动本地服务:
1 | npx hexo server |
预览没有问题后,再考虑提交到 GitHub。这里我仍然建议保留一个确认动作,因为“能构建成功”和“自己真的满意”并不是一回事。
七、可以自动化,但不要失去人的判断
Codex 很适合处理重复性工作,比如统一格式、补充目录、整理草稿、生成配图说明、检查 Markdown 结构。但一篇个人博客真正有价值的地方,仍然是作者自己的经验、情绪、判断和表达。
所以我理想中的模式不是让 Codex 替我写完一切,而是让它成为一个安静可靠的编辑助手:我提出方向,它搭建框架;我补充经历,它整理语言;我决定发布,它负责检查流程。这样一来,博客不会变成冰冷的自动内容仓库,而会变成一个更容易持续生长的个人空间。
八、未来可以继续升级的方向
等这个流程稳定以后,还可以继续做几件事:
- 建立固定文章模板,比如技术笔记、读书笔记、年度总结、工具教程。
- 新增草稿目录,让 Codex 默认只写草稿。
- 定期检查某个素材文件夹,把零散笔记整理成博客初稿。
- 为图片建立统一命名规则,减少路径混乱。
- 写一个发布前检查清单,确认标题、分类、标签、封面、链接都没问题。
- 使用 GitHub Actions 自动构建,让本地只负责写作和提交。
到那时,更新博客就不再是一件“每次都要重新启动”的事,而是一条熟悉的生产线:想法进入,文章成形,确认发布,最后沉淀为自己的知识地图。
最后
使用 Codex 更新个人博客,真正重要的不是“AI 写了多少字”,而是它能否帮助我把表达这件事坚持下去。工具负责铺路,人负责选择方向。只要方向还在,博客就会一直更新下去。


