升级指南

升级前必做

1. 完整备份：「媒体数据 - 数据备份」做一次全量备份，并下载到本地；
2. 记录当前版本号（仪表盘或「系统信息」可见）；
3. 如修改过主题或核心代码，先在本地环境验证新版本兼容性。

标准升级流程

1. 从下载页获取新版本安装包；
2. 解压后覆盖以下目录（不要删除你的数据目录）：

1. 保留不动：uploads/（用户数据）、storage/（运行时文件）、plugins/（已装插件）、core/config/database.php（数据库配置）；
2. 访问后台，系统检测到版本变化时自动执行数据库结构迁移（记录写入迁移日志表）；
3. 清理缓存（「系统维护 - 缓存设置」），逐页检查前台与后台。

应用市场升级

主题与插件可在「外观扩展 - 应用市场」中在线检测并升级新版本，升级前同样建议备份。

升级失败处理

• 页面报错：查看「系统维护 - 日志管理」定位异常；
• 结构迁移中断：从备份恢复后重新执行「系统维护 - 数据迁移」；
• 主题显示异常：确认主题版本与新系统匹配，必要时更新主题。

版本约定

BlogKit 版本号遵循语义化版本（主版本.次版本.修订号），次版本升级通常向后兼容；跨大版本升级请务必阅读发布说明中的不兼容变更清单。