arctanln2 / Application

一个设计精巧, 协议实现完备的, 基于 mirai-api-http 的即时聊天软件自动化框架.

Graia Application for mirai-api-http

当前最新版本:
所需求的最低 CPython 版本:
已确认可以在其上运行的 Python 实现:

开始使用

文档地址: https://graia-document.vercel.app/

Tencent QQ 交流群: 邀请链接

Discussion: https://github.com/GraiaProject/Application/discussions

从 Pypi 安装

pip install graia-application-mirai
# 或使用 poetry
poetry add graia-application-mirai

从 Github 安装

pip install poetry
git clone https://github.com/GraiaProject/Application graia-app
cd graia-app
poetry install

作出贡献

Graia Framework 欢迎一切形式上的贡献(包括但不限于 Issues, Pull Requests, Good Idea 等)
我们希望能有更多优秀的开发者加入到对项目的贡献上来. 你的 Star 是对我们最大的支持和鼓励.

我们在这里写了你在贡献本项目及 Graia Project 时所可能需要注意的事项.

若你在使用的过程中遇到了问题, 欢迎提出聪明的问题, 也请不要使用糟糕的方式提问, 我们希望有人能让这个项目变得更好.

若在使用时发现了本项目的问题, 先检查文档中是否有提及这一情况, 若没有, 你可以在我们的问题追踪器处提出问题, 我们会尽快解决你发现的问题.

你也可以通过 Discussion/QQ 群等方式获取帮助，现在我们更推荐使用 Discussion.

若使用中发现了并非本项目导致的问题, 请先向其他项目汇报问题, 当然, 记得通知我.

鸣谢&相关项目

这些项目也很棒, 去他们的项目页看看, 点个 Star 以鼓励他们的开发工作, 毕竟没有他们也没有 Graia Framework.

特别感谢 mamoe 给我们带来这些精彩的项目:

• mirai: 即 mirai-core, 一个高性能, 高可扩展性的 QQ 协议库
• mirai-console: 一个基于 mirai 开发的插件式可扩展开发平台
• mirai-api-http: 为本项目提供与 mirai 交互方式的 mirai-console 插件

Graia Application 同样还关联了其他 Graia Project 下的项目:

• Broadcast Control: 扩展性强大, 模块间低耦合, 高灵活性的事件系统支持
• Components: 简单的信息链元素选择器
• Template: 消息模板支持

作为学习目的, 我们以个人名义重新以 AGPL-3.0 开源了 python-mirai, 即 Graia Application 的前身, 希望能为社区的发展助力:

• python-mirai: 接口简洁, 支持 mirai-api-http 约 v1.6.x 版本. 一切的开始.

也感谢所有基于本项目开发的各位开发者, 请积极向上游项目反馈问题.

许可证

我们使用 GNU AGPLv3 作为本项目的开源许可证.