feat: complete T-105b account login reuse

docs/api.md

@@ -201,7 +201,7 @@ create_account(account_name, alias, region_host=None, debug_port=None,
 update_account(original_alias, account_name, alias, region_host=None, debug_port=None,
                password=None, note=None, path=None, config=None) -> db.Account
 delete_account(alias, path=None, config=None) -> None
-launch_for_login(account_or_alias, path=None, config=None) -> subprocess.Popen
+launch_for_login(account_or_alias, path=None, config=None) -> dict  # 幂等启动/复用入口
 create_shortcut(account_or_alias, shortcut_path=None, desktop_dir=None,
                 path=None, config=None) -> str
 detect_login(account_or_alias, timeout=8, path=None, config=None) -> dict
@@ -213,8 +213,8 @@ login_status_text(status) -> str
 - `create_account()` / `update_account()` 负责生成 slug、创建 `chrome_user_data_dir/<slug>` 并写 DB；编辑别名会生成新 slug/目录，但不删除旧 user-data-dir。
 - `debug_port` 在账号服务层按账号唯一校验；默认端口取 `debug_port_range` 中第一个未占用端口。
 - `delete_account()` 只删除 DB 账号记录，不删除本地 user-data-dir，避免误删登录态。
-- `launch_for_login()` 只启动带该账号 user-data-dir 和 CDP 端口的 Chrome；不会读取、填写或提交密码。
-- ③ 更新 shopee 的账号预检不会自动调用 `launch_for_login()`；Chrome 未启动/端口不可达时只返回阻断原因，由 GUI 提示用户去④手动打开账号浏览器并登录。
+- `launch_for_login()` 是幂等入口。先检查 `chrome.is_running(account.debug_port)`；若该账号 CDP 端口已响应，不再调用 `subprocess.Popen`，而是复用已打开的账号 Chrome，优先激活/打开 `https://<region_host>/portal/` 或卖家中心登录 tab，并返回 `reused=true`；若端口未响应，才启动带该账号 user-data-dir 和 CDP 端口的 Chrome，等待 CDP 就绪并返回 `launched=true`。不会读取、填写或提交密码，不绕过验证码。
+- ③ 更新 shopee 的账号预检不会自动调用 `launch_for_login()`；Chrome 未启动/端口不可达时只返回阻断原因，由 GUI 提示用户去④手动打开账号浏览器并登录。T-105b 的复用逻辑只作用于④用户主动点击「启动登录」这一入口。
 - `create_shortcut()` 生成 `.lnk`，目标/参数复用 `chrome.build_launch_args()`，不包含密码。
 - `detect_login()` 复用 `editor.login_status()`；检测为已登录时更新 `last_login_at`。
 
@@ -377,7 +377,7 @@ T-523 后 GUI 已从旧 `app/gui.py` 拆为 `app/gui/` 包：`__init__.py` 负
 
 - 表格列：账号名、别名、地区、端口、登录状态、备注；不展示密码。
 - 弹窗字段：账号名、别名、地区、调试端口、密码、备注、slug、数据目录；密码框使用打码显示；首次保存/变更非空密码前弹窗提示“本地明文保存”。
-- 「启动登录」只启动 Chrome，人工登录；「检测登录」用 worker 跑 `accounts.detect_login()` 并刷新状态列；若当前 URL 跳到 `accounts.shopee.tw/seller/login`，状态必须显示未登录；「快捷方式」调用 `accounts.create_shortcut()` 生成默认桌面 `.lnk`。
+- 「启动登录」必须幂等：若该账号 Chrome/CDP 已打开，则复用现有窗口并打开/激活卖家中心登录 tab，不重复启动 Chrome；未打开时才新启动 Chrome，仍由用户人工登录。「检测登录」用 worker 跑 `accounts.detect_login()` 并刷新状态列；若当前 URL 跳到 `accounts.shopee.tw/seller/login`，状态必须显示未登录；「快捷方式」调用 `accounts.create_shortcut()` 生成默认桌面 `.lnk`。
 
 ⑤ 设置当前要点（T-501）：