adspower-browser 1.0.2 → 2.0.0-beta.1

package/{build/cli.js → cli/index.js}

@@ -23,6 +23,521 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/index.ts
+var import_commander = require("commander");
+
+// src/store/index.ts
+var Store = class {
+  apiKey;
+  baseUrl;
+  nodeEnv;
+  apiPort;
+  appPort;
+  intranet;
+  rpaPid;
+  rpaPlusPid;
+  aiPid;
+  status;
+  pid;
+  constructor() {
+    this.apiKey = "";
+    this.baseUrl = "";
+    this.nodeEnv = "";
+    this.apiPort = "";
+    this.appPort = "";
+    this.intranet = "";
+    this.rpaPid = "";
+    this.rpaPlusPid = "";
+    this.aiPid = "";
+    this.status = "stop";
+    this.pid = "";
+  }
+  getStoreValue(key) {
+    if (key === "apiKey" && !this.apiKey) {
+      return process.env.ADS_API_KEY || "";
+    }
+    return this[key];
+  }
+  setStoreValue(key, value) {
+    this[key] = value;
+  }
+  clear() {
+    this.apiKey = "";
+    this.baseUrl = "";
+    this.nodeEnv = "";
+    this.apiPort = "";
+    this.appPort = "";
+    this.intranet = "";
+    this.rpaPid = "";
+    this.rpaPlusPid = "";
+    this.aiPid = "";
+    this.status = "stop";
+    this.pid = "";
+  }
+  getAllStoreValue() {
+    return {
+      apiKey: this.apiKey,
+      baseUrl: this.baseUrl,
+      nodeEnv: this.nodeEnv,
+      apiPort: this.apiPort,
+      appPort: this.appPort,
+      intranet: this.intranet,
+      rpaPid: this.rpaPid,
+      rpaPlusPid: this.rpaPlusPid,
+      aiPid: this.aiPid,
+      status: this.status,
+      pid: this.pid
+    };
+  }
+};
+var store = new Store();
+
+// src/core/start.ts
+var path2 = __toESM(require("path"));
+var import_node_child_process2 = require("child_process");
+
+// src/tools/index.ts
+var os = __toESM(require("os"));
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var crypto = __toESM(require("crypto"));
+var util = __toESM(require("util"));
+var import_node_child_process = require("child_process");
+var import_colors = require("colors");
+var import_fs_extra2 = require("fs-extra2");
+var VERSION = "1.0.0";
+var logError = (message) => {
+  console.error((0, import_colors.red)(message));
+};
+var logSuccess = (message) => {
+  console.log((0, import_colors.green)(message));
+};
+var logWarning = (message) => {
+  console.log((0, import_colors.yellow)(message));
+};
+var logInfo = (message) => {
+  console.log(message);
+};
+var sleepTime = (time) => new Promise((resolve) => {
+  setTimeout(() => {
+    resolve();
+  }, time);
+});
+var browsersKill = async () => {
+  await taskKillBrowser();
+  await taskKillFlowser();
+};
+var taskKillBrowser = () => new Promise((resolve) => {
+  const cmd = ["linux", "darwin"].includes(process.platform) ? 'pkill -u `whoami` -f "SunBrowser"' : "taskkill -PID SunBrowser.exe";
+  (0, import_node_child_process.exec)(cmd, (err) => {
+    if (err) {
+    }
+    resolve();
+  });
+});
+var taskKillFlowser = () => new Promise((resolve) => {
+  const cmd = ["linux", "darwin"].includes(process.platform) ? 'pkill -u `whoami` -f "FlowerBrowser"' : "taskkill -PID FlowerBrowser.exe";
+  (0, import_node_child_process.exec)(cmd, (err) => {
+    if (err) {
+    }
+    resolve();
+  });
+});
+var getHomedir = () => {
+  return (typeof os.homedir == "function" ? os.homedir() : process.env[process.platform == "win32" ? "USERPROFILE" : "HOME"]) || "~";
+};
+var getPidFileDir = () => {
+  const dir = path.join(getHomedir(), ".adspowerCli");
+  if (!fs.existsSync(dir)) {
+    (0, import_fs_extra2.ensureDirSync)(dir);
+  }
+  return dir;
+};
+var pidFileName = () => {
+  const md5 = crypto.createHash("md5").update(VERSION).digest("hex");
+  return md5;
+};
+var writePidFile = (config2) => {
+  const filePath = path.join(getPidFileDir(), pidFileName());
+  (0, import_fs_extra2.outputJsonSync)(filePath, config2 || {});
+};
+var readPidFile = () => {
+  const filePath = path.join(getPidFileDir(), pidFileName());
+  if (fs.existsSync(filePath)) {
+    return (0, import_fs_extra2.readJsonSync)(filePath);
+  }
+  return {};
+};
+var removePidFile = () => {
+  const filePath = path.join(getPidFileDir(), pidFileName());
+  if (fs.existsSync(filePath)) {
+    (0, import_fs_extra2.removeSync)(filePath);
+  }
+};
+var isRunning = (pid) => {
+  return new Promise((resolve) => {
+    if (pid) {
+      (0, import_node_child_process.exec)(
+        util.format(process.platform === "win32" ? 'tasklist /fi "PID eq %s" | findstr /i "node.exe"' : 'ps -f -p %s | grep "node"', pid),
+        function(err, stdout, stderr) {
+          resolve(!err && !!stdout.toString().trim());
+        }
+      );
+    } else {
+      resolve(false);
+    }
+  });
+};
+var ensureBrowserPath = () => {
+  const dir = path.join(__dirname, "../cwd/source", ".browser");
+  if (!fs.existsSync(dir)) {
+    (0, import_fs_extra2.ensureDirSync)(dir);
+  }
+};
+var getApiKeyAndPort = (options) => {
+  const apiKey = options.apiKey;
+  const port = options.port;
+  if (apiKey && port) {
+    return {
+      apiKey,
+      port
+    };
+  }
+  const result = {
+    apiKey,
+    port
+  };
+  const processInstance = readPidFile();
+  if (!apiKey) {
+    if (processInstance.apiKey) {
+      result.apiKey = processInstance.apiKey;
+    } else if (process.env.ADS_API_KEY) {
+      result.apiKey = process.env.ADS_API_KEY;
+    }
+  }
+  if (!port && processInstance.apiPort) {
+    result.port = processInstance.apiPort;
+  }
+  return result;
+};
+var hasRunning = async (options) => {
+  const { apiKey, port } = options;
+  if (apiKey && port) {
+    return true;
+  }
+  const processInstance = readPidFile();
+  if (processInstance.pid) {
+    return await isRunning(processInstance.pid);
+  }
+  return false;
+};
+var loadingFramesList = {
+  default: ["|", "/", "-", "\\"],
+  frames: ["\u2596", "\u2597", "\u2598", "\u2599", "\u259A", "\u259B", "\u259C", "\u259D", "\u259E", "\u259F"],
+  dotFrames: ["\u2840", "\u2844", "\u2846", "\u2847", "\u284F", "\u285F", "\u287F", "\u28FF", "\u28F7", "\u28F6", "\u28E6", "\u28E4", "\u28E0", "\u2880"]
+};
+var createLoading = (text) => {
+  if (!process.stdout.isTTY) {
+    return {
+      stop() {
+      }
+    };
+  }
+  let index = 0;
+  const frames = loadingFramesList.default;
+  process.stdout.write(`${frames[index]} ${text}`);
+  const timer = setInterval(() => {
+    index = (index + 1) % frames.length;
+    process.stdout.write(`\r${frames[index]} ${text}`);
+  }, 120);
+  return {
+    stop() {
+      clearInterval(timer);
+      process.stdout.write(`\r${" ".repeat(text.length + 2)}\r`);
+    }
+  };
+};
+var initSqlite3 = () => {
+  const sqliteFile = path.join(__dirname, "../cwd/lib", "node_sqlite3.node");
+  if (fs.existsSync(sqliteFile)) {
+    return;
+  }
+  const isMac = process.platform === "darwin";
+  const isLinux = process.platform === "linux";
+  const is32 = process.arch === "ia32";
+  const isArm = process.arch === "arm64";
+  const isX64 = process.arch === "x64";
+  const macFolder = isArm ? "arm64" : "mac";
+  const winFolder = is32 ? "ia32" : "x64";
+  const linuxFolder = isLinux && isX64 && "linux";
+  const sqliteFolder = isMac ? macFolder : isLinux ? linuxFolder : winFolder;
+  const dir = path.join(__dirname, `../sqlite/${sqliteFolder}`);
+  if (!fs.existsSync(dir)) {
+    throw new Error(`SQLite folder not found: ${dir}`);
+  } else {
+    const sqliteFile2 = path.join(dir, "node_sqlite3.node");
+    const cwdPath = path.join(__dirname, "../cwd/lib");
+    (0, import_fs_extra2.copySync)(sqliteFile2, path.join(cwdPath, "node_sqlite3.node"));
+    logSuccess(`[i] SQLite file initialized successfully!`);
+  }
+};
+var renderKernelProgress = (result) => {
+  const status = result.status || "pending";
+  const progress = ["completed", "installing"].includes(status) ? 100 : Math.max(0, Math.min(100, Number(result.progress) || 0));
+  if (!process.stdout.isTTY) {
+    logInfo(`Kernel progress: ${progress}% [${status}]`);
+    return;
+  }
+  const width = 30;
+  const filled = Math.round(progress / 100 * width);
+  const bar = `${"=".repeat(filled)}${"-".repeat(width - filled)}`;
+  process.stdout.write(`\r[${bar}] ${progress.toFixed(0).padStart(3, " ")}% ${status}     `);
+};
+var finishKernelProgress = () => {
+  if (process.stdout.isTTY) {
+    process.stdout.write("\n");
+  }
+};
+var trackKernelDownload = async (fnc, args) => {
+  while (true) {
+    const result = await fnc(args);
+    try {
+      const resultJson = JSON.parse(result.replace("Kernel download/update status: ", ""));
+      if (resultJson && resultJson.status && ["pending", "downloading", "completed", "installing", "failed"].includes(resultJson.status)) {
+        renderKernelProgress(resultJson);
+        if (["completed", "failed"].includes(resultJson.status)) {
+          finishKernelProgress();
+          return result;
+        }
+        await sleepTime(3e3);
+      } else {
+        return result;
+      }
+    } catch (error) {
+      return result;
+    }
+  }
+};
+
+// src/core/start.ts
+var getEnv = () => {
+  const env = {
+    ...process.env,
+    // 系统的环境变量信息
+    API_KEY: store.getStoreValue("apiKey"),
+    IS_CLOUD_BROWSER: true
+    // 云浏览器场景预留标识
+  };
+  if (store.getStoreValue("baseUrl")) {
+    env.BASE_URL = store.getStoreValue("baseUrl");
+  }
+  if (store.getStoreValue("nodeEnv")) {
+    env.NODE_ENV = store.getStoreValue("nodeEnv");
+  }
+  return env;
+};
+var startChild = (type) => {
+  let timer;
+  let child = null;
+  return new Promise(async (resolve, reject) => {
+    initSqlite3();
+    const processInstance = readPidFile();
+    if (processInstance && processInstance.pid) {
+      const isRun = await isRunning(processInstance.pid);
+      removePidFile();
+      if (isRun) {
+        process.kill(Number(processInstance.pid), "SIGKILL");
+        await sleepTime(1e3);
+      }
+    }
+    const env = Object.fromEntries(
+      Object.entries(getEnv()).map(([key, value]) => [key, value == null ? value : String(value)])
+    );
+    try {
+      const mainJs = path2.join(__dirname, "../cwd/lib", "main.min.js");
+      child = (0, import_node_child_process2.fork)(mainJs, {
+        env,
+        detached: true,
+        stdio: ["ignore", "ignore", "ignore", "ipc"]
+      });
+      ensureBrowserPath();
+      store.setStoreValue("status", "starting");
+      logSuccess(`[i] Adspower program is starting...`);
+      store.setStoreValue("pid", child?.pid?.toString() || "");
+      let isAppPortOk = false;
+      writePidFile(store.getAllStoreValue());
+      child.on("message", async (msg) => {
+        const text = String(msg);
+        if (text.indexOf("SERVER_PORT_$$_") === 0 && !isAppPortOk) {
+          const port = text.replace("SERVER_PORT_$$_", "").trim();
+          store.setStoreValue("appPort", port);
+          isAppPortOk = true;
+        }
+        if (text.indexOf("START_API_SERVER_SUCCESS_$$_") === 0) {
+          const port = text.replace("START_API_SERVER_SUCCESS_$$_", "").trim();
+          store.setStoreValue("apiPort", port);
+          logSuccess(`Server running at:`);
+          logSuccess(` - local: http://local.adspower.net:${port}`);
+          writePidFile(store.getAllStoreValue());
+          if (child) {
+            child.disconnect();
+            child.unref();
+          }
+        }
+        if (text.indexOf("START_API_SERVER_FAIL_$$_") === 0) {
+          const serverMsg = text.replace("START_API_SERVER_FAIL_$$_", "").split("_").filter(Boolean);
+          if (serverMsg[0]) {
+            logError(`ERROR - ${serverMsg[0]}`);
+          }
+          if (serverMsg[1]) {
+            logError(`ERROR - ${serverMsg[1]}`);
+          }
+          process.exit(0);
+        }
+        if (text === "start") {
+          clearTimeout(timer);
+          resolve();
+          store.setStoreValue("status", "doing");
+          writePidFile(store.getAllStoreValue());
+        }
+        if (text === "restart") {
+          child && child.kill("SIGKILL");
+          store.setStoreValue("status", "restarting");
+          startChild("2").catch(() => {
+          });
+        }
+        if (text.indexOf("INTRANET_$$_") > -1) {
+          const arr = text.split("_$$_");
+          if (arr && arr[1]) {
+            store.setStoreValue("intranet", arr[1]);
+          }
+        }
+        if (text === "browser-kill") {
+          await browsersKill();
+        }
+        if (text.indexOf("RPA_PROCESS_PID_") > -1) {
+          const rpaPid = text.replace("RPA_PROCESS_PID_", "");
+          store.setStoreValue("rpaPid", rpaPid);
+        }
+        if (text.indexOf("RPA_PLUS_PROCESS_PID_") > -1) {
+          const rpaPlusPid = text.replace("RPA_PLUS_PROCESS_PID_", "");
+          store.setStoreValue("rpaPlusPid", rpaPlusPid);
+        }
+        if (text.indexOf("AI_PROCESS_PID_") > -1) {
+          const aiPid = text.replace("AI_PROCESS_PID_", "");
+          store.setStoreValue("aiPid", aiPid);
+        }
+      });
+      child.on("error", (err) => {
+        logError(`[!] Node\u542F\u52A8\u5931\u8D25: ${err.message}`);
+        store.setStoreValue("status", "stop");
+        store.clear();
+        removePidFile();
+        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");
+          });
+        }
+      });
+      timer = setTimeout(() => {
+        child && child.kill("SIGKILL");
+        child = null;
+        store.setStoreValue("status", "stop");
+        logError("[!] Start Timeout");
+        reject("Start Timeout");
+      }, 30 * 1e3);
+    } catch (error) {
+      clearTimeout(timer);
+      reject(error);
+      child = null;
+      store.clear();
+      logError(`[!] Node\u542F\u52A8\u5931\u8D25: ${error instanceof Error ? error.message : JSON.stringify(error)}`);
+    }
+  });
+};
+var stopChild = async () => {
+  const processInstance = readPidFile();
+  if (processInstance.pid) {
+    const isRun = await isRunning(processInstance.pid);
+    try {
+      process.kill(Number(processInstance.pid), "SIGKILL");
+      removePidFile();
+    } catch (error) {
+      try {
+        await sleepTime(2e3);
+        process.kill(Number(processInstance.pid), "SIGKILL");
+        removePidFile();
+      } catch (error2) {
+        logError(`[!] Stop child fail: ${error2 instanceof Error ? error2.message : JSON.stringify(error2)}`);
+        if (isRun) {
+          logWarning(`[!] Please manually close the browser process: ${processInstance.pid}`);
+        }
+        return;
+      }
+    }
+    logSuccess("[i] Adspower program is stopped");
+  } else {
+    logInfo("[i] No running adspower program");
+  }
+};
+var restartChild = async () => {
+  const processInstance = readPidFile();
+  if (processInstance.pid) {
+    const apiKey = processInstance.apiKey;
+    const baseUrl = processInstance.baseUrl;
+    const nodeEnv = processInstance.nodeEnv;
+    await stopChild();
+    await sleepTime(1e3);
+    store.setStoreValue("apiKey", apiKey);
+    store.setStoreValue("baseUrl", baseUrl);
+    store.setStoreValue("nodeEnv", nodeEnv);
+    await startChild().then(() => {
+      logSuccess("[i] Adspower program is restarted");
+    }).catch((error) => {
+      logError(`[!] Restart failed: ${error.message}`);
+    });
+  } else {
+    logInfo("[i] No running adspower program");
+  }
+};
+var getChildStatus = async () => {
+  const processInstance = readPidFile();
+  if (processInstance.pid) {
+    const isRun = await isRunning(processInstance.pid);
+    if (!isRun) {
+      removePidFile();
+      logInfo("[i] Adspower program is not running");
+      return;
+    }
+    const status = processInstance.status;
+    if (status === "starting") {
+      logSuccess("[i] Adspower program is starting...");
+    } else if (status === "doing" && processInstance.apiPort) {
+      logSuccess("[i] Adspower program is running at:");
+      logSuccess(` - http://local.adspower.net:${processInstance.apiPort}`);
+    } else if (status === "stop") {
+      logInfo("[i] Adspower program is stopped");
+    } else {
+      logInfo("[i] Adspower program is not started");
+    }
+  } else {
+    logInfo("[i] Adspower program is not running");
+  }
+};
+
+// src/index.ts
+var import_colors2 = require("colors");
+
 // ../core/src/constants/api.ts
 var import_axios = __toESM(require("axios"));
 
