import{_ as i,c as a,a7 as n,o as t}from"./chunks/framework.jrU0lkHV.js";const E=JSON.parse('{"title":"插件开发","description":"","frontmatter":{"title":"插件开发","order":3},"headers":[],"relativePath":"dev/plugin.md","filePath":"zh/dev/plugin.md","lastUpdated":1729881298000}'),h={name:"dev/plugin.md"};function p(l,s,e,k,d,r){return t(),a("div",null,s[0]||(s[0]=[n(`

简介 ​

轻雪插件是轻雪内置的一部分功能，运行在主进程中，可以很高程度地扩展轻雪的功能

插件大致可分为应用(Application)、实现(Implementation)及服务(Service)等几种类型，大部分情况下一个插件通常承担着多个责任，可按需调整

应用：从总线通道接收到消息后进行处理，响应，以实现某些功能，例如echo

实现：对接特定平台，把平台的消息转换为轻雪消息格式传入总线通道

服务：提供一系列对外的ipc/rpc/http等服务，供其他插件调用

我们鼓励使用magicoca进行对象传递来进行插件间通信而不是依赖关系，这样可以避免很多潜在的问题。

开始 ​

创建插件 ​

一个.py文件或一个包含__init__.py的文件夹即可被识别为插件

首先创建一个文件夹，例如watchdog_plugin，并在其中创建一个__init__.py文件，即可创建一个插件

__init__.py

python
from liteyuki.plugin import PluginMetadata, PluginType
from .watch_dog import *    # 导入逻辑部分

# 定义插件元数据
__plugin_meta__ = PluginMetadata(
    name="NoneDog",  # 插件名称
    version="1.0.0",  # 插件版本
    description="A simple plugin for nonebot developer",  # 插件描述
    type=PluginType.SERVICE  # 插件类型
)

# 你的插件代码
...

编写逻辑部分 ​

轻雪主进程不涉及聊天部分，因此插件主要是一些后台任务或者与聊天机器人的通信 以下我们会编写一个简单的插件，用于开发NoneBot时进行文件系统变更重载 watch_dog.py

python
import os
from liteyuki.dev import observer  # 导入文件系统观察器
from liteyuki import get_bot, logger  # 导入轻雪Bot和日志
from watchdog.events import FileSystemEvent  # 导入文件系统事件

liteyuki = get_bot()  # 获取唯一的轻雪Bot实例

exclude_extensions = (".pyc", ".pyo")  # 排除的文件扩展名


# 用observer的on_file_system_event装饰器监听文件系统事件
@observer.on_file_system_event(
    directories=("src/nonebot_plugins",),
    event_filter=lambda event: not event.src_path.endswith(exclude_extensions) and ("__pycache__" not in event.src_path) and os.path.isfile(event.src_path)
)
def restart_nonebot_process(event: FileSystemEvent):
    logger.debug(f"File {event.src_path} changed, reloading nonebot...")
    liteyuki.restart_process("nonebot")  # 调用重启进程方法

加载插件 ​

方法1 ​

方法2 ​

python
from liteyuki.dev.plugin import run_plugins

run_plugins("watchdog_plugin")

然后运行python main.py即可启动插件

启用插件后，我们在src/nonebot_plugins下创建一个文件，例如test.py，并在其中写入一些代码，保存后轻雪会自动重载NoneBot进程

`,24)]))}const g=i(h,[["render",p]]);export{E as __pageData,g as default};