Release v1.0.56: Credential & Browser Profile Manager

references/README.md

@@ -1,51 +1,52 @@
 ---
-description: "统一管理搜狐、头条、知乎、微信、豆包、Kimi、DeepSeek 等多平台账号与浏览器配置目录。添加账号后,其它技能(如大模型写作、平台发布)可按平台自动选用对应环境。"
+description: "通用 Credential & Browser Profile Manager：管理网页账号、RPA 浏览器 profile、LLM/API 平台 API Key。支持物流、LLM、内容三大业务域。"
 ---
 
-# 👤 账号管理
+# 🔐 账号与凭据管理
 
-把你在各平台的账号**登记到本地**，后续「用大模型写稿」「发布到搜狐号」等技能才能按平台选用对应账号。
+把你在各平台的账号与凭据**登记到本地**，后续物流 RPA、大模型写作、内容发布等技能才能自动选用对应环境。
 
-> 本技能**只负责登记账号**，不在此处判断「有没有登录网站」。真正打开网页时，由对应业务（例如大模型网页版）在同窗口里提示你完成登录。
+> 本技能是**唯一**账号/凭据管理入口。业务 skill 不自己存密码、API Key，而是通过 CLI 调用获取。
 
 ## 它能帮你做什么
 
-- **添加账号** —— 选一个平台（如豆包、搜狐号），在对话里说出 **11 位大陆手机号**即可。
-- **查看列表** —— 按平台或全部列出已登记的账号。
-- **删除账号** —— 按 id、按平台整批、或按「平台 + 手机号」删除,并可清理对应本地目录。
-- **给其它技能用** —— 自动化的技能会通过内部接口按平台**取一条候选账号**(不要求你手工抄 id)。
+- **添加网页/RPA 账号** — 选平台，给出登录标识（邮箱/手机/用户名），自动创建浏览器 profile 目录。
+- **添加 API Key/Token** — 安全存储：API Key 明文存入 Windows Credential Manager 或环境变量引用，SQLite 只保存元数据和打码值。
+- **查看/列出账号** — 按平台、环境、角色等多维度筛选。
+- **给 RPA 技能用** — `pick-web` 按规则挑候选账号，支持 lease 防并发。
+- **给 LLM 技能用** — `credential pick` 安全获取 API Key。
+- **在浏览器里查看** — `open <id>` 打开 Chrome/Edge 查看，仅查看不写库。
 
 ## 你可以这样对它说
 
-- 「帮我添加一个豆包账号,手机号 138xxxx。」
-- 「列出我所有的搜狐号账号。」
-- 「删除头条号里手机尾号 3701 的那条。」
-- 「我想看看 3 号账号在浏览器里打开是什么页面。」
+- 「帮我添加一个 Maersk 模拟器账号，邮箱 demo@maersk.com。」
+- 「添加 DeepSeek 的 API Key，存在 Windows 凭据管理器里。」
+- 「列出所有物流平台的账号。」
+- 「用浏览器打开 3 号账号看看页面。」
+- 「给 RPA 技能取一个 maersk 模拟器的 booking 账号。」
 
 ## 你需要提供什么
 
 | 场景 | 你需要给的 |
 |---|---|
-| 添加账号 | **平台名称**(可说中文,如豆包、搜狐号) + **大陆 11 位手机号**(同平台下同号不能重复) |
-| 删除 | 账号 **id**,或平台名,或平台名 + 手机号 |
-| 仅打开浏览器核对 | 账号 **id**(需本机已安装 Chrome 或 Edge) |
-
-## 失败了怎么办
-
-- **提示手机号格式不对**:需 **1 开头、第二位 3～9、共 11 位数字**。
-- **提示同平台手机号已存在**:该平台上这条号已经加过,无需重复添加。
-- **列表是空的但你觉得应该有**:可能是当前设备与云端使用了**不同的数据目录**;在宿主设置里确认数据根目录与账号一致,或联系管理员。
+| 添加网页账号 | **平台名称** + **登录标识**（邮箱/手机/用户名） |
+| 添加 API Key | **平台名称** + **凭据类型**（api_key 等）+ **secret**（通过 stdin 或环境变量） |
+| 查看/列出 | 可选：平台名、环境、角色等筛选条件 |
+| 浏览器打开 | 账号 **id**（需本机已安装 Chrome 或 Edge） |
 
 ## 它不做什么
 
-- ❌ 不在此处替你**判定**各网站「是否已登录」(由使用账号的具体功能负责)
-- ❌ 不代替**内容管理、发布、大模型调用**等业务技能(本技能只提供账号与目录信息)
-- ❌ 不存储你的**大模型 API Key**(那是大模型管理技能的职责)
+- 不在此处判定各网站「是否已登录」（由业务技能自行处理）
+- 不代替内容管理、发布、大模型调用等业务技能
+- 不保存 API Key 明文在 SQLite 中（仅存引用和打码值）
 
-## 相关技能
+## Secret 存储方式
 
-- **大模型管理**:写稿时若走网页版大模型,会依赖本技能登记的账号与目录。
-- **内容管理、各平台发布**:按平台取账号时也会用到本技能的数据。
+| 方式 | 说明 |
+|---|---|
+| `none` | 无 secret（浏览器 profile 登录态） |
+| `env` | 引用环境变量名，运行时读取 |
+| `windows_credential` | 正式推荐：真实 secret 存 Windows Credential Manager |
 
 ---