API、CQ 码与扩展能力矩阵

本页汇总 Gensokyo-NewQQ 主仓库文档中列出的 OneBot V11 API、项目扩展 API 和 CQ 码，便于部署者与插件开发者快速检索。

矩阵中的状态含义：

• 已映射：主仓库明确列出，并提供对应的 OneBot 调用或消息映射。
• 适配实现：提供相应入口，但返回字段、权限或行为会受到 QQ 官方机器人能力限制。
• 项目扩展：不属于标准 OneBot V11，由 Gensokyo-NewQQ 额外提供。

IMPORTANT

本页不是稳定 ABI 承诺。QQ 官方平台权限、项目实现和版本差异都可能影响实际结果。开发插件前，应在目标版本上进行真实调用测试，并结合主仓库源码与运行日志确认。

本表用于快速检索主仓库文档中列出的能力，不代表所有字段与 OneBot 原始实现完全一致。标记为“适配实现”的项目会受到 QQ 官方权限、事件模型或接口限制。

当前显示 56 项

名称

类别

说明

状态

/send_private_msg

标准 API

发送 C2C 私聊消息

已映射

/send_group_msg

标准 API

发送 QQ 群消息

已映射

/send_msg

标准 API

按消息类型路由发送；具体行为受 QQ 官方场景限制

适配实现

/delete_msg

标准 API

撤回消息；可撤回范围取决于官方接口权限

适配实现

/delete_group_msg

标准 API

撤回 QQ 群用户或机器人消息

适配实现

/set_group_kick

标准 API

移除群成员，受机器人权限约束

适配实现

/set_group_ban

标准 API

设置群成员禁言

适配实现

/set_group_whole_ban

标准 API

设置群全员禁言

适配实现

/set_group_admin

标准 API

设置群管理员

适配实现

/set_group_card

标准 API

设置群名片

适配实现

/set_group_name

标准 API

设置群名称

适配实现

/set_group_leave

标准 API

退出群聊

适配实现

/set_group_special_title

标准 API

设置群专属头衔

适配实现

/set_friend_add_request

标准 API

处理好友请求

适配实现

/set_group_add_request

标准 API

处理加群请求或邀请

适配实现

/get_login_info

标准 API

获取当前机器人信息

已映射

/get_stranger_info

标准 API

获取用户信息；字段取决于可获得的官方数据

适配实现

/get_friend_list

标准 API

获取好友或 C2C 相关列表

适配实现

/get_group_info

标准 API

获取群聊信息

适配实现

/get_group_list

标准 API

获取群聊列表

适配实现

/get_group_member_info

标准 API

获取群成员信息

适配实现

/get_group_member_list

标准 API

获取群成员列表

适配实现

/get_group_honor_info

标准 API

获取群荣誉信息

适配实现

/can_send_image

标准 API

检查图片发送能力

已映射

/can_send_record

标准 API

检查语音发送能力

已映射

/get_version_info

标准 API

获取实现与版本信息

已映射

/set_restart

标准 API

请求重启 Gensokyo

已映射

/.handle_quick_operation

标准 API

对事件执行快速操作

适配实现

get_avatar

项目扩展

获取头像直链

项目扩展

get_robot_share_link

项目扩展

获取机器人分享链接

项目扩展

send_private_msg_wakeup

项目扩展

发送 C2C 召回或唤醒消息

项目扩展

send_private_msg_sse

项目扩展

通过 SSE 发送私聊消息

项目扩展

put_interaction

项目扩展

处理按钮交互回调

项目扩展

get_group_ban

项目扩展

查询群成员禁言状态

项目扩展

get_group_whole_ban

项目扩展

查询群全员禁言状态

项目扩展

send_to_group

项目扩展

send_group_msg 的项目别名

项目扩展

send_group_msg_raw

项目扩展

发送原始群消息数据

项目扩展

[CQ:face]

CQ 码

QQ 表情

已映射

[CQ:record]

CQ 码

语音消息，包含格式转换处理

适配实现

[CQ:video]

CQ 码

短视频消息

适配实现

[CQ:at]

CQ 码

@ 用户，并处理虚拟 ID 与 OpenID 映射

适配实现

[CQ:share]

CQ 码

链接分享消息

适配实现

[CQ:music]

CQ 码

音乐分享与自定义音乐分享

适配实现

[CQ:reply]

CQ 码

回复消息

适配实现

[CQ:forward]

CQ 码

合并转发消息

适配实现

[CQ:node]

CQ 码

合并转发节点

适配实现

[CQ:xml]

CQ 码

XML 消息；可用性受官方接口限制

适配实现

[CQ:json]

CQ 码

JSON 消息；可用性受官方接口限制

适配实现

[CQ:image]

CQ 码

图片消息，并处理压缩、上传或图床逻辑

适配实现

[CQ:poke]

CQ 码

戳一戳相关转换

适配实现

[CQ:markdown]

CQ 码

项目扩展 Markdown 卡片消息

项目扩展

[CQ:avatar]

CQ 码

项目扩展头像获取

项目扩展

[CQ:member]

CQ 码

项目扩展群成员变动表示

项目扩展

[CQ:active]

CQ 码

项目扩展 active 标记

项目扩展

[CQ:tts]

CQ 码

文本转语音

适配实现

[CQ:file]

CQ 码

项目扩展文件上传

项目扩展