升级助手（Upgrade Assist）

v3.2.4（2026-11-12）

一句话：升级前先备份、先体检，出问题一键还原。

功能清单

备份

1. 「立即备份」：把整站文件和数据库一起打包成快照，带完整文件清单和校验值，可精确还原。
2. 备份列表：每份显示编号、时间、站点版本、文件数、体积、是否含数据库；可下载、可删除。
3. 超过保留份数自动清理最旧的；「还原前自动留的那份」和「升级前备份」永远不参与清理。
4. 同一个数据库里装了多个站时，只导本站自己那套表（按表前缀识别），不会把别的站的表带进备份，还原时也不会覆盖别人。

体检

1. 26 项检查：PHP 版本与扩展、数据库、Web 服务器、磁盘余量、插件状态、目录权限。
2. 可修项一键修复，修完自动复查，不靠返回码骗人。

升级

1. 选版本 → 按该版本的要求逐项检测 → 备份 → 升级，四步在同一个弹窗里走完。
2. 没有备份不允许升级，先去备份一份。
3. 升级中途崩了自动回滚到升级前。
4. 卡在「文件已替换」阶段时，可以只补收尾（依赖安装 + 数据库迁移），不用从头再来。

还原

1. 选一份备份点「还原」：把它里面的文件写回站点。
2. 还原前自动再留一个恢复点，还原错了还能退回。
3. 默认不动数据库；勾选「同时还原数据库」才会导入。

救站

1. 站点或后台打不开时，可以在 SSH 里自行执行插件自带的回滚代码，直接退回升级前的备份。
2. 这段救援代码随插件一起提供，不需要额外安装任何东西，也不依赖后台或框架是否能跑起来。
3. 它按宝塔 / aaPanel 的目录约定工作；在别的面板或裸机上会先检测出不对，把缺什么说清楚，然后停下，不动任何文件。
4. 还原完会冒烟验证，依次试四个地址（配置里的 APP_URL → https 域名 → http 域名 → 本地回环带 Host 头），站点目录名和域名不一致时也不会误报「救不回来」。

插件台账

1. 一屏列出所有已装插件：标识、名称、版本、是否启用、磁盘占用、有无建表脚本。
2. 升级后回来对个数：备份时是 N 个，现在少了一个，就是被官方升级删掉的。

操作记录

• 谁在什么时候备份、升级、还原、修复过，全部留痕。

环境要求

1. BeikeShop v1.0.0 – v2.0.0。
2. PHP 8.0+（跨大版本升级时按目标版本要求提示切换）。
3. storage/app 可写（存备份），MySQL 5.7+ / 8.0。
4. 救站命令按 宝塔 / aaPanel 的目录约定工作（/www/wwwroot、/www/server/php、www 运行用户）。在其他面板或裸机上执行会被内置检测拦下并说明缺什么，不会误动站点。除救站命令外的全部功能（备份、体检、升级、还原、台账）不依赖面板。

兼容环境

在哪里看到它

• 后台顶栏「更新」按钮（有新版本时带红点）。
• 插件列表里点「设置」进入操作台。

通行验证

1. 进操作台后要先过一次验证，通过后才能备份、升级、还原、删备份。
2. 两种方式二选一（推荐动态口令）：
   • 动态口令：手机上的微软验证器 / 谷歌验证器 / 1Password 等任意 TOTP 软件。
   • 二级通行密码：单独设一个只用于本页面的密码（至少 8 位），和后台登录密码完全分开。
3. 绑定动态口令时给出一组一次性恢复码，抄下来收好。
4. 验证通过后放行 10 分钟，到点自动收回；连续输错 5 次锁 15 分钟。
5. 没通过验证时，危险按钮根本不会输出到浏览器，服务端另有一道拦截。

站点崩了怎么退

网页进不去的时候（升级后白屏 / 500），后台的「还原」点不了。这时用 SSH，在站点根目录执行插件自带的回滚代码即可退回升级前的备份。

这段代码不依赖框架、不依赖后台、不需要安装任何东西——插件装上它就在，直接执行就能用。

前提：服务器是宝塔 / aaPanel。其他面板上脚本会先检测出不对，把缺哪个目录告诉你，然后停止，一个文件都不动。

它做什么：先把当前状态存一份以备反悔 → 清空代码目录（保留运行目录、上传文件、配置）→ 解开备份覆盖回去 → 恢复配置文件 → 修正文件属主 → 导入数据库 → 清缓存 → 按备份里的版本对齐 PHP → 最后冒烟（请求一次首页确认能开）。

为什么用它

1. 升级前先看清楚：这台服务器到底满不满足目标版本的要求，不是猜。
2. 升级前先存一份：文件 + 数据库都能退。
3. 升级崩了能退：后台一键，或者 SSH 一条。
4. 升级后能对账：装了几个插件、少了哪个，一目了然。