BrowserSkill 完整入门指南：5 分钟让 AI 接管你的真实浏览器

【免费下载链接】BrowserSkillLet AI agents use your real, logged-in browser without interrupting your work. CLI + extension for browser automation across any shell-capable AI agent.项目地址: https://gitcode.com/GitHub_Trending/br/BrowserSkill

BrowserSkill 是一款面向 AI 智能体的浏览器自动化工具：它由bsk命令行工具和浏览器扩展组成，让 AI 直接复用你已经登录好的浏览器干活，同时不打扰你自己的浏览。只要你有 Cursor、Claude Code 这类能执行 shell 命令的 AI 助手，跟着这篇 BrowserSkill 入门教程，几分钟就能装好并跑通第一个任务。

为什么 AI 操作浏览器，总是差一口气

你有没有遇到过这种场景：让 AI 帮你看某个网站的页面，它却在沙箱里开一个全新的无头浏览器——没登录、弹验证码、关键信息全看不到，你还得专门给它注册个测试账号。问题往往不在 AI 够不够聪明，而在它手里根本没有你的真实浏览器。

BrowserSkill 要解决的就是这件事：把任何能跑 shell 命令的 AI 助手接到你的 Chrome 或 Edge 上，直接复用现有登录状态。它的关键设计是让 AI 任务跑在一个独立、可见的Agent Window里，你自己的标签页不受影响；遇到验证码这类只能人做的步骤，它会主动请你出手，完事再继续。

准备工作与安装：四步装好 bsk 并连上浏览器

第 1 步：拿到仓库，安装 bsk 命令

git clone https://gitcode.com/GitHub_Trending/br/BrowserSkill cd BrowserSkill bash install.sh

Windows 用户在 PowerShell 里换用这条命令：

cd BrowserSkill .\install.ps1

装完后运行bsk --version，能看到版本号就说明这步成功了。

💡 终端提示找不到bsk？多半是 PATH 没生效。重开一个终端再试，或直接用绝对路径~/.local/bin/bsk验证。

第 2 步：装好浏览器扩展

在 Chrome 应用商店或 Edge 加载项里搜索BrowserSkill并安装（需 Chromium 125 及以上）。装完点击扩展图标，在弹窗里启用本地连接，看到"已连接"状态才算就绪：

第 3 步：给 AI 装上技能

运行bsk install-skill，在交互菜单里用空格键选中你正在用的 AI 助手，按回车确认。这一步把浏览器操作说明书写进你的 AI 助手，它从此知道怎么用bsk。

第 4 步：一键自检

运行bsk doctor，各项检查都没有fail项即环境就绪。如果extension connected一项失败，回到第 2 步检查扩展弹窗。

跑通第一个 BrowserSkill 任务：让 AI 打开网页并总结

在 AI 助手里新开一个会话，直接说一句话：

打开 example.com，并总结这个页面的内容

AI 会按技能流程自动执行一连串命令，你可以全程看着它干活：

bsk session start --json bsk navigate https://example.com --session <id> bsk observe --session <id> bsk session stop <id>

第一条启动浏览器会话并返回会话 ID，中间两条负责打开页面、读取文本与控件，最后一条在任务完成后收掉会话。当 AI 把页面总结交到你手上时，恭喜，你已经完整跑通第一个 BrowserSkill 任务 🎉

原理速览：AI 的浏览器任务为什么不烦你

一条请求的完整链路是：bskCLI → 本地 daemon → WebSocket → 浏览器扩展 → Agent Window。CLI 只负责转交命令，daemon 默认监听 52800 端口、管理会话，扩展则真正驱动浏览器。每次bsk session start都会新开一个独立可见的窗口，AI 只能在其中操作；它若确实要碰你已有的标签页，必须走"借用"流程（bsk tab borrow）并获得你的确认，用完再bsk tab return归还。更多细节可以读 docs/architecture.md。

常用 bsk 命令速查：从读页面到截长图

其中的@eN编号来自上一次observe的返回，由 AI 自动维护，你只需用自然语言描述目标即可。完整命令集见 crates/bsk-cli/skill/SKILL.md。

避坑指南：首次使用 BrowserSkill 最常踩的四个问题

• bsk doctor显示扩展未连接？打开扩展弹窗，确认端口与本地 daemon 一致（默认 52800），再重新启用连接。
• 提示找不到bsk命令？macOS / Linux 执行export PATH="$HOME/.local/bin:$PATH"，或干脆重开终端。
• AI 助手找不到 browser-skill 技能？技能在会话启动时加载，重启 AI 会话再试。
• 支持哪些浏览器？Chrome 与 Edge 为官方支持（Chromium 125+），Firefox 规划中。

接下来可以玩什么

跑通第一个任务后，建议顺着这几个方向继续：

• docs/long-screenshot.md：整页长截图的完整玩法
• docs/sandboxed-agents.md：沙箱环境下的部署方式
• AGENT_INSTALL.md：让 AI 助手全自动完成安装

浏览器已经交到 AI 手里了，下次打开 AI 助手，直接把需求告诉它就好。

【免费下载链接】BrowserSkillLet AI agents use your real, logged-in browser without interrupting your work. CLI + extension for browser automation across any shell-capable AI agent.项目地址: https://gitcode.com/GitHub_Trending/br/BrowserSkill