karakoo / cai

🤖 又一个 QQ 协议支持库，使用 Python 编写 Yet Another Bot Framework for Tencent QQ Written in Python

✨ Yet Another Bot Framework for Tencent QQ Written in Python ✨

---

声明

一切开发旨在学习，请勿用于非法用途

• CAI 是完全免费且开放源代码的软件，仅供学习和娱乐用途使用
• CAI 不会通过任何方式强制收取费用，或对使用者提出物质条件

许可证

CAI 采用 AGPLv3 协议开源，不鼓励、不支持一切商业使用。

---

特色

• 简单易用的 API，支持多账号

• 极少的额外依赖

• 异步编写，效率++

  • 使用 Asyncio Stream 处理网络连接 (cai.connection.Connection)
  • 使用 Asyncio Future 处理收发包 (cai.utils.future.FutureStore)

• 完整的 Type Hints

  • Packet Query 支持 Variadic Generics

    from cai.utils.binary import Packet
    packet = Packet(bytes.fromhex("01000233000000"))
    packet.start().int8().uint16().bytes(4).execute()
    # return type: INT8, UINT16, BYTES

  • 便携的 JceStruct 定义 (使用方法参考 JceStruct)

    from typing import Optional
    from jce import JceStruct, JceField, types
    
    class CustomStruct(JceStruct):
        int32_field: types.INT32 = JceField(jce_id=0)
        optional_field: Optional[types.DOUBLE] = JceField(None, jce_id=1)
        nested_field: OtherStruct = JceField(jce_id=2)

功能

CAI 仅作为底层协议库使用，将协议封装为 API。

CAI 不会支持涉及 金钱、主动邀请、获取凭证 等敏感操作的协议。

已支持的协议列表：

登录

cai.api.login API Reference

• 账号密码登录
• 设备锁验证
• 图片验证码提交
• 短信验证码提交
• 扫码登录

客户端

cai.api.client API Reference

• 设置在线状态

好友

cai.api.friend API Reference

• 获取好友列表
• 获取好友信息
• 获取好友分组列表
• 获取好友分组信息

群组

cai.api.group API Reference

• 获取群列表
• 获取群信息
• 获取群成员列表

事件

cai.api.flow API Reference

通过注册事件监听回调，在事件发生时执行指定操作。事件类型可通过 cai.client 模块导入。

• 好友消息 (PrivateMessage)
• 群消息 (GroupMessage)

文档

In Development

See on Read The Docs