docs: add client release api integration guide

2026-07-07 08:38:07 +08:00
parent 5f17235a13
commit be8f6e5fac
4 changed files with 247 additions and 0 deletions
@@ -1445,3 +1445,13 @@
  - `git diff --check`：通过，仅 Windows CRLF 提示。
 - 决策：T-607 不继承 `ExternalApiView`，避免要求 API Key；也不挂 `GenerateRateThrottle`，避免版本检查占用生成额度。文件下载地址按请求生成绝对 URL；生产 HTTPS 由已有 proxy/HTTPS 配置保证。
 - 下一步：看板当前无新的编号任务；建议继续按业务优先级拆真实支付回调到账闭环、客户端下载包发布或真实图片耗时验证。
+
+## 2026-07-07 文档：桌面端版本检查接口对接 Demo
+
+- 状态：DONE。
+- 变更：
+  - 新增 `docs/client-release-api-integration.md`，整理 `GET /api/v1/client/releases/latest` 的用途、生产/本地请求地址、参数、curl / PowerShell / Python / JavaScript 请求 demo、成功/暂未发布/错误响应、客户端版本比较、下载 SHA256 校验、服务端发布前置条件和排查清单。
+  - `docs/README.md`：登记新文档入口。
+  - `docs/api.md`：在版本检查接口段落补充对接文档链接。
+- 验证：纯文档修改；`git diff --check` 通过。
+- 下一步：按业务优先级继续处理真实支付回调到账闭环、客户端下载包发布或真实图片耗时验证。