框架内置 _system_manager 插件提供的 ! 前缀聊天命令：热重载、加载/卸载外部插件、系统信息与开关配置。

---

目录

• 权限与安全
• 命令一览
• 配置项
• 说明与限制

---

权限与安全

• 所有命令仅当发送者 QQ 与全局配置中的 root（管理员）一致时才会执行；否则回复「无权执行此操作。」。
• 默认 仅私聊 可用；若要在群内使用，需将 plugin.builtin_commands_group_allowed 设为 true（群聊有泄露风险，请谨慎）。

---

命令一览

命令	作用
!reload <插件名>	对 plugins/ 目录下已索引 的外部插件执行热重载（与文件监视触发的流程相同）。不支持内置插件名。
!load <插件名>	按 manifest 加载单个外部插件（需已被扫描进索引）。
!unload <插件名>	卸载已加载插件；禁止卸载内置插件（如 _system_manager）。
!sysinfo	输出 NcatBot 版本、Python 与系统信息、已加载插件列表、debug / 热重载等状态（不含敏感 token）。
!builtin on / !builtin off	写入全局配置中的 plugin.enable_builtin_commands 并保存；关闭后其它 ! 命令立即失效，!builtin on 在总开关关闭时仍可使用以便恢复。

---

配置项

在 config.yaml 的 plugin 段：

plugin:
  enable_builtin_commands: true   # 总开关
  builtin_commands_group_allowed: false  # 是否允许在群聊使用（默认仅私聊）
  builtin_commands:
    reload: true
    load: true
    unload: true
    sysinfo: true
    config_toggle: true   # 是否允许 !builtin on/off

缺省情况下各子命令为 true；未列出的子命令视为开启。

---

说明与限制

• 热重载、加载、卸载仅针对 外部插件（plugins/ 目录、manifest.toml 已索引）。内置插件不提供聊天热重载。
• 配置项 plugin.enable_builtin_commands 与细粒度开关可在 handler 内即时生效，无需重启 Bot。

版权所有

版权归属：huan-yp

许可证：署名 4.0 国际 (CC-BY-4.0)