<div align="center">
# Ariadne
_Another elegant framework for mirai and mirai-api-http v2._
> 接受当下, 面向未来.
[](https://pypi.org/project/graia-ariadne)
[](https://pypi.org/project/graia-ariadne)
[](https://github.com/psf/black)
[](https://pycqa.github.io/isort/)
[](https://github.com/GraiaProject/Ariadne/blob/master/LICENSE)
[](https://pdm.fming.dev)
|文档|[](https://graia.readthedocs.io/)|[](https://graia.netlify.app/)|[](https://graia.pages.dev/)|
|:-:|:-:|:-:|:-:|
|API 参考|[](https://graia.readthedocs.io/projects/ariadne)|[](https://graia-ariadne.netlify.app/)|[](https://graia-ariadne.pages.dev/)|
|:-:|:-:|:-:|:-:|
</div>
**本项目适用于 mirai-api-http 2.0 以上版本**.
Ariadne 是 `Graia Project` 继承了 [`Application`](https://github.com/GraiaProject/Application) 并进行了许多改进后产生的作品,
相信它可以给你带来良好的 `Python QQ Bot` 开发体验.
**注意, 本框架需要 [`mirai-api-http v2`](https://github.com/project-mirai/mirai-api-http).**
## 安装
`pdm add graia-ariadne`
或
`poetry add graia-ariadne`
或
`pip install graia-ariadne`
> 我们强烈建议使用 [`pdm`](https://pdm.fming.dev) / [`poetry`](https://python-poetry.org) 进行包管理
## 开始使用
```python
from graia.ariadne.app import Ariadne
from graia.ariadne.connection.config import config
from graia.ariadne.model import Friend
app = Ariadne(config(verify_key="ServiceVerifyKey", account=123456789))
@app.broadcast.receiver("FriendMessage")
async def friend_message_listener(app: Ariadne, friend: Friend):
await app.send_message(friend, "Hello, World!")
Ariadne.launch_blocking()
```
更多信息请看
[](https://graia.readthedocs.io/ariadne/quickstart/)
## 讨论
QQ 交流群: [邀请链接](https://jq.qq.com/?_wv=1027&k=VXp6plBD)
> QQ 群不定时清除不活跃成员, 请自行重新申请入群.
## 文档
[](https://graia.readthedocs.io/projects/ariadne/)
[](https://graia.readthedocs.io/ariadne/)
[](https://graiax.cn)
[](https://graia.readthedocs.io/ariadne/appendix/credits)
**如果认为本项目有帮助, 欢迎点一个 `Star`.**
## 协议
本项目以 [`GNU AGPL-3.0`](https://choosealicense.com/licenses/agpl-3.0/) 作为开源协议, 这意味着你需要遵守相应的规则.
## 持续集成 (CI) 状态
[](https://graia.readthedocs.io/projects/ariadne/)
[](https://results.pre-commit.ci/latest/github/GraiaProject/Ariadne/master)
[](https://github.com/GraiaProject/Ariadne/actions/workflows/deploy-docs.yml)
[](https://github.com/GraiaProject/Ariadne/actions/workflows/release.yml)
## 参与开发
[贡献指南](./CONTRIBUTING.md)
一个优雅且完备的 Python QQ 自动化框架，基于 Mirai API HTTP v2+源代码+文档说明
版权申诉
43 浏览量
2023-12-01
18:38:40
上传
评论
收藏 227KB ZIP 举报
一个优雅且完备的 Python QQ 自动化框架，基于 Mirai API HTTP v2。 Powered by Graia Project..zip （93个子文件） 
code 
extract-release-notes.py 668B .vscode poetry-schema.json 19KB settings.json 2KB launch.json 296B .github dependabot.yml 271B ISSUE_TEMPLATE doc.md 379B bug.md 471B feature.md 390B workflows deploy-docs.yml 1KB release.yml 2KB FUNDING.yml 66B PULL_REQUEST_TEMPLATE.md 144B pytest.ini 63B src test_old commander_performance.py 1KB parser_performance.py 1KB app.py 8KB commander.py 4KB twilight.py 3KB tools.py 510B minimal.py 478B graia ariadne __init__.py 326B message __init__.py 2KB commander __init__.py 23KB saya.py 2KB util.py 9KB creart.py 1KB exp __init__.py 223B parser __init__.py 47B util.py 9KB twilight.py 29KB base.py 14KB formatter.py 4KB chain.py 16KB element.py 22KB typing.py 6KB app.py 73KB entry __init__.py 8KB saya.py 920B broadcast.py 850B scheduler.py 1KB event.py 4KB message.py 3KB py.typed 0B exception.py 1KB event __init__.py 461B mirai.py 40KB message.py 6KB lifecycle.py 1KB context.py 2KB connection http.py 6KB __init__.py 6KB util.py 3KB _info.py 820B ws.py 7KB config.py 3KB model __init__.py 6KB util.py 2KB relationship.py 9KB service.py 10KB console __init__.py 9KB saya.py 2KB dispatcher.py 7KB util __init__.py 11KB saya.py 5KB cooldown.py 7KB interrupt.py 6KB async_exec.py 7KB send.py 3KB validator.py 4KB test message chain.py 11KB element.py 0B LICENSE 34KB bump-version.py 278B CONTRIBUTING.md 2KB CHANGELOG.md 23KB .pre-commit-config.yaml 762B docs assets curtain.css 307B admonition.js 928B extra.css 2KB chat.css 418B overrides partials 
copyright.html 629B social.html 640B .icons 
netlify.svg 4KB gen_ref.py 1KB
requirements.txt 145B migrate_src migrator.py 7KB CODE_OF_CONDUCT.md 4KB pyproject.toml 4KB pdm.lock 210KB .gitignore 2KB README.md 4KB mkdocs.yml 3KB .readthedocs.yaml 192B资源评论
