From 1115445511d82d7b810ae2cb0aae3721352daa30 Mon Sep 17 00:00:00 2001 From: "astrbot-docs-agent[bot]" Date: Mon, 23 Feb 2026 14:33:49 +0000 Subject: [PATCH] docs: update for AstrBotDevs/AstrBot#5334 --- en/use/webui.md | 8 ++++++++ zh/use/webui.md | 10 +++++++++- 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/en/use/webui.md b/en/use/webui.md index 9869463..e5af558 100644 --- a/en/use/webui.md +++ b/en/use/webui.md @@ -45,6 +45,14 @@ You can also click the + button in the bottom right corner to manually install p If a plugin fails to load, the admin panel will display the error message and provide a **"Try one-click reload fix"** button. This allows you to quickly reload the plugin after fixing the environment (e.g., installing missing dependencies) or modifying the code, without having to restart the entire application. +Common causes of plugin load failures include: + +- **Missing dependencies**: Required Python libraries are not installed, usually showing `No module named 'xxx'` in the error message +- **Import errors**: Syntax errors or import issues in the plugin code +- **Registration failures**: Incorrect plugin metadata configuration + +After reloading a plugin, regardless of success or failure, the admin panel will automatically refresh the plugin list to display the latest status. If the reload succeeds, the plugin will resume normal operation; if it still fails, the panel will display the latest error information for further troubleshooting. + ## Command Management Use the `Command Management` menu on the left to centrally manage all registered commands; system plugins are hidden by default. diff --git a/zh/use/webui.md b/zh/use/webui.md index f52f4a3..866e310 100644 --- a/zh/use/webui.md +++ b/zh/use/webui.md @@ -43,7 +43,15 @@ AstrBot 管理面板具有管理插件、查看日志、可视化配置、查看 ### 插件加载失败处理 -如果插件加载失败，管理面板会显示错误信息，并提供 **“尝试一键重载修复”** 按钮。这允许你在修复环境（如安装缺失依赖）或修改代码后，无需重启整个程序即可快速重新加载插件。 +如果插件加载失败，管理面板会显示错误信息，并提供 **"尝试一键重载修复"** 按钮。这允许你在修复环境（如安装缺失依赖）或修改代码后，无需重启整个程序即可快速重新加载插件。 + +常见的插件加载失败原因包括： + +- **依赖缺失**：插件所需的 Python 库未安装，错误信息通常显示 `No module named 'xxx'` +- **导入错误**：插件代码存在语法错误或导入问题 +- **注册失败**：插件元数据配置不正确 + +重载插件后，无论成功与否，管理面板都会自动刷新插件列表以显示最新状态。如果重载成功，插件将恢复正常运行；如果仍然失败，面板会显示最新的错误信息以便进一步排查。 ## 指令管理