siluzan-tso-cli 1.1.39 → 1.1.40-beta.2

package/dist/index.js

@@ -3937,7 +3937,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -102283,15 +102283,17 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     costPerConversion: num2(currentPeriod.costPerConversion)
   } : null);
   if (currentKpiSource) {
-    if (kpis.cost == null) kpis.cost = currentKpiSource.cost;
-    if (kpis.impressions == null) kpis.impressions = currentKpiSource.impressions;
-    if (kpis.clicks == null) kpis.clicks = currentKpiSource.clicks;
-    if (kpis.conversions == null) kpis.conversions = currentKpiSource.conversions;
-    if (kpis.ctr == null) kpis.ctr = currentKpiSource.ctr;
-    if (kpis.averageCpc == null) kpis.averageCpc = currentKpiSource.averageCpc;
-    if (kpis.costPerConversion == null) kpis.costPerConversion = currentKpiSource.costPerConversion;
-  }
-  if (!kpis.previousPeriod && previousPeriod) {
+    if (currentKpiSource.cost != null) kpis.cost = currentKpiSource.cost;
+    if (currentKpiSource.impressions != null) kpis.impressions = currentKpiSource.impressions;
+    if (currentKpiSource.clicks != null) kpis.clicks = currentKpiSource.clicks;
+    if (currentKpiSource.conversions != null) kpis.conversions = currentKpiSource.conversions;
+    if (currentKpiSource.ctr != null) kpis.ctr = currentKpiSource.ctr;
+    if (currentKpiSource.averageCpc != null) kpis.averageCpc = currentKpiSource.averageCpc;
+    if (currentKpiSource.costPerConversion != null) {
+      kpis.costPerConversion = currentKpiSource.costPerConversion;
+    }
+  }
+  if (previousPeriod) {
     kpis.previousPeriod = {
       cost: num2(previousPeriod.spend),
       impressions: num2(previousPeriod.impressions),
@@ -102303,7 +102305,7 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     };
   }
   const charts = { ...payload.charts ?? {} };
