hermes plugins 命令 — 完整参考与示例

概述

hermes plugins 管理 Hermes Agent 插件 — 从 Git 仓库安装、可扩展 Agent 功能的模块。你可以安装、更新、移除、列出、启用和禁用插件。

用法

hermes plugins [-h] {install,update,remove,rm,uninstall,list,ls,enable,disable} ...

子命令

install <来源>

从 Git URL 或 owner/repo 安装插件。

hermes plugins install owner/repo
hermes plugins install https://github.com/owner/hermes-plugin.git

update [名称]

拉取已安装插件的最新变更。不指定名称时，更新所有已安装插件。

hermes plugins update my-plugin
hermes plugins update

remove / rm / uninstall <名称>

移除已安装的插件。三个名称是同一操作的不同别名。

hermes plugins remove my-plugin
hermes plugins rm my-plugin
hermes plugins uninstall my-plugin

list / ls

列出已安装的插件。ls 是 list 的别名。

hermes plugins list
hermes plugins ls

enable <名称>

启用已禁用的插件。

hermes plugins enable my-plugin

disable <名称>

禁用插件但不移除它。

hermes plugins disable my-plugin

示例

# 列出已安装的插件
hermes plugins list

# 从 GitHub 仓库安装插件
hermes plugins install owner/hermes-plugin

# 更新所有已安装的插件
hermes plugins update

# 禁用有问题的插件
hermes plugins disable my-plugin

# 稍后重新启用
hermes plugins enable my-plugin

# 彻底移除插件
hermes plugins remove my-plugin

技巧

• 插件从 Git 仓库安装，没有集中式注册中心。
• 排查问题时，禁用比移除更安全 — 插件仍然保留安装状态，可以立即重新启用。
• 定期更新插件，以获得错误修复和兼容性改进。
• 被禁用的插件不会加载，因此不会影响启动或行为。
• 安装或启用插件后，需要开启新会话（或重启网关）才会生效。