Hermes 入门指南(六):从安装到开发第一个插件

/opt/data/plugins/            #根目录├── 插件A/                      # 通用插件│   ├── plugin.yaml             # 清单文件，声明插件元数据│   ├── __init__.py             # 注册函数，将 Schema 与处理器绑定│   ├── schemas.py              # 工具描述，定义 LLM 可见的接口│   └── tools.py                # 处理器，工具被调用时实际执行的代码│├── memory/                     # 特殊插件：memory│   └── 插件B/│       ├── plugin.yaml  │       └── __init__.py│└── ......                        

hermes plugins install owner/repo

mkdir -p /opt/data/plugins/hello-world

name: hello-worldversion: "1.0"description: A minimal example plugin with modular structureauthor: Your Name

"""Tool schemas for the hello-world plugin."""def get_hello_world_schema():    """Return the schema for the hello_world tool."""    return {        "name": "hello_world",        "description": "Returns a friendly greeting for the given name.",        "parameters": {            "type": "object",            "properties": {                "name": {                    "type": "string",                    "description": "Name to greet",                }            },            # 必填参数列表（这里 name 是必填的）            "required": ["name"],        },    }

"""Tool handlers for the hello-world plugin."""import jsondef handle_hello_world(params, **kwargs):    # 避免未使用变量警告    del kwargs     # 从 params 中获取 name，如果未提供则默认为 "World"    name = params.get("name", "World")    # 返回 JSON 格式的结果，包含成功标志和问候语    return json.dumps({"success": True, "greeting": f"Hello, {name}!"})

"""Hello World plugin entry point."""from .schemas import get_hello_world_schemafrom .tools import handle_hello_worlddef register(ctx):    """Register the hello-world tool."""    ctx.register_tool(        name="hello_world",          # 工具名称，需与 Schema 中保持一致        toolset="hello_world",       # 工具所属的工具集        schema=get_hello_world_schema(),  # 获取工具 Schema        handler=handle_hello_world,       # 获取工具处理函数        description="Return a friendly greeting for the given name.",    )

# 查看插件状态hermes plugins list# 启用插件hermes plugins enable hello-world