@xbrowser/cli 0.14.2 → 0.15.0

package/README.md

@@ -1,6 +1,6 @@
 # xbrowser
 
-> Self-contained browser automation CLI — navigate, click, fill forms, screenshot, web scraping, record & replay. A Playwright/Puppeteer alternative for CLI-first workflows.
+> **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**.
 
 [![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)
@@ -18,6 +18,42 @@
 - **会话管理** — 多会话并行，独立上下文
 - **Daemon 模式** — 后台常驻，快速响应
 
+## Use Cases
+
+**Web Scraping & Data Extraction**
+```bash
+# Scrape any page to Markdown — no Playwright scripts needed
+xbrowser scrape https://news.ycombinator.com --mode smart --output markdown
+
+# Crawl an entire site
+xbrowser crawl https://example.com --max-depth 3 --output json
+```
+
+**Search Engine Automation**
+```bash
+# Search Google, Bing, Baidu from the command line
+xbrowser search "best headless browser CLI" --engine google --limit 10 --json
+
+# Time-filtered search
+xbrowser search "playwright alternative 2025" --engine bing --time-filter month
+```
+
+**Browser Automation for AI Agents**
+```bash
+# Record browser actions, replay in CI/CD
+xbrowser record --output workflow.yaml
+xbrowser replay workflow.yaml
+
+# Chain commands for complex workflows
+xbrowser "goto https://example.com && wait .content && text --selector .content"
+```
+
+**SEO & Backlink Automation**
+```bash
+# Auto-publish articles to 13+ SEO platforms
+xbrowser publish --platform devto,juejin --file article.md
+```
+
 ## 快速开始
 
 ### 安装
@@ -841,6 +877,32 @@ xbrowser/
 └── docs/                # 文档
 ```
 
+## xbrowser vs Other Browser Automation Tools
+
+| Feature | xbrowser | Playwright | Puppeteer | Selenium |
+|---------|----------|------------|-----------|----------|
+| **Interface** | CLI (command line) | Node.js library | Node.js library | Multi-language library |
+| **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 |
+| **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 | ❌ | ❌ |
+| **Anti-Detection** | ✅ CDP firewall | ❌ | ❌ | ❌ |
+| **AI Agent Integration** | ✅ Built-in plugins | Manual integration | Manual integration | Manual integration |
+
+**When to use xbrowser:**
+- You want to **automate browsers from the command line** without writing code
+- You need **web scraping, SEO automation, or AI agent workflows**
+- You want a **Playwright/Puppeteer alternative** that works with one-liners
+- You're building **CLI tools that need browser automation**
+
+**When to use Playwright/Puppeteer:**
+- You're writing **test suites** for web applications
+- You need **fine-grained programmatic control** of browser behavior
+- You're building a **Node.js application** that embeds browser automation
+
 ## 与相关项目的关系
 
 | 项目 | 定位 | 关系 |

package/dist/cli.js

@@ -132,7 +132,18 @@ function parsePluginParams(args, schema, base = {}) {
         if (value === "true") params[key] = true;
         else if (value === "false") params[key] = false;
         else if (/^\d+$/.test(value)) params[key] = parseInt(value, 10);
-        else params[key] = value;
+        else {
+          try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed) || typeof parsed === "object" && parsed !== null) {
+              params[key] = parsed;
+            } else {
+              params[key] = value;
+            }
+          } catch {
+            params[key] = value;
+          }
+        }
         i++;
       } else {
         params[key] = true;
@@ -6225,8 +6236,48 @@ async function loadHooks() {
 // src/executor.ts
 import { homedir as homedir3 } from "os";
 import { join as join3 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync10, writeFileSync as writeFileSync5, mkdirSync as mkdirSync3 } from "fs";
 var NAVIGATION_COMMANDS = /* @__PURE__ */ new Set(["goto", "back", "forward", "refresh"]);
 var snapshotHintShown = /* @__PURE__ */ new WeakSet();
+var STORAGE_DIR = join3(homedir3(), ".xbrowser", "storage");
+var storageCache = /* @__PURE__ */ new Map();
+function getPluginStorage(pluginName) {
+  if (!storageCache.has(pluginName)) {
+    const filePath = join3(STORAGE_DIR, `${pluginName}.json`);
+    let data = {};
+    const load3 = () => {
+      if (existsSync6(filePath)) {
+        try {
+          data = JSON.parse(readFileSync10(filePath, "utf-8"));
+        } catch {
+          data = {};
+        }
+      }
+    };
+    const save = () => {
+      mkdirSync3(STORAGE_DIR, { recursive: true });
+      writeFileSync5(filePath, JSON.stringify(data, null, 2), "utf-8");
+    };
+    load3();
+    storageCache.set(pluginName, {
+      get: async (key) => data[key] ?? null,
+      set: async (key, value) => {
+        data[key] = value;
+        save();
+      },
+      delete: async (key) => {
+        delete data[key];
+        save();
+      },
+      clear: async () => {
+        data = {};
+        save();
+      },
+      keys: async () => Object.keys(data)
+    });
+  }
+  return storageCache.get(pluginName);
+}
 var archiveInitialized = false;
 function ensureArchiveInit() {
   if (!archiveInitialized) {
@@ -6334,16 +6385,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     args: [],
     options: {},
     cwd: process.cwd(),
-    storage: {
-      get: async () => null,
-      set: async () => {
-      },
-      delete: async () => {
-      },
-      clear: async () => {
-      },
-      keys: async () => []
-    },
+    storage: getPluginStorage(commandName),
     output: {
       mode: "text",
       showTips: false,
@@ -6566,16 +6608,7 @@ async function executeChain(input, options) {
             browser: session.context.browser(),
             browserContext: session.context,
             sessionId: session.id,
-            storage: {
-              get: async (_key) => null,
-              set: async (_key, _value) => {
-              },
-              delete: async (_key) => {
-              },
-              clear: async () => {
-              },
-              keys: async () => []
-            },
+            storage: getPluginStorage(cmdName),
             output: { mode: "text", showTips: false, color: false, emoji: false },
             error: (msg) => {
               throw new Error(msg);
@@ -6586,8 +6619,21 @@ async function executeChain(input, options) {
           };
           const start2 = Date.now();
           try {
+            const hooks = await loadHooks();
+            if (hooks.length > 0) {
+              await Promise.all(hooks.map((h) => h.onBeforeCommand?.({ page: session.page, command: `${cmdName} ${subCommand}`, params: pluginParams })));
+            }
             const raw = await cmdEntry.handler(pluginParams, pluginCtx);
             const duration2 = Date.now() - start2;
+            let hookOutputs;
+            if (hooks.length > 0) {
+              const outputs = [];
+              for (const h of hooks) {
+                const output = await h.onAfterCommand?.({ page: session.page, command: `${cmdName} ${subCommand}`, params: pluginParams, result: raw, duration: duration2 });
+                if (output) outputs.push({ _hook: h.name, ...output });
+              }
+              if (outputs.length > 0) hookOutputs = outputs;
+            }
             const data = raw?.data ?? raw;
             recordArchive(session.id, sessionName, {
               step: results.length,
@@ -6602,7 +6648,8 @@ async function executeChain(input, options) {
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
               ...ok25(data),
-              duration: duration2
+              duration: duration2,
+              ...hookOutputs ? { hookOutputs } : {}
             });
             if (type === "or") {
               return {
@@ -6666,7 +6713,8 @@ async function executeChain(input, options) {
           data: result.data,
           message: result.message,
           duration,
-          tips: result.tips
+          tips: result.tips,
+          ...result.hookOutputs ? { hookOutputs: result.hookOutputs } : {}
         };
         results.push(stepResult);
         if (type === "and" && !result.success) {
@@ -6853,7 +6901,7 @@ var sessionKillBuiltin = {
 };
 
 // src/config.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync3, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, writeFileSync as writeFileSync6 } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir4, tmpdir } from "os";
 function getConfigFile() {
@@ -6861,14 +6909,14 @@ function getConfigFile() {
 }
 function loadConfig() {
   const configFile = getConfigFile();
-  if (!existsSync6(configFile)) return {};
+  if (!existsSync7(configFile)) return {};
   return readJsonFile(configFile, {});
 }
 function saveConfig(config) {
   const dir = join4(homedir4() || tmpdir(), ".xbrowser");
   const configFile = getConfigFile();
-  if (!existsSync6(dir)) mkdirSync3(dir, { recursive: true });
-  writeFileSync5(configFile, JSON.stringify(config, null, 2), "utf-8");
+  if (!existsSync7(dir)) mkdirSync4(dir, { recursive: true });
+  writeFileSync6(configFile, JSON.stringify(config, null, 2), "utf-8");
 }
 function getConfigValue(key) {
   return loadConfig()[key];
@@ -6976,26 +7024,26 @@ var configBuiltin = {
 
 // src/plugin/installer.ts
 import {
-  existsSync as existsSync13,
+  existsSync as existsSync14,
   readdirSync as readdirSync3,
-  mkdirSync as mkdirSync8,
+  mkdirSync as mkdirSync9,
   rmSync as rmSync7
 } from "fs";
 import { resolve as resolve15, basename as basename2 } from "path";
 import { homedir as homedir5 } from "os";
 
 // src/plugin/install-sources/local.ts
-import { existsSync as existsSync8, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
+import { existsSync as existsSync9, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
 import { resolve as resolve10 } from "path";
 
 // src/plugin/install-utils.ts
 import {
-  existsSync as existsSync7,
+  existsSync as existsSync8,
   readdirSync as readdirSync2,
   cpSync,
   rmSync,
-  mkdirSync as mkdirSync4,
-  readFileSync as readFileSync10,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync11,
   createWriteStream
 } from "fs";
 import { resolve as resolve9 } from "path";
@@ -7066,7 +7114,7 @@ async function downloadToFile(url, destPath) {
   await pipeline(nodeStream, createWriteStream(destPath));
 }
 function extractTarGz(tarballPath, targetDir) {
-  mkdirSync4(targetDir, { recursive: true });
+  mkdirSync5(targetDir, { recursive: true });
   execSync7(`tar -xzf "${tarballPath}" -C "${targetDir}"`, { stdio: "pipe" });
 }
 function flattenPackageRoot(targetDir) {
@@ -7087,18 +7135,18 @@ function flattenPackageRoot(targetDir) {
 async function verifyPlugin(dir) {
   const warnings = [];
   const indexPath = resolve9(dir, "index.ts");
-  if (!existsSync7(indexPath)) {
+  if (!existsSync8(indexPath)) {
     const indexJs = resolve9(dir, "index.js");
-    if (!existsSync7(indexJs)) {
+    if (!existsSync8(indexJs)) {
       return { valid: false, error: "No index.ts or index.js entry point found", warnings };
     }
   }
   const pkgPath = resolve9(dir, "package.json");
-  if (!existsSync7(pkgPath)) {
+  if (!existsSync8(pkgPath)) {
     warnings.push("No package.json found");
   } else {
     try {
-      const pkg2 = JSON.parse(readFileSync10(pkgPath, "utf-8"));
+      const pkg2 = JSON.parse(readFileSync11(pkgPath, "utf-8"));
       if (!pkg2.xbrowser) {
         warnings.push("No xbrowser metadata in package.json");
       }
@@ -7118,7 +7166,7 @@ function safeCleanup(dir) {
 // src/plugin/install-sources/local.ts
 async function installFromLocal(source, name, targetDir) {
   const srcPath = resolve10(source);
-  if (!existsSync8(srcPath)) {
+  if (!existsSync9(srcPath)) {
     throw new Error(`Local path does not exist: ${srcPath}`);
   }
   const tmpTarget = `${targetDir}-tmp-${Date.now()}`;
@@ -7131,7 +7179,7 @@ async function installFromLocal(source, name, targetDir) {
       safeCleanup(tmpTarget);
       throw new Error(`Invalid plugin: ${verify.error}`);
     }
-    if (existsSync8(targetDir)) {
+    if (existsSync9(targetDir)) {
       rmSync2(targetDir, { recursive: true, force: true });
     }
     cpSync2(tmpTarget, targetDir, { recursive: true, force: true });
@@ -7151,7 +7199,7 @@ async function installFromLocal(source, name, targetDir) {
 }
 
 // src/plugin/install-sources/npm.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync11, writeFileSync as writeFileSync6, rmSync as rmSync3, cpSync as cpSync3 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync12, writeFileSync as writeFileSync7, rmSync as rmSync3, cpSync as cpSync3 } from "fs";
 import { resolve as resolve11, join as join5 } from "path";
 import { tmpdir as tmpdir2 } from "os";
 async function installFromNpm(packageName, name, targetDir) {
@@ -7172,7 +7220,7 @@ async function installFromNpm(packageName, name, targetDir) {
   }
   const tarballUrl = versionMeta.dist.tarball;
   const tmpDir = join5(tmpdir2(), `xbrowser-npm-${Date.now()}`);
-  mkdirSync5(tmpDir, { recursive: true });
+  mkdirSync6(tmpDir, { recursive: true });
   let warnings = [];
   try {
     const tarballPath = join5(tmpDir, `${name}.tgz`);
@@ -7185,16 +7233,16 @@ async function installFromNpm(packageName, name, targetDir) {
     if (!verify.valid) {
       throw new Error(`Invalid npm plugin: ${verify.error}`);
     }
-    if (existsSync9(targetDir)) {
+    if (existsSync10(targetDir)) {
       rmSync3(targetDir, { recursive: true, force: true });
     }
     cpSync3(extractDir, targetDir, { recursive: true, force: true });
     const pkgPath = resolve11(targetDir, "package.json");
-    if (existsSync9(pkgPath)) {
-      const pkg2 = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+    if (existsSync10(pkgPath)) {
+      const pkg2 = JSON.parse(readFileSync12(pkgPath, "utf-8"));
       if (!pkg2._npmSource) {
         pkg2._npmSource = { name: packageName, version: latestVersion };
-        writeFileSync6(pkgPath, JSON.stringify(pkg2, null, 2));
+        writeFileSync7(pkgPath, JSON.stringify(pkg2, null, 2));
       }
     }
   } finally {
@@ -7211,7 +7259,7 @@ async function installFromNpm(packageName, name, targetDir) {
 }
 
 // src/plugin/install-sources/git.ts
-import { existsSync as existsSync10, readFileSync as readFileSync12, writeFileSync as writeFileSync7, rmSync as rmSync4, cpSync as cpSync4 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync8, rmSync as rmSync4, cpSync as cpSync4 } from "fs";
 import { resolve as resolve12, join as join6 } from "path";
 import { tmpdir as tmpdir3 } from "os";
 import { execSync as execSync8 } from "child_process";
@@ -7225,17 +7273,17 @@ async function installFromGit(gitUrl, name, targetDir) {
     if (!verify.valid) {
       throw new Error(`Invalid git plugin: ${verify.error}`);
     }
-    if (existsSync10(targetDir)) {
+    if (existsSync11(targetDir)) {
       rmSync4(targetDir, { recursive: true, force: true });
     }
     cpSync4(tmpDir, targetDir, { recursive: true, force: true });
     rmSync4(resolve12(targetDir, ".git"), { recursive: true, force: true });
     const pkgPath = resolve12(targetDir, "package.json");
-    if (existsSync10(pkgPath)) {
-      const pkg2 = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+    if (existsSync11(pkgPath)) {
+      const pkg2 = JSON.parse(readFileSync13(pkgPath, "utf-8"));
       if (!pkg2._gitSource) {
         pkg2._gitSource = { url: gitUrl };
-        writeFileSync7(pkgPath, JSON.stringify(pkg2, null, 2));
+        writeFileSync8(pkgPath, JSON.stringify(pkg2, null, 2));
       }
     }
   } finally {
@@ -7252,12 +7300,12 @@ async function installFromGit(gitUrl, name, targetDir) {
 }
 
 // src/plugin/install-sources/url.ts
-import { existsSync as existsSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync8, mkdirSync as mkdirSync6, rmSync as rmSync5, cpSync as cpSync5 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync14, writeFileSync as writeFileSync9, mkdirSync as mkdirSync7, rmSync as rmSync5, cpSync as cpSync5 } from "fs";
 import { resolve as resolve13, join as join7, basename } from "path";
 import { tmpdir as tmpdir4 } from "os";
 async function installFromUrl(url, name, targetDir) {
   const tmpDir = join7(tmpdir4(), `xbrowser-url-${Date.now()}`);
-  mkdirSync6(tmpDir, { recursive: true });
+  mkdirSync7(tmpDir, { recursive: true });
   let warnings = [];
   try {
     const fileName = basename(new URL(url).pathname) || "plugin.tar.gz";
@@ -7271,16 +7319,16 @@ async function installFromUrl(url, name, targetDir) {
     if (!verify.valid) {
       throw new Error(`Invalid plugin from URL: ${verify.error}`);
     }
-    if (existsSync11(targetDir)) {
+    if (existsSync12(targetDir)) {
       rmSync5(targetDir, { recursive: true, force: true });
     }
     cpSync5(extractDir, targetDir, { recursive: true, force: true });
     const pkgPath = resolve13(targetDir, "package.json");
-    if (existsSync11(pkgPath)) {
-      const pkg2 = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+    if (existsSync12(pkgPath)) {
+      const pkg2 = JSON.parse(readFileSync14(pkgPath, "utf-8"));
       if (!pkg2._urlSource) {
         pkg2._urlSource = { url };
-        writeFileSync8(pkgPath, JSON.stringify(pkg2, null, 2));
+        writeFileSync9(pkgPath, JSON.stringify(pkg2, null, 2));
       }
     }
   } finally {
@@ -7298,10 +7346,10 @@ async function installFromUrl(url, name, targetDir) {
 
 // src/plugin/install-sources/marketplace.ts
 import {
-  existsSync as existsSync12,
-  mkdirSync as mkdirSync7,
-  writeFileSync as writeFileSync9,
-  readFileSync as readFileSync14,
+  existsSync as existsSync13,
+  mkdirSync as mkdirSync8,
+  writeFileSync as writeFileSync10,
+  readFileSync as readFileSync15,
   rmSync as rmSync6,
   cpSync as cpSync6
 } from "fs";
@@ -7323,12 +7371,12 @@ async function installFromMarketplace(pluginsDir, slug, options) {
   const plugin = detailData.data;
   const name = options?.name || String(plugin.slug || slug);
   const targetDir = resolve14(pluginsDir, name);
-  if (existsSync12(targetDir) && !options?.force) {
+  if (existsSync13(targetDir) && !options?.force) {
     throw new Error(`Plugin "${name}" already exists. Use --force to overwrite.`);
   }
-  mkdirSync7(targetDir, { recursive: true });
+  mkdirSync8(targetDir, { recursive: true });
   const tmpDir = join8(tmpdir5(), `xbrowser-marketplace-${Date.now()}`);
-  mkdirSync7(tmpDir, { recursive: true });
+  mkdirSync8(tmpDir, { recursive: true });
   const realSlug = String(plugin.slug || slug);
   try {
     await downloadAndExtractMarketplaceTarball(baseUrl, realSlug, tmpDir, targetDir);
@@ -7358,14 +7406,14 @@ function isManifestArray(data) {
   return Array.isArray(data) && data.length > 0 && typeof data[0].path === "string" && typeof data[0].content === "string";
 }
 function extractManifestToDir(manifest, targetDir) {
-  if (existsSync12(targetDir)) {
+  if (existsSync13(targetDir)) {
     rmSync6(targetDir, { recursive: true, force: true });
   }
-  mkdirSync7(targetDir, { recursive: true });
+  mkdirSync8(targetDir, { recursive: true });
   for (const file of manifest) {
     const filePath = resolve14(targetDir, file.path);
-    mkdirSync7(dirname2(filePath), { recursive: true });
-    writeFileSync9(filePath, Buffer.from(file.content, "base64"));
+    mkdirSync8(dirname2(filePath), { recursive: true });
+    writeFileSync10(filePath, Buffer.from(file.content, "base64"));
   }
 }
 function tryParseAsGzippedManifest(buffer) {
@@ -7392,7 +7440,7 @@ async function downloadAndExtractMarketplaceTarball(baseUrl, slug, tmpDir, targe
     const redirectUrl = tarballRes.headers.get("location");
     const tarballPath = join8(tmpDir, `${slug}.tar.gz`);
     await downloadToFile(redirectUrl, tarballPath);
-    const buffer = readFileSync14(tarballPath);
+    const buffer = readFileSync15(tarballPath);
     const manifest = tryParseAsGzippedManifest(buffer);
     if (manifest) {
       extractManifestToDir(manifest, targetDir);
@@ -7401,7 +7449,7 @@ async function downloadAndExtractMarketplaceTarball(baseUrl, slug, tmpDir, targe
     const extractDir = join8(tmpDir, "extracted");
     extractTarGz(tarballPath, extractDir);
     flattenPackageRoot(extractDir);
-    if (existsSync12(targetDir)) {
+    if (existsSync13(targetDir)) {
       rmSync6(targetDir, { recursive: true, force: true });
     }
     cpSync6(extractDir, targetDir, { recursive: true, force: true });
@@ -7413,12 +7461,12 @@ async function downloadAndExtractMarketplaceTarball(baseUrl, slug, tmpDir, targe
       return;
     }
     const tarballPath = join8(tmpDir, `${slug}.tar.gz`);
-    writeFileSync9(tarballPath, buffer);
+    writeFileSync10(tarballPath, buffer);
     try {
       const extractDir = join8(tmpDir, "extracted");
       extractTarGz(tarballPath, extractDir);
       flattenPackageRoot(extractDir);
-      if (existsSync12(targetDir)) {
+      if (existsSync13(targetDir)) {
         rmSync6(targetDir, { recursive: true, force: true });
       }
       cpSync6(extractDir, targetDir, { recursive: true, force: true });
@@ -7454,24 +7502,24 @@ function writeMarketplacePackageJson(plugin, slug, name, baseUrl, targetDir) {
     }
   };
   const pkgPath = resolve14(targetDir, "package.json");
-  if (!existsSync12(pkgPath)) {
-    writeFileSync9(pkgPath, JSON.stringify(packageJson, null, 2));
+  if (!existsSync13(pkgPath)) {
+    writeFileSync10(pkgPath, JSON.stringify(packageJson, null, 2));
   } else {
     try {
-      const existing = JSON.parse(readFileSync14(pkgPath, "utf-8"));
+      const existing = JSON.parse(readFileSync15(pkgPath, "utf-8"));
       const merged = {
         ...existing,
         xbrowser: { ...existing.xbrowser, ...packageJson.xbrowser },
         _marketplace: packageJson._marketplace
       };
-      writeFileSync9(pkgPath, JSON.stringify(merged, null, 2));
+      writeFileSync10(pkgPath, JSON.stringify(merged, null, 2));
     } catch {
-      writeFileSync9(pkgPath, JSON.stringify(packageJson, null, 2));
+      writeFileSync10(pkgPath, JSON.stringify(packageJson, null, 2));
     }
   }
 }
 function ensureIndexFile(plugin, name, targetDir) {
-  if (!existsSync12(resolve14(targetDir, "index.ts")) && !existsSync12(resolve14(targetDir, "index.js"))) {
+  if (!existsSync13(resolve14(targetDir, "index.ts")) && !existsSync13(resolve14(targetDir, "index.js"))) {
     const commands = plugin.commands || [];
     const commandHandlers = commands.length > 0 ? commands.map((cmd) => {
       return [
@@ -7486,7 +7534,7 @@ function ensureIndexFile(plugin, name, targetDir) {
       `    handler: async () => ({ data: { message: 'Hello from ${name}!' }, tips: [] }),`,
       `  });`
     ].join("\n");
-    writeFileSync9(
+    writeFileSync10(
       resolve14(targetDir, "index.ts"),
       [
         `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
