adspower-browser 2.1.0 → 2.1.2-beta.1

package/README.MD

@@ -142,6 +142,8 @@ ads close-browser <profile_id>                   # Or JSON: profile_id? | profil
 ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"},...}'  # group_id + account field required; proxy optional (defaults to no_proxy; proxyid takes priority over user_proxy_config when both given)
 ads update-browser '{"profile_id":"...",...}'    # profile_id required
 ads delete-browser '{"profile_id":["..."]}'     # profile_id required
+ads get-recycle-bin-list '{}'                   # page?, limit? (1-100, default 1). Last 30 days only
+ads restore-recycle-bin '{"profile_id":"...","group_id":"123"}'  # profile_id or profile_no, group_id required
 ads get-browser-list '{}'                       # CLI defaults to page=1,limit=200. Or group_id?, limit?, page?, profile_id[]?, profile_no[]?, sort_type?, sort_order?, tag_ids?, tags_filter?, name?, name_filter?
 ads get-opened-browser                          # No params
 ```

package/cli/core/winHideChildProcess.js

@@ -1,30 +1,91 @@
 "use strict";
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// src/core/winHideChildProcessLogic.js
+var require_winHideChildProcessLogic = __commonJS({
+  "src/core/winHideChildProcessLogic.js"(exports2, module2) {
+    "use strict";
+    var path = require("path");
+    var CONSOLE_EXECUTABLES = /^(cmd|powershell|pwsh|wmic|tasklist|reg|findstr|where|whoami|systeminfo|netstat|sc|net|chcp|hostname|conhost)(\.exe)?$/i;
+    var BROWSER_EXECUTABLES = /^(sunbrowser|flowerbrowser|chrome|chromium|msedge|firefox|brave|opera)(\.exe)?$/i;
+    function getExecutableBaseName(command) {
+      const trimmed = String(command).trim();
+      let executable = trimmed;
+      const quotedMatch = trimmed.match(/^"([^"]+)"|^'([^']+)'/);
+      if (quotedMatch) {
+        executable = quotedMatch[1] || quotedMatch[2];
+      } else {
+        executable = trimmed.split(/\s+/)[0] || trimmed;
+      }
+      executable = executable.replace(/^["']|["']$/g, "");
+      return path.basename(executable.replace(/\\/g, "/")).toLowerCase();
+    }
+    function shouldHideForSpawn(command, options) {
+      if (options?.windowsHide === false) {
+        return false;
+      }
+      const base = getExecutableBaseName(command);
+      if (BROWSER_EXECUTABLES.test(base)) {
+        return false;
+      }
+      if (CONSOLE_EXECUTABLES.test(base)) {
+        return true;
+      }
+      if (options?.shell) {
+        return true;
+      }
+      if (/\.(cmd|bat)$/i.test(base)) {
+        return true;
+      }
+      return false;
+    }
+    function withWindowsHideForExec2(options) {
+      if (typeof options === "object" && options !== null && !Array.isArray(options)) {
+        if (options.windowsHide === false) {
+          return options;
+        }
+        return { ...options, windowsHide: true };
+      }
+      return { windowsHide: true };
+    }
+    function withWindowsHideForSpawn2(command, options) {
+      const opts = typeof options === "object" && options !== null && !Array.isArray(options) ? { ...options } : {};
+      if (!shouldHideForSpawn(command, opts)) {
+        return opts;
+      }
+      return { ...opts, windowsHide: true };
+    }
+    module2.exports = {
+      CONSOLE_EXECUTABLES,
+      BROWSER_EXECUTABLES,
+      getExecutableBaseName,
+      shouldHideForSpawn,
+      withWindowsHideForExec: withWindowsHideForExec2,
+      withWindowsHideForSpawn: withWindowsHideForSpawn2
+    };
+  }
+});
 
 // src/core/winHideChildProcess.js
 if (process.platform !== "win32") {
   return;
 }
 var cp = require("child_process");
-function withWindowsHide(options) {
-  if (typeof options === "object" && options !== null && !Array.isArray(options)) {
-    if (options.windowsHide === false) {
-      return options;
-    }
-    return { ...options, windowsHide: true };
-  }
-  return { windowsHide: true };
-}
+var { withWindowsHideForExec, withWindowsHideForSpawn } = require_winHideChildProcessLogic();
 function normalizeExecArgs(options, callback) {
   if (typeof options === "function") {
-    return { options: { windowsHide: true }, callback: options };
+    return { options: withWindowsHideForExec({}), callback: options };
   }
-  return { options: withWindowsHide(options || {}), callback };
+  return { options: withWindowsHideForExec(options || {}), callback };
 }
-function normalizeSpawnArgs(args, options) {
+function normalizeSpawnArgs(command, args, options) {
   if (Array.isArray(args)) {
-    return { args, options: withWindowsHide(options || {}) };
+    return { args, options: withWindowsHideForSpawn(command, options || {}) };
   }
-  return { args: [], options: withWindowsHide(args || {}) };
+  return { args: [], options: withWindowsHideForSpawn(command, args || {}) };
 }
 var origExec = cp.exec.bind(cp);
 cp.exec = function exec(cmd, options, callback) {
@@ -33,15 +94,15 @@ cp.exec = function exec(cmd, options, callback) {
 };
 var origExecSync = cp.execSync.bind(cp);
 cp.execSync = function execSync(cmd, options) {
-  return origExecSync(cmd, withWindowsHide(options || {}));
+  return origExecSync(cmd, withWindowsHideForExec(options || {}));
 };
 var origSpawn = cp.spawn.bind(cp);
 cp.spawn = function spawn(command, args, options) {
-  const normalized = normalizeSpawnArgs(args, options);
+  const normalized = normalizeSpawnArgs(command, args, options);
   return origSpawn(command, normalized.args, normalized.options);
 };
 var origSpawnSync = cp.spawnSync.bind(cp);
 cp.spawnSync = function spawnSync(command, args, options) {
-  const normalized = normalizeSpawnArgs(args, options);
+  const normalized = normalizeSpawnArgs(command, args, options);
   return origSpawnSync(command, normalized.args, normalized.options);
 };

package/cli/core/winHideChildProcessLogic.js

@@ -0,0 +1,61 @@
+"use strict";
+
+// src/core/winHideChildProcessLogic.js
+var path = require("path");
+var CONSOLE_EXECUTABLES = /^(cmd|powershell|pwsh|wmic|tasklist|reg|findstr|where|whoami|systeminfo|netstat|sc|net|chcp|hostname|conhost)(\.exe)?$/i;
+var BROWSER_EXECUTABLES = /^(sunbrowser|flowerbrowser|chrome|chromium|msedge|firefox|brave|opera)(\.exe)?$/i;
+function getExecutableBaseName(command) {
+  const trimmed = String(command).trim();
+  let executable = trimmed;
+  const quotedMatch = trimmed.match(/^"([^"]+)"|^'([^']+)'/);
+  if (quotedMatch) {
+    executable = quotedMatch[1] || quotedMatch[2];
+  } else {
+    executable = trimmed.split(/\s+/)[0] || trimmed;
+  }
+  executable = executable.replace(/^["']|["']$/g, "");
+  return path.basename(executable.replace(/\\/g, "/")).toLowerCase();
+}
+function shouldHideForSpawn(command, options) {
+  if (options?.windowsHide === false) {
+    return false;
+  }
+  const base = getExecutableBaseName(command);
+  if (BROWSER_EXECUTABLES.test(base)) {
+    return false;
+  }
+  if (CONSOLE_EXECUTABLES.test(base)) {
+    return true;
+  }
+  if (options?.shell) {
+    return true;
+  }
+  if (/\.(cmd|bat)$/i.test(base)) {
+    return true;
+  }
+  return false;
+}
+function withWindowsHideForExec(options) {
+  if (typeof options === "object" && options !== null && !Array.isArray(options)) {
+    if (options.windowsHide === false) {
+      return options;
+    }
+    return { ...options, windowsHide: true };
+  }
+  return { windowsHide: true };
+}
+function withWindowsHideForSpawn(command, options) {
+  const opts = typeof options === "object" && options !== null && !Array.isArray(options) ? { ...options } : {};
+  if (!shouldHideForSpawn(command, opts)) {
+    return opts;
+  }
+  return { ...opts, windowsHide: true };
+}
+module.exports = {
+  CONSOLE_EXECUTABLES,
+  BROWSER_EXECUTABLES,
+  getExecutableBaseName,
+  shouldHideForSpawn,
+  withWindowsHideForExec,
+  withWindowsHideForSpawn
+};

package/cli/index.js

@@ -610,6 +610,23 @@ var LOCAL_API_CONTRACTS = {
       profile_id: { apiName: "profile_id", location: "body" }
     }
   },
+  "get-recycle-bin-list": {
+    method: "POST",
+    path: "/api/v2/browser-profile/recycle-bin/list",
+    params: {
+      page: { apiName: "page", location: "body", default: 1 },
+      limit: { apiName: "limit", location: "body", default: 1 }
+    }
+  },
+  "restore-recycle-bin": {
+    method: "POST",
+    path: "/api/v2/browser-profile/recycle-bin/restore",
+    params: {
+      profile_id: { apiName: "profile_id", location: "body" },
+      profile_no: { apiName: "profile_no", location: "body" },
+      group_id: { apiName: "group_id", location: "body" }
+    }
+  },
   "get-browser-list": {
     method: "POST",
     path: "/api/v2/browser-profile/list",
@@ -881,6 +898,8 @@ var API_ENDPOINTS = {
   GET_BROWSER_LIST: LOCAL_API_CONTRACTS["get-browser-list"].path,
   UPDATE_BROWSER: LOCAL_API_CONTRACTS["update-browser"].path,
   DELETE_BROWSER: LOCAL_API_CONTRACTS["delete-browser"].path,
+  GET_RECYCLE_BIN_LIST: LOCAL_API_CONTRACTS["get-recycle-bin-list"].path,
+  RESTORE_RECYCLE_BIN: LOCAL_API_CONTRACTS["restore-recycle-bin"].path,
   GET_PROFILE_COOKIES: LOCAL_API_CONTRACTS["get-profile-cookies"].path,
   GET_PROFILE_UA: LOCAL_API_CONTRACTS["get-profile-ua"].path,
   CLOSE_ALL_PROFILES: LOCAL_API_CONTRACTS["close-all-profiles"].path,
@@ -907,12 +926,16 @@ var API_ENDPOINTS = {
   GET_KERNEL_LIST: LOCAL_API_CONTRACTS["get-kernel-list"].path,
   UPDATE_PATCH: LOCAL_API_CONTRACTS["update-patch"].path
 };
+var createClientHeaders = (apiKey) => ({
+  ...apiKey ? { Authorization: `Bearer ${apiKey}` } : {},
+  "x-mcp-client": "mcp"
+});
 var apiClient = import_axios2.default.create({
-  headers: API_KEY ? { "Authorization": `Bearer ${API_KEY}` } : {}
+  headers: createClientHeaders(API_KEY)
 });
 var getApiClient = () => {
   const client = import_axios2.default.create({
-    headers: CONFIG.apiKey ? { "Authorization": `Bearer ${CONFIG.apiKey}` } : {}
+    headers: createClientHeaders(CONFIG.apiKey)
   });
   client.interceptors.request.use(async (config2) => {
     if (isLocalApiRequestUrl(config2.url)) {
@@ -955,6 +978,18 @@ var TOOL_INTENT_BY_NAME = {
     triggersEn: "remove profile, delete account, trash browser",
     triggersZh: "\u5220\u9664\u73AF\u5883,\u79FB\u9664profile,\u5220\u6389\u6D4F\u89C8\u5668\u8D26\u53F7"
   },
+  "get-recycle-bin-list": {
+    intentEn: "List browser profiles in the recycle bin from the last 30 days.",
+    intentZh: "\u67E5\u8BE2\u8FD1 30 \u5929\u56DE\u6536\u7AD9\u4E2D\u7684\u6D4F\u89C8\u5668\u73AF\u5883\u3002",
+    triggersEn: "recycle bin, deleted profiles, trash list, recently deleted",
+    triggersZh: "\u56DE\u6536\u7AD9,\u5DF2\u5220\u9664\u73AF\u5883,\u6700\u8FD1\u5220\u9664,\u5783\u573E\u6876\u5217\u8868"
+  },
+  "restore-recycle-bin": {
+    intentEn: "Restore one deleted browser profile from the recycle bin into a target group.",
+    intentZh: "\u628A\u56DE\u6536\u7AD9\u91CC\u7684\u4E00\u4E2A\u73AF\u5883\u6062\u590D\u5230\u6307\u5B9A\u5206\u7EC4\u3002",
+    triggersEn: "restore profile, recover deleted browser, undelete environment",
+    triggersZh: "\u6062\u590D\u73AF\u5883,\u8FD8\u539F\u56DE\u6536\u7AD9,\u627E\u56DE\u5DF2\u5220\u9664\u73AF\u5883"
+  },
   "get-browser-list": {
     intentEn: "List or search browser profiles (pagination, filters).",
     intentZh: "\u5206\u9875/\u6761\u4EF6\u67E5\u8BE2\u6D4F\u89C8\u5668 profile \u5217\u8868\u3002",
@@ -1312,6 +1347,51 @@ function resolveOpenBrowserHeadless(params, env, platform) {
   };
 }
 
+// ../core/src/utils/systemVer.ts
+var import_os = __toESM(require("os"));
+function getUaSystemVersionFromOs(info = {}) {
+  const platform = info.platform ?? import_os.default.platform();
+  const release = info.release ?? import_os.default.release();
+  if (platform === "linux") {
+    return "Linux";
+  }
+  if (platform === "win32") {
+    return matchWindowsVersion(release);
+  }
+  if (platform === "darwin") {
+    return matchMacVersion(release);
+  }
+  return null;
+}
+function matchWindowsVersion(release) {
+  const [majorStr, minorStr = "0", buildStr = "0"] = release.split(".");
+  const major = Number(majorStr);
+  const minor = Number(minorStr);
+  const build = Number(buildStr);
+  if (major === 6) {
+    if (minor === 1) return "Windows 7";
+    if (minor === 2 || minor === 3) return "Windows 8";
+  }
+  if (major === 10 && minor === 0) {
+    return build >= 22e3 ? "Windows 11" : "Windows 10";
+  }
+  return "Windows";
+}
+function matchMacVersion(release) {
+  const darwinMajor = Number(release.split(".")[0]);
+  if (darwinMajor < 20) return "Mac OS X 10";
+  const darwinToMac = {
+    20: "Mac OS X 11",
+    21: "Mac OS X 12",
+    22: "Mac OS X 13",
+    23: "Mac OS X 14",
+    24: "Mac OS X 15",
+    25: "Mac OS X 26"
+    // macOS Tahoe 26，Darwin 仍为 25.x
+  };
+  return darwinToMac[darwinMajor] ?? "Mac OS X";
+}
+
 // ../core/src/handlers/browser.ts
 var browserHandlers = {
   async openBrowser(params) {
@@ -1336,7 +1416,23 @@ var browserHandlers = {
     throw new Error(response.data.msg);
   },
   async createBrowser(params) {
-    const requestBody = buildRequestBodyFor("create-browser", params);
+    let resolvedParams = params;
+    if (!params.fingerprint_config?.random_ua?.ua_system_version) {
+      const uaSystemVersion = getUaSystemVersionFromOs();
+      if (uaSystemVersion) {
+        resolvedParams = {
+          ...params,
+          fingerprint_config: {
+            ...params.fingerprint_config,
+            random_ua: {
+              ...params.fingerprint_config?.random_ua,
+              ua_system_version: [uaSystemVersion]
+            }
+          }
+        };
+      }
+    }
+    const requestBody = buildRequestBodyFor("create-browser", resolvedParams);
     const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CREATE_BROWSER}`, requestBody);
     if (response.data.code === 0) {
       return JSON.stringify(response.data.data, null, 2);
@@ -1361,6 +1457,26 @@ var browserHandlers = {
     }
     throw new Error(response.data.msg);
   },
