参考 / Reference
更新日志
每个版本改了什么、为什么改——这一页是完整的版本历史, 按次版本号分组、新到旧排列。chrome-use 自己的功能开发都在 v1.x 系列;再往前, 还有重塑品牌前的 fork 阶段,以及定期从上游 agent-browser 合并进来的版本号。
ℹ️ 逐条 commit diff:GitHub Releases
这一页按版本汇总了每次改动的要点。想看某个版本的完整 diff,去
GitHub Releases。
v1.5.x
- v1.5.75(2026-07-10)— 修复扩展 relay 自动连接在新会话中重复创建两个
about:blank标签页。连接现在复用目标发现阶段创建的 session-owned scratch tab,仅在页面数为零时创建兜底页;纯读取、状态查询或导航前失败不再留下成对空白页。 - v1.5.74(2026-07-08)— 技能分发 v2:新增
chrome-use skill install统一入口,委托 skills.sh(npx skills add … -g)跨 20+ runner 装技能,自己绝不写 runner 目录;curl … | sh装完二进制顺带装技能,并以doctor自检 + 一条可直接粘贴给 agent 的首条 prompt 收尾;doctor新增只读探测「agent 技能是否已装」(warn 不 fail);stub 路由表从 5 个场景补齐到 11 个(canvas/network/react/real-chrome/sessions/test 等按症状路由)。另修:skills/chrome-use/SKILL.md的description是含:的非法 YAML,导致npx skills add误装成core/test等而非chrome-use——改为折叠块标量修复。 - v1.5.73(2026-07-07)— 四个 issue 修复:
extract --schema对普通重复列表不再静默返回[](自动探测重复容器 + 未命中给诊断 + 接受数组 schema,#96);site适配器运行前注入家族_helper(twitter/* 等不再ReferenceError,#99);console --limit N只看最近 N 条(#110);skill 真分层(<!-- full -->标记,默认精简、--full全量)+ 去重 +session handoff同步进 sessions skill(#100)。 - v1.5.72(2026-07-07)— 原生命令扛 shadow-DOM 重站:
select/fill现在能处理 react-select、模块作用域内的 Monaco、@ref 落在包裹元素的受控输入(#105);对 Element-Plus 弹窗更利落——snapshot -i给顶层 modal/drawer 内控件加modal标记、选择器未命中给最接近文本匹配提示、新增diagnose排查空白 SPA(#90)。curl … | sh一条命令装扩展并处理调试横幅(装机时征得同意 → 运行时自动静默)。skill 引导 agent 优先用read/click/fill等命令而非手搓eval。 - v1.5.71(2026-07-07)— 文档:新增「它怎么工作」(含 SVG 架构图)、「血统与上游」、「单次成型脚本」三章,并对整站文档做了一轮审计修订。无功能改动。
- v1.5.70(2026-07-07)—
chrome-use script单次成型脚本(#101):JSON op-list(值总线 + 循环 + 断言)与同步 JS(cu.*助手)两种写法,守护进程内 boa 引擎扛硬跳转,一次 tool call 跑完多步。另:connect 检测企业策略拦截扩展并引导逃生口;后台自动更新(CHROME_USE_AUTO_UPGRADE=1);一键 Web Store 安装。 - v1.5.69(2026-07-07)—
snapshot -i合并 presentation-role / AX-stripped 跨域 iframe(reCAPTCHA 这类,#92);snapshot/eval 先 resync 防漂到 about:blank(#93);未命名交互控件按 placeholder / 邻近 label 命名(#90.2);screenshot resync 抓活动标签(#91)。 - v1.5.68(2026-07-02)— 会话所有权 + 人工接管:
session handoff/resume/status/list(#89,从 ego-lite 搬);whoami每站身份 + 全局--as账号守卫。 - v1.5.67(2026-07-02)— 扩展多 profile 引导安装:枚举所有 profile、检测过期策略、深链设置页 + 等审批 + 自动重启;安装向导 zh/en 本地化;
connect <port>/--cdp换端点时重绑。 - ab-connect 0.5.10(2026-07-06)— 扩展 popup / options 页脚新增
Docs(chrome-use.leeguoo.com)与leeguoo.com链接;消除 native host 断开时打到错误页的Unchecked runtime.lastError: Native host has exited警告(断开本就预期,按需重连,纯观感清理)。 - ab-connect 0.5.9(2026-07-02)— 新增
identity/identity.email权限:hello 握手带上当前 Chrome profile 的登录邮箱,chrome-use browsers能标出每条连接属于哪个账号(多账号下区分"登出" vs "错账号")。邮箱仅走本地 native messaging,不外传。 - v1.5.66(2026-07-02)—
select找不到匹配的<option>时不再默默选不中,改为报错并列出所有可选项;默认操作超时从 30s 降到 25s。 - v1.5.65(2026-07-02)—
network route --set-json结构化编辑响应 JSON 字段;新增chrome-use report一键打包脱敏痛点日志为可粘贴 issue;MCP--tools all(24 工具)。 - v1.5.64(2026-07-01)—
chrome-use mcp:给 Claude Desktop 这类只讲 MCP、不能跑 shell 命令的宿主起一个 stdio MCP 服务器(12 工具核心 profile)。 - v1.5.63(2026-07-01)—
read [url]:把一个 URL(不传参数时是当前标签页)抓取成 agent 可读文本,支持--llms/--outline/--filter/--raw。 - v1.5.62(2026-07-01)— 修复
type --clear/--delay解析;find label现在也匹配aria-label/aria-labelledby。 - v1.5.61(2026-07-01)— React renderer 修复:挑选真正的 react-dom renderer,不再硬编码 id 1(此前在 Next.js 16.3 Turbopack RSC 应用上读到空树)。
- v1.5.60(2026-07-01)—
network route:响应阶段编辑真实响应(状态码/响应头/响应体子串替换)。 - v1.5.59(2026-07-01)—
network route:通过 CDP Fetch 域 mock 响应、改写请求——无需代理、无需证书、不注入 JS。 - v1.5.58(2026-07-01)—
chrome-use test:多账号 YAML 用例支持按 case 切换账号(account:)。 - v1.5.55(2026-06-29)— 摩擦点自动上报(friction auto-reporting)。
- v1.5.54(2026-06-29)— form fill 支持按可见文本选中 select 选项;修复 self-heal 在
--launch路径下失效的问题。 - v1.5.53(2026-06-29)—
form fill --map:批量映射填表。 - v1.5.52(2026-06-29)—
--observe:捕捉 action 前后的 a11y 树差异;补充 auto ref-heal 文档。 - v1.5.51(2026-06-29)— action 守卫
--if-present/--optional。 - v1.5.50(2026-06-29)—
extract --schema:按 schema 结构化抓取为 JSON。 - v1.5.49(2026-06-29)—
expect:断言 + 对应退出码。 - v1.5.48(2026-06-29)— ab-connect 0.5.7:休眠唤醒后通过
chrome.idle自动重连。 - v1.5.47(2026-06-29)— ab-connect 0.5.6:adopt 不再持久化,清除卡住的 debugger 提示条。
- v1.5.46(2026-06-29)— relay 自愈:relay 掉线自动恢复,无需挂起等待或手动重连。
- v1.5.45(2026-06-28)— 修复 adopt-tab 命令解析回归(#68 引入)。
- v1.5.44(2026-06-28)— adopt 改为按需 attach(ext 0.5.5):用户标签页不再出现 debugger 提示条。
- v1.5.43(2026-06-27)— #65
snapshot --filter+ eval 顶层 await 提示。 - v1.5.42(2026-06-27)— #60 浏览器/profile 选择:
browsers列表 +--browser。 - v1.5.41(2026-06-26)— #60 驱动中 profile 可观测性 + #53 canvas/closed-shadow 技能文档。
- v1.5.40(2026-06-26)— #58
eval --frame、reconnect 别名、更可操作的 stale-target 报错。 - v1.5.39(2026-06-26)—
snapshot -i现在能暴露内联表单校验错误。 - v1.5.38(2026-06-26)— #52 标签页路由限定到会话分组内 + CI 格式修复。
- v1.5.37(2026-06-25)— solve-slider 健壮性(等待切片加载)+ 可插拔检测器 hook。
- v1.5.34(2026-06-25)— solve-slider(网易易盾滑块验证码)+ drag 偏移模式。
- v1.5.32(2026-06-24)— sunny 扩展体验优化:更友好的图标、精修 popup、options 页、agent 光标。
- v1.5.31(2026-06-24)— relay tab-drift 时改为大声报错,不再误点错误的标签页。
- v1.5.30(2026-06-24)— relay 掉线提示 + canvas/closed-shadow 技能手册。
- v1.5.29(2026-06-24)— 静音
chrome.debugger提示条 + 修复残留的 about:blank scratch 标签页。 - v1.5.28(2026-06-22)— chrome-use 技能优先做真实联网检查。
- v1.5.27(2026-06-19)— 把 about:blank 清理逻辑限定在 relay 场景。
- v1.5.26(2026-06-18)—
session stop <name>+session prune+ 生命周期文档。 - v1.5.25(2026-06-18)— 默认空闲自动关闭 +
keep:不再留下 scratch 标签页/分组垃圾。 - v1.5.24(2026-06-18)— 修复构建:补上 browser.rs 的 clear_viewport/via_relay + cargo fmt。
- v1.5.23(2026-06-17)—
adopt:无需新开标签页即可驱动已存在的标签页。 - v1.5.22(2026-06-17)— relay 按分组限定
Target.getTargets:恢复弹窗跟随 + 隔离下的跨会话 adopt。 - v1.5.21(2026-06-17)— 富文本编辑器填充、box 中心点、截图降采样、disabled 处理 + 文档(#41-#45)。
- v1.5.20(2026-06-17)—
site:适配器自动同步 + 自动建议触发。 - v1.5.19(2026-06-17)—
site:bb-sites 适配器,把任意站点变成结构化数据 CLI。 - v1.5.18(2026-06-17)— 问题反馈指引 + relay 上
data:URL 的清晰报错。 - v1.5.17(2026-06-17)— 完善多 agent 隔离:点击不再误吞用户标签页/弹出页。
- v1.5.16(2026-06-17)— relay 上的严格多 agent 标签页隔离。
- v1.5.15(2026-06-17)— iframe 内按钮的可信激活。
- v1.5.14(2026-06-17)— 修复 eval await 回归(replMode)+ 默认滚动;CI 转绿(#36, #38)。
- v1.5.13(2026-06-17)— eval replMode(可重复声明 let/const)+ snapshot-first 技能规则(#37, #38)。
- v1.5.12(2026-06-17)— relay 安全的 hover/dblclick/drag、更深的 iframe snapshot、按键事件式输入。
- v1.5.11(2026-06-16)— 跨域 iframe 滚动/点击 +
open自动重新 attach(#35, #36)。 - v1.5.10(2026-06-16)— relay 在线时用 debug-port 启动会给出警告。
- v1.5.9(2026-06-16)— 去除标题里的零宽 unicode 字符 +
screenshot --clip/element。 - v1.5.8(2026-06-16)— 通过扩展 relay 实现文件上传。
- v1.5.7(2026-06-16)—
cf-status:Cloudflare 人机验证 clearance 预检。 - v1.5.6(2026-06-15)— 固定 adopt 的标签页,防止被短暂的 relay 快照误伤。
- v1.5.5(2026-06-15)— connect 模式下远程调试授权弹窗的诊断日志。
- v1.5.4(2026-06-15)—
get text --pierce:穿透 closed shadow DOM(#30)。 - v1.5.3(2026-06-15)—
get text默认跨 frame;#29(sessions/did-you-mean/标签页存活检测);CI changelog 修复。 - v1.5.1(2026-06-15)— 按 frame 提取文本(
get text --all-frames/--main、frames)+ #27,ab-connect 0.4.9 targetId 恢复。 - v1.5.0(2026-06-15)— 文本选择器点击、
get text默认到 body、tab --activate、click --follow/openedTab;fill触发 input/change/blur;close提示文案 +chrome-use current。
v1.4.x
- v1.4.1(2026-06-14)— hold-to-move(完整 keydown/keyup 描述符,#game);要求 ab-connect 0.4.8(#23 重连加固)。
- v1.4.0(2026-06-13)—
open不再抢占用户焦点;tab adopt-by-targetId;keydown/keyup 文档;canvas 提示;doctor检查各组件版本一致性。
v1.3.x
- v1.3.0(2026-06-13)— daemon restart/status(#20.2)+ 实时标签页重同步、adopt-by-targetId、
open --reuse-tab。
v1.0.x – v1.2.x
- v1.2.3(2026-06-13)—
bringToFront命令 +tab list --full显示完整 URL。 - v1.2.2(2026-06-12)— 非阻塞的“有更新”提示 + release changelog。
- v1.2.1(2026-06-12)— relay tab-drift 固定修复(#14/#18)+ 稳定的按标签页 relay session。
- v1.2.0(2026-06-12)—
chrome-use test:浏览器测试套件。 - v1.1.0(2026-06-12)— 跨 profile cookie 导出/迁移。
- v1.0.0(2026-06-12)— 品牌重塑:agent-browser-stealth → chrome-use,去 fork 化,版本号重置为 1.0.0。
v0.27.0-fork.x(重塑品牌前的 fork 阶段)
- v0.27.0-fork.51(2026-06-12)— rustfmt 修复 issue #7 回归测试(CI 格式检查)。
- v0.27.0-fork.50(2026-06-11)— 标签页标题截断 + 多 agent/eval/type 文档。
- v0.27.0-fork.49(2026-06-11)— 内嵌 stealth-status + 多 agent 技能指引。
- v0.27.0-fork.48(2026-06-11)— iframe-proxy 开关 + stealth status。
- v0.27.0-fork.47(2026-06-11)— tab-drift 固定、
snapshot -c保留可交互元素、stale-ref 处理指引。 - v0.27.0-fork.46(2026-06-11)— 限制
--annotate图例数量。 - v0.27.0-fork.45(2026-06-11)—
pickcombobox 原子操作。 - v0.27.0-fork.44(2026-06-11)— eval 来源标记、
type --focused、humanize 参数校验警告。 - v0.27.0-fork.43(2026-06-11)— 一批 issue/Hermes 反馈修复(静默点击、live 环境、
eval --file、tab-list、文档)。 - v0.27.0-fork.42(2026-06-11)— 退出时关闭本会话拥有的标签页,不再遗留标签页。
- v0.27.0-fork.41(2026-06-11)— relay 静默自愈,异常时无需用户操作。
- v0.27.0-fork.40(2026-06-11)— 已安装扩展时不再回退到 consent 弹窗。
- v0.27.0-fork.39(2026-06-11)—
cookies set --curl保留完整 cookie 属性。 - v0.27.0-fork.38(2026-06-11)— 静默运行,不再抢占用户前台标签页。
- v0.27.0-fork.37(2026-06-11)— 完善 humanize(bbox 抖动 + 滚轮/拖拽缓动)。
- v0.27.0-fork.36(2026-06-11)— 类人输入 stealth(humanize)。
- v0.27.0-fork.35(2026-06-11)— 技能内嵌 Store 安装、反馈渠道、过期二进制提示。
- v0.27.0-fork.34(2026-06-11)— Chrome Web Store 上线:面向商店的强制安装 + 技能商店安装指引。
- v0.27.0-fork.33(2026-06-10)— 修复两处 Hermes 反馈的边角问题(非法选择器措辞、空 URL glob)。
- v0.27.0-fork.32(2026-06-10)— 修复 Hermes 发现的 CLI bug(
wait --url、find role、非法选择器等)。 - v0.27.0-fork.31(2026-06-10)— Chrome Web Store 提审就绪 + 两条安装路径。
- v0.27.0-fork.30(2026-06-10)— stealth:navigator 覆写放到 prototype 上而非实例上。
- v0.27.0-fork.29(2026-06-10)— 修复插件 overflowTest、免弹窗自动连接、ab-connect 更名+图标、README。
- v0.27.0-fork.28(2026-06-10)— 技能文档:默认有头模式、标签页分组。
- v0.27.0-fork.27(2026-06-10)— 禁止无头模式(stealth 要求始终有头运行)。
- v0.27.0-fork.26(2026-06-10)— stealth:
navigator.platform修复为 MacIntel(反检测修复)。 - v0.27.0-fork.25(2026-06-10)— 修复 relay 活性检测(本地回答
Browser.getVersion),不再引发重连风暴导致漂移。 - v0.27.0-fork.24(2026-06-10)— 被动标签页发现不再抢占当前标签页(按会话隔离控制)。
- v0.27.0-fork.23(2026-06-10)— 容忍 relay 返回的最简 targetInfo(扩展 connect 的 getTargets)。
- v0.27.0-fork.22(2026-06-09)— 扩展 connect 改用 relay URL,修复
--session connect挂起问题。 - v0.27.0-fork.21(2026-06-09)— 多客户端 relay(支持并发 agent)。
- v0.27.0-fork.20(2026-06-09)— 按会话分组标签页(ab-connect 0.4.0)。
- v0.27.0-fork.19(2026-06-09)— 新扩展 ID(Web Store 签名密钥)+ 商店感知安装。
- v0.27.0-fork.18(2026-06-09)— 扩展 connect:零 token 原生消息控制真实 Chrome + 点击可靠性 + eval-first/find-url/site-notes。
- v0.27.0-fork.17(2026-06-05)— eval-first 技能 + find-url(本地书签搜索)+ site-notes 约定。
- v0.27.0-fork.16(2026-06-05)— 点击可靠性(滚动到可视区 + DOM 回退)+ 技能文档(console 手动开启、CLICK_MODE、表单/隐藏输入 eval)。
- v0.27.0-fork.15(2026-06-04)— stealth 加固(惰性
Runtime.enable、原生时区/WebRTC、可选 canvas 噪声)+ 自适应 @ref 重定位。 - v0.27.0-fork.14(2026-06-01)— 升级修复 + CI 切到 Node 24。
- v0.27.0-fork.13(2026-06-01)—
--profile auto。 - v0.27.0-fork.12(2026-06-01)— 内嵌技能文档。
- v0.27.0-fork.11(2026-06-01)— FullLaunch 路径下 stealth 完整生效(此前只在部分启动路径生效)。
- v0.27.0-fork.10(2026-06-01)— 一批体验优化 + stealth 覆盖率/webdriver 处理。
- v0.27.0-fork.9(2026-06-01)— 常规修复迭代。
- v0.27.0-fork.8(2026-05-09)— 内置重试机制,应对短暂的遮挡层。
- v0.27.0-fork.7(2026-05-09)— 误点前先捕捉短暂的遮挡层。
- v0.27.0-fork.6(2026-05-09)— 收紧防御性 CDP 超时上限,修复误导性的 chrome://inspect 提示。
- v0.27.0-fork.5(2026-05-09)— 修复误导性警告 + connect 活性探测 +
wait @ref。 - v0.27.0-fork.4(2026-05-09)— 修复 SPA 点击竞态 + @ref 身份校验 +
wait --gone。 - v0.27.0-fork.3(2026-05-09)— SPA 点击竞态修复 +
wait --gone原语。 - v0.27.0-fork.2(2026-05-09)— 更友好的 find 报错 + 版本不匹配重启后恢复 URL。
- v0.27.0-fork.1(2026-05-09)— 与上游 v0.27.0 同步,支持 skills.sh。
更早历史
chrome-use 会定期把上游 agent-browser 的版本合并进来(v0.27–v0.31,比如 v0.30.0 的 --wait glob 支持、v0.29.0 的 sandbox 包发布元数据修复);chrome-use 自己在这之上做了大量独立开发,两条版本号并不同步。
更早的 v0.x 版本(v0.6.0 – v0.26.0,2026 年 1–4 月)继承自上游 agent-browser 基线,逐条列出意义不大,这里不再展开。