用途:在 chrome-use 中并行运行多个相互隔离的浏览器会话,适用于多用户流程测试或并行抓取。
主要能力:每个 --session <name> 是独立浏览器,拥有自己的 cookie、标签页与 refs。示例: chrome-use --session a open https://app.example.com chrome-use --session b open https://app.example.com chrome-use --session a fill @e1 "alice@test.com" chrome-use --session b fill @e1 "bob@test.com" AGENT_BROWSER_SESSION=myapp 可设置当前 shell 的默认会话。
使用约束:并发 agent 必须各自使用不同的 --session;同一会话内命令被绑定到所打开的标签页(按 target_id),避免误操作外部标签页。两个 agent 共用同一会话(如都用默认会话)会共享同一守护进程与活动标签页,互相覆盖。真正的多 agent 隔离需走 extension-connect 路径,每个 --session 拥有独立彩色标签组;裸 --cdp <port> 不隔离。t<N> 索引不跨会话稳定,跨会话接管应使用稳定的 CDP targetId: chrome-use tab list --full --session B chrome-use tab <targetId> --session B 按 targetId 接管不会重新加载,可保留已填表单。重开同一入口 URL 时可加 --reuse-tab 复用已有标签页。会话异常时可用 chrome-use daemon status 与 chrome-use daemon restart 重置守护进程,重启不影响扩展的 native-messaging 桥接,也不关闭标签页。
人工接管:自主登录为默认方式,handoff 仅用于 agent 确实无法完成的一步(如设备 2FA、验证码):chrome-use session handoff / status / list / resume。接管期间该会话的驱动命令会以退出码 1 拒绝执行,所有权按会话独立。