演示

已安装但前端模块未加载

模块显示已安装，但浏览器中看不到菜单、路由或插件前端入口。

现象

Modules UI 可能显示 installed=true，但 shell 从未注册插件 UI——无侧栏菜单、路由空白，或网络面板中没有前端包。

检查清单

  • 确认 installed-plugins/<name>/ 含 frontend/ 与 module.metadata.json
  • 目录名、metadata.name、Modules 表名称必须一致
  • quan-erp watch 后重新 Install（或确认已刷新 installed 副本）
  • 强制刷新浏览器；在 Network 中检查插件前端入口
  • 查看控制台中 register() / import 错误
  • 若声明了 pluginDependencies，依赖插件须先安装并加载

源码 / available / installed

watch 只写入 available-plugins；shell 加载 installed-plugins。

  • 源码 — plugins/<name>/frontend/
  • 可安装 — base/available-plugins/<name>/<version>/frontend/
  • 已安装 — base/backend/installed-plugins/<name>/frontend/
插件生命周期 →目录结构 →

入口必须导出 PluginModule

shell 只加载 frontend/src/index.tsx。请 default export PluginModule，并在 register(AppRegistry) 中注册路由/菜单。

  • 缺少或错误的 default export → 永不注册
  • register() 抛错 → 查看控制台并重建
  • 在 register() 外添加的路由/菜单会被忽略