chore: account-manager — runtime_env sibling root, wait-login and browser fixes

references/CLI.md

@@ -6,7 +6,7 @@
 
 - **平台参数**：可为 `scripts/util/platforms.py` 中配置的**中文展示名、别名或英文键**（如 `sohu`、`搜狐号`）。详见 [PLATFORMS.md](PLATFORMS.md)。
 - **数据与路径**：库文件、profile 目录由环境变量决定，网关与本地终端不一致时会「看不到同一份数据」。详见 [RUNTIME.md](RUNTIME.md)。
-- **机器可读子命令**：`get`、`list-json`、`pick-logged-in`、`pick-web`、`set-login-status` 的成功/失败约定见 [INTEGRATION.md](INTEGRATION.md)。
+- **机器可读子命令**：`get`、`list-json`、`pick-web` 的成功/失败约定见 [INTEGRATION.md](INTEGRATION.md)。
 - **错误码前缀**：见 [ERRORS.md](ERRORS.md)。
 
 > 说明：当前版本 **未实现** `health` / `version` 子命令；与工作区其它技能的统一约定可对齐后另补。
@@ -56,33 +56,15 @@ python main.py list-json <平台|all|全部> [--limit N]
 - 默认 `limit=200`，实际 clamp 为 `1..500`。
 - 排序：按 `updated_at` 倒序。
 
-### `pick-logged-in` — 该平台**已登录**的一条账号（单行 JSON）
-
-```bash
-python main.py pick-logged-in <平台>
-```
-
-- 筛选：`login_status = 1`，按 `last_login_at` 优先。
-- 失败：首行以 `ERROR:` 开头（**勿当 JSON 解析**）。
-
 ### `pick-web` — 网页自动化候选账号（单行 JSON）
 
 ```bash
 python main.py pick-web <平台>
 ```
 
-- 优先同 `pick-logged-in`；若无已登录，则取该平台 `updated_at` 最新一条。
+- 按该平台 `updated_at`、`created_at` 倒序选一条；**不**表示当前浏览器已登录。
 - 失败：首行 `ERROR:`。
 
