@sidereus-ai/browser

基于 Playwright 构建的命令行浏览器守护进程，专为大语言模型代理和终端用户设计。

安装

npm install -g @sidereus-ai/browser
npx playwright install chromium

使用方法

命令行工具名为 SB。

1. 启动守护进程

首先，启动管理浏览器实例的后台服务。

SB up

2. 启动浏览器会话

创建一个新的浏览器工作进程。默认情况下，它以无头模式（后台）运行。

# 在后台启动（默认）
SB start

# 在后台启动并与特定目录关联
SB start --workdir /path/to/project

# 启动并显示浏览器窗口（前台）
SB start --show

3. 导航与提取内容

让浏览器访问指定的 URL。此命令会生成三个文件：页面的完整HTML内容（page.html）、页面的无障碍树结构（page.yaml）和页面的Markdown格式内容（page.md）。

# 访问网页并生成内容文件
SB goto google.com

# 目标特定工作进程
SB goto google.com --workdir /path/to/project

4. 页面交互

在页面上执行交互操作，如点击元素、填充表单、按键等。每次操作后同样会更新生成的三个内容文件。

# 点击元素
SB click <selector>

# 填充输入框
SB fill <selector> <text>

# 按键操作
SB press <key>

# 选中复选框
SB check <selector>

# 取消选中复选框
SB uncheck <selector>

# 下载点击
SB download-click <selector>

5. 会话管理

# 列出活跃的工作进程
SB ps

# 停止一个工作进程
SB stop [--workdir path]

# 停止所有工作进程
SB stop --all

6. 技能文档

显示技能和使用指南，可输出到标准输出或保存到指定位置。

# 直接输出到标准输出（默认行为）
SB skills

# 保存到默认位置 (skills/SB/skills.md)
SB skills --target DEFAULT

# 保存到 QWEN 位置 (.qwen/skills/SB/SKILL.md)
SB skills --target QWEN

# 保存到自定义位置 (如 .custom/skills/SB/SKILL.md)
SB skills --target custom

# 结合工作流程指南
SB skills --workflow crawl
SB skills --target QWEN --workflow crawl

7. 关闭

停止守护进程和所有运行中的浏览器。

SB down

架构

• 守护进程：在后台运行，监听 IPC 命令。
• 工作进程：包装 Playwright 实例的子进程。
• 命令行接口：向守护进程发送命令。