BrowserSkill 详细部署教程

BrowserSkill 是腾讯开源的一款工具，它能将你的 AI 编程助手（如 Cursor、Claude Code 等）连接到你已经登录的浏览器，让 AI 像人一样操作网页，同时不影响你自己的工作浏览。

本教程将指导你完成 BrowserSkill 的完整部署。

1. 部署前准备

在开始前，请确认你的环境满足以下要求：

  • 操作系统: macOS (Apple Silicon/Intel)、Linux (x64/ARM64) 或 Windows x64。
  • 浏览器: Google Chrome 或 Microsoft Edge。其他基于 Chromium 的浏览器（如 Brave、Vivaldi）理论上也支持。
  • AI Agent: 支持 Shell 命令调用的 Agent，如 Cursor、Claude Code、Codex、OpenClaw、CodeBuddy 等。DeepSeek Harness 有专用插件支持。

2. 安装方式选择

官方提供了两种安装方式，推荐使用方式一（由你的 Agent 自动安装），整个过程会顺畅很多。

方式一：让 Agent 帮你安装 (推荐)

这是最简单的方法。只需要在你的 AI Agent（如 Cursor 的聊天窗口）中输入以下指令并发送：

1
Set up browser-skill on this machine by following https://raw.githubusercontent.com/Tencent/BrowserSkill/main/AGENT_INSTALL.md

随后，你的 AI Agent 会接管大部分安装步骤，包括下载 CLI、安装 skill，并引导你完成浏览器扩展的安装。你只需根据它的提示进行操作即可。

方式二：手动安装 (备选)

如果你偏好手动控制，可以按以下三步进行。

步骤 1：安装 bsk CLI

bsk 是 BrowserSkill 的命令行工具和后台服务。

  • macOS / Linux:
    打开终端，执行以下命令。它会将 bsk 安装到 ~/.local/bin 目录下：

    1
    curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh

  • Windows:
    以管理员身份打开 PowerShell，执行以下命令：

    1
    irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex

  • 验证安装:
    重新打开终端或命令行，运行以下命令，若成功显示版本号则说明 CLI 安装成功：

    1
    bsk --version

注意: 如果安装后提示命令找不到，你可能需要将 ~/.local/bin 添加到系统的环境变量 PATH 中。

步骤 2：安装浏览器扩展

接下来需要为你的浏览器安装 BrowserSkill 扩展，它是 AI 操作浏览器的“执行器”。

安装后，请固定 (Pin) 扩展图标到工具栏。安装后打开任意网页（或新标签页），点击扩展图标，确保其状态变为绿色，这表示它已与本地 CLI 成功建立连接。

步骤 3：为你的 Agent 安装 Skill

这一步是将 BrowserSkill 的使用说明“教”给 AI Agent，让它知道如何调用 bsk 命令。

  • 对于 Cursor、Claude Code 等支持的 Agent:
    在终端中执行以下命令，会出现一个交互式选择界面：

    1
    bsk install-skill

    使用 空格键 (Space) 选择你正在使用的 Agent（如 Cursor），然后按 回车键 (Enter) 确认安装。

  • 对于 DeepSeek Harness (dsh):
    需要安装专用的 npm 插件，而非使用 bsk install-skill。在你的项目目录下执行：

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

    完成后，dsh 会获得原生的 browser_* 工具集。

  • 其他 Agent:
    如果列表中没有你的 Agent，可以手动将项目中的 skill/SKILL.md 文件复制到你 Agent 对应的技能目录下，并重命名为 browser-skill/SKILL.md。

3. 验证安装

完成所有步骤后，强烈建议运行诊断命令，确保一切正常。

1
bsk doctor

该命令会检查 CLI、浏览器扩展连接等各项状态。如果所有检查项都显示 ok 或 na，则说明安装成功。如果 extension connected 显示 FAIL，请返回步骤2，确保浏览器扩展已正确安装并变为绿色状态。

4. 首次使用尝试

现在，你可以启动一个新的 AI Agent 会话，输入一个需要操作浏览器的指令来测试了。

例如，在 Cursor 的对话框中输入：

1
/browser-skill open https://example.com and summarize what is on the page.

你的 AI Agent 应该会调用 BrowserSkill，在你的浏览器中打开一个新的“Agent Window”标签页，执行打开网页和总结内容的操作。

故障排查提示

  • bsk 命令找不到: 检查 ~/.local/bin 是否在你的 PATH 环境变量中。Windows 用户可能需要重启 PowerShell。
  • 扩展无法连接: 确保 bsk CLI 正在后台运行（可以通过 bsk doctor 检查）。尝试重新加载浏览器扩展或重启浏览器。
  • Agent 无法调用: 确认你已经为当前的 Agent 正确安装了 Skill（执行了 bsk install-skill 并选择了正确的 Agent）。

至此，你已经完成了 BrowserSkill 的全部部署工作，可以开始享受 AI 助手上网冲浪的乐趣了。