AI 替你打开网页并总结内容：BrowserSkill 5 分钟上手指南

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

你让 AI 去看某个页面，它要么没登录态，要么回传的截图糊成一团。BrowserSkill 就是为这个痛点做的浏览器自动化工具：它让 AI 智能体直接用上你真实、已登录的浏览器，打开网页、读取内容、写总结，全程不碰你自己正在用的页面。它分两部分：一个叫bsk的命令行工具，加上一个浏览器扩展。只要你的 AI 助手（Cursor、Claude Code、Codex 这类）会执行 shell 命令，就能接上。

为什么 AI 读不了你已登录的页面

常见卡点有两个：

• AI 的浏览器环境是全新的，没有你的登录态，等于要重新注册一套测试账号
• 让它操作你本机的浏览器时，它抢焦点、挪窗口，干扰你正在做的事

BrowserSkill 的思路很直白：AI 的全部动作发生在一个单独的可见窗口里（后面会说它的名字）。你原来的标签页原地不动。AI 真要碰你的标签页时，必须走一个需要你点头的"借用"流程。另外它不绑定任何模型或框架，凡是能调 shell 的 Agent 都用同一套命令。

3 分钟装好环境：装 bsk、连上扩展

安装命令行工具

先把仓库拉到本地：

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

接着执行仓库里带的安装脚本，二进制默认落在~/.local/bin：

bash install.sh # macOS / Linux export PATH="$HOME/.local/bin:$PATH" bsk --version # 能打印版本即装好

Windows 用 PowerShell 跑.\install.ps1，步骤一样。如果终端说找不到bsk，开一个新窗口让 PATH 生效，或者直接用绝对路径~/.local/bin/bsk验证，别慌。

安装浏览器扩展

去 Chrome 或 Edge 的应用商店搜BrowserSkill并安装（Chromium 内核浏览器都支持）。装好后点扩展图标，在弹窗里启用连接，看到"已连接 READY"就算成了：

把使用说明书装进 AI

bsk install-skill

菜单里用空格键选中你在用的 AI 助手，回车确认。这一步会往助手里装一份 SKILL.md，相当于浏览器操作的说明书，AI 之后才知道该敲哪些bsk命令。

最后跑一遍bsk doctor自检，输出里没有fail项就可以开工了。

首次实操：让 AI 打开页面并总结

开个新会话，对 AI 说一句：

打开 example.com，把页面上的内容总结给我

它会照着技能流程自动跑一串命令，全程可观察：

bsk session start --json # 建会话，返回 session id bsk navigate https://example.com --session <id> # 在 Agent Window 里打开页面 bsk observe --session <id> # 读取页面文本与控件 bsk session stop <id> # 总结完成，结束会话

两个细节值得记住：

• navigate开的是独立窗口，你眼前的标签栏纹丝不动
• observe拿到的文本、按钮等控件都带@eN编号，AI 之后点击、输入全靠它

AI 把总结交到你手上，整条链路就跑通了。

Agent Window 如何保证不打断你浏览

核心是 Agent Window（Agent 窗口）机制：每个bsk会话自动开一个独立、可见的浏览器窗口，AI 被限定在里面活动。它想碰你已打开的标签页？必须走借用流程，而且要你确认：

bsk tab borrow <tab-id> --session <id> # 借用，需你确认 bsk tab return <tab-id> --session <id> # 用完归还

请求链路长这样：bskCLI → 本地 daemon（守护进程，默认监听 52800 端口）→ WebSocket → 浏览器扩展 → Agent Window。扩展弹窗里显示的端口要和 daemon 对上，这也是bsk doctor会检查的一项。

想抠细节的话，docs/architecture.md 里有完整的组件图。

observe 之后还能做什么：常用操作速查

跑通首次任务后，下面这几条是你最常用的。@eN来自上一次observe的结果，AI 会自动维护，你只需用自然语言描述目标：

排障要点与延伸配置

几个高频问题和对策：

• doctor 报扩展未连接：打开扩展弹窗，确认端口和 daemon 一致（默认 52800），重新启用连接
• AI 找不到 browser-skill 技能：重启 AI 会话，技能在会话启动时加载
• 浏览器支持范围：Chrome、Edge 为官方支持，Firefox 还在规划中

完整命令说明在 crates/bsk-cli/skill/SKILL.md。第一个任务跑顺之后，可以试试让 AI"打开这个网站，整理今天的最新动态并发我摘要"——长截图完整用法看 docs/long-screenshot.md，让 AI 助手代你完成整套安装则参考 AGENT_INSTALL.md，照着玩就行。

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