feat(update): add startup health rollback fuse

2026-07-13 12:23:46 +08:00
parent 04124060fc
commit f6db4f0d62
16 changed files with 481 additions and 14 deletions
@@ -319,3 +319,9 @@ cmshopee 的 cmhub 请求默认**绕过系统代理**（`ai.cmhub.use_system_pro
 - 若你的机器**必须走代理**才能上网，编辑 `data/config.json` 把 `ai.cmhub.use_system_proxy` 改为 `true`（注意：慢代理仍可能拖累图片下载）。
 - 若下载仍慢且 curl 也慢，则是 cmhub **媒体服务器本身慢**（如 Django 直接服媒体、单线程），属服务端问题，需在 cmhub 侧用 nginx/对象存储服 `/generated/images/`。
 - 调试期可临时把 ⑤「图片并发数」设 1 复测单张，排除并发因素。
+## 自动升级排障
+
+- 强制升级窗口显示“该版本自动升级曾失败”：本机已经自动回滚过相同版本和zip hash，为避免循环不会再次自动安装。等待管理员发布修复包/更高版本，或退出后人工覆盖可信发布包；不要删除 `data/`。
+- 升级后提示数据迁移冲突、数据目录不可写或Chrome配置错误：这是本地环境阻断，新版不会自动回滚。按原提示修复目录或Chrome配置后重新启动。
+- 自动升级失败的本地记录位于安装目录 `.cmshopee-update/logs/`、`transactions/` 和 `failed-versions.json`。提供排障材料前先检查并脱敏；程序不会自动上传日志。
+- 人工恢复时只覆盖 `cmshopee.exe`、`_internal/`、版本/说明/manifest和更新器，必须保留 `data/`。不要把 `.cmshopee-update/backup/` 当业务数据目录。