Halo CLI 操作

使用此技能处理 halo theme、halo plugin、halo attachment、halo backup 和 halo moment 命令。

命令

bash
halo theme --help
halo plugin --help
halo attachment --help
halo backup --help
halo moment --help

主题

bash
halo theme list
halo theme current
halo theme get <名称>
halo theme install --file ./theme.zip
halo theme install --url https://example.com/theme.zip
halo theme activate <名称>
halo theme reload <名称>
halo theme upgrade <名称>
halo theme upgrade --all
halo theme delete <名称> --force

规则：

• - theme list 在表格输出中标记当前激活的主题。
• 本地主题安装使用 --file 参数。
• 当远程主机不是 www.halo.run 时，theme install --url 和 theme upgrade --url 会提示确认；在自动化或其他非交互式运行中使用 --yes 跳过该提示。
• upgrade --all 用于支持应用商店感知的升级，而非直接通过 --file 或 --url 源进行。

插件

bash
halo plugin list
halo plugin get <名称>
halo plugin install --file ./plugin.jar
halo plugin install --url https://example.com/plugin.jar
halo plugin enable <名称>
halo plugin disable <名称> --force
halo plugin upgrade <名称>
halo plugin upgrade --all
halo plugin uninstall <名称> --force

规则：

• - 插件升级可使用应用商店感知逻辑。
• 当远程主机不是 www.halo.run 时，plugin install --url 和 plugin upgrade --url 会提示确认；在自动化或其他非交互式运行中使用 --yes 跳过该提示。
• 将 disable、upgrade 和 uninstall 视为变更操作。

附件

bash
halo attachment list
halo attachment get <名称>
halo attachment upload --file ./image.png
halo attachment upload --url https://example.com/image.png
halo attachment download <名称> --output ./downloads/image.png
halo attachment delete <名称> --force

规则：

• - 仅使用一个上传源：--file 或 --url。
• 在 TTY 模式下，上传和下载会显示进度，除非启用了 --json 参数。

备份

bash
halo backup list
halo backup get <名称>
halo backup create
halo backup create --wait
halo backup create --wait --wait-timeout 300
halo backup download <名称> --output ./backup.zip
halo backup delete <名称> --force

规则：

• - backup create --wait 会轮询直到完成或超时。

动态

bash
halo moment list
halo moment get <名称>
halo moment create --content 来自 Halo CLI 的问候
halo moment update <名称> --content 已更新的内容
halo moment delete <名称> --force

有用的选项包括 --visible、--tags 以及与发布时间相关的标志。

安全与自动化

• - 使用 --profile <名称> 指定目标环境。
• 当其他工具需要结构化输出时使用 --json 参数。
• 对破坏性的非交互式操作使用 --force 参数。
• 在执行批量或破坏性维护前，优先使用 list 或 get 命令。