BrowserSkill 浏览器自启动器

要解决的具体问题

当使用 BrowserSkill（简称 bsk）进行网页抓取或浏览器自动化时，一个常见的前置条件是本机 Edge 浏览器已开启，且 BrowserSkill 扩展已连接到本地 daemon。对于定时任务、CI/CD 流程或任何无人值守的自动化场景，这个依赖人工操作的“启动浏览器”步骤就构成了一个阻断点。脚本常因 browsers connected 0 或 no browser is connected to the daemon 错误而失败，导致整个自动化流水线中断。

技能如何工作

BrowserSkill 浏览器自启动器 的核心能力是让浏览器在自动化任务中变为“自可用”。它是一个纯管控组件，不包含任何业务逻辑（如登录、数据处理）。其工作流程封装在 scripts/launch_browser.py 脚本中，关键步骤如下：

1. 连接探测：首先调用 bsk status 命令，检测是否有浏览器实例已连接到 daemon。
2. 条件启动：如果探测到无浏览器连接，脚本会自动启动本机已安装的 Microsoft Edge 浏览器。由于 BrowserSkill 扩展被设置为随浏览器启动，它会自动连接 daemon。
3. 就绪等待：启动后，脚本进入轮询循环（默认最多等待40秒，可通过 --wait 参数调整），持续检查浏览器连接状态。
4. 结果反馈：连接成功后，脚本以退出码 0 退出，并打印确认信息。若指定了 --start-session 参数，还会输出新建会话的 SESSION= 标识，便于下游任务直接使用。

它通过一套清晰的退出码与调用方约定处理方式：

• 0：浏览器就绪，可继续执行抓取或自动化。
• 3：连接超时失败，调用方应考虑降级策略（如改用 WebFetch）或标记任务。
• 4：会话创建失败，可尝试重试。

适用边界与注意点

本技能是通用的“启动器”，适用边界明确：

• 职责单一：只负责拉起浏览器并确保连接，不关心具体抓取什么数据、发布到哪里。任何基于 bsk 的抓取 skill 或自动化任务，都应将其作为前置调用环节。
• 环境依赖：依赖本机 Edge 浏览器路径（通常为 C:/Program Files (x86)/Microsoft/Edge/...）和 bsk 守护进程（~/.local/bin/bsk.exe）。在非标准环境下需确认路径。
• 无状态与安全：脚本不包含任何业务凭证（如 appid/appsecret），纯做浏览器生命周期管理，可安全发布。
• 异步连接处理：浏览器启动后，扩展连接是异步的，launch_browser.py 内部的轮询机制已处理此问题，调用方无需自行编写 sleep 逻辑。

总之，它是一个基础依赖库，旨在消除自动化任务中繁琐且易出错的手动环境准备步骤，让开发者更专注于业务逻辑本身。