让 AI 智能体使用你的浏览器，而不打断你的工作。

English · 中文

BrowserSkill 将 Cursor、Claude Code、Codex、OpenClaw、CodeBuddy、WorkBuddy、Pi、Hermes Agent、DeepSeek Harness 以及其他 AI 智能体连接到你已经登录的浏览器。

如果需要智能体操作你已经打开的标签页，它必须显式"借用"该标签页，并在任务完成后归还，同时保持你浏览器其他部分不受影响。

https://github.com/user-attachments/assets/db782c92-b1d4-4aae-a255-039675937a90

BrowserSkill 的优势

• 复用真实登录状态：智能体可以直接操作你已经登录的网站，无需另设测试账号。
• 不打断你的工作：浏览器任务运行在独立的、可见的"智能体窗口"中，因此你可以继续使用自己的浏览器。
• 支持任何智能体：任何能够调用 shell 的智能体都可以通过 bsk 命令行工具使用 BrowserSkill，不绑定特定模型、智能体框架或运行时。
• 内置人在回路：当任务遇到验证码、登录、确认对话框或其他仅限人类操作的环节时，智能体可以请求你接管，之后再继续。

可在 快捷操作 → 全页截图 中截取长图，或让智能体使用 bsk screenshot --session --full-page --out page.png。详细页面支持、取消与导出方式请参阅全页截图指南。

运行环境

BrowserSkill 由两个本地运行时组成：bsk 命令行工具/守护进程，以及浏览器扩展。

快速开始

如果你使用的智能体沙箱会在每条命令结束后回收后台进程，请参考沙箱化智能体设置，将守护进程保留在持久的宿主机环境中，并通过共享的 BSK_HOME 与 BSK_AUTO_START=0 进行连接。普通本地使用默认保持自动启动。

通过智能体安装（推荐）

已经在使用 Cursor、Claude Code、Codex 或其他支持 shell 的智能体？只需复制下面这一行发送给智能体，它会自动为你安装命令行工具与技能，并引导你加载扩展：

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

手动安装

先安装命令行工具，然后从 Chrome Web Store 或 Edge Add-ons 安装扩展。

1. 安装 bsk 命令行工具

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 用于在当前 Unix shell 中使命令行工具可用。运行中的智能体在每次调用 shell 时可能都需要同样的 PATH 设置，或使用已安装二进制文件的绝对路径。如果智能体在安装后保留了旧的 PATH，请重启智能体。

在将要使用它的终端或智能体环境中验证二进制文件：

bsk --version

2. 安装浏览器扩展

从浏览器商店安装 BrowserSkill：

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

3. 安装技能

BrowserSkill 自带一个技能，用于教会你的智能体运行时如何使用 bsk。对于以下运行时，可一步完成安装：

bsk install-skill

使用空格选择要安装到的智能体运行时，再按回车完成技能安装。运行 bsk install-skill --list 可查看内部变体与安装路径。

如需非交互式安装，可指定目标运行时，例如 bsk install-skill --harness cursor --json。当运行时未被识别时，显式选择同样有效。单独使用 --yes 时，会向所有已检测到的运行时安装；若未检测到任何运行时则失败。

若要安装你自己的指令，可使用 bsk install-skill --harness cursor --source ./SKILL.md。即便内容与内置技能一致，显式传入的 --source 也会被视作自定义内容。已存在的安装会被跳过，除非添加 --force。

守护进程启动、session start 和 doctor 会在托管技能内容仍与上一次安装版本一致时自动更新。本地修改会被保留，自动更新将暂停。对于没有内容基准的旧版本安装，只有在其内容与当前内置技能完全一致时才会自动纳入更新；此操作仅写入来源标记，不会重写 SKILL.md。即便内容一致，显式自定义安装始终保持自定义状态。

对于不同的历史文件、本地修改或无法识别的来源标记，doctor 会显示 WARN 并给出原因与恢复选项。这些警告不会让健康检查失败（--json 会报告 status: "warn" 与 ok: true）。并发安装或同步会被报告为延迟，并在后续重新尝试。

若要将当前指令保留为显式自定义，请运行 bsk install-skill --harness cursor --source --force，将 ` 替换为现有文件的路径。若要恢复内置技能并继续自动更新，请在不使用--source的情况下运行bsk install-skill --harness cursor --force`，此命令将覆盖现有指令。

其他支持 shell 的智能体运行时同样受支持。将 skill/SKILL.md 复制到运行时技能目录下，重命名为 browser-skill/SKILL.md 即可手动安装。DeepSeek Harness 使用专用插件——请参阅 DeepSeek Harness 插件。

4. 验证连接

运行 bsk doctor 并按提示操作。打开扩展弹窗，确认其已连接。请解释所有警告，并在测试浏览器使用前解决所有失败。Doctor 即便未安装技能也能通过（显示 N/A）；请单独验证技能发现是否正常。

启动一个新的智能体会话，确认 browser-skill 在运行时中可用，然后请它打开 https://example.com 并对页面进行摘要。对于支持斜杠命令调用技能的运行时，例如：

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

首次使用的检查若成功，会读取页面内容并结束 BrowserSkill 会话。若技能缺失，请检查目标运行时与安装路径后再重试。

更新

对于默认的本地设置，请在更新前结束进行中的浏览器任务：

bsk update --yes

若 Windows 报告存在待生效的更新，请等待替换完成后再检查 bsk --version。

当该命令安装更新时，会以默认启动设置重启正在运行的守护进程。如果你改用安装程序替换了二进制文件，请先结束任务，再使用 bsk daemon restart 重启现有守护进程。

对于自定义端口、由宿主管理的沙箱守护进程或远程服务器，请在所属宿主机或监管进程中停止守护进程，运行 bsk update --yes --no-restart-daemon，并在该处以原始标志和 BSK_HOME 重新启动。在智能体命令中管理时，请设置 BSK_AUTO_START=0；可参考沙箱与远程配置指南。

请通过浏览器商店更新扩展；对于未打包的开发构建，请重新构建并重新加载。商店的上架可能会晚于命令行工具的发布。可通过 bsk --version 和 bsk status 检查命令行工具、守护进程与扩展的版本，再运行 bsk doctor。全页截图等新功能需要匹配的版本。请单独更新 DSH 插件 并重启其配置文件。托管的命令行工具技能会在守护进程启动、session start 或 doctor 时同步；本地修改与自定义技能会被保留。请启动新的智能体会话以加载更新后的指令。

升级到 0.3.0：--unattended、tab borrow --no-confirm 与 BSK_REQUEST_HELP=off 不再用于绕过确认或禁用帮助。请改用下文所述的对应扩展设置。详见变更说明。