Release v1.0.53: account docs split, remove login flow, SCHEMA reference

references/CLI.md

@@ -1,6 +1,6 @@
-# account-manager CLI 参考
+# account-manager CLI 速查
 
-入口：`{skillRoot}/scripts/main.py`（宿主可将 `{baseDir}` 或技能根目录代入）。下文用 `python main.py` 表示在 `scripts/` 目录执行，或写成 `python {skillRoot}/scripts/main.py`。
+将 `{baseDir}` 替换为技能根目录。所有命令通过 `python {baseDir}/scripts/main.py` 调用（工作目录可为技能根或 `scripts/`，与命令中的路径一致即可）。下文示例简写为 `python main.py` 表示在 `scripts/` 下执行。
 
 ## 通用说明
 
@@ -65,23 +65,14 @@ python main.py pick-web <平台>
 - 按该平台 `updated_at`、`created_at` 倒序选一条；**不**表示当前浏览器已登录。
 - 失败：首行 `ERROR:`。
 
-### `open` — 仅打开浏览器（**不写库**）
+### `open` — 仅打开浏览器（**不写库、不检测登录**）
 
 ```bash
 python main.py open <id>
 ```
 
 - 需本机 Chrome/Edge + Playwright；详见运行环境说明。
-
-### `login` — 打开浏览器并**自动检测登录**（成功则刷新 `updated_at`）
-
-```bash
-python main.py login <id>
-```
-
-- 依赖 Playwright；超时与轮询间隔等见 [RUNTIME.md](RUNTIME.md)。
-- **不**在库中持久化「是否已登录」；仅刷新 `updated_at` 供 `pick-web` 等排序参考。
-- 跨技能编排（如 llm-manager 网页生成）**不再**通过本 skill 单独做「登录预检」；由业务侧在同一浏览器会话内处理未登录态。
+- 仅供人工核对页面；登录与否由业务侧（如 llm-manager 网页引擎）在使用账号时自行处理。
 
 ### `delete` — 删除库记录并尽量删除 profile 目录
 

references/ERRORS.md

@@ -9,7 +9,6 @@
 | `ERROR:CLI_ADD_MISSING_ARGS` | `add` 参数不足 |
 | `ERROR:CLI_GET_MISSING_ID` | `get` 缺少 id |
 | `ERROR:CLI_OPEN_MISSING_ID` | `open` 缺少 id |
-| `ERROR:CLI_LOGIN_MISSING_ID` | `login` 缺少 id |
 | `ERROR:CLI_DELETE_MISSING_ARGS` | `delete` 参数不足 |
 | `ERROR:CLI_DELETE_BAD_MODE` | `delete` 第二段不是 `id`/`platform` |
 | `ERROR:CLI_LIST_JSON_MISSING_PLATFORM` | `list-json` 缺少平台参数 |

references/PLATFORMS.md

@@ -16,6 +16,7 @@
 | `qianwen` | 通义千问 | 通义 | 通义、千问 | https://tongyi.aliyun.com |
 | `yiyan` | 文心一言 | 文心 | 文心、一言 | https://yiyan.baidu.com |
 | `yuanbao` | 腾讯元宝 | 元宝 | 元宝 | https://yuanbao.tencent.com |
+| `gemini` | Gemini | Gemini | 谷歌Gemini、Google Gemini、google gemini、Bard | https://gemini.google.com |
 
 ## 解析规则（摘要）
 

references/README.md

@@ -1,13 +1,52 @@
-# references（account-manager）
+---
+description: "统一管理搜狐、头条、知乎、微信、豆包、Kimi、DeepSeek 等多平台账号与浏览器配置目录。添加账号后,其它技能(如大模型写作、平台发布)可按平台自动选用对应环境。"
+---
 
-供 Agent 按需加载的说明文档（与 `SKILL.md` 配合，渐进式披露）。
+# 👤 账号管理
 
-| 文件 | 内容 |
-|------|------|
-| [CLI.md](CLI.md) | 子命令、参数、行为说明 |
-| [PLATFORMS.md](PLATFORMS.md) | 平台英文键、中文名、别名 |
-| [RUNTIME.md](RUNTIME.md) | 环境变量、数据路径、日志、登录调参 |
-| [ERRORS.md](ERRORS.md) | `ERROR:` 前缀一览 |
-| [INTEGRATION.md](INTEGRATION.md) | 跨 Skill 调用与 JSON 解析约定 |
+把你在各平台的账号**登记到本地**,并为每个账号准备好**独立的浏览器用户目录**。这样后续「用大模型写稿」「发布到搜狐号」等技能才能知道该用哪套登录环境。
 
