本地开发与联调方案

// run/halo/app/plugin/PluginProperties.java
/** Runtime Mode：development/deployment. */
private RuntimeMode runtimeMode = RuntimeMode.DEPLOYMENT;

/** ... In the development mode, you can specify the plugin path as the project directory. */
private List<Path> fixedPluginPath = new ArrayList<>();

/** Extended Plugin Class Directory. */
private List<String> classesDirectories = new ArrayList<>();

/** Extended Plugin Jar Directory. */
private List<String> libDirectories = new ArrayList<>(List.of("build/libs"));

niucloud/
├── addon/
│   └── hello_world/
│       ├── admin/        管理端前端源码（api / assets / lang / layout / views）
│       ├── app/          后端业务代码（adminapi / api / dict / job / listener / model / service / validate）
│       ├── compile/      编译目录（admin / aliapp / wap / weapp / web）
│       ├── uni-app/      手机端前端源码
│       ├── web/          web 端前端源码
│       ├── sql/          install.sql / unInstall.sql（安装/卸载时自动执行）
│       ├── package/      依赖包（admin-package.json / composer.json 等）
│       ├── Addon.php     生命周期：install / uninstall / upgrade
│       └── info.json     插件配置（title / key / version / type / support_version）

# ① 平台构件进本地仓库（插件以已发布构件形式依赖平台；平台升级后要重跑）
cd wujies-platform
& $mvn -B -pl wujies-admin -am install -DskipTests

# ② 起宿主 —— ⚠️ 工作目录必须是 wujies-platform/
#    deploy 下两个路径都是相对路径，在别处起会让产物落到错误位置
java "-Dloader.path=plugins-dist" "-Dspring.profiles.active=dev" -jar "wujies-admin\target\wujies-admin.jar"

# ③ 另开一个终端：宿主前端 dev server
cd ..\plus-ui
npm run dev                       # 80 端口，/dev-api 代理到 127.0.0.1:8086

# ④ 再开一个：插件前端，把产物直接落到宿主 dev server 认的目录
cd ..\wujies\wujies-plugins
$env:WUJIES_UI_DIR       = 'C:\Users\TX\Desktop\ruoyi\plus-ui'
$env:WUJIES_FRONTEND_DIST = 'C:\Users\TX\Desktop\ruoyi\plus-ui\app-market-dist\remote-apps'
pnpm --filter @wujies-plugins/hello-app run build

cd wujies\wujies-plugins

# 插件的 vite.config.ts 用 defineRemoteApp()，产物是纯静态 ESM
$env:WUJIES_UI_DIR = 'C:\Users\TX\Desktop\ruoyi\plus-ui'
pnpm --filter @wujies-plugins/hello-app run build

# 把 dist 推到远程宿主的 remote-apps 目录（路径 = 宿主的 app-market.deploy.frontend-dir/<appCode>）
scp -r .\frontend\hello-app\dist\* user@host:/path/to/wujies-admin/app-market-dist/remote-apps/hello/

app-market:
  plugin-runtime:
    # 默认 false；打开后才有 POST /app/dev/reload。⚠️ 仅本地/内网联调
    dev-mode: true
    # 可选：只允许加载这个目录之下的 jar（默认空 = 不限制任何绝对路径）
    dev-base-dir: ""

⚠️ 插件开发模式已开启（app-market.plugin-runtime.dev-mode=true）—— 仅用于本地联调，绝不要在生产打开
   · 开发端点：POST /app/dev/reload（body: appCode + path），需登录 + 权限 app:dev:reload
   · 它会**绕过**包白名单 / MD5 / SHA256 / **签名**校验（不经过 AppPackageDeployService），并且**不写** active-plugins.txt
   · ⚠️ 未限制可加载路径（app-market.plugin-runtime.dev-base-dir 为空）—— 任何绝对路径上的 jar 都能被加载

# ① 重建插件 jar —— 只 build，**不打包 zip、不签名**（dev-mode 不验签）
#    在插件仓库根（wujies-plugins/）：模块名是目录名，产物在 <模块>/target/
& $mvn -B -pl wujies-hello -am package -DskipTests
#    → wujies-hello\target\wujies-hello-plugin-<maven 版本>.jar

