Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

Commit 1115445

Browse files
author
astrbot-docs-agent[bot]
committed
docs: update for AstrBotDevs/AstrBot#5334
1 parent 7f682f5 commit 1115445

2 files changed

Lines changed: 17 additions & 1 deletion

File tree

en/use/webui.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,14 @@ You can also click the + button in the bottom right corner to manually install p
4545

4646
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.
4747

48+
Common causes of plugin load failures include:
49+
50+
- **Missing dependencies**: Required Python libraries are not installed, usually showing `No module named 'xxx'` in the error message
51+
- **Import errors**: Syntax errors or import issues in the plugin code
52+
- **Registration failures**: Incorrect plugin metadata configuration
53+
54+
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.
55+
4856
## Command Management
4957

5058
Use the `Command Management` menu on the left to centrally manage all registered commands; system plugins are hidden by default.

zh/use/webui.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,15 @@ AstrBot 管理面板具有管理插件、查看日志、可视化配置、查看
4343
4444
### 插件加载失败处理
4545

46-
如果插件加载失败,管理面板会显示错误信息,并提供 **“尝试一键重载修复”** 按钮。这允许你在修复环境(如安装缺失依赖)或修改代码后,无需重启整个程序即可快速重新加载插件。
46+
如果插件加载失败,管理面板会显示错误信息,并提供 **"尝试一键重载修复"** 按钮。这允许你在修复环境(如安装缺失依赖)或修改代码后,无需重启整个程序即可快速重新加载插件。
47+
48+
常见的插件加载失败原因包括:
49+
50+
- **依赖缺失**:插件所需的 Python 库未安装,错误信息通常显示 `No module named 'xxx'`
51+
- **导入错误**:插件代码存在语法错误或导入问题
52+
- **注册失败**:插件元数据配置不正确
53+
54+
重载插件后,无论成功与否,管理面板都会自动刷新插件列表以显示最新状态。如果重载成功,插件将恢复正常运行;如果仍然失败,面板会显示最新的错误信息以便进一步排查。
4755

4856
## 指令管理
4957

0 commit comments

Comments
 (0)