ProjectHentai/nonebot2

mirror of https://github.com/nonebot/nonebot2.git synced 2024-12-18 09:25:46 +08:00

跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python

bot chatbot cqhttp dingtalk-robot fastapi lark-bot mirai-bot nonebot nonebot2 onebot python qq qq-guild telegram-bot

Go to file

yanyongyu feadffebcd 🔀 Merge master into dev		2022-01-01 00:01:25 +08:00
.github	👷 update ci version	2021-12-30 23:29:32 +08:00
docs_build	📝 update choose driver doc	2021-12-27 15:29:34 +08:00
nonebot	🚧 add handler di example	2021-12-31 23:58:59 +08:00
packages/nonebot-plugin-docs	🎨 add store components	2021-12-29 21:09:36 +08:00
tests	🐛 fix matcher got receive type error	2021-12-31 22:43:29 +08:00
website	🚧 add handler di example	2021-12-31 23:58:59 +08:00
.editorconfig	🏷️ Add typing for cqhttp api	2020-08-26 17:47:36 +08:00
.gitignore	👷 update doc ci	2021-12-02 03:17:10 +08:00
.prettierignore	✏️ fix issue template typo	2020-11-13 11:31:24 +08:00
.prettierrc	🎨 improve format	2021-04-05 16:35:29 +08:00
.yarnrc	⬆️ update theme version	2021-12-02 15:00:55 +08:00
CHANGELOG.md	📝 update homepage	2021-12-03 16:21:24 +08:00
LICENSE	📄 update license	2020-12-01 10:57:00 +08:00
package.json	⬆️ update theme version	2021-12-02 15:00:55 +08:00
poetry.lock	🐛 fix matcher got receive type error	2021-12-31 22:43:29 +08:00
pyproject.toml	⚗️ new driver combine expr support	2021-12-23 17:20:26 +08:00
README.md	📝 add codecov badge	2021-12-27 13:26:34 +08:00
yarn.lock	🚧 add modal	2021-12-31 02:06:20 +08:00

README.md

NoneBot

✨ 跨平台 Python 异步机器人框架 ✨

文档 · 安装 · 开始使用 · 文档打不开？

简介

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

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

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

特色

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

目前 NoneBot2 内置的驱动框架：

FastAPI
Quart (异步 Flask)
aiohttp
httpx
websockets

目前 NoneBot2 官方维护的协议适配：

更多：商店

即刻开始

完整文档可以在这里查看。

懒得看文档？下面是快速安装指南：

(可选)使用你喜欢的 Python 环境管理工具创建新的虚拟环境。
使用 pip (或其他) 安装 NoneBot 脚手架。
```
pip install nb-cli
```
使用脚手架创建项目
```
nb create
```

社区资源

常见问题

常见问题解答(FAQ)

教程/实际项目/经验分享

awesome-nonebot

插件

此外，NoneBot2 还有丰富的官方以及第三方现成的插件供大家使用：

NoneBot-Plugin-Docs：离线文档至本地使用(别再说文档打不开了！)
```
nb plugin install nonebot_plugin_docs
```
或者尝试以下镜像：
- 文档镜像(中国境内)
- 文档镜像(Vercel)
其他插件请查看商店

许可证

NoneBot 采用 MIT 协议开源，协议文件参考 LICENSE。

贡献

如果你在使用过程中发现任何问题，可以提交 Issue 或自行 Fork 修改后提交 Pull Request。

如果你要提交 Pull Request，请确保你的代码风格和项目已有的代码保持一致，遵循 PEP 8 与 PEP 484，变量命名清晰，有适当的注释，并且请以 dev 分支作为 Pull Request 目标分支。

感谢以下开发者对 NoneBot2 的贡献：