@@ -40,16 +555,28 @@ function parseArgs() {
     }
   }
   return {
-    port: port || process.env.PORT || "50325",
+    port: port || process.env.PORT || "50326",
     apiKey: apiKey || process.env.API_KEY
   };
 }
 var config = parseArgs();
+var updateConfig = (apiKey, port) => {
+  if (apiKey) {
+    config.apiKey = apiKey;
+  }
+  if (port) {
+    config.port = port;
+  }
+};
 var PORT = config.port;
 var API_KEY = config.apiKey;
+var CONFIG = config;
 
 // ../core/src/constants/api.ts
 var LOCAL_API_BASE = `http://127.0.0.1:${PORT}`;
+var getLocalApiBase = () => {
+  return `http://127.0.0.1:${CONFIG.port}`;
+};
 var API_ENDPOINTS = {
   STATUS: "/status",
   START_BROWSER: "/api/v2/browser-profile/start",
@@ -87,6 +614,11 @@ var API_ENDPOINTS = {
 var apiClient = import_axios.default.create({
   headers: API_KEY ? { "Authorization": `Bearer ${API_KEY}` } : {}
 });
+var getApiClient = () => {
+  return import_axios.default.create({
+    headers: CONFIG.apiKey ? { "Authorization": `Bearer ${CONFIG.apiKey}` } : {}
+  });
+};
 
 // ../core/src/utils/requestBuilder.ts
 function buildRequestBody(params) {
@@ -174,7 +706,7 @@ var browserHandlers = {
     if (cdpMask) {
       requestBody.cdp_mask = cdpMask;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.START_BROWSER}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.START_BROWSER}`, requestBody);
     if (response.data.code === 0) {
       return `Browser opened successfully with: ${Object.entries(response.data.data).map(([key, value]) => {
         if (value && typeof value === "object") {
@@ -193,7 +725,7 @@ var browserHandlers = {
     if (profileNo) {
       requestBody.profile_no = profileNo;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CLOSE_BROWSER}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CLOSE_BROWSER}`, requestBody);
     if (response.data.code === 0) {
       return "Browser closed successfully";
     }
@@ -201,7 +733,7 @@ var browserHandlers = {
   },
   async createBrowser(params) {
     const requestBody = buildRequestBody(params);
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CREATE_BROWSER}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CREATE_BROWSER}`, requestBody);
     if (response.data.code === 0) {
       return `Browser created successfully with: ${Object.entries(response.data.data).map(([key, value]) => `${key}: ${value}`).join("\n")}`;
     }
@@ -209,14 +741,14 @@ var browserHandlers = {
   },
   async updateBrowser(params) {
     const requestBody = buildRequestBody(params);
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_BROWSER}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.UPDATE_BROWSER}`, requestBody);
     if (response.data.code === 0) {
       return `Browser updated successfully with: ${Object.entries(response.data.data || {}).map(([key, value]) => `${key}: ${value}`).join("\n")}`;
     }
     throw new Error(`Failed to update browser: ${response.data.msg}`);
   },
   async deleteBrowser({ profileIds }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DELETE_BROWSER}`, {
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.DELETE_BROWSER}`, {
       profile_id: profileIds
     });
     if (response.data.code === 0) {
@@ -260,21 +792,21 @@ var browserHandlers = {
     if (name_filter) {
       requestBody.name_filter = name_filter;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_BROWSER_LIST}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_BROWSER_LIST}`, requestBody);
     if (response.data.code === 0) {
       return `Browser list: ${JSON.stringify(response.data.data.list, null, 2)}`;
     }
     throw new Error(`Failed to get browser list: ${response.data.msg}`);
   },
   async getOpenedBrowser() {
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_OPENED_BROWSER}`);
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_OPENED_BROWSER}`);
     if (response.data.code === 0) {
       return `Opened browser list: ${JSON.stringify(response.data.data.list, null, 2)}`;
     }
     throw new Error(`Failed to get opened browsers: ${response.data.msg}`);
   },
   async moveBrowser({ groupId, userIds }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.MOVE_BROWSER}`, {
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.MOVE_BROWSER}`, {
       group_id: groupId,
       user_ids: userIds
     });