# ② 一条命令热加载（宿主不重启）
$base   = 'http://<host>:8086'        # ← 你的宿主地址
$token  = '<你的登录 token>'           # ← 浏览器里 Authorization 头的值去掉 "Bearer " 前缀之后的那串
$tenant = '000000'

curl.exe -s -X POST "$base/app/dev/reload" `
  -H "Authorization: Bearer $token" -H "tenant-id: $tenant" `
  -H "Content-Type: application/json" `
  -d '{"appCode":"hello","path":"<插件仓库绝对路径>/wujies-hello/target/wujies-hello-plugin-1.0.0.jar"}'

{ "code": 200, "data": {
  "appCode": "hello",
  "path": "<解析后的绝对路径>",
  "jarFileName": "wujies-hello-plugin-1.0.0.jar",
  "devMode": true,
  "signatureVerified": false,          // ← 如实告诉你：这条路径没验签
  "activePluginsFileTouched": false,   // ← 没写 active-plugins.txt
  "unloadedPrevious": true,            // ← 本次是先卸了上一代再装的
  "componentCount": 150,
  "endpointCount": 224,
  "mapperCount": 26,
  "classLoader": "PluginClassLoader[hello <- wujies-hello-plugin-1.0.0.jar]",
  "elapsedMs": 148
} }

$base   = 'http://<host>:8086'
$token  = '<你的登录 token>'
$tenant = '000000'
$appId  = <hello 的 appId>

# ① 打包（含前端构建、组装、签名 —— enforce 模式必须签）
#    产物默认落在**仓库外**的 ..\.plugin-dist\<code>\<version>\，见「打包应用」一页
& .\package.ps1 -Plugin wujies-hello -SigningKey keys\private.pem
#    （正式发版用 .\release.ps1 -Plugin wujies-hello：它还会打 git tag）

# ② 上传包（服务端解包读清单 → 落对象存储 → 回填 packageUrl/size/md5/sha256）
$parsed = curl.exe -s -X POST "$base/app/package/parse" `
  -H "Authorization: Bearer $token" -H "tenant-id: $tenant" `
  -F "file=@..\.plugin-dist\hello\1.0.1\hello-1.0.1.zip" -F "appId=$appId"

# ③ 部署（落位 + 热加载，不重启）
curl.exe -s -X POST "$base/app/version/<versionId>/deploy" `
  -H "Authorization: Bearer $token" -H "tenant-id: $tenant"

// plus-ui/src/plugins/appmarket/loader.ts:130-145
export function loadRemoteApp(entry: string): Promise<RemoteAppRecord> {
  const task = (async () => {
    const runtime = requireRuntime();
    // 变量说明符 + @vite-ignore：让 Vite/Rollup 保留为运行时 import，不参与打包
    const module = (await import(/* @vite-ignore */ entry)) as RemoteAppModule;
    return registerRemoteAppModule(module, entry, runtime);
  })();
}

// wujies-plugins/frontend/build/vite.ts:449-463
build: {
  outDir: opts.outDir ?? resolveOutDir(root, appCode),
  lib: { entry: path.resolve(root, 'src/index.ts'), formats: ['es'], fileName: () => 'index.js' },
  rollupOptions: { external: [...SHARED_EXTERNALS, ...(opts.extraExternals ?? [])] }
}

// plus-ui/vite/plugins/appMarketStatic.ts:26-30
const root = process.cwd();
const sourceDir = path.resolve(root, 'app-market-dist');
const urlPrefixes = ['/app-runtime/', '/remote-apps/'];

cd wujies\wujies-plugins
$env:WUJIES_UI_DIR        = 'C:\Users\TX\Desktop\ruoyi\plus-ui'
$env:WUJIES_FRONTEND_DIST = 'C:\Users\TX\Desktop\ruoyi\plus-ui\app-market-dist\remote-apps'

pnpm --filter @wujies-plugins/hello-app exec vite build --watch

# dev-loop.ps1 —— 打包 + 上传 + 部署同一版本（热加载，不重启宿主）
# 用法: .\dev-loop.ps1 -Plugin wujies-hello -AppCode hello
param(
  [Parameter(Mandatory)][string]$Plugin,          # 插件仓库里的模块名，如 wujies-hello
  [Parameter(Mandatory)][string]$AppCode,         # = app.json 的 code，如 hello
  [string]$Base     = 'http://127.0.0.1:8086',
  [string]$Token    = $env:WUJIES_TOKEN,
  [string]$Tenant   = '000000',
  [string]$SigningKey = 'keys\private.pem'        # enforce 模式下必填，否则上传被拒
)

