本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

ego-browser

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-ego-browser

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 看得到：别家是"跑完告诉你结果"的黑盒；我们实时推流，你看着 agent 操作，卡在验证码/走岔立刻发现。
• 控得住：别家只读；我们监控窗直接驱动同一个 agent 浏览器，需要时你亲手接管（缩放/拖拽/点击），不必打断 agent 重来。
• 文献 / 数据抓取：让 agent 登录知网 / 谷歌学术翻页收集，你在观察窗看着它滚动、点下一页、下载 PDF，中途卡住立刻能发现。
• 表单与登录：agent 填表到一半，观察窗弹出验证码——你直接接管把验证码点了，再交还给 agent 继续。
• QA / 冒烟测试：让 agent 在自己产品上点一圈，观察窗等于一台"会说话的录屏"，顺手还能回看历史轨迹。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后我看不到右下角那个浏览器小球怎么办？

观察窗依赖宿主提供 webServer 服务（DSH Web 端默认有）。如果跑在 headless 或非 Web 宿主，ego_* 工具仍能正常工作，只是没有观察窗面板；右上"显示"开关也不会出现浮窗。

工具调用时提示 "CDP channel is not open" 或类似错误怎么办？

通常是 Chrome 首次冷启动时还没就绪。插件已内置 withWarmupRetry，遇到这类瞬态错误会自动重试一次；如果反复出现，请先跑一次 ego_status 确认 ego-browser CLI 可用，必要时用 EGO_LINUX_CHROME 指定 Chrome 路径。

32 个工具和"网页操作"工具之间的区别是什么？

32 个都是同一套浏览器上的细粒度动作（点击、填表、滚动、等待等），不是 32 个独立浏览器；它们共享同一个 Chromium，由插件内互斥锁串行执行，避免争用。

登录态会保留吗？

会保留到对应任务空间内，但 Chrome 只在优雅关闭时把 cookie 落盘，强杀或断电后需要重新登录；想要立即固化可以调一次 ego_auth_flush 或在观察窗登录引导条点"已登录，保存"。

我可以在观察窗里直接点页面抢过 agent 的控制吗？

可以。浮窗支持鼠标点击、拖拽、滚轮、Ctrl+滚轮缩放、Ctrl+拖动平移，点击画面后键盘输入（中文 IME、粘贴、Tab/Enter、方向键、Ctrl/Cmd 快捷键）都直接回传到同一个浏览器。

FFmpeg 后端有什么用？我必须装吗？

不必须。CDP 是默认后端，无额外依赖；FFmpeg 后端在 Windows 上能直接抓 Chrome 窗口的 D3D11 帧，画质与分辨率更好。需要在设置里手动切到 FFmpeg 并通过托管下载拿到带 gfxcapture 的构建。

我能不能在 Linux 服务器无显示器 / root 环境下跑？

可以。resolveEgoEnv 自动探测 root / 无显示器环境并注入 --no-sandbox 包装脚本与 headless 兜底；FFmpeg 后端在 Linux 走 x11grab，Wayland 缺少 Portal/PipeWire 输入时会提示切回 CDP。

工具返回的 schema 看起来很宽松，会漏字段吗？

工具输出 schema 使用 additionalProperties: true，文档明确说明客户端应以实际返回值而非 schema 字段为准；这是为了容纳运行时扩展返回的字段。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8
• Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则