Madoka
一个基于 Graia 和 Mirai 的快速、可配置、可自定义插件的 QQ 机器人
只要将想要守护的事物一直守护到底就好了。
Madoka 是一个非盈利的开源项目，仅供交流学习使用。请勿用于商业或非法用途，因使用而与腾讯公司产生的一切纠纷均与原作者无关。
Build Setup
# install dependencies
$ pip install -r requirements.txt
# Start the mirai service and Configuration profile
# Run on the server
$ screen -S qq-bot
$ python main.py部署流程
请查看文档: https://madoka.colsrch.cn/doc/
项目版本管理
项目目录结构说明
madoka
├── app ······················· 程序主体
│ ├── console ··············· 控制台模块
│ ├── core ·················· 核心模块
│ │ ├── app.py ············ 应用主体
│ │ ├── commander.py······· 命令委托管理器
│ │ ├── config.py ········· 系统配置读取器
│ │ ├── env.config.ini ···· 示例系统配置文件
│ │ └── settings.py ······· 在线配置文件
│ ├── entities ·············· 实体模块
│ │ ├── game.py ··········· 游戏实体
│ │ ├── group.py ·········· 群实体
│ │ └── user.py ··········· 用户实体
│ ├── event ················· 事件模块
│ ├── extend ················ 扩展模块
│ ├── plugin ················ 插件模块
│ ├── resource ·············· 资源目录
│ ├── trigger ··············· 预处理模块
│ └── util ·················· 工具模块
│ ├── control.py ········ 管理工具
│ ├── cut_string.py ····· 字符串断行工具
│ ├── dao.py ············ 数据库访问接口
│ ├── decorator.py ······ 装饰器存放处
│ ├── msg.py ············ 消息存储接口
│ ├── network.py ········ 网络工具
│ ├── online_config.py ·· 在线配置工具
│ ├── other.py ·········· 其他工具
│ ├── phrases.py ········ 快捷回复消息
│ ├── send_message.py ··· 发送消息函数
│ ├── text2image.py ····· 文本转图片工具
│ └── tools.py··········· 工具函数
├── CHANGELOG.md ·············· 更新日志
├── k8s ······················· Kubernetes 配置
├── main.py ··················· 应用执行入口
├── requirements.txt ·········· 项目依赖
└── README.md ················· 项目介绍
说明
请勿将其用于商业或非法用途。
相关项目
- Madoka: Madoka 主体
- Plugins: Madoka 的官方插件库（你也可以提交 PR 来丰富此插件库）
- Web: 机器人 Web 控制系统(计划中)
- Loader: 懒人工具(或许有？)
依赖
mirai: 即mirai-core, 一个高性能, 高可扩展性的 QQ 协议库mirai-console-loader: 模块化、轻量级且支持完全自定义的mirai加载器。mirai-console: 一个基于mirai开发的插件式可扩展开发平台mirai-api-http: 提供与mirai交互方式的mirai-console插件Graia Ariadne: 一个设计精巧, 协议实现完备的, 基于mirai-api-http v2的即时聊天软件自动化框架.Arclet-Alconna: 一个直观的、高性能、泛用的命令行参数解析器集成库