如何给 Hermes Agent 装上 Halo 博客管理技能
文章摘要
|
如何给 Hermes Agent 装上 Halo 博客管理技能
记录一下给 Hermes Agent 配置 Halo 博客管理能力的过程，供后续参考。
背景
Halo（https://www.halo.run）是一款开源博客系统，我平时用它写博客发文章。以前都是登录后台手动操作，写多了就觉得麻烦——尤其是需要批量发、或者在终端环境下干活的时候，就想能不能用命令行搞定一切。
正好 Hermes Agent 支持通过 SkillHub 安装技能插件，就找到了 @alex-shen1121/halo-blog 这个技能。
安装过程
1. 安装 SkillHub CLI
SkillHub 是国内的 Skill 商店，访问 https://skillhub.cn/install/skillhub.md 可以看到安装脚本：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
装完之后 CLI 在 ~/.local/bin/skillhub，如果提示找不到，加绝对路径即可。
2. 搜索 Halo 相关技能
skillhub search halo
结果里有好几个，选了 @alex-shen1121/halo-blog 这个，功能最全，支持文章、页面、主题、插件、评论、备份等全套管理。
3. 安装到 Hermes Agent 的 Skills 目录
skillhub install halo-blog --namespace alex-shen1121 --dir /root/.hermes/skills/
注意：--dir 必须指向当前 Agent 的 skills 目录，否则装到默认位置不会被识别。
4. 安装 Halo CLI（Node.js 全局工具）
这个 Skill 本质上是调用 @halo-dev/cli，所以系统里得有这个包：
npm install -g @halo-dev/cli
装完验证一下：
halo --version
# halo/1.3.0 linux-x64 node-v24.18.0
5. 配置认证
拿到 Halo 后台的 API Token（个人设置 → API Token），然后：
halo auth login \
--profile 豉油鸡 \
--url http://localhost:8090 \
--auth-type bearer \
--token pat_eyJraWQiOiJ...
Bearer Token 直接用 PAT 就行，不需要额外配置 Basic Auth。
6. 验证连接
halo post list
看到文章列表就说明通了。
能做什么
安装完之后，终端里直接敲命令就能管理博客：
| 命令 | 功能 |
|---|---|
halo post list |
列出所有文章 |
halo post import-markdown --file ./article.md --force |
从 Markdown 导入文章（自动转 HTML） |
halo post create --title "标题" --content "内容" --publish true |
直接创建文章 |
halo single-page * |
管理单页 |
halo comment list |
查看评论 |
halo theme upgrade --all --yes |
批量升级主题 |
halo plugin upgrade --all --yes |
批量升级插件 |
halo backup create |
创建备份 |
halo post export-json my-post --output ./post.json |
导出文章为 JSON |
支持管理多个 Halo 实例（--profile 切换），也支持输出 JSON 方便脚本调用。
用处
对我来说最实用的就两点：
- Markdown 直接发文章：写完
.md文件，一行命令发布，不需要登录后台，适合批量发文。 - 服务器环境无 GUI 管理：在纯终端环境下，CLI 比网页后台高效得多。
当前状态
- Halo CLI：
v1.3.0 - Node.js：
v24.18.0 - 已连接本地 Halo 实例
有问题欢迎交流。