-示例 JSON 与 Schema 见仓库 `assets/`。
+> 本技能**只负责登记账号与目录**,不在此处判断「有没有登录网站」。真正打开网页时,由对应业务(例如大模型网页版)在同窗口里提示你完成登录。
+
+## 它能帮你做什么
+
+- **添加账号** —— 选一个平台(如豆包、搜狐号),填**中国大陆 11 位手机号**,系统生成账号名与专属目录。
+- **查看列表** —— 按平台或全部列出已登记的账号。
+- **删除账号** —— 按 id、按平台整批、或按「平台 + 手机号」删除,并可清理对应本地目录。
+- **给其它技能用** —— 自动化的技能会通过内部接口按平台**取一条候选账号**(不要求你手工抄 id)。
+
+## 你可以这样对它说
+
+- 「帮我添加一个豆包账号,手机号 138xxxx。」
+- 「列出我所有的搜狐号账号。」
+- 「删除头条号里手机尾号 3701 的那条。」
+- 「我想看看 3 号账号在浏览器里打开是什么页面。」
+
+## 你需要提供什么
+
+| 场景 | 你需要给的 |
+|---|---|
+| 添加账号 | **平台名称**(可说中文,如豆包、搜狐号) + **大陆 11 位手机号**(同平台下同号不能重复) |
+| 删除 | 账号 **id**,或平台名,或平台名 + 手机号 |
+| 仅打开浏览器核对 | 账号 **id**(需本机已安装 Chrome 或 Edge) |
+
+## 失败了怎么办
+
+- **提示手机号格式不对**:需 **1 开头、第二位 3～9、共 11 位数字**。
+- **提示同平台手机号已存在**:该平台上这条号已经加过,无需重复添加。
+- **列表是空的但你觉得应该有**:可能是当前设备与云端使用了**不同的数据目录**;在宿主设置里确认数据根目录与账号一致,或联系管理员。
+
+## 它不做什么
+
+- ❌ 不在此处替你**判定**各网站「是否已登录」(由使用账号的具体功能负责)
+- ❌ 不代替**内容管理、发布、大模型调用**等业务技能(本技能只提供账号与目录信息)
+- ❌ 不存储你的**大模型 API Key**(那是大模型管理技能的职责)
+
+## 相关技能
+
+- **大模型管理**:写稿时若走网页版大模型,会依赖本技能登记的账号与目录。
+- **内容管理、各平台发布**:按平台取账号时也会用到本技能的数据。
+
+---
+
+**作者**:深圳匠厂科技有限公司 · **版本**:1.0.53

references/RUNTIME.md

@@ -36,15 +36,9 @@
 | `JIANGCHANG_LOG_BACKUP_COUNT` | 轮转保留份数，默认 `30` |
 | `JIANGCHANG_TRACE_ID` | 可选；跨技能子进程由父进程注入以串联同一调用链 |
 
-## 登录 / 浏览器子进程（login）
+## 浏览器（open）
 
-`service/browser_service.py` 与子进程 `service/login_child_runner.py`：
-
-| 变量 | 作用 |
-|------|------|
-| `JIANGCHANG_LOGIN_TIMEOUT_SECONDS` | 登录检测最长秒数，默认 `300`，不少于 `60` |
-| `JIANGCHANG_LOGIN_POLL_INTERVAL_SECONDS` | DOM 轮询间隔，默认 `1.5`，限制在 `0.5..10` |
-| `JIANGCHANG_LOGIN_DOM_GRACE_SECONDS` | 打开 URL 后等待再检测，默认 `4`，减轻跳转误判 |
+`open` 由 `service/browser_service.py` 与子进程 `service/open_child_runner.py` 启动持久化上下文，仅用于人工查看；**不做**登录态 DOM 检测。
 
 依赖：**本机已安装 Chrome 或 Edge**；Python 环境需 **`playwright` 包**（匠厂共享 `python-runtime` 已包含）。运行时使用 **Playwright `channel=chrome|msedge`** 调系统浏览器，**不要**执行 `playwright install chromium`（避免下载自带 Chromium）。
 
@@ -52,4 +46,3 @@
 
 - **`ERROR:需要 playwright Python 包`**：确认共享 venv 已 `uv sync`；本机安装 Chrome 或 Edge。
 - **`ERROR:PROFILE_DIR_MISSING`**：库中该账号 `profile_dir` 为空，需检查数据或重新添加账号流程。
-- **登录检测一直失败**：关闭占用同一 profile 目录的其它浏览器；可调高超时与环境变量；查看统一日志文件。

references/SCHEMA.md

@@ -0,0 +1,28 @@
+# 数据存储(account-manager)
+
+## 数据库路径
+
+`{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/account-manager/account-manager.db`
+
+`JIANGCHANG_DATA_ROOT` 与 `JIANGCHANG_USER_ID` 由宿主注入,与兄弟技能保持一致。路径解析细节见 [RUNTIME.md](RUNTIME.md)。
+
+## `accounts` 表(核心字段)
+
+- `id` —— 自增主键,CLI 与跨技能常称「账号 id」
+- `name` —— 展示用名称(如「豆包1号」)
+- `platform` —— 平台英文键(小写,如 `doubao`、`sohu`),见 [PLATFORMS.md](PLATFORMS.md)
+- `phone` —— 归一化后的 11 位数字串
+- `profile_dir` —— 持久化浏览器用户数据目录绝对路径,供 Playwright 等复用
+- `url` —— 该平台默认入口 URL
+- `extra_json` —— 可选扩展(JSON 文本),`get` 成功时可能并入返回对象
+- `created_at` / `updated_at` —— Unix 秒;`pick-web` 等按更新时间排序选候选
+
+**说明**:表中**不**存「是否已登录」字段;业务侧在真实浏览器会话中自行处理登录态。
+
+## Profile 文件布局
+
+浏览器配置目录通常位于技能数据目录下的 `profiles/` 分层路径,由实现生成。删除账号时实现会尽量同时删除对应目录,见 [CLI.md](CLI.md) `delete` 说明。
+
+## 与 JSON 输出的对应关系
+
+`get` / `list-json` / `pick-web` 单行 JSON 的键名与上表及 `extra_json` 展开规则见 [INTEGRATION.md](INTEGRATION.md) 与仓库 `assets/schemas/`。