docs: update indicator is a hint text, not a red button
Replace the red-dot-on-the-gear treatment with a low-key blue "发现新版本 vX.Y.Z" label to the left of the ⚙ 配置 button (red reads as error; the text is clearer and shows the version). docs/07 §4.3, docs/10 §12 and related wording updated. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -110,7 +110,7 @@
|
||||
|
||||
## 6. 更新时机
|
||||
|
||||
- **检查**:主程序**启动时**后台线程检查一次(非阻塞);发现新版只点亮设置入口的角标,不打断使用。
|
||||
- **检查**:主程序**启动时**后台线程检查一次(非阻塞);发现新版只在设置入口旁显示一行蓝色提示文字,不打断使用。
|
||||
- **下载暂存**:用户在设置里点「更新」时进行(app 运行期);下载/校验不阻塞主界面,完成后暂存待应用。
|
||||
- **应用切换**:仅在**下次启动**由启动器完成(主程序未运行时)。
|
||||
|
||||
@@ -221,7 +221,7 @@ http://cm.xiapi.com/
|
||||
|
||||
## 12. 用户体验
|
||||
|
||||
- **发现新版**:主程序启动后台检查,有新版则在 `⚙ 配置` 按钮上点亮红点(不弹阻塞横幅、不打断工作)。
|
||||
- **发现新版**:主程序启动后台检查,有新版则在 `⚙ 配置` 按钮左侧显示一行低调蓝色提示 `发现新版本 vX.Y.Z`(可点击进设置;不用红色、不弹阻塞横幅、不打断工作)。
|
||||
- **手动更新**:用户打开设置 → 点「检查并更新」→ 下载在后台进行,完成后提示「已下载 vX,下次启动生效」。下载期间主界面照常可用。
|
||||
- **应用**:下次双击 `Launcher.exe` 时秒切到新版,几乎无感;启动**永不因下载而卡住**。
|
||||
- 更新源不可达 / 安装目录不可写时,给出明确文案并降级,不静默失败也不阻断使用。
|
||||
@@ -256,7 +256,7 @@ HTTP 在线更新比内网共享面临更高风险,按以下层次防护:
|
||||
分阶段落地,每阶段可独立验证:
|
||||
|
||||
1. **地基**:数据目录分离(第 5 节)。任何更新方案的前提。✅ 已实现。
|
||||
2. **检测通知**:启动时比对版本,有新版提示。✅ 已实现——`services/update_service.py`(`check_for_update` / 版本比较,支持 **`http(s)://` 源 + Basic Auth** 及本地路径,manifest 用 `utf-8-sig` 容忍 BOM)+ 主窗口后台线程检查 → `⚙ 配置` 按钮点亮角标(非阻塞)。
|
||||
2. **检测通知**:启动时比对版本,有新版提示。✅ 已实现——`services/update_service.py`(`check_for_update` / 版本比较,支持 **`http(s)://` 源 + Basic Auth** 及本地路径,manifest 用 `utf-8-sig` 容忍 BOM)+ 主窗口后台线程检查 → `⚙ 配置` 按钮左侧显示蓝色提示文字(非阻塞)。
|
||||
3. **非阻塞更新(当前方向)**:✅ 已实现——下载与应用拆开,**启动不阻塞**。
|
||||
- `services/installer.py`:`download_and_stage()`(app 内下载→SHA-256→解压→`staging\app.new`)、`apply_staged()`(启动器秒切 `app/app.old`,含「不比当前新则丢弃」「移动失败回滚」)、`staged_version()`。
|
||||
- `src/launcher.py`:瘦身为 seed + `apply_staged` + 启动,**不联网**。
|
||||
@@ -283,7 +283,7 @@ HTTP 在线更新比内网共享面临更高风险,按以下层次防护:
|
||||
|
||||
## 18. 验收要点
|
||||
|
||||
- 有新版时 `⚙ 配置` 按钮亮角标,启动不被打断。
|
||||
- 有新版时 `⚙ 配置` 按钮左侧出现蓝色提示文字,启动不被打断。
|
||||
- 设置里「检查并更新」能下载暂存,下载期间主界面照常可用,完成提示「下次启动生效」。
|
||||
- 下载暂存期间 `app\` 不被改动;下次启动 `Launcher.exe` 秒切到新版,`app.old\` 保留旧版。
|
||||
- 安装(切换)后用户自定义模板与偏好(`~/.cmbot`)完整保留。
|
||||
|
||||
Reference in New Issue
Block a user