BrowserSkill 完整上手指南3 条路径让 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 就是为这类痛点设计的它是 Agent 与真实浏览器之间的本地桥接层让 Cursor、Claude Code、Codex、OpenClaw 等任意能调用 Shell 的 Agent直接操作你已经登录的浏览器。任务跑在独立的 Agent Window 里不打断你的日常浏览需要碰你已打开的标签时它先显式借用、用完归还其余窗口不受影响。项目定位与适用对象一句话BrowserSkill 是bskCLI/daemon 与浏览器扩展组成的本地桥接层负责把你手里的 Agent 接到你已登录的浏览器上。适合你正在用任意能调用 Shell 的 AgentCursor、Claude Code、Codex、OpenClaw、CodeBuddy、WorkBuddy、Pi、Hermes Agent 等想让它们读取、填写、点击、截图你已登录的网站但不想为此维护测试账号也不想被打断工作。不适合需要完全隔离、无登录态的干净环境——Agent Window 共享所选 Profile 的登录态不是独立账号也不是安全沙盒。关键约束它绝不提取凭据、Cookie、Token 等敏感信息也不收集产品遥测。组件支持范围CLI / daemonmacOSApple Silicon、Intel、Linuxx64、ARM64、Windows x64浏览器扩展Chromium 125 的 Chrome、Microsoft Edge其他 Chromium 浏览器通常可用Agent 接入任意能调用 Shell 的 Agent配 BrowserSkill skillDeepSeek Harness 用专用插件动手前的准备开工前把这三件事确认清楚能避免 90% 的连接问题。本机环境macOS / Linux / Windows x64 任一即可Agent 所在的终端能找到bsk命令装完会提示更新PATH已启动的 Agent 记得重启或改用二进制绝对路径。浏览器扩展目标浏览器安装对应扩展Chrome 或 Edge并能在弹窗里看到已连接 / READY。沙盒特殊情况如果你的 Agent 沙盒会在每条命令结束后回收后台进程请先读 docs/sandboxed-agents.md——在宿主侧保持 daemon 存活沙盒内用共享的BSK_HOME和BSK_AUTO_START0连接。普通本地环境默认自动拉起 daemon无需额外配置。三条上手路径三条路径任选其一互不冲突选最贴合你习惯的。路径 A把一句话丢给 Agent让它自助安装把下面这句话发给你的 Agent它会按仓库自带的安装指引完成 CLI、skill 安装并引导你加载扩展按照 AGENT_INSTALL.md 的说明在本机安装并配置 browser-skill指引文件见 AGENT_INSTALL.md。你仍需手动在浏览器里装好扩展。验证点Agent 完成后bsk doctor全绿、扩展弹窗显示已连接且新开的 Agent 会话能发现browser-skill。doctor 通过不等于 Agent 已加载 skill需单独确认。路径 B手动安装 CLI 扩展 skillcurl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh bsk install-skillWindows PowerShell 用irm .../install.ps1 | iex。装完bsk install-skill按空格选择目标 harness、回车安装非交互可写bsk install-skill --harness cursor --json。然后从 Chrome / Edge 商店安装扩展并打开弹窗。验证点bsk --version有输出bsk doctor通过扩展显示已连接。路径 CDeepSeek Harness 专用插件在 DeepSeek Harnessdsh下不用装 skill直接装官方插件它会注入原生browser_*工具并在 Web UI 实时展示会话dsh plugin --profile web add wxg-prc-cpg/browser-skill-dsh-plugin dsh --profile web把web换成你的 profile 名。插件已内置browser-skill无需再跑bsk install-skill。验证点dsh启动后调用/browser-skill能描述任务并在 Web UI 看到浏览器任务预览。用法见 packages/dsh-plugin-browserskill/README.md。第一次跑通端到端最小流程连接成功后先让 Agent 打开一个页面并总结或直接敲下面四步。四步走通说明全链路可用。启动会话——bsk session start --json记下返回的session_id多浏览器时加--browser id。成功的样子拿到一个字符串形式的session_id。打开页面——bsk navigate https://example.com --session id。成功的样子Agent Window 打开该地址无报错。读取页面——bsk observe --session id。成功的样子返回页面文本与一组新鲜eNrefs。停止会话——bsk session stop id。成功的样子会话结束借用的标签被归还回原窗口。⚠️ 注意无论成功还是失败都执行第 4 步除非用户要求保留会话。不要靠空闲清理结束任务也不要用重启共享 daemon 来收尾。进阶场景场景一借用你已打开的标签页Agent 要操作你已打开的页面时必须显式借用相关步骤一结束立即归还bsk tab list --scope user --session id bsk tab borrow tab-id --session id bsk tab return tab-id --session id像借书-还书借来的标签在 Agent Window 里成为后续命令的默认目标用完归还原窗口。精确地说tab borrow只在该窗口中选择该标签作为默认目标不额外聚焦窗口后台创建的标签tab create --no-active要自己保存tab_id并在命令里显式传--tab-id。不要编造 tab ID也不要让用户标签跨无关任务保留。场景二无人值守与人工接管插件弹窗有两个默认开启、相互独立的开关借用标签页前确认和允许请求人工协助。浏览器里保存的设置对已有和新建会话都有最终决定权。需要人处理登录、验证码、支付确认等步骤或两次尝试无进展时请求接管bsk request-help --session id --prompt Please complete sign-in --target e3。返回continued/completed→ 重新 observe用新 refs 继续返回cancelled/timed_out→ 尊重拒绝不重复请求返回disabled→ 没人真的操作过重新 observe 并遵循禁用协助规则。关闭人工协助后request-help返回disabled不代表步骤已完成。此时 Agent 应利用现有登录态、已授权输入和可行替代方案继续推进纯手机扫码、人脸、缺失短信码、纯文本模型识别不了的图形验证码可如实报告受阻但别因此把任务判为完成或受阻。⚠️ 注意--unattended、tab borrow --no-confirm、BSK_REQUEST_HELPoff这些旧参数只保留兼容识别、已弃用不能覆盖插件开关。需要后台打开窗口用session start --no-focus。场景三服务器上的 Agent 操作本地浏览器Agent、CLI、daemon 都跑在服务器上浏览器留在你本机。扩展主动发起出站 WSS 连接本机无需开放入站端口任务仍走独立 Agent Window 和借用-归还流程。bsk daemon start --mode server \ --listen 0.0.0.0 --port 52800 \ --public-url wss://browser.example.com:52800/extension \ --tls-cert /etc/bsk/fullchain.pem --tls-key /etc/bsk/privkey.pem配对验证按生成链接 → 服务器列出已连浏览器 → 测试会话读页并成功停止的证据链走服务器侧BSK_AUTO_START0 bsk daemon pair生成一次性链接默认 5 分钟过期浏览器弹窗选Remote connection粘贴保存再用BSK_AUTO_START0 bsk status --json确认目标浏览器出现最后以其中的instance_id启动会话读页。启动参数默认值含义--pairing-ttl5m一次性配对有效期最多 1 小时--device-ttl90d设备凭据寿命最多 366 天--renew-after30d扩展应续期时间点须小于设备寿命--max-connections64在线浏览器容量1–1000⚠️ 注意证书主机名必须与公网 URL 匹配bsk不签发证书、不改浏览器信任BSK_HOME是私有目录含设备授权须跨重启持久化不要在多台独立服务器或不受信任的用户间共享。远程模式暂不支持上传/下载返回unsupported。详见 docs/remote-extension-connection.md。亮点特性整页长截图长页面要留档时最烦的就是手动滚动拼接、内存还容易爆。BrowserSkill 的整页长截图从顶部增量滚动、按重叠视口拼接边滚边等加载稳定完成后恢复原始滚动位置新捕获是一组 512px 高的 PNG 瓦片存在扩展的 OPFS 里配合专用 worker 流式编码避免构建整图缓冲基准里 3170×100062 像素的页面RGBA 缓冲峰值仅约 41.7 MiB而整图需约 1.27 GB。让 Agent 直接截取当前会话页面bsk screenshot --session id --full-page --out page.png默认采集/编码超时两分钟长页面加--timeout 5m--scope current只捕获开始时测量的区域。⚠️ 注意需要 CLI 与扩展版本匹配更新 CLI 后跑bsk daemon restart嵌套滚动面板和虚拟化列表不受支持。更多模式自动/我滚动/可见区域与存储细节见 docs/long-screenshot.md。它到底怎么工作Agent 不直接碰浏览器整条链路被严格分层bsk session start通过ensure_daemon自动拉起 daemon再发类型化 RPCdaemon 侧会持有session.start直到扩展重连上才放行。线上协议类型与每个工具的参数/结果 JSON Schema 集中在 crates/bsk-protocolschema/下能找到tool_session_start_params.json、tool_navigate_params.json、tool_observe_params.json等契约。扩展端在 apps/extension/src 实现浏览器自动化、录制、长截图、审计等模块。各模块一句话职责crates/bsk-cli 是 CLI daemon 内置 skillcrates/bsk-protocol 是共享协议与 Schemaapps/extension 是浏览器自动化与调试工作区packages/dsh-plugin-browserskill 是 DeepSeek Harness 集成packages/ui、packages/i18n、packages/vom 是共享 UI、多语言与页面观察evals/browser 是本地浏览器能力评测台。常见问题问升级后某些行为变了 / 提示旧参数无效bsk update --yes会先装新版并重启运行中的 daemon若你手动替换了二进制补一句bsk daemon restart。--unattended、tab borrow --no-confirm、BSK_REQUEST_HELPoff从 0.3.0 起不再能关闭确认或人工协助改到插件弹窗里开关。问为什么request-help或借用等待时间不生效自定义借用等待时间、新版request-help都要求 daemon 与扩展协议版本够高前者需 1.2request-help需 1.3。版本不匹配时只限制当次操作并提示升级不会断开连接。用bsk --version、bsk status、bsk doctor核对 CLI、daemon、扩展三方版本一致。问我改了 skill 文件为什么它不再自动更新受管 skill 只在文件内容仍与上次安装/同步一致时自动同步检测到本地编辑就保留文件、暂停更新doctor会给出WARN与恢复方法。想恢复内置并重新启用更新bsk install-skill --harness name --force不带--source。问浏览器设置和命令行参数冲突时听谁的浏览器里保存的开关拥有最终决定权对已有和新建会话都生效旧参数只保留兼容识别、不能覆盖。偏好读取失败时 daemon 保留已有有效值、不写回默认也不阻止新建会话。问断开连接 / 停止会话会丢数据或删记录吗停止或断开会取消任务工作、归还借用标签、关闭任务创建的标签但你手动创建的标签存活。已保存的网站调试历史、审计记录不会被删各自 30 天后过期远程模式暂不支持上传/下载。本项目采用 MIT 许可证。更多细节见 docs/ 下的架构、长截图、远程连接、scroll-to 与沙盒配置说明。【免费下载链接】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辅助生成（AIGC），仅供参考