diff --git a/src/posts/plugin/develop.md b/src/posts/plugin/develop.md index 60ae2ef26..0a723f5dc 100644 --- a/src/posts/plugin/develop.md +++ b/src/posts/plugin/develop.md @@ -209,7 +209,7 @@ async def access_web(self, query, url: str): - 这仅仅是一个示例,需要更高效的网络访问能力支持插件,请查看[WebwlkrPlugin](https://github.com/RockChinQ/WebwlkrPlugin) -## 📄API参考 +## 📄名词解释 ### 说明 @@ -218,7 +218,7 @@ async def access_web(self, query, url: str): ### 事件 -若一个事件是一次请求(用户发送消息)中的事件,其事件对象中会含有`query`对象,这个对象中包含了此次请求(即用户发送一条消息的处理过程,一个请求过程可能会触发多个事件)处理过程中的数据。 +若一个事件是一次请求(用户发送消息)中的事件,其事件对象中会含有`query`对象,这个对象中包含了此次请求(即用户发送一条消息的处理过程,一个请求过程可能会触发多个事件)处理过程中的上下文数据。 所有支持的事件,请查看`pkg.plugin.events`文件中的每个事件类的注释。 关于`YiriMirai`支持的消息链组件,请查看 [YiriMirai的文档](https://yiri-mirai.wybxc.cc/docs/basic/message-chain) diff --git a/src/posts/plugin/extension.md b/src/posts/plugin/extension.md index 7d2769eb8..253deacd1 100644 --- a/src/posts/plugin/extension.md +++ b/src/posts/plugin/extension.md @@ -21,14 +21,77 @@ index: false 普通的以 `BasePlugin` 子类包装的插件只能监听预定事件,而组件扩展则可以替换整个组件,实现更强大的功能扩展。 -- 组件扩展不需要包装在 `BasePlugin` 子类中 +- 组件扩展不需要包装在 `BasePlugin` 子类中,可以放在插件目录下任意一个模块中 - 扩展的组件不受插件开关控制 - 扩展的组件通常由配置文件中的选项选用 ## 可扩展的组件 +扩展一个组件的方法,新建一个类,继承于组件的基类,然后在类上使用对应的装饰器,再根据使用方式来配置使用该实现的组件。 + +大部分组件中包含了`ap: pkg.core.app.Application`对象,可以用这个对象来与整个程序的各个部分进行交互。 +大部分组件支持实现`async def initialize(self)`方法,用于在组件加载时进行异步初始化。 +`ap`对象中包含了各个配置文件的管理器对象,可以用于访问各个配置文件。 + ### 命令 +新增一个命令。 + - 基类:`pkg.command.operator.CommandOperator` - 装饰器:`pkg.command.operator.operator_class(name: str, help: str="", usage: str=None, alias: list[str]=[], privilege: int=1, parent_class: typing.Type[CommandOperator] = None)` -- 参考类:`pkg.command.operators/` \ No newline at end of file +- 参考实现:`pkg.command.operators/` +- 使用方式:加载成功后,执行命令`!cmd`可查看所有命令和命令帮助信息。 + +### 内容过滤器 + +新增一个在处理消息前后判断是否要继续的内容处理器。 + +- 基类:`pkg.pipeline.cntfilter.filter.ContentFilter` +- 装饰器:`pkg.pipeline.cntfilter.filter.filter_class(name: str)` +- 参考实现:`pkg.pipeline.cntfilter.filters/` +- 使用方式:加载成功后,每次都会在过滤器实现声明的检查阶段调用内容过滤器的`process`方法。 + +### 长消息处理策略 + +新增一个长消息处理策略。类似:文本转合并转发消息组件、文本转图片。 + +- 基类:`pkg.pipeline.longtext.strategy.LongTextStrategy` +- 装饰器:`pkg.pipeline.longtext.strategy.strategy_class(name: str)` +- 参考实现:`pkg.pipeline.longtext.strategies/` +- 使用方式:需要在 `data/config/platform.json` 的 `long-text-strategy` 字段中将 `strategy` 设置为新增的策略名称。 + +### 会话限速算法 + +新增一个会话限速算法。会话请求在进入和退出时均会调用限速算法实现类的方法,实现类可以控制等待或丢弃请求。 + +- 基类:`pkg.pipeline.ratelimit.algo.RateLimitAlgo` +- 装饰器:`pkg.pipeline.ratelimit.algo.algo_class(name: str)` +- 参考实现:`pkg.pipeline.ratelimit.algos/` +- 使用方式:需要在 `data/config/pipeline.json` 的 `rate-limit` 字段中将 `algo` 设置为新增的算法名称。 + +### LLM 接口请求器 + +新增一个 LLM 接口请求器,例如:接入ChatGLM接口等。 + +- 基类:`pkg.provider.modelmgr.api.LLMAPIRequester` +- 装饰器:`pkg.provider.modelmgr.api.api_requester_class(name: str)` +- 参考实现:`pkg.provider.modelmgr.apis/` +- 使用方式:需要在`data/metadata/llm-models.json`中添加模型,将模型的`requester`字段设置为新增的请求器名称。具体请查看元数据配置板块。 + +### Prompt 加载器 + +新增一个 Prompt 加载器。 + +- 基类:`pkg.provider.sysprompt.loader.PromptLoader` +- 装饰器:`pkg.provider.sysprompt.loader.loader_class(name: str)` +- 参考实现:`pkg.provider.sysprompt.loaders/` +- 使用方式:需要在`data/config/provider.json`将`prompt-mode`设置为新增的加载器名称。 + +### 消息平台适配器 + +新增一个消息平台适配器,例如:接入Telegram等。 + +- 基类:`pkg.platform.adapter.MessageSourceAdapter` +- 装饰器:`pkg.platform.adapter.adapter_class(name: str)` +- 参考实现:`pkg.platform.adapters/` +- 使用方式:`data/config/platform.json`的`platform-adapters`中各个配置信息,将在初始化时自动根据`adapter`名称查找对应的适配器实现,并将配置传递给适配器以进行初始化。消息平台适配器实现复杂,建议多参考现有的实现。