内置命令使用

Bngeuit 框架内置了多个常用命令，主要用于机器人管理和调试。所有内置命令都在控制台输入使用。

命令列表

命令	别名	说明
stop	—	停止机器人：卸载全部插件、关闭客户端并退出进程
plugins	pl	列出已加载插件（名称 / 版本 / 状态）
help [页码]	—	分页查看命令列表，每页 8 条
plugin <load|unload|reload> <插件名>	plg	插件热管理：加载 / 卸载 / 重载（JAR 与 JS 脚本插件均支持）
log level <级别>	—	热修改日志级别，立即生效
c2c send <openid> text|md <内容|md文件名>	—	发送私聊消息
c2c media <openid> image|video|voice|file file|url <文件名或url>	—	发送私聊媒体
group send <openid> text|md <内容|md文件名>	—	发送群消息
group media <openid> image|video|voice|file file|url <文件名或url>	—	发送群媒体

使用示例

查看帮助

help          # 第一页命令列表
help 2        # 第二页

管理插件

plugins                  # 查看已加载插件列表
plugin load myplugin     # 热加载插件
plugin unload myplugin   # 卸载插件
plugin reload myplugin   # 重载插件（卸载后重新加载）

也可以使用别名：

pl                  # 等同于 plugins
plg reload myplugin # 等同于 plugin reload myplugin

调整日志级别

log level           # 查看当前日志级别
log level DEBUG     # 设置为 DEBUG
log level INFO      # 设置为 INFO
log level WARN      # 设置为 WARN
log level ERROR     # 设置为 ERROR
log level OFF       # 关闭日志

日志级别（从详细到简略）：TRACE / DEBUG / INFO（默认）/ WARN / ERROR / OFF

发送消息

支持使用 ()配置路径 读取 config.yml 中的配置值：

# 直接使用 openid
c2c send 用户OpenID 你好，这是一条消息
group send 群OpenID 大家好

# 使用配置值（() 开头会自动读取 config.yml）
c2c send ()test_user_openid 你好
group send ()test_group_openid 大家好

# 发送 Markdown（从 markdown_files/ 目录加载的文件名）
c2c send ()test_user_openid md welcome
group send ()test_group_openid md welcome

# 发送媒体文件
c2c media ()test_user_openid image file logo.png
group media ()test_group_openid video url https://example.com/video.mp4

停止机器人

stop    # 停止机器人并退出进程

命令命名空间

每个命令都有一个命名空间，用于区分不同来源的命令：

• 内置命令：命名空间为 bngeuit，如 bngeuit:stop
• 插件命令：命名空间为插件名（小写），如 myplugin:test

当存在同名命令冲突时，可以使用 命名空间:命令 格式精确指定：

bngeuit:stop            # 明确调用内置的 stop 命令
myplugin:test           # 明确调用 myplugin 插件的 test 命令

如果不使用命名空间，框架会按优先级自动匹配可用的命令。

命令冲突处理

当多个插件注册了同名命令时：

1. 使用 help 命令查看所有可用命令
2. 使用 插件名:命令 格式精确调用特定插件的命令
3. 建议插件开发者为命令设置独特的名称，避免冲突