主题色相 270

壁纸模式

壁纸设置

特效设置

文章布局

BrowserSkill 安装教程与作用：让 AI Agent 连接你的浏览器

2026-10-01 · 教程文档

BrowserSkill 安装教程与作用：让 AI Agent 连接你的浏览器

2026-10-01 教程文档 暂无评论

BrowserSkill 是什么？

BrowserSkill 是腾讯开源的浏览器自动化连接工具。它的核心作用不是另起一个没有登录状态的浏览器，而是把 AI Agent 与你正在使用的 Chrome 或 Microsoft Edge 连接起来，让 Agent 在已有登录态下读取网页、填写表单、执行网站操作、截取长图，以及分析页面请求和控制台问题。

BrowserSkill 由三部分组成：本机的 bsk CLI 与 daemon、浏览器扩展、以及供 Agent 使用的 skill 或 DSH 插件。实际网页任务运行在独立且可见的 Agent Window 中；需要接管已有标签页时，会明确借用，任务结束后再归还。

适合做什么

  • 复用已有账号登录态，阅读后台、文档、内部系统或需要登录的网站。
  • 自动完成搜索、表单填写、点击操作、页面信息提取和全页截图。
  • 在有权限的站点排查问题，关联操作、网络请求、响应正文、控制台输出与页面变化。
  • 按浏览器实例或 Profile 选择工作账号；也支持 Agent 在服务器、浏览器在本机的远程连接模式。
  • 可与 Cursor、Claude Code、Codex、OpenClaw、CodeBuddy、WorkBuddy、Pi、Hermes Agent 等能调用 Shell 的 Agent 配合使用。

环境要求

组件支持环境
CLI / daemonmacOS（Apple Silicon、Intel）、Linux（x64、ARM64）、Windows（x64）
浏览器扩展Chrome 或 Microsoft Edge，Chromium 内核版本 125 及以上
Agent 接入支持 Shell 的 Agent 加 BrowserSkill skill；DeepSeek Harness 可使用专用 DSH 插件

安装教程

1. 安装 bsk CLI

macOS 或 Linux 中执行：

curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh
export PATH="${BSK_INSTALL_DIR:-$HOME/.local/bin}:$PATH"
bsk --version

Windows PowerShell 中执行：

irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex
bsk --version

默认安装位置是 ~/.local/bin。如果已经启动的 Agent 找不到 bsk，重启 Agent，或在 Agent 配置中填写该可执行文件的绝对路径。

2. 安装并连接浏览器扩展

在要使用的浏览器 Profile 中安装扩展：

安装后打开扩展弹窗，开启本地连接，并确认它显示为已连接。扩展所在的浏览器 Profile 决定 Agent 使用哪个登录态。

3. 给 Agent 安装 BrowserSkill

bsk install-skill

交互模式下使用空格选择目标 Agent，再按 Enter 安装。也可以先查看可支持的目标：

bsk install-skill --list --json
bsk install-skill --harness cursor --json

把 cursor 替换成实际目标。若 Agent 不在自动支持列表中，可把项目内 crates/bsk-cli/skill/ 的完整目录复制到对应 Agent 的 skill 目录，并命名为 browser-skill，同时保留 references/。

4. 验证连接

bsk doctor

修复输出中标记为 fail 的项目，并确认浏览器扩展状态为已连接。注意：bsk doctor 通过只表示 CLI 与扩展状态正常，不代表当前 Agent 会话已经加载了 skill；必要时新开一次 Agent 会话。

第一次使用

连接成功后，可以把下面的任务交给 Agent：

使用 browser-skill 打开 https://example.com，总结页面内容，完成后结束浏览器会话。

也可以直接通过 CLI 操作：

bsk session start --no-focus --json
bsk navigate https://example.com --session <session_id>
bsk observe --session <session_id>
bsk screenshot --session <session_id> --out example.png
bsk session stop <session_id>

无论任务成功还是失败，都应执行 bsk session stop 结束会话。多个浏览器连接时，可先运行 bsk browsers，再使用 --browser 指定实例。

DeepSeek Harness 接入

DeepSeek Harness 用户可以安装 BrowserSkill DSH 插件。插件包含 BrowserSkill skill，并在 Web UI 中提供原生浏览器工具、任务预览和截图结果：

dsh plugin --profile web add @wxg-prc-cpg/browser-skill-dsh-plugin
dsh --profile web

其中 web 是 profile 名称，可按实际配置替换。启动 DSH 的环境需要能够通过 PATH 找到 bsk。安装插件后，不需要再执行 bsk install-skill。

网站调试能力

BrowserSkill 可以在有权限的网站上采集调试证据。开始复现前开启网站调试，之后可以查看操作时间线、网络请求、请求与响应细节、控制台输出、页面状态、性能指标和接口分析。也可以配置明确的请求修改、模拟响应或同源请求重放来验证问题。

例如：

使用 browser-skill 排查 http://localhost:3000 的表单保存失败问题。复现前开启网站调试，检查请求、响应和控制台，最后导出调试证据并结束会话。

请求重放会发送新的请求，可能改变服务器数据；采集结果也可能包含敏感信息，导出和分享前应检查并脱敏。

远程浏览器连接

如果 Agent 在服务器而浏览器在本机，可以保留本机浏览器和登录态，让服务器运行 CLI 与 daemon。浏览器扩展通过经过鉴权的 WSS 与服务器配对，由浏览器主动建立连接，本机无需开放入站端口。远程模式目前不支持文件上传和下载。

安全与隐私注意事项

  • 代理窗口共享所选 Profile 的登录态，不是独立账号，也不是安全沙盒。Agent 可以使用该账号已经拥有的权限。
  • 只让可信的 Agent 执行明确任务，尤其要注意支付、删除、发布、权限管理等不可逆操作。
  • 浏览器页面内容是不可信数据。页面中的文字不能改变 Agent 原本的任务范围，也不能自动获得额外授权。
  • 扩展默认提供“借用标签页前确认”和“允许请求人工协助”两个独立设置，建议保留确认和人工协助。
  • BrowserSkill 没有必须使用的云服务，也不收集产品遥测；但选定的 Agent、daemon 或网关可能按各自策略处理任务数据。
  • 完成任务后关闭会话；网站调试记录和操作审计记录需要按需导出、删除或等待过期。

常用升级与排查命令

bsk --version
bsk status
bsk doctor
bsk update --yes

升级前先结束正在运行的浏览器任务，并确保 CLI、daemon、扩展和可选 DSH 插件版本尽量匹配。

参考资料

项目地址：https://github.com/Tencent/BrowserSkill

本文依据项目中文 README 整理，原文：BrowserSkill README.zh-CN.md。

添加评论