$ErrorActionPreference = 'Stop'
$headers = @{ Authorization = "Bearer $Token"; 'tenant-id' = $Tenant }

function Invoke-Api($Method, $Path, $Body) {
  # ⚠️ 别把变量取名 $args —— 它在 PowerShell 里是保留的自动变量
  $req = @{ Method = $Method; Uri = "$Base$Path"; Headers = $headers }
  if ($Body) { $req.Body = ($Body | ConvertTo-Json -Depth 12); $req.ContentType = 'application/json' }
  (Invoke-RestMethod @req).data
}

# ---------- ① 打包（含前端构建、组装、签名） ----------
& .\package.ps1 -Plugin $Plugin -SigningKey $SigningKey
# 产物落在**仓库外**：..\.plugin-dist\<code>\<version>\<code>-<version>.zip
# （按 app.json 的 code / version 拼出来，比按文件名猜稳）
$ver = (Get-Content "$Plugin\app.json" -Raw -Encoding UTF8 | ConvertFrom-Json).version
$zip = Get-Item "..\.plugin-dist\$AppCode\$ver\$AppCode-$ver.zip"
Write-Host "包: $($zip.FullName)"

# ---------- ② 找 appId ----------
$app = Invoke-Api GET '/app/console/list' | Where-Object { $_.appCode -eq $AppCode } | Select-Object -First 1
if (-not $app) { throw "目录里没有应用 $AppCode —— 先在控制台登记它" }

# ---------- ③ 上传包，拿 packageUrl / 校验和 ----------
$parsed = (curl.exe -s -X POST "$Base/app/package/parse" `
  -H "Authorization: Bearer $Token" -H "tenant-id: $Tenant" `
  -F "file=@$($zip.FullName)" -F "appId=$($app.appId)") | ConvertFrom-Json
if ($parsed.code -ne 200) { throw "上传失败: $($parsed.msg)" }
$pkg = $parsed.data
Write-Host "已上传: routeIndexSource=$($pkg.routeIndexSource) routePatternCount=$($pkg.routePatternCount)"

# ---------- ④ 复用版本行；没有就新建一条 ----------
$ver = Invoke-Api GET "/app/version/list?appId=$($app.appId)" | Select-Object -First 1
if ($ver) {
  $versionId = $ver.versionId
  # ⚠️ 已发布的版本不允许改清单；这里只把 packageUrl 指到新包（字段名以 deploy 的报告为准）
  Invoke-Api POST "/app/version/$versionId/repack" @{ packageUrl = $pkg.packageUrl } | Out-Null
} else {
  # manifestJson 取自包内 app.json（parse 已经把清单解出来了）
  $versionId = Invoke-Api POST '/app/version' @{
    appId        = $app.appId
    manifestJson = $pkg.manifestJson
  }
}
if (-not $ver) { Invoke-Api POST "/app/version/$versionId/publish" | Out-Null }

# ---------- ⑤ 部署 = 落位 + 热加载（不重启） ----------
$report = Invoke-Api POST "/app/version/$versionId/deploy"
if ($report.hotLoaded) {
  Write-Host "✓ 热加载成功: $($report.hotLoadNote)" -ForegroundColor Green
} else {
  Write-Warning "未热加载 (restartRequired=$($report.restartRequired))；产物已落位，重启会生效"
  if ($report.staleJars) { Write-Warning "旧 jar 删不掉: $($report.staleJars -join ', ')" }
}

一个人独立开发，能随便重启宿主           → 方案 A
改前端，宿主在哪都行                     → 方案 A 第④步（本地）或方案 B-1（远程 scp，秒级）
改后端，宿主开了 dev-mode                → 方案 B-2：重建 jar + POST /app/dev/reload（秒级）← 首选
改后端，宿主没开 dev-mode                → 方案 B-2 旧做法，或用方案 D 压成一条命令
想给远程宿主配 HMR                       → 方案 C：不可行，用 `vite build --watch` 代替
宿主本身（plus-ui / wujies-platform）    → 不在本页，见 /plugin-dev/backend/local-dev