---
description: "通用账号 & 凭据 & 登录流程管理器。管理网页/RPA 账号、API Key/Token；支持 9 种登录策略与 Fernet 加密入库；可选 CLI + rpa_helpers 同进程自动登录。涵盖物流、LLM、内容、开发、仿真等平台。"
---

# 🔐 账号与凭据管理

把你在各平台的账号与凭据**登记到本地**，后续物流 RPA、大模型写作、内容发布等技能才能自动选用对应环境。

> 本技能是**唯一**账号/凭据管理入口。业务 skill 不自己散落密码、API Key，而是通过 CLI（或与 CLI 组合的同进程 [`RPA_HELPERS.md`](RPA_HELPERS.md)）获取。

## 它能帮你做什么

- **添加网页/RPA 账号** — 选平台，给出登录标识（邮箱/手机/用户名），自动创建浏览器 profile 目录。
- **添加 API Key/Token / 加密密码** — `none` / `env` / `windows_credential` / `local_encrypted`（Fernet 密文入库）。
- **查看/列出账号** — 按平台、环境、角色等多维度筛选。
- **给 RPA 技能用** — `pick-web` 按规则挑候选账号，支持 lease 防并发；输出含 `auth_strategy` / `session_persistent` / `device_fingerprint`。
- **给 LLM 技能用** — `credential pick` 安全获取 API Key。
- **在浏览器里查看** — `open <id>` 打开 Chrome/Edge 查看，仅查看不写库。
- **加密存储密码** — Fernet 加密，密码在 SQLite 中以密文形式存在；只有持有 master key 才能解密。
- **9 种登录策略** — 账密自动、账密+图形验证码、账密+2FA、扫码、每次手动登录、设备绑定、客户端证书、API Token、SSO 跳转；业务 skill 可调用统一入口 `ensure_logged_in`（见 [`RPA_HELPERS.md`](RPA_HELPERS.md)）。
- **加密备份与迁移** — `export-credentials --plaintext` 导出 JSON，`import-credentials` 在新机器重新加密写入（需先 `init-master-key`）。

## 你可以这样对它说

- 「帮我添加一个 Maersk 模拟器账号，邮箱 demo@maersk.com。」
- 「添加 DeepSeek 的 API Key，存在 Windows 凭据管理器里。」
- 「列出所有物流平台的账号。」
- 「用浏览器打开 3 号账号看看页面。」
- 「给 RPA 技能取一个 maersk 模拟器的 booking 账号。」
- 「我要把工行仿真账号的密码加密保存，下次 RPA 自动登录用。」
- 「给我导出所有加密凭据，明天换台电脑要用。」

## 你需要提供什么

| 场景 | 你需要给的 |
|---|---|
| 添加网页账号 | **平台名称** + **登录标识**（邮箱/手机/用户名） |
| 添加 API Key / 加密密码 | **平台名称** + **凭据类型**（api_key 等）+ **secret**（stdin / 环境变量引用等） |
| 查看/列出 | 可选：平台名、环境、角色等筛选条件 |
| 浏览器打开 | 账号 **id**（需本机已安装 Chrome 或 Edge） |

## 它不做什么

- 不在此处包办所有网站的 DOM 自动化细节（具体抓取逻辑在各业务 skill）
- 不代替内容管理、发布、大模型调用等业务技能
- `windows_credential` / `env` 路径下不把明文写入 SQLite；`local_encrypted` 仅存 Fernet 密文

## Secret 存储方式

| 方式 | 说明 |
|---|---|
| `none` | 无 secret（浏览器 profile 登录态） |
| `env` | 引用环境变量名，运行时读取 |
| `windows_credential` | 正式推荐：真实 secret 存 Windows Credential Manager |
| `local_encrypted` | 本地 Fernet 加密存 DB；需先 `account init-master-key` |

命令细节见 [`CLI.md`](CLI.md)；加密与环境变量见 [`RUNTIME.md`](RUNTIME.md)。

---

**作者**:深圳匠厂科技有限公司 · **版本**:2.0.0