Skip to content

Releases

v0.14.2 — spaces 快返回 + ego_scroll 正确性

Choose a tag to compare

@Fisfzy Fisfzy released this 20 Nov 08:09

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.2

v0.14.1 — 侧栏 watch fallback

Choose a tag to compare

@Fisfzy Fisfzy released this 16 Nov 14:48

0.14.1 — 观察窗 watch fallback

修复

  • 侧栏地址栏导航后停在 idle / 未接管:Remote egoBrowser/watch 未返回时增加 2 秒超时,并回退到 /api/ego/watch-fallback host 代理;该路径只做一次租约切换,不是轮询。
  • 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.1

GitHub 附件为 Chrome 登录导入扩展 zip。

v0.13.0 — CUA 启发:ego_verify / 快照代次 / 轨迹回放 / 幽灵光标

Choose a tag to compare

@Fisfzy Fisfzy released this 15 Nov 09:30

安装: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:读取 trajectory JSONL,按顺序通过同一套 ego_* 脚本构建器重新执行;返回逐步骤 ok/error,失败即停(可配置 stopOnError:false)。脱敏的 ego_fill / ego_key 文本跳过,不把 <redacted> 当真实输入;回放时忽略旧的 snapshotId,由回放过程重新观察。
  • 观察窗幽灵光标(P2-6):host 在 ego_click / ego_hover 后广播 SSE cursor 事件,前端在实时画面上叠加带渐隐动画的光标/点击波纹;不改变页面 DOM,也不影响截图。

测试

  • 全量:453 passed / 8 skipped;typecheck/build 通过。
  • ego_replay 与幽灵光标需重启 DSH 后真实浏览器验证。

v0.9.15 — Windows 焦点 / 观察窗 / 弹窗与标签修复

Choose a tag to compare

@Fisfzy Fisfzy released this 14 Nov 14:00

安装: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 修复

Choose a tag to compare

@Fisfzy Fisfzy released this 10 Nov 03:47

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,并支持 PATH command -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 重做

Choose a tag to compare

@Fisfzy Fisfzy released this 09 Nov 12:04

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)

Choose a tag to compare

@Fisfzy Fisfzy released this 09 Nov 04:52

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 诊断

Choose a tag to compare

@Fisfzy Fisfzy released this 07 Nov 10:20

安装: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 运行时路径

Choose a tag to compare

@Fisfzy Fisfzy released this 06 Nov 05:40

安装: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 修复

Choose a tag to compare

@Fisfzy Fisfzy released this 03 Nov 16:07

安装: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 通过。