Agent 用法 GitHub · bggoranoff/agent-blindfold
用 agent-blindfold 让浏览器 Agent 登录时不看密码也能签入
Agent 碰到登录页时弹独立窗口或发一次性链接,你填密码和验证码,脚本代为提交,agent 只获得“填了哪些字段”。
效果
仓库 docs 目录含 demo.gif、demo.mp4 与 demo-phone.gif、demo-phone.mp4,展示伪造站点上 agent 与手机模拟浏览器完成登录的过程;README 说明其中链接为真实 Cloudflare quick tunnel,agent 台词为脚本、命令与输出为真实。
这是什么
新在哪里:以前浏览器 agent 登录要么停手等你接手,要么让你把密码和 2FA 码粘进聊天;现在密文只进一次性窗口或手机链接,脚本直接键入 agent 的标签页,密码不进入模型上下文。
怎么做到的:把一个无依赖的 Node 脚本安装为 Agent Skill:用 `npx skills add bggoranoff/agent-blindfold` 或按 README 的安装提示把仓库克隆到 ~/.agent-blindfold 并链入 ~/.claude/skills 与 ~/.agents/skills,在自己的 Chrome 场景再加载伴生扩展;agent 遇到登录时运行 `signin.mjs ask` 取一次性链接/窗口,你从密码管理器填入,再 `signin.mjs wait` 等待状态变成 filled。
- 适合谁
- 用 Claude Code / Codex 等带浏览器能力的 agent 代操作网页、又不想把账号密码交给模型的用户。
- 能帮你
- 把登录与 2FA 交接给一次性窗口或手机链接,agent 全程不接触密码和验证码。
评分 三项分开看,不合成总分;热度不等于好用
- 新颖性
- 全新做法 · 2026-10-15 出现
- 热度
- 未知
- 易上手
- 需要一些准备
怎么评的
三项都由本站记录的事实按固定规则算出,编辑不能直接改档位;规则改动会写进更新说明。
新颖性
- ●●● 全新做法,且有来源依据的出现时间在最近 30 天内
- ●●○ 老工具新用法或近期刚开放,且有来源依据的时间在最近 30 天内
- ●○○ 出现时间超过 30 天、未核实到精确日期,或已不再是新做法
- 其他 出现时间未核实、晚于今天,或新颖类型未核实时按最低一档处理,不靠猜测加分
热度
- ●●● 最近一次每周人工确认为“热门”:最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足(规则 heat-v1)
- ●●○ 最近一次人工确认为“观察中”:前三项至少一项达到,或讨论增长 ≥ 50%,且至少 2 个独立案例
- ●○○ 最近一次人工确认为“未进入跟踪”
- 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源,不代表全网
易上手
- ●●● 准备门槛低且难度入门:不需要新账号或付费,首次尝试不超过 30 分钟,公开可用,会复制粘贴即可
- ●●○ 准备门槛中等,或门槛低但需要改少量代码或配置
- ●○○ 准备门槛高:需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案,或需要专业知识
- 其他 只有介绍、还没有站内步骤,或关键步骤已失效时显示“暂不可试”;门槛未核实时显示“未核实”
怎么尝试
- 时间 首次约 20 分钟
- 费用 免费:仓库为 MIT 开源,README 未标注任何收费项目。
- 账号 不需要新账号
- 环境 Node.js 22 及以上;Chromium 系浏览器(README 以 Google Chrome 为例,另可指定 Brave 等 profile 目录);带 shell 的 agent(Claude Code 或 Codex)。
- 准备 Node.js 22+:运行 signin.mjs 脚本,README 要求 node -v 为 22 或更高
- 准备 Claude Code 或 Codex 等带 shell 的 agent:执行安装提示中的命令并驱动浏览器
- 准备 Chromium 系浏览器(如 Google Chrome):作为 agent 浏览的浏览器,需 DevTools 端口或加载伴生扩展
- 准备 密码管理器(选用):在一次性窗口或手机链接中填入账号密码与验证码
- 准备 手机(选用):服务器场景下接收一次性登录链接
替代方案:没有有效替代方案。能做到:网页未列出同类工具;在不把密码交给模型这一前提下,README 描述的独立窗口/一次性链接代填方式本身即是它提出的方案。;差别:原站未说明。
完成替代方案不算复现本实践。
按下面的步骤就能做出第一个结果。复制命令不会自动执行。
检查 Node 版本
在终端确认 Node 版本为 22 或以上;README 要求不满足时停下。
bash原始来源命令node -v预期结果:输出 v22 或更高版本号
一行安装 skill
对在带 DevTools 端口的 Chromium 中浏览的 agent,用 skills CLI 一行安装。
bash原始来源命令npx skills add bggoranoff/agent-blindfold预期结果:agent-blindfold skill 安装完成并可被 agent 识别
自用 Chrome 场景克隆并链接 skill
把仓库克隆到 ~/.agent-blindfold(已存在则 pull),然后软链到 Claude Code 与 Codex 的 skills 目录。
bash原始来源命令mkdir -p ~/.claude/skills ~/.agents/skills预期结果:skills 目录存在,后续软链命令可执行
安装伴生扩展
运行 install 子命令,让脚本打印加载扩展的步骤;按提示在 Chrome 中加载扩展后再继续。
bash原始来源命令node ~/.agent-blindfold/skills/agent-blindfold/signin.mjs install预期结果:打印出在 Chrome 中加载扩展的步骤
在公开测试站点发起登录
在日常 Chrome 中打开测试登录页,用 extension 通道对 the-internet.herokuapp.com 发起 ask,记录打印的 url。公开测试账号为 tomsmith / SuperSecretPassword!。
bash原始来源命令node ~/.agent-blindfold/skills/agent-blindfold/signin.mjs ask --cdp extension --tab the-internet.herokuapp.com预期结果:打印出一次性登录 url 与任务 id
填入并等待完成
在窗口或打印的 url 中填入测试账号后,用 ask 返回的 id 运行 wait,超时设为 10 分钟。
bash原始来源命令node ~/.agent-blindfold/skills/agent-blindfold/signin.mjs wait <id>预期结果:最后一行含 "status":"filled",测试页显示 “You logged into a secure area!”