QQ 命令

QQ 命令

命令由 nonebot-plugin-alconna 注册，默认启用命令起始符和命令分隔符。命令触发词按 locale 互斥选择：中文 locale 启用中文触发词，英文 locale 启用短横线风格英文触发词。两种语言的触发词不会同时启用。

菜单

主命令：

菜单

当 LINGCHU_LOCALE / lc_locale / locale 选择英文时的英文命令：

menu

菜单命令是索引入口。它只列出可进入的子菜单命令，不再把所有功能堆在一条长消息里。子菜单完全由代码驱动，并按当前平台、协议和实现过滤。

默认子菜单命令：

• 成员管理 / member-management：踢出、拉黑/删黑、拉白/删白、设置群名片、设置群头衔、设置/取消管理员。
• 发言管理 / speech-management：禁言/解禁群成员、开启/关闭全体禁言、撤回最近消息。
• 群聊管理 / group-chat-management：设置群名称、设置群头像（实现支持时）、发送群公告（实现支持时）、退出当前群。
• 远程管理 / remote-management：跨群禁言/解禁、全体禁言/解禁、踢出、拉黑/删黑、发送公告、群发公告。
• 系统管理 / system-management：闭嘴/说话（静默模式）、开机/关机（处理器门禁）、重启协议端等应用运行命令。

成员禁言

禁言 @用户 [时长秒数] [原因]
mute @user [duration seconds] [reason]

• 时长默认：60 秒。
• 原因默认：违反群规「默认」。

成员解禁

解禁 @用户
unmute @user

全体禁言

全员禁言
mute-all

全体解禁

全体解禁
unmute-all

消息撤回

撤回 [@用户] [数量]
recall [@user] [count]

• 数量默认读取 config.json5 的 recall_message_default_count（默认 10）。
• 单个数字参数会被视为数量：撤回 20。
• 定向撤回用户消息时先提供 @：撤回 @用户 20。
• 命令从消息存储读取当前群最近消息，跳过触发命令本身，通过 OneBot V11 get_msg 校验候选消息，再调用 delete_msg 撤回。
• 机器人会跳过操作者、机器人自己、群管理员/群主，以及通过 protected_subject_feature_keys 保护的用户消息。

OneBot V11 黑名单

黑名单和白名单命令仅在 OneBot V11 可用。拉黑会把用户写入本群或全局黑名单，随后从当前群踢出该用户，并在黑名单生效期间拒绝该用户的后续加群请求。拉白会把用户写入受保护目标；只有仓库内 SUPERUSERS 组成员可以增删白名单。

拉黑 @用户 [时长秒数] [原因]
全局拉黑 @用户 [时长秒数] [原因]
删黑 @用户 [原因]
全局删黑 @用户 [原因]
清空黑名单 [原因]
全局清空黑名单 [原因]
拉白 @用户 [原因]
全局拉白 @用户 [原因]
删白 @用户 [原因]
全局删白 @用户 [原因]

英文：block、global-block、unblock、global-unblock、clear-blocklist、global-clear-blocklist、protect、global-protect、unprotect、global-unprotect。

• 时长默认：永久。
• 拉黑原因默认：违反群规「默认」。
• 删黑/清空/白名单原因默认：管理员操作「默认」。

清空黑名单 只清空当前群黑名单；如需清空全局黑名单，请使用 全局清空黑名单。 拉白 和 删白 只影响当前群白名单；如需跨群保护，请使用全局变体。

群设置与操作

群公告和群头像命令接收 nonebot-plugin-alconna 的 UniImage 参数。包含空格的名称、公告内容、名片或头衔建议使用引号包裹，避免被命令分隔符拆分。

远程管理（仅 OneBot V11）

远程命令作用于当前群之外的目标群。<群号或群名称> 参数接受：

• 整数群号（如 123456789）。
• 可解析为整数的纯数字字符串。
• 非数字字符串，触发通过 get_group_list 对机器人已加入群聊的模糊匹配。精确名称匹配优先；否则使用包含关系匹配。匹配到多个群时，机器人会要求提供更精确的名称或群号。

群发公告使用命令键 / 功能名 mass announcement / 群发公告。内容参数在前。省略目标列表时，机器人会发送到已加入的全部群。指定多个目标群时，用 ,、，、、、; 或 ； 分隔群号或群名称。也可以用 全部群 或 all 明确指定全部已加入群。

错误反馈

群管理命令会对已覆盖适配器的网络异常和操作拒绝返回可读错误消息。未知异常仍会向外抛出，方便开发者发现未覆盖的问题。

反馈文本和命令触发词语言会使用当前 NoneBot 配置中的 LINGCHU_LOCALE、lc_locale 或 locale。详见国际化。

系统管理

重启协议端 省略平台参数时重启当前 QQ OneBot V11 协议端。协议端重新连接后，Lingchu 会向发起命令的群发送确认反馈。

闭嘴
silence

进入静默模式：命令照常执行（禁言、踢出等操作仍生效），但不发送任何反馈消息。

说话
speak

退出静默模式：恢复命令反馈消息发送。

开机
boot

开机：启用所有命令处理器。开机状态下所有命令正常响应。

关机
shutdown

关机：停用所有命令处理器（除开机/关机本身），所有命令不再执行也不响应。仅开机/关机命令可在关机状态下使用。