插件快速开始

第一步：创建插件目录

mkdir -p plugin/plugins/hello_world

第二步：创建 plugin.toml

[plugin]
id = "hello_world"
name = "Hello World Plugin"
description = "A simple example plugin"
version = "1.0.0"
entry = "plugins.hello_world:HelloWorldPlugin"

[plugin.sdk]
recommended = ">=0.1.0,<0.2.0"
supported = ">=0.1.0,<0.3.0"

配置字段

字段	是否必需	说明
id	是	唯一插件标识符
name	否	显示名称
description	否	插件描述
version	否	插件版本
entry	是	入口点：module_path:ClassName

SDK 版本字段

字段	说明
recommended	推荐的 SDK 版本范围
supported	最低支持范围（不满足则拒绝加载）
untested	允许但加载时会发出警告
conflicts	拒绝的版本范围

第三步：创建 __init__.py

from plugin.sdk.base import NekoPluginBase
from plugin.sdk.decorators import neko_plugin, plugin_entry
from typing import Any

@neko_plugin
class HelloWorldPlugin(NekoPluginBase):
    """Hello World plugin example"""

    def __init__(self, ctx: Any):
        super().__init__(ctx)
        self.logger = ctx.logger
        self.logger.info("HelloWorldPlugin initialized")

    @plugin_entry(
        id="greet",
        name="Greet",
        description="Return a greeting message",
        input_schema={
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Name to greet",
                    "default": "World"
                }
            }
        }
    )
    def greet(self, name: str = "World", **_):
        """Greeting function"""
        message = f"Hello, {name}!"
        self.logger.info(f"Greeting: {message}")
        return {
            "message": message
        }

第四步：测试

启动插件服务器后，通过 HTTP 调用你的插件：

curl -X POST http://localhost:48916/plugin/trigger \
  -H "Content-Type: application/json" \
  -d '{
    "plugin_id": "hello_world",
    "entry_id": "greet",
    "args": {"name": "N.E.K.O"}
  }'

下一步

• SDK 参考 — 了解 NekoPluginBase 和 PluginContext
• 装饰器 — 所有可用的装饰器类型
• 示例 — 完整的可运行插件示例