@xbrowser/cli 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # xbrowser
 
-> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 35+ commands, 67+ plugins. A command-line alternative to Playwright, Puppeteer, and Selenium — **no code required**.
+> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 49 commands, 69 plugins. A command-line alternative to Playwright, Puppeteer, and Selenium — **no code required**.
 
 [![CI Status](https://github.com/dyyz1993/xbrowser/workflows/CI/badge.svg)](https://github.com/dyyz1993/xbrowser/actions)
 [![codecov](https://codecov.io/gh/dyyz1993/xbrowser/branch/master/graph/badge.svg)](https://codecov.io/gh/dyyz1993/xbrowser)
@@ -9,7 +9,7 @@
 
 ## 特性
 
-- **35+ 浏览器命令** — 导航、交互、查询、存储、截图，覆盖常见自动化场景
+- **49 浏览器命令** — 导航、交互、查询、存储、截图，覆盖常见自动化场景
 - **命令链** — 用 `&&`、`,`、`+`、`->`、`;` 串联多个命令，一行搞定复杂流程
 - **管道 & Heredoc** — 支持 stdin 管道和 heredoc 批量执行
 - **录制 / 回放** — 录制浏览器操作为 YAML，随时回放，可转换为 JS/Python/Bash 脚本
@@ -71,7 +71,7 @@ npm install -g @xbrowser/cli
 
 ```bash
 # 打开浏览器，导航到页面
-xbrowser session open https://example.com
+xbrowser goto https://example.com
 
 # 获取页面标题
 xbrowser title
@@ -89,7 +89,7 @@ xbrowser session close
 
 ### 单行命令链
 
-不需要先 `session open`，命令链会自动启动浏览器并在执行完毕后关闭：
+会话会自动创建，命令链会自动启动浏览器并在执行完毕后关闭：
 
 ```bash
 # 用逗号分隔
@@ -178,19 +178,17 @@ xbrowser --cdp auto "goto https://example.com , title"
 
 | 命令 | 说明 | 示例 |
 |------|------|------|
-| `session open <url>` | 打开浏览器并创建会话 | `xbrowser session open https://example.com` |
-| `session open <url> --name work` | 以指定名称创建会话 | `xbrowser session open https://example.com --name work` |
 | `session close` | 关闭当前会话 | `xbrowser session close` |
-| `session close --name work` | 关闭指定会话 | `xbrowser session close --name work` |
+| `session close --session work` | 关闭指定会话 | `xbrowser session close --session work` |
 | `session close --all` | 关闭所有会话 | `xbrowser session close --all` |
 | `session list` | 列出所有活跃会话 | `xbrowser session list` |
-| `session kill [--name <n>]` | 强制终止会话 | `xbrowser session kill --name work` |
+| `session kill [--session <n>]` | 强制终止会话 | `xbrowser session kill --session work` |
 
 ### 页面导航
 
 | 命令 | 说明 | 示例 |
 |------|------|------|
-| `goto <url>` | 导航到指定 URL | `xbrowser goto https://example.com` |
+| `goto <url>` / `open <url>` | 导航到指定 URL | `xbrowser goto https://example.com` |
 | `goto <url> --waitUntil networkidle` | 指定等待条件 | `xbrowser goto https://example.com --waitUntil networkidle` |
 | `back` | 浏览器后退 | `xbrowser back` |
 | `forward` | 浏览器前进 | `xbrowser forward` |
@@ -314,15 +312,6 @@ xbrowser --cdp auto "goto https://example.com , title"
 | `setViewport <width> <height>` | 设置视口大小 | `xbrowser setViewport 1920 1080` |
 | `setViewport 375 812 --isMobile true` | 移动设备模式 | `xbrowser setViewport 375 812 --isMobile true` |
 
-### Daemon 进程
-
-| 命令 | 说明 | 示例 |
-|------|------|------|
-| `daemon start` | 启动 daemon | `xbrowser daemon start` |
-| `daemon start --port 9223` | 指定端口启动 | `xbrowser daemon start --port 9223` |
-| `daemon stop` | 停止 daemon | `xbrowser daemon stop` |
-| `daemon status` | 查看 daemon 状态 | `xbrowser daemon status` |
-
 ### 配置管理
 
 | 命令 | 说明 | 示例 |
@@ -458,7 +447,7 @@ project > browser > page > element
 命令执行前会自动检查 Scope 是否满足。不满足时会提示：
 
 ```
-Error: 需要活跃的页面，请先执行 xbrowser session open <url>
+Error: 需要活跃的页面，请先执行 xbrowser goto <url>
 ```
 
 ## 插件系统
@@ -554,14 +543,14 @@ xbrowser 自带以下插件：
 
 ```bash
 # 百度搜索
-xbrowser session open https://www.baidu.com
+xbrowser goto https://www.baidu.com
 xbrowser baidu search --query "AI 编程"
 
 # 百度热搜
 xbrowser baidu hotsearch
 
 # GitHub 资料获取
-xbrowser session open https://github.com
+xbrowser goto https://github.com
 xbrowser github get-profile
 ```
 
@@ -570,8 +559,8 @@ xbrowser github get-profile
 ### 录制
 
 ```bash
-# 1. 打开会话
-xbrowser session open https://example.com
+# 1. 打开会话（自动创建）
+xbrowser goto https://example.com
 
 # 2. 开始录制
 xbrowser record start --url https://example.com
@@ -686,6 +675,8 @@ xbrowser filter raw.yaml clean.yaml --exclude hover_enter,hover_leave
 |------|------|--------|
 | `XBROWSER_CHROMIUM_PATH` | Chromium 可执行文件路径 | `/Applications/Chromium.app/Contents/MacOS/Chromium` |
 | `XBROWSER_DAEMON_PORT` | Daemon 端口 | `9222` |
+| `XBROWSER_CDP` | 默认 CDP 连接地址（可被 `--cdp` 覆盖） | — |
+| `XBROWSER_SESSION` | 默认会话名称（可被 `--session` 覆盖） | `default` |
 
 ### 命令行配置
 
@@ -812,7 +803,7 @@ done
 ### 示例 6：使用插件采集百度热搜
 
 ```bash
-xbrowser session open https://www.baidu.com
+xbrowser goto https://www.baidu.com
 xbrowser baidu hotsearch --category tech
 xbrowser session close
 ```
@@ -856,7 +847,7 @@ npm run validate
 ```
 xbrowser/
 ├── src/
-│   ├── commands/        # 35 个浏览器命令定义
+│   ├── commands/        # 49 个浏览器命令定义
 │   ├── builtins/        # CLI 内置命令（config, plugin, session, create）
 │   ├── recorder/        # 录制引擎（录制器 + 回放器）
 │   ├── session/         # 会话管理
@@ -885,7 +876,7 @@ xbrowser/
 | **Setup** | `npm i -g` — 0 config | Install + browser download | Install + browser download | Install + WebDriver + drivers |
 | **Web Scraping** | Built-in (`scrape`, `crawl`, `map`) | Write custom scripts | Write custom scripts | Write custom scripts |
 | **Search** | Built-in multi-engine (`search`) | No | No | No |
-| **Plugin Ecosystem** | 67+ plugins | Limited | Limited | No |
+| **Plugin Ecosystem** | 69 plugins | Limited | Limited | No |
 | **No Code Required** | ✅ CLI commands | ❌ Must write JS/TS | ❌ Must write JS/TS | ❌ Must write code |
 | **Headless Mode** | ✅ Default | ✅ | ✅ | ✅ |
 | **Record/Replay** | ✅ Built-in (`record`/`replay`) | ✅ Codegen | ❌ | ❌ |

package/dist/{browser-GURRY444.js → browser-GITRHHFO.js}

@@ -20,9 +20,10 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-E4O5ZU3H.js";
-import "./chunk-T4J4C2NZ.js";
-import "./chunk-3RG5ZIWI.js";
+} from "./chunk-QIK2I3VQ.js";
+import "./chunk-PPG4D2EW.js";
+import "./chunk-BBMRDUYQ.js";
+import "./chunk-KFQGP6VL.js";
 export {
   closeAllSessions,
   closeEphemeralContext,

package/dist/{browser-DSVV4GHS.js → browser-R56O3CW6.js}

@@ -20,9 +20,9 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-2BQZIT3S.js";
-import "./chunk-T4J4C2NZ.js";
-import "./chunk-3RG5ZIWI.js";
+} from "./chunk-CAFNSGYM.js";
+import "./chunk-BBMRDUYQ.js";
+import "./chunk-KFQGP6VL.js";
 export {
   closeAllSessions,
   closeEphemeralContext,

package/dist/{browser-53KUFEEM.js → browser-ZJOZB5CR.js}

@@ -20,11 +20,11 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-YKOHDEFV.js";
-import "./chunk-42RPMJ76.js";
-import "./chunk-T4J4C2NZ.js";
+} from "./chunk-JPA2ZT2R.js";
+import "./chunk-PPG4D2EW.js";
+import "./chunk-BBMRDUYQ.js";
 import "./chunk-ZZ2TFWIV.js";
-import "./chunk-3RG5ZIWI.js";
+import "./chunk-KFQGP6VL.js";
 export {
   closeAllSessions,
   closeEphemeralContext,