企业官网建设流程全解析

BrowserSkill快速上手：3步安装bsk CLI+浏览器扩展，让AI驱动你的Chrome

【免费下载链接】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 是一款开源浏览器自动化工具，通过bskCLI + 浏览器扩展，让 Cursor、Claude Code、Codex 等 AI Agent 直接操作你已登录的真实 Chrome——打开网页、填表单、点按钮、截长图，全程不打断你自己的工作。本文带你用 3 步完成安装，让 AI 真正"开上"你的浏览器。

BrowserSkill 是什么？为什么值得装

一句话理解：它是 AI Agent 和你浏览器之间的本地桥接层。Agent 不直接碰浏览器，而是通过本地bsk命令下发任务，扩展在独立的 Agent Window 中执行。

四大核心优势：

• 🔄复用真实登录态：Agent 直接用你已登录的网站，无需测试账号
• 🛡️不中断你的工作：任务跑在独立的 Agent Window 里，你的常规窗口不受影响
• 🔌不绑定特定 Agent：只要 Agent 能调用 Shell，就能通过bskCLI 使用
• 🙋内置 human-in-loop：遇到验证码、登录、确认弹窗时，Agent 会主动请你接管，完成后继续任务

📦 运行环境：macOS（Apple Silicon / Intel）、Linux（x64 / ARM64）、Windows x64；浏览器支持 Chrome、Microsoft Edge 及其他 Chromium 系浏览器。

第一步：一键安装 bsk CLI

如果项目需要获取源码，执行：

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

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

./install.sh export PATH="$HOME/.local/bin:$PATH"

Windows（PowerShell）：运行 install.ps1 脚本即可。

验证安装成功：

bsk --version

能打印版本号就说明 CLI 装好了。bsk由 Rust 编写，CLI 与本地 daemon 的源码在 crates/bsk-cli/，想深入可以看看 crates/bsk-cli/src/daemon/ 的实现。

💡 首次执行浏览器任务时，daemon 会自动启动，普通本地环境无需任何额外配置。

第二步：安装 BrowserSkill 浏览器扩展

1. 打开 Chrome Web Store（Chrome / Chromium 系）或 Edge 加载项商店，搜索BrowserSkill并点击安装
2. 安装后点击浏览器右上角的 BrowserSkill 扩展图标，打开弹窗
3. 确认弹窗中显示"已连接"（READY），端口应与本地 daemon 一致
4. 可选：给浏览器起个别名（例如"个人 Chrome"），方便多浏览器场景识别

⚠️ 长截图等新功能要求 CLI 与扩展版本一致，可用bsk --version和bsk status核对。

第三步：安装 skill 并验证连接

skill 是"教" Agent 使用bsk的指令文件。一键安装到你的 AI 环境：

bsk install-skill

用Space选择你的 Agent（Cursor、Claude Code、Codex、OpenClaw 等），按Enter完成安装。非交互场景可指定目标，例如bsk install-skill --harness cursor --json。skill 内容源文件见 skill/SKILL.md。

然后运行健康检查：

bsk doctor

• 每行fail项都会附带hint，按提示处理后再跑一次即可
• 只安装完扩展后extension connected显示失败是正常的，装好扩展再复查
• 全新环境里 skill 相关项显示N/A不代表失败，说明未安装 skill

✅第一次实战验证：启动一个 Agent 会话，让它执行"打开 example.com 并总结页面内容"，成功读取并结束 session 即大功告成。

它是怎么工作的？

![说明：本图为文字流程示意，无对应图片文件] 整体链路非常清晰：

Agent（Cursor / Claude Code / Codex） │ shell: bsk ... ▼ bsk CLI ──本地 IPC──▶ bsk daemon ──127.0.0.1 WebSocket──▶ 浏览器扩展 │ ▼ Agent Window（自动化执行） 你的常规窗口（仅在显式借用时介入）

几个关键设计：

• 标签页借用机制：Agent 想操作你已打开的标签页，必须显式借用，任务结束自动归还；借用前你还能在扩展弹窗里设置是否需要确认
• human-in-loop：登录、验证码等必须由人处理的步骤，Agent 会请求你接管，完成后再继续
• 远程模式：Agent 跑在服务器上、浏览器在本地电脑？内置鉴权服务支持配对连接，详见 docs/remote-extension-connection.md

完整架构说明在 docs/architecture.md。

装好之后，还能玩什么 🚀

长截图功能还支持在扩展弹窗的快捷功能 → 长截图中直接操作，详见 docs/long-screenshot.md。

常见问题排查 🛠️

Q：bsk --version提示命令不存在？把~/.local/bin加入 PATH（见第一步的export命令）；正在运行的 Agent 如果沿用旧 PATH，重启一下即可。

Q：bsk doctor显示扩展未连接？确认扩展已安装、弹窗中开关已打开，且端口与本地 daemon 一致；混用旧版本 CLI 和扩展会触发协议兼容提示，升级后再看bsk status中的版本差异。

Q：Agent 找不到 browser-skill？检查bsk install-skill --list的输出路径是否指向你正在使用的 harness，必要时用--harness <id>显式指定。

Q：Agent 任务中弹出验证码怎么办？这正是 human-in-loop 生效的时刻——你手动完成验证后，Agent 会自动继续任务。也可以在扩展弹窗中关闭"允许请求人工协助"，让 Agent 在无协助情况下尽力完成已授权步骤。

三步走完，你的 AI Agent 就已经能像人一样使用真实浏览器了。🎉 建议从"打开网页并总结"这类小任务练手，熟悉后再交给它填表单、截长图等更复杂的自动化工作。

【免费下载链接】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