nonebot2/docs/api/adapters/cqhttp.md

contentSidebar	sidebarDepth
true	0

NoneBot.adapters.cqhttp 模块

CQHTTP (OneBot) v11 协议适配

协议详情请看: CQHTTP | OneBot

log(level, message)

• 说明

  用于打印 CQHTTP 日志。

• 参数

  • level: str: 日志等级

  • message: str: 日志信息

escape(s, *, escape_comma=True)

• 说明

  对字符串进行 CQ 码转义。

• 参数

  • s: str: 需要转义的字符串

  • escape_comma: bool: 是否转义逗号（,）。

unescape(s)

• 说明

  对字符串进行 CQ 码去转义。

• 参数

  • s: str: 需要转义的字符串

_b2s(b)

转换布尔值为字符串。

async _check_reply(bot, event)

• 说明

  检查消息中存在的回复，去除并赋值 event.reply, event.to_me

• 参数

  • bot: Bot: Bot 对象

  • event: Event: Event 对象

_check_at_me(bot, event)

• 说明

  检查消息开头或结尾是否存在 @机器人，去除并赋值 event.to_me

• 参数

  • bot: Bot: Bot 对象

  • event: Event: Event 对象

_check_nickname(bot, event)

• 说明

  检查消息开头是否存在，去除并赋值 event.to_me

• 参数

  • bot: Bot: Bot 对象

  • event: Event: Event 对象

_handle_api_result(result)

• 说明

  处理 API 请求返回值。

• 参数

  • result: Optional[Dict[str, Any]]: API 返回数据

• 返回

  • Any: API 调用返回数据

• 异常

  • ActionFailed: API 调用失败

class Bot

基类：nonebot.adapters.BaseBot

CQHTTP 协议 Bot 适配

property type

• 返回: "cqhttp"

async handle_message(message)

• 说明

  调用 _check_reply, _check_at_me, _check_nickname 处理事件并转换为 Event

async call_api(api, **data)

• 说明

  调用 CQHTTP 协议 API

• 参数

  • api: str: API 名称

  • **data: Any: API 参数

• 返回

  • Any: API 调用返回数据

• 异常

  • NetworkError: 网络错误

  • ActionFailed: API 调用失败

async send(event, message, at_sender=False, **kwargs)

• 说明

  根据 event 向触发事件的主体发送消息。

• 参数

  • event: Event: Event 对象

  • message: Union[str, Message, MessageSegment]: 要发送的消息

  • at_sender: bool: 是否 @ 事件主体

  • **kwargs: 覆盖默认参数

• 返回

  • Any: API 调用返回数据

• 异常

  • ValueError: 缺少 user_id, group_id

  • NetworkError: 网络错误

  • ActionFailed: API 调用失败

class Event

基类：nonebot.adapters.BaseEvent

class MessageSegment

基类：nonebot.adapters.BaseMessageSegment

class Message

基类：nonebot.adapters.BaseMessage