release: v1.0.55 SKILL description for routing, CLI mapping table, when-to-use cleanup

SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: 账号管理
-description: "多平台账号登记与浏览器 Profile 目录管理。当用户要添加/列出/删除各平台账号、或编排侧需要按平台取一条账号 JSON(pick-web/get)用于网页自动化时,加载本技能。本技能不持久化「是否已登录」,不在此做登录预检;登录由业务侧(如 llm-manager 网页引擎)在使用 profile 时处理。"
-version: 1.0.54
+description: "多平台账号（搜狐号、头条、知乎、微信公众号、豆包、Kimi、DeepSeek 等）的本地登记与查询。当用户或编排要添加/删除账号、列出全部或某平台账号、按 id 查看单条账号信息、为网页自动化批量取账号 JSON 或从中选一条候选、在浏览器中打开已登记账号以登录或核对页面时，加载本技能。本技能不在库中记录「是否已登录」；具体子命令与参数以 references/CLI.md 为准。"
+version: 1.0.55
 author: 深圳匠厂科技有限公司
 metadata:
   openclaw:
@@ -12,43 +12,46 @@ allowed-tools:
   - bash
 ---
 
-# 账号管理(account-manager)
+# 账号管理（account-manager）
 
-登记各平台账号与 **Chrome/Edge 持久化用户目录(`profile_dir`)** 的对应关系,供发布类、大模型网页类等 Skill 通过子进程 CLI 取号。**库中不保存「已登录」状态**;`pick-web` 仅按更新时间等选一条候选,**不**表示浏览器已登录。
+在本地 SQLite 登记各平台账号与持久化用户目录路径，供其它技能通过子进程调用 `scripts/main.py` 读取或维护。**不在库中持久化「是否已登录」**；`pick-web` 仅按规则选一条候选，**不表示**当前浏览器已登录。
 
 ## 何时使用本技能
 
-用户或编排表达以下意图之一时加载:
+出现下列**业务场景**时加载；真正执行时严格按 **`references/CLI.md`** 拼 argv，勿臆造参数。子命令与源码函数的对应关系见该文件篇首映射表。
 
-1. **添加 / 删除 / 列出账号** —— 多平台(搜狐号、头条、知乎、微信、豆包、Kimi、DeepSeek 等)的账号记录与数据目录管理。
-2. **按 id 取账号 JSON** —— 跨技能需要单行 JSON(`get`)。
-3. **按平台取网页自动化候选账号** —— 跨技能需要 `pick-web` / `list-json` 的机器可读输出。
-4. **仅打开浏览器核对页面** —— `open`(不写库、不做登录 DOM 检测)。
+1. **登记新账号**：用户给出平台名与大陆 11 位手机号 —— `add`。
+2. **人读查看列表**：要看全部或某一平台的账号台账（多行文本）；首参若能识别为平台，可用「只写平台名」或「平台名 + list」的简写 —— `list`（路由见 `cli/app.py`）。
+3. **按 id 取一条机器可读记录**：编排或调试需要单行 JSON —— `get`。
+4. **按平台或全部拉列表机器可读**：stdout 一行 JSON 数组，元素同 `get`，供跨技能编排 —— `list-json`。
+5. **为某平台挑一条网页自动化用号**：stdout 一行 JSON，按更新时间等规则选一条 —— `pick-web`。
+6. **在浏览器里打开已登记账号**：用户说「打开某平台这个账号」「用浏览器打开 id 为 x 的号」等 —— `open`（须已知账号 id；本机 Chrome/Edge + Playwright channel；不写库、不做登录检测）。
+7. **删除账号**：按 id 删一条、按平台清空、或按平台+手机号删一条 —— `delete`（`id` / `platform` / `platform`+手机号 三种形式）。
 
 ## CLI 调用
 
-所有子命令、参数、简写形式与行为细节见 `references/CLI.md`。**执行或拼写任何命令前先读该文件**,不要凭记忆臆造参数。
+语法、默认值、错误约定、**CLI → service** 映射见 **`references/CLI.md`**。
 
-**重要约束**：CLI 由宿主或工具执行；**不要把命令原文贴给最终用户看**。对用户用自然语言说明「添加某平台账号、提供大陆手机号」等即可。添加账号时**只需平台名与 11 位完整手机号**；**不要**引导用户去具体宿主菜单路径（如「技能中心 → 账号管理」等，易随产品改版失效），也**不要**让用户填写 `profile_dir`——本技能在 `add` 时会自动创建并分配浏览器用户目录。
+**重要约束**：CLI 由宿主或工具执行；**不要把命令原文贴给最终用户看**。添加账号时用户只需在对话中提供**平台名与 11 位完整手机号**；**不要**引导具体宿主菜单路径；**不要**让用户填写 `profile_dir`（`add` 时由实现分配路径）。
 
 ## 平台名称与别名
 
