account-manager/references/README.md

description

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

🔐 账号与凭据管理

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

本技能是唯一账号/凭据管理入口。业务 skill 不自己散落密码、API Key，而是通过 CLI（或与 CLI 组合的同进程 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）。
• 加密备份与迁移 — 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；加密与环境变量见 RUNTIME.md。

---

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