中国 帮助

可视化开发台

宿主后台内置了一个插件开发页面,把「新建骨架、本地安装、一键开发、启动后端、启动前端、热加载、监听、打包」从命令行搬到了浏览器里。 入口:开发工具 → 插件开发(前端组件 appstore/dev/index,权限 app:dev:view

可视化开发台
封面

> 本文整理自平台文档 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容