cmautobuy/docs/task/148-切换正式管理端默认地址.md

148 Client：将管理端默认地址切换为正式 HTTPS 地址

• 类型：需求
• 父级大工单：#1
• 所属 MVP / 版本：#2 / Client 可运行任务闭环
• 状态：已完成，待用户验收
• 日期：2026-08-11
• Gitea 工单：#148

背景与目标

Client 原来默认连接本机 Admin。新安装客户端应默认连接 https://buy.833729.com，升级时还要迁移旧默认值，同时保留用户手动保存的其他地址。

最终方案

• 将唯一默认地址常量改为 https://buy.833729.com。
• 增加统一的管理端地址读取函数：没有值、空值或旧默认地址时写入新默认值；其他地址只在使用时去除首尾空白和末尾斜杠，不覆盖数据库原值。
• 设置页和 PDD 任务页都使用统一读取函数，避免登记、领取和提交访问不同地址。
• 更新设置页占位文字和长期界面基线。

改了哪些

• client/src/http_admin_gateway.py：修改默认地址。
• client/src/current_client_service.py：增加旧默认值兼容迁移。
• client/src/settings_ui_event.py、client/src/pdd_ui_event.py：统一读取管理端地址。
• client/src/settings_ui.py：更新地址占位文字。
• client/test/：覆盖默认值、迁移、自定义地址和界面保存行为。
• docs/client/05-ui-specification.md：记录稳定默认值与迁移规则。

验收结果

验收标准	结果
全新 Client 使用正式 HTTPS 默认地址	通过
缺少配置时保存新默认值	通过
旧本机默认值自动迁移	通过
用户自定义地址保持不变	通过
设置页与任务页使用同一地址来源	通过
测试不访问真实管理端、不记录凭据	通过

测试

• 执行的命令：
  • C:/Python310/python.exe -m unittest discover -s test -p "test_current_client_service.py"
  • C:/Python310/python.exe -m unittest discover -s test -p "test_http_admin_gateway.py"
  • $env:QT_QPA_PLATFORM='offscreen'; C:/Python310/python.exe -m unittest discover -s test -p "test_settings_ui_event.py"
  • C:/Python310/python.exe -m py_compile src/http_admin_gateway.py src/current_client_service.py src/settings_ui_event.py src/pdd_ui_event.py src/settings_ui.py
• 结果：6、13、43 项测试全部通过，语法检查通过；Qt 输出已有字体目录警告，不影响测试结果。
• 没验证到的部分：未向正式 Admin 发起真实登记、领取或提交请求，避免测试影响线上任务。

相关提交

• 5c2f4f6 feat: 切换正式管理端默认地址 (#148)