-### `set-login-status` — 回写登录态（跨技能）
-
-```bash
-python main.py set-login-status <id> <0|1>
-```
-
-- 成功：`stdout` 首行 `OK:SET_LOGIN_STATUS` 或 `OK:CLEARED_LOGIN_STATUS`，退出码 `0`。
-- 失败：`stdout` 首行 `ERROR:...`，退出码 `1`。
-
 ### `open` — 仅打开浏览器（**不写库**）
 
 ```bash
@@ -91,13 +73,24 @@ python main.py open <id>
 
 - 需本机 Chrome/Edge + Playwright；详见运行环境说明。
 
-### `login` — 打开浏览器并**自动检测登录**，写回 `login_status`
+### `login` — 打开浏览器并**自动检测登录**（成功则刷新 `updated_at`）
 
 ```bash
 python main.py login <id>
 ```
 
 - 依赖 Playwright；超时与轮询间隔等见 [RUNTIME.md](RUNTIME.md)。
+- **不**在库中持久化「是否已登录」；仅刷新 `updated_at` 供 `pick-web` 等排序参考。
+
+### `wait-login` — 跨技能：**始终以本次 DOM 检测为准**
+
+```bash
+python main.py wait-login <id>
+```
+
+- 由**账号管理**打开浏览器并完成 DOM 检测；调用方只需 `subprocess` 等待本进程结束，成功时 stdout 含 `OK:WAIT_LOGIN`。
+- 会先打印若干行说明（含 `INFO:WAIT_LOGIN_BEGIN`），再进入检测；超时、关窗、启动失败等见 [ERRORS.md](ERRORS.md)。
+- 时间窗由 `JIANGCHANG_WAIT_LOGIN_TIMEOUT_SECONDS` 控制，见 [RUNTIME.md](RUNTIME.md)。
 
 ### `delete` — 删除库记录并尽量删除 profile 目录
 

references/ERRORS.md

@@ -1,13 +1,6 @@
 # 终端前缀约定（account-manager）
 
-约定：**机器解析只依赖 `stdout` 首行**时，应先判断首行是否以 `ERROR:` 或 `OK:` 开头；多行说明可忽略或仅作展示。
-
-## `OK:`（成功标记）
-
-| 首行 | 场景 |
-|------|------|
-| `OK:SET_LOGIN_STATUS` | `set-login-status <id> 1` 成功 |
-| `OK:CLEARED_LOGIN_STATUS` | `set-login-status <id> 0` 成功 |
+约定：**机器解析只依赖 `stdout` 首行**时，应先判断首行是否以 `ERROR:` 开头；多行说明可忽略或仅作展示。
 
 ## `ERROR:` — CLI 参数 / 路由
 
@@ -19,10 +12,9 @@
 | `ERROR:CLI_LOGIN_MISSING_ID` | `login` 缺少 id |
 | `ERROR:CLI_DELETE_MISSING_ARGS` | `delete` 参数不足 |
 | `ERROR:CLI_DELETE_BAD_MODE` | `delete` 第二段不是 `id`/`platform` |
-| `ERROR:CLI_SET_LOGIN_STATUS_MISSING_ARGS` | `set-login-status` 参数不足 |
 | `ERROR:CLI_LIST_JSON_MISSING_PLATFORM` | `list-json` 缺少平台参数 |
-| `ERROR:CLI_PICK_LOGGED_IN_MISSING_ARGS` | `pick-logged-in` 缺少平台 |
 | `ERROR:CLI_PICK_WEB_MISSING_ARGS` | `pick-web` 缺少平台 |
+| `ERROR:CLI_WAIT_LOGIN_MISSING_ID` | `wait-login` 缺少 id |
 | `ERROR:CLI_UNKNOWN_OR_BAD_ARGS` | 无法识别的子命令或参数组合 |
 
 ## `ERROR:` — 业务与数据
@@ -38,10 +30,7 @@
 | `ERROR:PHONE_INVALID` | 手机号格式不符合大陆 11 位规则 |
 | `ERROR:DUPLICATE_PHONE_PLATFORM` | 同平台下山手机号已存在 |
 | `ERROR:DELETE_INVALID_ID` | 删除 id 非法 |
-| `ERROR:NO_LOGGED_IN_ACCOUNT` | `pick-logged-in` 无 `login_status=1` 的账号 |
 | `ERROR:NO_ACCOUNT` | `pick-web` 该平台无任何记录 |
-| `ERROR:INVALID_ACCOUNT_ID` | `set-login-status` 的 id 非数字 |
-| `ERROR:INVALID_STATUS` | `set-login-status` 状态不是 0/1 |
 
 ## `ERROR:` — 浏览器 / 环境
 
@@ -50,7 +39,20 @@
 | `ERROR:需要 playwright：pip install playwright && playwright install chromium` | 未安装 Playwright 或浏览器未安装 |
 | `ERROR:PROFILE_DIR_MISSING` | 账号记录中 `profile_dir` 为空 |
 
+## `ERROR:` — `wait-login`（跨技能编排）
+
+| 前缀 | 含义 |
+|------|------|
+| `ERROR:WAIT_LOGIN_ABORTED` | 用户关闭浏览器，放弃登录 |
+| `ERROR:WAIT_LOGIN_TIMEOUT` | 限时内未完成登录（默认由 `JIANGCHANG_WAIT_LOGIN_TIMEOUT_SECONDS` 控制，约 180s） |
+| `ERROR:WAIT_LOGIN_LAUNCH_FAILED` | 无法启动浏览器或创建持久化上下文（端口/占用/安装问题等） |
+| `ERROR:WAIT_LOGIN_PAGE_ERROR` | 打开登录页或轮询 DOM 时异常 |
+| `ERROR:WAIT_LOGIN_CONFIG_ERROR` | 子进程配置异常 |
+| `ERROR:WAIT_LOGIN_CHILD_CRASH` | 子进程异常退出且未写入有效结果文件 |
+
+编排技能（如 llm-manager）另可能打印 `ERROR:WAIT_LOGIN_OUTER_TIMEOUT`：等待本进程整体超过上限（登录窗口 + 子进程缓冲），已中止。
+
 ## 非前缀输出
 
 - **成功添加账号**、**删除成功**等可能包含 `✅` 等人类可读行，**不宜**作为稳定协议解析。
-- **`get` / `list-json` / `pick-*` 成功**：`stdout` 应为**单行 JSON**（失败时首行 `ERROR:`，勿当 JSON）。
+- **`get` / `list-json` / `pick-web` 成功**：`stdout` 应为**单行 JSON**（失败时首行 `ERROR:`，勿当 JSON）。

references/INTEGRATION.md

@@ -10,30 +10,27 @@
 |------|------|----------------|
 | 取单条账号 JSON | `get <id>` | 单行 JSON 对象 |
 | 批量账号 JSON | `list-json <平台或all> [--limit N]` | 单行 JSON 数组 |
-| 只要已登录 | `pick-logged-in <平台>` | 单行 JSON 对象 |
-| 自动化候选（优先已登录） | `pick-web <平台>` | 单行 JSON 对象 |
-| 回写登录态 | `set-login-status <id> <0或1>` | 首行 `OK:...` |
+| 网页自动化候选账号 | `pick-web <平台>` | 单行 JSON 对象（按 `updated_at` 选一条，**不**表示当前已登录） |
 
 ## 解析协议（强建议）
 
 1. 读取子进程 **stdout** 全文或首行。
 2. 若首行以 **`ERROR:`** 开头 → 失败，不要 `json.loads` 整段 stdout。
-3. 若首行以 **`OK:`** 开头 → `set-login-status` 成功（可再检查退出码 `0`）。
-4. **`get` / `list-json` / `pick-logged-in` / `pick-web`**：成功时应对**第一行**做 `json.loads`；后续行应不存在，若有则视为非协议内容。
+3. **`get` / `list-json` / `pick-web`**：成功时应对**第一行**做 `json.loads`；后续行应不存在，若有则视为非协议内容。
 
 ## JSON 对象字段（与 `get` 一致）
 
 典型字段见仓库 `assets/examples/get-response.json` 与 `assets/schemas/account-record.schema.json`。
 
-常见键名包括：`id`, `name`, `platform`, `phone`, `profile_dir`, `url`, `login_status`, `last_login_at`, `created_at`, `updated_at`；`extra_json` 列中的扁平扩展可能并入同一对象。
+常见键名包括：`id`, `name`, `platform`, `phone`, `profile_dir`, `url`, `created_at`, `updated_at`；`extra_json` 列中的扁平扩展可能并入同一对象。
+
+**库中不再持久化「是否已登录」**；编排侧需登录时请调用 `wait-login <id>`（始终以本次 Playwright DOM 检测为准）或在业务页内自行判断。
 
 ## Publisher / 自动化流水线示例
 
 1. `pick-web 搜狐号`（或目标平台）→ 解析 JSON → 取 `id`、`profile_dir`、`url`。
-2. 若需确认已登录：检查 `login_status == 1`，否则可引导用户执行 `login <id>` 或先 `open <id>` 人工登录。
-3. 外部脚本在确认登录后，可调用 `set-login-status <id> 1` 保持与库一致（若你们自有检测逻辑）。
+2. 需要确保会话有效时：调用 `wait-login <id>`，成功则 stdout 首行含 `OK:WAIT_LOGIN`。
 
 ## 退出码
 
-- **`set-login-status`**：失败时进程以 **`1`** 退出（见实现）。
-- 其它子命令多数为 **`0`**；若需严格编排，请以 **stdout 首行前缀** 与 **JSON 可解析性** 为准，不要仅依赖退出码。
+请以 **stdout 首行前缀** 与 **JSON 可解析性** 为准；不要仅依赖退出码。

references/README.md

@@ -7,7 +7,7 @@
 | [CLI.md](CLI.md) | 子命令、参数、行为说明 |
 | [PLATFORMS.md](PLATFORMS.md) | 平台英文键、中文名、别名 |
 | [RUNTIME.md](RUNTIME.md) | 环境变量、数据路径、日志、登录调参 |
-| [ERRORS.md](ERRORS.md) | `ERROR:` / `OK:` 前缀一览 |
+| [ERRORS.md](ERRORS.md) | `ERROR:` 前缀一览 |
 | [INTEGRATION.md](INTEGRATION.md) | 跨 Skill 调用与 JSON 解析约定 |
 
 示例 JSON 与 Schema 见仓库 `assets/`。