QQ.py 介绍

发表于 更新于 分类于 ， ，

QQ.py 是一个现代化，模组化且简洁的 QQ 频道机器人 API Wrapper。

安装

你需要一个 Python 3.8 或以上的环境，以及能够连接上互联网的服务器。
不支持 Python 2.7 或更低版本。不支持 Python 3.7 或更低版本。

PypI

你可以直接从 PyPI 使用 pip 命令安装。

命令提示符
1
pip install -U qq.py

Github

或者，如果有新的更新，但是更新还没有发布到 PyPI ，你可以使用 pip 来安装 git 来源的包。

命令提示符
1
pip3 install -U git+pip install git+https://github.com/foxwhite25/qq.py.git

虚拟环境

有时候，你想要安装两个不同版本的库，或者不想污染全局库。你可能也无权在系统范围内安装库。
为此，Python 3.3 以后的标准库都附带了一个称为 虚拟环境 的概念，来让你能够为单独维护项目的库。

这里只是展示一个快速建立虚拟环境的方法，更深入的教程可以在 虚拟环境文档 中找到。

  1. 转到你项目的工作目录并创建虚拟环境:
    命令提示符
    1
    2
    cd your-bot-source
    python3 -m venv bot-env
  2. 激活虚拟环境
    命令提示符
    1
    source bot-env/bin/activate
    或者如果你在Windows的话
    命令提示符
    1
    .\bot-env\Scripts\activate.bat

然后你就可以正常运行上面那些安装指令用 pip 安装了。
恭喜。你现在已经设置了一个虚拟环境。

基本概念

QQ.py 围绕着 事件 运作，当一个 事件 发生时调用回调函数。
事件 可以是新消息，也可以是新成员加入。
演示 事件 如何工作的示例：

事件示例 mark:4,7
1
2
3
4
5
6
7
8
9
10
11
import qq

class MyClient(qq.Client):
    async def on_ready(self):
        print(f'Logged on as {self.user}!')

    async def on_message(self, message):
        print(f'Message from {messsage.author}: {message.content}')

client = MyClient()
client.run(token='你的token')