nonebot2/docs/guide
Xiaowei Zhou c99e1880d3
[Doc] Update: Onebot-Kotlin rename
Update: cqhttp-mirai / cqhttp-mirai-embedded has been renamed to Onebot-Mirai / Onebot-Kotlin by its author [yyuueexxiinngg](https://github.com/yyuueexxiinngg). Since the embedded branch was abandoned, both links here point to master branch of [onebot-kotlin](https://github.com/yyuueexxiinngg/onebot-kotlin).
2021-05-12 08:54:19 +08:00
..
images ding: send by webhook 2021-03-11 13:26:16 +08:00
basic-configuration.md 📝 update doc 2021-02-02 21:55:18 +08:00
cqhttp-guide.md [Doc] Update: Onebot-Kotlin rename 2021-05-12 08:54:19 +08:00
creating-a-handler.md 📝 Update creating-a-handler.md 2021-01-01 19:23:51 +08:00
creating-a-matcher.md 📝 update how to work doc 2021-02-26 17:00:38 +08:00
creating-a-plugin.md 📝 recommend pylance 2021-04-13 00:24:49 +08:00
creating-a-project.md 🎨 improve format 2021-04-05 16:35:29 +08:00
ding-guide.md 🎨 format files 2021-04-05 13:49:01 +08:00
end-or-start.md 📝 update doc and chqnglog 2021-03-20 16:38:42 +08:00
getting-started.md 📝 docs grammar 2021-02-02 19:45:17 +08:00
installation.md 🐛 fix store link 2021-05-03 14:10:12 +08:00
loading-a-plugin.md 📝 update doc 2021-05-01 10:53:18 +08:00
mirai-guide.md 📝 remove redundant characters 2021-03-07 18:12:14 +08:00
README.md 📝 docs grammar 2021-02-02 19:45:17 +08:00

概览

:::tip 提示 初次使用时可能会觉得这里的概览过于枯燥,可以先简单略读之后直接前往 安装 查看安装方法,并进行后续的基础使用教程。 :::

NoneBot2 是一个可扩展的 Python 异步机器人框架,它会对机器人收到的事件进行解析和处理,并以插件化的形式,按优先级分发给事件所对应的事件响应器,来完成具体的功能。

除了起到解析事件的作用NoneBot 还为插件提供了大量实用的预设操作和权限控制机制。对于命令处理,它更是提供了完善且易用的会话机制和内部调用机制,以分别适应命令的连续交互和插件内部功能复用等需求。

得益于 Python 的 asyncio 机制NoneBot 处理事件的吞吐量有了很大的保障,再配合 WebSocket 通信方式也是最建议的通信方式NoneBot 的性能可以达到 HTTP 通信方式的两倍以上,相较于传统同步 I/O 的 HTTP 通信,更是有质的飞跃。

需要注意的是NoneBot 仅支持 Python 3.7+

特色

NoneBot2 的驱动框架 Driver 以及通信协议 Adapter 均可自定义,并且可以作为插件进行替换/添加

  • 提供使用简易的脚手架
  • 提供丰富的官方插件
  • 提供可添加/替换的驱动以及协议选项
  • 基于异步 I/O
  • 同时支持 HTTP 和反向 WebSocket 通信方式
  • 支持多个机器人账号负载均衡
  • 提供直观的交互式会话接口
  • 提供可自定义的权限控制机制
  • 多种方式渲染要发送的消息内容,使对话足够自然