nonebot2/website/versioned_docs/version-2.0.1/api/plugin/plugin.md
2023-09-27 16:00:26 +08:00

135 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
sidebar_position: 3
description: nonebot.plugin.plugin 模块
slug: /api/plugin/plugin
---
# nonebot.plugin.plugin
本模块定义插件相关信息。
## _class_ `PluginMetadata(<auto>)` {#PluginMetadata}
- **说明:** 插件元信息,由插件编写者提供
- **参数**
auto
### _instance-var_ `name` {#PluginMetadata-name}
- **类型:** str
- **说明:** 插件名称
### _instance-var_ `description` {#PluginMetadata-description}
- **类型:** str
- **说明:** 插件功能介绍
### _instance-var_ `usage` {#PluginMetadata-usage}
- **类型:** str
- **说明:** 插件使用方法
### _class-var_ `type` {#PluginMetadata-type}
- **类型:** str | None
- **说明:** 插件类型,用于商店分类
### _class-var_ `homepage` {#PluginMetadata-homepage}
- **类型:** str | None
- **说明:** 插件主页
### _class-var_ `config` {#PluginMetadata-config}
- **类型:** type[BaseModel] | None
- **说明:** 插件配置项
### _class-var_ `supported_adapters` {#PluginMetadata-supported-adapters}
- **类型:** set[str] | None
- **说明**
插件支持的适配器模块路径
格式为 `<module>[:<Adapter>]``~` 为 `nonebot.adapters.` 的缩写。
`None` 表示支持**所有适配器**。
### _class-var_ `extra` {#PluginMetadata-extra}
- **类型:** dict[Any, Any]
- **说明:** 插件额外信息,可由插件编写者自由扩展定义
### _method_ `get_supported_adapters()` {#PluginMetadata-get-supported-adapters}
- **说明:** 获取当前已安装的插件支持适配器类列表
- **参数**
empty
- **返回**
- set[type[[Adapter](../adapters/index.md#Adapter)]] | None
## _class_ `Plugin(<auto>)` {#Plugin}
- **说明:** 存储插件信息
- **参数**
auto
### _instance-var_ `name` {#Plugin-name}
- **类型:** str
- **说明:** 插件索引标识NoneBot 使用 文件/文件夹 名称作为标识符
### _instance-var_ `module` {#Plugin-module}
- **类型:** ModuleType
- **说明:** 插件模块对象
### _instance-var_ `module_name` {#Plugin-module-name}
- **类型:** str
- **说明:** 点分割模块路径
### _instance-var_ `manager` {#Plugin-manager}
- **类型:** [PluginManager](manager.md#PluginManager)
- **说明:** 导入该插件的插件管理器
### _class-var_ `matcher` {#Plugin-matcher}
- **类型:** set[type[[Matcher](../matcher.md#Matcher)]]
- **说明:** 插件加载时定义的 `Matcher`
### _class-var_ `parent_plugin` {#Plugin-parent-plugin}
- **类型:** Plugin | None
- **说明:** 父插件
### _class-var_ `sub_plugins` {#Plugin-sub-plugins}
- **类型:** set[Plugin]
- **说明:** 子插件集合