第9篇：插件系统——无限扩展 Hermes

这篇讲的是：如何像给手机装App一样，给 Hermes 装上各种“插件”，让它学会新技能。

想象一下，Hermes 是一台刚出厂的智能手机，自带电话、短信等基础功能。而插件系统，就是它的“应用商店”——你想让它会画画、会查天气、会连 Discord，都不用改手机本身，装个“App”就行。

插件长什么样？

一个插件就是一个文件夹，里面放着“说明书”（plugin.yaml）和“程序代码”（.py 文件）。你只要把这个文件夹放进 Hermes 的“插件安装目录”（~/.hermes/plugins/），重启 Hermes，新技能立刻生效。

第1步：创建插件文件夹

在你的用户目录下，找到或创建 ~/.hermes/plugins/ 文件夹。每个插件独占一个子文件夹，比如 hello-world。

第2步：写“说明书”（plugin.yaml）

用记事本新建一个 plugin.yaml，告诉 Hermes 这个插件叫什么、是干嘛的：

name: hello-world
version: "1.0"
description: 一个打招呼的示例插件

第3步：写“程序代码”（init.py）

这是插件的核心。里面做两件事：注册工具（让模型能调用新功能）和注册钩子（在某个事件发生后自动执行动作）。官方示例里，hello_world 工具会向指定名字问好；钩子则会在每次工具被调用时，在后台打印一行日志。

第4步：重启并启用

重启 Hermes，模型就能立刻使用 hello_world 这个新工具了。但注意：插件默认是“禁用”状态，防止陌生代码随意运行。你需要手动“点亮”它。

第5步：启用插件（关键！）

打开配置文件 ~/.hermes/config.yaml，在 plugins 部分加上插件名：

plugins:
  enabled:
    - hello-world

或者用命令更省事：

hermes plugins enable hello-world

插件还能做什么？

不止是加工具。表格里列出的能力很丰富，挑几个常用的：

• 加斜杠命令：在聊天框输入 /mycommand 就能触发。
• 加 CLI 命令：在终端里用 hermes 插件名 子命令 操作。
• 注入消息：让插件主动给对话“插话”。
• 打包技能：把一套提示词打包成技能，用 plugin:skill 方式调用。
• 接入新平台：让 Hermes 连上 Discord、Telegram 等聊天软件。

安全提示：项目插件默认关闭

放在项目文件夹 .hermes/plugins/ 里的插件，默认不加载。只有当你明确信任某个项目时，才设置环境变量 HERMES_ENABLE_PROJECT_PLUGINS=true 再启动。永远不要轻易启用不信任来源的插件。

小总结

插件系统让 Hermes 从“好用”变成“万能”。你不需要懂底层代码，只要会建文件夹、写两行配置，就能给它无限扩展新能力。记住三步：放对位置、写好清单、启用开关。

下篇预告：插件装好了，怎么让 Hermes 记住长期信息？下一篇我们聊聊“记忆系统”，让 AI 真正“记得你”。