gf-packages-cli 1.0.6 → 1.0.7

package/bin/cli.js

@@ -5,6 +5,8 @@ const pkg = require('../package.json');
 const showMenu = require('../src/index.js');
 const exportCommand = require('../src/exportPackage.js');
 const deleteCommand = require('../src/deletePackage.js');
+const testActivationCommand = require('../src/testActivation.js');
+const downloadPackageCommand = require('../src/downloadPackage.js');
 const autoUpdate = require('../lib/common/updateCheck.js');
 
 program
@@ -20,6 +22,10 @@ program.hook('preAction', async () => {
 program.addCommand(exportCommand);
 // 注册 delete 子命令
 program.addCommand(deleteCommand);
+// 注册 test-activation 子命令
+program.addCommand(testActivationCommand);
+// 注册 download-pkg 子命令
+program.addCommand(downloadPackageCommand);
 // 无子命令时，显示菜单
 program
   .action(() => {

package/lib/common/appDownload.js

@@ -0,0 +1,187 @@
+// ===================== 云控下载 + 安装（公共模块） =====================
+// 供 test-activation 与 download-pkg 两个功能复用
+
+const { spawn } = require('child_process');
+const chalk = require('chalk').default;
+const fs = require('fs');
+const path = require('path');
+const AdmZip = require('adm-zip');
+const inquirer = require('inquirer');
+const { runAdbSync } = require('../tools/adb.js');
+
+/** 以可见进度执行 adb 命令（spawn 继承 stdio，显示 adb 原生进度条）
+ * @param {string|null} deviceId 设备序列号
+ * @param {string[]} args adb 参数数组（不含 -s 和 adb 前缀）
+ */
+function runAdbLive(deviceId, args) {
+  return new Promise((resolve, reject) => {
+    const base = deviceId ? ['-s', deviceId] : [];
+    const child = spawn('adb', [...base, ...args], { stdio: 'inherit' });
+    child.on('error', reject);
+    child.on('close', code => {
+      if (code === 0) resolve();
+      else reject(new Error(`adb ${args[0]} 退出码 ${code}`));
+    });
+  });
+}
+
+// ===================== 云控下载参数（固定值） =====================
+
+const DEFAULT_CLOUD_SERVER = 'http://43.155.24.172';
+const SERVER_PARAMS = {
+  cloudServerUrl: DEFAULT_CLOUD_SERVER,
+  countryCode: 'US',
+  type: '1',
+  appMarketType: 'google',
+  offerType: '5',
+  taskType: '5001'
+};
+
+async function getServerConfig() {
+  console.log(chalk.gray(`使用云控参数: ${JSON.stringify(SERVER_PARAMS)}`));
+  return { ...SERVER_PARAMS };
+}
+
+// ===================== 获取下载信息 =====================
+
+/** 获取设备SN（对应 deviceUtil.getSerialNo：getprop ro.boot.serialno） */
+async function getDeviceSn(deviceId) {
+  try {
+    const out = await runAdbSync(deviceId, 'shell getprop ro.boot.serialno');
+    if (out.trim()) return out.trim();
+  } catch { }
+  throw new Error('无法获取设备SN');
+}
+
+/** 获取应用下载信息；ftp_url 为相对路径时通过 ftpAccount 接口拼接完整下载地址 */
+async function getDownloadInfo(pkgName, server, deviceId) {
+  const params = new URLSearchParams({
+    name: pkgName,
+    countryCode: server.countryCode,
+    type: server.type,
+    appMarketType: server.appMarketType,
+    offerType: server.offerType,
+    taskType: server.taskType,
+    version: ''
+  });
+  const url = `${server.cloudServerUrl}/api/v1/apk/package/V3?${params.toString()}`;
+  console.log(chalk.gray(`获取应用信息: ${url}`));
+  const res = await fetch(url, { signal: AbortSignal.timeout(30000) });
+  if (!res.ok) throw new Error(`云控接口返回 HTTP ${res.status}`);
+  const data = await res.json();
+  const info = data && data.data;
+  if (!info || !info.ftp_url) throw new Error(`未获取到下载地址，返回: ${JSON.stringify(data)}`);
+
+  // V3 返回的是相对路径（如 /cloudcontrol/prod/...），需调 ftpAccount/get 拿服务器 host 拼接（对应 downloadBigFile/getFilerResource）
+  if (!/^https?:\/\//i.test(info.ftp_url)) {
+    const sn = await getDeviceSn(deviceId);
+    const ftpUrl = `${server.cloudServerUrl}/api/v1/ftpAccount/get?platform=1&type=0&sn=${encodeURIComponent(sn)}`;
+    console.log(chalk.gray(`获取FTP服务器: ${ftpUrl}`));
+    const ftpRes = await fetch(ftpUrl, { signal: AbortSignal.timeout(30000) });
+    const ftpData = await ftpRes.json();
+    const host = ftpData && ftpData.data && ftpData.data.host;
+    if (!host) throw new Error(`未获取到FTP服务器地址，返回: ${JSON.stringify(ftpData)}`);
+    info.ftp_url = `http://${host}${info.ftp_url}`;
+    console.log(chalk.gray(`拼接下载地址: ${info.ftp_url}`));
+  }
+  return info;
+}
+
+// ===================== 下载文件 =====================
+
+async function downloadFile(url, destDir) {
+  if (!/^https?:\/\//.test(url)) {
+    const { direct } = await inquirer.prompt([{
+      type: 'input',
+      name: 'direct',
+      message: `下载地址不是直链(${url})，请粘贴直链URL：`,
+      validate: input => /^https?:\/\//.test(input.trim()) ? true : '请输入http(s)直链'
+    }]);
+    url = direct.trim();
+  }
+  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+
+  const extMatch = url.match(/\.(\w+)$/);
+  const ext = extMatch ? extMatch[1].toLowerCase() : 'apk';
+  const filePath = path.join(destDir, `pkg.${ext}`);
+
+  console.log(chalk.gray(`开始下载: ${url}`));
+  const res = await fetch(url, { signal: AbortSignal.timeout(300000) });
+  if (!res.ok) throw new Error(`下载失败，HTTP ${res.status}`);
+
+  // 流式下载并实时显示进度（百分比 + 速度）
+  const total = Number(res.headers.get('content-length')) || 0;
+  const chunks = [];
+  let received = 0;
+  let lastPct = -1;
+  const started = Date.now();
+  for await (const chunk of res.body) {
+    chunks.push(Buffer.from(chunk));
+    received += chunk.length;
+    if (total) {
+      const pct = Math.floor((received / total) * 100);
+      if (pct !== lastPct) {
+        lastPct = pct;
+        const speed = received / 1024 / 1024 / Math.max(1, (Date.now() - started) / 1000);
+        process.stdout.write(`\r下载进度: ${(received / 1024 / 1024).toFixed(1)}/${(total / 1024 / 1024).toFixed(1)} MB (${pct}%) ${speed.toFixed(1)}MB/s`);
+      }
+    } else {
+      process.stdout.write(`\r已下载: ${(received / 1024 / 1024).toFixed(1)} MB`);
+    }
+  }
+  process.stdout.write('\n');
+  const buf = Buffer.concat(chunks);
+  fs.writeFileSync(filePath, buf);
+  console.log(chalk.green(`下载完成: ${filePath} (${(buf.length / 1024 / 1024).toFixed(2)} MB)`));
+  return { filePath, ext };
+}
+
+// ===================== 安装并打开 =====================
+
+async function installAndOpen(deviceId, pkgName, filePath, ext) {
+  // 关闭安装校验（对应原脚本 downloadUtil 的 verifier 设置）
+  await runAdbSync(deviceId, 'shell settings put global verifier_verify_adb_installs 0');
+  await runAdbSync(deviceId, 'shell settings put global package_verifier_enable 0');
+
+  if (ext === 'apk') {
+    // 直接安装（--streaming 实时显示 adb 安装进度）
+    await runAdbLive(deviceId, ['install', '--streaming', '-r', '-d', filePath]);
+  } else {
+    // apks/xapk/zip：解压后批量安装分包
+    console.log(chalk.gray('解压分包...'));
+    const tmpDir = path.join(path.dirname(filePath), 'unpack');
+    if (fs.existsSync(tmpDir)) fs.rmSync(tmpDir, { recursive: true, force: true });
+    fs.mkdirSync(tmpDir, { recursive: true });
+    new AdmZip(filePath).extractAllTo(tmpDir, true);
+
+    const apkFiles = [];
+    const walk = (dir) => {
+      for (const f of fs.readdirSync(dir)) {
+        const full = path.join(dir, f);
+        if (fs.statSync(full).isDirectory()) walk(full);
+        else if (f.toLowerCase().endsWith('.apk')) apkFiles.push(full);
+      }
+    };
+    walk(tmpDir);
+    if (apkFiles.length === 0) throw new Error('解压后未找到任何APK分包');
+    console.log(chalk.gray(`找到 ${apkFiles.length} 个APK分包，开始安装...`));
+    await runAdbLive(deviceId, ['install-multiple', '-r', '-d', ...apkFiles]);
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+
+  // 推送副本到设备 /sdcard/Download（与删除功能清理路径一致，显示 push 进度）
+  await runAdbLive(deviceId, ['push', filePath, `/sdcard/Download/${pkgName}.${ext}`]);
+
+  // 打开应用
+  await runAdbSync(deviceId, `shell monkey -p ${pkgName} -c android.intent.category.LAUNCHER 1`);
+  console.log(chalk.green(`已安装并打开应用: ${pkgName}`));
+}
+
+module.exports = {
+  getServerConfig,
+  getDeviceSn,
+  getDownloadInfo,
+  downloadFile,
+  installAndOpen,
+  runAdbLive
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gf-packages-cli",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "bin": {
     "gf-packages-cli": "bin/cli.js"
   },

package/src/downloadPackage.js

@@ -0,0 +1,57 @@
+const { Command } = require('commander');
+const inquirer = require('inquirer');
+const chalk = require('chalk').default;
+const fs = require('fs');
+const path = require('path');
+const { getDeviceList, selectDevice } = require('../lib/tools/adb.js');
+const { getServerConfig, getDownloadInfo, downloadFile, installAndOpen } = require('../lib/common/appDownload.js');
+
+async function runDownloadPackage(options = {}) {
+  const { device, pkg } = options;
+  try {
+    // 1. 设备选择
+    const allDevices = await getDeviceList();
+    const targetDevice = device || await selectDevice(allDevices);
+
+    // 2. 输入包名
+    let pkgName = pkg;
+    if (!pkgName) {
+      const ans = await inquirer.prompt([{
+        type: 'input',
+        name: 'pkgName',
+        message: '请输入要下载的包名：',
+        validate: input => input.trim() ? true : '包名不能为空'
+      }]);
+      pkgName = ans.pkgName;
+    }
+    pkgName = pkgName.trim();
+
+    // 3. 获取下载地址
+    const server = await getServerConfig();
+    const info = await getDownloadInfo(pkgName, server, targetDevice);
+
+    // 4. 下载
+    const destDir = path.resolve('./tmp_download');
+    const { filePath, ext } = await downloadFile(info.ftp_url, destDir);
+
+    // 5. 安装并打开
+    await installAndOpen(targetDevice, pkgName, filePath, ext);
+
+    if (fs.existsSync(destDir)) fs.rmSync(destDir, { recursive: true, force: true });
+    console.log(chalk.bold.cyan('\n===== 下载安装完成 ====='));
+  } catch (err) {
+    console.log(chalk.red(`\n程序异常: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+const downloadPackageCommand = new Command('download-pkg')
+  .description('下载并安装指定包（云控）')
+  .option('-d, --device <id>', '设备序列号（单设备时自动识别）')
+  .option('-p, --pkg <pkg>', '要下载的包名')
+  .action(async (options) => {
+    await runDownloadPackage(options);
+  });
+
+module.exports = downloadPackageCommand;
+module.exports.run = runDownloadPackage;

package/src/index.js

@@ -2,6 +2,8 @@ const inquirer = require('inquirer');
 const chalk = require('chalk').default;
 const { run: runExport } = require('./exportPackage');
 const { run: runDelete } = require('./deletePackage');
+const { run: runTestActivation } = require('./testActivation');
+const { run: runDownloadPackage } = require('./downloadPackage');
 async function showMenu() {
   console.log('\n📦 APP包工具\n');
 
@@ -21,6 +23,16 @@ async function showMenu() {
           description: '删除设备指定APP及文件',
           value: 'delete'
         },
+        {
+          name: '🔑 一键测试激活',
+          description: '处理激活链接并下载安装包',
+          value: 'testActivation'
+        },
+        {
+          name: '📥 下载并安装指定包',
+          description: '从云控下载指定包并安装打开',
+          value: 'downloadPkg'
+        },
         {
           name: '❌ 退出',
           value: 'exit'
@@ -35,7 +47,13 @@ async function showMenu() {
       break;
     case 'delete':
       await runDelete();
-      break;  
+      break;
+    case 'testActivation':
+      await runTestActivation();
+      break;
+    case 'downloadPkg':
+      await runDownloadPackage();
+      break;
     case 'exit':
       console.log(chalk.gray('已退出'));
       process.exit(0);

package/src/testActivation.js

@@ -0,0 +1,315 @@
+const { Command } = require('commander');
+const inquirer = require('inquirer');
+const chalk = require('chalk').default;
+const fs = require('fs');
+const path = require('path');
+const { getDeviceList, selectDevice, runAdbSync } = require('../lib/tools/adb.js');
+const { getServerConfig, getDownloadInfo, downloadFile, installAndOpen } = require('../lib/common/appDownload.js');
+
+// ===================== 读取设备 GAID =====================
+
+const AUTOJS_PKG_CANDIDATES = [
+  'org.autojs.autoxjs',
+  'org.autojs.autoxjs.v7',
+  'org.autojs.autox6',
+  'org.autojs.autox6.v6',
+  'org.autojs.autojs',
+  'com.stardust.autojs',
+  'com.cloudcontrol'
+];
+
+// 通过设备上的 Auto.js 运行时读取 GAID（对应 deviceUtil.getDeviceGaId）
+async function getGaIdByAutoJs(deviceId) {
+  try {
+    const out = await runAdbSync(deviceId, 'shell pm list packages');
+    const pkgs = out.split(/\r?\n/)
+      .map(l => l.replace('package:', '').trim())
+      .filter(Boolean);
+    const autoJsPkg = AUTOJS_PKG_CANDIDATES.find(p => pkgs.includes(p)) || pkgs.find(p => /autojs|autox/i.test(p));
+    if (!autoJsPkg) return null;
+
+    // 自包含脚本：调用 stardust SDK 的 requestGoogle 取 GAID 并写入结果文件
+    const script = [
+      'var adId = 0, status = 0;',
+      'for (var i = 0; i < 5; i++) {',
+      '  try {',
+      '    com.stardust.sdk.AutoJsApi.requestGoogle({ onCallback: function (gaid) { adId = gaid; status = 1; } });',
+      '  } catch (e) { status = 1; }',
+      '  var n = 0;',
+      '  while (n < 20 && status === 0) { sleep(500); n++; }',
+      '  if (adId !== 0) break;',
+      '}',
+      "files.write('/sdcard/Download/_gaid_result.txt', String(adId));"
+    ].join('\n');
+
+    const localScript = path.resolve('./tmp_activation/_getGaid.js');
+    const dir = path.dirname(localScript);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(localScript, script, 'utf-8');
+    await runAdbSync(deviceId, `push "${localScript}" /sdcard/Download/_getGaid.js`);
+
+    // 尝试多种方式触发 Auto.js 运行脚本（intent filter 要求 application/x-javascript 类型）
+    const components = [
+      `${autoJsPkg}/org.autojs.autojs.external.open.RunIntentActivity`,
+      `${autoJsPkg}/org.autojs.autojs.external.open.OpenIntentActivity`,
+      `${autoJsPkg}/com.stardust.autojs.external.open.RunIntentActivity`
+    ];
+    let ran = false;
+    for (const comp of components) {
+      try {
+        await runAdbSync(deviceId, `shell am start -n ${comp} -d "file:///sdcard/Download/_getGaid.js" -t "application/x-javascript"`);
+        ran = true;
+        break;
+      } catch { }
+    }
+    if (!ran) {
+      // 兜底：隐式 VIEW 打开 .js（AutoX.js 注册了该 scheme）
+      try {
+        await runAdbSync(deviceId, 'shell am start -a android.intent.action.VIEW -d "file:///sdcard/Download/_getGaid.js" -t "application/x-javascript"');
+        ran = true;
+      } catch { }
+    }
+    if (!ran) return null;
+
+    // 轮询结果文件（脚本最多约 50s 重试，通常几秒内完成）
+    let id = '';
+    for (let i = 0; i < 20; i++) {
+      await new Promise(r => setTimeout(r, 1000));
+      try {
+        const res = await runAdbSync(deviceId, 'shell cat /sdcard/Download/_gaid_result.txt');
+        const candidate = res.trim();
+        if (/^[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}$/i.test(candidate)) { id = candidate; break; }
+      } catch { }
+    }
+    await runAdbSync(deviceId, 'shell rm -f /sdcard/Download/_getGaid.js /sdcard/Download/_gaid_result.txt');
+    if (id) return id;
+  } catch { }
+  return null;
+}
+
+async function getGaId(deviceId) {
+  // 1. 设备 Auto.js 运行时读取（本生态正规方式）
+  const autoJsId = await getGaIdByAutoJs(deviceId);
+  if (autoJsId) {
+    console.log(chalk.gray(`读取到设备GAID: ${autoJsId}`));
+    return autoJsId;
+  }
+
+  // 2. 部分 Android 12+ ROM：cmd advertising_id
+  try {
+    const out = await runAdbSync(deviceId, 'shell cmd advertising_id get-id');
+    const id = (out.trim() || '').split(/\s+/).pop();
+    if (/^[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}$/i.test(id)) {
+      console.log(chalk.gray(`读取到设备GAID: ${id}`));
+      return id;
+    }
+  } catch { }
+
+  // 3. root 设备：读取 Google Play 服务配置里的 adid
+  try {
+    const out = await runAdbSync(deviceId, 'shell su -c "grep adid_key /data/data/com.google.android.gms/shared_prefs/adid_settings.xml"');
+    const m = out.match(/adid_key">([^<]+)</);
+    if (m) {
+      console.log(chalk.gray(`读取到设备GAID: ${m[1]}`));
+      return m[1];
+    }
+  } catch { }
+
+  // 4. 手动输入兜底
+  const { gaid } = await inquirer.prompt([{
+    type: 'input',
+    name: 'gaid',
+    message: '无法自动读取GAID，请手动输入设备GAID：',
+    validate: input => input.trim() ? true : 'GAID不能为空'
+  }]);
+  return gaid.trim();
+}
+
+// ===================== 处理激活链接（移植 本地.js buildUrl） =====================
+
+async function buildUrl(url, gaid) {
+  console.log(chalk.gray(`本机gaid: ${gaid}`));
+
+  // 通用：所有 {gaid} 占位 → 本机 gaid
+  url = url.replace(/\{gaid\}/g, gaid);
+
+  if (url.indexOf('aff_sub') === -1) {
+    // 第一种：movablead 型，aff_site_id 随机 4 位数
+    const affId = Math.floor(1000 + Math.random() * 9000);
+    url = url.replace(/aff_site_id=[^&]+/, 'aff_site_id=' + affId);
+    console.log(chalk.gray(`随机 aff_site_id: ${affId}`));
+  } else {
+    // 第二种：hotrk0 型，剩余 {xxx} 占位逐个询问是否添加
+    const remain = url.match(/\{[^}]+\}/g) || [];
+    for (const ph of remain) {
+      const name = ph.slice(1, -1);
+      const { want } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'want',
+        message: `链接中存在参数 {${name}}，是否添加？`,
+        default: false
+      }]);
+      if (want) {
+        const { val } = await inquirer.prompt([{
+          type: 'input',
+          name: 'val',
+          message: `请输入 ${name} 的值：`
+        }]);
+        url = url.split(ph).join(val);
+      }
+    }
+  }
+
+  console.log(chalk.gray(`处理后的链接: ${url}`));
+  return url;
+}
+
+// ===================== 跳转判断（移植 本地.js openChromeClick） =====================
+
+/** 轮询直到 checkFn 返回 true 或超时
+ * @param {number} count 次数
+ * @param {number} interval 间隔ms
+ */
+async function pollUntil(deviceId, count, interval, checkFn) {
+  for (let i = 0; i < count; i++) {
+    try {
+      if (await checkFn()) return true;
+    } catch { }
+    await new Promise(r => setTimeout(r, interval));
+  }
+  return false;
+}
+
+/** 打开链接并判断是否跳转成功（目标包到前台）
+ * @param {string} url 链接
+ * @param {string} targetPkg 跳转目标包名，默认 com.android.vending 谷歌商城
+ * @returns {boolean} 是否跳转成功
+ */
+async function openChromeClick(deviceId, url, targetPkg) {
+  targetPkg = targetPkg || 'com.android.vending';
+  try {
+    // 先清掉 Chrome，避免已运行状态下 URL 落到地址栏编辑框而不导航
+    await runAdbSync(deviceId, 'shell am force-stop com.android.chrome');
+    await new Promise(r => setTimeout(r, 500));
+
+    // 与本地.js 一致：用 Chrome 打开。
+    // 关键：& 转义成 \&。Windows 下 cmd.exe 会先剥掉双引号，若 URL 里的 & 不做转义，
+    // 会被设备 shell 当成后台符，命令在第一个 & 处截断（offer_id 等参数丢失 → 广告提示不在线）。
+    const escapedUrl = url.replace(/&/g, '\\&');
+    const cmd = `shell am start -n com.android.chrome/com.google.android.apps.chrome.Main -a android.intent.action.VIEW -d "${escapedUrl}"`;
+    console.log(chalk.gray(`打开Chrome命令: ${cmd}`));
+    await runAdbSync(deviceId, cmd);
+
+    // 轮询：等待跳转到目标包（前台应用窗口包含目标包名）
+    // 注意：不依赖 host 端 grep（Windows 用户终端 PATH 可能没有 grep），
+    // 拉全量 dumpsys window 后在 Node 里过滤 mCurrentFocus 行，任何环境都可运行。
+    const jumped = await pollUntil(deviceId, 30, 1000, async () => {
+      const out = await runAdbSync(deviceId, 'shell dumpsys window');
+      const focusLine = (out.split(/\r?\n/) || []).find(l => l.includes('mCurrentFocus'));
+      console.log(chalk.gray(`当前前台应用: ${focusLine ? focusLine.trim() : 'null'}`));
+      return focusLine ? focusLine.includes(targetPkg) : false;
+    });
+
+    if (jumped) {
+      console.log(chalk.green(`跳转成功，已进入目标: ${targetPkg}`));
+      return true;
+    }
+    console.log(chalk.yellow('超时未跳转'));
+    return false;
+  } catch (e) {
+    console.log(chalk.yellow(`跳转异常: ${e.message}`));
+    return false;
+  }
+}
+
+// ===================== 核心流程 =====================
+
+async function runTestActivation(options = {}) {
+  const { device, url, pkg } = options;
+  try {
+    // 1. 设备选择
+    const allDevices = await getDeviceList();
+    const targetDevice = device || await selectDevice(allDevices);
+
+    // 2. 输入激活链接
+    let activationUrl = url;
+    if (!activationUrl) {
+      const ans = await inquirer.prompt([{
+        type: 'input',
+        name: 'activationUrl',
+        message: '请输入激活链接：',
+        validate: input => input.trim() ? true : '链接不能为空'
+      }]);
+      activationUrl = ans.activationUrl;
+    }
+
+    // 3. 读取GAID并处理链接（替换参数）
+    const gaid = await getGaId(targetDevice);
+    const builtUrl = await buildUrl(activationUrl.trim(), gaid);
+
+    // 4. 循环 3 次打开链接并判断跳转是否成功
+    let jumpOkCount = 0;
+    for (let i = 1; i <= 3; i++) {
+      console.log(chalk.gray(`\n===== 第 ${i}/3 次跳转开始 =====`));
+      const ok = await openChromeClick(targetDevice, builtUrl);
+      if (ok) {
+        jumpOkCount++;
+        console.log(chalk.green(`第 ${i}/3 次跳转成功`));
+      } else {
+        console.log(chalk.yellow(`第 ${i}/3 次跳转失败`));
+      }
+      if (i < 3) {
+        await new Promise(r => setTimeout(r, 3000 + Math.random() * 2000)); // 两次之间停 3~5 秒
+      }
+    }
+    console.log(chalk.gray(`\n===== 3 次跳转执行完毕，成功 ${jumpOkCount} 次 =====`));
+
+    // 5. 跳转未成功则显示失败，不再进行后续步骤
+    if (jumpOkCount === 0) {
+      console.log(chalk.red('\n❌ 激活失败：3 次跳转均未成功，不再进行后续操作'));
+      process.exit(0);
+    }
+
+    // 6. 询问下载的包
+    let pkgName = pkg;
+    if (!pkgName) {
+      const ans = await inquirer.prompt([{
+        type: 'input',
+        name: 'pkgName',
+        message: '请输入要下载的包名：',
+        validate: input => input.trim() ? true : '包名不能为空'
+      }]);
+      pkgName = ans.pkgName;
+    }
+    pkgName = pkgName.trim();
+
+    // 7. 从云控获取下载地址并下载
+    const server = await getServerConfig();
+    const info = await getDownloadInfo(pkgName, server, targetDevice);
+    const destDir = path.resolve('./tmp_activation');
+    const { filePath, ext } = await downloadFile(info.ftp_url, destDir);
+
+    // 8. 安装并打开
+    await installAndOpen(targetDevice, pkgName, filePath, ext);
+
+    if (fs.existsSync(destDir)) fs.rmSync(destDir, { recursive: true, force: true });
+    console.log(chalk.bold.cyan('\n===== 一键测试激活完成 ====='));
+  } catch (err) {
+    console.log(chalk.red(`\n程序异常: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+// ===================== Commander 命令定义 =====================
+
+const testActivationCommand = new Command('test-activation')
+  .description('一键测试激活：处理激活链接并下载安装包')
+  .option('-d, --device <id>', '设备序列号（单设备时自动识别）')
+  .option('-u, --url <url>', '激活链接')
+  .option('-p, --pkg <pkg>', '要下载的包名')
+  .action(async (options) => {
+    await runTestActivation(options);
+  });
+
+module.exports = testActivationCommand;
+module.exports.run = runTestActivation;

package/tmp_activation/_getGaid.js

@@ -0,0 +1,10 @@
+var adId = 0, status = 0;
+for (var i = 0; i < 5; i++) {
+  try {
+    com.stardust.sdk.AutoJsApi.requestGoogle({ onCallback: function (gaid) { adId = gaid; status = 1; } });
+  } catch (e) { status = 1; }
+  var n = 0;
+  while (n < 20 && status === 0) { sleep(500); n++; }
+  if (adId !== 0) break;
+}
+files.write('/sdcard/Download/_gaid_result.txt', String(adId));