+  async getRecycleBinList(params) {
+    const response = await getApiClient().post(
+      `${getLocalApiBase()}${API_ENDPOINTS.GET_RECYCLE_BIN_LIST}`,
+      buildRequestBodyFor("get-recycle-bin-list", params)
+    );
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async restoreRecycleBin(params) {
+    const response = await getApiClient().post(
+      `${getLocalApiBase()}${API_ENDPOINTS.RESTORE_RECYCLE_BIN}`,
+      buildRequestBodyFor("restore-recycle-bin", params)
+    );
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
   async getBrowserList(params) {
     const requestBody = buildRequestBodyFor("get-browser-list", params);
     const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_BROWSER_LIST}`, requestBody);
@@ -1598,7 +1714,7 @@ var tagHandlers = {
 
 // ../core/src/handlers/automation.ts
 var import_path2 = __toESM(require("path"));
-var import_os = __toESM(require("os"));
+var import_os2 = __toESM(require("os"));
 
 // ../core/src/utils/browserBase.ts
 var import_playwright_core = require("playwright-core");
@@ -1651,7 +1767,7 @@ var BrowserBase = class {
 var browserBase_default = new BrowserBase();
 
 // ../core/src/handlers/automation.ts
-var defaultDownloadsPath = import_path2.default.join(import_os.default.homedir(), "Downloads");
+var defaultDownloadsPath = import_path2.default.join(import_os2.default.homedir(), "Downloads");
 
 // ../core/src/handlers/kernel.ts
 var kernelHandlers = {
@@ -1805,6 +1921,7 @@ var randomUaConfigSchema = import_zod.z.object({
       "Mac OS X 13",
       "Mac OS X 14",
       "Mac OS X 15",
+      "Mac OS X 26",
       "Mac OS X",
       "Windows",
       "iOS",
@@ -2212,7 +2329,7 @@ var schemas = {
     ipchecker: import_zod.z.enum(["ip2location", "ipapi", "ipfoxy"]).optional().describe("IP query channel"),
     category_id: import_zod.z.string().optional().describe("The category id of the browser, you can use the get-application-list tool to get the application list"),
     profile_tag_ids: import_zod.z.array(import_zod.z.string()).max(30).optional().describe('Tag IDs to assign to the profile, max 30 tags per profile. Example: ["tag1","tag2"]'),
-    fingerprint_config: fingerprintConfigSchema.optional().default({ random_ua: { ua_system_version: ["Windows"] }, browser_kernel_config: { version: "latest", type: "chrome" } }),
+    fingerprint_config: fingerprintConfigSchema.optional().default({ browser_kernel_config: { version: "latest", type: "chrome" } }),
     platform_account: platformAccountSchema
   }).strict(),
   updateBrowserSchema: import_zod.z.object({
@@ -2272,6 +2389,17 @@ var schemas = {
   deleteBrowserSchema: import_zod.z.object({
     profile_id: import_zod.z.array(import_zod.z.string()).describe("The profile ids of the browsers to delete, it is required when you want to delete the browser")
   }).strict(),
+  getRecycleBinListSchema: import_zod.z.object({
+    page: import_zod.z.number().int().min(1).optional().describe("Page number. Defaults to 1. Only profiles deleted in the last 30 days and visible to the caller are returned."),
+    limit: import_zod.z.number().int().min(1).max(100).optional().describe("Profiles per page, range 1-100. Defaults to 1 when omitted.")
+  }).strict(),
+  restoreRecycleBinSchema: import_zod.z.object({
+    profile_id: import_zod.z.string().optional().describe("Profile ID in the recycle bin. Either profile_id or profile_no is required. If both are provided, profile_id takes priority."),
+    profile_no: import_zod.z.string().regex(/^\d+$/, "Profile number must be a numeric string").optional().describe("Profile serial number in the recycle bin. Either profile_id or profile_no is required. If both are provided, profile_id takes priority."),
+    group_id: import_zod.z.string().regex(/^\d+$/, "Group ID must be a numeric string").describe('Target group ID after restore. Use get-group-list to find a group the caller can use. "0" is ungrouped.')
+  }).strict().refine((data) => data.profile_id || data.profile_no, {
+    message: "Either profile_id or profile_no must be provided"
+  }),
   getBrowserListSchema: import_zod.z.object({
     group_id: import_zod.z.string().regex(/^\d+$/, "Group ID must be a numeric string").optional().describe("Query by group ID; searches all groups if empty"),
     limit: import_zod.z.number().min(1).max(200).optional().describe("Profiles per page, range 1 ~ 200. If omitted the CLI sends limit=200; the Local API itself defaults to only 1, so always rely on this CLI default or pass an explicit value"),
@@ -2541,6 +2669,16 @@ var STATELESS_HANDLERS = {
     description: buildCliCommandDescription("delete-browser", "Delete the browser"),
     paramsDescription: schemaParamsDescription(schemas.deleteBrowserSchema, "delete-browser")
   },
+  "get-recycle-bin-list": {
+    fn: browserHandlers.getRecycleBinList,
+    description: buildCliCommandDescription("get-recycle-bin-list", "List browser profiles in the recycle bin from the last 30 days"),
+    paramsDescription: schemaParamsDescription(schemas.getRecycleBinListSchema, "get-recycle-bin-list")
+  },
+  "restore-recycle-bin": {
+    fn: browserHandlers.restoreRecycleBin,
+    description: buildCliCommandDescription("restore-recycle-bin", "Restore a deleted browser profile from the recycle bin into a group"),
+    paramsDescription: schemaParamsDescription(schemas.restoreRecycleBinSchema, "restore-recycle-bin")
+  },
   "get-browser-list": {
     fn: browserHandlers.getBrowserList,
     description: buildCliCommandDescription("get-browser-list", "Get the list of browsers"),
@@ -3050,9 +3188,6 @@ var startChild = (type) => {
         }
         if (text === "restart") {
           child && child.kill("SIGKILL");
-          store.setStoreValue("status", "restarting");
-          startChild("2").catch(() => {
-          });
         }
         if (text.indexOf("INTRANET_$$_") > -1) {
           const arr = text.split("_$$_");
@@ -3084,18 +3219,9 @@ var startChild = (type) => {
         process.exit(0);
       });
       child.on("exit", async (code, signal) => {
-        if (signal === "SIGKILL") {
-          await browsersKill();
-          store.clear();
-          removePidFile();
-        } else {
-          child = null;
-          await sleepTime(500);
-          startChild("2").then(() => {
-          }).catch(() => {
-            logError("[!] Restart failed");
-          });
-        }
+        await browsersKill();
+        store.clear();
+        removePidFile();
       });
       timer = setTimeout(() => {
         child && child.kill("SIGKILL");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspower-browser",
-  "version": "2.1.0",
+  "version": "2.1.2-beta.1",
   "main": "cli/index.js",
   "type": "commonjs",
   "bin": {