@@ -291,7 +823,7 @@ var browserHandlers = {
     if (profileNo) {
       params.set("profile_no", profileNo);
     }
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_PROFILE_COOKIES}`, { params });
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_PROFILE_COOKIES}`, { params });
     if (response.data.code === 0) {
       return `Profile cookies: ${JSON.stringify(response.data.data, null, 2)}`;
     }
@@ -305,14 +837,14 @@ var browserHandlers = {
     if (profileNo && profileNo.length > 0) {
       requestBody.profile_no = profileNo;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_PROFILE_UA}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_PROFILE_UA}`, requestBody);
     if (response.data.code === 0) {
       return `Profile User-Agent: ${JSON.stringify(response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to get profile User-Agent: ${response.data.msg}`);
   },
   async closeAllProfiles(_params) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CLOSE_ALL_PROFILES}`, {});
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CLOSE_ALL_PROFILES}`, {});
     if (response.data.code === 0) {
       return "All profiles closed successfully";
     }
@@ -326,14 +858,14 @@ var browserHandlers = {
     if (profileNo && profileNo.length > 0) {
       requestBody.profile_no = profileNo;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.NEW_FINGERPRINT}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.NEW_FINGERPRINT}`, requestBody);
     if (response.data.code === 0) {
       return `New fingerprint created: ${JSON.stringify(response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to create new fingerprint: ${response.data.msg}`);
   },
   async deleteCacheV2({ profileIds, type }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DELETE_CACHE_V2}`, {
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.DELETE_CACHE_V2}`, {
       profile_id: profileIds,
       type
     });
