- 查看 CPU、内存、磁盘、网络、进程占用和运行时间。
- 查看当前连接的 Bot、适配器和已加载插件。
- 搜索 NoneBot 官方插件商店，安装、更新或卸载插件。
- 在网页中修改 dotenv 配置，敏感字段自动脱敏，保存前自动备份。
- 搜索和筛选当前进程日志。
- 自定义 WebUI 背景图，支持远程链接或本地上传。
- 检测 GitHub 最新版本并一键更新，概览页支持重启 NoneBot。
- 使用初始化令牌创建管理员，后续通过账号密码登录。
前端资源随插件一起安装，不依赖单独的 Web 服务，也不绑定任何消息适配器。
使用 NB-CLI：
nb plugin install nonebot-plugin-mimo-console或使用 uv / pip：
uv add nonebot-plugin-mimo-console
# pip install nonebot-plugin-mimo-console使用 uv 或 pip 安装后，请确认 NoneBot 项目的 pyproject.toml 已加载插件：
[tool.nonebot]
plugins = ["nonebot_plugin_mimo_console"]项目需要启用 FastAPI 驱动：
DRIVER=~fastapi启动 NoneBot 后，日志会显示 WebUI 地址和首次初始化令牌。默认地址：
http://127.0.0.1:8080/mimo-console/
第一次打开时输入日志中的令牌并创建管理员；完成初始化后只需使用管理员账号登录。
所有配置均可省略。
| 配置项 | 默认值 | 作用 |
|---|---|---|
MIMO_CONSOLE_PATH |
/mimo-console |
WebUI 挂载路径 |
MIMO_CONSOLE_PROJECT_ROOT |
当前工作目录 | NoneBot 项目目录 |
MIMO_CONSOLE_SESSION_HOURS |
72 |
登录有效时长，范围 1-720 小时 |
MIMO_CONSOLE_ENABLE_STORE |
true |
显示官方插件商店 |
MIMO_CONSOLE_ALLOW_PACKAGE_MANAGEMENT |
true |
允许安装、更新和卸载插件 |
MIMO_CONSOLE_STORE_CACHE_SECONDS |
600 |
商店数据缓存时间 |
MIMO_CONSOLE_PACKAGE_TIMEOUT |
300 |
插件操作超时时间（秒） |
MIMO_CONSOLE_GITHUB_PROXY |
空 | GitHub 加速前缀或镜像仓库地址，用于 README、版本检查和自更新 |
超级用户也可以发送 mimo控制台 或 NoneBot控制台 获取访问地址。
- 概览页显示当前版本，并与 GitHub 最新 release 比对，有新版时可一键通过
nb plugin update自更新（结果缓存约 30 分钟）。 - 更新与修改配置一样，需要重启 NoneBot 才能生效。
- 概览页的「重启」按钮会发送
SIGINT让进程优雅退出，需要 NoneBot 进程由外部进程管理器托管（systemd / MCSManager autoRestart / pm2 / Dockerrestart=always等）才会自动重新拉起；未托管时进程会停止。
- Mimo Console 具有修改 dotenv、管理 Python 包、查看日志、禁用插件响应器和触发进程重启等高权限能力，其权限等同于运行 NoneBot 的系统用户。
- 不建议将 WebUI 直接暴露到公网；确需公网访问时，应在反向代理层启用 HTTPS、来源限制或额外认证。
- 不需要在线安装、更新和卸载插件时，建议设置
MIMO_CONSOLE_ALLOW_PACKAGE_MANAGEMENT=false。 - 管理员数据由
nonebot-plugin-localstore保存，不会写进插件安装目录。 - Token、Secret、Password、Cookie、API Key 等配置值默认脱敏。
- 配置修改会生成备份，重启 NoneBot 后生效；修改项目配置和依赖前仍建议自行备份。
- 自定义背景图保存在 localstore 数据目录，上传文件名随机化；远程 URL 仅允许 http/https，浏览器端加载，不做服务端可达性校验。
- “禁用插件”只会阻止对应插件的 Matcher 继续响应事件，不会停止其已注册的后台任务；Mimo Console 自身不可被禁用。
uv sync --all-groups
uv run poe test
uv run ruff check .
uv build项目使用 GPL-3.0 协议。
感谢M