HoshinoBot 是一款 QQ 群应答机器人框架,在 nonebot 框架的基础上进一步提供了更优秀的封装,大大方便了开发者和使用者。
本文档为社区文档,是对官方文档的做出一些更方便初学者阅读的说明。
HoshinoBot 部署完成后,我们可以在 hoshino/modules
目录下创建一个新的文件夹,作为功能模块
cd hoshino/modules
mkdir my_module
在这个模块下,创建一个新的插件文件
cd my_module
vi hello.py
编写一点内容
from hoshino import Service
sv = Service('hello')
@sv.on_fullmatch('你好')
async def hello(bot, ev):
await bot.send(ev, '你好,世界!')
然后编辑 HoshinoBot/config/__bot__.py
来启用这个新的模块
# 前略
MODULES_ON = {
# 前略
'my_module', # 添加新的功能模块名称到这里
}
现在,重新启动 hoshino,对机器人说一声 你好
吧!
HoshinoBot 内文件分布如下:
/hoshino/modules
模块目录,每个文件夹是一组插件构成的模块
/hoshino/config
配置目录,每个.py
文件是同名模块的配置项
/hoshino/modules/<my_module>
模块内容,每个文件或目录是一个 python 模块,*.py
文件和目录下的__init__.py
文件会被加载为模块插件
HoshinoBot 封装了很多高级用法,使得编写插件非常简单
服务层:分群、分权限的管理插件
触发器:多种消息触发方式
计划任务:定时执行任务,在运行时动态调整任务,持久化储存任务
资源管理:轻松管理图片、语言资源,简单地合成图片并发送
为了编写 Hoshino 插件,请学习 python 至协程部分
为了向 HoshinoBot 项目提交代码,请学习使用 Git 管理项目源码