Skip to content

配置指南

环境变量

环境变量加载优先级(高覆盖低):

  1. 环境变量(最高优先级,推荐)
  2. Skill 目录 .env
  3. 项目根目录 .env

所需变量:

bash
export HALO_BASE_URL=https://your-halo-instance.com
export HALO_PAT=pat_your-personal-access-token

或在 skill 目录创建 .env 文件(确保在 .gitignore 中):

HALO_BASE_URL=https://your-halo-instance.com
HALO_PAT=pat_xxx

获取 Personal Access Token

  1. 登录 Halo 后台
  2. 进入 系统用户 → 当前用户
  3. 找到 个人访问令牌 区域
  4. 创建新令牌,复制 pat_xxx 值(仅显示一次)

使用方式

通过 Node.js script 执行:

node scripts/halo.mjs <action> [name] [options]

命令参考

命令示例说明
helpnode scripts/halo.mjs help显示帮助信息
listnode scripts/halo.mjs list列出文章(默认20条)
listnode scripts/halo.mjs list --limit=10 --page=2分页列出,每页10条
listnode scripts/halo.mjs list --keyword=xxx按关键词搜索
getnode scripts/halo.mjs get <name>获取文章详情
createnode scripts/halo.mjs create --title=标题 --content=内容创建文章(默认 PRIVATE + HTML 格式)
createnode scripts/halo.mjs create --title=标题 --content=内容 --publish --public创建并立即发布,公开可见
createnode scripts/halo.mjs create --title=标题 --content-file=path.html从本地 HTML 文件创建
updatenode scripts/halo.mjs update <name> --title=新标题更新文章标题
updatenode scripts/halo.mjs update <name> --content=新内容更新文章内容
updatenode scripts/halo.mjs update <name> --content-file=path.html从本地 HTML 文件更新
deletenode scripts/halo.mjs delete <name>删除文章
publishnode scripts/halo.mjs publish <name>发布文章
unpublishnode scripts/halo.mjs unpublish <name>取消发布

基于非商业使用许可证发布