1Password Browser Login

从 1Password 取出账号密码，用无头浏览器自动登录目标网站，然后根据用户需求操作页面。 适用场景：用户说"帮我登录 xxx 然后做 yyy"、"用 1Password 登录 xxx"、"从 1Password 取 xxx 的账号登录并下载数据/截图/抓取内容"等。 前提：系统已安装 1Password CLI（op），且 OP_SERVICE_ACCOUNT_TOKEN 已配置在 ~/.zshrc 中。

从 1Password 取凭证，无头浏览器自动登录，执行用户指定任务。

前提检查

source ~/.zshrc 2>/dev/null && op whoami 2>&1

若失败，提示用户配置 OP_SERVICE_ACCOUNT_TOKEN。

执行流程

Step 1：解析意图

从用户消息提取：

• ITEM_NAME：1Password 中的 item 名称
• TASK：登录后要做什么

ITEM_NAME 不明确时，列出所有可用 item 让用户选：

source ~/.zshrc 2>/dev/null && op item list --format json 2>&1

Step 2：取凭证

服务账户必须指定 vault，先列出：

source ~/.zshrc 2>/dev/null && op vault list --format json 2>&1

取 item 详情：

source ~/.zshrc 2>/dev/null && op item get "<ITEM_NAME>" --vault "<VAULT_NAME>" --format json 2>&1

从 JSON 中提取：

• fields[] 中 purpose=USERNAME 的 value → username
• fields[] 中 purpose=PASSWORD 的 value → password
• urls[0].href → 登录页 URL

⚠️ 安全规则：

• 禁止将 password 打印到回复或日志
• 禁止将凭证写入任何文件
• 回复用户只说"已从 1Password 取得凭证"

Step 3：浏览器登录

browser open url=<登录页URL>
browser snapshot → 找用户名输入框、密码输入框、登录按钮的 ref
browser act kind=type ref=<用户名框> text=<username>
browser act kind=type ref=<密码框> text=<password>
browser act kind=click loadState=networkidle ref=<登录按钮>
browser snapshot → 确认已离开登录页（登录成功）

Step 4：执行任务

任务类型	操作
截图	browser screenshot → 保存到 ./downloads/ → MEDIA:./downloads/文件名 发给用户
抓页面数据	browser snapshot → 解析内容 → 整理回复
下载文件	browser act kind=click 触发下载 → exec 找到文件移到 workspace → MEDIA: 发送
导航后操作	browser navigate url=<目标页> → 再截图/抓数据/下载

结果文件保存路径：./downloads/YYYY-MM-DD_<网站名>_<描述>.<扩展名>

错误处理

错误	处理
item 不存在	列出所有 item，让用户确认名称
vault 无权限	提示在 1Password 后台给服务账户授权该 vault
登录失败（密码错误）	截图当前页，告知用户
需要 2FA	告知不支持，需用户手动处理
CAPTCHA	截图，告知用户需手动完成验证
找不到输入框	截图，让用户描述表单位置

示例

用户： 帮我登录 MyApp 然后截个首页截图

1. ITEM_NAME="MyApp"，TASK="截首页截图"
2. 取凭证 → browser 登录 → screenshot → 发给用户

用户： 用 1Password 登录 GitHub 下载最新 release

1. ITEM_NAME="GitHub"，TASK="下载最新 release"
2. 取凭证 → 登录 → 导航到 releases 页 → 点击下载 → 发文件