@@ -353,7 +885,7 @@ var browserHandlers = {
     if (content !== void 0) {
       requestBody.content = content;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.SHARE_PROFILE}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.SHARE_PROFILE}`, requestBody);
     if (response.data.code === 0) {
       return `Profiles shared successfully: ${profileIds.join(", ")}`;
     }
@@ -367,14 +899,14 @@ var browserHandlers = {
     if (profileNo) {
       params.set("profile_no", profileNo);
     }
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_BROWSER_ACTIVE}`, { params });
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_BROWSER_ACTIVE}`, { params });
     if (response.data.code === 0) {
       return `Browser active info: ${JSON.stringify(response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to get browser active: ${response.data.msg}`);
   },
   async getCloudActive({ userIds }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_CLOUD_ACTIVE}`, {
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_CLOUD_ACTIVE}`, {
       user_ids: userIds
     });
     if (response.data.code === 0) {
@@ -393,7 +925,7 @@ var groupHandlers = {
     if (remark !== void 0) {
       requestBody.remark = remark;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CREATE_GROUP}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CREATE_GROUP}`, requestBody);
     if (response.data.code === 0) {
       return `Group created successfully with name: ${groupName}${remark ? `, remark: ${remark}` : ""}`;
     }
@@ -407,7 +939,7 @@ var groupHandlers = {
     if (remark !== void 0) {
       requestBody.remark = remark;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_GROUP}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.UPDATE_GROUP}`, requestBody);
     if (response.data.code === 0) {
       return `Group updated successfully with id: ${groupId}, name: ${groupName}${remark !== void 0 ? `, remark: ${remark === null ? "(cleared)" : remark}` : ""}`;
     }
@@ -424,7 +956,7 @@ var groupHandlers = {
     if (page) {
       params.set("page", page.toString());
     }
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_GROUP_LIST}`, { params });
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_GROUP_LIST}`, { params });
     return `Group list: ${JSON.stringify(response.data.data.list, null, 2)}`;
   }
 };
@@ -432,7 +964,7 @@ var groupHandlers = {
 // ../core/src/handlers/application.ts
 var applicationHandlers = {
   async checkStatus() {
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.STATUS}`);
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.STATUS}`);
     return `Connection status: ${JSON.stringify(response.data, null, 2)}`;
   },
   async getApplicationList({ category_id, page, limit }) {
@@ -446,7 +978,7 @@ var applicationHandlers = {
     if (limit !== void 0) {
       params.set("limit", limit.toString());
     }
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_APPLICATION_LIST}`, { params });
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_APPLICATION_LIST}`, { params });
     return `Application list: ${JSON.stringify(response.data.data.list, null, 2)}`;
   }
 };
@@ -508,7 +1040,7 @@ function buildCreateProxyRequestBody(proxy) {
 var proxyHandlers = {
   async createProxy(params) {
     const requestBody = params.proxies.map((proxy) => buildCreateProxyRequestBody(proxy));
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CREATE_PROXY}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CREATE_PROXY}`, requestBody);
     if (response.data.code === 0) {
       return `Proxy created successfully with: ${Object.entries(response.data.data || {}).map(([key, value]) => `${key}: ${value}`).join("\n")}`;
     }
