cmshoppe/docs/tasks/T-653.md

id, title, phase, deps, status, created

id	title	phase	deps	status	created
T-653	精简主Tab标题并移除更新蝦皮静态红点	7		DONE	2026-07-17

问题 / 背景

主窗口目前在启动时无条件给「③ 更新蝦皮」设置一个警告色圆点图标。该圆点不关联待更新数量、失败记录、未读消息或运行状态，即使没有任何任务也始终存在，容易被理解为异常或待处理提醒。

另外，主 Tab 当前使用「④ 账号管理」「⑤ 设置」「⑥ 商品套图」标题。产品决定保留①导入采集、②AI生成、③更新蝦皮的流程序号，但将后三个管理/工具型模块改为更简洁的「账号管理」「设置」「商品套图」。标题变更后，现有基于完整标题查找 Tab 的代码、用户可见引导和测试都必须同步，不能留下“请到⑤设置”等无法对应实际 Tab 的文案。

方案

1. 移除③更新蝦皮的静态圆点

• 删除 MainWindow 初始化时对「③ 更新蝦皮」调用 setTabIcon(..., _warning_dot_icon()) 的静态图标设置；
• 若 _warning_dot_icon() 及其相关导入不再有其他调用，清理死代码；若存在其他真实语义调用，不得误删；
• 不新增替代红点、数字 badge、闪烁动画或常驻警告。③的高风险边界继续由「开始更新」确认框、账号预检、按钮语义和运行日志表达；
• 不把 Tab 红点与待更新数量、失败数量或运行状态绑定，本任务只移除误导性的静态标记。

2. 精简后三个主Tab标题

将 TAB_TITLES 和全部对应 UI 路由调整为：

① 导入采集 │ ② AI生成 │ ③ 更新蝦皮 │ 账号管理 │ 设置 │ 商品套图

• 保持 Tab 顺序、索引、模块实例和业务职责不变；①至③仍保留现有序号，④至⑥只移除显示文字前缀；
• 更新通过标题查找的设置页离开保护、Tab 切换逻辑、构建分发、测试断言和 tooltip，不能因文字变化导致切换设置页时报错或跳错模块；
• 所有用户可见的引导、空态、错误提示、确认框、tooltip、状态栏和菜单中，原本指向「④ 账号管理」「⑤ 设置」「⑥ 商品套图」的表述改为「账号管理」「设置」「商品套图」。技术文档可在需要表达工作流顺序时保留阶段编号，但不得与实际 Tab 标题混淆；
• 不修改账号管理、设置、商品套图的内部对象名、类名、数据库字段、配置键、快捷方式、CDP、cmhub 或业务流程。

3. 文档与验证

• 更新 docs/routes.md、docs/04-architecture.md、docs/api.md 中主 Tab 标题和用户操作路径；保留流程图中①至③的编号，后三项改为无序号显示；
• 若现有 SVG 效果图含后三个旧 Tab 标题，同步更新对应 docs/ui/ 文件及 docs/ui/README.md；没有受影响效果图则不要无关重画；
• tests/test_gui.py / 相关主窗口测试：断言 Tab 文本顺序准确，③ Tab 没有静态图标，设置离开保护、构建分发和状态栏引导仍可用；
• 运行：

py -3.10 -m unittest tests.test_gui
py -3.10 -m unittest discover -s tests
py -3.10 -m ruff check app tests main.py
py -3.10 -m compileall app main.py
git diff --check

验收要点

• 软件启动后，「③ 更新蝦皮」Tab 前不再显示静态红/警告色圆点。
• ③没有待更新任务、失败任务或未读提醒时不会出现任何虚假的状态标记。
• 主 Tab 标题依次为「① 导入采集、② AI生成、③ 更新蝦皮、账号管理、设置、商品套图」。
• 进入/离开「设置」时未保存更改确认仍正确工作，账号管理和商品套图均能正常创建和切换。
• 用户可见引导不再要求前往“④账号管理”“⑤设置”或“⑥商品套图”。
• 不影响①采集、②AI生成、③真实更新确认、账号登录、cmhub 设置、套图生成、数据库、Excel、Shopee CDP 或自动升级。

边界（不改什么）

• 不移除①、②、③的显示序号，不调整主 Tab 排序或新增/隐藏模块。
• 不实现动态 badge、任务计数、失败计数、未读消息或 Tab 动画。
• 不修改③更新蝦皮的安全确认、账号就绪预检、按钮颜色或线上提交逻辑。
• 不重命名 Python 类、模块、配置键、SQLite 表或历史数据中的技术标识。

执行记录

• 2026-07-17：根据主Tab标题精简和更新蝦皮静态红点误导问题创建任务。待实现。
• 2026-07-17：开始实现；先核对主窗口标题路由、静态图标、测试和用户操作文档。
• 2026-07-17：移除 MainWindow 对③的静态图标设置和无调用的 _warning_dot_icon()；保留通配导入兼容所需的 QIcon、QPixmap、QPainter。TAB_TITLES、构建分发、设置离开守卫、账号/设置跳转及所有用户可见引导统一改为无序号的后三个主 Tab 名称；同步更新 API、架构、路由和 SVG 线框。
• 2026-07-17：验证通过：py -3.10 -m unittest tests.test_gui（187 项）、py -3.10 -m unittest discover -s tests（578 项）、py -3.10 -m ruff check app tests main.py、py -3.10 -m compileall app main.py、git diff --check。