命令概览

命令概览

Lingchu Bot 的用户侧能力集中在 QQ 群管理命令。命令由 nonebot-plugin-alconna 注册，默认启用命令起始符和命令分隔符。

Locale 与触发词

命令触发词按 locale 互斥选择。中文 locale 启用既有中文触发词，英文 locale 启用短横线风格英文触发词。两种语言的触发词不会同时启用。

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

菜单

主命令：

菜单

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

menu

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

默认子菜单命令：

• 成员管理 / member-management
• 发言管理 / speech-management
• 群聊管理 / group-chat-management
• 远程管理 / remote-management
• 系统管理 / system-management — 机器人状态与应用运行命令，包括支持时的协议端重启

平台专属命令参考

命令的可用性和行为因平台、协议和实现而异。完整命令参考请参见平台专属页面：

• QQ 命令 — 完整 QQ 命令参考（含远程管理）
• QQ 平台概览 — 协议与实现矩阵
• OneBot V11 协议 — 协议概览和实现专属文档

实现过滤

不被当前平台、协议或实现支持的命令会从菜单中隐藏。当前实现过滤规则包括：

• OneBot V11 未知实现会隐藏群公告和群头像。
• NapCat.Onebot >= 4.18.0 显示群公告和群头像。
• 远程管理命令仅 OneBot V11 可用。
• 远程公告和群发公告要求 NapCat.Onebot >= 4.18.0。

群发公告的命令键 / 功能名是 mass announcement / 群发公告。语法为 群发公告 <内容> [群号或群名称列表或全部群] [图片]；英文 locale 使用 mass-announcement <content> [group_ids_or_group_names_or_all] [image]。省略目标时，机器人会发送到已加入的全部群。多个目标群用 ,、，、、、; 或 ； 分隔。

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

错误反馈

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