Commands Overview

Commands Overview

Lingchu Bot's user-facing capabilities are concentrated in QQ group management commands. Commands are registered through nonebot-plugin-alconna, with command start tokens and separators enabled by default.

Locale and triggers

Command trigger words are locale-exclusive. Chinese locales enable the existing Chinese triggers, while English locales enable short hyphenated English triggers. The two trigger languages are not enabled at the same time.

Feedback text and command trigger language use LINGCHU_LOCALE, lc_locale, or locale from the current NoneBot configuration. See Internationalization.

Menu

Primary command:

菜单

English command when LINGCHU_LOCALE / lc_locale / locale selects English:

menu

The menu command is an index entry. It lists the available submenu commands instead of expanding every feature into one long message. Submenus are code-driven and filtered by the selected platform, protocol, and implementation.

Default submenu commands:

• 成员管理 / member-management
• 发言管理 / speech-management
• 群聊管理 / group-chat-management
• 远程管理 / remote-management
• 系统管理 / system-management — bot state and application operation commands, including protocol endpoint restart where supported

Platform-specific command references

Command availability and behavior vary by platform, protocol, and implementation. For full command references, see the platform-specific pages:

• QQ Commands — Full QQ command reference including remote management
• QQ Platform Overview — Protocol and implementation matrix
• OneBot V11 Protocol — Protocol overview and implementation-specific docs

Implementation filtering

Commands unsupported by the selected platform, protocol, or implementation are hidden from the menu. Current implementation filters include:

• OneBot V11 with unknown implementation hides group announcement and group avatar.
• NapCat.Onebot >= 4.18.0 shows group announcement and group avatar.
• Remote management commands are OneBot V11 only.
• Remote announcement and mass announcement require NapCat.Onebot >= 4.18.0.

The mass announcement command key / feature name is mass announcement / 群发公告. Its syntax is mass-announcement <content> [group_ids_or_group_names_or_all] [image]; Chinese locale uses 群发公告 <内容> [群号或群名称列表或全部群] [图片]. If the target is omitted, the bot sends to all groups it has joined. Multiple target groups are separated with ,, ，, 、, ;, or ；.

重启协议端 restarts the current QQ OneBot V11 protocol endpoint when the platform argument is omitted. After the protocol endpoint reconnects, Lingchu sends a confirmation message to the group where the command was issued.

Error feedback

Group management commands return readable error messages for covered adapter network errors and rejected operations. Unknown exceptions are still raised outward so developers can find uncovered cases.