-  if (!charts.dailyTrend) {
+  {
     const dailyRows = items(sectionMap.get("daily-metrics"));
     if (dailyRows.length > 0) {
       const sorted = [...dailyRows].sort(
@@ -102318,7 +102320,7 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     }
   }
   const tables = { ...payload.tables ?? {} };
-  if (!tables.dimensionSummary) {
+  {
     const summary = record(sectionMap.get("dimension-summary"));
     if (summary) {
       tables.dimensionSummary = {
@@ -102335,19 +102337,19 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
       };
     }
   }
-  if (!tables.campaigns && campaignRows2.length > 0) {
+  if (campaignRows2.length > 0) {
     tables.campaigns = campaignRows2.map((r) => ({
       ...pickMetricRow(r, ["campaignName", "campaignStatusDisplay", "channelTypeV2"]),
       budgetAmountYuan: r.budgetAmountYuan ?? null
     }));
   }
-  if (!tables.devices) {
+  {
     const rows = items(sectionMap.get("devices"));
     if (rows.length > 0) {
       tables.devices = rows.map((r) => pickMetricRow(r, ["deviceType"]));
     }
   }
-  if (!tables.geographic) {
+  {
     const rows = items(sectionMap.get("geographic"));
     if (rows.length > 0) {
       tables.geographic = rows.map(
@@ -102355,7 +102357,7 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
       );
     }
   }
-  if (!tables.keywords) {
+  {
     const rows = items(sectionMap.get("keywords"));
     if (rows.length > 0) {
       tables.keywords = rows.map(
@@ -103814,7 +103816,7 @@ function resolveSectionList(sections, exclude) {
   const base = include.length > 0 ? SECTIONS.filter((s) => include.includes(s.name)) : SECTIONS;
   return base.filter((s) => !drop.has(s.name));
 }
-async function runWithConcurrency(tasks, concurrency) {
+async function runWithConcurrency2(tasks, concurrency) {
   const results = new Array(tasks.length);
   let cursor = 0;
   const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
@@ -103897,7 +103899,7 @@ async function runAllSections(opts) {
   const cliVersion = getCurrentVersion2();
   const overallT0 = performance4.now();
   const tasks = targets.map((def) => () => fetchAndWriteSection(def, opts, config, id, cliVersion));
-  let results = await runWithConcurrency(tasks, concurrency);
+  let results = await runWithConcurrency2(tasks, concurrency);
   const failedIndices = results.map((r, i) => r.ok ? -1 : i).filter((i) => i >= 0);
   if (failedIndices.length > 0) {
     console.error(`
@@ -107055,6 +107057,747 @@ function register9(program2) {
 // src/index.ts
 init_accounts_digest2();
 
+// src/commands/guard/budget-circuit.ts
+init_cli_json_snapshot();
+
+// src/commands/guard/shared.ts
+init_auth();
+init_list_fetch();
+
+// src/commands/ad/_shared.ts
+init_auth();
+async function findItemInList(listUrl, config, id, verbose) {
+  const res = await apiFetch2(listUrl, config, {}, verbose);
+  const item = (res.data ?? []).find((x) => x["id"] === id);
+  if (!item) {
+    throw new Error(`\u672A\u5728\u5217\u8868\u4E2D\u627E\u5230 id="${id}" \u7684\u6761\u76EE`);
+  }
+  return item;
+}
+function toGoogleDate(dateStr, offsetDays) {
+  if (dateStr) return dateStr.replace(/-/g, "/");
+  const d = /* @__PURE__ */ new Date();
+  d.setDate(d.getDate() + offsetDays);
+  return d.toISOString().slice(0, 10).replace(/-/g, "/");
+}
+function toDisplayMoney(raw) {
+  if (raw == null) return null;
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return null;
+  return n / 100;
+}
+function toCentAmount(displayValue) {
+  if (!Number.isFinite(displayValue)) {
+    throw new Error(`toCentAmount: \u8F93\u5165\u5FC5\u987B\u662F\u6709\u9650\u6570\u5B57\uFF0C\u6536\u5230 ${displayValue}`);
+  }
+  return Math.round(displayValue * 100);
+}
+var CAMPAIGN_BATCH_MONEY_KEYS = /* @__PURE__ */ new Set([
+  "Budget",
+  "MaxCPCAmount",
+  "MaxCpmAmount",
+  "MaxCPVAmount",
+  "TargetCpa_BidingAmount",
+  "TargetSpend_BidCeilingAmount",
+  "TargetCpaAmount",
+  "MaxCPC"
+]);
+function convertBatchMoneyTreeFromYuan(value) {
+  return convertBatchMoneyTreeFromYuanInner(value);
+}
+function convertBatchMoneyTreeFromYuanInner(value) {
+  if (Array.isArray(value)) {
+    return value.map(convertBatchMoneyTreeFromYuanInner);
+  }
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, val] of Object.entries(value)) {
+      if (typeof val === "number" && CAMPAIGN_BATCH_MONEY_KEYS.has(key)) {
+        out[key] = toCentAmount(val);
+      } else {
+        out[key] = convertBatchMoneyTreeFromYuanInner(val);
+      }
+    }
+    return out;
+  }
+  return value;
+}
+function adgroupListUrl(googleApiUrl, account, startDate, endDate) {
+  const params = new URLSearchParams();
+  params.set("startDate", toGoogleDate(startDate, -30));
+  params.set("endDate", toGoogleDate(endDate, 0));
+  return `${googleApiUrl}/adgroupnmanagement/v2/list/${account}?${params}`;
+}
+function requireGoogleApi(config) {
+  if (!config.googleApiUrl) {
+    console.error(
+      "\n\u274C \u672A\u627E\u5230 Google API \u5730\u5740\u3002\n   Google API \u5730\u5740\u4ECE TSO API \u5730\u5740\u81EA\u52A8\u63A8\u5BFC\uFF0C\u4E5F\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF SILUZAN_GOOGLE_API \u8986\u76D6\u3002\n"
+    );
+    process.exit(1);
+  }
+  return config.googleApiUrl;
+}
+
+// src/commands/guard/shared.ts
+init_cli_table();
+var GUARD_ACCOUNT_CONCURRENCY = 4;
+async function resolveGuardConfig(opts) {
+  let config = loadConfig(opts.token);
+  if (opts.refreshDp) {
+    config = await refreshDataPermission(config);
+  }
+  return config;
+}
+function assertGoogleOnly(media) {
+  if (media !== "Google") {
+    console.error(
+      `
+\u274C guard \u7194\u65AD\u5199\u76EE\u524D\u4EC5\u652F\u6301 Google\uFF08\u5F53\u524D\uFF1A${media}\uFF09\u3002
+   \u975E Google \u5A92\u4F53\u672C CLI \u65E0\u7CFB\u5217/\u7EC4/\u521B\u610F\u6682\u505C\u5199\u80FD\u529B\uFF1B\u8BF7\u6539\u7528 -m Google\u3002
+`
+    );
+    process.exit(1);
+  }
+}
+async function resolveGuardAccounts(opts, config) {
+  const filterIds = (opts.accounts ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  if (filterIds.length > 0) {
+    process.stderr.write(
+      `\u23F3 [guard] \u5B50\u96C6\u6A21\u5F0F\uFF1A\u5BF9 -a \u6307\u5B9A\u7684 ${filterIds.length} \u4E2A\u8D26\u6237\u626B\u63CF\u3002
+`
+    );
+    return filterIds.map((id) => ({ mediaCustomerId: id, name: null }));
+  }
+  const pageSize = Math.max(1, Math.min(500, opts.pageSize ?? 200));
+  const maxPages = Math.max(1, Math.min(200, opts.maxPages ?? 20));
+  const res = await fetchAccountsByMedia("Google", config, {
+    pageSize,
+    maxPages,
+    verbose: opts.verbose
+  });
+  return res.items.map((item) => ({
+    mediaCustomerId: String(item.ma?.mediaCustomerId ?? ""),
+    name: item.ma?.mediaCustomerName ?? null
+  })).filter((a) => a.mediaCustomerId);
+}
+async function runWithConcurrency(tasks, concurrency) {
+  const results = new Array(tasks.length);
+  let cursor = 0;
+  const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length || 1))).fill(0).map(async () => {
+    while (true) {
+      const i = cursor++;
+      if (i >= tasks.length) return;
+      results[i] = await tasks[i]();
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function fetchCampaignsForDay(config, accountId, date, verbose) {
+  const googleApiUrl = requireGoogleApi(config);
+  const params = new URLSearchParams();
+  params.set("startDate", toGoogleDate(date, 0));
+  params.set("endDate", toGoogleDate(date, 0));
+  const url = `${googleApiUrl}/campaignmanagement/v2/list/${accountId}?${params}`;
+  const data = await apiFetch2(url, config, {}, verbose);
+  return (data.data ?? []).map((item) => ({
+    id: String(item["id"] ?? ""),
+    name: String(item["name"] ?? ""),
+    statusV2: String(item["statusV2"] ?? ""),
+    budget: toDisplayMoney(item["budget"]),
+    spend: item["spend"] != null && Number.isFinite(Number(item["spend"])) ? Number(item["spend"]) : 0,
+    conversions: item["conversions"] != null && Number.isFinite(Number(item["conversions"])) ? Number(item["conversions"]) : null
+  })).filter((r) => r.id);
+}
+async function fetchAdGroupsForDay(config, accountId, date, verbose) {
+  const googleApiUrl = requireGoogleApi(config);
+  const params = new URLSearchParams();
+  params.set("startDate", toGoogleDate(date, 0));
+  params.set("endDate", toGoogleDate(date, 0));
+  const url = `${googleApiUrl}/adgroupnmanagement/v2/list/${accountId}?${params}`;
+  const data = await apiFetch2(url, config, {}, verbose);
+  return (data.data ?? []).map((item) => ({
+    id: String(item["id"] ?? ""),
+    name: String(item["name"] ?? ""),
+    campaignName: String(item["campaignName"] ?? ""),
+    statusV2: String(item["statusV2"] ?? ""),
+    spend: item["spend"] != null && Number.isFinite(Number(item["spend"])) ? Number(item["spend"]) : 0,
+    conversions: item["conversions"] != null && Number.isFinite(Number(item["conversions"])) ? Number(item["conversions"]) : null,
+    targetCpaAmountYuan: toDisplayMoney(item["targetCpaAmount"])
+  })).filter((r) => r.id);
+}
+async function fetchAdsForDay(config, accountId, date, verbose) {
+  const googleApiUrl = requireGoogleApi(config);
+  const params = new URLSearchParams();
+  params.set("startDate", toGoogleDate(date, 0));
+  params.set("endDate", toGoogleDate(date, 0));
+  const url = `${googleApiUrl}/admanagement/v2/list/${accountId}?${params}`;
+  const data = await apiFetch2(url, config, {}, verbose);
+  return (data.data ?? []).map((item) => {
+    const rawTitle = item["headlines"]?.[0] ?? item["adTitle"] ?? item["headlinePart1"] ?? item["name"] ?? "";
+    return {
+      id: String(item["id"] ?? ""),
+      name: String(rawTitle),
+      campaign: String(item["campaign"] ?? ""),
+      adGroup: String(item["adGroup"] ?? ""),
+      statusV2: String(item["statusV2"] ?? ""),
+      spend: item["spend"] != null && Number.isFinite(Number(item["spend"])) ? Number(item["spend"]) : 0,
+      conversions: item["conversions"] != null && Number.isFinite(Number(item["conversions"])) ? Number(item["conversions"]) : null
+    };
+  }).filter((r) => r.id);
+}
+async function pauseCampaign(config, accountId, campaignId, verbose) {
+  const googleApiUrl = requireGoogleApi(config);
+  const detailUrl = `${googleApiUrl}/campaignmanagement/campaign/${accountId}/${campaignId}`;
+  const res = await apiFetch2(detailUrl, config, {}, verbose);
+  const campaign = res.data ?? res;
+  const body = { ...campaign, statusV2: "Paused" };
+  await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, verbose);
+}
+async function pauseAdGroup(config, accountId, adGroupId, date, verbose) {
+  const googleApiUrl = requireGoogleApi(config);
+  const listUrl = adgroupListUrl(googleApiUrl, accountId, date, date);
+  const adgroup = await findItemInList(
+    listUrl,
+    config,
+    adGroupId,
+    verbose
+  );
+  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${accountId}/${adGroupId}`;
+  await apiFetch2(
+    putUrl,
+    config,
+    { method: "PUT", body: JSON.stringify({ ...adgroup, statusV2: "Paused" }) },
+    verbose
+  );
+}
+async function pauseAd(config, accountId, adId, date, verbose) {
+  const googleApiUrl = requireGoogleApi(config);
+  const params = new URLSearchParams();
+  params.set("startDate", toGoogleDate(date, 0));
+  params.set("endDate", toGoogleDate(date, 0));
+  const listUrl = `${googleApiUrl}/admanagement/v2/list/${accountId}?${params}`;
+  const ad = await findItemInList(listUrl, config, adId, verbose);
+  const putUrl = `${googleApiUrl}/admanagement/campaign/${accountId}/${adId}`;
+  await apiFetch2(
+    putUrl,
+    config,
+    { method: "PUT", body: JSON.stringify({ ...ad, statusV2: "Paused" }) },
+    verbose
+  );
+}
+function printHitsTable(title, rows, cols) {
+  console.log(`
+${title}
+`);
+  if (rows.length === 0) {
+    console.log("  \uFF08\u65E0\u547D\u4E2D\uFF09\n");
+    return;
+  }
+  printCliTable(rows, cols);
+  console.log();
+}
+
+// src/commands/guard/rules.ts
+function moneyGte(leftYuan, rightYuan) {
+  return Math.round(leftYuan * 100) >= Math.round(rightYuan * 100);
+}
+function isBudgetCircuitHit(spend, budgetYuan, ratio) {
+  if (spend == null || budgetYuan == null) return false;
+  if (!Number.isFinite(spend) || !Number.isFinite(budgetYuan) || !Number.isFinite(ratio)) {
+    return false;
+  }
+  if (budgetYuan <= 0 || ratio <= 0) return false;
+  return moneyGte(spend, budgetYuan * ratio);
+}
+function isZeroConvHit(spend, conversions, targetCpaYuan, multiple) {
+  if (spend == null || targetCpaYuan == null) return false;
+  if (!Number.isFinite(spend) || !Number.isFinite(targetCpaYuan) || !Number.isFinite(multiple)) {
+    return false;
+  }
+  if (targetCpaYuan <= 0 || multiple <= 0) return false;
+  const conv = conversions == null || !Number.isFinite(conversions) ? 0 : conversions;
+  if (conv !== 0) return false;
+  return moneyGte(spend, targetCpaYuan * multiple);
+}
+function shanghaiToday(now = /* @__PURE__ */ new Date()) {
+  return new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Asia/Shanghai",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).format(now);
+}
+function isEnabledStatus(statusV2) {
+  return String(statusV2 ?? "").toLowerCase() === "enabled";
+}
+
+// src/commands/guard/budget-circuit.ts
+async function runBudgetCircuit(opts) {
+  assertGoogleOnly(opts.media);
+  const config = await resolveGuardConfig(opts);
+  const date = opts.date?.trim() || shanghaiToday();
+  const ratio = opts.ratio ?? 1.1;
+  if (!Number.isFinite(ratio) || ratio <= 0) {
+    console.error("\n\u274C --ratio \u5FC5\u987B\u4E3A\u6B63\u6570\uFF08\u4F8B\u5982 1.1\uFF09\n");
+    process.exit(1);
+  }
+  const statusFilter = opts.status === void 0 ? "Enabled" : opts.status;
+  const filterAll = statusFilter === "" || statusFilter === "*";
+  const apply = Boolean(opts.apply);
+  const accounts = await resolveGuardAccounts(opts, config);
+  if (accounts.length === 0) {
+    console.error("\n\u274C \u672A\u627E\u5230\u53EF\u626B\u63CF\u7684 Google \u8D26\u6237\u3002\n");
+    process.exit(1);
+  }
+  process.stderr.write(
+    `\u23F3 [guard budget-circuit] ${accounts.length} \u6237 \xB7 \u65E5\u671F ${date} \xB7 ratio=${ratio}${apply ? " \xB7 APPLY" : " \xB7 dry-run"}
+`
+  );
+  const accountResults = await runWithConcurrency(
+    accounts.map((acc) => async () => {
+      try {
+        const campaigns = await fetchCampaignsForDay(
+          config,
+          acc.mediaCustomerId,
+          date,
+          opts.verbose
+        );
+        const hits2 = [];
+        let checked = 0;
+        for (const c of campaigns) {
+          if (!filterAll) {
+            if (statusFilter.toLowerCase() === "enabled") {
+              if (!isEnabledStatus(c.statusV2)) continue;
+            } else if (String(c.statusV2) !== statusFilter) {
+              continue;
+            }
+          }
+          checked++;
+          if (!isBudgetCircuitHit(c.spend, c.budget, ratio)) continue;
+          const budget = c.budget;
+          const hit = {
+            mediaCustomerId: acc.mediaCustomerId,
+            accountName: acc.name,
+            campaignId: c.id,
+            campaignName: c.name,
+            statusV2: c.statusV2,
+            spend: c.spend,
+            budget,
+            ratio,
+            threshold: budget * ratio,
+            applied: false
+          };
+          if (apply) {
+            try {
+              await pauseCampaign(config, acc.mediaCustomerId, c.id, opts.verbose);
+              hit.applied = true;
+              hit.statusV2 = "Paused";
+            } catch (err) {
+              hit.applyError = err instanceof Error ? err.message : String(err);
+            }
+          }
+          hits2.push(hit);
+        }
+        return {
+          mediaCustomerId: acc.mediaCustomerId,
+          accountName: acc.name,
+          checked,
+          hits: hits2
+        };
+      } catch (err) {
+        return {
+          mediaCustomerId: acc.mediaCustomerId,
+          accountName: acc.name,
+          checked: 0,
+          hits: [],
+          error: err instanceof Error ? err.message : String(err)
+        };
+      }
+    }),
+    GUARD_ACCOUNT_CONCURRENCY
+  );
+  const hits = accountResults.flatMap((r) => r.hits);
+  const errors = accountResults.filter((r) => r.error).map((r) => ({
+    mediaCustomerId: r.mediaCustomerId,
+    accountName: r.accountName,
+    error: r.error
+  }));
+  const paused = hits.filter((h) => h.applied);
+  const checkedCampaigns = accountResults.reduce((n, r) => n + r.checked, 0);
+  const payload = {
+    meta: {
+      media: "Google",
+      date,
+      ratio,
+      statusFilter: filterAll ? "*" : statusFilter,
+      apply,
+      note: "\u975E Google \u5A92\u4F53\u672C CLI \u65E0\u7CFB\u5217\u7194\u65AD\u5199\u80FD\u529B\uFF1B\u672C\u547D\u4EE4\u4EC5\u626B\u63CF Google\u3002"
+    },
+    summary: {
+      label: "\u8D85\u9884\u7B97\u7194\u65AD",
+      accountCount: accounts.length,
+      checkedCampaigns,
+      hitCount: hits.length,
+      pausedCount: paused.length,
+      errorCount: errors.length,
+      mode: apply ? "apply" : "dry-run"
+    },
+    hits,
+    paused,
+    errors
+  };
+  if (await emitCliJsonOrSnapshot(opts, {
+    section: "guard-budget-circuit",
+    commandLabel: "guard budget-circuit",
+    payload
+  })) {
+  }
+  const title = `\u8D85\u9884\u7B97\u7194\u65AD\uFF08${apply ? "\u5DF2\u5C1D\u8BD5\u6682\u505C" : "dry-run"}\uFF09 \xB7 ${date} \xB7 ratio=${ratio} \xB7 \u547D\u4E2D ${hits.length}/${checkedCampaigns}`;
+  printHitsTable(
+    title,
+    hits.map((h) => ({
+      account: h.mediaCustomerId,
+      campaign: h.campaignName.slice(0, 36),
+      spend: h.spend.toFixed(2),
+      budget: h.budget.toFixed(2),
+      threshold: h.threshold.toFixed(2),
+      applied: h.applied ? "Paused" : h.applyError ? `ERR:${h.applyError.slice(0, 20)}` : "\u2014"
+    })),
+    [
+      { key: "account", header: "\u8D26\u6237ID" },
+      { key: "campaign", header: "\u7CFB\u5217" },
+      { key: "spend", header: "\u5F53\u65E5\u82B1\u8D39" },
+      { key: "budget", header: "\u65E5\u9884\u7B97" },
+      { key: "threshold", header: "\u9608\u503C" },
+      { key: "applied", header: "\u6682\u505C" }
+    ]
+  );
+  if (errors.length > 0) {
+    console.error(`\u26A0\uFE0F  ${errors.length} \u4E2A\u8D26\u6237\u62C9\u6570\u5931\u8D25\uFF08\u8BE6\u89C1 json-out errors[]\uFF09`);
+    for (const e of errors.slice(0, 5)) {
+      console.error(`   \u2022 ${e.mediaCustomerId}: ${e.error}`);
+    }
+  }
+  if (!apply && hits.length > 0) {
+    console.log(
+      '\u63D0\u793A\uFF1A\u4EE5\u4E0A\u4E3A dry-run\u3002\u786E\u8BA4\u540E\u8FFD\u52A0 --apply --commit "budget-circuit <date>" \u6267\u884C\u6682\u505C\u3002\n'
+    );
+  } else if (apply) {
+    console.log(
+      `\u2705 apply \u5B8C\u6210\uFF1A\u547D\u4E2D ${hits.length}\uFF0C\u6210\u529F\u6682\u505C ${paused.length}${hits.length - paused.length > 0 ? `\uFF0C\u5931\u8D25 ${hits.length - paused.length}` : ""}\u3002
+`
+    );
+  } else {
+    console.log("\u2705 \u4ECA\u65E5\u65E0\u7CFB\u5217\u89E6\u53D1\u8D85\u9884\u7B97\u7194\u65AD\u3002\n");
+  }
+}
+
+// src/commands/guard/zero-conv.ts
+init_cli_json_snapshot();
+function parseLevel(raw) {
+  const v = (raw ?? "adgroup").toLowerCase();
+  if (v === "adgroup" || v === "ad" || v === "both") return v;
+  console.error("\n\u274C --level \u987B\u4E3A adgroup | ad | both\n");
+  process.exit(1);
+}
+async function runZeroConv(opts) {
+  assertGoogleOnly(opts.media);
+  const config = await resolveGuardConfig(opts);
+  const date = opts.date?.trim() || shanghaiToday();
+  const multiple = opts.cpaMultiple ?? 3;
+  if (!Number.isFinite(multiple) || multiple <= 0) {
+    console.error("\n\u274C --cpa-multiple \u5FC5\u987B\u4E3A\u6B63\u6570\uFF08\u4F8B\u5982 3\uFF09\n");
+    process.exit(1);
+  }
+  const level = parseLevel(opts.level);
+  const fallback = opts.fallbackTargetCpa != null && Number.isFinite(opts.fallbackTargetCpa) ? opts.fallbackTargetCpa : null;
+  const onlyEnabled = opts.onlyEnabled !== false;
+  const apply = Boolean(opts.apply);
+  if ((level === "ad" || level === "both") && fallback == null) {
+    process.stderr.write(
+      "\u26A0\uFE0F  [guard zero-conv] \u521B\u610F\u7EF4\u65E0\u7EC4\u7EA7 targetCpa \u5B57\u6BB5\uFF0C\u672A\u4F20 --fallback-target-cpa \u65F6\u521B\u610F\u547D\u4E2D\u53EF\u80FD\u4E3A 0\uFF08\u4F1A\u8BB0\u5165 skipped\uFF09\u3002\n"
+    );
+  }
+  const accounts = await resolveGuardAccounts(opts, config);
+  if (accounts.length === 0) {
+    console.error("\n\u274C \u672A\u627E\u5230\u53EF\u626B\u63CF\u7684 Google \u8D26\u6237\u3002\n");
+    process.exit(1);
+  }
+  process.stderr.write(
+    `\u23F3 [guard zero-conv] ${accounts.length} \u6237 \xB7 ${date} \xB7 \xD7${multiple} \xB7 level=${level}${apply ? " \xB7 APPLY" : " \xB7 dry-run"}
+`
+  );
+  const accountResults = await runWithConcurrency(
+    accounts.map((acc) => async () => {
+      try {
+        const hits2 = [];
+        const skipped2 = [];
+        let checked2 = 0;
+        if (level === "adgroup" || level === "both") {
+          const groups = await fetchAdGroupsForDay(
+            config,
+            acc.mediaCustomerId,
+            date,
+            opts.verbose
+          );
+          for (const g of groups) {
+            if (onlyEnabled && !isEnabledStatus(g.statusV2)) continue;
+            checked2++;
+            const target = g.targetCpaAmountYuan ?? fallback;
+            if (target == null) {
+              skipped2.push({
+                mediaCustomerId: acc.mediaCustomerId,
+                level: "adgroup",
+                objectId: g.id,
+                objectName: g.name,
+                reason: "missing_target_cpa"
+              });
+              continue;
+            }
+            if (!isZeroConvHit(g.spend, g.conversions, target, multiple)) continue;
+            const hit = {
+              mediaCustomerId: acc.mediaCustomerId,
+              accountName: acc.name,
+              level: "adgroup",
+              objectId: g.id,
+              objectName: g.name,
+              parentName: g.campaignName,
+              statusV2: g.statusV2,
+              spend: g.spend,
+              conversions: g.conversions ?? 0,
+              targetCpaYuan: target,
+              multiple,
+              threshold: target * multiple,
+              applied: false
+            };
+            if (apply) {
+              try {
+                await pauseAdGroup(config, acc.mediaCustomerId, g.id, date, opts.verbose);
+                hit.applied = true;
+                hit.statusV2 = "Paused";
+              } catch (err) {
+                hit.applyError = err instanceof Error ? err.message : String(err);
+              }
+            }
+            hits2.push(hit);
+          }
+        }
+        if (level === "ad" || level === "both") {
+          const ads = await fetchAdsForDay(config, acc.mediaCustomerId, date, opts.verbose);
+          for (const ad of ads) {
+            if (onlyEnabled && !isEnabledStatus(ad.statusV2)) continue;
+            checked2++;
+            if (fallback == null) {
+              skipped2.push({
+                mediaCustomerId: acc.mediaCustomerId,
+                level: "ad",
+                objectId: ad.id,
+                objectName: ad.name,
+                reason: "missing_fallback_target_cpa"
+              });
+              continue;
+            }
+            if (!isZeroConvHit(ad.spend, ad.conversions, fallback, multiple)) continue;
+            const hit = {
+              mediaCustomerId: acc.mediaCustomerId,
+              accountName: acc.name,
+              level: "ad",
+              objectId: ad.id,
+              objectName: ad.name,
+              parentName: `${ad.campaign} / ${ad.adGroup}`,
+              statusV2: ad.statusV2,
+              spend: ad.spend,
+              conversions: ad.conversions ?? 0,
+              targetCpaYuan: fallback,
+              multiple,
+              threshold: fallback * multiple,
+              applied: false
+            };
+            if (apply) {
+              try {
+                await pauseAd(config, acc.mediaCustomerId, ad.id, date, opts.verbose);
+                hit.applied = true;
+                hit.statusV2 = "Paused";
+              } catch (err) {
+                hit.applyError = err instanceof Error ? err.message : String(err);
+              }
+            }
+            hits2.push(hit);
+          }
+        }
+        return {
+          mediaCustomerId: acc.mediaCustomerId,
+          accountName: acc.name,
+          checked: checked2,
+          hits: hits2,
+          skipped: skipped2
+        };
+      } catch (err) {
+        return {
+          mediaCustomerId: acc.mediaCustomerId,
+          accountName: acc.name,
+          checked: 0,
+          hits: [],
+          skipped: [],
+          error: err instanceof Error ? err.message : String(err)
+        };
+      }
+    }),
+    GUARD_ACCOUNT_CONCURRENCY
+  );
+  const hits = accountResults.flatMap((r) => r.hits);
+  const skipped = accountResults.flatMap((r) => r.skipped);
+  const errors = accountResults.filter((r) => r.error).map((r) => ({
+    mediaCustomerId: r.mediaCustomerId,
+    accountName: r.accountName,
+    error: r.error
+  }));
+  const paused = hits.filter((h) => h.applied);
+  const checked = accountResults.reduce((n, r) => n + r.checked, 0);
+  const payload = {
+    meta: {
+      media: "Google",
+      date,
+      cpaMultiple: multiple,
+      level,
+      fallbackTargetCpa: fallback,
+      apply,
+      note: "\u975E Google \u5A92\u4F53\u672C CLI \u65E0\u7EC4/\u521B\u610F\u7194\u65AD\u5199\u80FD\u529B\uFF1B\u672C\u547D\u4EE4\u4EC5\u626B\u63CF Google\u3002P1\u300C\u7A7A\u8017\u7194\u65AD\u300D\u901A\u77E5\u7531\u5BBF\u4E3B\u53D1\u9001\u3002"
+    },
+    summary: {
+      label: "\u7A7A\u8017\u7194\u65AD",
+      accountCount: accounts.length,
+      checkedObjects: checked,
+      hitCount: hits.length,
+      pausedCount: paused.length,
+      skippedCount: skipped.length,
+      errorCount: errors.length,
+      mode: apply ? "apply" : "dry-run"
+    },
+    hits,
+    paused,
+    skipped,
+    errors
+  };
+  await emitCliJsonOrSnapshot(opts, {
+    section: "guard-zero-conv",
+    commandLabel: "guard zero-conv",
+    payload
+  });
+  const title = `\u7A7A\u8017\u7194\u65AD\uFF08${apply ? "\u5DF2\u5C1D\u8BD5\u6682\u505C" : "dry-run"}\uFF09 \xB7 ${date} \xB7 \xD7${multiple} \xB7 \u547D\u4E2D ${hits.length}/${checked}`;
+  printHitsTable(
+    title,
+    hits.map((h) => ({
+      account: h.mediaCustomerId,
+      level: h.level,
+      name: h.objectName.slice(0, 32),
+      spend: h.spend.toFixed(2),
+      target: h.targetCpaYuan.toFixed(2),
+      threshold: h.threshold.toFixed(2),
+      applied: h.applied ? "Paused" : h.applyError ? `ERR` : "\u2014"
+    })),
+    [
+      { key: "account", header: "\u8D26\u6237ID" },
+      { key: "level", header: "\u5C42\u7EA7" },
+      { key: "name", header: "\u5BF9\u8C61" },
+      { key: "spend", header: "\u5F53\u65E5\u82B1\u8D39" },
+      { key: "target", header: "\u76EE\u6807CPA" },
+      { key: "threshold", header: "\u9608\u503C" },
+      { key: "applied", header: "\u6682\u505C" }
+    ]
+  );
+  if (errors.length > 0) {
+    console.error(`\u26A0\uFE0F  ${errors.length} \u4E2A\u8D26\u6237\u62C9\u6570\u5931\u8D25\uFF08\u8BE6\u89C1 json-out errors[]\uFF09`);
+  }
+  if (!apply && hits.length > 0) {
+    console.log(
+      '\u63D0\u793A\uFF1A\u4EE5\u4E0A\u4E3A dry-run\u3002\u786E\u8BA4\u540E\u8FFD\u52A0 --apply --commit "zero-conv <date>" \u6267\u884C\u6682\u505C\u3002\n'
+    );
+  } else if (apply) {
+    console.log(
+      `\u2705 apply \u5B8C\u6210\uFF1A\u547D\u4E2D ${hits.length}\uFF0C\u6210\u529F\u6682\u505C ${paused.length}${hits.length - paused.length > 0 ? `\uFF0C\u5931\u8D25 ${hits.length - paused.length}` : ""}\u3002
+`
+    );
+  } else {
+    console.log("\u2705 \u4ECA\u65E5\u65E0\u5BF9\u8C61\u89E6\u53D1\u7A7A\u8017\u7194\u65AD\u3002\n");
+  }
+}
+
+// src/commands/guard/_register.ts
+function register11(program2) {
+  const guard = program2.command("guard").description(
+    "Google \u6295\u653E\u81EA\u63A7\u7194\u65AD\uFF1A\u5168\u6237\uFF08\u6216 -a \u5B50\u96C6\uFF09\u626B\u63CF\u5F53\u65E5\u8D85\u9884\u7B97/\u7A7A\u8017\u547D\u4E2D\uFF0C\u9ED8\u8BA4 dry-run\uFF1B--apply \u65F6\u6682\u505C\u547D\u4E2D\u5BF9\u8C61\uFF08\u987B\u5168\u5C40 --commit\uFF09\u3002\u975E Google \u5A92\u4F53\u4E0D\u652F\u6301\u3002"
+  );
+  guard.command("budget-circuit").description(
+    "\u5355\u65E5\u9884\u7B97\u7194\u65AD\uFF1A\u5F53\u65E5\u7CFB\u5217 spend \u2265 \u65E5\u9884\u7B97 \xD7 ratio \u65F6\u5217\u51FA\uFF08\u53EF\u9009\u6682\u505C\uFF09\u3002\u66FF\u4EE3\u300Clist-accounts \xD7 N + \u9010\u6237 ad campaigns + \u811A\u672C\u300D\u3002"
+  ).requiredOption("-m, --media <type>", "\u76EE\u524D\u4EC5\u652F\u6301 Google").option(
+    "-a, --accounts <ids>",
+    "\u6307\u5B9A\u8D26\u6237 mediaCustomerId\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u7559\u7A7A\u5219\u626B\u63CF\u540D\u4E0B\u5168\u90E8 Google \u8D26\u6237"
+  ).option("--date <YYYY-MM-DD>", "\u7EDF\u8BA1\u65E5\uFF08Asia/Shanghai \u9ED8\u8BA4\u4ECA\u5929\uFF09\uFF1B\u5F3A\u5236 start=end=\u8BE5\u65E5").option("--ratio <n>", "\u9608\u503C\u7CFB\u6570\uFF1Aspend >= budget * ratio\uFF08\u9ED8\u8BA4 1.1\uFF09", (v) => parseFloat(v)).option(
+    "--status <statusV2>",
+    "\u53EA\u68C0\u67E5\u8BE5\u72B6\u6001\u7684\u7CFB\u5217\uFF08\u9ED8\u8BA4 Enabled\uFF1B\u4F20 * \u8868\u793A\u4E0D\u8FC7\u6EE4\uFF09",
+    "Enabled"
+  ).option("--apply", "\u5BF9\u547D\u4E2D\u7CFB\u5217\u6267\u884C Paused\uFF08\u987B\u914D\u5408\u5168\u5C40 --commit\uFF09", false).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF09").option(
+    "--json-out <path>",
+    "\u843D\u76D8\u76EE\u5F55\u6216 *.json\uFF1Bstdout \u4E00\u884C\u6458\u8981\uFF1B\u4EBA\u7C7B\u53EF\u8BFB\u8868\u59CB\u7EC8\u6253\u5370",
+    void 0
+  ).option("--refresh-dp", "\u5F3A\u5236\u91CD\u62C9 Datapermission", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF", false).action(
+    async (opts) => {
+      await runBudgetCircuit({
+        media: opts.media,
+        accounts: opts.accounts,
+        date: opts.date,
+        ratio: opts.ratio,
+        status: opts.status,
+        apply: opts.apply,
+        pageSize: opts.pageSize,
+        maxPages: opts.maxPages,
+        token: opts.token,
+        jsonOut: opts.jsonOut,
+        refreshDp: opts.refreshDp,
+        verbose: opts.verbose
+      });
+    }
+  );
+  guard.command("zero-conv").description(
+    "\u7A7A\u8017\u7194\u65AD\uFF1A\u5F53\u65E5 spend \u2265 \u76EE\u6807 CPA \xD7 N \u4E14\u8F6C\u5316\u4E3A 0 \u65F6\u5217\u51FA\u7EC4/\u521B\u610F\uFF08\u53EF\u9009\u6682\u505C\uFF09\u3002\u7ED3\u679C summary.label=\u300C\u7A7A\u8017\u7194\u65AD\u300D\uFF1BP1 \u901A\u77E5\u7531\u5BBF\u4E3B\u53D1\u9001\u3002"
+  ).requiredOption("-m, --media <type>", "\u76EE\u524D\u4EC5\u652F\u6301 Google").option(
+    "-a, --accounts <ids>",
+    "\u6307\u5B9A\u8D26\u6237 mediaCustomerId\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u7559\u7A7A\u5219\u626B\u63CF\u540D\u4E0B\u5168\u90E8 Google \u8D26\u6237"
+  ).option("--date <YYYY-MM-DD>", "\u7EDF\u8BA1\u65E5\uFF08Asia/Shanghai \u9ED8\u8BA4\u4ECA\u5929\uFF09").option(
+    "--cpa-multiple <n>",
+    "\u500D\u6570 N\uFF1Aspend >= targetCpa \xD7 N\uFF08\u9ED8\u8BA4 3\uFF09",
+    (v) => parseFloat(v)
+  ).option(
+    "--level <level>",
+    "\u626B\u63CF\u5C42\u7EA7\uFF1Aadgroup | ad | both\uFF08\u9ED8\u8BA4 adgroup\uFF09",
+    "adgroup"
+  ).option(
+    "--fallback-target-cpa <yuan>",
+    "\u7EC4\u65E0 targetCpa\uFF08\u6216\u521B\u610F\u7EF4\uFF09\u65F6\u4F7F\u7528\u7684\u76EE\u6807 CPA\uFF08\u5143\uFF09",
+    (v) => parseFloat(v)
+  ).option("--apply", "\u5BF9\u547D\u4E2D\u5BF9\u8C61\u6267\u884C Paused\uFF08\u987B\u914D\u5408\u5168\u5C40 --commit\uFF09", false).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF09").option("--json-out <path>", "\u843D\u76D8\u76EE\u5F55\u6216 *.json", void 0).option("--refresh-dp", "\u5F3A\u5236\u91CD\u62C9 Datapermission", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF", false).action(
+    async (opts) => {
+      await runZeroConv({
+        media: opts.media,
+        accounts: opts.accounts,
+        date: opts.date,
+        cpaMultiple: opts.cpaMultiple,
+        level: opts.level,
+        fallbackTargetCpa: opts.fallbackTargetCpa,
+        apply: opts.apply,
+        pageSize: opts.pageSize,
+        maxPages: opts.maxPages,
+        token: opts.token,
+        jsonOut: opts.jsonOut,
+        refreshDp: opts.refreshDp,
+        verbose: opts.verbose
+      });
+    }
+  );
+}
+
 // src/commands/stats.ts
 init_auth();
 init_cli_json_snapshot();
@@ -107307,7 +108050,7 @@ ${opts.media} \u6295\u653E\u6570\u636E\uFF08${rangeLabel}\uFF09\uFF08\u7B2C 1 \u
   printCliTable(rows, cols);
   console.log();
 }
-function register11(program2) {
+function register12(program2) {
   program2.command("stats").description(
     "\u67E5\u8BE2\u5E7F\u544A\u6D88\u8017\u3001\u70B9\u51FB\u3001\u8F6C\u5316\u7B49\u6295\u653E\u6570\u636E\uFF08\u9ED8\u8BA4\u8FD1 7 \u5929\u533A\u95F4\u5408\u8BA1\uFF0C\u4E0D\u542B\u4ECA\u5929\uFF0C\u65E5\u5386\u6309 UTC+8\uFF1B\u8981\u6309\u65E5\u660E\u7EC6\u52A0 --by-day\uFF09"
   ).requiredOption(
@@ -107426,7 +108169,7 @@ async function runAccountHistory(opts) {
   }
   console.log();
 }
-function register12(program2) {
+function register13(program2) {
   program2.command("account-history").description("\u67E5\u8BE2\u5F00\u6237\u7533\u8BF7\u5386\u53F2\u8BB0\u5F55").option("-m, --media <type>", "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | MetaAd | BingV2 | Kwai").option("-s, --status <status>", "\u7533\u8BF7\u72B6\u6001\u5173\u952E\u5B57").option("-k, --keyword <text>", "\u641C\u7D22\u5173\u952E\u5B57\uFF08\u8D26\u6237\u540D/ID\uFF09").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF\uFF08\u9ED8\u8BA4 20\uFF09", parseInt).option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
@@ -108268,7 +109011,7 @@ async function runReportPushReceiveEmails(opts) {
 var splitCsv = (v) => v.split(",").map((s) => s.trim()).filter(Boolean);
 
 // src/commands/report/register.ts
-function register13(program2) {
+function register14(program2) {
   const reportCmd = program2.command("report").description("\u4F18\u5316\u62A5\u544A\u4E0E\u63A8\u9001\u7BA1\u7406");
   reportCmd.command("list").description("\u67E5\u8BE2\u4F18\u5316\u62A5\u544A\u5217\u8868").requiredOption("-m, --media <type>", "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok").option("-t, --type <type>", "\u62A5\u544A\u7C7B\u578B\uFF08\u5982 Daily / Hourly\uFF09").option("-s, --status <ready>", "\u751F\u6210\u72B6\u6001\uFF08true/false\uFF09").option("-k, --keyword <text>", "\u62A5\u544A\u540D\u79F0\u5173\u952E\u5B57").option("--start <date>", "\u5F00\u59CB\u65E5\u671F").option("--end <date>", "\u7ED3\u675F\u65E5\u671F").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF", parseInt).option("--token <token>", "Auth Token").option(
     "--json-out <path>",
@@ -108596,7 +109339,7 @@ async function runTransferList(opts) {
   printCliTable(rows, cols);
   console.log();
 }
-function register14(program2) {
+function register15(program2) {
   const transferCmd = program2.command("transfer").description("\u5A92\u4F53\u8D26\u6237\u8F6C\u8D26\uFF1A\u63D0\u4EA4\u8F6C\u8D26\u7533\u8BF7\u6216\u67E5\u8BE2\u8F6C\u8D26\u8BB0\u5F55");
   transferCmd.command("create").description("\u63D0\u4EA4\u8D26\u6237\u95F4\u8F6C\u8D26\u7533\u8BF7\uFF08Google / TikTok / MetaAd / BingV2\uFF09").requiredOption("-m, --media <type>", "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | MetaAd | BingV2").requiredOption("--out <id>", "\u8F6C\u51FA\u8D26\u6237 mediaCustomerId\uFF08\u6765\u81EA list-accounts\uFF09").requiredOption("--in <id>", "\u8F6C\u5165\u8D26\u6237 mediaCustomerId\uFF08\u6765\u81EA list-accounts\uFF09").requiredOption("--amount <amount>", "\u8F6C\u8D26\u91D1\u989D\uFF08\u4E0E\u8D26\u6237\u8D27\u5E01\u5355\u4F4D\u4E00\u81F4\uFF09").option("--customer-name <name>", "\u5BA2\u6237\u540D\u79F0\uFF08\u5907\u6CE8\uFF0C\u53EF\u9009\uFF09").option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
@@ -109041,7 +109784,7 @@ async function runInvoiceApply(opts) {
 }
 
 // src/commands/invoice/_register.ts
-function register15(program2) {
+function register16(program2) {
   const invoiceCmd = program2.command("invoice").description("\u5F00\u7968\u8BB0\u5F55\u4E0E\u5F00\u7968\u7533\u8BF7\uFF0C\u4E0D\u652F\u6301\u8D26\u6237\u6FC0\u6D3B\u5145\u503C\u8BA2\u5355\u7684\u5F00\u7968\uFF0C\u5982\u9700\u5F00\u7968\u8BF7\u8054\u7CFB\u7EBF\u4E0B\u8FD0\u8425");
   invoiceCmd.command("list").description("\u67E5\u8BE2\u5F00\u7968\u7533\u8BF7\u8BB0\u5F55").option("-k, --keyword <text>", "\u53D1\u7968\u53F7\u6216\u5173\u952E\u5B57").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF", parseInt).option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
@@ -109312,7 +110055,7 @@ async function runInvoiceInfoDelete(opts) {
 \u2705 \u53D1\u7968\u62AC\u5934\u5DF2\u5220\u9664\uFF08ID: ${opts.id}\uFF09
 `);
 }
-function register16(program2) {
+function register17(program2) {
   const invoiceInfoCmd = program2.command("invoice-info").description("\u53D1\u7968\u62AC\u5934\u7BA1\u7406\uFF08\u5BF9\u5E94\u300C\u8BBE\u7F6E \u2192 \u53D1\u7968\u62AC\u5934\u300D\u9875\u9762\uFF09");
   invoiceInfoCmd.command("list").description("\u67E5\u8BE2\u5DF2\u4FDD\u5B58\u7684\u53D1\u7968\u62AC\u5934\u5217\u8868").option("-k, --keyword <text>", "\u6309\u516C\u53F8\u540D\u79F0\u641C\u7D22").option("--invoice-type <type>", "\u6309\u53D1\u7968\u7C7B\u578B\u7B5B\u9009\uFF1API | VATI | VATSI").option("--page <n>", "\u9875\u7801", (v) => parseInt(v), 1).option("--page-size <n>", "\u6BCF\u9875\u6761\u6570", (v) => parseInt(v), 20).option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
@@ -109660,7 +110403,7 @@ async function runOptimizeChildren(opts) {
 }
 
 // src/commands/optimize/_register.ts
-function register17(program2) {
+function register18(program2) {
   const optimizeCmd = program2.command("optimize").description("AI \u5E7F\u544A\u4F18\u5316\uFF08Google\uFF09");
   optimizeCmd.command("list").description("\u67E5\u8BE2\u8D26\u6237\u7EA7\u4F18\u5316\u4E3B\u5217\u8868\uFF08\u5BF9\u5E94\u9875\u9762 /advertising/intelligentOptimization\uFF09").option("-a, --account <id>", "\u8D26\u6237 mediaCustomerId\uFF08\u7559\u7A7A\u67E5\u5168\u90E8\uFF09").option(
     "--match-media-customer-id <id>",
@@ -109720,13 +110463,31 @@ function register17(program2) {
 }
 
 // src/commands/forewarning/_shared.ts
+init_dist();
 var VALID_MEDIA_TYPES7 = ["Google", "TikTok"];
+function skipForewarningInAgentEnv(commandLabel = "siluzan-tso forewarning") {
+  if (!isSiluzanAgentEnv()) return false;
+  console.log(
+    `
+\u2139\uFE0F  \u68C0\u6D4B\u5230 Siluzan Agent \u73AF\u5883\uFF08IS_SILUZAN_AGENT_ENV=true\uFF09\u3002
+   \`${commandLabel}\` \u5728 Agent \u6C99\u7BB1\u4E2D\u4E0D\u53EF\u7528\uFF0C\u5DF2\u8DF3\u8FC7\uFF08\u4E0D\u6267\u884C\u4EFB\u4F55\u64CD\u4F5C\uFF09\u3002
+
+   \u8BF7\u6539\u4E3A\uFF1A\u521B\u5EFA\u81EA\u52A8\u5316\u4EFB\u52A1\uFF0C\u5728\u4EFB\u52A1\u4E2D\u8C03\u7528 siluzan-tso \u672C Skill
+   \uFF08\u62C9\u6570 / guard / \u5199\u547D\u4EE4\u7B49\uFF09\u5B8C\u6210\u7528\u6237\u7684\u9884\u8B66\u4E0E\u5DE1\u68C0\u9700\u6C42\u3002
+
+   \u5FC5\u8BFB\uFF1Areferences/operations/hosted-automation-user-catalog.md
+   \uFF08\u9884\u7B97\u7194\u65AD / \u5F02\u5E38\u76D1\u63A7 / \u81EA\u52A8\u4F18\u5316\uFF1B\u8868\u5185\u6BCF\u884C\u53EA Read \u4E00\u4E2A SOP\uFF09
+`
+  );
+  return true;
+}
 
 // src/commands/forewarning/list.ts
 init_auth();
 init_cli_json_snapshot();
 init_cli_table();
 async function runForewarningList(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning list")) return;
   if (!VALID_MEDIA_TYPES7.includes(opts.media)) {
     console.error(
       `
@@ -109809,6 +110570,7 @@ init_auth();
 init_cli_json_snapshot();
 init_cli_table();
 async function runForewarningRecords(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning records")) return;
   if (!VALID_MEDIA_TYPES7.includes(opts.media)) {
     console.error(`
 \u274C \u4E0D\u652F\u6301\u7684\u5A92\u4F53\u7C7B\u578B\uFF1A${opts.media}
@@ -109884,6 +110646,7 @@ async function runForewarningRecords(opts) {
 // src/commands/forewarning/actions.ts
 init_auth();
 async function runForewarningStart(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning start")) return;
   const config = loadConfig(opts.token);
   const url = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}/${opts.id}/start`;
   try {
@@ -109897,6 +110660,7 @@ async function runForewarningStart(opts) {
   console.log("\n\u2705 \u9884\u8B66\u89C4\u5219\u5DF2\u542F\u52A8\n");
 }
 async function runForewarningStop(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning stop")) return;
   const config = loadConfig(opts.token);
   const url = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}/${opts.id}/stop`;
   try {
@@ -109910,6 +110674,7 @@ async function runForewarningStop(opts) {
   console.log("\n\u2705 \u9884\u8B66\u89C4\u5219\u5DF2\u505C\u6B62\n");
 }
 async function runForewarningDelete(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning delete")) return;
   const config = loadConfig(opts.token);
   const url = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}/${opts.id}`;
   try {
@@ -109923,6 +110688,7 @@ async function runForewarningDelete(opts) {
   console.log("\n\u2705 \u9884\u8B66\u89C4\u5219\u5DF2\u5220\u9664\n");
 }
 async function runForewarningGet(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning get")) return;
   const config = loadConfig(opts.token);
   const url = `${config.apiBaseUrl}/query/smart-strategy/settings/${opts.media}/${opts.id}`;
   let data;
@@ -109946,6 +110712,7 @@ import QRCode from "qrcode";
 import open2 from "open";
 init_cli_table();
 async function runForewarningNotifyAccounts(opts) {
+  if (skipForewarningInAgentEnv("siluzan-tso forewarning notify-accounts")) return;
   const config = loadConfig(opts.token);
   const listUrl = `${config.apiBaseUrl}/query/notice-account/getAccount`;
   let accounts;
@@ -110066,6 +110833,11 @@ function buildRuleBody(opts) {
   };
 }
 async function runForewarningCreate(opts) {
+  if (skipForewarningInAgentEnv(
+    opts.id ? "siluzan-tso forewarning update" : "siluzan-tso forewarning create"
+  )) {
+    return;
+  }
   if (!VALID_MEDIA_TYPES7.includes(opts.media)) {
     console.error(
       `
@@ -110106,7 +110878,7 @@ async function runForewarningCreate(opts) {
 }
 
 // src/commands/forewarning/_register.ts
-function register18(program2) {
+function register19(program2) {
   const forewarningCmd = program2.command("forewarning").description("\u667A\u80FD\u9884\u8B66\u89C4\u5219\u4E0E\u9884\u8B66\u8BB0\u5F55\u7BA1\u7406");
   forewarningCmd.command("list").description("\u67E5\u8BE2\u9884\u8B66\u89C4\u5219\u5217\u8868").requiredOption("-m, --media <type>", "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok").option("-a, --account <id>", "\u8D26\u6237 ID \u7B5B\u9009").option("-k, --keyword <text>", "\u89C4\u5219\u540D\u79F0\u5173\u952E\u5B57").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF", parseInt).option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
@@ -110398,7 +111170,7 @@ Meta \u7EBF\u7D22\u8868\u5355\uFF08\u8D26\u6237 ${opts.account}\uFF0C\u7B2C 1 \u
     console.log();
   }
 }
-function register19(program2) {
+function register20(program2) {
   program2.command("clue").description("\u67E5\u8BE2\u5E7F\u544A\u7EBF\u7D22\u8868\u5355\u6570\u636E\uFF08TikTok / Meta\uFF09").option("-m, --media <type>", "\u5A92\u4F53\u7C7B\u578B\uFF1ATikTok | Meta", "TikTok").requiredOption("-a, --account <id>", "\u5E7F\u544A\u8D26\u6237 mediaCustomerId").option("--region <region>", "TikTok \u533A\u57DF\uFF1Aeu | us | other | ALL\uFF08\u9ED8\u8BA4 ALL\uFF09").option("--start <date>", "Meta \u5F00\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF09").option("--end <date>", "Meta \u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF09").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
@@ -110417,80 +111189,6 @@ function register19(program2) {
   });
 }
 
-// src/commands/ad/_shared.ts
-init_auth();
-async function findItemInList(listUrl, config, id, verbose) {
-  const res = await apiFetch2(listUrl, config, {}, verbose);
-  const item = (res.data ?? []).find((x) => x["id"] === id);
-  if (!item) {
-    throw new Error(`\u672A\u5728\u5217\u8868\u4E2D\u627E\u5230 id="${id}" \u7684\u6761\u76EE`);
-  }
-  return item;
-}
-function toGoogleDate(dateStr, offsetDays) {
-  if (dateStr) return dateStr.replace(/-/g, "/");
-  const d = /* @__PURE__ */ new Date();
-  d.setDate(d.getDate() + offsetDays);
-  return d.toISOString().slice(0, 10).replace(/-/g, "/");
-}
-function toDisplayMoney(raw) {
-  if (raw == null) return null;
-  const n = Number(raw);
-  if (!Number.isFinite(n)) return null;
-  return n / 100;
-}
-function toCentAmount(displayValue) {
-  if (!Number.isFinite(displayValue)) {
-    throw new Error(`toCentAmount: \u8F93\u5165\u5FC5\u987B\u662F\u6709\u9650\u6570\u5B57\uFF0C\u6536\u5230 ${displayValue}`);
-  }
-  return Math.round(displayValue * 100);
-}
-var CAMPAIGN_BATCH_MONEY_KEYS = /* @__PURE__ */ new Set([
-  "Budget",
-  "MaxCPCAmount",
-  "MaxCpmAmount",
-  "MaxCPVAmount",
-  "TargetCpa_BidingAmount",
-  "TargetSpend_BidCeilingAmount",
-  "TargetCpaAmount",
-  "MaxCPC"
-]);
-function convertBatchMoneyTreeFromYuan(value) {
-  return convertBatchMoneyTreeFromYuanInner(value);
-}
-function convertBatchMoneyTreeFromYuanInner(value) {
-  if (Array.isArray(value)) {
-    return value.map(convertBatchMoneyTreeFromYuanInner);
-  }
-  if (value && typeof value === "object") {
-    const out = {};
-    for (const [key, val] of Object.entries(value)) {
-      if (typeof val === "number" && CAMPAIGN_BATCH_MONEY_KEYS.has(key)) {
-        out[key] = toCentAmount(val);
-      } else {
-        out[key] = convertBatchMoneyTreeFromYuanInner(val);
-      }
-    }
-    return out;
-  }
-  return value;
-}
-function adgroupListUrl(googleApiUrl, account, startDate, endDate) {
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(startDate, -30));
-  params.set("endDate", toGoogleDate(endDate, 0));
-  return `${googleApiUrl}/adgroupnmanagement/v2/list/${account}?${params}`;
-}
-function requireGoogleApi(config) {
-  if (!config.googleApiUrl) {
-    console.error(
-      "\n\u274C \u672A\u627E\u5230 Google API \u5730\u5740\u3002\n   Google API \u5730\u5740\u4ECE TSO API \u5730\u5740\u81EA\u52A8\u63A8\u5BFC\uFF0C\u4E5F\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF SILUZAN_GOOGLE_API \u8986\u76D6\u3002\n"
-    );
-    process.exit(1);
-  }
-  return config.googleApiUrl;
-}
-
 // src/commands/ad/campaign.ts
 init_auth();
 init_cli_json_snapshot();
@@ -119638,7 +120336,7 @@ function parseOptionalMatchType(raw) {
 `);
   process.exit(1);
 }
-function register20(program2) {
+function register21(program2) {
   const adCmd = program2.command("ad").description(
     "Google \u5E7F\u544A\u7BA1\u7406\uFF08Google API \u5730\u5740\u4ECE TSO API \u81EA\u52A8\u63A8\u5BFC\uFF0C\u53EF\u901A\u8FC7 SILUZAN_GOOGLE_API \u73AF\u5883\u53D8\u91CF\u8986\u76D6\uFF09\n  \u542B\uFF1A\u7CFB\u5217/\u7EC4/\u521B\u610F/\u5173\u952E\u8BCD\u7B49\u5E38\u89C4\u5E7F\u544A\u6295\u653E\u4E0E\u7BA1\u7406\u80FD\u529B"
   );
@@ -121311,7 +122009,7 @@ function attachBaseCliOptions(cmd) {
 function splitKeywordSeeds(raw) {
   return raw.split(",").map((s) => s.trim()).filter(Boolean);
 }
-function register21(program2) {
+function register22(program2) {
   const keywordCmd = program2.command("keyword").description(
     "Google \u5173\u952E\u5B57\u63A8\u8350\uFF08\u53EF\u9009 -a \u8D26\u6237 ID \u6309\u8D26\u6237\u5E01\u79CD\u51FA\u4EF7\uFF1B\u5426\u5219\u5171\u4EAB MCC/USD\uFF1B\u53EF --geo \u9650\u5B9A\u5E02\u573A\uFF09"
   );
@@ -121780,7 +122478,7 @@ async function runRagList(options) {
   ];
   console.log(lines.join("\n"));
 }
-function register22(program2) {
+function register23(program2) {
   const ragCmd = program2.command("rag").description(
     "RAG \u77E5\u8BC6\u5E93\u68C0\u7D22\uFF08\u534F\u52A9\u5E7F\u544A\u6295\u653E\u3001\u62D3\u8BCD\u3001\u8D26\u6237\u8BCA\u65AD\u4E0E\u62A5\u544A\uFF1B\u9ED8\u8BA4 belongToId=account/me \u7684 companyId\uFF09"
   );
@@ -123231,7 +123929,7 @@ async function runAccountBmBind(opts) {
 }
 
 // src/commands/account-manage-register.ts
-function register23(program2) {
+function register24(program2) {
   const accountCmd = program2.command("account").description("\u5E7F\u544A\u8D26\u6237\u7BA1\u7406\uFF1AOAuth \u6DFB\u52A0\u6388\u6743\u3001\u89E3\u9664\u5173\u8054\uFF08\u89E3\u7ED1\uFF09\u3001Google MCC \u7ED1\u5B9A/\u89E3\u7ED1\u3001\u8D26\u53F7\u5206\u4EAB");
   accountCmd.command("list", { hidden: true }).description("\uFF08\u517C\u5BB9\u522B\u540D\uFF09\u540C list-accounts").option(
     "-m, --media <type>",
@@ -125061,7 +125759,7 @@ async function runOpenAccountMeta(opts) {
 }
 
 // src/commands/open-account-register.ts
-function register24(program2) {
+function register25(program2) {
   const openAccountCmd = program2.command("open-account").description("\u5F00\u6237\u7533\u8BF7\uFF08Google / TikTok / Yandex / Bing / Kwai / Meta \u5F00\u6237\u94FE\u63A5\uFF09");
   openAccountCmd.command("meta").description(
     "\u83B7\u53D6 Meta/Facebook \u5B98\u65B9\u5F00\u6237\u94FE\u63A5\uFF08GET MetaAccount/Management/GetOpenAccountLink\uFF0C\u4E0E\u7F51\u9875\u300C\u7533\u8BF7\u5F00\u6237\u300D\u4E00\u81F4\uFF09"
@@ -125285,7 +125983,7 @@ function register24(program2) {
 }
 
 // src/commands/diagnostic.ts
-function register25(program2) {
+function register26(program2) {
   program2.command("diagnostic").description("\u8BCA\u65AD\u5165\u53E3\u8BF4\u660E\uFF1AGoogle \u5E7F\u544A\u8D26\u6237\u8BCA\u65AD\u9875 vs \u7F51\u7AD9\u8BCA\u65AD CLI").action(() => {
     console.log("\n\u8BCA\u65AD\u80FD\u529B\u8BF4\u660E\n");
     console.log("  \u3010Google \u5E7F\u544A\u8D26\u6237\u8BCA\u65AD\u3011");
@@ -129055,12 +129753,12 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
   const accountId = manifest.accountId ?? (typeof overview?.accountId === "string" ? overview.accountId : void 0);
   const kpis = { ...payload.kpis ?? {} };
   if (current) {
-    if (kpis.spend == null) kpis.spend = current.spend;
-    if (kpis.results == null) kpis.results = current.results;
-    if (kpis.costPerResult == null) kpis.costPerResult = current.costPerResult;
-    if (kpis.reach == null) kpis.reach = current.reach;
-    if (kpis.impressions == null) kpis.impressions = current.impressions;
-    if (kpis.frequency == null) kpis.frequency = current.frequency;
+    if (current.spend != null) kpis.spend = current.spend;
+    if (current.results != null) kpis.results = current.results;
+    if (current.costPerResult != null) kpis.costPerResult = current.costPerResult;
+    if (current.reach != null) kpis.reach = current.reach;
+    if (current.impressions != null) kpis.impressions = current.impressions;
+    if (current.frequency != null) kpis.frequency = current.frequency;
   }
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountName && accountName) meta.accountName = accountName;
@@ -129073,12 +129771,12 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
   if (!meta.resultType && current?.resultType) meta.resultType = String(current.resultType);
   const charts = { ...payload.charts ?? {} };
   const avgCpl = num5(kpis.costPerResult) ?? 0;
-  if (!charts.platform) {
+  {
     const platform = sectionMap.get("platform");
     const networks = Array.isArray(platform?.networks) ? platform.networks : [];
     if (networks.length) charts.platform = aggregatePlatform(networks);
   }
-  if (!charts.country) {
+  {
     const country = sectionMap.get("country");
     const countries = Array.isArray(country?.countries) ? country.countries : [];
     if (countries.length) {
@@ -129089,7 +129787,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
       };
     }
   }
-  if (!charts.audience) {
+  {
     const audience = sectionMap.get("audience");
     const audiences = Array.isArray(audience?.audiences) ? audience.audiences : [];
     if (audiences.length) {
@@ -129101,11 +129799,11 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
       };
     }
   }
-  if (!charts.funnel && num5(kpis.reach) != null) {
+  if (num5(kpis.reach) != null) {
     charts.funnel = { reach: kpis.reach, results: kpis.results ?? 0 };
   }
   const tables = { ...payload.tables ?? {} };
-  if (!tables.adSets) {
+  {
     const adSets = sectionMap.get("ad-sets");
     const groups = Array.isArray(adSets?.adGroups) ? adSets.adGroups : [];
     if (groups.length) {
@@ -129128,15 +129826,13 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
       }).sort((a, b) => b.spend - a.spend);
     }
   }
-  if (!tables.audienceTop || !tables.audienceBottom) {
+  {
     const audience = sectionMap.get("audience");
     const audiences = Array.isArray(audience?.audiences) ? audience.audiences : [];
     if (audiences.length) {
       const rows = buildAudienceRows(audiences).sort((a, b) => a.costPerResult - b.costPerResult);
-      const topN = rows.slice(0, 10);
-      const bottomN = [...rows].reverse().slice(0, 10);
-      if (!tables.audienceTop) tables.audienceTop = topN;
-      if (!tables.audienceBottom) tables.audienceBottom = bottomN;
+      tables.audienceTop = rows.slice(0, 10);
+      tables.audienceBottom = [...rows].reverse().slice(0, 10);
     }
   }
   const currency = typeof meta.currency === "string" ? meta.currency : "USD";
@@ -129851,17 +130547,26 @@ async function mergeMetaDiagnosisSnapshotIntoReport(payload, snapshotDir) {
   if (!meta.generatedAt) meta.generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const kpis = { ...payload.kpis ?? {} };
   if (currentPeriod) {
-    if (kpis.spend == null) kpis.spend = num6(currentPeriod.spend);
-    if (kpis.impressions == null) kpis.impressions = num6(currentPeriod.impressions);
-    if (kpis.clicks == null) kpis.clicks = num6(currentPeriod.clicks);
-    if (kpis.results == null) kpis.results = num6(currentPeriod.results);
-    if (kpis.costPerResult == null) kpis.costPerResult = num6(currentPeriod.costPerResult);
-    if (kpis.ctr == null) kpis.ctr = num6(currentPeriod.ctr);
-    if (kpis.cpc == null) kpis.cpc = num6(currentPeriod.cpc ?? currentPeriod.averageCpc);
-    if (kpis.reach == null) kpis.reach = num6(currentPeriod.reach);
-    if (kpis.frequency == null) kpis.frequency = num6(currentPeriod.frequency);
-  }
-  if (!kpis.previousPeriod && previousPeriod) {
+    const spend = num6(currentPeriod.spend);
+    const impressions = num6(currentPeriod.impressions);
+    const clicks = num6(currentPeriod.clicks);
+    const results = num6(currentPeriod.results);
+    const costPerResult = num6(currentPeriod.costPerResult);
+    const ctr = num6(currentPeriod.ctr);
+    const cpc = num6(currentPeriod.cpc ?? currentPeriod.averageCpc);
+    const reach = num6(currentPeriod.reach);
+    const frequency = num6(currentPeriod.frequency);
+    if (spend != null) kpis.spend = spend;
+    if (impressions != null) kpis.impressions = impressions;
+    if (clicks != null) kpis.clicks = clicks;
+    if (results != null) kpis.results = results;
+    if (costPerResult != null) kpis.costPerResult = costPerResult;
+    if (ctr != null) kpis.ctr = ctr;
+    if (cpc != null) kpis.cpc = cpc;
+    if (reach != null) kpis.reach = reach;
+    if (frequency != null) kpis.frequency = frequency;
+  }
+  if (previousPeriod) {
     kpis.previousPeriod = {
       spend: num6(previousPeriod.spend),
       impressions: num6(previousPeriod.impressions),
@@ -129875,7 +130580,7 @@ async function mergeMetaDiagnosisSnapshotIntoReport(payload, snapshotDir) {
     };
   }
   const tables = { ...payload.tables ?? {} };
-  if (!tables.adSets) {
+  {
     const rows = asRows(sectionMap.get("ad-sets")?.adGroups).map(
       (r) => pickMetricExtras(r, [
         "adGroupId",
@@ -129886,38 +130591,38 @@ async function mergeMetaDiagnosisSnapshotIntoReport(payload, snapshotDir) {
     );
     if (rows.length > 0) tables.adSets = rows;
   }
-  if (!tables.platform) {
+  {
     const rows = asRows(sectionMap.get("platform")?.networks).map(
       (r) => pickMetricExtras(r, ["publisherPlatform", "platformPosition", "network"])
     );
     if (rows.length > 0) tables.platform = rows;
   }
-  if (!tables.country) {
+  {
     const rows = asRows(sectionMap.get("country")?.countries).map(
       (r) => pickMetricExtras(r, ["countryOrRegion"])
     );
     if (rows.length > 0) tables.country = rows;
   }
-  if (!tables.audience) {
+  {
     const rows = asRows(sectionMap.get("audience")?.audiences).map(
       (r) => pickMetricExtras(r, ["age", "gender"])
     );
     if (rows.length > 0) tables.audience = rows;
   }
-  if (!tables.creative) {
+  {
     const rows = asRows(sectionMap.get("creative")?.creatives).map(
       (r) => pickMetricExtras(r, ["adId", "adName", "creativeType", "title"])
     );
     if (rows.length > 0) tables.creative = rows;
   }
-  if (!tables.material) {
+  {
     const mat = sectionMap.get("material");
     const rows = asRows(mat?.materials).map(
       (r) => pickMetricExtras(r, ["materialId", "materialName", "materialType"])
     );
     if (rows.length > 0) {
       tables.material = rows;
-      if (tables.materialMeta == null && mat) {
+      if (mat) {
         tables.materialMeta = {
           dataSource: mat.dataSource,
           message: mat.message
@@ -130220,7 +130925,7 @@ function resolveSectionList2(sections, exclude) {
 }
 
 // src/commands/facebook-analysis/run-batch.ts
-async function runWithConcurrency2(tasks, concurrency) {
+async function runWithConcurrency3(tasks, concurrency) {
   const results = new Array(tasks.length);
   let cursor = 0;
   const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
@@ -130284,7 +130989,7 @@ async function runAllFacebookSections(opts) {
       }
     }
   );
-  const results = await runWithConcurrency2(tasks, concurrency);
+  const results = await runWithConcurrency3(tasks, concurrency);
   const succeeded = results.filter((r) => r.ok).length;
   const failed = results.length - succeeded;
   const absoluteSnapshotDir = path35.resolve(opts.jsonOut);
@@ -130796,7 +131501,7 @@ init_auth();
 import * as path36 from "path";
 import { performance as performance6 } from "perf_hooks";
 init_version();
-async function runWithConcurrency3(tasks, concurrency) {
+async function runWithConcurrency4(tasks, concurrency) {
   const results = new Array(tasks.length);
   let cursor = 0;
   const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
@@ -130864,7 +131569,7 @@ async function runAllBingSections(opts) {
       };
     }
   });
-  const results = await runWithConcurrency3(tasks, concurrency);
+  const results = await runWithConcurrency4(tasks, concurrency);
   const succeeded = results.filter((r) => r.ok).length;
   const failed = results.length - succeeded;
   const absoluteSnapshotDir = path36.resolve(opts.jsonOut);
@@ -131128,25 +131833,27 @@ async function mergeBingAnalysisSnapshotIntoReport(payload, snapshotDir) {
     costPerConversion: num8(currentPeriod.costPerConversion)
   } : null);
   if (currentKpiSource) {
-    if (kpis.spend == null) kpis.spend = currentKpiSource.spend;
-    if (kpis.impressions == null) kpis.impressions = currentKpiSource.impressions;
-    if (kpis.clicks == null) kpis.clicks = currentKpiSource.clicks;
-    if (kpis.conversions == null) kpis.conversions = currentKpiSource.conversions;
-    if (kpis.ctr == null) kpis.ctr = currentKpiSource.ctr;
-    if (kpis.averageCpc == null) kpis.averageCpc = currentKpiSource.averageCpc;
-    if (kpis.costPerConversion == null) kpis.costPerConversion = currentKpiSource.costPerConversion;
-  }
-  if (kpis.averageDailyCost == null && overview) {
-    kpis.averageDailyCost = num8(overview.averageDailyCost);
-  }
-  if (kpis.balance == null && overview) kpis.balance = num8(overview.balance);
-  if (kpis.remainingAccountBudget == null && overview) {
-    kpis.remainingAccountBudget = num8(overview.remainingAccountBudget);
-  }
-  if (kpis.optimizationScore == null && overview) {
-    kpis.optimizationScore = num8(overview.optimizationScore);
-  }
-  if (!kpis.previousPeriod && previousPeriod) {
+    if (currentKpiSource.spend != null) kpis.spend = currentKpiSource.spend;
+    if (currentKpiSource.impressions != null) kpis.impressions = currentKpiSource.impressions;
+    if (currentKpiSource.clicks != null) kpis.clicks = currentKpiSource.clicks;
+    if (currentKpiSource.conversions != null) kpis.conversions = currentKpiSource.conversions;
+    if (currentKpiSource.ctr != null) kpis.ctr = currentKpiSource.ctr;
+    if (currentKpiSource.averageCpc != null) kpis.averageCpc = currentKpiSource.averageCpc;
+    if (currentKpiSource.costPerConversion != null) {
+      kpis.costPerConversion = currentKpiSource.costPerConversion;
+    }
+  }
+  if (overview) {
+    const avgDaily = num8(overview.averageDailyCost);
+    if (avgDaily != null) kpis.averageDailyCost = avgDaily;
+    const bal = num8(overview.balance);
+    if (bal != null) kpis.balance = bal;
+    const rem = num8(overview.remainingAccountBudget);
+    if (rem != null) kpis.remainingAccountBudget = rem;
+    const opt = num8(overview.optimizationScore);
+    if (opt != null) kpis.optimizationScore = opt;
+  }
+  if (previousPeriod) {
     kpis.previousPeriod = {
       spend: num8(previousPeriod.spend),
       impressions: num8(previousPeriod.impressions),
@@ -131158,35 +131865,33 @@ async function mergeBingAnalysisSnapshotIntoReport(payload, snapshotDir) {
     };
   }
   const tables = { ...payload.tables ?? {} };
-  if (!tables.devices) {
+  {
     const rows = mapDeviceRows(sectionMap.get("device"));
     if (rows.length > 0) tables.devices = rows;
   }
-  if (!tables.geographic) {
+  {
     const rows = mapGeographicRows(sectionMap.get("geographic"));
     if (rows.length > 0) tables.geographic = rows;
   }
   const audienceMapped = mapAudienceRows(sectionMap.get("audience-merged"));
-  if (!tables.audienceAge && audienceMapped.audienceAge.length > 0) {
-    tables.audienceAge = audienceMapped.audienceAge;
-  }
-  if (!tables.audienceGender && audienceMapped.audienceGender.length > 0) {
+  if (audienceMapped.audienceAge.length > 0) tables.audienceAge = audienceMapped.audienceAge;
+  if (audienceMapped.audienceGender.length > 0) {
     tables.audienceGender = audienceMapped.audienceGender;
   }
-  if (!tables.campaigns && campaignRows2.length > 0) tables.campaigns = campaignRows2;
-  if (!tables.adGroups) {
+  if (campaignRows2.length > 0) tables.campaigns = campaignRows2;
+  {
     const rows = mapAdGroupRows(sectionMap.get("ad-groups"));
     if (rows.length > 0) tables.adGroups = rows;
   }
-  if (!tables.ads) {
+  {
     const rows = mapAdRows(sectionMap.get("ads"));
     if (rows.length > 0) tables.ads = rows;
   }
-  if (!tables.keywords) {
+  {
     const rows = mapKeywordRows(sectionMap.get("keywords"));
     if (rows.length > 0) tables.keywords = rows;
   }
-  if (!tables.searchTerms) {
+  {
     const rows = mapSearchTermRows(sectionMap.get("search-terms"));
     if (rows.length > 0) tables.searchTerms = rows;
   }
@@ -131666,7 +132371,7 @@ init_auth();
 import * as path39 from "path";
 import { performance as performance7 } from "perf_hooks";
 init_version();
-async function runWithConcurrency4(tasks, concurrency) {
+async function runWithConcurrency5(tasks, concurrency) {
   const results = new Array(tasks.length);
   let cursor = 0;
   const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
@@ -131735,7 +132440,7 @@ async function runAllTikTokSections(opts) {
       }
     }
   );
-  const results = await runWithConcurrency4(tasks, concurrency);
+  const results = await runWithConcurrency5(tasks, concurrency);
   const succeeded = results.filter((r) => r.ok).length;
   const failed = results.length - succeeded;
   const absoluteSnapshotDir = path39.resolve(opts.jsonOut);
@@ -131963,15 +132668,17 @@ async function mergeTikTokAnalysisSnapshotIntoReport(payload, snapshotDir) {
     costPerConversion: num9(currentPeriod.costPerConversion)
   } : null);
   if (currentKpiSource) {
-    if (kpis.spend == null) kpis.spend = currentKpiSource.spend;
-    if (kpis.impressions == null) kpis.impressions = currentKpiSource.impressions;
-    if (kpis.clicks == null) kpis.clicks = currentKpiSource.clicks;
-    if (kpis.conversions == null) kpis.conversions = currentKpiSource.conversions;
-    if (kpis.ctr == null) kpis.ctr = currentKpiSource.ctr;
-    if (kpis.averageCpc == null) kpis.averageCpc = currentKpiSource.averageCpc;
-    if (kpis.costPerConversion == null) kpis.costPerConversion = currentKpiSource.costPerConversion;
-  }
-  if (!kpis.previousPeriod && previousPeriod) {
+    if (currentKpiSource.spend != null) kpis.spend = currentKpiSource.spend;
+    if (currentKpiSource.impressions != null) kpis.impressions = currentKpiSource.impressions;
+    if (currentKpiSource.clicks != null) kpis.clicks = currentKpiSource.clicks;
+    if (currentKpiSource.conversions != null) kpis.conversions = currentKpiSource.conversions;
+    if (currentKpiSource.ctr != null) kpis.ctr = currentKpiSource.ctr;
+    if (currentKpiSource.averageCpc != null) kpis.averageCpc = currentKpiSource.averageCpc;
+    if (currentKpiSource.costPerConversion != null) {
+      kpis.costPerConversion = currentKpiSource.costPerConversion;
+    }
+  }
+  if (previousPeriod) {
     kpis.previousPeriod = {
       spend: num9(previousPeriod.spend),
       impressions: num9(previousPeriod.impressions),
@@ -131983,29 +132690,29 @@ async function mergeTikTokAnalysisSnapshotIntoReport(payload, snapshotDir) {
     };
   }
   const tables = { ...payload.tables ?? {} };
-  if (!tables.campaigns && camps.length > 0) tables.campaigns = mapCampaignTable(camps);
-  if (!tables.adGroups) {
+  if (camps.length > 0) tables.campaigns = mapCampaignTable(camps);
+  {
     const rows = mapAdGroupTable(sectionMap.get("ad-groups"));
     if (rows.length > 0) tables.adGroups = rows;
   }
-  if (!tables.ads) {
+  {
     const rows = mapAdTable(sectionMap.get("ads"));
     if (rows.length > 0) tables.ads = rows;
   }
-  if (!tables.videos) {
+  {
     const rows = mapVideoTable(sectionMap.get("videos"));
     if (rows.length > 0) tables.videos = rows;
   }
   const fromMerged = mapAudienceMerged(sectionMap.get("audience-merged"));
-  if (!tables.audienceGender) {
+  {
     const rows = fromMerged.audienceGender.length > 0 ? fromMerged.audienceGender : mapAudienceList(sectionMap.get("audience-gender"), "gender", "gender");
     if (rows.length > 0) tables.audienceGender = rows;
   }
-  if (!tables.audienceAge) {
+  {
     const rows = fromMerged.audienceAge.length > 0 ? fromMerged.audienceAge : mapAudienceList(sectionMap.get("audience-age"), "age", "ageRange");
     if (rows.length > 0) tables.audienceAge = rows;
   }
-  if (!tables.audienceInterest) {
+  {
     const rows = fromMerged.audienceInterest.length > 0 ? fromMerged.audienceInterest : mapAudienceList(
       sectionMap.get("audience-interest-category"),
       "interest_category",
@@ -132332,11 +133039,29 @@ function jsonOutMissingPath(args) {
   }
   return false;
 }
+function adSubcommandHasMediaFlag(args) {
+  if (args[0] !== "ad") return false;
+  const sub = args[1];
+  if (!sub || sub.startsWith("-")) return false;
+  for (let i = 2; i < args.length; i++) {
+    const a = args[i];
+    if (a === "-m" || a === "--media" || a.startsWith("--media=")) return true;
+  }
+  return false;
+}
+function hasDateFromTo(args) {
+  return args.some(
+    (a) => a === "--date-from" || a === "--date-to" || a.startsWith("--date-from=") || a.startsWith("--date-to=")
+  );
+}
 function agentCompatFatalMessage(argv) {
   const args = argv.slice(2);
   if (args.includes("--period") || args.some((a) => a.startsWith("--period="))) {
     return "\n\u274C \u6CA1\u6709 --period \u9009\u9879\u3002\u8BF7\u7528 --start/--end\uFF08\u6216\u517C\u5BB9\u522B\u540D --start-date/--end-date\uFF09\u6307\u5B9A YYYY-MM-DD \u533A\u95F4\u3002\n";
   }
+  if (hasDateFromTo(args)) {
+    return "\n\u274C \u6CA1\u6709 `--date-from` / `--date-to`\u3002\u8BF7\u7528 `--start` / `--end`\uFF08YYYY-MM-DD\uFF09\u3002\n   \u5355\u65E5\u9884\u7B97/\u7A7A\u8017\u7194\u65AD\u8BF7\u7528\uFF1Asiluzan-tso guard budget-circuit|zero-conv -m Google --date <\u5F53\u65E5> --json-out <dir>\n";
+  }
   if (jsonOutMissingPath(args)) {
     return "\n\u274C `--json-out` \u5FC5\u987B\u5E26\u8DEF\u5F84\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\uFF09\uFF0CJSON \u843D\u76D8\u800C\u975E\u6253\u5370\u5230 stdout\uFF0C\u4E0D\u80FD\u7BA1\u9053\u7ED9 python/jq\u3002\n   \u793A\u4F8B\uFF1Asiluzan-tso ad campaigns -a <id> --json-out ./snap\n   \u7136\u540E\u7528 node/python \u8BFB ./snap \u4E0B writtenFiles\uFF08\u89C1 stdout \u6458\u8981\u7684 absoluteSnapshotDir\uFF09\u3002\n";
   }
@@ -132344,6 +133069,12 @@ function agentCompatFatalMessage(argv) {
   if (cmd === "google-ads") {
     return "\n\u274C \u6CA1\u6709 `google-ads` \u547D\u540D\u7A7A\u95F4\u3002\u8BF7\u6539\u7528\uFF1A\n   - \u8D26\u6237\u5206\u6790\u62C9\u6570\uFF1Asiluzan-tso google-analysis \u2026\n   - \u5E7F\u544A\u7CFB\u5217/\u7EC4/\u521B\u610F/\u5173\u952E\u8BCD\uFF1Asiluzan-tso ad campaigns|groups|list|keywords \u2026\n     \uFF08\u6CA1\u6709 campaign-list\uFF1B\u5217\u8868\u547D\u4EE4\u662F campaigns / groups / list / keywords\uFF09\n   - \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF1Asiluzan-tso google-ads-diagnosis \u2026\n";
   }
+  if (cmd === "adgroups" || cmd === "ad" && args[1] === "adgroups") {
+    return "\n\u274C \u6CA1\u6709 `adgroups` \u547D\u4EE4\u3002\u8BF7\u7528\uFF1Asiluzan-tso ad groups -a <mediaCustomerId> --json-out <dir>\n";
+  }
+  if (adSubcommandHasMediaFlag(args)) {
+    return "\n\u274C `ad \u2026` \u5B50\u547D\u4EE4\u6CA1\u6709 `-m/--media`\uFF0C\u8D26\u6237\u7528 `-a/--account <mediaCustomerId>`\u3002\n   \u5355\u6237\uFF1Asiluzan-tso ad campaigns -a <id> --start <\u65E5> --end <\u65E5> --json-out ./snap\n   \u5168\u6237\u5F53\u65E5\u8D85\u9884\u7B97/\u7A7A\u8017\u7194\u65AD\uFF1Asiluzan-tso guard budget-circuit|zero-conv -m Google --json-out ./snap\n";
+  }
   if (cmd === "list" && (args.length === 1 || args[1]?.startsWith("-"))) {
     return "\n\u274C \u6CA1\u6709\u9876\u5C42 `list` \u547D\u4EE4\u3002\u67E5\u8BE2\u5E7F\u544A\u8D26\u6237\u5217\u8868\u8BF7\u7528\uFF1A\n   siluzan-tso list-accounts [-m Google] [-k <id\u6216\u5173\u952E\u5B57>] --json-out <dir>\n";
   }
@@ -132415,12 +133146,12 @@ var REGISTRARS = [
   register11,
   register12,
   register13,
+  register14,
   registerGoogleAnalysisCommands,
   registerGoogleAnalysisBatchCommands,
   registerFacebookAnalysisCommands,
   registerBingAnalysisCommands,
   registerTikTokAnalysisCommands,
-  register14,
   register15,
   register16,
   register17,
@@ -132432,6 +133163,7 @@ var REGISTRARS = [
   register23,
   register24,
   register25,
+  register26,
   registerWebsiteDiagnosisCommands,
   registerMarketAnalysisCommands,
   registerGoogleAdsDiagnosisCommands