ego-browser — 看得见的 Agent 浏览器

<a href="https://dshfind.com/zh/plugins/Fisfzy/ego-browser"><img src="https://dshfind.com/api/card/Fisfzy/ego-browser?lang=zh" alt="ego-browser card"></a>

仓库：github.com/Fisfzy/dsh-ego-browser｜当前版本 v0.9.4｜版本历史见 CHANGELOG.md｜详情页：dshfind

版本兼容矩阵

依赖	最低版本	推荐版本	说明
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.9.4 已在 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 浏览器。现在有两条安全路径：

1. 扩展桥接（推荐，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 分发，安装一次即可。
2. 安全复制（旧版浏览器 / 已关闭的浏览器）：只复制 Local State + Cookies 数据库到临时目录再用无头浏览器读取；真实 profile 从不被浏览器打开、也不会被写入。Chrome/Edge 127+ 的 ABE 绑定原始路径，复制会读到 0 条 cookie，工具会明确报错并提示改用扩展路径。

cookie 值不出现在任何日志与输出中；导入是单次快照。配合磁盘持久化 Profile，导入的登录态跨重启保留。

…