@xbrowser/cli 1.24.0 → 1.24.2

package/dist/{browser-Q67BJTI2.js → browser-DFM2SQDM.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-2Q3GQRUP.js";
-import "./chunk-7OP2ISEY.js";
+} from "./chunk-PKXJST62.js";
+import "./chunk-UR3R5LWF.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{browser-BVRFSUXU.js → browser-I3EZY3FL.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-IFKJO2UR.js";
+} from "./chunk-X735U7G7.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{browser-DSYUAE7H.js → browser-WCHMUN6H.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-T4WTKBWI.js";
-import "./chunk-4OU37CXP.js";
+} from "./chunk-ROAXLDV7.js";
+import "./chunk-BH3GIMWE.js";
 import "./chunk-A7NEA4PA.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";

package/dist/{cdp-driver-WWO2UZDR.js → cdp-driver-57QV7C5O.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-7OP2ISEY.js";
+} from "./chunk-UR3R5LWF.js";
 import "./chunk-GYB5BOSP.js";
 import {
   connectToCDP,

package/dist/{cdp-driver-DC7EIUG5.js → cdp-driver-BFGFAVAN.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-4OU37CXP.js";
+} from "./chunk-BH3GIMWE.js";
 import "./chunk-A7NEA4PA.js";
 import "./chunk-GYB5BOSP.js";
 import {

package/dist/{cdp-driver-T7D6H2RW.js → cdp-driver-HGWM5NRF.js}

@@ -710,6 +710,61 @@ async function scrollIntoView(page, selector) {
   `);
 }
 
+// src/cdp-driver/editor-profile.ts
+function buildEditorProbe(selector) {
+  return `(function() {
+    const el = ${selector};
+    if (!el) return { react: false, richFamily: null, contenteditable: false, controlled: false };
+    const editable = el.closest('[contenteditable="true"]');
+    const host = editable || el;
+    // React fiber\uFF1A\u5143\u7D20\u81EA\u6709\u952E\u626B\u63CF\uFF08interaction.ts \u9875\u9762\u7EA7\u63A2\u6D4B\u7684\u5143\u7D20\u7EA7\u6536\u7A84\uFF09
+    let react = false;
+    try {
+      for (const k of Object.keys(host)) {
+        if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+      }
+      if (!react && host.parentElement) {
+        for (const k of Object.keys(host.parentElement)) {
+          if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+        }
+      }
+    } catch (e) { /* \u8DE8\u57DF/\u6743\u9650\u515C\u5E95 */ }
+    // \u5DF2\u77E5\u7F16\u8F91\u5668\u5BB6\u65CF\uFF08\u81EA\u7814 Draft \u7CFB\u6700\u5371\u9669\u2014\u2014EditorState \u5F3A\u53D7\u63A7\uFF09
+    const families = [
+      ['.public-DraftEditor-content', 'draft'],
+      ['.DraftEditor-editorContainer', 'draft'],
+      ['.ProseMirror', 'prosemirror'],
+      ['.ql-editor', 'quill'],
+      ['.CodeMirror', 'codemirror'],
+      ['.cm-editor', 'codemirror'],
+      ['[data-slate-editor]', 'slate'],
+      ['.jsx-lexical', 'lexical'],
+      ['.contenteditable-editor', 'generic-rich'],
+    ];
+    let richFamily = null;
+    for (const [sel, name] of families) {
+      if (host.closest(sel)) { richFamily = name; break; }
+    }
+    const contenteditable = !!editable && el.tagName !== 'INPUT' && el.tagName !== 'TEXTAREA';
+    return {
+      react,
+      richFamily,
+      contenteditable,
+      controlled: react || !!richFamily || contenteditable,
+    };
+  })()`;
+}
+async function probeEditor(evaluate, selector) {
+  const fallback = { react: false, richFamily: null, contenteditable: false, controlled: false };
+  try {
+    const r = await evaluate(buildEditorProbe(selector));
+    if (r && typeof r === "object") return r;
+    return fallback;
+  } catch {
+    return fallback;
+  }
+}
+
 // src/cdp-driver/locator.ts
 var XBLocatorImpl = class _XBLocatorImpl {
   page;
@@ -783,19 +838,51 @@ var XBLocatorImpl = class _XBLocatorImpl {
         if ((el.value || el.textContent || '') !== '') document.execCommand('selectAll');
       })()
     `);
-    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+    const profile = await probeEditor(
+      (expr) => this.page.evaluate(expr),
+      this._q(this.selector)
+    );
+    const verifyMs = parseInt(process.env.XBROWSER_FILL_VERIFY_MS ?? "600", 10) || 600;
+    const readValue = () => this.page.evaluate(
+      `(function(){ const el = ${this._q(this.selector)}; if (!el) return ''; const v = el.value !== undefined ? el.value : el.textContent; return v || ''; })()`
+    );
+    const survived = async (expected) => {
+      await this.page.waitForTimeout(verifyMs);
+      const got = await readValue();
+      return !(got === "" || got.length < expected.length * 0.5);
+    };
+    const canFastPath = process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type" && !profile.controlled;
+    if (canFastPath) {
       try {
         const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-XRP54ENE.js");
         await pasteViaClipboard(this.page, value);
         const got = await this.page.evaluate(
           `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
         );
-        if (got === value) return;
-        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+        if (got === value && await survived(value)) return;
+        const syn = await syntheticPaste(this.page, this._q(this.selector), value);
+        if (syn && await survived(value)) return;
       } catch {
       }
     }
     await this.page.keyboard.type(value, { stealth: true });
+    if (profile.controlled && verifyMs > 0 && !await survived(value)) {
+      await this.click({ ...opts });
+      await this.page.evaluate(`
+        (function() {
+          const el = ${this._q(this.selector)};
+          if (!el) return;
+          if (document.activeElement !== el) el.focus();
+          document.execCommand('selectAll');
+        })()
+      `);
+      await this.page.keyboard.type(value, { stealth: true });
+      if (!await survived(value)) {
+        throw new Error(
+          `input not retained: \u53D7\u63A7\u7F16\u8F91\u5668\u5728\u952E\u76D8\u6D41\u540E\u4ECD\u6E05\u7A7A\u6CE8\u5165\u503C\uFF08\u5347\u7EA7\u4EBA\u5DE5\u6216\u68C0\u67E5\u7AD9\u70B9\u88C1\u51B3\u903B\u8F91\uFF1B\u53EF\u8C03 XBROWSER_FILL_VERIFY_MS\uFF09`
+        );
+      }
+    }
     return;
     await this.page.evaluate(`
       (function() {

package/dist/{chunk-4OU37CXP.js → chunk-BH3GIMWE.js}

@@ -611,6 +611,61 @@ async function scrollIntoView(page, selector) {
   `);
 }
 
+// src/cdp-driver/editor-profile.ts
+function buildEditorProbe(selector) {
+  return `(function() {
+    const el = ${selector};
+    if (!el) return { react: false, richFamily: null, contenteditable: false, controlled: false };
+    const editable = el.closest('[contenteditable="true"]');
+    const host = editable || el;
+    // React fiber\uFF1A\u5143\u7D20\u81EA\u6709\u952E\u626B\u63CF\uFF08interaction.ts \u9875\u9762\u7EA7\u63A2\u6D4B\u7684\u5143\u7D20\u7EA7\u6536\u7A84\uFF09
+    let react = false;
+    try {
+      for (const k of Object.keys(host)) {
+        if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+      }
+      if (!react && host.parentElement) {
+        for (const k of Object.keys(host.parentElement)) {
+          if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+        }
+      }
+    } catch (e) { /* \u8DE8\u57DF/\u6743\u9650\u515C\u5E95 */ }
+    // \u5DF2\u77E5\u7F16\u8F91\u5668\u5BB6\u65CF\uFF08\u81EA\u7814 Draft \u7CFB\u6700\u5371\u9669\u2014\u2014EditorState \u5F3A\u53D7\u63A7\uFF09
+    const families = [
+      ['.public-DraftEditor-content', 'draft'],
+      ['.DraftEditor-editorContainer', 'draft'],
+      ['.ProseMirror', 'prosemirror'],
+      ['.ql-editor', 'quill'],
+      ['.CodeMirror', 'codemirror'],
+      ['.cm-editor', 'codemirror'],
+      ['[data-slate-editor]', 'slate'],
+      ['.jsx-lexical', 'lexical'],
+      ['.contenteditable-editor', 'generic-rich'],
+    ];
+    let richFamily = null;
+    for (const [sel, name] of families) {
+      if (host.closest(sel)) { richFamily = name; break; }
+    }
+    const contenteditable = !!editable && el.tagName !== 'INPUT' && el.tagName !== 'TEXTAREA';
+    return {
+      react,
+      richFamily,
+      contenteditable,
+      controlled: react || !!richFamily || contenteditable,
+    };
+  })()`;
+}
+async function probeEditor(evaluate, selector) {
+  const fallback = { react: false, richFamily: null, contenteditable: false, controlled: false };
+  try {
+    const r = await evaluate(buildEditorProbe(selector));
+    if (r && typeof r === "object") return r;
+    return fallback;
+  } catch {
+    return fallback;
+  }
+}
+
 // src/cdp-driver/locator.ts
 var XBLocatorImpl = class _XBLocatorImpl {
   page;
@@ -684,19 +739,51 @@ var XBLocatorImpl = class _XBLocatorImpl {
         if ((el.value || el.textContent || '') !== '') document.execCommand('selectAll');
       })()
     `);
-    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+    const profile = await probeEditor(
+      (expr) => this.page.evaluate(expr),
+      this._q(this.selector)
+    );
+    const verifyMs = parseInt(process.env.XBROWSER_FILL_VERIFY_MS ?? "600", 10) || 600;
+    const readValue = () => this.page.evaluate(
+      `(function(){ const el = ${this._q(this.selector)}; if (!el) return ''; const v = el.value !== undefined ? el.value : el.textContent; return v || ''; })()`
+    );
+    const survived = async (expected) => {
+      await this.page.waitForTimeout(verifyMs);
+      const got = await readValue();
+      return !(got === "" || got.length < expected.length * 0.5);
+    };
+    const canFastPath = process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type" && !profile.controlled;
+    if (canFastPath) {
       try {
         const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-BOL2GP2E.js");
         await pasteViaClipboard(this.page, value);
         const got = await this.page.evaluate(
           `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
         );
-        if (got === value) return;
-        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+        if (got === value && await survived(value)) return;
+        const syn = await syntheticPaste(this.page, this._q(this.selector), value);
+        if (syn && await survived(value)) return;
       } catch {
       }
     }
     await this.page.keyboard.type(value, { stealth: true });
+    if (profile.controlled && verifyMs > 0 && !await survived(value)) {
+      await this.click({ ...opts });
+      await this.page.evaluate(`
+        (function() {
+          const el = ${this._q(this.selector)};
+          if (!el) return;
+          if (document.activeElement !== el) el.focus();
+          document.execCommand('selectAll');
+        })()
+      `);
+      await this.page.keyboard.type(value, { stealth: true });
+      if (!await survived(value)) {
+        throw new Error(
+          `input not retained: \u53D7\u63A7\u7F16\u8F91\u5668\u5728\u952E\u76D8\u6D41\u540E\u4ECD\u6E05\u7A7A\u6CE8\u5165\u503C\uFF08\u5347\u7EA7\u4EBA\u5DE5\u6216\u68C0\u67E5\u7AD9\u70B9\u88C1\u51B3\u903B\u8F91\uFF1B\u53EF\u8C03 XBROWSER_FILL_VERIFY_MS\uFF09`
+        );
+      }
+    }
     return;
     await this.page.evaluate(`
       (function() {

package/dist/{chunk-BROEUPL3.js → chunk-LTLMDKWG.js}

@@ -9,7 +9,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-2Q3GQRUP.js";
+} from "./chunk-PKXJST62.js";
 import {
   detectAntiBot,
   formatDetectionMessage
@@ -7146,7 +7146,7 @@ function setWSServerCache(browserContext, server) {
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve2, basename, dirname as dirname3 } from "path";
 import { existsSync as existsSync6, readdirSync } from "fs";
 import { homedir as homedir4 } from "os";
 
@@ -7450,6 +7450,8 @@ var XBrowserPluginLoader = class {
   core;
   loader;
   options;
+  /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+  dirSiteAliases = /* @__PURE__ */ new Map();
   constructor(options) {
     patchLoginRequired();
     this.options = options ?? {};
@@ -7487,15 +7489,39 @@ var XBrowserPluginLoader = class {
   getLoadedPlugins() {
     return this.loader.getLoadedPlugins();
   }
+  /**
+   * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+   * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+   * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+   * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+   * 插件 id 而非 site 名，不可用）。
+   */
+  resolveSiteName(name) {
+    if (this.core.loader.getSite(name)) return name;
+    const aliased = this.dirSiteAliases.get(name);
+    if (aliased && this.core.loader.getSite(aliased)) return aliased;
+    return void 0;
+  }
+  /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+  recordSiteAliases(pluginDirName, before) {
+    for (const site of this.core.loader.getSites()) {
+      if (!before.has(site.name)) this.dirSiteAliases.set(pluginDirName, site.name);
+    }
+  }
   getPluginContract(siteName, commandName) {
-    const site = this.core.loader.getSite(siteName);
+    const resolved = this.resolveSiteName(siteName);
+    if (!resolved) return void 0;
+    const site = this.core.loader.getSite(resolved);
     if (!site) return void 0;
     const contract = buildPluginContract(site);
     if (!commandName) return contract;
     return contract.commands.find((command) => command.name === commandName);
   }
   async loadPlugin(pluginPath, id) {
-    return this.loader.loadPlugin(pluginPath, id);
+    const before = new Set(this.core.loader.getSites().map((s) => s.name));
+    const instance = await this.loader.loadPlugin(pluginPath, id);
+    this.recordSiteAliases(basename(dirname3(pluginPath)), before);
+    return instance;
   }
   async unloadPlugin(id) {
     return this.loader.unloadPlugin(id);
@@ -7563,6 +7589,7 @@ var FAIL_CODES = {
   selectorNotFound: "RETRYABLE: selector-not-found",
   pageNotReady: "RETRYABLE: page-not-ready",
   elementGone: "RETRYABLE: element-gone",
+  inputNotRetained: "RETRYABLE: input-not-retained",
   captcha: "HUMAN: captcha",
   loginWall: "HUMAN: login-wall",
   permissionDenied: "FATAL: permission-denied",
@@ -7582,6 +7609,7 @@ function classifyFailure(message) {
   if (/selector|选择器|element not found|未找到元素|no such element|queryselector returned null/.test(msg))
     return pick(FAIL_CODES.selectorNotFound);
   if (/timeout|超时|timed out|waiting for/.test(msg)) return pick(FAIL_CODES.pageNotReady);
+  if (/not retained|清空了注入值|input-not-retained/.test(msg)) return pick(FAIL_CODES.inputNotRetained);
   if (/net::err|404|navigation failed|页面不存在|target closed|element-gone/.test(msg))
     return pick(FAIL_CODES.targetGone);
   return pick(FAIL_CODES.unknown);
@@ -8536,7 +8564,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-Q67BJTI2.js");
+    const { findTargetPage } = await import("./browser-DFM2SQDM.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8837,7 +8865,8 @@ async function executeChain(input, options) {
         const cmdArgs = parts.slice(1);
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(cmdName);
+        const resolvedName = loader.resolveSiteName(cmdName);
+        const site = resolvedName ? internalLoader.getSite(resolvedName) : void 0;
         if (site) {
           const subCommand = cmdArgs[0];
           if (!subCommand) {

package/dist/{chunk-A3MORKYR.js → chunk-OSZNJT4U.js}

@@ -2,7 +2,7 @@
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve2, basename, dirname } from "path";
 import { existsSync as existsSync3, readdirSync } from "fs";
 import { homedir } from "os";
 
@@ -306,6 +306,8 @@ var XBrowserPluginLoader = class {
   core;
   loader;
   options;
+  /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+  dirSiteAliases = /* @__PURE__ */ new Map();
   constructor(options) {
     patchLoginRequired();
     this.options = options ?? {};
@@ -343,15 +345,39 @@ var XBrowserPluginLoader = class {
   getLoadedPlugins() {
     return this.loader.getLoadedPlugins();
   }
+  /**
+   * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+   * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+   * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+   * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+   * 插件 id 而非 site 名，不可用）。
+   */
+  resolveSiteName(name) {
+    if (this.core.loader.getSite(name)) return name;
+    const aliased = this.dirSiteAliases.get(name);
+    if (aliased && this.core.loader.getSite(aliased)) return aliased;
+    return void 0;
+  }
+  /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+  recordSiteAliases(pluginDirName, before) {
+    for (const site of this.core.loader.getSites()) {
+      if (!before.has(site.name)) this.dirSiteAliases.set(pluginDirName, site.name);
+    }
+  }
   getPluginContract(siteName, commandName) {
-    const site = this.core.loader.getSite(siteName);
+    const resolved = this.resolveSiteName(siteName);
+    if (!resolved) return void 0;
+    const site = this.core.loader.getSite(resolved);
     if (!site) return void 0;
     const contract = buildPluginContract(site);
     if (!commandName) return contract;
     return contract.commands.find((command) => command.name === commandName);
   }
   async loadPlugin(pluginPath, id) {
-    return this.loader.loadPlugin(pluginPath, id);
+    const before = new Set(this.core.loader.getSites().map((s) => s.name));
+    const instance = await this.loader.loadPlugin(pluginPath, id);
+    this.recordSiteAliases(basename(dirname(pluginPath)), before);
+    return instance;
   }
   async unloadPlugin(id) {
     return this.loader.unloadPlugin(id);

package/dist/{chunk-2Q3GQRUP.js → chunk-PKXJST62.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-7OP2ISEY.js";
+} from "./chunk-UR3R5LWF.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-T4WTKBWI.js → chunk-ROAXLDV7.js}

@@ -1,7 +1,7 @@
 import {
   createRuleEngine,
   launch
-} from "./chunk-4OU37CXP.js";
+} from "./chunk-BH3GIMWE.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-A7RZYSWM.js → chunk-SUHS2EWV.js}

@@ -20,7 +20,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-IFKJO2UR.js";
+} from "./chunk-X735U7G7.js";
 import {
   rand,
   sleep,
@@ -35,6 +35,7 @@ var FAIL_CODES = {
   selectorNotFound: "RETRYABLE: selector-not-found",
   pageNotReady: "RETRYABLE: page-not-ready",
   elementGone: "RETRYABLE: element-gone",
+  inputNotRetained: "RETRYABLE: input-not-retained",
   captcha: "HUMAN: captcha",
   loginWall: "HUMAN: login-wall",
   permissionDenied: "FATAL: permission-denied",
@@ -54,6 +55,7 @@ function classifyFailure(message) {
   if (/selector|选择器|element not found|未找到元素|no such element|queryselector returned null/.test(msg))
     return pick(FAIL_CODES.selectorNotFound);
   if (/timeout|超时|timed out|waiting for/.test(msg)) return pick(FAIL_CODES.pageNotReady);
+  if (/not retained|清空了注入值|input-not-retained/.test(msg)) return pick(FAIL_CODES.inputNotRetained);
   if (/net::err|404|navigation failed|页面不存在|target closed|element-gone/.test(msg))
     return pick(FAIL_CODES.targetGone);
   return pick(FAIL_CODES.unknown);
@@ -7045,7 +7047,7 @@ function attachDetectAntiBot(ctx) {
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve2, basename, dirname as dirname3 } from "path";
 import { existsSync as existsSync6, readdirSync } from "fs";
 import { homedir as homedir5 } from "os";
 
@@ -7349,6 +7351,8 @@ var XBrowserPluginLoader = class {
   core;
   loader;
   options;
+  /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+  dirSiteAliases = /* @__PURE__ */ new Map();
   constructor(options) {
     patchLoginRequired();
     this.options = options ?? {};
@@ -7386,15 +7390,39 @@ var XBrowserPluginLoader = class {
   getLoadedPlugins() {
     return this.loader.getLoadedPlugins();
   }
+  /**
+   * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+   * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+   * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+   * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+   * 插件 id 而非 site 名，不可用）。
+   */
+  resolveSiteName(name) {
+    if (this.core.loader.getSite(name)) return name;
+    const aliased = this.dirSiteAliases.get(name);
+    if (aliased && this.core.loader.getSite(aliased)) return aliased;
+    return void 0;
+  }
+  /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+  recordSiteAliases(pluginDirName, before) {
+    for (const site of this.core.loader.getSites()) {
+      if (!before.has(site.name)) this.dirSiteAliases.set(pluginDirName, site.name);
+    }
+  }
   getPluginContract(siteName, commandName) {
-    const site = this.core.loader.getSite(siteName);
+    const resolved = this.resolveSiteName(siteName);
+    if (!resolved) return void 0;
+    const site = this.core.loader.getSite(resolved);
     if (!site) return void 0;
     const contract = buildPluginContract(site);
     if (!commandName) return contract;
     return contract.commands.find((command) => command.name === commandName);
   }
   async loadPlugin(pluginPath, id) {
-    return this.loader.loadPlugin(pluginPath, id);
+    const before = new Set(this.core.loader.getSites().map((s) => s.name));
+    const instance = await this.loader.loadPlugin(pluginPath, id);
+    this.recordSiteAliases(basename(dirname3(pluginPath)), before);
+    return instance;
   }
   async unloadPlugin(id) {
     return this.loader.unloadPlugin(id);
@@ -8216,7 +8244,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-BVRFSUXU.js");
+    const { findTargetPage } = await import("./browser-I3EZY3FL.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8517,7 +8545,8 @@ async function executeChain(input, options) {
         const cmdArgs = parts.slice(1);
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(cmdName);
+        const resolvedName = loader.resolveSiteName(cmdName);
+        const site = resolvedName ? internalLoader.getSite(resolvedName) : void 0;
         if (site) {
           const subCommand = cmdArgs[0];
           if (!subCommand) {

package/dist/{chunk-7OP2ISEY.js → chunk-UR3R5LWF.js}

@@ -712,6 +712,61 @@ async function scrollIntoView(page, selector) {
   `);
 }
 
+// src/cdp-driver/editor-profile.ts
+function buildEditorProbe(selector) {
+  return `(function() {
+    const el = ${selector};
+    if (!el) return { react: false, richFamily: null, contenteditable: false, controlled: false };
+    const editable = el.closest('[contenteditable="true"]');
+    const host = editable || el;
+    // React fiber\uFF1A\u5143\u7D20\u81EA\u6709\u952E\u626B\u63CF\uFF08interaction.ts \u9875\u9762\u7EA7\u63A2\u6D4B\u7684\u5143\u7D20\u7EA7\u6536\u7A84\uFF09
+    let react = false;
+    try {
+      for (const k of Object.keys(host)) {
+        if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+      }
+      if (!react && host.parentElement) {
+        for (const k of Object.keys(host.parentElement)) {
+          if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+        }
+      }
+    } catch (e) { /* \u8DE8\u57DF/\u6743\u9650\u515C\u5E95 */ }
+    // \u5DF2\u77E5\u7F16\u8F91\u5668\u5BB6\u65CF\uFF08\u81EA\u7814 Draft \u7CFB\u6700\u5371\u9669\u2014\u2014EditorState \u5F3A\u53D7\u63A7\uFF09
+    const families = [
+      ['.public-DraftEditor-content', 'draft'],
+      ['.DraftEditor-editorContainer', 'draft'],
+      ['.ProseMirror', 'prosemirror'],
+      ['.ql-editor', 'quill'],
+      ['.CodeMirror', 'codemirror'],
+      ['.cm-editor', 'codemirror'],
+      ['[data-slate-editor]', 'slate'],
+      ['.jsx-lexical', 'lexical'],
+      ['.contenteditable-editor', 'generic-rich'],
+    ];
+    let richFamily = null;
+    for (const [sel, name] of families) {
+      if (host.closest(sel)) { richFamily = name; break; }
+    }
+    const contenteditable = !!editable && el.tagName !== 'INPUT' && el.tagName !== 'TEXTAREA';
+    return {
+      react,
+      richFamily,
+      contenteditable,
+      controlled: react || !!richFamily || contenteditable,
+    };
+  })()`;
+}
+async function probeEditor(evaluate, selector) {
+  const fallback = { react: false, richFamily: null, contenteditable: false, controlled: false };
+  try {
+    const r = await evaluate(buildEditorProbe(selector));
+    if (r && typeof r === "object") return r;
+    return fallback;
+  } catch {
+    return fallback;
+  }
+}
+
 // src/cdp-driver/locator.ts
 var XBLocatorImpl = class _XBLocatorImpl {
   page;
@@ -785,19 +840,51 @@ var XBLocatorImpl = class _XBLocatorImpl {
         if ((el.value || el.textContent || '') !== '') document.execCommand('selectAll');
       })()
     `);
-    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+    const profile = await probeEditor(
+      (expr) => this.page.evaluate(expr),
+      this._q(this.selector)
+    );
+    const verifyMs = parseInt(process.env.XBROWSER_FILL_VERIFY_MS ?? "600", 10) || 600;
+    const readValue = () => this.page.evaluate(
+      `(function(){ const el = ${this._q(this.selector)}; if (!el) return ''; const v = el.value !== undefined ? el.value : el.textContent; return v || ''; })()`
+    );
+    const survived = async (expected) => {
+      await this.page.waitForTimeout(verifyMs);
+      const got = await readValue();
+      return !(got === "" || got.length < expected.length * 0.5);
+    };
+    const canFastPath = process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type" && !profile.controlled;
+    if (canFastPath) {
       try {
         const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-BOL2GP2E.js");
         await pasteViaClipboard(this.page, value);
         const got = await this.page.evaluate(
           `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
         );
-        if (got === value) return;
-        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+        if (got === value && await survived(value)) return;
+        const syn = await syntheticPaste(this.page, this._q(this.selector), value);
+        if (syn && await survived(value)) return;
       } catch {
       }
     }
     await this.page.keyboard.type(value, { stealth: true });
+    if (profile.controlled && verifyMs > 0 && !await survived(value)) {
+      await this.click({ ...opts });
+      await this.page.evaluate(`
+        (function() {
+          const el = ${this._q(this.selector)};
+          if (!el) return;
+          if (document.activeElement !== el) el.focus();
+          document.execCommand('selectAll');
+        })()
+      `);
+      await this.page.keyboard.type(value, { stealth: true });
+      if (!await survived(value)) {
+        throw new Error(
+          `input not retained: \u53D7\u63A7\u7F16\u8F91\u5668\u5728\u952E\u76D8\u6D41\u540E\u4ECD\u6E05\u7A7A\u6CE8\u5165\u503C\uFF08\u5347\u7EA7\u4EBA\u5DE5\u6216\u68C0\u67E5\u7AD9\u70B9\u88C1\u51B3\u903B\u8F91\uFF1B\u53EF\u8C03 XBROWSER_FILL_VERIFY_MS\uFF09`
+        );
+      }
+    }
     return;
     await this.page.evaluate(`
       (function() {

package/dist/{chunk-IFKJO2UR.js → chunk-X735U7G7.js}

@@ -715,6 +715,61 @@ async function scrollIntoView(page, selector) {
   `);
 }
 
+// src/cdp-driver/editor-profile.ts
+function buildEditorProbe(selector) {
+  return `(function() {
+    const el = ${selector};
+    if (!el) return { react: false, richFamily: null, contenteditable: false, controlled: false };
+    const editable = el.closest('[contenteditable="true"]');
+    const host = editable || el;
+    // React fiber\uFF1A\u5143\u7D20\u81EA\u6709\u952E\u626B\u63CF\uFF08interaction.ts \u9875\u9762\u7EA7\u63A2\u6D4B\u7684\u5143\u7D20\u7EA7\u6536\u7A84\uFF09
+    let react = false;
+    try {
+      for (const k of Object.keys(host)) {
+        if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+      }
+      if (!react && host.parentElement) {
+        for (const k of Object.keys(host.parentElement)) {
+          if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { react = true; break; }
+        }
+      }
+    } catch (e) { /* \u8DE8\u57DF/\u6743\u9650\u515C\u5E95 */ }
+    // \u5DF2\u77E5\u7F16\u8F91\u5668\u5BB6\u65CF\uFF08\u81EA\u7814 Draft \u7CFB\u6700\u5371\u9669\u2014\u2014EditorState \u5F3A\u53D7\u63A7\uFF09
+    const families = [
+      ['.public-DraftEditor-content', 'draft'],
+      ['.DraftEditor-editorContainer', 'draft'],
+      ['.ProseMirror', 'prosemirror'],
+      ['.ql-editor', 'quill'],
+      ['.CodeMirror', 'codemirror'],
+      ['.cm-editor', 'codemirror'],
+      ['[data-slate-editor]', 'slate'],
+      ['.jsx-lexical', 'lexical'],
+      ['.contenteditable-editor', 'generic-rich'],
+    ];
+    let richFamily = null;
+    for (const [sel, name] of families) {
+      if (host.closest(sel)) { richFamily = name; break; }
+    }
+    const contenteditable = !!editable && el.tagName !== 'INPUT' && el.tagName !== 'TEXTAREA';
+    return {
+      react,
+      richFamily,
+      contenteditable,
+      controlled: react || !!richFamily || contenteditable,
+    };
+  })()`;
+}
+async function probeEditor(evaluate, selector) {
+  const fallback = { react: false, richFamily: null, contenteditable: false, controlled: false };
+  try {
+    const r = await evaluate(buildEditorProbe(selector));
+    if (r && typeof r === "object") return r;
+    return fallback;
+  } catch {
+    return fallback;
+  }
+}
+
 // src/cdp-driver/locator.ts
 var XBLocatorImpl = class _XBLocatorImpl {
   page;
@@ -788,19 +843,51 @@ var XBLocatorImpl = class _XBLocatorImpl {
         if ((el.value || el.textContent || '') !== '') document.execCommand('selectAll');
       })()
     `);
-    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+    const profile = await probeEditor(
+      (expr) => this.page.evaluate(expr),
+      this._q(this.selector)
+    );
+    const verifyMs = parseInt(process.env.XBROWSER_FILL_VERIFY_MS ?? "600", 10) || 600;
+    const readValue = () => this.page.evaluate(
+      `(function(){ const el = ${this._q(this.selector)}; if (!el) return ''; const v = el.value !== undefined ? el.value : el.textContent; return v || ''; })()`
+    );
+    const survived = async (expected) => {
+      await this.page.waitForTimeout(verifyMs);
+      const got = await readValue();
+      return !(got === "" || got.length < expected.length * 0.5);
+    };
+    const canFastPath = process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type" && !profile.controlled;
+    if (canFastPath) {
       try {
         const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-BOL2GP2E.js");
         await pasteViaClipboard(this.page, value);
         const got = await this.page.evaluate(
           `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
         );
-        if (got === value) return;
-        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+        if (got === value && await survived(value)) return;
+        const syn = await syntheticPaste(this.page, this._q(this.selector), value);
+        if (syn && await survived(value)) return;
       } catch {
       }
     }
     await this.page.keyboard.type(value, { stealth: true });
+    if (profile.controlled && verifyMs > 0 && !await survived(value)) {
+      await this.click({ ...opts });
+      await this.page.evaluate(`
+        (function() {
+          const el = ${this._q(this.selector)};
+          if (!el) return;
+          if (document.activeElement !== el) el.focus();
+          document.execCommand('selectAll');
+        })()
+      `);
+      await this.page.keyboard.type(value, { stealth: true });
+      if (!await survived(value)) {
+        throw new Error(
+          `input not retained: \u53D7\u63A7\u7F16\u8F91\u5668\u5728\u952E\u76D8\u6D41\u540E\u4ECD\u6E05\u7A7A\u6CE8\u5165\u503C\uFF08\u5347\u7EA7\u4EBA\u5DE5\u6216\u68C0\u67E5\u7AD9\u70B9\u88C1\u51B3\u903B\u8F91\uFF1B\u53EF\u8C03 XBROWSER_FILL_VERIFY_MS\uFF09`
+        );
+      }
+    }
     return;
     await this.page.evaluate(`
       (function() {

package/dist/cli.js

@@ -16,7 +16,7 @@ import {
   loadHooks,
   parsePluginParams,
   readJsonFile
-} from "./chunk-A7RZYSWM.js";
+} from "./chunk-SUHS2EWV.js";
 import "./chunk-JKVUFP3G.js";
 import {
   forwardCommandLog,
@@ -80,7 +80,7 @@ import {
   findSession,
   getAllSessions,
   saveSessionDiskMeta
-} from "./chunk-IFKJO2UR.js";
+} from "./chunk-X735U7G7.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";
 import {
@@ -629,6 +629,9 @@ async function installFromMarketplace(pluginsDir, slug, options) {
   const realSlug = String(plugin.slug || slug);
   try {
     await downloadAndExtractMarketplaceTarball(baseUrl, realSlug, tmpDir, targetDir);
+  } catch (err) {
+    safeCleanup5(targetDir);
+    throw err;
   } finally {
     safeCleanup5(tmpDir);
   }
@@ -802,6 +805,7 @@ function ensureIndexFile(plugin, name, targetDir) {
 }
 
 // src/plugin/installer.ts
+import { safeCleanup as safeCleanup6 } from "@dyyz1993/xcli-core";
 var PluginInstaller = class {
   pluginsDir;
   constructor(pluginsDir) {
@@ -827,31 +831,29 @@ var PluginInstaller = class {
     }
     mkdirSync4(targetDir, { recursive: true });
     const resolvedSource = type === "npm" ? await resolveNpmPackageWithFallback(source) : source;
+    const withCleanup = async (fn) => {
+      try {
+        const r = await fn();
+        await this.fixSharedDeps(targetDir);
+        ensurePluginDependencies(this.pluginsDir);
+        if (!existsSync6(resolve6(targetDir, "index.ts")) && !existsSync6(resolve6(targetDir, "index.js"))) {
+          throw new Error("installed package has no index.ts/js entry");
+        }
+        return r;
+      } catch (err) {
+        safeCleanup6(targetDir);
+        throw err;
+      }
+    };
     switch (type) {
       case "local":
-        return await installFromLocal(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromLocal(source, name, targetDir));
       case "npm":
-        return await installFromNpm(resolvedSource, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromNpm(resolvedSource, name, targetDir));
       case "git":
-        return await installFromGit(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromGit(source, name, targetDir));
       case "url":
-        return await installFromUrl(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromUrl(source, name, targetDir));
     }
   }
   /**
@@ -5816,7 +5818,14 @@ async function routeCommand(argvIn, stdinCommands) {
       default: {
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(command);
+        const resolvedSiteName = loader.resolveSiteName(command);
+        const site = resolvedSiteName ? internalLoader.getSite(resolvedSiteName) : void 0;
+        if (site && resolvedSiteName !== command) {
+          if (mode !== "json" && mode !== "yaml") {
+            process.stderr.write(`\u2139\uFE0F "${command}" \u7684\u547D\u4EE4\u540D\u662F "${resolvedSiteName}"\uFF08\u63D2\u4EF6\u76EE\u5F55\u540D\u4E0E\u7AD9\u70B9\u540D\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u6620\u5C04\uFF09
+`);
+          }
+        }
         if (!site) {
           const globalFlagSet = /* @__PURE__ */ new Set(["--session", "--cdp", "--json", "--yaml", "--help", "-h", "--version", "--output", "-o"]);
           const cleanParts = [];
@@ -6007,7 +6016,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage } = await import("./browser-BVRFSUXU.js");
+              const { setActivePage } = await import("./browser-I3EZY3FL.js");
               setActivePage(session, targetPage);
             }
           }
@@ -6272,7 +6281,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-YVMWMNHD.js");
+  const { startMcpStdio } = await import("./server-A5R4OIGX.js");
   startMcpStdio();
 }
 
@@ -6291,7 +6300,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve" || command === "mcp";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-BVRFSUXU.js");
+      const { ensureProcessCanExit } = await import("./browser-I3EZY3FL.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(process.exitCode || exitCode);

package/dist/daemon-main.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-JKVUFP3G.js";
 import {
   getPluginLoader
-} from "./chunk-A3MORKYR.js";
+} from "./chunk-OSZNJT4U.js";
 import {
   version
 } from "./chunk-43TEMG4U.js";
@@ -38,10 +38,10 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-T4WTKBWI.js";
+} from "./chunk-ROAXLDV7.js";
 import {
   createRuleEngine
-} from "./chunk-4OU37CXP.js";
+} from "./chunk-BH3GIMWE.js";
 import {
   queryJS
 } from "./chunk-A7NEA4PA.js";
@@ -74,6 +74,7 @@ var FAIL_CODES = {
   selectorNotFound: "RETRYABLE: selector-not-found",
   pageNotReady: "RETRYABLE: page-not-ready",
   elementGone: "RETRYABLE: element-gone",
+  inputNotRetained: "RETRYABLE: input-not-retained",
   captcha: "HUMAN: captcha",
   loginWall: "HUMAN: login-wall",
   permissionDenied: "FATAL: permission-denied",
@@ -93,6 +94,7 @@ function classifyFailure(message) {
   if (/selector|选择器|element not found|未找到元素|no such element|queryselector returned null/.test(msg))
     return pick(FAIL_CODES.selectorNotFound);
   if (/timeout|超时|timed out|waiting for/.test(msg)) return pick(FAIL_CODES.pageNotReady);
+  if (/not retained|清空了注入值|input-not-retained/.test(msg)) return pick(FAIL_CODES.inputNotRetained);
   if (/net::err|404|navigation failed|页面不存在|target closed|element-gone/.test(msg))
     return pick(FAIL_CODES.targetGone);
   return pick(FAIL_CODES.unknown);
@@ -7797,7 +7799,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-DSYUAE7H.js");
+    const { findTargetPage } = await import("./browser-WCHMUN6H.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8098,7 +8100,8 @@ async function executeChain(input, options) {
         const cmdArgs = parts.slice(1);
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(cmdName);
+        const resolvedName = loader.resolveSiteName(cmdName);
+        const site = resolvedName ? internalLoader.getSite(resolvedName) : void 0;
         if (site) {
           const subCommand = cmdArgs[0];
           if (!subCommand) {
@@ -9238,9 +9241,9 @@ function createRPCHandler() {
     return result;
   }
   async function handlePluginsReload() {
-    const { resetPluginLoader } = await import("./plugin-singleton-GJO7EZXB.js");
+    const { resetPluginLoader } = await import("./plugin-singleton-GGSBI3EG.js");
     resetPluginLoader();
-    const loader = await import("./plugin-singleton-GJO7EZXB.js").then((m) => m.getPluginLoader());
+    const loader = await import("./plugin-singleton-GGSBI3EG.js").then((m) => m.getPluginLoader());
     const sites = loader.getCore().loader.getSites();
     return { ok: true, plugins: sites.length };
   }
@@ -9636,7 +9639,7 @@ function createRPCHandler() {
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-N665T3G5.js");
+        const { SessionReplayer } = await import("./session-replayer-PSAPQBZA.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.d.ts

@@ -1634,6 +1634,8 @@ declare class XBrowserPluginLoader {
     private core;
     private loader;
     private options;
+    /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+    private dirSiteAliases;
     constructor(options?: PluginLoaderOptions);
     getAPI(): XCLIAPI;
     /**
@@ -1644,6 +1646,16 @@ declare class XBrowserPluginLoader {
     getPlugin(id: string): PluginInstance | undefined;
     getPluginStatus(id: string): PluginStatus;
     getLoadedPlugins(): PluginInstance[];
+    /**
+     * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+     * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+     * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+     * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+     * 插件 id 而非 site 名，不可用）。
+     */
+    resolveSiteName(name: string): string | undefined;
+    /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+    private recordSiteAliases;
     getPluginContract(siteName: string, commandName?: string): PluginContract | PluginCommandContract | undefined;
     loadPlugin(pluginPath: string, id?: string): Promise<PluginInstance>;
     unloadPlugin(id: string): Promise<void>;

package/dist/index.js

@@ -48,7 +48,7 @@ import {
   splitCommand,
   waitForAIResponse,
   waitForPage
-} from "./chunk-BROEUPL3.js";
+} from "./chunk-LTLMDKWG.js";
 import {
   SessionRecorder
 } from "./chunk-IR6C24P7.js";
@@ -63,7 +63,7 @@ import {
   getBrowser,
   resetForTesting,
   saveSessionDiskMeta
-} from "./chunk-2Q3GQRUP.js";
+} from "./chunk-PKXJST62.js";
 import "./chunk-JKVUFP3G.js";
 import {
   forwardCommandLog,
@@ -120,7 +120,7 @@ import {
   generateJSScript,
   generatePythonScript
 } from "./chunk-ETCO4SNK.js";
-import "./chunk-7OP2ISEY.js";
+import "./chunk-UR3R5LWF.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";
 import {
@@ -720,6 +720,9 @@ async function installFromMarketplace(pluginsDir, slug, options) {
   const realSlug = String(plugin.slug || slug);
   try {
     await downloadAndExtractMarketplaceTarball(baseUrl, realSlug, tmpDir, targetDir);
+  } catch (err) {
+    safeCleanup5(targetDir);
+    throw err;
   } finally {
     safeCleanup5(tmpDir);
   }
@@ -893,6 +896,7 @@ function ensureIndexFile(plugin, name, targetDir) {
 }
 
 // src/plugin/installer.ts
+import { safeCleanup as safeCleanup6 } from "@dyyz1993/xcli-core";
 var PluginInstaller = class {
   pluginsDir;
   constructor(pluginsDir) {
@@ -918,31 +922,29 @@ var PluginInstaller = class {
     }
     mkdirSync4(targetDir, { recursive: true });
     const resolvedSource = type === "npm" ? await resolveNpmPackageWithFallback(source) : source;
+    const withCleanup = async (fn) => {
+      try {
+        const r = await fn();
+        await this.fixSharedDeps(targetDir);
+        ensurePluginDependencies(this.pluginsDir);
+        if (!existsSync6(resolve6(targetDir, "index.ts")) && !existsSync6(resolve6(targetDir, "index.js"))) {
+          throw new Error("installed package has no index.ts/js entry");
+        }
+        return r;
+      } catch (err) {
+        safeCleanup6(targetDir);
+        throw err;
+      }
+    };
     switch (type) {
       case "local":
-        return await installFromLocal(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromLocal(source, name, targetDir));
       case "npm":
-        return await installFromNpm(resolvedSource, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromNpm(resolvedSource, name, targetDir));
       case "git":
-        return await installFromGit(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromGit(source, name, targetDir));
       case "url":
-        return await installFromUrl(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromUrl(source, name, targetDir));
     }
   }
   /**
@@ -5912,7 +5914,14 @@ async function routeCommand(argvIn, stdinCommands) {
       default: {
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(command);
+        const resolvedSiteName = loader.resolveSiteName(command);
+        const site = resolvedSiteName ? internalLoader.getSite(resolvedSiteName) : void 0;
+        if (site && resolvedSiteName !== command) {
+          if (mode !== "json" && mode !== "yaml") {
+            process.stderr.write(`\u2139\uFE0F "${command}" \u7684\u547D\u4EE4\u540D\u662F "${resolvedSiteName}"\uFF08\u63D2\u4EF6\u76EE\u5F55\u540D\u4E0E\u7AD9\u70B9\u540D\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u6620\u5C04\uFF09
+`);
+          }
+        }
         if (!site) {
           const globalFlagSet = /* @__PURE__ */ new Set(["--session", "--cdp", "--json", "--yaml", "--help", "-h", "--version", "--output", "-o"]);
           const cleanParts = [];
@@ -6103,7 +6112,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage } = await import("./browser-Q67BJTI2.js");
+              const { setActivePage } = await import("./browser-DFM2SQDM.js");
               setActivePage(session, targetPage);
             }
           }
@@ -6368,7 +6377,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-NPINOVJS.js");
+  const { startMcpStdio } = await import("./server-Y5VVPRC6.js");
   startMcpStdio();
 }
 
@@ -9283,7 +9292,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-WWO2UZDR.js");
+    const { launch } = await import("./cdp-driver-57QV7C5O.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{plugin-singleton-GJO7EZXB.js → plugin-singleton-GGSBI3EG.js}

@@ -1,7 +1,7 @@
 import {
   getPluginLoader,
   resetPluginLoader
-} from "./chunk-A3MORKYR.js";
+} from "./chunk-OSZNJT4U.js";
 import "./chunk-KFQGP6VL.js";
 export {
   getPluginLoader,

package/dist/{server-YVMWMNHD.js → server-A5R4OIGX.js}

@@ -1,12 +1,12 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-A7RZYSWM.js";
+} from "./chunk-SUHS2EWV.js";
 import "./chunk-JKVUFP3G.js";
 import "./chunk-3OD76SUE.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
-import "./chunk-IFKJO2UR.js";
+import "./chunk-X735U7G7.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{server-NPINOVJS.js → server-Y5VVPRC6.js}

@@ -1,13 +1,13 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-BROEUPL3.js";
-import "./chunk-2Q3GQRUP.js";
+} from "./chunk-LTLMDKWG.js";
+import "./chunk-PKXJST62.js";
 import "./chunk-JKVUFP3G.js";
 import "./chunk-3OD76SUE.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
-import "./chunk-7OP2ISEY.js";
+import "./chunk-UR3R5LWF.js";
 import "./chunk-GYB5BOSP.js";
 import "./chunk-MYH6FIBZ.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{session-replayer-N665T3G5.js → session-replayer-PSAPQBZA.js}

@@ -61,7 +61,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-DC7EIUG5.js");
+      const { launch } = await import("./cdp-driver-BFGFAVAN.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.24.0",
+  "version": "1.24.2",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {