QQ 命令

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

包括 locale 在内的部署默认值来自 NoneBot 环境变量或其 .env 文件。通过在线管理命令修改的触发词覆盖是例外：它们存储在 localstore 管理的 runtime-overrides.toml 中。

菜单

主命令：

菜单

当 LINGCHU_LOCALE 选择英文时的英文命令：

menu

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

默认子菜单命令：

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

成员禁言

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

省略时长或原因时，灵初会使用 member_mute.toml 中对应的 handle 默认值。管理员可用 设置功能默认值 <功能> <字段> <值> 在运行时更新所有受支持的功能默认值；成员禁言也保留 设置默认禁言 <秒数> 快捷命令。

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

成员解禁

解禁 @用户
unmute @user

允许解禁自己——解禁 / unmute 属于恢复性动作，不会拒绝操作者本人的 QQ（仅排除机器人自身）。

全体禁言

全员禁言
mute-all

全体解禁

全体解禁
unmute-all

消息撤回

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

数量默认读取 NoneBot 环境变量或 .env 中的 LINGCHU_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。

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

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

拉黑自己或机器人会被拒绝：拉黑 / block（以及远程变体）不接受目标为操作者本人或机器人自身。

群设置与操作

能力	中文命令	英文命令
设置群名称	`设置群名称 <新群名称>`	`set-group-name <new group name>`
设置群头像	`设置群头像 <图片>`	`set-group-avatar <image>`
设置群名片	`设置群名片 @用户 <名片>`	`set-member-card @user <card>`
设置群成员专属头衔	`设置群头衔 @用户 <头衔>`	`set-member-title @user <title>`
设置群管理员	`设置群管理员 @用户 [true/false]`	`set-member-admin @user [true/false]`
取消群管理员	`取消群管理员 @用户`	`unset-member-admin @user`
踢出成员	`踢出 <用户ID或@提及> [原因]`	`kick-member <user_id_or_mention> [reason]`
发送群公告	`发送群公告 <内容> [图片]`	`send-announcement <content> [image]`
退出当前群	`退出群`	`leave-group`

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

远程管理（仅 OneBot V11）

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

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

能力	中文命令	英文命令
远程禁言	`远程禁言 <群号或群名称> @用户 [时长秒数] [原因]`	`remote-mute <group_id_or_group_name> @user [duration seconds] [reason]`
远程解禁	`远程解禁 <群号或群名称> @用户 [原因]`	`remote-unmute <group_id_or_group_name> @user [reason]`
远程全体禁言	`远程全体禁言 <群号或群名称>`	`remote-mute-all <group_id_or_group_name>`
远程全体解禁	`远程全体解禁 <群号或群名称>`	`remote-unmute-all <group_id_or_group_name>`
远程踢出	`远程踢出 <群号或群名称> @用户 [原因]`	`remote-kick <group_id_or_group_name> @user [reason]`
远程拉黑	`远程拉黑 <群号或群名称> @用户 [时长秒数] [原因]`	`remote-block <group_id_or_group_name> @user [duration seconds] [reason]`
远程删黑	`远程删黑 <群号或群名称> @用户 [原因]`	`remote-unblock <group_id_or_group_name> @user [reason]`
远程公告	`远程公告 <群号或群名称> <内容> [图片]`	`remote-announcement <group_id_or_group_name> <content> [image]`
群发公告	`群发公告 <内容> [群号或群名称列表或全部群] [图片]`	`mass-announcement <content> [group_ids_or_group_names_or_all] [image]`

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

远程解禁（远程解禁 / remote-unmute）允许在目标群解禁自己的账号。远程拉黑（远程拉黑 / remote-block）拒绝目标为操作者本人或机器人自身。

错误反馈

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

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

系统管理

能力	中文命令	英文命令
重启协议端	`重启协议端 [平台]`	`restart-protocol-endpoint [platform]`
重置灵初配置	`重置灵初配置`	`reset-lingchu-config`

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

重置灵初配置 从磁盘重新加载灵初运行时配置：机器人状态（bot_state.toml）、菜单、功能配置文件以及运行时覆盖（runtime-overrides.toml）。手工编辑这些 TOML 文件后执行该命令，无需重启即可让运行中的机器人读取最新配置。命令触发词覆盖仍需重启，因为匹配器在启动时注册。

闭嘴
silence

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

说话
speak

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

开机
boot

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

关机
shutdown

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