返回目录

dsh-ego-browser

编辑精选维护状态: 活跃

fisfzy/dsh-ego-browser

DSH(DeepSeek Harness)插件:把 ego-lite 浏览器(给 AI Agent 用的 Chromium)接入 HARNESS——13 个结构化 ego_* 工具(文本语义快照、语义定位点击、表单填充、截图、CDP 控制、任务空间隔离),内置 ego 运行时,Linux + Chrome 开箱即用,无需克隆官方仓库或手动构建。

前往 GitHub
$ dsh plugin add dsh-ego-browser

208

星标

37

Fork

JavaScript

语言

NOASSERTION

许可证

2026-08-07

创建于

2026-09-28

最近推送

DeepSeek Harness 插件:给 agent 一只能被看见、可随时接管的真浏览器——32 个 ego_* 工具、实时观察窗,跨平台开箱即用。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-30

许可证

作者未说明

01它能帮你完成什么?

  • 让 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 的运维与开发者

02如何接入 DeepSeek Harness?

前置条件

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

安装步骤

  1. 01

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

  2. 02

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

验证接入成功

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

03DSH 适配与能力边界

DSH 适配原生运行时

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 自身界面实时可见、可随时接手

04适合谁?何时不该用?

适合

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

不适合

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

05兼容性、维护与安全提示

  • 底层 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)

06常见问题

如何在 DeepSeek Harness 中安装 ego-browser?

执行 `dshx install ego-browser <ego-browser.tgz>`(tarball 或 git URL 均可),再运行 `dshx list`,应显示 `[on] ego-browser`。无需宿主侧任何配置,插件会自动探测 root / 无显示器并兜底。

前置条件是什么?

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

它如何与 DeepSeek Harness 连接?

它是 dshx 装载的原生 DSH 插件。每个工具把参数拼成 JS 脚本,经 `ego-browser nodejs` 喂给 stdin 执行,宿主通过 CDP 驱动共享 Chromium,结果以 `@@DSH_RESULT@@` 哨兵行解析。适配 DeepSeek Harness ≥ 0.1.2-alpha.1。

它和只做 3 个工具的同类插件有何不同?

同类插件只用 3 个工具(run/help/status)把浏览器留在后台黑盒里。ego-browser 打开黑盒:32 个职责单一的 ego_* 工具、带实时观察窗(CDP JPEG / FFmpeg H.264 双后端 + 标签条 + 历史抽屉)并支持监控窗鼠标直操,外加 worker 单实例守卫与崩溃自愈。

观察窗不显示 / 无法接管,怎么排查?

观察窗需要带图形界面的 DSH Web;无头会话仍可用 ego_* 工具但无观察窗。macOS 首次使用需「屏幕录制」权限;X11 需 Chromium 与 FFmpeg 共享 DISPLAY;Wayland 缺少 Portal/PipeWire 输入时会提示切回 CDP。登录态按任务空间隔离,强杀重启后需重新登录(扫码很快)。

08数据与来源

  • 作者声明github.coma766f4f2bb97…

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

  • 作者声明github.coma766f4f2bb97…

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

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-30。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

广告

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。