3.8 KiB
3.8 KiB
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。 - 数据与路径：库文件、profile 目录由环境变量决定，网关与本地终端不一致时会「看不到同一份数据」。详见 RUNTIME.md。
- 机器可读子命令：
get、list-json、pick-web的成功/失败约定见 INTEGRATION.md。 - 错误码前缀：见 ERRORS.md。
说明：当前版本 未实现
health/version子命令；与工作区其它技能的统一约定可对齐后另补。
子命令一览
add — 添加账号
python main.py add <平台> <手机号>
- 手机号为中国大陆 11 位（
1开头，第二位3–9），可含空格/分隔符，入库前会归一成数字。 - 同一
platform下同一手机号不可重复。
list — 列出账号（人类可读多行块）
python main.py list [平台|all|全部]
- 省略第二参数时等价于
all。 - 默认最多 10 条（按创建时间倒序）；内部实现见
service/account_service.cmd_list。
简写：python main.py <平台> / python main.py <平台> list
- 若第一个参数能解析为平台，则等价于
list <平台>。
get — 按 id 输出单行 JSON
python main.py get <id>
- 成功：
stdout仅一行 JSON 对象（UTF-8）。 - 失败：首行
ERROR:ACCOUNT_NOT_FOUND，路径提示在 stderr。
list-json — 列表的单行 JSON 数组（跨技能）
python main.py list-json <平台|all|全部> [--limit N]
- 成功：
stdout仅一行 JSON 数组；元素结构与get单条一致。 - 默认
limit=200，实际 clamp 为1..500。 - 排序：按
updated_at倒序。
pick-web — 网页自动化候选账号（单行 JSON）
python main.py pick-web <平台>
- 按该平台
updated_at、created_at倒序选一条；不表示当前浏览器已登录。 - 失败：首行
ERROR:。
open — 仅打开浏览器（不写库、不检测登录）
python main.py open <id>
- 需本机 Chrome/Edge + Playwright；详见运行环境说明。
- 仅供人工核对页面；登录与否由业务侧（如 llm-manager 网页引擎）在使用账号时自行处理。
delete — 删除库记录并尽量删除 profile 目录
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。