版本升级指南

升级前准备

1. 备份数据库：后台「设置 → 高级设置 → 导出设置备份」+ 数据库导出（宝塔面板一键备份 / mysqldump）；
2. 备份源码：将站点目录打包留存（至少保留 config.php 与 usr/ 上传目录）；
3. 确认站点进入维护模式（后台高级设置可开启，在线更新时会自动临时开启并恢复）。

升级步骤

1. 用新版本源码包覆盖站点文件（保留 config.php 与 usr/uploads、usr/cache）；
2. 访问 https://你的域名/upgrade.php，脚本会读取数据库版本（vd_options.db_version）并执行所有更高版本的迁移块；
3. 看到「升级完成（数据库版本：x.y.z）」即成功；也可以命令行执行：php upgrade.php；
4. 到后台确认版本号、抽查前台各页面。

迁移块是幂等的

upgrade.php 按 version_compare 分段执行（如 1.4.1 建索引、1.4.2 建归档计数物化表），每段只在旧版本执行一次；索引/表创建均先判断存在，可重复安全运行。1.4.1 起自动补齐百万级所需的两张复合索引，1.4.2 自动创建 vd_archive_stats 物化计数表。

常见问题

• 升级后报 Key doesn't exist：多为索引未建，重跑 upgrade.php 或确认 1.4.1 迁移块执行；
• 升级后前台 500：检查 PHP 版本是否满足 8.1+，或清空 usr/cache/ 下缓存文件；
• 双语站升级：英文列由 english-admin 插件管理，核心升级不会动英文数据。