feat: 更新下载接口和文档，支持安装包下载和版本检测

backend/app/main.py

@@ -108,8 +108,8 @@ app.add_api_route("/admin/logout", admin_logout, methods=["GET"], include_in_sch
 _DOWNLOAD_ROOT = Path(__file__).resolve().parent.parent  # backend/
 
 
-@app.get("/download", include_in_schema=False)
-@app.get("/11", include_in_schema=False)
+@app.get("/download")
+@app.get("/11")
 async def download_installer():
     """下载 Windows 客户端安装包（backend/ 下 *.setup.exe，如 云超服..._x64-setup.exe）。"""
     for f in sorted(_DOWNLOAD_ROOT.glob("*setup.exe")):
@@ -146,7 +146,7 @@ class UpdateCheckBody(BaseModel):
     current: str = ""   # 前端上报的当前版本，如 0.1.0
 
 
-@app.post("/api/update/check", include_in_schema=False)
+@app.post("/api/update/check")
 async def update_check(body: UpdateCheckBody):
     """检测更新：返回最新版本号、安装包下载地址、是否需要更新（仅 Windows）。"""
     inst = _latest_installer()

docs/update-check.md

@@ -0,0 +1,67 @@
+# 客户端更新检测与安装（Windows）—— 接口文档
+
+> 展播端（Tauri Windows 应用）检测后端是否有新版本安装包，下载并启动安装。仅 Windows。
+
+## 一、检测更新接口
+
+**`POST /api/update/check`**
+
+请求体：
+```json
+{ "current": "0.1.0" }   // 前端上报的当前安装版本（Tauri getVersion）
+```
+
+响应：
+```json
+{
+  "ok": true,
+  "latest_version": "0.1.1",
+  "installer_name": "云超服昆创园OPC运营中心_0.1.1_x64-setup.exe",
+  "download_url": "/download",
+  "update_available": true
+}
+```
+
+字段：
+| 字段 | 说明 |
+|---|---|
+| `ok` | 是否成功 |
+| `latest_version` | 最新版本号（从安装包文件名解析） |
+| `installer_name` | 安装包文件名 |
+| `download_url` | 安装包下载相对路径（前缀 `api_base`） |
+| `update_available` | 是否需要更新（`latest > current`） |
+
+**最新版本如何确定**：扫描 `backend/` 目录下 `*.setup.exe`，从文件名正则 `_(\d+\.\d+(?:\.\d+)?)` 提取版本号（如 `..._0.1.1_x64-setup.exe` → `0.1.1`）。文件名倒序取第一个。
+
+## 二、下载安装包接口
+
+**`GET /download`**（别名 `/11`）—— 返回 `backend/` 下最新安装包，`application/octet-stream` 附件下载。
+
+## 三、前端流程
+
+| 文件 | 逻辑 |
+|---|---|
+| `src/utils/updateCheck.js` | `getCurrentVersion()` 用 Tauri `getVersion()` 读真实版本 → `checkForUpdate()` 调 `/api/update/check` → `downloadAndInstall()` fetch 下载字节 |
+| `src/components/UpdateNotify.jsx` | 检测到更新弹底部提示；点「下载更新」→ 下载 → 启动安装 → 应用退出 |
+| Rust `install_update` | 写盘到 `%TEMP%` → 启动安装程序 → 0.8s 后 `app.exit(0)` |
+
+触发时机：启动静默查一次 + 每 30 分钟自动查 + 点页眉 logo 主动查。
+
+## 四、发布新版本步骤
+
+1. 把新安装包放入 `backend/`，文件名带版本号：`云超服昆创园OPC运营中心_0.2.0_x64-setup.exe`。
+2. 同步改 `package.json` 的 `version`（Tauri `getVersion` 读取它）。
+3. 重启后端 + 重新打包前端 `yarn build:win`。
+4. 安装端检测到 `latest > current` → 弹更新提示 → 下载安装。
+
+## 五、验证
+
+```bash
+curl -X POST http://192.168.1.9:10085/api/update/check \
+  -H "Content-Type: application/json" -d '{"current":"0.1.0"}'
+```
+`backend/` 有更高版本安装包时返回 `update_available: true`。
+
+## 六、注意
+- 当前按「文件名倒序取第一个」判定最新；若目录同时存在多个版本（如 `0.9` 与 `0.10`），字符串倒序可能取错。多版本共存时应改为「解析全部版本号 → 取数值最大」。
+- `downloadAndInstall` 经 `invoke` 传递安装包字节（约 2.5MB，JSON 数组稍慢）；如需更快可改 Rust 端直接 HTTP 下载。