58 lines
3.5 KiB
Markdown
58 lines
3.5 KiB
Markdown
---
|
||
name: 账号管理
|
||
description: "多平台账号(搜狐号、头条、知乎、微信公众号、豆包、Kimi、DeepSeek 等)的本地登记与查询。当用户或编排要添加/删除账号、列出全部或某平台账号、按 id 查看单条账号信息、为网页自动化批量取账号 JSON 或从中选一条候选、在浏览器中打开已登记账号以登录或核对页面时,加载本技能。本技能不在库中记录「是否已登录」;具体子命令与参数以 references/CLI.md 为准。"
|
||
version: 1.0.55
|
||
author: 深圳匠厂科技有限公司
|
||
metadata:
|
||
openclaw:
|
||
slug: account-manager
|
||
emoji: "👤"
|
||
category: "通用"
|
||
allowed-tools:
|
||
- bash
|
||
---
|
||
|
||
# 账号管理(account-manager)
|
||
|
||
在本地 SQLite 登记各平台账号与持久化用户目录路径,供其它技能通过子进程调用 `scripts/main.py` 读取或维护。**不在库中持久化「是否已登录」**;`pick-web` 仅按规则选一条候选,**不表示**当前浏览器已登录。
|
||
|
||
## 何时使用本技能
|
||
|
||
出现下列**业务场景**时加载;真正执行时严格按 **`references/CLI.md`** 拼 argv,勿臆造参数。子命令与源码函数的对应关系见该文件篇首映射表。
|
||
|
||
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 调用
|
||
|
||
语法、默认值、错误约定、**CLI → service** 映射见 **`references/CLI.md`**。
|
||
|
||
**重要约束**:CLI 由宿主或工具执行;**不要把命令原文贴给最终用户看**。添加账号时用户只需在对话中提供**平台名与 11 位完整手机号**;**不要**引导具体宿主菜单路径;**不要**让用户填写 `profile_dir`(`add` 时由实现分配路径)。
|
||
|
||
## 平台名称与别名
|
||
|
||
入库为英文 `platform` 键;用户话术可为中文名或别名。见 `references/PLATFORMS.md`;错误前缀见 `references/ERRORS.md`。
|
||
|
||
## 数据与环境
|
||
|
||
库路径、profile 布局、环境变量见 `references/RUNTIME.md`;表结构见 `references/SCHEMA.md`。
|
||
|
||
## 跨技能集成
|
||
|
||
`get` / `list-json` / `pick-web` 的 stdout 协议见 `references/INTEGRATION.md`。
|
||
|
||
## 依赖与运行时
|
||
|
||
- **Python**:共享宿主运行时;勿在技能目录内自建 `.venv`。
|
||
- **浏览器**:`open` 依赖本机 **Chrome 或 Edge** 与 **playwright** 包(channel 模式)。详见 `references/RUNTIME.md`。
|
||
- **环境变量**:`JIANGCHANG_*` / `CLAW_*` 等与兄弟技能一致。
|
||
|
||
## 资产与示例
|
||
|
||
见 `assets/README.md` 及 `assets/examples/`、`assets/schemas/`。
|