Tencent BrowserSkill

BrowserSkill 让 AI agent 使用你的浏览器，而不打断你的工作。English · 中文 BrowserSkill 将 Cursor、Claude Code、Codex、OpenClaw、CodeBuddy、WorkBuddy、Pi、Hermes Agent、DeepSeek Harness 以及其他 AI agent 连接到你已经登录的浏览器。需要 agent 操作你已经打开的某个标签页？它必须明确借用该标签页，在任务完成后归还，并且不干扰你浏览器的其余部分。github.-.mp4

BrowserSkill 优势

复用真实登录状态：Agent 可以操作你已经登录的网站，无需单独的测试账号。
保持工作不被打断：浏览器任务在一个独立、可见的 Agent Window 中运行，因此你可以继续使用自己的浏览器。
支持任意 Agent：任何能够调用 shell 的 Agent 都可以通过 bsk CLI 使用 BrowserSkill，不锁定特定模型、Agent 框架或 harness。
内置 human-in-loop：当任务遇到 captcha、登录、确认对话框或其他仅限人工完成的步骤时，Agent 可以请求你接管，然后在之后继续。

在 Quick actions → Full-page screenshot 中截取长图，或让 Agent 使用 bsk screenshot --session --full-page --out page.png。有关页面支持、取消和导出，请参阅 full-page screenshot 指南。

运行环境

BrowserSkill 有两个本地运行时组件：bsk CLI/daemon 和浏览器扩展。

运行时支持

操作系统：macOS（Apple Silicon 和 Intel）、Linux（x64 和 ARM64）、Windows x64
浏览器：支持 Chrome 和 Microsoft Edge；其他基于 Chromium 的浏览器在支持未打包 Chromium 扩展时预计也可使用；Firefox 已在计划中

快速开始

使用的是会在每条命令后回收后台进程的 agent 沙箱？请遵循 sandboxed agent setup，将 daemon 保持在持久的主机环境中，并使用共享的 BSK_HOME 加上 BSK_AUTO_START=0 进行连接。普通本地使用默认保持自动启动。

使用你的 Agent 安装（推荐）

已经在使用 Cursor、Claude Code、Codex 或其他支持 shell 的 agent？只需复制这一行并发送给你的 agent——它会为你安装 CLI 和 skill，然后引导你加载扩展：

按照 https://raw.githubusercontent.com/Tencent/BrowserSkill/main/AGENT_INSTALL.md 在这台机器上设置 browser-skill

手动安装

安装 CLI，然后从 Chrome Web Store 或 Edge Add-ons 安装扩展。

1. 安装 bsk CLI

macOS / Linux（推荐——安装到 ~/.local/bin）：

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

Windows（PowerShell——安装到 ~/.local/bin）：

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

export 使 CLI 在当前 Unix shell 中可用。正在运行的 agent 可能需要在每次 shell 调用中使用相同的 PATH 设置，或使用已安装二进制的绝对路径。如果 agent 在安装后仍保留旧的 PATH，请重启它。

在将使用它的终端或 agent 环境中验证该二进制文件：

bsk --version

2. 安装浏览器扩展

从你的浏览器商店安装 BrowserSkill：

浏览器商店列表
Chrome：Chrome Web Store
Microsoft Edge：Edge Add-ons

在其他基于 Chromium 的浏览器上，请安装 Chrome Web Store 版本。

3. 安装 skill

BrowserSkill 附带一个 skill，用于教会你的 agent harness 如何使用 bsk。对于这些 harness，可一步安装：

Cursor
Claude Code
Codex
OpenClaw
CodeBuddy
WorkBuddy
Pi
Hermes Agent

bsk install-skill

使用 Space 选择你要安装到的 Agent harness，然后按 Enter 安装 skill。运行 bsk install-skill --list 查看内部变体和安装路径。

对于非交互式安装，请指定目标 harness，例如 bsk install-skill --harness cursor --json。当未检测到 harness 时，显式选择也可用。仅使用 --yes 会安装到所有检测到的 harness，并在未检测到任何 harness 时失败。

要安装你自己的指令，请使用 bsk install-skill --harness cursor --source ./SKILL.md。显式的 --source 即使其内容与捆绑 skill 匹配，也会保持为自定义。

除非添加 --force，否则会跳过现有安装。Daemon startup、session start 和 doctor 仅在其内容仍与上次安装版本匹配时，才会自动更新受管理的 skill。本地编辑会被保留，自动更新会暂停。没有内容基线的较旧安装，仅当其与当前捆绑 skill 完全匹配时才会自动纳入；这只会写入 source marker，而不会重写 SKILL.md。显式自定义安装即使内容匹配也会保持自定义。对于不同的历史文件、本地编辑或无法识别的 source marker，doctor 会显示 WARN，并给出原因和恢复选项。这些警告不会使健康检查失败（--json 报告 status: "warn" 和 ok: true）。并发安装或同步会被报告为 deferred，并在后续轮次重试。

要将你当前的指令保留为显式自定义，请运行 bsk install-skill --harness cursor --source --force，将替换为你现有文件的路径。要恢复捆绑 skill 并恢复自动更新，请运行不带 --source 的 bsk install-skill --harness cursor --force。第二条命令会覆盖现有指令。

其他支持 shell 的 agent harness 也受支持。将 skill/SKILL.md 复制到你 harness 的 skills 目录中，作为 browser-skill/SKILL.md，即可手动安装该 skill。DeepSeek Harness 使用专用插件——请参阅 DeepSeek Harness plugin。

4. 验证连接

运行 bsk doctor 并遵循其提示。打开扩展弹窗并确认其已连接。在测试浏览器使用前，解释任何警告并解决失败。Doctor 可以在未安装 skill 的情况下通过（N/A）；请单独验证 skill 发现。启动一个新的 Agent session，确认 browser-skill 在 harness 中可用，并且