用途:在终端管理 Halo 的文章(post)与独立页面(single-page),涵盖创建、更新、查看、打开、删除、导出与导入。使用前需先阅读 ../halo-shared/SKILL.md,了解安装、认证、profile 选择、--json 与安全规则。
主要能力:文章命令为 halo post <command>,独立页面为 halo single-page <command>,两者均支持 list、get、open、create、update、delete、export-json、import-json。多数命令支持 --profile <name> 选择配置,--json 输出机器可读结果。
用法要点:创建文章示例 halo post create --title "Hello Halo" --content-file ./post.md --publish true;内容可用 --content 或 --content-file,真实文档建议用后者,不要同时传。更新用 halo post update my-post --title "Updated title",重命名用 --new-name。删除在非交互场景需加 --force。导出默认路径为 ./<name>.json,导入支持 --file 或 --raw,已存在时用 --force 覆盖。open 仅在内容有已发布永久链接时可用,JSON 模式下返回解析后的 URL。
独立页面差异:命令是 halo single-page,不是 singlePage;没有分类/标签流程,也没有 --pinned 选项。
导入 JSON 结构:文章为 {"post":{"metadata":{"name":"my-post"},"spec":{"publish":true}},"content":{"raw":"# Hello Halo","content":"<h1>Hello Halo</h1>","rawType":"markdown"}};独立页面将 post 换成 page。metadata.name 必填,content.raw 或 content.content 至少存在一个。
适用场景:脚本化内容发布、批量导出导入、CI 中管理 Halo 内容。
限制与注意:多 profile 时需显式指定 --profile;未发布内容无法 open;导入格式错误会失败;非交互删除需 --force;不确定支持范围时用 halo post --help、halo single-page --help 等查看帮助。