麦麦指令小抄

记不住安装过的插件指令时，发送一条命令就能查看当前真正加载的插件指令。

它是一个独立的 MaiBot 插件，不依赖“麦麦写书”“麦麦群聊寻迹”或其他第三方插件，也不会修改 MaiBot 主程序。

它能做什么

• 自动读取当前已经加载的插件命令，不需要手工维护指令表。
• 按插件整理命令、别名和说明。
• 支持按插件名、指令或关键词筛选。
• 内容过长时自动分页，避免单条消息发送失败。
• 插件增删或重载后，下次查询会显示最新结果。

使用

/指令
/指令 总结
/指令 寻迹
/插件指令

• /指令：按插件列出全部已启用指令。
• /指令 关键词：按插件 ID、命令、别名或说明筛选。
• 内容较长时自动拆成多条消息。
• 插件增删或重载后，下一次查询会自动显示最新结果。

它不调用模型，也不读取聊天记录，只通过 MaiBot 官方运行时能力读取命令组件元数据。

安装

1. 下载 MaiBot-command-help-v0.1.0.zip 并解压。
2. 把整个 MaiBot_command_help 文件夹放进 MaiBot 的 plugins/ 目录。
3. 重启 MaiBot，或等待插件系统自动热重载。
4. 发送 /指令 查看当前可用命令。

兼容性

• MaiBot 1.1.0 至 1.x
• maibot-plugin-sdk 2.7.0 至 2.x

显示设置

通常不需要修改设置。需要时可以在 WebUI 中：

• 显示已停用的命令；
• 调整每页字数；
• 隐藏指定插件或命令组件。

权限与隐私

插件不调用模型、不访问网络、不读取聊天记录，也不会保存命令查询内容。它只通过 MaiBot 官方运行时能力读取已加载插件公开的命令元数据，然后把结果发回当前会话。

常见问题

为什么没有显示某条命令？

先确认对应插件已经成功加载、命令组件处于启用状态，并检查“隐藏插件”和“隐藏命令”设置。也可以在 WebUI 中开启“显示已停用的命令”后再次查询。

安装新插件后需要维护指令表吗？

不需要。再次发送 /指令 时会重新读取当前运行状态。

开发与测试

python -m unittest discover -s tests -v
python scripts/build_release.py

贡献前请阅读 CONTRIBUTING.md，遇到问题可查看 SUPPORT.md。安全问题请按 SECURITY.md 提交。

版本

当前版本：0.1.0，更新内容见 CHANGELOG.md。