siluzan-tso-cli 1.1.30-beta.6 → 1.1.30-beta.8

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.30-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.30-beta.8），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -4170,11 +4170,27 @@ function defaultDateRange() {
   start.setDate(start.getDate() - 6);
   return { startDate: fmt(start), endDate: fmt(end) };
 }
+function resolveAccountOverviewMediaRoute(cliMedia, accountMediaAccountType) {
+  if (cliMedia === "MetaAd" && accountMediaAccountType === "FacebookAds") {
+    return "FacebookAds";
+  }
+  return cliMedia;
+}
+function groupAccountIdsByOverviewRoute(cliMedia, accountIds, accountMediaTypes) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const id of accountIds) {
+    const route = resolveAccountOverviewMediaRoute(cliMedia, accountMediaTypes?.get(id));
+    const list = groups.get(route) ?? [];
+    list.push(id);
+    groups.set(route, list);
+  }
+  return groups;
+}
 async function fetchBalanceMap(media, accountIds, config, startDate, endDate, verbose) {
   const result = /* @__PURE__ */ new Map();
-  if (accountIds.length === 0 || media === "MetaAd") return result;
+  if (accountIds.length === 0) return result;
   try {
-    if (["Google", "Yandex", "TikTok", "BingV2"].includes(media)) {
+    if (["Google", "Yandex", "TikTok", "BingV2", "MetaAd"].includes(media)) {
       const params = new URLSearchParams({ ids: accountIds.join("|") });
       const url = `${config.apiBaseUrl}/query/media-account/${media}/GetMediaAccountInfo?${params}`;
       const raw = await apiFetch2(
@@ -4284,39 +4300,87 @@ function parseGoogleAccountSpendOverviewRows(raw) {
   const items = Array.isArray(r.items) ? r.items : [];
   return items.map(fromDbItem).filter((row) => row !== null);
 }
-async function fetchOverviewMap(media, accountIds, config, startDate, endDate, verbose) {
+async function fetchOverviewMap(route, accountIds, config, startDate, endDate, verbose) {
   const result = /* @__PURE__ */ new Map();
-  if (accountIds.length === 0 || media === "MetaAd") return result;
+  if (accountIds.length === 0) return result;
   const range = defaultDateRange();
   const start = startDate ?? range.startDate;
   const end = endDate ?? range.endDate;
   try {
-    if (media === "Google") {
-      const params2 = new URLSearchParams({
+    if (route === "Google") {
+      const params = new URLSearchParams({
         startDate: start,
         endDate: end,
         mediaCustomerIds: accountIds.join("|")
       });
-      const url2 = `${config.apiBaseUrl}/report/media-account/google/account-spend-overview?${params2}`;
-      const raw2 = await apiFetch2(url2, config, {}, verbose);
-      const rows = parseGoogleAccountSpendOverviewRows(raw2);
+      const url = `${config.apiBaseUrl}/report/media-account/google/account-spend-overview?${params}`;
+      const raw = await apiFetch2(url, config, {}, verbose);
+      const rows = parseGoogleAccountSpendOverviewRows(raw);
       for (const row of rows) {
         result.set(row.mediaAccountId, row);
       }
       return result;
     }
-    const params = new URLSearchParams({
-      period: "true",
-      startDate: start,
-      endDate: end,
-      mediaCustomerIds: accountIds.join(",")
-    });
-    const url = `${config.apiBaseUrl}/report/media-account/${media}/accountsoverview?${params}`;
-    const raw = await apiFetch2(url, config, {}, verbose);
-    const items = Array.isArray(raw) ? raw : [];
-    for (const item of items) {
-      if (item.mediaAccountId != null) {
-        result.set(String(item.mediaAccountId), item);
+    const fetchLegacyBatch = async (ids) => {
+      const batch = /* @__PURE__ */ new Map();
+      const params = new URLSearchParams({
+        period: "true",
+        startDate: start,
+        endDate: end,
+        mediaCustomerIds: ids.join(",")
+      });
+      const url = `${config.apiBaseUrl}/report/media-account/${route}/accountsoverview?${params}`;
+      const raw = await apiFetch2(url, config, {}, verbose);
+      const items = Array.isArray(raw) ? raw : [];
+      for (const item of items) {
+        if (item.mediaAccountId != null) {
+          batch.set(String(item.mediaAccountId), item);
+        }
+      }
+      return batch;
+    };
+    const mergeOverview = (batch) => {
+      for (const [k, v] of batch) result.set(k, v);
+    };
+    if (accountIds.length === 1) {
+      mergeOverview(await fetchLegacyBatch(accountIds));
+      return result;
+    }
+    try {
+      const batch = await fetchLegacyBatch(accountIds);
+      mergeOverview(batch);
+      if (batch.size === 0) {
+        for (const id of accountIds) {
+          try {
+            mergeOverview(await fetchLegacyBatch([id]));
+          } catch (singleErr) {
+            if (verbose) {
+              process.stderr.write(
+                `[fetchOverviewMap] \u9010\u6237\u91CD\u8BD5\u5931\u8D25 ${id}\uFF1A${singleErr instanceof Error ? singleErr.message : String(singleErr)}
+`
+              );
+            }
+          }
+        }
+      }
+    } catch (err) {
+      if (verbose) {
+        process.stderr.write(
+          `[fetchOverviewMap] \u6279\u91CF\u5F02\u5E38\uFF0C\u9010\u6237\u91CD\u8BD5\uFF1A${err instanceof Error ? err.message : String(err)}
+`
+        );
+      }
+      for (const id of accountIds) {
+        try {
+          mergeOverview(await fetchLegacyBatch([id]));
+        } catch (singleErr) {
+          if (verbose) {
+            process.stderr.write(
+              `[fetchOverviewMap] \u9010\u6237\u91CD\u8BD5\u5931\u8D25 ${id}\uFF1A${singleErr instanceof Error ? singleErr.message : String(singleErr)}
+`
+            );
+          }
+        }
       }
     }
   } catch (err) {
@@ -4339,7 +4403,8 @@ var init_balance = __esm({
       "Yandex",
       "TikTok",
       "BingV2",
-      "Kwai"
+      "Kwai",
+      "MetaAd"
     ];
   }
 });
@@ -4373,16 +4438,25 @@ async function fetchBalanceAndOverviewSequential(opts) {
     const ids = chunks[chunkIdx];
     const oneBased = chunkIdx + 1;
     opts.onChunkStart?.(oneBased, chunks.length, ids);
-    const overviewChunk = await fetchOverviewMap(
+    const routeGroups = groupAccountIdsByOverviewRoute(
       media,
       ids,
-      config,
-      startDate,
-      endDate,
-      verbose
+      opts.accountMediaTypes
     );
-    opts.onOverviewDone?.(oneBased, chunks.length, ids, overviewChunk.size);
-    for (const [k, v] of overviewChunk) overviewMap.set(k, v);
+    let chunkOverviewSize = 0;
+    for (const [route, routeIds] of routeGroups) {
+      const overviewChunk = await fetchOverviewMap(
+        route,
+        routeIds,
+        config,
+        startDate,
+        endDate,
+        verbose
+      );
+      chunkOverviewSize += overviewChunk.size;
+      for (const [k, v] of overviewChunk) overviewMap.set(k, v);
+    }
+    opts.onOverviewDone?.(oneBased, chunks.length, ids, chunkOverviewSize);
     const balanceChunk = await fetchBalanceMap(
       media,
       ids,
@@ -4403,6 +4477,143 @@ var init_media_account_batch = __esm({
   }
 });
 
+// src/utils/media-account-lookup.ts
+function pickMediaCustomerName(items, mediaCustomerId) {
+  const list = Array.isArray(items) ? items : [];
+  const target = mediaCustomerId.trim();
+  for (const item of list) {
+    const cid = String(item.ma?.mediaCustomerId ?? "");
+    if (cid === target) {
+      const name2 = String(item.ma?.mediaCustomerName ?? "").trim();
+      return name2 || null;
+    }
+  }
+  return null;
+}
+function metaAccountIdDigits(raw) {
+  const t = raw.trim();
+  if (t.startsWith("act_")) return t.slice(4);
+  return t;
+}
+function idsMatch(a, b) {
+  return metaAccountIdDigits(a) === metaAccountIdDigits(b);
+}
+async function lookupFromMediaAccountQuery(apiBaseUrl, config, mediaType, mediaCustomerId, verbose) {
+  const params = new URLSearchParams({
+    MediaType: mediaType,
+    mediaAccountState: "Approved,Linked",
+    pageNo: "1",
+    pageSize: "20",
+    mediaCustomerId: mediaCustomerId.trim()
+  });
+  const data = await apiFetch2(
+    `${apiBaseUrl}/query/media-account/?${params}`,
+    config,
+    {},
+    verbose
+  );
+  return pickMediaCustomerName(data, mediaCustomerId);
+}
+async function lookupMediaCustomerName(apiBaseUrl, config, mediaType, mediaCustomerId, verbose = false) {
+  const id = mediaCustomerId.trim();
+  if (!id) return null;
+  if (mediaType === "Google" || mediaType === "Yandex") {
+    return lookupFromMediaAccountQuery(apiBaseUrl, config, mediaType, id, verbose);
+  }
+  return null;
+}
+async function lookupMetaMediaAccountTypes(config, accountIds, verbose = false) {
+  const result = /* @__PURE__ */ new Map();
+  const pending = new Set(accountIds.map((id) => id.trim()).filter(Boolean));
+  if (pending.size === 0) return result;
+  const CHUNK = 50;
+  const ids = [...pending];
+  for (let i = 0; i < ids.length; i += CHUNK) {
+    const chunk = ids.slice(i, i + CHUNK);
+    const params = new URLSearchParams({
+      MediaTypes: "MetaAd|FacebookAds",
+      advStatus: "",
+      mediaAccountState: "Approved,Linked",
+      isForce: "false",
+      pageNum: "1",
+      pageSize: String(Math.max(20, chunk.length)),
+      mediaCustomerIds: chunk.join(",")
+    });
+    try {
+      const data = await apiFetch2(
+        `${config.apiBaseUrl}/query/media-account/SearchMediaAcountByCriteria?${params}`,
+        config,
+        {},
+        verbose
+      );
+      for (const item of data?.mas ?? []) {
+        const ma = item.ma ?? {};
+        const cid = String(ma.mediaCustomerId ?? "");
+        const typ = String(ma.mediaAccountType ?? "").trim();
+        if (!cid || !typ) continue;
+        for (const inputId of chunk) {
+          if (idsMatch(inputId, cid)) {
+            result.set(inputId, typ);
+            pending.delete(inputId);
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  for (const inputId of [...pending]) {
+    for (const idCandidate of [inputId, `act_${metaAccountIdDigits(inputId)}`]) {
+      const params = new URLSearchParams({
+        MediaTypes: "MetaAd|FacebookAds",
+        advStatus: "",
+        mediaAccountState: "Approved,Linked",
+        isForce: "false",
+        pageNum: "1",
+        pageSize: "20",
+        mediaCustomerIds: idCandidate
+      });
+      try {
+        const data = await apiFetch2(
+          `${config.apiBaseUrl}/query/media-account/SearchMediaAcountByCriteria?${params}`,
+          config,
+          {},
+          verbose
+        );
+        for (const item of data?.mas ?? []) {
+          const ma = item.ma ?? {};
+          const cid = String(ma.mediaCustomerId ?? "");
+          if (idsMatch(inputId, cid)) {
+            result.set(inputId, String(ma.mediaAccountType ?? "FacebookAds"));
+            pending.delete(inputId);
+            break;
+          }
+        }
+      } catch {
+      }
+      if (!pending.has(inputId)) break;
+    }
+    if (!result.has(inputId)) {
+      result.set(inputId, "FacebookAds");
+    }
+  }
+  return result;
+}
+function buildAccountMediaTypesMap(items) {
+  const map = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const id = item.ma?.mediaCustomerId;
+    const typ = item.ma?.mediaAccountType;
+    if (id && typ) map.set(String(id), String(typ));
+  }
+  return map;
+}
+var init_media_account_lookup = __esm({
+  "src/utils/media-account-lookup.ts"() {
+    "use strict";
+    init_auth();
+  }
+});
+
 // src/commands/accounts-digest/list-fetch.ts
 async function fetchAccountsByMedia(media, config, opts) {
   const cfg = DIGEST_PLATFORM_CONFIG[media];
@@ -4491,6 +4702,17 @@ var init_list_fetch = __esm({
           isForce: false
         },
         responseType: "mas"
+      },
+      MetaAd: {
+        path: "/query/media-account/SearchMediaAcountByCriteria",
+        pageParam: "pageNum",
+        fixedParams: {
+          MediaTypes: "MetaAd|FacebookAds",
+          advStatus: "",
+          mediaAccountState: "Approved,Linked",
+          isForce: false
+        },
+        responseType: "mas"
       }
     };
   }
@@ -4509,7 +4731,7 @@ async function runAccountsDigest(opts) {
     console.error(
       `
 \u274C accounts-digest \u6682\u4E0D\u652F\u6301\u5A92\u4F53\uFF1A${opts.media}
-   \u53EF\u9009\uFF1A${BALANCE_SUPPORTED_MEDIA.join(" | ")}\uFF08MetaAd \u65E0\u4F59\u989D/\u6D88\u8017\u6C47\u603B\u63A5\u53E3\uFF09
+   \u53EF\u9009\uFF1A${BALANCE_SUPPORTED_MEDIA.join(" | ")}
 `
     );
     process.exit(1);
@@ -4523,12 +4745,16 @@ async function runAccountsDigest(opts) {
   let accountsList;
   let scannedFromList = false;
   if (filterSet.size > 0) {
+    let mediaTypes = /* @__PURE__ */ new Map();
+    if (media === "MetaAd") {
+      mediaTypes = await lookupMetaMediaAccountTypes(config, filterIds, opts.verbose);
+    }
     accountsList = filterIds.map((id) => ({
       ma: {
         entityId: "",
         mediaCustomerId: id,
         mediaCustomerName: null,
-        mediaAccountType: media,
+        mediaAccountType: mediaTypes.get(id) ?? media,
         invalidOAuthToken: false
       },
       accepted: true,
@@ -4566,6 +4792,7 @@ async function runAccountsDigest(opts) {
       startDate: opts.startDate,
       endDate: opts.endDate,
       verbose: opts.verbose,
+      accountMediaTypes: buildAccountMediaTypesMap(accountsList),
       onChunkStart: (chunkIdx, totalChunks, ids) => {
         process.stderr.write(
           `   \u2192 [\u6D88\u8017] \u7B2C ${chunkIdx}/${totalChunks} \u6279\uFF08${ids.length} \u6237\uFF09\u2026
@@ -4725,6 +4952,7 @@ var init_run = __esm({
     init_cli_table();
     init_currency_display();
     init_media_account_batch();
+    init_media_account_lookup();
     init_list_fetch();
   }
 });
@@ -4735,7 +4963,7 @@ function register10(program2) {
     "\u591A\u8D26\u6237\u6295\u653E\u753B\u50CF\uFF1A\u4E00\u6761\u547D\u4EE4\u62FF\u9F50\u6D88\u8017/\u70B9\u51FB/\u8F6C\u5316/\u4F59\u989D/\u6D3E\u751F\u6307\u6807\uFF08CTR/CPC/CPA\uFF09\uFF0C\u66FF\u4EE3 AI \u9010\u8D26\u6237 `list-accounts` + `stats` \u7684\u7F16\u6392\u3002\u5178\u578B\u573A\u666F\uFF1A\u300C\u8FD9 10 \u4E2A\u8D26\u6237\uFF08\u6216\u67D0\u5A92\u4F53\u5168\u90E8\u8D26\u6237\uFF09\u5E2E\u6211\u6574\u7406\u4E00\u4E0B\u300D\u3002"
   ).requiredOption(
     "-m, --media <type>",
-    "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | BingV2 | Kwai\uFF08MetaAd \u65E0\u6D88\u8017\u6C47\u603B\u63A5\u53E3\uFF09"
+    "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | MetaAd | BingV2 | Kwai"
   ).option(
     "-a, --accounts <ids>",
     "\u6307\u5B9A\u8D26\u6237 mediaCustomerId\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u7559\u7A7A\u5219\u626B\u63CF\u8BE5\u5A92\u4F53\u4E0B\u5168\u90E8\u8D26\u6237"
@@ -105320,6 +105548,7 @@ init_balance();
 init_cli_table();
 init_currency_display();
 init_media_account_batch();
+init_media_account_lookup();
 
 // src/commands/balance-scan/list-fetch.ts
 init_auth();
@@ -105369,6 +105598,17 @@ var SCAN_PLATFORM_CONFIG = {
       isForce: false
     },
     responseType: "mas"
+  },
+  MetaAd: {
+    path: "/query/media-account/SearchMediaAcountByCriteria",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaTypes: "MetaAd|FacebookAds",
+      advStatus: "",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
   }
 };
 async function fetchOnePage(media, page, pageSize, config, verbose) {
@@ -105472,7 +105712,7 @@ async function runBalanceScan(opts) {
     console.error(
       `
 \u274C balance scan \u6682\u4E0D\u652F\u6301\u5A92\u4F53\uFF1A${opts.media}
-   \u53EF\u9009\uFF1A${BALANCE_SUPPORTED_MEDIA.join(" | ")}\uFF08MetaAd \u63A5\u53E3\u672A\u5F00\u653E\u4F59\u989D\u67E5\u8BE2\uFF09
+   \u53EF\u9009\uFF1A${BALANCE_SUPPORTED_MEDIA.join(" | ")}
 `
     );
     process.exit(1);
@@ -105489,12 +105729,16 @@ async function runBalanceScan(opts) {
   let allItems;
   let total;
   if (isSubset) {
+    let mediaTypes = /* @__PURE__ */ new Map();
+    if (media === "MetaAd") {
+      mediaTypes = await lookupMetaMediaAccountTypes(config, filterIds, opts.verbose);
+    }
     allItems = filterIds.map((id) => ({
       ma: {
         entityId: "",
         mediaCustomerId: id,
         mediaCustomerName: null,
-        mediaAccountType: media,
+        mediaAccountType: mediaTypes.get(id) ?? media,
         invalidOAuthToken: false
       },
       accepted: true,
@@ -105532,6 +105776,7 @@ async function runBalanceScan(opts) {
       accountIds: validIds,
       config,
       verbose: opts.verbose,
+      accountMediaTypes: buildAccountMediaTypesMap(allItems),
       onChunkStart: (chunkIdx, totalChunks, ids) => {
         process.stderr.write(
           `   \u2192 [\u8FD17\u65E5\u6D88\u8017] \u7B2C ${chunkIdx}/${totalChunks} \u6279\u8BF7\u6C42\u4E2D\uFF08${ids.length} \u6237\uFF09\u2026
@@ -105691,7 +105936,7 @@ function register9(program2) {
     "\u4E00\u952E\u626B\u63CF\u67D0\u5A92\u4F53\u4E0B\u6240\u6709\u8D26\u6237\u7684\u4F59\u989D\uFF0C\u7B5B\u51FA\u7EED\u822A\u5929\u6570\u4E0D\u8DB3\u7684\u8D26\u6237\u3002\u66FF\u4EE3\u5FAA\u73AF\u8C03\u7528 balance \u7684\u4F20\u7EDF\u505A\u6CD5\uFF0C\u5178\u578B\u573A\u666F\uFF1A\u300C\u5E2E\u6211\u627E\u51FA 117 \u4E2A Bing \u8D26\u6237\u91CC\u4F59\u989D\u4E0D\u8DB3 7 \u5929\u7684\u300D\u3002"
   ).requiredOption(
     "-m, --media <type>",
-    "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | BingV2 | Kwai\uFF08MetaAd \u63A5\u53E3\u672A\u5F00\u653E\u4F59\u989D\u67E5\u8BE2\uFF09"
+    "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | MetaAd | BingV2 | Kwai"
   ).option(
     "-a, --accounts <ids>",
     "\u6307\u5B9A mediaCustomerId\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF1B\u8DF3\u8FC7\u6E05\u5355\u7FFB\u9875\uFF0C\u62C9\u53D6\u540E\u5168\u90E8\u8F93\u51FA\uFF08\u4E0D\u6309\u9608\u503C\u8FC7\u6EE4\uFF09"
@@ -105743,6 +105988,7 @@ init_auth();
 init_cli_json_snapshot();
 init_cli_table();
 init_balance();
+init_media_account_lookup();
 var VALID_MEDIA_TYPES3 = ["Google", "TikTok", "Yandex", "MetaAd", "BingV2", "Kwai"];
 function defaultDateRange2() {
   const end = /* @__PURE__ */ new Date();
@@ -105780,15 +106026,12 @@ async function runStats(opts) {
   }
   const ids = opts.accounts.split(",").map((id) => id.trim()).filter(Boolean);
   const isGoogle = opts.media === "Google";
-  const params = isGoogle ? new URLSearchParams({ startDate, endDate, mediaCustomerIds: ids.join("|") }) : (() => {
-    const p = new URLSearchParams({ startDate, endDate, period: "true" });
-    p.set("mediaCustomerIds", ids.join(","));
-    return p;
-  })();
-  const url = isGoogle ? `${config.apiBaseUrl}/report/media-account/google/account-spend-overview?${params.toString()}` : `${config.apiBaseUrl}/report/media-account/${opts.media}/accountsoverview?${params.toString()}`;
+  const isMetaAd = opts.media === "MetaAd";
   let items;
   try {
     if (isGoogle) {
+      const params = new URLSearchParams({ startDate, endDate, mediaCustomerIds: ids.join("|") });
+      const url = `${config.apiBaseUrl}/report/media-account/google/account-spend-overview?${params.toString()}`;
       const raw = await apiFetch2(url, config, {}, opts.verbose);
       items = parseGoogleAccountSpendOverviewRows(raw).map((row) => ({
         mediaAccountId: row.mediaAccountId,
@@ -105802,7 +106045,30 @@ async function runStats(opts) {
         remainingAccountBudget: row.remainingAccountBudget,
         status: row.status
       }));
+    } else if (isMetaAd) {
+      const accountMediaTypes = await lookupMetaMediaAccountTypes(config, ids, opts.verbose);
+      items = [];
+      for (const [route, routeIds] of groupAccountIdsByOverviewRoute(
+        "MetaAd",
+        ids,
+        accountMediaTypes
+      )) {
+        const map = await fetchOverviewMap(
+          route,
+          routeIds,
+          config,
+          startDate,
+          endDate,
+          opts.verbose
+        );
+        for (const item of map.values()) {
+          items.push(item);
+        }
+      }
     } else {
+      const params = new URLSearchParams({ startDate, endDate, period: "true" });
+      params.set("mediaCustomerIds", ids.join(","));
+      const url = `${config.apiBaseUrl}/report/media-account/${opts.media}/accountsoverview?${params.toString()}`;
       const raw = await apiFetch2(url, config, {}, opts.verbose);
       items = Array.isArray(raw) ? raw : raw.items ?? [];
     }
@@ -111664,46 +111930,8 @@ function tryLoadCampaignCreateConfig(configFile) {
   return stripMetaKeys(raw);
 }
 
-// src/utils/media-account-lookup.ts
-init_auth();
-function pickMediaCustomerName(items, mediaCustomerId) {
-  const list = Array.isArray(items) ? items : [];
-  const target = mediaCustomerId.trim();
-  for (const item of list) {
-    const cid = String(item.ma?.mediaCustomerId ?? "");
-    if (cid === target) {
-      const name2 = String(item.ma?.mediaCustomerName ?? "").trim();
-      return name2 || null;
-    }
-  }
-  return null;
-}
-async function lookupFromMediaAccountQuery(apiBaseUrl, config, mediaType, mediaCustomerId, verbose) {
-  const params = new URLSearchParams({
-    MediaType: mediaType,
-    mediaAccountState: "Approved,Linked",
-    pageNo: "1",
-    pageSize: "20",
-    mediaCustomerId: mediaCustomerId.trim()
-  });
-  const data = await apiFetch2(
-    `${apiBaseUrl}/query/media-account/?${params}`,
-    config,
-    {},
-    verbose
-  );
-  return pickMediaCustomerName(data, mediaCustomerId);
-}
-async function lookupMediaCustomerName(apiBaseUrl, config, mediaType, mediaCustomerId, verbose = false) {
-  const id = mediaCustomerId.trim();
-  if (!id) return null;
-  if (mediaType === "Google" || mediaType === "Yandex") {
-    return lookupFromMediaAccountQuery(apiBaseUrl, config, mediaType, id, verbose);
-  }
-  return null;
-}
-
 // src/commands/ad/campaign-customer-name.ts
+init_media_account_lookup();
 var CampaignCustomerNameResolveError = class extends Error {
   constructor(accountId) {
     super(
@@ -113932,6 +114160,7 @@ async function runAdGeoSetBid(opts) {
 
 // src/commands/ad/ai-creation.ts
 init_auth();
+init_media_account_lookup();
 init_cli_json_snapshot();
 init_cli_table();
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.30-beta.6",
-  "publishedAt": 1782372193290
+  "version": "1.1.30-beta.8",
+  "publishedAt": 1782442092875
 }

package/dist/skill/references/accounts/accounts.md

@@ -31,6 +31,10 @@ siluzan-tso list-accounts [选项]
 | 列出全部某媒体账户 | `list-accounts -m <媒体> --page-size 999 --json-out <dir>` | `items[]`（`ma.mediaCustomerId`、`ma.mediaCustomerName`、`ma.currencyCode`、`ma.mediaAccountState` 等） |
 | 有多少个账户       | 同上                                                       | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大）                                    |
 | 只查某一个户       | `list-accounts -m <媒体> -k <id或名称> --json-out <dir>`   | 无需大 page-size                                                                                        |
+| **Meta 全部账户 + 余额/消耗** | **`accounts-digest -m MetaAd --json-out <dir>`**（一步；内部翻页+分批） | `accounts-digest-metaad.json` → `data.items[]`（含 `balance`、`spend`） |
+| Meta 余额续航预警  | `balance-scan -m MetaAd --json-out <dir>`                  | `balance-scan-metaad.json`                                                                              |
+
+> **MetaAd ID 格式**：OAuth 授权户（`list-accounts` 里 `mediaAccountType=FacebookAds`）的 `mediaCustomerId` **须带 `act_` 前缀**（与列表返回值一致）。**禁止**把 70+ 个 ID 拼成一条 `balance -a …`；全量用 `accounts-digest`。
 
 仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环（stdout 摘要无 `total` / `items`，读盘协议见 `references/core/agent-conventions.md` §三）。列账户 / 数个数**不需要** `accounts-digest`、`balance-scan`。
 
@@ -116,7 +120,7 @@ siluzan-tso account-active-bills -m Google --id 18176820-6204-43c2-9a1f-0d0f5e9e
 siluzan-tso account-active-bills -m Google --id 18176820-6204-43c2-9a1f-0d0f5e9eb957 --json-out ./snap
 ```
 
-> **勿在文档或聊天中粘贴真实 JWT。** CI 环境基址为 `https://tso-api-ci.siluzan.com`，生产为 `https://tso-api.siluzan.com`（由 `config` / 构建环境决定）。
+> **勿在文档或聊天中粘贴真实 JWT。
 
 ---
 
@@ -128,7 +132,7 @@ siluzan-tso balance -m <媒体类型> -a <账户ID列表>
 
 | 选项                   | 说明                                                                                 |
 | ---------------------- | ------------------------------------------------------------------------------------ |
-| `-m, --media <type>`   | 媒体类型（必填）                                                                     |
+| `-m, --media <type>`   | 媒体类型（必填）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`（MetaAd 走 `GetMediaAccountInfo`，余额字段为 `spend_cap`） |
 | `-a, --accounts <ids>` | 账户 `mediaCustomerId`（数字 ID），多个用逗号分隔（必填）。**注意：不是 `entityId`** |
 | `--json-out`           | 输出原始 JSON；不支持或查询失败时 stdout 为 `{"ok":false,"error":"..."}`             |
 
@@ -141,6 +145,9 @@ siluzan-tso balance -m Google -a 6326027735
 # 查询多个 TikTok 账户余额
 siluzan-tso balance -m TikTok -a 1234567890,9876543210
 
+# 查询 Meta 广告账户余额
+siluzan-tso balance -m MetaAd -a <mediaCustomerId>
+
 # JSON 输出，供脚本使用
 siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 ```
@@ -153,7 +160,7 @@ siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 
 一条命令替代 AI 对每个账户循环 `list-accounts -k` + `stats`。**多账户汇总表、对比消耗、跨账户巡检** 应优先本命令，禁止外层 for-loop 逐户 `stats`。
 
-> **数据时效性**：与 `stats` / `balance-scan` 相同（Google `account-spend-overview` 分流；TikTok/Yandex/BingV2/Kwai 为截至昨天的 `accountsoverview`）。完整表见 `references/analytics/account-analytics.md` 顶部。
+> **数据时效性**：与 `stats` / `balance-scan` 相同（Google `account-spend-overview` 分流；TikTok/Yandex/BingV2/Kwai/**MetaAd** 为截至昨天的 `accountsoverview`）。完整表见 `references/analytics/account-analytics.md` 顶部。
 
 ```bash
 siluzan-tso accounts-digest -m <媒体类型> [选项]
@@ -161,7 +168,7 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
 
 | 选项                   | 说明                                                                                                          | 默认    |
 | ---------------------- | ------------------------------------------------------------------------------------------------------------- | ------- |
-| `-m, --media <type>`   | 媒体类型（必填）：`Google \| TikTok \| Yandex \| BingV2 \| Kwai`（**MetaAd 无消耗汇总接口**）                 | —       |
+| `-m, --media <type>`   | 媒体类型（必填）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`                 | —       |
 | `-a, --accounts <ids>` | 指定 `mediaCustomerId`，逗号分隔；**留空**则翻页拉该媒体全部账户                                              | —       |
 | `--start <YYYY-MM-DD>` | 统计开始日期（SKILL 要求 AI 先与用户确认区间）                                                                | 近 7 天 |
 | `--end <YYYY-MM-DD>`   | 统计结束日期                                                                                                  | 昨天    |

package/dist/skill/references/analytics/account-analytics.md

@@ -14,7 +14,7 @@
 | `google-analysis --sections campaign-types`（`types-summary`）                                                                                              | **实时**                                                                                                                                                            | ✅ 可查当天                       | 当天系列类型分布                                       |
 | `google-analysis` 其他维度（`campaigns` / `keywords` / `devices` / ...）                                                                                    | 实时（受 Google Ads API 同步延迟影响）                                                                                                                              | 可查当天，但当天可能尚未结算      | 周期分析、报告                                         |
 | `stats -m Google` / `balance-scan -m Google` / `accounts-digest -m Google` / `list-accounts -m Google` 合并消耗（TSO `account-spend-overview`，2026-05 起） | **后端自动分流**：窗口完全在历史 → `database` 模式（含余额/状态/币种/账户名 + 当期消耗）；窗口含今天 → `googleCombined` 模式（仅实时消耗，无余额/状态/币种/账户名） | ✅ 可查当天（含今天时切实时聚合） | 历史回溯、巡检、余额续航估算；含今天时也能给出实时消耗 |
-| `stats` / `balance-scan` / `accounts-digest` / `list-accounts` 的 **TikTok / Yandex / BingV2 / Kwai** 合并消耗（TSO `accountsoverview`）                    | **每日同步昨天**                                                                                                                                                    | ❌ 查今天会全为 0                 | 历史回溯、巡检、余额续航估算（口径为"截至昨天"）       |
+| `stats` / `balance-scan` / `accounts-digest` / `list-accounts` 的 **TikTok / Yandex / BingV2 / Kwai / MetaAd** 合并消耗（TSO `accountsoverview`；MetaAd OAuth 户走 `FacebookAds` 段） | **每日同步昨天**                                                                                                                                                    | ❌ 查今天会全为 0                 | 历史回溯、巡检、余额续航估算（口径为"截至昨天"）       |
 | `balance`（`GetMediaAccountInfo`）                                                                                                                          | 实时                                                                                                                                                                | —                                 | 仅当前余额，不反映消耗                                 |
 
 **选用规则**：
@@ -22,7 +22,7 @@
 - 「今天/当天/今日消耗」「实时消耗排行」 → 优先 `google-analysis(-batch) --sections overview`，`--start` / `--end` 都设为今天；
   - Google 单账户/批量取数也可直接 `stats -m Google` 把 `--end-date` 设为今天，后端会切到 `googleCombined` 模式给实时消耗（但**不会**返回余额/币种/账户名）。
 - 「最近 N 天消耗 / 周报 / 月报 / 余额续航」 → `stats` / `balance-scan` / `accounts-digest`，默认窗口截至昨天即可（Google 此时走 `database`，包含完整字段）。
-- **禁止**用 TikTok / Yandex / BingV2 / Kwai 的 `accountsoverview` 接口判断当天消耗（仍是每日同步）。
+- **禁止**用 TikTok / Yandex / BingV2 / Kwai / MetaAd 的 `accountsoverview` 接口判断当天消耗（仍是每日同步）。
 - **禁止**给非 Google 媒体的当天高消耗场景加 `--min-spend`：其预筛选来自非实时 `accountsoverview`，会把今天有消耗的账号当成 0 给筛掉。Google 媒体当 `--end-date` 设为今天时，预筛选走的是 `googleCombined` 实时数据，可以使用 `--min-spend`。
 
 ---

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.30-beta.6'
+$PKG_VERSION = '1.1.30-beta.8'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.30-beta.6"
+readonly PKG_VERSION="1.1.30-beta.8"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.30-beta.6",
+  "version": "1.1.30-beta.8",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",