第10篇:内置插件——开箱即用的增强包
Hermes 功能详解第10篇:内置插件。官方预装的高质量插件,每个都是实用小工具。
这篇讲的是 Hermes Agent 自带的一批“官方插件”,它们就像手机出厂预装的应用,功能实用但默认不开启,需要你亲手点亮。
先搞懂:插件从哪来?
Hermes 会按顺序在 4 个地方找插件:① 官方内置(随仓库下载)、② 你自己装的(~/.hermes/plugins/)、③ 项目专用(需设置环境变量)、④ 通过 pip 安装的。如果名字撞了,后找到的会覆盖先找到的——比如你装了个同名插件,就能替换官方版。
重点:内置插件默认全是关的,不会自动启用。想用哪个,手动开一下就行。
第1步:启用一个内置插件
打开终端,输入:
hermes plugins enable disk-cleanup
或者编辑配置文件 ~/.hermes/config.yaml,加上:
plugins:
enabled:
- disk-cleanup
想关掉就输入 hermes plugins disable disk-cleanup,或者从配置文件里删掉。
第2步:认识几个明星插件
官方目前带了 11 个插件,我挑几个最常用的说:
-
disk-cleanup(磁盘清洁工):自动跟踪并清理会话中产生的临时文件(测试脚本、临时输出、旧日志等)。它像个细心的管家,每次会话结束自动打扫,但只碰自己跟踪过的文件,绝不乱删。你还可以用
/disk-cleanup status查看状态,/disk-cleanup dry-run预览要删什么,/disk-cleanup deep做深度清理。 -
security-guidance(安全卫士):当 AI 写代码时,如果碰到危险模式(比如
eval()、os.system、不安全的yaml.load),它会在结果里追加一条安全警告。默认只警告不拦截——文件照常写入,但 AI 会看到提醒并自行修正。想改成硬拦截,设置环境变量SECURITY_GUIDANCE_BLOCK=1即可。 -
observability/langfuse(监控仪表盘):把 AI 的每次对话、每次调用工具、每次请求大模型,都记录到 Langfuse 平台。你可以在网页上看到每次对话花了多少 token、多少钱,像查话费账单一样清楚。
-
spotify(音乐播放器):给 AI 装上 7 个音乐工具,能搜索、播放、管理歌单和专辑。你可以直接对 AI 说“放点爵士乐”,它就真能放出来。
-
google_meet(会议助手):能自动加入 Google Meet 会议,实时生成字幕和会议纪要。
第3步:查看插件列表
输入 hermes plugins list 就能看到所有可用插件,包括哪些已启用、哪些还没开。
小总结
内置插件 = 官方帮你写好的增强功能,按需开启、即开即用。建议先试 disk-cleanup 和 security-guidance,一个省心一个安全,性价比最高。
下篇预告:插件虽好,但怎么自己写一个?下一篇我们聊聊如何从零构建你的第一个 Hermes 插件。
📖 官方文档
本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/checkpoints-and-rollback