Space
Agent 在 ego lite 中执行网页任务的并行工作区。
Space 是 ego lite 为 AI Agent 划出的并行工作区。Agent 在 Space 里打开网页、读取页面、点击、填表、下载文件,你继续在自己的标签页里工作。两边共用同一个 ego lite 浏览器进程,但标签页和上下文互不打断。
它是什么、不是什么
Space 是:
- 同一个 ego lite 浏览器进程里的并行工作区。
- 每个任务一个独立的 BrowserContext,cookie 与 storage 隔离。
Space 不是:
- 不是新开一个浏览器窗口或新的 Chrome Profile。
- 不是 headless Chrome 或屏幕外渲染。
- 不是云端浏览会话,所有数据都在本机。
为什么要做 Space
让 Agent 操作真实浏览器时,常见做法是为每个任务启动一个独立的 Chromium 实例(headless 或带 profile 复制)。Chrome 的同一个 user-data-dir 通常只能被一个进程持锁,要复用本机登录态跑多 session,要么互相打架,要么把 profile 复制到临时目录。
Space 的做法是:所有 Agent 任务共用 ego lite 的主进程,每个任务用一个原生 BrowserContext 隔离 cookie 和 storage,但共享浏览器基础设施和你已有的登录环境。
一次 6 并发、仅打开 about:blank 的对照测试:
| 方案 | 增加内存 | 增加进程数 | 并发启动耗时 |
|---|---|---|---|
| 独立浏览器实例 + profile 复制 | 约 15 GB | 约 84 个 | 约 2.5 秒 |
| ego lite Space | 约 0.9 GB | 约 6 个 | 约 0.6 秒 |
数据仅说明资源模型差异。实际开销随页面复杂度、扩展、站点脚本和并发数量变化。
适合放进 Space 的任务
需要真实网页操作、登录态或文件交互时使用 Space:
- 访问登录后的后台、个人工作台、订单页、私有文档。
- 需要点击、输入、翻页、筛选、上传或下载。
- 复用 ego lite 已有的登录状态,而不是为每个任务重新登录。
- 任务结束后你想检查 Agent 打开过哪些页面、做了什么。
如果只是查公开信息,普通 web search 更轻。
用户和 Agent 的协作
Agent 在 Space 中执行任务时不会抢占你当前页面、鼠标或焦点。你可以继续浏览,也可以随时切到 Space 看进度。
典型流程:
- 你在 Codex / Claude Code / Cursor 等 Agent 里描述网页任务。
- Agent 通过
ego-browser写代码操作浏览器,在 Space 里打开目标网站。 - Agent 读取 Snapshot 并执行操作。
- 遇到验证码、扫码登录、支付确认等需要本人处理的步骤,Agent 暂停等你接管。
- 你完成必要操作后,Agent 继续。
- 任务完成后 Space 中的标签页保留,方便复核。
登录状态
ego lite 已登录的网站,Agent 在 Space 中通常可以直接访问登录后的页面,不需要重新导入 cookie。
下面这些情况 Agent 应当停下让你处理:
- 短信、邮箱验证码、扫码登录、硬件密钥。
- 支付、下单、转账、退款。
- 发布、删除、归档、批量修改这类不易撤销的操作。
- 授权第三方应用访问账号。
你也可以在任务一开始就写明边界,例如「只读,不要修改」或「提交前先让我确认」。
多任务并行
Space 可以同时承载多个任务,每个任务有独立的标签页、cookie 和 storage。useOrCreateTaskSpace(name) 会按名字复用或创建一个空间,后续命令都挂在该任务下:
ego-browser nodejs <<'EOF'
const task = await useOrCreateTaskSpace('describe your task')
await openOrReuseTab('https://example.com', { wait: true, timeout: 20 })
cliLog(await snapshotText())
await click('button.primary', { label: '点击提交按钮' })
EOF
不同任务之间不共享页面引用。页面跳转、表单提交、切换标签页或动态渲染后,应重新拍快照,参见 Snapshot。
安装与启用
随 ego lite 安装即可使用,参见 快速开始。
如果你已经在用支持 Skills 的 Agent,也可以单独安装 Skill:
npx skills add github:CitroLabs/ego-lite/skills/ego-browser
常见问题
Space 会影响我当前页面吗?
不会。Agent 在 Space 中操作,你的标签页、焦点、鼠标都不受影响。
任务结束后标签页会自动关吗?
不会。Space 保留相关标签页,方便检查访问路径和结果。
什么时候不需要 Space?
只是搜索公开资料、总结公开网页,不需要登录或网页操作时,普通 web search 更合适。