Back to directory

dsh-ego-browser

Curated pickMaintenance: Active

fisfzy/dsh-ego-browser

把 ego-lite 浏览器(给 AI Agent 用的 Chromium)接入 HARNESS,提供浏览器会话能力。

View on GitHub
$ dsh plugin add dsh-ego-browser

208

stars

37

forks

JavaScript

Language

NOASSERTION

License

2026-08-07

Created

2026-09-28

Last push

A DeepSeek Harness plugin that gives your agent a real, observable Chromium: 32 ego_* tools, a live view-and-take-over observation window, and a zero-config cross-platform runtime.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-30

License

Not specified by the author

01What can it help you accomplish?

  • 让 AI Agent 在已登录的真浏览器里完成登录态、验证码、动态渲染、表单等人机交互任务

    通过 32 个结构化 ego_* 工具驱动 Chromium,并提供实时观察前端口(SSE 推流 + 标签条 + 历史抽屉)

    在 DeepSeek Harness 中需要真浏览器自动化能力的开发者与 Agent 编排者

  • 实时观察并直接接管 Agent 正在操作的浏览器,遇到问题(验证码 / 走岔)立刻介入

    右下角常驻观察球 / 侧边栏原生 Tab,支持点击 / 拖拽 / 缩放直接驱动真实浏览器,并可回看历史轨迹

    希望在后台自动化中保持可见可控、需要人工接管的用户

  • 跨平台(Linux / macOS / Windows)零配置开箱即用,把 ego-lite 运行时与浏览器能力带进 DSH

    内置 ego 运行时(MIT),自动探测 Chrome / Edge / Brave + 自带 --no-sandbox wrapper,root / Docker / 无显示器一键跑

    在 Linux / WSL / 容器等无 GUI 环境部署 DSH 的运维与开发者

02How to install into DeepSeek Harness

Prerequisites

  • Node ≥ 22(harness 环境自带)
  • 任意 Chrome / Chromium / Brave / Edge(自动发现,或用 EGO_LINUX_CHROME 指定)
  • DSH + dshx(插件装载机制)
  • 带图形界面的 DSH Web(仅观察窗需要;headless 会话仍可使用全部 ego_* 工具)

Installation steps

  1. 01

    dshx install ego-browser <ego-browser.tgz> # tarball 或 git URL 均可

  2. 02

    dshx list # 应显示:[on] ego-browser

Verify the integration

  • 运行 `dshx list`,输出应显示:[on] ego-browser

03DSH integration and capability boundaries

DSH integrationNative runtime

Loaded as a dshx plugin into the DeepSeek Harness runtime; exposes 32 structured ego_* tools and a live-observation front end that drives a shared Chromium via CDP.

  • 32 个结构化 ego_* 工具

    agent 任务参数(导航 / 交互 / 执行 / 输出 / 会话与安全)→页面语义快照、截图、下载、CDP 控制等,结果以 @@DSH_RESULT@@ 哨兵行解析

  • 实时观察窗(看直播 + 直接接管)

    agent 后台浏览器操作→右下角观察球或侧边栏原生 Tab,SSE 推流 + 标签条 + 历史抽屉 + 监控窗鼠标直操

  • 内置 ego 运行时 + 跨平台自适应

    DSH 宿主环境→自动探测 Chrome / Edge / Brave,自带 --no-sandbox wrapper,root / Docker / 无显示器免配置

  • self-observation(观察 agent 操作 DSH 界面)

    agent 对 DSH 的管理会话 / 任务看板 / 设置操作→DSH 自身界面实时可见、可随时接手

04Who is it for? When not to use it?

Good for

  • 在 DeepSeek Harness 中需要真浏览器自动化能力的开发者与 Agent 编排者
  • 希望在后台自动化中保持可见可控、需要人工接管的用户
  • 在 Linux / WSL / 容器等无 GUI 环境部署 DSH 的运维与开发者

Not for

  • 底层 ego-lite 宿主仍是非 Windows 官方支持的社区移植,复杂多步流程稳定性可能弱于 macOS。
  • 本仓库的 DSH peer 包不全在公共 npm registry,普通 pnpm install 可能在解析 @deepseek-ai/* peer 时失败,需由 DSH profile 安装提供这些 peer。

05Compatibility, maintenance and safety notes

  • 底层 ego-lite 宿主仍是非 Windows 官方支持的社区移植,复杂多步流程稳定性可能弱于 macOS。
  • 本仓库的 DSH peer 包不全在公共 npm registry,普通 pnpm install 可能在解析 @deepseek-ai/* peer 时失败,需由 DSH profile 安装提供这些 peer。
  • Linux 用 CDP DOMSnapshot 重建语义树,非 macOS 内核级,复杂 iframe / 画布场景可能降级。
2026-08-072026-08-28v0.8.1

MIT(README 声明插件本体为 MIT)· actively maintained(最新发布 v0.8.1,2026-08-28)

06Frequently asked questions

How do I install ego-browser with DeepSeek Harness?

Run `dshx install ego-browser <ego-browser.tgz>` (a tarball or git URL), then `dshx list` — it should show `[on] ego-browser`. No host-side config is needed; the plugin auto-detects root / headless and falls back via `--no-sandbox`.

What are the prerequisites?

Node ≥ 22 (provided by the harness), any Chrome / Chromium / Brave / Edge (auto-discovered, or set via EGO_LINUX_CHROME), and DSH + dshx as the load mechanism. A graphical DSH Web is needed only for the observation window; headless sessions still run all ego_* tools.

How does it connect to DeepSeek Harness?

It is a native DSH plugin loaded by dshx. Each tool serializes a JS script, feeds it through `ego-browser nodejs` over stdin, and the harness drives a shared Chromium via CDP; results are parsed from an `@@DSH_RESULT@@` sentinel line. It targets DeepSeek Harness ≥ 0.1.2-alpha.1.

How is it different from a similar 3-tool ego plugin?

Competing plugins wrap ego-lite with only 3 tools (run/help/status) and leave the browser a black box. ego-browser opens the box: 32 single-responsibility tools, a live observation window (CDP JPEG / FFmpeg H.264 backends, tab strip, history drawer) with direct mouse control, plus a worker single-instance guard and crash self-healing.

The observation window won't show / I can't take over — troubleshooting?

The observation window needs a graphical DSH Web; headless sessions still run ego_* tools but without the view. On macOS the first use requires Screen Recording permission; on X11, Chromium and FFmpeg must share DISPLAY; on Wayland, if Portal/PipeWire input is missing it prompts to switch back to CDP. Login state is isolated per task space and is cleared on a hard restart (re-login is fast).

08Data and sources

  • Author-claimedgithub.coma766f4f2bb97…

    接入 DeepSeek Harness:以 **32 个结构化 `ego_*` 工具**驱动浏览器

  • Author-claimedgithub.coma766f4f2bb97…

    本版本针对 **DeepSeek Harness ≥ `0.1.2-alpha.1`** 适配(2026-08-28)

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-30. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

AD

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.