BrowserSkill 扩展 0.3.3→0.4.2 升级实战:版本号对不上与 confirmTabBorrow 开关

举报
yd_234112108 发表于 2026/11/09 17:55:50 2026/11/09
【摘要】 背景:先分清三个版本号BrowserSkill(以下简称 BS)是一套用自然语言操作浏览器的工具,由 CLI、浏览器扩展、通信协议三部分组成。很多人升级时只盯一个版本号,结果升完发现对不上——因为这三者是独立发版的:CLI:命令行工具 bsk,负责发指令、管会话;扩展(Ext):装在 Chrome 里的扩展,负责在页面上执行操作;协议(Protocol):CLI 与扩展之间约定的消息版本。这...

背景:先分清三个版本号

BrowserSkill(以下简称 BS)是一套用自然语言操作浏览器的工具,由 CLI、浏览器扩展、通信协议三部分组成。很多人升级时只盯一个版本号,结果升完发现对不上——因为这三者是独立发版的:

  • CLI:命令行工具 bsk,负责发指令、管会话;
  • 扩展(Ext):装在 Chrome 里的扩展,负责在页面上执行操作;
  • 协议(Protocol):CLI 与扩展之间约定的消息版本。

这次我把扩展从 0.3.3 升到 0.4.2,CLI 本来就已经是 0.4.2。升级完反而冒出一个自相矛盾的提示,值得单独记一笔。

升级步骤

扩展没有走 Chrome 应用商店自动更新,我是手动换的预编译包:

# 1. 下载对应版本的预编译包(以 0.4.2 为例)
https://github.com/Tencent/BrowserSkill/releases/download/ext-v0.4.2/browser-skill-extension-v0.4.2-chrome.zip

# 2. 解压,确认 manifest 里的 version 是 0.4.2
# 3. 把扩展目录 dist/chrome-mv3 整个替换成新版
# 4. 重启 Chrome(扩展是随浏览器加载的,不重启内存里还是旧版)

关键点在第 4 步:只换文件不重启浏览器,扩展还是旧的。扩展的 service worker 和 content script 是浏览器启动时加载的,文件换了、进程没换,等于没升。我这次就是先换了文件、忘了重启,查版本时还以为升级失败。

坑一:升级完版本号还是 0.3.3

文件换好、浏览器重启后,扩展弹窗底部仍然显示 CLI 0.4.2 / Ext 0.3.3,daemon 上报的扩展版本也是 0.3.3。但同一块弹窗的标题栏却写着 Extension protocol v1.8, CLI protocol v1.8,还挂着一个 UPGRADABLE 角标和一句 Protocol versions differ — please upgrade。

三处信息互相打架:

  • 弹窗已经是新版 UI(多了 Automation settings 分区),说明新包确实加载了;
  • 底部的 Ext 版本号还停在 0.3.3;
  • 协议版本两边都是 v1.8,明明一致,却提示“版本不同,请升级”。

结论:底部那个 Ext 版本号不是从 chrome.runtime.getManifest() 读的,而是 daemon 上报的缓存值,重启 daemon 或等它重新握手后才可能刷新。判断升级是否成功的可靠依据是两点——弹窗出现新版才有的设置项,以及协议版本一致(都是 v1.8)。只看底部版本号会误判,不用在那上面死磕。

坑二:confirmTabBorrow 是按浏览器 profile 存的

0.4.2 新版弹窗里多了 Automation settings 分区,其中一项是 Confirm before borrowing tabs(借用标签页前确认)。打开时,Agent 想用你已经打开的标签页要先弹确认;关掉后直接借用,不再打扰。

这个开关的存储键名是 confirmTabBorrow,存在扩展的 storage 里。容易踩的坑是:它是按浏览器 profile 存的,不是全局的。同一台机器上有几个 Chrome profile(比如主 profile 和专门跑自动化任务的 profile),每个 profile 都要单独关一次;只关一个,另一个 profile 里还是弹确认。命令行参数也覆盖不了它,弹窗里写明了 command-line options cannot override it。

我的做法是:每个要跑自动化的 profile 都手动打开扩展弹窗确认一遍,开关处于关闭状态再开始跑任务。批量部署时别指望一个命令全搞定。

顺带教训:标签页纪律

这次升级顺带暴露了另一个问题:自动化跑久了,浏览器里会攒下一堆标签页——任务页、案例页、登录页、中间跳转页,全开着没人关。标签页一多,浏览器负载明显上升,操作也变慢。

现在立的规矩很简单,三条:

  • 能复用当前标签页就复用,原地导航,不开新页;
  • 用完的标签页立刻关掉,不留无用标签页;
  • 每次开工先清掉不需要的标签页,只留正在用的。

另外,BS 的 tab close 关不了“借用”来的用户标签页(会报 tab is borrowed; call tab_return first),要先 tab_return 归还,或者直接用 CDP 的 /json/close/<targetId> 按完整 UUID 关。批量清标签页时,CDP 按 URL 匹配更直接,但要注意区分同 URL 的重复页,别把正在用的那一页误关了。

验收清单

升级完按这张清单逐项核对,全过才算完:

  • 扩展 manifest 里的 version 是目标版本(如 0.4.2);
  • 浏览器已重启,弹窗出现新版才有的设置项;
  • CLI 与扩展的协议版本一致(如都是 v1.8);
  • 每个自动化 profile 的 Confirm before borrowing tabs 都已关闭;
  • 浏览器里只留正在用的标签页,多余的已关掉。

版本号那一栏如果还显示旧数字,先看上面四项——四项都过就不用管它,那是 daemon 的缓存值,不是真实版本。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。