Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions en/use/webui.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
10 changes: 9 additions & 1 deletion zh/use/webui.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,15 @@ AstrBot 管理面板具有管理插件、查看日志、可视化配置、查看

### 插件加载失败处理

如果插件加载失败,管理面板会显示错误信息,并提供 **“尝试一键重载修复”** 按钮。这允许你在修复环境(如安装缺失依赖)或修改代码后,无需重启整个程序即可快速重新加载插件。
如果插件加载失败,管理面板会显示错误信息,并提供 **"尝试一键重载修复"** 按钮。这允许你在修复环境(如安装缺失依赖)或修改代码后,无需重启整个程序即可快速重新加载插件。

常见的插件加载失败原因包括:

- **依赖缺失**:插件所需的 Python 库未安装,错误信息通常显示 `No module named 'xxx'`
- **导入错误**:插件代码存在语法错误或导入问题
- **注册失败**:插件元数据配置不正确

重载插件后,无论成功与否,管理面板都会自动刷新插件列表以显示最新状态。如果重载成功,插件将恢复正常运行;如果仍然失败,面板会显示最新的错误信息以便进一步排查。

## 指令管理

Expand Down