用途:在智能体控制的浏览器中,通过 Bitwarden Agent Access CLI(aac)完成网站登录,把凭据以“按域名批准”的方式交接给本机进程,而不是让智能体直接接触明文密码。
主要能力与原则:仅将 aac 作为经批准、限定域名的凭据交接工具;不得要求用户粘贴密码、TOTP 码、API 密钥、cookie、会话值、配对码或完整凭据 JSON;不得运行会打印 AAC_USERNAME、AAC_PASSWORD、AAC_TOTP、环境变量、shell 历史、cookie 或含认证信息的文件的命令;把 aac run --env-all 视为敏感操作,因为子进程及其代码路径可获取凭据。优先使用“凭据盲”辅助程序,若实际路径会把凭据经智能体控制的代码放入内存,需在使用前明确说明。请求真实凭据前先确认确切目标域名,只批准用户预期的域名;除非用户在操作发生时确认,否则在账号创建、最终提交、支付、权限授予或敏感表单提交前停止。
使用方式:先在不读取密钥的前提下验证前置条件,运行 command -v aac 与 aac connections list,不要检查 Bitwarden 保险库数据或环境变量。确认用户的 aac listen 已打开、已解锁并准备批准请求;若无缓存连接,让用户在本地配对,不要把配对码粘贴到对话中。用浏览器控制工具打开目标登录页,只检查可见表单结构,识别用户名/邮箱、密码和提交按钮的稳定定位符。然后用 aac run --domain <domain> --env-all -- <helper> 请求凭据,其中 <domain> 是对用户展示以供批准的注册域名或站点域名。填写并提交登录表单时不记录凭据值;提交后通过 URL、标题、问候语、退出链接或下一工作流步骤验证成功。只报告非机密状态:成功、请求的域名、到达的页面或脱敏的错误类型。
推荐模式:在智能体控制的浏览器中,可靠做法是在 aac run 等待用户批准时保持浏览器控制执行处于活动状态:在活动浏览器控制执行中验证登录定位符唯一;在 127.0.0.1 的随机端口启动临时服务器;生成 aac run --domain <domain> --env-all -- node -e '<small helper>';helper 读取 AAC_USERNAME 与 AAC_PASSWORD,发送到本地临时服务器后退出;活动浏览器控制执行在内存中接收值、填写字段、点击登录、关闭服务器,只返回脱敏状态。实现该模式前阅读 references/browser-bridge.md。
失败模式:找不到缓存连接时,用户需将远程客户端与 aac listen 配对,不要索取粘贴的令牌;请求被拒绝可能是用户拒绝批准、域名错误或无匹配保险库条目;登录页无变化时检查可见验证错误及 helper 是否退出,但不要打印凭据值;后台桥接收到凭据却未填写页面时,保持浏览器控制调用存活,不要依赖工具调用返回后的异步回调执行浏览器操作。
脱敏:记录或保存工作流时用占位符替换真实值,如域名 example-app.test、URL https://example-app.test/login、姓名与邮箱 user@example.test、账户标签 Example Account、配对码 [rendezvous-code]、指纹/会话 id/合约 id/条目 id 用 [id];不要提交本地应用 URL、账户名、邮箱、租赁/申请数据、机密或含用户特定细节的文字片段。