@@ -516,7 +1048,7 @@ var proxyHandlers = {
   },
   async updateProxy(params) {
     const requestBody = buildProxyRequestBody(params);
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_PROXY}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.UPDATE_PROXY}`, requestBody);
     if (response.data.code === 0) {
       return `Proxy updated successfully with: ${Object.entries(response.data.data || {}).map(([key, value]) => `${key}: ${value}`).join("\n")}`;
     }
@@ -534,14 +1066,14 @@ var proxyHandlers = {
     if (proxyId && proxyId.length > 0) {
       requestBody.proxy_id = proxyId;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_PROXY_LIST}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_PROXY_LIST}`, requestBody);
     if (response.data.code === 0) {
       return `Proxy list: ${JSON.stringify(response.data.data.list || response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to get proxy list: ${response.data.msg}`);
   },
   async deleteProxy({ proxyIds }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DELETE_PROXY}`, {
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.DELETE_PROXY}`, {
       proxy_id: proxyIds
     });
     if (response.data.code === 0) {
@@ -565,28 +1097,28 @@ var tagHandlers = {
     if (page !== void 0) {
       requestBody.page = page;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_TAG_LIST}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_TAG_LIST}`, requestBody);
     if (response.data.code === 0) {
       return `Tag list: ${JSON.stringify(response.data.data.list || response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to get tag list: ${response.data.msg}`);
   },
   async createTag({ tags }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CREATE_TAG}`, { tags });
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CREATE_TAG}`, { tags });
     if (response.data.code === 0) {
       return `Tags created successfully: ${JSON.stringify(response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to create tags: ${response.data.msg}`);
   },
   async updateTag({ tags }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_TAG}`, { tags });
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.UPDATE_TAG}`, { tags });
     if (response.data.code === 0) {
       return `Tags updated successfully: ${JSON.stringify(response.data.data, null, 2)}`;
     }
     throw new Error(`Failed to update tags: ${response.data.msg}`);
   },
   async deleteTag({ ids }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DELETE_TAG}`, { ids });
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.DELETE_TAG}`, { ids });
     if (response.data.code === 0) {
       return `Tags deleted successfully: ${ids.join(", ")}`;
     }
@@ -654,7 +1186,7 @@ var defaultDownloadsPath = import_path.default.join(import_os.default.homedir(),
 // ../core/src/handlers/kernel.ts
 var kernelHandlers = {
   async downloadKernel({ kernel_type, kernel_version }) {
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DOWNLOAD_KERNEL}`, {
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.DOWNLOAD_KERNEL}`, {
       kernel_type,
       kernel_version
     });
@@ -668,7 +1200,7 @@ var kernelHandlers = {
     if (kernel_type) {
       params.set("kernel_type", kernel_type);
     }
-    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_KERNEL_LIST}`, { params });
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_KERNEL_LIST}`, { params });
     if (response.data.code === 0) {
       return `Kernel list: ${JSON.stringify(response.data.data.list || response.data.data, null, 2)}`;
     }
@@ -683,7 +1215,7 @@ var patchHandlers = {
     if (version_type) {
       requestBody.version_type = version_type;
     }
-    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_PATCH}`, requestBody);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.UPDATE_PATCH}`, requestBody);
     if (response.data.code === 0) {
       return `Patch update status: ${JSON.stringify(response.data.data, null, 2)}, message: ${response.data.msg}`;
     }
@@ -1420,38 +1952,134 @@ var schemas = {
 
 // src/cli.ts
 var STATELESS_HANDLERS = {
-  "open-browser": browserHandlers.openBrowser,
-  "close-browser": browserHandlers.closeBrowser,
-  "create-browser": browserHandlers.createBrowser,
-  "update-browser": browserHandlers.updateBrowser,
-  "delete-browser": browserHandlers.deleteBrowser,
-  "get-browser-list": browserHandlers.getBrowserList,
-  "get-opened-browser": browserHandlers.getOpenedBrowser,
-  "move-browser": browserHandlers.moveBrowser,
-  "get-profile-cookies": browserHandlers.getProfileCookies,
-  "get-profile-ua": browserHandlers.getProfileUa,
-  "close-all-profiles": browserHandlers.closeAllProfiles,
-  "new-fingerprint": browserHandlers.newFingerprint,
-  "delete-cache-v2": browserHandlers.deleteCacheV2,
-  "share-profile": browserHandlers.shareProfile,
-  "get-browser-active": browserHandlers.getBrowserActive,
-  "get-cloud-active": browserHandlers.getCloudActive,
-  "create-group": groupHandlers.createGroup,
-  "update-group": groupHandlers.updateGroup,
-  "get-group-list": groupHandlers.getGroupList,
-  "check-status": applicationHandlers.checkStatus,
-  "get-application-list": applicationHandlers.getApplicationList,
-  "create-proxy": proxyHandlers.createProxy,
-  "update-proxy": proxyHandlers.updateProxy,
-  "get-proxy-list": proxyHandlers.getProxyList,
-  "delete-proxy": proxyHandlers.deleteProxy,
-  "get-tag-list": tagHandlers.getTagList,
-  "create-tag": tagHandlers.createTag,
-  "update-tag": tagHandlers.updateTag,
-  "delete-tag": tagHandlers.deleteTag,
-  "download-kernel": kernelHandlers.downloadKernel,
-  "get-kernel-list": kernelHandlers.getKernelList,
-  "update-patch": patchHandlers.updatePatch
+  "open-browser": {
+    fn: browserHandlers.openBrowser,
+    description: "Open the browser, both environment and profile mean browser"
+  },
+  "close-browser": {
+    fn: browserHandlers.closeBrowser,
+    description: "Close the browser"
+  },
+  "create-browser": {
+    fn: browserHandlers.createBrowser,
+    description: "Create a browser"
+  },
+  "update-browser": {
+    fn: browserHandlers.updateBrowser,
+    description: "Update the browser"
+  },
+  "delete-browser": {
+    fn: browserHandlers.deleteBrowser,
+    description: "Delete the browser"
+  },
+  "get-browser-list": {
+    fn: browserHandlers.getBrowserList,
+    description: "Get the list of browsers"
+  },
+  "get-opened-browser": {
+    fn: browserHandlers.getOpenedBrowser,
+    description: "Get the list of opened browsers"
+  },
+  "move-browser": {
+    fn: browserHandlers.moveBrowser,
+    description: "Move browsers to a group"
+  },
+  "get-profile-cookies": {
+    fn: browserHandlers.getProfileCookies,
+    description: "Query and return cookies of the specified profile. Only one profile can be queried per request."
+  },
+  "get-profile-ua": {
+    fn: browserHandlers.getProfileUa,
+    description: "Query and return the User-Agent of specified profiles. Up to 10 profiles can be queried per request."
+  },
+  "close-all-profiles": {
+    fn: browserHandlers.closeAllProfiles,
+    description: "Close all opened profiles on the current device"
+  },
+  "new-fingerprint": {
+    fn: browserHandlers.newFingerprint,
+    description: "Generate a new fingerprint for specified profiles. Up to 10 profiles are supported per request."
+  },
+  "delete-cache-v2": {
+    fn: browserHandlers.deleteCacheV2,
+    description: "Clear local cache of specific profiles.For account security, please ensure that there are no open browsers on the device when using this interface."
+  },
+  "share-profile": {
+    fn: browserHandlers.shareProfile,
+    description: "Share profiles via account email or phone number. The maximum number of profiles that can be shared at one time is 200."
+  },
+  "get-browser-active": {
+    fn: browserHandlers.getBrowserActive,
+    description: "Get active browser profile information"
+  },
+  "get-cloud-active": {
+    fn: browserHandlers.getCloudActive,
+    description: 'Query the status of browser profiles by user_id, up to 100 profiles per request. If the team has enabled "Multi device mode," specific statuses cannot be retrieved and the response will indicate "Profile not opened."'
+  },
+  "create-group": {
+    fn: groupHandlers.createGroup,
+    description: "Create a browser group"
+  },
+  "update-group": {
+    fn: groupHandlers.updateGroup,
+    description: "Update the browser group"
+  },
+  "get-group-list": {
+    fn: groupHandlers.getGroupList,
+    description: "Get the list of groups"
+  },
+  "check-status": {
+    fn: applicationHandlers.checkStatus,
+    description: "Check the availability of the current device API interface (Connection Status)"
+  },
+  "get-application-list": {
+    fn: applicationHandlers.getApplicationList,
+    description: "Get the list of applications (categories)"
+  },
+  "create-proxy": {
+    fn: proxyHandlers.createProxy,
+    description: "Create the proxy"
+  },
+  "update-proxy": {
+    fn: proxyHandlers.updateProxy,
+    description: "Update the proxy"
+  },
+  "get-proxy-list": {
+    fn: proxyHandlers.getProxyList,
+    description: "Get the list of proxies"
+  },
+  "delete-proxy": {
+    fn: proxyHandlers.deleteProxy,
+    description: "Delete the proxy"
+  },
+  "get-tag-list": {
+    fn: tagHandlers.getTagList,
+    description: "Get the list of browser tags"
+  },
+  "create-tag": {
+    fn: tagHandlers.createTag,
+    description: "Create browser tags (batch supported)"
+  },
+  "update-tag": {
+    fn: tagHandlers.updateTag,
+    description: "Update browser tags (batch supported)"
+  },
+  "delete-tag": {
+    fn: tagHandlers.deleteTag,
+    description: "Delete browser tags"
+  },
+  "download-kernel": {
+    fn: kernelHandlers.downloadKernel,
+    description: "Download or update a browser kernel version"
+  },
+  "get-kernel-list": {
+    fn: kernelHandlers.getKernelList,
+    description: "Get browser kernel list by type or all"
+  },
+  "update-patch": {
+    fn: patchHandlers.updatePatch,
+    description: "Update AdsPower to latest patch version"
+  }
 };
 var SINGLE_PROFILE_ID_COMMANDS = {
   "open-browser": "profileId",
@@ -1460,56 +2088,109 @@ var SINGLE_PROFILE_ID_COMMANDS = {
   "get-browser-active": "profileId"
 };
 var SINGLE_PROFILE_ID_ARRAY_COMMANDS = ["get-profile-ua", "new-fingerprint"];
-function parseArgv(argv) {
-  let i = 0;
-  while (i < argv.length) {
-    if (argv[i] === "--port" || argv[i] === "--api-key") {
-      i += 2;
-      continue;
-    }
-    break;
-  }
-  const command = argv[i];
-  const arg = argv[i + 1];
-  if (!command || !STATELESS_HANDLERS[command]) {
-    throw new Error(`Unknown or unsupported command: ${command || "(missing)"}. Supported: ${Object.keys(STATELESS_HANDLERS).join(", ")}`);
-  }
-  let args = {};
-  if (arg) {
-    const trimmed = arg.trim();
-    if (trimmed.startsWith("{")) {
-      try {
-        args = JSON.parse(arg);
-      } catch {
-        throw new Error("Invalid JSON for command args");
+
+// src/index.ts
+var program = new import_commander.Command();
+program.name("adspower-browser").description("CLI and runtime for adspower-browser").version(VERSION);
+program.command("start").description("Start the adspower runtime").option("-k, --api-key <apiKey>", "Set the API key for the adspower runtime").addOption(new import_commander.Option("--base-url <baseUrl>", "Set the base URL for the adspower runtime").hideHelp()).addOption(new import_commander.Option("--node-env <nodeEnv>", "Set the node environment for the adspower runtime").hideHelp()).action(async (options) => {
+  if (options.apiKey) {
+    store.setStoreValue("apiKey", options.apiKey);
+  } else {
+    const apiKey = process.env.ADS_API_KEY;
+    if (!apiKey) {
+      logError("error: required option '-k, --api-key <apiKey>' not specified");
+      process.exit(1);
+    }
+    store.setStoreValue("apiKey", "");
+  }
+  if (options.baseUrl) {
+    store.setStoreValue("baseUrl", options.baseUrl);
+  }
+  if (options.nodeEnv) {
+    store.setStoreValue("nodeEnv", options.nodeEnv);
+  }
+  await startChild();
+});
+program.command("stop").description("Stop the adspower runtime").action(async () => {
+  await stopChild();
+});
+program.command("restart").description("Restart the adspower runtime").action(async () => {
+  await restartChild();
+});
+program.command("status").description("Get the status of the adspower runtime").action(async () => {
+  getChildStatus();
+});
+for (const cmd of Object.keys(STATELESS_HANDLERS)) {
+  const fnc = STATELESS_HANDLERS[cmd].fn;
+  program.command(`${cmd} [params]`).description(STATELESS_HANDLERS[cmd].description).option("-k, --api-key <apiKey>", "Set the API key for the adspower runtime").option("-p, --port <port>", "Set the port for the adspower runtime").action(async (params, options, command) => {
+    const isRun = await hasRunning(options);
+    if (!isRun) {
+      logError("[!] Adspower runtime is not running");
+      const info = `[i] Please run "${(0, import_colors2.green)("adspower-browser start -k <apiKey>")}" to start the adspower runtime`;
+      console.log(info);
+      return;
+    }
+    const { apiKey, port } = getApiKeyAndPort(options);
+    updateConfig(apiKey, port);
+    let args = {};
+    if (params) {
+      const trimmed = params.trim();
+      if (trimmed.startsWith("{")) {
+        try {
+          args = JSON.parse(params);
+        } catch {
+          logError("Invalid JSON for command args");
+          return;
+        }
+      } else if (SINGLE_PROFILE_ID_COMMANDS[command.name()]) {
+        const key = SINGLE_PROFILE_ID_COMMANDS[command.name()];
+        if (!isNaN(Number(trimmed))) {
+          args = { profileNo: Number(trimmed) };
+        } else {
+          args = { profileId: trimmed };
+        }
+      } else if (SINGLE_PROFILE_ID_ARRAY_COMMANDS.includes(command.name())) {
+        args = { profileId: [trimmed] };
+      } else {
+        try {
+          args = JSON.parse(params);
+        } catch {
+          logError(`Command requires JSON args (e.g. '{"key":"value"}') or use a supported shorthand`);
+          return;
+        }
       }
-    } else if (SINGLE_PROFILE_ID_COMMANDS[command]) {
-      const key = SINGLE_PROFILE_ID_COMMANDS[command];
-      args = { [key]: trimmed };
-    } else if (SINGLE_PROFILE_ID_ARRAY_COMMANDS.includes(command)) {
-      args = { profileId: [trimmed] };
-    } else {
-      try {
-        args = JSON.parse(arg);
-      } catch {
-        throw new Error(`Command requires JSON args (e.g. '{"key":"value"}') or use a supported shorthand`);
+    }
+    logSuccess(`Executing command: ${command.name()}, params: ${JSON.stringify(args)}`);
+    const loading = createLoading(`Executing ${command.name()}...`);
+    try {
+      if (command.name() === "download-kernel") {
+        loading.stop();
+        const result = await trackKernelDownload(fnc, args);
+        const out = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+        logInfo(`
+
+${out}
+
+`);
+      } else {
+        const result = await fnc(args);
+        const out = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+        logInfo(`
+
+${out}
+`);
+        if (command.name() === "update-patch" && !out.includes("The client is already on the latest patch version. No update is required")) {
+          loading.stop();
+          await sleepTime(1e3 * 60);
+          await restartChild();
+        }
       }
+    } finally {
+      loading.stop();
     }
-  }
-  return { command, args };
-}
-async function main() {
-  const argv = process.argv.slice(2);
-  try {
-    const { command, args } = parseArgv(argv);
-    const handler = STATELESS_HANDLERS[command];
-    const result = await handler(args);
-    const out = typeof result === "string" ? result : JSON.stringify(result, null, 2);
-    process.stdout.write(out + "\n");
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(msg + "\n");
-    process.exit(1);
-  }
+  });
 }
-main();
+program.parseAsync(process.argv).catch((error) => {
+  console.error(error);
+  process.exit(1);
+});