Red Protocol Adapter for Nonebot2
Project description
NoneBot-Adapter-Red
✨ NoneBot2 Red Protocol适配器 / Red Protocol Adapter for NoneBot2 ✨
安装
Chronocat
请按照 Chronocat 的指引安装。
目前推荐版本为 v0.0.46
配置
修改 NoneBot 配置文件 .env
或者 .env.*
。
Driver
参考 driver 配置项,添加 ForwardDriver
支持。
如:
DRIVER=~httpx+~websockets
DRIVER=~aiohttp
RED_AUTO_DETECT
是否自动检测 Chronocat 的配置文件 ~/.chronocat/config/chronocat.yml
并读取内容,默认为 False
。
配置文件详细内容请参考 Chronocat/config。
该配置项需要在 Chronocat
版本 v0.0.46
以上才可用。
使用该配置项时,你需要通过 pip install nonebot-adapter-red[auto_detect]
安装 nonebot-adapter-red
。
如果你已经配置了 RED_BOTS
,则该配置项不会生效。
RED_BOTS
配置机器人帐号,如:
RED_BOTS='
[
{
"port": "xxx",
"token": "xxx",
"host": "xxx"
}
]
'
你需要从 Chronocat 的配置文件 ~/.chronocat/config/chronocat.yml
中获取 port
、token
、host
。
在单账号下,
port
与配置文件下的servers[X].port
一致token
与配置文件下的servers[X].token
一致host
与配置文件下的servers[X].listen
一致
# ~/.chronocat/config/chronocat.yml
servers:
- type: red
# Chronocat 已经自动生成了随机 token。要妥善保存哦!
# 客户端使用服务时需要提供这个 token!
token: DEFINE_CHRONO_TOKEN # token
# Chronocat 开启 red 服务的端口,默认为 16530。
port: 16530 # port
# 服务器监听的地址。 如果你不知道这是什么,那么不填此项即可!
listen: localhost # host
而多账号下,
port
与配置文件下下的overrides[QQ].servers[X].port
一致,并且一个QQ
只能对应一个port
token
与配置文件下下的overrides[QQ].servers[X].token
一致host
与配置文件下下的overrides[QQ].servers[X].listen
一致
# ~/.chronocat/config/chronocat.yml
overrides:
1234567890:
servers:
- type: red
# Chronocat 已经自动生成了随机 token。要妥善保存哦!
# 客户端使用服务时需要提供这个 token!
token: DEFINE_CHRONO_TOKEN # token
# Chronocat 开启 red 服务的端口,默认为 16530。
port: 16531 # port
# 服务器监听的地址。 如果你不知道这是什么,那么不填此项即可!
listen: localhost
旧版 Chronocat
对于旧版的 Chronocat,
port
是默认的16530
token
被默认存储在%AppData%/BetterUniverse/QQNT/RED_PROTOCOL_TOKEN
或~/BetterUniverse/QQNT/RED_PROTOCOL_TOKEN
中,并保持不变。host
默认为localhost
。
功能
支持的事件:
- 群聊消息、好友消息 (能够接收到来着不同设备的自己的消息)
- 群名称改动事件
- 群成员禁言/解除禁言事件
- 群成员加入事件 (包括旧版受邀请入群)
支持的 api:
- 发送消息 (文字,at,图片,文件,表情,引用回复)
- 发送伪造合并转发 (文字,at,图片)
- 获取自身资料
- 获取好友、群组、群组内群员资料
- 获取群公告
- 禁言/解禁群员
- 全体禁言
- 获取历史消息
- 获取媒体消息的原始数据
完整的 api 文档请参考 API 文档 或 QQNTRedProtocol
示例
from pathlib import Path
from nonebot import on_command
from nonebot.adapters.red import Bot
from nonebot.adapters.red.event import MessageEvent
from nonebot.adapters.red.message import MessageSegment
matcher = on_command("test")
@matcher.handle()
async def handle_receive(bot: Bot, event: MessageEvent):
if event.is_group:
await bot.send_group_message(event.scene, MessageSegment.image(Path("path/to/img.jpg")))
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nonebot_adapter_red-0.5.1.tar.gz
(21.8 kB
view hashes)
Built Distribution
Close
Hashes for nonebot_adapter_red-0.5.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12dde60000f3827f1f9d2939ec71ba6fe7c9b71cbf04266612db10ab992bded9 |
|
MD5 | 87908a43cf98a2a30f4b33cfa9f06ef6 |
|
BLAKE2b-256 | 21219318a9ae9393422cb57748bbc8911e137f1db15289b298d2fe49bf61d4fb |
Close
Hashes for nonebot_adapter_red-0.5.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 57d41547f4587cc140641cfb361766a34bde31b593690bf15841ad8cfaf3362b |
|
MD5 | 15f1ad7eb9392df634048e426f763790 |
|
BLAKE2b-256 | 9c5edf5e58f248d04b8cc51d73d2912898807b8fee7f43eca3c582ae9418679d |