> 本文整理自平台文档 docs/wujies/5.x/platform/plugin/console.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-18735aa5ce90-cover.svg)
宿主后台内置了一个插件开发页面,把「新建骨架、本地安装、一键开发、启动后端、启动前端、热加载、监听、打包」从命令行搬到了浏览器里。 入口:开发工具 → 插件开发(前端组件 appstore/dev/index,权限 app:dev:view)。
这一页说明它能看到什么、每个按钮做了什么、背后调用了哪些接口,以及它刻意不做什么。
它的模型和 [Halo 的插件开发](https://docs.halo.run/developer-guide/plugin/basics/devtools)一致: 直接加载插件工程的编译输出(target/classes),每次重载换一代类加载器,宿主不重启。 开发台把 Halo 的两个启动动作也搬了过来:
| Halo 插件模板 | Wujies 开发台 | 做什么 |
|---|---|---|
./gradlew haloServer + npm run dev | 一键开发 | 首次先安装(迁移 + 菜单),再编译 → 加载 → 监听 → 前端 watch,一次做完 |
./gradlew haloServer | 启动后端 | 按需编译 → 加载 target/classes → 开启监听 |
npm run dev(vite build --watch) | 启动前端 | 常驻增量构建前端工程的 dist/,刷新页面生效 |
这三者都不需要把插件源码挂进宿主 Maven 模块,也不需要为了改一行 Java 重新打 jar。
页面主体是一张插件列表(与应用管理页同一套写法):搜索栏 + 状态 tab + 表格, 每行的主按钮就是「一键开发」(未安装时显示「安装并开发」),手动操作收在行末的「更多」里。 名称列后面的两个标签都来自工程自己:前一个是分类「应用 / 插件」,读 app.json 的 type (app 显示应用,其余显示插件;判据见[应用清单](/docs/wujies/5.x/platform/plugin/basics/manifest)), 后一个是布局标签(应用仓库都是「独立仓库」)。 改代码、加权限 / 菜单 / 表 / 版本号等约定见 [插件开发](/docs/wujies/5.x/platform/plugin) 与[应用清单](/docs/wujies/5.x/platform/plugin/basics/manifest); 只想敲命令、不用页面时见 [手动开发与本地运行](/docs/wujies/5.x/platform/plugin/manual-run)——对应 Halo 的传统开发方式。
页面依赖 app-market.plugin-runtime.dev-mode=true。开关关闭时后端不会注册相关接口与控制器, 页面打开会显示「开发模式未就绪」,并给出配置提示。绝不要在生产环境开启。
一次性配置
和 Halo 一样,只有两个键:开关 + 插件工程的位置。
app-market:
plugin-runtime:
dev-mode: true
# 留空 = 默认扫描项目根的 plugins/(其中的插件工程全部加载)
fixed-plugin-path: []
# 也可以显式列出工程目录或插件容器:
# fixed-plugin-path:
# - C:\work\wujies\plugins\wujies-hello-plugin
# - C:\work\wujies\plugins # 目录里每个 wujies-*-plugin/ 都会加载
改完重启宿主(只有这一次)。宿主启动时会直接加载找到的每个插件工程 —— 前提是它已经有编译产物(target/classes 或 target/*.jar);没有产物只会在日志里告警并给出 编译命令,不会在启动流程里替你跑 Maven。
fixed-plugin-path 留空时,按以下位置找插件容器(目录里至少有一个 wujies-*/app.json):
plugins
../plugins
../../plugins
wujies/plugins
容器里的每个插件工程都会在启动时加载。 独立插件仓库放在 plugins/ 下即可被扫到,不必再逐个写进 fixed-plugin-path。
定位优先级恒为:fixed-plugin-path > 约定自动探测,同名应用只认优先级最高的那一份。
超级管理员天然持有 *:*:*,无需额外配置。其它账号需要被授予:
| 权限 | 能做什么 |
|---|---|
app:dev:view | 打开开发台、查看概览 |
app:dev:scaffold | 新建插件骨架 |
app:dev:install | 本地安装:落位产物、执行迁移、登记开发版本、同步菜单、加载后端 |
app:dev:reload | 启动后端、启动/停止前端监听、热加载,以及开启/关闭自动监听 |
app:dev:package | 打包抽屉的四个动作:体检、打包、生成/更换签名密钥、下载最近一次包 |
菜单与按钮 SQL 在 plugin_dev_menu.sql(⚠️ 已删除,取回 git show d0cc5cd90^:script/sql/update/plugin_dev_menu.sql;全新初始化已包含在 platform_init.sql 的 70300–70304)。按钮权限必须先加进菜单,才能在「角色管理」里勾选。
页面结构
### 0. 搜索与状态 tab
列表上方是一个搜索栏(按插件名称 / 编码过滤)与一排状态 tab:全部 / 运行中 / 未运行 / 清单异常, 计数随搜索条件实时变化(写法与应用管理页一致)。
- 运行中 = 已在宿主 JVM 里装载,或已开启后端监听;
- 未运行 = 工程扫得到但什么都没跑;
- 清单异常 =
app.json读不出来 / 校验不通过,这类行只能先修清单。
「新建插件」和「开发文档」在右上角;列表为空时空态里也给出这两个入口。 一条硬约束不变:应用不能单独启动 —— 后端跑在宿主的 JVM 子上下文里, 前端是宿主同源 import() 的 ESM 产物。
### 1. 状态概览
| 字段 | 含义 |
|---|---|
| 开发模式 | 固定显示「已开启」;接口 404 时整页会变成配置提示 |
| 插件路径 | fixed-plugin-path 配置值;为空时显示「默认扫描插件目录」 |
| Node | 宿主机器的 Node 版本;为空表示「启动前端」「新建插件」不可用 |
| Maven | 宿主进程能否定位到 Maven;未找到时「启动后端」无法编译(可配置 maven-command) |
| 运行中 / 监听 | 当前 JVM 里通过独立类加载器装载的插件数量,以及开启后端监听的插件数量 |
### 2. 启动即加载
fixed-plugin-path 里列出的插件工程(或未配置时 plugins/ 里的全部工程)会在宿主启动时直接加载, 和 Halo 的 halo.plugin.fixed-plugin-path 一样 —— 不用先上架、不用本地安装、不用点按钮。 加载失败不会拖垮启动:日志里给一条 ERROR,页面照常可以继续操作。
页面和接口只做两件事:把它列出来的工程找出来,以及给你一个不用重启的回路 (改代码 → mvn compile → 产物稳定后自动热加载)。列进来的目录立刻参与插件定位、 启动后端 / 前端、监听与打包,并且优先于自动探测的仓库 —— 「我 clone 的那份」不会被自动探测目录里的其它副本盖掉。
### 3. 插件列表
扫描所有搜索根里的插件工程(认每个 wujies-<code>-plugin/ 仓库根的 app.json), 每个插件一行。同一编码在多个根里都命中时只保留优先级最高的那个:
| 列 / 区域 | 内容 |
|---|---|
| 插件 | 名称 + 布局标签(独立仓库),第二行是编码与清单版本;鼠标悬停显示工程路径或清单错误 |
| 构成 | 前后端 / 纯后端 / 纯前端(按有没有 pom.xml、有没有前端工程判定) |
| 状态 | 运行中 / 未加载 / 清单异常,另加「已安装」「监听中」「前端监听」「后端有改动」「前端有改动」 |
| 更新时间 | 工程目录最近一次源码改动 |
| 操作 | 主按钮「安装并开发」/「一键开发」+「打包」+「更多」(打开应用、本地安装、启动后端、构建一次、启动/停止前端、前端日志、热加载、全部命令、停止开发) |
「已安装」看的是当前租户的安装台账(app_install),不是宿主里有没有加载过 —— 卸载之后会重新回到「安装并开发」。
「全部命令」弹窗给出可直接复制的命令:后端编译、前端构建一次、前端监听、命令行打包(先 -CheckOnly 体检、再出包 —— 就是抽屉里「打包」真正执行的那条),并展示插件工程、target/classes、前端源码与 dist 的绝对路径。编译与构建命令:
| 布局 | 后端编译 | 前端构建 |
|---|---|---|
| 独立插件仓库 | mvn -f <仓库根>/pom.xml compile -DskipTests | `cd <仓库根>/fron |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-18735aa5ce90-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。