docs: add update-check contract (T-559 done)
Tests / Python 3.11 / Windows (push) Has been cancelled

新增 docs/update-check.md:版本检查接口的服务端响应契约、客户端字段读取、
强制规则与发版约定(方案A force_update / 方案B min_supported_version);
README 加索引;T-559 标 DONE。客户端无需改代码(T-544 已实现)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-07-08 14:46:03 +08:00
co-authored by Claude Opus 4.8
parent 94e28203d0
commit 46adc32e2d
3 changed files with 112 additions and 2 deletions
+5 -2
View File
@@ -3,7 +3,7 @@ id: T-559
title: 版本检查响应契约 + 强制升级约定(force_update)固化进仓库
phase: 7
deps: [T-544]
status: TODO
status: DONE
created: 2026-07-08
---
@@ -45,4 +45,7 @@ created: 2026-07-08
## 执行记录
(做完在此记录:改了哪些文件、跑的验证命令与结果、决策)
- 2026-07-08:完成 T-559。
- 文档:新增 `docs/update-check.md`——接口/客户端字段读取(对照 `app/update_check.py` 的 `parse_update_info`/`is_forced_update`:`version`|`latest_version`、`force_update`、`min_supported_version`、`download_url`、`sha256`、`release_notes`|`message`,顶层或 `release` 里都认)/强制规则/客户端行为(T-544 已实现)/失败放行/发版约定(方案A `force_update:true`、方案B `min_supported_version`)/三份示例响应。`docs/README.md` 加索引一行。
- 未改客户端代码:`app/update_check.py`/`app/version.py`/启动流程按契约已实现(T-544);服务端返回 `force_update` 属本仓库外配置。
- 验证:纯文档任务,字段逐条对照 `app/update_check.py` 源码确认一致;未跑单测(无代码改动)。