-入库使用英文 `platform` 键;用户话术可用中文展示名或别名。完整表与解析规则见 `references/PLATFORMS.md`。平台无法识别时会输出 `ERROR:INVALID_PLATFORM*` 系列前缀,详见 `references/ERRORS.md`。
+入库为英文 `platform` 键；用户话术可为中文名或别名。见 `references/PLATFORMS.md`；错误前缀见 `references/ERRORS.md`。
 
 ## 数据与环境
 
-数据库路径、profile 布局、日志与环境变量见 `references/RUNTIME.md`。`accounts` 表字段与 JSON 形状摘要见 `references/SCHEMA.md`。
+库路径、profile 布局、环境变量见 `references/RUNTIME.md`；表结构见 `references/SCHEMA.md`。
 
 ## 跨技能集成
 
-`get` / `list-json` / `pick-web` 的 stdout 协议、JSON 字段说明、推荐 `subprocess` 用法见 `references/INTEGRATION.md`。解析失败时首行多为 `ERROR:` —— 与 `references/ERRORS.md` 对照。
+`get` / `list-json` / `pick-web` 的 stdout 协议见 `references/INTEGRATION.md`。
 
 ## 依赖与运行时
 
-- **Python**:共享宿主 `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`,**不要**在技能目录内创建 `.venv`。
-- **浏览器**:网页相关能力依赖本机 **Chrome / Edge**(Playwright `channel` 模式,**不**下载自带 Chromium)。`open` 另需 `playwright` 包。
-- **环境变量**:`JIANGCHANG_DATA_ROOT`、`JIANGCHANG_USER_ID` 与兄弟技能一致;细节见 `references/RUNTIME.md`。
+- **Python**：共享宿主运行时；勿在技能目录内自建 `.venv`。
+- **浏览器**：`open` 依赖本机 **Chrome 或 Edge** 与 **playwright** 包（channel 模式）。详见 `references/RUNTIME.md`。
+- **环境变量**：`JIANGCHANG_*` / `CLAW_*` 等与兄弟技能一致。
 
 ## 资产与示例
 
-示例 JSON 与 JSON Schema 见 `assets/README.md` 及 `assets/examples/`、`assets/schemas/`。
+见 `assets/README.md` 及 `assets/examples/`、`assets/schemas/`。

references/CLI.md

@@ -2,6 +2,20 @@
 
 将 `{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)。

references/README.md

@@ -4,13 +4,13 @@ description: "统一管理搜狐、头条、知乎、微信、豆包、Kimi、De
 
 # 👤 账号管理
 
-把你在各平台的账号**登记到本地**,并为每个账号准备好**独立的浏览器用户目录**。这样后续「用大模型写稿」「发布到搜狐号」等技能才能知道该用哪套登录环境。
+把你在各平台的账号**登记到本地**，后续「用大模型写稿」「发布到搜狐号」等技能才能按平台选用对应账号。
 
-> 本技能**只负责登记账号与目录**,不在此处判断「有没有登录网站」。真正打开网页时,由对应业务(例如大模型网页版)在同窗口里提示你完成登录。
+> 本技能**只负责登记账号**，不在此处判断「有没有登录网站」。真正打开网页时，由对应业务（例如大模型网页版）在同窗口里提示你完成登录。
 
 ## 它能帮你做什么
 
-- **添加账号** —— 选一个平台(如豆包、搜狐号),在对话中提供**中国大陆 11 位完整手机号**,系统生成账号名并**自动创建**专属浏览器用户目录;**不需要**你自行指定 Profile 路径。
+- **添加账号** —— 选一个平台（如豆包、搜狐号），在对话里说出 **11 位大陆手机号**即可。
 - **查看列表** —— 按平台或全部列出已登记的账号。
 - **删除账号** —— 按 id、按平台整批、或按「平台 + 手机号」删除,并可清理对应本地目录。
 - **给其它技能用** —— 自动化的技能会通过内部接口按平台**取一条候选账号**(不要求你手工抄 id)。
@@ -49,4 +49,4 @@ description: "统一管理搜狐、头条、知乎、微信、豆包、Kimi、De
 
 ---
 
-**作者**:深圳匠厂科技有限公司 · **版本**:1.0.54
+**作者**:深圳匠厂科技有限公司 · **版本**:1.0.55