企业官网建设流程全解析

BrowserSkill 快速上手：让 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

让 Agent 帮忙打开网页、总结内容，它又卡在登录墙上——要么自建测试账号，要么眼睁睁看着它等你输密码。BrowserSkill 是解决这个问题的本地桥接层：把 AI Agent 接到你日常在用的 Chrome 或 Edge 上，直接复用现有登录态。Agent 干活期间，你在自己的窗口里继续写文档、看消息，互不干扰。

一分钟搞懂它

一句话：BrowserSkill = 本机的bsk命令行工具（内含常驻后台的 daemon 服务）+ 一个浏览器扩展。前者是 Agent 的唯一入口，后者负责在浏览器里真正动手。

• CLI / daemon：跑在 macOS（Apple Silicon 与 Intel）、Linux（x64 与 ARM64）、Windows x64 上，装好即用，不需要别的常驻服务。
• 浏览器扩展：Chrome、Microsoft Edge 已适配，基于 Chromium 125 及以上；其他 Chromium 内核浏览器一般可用，Firefox 在计划中。
• 前置依赖：一个能执行 Shell 命令的 AI Agent——Cursor、Claude Code、Codex 都可以。没有 SDK，没有模型绑定，bsk就是它的 API。

代价是边界被写死：只做操作，绝不提取凭据、Cookie 或 Token。

装好它的最快路径

1. 装 CLI。macOS / Linux 在终端执行：

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

   Windows 用 PowerShell：

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

   二进制默认落在~/.local/bin，bsk --version能输出版本号即成功。

2. 装扩展。从 Chrome Web Store 或 Edge 加载项商店安装 BrowserSkill，打开弹窗启用本地连接。

3. 把操作手册（skill）交给 Agent，让它知道怎么调bsk：

   bsk install-skill --harness cursor --json

   把cursor换成你的 harness ID；全部选项用bsk install-skill --list查看。

4. 体检：运行bsk doctor，按提示处理警告与失败项，直到扩展弹窗显示已连接。

最容易踩的坑：正在运行的 Agent 会缓存旧 PATH。装完 CLI 后重启一次 Agent，否则它会报"找不到bsk"。

跟着敲一遍

场景一：打开网页并总结

一个会话的完整生命周期是start → 干活 → stop。

bsk session start --json

返回session_id，后续所有命令都要带它。

bsk navigate https://example.com --session <id>

页面在独立的 Agent Window 里打开，不会占用你正在看的窗口。

bsk observe --session <id>

返回页面文本和形如@e3的元素引用（ref），这是后续交互的坐标。规则只有一条：导航或页面结构大变更后，重新observe拿新鲜引用再动作。

bsk click @e3 --session <id>

拿到结果后，重新observe验证效果，别盲目重试。

bsk session stop <id>

无论任务成败都应显式关闭，不要指望空闲自动清理。

场景二：借用你自己的标签页

Agent 默认只碰 Agent Window 内的页面。要操作你已打开的标签，先列出来再借：

bsk tab list --scope user --session <id> bsk tab borrow <tab-id> --session <id>

借用默认等你确认 60 秒（--timeout 120s可改，需 daemon 与扩展协议版本 1.2 及以上）。

卡住时可以喊人，比如登录、验证码、支付确认：

bsk request-help --session <id> --prompt "Please complete sign-in" --target @e3

做完相关操作立即bsk tab return <tab-id> --session <id>，别让用户的标签页跨任务滞留。

顺手带走的能力

链路长什么样

Agent 从头到尾不直接碰浏览器，整条链路严格分层：

两处反直觉的设计值得知道：CLI 侧工具调用的 IPC 超时设为 35 秒，刻意比 daemon 侧工具超时略长，这样调用方收到的是结构化超时响应，而不是连接莫名断开；session start会先自动拉起 daemon，并等待扩展重连最多 35 秒才放行请求。线上协议类型与每个工具的参数/结果契约全部集中在 crates/bsk-protocol/schema/，扩展端实现位于 apps/extension/src/。

谁该用，下一步看什么

如果你的 Agent 需要操作真实网站（后台系统、电商、SaaS），不想维护一套测试账号，还希望全程可见、可控、可中途接管，它就是为此设计的；纯无头批量抓取则别用，它的人机协作取向会拖慢你。

• Agent 自助安装指引：把一句话发给 Agent，它自己装好 CLI 和 skill
• 长截图说明
• 沙盒环境说明：沙盒会回收后台进程时，如何在宿主侧托管 daemon

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