# account-manager CLI 速查

将 `{baseDir}` 替换为技能根目录。所有命令通过 `python {baseDir}/scripts/main.py` 调用（工作目录可为技能根或 `scripts/`，与命令中的路径一致即可）。下文示例简写为 `python main.py` 表示在 `scripts/` 下执行。

## 子命令与实现（与代码一致）

| CLI（`main.py` 第一参或等价路由） | 实现（`scripts/service/`） |
|----------------------------------|---------------------------|
| `add` | `account_service.cmd_add` |
| `list`；或首参为平台且 `list`/单参 | `account_service.cmd_list`（路由见 `cli/app.py`） |
| `get` | `account_service.cmd_get` |
| `list-json` | `account_service.cmd_list_json` |
| `pick-web` | `account_service.cmd_pick_web` |
| `open` | `browser_service.cmd_open` |
| `delete` | `account_service.cmd_delete_by_id` / `cmd_delete_by_platform` / `cmd_delete_by_platform_phone` |

入口：`scripts/main.py` → `cli/app.py` → 上表。

## 通用说明

- **平台参数**：可为 `scripts/util/platforms.py` 中配置的**中文展示名、别名或英文键**（如 `sohu`、`搜狐号`）。详见 [PLATFORMS.md](PLATFORMS.md)。
- **数据与路径**：库文件、profile 目录由环境变量决定，网关与本地终端不一致时会「看不到同一份数据」。详见 [RUNTIME.md](RUNTIME.md)。
- **机器可读子命令**：`get`、`list-json`、`pick-web` 的成功/失败约定见 [INTEGRATION.md](INTEGRATION.md)。
- **错误码前缀**：见 [ERRORS.md](ERRORS.md)。

> 说明：当前版本 **未实现** `health` / `version` 子命令；与工作区其它技能的统一约定可对齐后另补。

---

## 子命令一览

### `add` — 添加账号

```bash
python main.py add <平台> <手机号>
```

- 手机号为**中国大陆 11 位**（`1` 开头，第二位 `3–9`），可含空格/分隔符，入库前会归一成数字。
- 同一 `platform` 下同一手机号不可重复。

### `list` — 列出账号（人类可读多行块）

```bash
python main.py list [平台|all|全部]
```

- 省略第二参数时等价于 `all`。
- 默认最多 **10** 条（按创建时间倒序）；内部实现见 `service/account_service.cmd_list`。

### 简写：`python main.py <平台>` / `python main.py <平台> list`

- 若第一个参数能解析为平台，则等价于 `list <平台>`。

### `get` — 按 id 输出**单行 JSON**

```bash
python main.py get <id>
```

- 成功：`stdout` **仅一行** JSON 对象（UTF-8）。
- 失败：首行 `ERROR:ACCOUNT_NOT_FOUND`，路径提示在 stderr。

### `list-json` — 列表的**单行 JSON 数组**（跨技能）

```bash
python main.py list-json <平台|all|全部> [--limit N]
```

- 成功：`stdout` **仅一行** JSON 数组；元素结构与 `get` 单条一致。
- 默认 `limit=200`，实际 clamp 为 `1..500`。
- 排序：按 `updated_at` 倒序。

### `pick-web` — 网页自动化候选账号（单行 JSON）

```bash
python main.py pick-web <平台>
```

- 按该平台 `updated_at`、`created_at` 倒序选一条；**不**表示当前浏览器已登录。
- 失败：首行 `ERROR:`。

### `open` — 仅打开浏览器（**不写库、不检测登录**）

```bash
python main.py open <id>
```

- 需本机 Chrome/Edge + Playwright；详见运行环境说明。
- 仅供人工核对页面；登录与否由业务侧（如 llm-manager 网页引擎）在使用账号时自行处理。

### `delete` — 删除库记录并尽量删除 profile 目录

```bash
python main.py delete id <id>
python main.py delete platform <平台>
python main.py delete platform <平台> <手机号>
```

- 第二段必须为 `id` 或 `platform`（小写不敏感）。

---

## 无参数 / 未知子命令

- 无参数或无法解析：打印用法概览；未知子命令时首行 `ERROR:CLI_UNKNOWN_OR_BAD_ARGS`，退出码 `1`。