cmautobuy/docs/task/103-client启动检查到新版本时提醒参数设置导航.md

#103 Client：启动检查到新版本时提醒参数设置导航

• 工单号：#103
• 类型：功能
• 父级：#1
• 版本：MVP #2
• 状态：已完成
• 日期：2026-08-11
• Gitea：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/103

背景与目标

启动时异步检查到线上版本较新后，在主导航明确提醒采购人员，并在设置页同时展示本地和线上版本。

最终方案

更新检查成功后由事件层发出版本状态信号。主窗口收到信号后使用提醒色和“有更新”文字共同标记参数设置导航；确认已是最新版本时恢复普通导航。检查失败不改变导航状态，进入设置页也不会清除提醒。

改了哪些

• 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"
• 结果：相关测试通过；Client 全量 377 项测试通过。
• 没验证到的部分：未连接真实发布服务器下载更新；未在 Windows 有界面环境人工检查深浅色主题效果。

相关提交

• 69e5292 新版本时提醒参数设置导航
• f9c3016 修正更新提醒测试数据与正式模型字段不一致的问题

用户验收

• 2026-08-11：用户确认通过验收。