BrowserSkill 安装与实战教程AI Agent 浏览器自动化驱动你已登录浏览器的 4 步路径【免费下载链接】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 Agent 做浏览器自动化——打开页面、填表单、读取内容——但不想导出 Cookie不想它动你正在用的标签页也不想备一套测试账号。BrowserSkill 是 bsk CLI 加一个浏览器扩展的组合它驱动你真实登录状态的浏览器全部任务收进独立的 Agent Window。先跑起来bsk 安装与第一个任务这一节回答从零到能用要几步。本地自动化需要三样东西bsk CLIdaemon 与 CLI 是同一个二进制、浏览器扩展、skill。bsk是统一入口任何能跑 shell 的 Agent 都可以接入DeepSeek Harness 另有插件提供原生browser_*工具。第 1 步装 CLI。clone 仓库后跑安装脚本默认装到~/.local/binWindows 用仓库里的install.ps1git clone https://gitcode.com/GitHub_Trending/br/BrowserSkill cd BrowserSkill sh install.sh自检在将要使用它的终端里跑bsk --version能输出版本号即成功。注意export PATH只对当前 shell 生效正在运行的 Agent 可能要重启一次才能找到新命令。第 2 步加载扩展。在 Chrome Web Store 或 Edge Add-ons 搜索 BrowserSkill 安装要求 Chromium 125打开弹窗开启本地连接。自检弹窗状态显示已连接 READY。第 3 步装 skill 并体检。skill 负责教会你的 harness 怎么调用bskbsk install-skill用 Space 选目标 harness、Enter 确认脚本环境可写bsk install-skill --harness cursor --json。随后跑bsk doctor并按提示解决所有失败项。预期结果连接链路无失败项但 doctor 通过不代表 skill 生效这一点要在新会话里单独确认。第 4 步第一个任务怎么跑。手动 CLI 是最短路径bsk session start --no-focus --json bsk navigate https://example.com --session id bsk observe --session id bsk session stop idid取session start返回的会话 ID。预期结果浏览器弹出一个独立 Agent Window 并打开 example.comobserve输出页面文本结构stop后会话结束、借出的标签页自动回到原窗口。交给 Agent 时直接说用 browser-skill 打开 example.com 并总结页面即可。两个部署场景沙箱里 daemon 怎么放远程怎么连这一节解决Agent 不在你桌面上跑时daemon 放哪、IPC 怎么共享。两种变体核心问题相同。沙箱化 Agentbubblewrap 式 Bash 沙箱等如果沙箱在每条命令结束后收割后台进程daemon 必须留在持久的宿主环境沙箱内只走共享的本地 IPC。所有命令统一带这两个环境变量因为 env 不一定跨 shell 保留BSK_HOME/absolute/shared/bsk BSK_AUTO_START0 bsk status --json自检status 正常返回就复用该 daemonbrowsers列表为空只代表扩展还没连上不需要另起 daemon。daemon 缺失时换到沙箱外的持久后台任务里执行bsk daemon start --foreground。遇到权限错误或超时先查路径与 IPC 权限——这类错误不能证明 daemon 不存在。完整流程见沙箱文档。Agent 跑在远程服务器登录态留在你的电脑CLI 与 daemon 放服务器扩展主动向服务器发起 WSS 连接你的电脑不需要开任何入站端口。启动带认证的服务器bsk daemon start --mode server \ --listen 0.0.0.0 --port 52800 \ --public-url wss://域名/extension预期结果扩展与该端点完成 WSS 配对。记得在 Agent 环境设置BSK_AUTO_START0防止隐式拉起覆盖托管的服务器实例。配对、凭据续期与吊销的完整说明见远程连接文档。你的浏览器为什么是安全的开关、借用与 Cookie 隔离这一节回答Agent 在你的浏览器里活动的边界在哪。边界可以压缩成一句话任务只在独立 Agent Window 里执行要触碰你已有的标签页必须走显式借用用完自动回原窗口。Cookie 与登录态始终留在你的 profile 里远程设备只在私有BSK_HOME存凭据哈希。每个会话的权威配置是浏览器里保存的值。扩展弹窗提供两个相互独立的 Automation settings默认都开开关开启默认关闭后借用标签页前确认Agent 触碰你的标签页前先请求批准跳过确认直接借用允许请求人工帮助request-help弹出接管 UI求助请求直接返回disabled不确认任何人工动作什么时候值得关确认批量跑任务且 Agent 只操作 Agent Window 内标签页或者 Agent 反复借用同一个标签页你不想每次都被弹窗打断。⚠️disabled不代表任务完成也不授予任何额外权限关闭开关会释放挂起的借用确认、以disabled结束挂起的求助但已完成的操作不会回滚。人机协作的另一点是request-helpAgent 卡在验证码、登录这类只有人能过的步骤时发起求助你接管操作它随后自动继续。事后可追溯也值得知道可选的操作审计默认关闭记录任务元数据网站调试能把请求、Console、性能证据导出为 JSON。一次点击背后CLI、daemon 与扩展的调用链这一节拆开一条bsk click e1的完整路径。三端分工bskCLI解析子命令经本地 IPC 找到 daemonUnix 下是$BSK_HOME/run/daemon.sockWindows 为命名管道默认 home 是~/.bskbsk daemon在回环 WebSocket默认端口 52800上等待扩展连接维护浏览器与两个会话表按会话串行化调用扩展WXT/MV3收到tool.*RPC 后经 dispatcher 走 CDP在 Agent Window 内执行。链路上有几个约束直接影响你怎么写任务沙箱约束写工具只接受 Agent Window 内的标签页或从用户 profile 显式借出的标签页页面自己弹出的弹窗不会自动获得控制权。会话隔离一个会话 一个不透明 ID 一个专属 Agent Window 独立的 ref 存储多会话互不串台。并发策略同一会话的 RPC 由 daemon 串行化保证 ref 存储安全不同会话并行。连了多个浏览器时用session start --browser id指定。生命周期空闲超时默认 5 分钟只是安全网任务结束必须显式bsk session stop。连接安全本地模式的 WebSocket 只绑回环升级时校验扩展 origin。源码地图关键目录一句话清单这一节给想读源码的人一份最小导航。仓库是 Cargo pnpm 双 workspacecrates/bsk-cli/— CLI 子命令、本地 daemonskill 包与安装逻辑都在这里crates/bsk-protocol/— 共享的 Rust 线格式类型与 JSON Schema 生成apps/extension/— WXT/MV3 扩展transport、二十余个工具处理器、session-manager 与 CDP 驱动packages/dsh-plugin-browserskill/— DeepSeek Harness 插件自带 skill 与browser_*工具evals/browser/— 确定性的、Agent 无关的浏览器能力评估用例。更完整的系统视图见架构文档。升级与避坑更新命令和已废弃参数这一节罗列升级时最可能踩的四个点。一条命令更新bsk update --yesWindows 出现 staged update 提示时等替换完成再核对bsk --version。三端版本匹配扩展走商店更新发布可能滞后于 CLI整页截图等新功能要求 CLI、daemon、扩展三端版本一致。用bsk --versionbsk status核对再跑bsk doctor。废弃参数0.3.0 起--unattended、tab borrow --no-confirm、BSK_REQUEST_HELPoff不能再绕过确认或禁用求助一律改用扩展里的 Automation settings。skill 同步托管的 skill 在 daemon 启动、session start、doctor时自动同步你本地编辑过或自定义的 skill 会被保留。更新后启动新 Agent 会话加载新指令变更明细见 CHANGELOG。BrowserSkill 以 MIT 许可证开源。装好之后建议拿它跑一次真实站点的完整任务盯着 Agent Window 看每一跳操作——这是建立对这套工具边界感最快的方式。【免费下载链接】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），仅供参考 
长河君 · 2026/10/14 6:13:40 · 阅读 1.2k BrowserSkill 安装与实战教程：AI Agent 浏览器自动化驱动你已登录浏览器的 4 步路径
BrowserSkill 安装与实战教程AI Agent 浏览器自动化驱动你已登录浏览器的 4 步路径【免费下载链接】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 Agent 做浏览器自动化——打开页面、填表单、读取内容——但不想导出 Cookie不想它动你正在用的标签页也不想备一套测试账号。BrowserSkill 是 bsk CLI 加一个浏览器扩展的组合它驱动你真实登录状态的浏览器全部任务收进独立的 Agent Window。先跑起来bsk 安装与第一个任务这一节回答从零到能用要几步。本地自动化需要三样东西bsk CLIdaemon 与 CLI 是同一个二进制、浏览器扩展、skill。bsk是统一入口任何能跑 shell 的 Agent 都可以接入DeepSeek Harness 另有插件提供原生browser_*工具。第 1 步装 CLI。clone 仓库后跑安装脚本默认装到~/.local/binWindows 用仓库里的install.ps1git clone https://gitcode.com/GitHub_Trending/br/BrowserSkill cd BrowserSkill sh install.sh自检在将要使用它的终端里跑bsk --version能输出版本号即成功。注意export PATH只对当前 shell 生效正在运行的 Agent 可能要重启一次才能找到新命令。第 2 步加载扩展。在 Chrome Web Store 或 Edge Add-ons 搜索 BrowserSkill 安装要求 Chromium 125打开弹窗开启本地连接。自检弹窗状态显示已连接 READY。第 3 步装 skill 并体检。skill 负责教会你的 harness 怎么调用bskbsk install-skill用 Space 选目标 harness、Enter 确认脚本环境可写bsk install-skill --harness cursor --json。随后跑bsk doctor并按提示解决所有失败项。预期结果连接链路无失败项但 doctor 通过不代表 skill 生效这一点要在新会话里单独确认。第 4 步第一个任务怎么跑。手动 CLI 是最短路径bsk session start --no-focus --json bsk navigate https://example.com --session id bsk observe --session id bsk session stop idid取session start返回的会话 ID。预期结果浏览器弹出一个独立 Agent Window 并打开 example.comobserve输出页面文本结构stop后会话结束、借出的标签页自动回到原窗口。交给 Agent 时直接说用 browser-skill 打开 example.com 并总结页面即可。两个部署场景沙箱里 daemon 怎么放远程怎么连这一节解决Agent 不在你桌面上跑时daemon 放哪、IPC 怎么共享。两种变体核心问题相同。沙箱化 Agentbubblewrap 式 Bash 沙箱等如果沙箱在每条命令结束后收割后台进程daemon 必须留在持久的宿主环境沙箱内只走共享的本地 IPC。所有命令统一带这两个环境变量因为 env 不一定跨 shell 保留BSK_HOME/absolute/shared/bsk BSK_AUTO_START0 bsk status --json自检status 正常返回就复用该 daemonbrowsers列表为空只代表扩展还没连上不需要另起 daemon。daemon 缺失时换到沙箱外的持久后台任务里执行bsk daemon start --foreground。遇到权限错误或超时先查路径与 IPC 权限——这类错误不能证明 daemon 不存在。完整流程见沙箱文档。Agent 跑在远程服务器登录态留在你的电脑CLI 与 daemon 放服务器扩展主动向服务器发起 WSS 连接你的电脑不需要开任何入站端口。启动带认证的服务器bsk daemon start --mode server \ --listen 0.0.0.0 --port 52800 \ --public-url wss://域名/extension预期结果扩展与该端点完成 WSS 配对。记得在 Agent 环境设置BSK_AUTO_START0防止隐式拉起覆盖托管的服务器实例。配对、凭据续期与吊销的完整说明见远程连接文档。你的浏览器为什么是安全的开关、借用与 Cookie 隔离这一节回答Agent 在你的浏览器里活动的边界在哪。边界可以压缩成一句话任务只在独立 Agent Window 里执行要触碰你已有的标签页必须走显式借用用完自动回原窗口。Cookie 与登录态始终留在你的 profile 里远程设备只在私有BSK_HOME存凭据哈希。每个会话的权威配置是浏览器里保存的值。扩展弹窗提供两个相互独立的 Automation settings默认都开开关开启默认关闭后借用标签页前确认Agent 触碰你的标签页前先请求批准跳过确认直接借用允许请求人工帮助request-help弹出接管 UI求助请求直接返回disabled不确认任何人工动作什么时候值得关确认批量跑任务且 Agent 只操作 Agent Window 内标签页或者 Agent 反复借用同一个标签页你不想每次都被弹窗打断。⚠️disabled不代表任务完成也不授予任何额外权限关闭开关会释放挂起的借用确认、以disabled结束挂起的求助但已完成的操作不会回滚。人机协作的另一点是request-helpAgent 卡在验证码、登录这类只有人能过的步骤时发起求助你接管操作它随后自动继续。事后可追溯也值得知道可选的操作审计默认关闭记录任务元数据网站调试能把请求、Console、性能证据导出为 JSON。一次点击背后CLI、daemon 与扩展的调用链这一节拆开一条bsk click e1的完整路径。三端分工bskCLI解析子命令经本地 IPC 找到 daemonUnix 下是$BSK_HOME/run/daemon.sockWindows 为命名管道默认 home 是~/.bskbsk daemon在回环 WebSocket默认端口 52800上等待扩展连接维护浏览器与两个会话表按会话串行化调用扩展WXT/MV3收到tool.*RPC 后经 dispatcher 走 CDP在 Agent Window 内执行。链路上有几个约束直接影响你怎么写任务沙箱约束写工具只接受 Agent Window 内的标签页或从用户 profile 显式借出的标签页页面自己弹出的弹窗不会自动获得控制权。会话隔离一个会话 一个不透明 ID 一个专属 Agent Window 独立的 ref 存储多会话互不串台。并发策略同一会话的 RPC 由 daemon 串行化保证 ref 存储安全不同会话并行。连了多个浏览器时用session start --browser id指定。生命周期空闲超时默认 5 分钟只是安全网任务结束必须显式bsk session stop。连接安全本地模式的 WebSocket 只绑回环升级时校验扩展 origin。源码地图关键目录一句话清单这一节给想读源码的人一份最小导航。仓库是 Cargo pnpm 双 workspacecrates/bsk-cli/— CLI 子命令、本地 daemonskill 包与安装逻辑都在这里crates/bsk-protocol/— 共享的 Rust 线格式类型与 JSON Schema 生成apps/extension/— WXT/MV3 扩展transport、二十余个工具处理器、session-manager 与 CDP 驱动packages/dsh-plugin-browserskill/— DeepSeek Harness 插件自带 skill 与browser_*工具evals/browser/— 确定性的、Agent 无关的浏览器能力评估用例。更完整的系统视图见架构文档。升级与避坑更新命令和已废弃参数这一节罗列升级时最可能踩的四个点。一条命令更新bsk update --yesWindows 出现 staged update 提示时等替换完成再核对bsk --version。三端版本匹配扩展走商店更新发布可能滞后于 CLI整页截图等新功能要求 CLI、daemon、扩展三端版本一致。用bsk --versionbsk status核对再跑bsk doctor。废弃参数0.3.0 起--unattended、tab borrow --no-confirm、BSK_REQUEST_HELPoff不能再绕过确认或禁用求助一律改用扩展里的 Automation settings。skill 同步托管的 skill 在 daemon 启动、session start、doctor时自动同步你本地编辑过或自定义的 skill 会被保留。更新后启动新 Agent 会话加载新指令变更明细见 CHANGELOG。BrowserSkill 以 MIT 许可证开源。装好之后建议拿它跑一次真实站点的完整任务盯着 Agent Window 看每一跳操作——这是建立对这套工具边界感最快的方式。【免费下载链接】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），仅供参考