Repository navigation
Releases
v0.14.2 — spaces 快返回 + ego_scroll 正确性
0.14.2 — spaces 快返回 + ego_scroll 正确性
修复
- 无浏览器时
/api/ego/spaces不再拉起 worker(#107/#108):没有 live worker/browser 时直接返回空列表,避免未开 agent 浏览器时反复 spawn worker。 ensureWorker()不再死等(#108):worker 启动后立即退出时,等待循环立即中止,不再等满 8 秒。ego_scroll返回稳定后的偏移(#109/#110):增加before/after/moved/settled/atEnd/deltaX/deltaY,scrollX/scrollY保持最终位置语义。
说明
atEnd当前表示“本次没有移动”,不区分顶部/底部;后续可改进为atBoundary或atStart。- 未包含 #111 精简工具模式、#95/#87 官方 ego lite 支持改进,这些仍在后续版本处理。
测试
- 480 passed / 8 skipped;typecheck / build 通过。
安装
npm install dsh-ego-browser@0.14.2v0.14.1 — 侧栏 watch fallback
0.14.1 — 观察窗 watch fallback
修复
- 侧栏地址栏导航后停在
idle / 未接管:RemoteegoBrowser/watch未返回时增加 2 秒超时,并回退到/api/ego/watch-fallbackhost 代理;该路径只做一次租约切换,不是轮询。 - Remote 调用不再无限等待:
egoRpc统一加超时,避免状态/watch 调用悬挂时侧栏不打开 SSE、不建立 capture。
包含的 0.14.0 功能
- 标签栏最右侧
+新建独立 Chrome 窗口 - 常驻地址栏、前进/后退/刷新
- watch lease 由 SSE 连接在 worker 内续期,不再 5 秒轮询
- 继承 0.13.2 的 lazy Remote peer、relay 恢复和配对过期修复
测试
- 471 passed / 8 skipped;typecheck / build 通过。
安装
npm install dsh-ego-browser@0.14.1GitHub 附件为 Chrome 登录导入扩展 zip。
v0.13.0 — CUA 启发:ego_verify / 快照代次 / 轨迹回放 / 幽灵光标
安装:dsh plugin --profile desktop add dsh-ego-browser@0.13.0
配套 Chrome 扩展:dsh-ego-browser-extension-0.13.0.zip(chrome://extensions → 开发者模式 → Load unpacked)。
[0.13.0] - 2026-11-15 — 回放与观察窗幽灵光标
新增
ego_replay:读取trajectoryJSONL,按顺序通过同一套 ego_* 脚本构建器重新执行;返回逐步骤 ok/error,失败即停(可配置stopOnError:false)。脱敏的ego_fill/ego_key文本跳过,不把<redacted>当真实输入;回放时忽略旧的snapshotId,由回放过程重新观察。- 观察窗幽灵光标(P2-6):host 在
ego_click/ego_hover后广播 SSEcursor事件,前端在实时画面上叠加带渐隐动画的光标/点击波纹;不改变页面 DOM,也不影响截图。
测试
- 全量:453 passed / 8 skipped;typecheck/build 通过。
ego_replay与幽灵光标需重启 DSH 后真实浏览器验证。
v0.9.15 — Windows 焦点 / 观察窗 / 弹窗与标签修复
安装:dsh plugin --profile desktop add dsh-ego-browser@0.9.15
配套 Chrome 扩展:dsh-ego-browser-extension-0.9.15.zip(chrome://extensions → 开发者模式 → Load unpacked)。
[0.9.15] - 2026-11-14 — Windows 焦点 / 观察窗 / 弹窗与标签修复(#99–#104)
修复
- #99 Windows 有头模式不再隐式置顶:transport 拦截模型侧
Target.activateTarget/Page.bringToFront,保留 active 记账;Target.createTarget使用background:true,并按 session 补Emulation.setFocusEmulationEnabled保证后台页仍能渲染/截图。ego-browser --open仍保留用户主动抬窗。 - #100 反向代理子路径:观察窗的
/api/ego/*、/ego/api/*与 SSE 全部按<base href>计算部署前缀,不再请求代理根路径。 - #101 移动端实时画面比例:去掉
max-height:50vh,body/liveview/stage 改为 flex 填满,图片object-fit:contain等比铺满可用区域。 - #102 截图交付卡:
ego_screenshot的deliver改为显式 opt-in(默认false),避免手机/无桌面宿主生成空白交付卡。 - #103 观察窗 about:blank:新建 space 不再激活空白 anchor;持久 Profile 下若已有真实页面,新 space 的 tab 以该 URL 起步(仍独立),worker 的
activeTargetId()也优先真实页而不是/json/list[0]。 - #104 原生弹窗与 target=_blank:
Page.javascriptDialogOpening立即默认 dismiss,避免 renderer 卡死;listTabs()的 fallback 接受 opener 所属页面。
测试
- 新增
tests/issue-99-104-regressions.test.ts,覆盖这 6 个修复的关键路径。 - 全量:439 passed / 8 skipped;typecheck/build 通过。
v0.9.14 — 内联截图 / 触摸操作 / 安全与 Android proot 修复
dsh-ego-browser v0.9.14
安装 / 升级:
npm install dsh-ego-browser@0.9.14
# 或
dsh plugin add dsh-ego-browser@0.9.14新增
ego_screenshot默认内联图片:截图同时返回{ path, attachment }并渲染为 image block,模型当轮看到画面,不再需要额外read_image。无附件服务/保存失败时自动退回“仅路径”;inline:false可只保留路径。ego_click新增touch/holdMs:touch:true发送 touchStart/touchEnd,适配 4399 等 touch-first H5 游戏;holdMs在同一坐标按下→等待→抬起(0–5000ms);- 两种模式都不发 move,不会拖动页面或滚动;默认鼠标路径完全不变,拖拽仍只属于
ego_drag。
- Canvas / iframe 边界文档:Canvas/WebGL 内容必须用
ego_screenshot;跨域 iframe 用 snapshot 的ref交互,CSS selector 不跨帧。
修复
- 安全:snapshot 不再回显密码框明文:
input[type=password]输出value=••••••,避免浏览器自动填充把密码写进语义树、模型上下文和会话日志。 - 人机协作规则:登录/人机验证/支付/年龄确认时,先说明需要用户操作并用
ego_wait_for_human等待;不猜密码、不绕过访问控制。 - #98 Android proot 适配:
- 启动时自愈
bin/ego-chrome-wrapper.sh的执行位(npm/tar 解压可能掉为 600); - wrapper 优先使用插件解析的
EGO_LINUX_CHROME_BIN,并支持 PATHcommand -v(覆盖/usr/local/bin/chromium等自定义安装); ego_doctor输出 wrapper 路径、执行位与最终浏览器,避免 CLI 与 wrapper 探测不一致。
- 启动时自愈
- 内联截图附件服务改为
ctx.inject(['attachments'])捕获 +ctx.get兜底(首次实机测试发现的 Cordis inject 保护问题)。
测试
- 全量:433 passed / 8 skipped;typecheck 通过。
- 新增
tests/click-script.test.ts(9)、tests/wrapper.test.ts(3)、tests/help-topics.test.ts、tests/snapshot-diff.test.ts、tests/errors.test.ts、tests/rules.test.ts。 scripts/smoke-0.9.13.mjs:真实 vendored runtime + 本地页面,31/31 通过。- 4399 实机验证:touch 点击进入游戏、
holdMs长按方向键移动角色,页面sx/sy保持 0;默认鼠标点击 DOM 按钮无回归。
附件
dsh-ego-browser-0.9.14.tgz:npm 包同款 tarball。dsh-ego-browser-extension-0.9.14.zip:Chrome/Edge 登录态桥接扩展。
完整变更:见仓库 CHANGELOG.md 的 [0.9.14] 段。
v0.9.13 — 浏览器操作能力增强 & 观察窗 UI 重做
dsh-ego-browser v0.9.13
安装 / 升级:
npm install dsh-ego-browser@0.9.13
# 或
dsh plugin add dsh-ego-browser@0.9.13浏览器操作能力增强(借鉴 ZCode browser-use / computer-use 的公开设计)
- 原生操作规则提示(不引入 skill):首次调用
ego_*后注入 8 条防错规则(先观察、一次动作一次观察、不猜 selector、截图纪律、页面内容不可信等);rulesPrompt可关闭。 - 结构化失败契约:动作用具失败返回
{ code, actionSent, retry, hint },区分LOCATOR_NOT_FOUND / TIMEOUT / USER_CONTROLLING / BROWSER_DOWN / CAPTCHA等,并给出下一步动作。 ego_navigate新增reuse:origin(默认,同源已开页就地导航)/exact/none,避免同站导航顶掉无关页面。ego_snapshot({ diff: true }):只返回新增/移除/变化行,首次返回完整树作基线;diff 不含可操作 ref。ego_tabs返回任务空间归属(ownership/recentTabTitles),避免误关/接管用户空间。ego_screenshot新增fullPage与clip。ego_cli/ego_script失败统一为结构化值。ego_help文档注册表:inline/lookup分层、平台门控,新增discipline/errors/screenshots/gui-test。ego_status新增rulesSummary与rulesPrompt注册诊断。
观察窗 UI 重做
- 实时观察面板改用 DSH 宿主主题 token(颜色/圆角/间距随主题切换),不再硬编码皮肤。
- 新增
assets/icon*.png,package.json#icon与files收录;包描述更新为中文能力概览。
测试
- 单元/集成:420 passed / 7 skipped,typecheck 通过。
- 新增
scripts/smoke-0.9.13.mjs:真实 vendored runtime + 本地页面的端到端 smoke,31/31 通过(规则段、导航复用、diff、截图参数、tabs 归属、失败契约、8 轮稳定性)。
附件
dsh-ego-browser-0.9.13.tgz:npm 包同款 tarball。dsh-ego-browser-extension-0.9.13.zip:Chrome/Edge 登录态桥接扩展(解压后在chrome://extensions加载已解压的扩展程序)。
完整变更:见仓库 CHANGELOG.md 的 [0.9.13] 段。
v0.9.12 — macOS Cookie 落盘修复开关(#93)
v0.9.12 — macOS Cookie 落盘修复开关(#93 收尾)
macOS 26/27 + Chrome 156 上「任务空间登录态重启后丢失」的成因已由社区真机确认为 Chrome 登录 Keychain 层不落盘:ego_auth_flush 返回非零 {total, flushed},但 Default/Cookies 仍是 0 行。用 --use-mock-keychain 让 Chrome 改用 mock/test Keychain 后 cookie 恢复正常落盘(重启后探针 cookie 仍在)。
新增
- 「macOS Cookie 落盘修复」设置(
useMockKeychain,默认关闭):把 0.9.11 的诊断开关升级为正式 opt-in 选项。开启后插件在 macOS 上向运行时注入EGO_LINUX_USE_MOCK_KEYCHAIN=1,Chrome 以--use-mock-keychain启动。- 仅 macOS 生效;Windows/Linux 不注入;
- 用户显式设置的同名环境变量仍然优先;
- 只影响 Chrome 启动参数,需浏览器冷启动(
ego-browser --stop或重启 DSH); - 会降低 cookie 的静态加密强度,因此默认关闭。
- 设置页(Web 设置卡片 + TUI settings section / manifest)新增该布尔项与中英文文案。
ego_doctor输出useMockKeychain状态;macOS 未开启时给出提示。
文档
- README 的 macOS Cookie 章节改写为:已确认成因、修复开关、落盘是延迟的(约 60 秒后才出现在
Default/Cookies,flush 后立刻查询会误判为 0 行)、mock Keychain 的安全权衡,以及chromeArgs/EGO_LINUX_USE_MOCK_KEYCHAIN的等价做法与官方 ego lite 线的差异。
测试
useMockKeychain默认值 / 真值解析(config)- macOS 注入、关闭不注入、Windows/Linux 不注入、用户环境变量优先(env)
/ego/api/set白名单持久化(gateway)+ manifest/TUI 字段同步
全量:371 passed / 7 skipped,typecheck 与 build 通过。
安装
dsh plugin --profile <profile> add dsh-ego-browser@0.9.12或升级现有安装。macOS 用户若遇到登录态丢失:设置 → 插件 → ego-browser → macOS Cookie 落盘修复 → 开启 → 冷启动浏览器 → 等约 60 秒后核对 Default/Cookies 行数。
完整对比见 CHANGELOG.md。
v0.9.11 — cast worker 状态路径修复 / macOS Cookie 诊断
安装:dsh plugin --profile desktop add dsh-ego-browser@0.9.11
配套 Chrome 扩展:dsh-ego-browser-extension-0.9.11.zip(chrome://extensions → 开发者模式 → Load unpacked)。
[0.9.11] - 2026-11-06 — cast worker 状态路径修复 / macOS Cookie 诊断
诊断
- macOS 27 + Chrome 156 cookie 不落盘(#93 后续):新增
EGO_LINUX_USE_MOCK_KEYCHAIN=1(或chromeArgs: "--use-mock-keychain")对照开关:macOS 上让 Chrome 使用 mock/test Keychain,用于判断实时 cookie jar 非空但Default/Cookies不变是否由登录 Keychain 引起。默认关闭,开启会降低静态加密强度,只建议诊断使用。 - README 增加 macOS Cookie 落盘排查步骤,并明确 macOS 仍使用
Default/Cookies(不是 Windows 的Default/Network/Cookies)。
修复
- 自定义
EGO_LINUX_STATE_DIR下 cast worker 无限重启(#97):worker 把ego-cast.json直接写在$EGO_LINUX_STATE_DIR,而插件castStatePath()又拼了一层ego-lite-linux,导致永远找不到 worker → 每 8 秒重新 spawn,旧 worker 不退出、内存持续增长。现在两边统一为<EGO_LINUX_STATE_DIR>/ego-cast.json;ensureWorker()增加单次 in-flight 保护与 8s→16s→…→60s 指数退避,避免重复 spawn。
测试
- 新增
tests/worker-state.test.ts:自定义 state dir 路径、读取 ego-cast.json。 - 全量:364 passed / 7 skipped;typecheck/build 通过。
v0.9.10 — 标签页/脚本 space / 面板刷新与最大化 / macOS 运行时路径
安装:dsh plugin --profile desktop add dsh-ego-browser@0.9.10
配套 Chrome 扩展:dsh-ego-browser-extension-0.9.10.zip(chrome://extensions → 开发者模式 → Load unpacked)。
[0.9.10] - 2026-11-06 — 标签页选择 / 脚本 space / 面板刷新与最大化
修复
ensureRealTab选中chrome://newtab(#92):没有 active 标签时,旧兜底把__tabs[0](常驻 newtab)当成真实页,ego_script的page句柄指向空白页。现在统一识别about:/chrome:/chrome-extension:/edge:/devtools:/data:,优先「active 且非空白」→ 非空白 → active → 第一个标签;显式 pin 仍优先。ego_script/ego_cli没有 space(#92):两个脚本工具现在接受space参数,脚本前置taskSpaces.useOrCreate(space),并使用同一个 space 记录 targetId pin,和结构化工具的 target 保持一致。- Windows 最小化后每次调用弹窗(#96):
ensureRealTab不再对已经 active 的标签调用browser.switchTab(Target.activateTarget会恢复最小化窗口);只有 pinned/后台目标才切换。 - 截图包含 agent 光标(#96):新增
ego_screenshot({ hideCursor }),默认true:截图前临时ego.hideCursor(),完成后ego.showCursor();浏览器窗口仍显示光标,PNG 不再截到它。 - macOS 运行时仍只认 Linux PATH(#95):
runtime/ego-linux/src/chrome.mjs的resolveBinary()在which失败后增加平台安装路径兜底——macOS/Applications与~/Applications下的 Chrome/Chromium/Edge/Brave/Tungsten Edge.app,Windows Program Files/LocalAppData;PATH 仍优先。README 增加 macOS 官方 ego lite 桥接说明。 ego_auth_flush报告真实 cookie 数量(#93 诊断):worker/api/flush现在先Storage.getCookies统计 jar,再Storage.flushCookies,返回{total, flushed};不再固定total:0。macOS 持久化是否落盘仍需报告者按 issue 步骤复测。
新增
- 面板刷新 / 手动网址 / 最大化(#94):工具栏新增「刷新」「网址」按钮,以及尺寸预设右侧的「最大化」按钮;新增
/api/ego/navigate主机路由和 worker 的Page.reload/Page.navigate;/api/ego/window-size支持maximize(Browser.setWindowBounds({windowState:'maximized'}))。
测试
- 扩充
tests/tab-and-viewport.test.ts:模拟 tab 列表验证空白 active、已 active 不切换、显式 pin;验证脚本 space 前置。 - 新增
tests/panel-actions.test.ts:刷新/网址/最大化路由与 UI 接线、焦点回归、截图隐藏光标。 - 全量:361 passed / 7 skipped;typecheck/build 通过。
v0.9.9 — 登录参数归一化 / 僵尸 X display 修复
安装:dsh plugin --profile desktop add dsh-ego-browser@0.9.9
配套 Chrome 扩展:dsh-ego-browser-extension-0.9.9.zip(chrome://extensions → 开发者模式 → Load unpacked)。
[0.9.9] - 2026-11-03 — 登录参数归一化 / X display 存活判断
修复
ego_login_import(source="extension")恒 0 条(#90):DSH 宿主会把type: "json"参数以 JSON 字符串交给execute,旧代码的Array.isArray(args.domains)因此恒为 false,domains变成空数组,扩展静默读到 0 条。新增parseJsonArg()/asStringArray()/asArrayArg()统一归一化 JSON 字符串、数组和逗号分隔值;domains、ego_select.value、ego_drag.points、ego_cdp.params、ego_http.headers都走归一化。- 扩展 domains 语义:省略/空 domains 现在按文档读取全部 cookie(
chrome.cookies.getAll({})),不再静默导出 0 条;结果带warning,面板卡片也会展示。 - 僵尸 X display(#91):
displayUsable()现在同时检查/tmp/.X11-unix/X<n>与.X<n>-lock中的 pid 是否存活;pickFreeDisplayNumber()只把 live display 算作占用。死 Xvfb 不再触发一次 20s 冷启动失败,也不会让 display 号每次重启漂移。
测试
- 新增
tests/json-args.test.ts:JSON/数组/逗号分隔归一化、domains/select/points/CDP 接线、空 domains 全量读取、0 条 warning。 - 新增
tests/display-usable.test.ts:死/活 lock pid、无 socket、无 lock、僵尸 display 复用、live display 跳过。 tests/login-extension.test.ts增加“扩展返回 0 条时 warning”用例。- 全量:350 passed / 7 skipped;typecheck/build 通过。