dsh-ego-browser
精选清单收录维护状态: 活跃omdsh-dev/dsh-ego-browser
DSH(DeepSeek Harness)插件:把 ego-lite 浏览器(给 AI Agent 用的 Chromium)接入 HARNESS——13 个结构化 ego_* 工具(文本语义快照、语义定位点击、表单填充、截图、CDP 控制、任务空间隔离),内置 ego 运行时,Linux + Chrome 开箱即用,无需克隆官方仓库或手动构建。
$ dsh plugin add dsh-ego-browser558
星标
58
Fork
TypeScript
语言
NOASSERTION
许可证
2026-08-07
创建于
2026-11-20
最近推送
README
ego-browser — 看得见的 Agent 浏览器
仓库:
github.com/omdsh-dev/dsh-ego-browser|当前版本 v0.15.1|版本历史见 CHANGELOG.md|详情页:dshfind
右侧边栏实时显示 agent 正在操作的页面;可直接点击 / 滚动 / 输入,或点「弹出窗口」接管。
版本兼容矩阵
| 依赖 | 最低版本 | 推荐版本 | 说明 |
|---|---|---|---|
| DSH (DeepSeek Harness) | 0.1.2-rc.1 |
≥ 0.1.2-rc.1(v0.8.6 起适配 0.1.7 settings;v0.8.8 起支持 0.2.1 原生右侧边栏,截至 0.2.1 验证通过) |
engines.dsh 声明地板;peer 依赖同步锁定 >=0.1.2-rc.1。0.1.0-rc.x / 0.1.1-rc.x 请使用 v0.8.0 及更早版本 |
| dsh-better-sidebar | 0.12.2(可选) |
≥ 0.17.1 |
官方右侧边栏不可用时的可选侧栏回退(v0.9.3 起不再回退浮动球);< 0.12.2 可运行但外部链接拦截(urlTarget)静默降级 |
| dsh-TUI(可选) | — | 提供 tuiSettingsSections / tuiStatus / tuiToast / tuiPanels 的版本 |
按服务能力启用设置页、底栏状态、通知、纯文字侧栏面板;缺席时静默跳过,无额外 I/O |
| Node.js | 22 |
— | harness 环境自带 |
DSH 全版本适配说明:v0.15.1 已在 DSH 0.1.2-rc.1 至 0.1.7(含 0.2.0-rc.x / 0.2.1-rc.2 桌面端的 0.1.7 settings 路径 + 原生右侧边栏)上验证;核心 API(defineTool、ctx.tools.register、ctx.subprocess.spawn、ctx.webServer.register、ctx.inject、ModuleLoader CJS factory、cordis.patch.yml)在 v0.1.0-rc.7 → v0.2.1 无破坏性变更。0.1.2-alpha.x 系列按声明可装但未实测。
dsh-better-sidebar 适配说明:ego-browser 通过 ctx.betterSidebar 服务(try-catch 防御性获取)注册侧边栏 Tab 并监听外部链接。关键 API 引入版本:
| API | ego-browser 用法 | better-sidebar 引入版本 |
|---|---|---|
registerTab() / openTab() / ctx.betterSidebar |
Tab 注册 + 打开 | v0.9.0+ |
TabDescriptor.single |
单实例 Tab | v0.9.0+ |
TabDescriptor.urlTarget |
外部链接拦截 | v0.12.2+(低于此版本链接拦截静默失效) |
DSH 版本支持详情:v0.8.2 → v0.8.3 主要变更:合并 6 个社区 PR(root/xvfb/macOS headless 适配、rc.1 兼容、Windows 稳定性),修复无认证 /api/ego/* 路由安全漏洞、无 dsh-better-sidebar 宿主 client 启动失败(#29)、Windows 冷启动回归(#22 引入的 Xvfb 误判),并修复 gateway 设置白名单缺 egoCliArgs/chromeArgs。适配点:client 运行时改名(@deepseek-ai/dsh-client-store)、client 模块注册 id 与装载行名按声明包名、dsh.client.inject 仅声明真实模块图行、webServer 以嵌套注入交付(可选服务),并同步侧边栏 Tab(dsh-better-sidebar)模式。
侧边栏支持:v0.8.8 起优先注册进 DSH 原生右侧边栏(@deepseek-ai/dsh-client-ui-sidebar-right,DSH ≥ 0.2.1 桌面端自带)——「Agent 浏览器」出现在侧边栏「+」的新标签页列表里(带自绘图标),点击打开并随侧边栏抽屉固定展示;agent 首次调用 ego_* 工具时自动打开该 Tab(按调用会话作用域,多会话不会弹错位置)。宿主没有原生右侧边栏时,回退到 dsh-better-sidebar(推荐 ≥ v0.12.2)的原生 Tab;两者都没有时不显示侧栏面板。两种 Sidebar 形态共用同一套 SSE 实时推流 / 点击 / 输入 / 下载捕获能力。观察窗还提供一个「弹出窗口」按钮:无头(headless)运行的 agent 浏览器可一键替换为同 Profile 的有头窗口(标签页保留),方便手动接管。
登录态导入(v0.8.5 新增;v0.9.4 起 #69 安全重构):工具 ego_login_import 把你日常 Chrome/Edge/Brave 里的登录 cookie 按域名复制进 agent 浏览器。现在有两条安全路径:
- 扩展桥接(推荐,Chrome 保持打开,支持 Chrome 127+ ABE):在 Agent 浏览器面板点 「连接 Chrome 登录态」 → 面板显示 6 位配对码;在 Chrome 的
chrome://extensions开启开发者模式 → Load unpacked 选择插件目录下的extension/,打开扩展弹窗输入配对码并点 Pair。之后每次只需在面板点 「复用 Chrome 登录态」——扩展在后台轮询本地桥接(30 秒内)并自动导出当前网站 cookie,不需要再打开 Chrome UI、不需要手动点 Export,也不需要复制 token。Agent 侧仍可调用ego_login_import(source: "extension",带domains),行为相同。全程不复制 profile、不关闭浏览器、不做离线解密。扩展随 npm 包(extension/)与 GitHub Release 的extension.zip分发,安装一次即可。 - 安全复制(旧版浏览器 / 已关闭的浏览器):只复制
Local State+ Cookies 数据库到临时目录再用无头浏览器读取;真实 profile 从不被浏览器打开、也不会被写入。Chrome/Edge 127+ 的 ABE 绑定原始路径,复制会读到 0 条 cookie,工具会明确报错并提示改用扩展路径。
cookie 值不出现在任何日志与输出中;导入是单次快照。配合磁盘持久化 Profile,导入的登录态跨重启保留。
⚠️ Windows + Chrome/Edge ≥127 的 profile 复制路径会被拒绝(ABE 导致 0 cookies,旧 junction 真实 profile 启动路径已在 0.9.4 删除)。请使用上面的扩展桥接;
EGO_LINUX_LOGIN_IMPORT_FORCE=1仅作为老版本浏览器的调试开关。
常驻执行器(v0.8.8,可选,默认关闭):设置页「常驻执行进程」开启后,ego_* 调用复用同一个 ego-browser --serve 进程——首次调用支付启动开销,之后每次 ~1–2 ms(一次性 spawn 基准 ~340 ms)。浏览器被空闲回收或崩溃后,下一次调用自动回退到一次性 spawn 并重新拉起浏览器(带启动重试),随后恢复常驻;已经写出的请求不会重试,避免重复点击/填表。空闲停止时间可配(默认 30 分钟)。
把 CitroLabs/ego-lite(给 AI Agent 用的 Chromium)接入 DeepSeek Harness:以 35 个结构化 ego_* 工具驱动浏览器,并配一套实时观察前端口——agent 后台操作网页时,你能像看直播一样看到它正在浏览的每个页面,还能直接操作它。
一点私藏的独特之处(self-observation):agent 用的就是这一个 Chromium——连它操作 DSH 自身(管理会话、任务看板、调设置)时,观察窗也实时显示、你能随时接手。不只是"看得见 agent 在网页上干活",连 agent 操作 DSH 界面本身都是全程可见、可掌控的。
开箱即用:插件包内置 ego 运行时(runtime/,MIT,见 THIRD_PARTY_NOTICES.md)——无需克隆官方仓库、无需手动构建,--no-sandbox wrapper 随包自带,root / Docker / 无显示器一键跑。
🚀 快速启动
# 安装(任选一种;桌面端也可以走 插件 → 添加插件)
dsh plugin --profile desktop add dsh-ego-browser@0.15.1
- 在 DSH 会话里说一句让 agent 用浏览器的话,例如:
打开 https://example.com ,截图并告诉我页面标题
- agent 第一次调用
ego_*时,右侧边栏的「Agent 浏览器」标签会自动出现(没有原生侧边栏时回退到dsh-better-sidebar;两者都没有时不显示侧栏面板),实时显示它正在操作的页面。 - 想接手时,直接在观察窗里点击 / 输入 / 滚动;需要完整浏览器窗口就点面板上的「弹出窗口」。
更多「Agent、自动化与工作流」插件
dsh-agent-teams
作者 nanmicoder
DeepSeek Harness 的 Agent Teams 多智能体协作插件,支持多个 AI Agent 组成团队,协同完成复杂任务,实现任务分配、并行执行、成员通信与团队协作。 AgentTeams plugin for DeepSeek Harness
dsh-blender-plugin
作者 sixtysevenlf
DSH × Blender 直连插件 v3.0.6:15 个模型工具让 AI 驱动 GUI Blender(视口 / 自定义视角 / 无头 worker / 作业层 / 事务回滚 / 配方库),34 family / 228 op 契约层;npm 安装 + addon zip,GUI 优先、无头备用;dsh-TUI 选中 chip / @ 提及 / /blender,随包建模 skill,支持 WSL / Windows / macOS。
dsh-free-search
作者 dddmuc
为DeepSeek Harness提供的免费网络搜索服务商:即使没有API密钥也可使用。Free web search provider for DeepSeek Harness:usable even without an API key.
dsh-bili-scroll
作者 c1overzz
DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你
