BrowserSkill 扩展 0.3.3→0.4.2 升级实战:版本号对不上与 confirmTabBorrow 开关
背景:先分清三个版本号
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 的缓存值,不是真实版本。
- 点赞
- 收藏
- 关注作者
评论(0)