@@ -7525,10 +7573,10 @@ var PluginInstaller = class {
     const type = this.detectSourceType(source);
     const name = options?.name || this.deriveName(source, type);
     const targetDir = resolve15(this.pluginsDir, name);
-    if (existsSync13(targetDir) && !options?.force) {
+    if (existsSync14(targetDir) && !options?.force) {
       throw new Error(`Plugin "${name}" already exists. Use --force to overwrite.`);
     }
-    mkdirSync8(targetDir, { recursive: true });
+    mkdirSync9(targetDir, { recursive: true });
     const resolvedSource = type === "npm" ? await resolveNpmPackageWithFallback(source) : source;
     switch (type) {
       case "local":
@@ -7586,7 +7634,7 @@ var PluginInstaller = class {
    */
   async uninstall(name) {
     const targetDir = resolve15(this.pluginsDir, name);
-    if (!existsSync13(targetDir)) {
+    if (!existsSync14(targetDir)) {
       throw new Error(`Plugin "${name}" not found`);
     }
     rmSync7(targetDir, { recursive: true, force: true });
@@ -7597,7 +7645,7 @@ var PluginInstaller = class {
    * @returns Array of installed plugin information.
    */
   async list(_options) {
-    if (!existsSync13(this.pluginsDir)) return [];
+    if (!existsSync14(this.pluginsDir)) return [];
     const entries = readdirSync3(this.pluginsDir, { withFileTypes: true });
     const plugins = [];
     for (const entry of entries) {
@@ -7605,7 +7653,7 @@ var PluginInstaller = class {
       const pluginPath = resolve15(this.pluginsDir, entry.name);
       const indexPath = resolve15(pluginPath, "index.ts");
       const indexJsPath = resolve15(pluginPath, "index.js");
-      if (!existsSync13(indexPath) && !existsSync13(indexJsPath)) continue;
+      if (!existsSync14(indexPath) && !existsSync14(indexJsPath)) continue;
       const metadata = PluginMetadataParser.parseFromPackageJson(pluginPath);
       let source = "local";
       const pkg2 = readJsonFile(resolve15(pluginPath, "package.json"), {});
@@ -7632,10 +7680,10 @@ var PluginInstaller = class {
     }
     if (source.startsWith("file://")) {
       const filePath = decodeURIComponent(new URL(source).pathname);
-      if (existsSync13(filePath)) return "url";
+      if (existsSync14(filePath)) return "url";
     }
     if (source.endsWith(".git") || source.includes("github.com/")) return "git";
-    if (existsSync13(resolve15(source))) return "local";
+    if (existsSync14(resolve15(source))) return "local";
     return "npm";
   }
   deriveName(source, type) {
@@ -9659,7 +9707,7 @@ async function handleFilter(args, _mode) {
 
 // src/stdin.ts
 import { createInterface } from "readline";
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 async function readStdin2() {
   if (process.stdin.isTTY) return [];
   const lines = [];
@@ -9673,7 +9721,7 @@ async function readStdin2() {
   return lines;
 }
 function readCommandFile(filePath) {
-  const content = readFileSync15(filePath, "utf-8");
+  const content = readFileSync16(filePath, "utf-8");
   return content.split("\n").map((line) => line.trim()).filter((line) => line && !line.startsWith("#"));
 }
 
@@ -10941,11 +10989,14 @@ Run "xbrowser ${command} --help" to see available commands.`
             showCommandHelp(command, cmdEntry, { description: site.config.description, name: site.name, url: site.url }, mode);
             return;
           }
-          const params = parsePluginParams(cmdArgsForPlugin, cmdEntry.parameters, options);
+          const pluginNameIdx = argv.indexOf(command);
+          const subCmdIdx = pluginNameIdx >= 0 ? argv.indexOf(subCommand, pluginNameIdx + 1) : -1;
+          const rawPluginArgs = subCmdIdx >= 0 ? argv.slice(subCmdIdx + 1) : [];
+          const params = parsePluginParams(rawPluginArgs, cmdEntry.parameters);
           if (options.target && !params._target) {
             params._target = options.target;
           }
-          const needsBrowser = cmdEntry.scope !== "global";
+          const needsBrowser = cmdEntry.scope === "page";
           if (needsBrowser && !process.env.XBROWSER_DAEMON_WORKER) {
             const { forwardExec } = await import("./daemon-client-XWSSQBEA.js");
             const userTimeout = typeof params.timeout === "number" && params.timeout > 0 ? params.timeout * 1e3 + 3e4 : void 0;
@@ -10982,16 +11033,7 @@ Run "xbrowser ${command} --help" to see available commands.`
             browser: needsBrowser ? session.context.browser() : null,
             browserContext: needsBrowser ? session.context : null,
             sessionId: needsBrowser ? session.id : "",
-            storage: {
-              get: async (_key) => null,
-              set: async (_key, _value) => {
-              },
-              delete: async (_key) => {
-              },
-              clear: async () => {
-              },
-              keys: async () => []
-            },
+            storage: getPluginStorage(command),
             output: { mode, showTips: true, color: true, emoji: true },
             error: (msg) => {
               outputError(msg);