diff --git a/docs/task/103-client启动检查到新版本时提醒参数设置导航.md b/docs/task/103-client启动检查到新版本时提醒参数设置导航.md new file mode 100644 index 0000000..412413f --- /dev/null +++ b/docs/task/103-client启动检查到新版本时提醒参数设置导航.md @@ -0,0 +1,45 @@ +# #103 Client:启动检查到新版本时提醒参数设置导航 + +- 工单号:#103 +- 类型:功能 +- 父级:#1 +- 版本:MVP #2 +- 状态:待验收 +- 日期:2026-08-11 +- Gitea: + +## 背景与目标 + +启动时异步检查到线上版本较新后,在主导航明确提醒采购人员,并在设置页同时展示本地和线上版本。 + +## 最终方案 + +更新检查成功后由事件层发出版本状态信号。主窗口收到信号后使用提醒色和“有更新”文字共同标记参数设置导航;确认已是最新版本时恢复普通导航。检查失败不改变导航状态,进入设置页也不会清除提醒。 + +## 改了哪些 + +- `client/src/update_ui_event.py`:发布更新可用状态和本地、线上版本。 +- `client/src/ui_main.py`:更新参数设置导航的文字、颜色和提示。 +- `client/src/settings_ui.py`:同时展示本地版本和线上版本。 +- `client/test/`:补充更新状态和导航提醒测试。 +- `docs/client/05-ui-specification.md`:补充稳定交互规则。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 启动检查保持后台执行,不阻塞主界面 | 通过 | +| 发现新版本时导航同时使用颜色和文字提醒 | 通过 | +| 设置页显示本地版本和线上版本 | 通过 | +| 已是最新版本时清除提醒 | 通过 | +| 检查失败不误报,提示可重试 | 通过 | + +## 测试 + +- 执行的命令:`cd client; python -m unittest discover -s test -p "test_update_ui_event.py"`;`cd client; python -m unittest discover -s test -p "test_pdd_ui_event.py"` +- 结果:通过,共 48 项 PDD UI 事件测试及在线更新事件测试。 +- **没验证到的部分**:未连接真实发布服务器下载更新;未在 Windows 有界面环境人工检查深浅色主题效果。 + +## 相关提交 + +- `69e5292` 新版本时提醒参数设置导航