基础命令指南

本文档介绍日常使用中最常见的基础命令。它们主要用于：

• 聊天管理
• 查看系统信息
• 查看插件状态
• 控制频道状态

平台说明

文档中的聊天命令主要基于当前命令系统与 OneBot v11（QQ）场景整理。不同适配器与 WebUI 管理方式之间可能存在差异，实际可用性请以当前环境为准。

权限说明

基础命令通常会涉及以下权限角色：

• 超级管理员：拥有最高权限
• 高级用户：可使用部分管理能力
• 普通用户：可使用公开能力

如果某条命令没有权限，系统可能直接拒绝执行，或在关闭未授权提示输出时不返回反馈。

聊天管理命令

reset

用于重置当前聊天或指定聊天的上下文。

常见用法：

reset
reset group_123456789

适合场景：

• 当前上下文混乱
• 需要重新开始一轮对话
• 需要清空某个频道的聊天记忆窗口

inspect

用于查看指定聊天的基本信息。

常见用法：

inspect
inspect group_123456789

适合场景：

• 快速确认某个频道的标识
• 调试频道状态和归属

频道状态命令

na_on

将目标频道设为正常激活状态。

常见用法：

na_on
na_on *
na_on private_*
na_on group_*
na_on group_123456789

na_off

将目标频道设为停用状态。

常见用法：

na_off
na_off *
na_off private_*
na_off group_*
na_off group_123456789

na_observe

将目标频道设为旁观模式。

常见用法：

na_observe
na_observe *
na_observe private_*
na_observe group_*
na_observe group_123456789

旁观模式的含义是：

• 保留频道记录
• 不触发正常回复流程

如果你想理解三种频道状态的差异，建议阅读频道管理文档（即将发布）。

系统信息命令

na_info

查看系统信息和当前聊天设定。

常见用法：

na_info

通常会包含：

• Nekro Agent 版本信息
• 当前聊天的人设或配置情况
• 当前模型组或相关运行信息

na_help

查看可用命令的帮助信息。

常见用法：

na_help

适合：

• 快速浏览当前环境中有哪些命令
• 检查命令描述和基本用法

插件管理命令

na_plugins

查看当前已加载的插件列表。

常见用法：

na_plugins

通常会显示：

• 插件名称
• 版本
• 作者
• 描述
• 状态

plugin_info

查看某个插件的详细信息。

常见用法：

plugin_info emotion
plugin_info draw

reset_plugin

重置指定插件的配置文件。

常见用法：

reset_plugin emotion
reset_plugin draw

注意：

• 这类操作通常不可撤销
• 执行前建议先确认配置是否需要保留

使用建议

• 把基础命令理解为“日常管理入口”，而不是深度调试入口。
• 对频道状态类命令，优先在测试环境验证后再批量操作。
• 涉及插件重置和全局操作时，优先确认权限和目标范围。

继续阅读

• 命令中心（即将发布）
• 调试命令指南
• 频道管理（即将发布）