diff --git a/docs/tasks/T-698.md b/docs/tasks/T-698.md new file mode 100644 index 0000000..bc7e9da --- /dev/null +++ b/docs/tasks/T-698.md @@ -0,0 +1,61 @@ +--- +id: T-698 +title: 会员信息移入 Windows 原生标题栏 +phase: 7 +deps: [T-697] +status: TODO +created: 2026-07-23 +--- + +## 问题 / 背景 + +T-697 已移除 Tabs 上方重复的应用名称,但仍保留一整行应用内会员状态栏。用户希望把账号、套餐和有效期直接加载到 Windows 原生窗口标题的应用名称后面,不再在 Tabs 上方占用独立区域。 + +该调整会让会员摘要同时出现在窗口标题、任务栏和 Alt+Tab 中;这是本次需求明确接受的展示范围。API Key、接口地址、原始错误和支付信息仍不得进入窗口标题。 + +## 方案 + +### 1. 原生窗口标题 + +- 默认、正在检测、未配置、无订阅、到期、撤销、账号禁用、Key 无效、网络异常和旧服务兼容状态,窗口标题只显示 `display_name()`。 +- 订阅有效时显示:`应用名称 | 账号名 · 套餐名 · 有效至日期`。 +- 宽限期显示:`应用名称 | 账号名 · 套餐名 · 宽限至日期`。 +- 账号、套餐文本只使用 `SubscriptionStatus` 已归一化的安全字段;标题不得包含 API Key、`manage_url`、`notice_id`、接口路径或原始响应。 +- 状态从有效切换为异常、重新检测或配置变更时,立即恢复纯应用名称,避免显示陈旧会员信息。 + +### 2. 删除 Tabs 上方状态行 + +- 删除 `subscriptionStatusLabel`、`appHeader` 及其布局;中央区域直接从六个 Tabs 开始,不保留空白占位。 +- 保留 Windows 原生窗口标题、图标、窗口拖动、任务栏和 Alt+Tab 行为。 +- 检测中、观察模式异常、正式门禁原因和设置保存反馈统一由现有底部状态栏显示中文信息。 + +### 3. 订阅行为不变 + +- T-696 继续保持“真实检测、观察模式不限制使用”;本任务不启用正式门禁。 +- 启动异步检查、保存设置后重查、陈旧回调隔离、新提交放行和 `notice_id` 模态框抑制逻辑不变。 +- 标题更新只在 GUI 主线程处理,不让 Worker 直接操作窗口。 + +## 验收要点 + +- 初始窗口标题仅为当前 `display_name()`,Tabs 上方不再存在 `appHeader` 或 `subscriptionStatusLabel`。 +- 有效“测试”套餐返回后,窗口标题包含账号、套餐“测试”和有效期。 +- 宽限状态使用“宽限至”;异常或重新检测时立即恢复纯应用名称。 +- 检测中和异常原因仍能在底部状态栏看到,观察模式下所有工作流继续可用。 +- 窗口标题不包含 API Key、接口地址、会员中心地址、通知标识或原始错误。 +- 自动验证: + - 主窗口原生标题与订阅状态定向 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` + +## 边界(不改什么) + +- 不自定义或隐藏 Windows 原生标题栏,不实现无边框窗口。 +- 不修改 cmhub 订阅接口、状态解析、套餐、支付、会员中心或服务端授权。 +- 不启用客户端正式门禁,不修改六个业务 Tab、CDP 或蝦皮流程。 +- 不在底部状态栏重复长期展示有效账号和套餐;有效摘要以窗口标题为准。 + +## 执行记录 + +- 待实现。