SuperAPI AI 工具集

halo-cli-shared

办公与效率

查看项目

更新于 10-15 22:11

技能介绍

用途:当任务提到“使用 Halo CLI”但未指明是认证、内容、搜索、运维还是审核时,从本技能开始,提供共享规则与命令区域路由。

安装与验证:全局安装 npm install -g @halo-dev/cli,二进制名为 halo。可用 halo --version 与 halo --help 检查版本和顶层帮助。

顶层命令区域:auth、post、single-page、search、plugin、theme、attachment、backup、moment、comment、notification,以及 completion <shell>(生成 bash、zsh、fish、powershell 补全脚本)。

共享规则:多数命令区域需要已认证的 profile,使用 halo auth login 创建;存在多个 profile 时用 --profile <name> 指定;输出供自动化或后续解析时用 --json;非交互模式下危险命令通常需要 --force;对具体命令应先读 --help 再猜测参数。

公开与认证:多数区域需要认证;主要公开工作流是 halo search,可直接使用站点 URL 而无需登录,例如 halo search --keyword "halo" --url https://www.halo.run。

配置与密钥:profile 元数据存储位置依次为 $HALO_CLI_CONFIG_DIR/config.json(若设置了 HALO_CLI_CONFIG_DIR)、$XDG_CONFIG_HOME/halo/config.json、~/.config/halo/config.json;凭据存储在系统密钥环中。

路由:登录、当前 profile、profile 列表/切换/删除及凭据修复使用 halo-cli-auth;文章与单页使用 halo-cli-content;公开站点搜索使用 halo-cli-search;主题、插件、附件、备份与瞬间使用 halo-cli-operations;评论、回复与通知使用 halo-cli-moderation-notifications。

限制:资料未提供各命令的具体参数细节、错误处理、版本兼容范围及收费信息,需查阅对应子技能或 --help。