核心与插件升级

两条升级线：插件（应用）与主程序（核心），集中在 app/controller/plugin/StoreController.php（/plugin/store）；插件装配本身在 app/controller/plugin/AppController.php（/plugin/app）。

插件（应用）管理 /plugin/app

管理应用：已安装插件列表、启停、重载、备份、打包、Composer 依赖管理

扫描、创建、安装、启用/停用、卸载、打包、备份与依赖管理：

方法	作用
index/read/readByName	列表、按 id/按 name 详情（readByName 供宿主路由 /plugin-app/{name} 打开插件）
save/update/checkName	创建/编辑插件、检测标识可用性
auth	保存插件可见范围（哪些角色/主体能用）
menuOptions	插件可选菜单项
scan	扫描 plugin/ 目录下的插件
install/uninstall	安装/卸载（卸载自动备份）
enable/disable/reload	启用/禁用（自动平滑重启 worker）/重载清单
scaffold	重新生成插件模板
package/packageInspect	生成安装包/预检安装包
backup/installPackage/restorePackage	备份/安装 zip 包/恢复备份包
dependency/save/update/delete	维护插件间依赖
composer/check/install/status/reload	插件 Composer 依赖检测/安装/进度查询/重载生效

安装/升级的机制（占位符替换、幂等 SQL、升级脚本、composer.require 装包与卸载清理、forgetByOwner 反清注册）见安装与升级与生命周期。

应用插件与升级 /plugin/store

应用中心：主程序版本检查、授权状态、在线应用市场、插件一键安装/升级

方法	作用
index/read/categories	市场列表、详情、分类
install/update	从市场安装 / 更新应用
check-update	检查已装应用更新
system-update / system-update/plan / system-update/execute / system-update/status	主程序升级：检查、生成计划、执行、查进度
market/login/status/logout	绑定/查看/解绑市场账号
license/index/refresh	授权列表与刷新

兼容性判定

插件与基座是否兼容看 manifest.support_version（示例 am_demo 声明 support_version: 1.0.1）。框架能力以代码为准，跨大版本不保证接口稳定，升级前先看更新日志。

主程序升级

核心升级涉及覆盖 am-serve/ 目录（保留 .env、plugin/、runtime/、secrets/），执行前务必先把插件备份/备份表数据做完整快照、并在维护态（APP_MAINTENANCE=true）下执行。