可视化开发台

宿主后台内置了一个插件开发页面，把「新建骨架、热加载、打开发包」三件事从命令行搬到了浏览器里。 入口：应用上架 → 插件开发（前端组件 appstore/dev/index，权限 app:dev:view）。

这一页说明它能看到什么、每个按钮做了什么、背后调用了哪些接口，以及它刻意不做什么。

一次性配置复制标题链接

在宿主 application.yml：

app-market:
  plugin-runtime:
    dev-mode: true
    # 插件仓库绝对路径；留空时自动探测（见下表）
    plugin-repo: ""
    # 可选：热加载只允许这个目录下的 jar；留空 = 不限制
    dev-base-dir: ""

改完重启宿主。启动日志会打印开发模式告警、可加载路径是否受限，以及开发端点地址。

plugin-repo 留空时，服务端按以下候选顺序探测（相对于宿主进程工作目录）：

plugins
wujies/wujies-plugins
../wujies-plugins
../wujies/wujies-plugins
../../wujies/wujies-plugins
../../../wujies/wujies-plugins
../plugins

命中条件是目录里同时存在 package.ps1 与 wujies-hello/。找不到时页面会提示，插件列表为空。

页面上的四块内容复制标题链接

1. 状态概览复制标题链接

2. 仓库插件复制标题链接

扫描插件仓库下所有 wujies-*/app.json，每个插件一行：

「命令」弹窗给出三条可直接复制的命令：后端构建、前端构建、命令行打开发包。 页面不会替你执行构建。

3. 已加载运行时复制标题链接

热加载成功后出现一行，数据来自 PluginRuntimeManager 的运行时快照：

4. 三个动作复制标题链接

新建插件复制标题链接

填写编码、名称、简介、版本、是否生成前端，服务端在插件仓库执行：

node scripts/new-plugin.mjs --code <code> --name <name> --version <version>
     [--description <description>] [--no-frontend]

生成内容与命令行完全一致：后端最小 CRUD 工程、可选前端工程、app.json、迁移脚本， 并自动登记到仓库根 pom.xml。结果弹窗会显示两个目录、生成日志和可复制的下一步命令。

约束：编码 ^[a-z][a-z0-9]{1,31}$，名称 ≤ 40 字，版本语义化；目标目录已存在时直接拒绝， 不会覆盖已有代码。

热加载复制标题链接

弹窗预填 appCode 与该插件最新的 jar 路径，也可以填一个只含一个 jar 的目录。 调用：

POST /app/dev/reload
Content-Type: application/json

{ "appCode": "demo", "path": "C:/.../wujies-demo/target/wujies-demo-plugin-1.0.0.jar" }

行为是「先卸载上一代，再装载新 jar」，重复调用幂等。报告里会返回接口数、组件数、Mapper 数、 耗时与类加载器名。重启宿主后需要重新热加载一次。

打开发包复制标题链接

不需要再填表：服务端按 code 找到插件目录，把已经构建好的产物组装成一个 zip：

<插件仓库的上一级>/.plugin-dist/<code>/dev/<code>-<version>.zip
  ├── app.json
  ├── backend/<jar>
  ├── frontend/**          （存在前端 dist 时）
  └── migrations/*.sql     （存在迁移脚本时）

它不触发 Maven / pnpm 构建。如果页面提示找不到后端 jar 或前端 dist，先在终端执行 「命令」弹窗里的构建命令，或直接跑 package.ps1。

开发包不签名，适合 security.mode=warn/off 的部署或本地展开核对； enforce 模式下不能上传安装。需要安装或上架时，用打包应用里的正式流程。

接口一览复制标题链接

所有接口都只在 dev-mode=true 时存在，关闭时返回 404。

POST /app/dev/package 的请求体只有 { "code": "demo" }；响应包含 zipPath、size、 entries、signed=false 与一句说明。

{
  "devMode": true,
  "devBaseDir": "",
  "pluginRepo": "C:/Users/.../wujies/wujies-plugins",
  "nodeVersion": "v24.18.0",
  "reloadEndpoint": "POST /app/dev/reload",
  "loaded": [
    { "appCode": "demo", "jar": "...", "endpoints": 6, "components": 12,
      "mappers": 1, "converters": 1, "classLoader": "PluginClassLoader[demo <- ...]" }
  ],
  "plugins": [
    { "dir": "wujies-demo", "code": "demo", "name": "演示应用", "version": "1.0.0",
      "valid": true, "jar": "...", "frontendDist": "...", "migrationCount": 1,
      "loaded": true, "buildCommand": "...", "frontendCommand": "...", "packageCommand": "..." }
  ],
  "hint": "热加载会绕过签名与包校验，只允许在开发环境开启。"
}

它不做什么复制标题链接

因此，一个完整的开发闭环是：

新建骨架 → 构建后端 → 热加载 → 验证接口
         → 构建前端 → 刷新页面
         → 首次安装一次（建表 + 菜单 + 落位）
         → 之后循环：改代码 → 构建 → 热加载 / 刷新

排查复制标题链接

更多运行时问题见故障排查；热加载的完整背景见 本地开发与联调方案。

相关阅读复制标题链接

• 快速开始 —— 从新建到打包的完整第一遍
• 打包应用 —— -Dev 与正式包的区别、产物结构
• 插件运行时 —— 类加载与热加载的实现
• 应用生命周期 —— 安装、升级、卸载与菜单同步