docs: define forced update check

2026-07-07 17:23:02 +08:00
parent 9ce4d2442e
commit 610a2304cc
4 changed files with 59 additions and 8 deletions
@@ -1405,3 +1405,11 @@
 - 测试：`tests/test_gui.py` 新增状态栏语义色、颜色重置、保存成功/无任务/失败路径等级覆盖。
 - 验证：`python -m unittest discover -s tests -p test_gui.py` 通过（99 tests）；`python -m ruff check app tests main.py` 通过；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（223 tests）。
 - 边界：只改 GUI 状态栏提示层和测试；未改业务流程、DB schema、AI HTTP、Excel、Shopee/CDP 或运行日志持久化。
+
+## 【2026-07-07】T-544 文档 · 启动时检查强制升级
+
+- 需求：启动程序后先请求服务器版本接口；如果线上版本高于当前程序版本且服务端要求强制升级，必须弹窗阻断进入主界面，要求用户升级。
+- 文档：`docs/06-tasks.md` 新增 T-544；`docs/packaging.md` 新增启动版本检查第一版方案、接口结构、版本比较规则、网络失败策略和手动覆盖更新流程；`docs/current-state.md` 将下一步任务更新为 T-544。
+- 第一版方案：只做“启动检查 + 强制弹窗 + 下载新版/退出程序”。命中强制升级时显示当前版本、线上版本、升级说明，点击「下载新版」用系统浏览器打开 `download_url`；不允许继续进入主界面。
+- 策略：只有服务端明确返回强制升级才阻断；网络失败、接口超时、JSON 非法或字段缺失时允许进入软件，避免服务器故障导致用户全部不可用。
+- 边界：第一版不自动下载并覆盖 `cmshopee.exe` 或 `_internal/`，不删除/覆盖 `data/`，不做 Launcher、后台替换、增量补丁、签名校验或回滚；本轮只更新文档，未改代码。