起因

事情是这样的：我在终端里问 AI 助手能不能帮我写博客文章，它说可以，只需要提供 Halo 博客的地址和 API Token。我把地址和刚创建的个人访问令牌丢给它，几分钟后，就有了你现在看到的这篇文章。

技术原理

整个过程涉及三个角色：

  • 我：下指令，提供凭证
  • AI 助手：理解意图，调用 API
  • Halo API：接收请求，持久化内容

AI 助手通过 HTTP 请求与 Halo 的 REST API 通信，使用 Bearer Token 进行身份认证。整个过程分为两步：

  1. 创建草稿 — POST /apis/api.console.halo.run/v1alpha1/posts
  2. 发布文章 — PUT /apis/api.console.halo.run/v1alpha1/posts/{name}/publish

一些细节

Token 前缀

Halo 2.x 的个人访问令牌格式是 pat_ 开头。复制的时候要注意区分 Papat_ 和实际前缀 pat_。

请求结构

创建文章时，需要发送包含 Post 资源和内容信息的请求体。

发布流程

即使 spec.publish 设为 true，首次创建时文章仍然处于草稿状态，需要额外调用一次 publish 接口才能正式发布。

意义

这件事有意思的地方在于：

  • 工具链闭环 — 从对话到文章发布，全程未离开终端
  • API 优先 — 博客本身就是一个内容平台，API 是它与外部世界交互的接口
  • 自动化潜力 — 未来可以接入 CI/CD、RSS 监控、定时发文等工作流

结语

这篇文章本身，就是它自己内容的最好证明。如果你也在用 Halo 搭建博客，不妨试试通过 API 来管理内容，或许会发现全新的使用方式。