我如何给 Halo 博客搭建自动发布流水线

维护博客最容易被忽略的,往往不是写文章,而是发布前后那些重复操作:整理 Markdown、选择分类、补标签、上传封面、检查格式、点击发布,再打开网站确认文章真的能访问。

当这些步骤偶尔做一次时,手动操作没有问题;当博客需要持续更新时,重复劳动就会变成阻碍。我的做法是把文章发布拆成一条清晰的流水线:文章以 Markdown 保存,自动流程负责补齐元数据、提交到 Halo,并在发布后检查结果。

先把文章和发布信息分开

文章正文适合使用 Markdown 管理,标题、摘要、分类、标签和封面则作为发布元数据单独处理。这样做有两个好处:正文可以继续使用 Git 或普通文件夹管理,发布流程也能根据元数据做校验。

一篇文章至少需要这些信息:

title: 我如何给 Halo 博客搭建自动发布流水线
slug: halo-auto-publish-pipeline
category: 运维部署
tags:
  - Halo
  - 自动化
  - 博客运维
status: draft

发布前先检查标题是否为空、分类是否存在、标签是否重复,以及正文是否包含明显的占位符。检查失败时停止发布,比发布一篇格式不完整的文章更容易维护。

发布流程应该允许先保存草稿

自动化不等于每次生成后立即公开。更稳妥的流程是先创建草稿,完成内容检查后再发布。文章状态可以分成三个阶段:

  1. draft:文章已生成,但还没有公开。

  2. reviewed:标题、正文、分类和链接已经通过检查。

  3. published:Halo 返回成功,公开页面也能正常访问。

状态记录很重要。网络请求超时并不一定代表发布失败,如果没有记录文章标题、请求时间和返回结果,重试时就可能产生重复文章。自动流程应先根据文章 slug 查询,再决定是更新原文章还是创建新文章。

分类和标签要保持稳定

分类用于组织内容,标签用于描述主题。分类数量不宜频繁变化,否则旧文章会越来越难整理。我的博客可以把运维部署作为自动发布文章的主分类,再用 Halo、Markdown、自动化、Docker 等标签补充细节。

自动化程序不应该每次都创建一个新分类。发布前先读取现有分类,找到匹配项后使用它;找不到时进入草稿状态并记录原因,避免因为拼写差异产生“运维”“运维部署”“运维实践”三个相近分类。

发布成功后还要做线上校验

管理端返回成功只能说明请求被接受,还不能说明读者看到的页面没有问题。发布后至少检查三件事:

  • 文章公开链接返回 HTTP 200。

  • 页面标题和正文首段与提交内容一致。

  • 文章出现在对应分类或归档列表中。

如果文章包含图片,还需要检查图片地址是否可以从公网访问。校验失败时保留文章为草稿或记录告警,不要静默地当作发布成功。

一个适合个人博客的最小方案

对个人博客来说,不需要一开始就搭建复杂的消息队列。一个定时任务、一个文章目录和一个发布脚本就足够:

posts/
├── drafts/
├── ready/
└── published/

publish.sh
publish-state.json

脚本从 ready/ 读取文章,校验元数据后调用 Halo 接口。成功发布的文章移动到 published/,并把 Halo 返回的文章 ID、公开链接和发布时间写入状态文件。失败的文章保留在原位置,下一次任务可以重试。

真正需要自动化的,是重复且容易遗漏的步骤;文章观点、经验和结论仍然应该来自实际使用。这样发布流水线负责稳定交付,博客内容也能保持真实和可读。

结语

博客自动发布的重点不是“让程序替我写任何文章”,而是让一篇已经准备好的文章能够稳定地从文件进入 Halo,并且可以确认它已经正确出现在公开页面上。

当这条链路稳定后,再接入自动选题、AI 辅助写作、封面生成和定时发布,扩展会简单很多。先把发布这件事做可靠,持续写作才不会被重复操作打断。