上架不是传个 zip
一个能被安装的应用包有固定结构:app.json 清单、route-index.json 路由、后端 jar、frontend/ 前端产物、migrations/ 迁移脚本,以及 signature.txt 签名。包检查器会扫路径穿越、非法条目与清单字段;主题包的资源统一放在 frontend/themes/<code>/ 与 frontend/templates/cms/<code>/ 下,和插件包走同一套规范。

中心目录存什么
中心库里有两层台账:app_info 存应用(编码、名称、类型、作者、标签、安装模式、最新版本、状态),app_version 存版本(版本号、包地址、包大小、校验值、变更日志、清单 JSON)。类型现在只有应用 / 插件 / 主题三类 —— 内置模块是宿主自带功能,由 ModuleAppInstaller 注册菜单,没有可安装产物,不该出现在市场里。
清单 JSON 很关键:租户侧装应用时,菜单、权限与前端路由都从它解析,导入时字符集不对会直接把乱码名字带进租户侧,所以种子 SQL 头部必须声明 SET NAMES utf8mb4。
租户点「安装」之后

后端不是解压完就算完,而是一条逐步记录的任务:下载包 → 校验签名与大小 → 落盘到 plugins-dist → 执行迁移脚本 → 注册菜单与权限 → 刷新路由 → 装载插件运行时。每一步都有日志,失败时能一眼看到断在哪。
升级复用同一条链,只是把「落盘」换成「备份旧包 + 换新包」,迁移按编号增量执行。卸载反过来,但菜单归属规则决定了哪些节点能删、哪些是用户改过要保留的。
关于版本
同一个应用的版本号在三个地方要同步:app.json 的 version、assets.backend 里的 jar 文件名、README 里的版本号与 jar 名。漏一处,装上去的表现就是「版本对不上包」。仓库里有个 bump-app-version.cjs 专门干这件事,别手改。


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