Halo CLI 内容

使用此技能处理 halo post 和 halo single-page 命令。

如果认证可能尚未就绪，请先运行 halo auth current 或加载 halo-cli-auth。

命令

bash
halo post --help
halo single-page --help

文章工作流：

• - list
• get <名称>
• open <名称>
• create
• update <名称>
• delete <名称>
• export-json <名称>
• import-json
• category（子命令）
• tag（子命令）

单页工作流：

• - list
• get <名称>
• open <名称>
• create
• update <名称>
• delete <名称>
• export-json <名称>
• import-json

文章

列出和查看：

bash
halo post list
halo post list --keyword halo --publish-phase PUBLISHED
halo post get my-post --json

创建或更新：

bash
halo post create --title Hello Halo --content # Hello Halo --publish true
halo post create --title Hello Halo --content

Hello Halo

支持分类的创建/更新：

bash
halo post create \
--title Release Notes \
--content Release notes content \
--categories News,CLI \
--tags Halo,Release

JSON 往返：

bash
halo post export-json my-post --output ./post.json
halo post import-json --file ./post.json --force

Markdown 往返：

bash
halo post export-markdown my-post
halo post export-markdown my-post --output ./post.md
halo post import-markdown --file ./post.md --force

规则：

• - --raw-type 默认为 markdown，因此 --content 会被渲染为 Markdown，除非你设置 --raw-type html。
• 直接内联更新时优先使用 --content，或使用 import-markdown 处理 Markdown 文件。
• open 仅适用于已发布的内容；使用 --json 时会返回 URL。
• 导入负载必须包含 post.metadata.name。
• 导入负载必须包含 content.raw 或 content.content。

文章分类

管理文章分类：

bash
halo post category list
halo post category list --keyword Technology
halo post category get category-abc123
halo post category create --display-name Technology --slug tech
halo post category create --display-name News --description Latest news --priority 100
halo post category update category-abc123 --display-name Tech News
halo post category delete category-abc123 --force

文章标签

管理文章标签：

bash
halo post tag list
halo post tag list --keyword Halo
halo post tag get tag-abc123
halo post tag create --display-name Halo --slug halo --color #1890ff
halo post tag update tag-abc123 --display-name Halo CMS
halo post tag delete tag-abc123 --force

单页

列出和查看：

bash
halo single-page list
halo single-page get about --json

创建或更新：

bash
halo single-page create --title About --content # About --publish true
halo single-page create --title About --content

Hello Halo

JSON 往返：

bash
halo single-page export-json about --output ./about.json
halo single-page import-json --file ./about.json --force

规则：

• - 命令名称为 single-page，而非 singlePage。
• 单页不使用文章分类/标签工作流。
• single-page 没有 --pinned 选项。
• 导入负载必须包含 page.metadata.name。

安全与自动化

• - 当存在多个 Halo 配置文件时，使用 --profile <名称>。
• 在脚本中使用 --json。
• 对于破坏性的非交互式命令（如 delete 或覆盖式导入），使用 --force。
• 在目标资源不确定时，先读取当前状态再进行修改。