扩展阅读 / 升级机制

升级机制

更新于 2026-11-11 阅读 269 完整包、补丁包与回滚流程。 Markdown

升级流程

后台「在线升级」会依次执行以下步骤，全部通过后才会替换文件：

拉取 market_url 的市场清单，对比本地核心版本；
下载整包或增量补丁包，校验签名与 md5；
备份当前核心与主题到 storage/backups；
执行补丁包内的 manifest.json 文件清单，写入新增、覆盖变更、删除废弃文件；
执行 sql 字段中的升级语句，刷新缓存。

升级前请确认 storage/backups 可写，并保留最近一次完整备份。

补丁包 manifest 字段

字段	类型	说明
`app`	string	应用标识，如 `aurora`
`type`	string	`plugin` / `theme` / `source`
`from_version`	string	起始版本
`to_version`	string	目标版本
`mode`	string	固定为 `patch`
`files`	array	变更文件与 md5
`deleted`	array	需要删除的文件

manifest 示例

{
  "app": "aurora",
  "type": "theme",
  "name": "Aurora",
  "from_version": "1.2.0",
  "to_version": "1.3.0",
  "mode": "patch",
  "files": [{"path": "index/index.html", "md5": "9f2c..."}],
  "deleted": ["assets/legacy.css"]
}

回滚

补丁升级失败时不会删除备份；
在「核心版本」页选择历史版本，重新上传整包即可回滚；
数据库变更请按 sql 字段手动确认，平台不会自动执行破坏性语句。

更多细节见应用市场升级说明。