siluzan-tso-cli 1.1.23 → 1.1.24-beta.3

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.24-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -3328,7 +3328,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";
   }
 });
 
@@ -4753,8 +4753,9 @@ var init_google_analysis = __esm({
       "// \u65E7\u5B57\u6BB5 `budgetAmount`\uFF08\u5206\uFF09/ `*Micros`\uFF08\u5FAE\u5143\uFF09\u5DF2\u4E0D\u518D\u843D\u76D8\uFF0C**\u7981\u6B62**\u518D\u505A \xF7100 / \xF71_000_000 \u6362\u7B97\u3002"
     ];
     GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS = [
-      "// \u7ADE\u4E89\u6307\u6807\uFF1A`campaigns[].competitiveMetrics` \u4E3A Google \u539F\u751F **0~1 \u5C0F\u6570**\uFF08\u5982 `0.0999` = 9.99%\uFF09\uFF0C\u542B Top/AbsoluteTop/Content/ClickShare \u7B49 15 \u9879\uFF1B\u65E0 GAQL \u7ADE\u4E89\u6570\u636E\u65F6\u4E3A `null`\u3002",
-      "// \u884C\u9876 `searchImpressionShare` / `searchBudgetLostImpressionShare` / `searchRankLostImpressionShare` \u4ECD\u4E3A **0~100 \u767E\u5206\u6570**\uFF08\u4EC5 3 \u9879\uFF09\uFF1B**\u7981\u6B62**\u4E0E `competitiveMetrics.*` \u76F8\u52A0\u6216\u6DF7\u7B97\u3002"
+      "// \u7ADE\u4E89\u6307\u6807\uFF1A`campaigns[].competitiveMetrics` \u4E3A **0~1 \u5C0F\u6570**\uFF08\u5982 `0.0999` = 9.99%\uFF09\uFF0C\u542B Top/AbsoluteTop/Content/ClickShare \u7B49\uFF1B\u65E0\u6570\u636E\u65F6\u4E3A `null`\u3002",
+      "// \u884C\u9876 `searchImpressionShare` / `searchBudgetLostImpressionShare` / `searchRankLostImpressionShare` \u843D\u76D8\u524D\u5DF2\u5F52\u4E00\u4E3A **0~1 \u5C0F\u6570**\uFF08\u4E0E `competitiveMetrics` \u540C\u540D\u9879\u4E00\u81F4\uFF09\uFF1B\u5C55\u793A\u4E3A % \u65F6 \xD7100\u3002",
+      "// `keywords[]` \u884C\u9876 3 \u9879\u4EFD\u989D\u540C\u6837\u4E3A 0~1 \u5C0F\u6570\uFF08\u65E0 `competitiveMetrics` \u65F6\u7531\u767E\u5206\u6570 \xF7100\uFF09\u3002"
     ];
     RATE_BEARING_SECTIONS = /* @__PURE__ */ new Set([
       "overview",
@@ -5009,6 +5010,61 @@ var init_sections = __esm({
   }
 });
 
+// src/commands/google-analysis/normalize-impression-shares.ts
+function normalizeShareValue(value, competitiveMetrics, field) {
+  const cmVal = competitiveMetrics?.[field];
+  if (typeof cmVal === "number" && Number.isFinite(cmVal)) {
+    return cmVal;
+  }
+  if (Math.abs(value) > 1) {
+    return value / 100;
+  }
+  return value;
+}
+function normalizeLegacyShareOnRow(row) {
+  const rawCm = row.competitiveMetrics;
+  const competitiveMetrics = rawCm !== null && typeof rawCm === "object" && !Array.isArray(rawCm) ? rawCm : null;
+  for (const field of LEGACY_ROW_IMPRESSION_SHARE_FIELDS) {
+    const v = row[field];
+    if (typeof v !== "number" || !Number.isFinite(v)) continue;
+    row[field] = normalizeShareValue(v, competitiveMetrics, field);
+  }
+}
+function normalizeRowsInArray(rows) {
+  if (!Array.isArray(rows)) return;
+  for (const row of rows) {
+    if (row !== null && typeof row === "object" && !Array.isArray(row)) {
+      normalizeLegacyShareOnRow(row);
+    }
+  }
+}
+function normalizeImpressionShareScales(payload, section) {
+  if (!SECTIONS_WITH_LEGACY_ROW_SHARES.has(section)) return payload;
+  if (payload === null || typeof payload !== "object") return payload;
+  const root = payload;
+  if (section === "campaigns") {
+    normalizeRowsInArray(root.campaigns);
+  } else if (section === "keywords") {
+    normalizeRowsInArray(root.keywords);
+  }
+  return payload;
+}
+var LEGACY_ROW_IMPRESSION_SHARE_FIELDS, SECTIONS_WITH_LEGACY_ROW_SHARES;
+var init_normalize_impression_shares = __esm({
+  "src/commands/google-analysis/normalize-impression-shares.ts"() {
+    "use strict";
+    LEGACY_ROW_IMPRESSION_SHARE_FIELDS = [
+      "searchImpressionShare",
+      "searchBudgetLostImpressionShare",
+      "searchRankLostImpressionShare"
+    ];
+    SECTIONS_WITH_LEGACY_ROW_SHARES = /* @__PURE__ */ new Set([
+      "campaigns",
+      "keywords"
+    ]);
+  }
+});
+
 // src/commands/google-analysis/normalize-rates.ts
 function divIfFiniteNumber(v) {
   return typeof v === "number" && Number.isFinite(v) ? v / 100 : v;
@@ -100824,6 +100880,7 @@ async function fetchSectionPayload(def, opts, config, id) {
   );
   let payload = stripLegacyGoogleFieldsIfV2Present(data);
   payload = normalizeRateScales(payload, def.name);
+  payload = normalizeImpressionShareScales(payload, def.name);
   payload = normalizeMoneyScales(payload, def.name);
   if (def.name === "overview") {
     payload = normalizeOverviewPayload(payload);
@@ -100871,6 +100928,7 @@ var init_fetch = __esm({
     init_auth();
     init_strip_legacy_google_fields();
     init_sections();
+    init_normalize_impression_shares();
     init_normalize_rates();
     init_normalize_money();
     init_normalize_overview();
@@ -100905,14 +100963,14 @@ function computeBackoffMs(attempt, policy) {
   return capped + jitter;
 }
 function sleep3(ms, signal) {
-  return new Promise((resolve13, reject) => {
+  return new Promise((resolve14, reject) => {
     if (signal?.aborted) {
       reject(new Error("retry sleep aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve13();
+      resolve14();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -102514,6 +102572,7 @@ var init_google_analysis2 = __esm({
     init_sections();
     init_fetch();
     init_normalize_rates();
+    init_normalize_impression_shares();
     init_translate_fields();
     init_register_cli();
   }
@@ -102531,7 +102590,7 @@ var init_google_analysis3 = __esm({
 init_dist();
 init_dist();
 import * as fs14 from "fs";
-import * as path21 from "path";
+import * as path22 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command } from "commander";
 
@@ -103016,10 +103075,10 @@ function deriveWebUrl(apiBaseUrl) {
 }
 var TSO_UMI_ROUTE_PREFIX = "/v3umijs/tso";
 function buildTsoPageWebUrl(webUrl, tsoSubRoute) {
-  const path22 = tsoSubRoute.replace(/^\/+/, "");
-  const umiPath = `${TSO_UMI_ROUTE_PREFIX}/${path22}`;
+  const path23 = tsoSubRoute.replace(/^\/+/, "");
+  const umiPath = `${TSO_UMI_ROUTE_PREFIX}/${path23}`;
   const q = new URLSearchParams({ tso: umiPath });
-  return `${webUrl.replace(/\/+$/, "")}/v3/foreign_trade/tso/${path22}?${q.toString()}`;
+  return `${webUrl.replace(/\/+$/, "")}/v3/foreign_trade/tso/${path23}?${q.toString()}`;
 }
 function cmdConfigShow() {
   const shared = readSharedConfig();
@@ -110193,7 +110252,7 @@ function cloneKeywordBlockShell(block) {
   delete shell["matchTypeV2"];
   return shell;
 }
-function splitKeywordsForBatchJobBlockIfMixed(block, path22, warnings) {
+function splitKeywordsForBatchJobBlockIfMixed(block, path23, warnings) {
   const declaredUi = matchTypeV2ToUi(readBlockMatchTypeRaw(block));
   const entries = collectKeywordEntriesFromBlock(block);
   if (entries.length === 0) return [block];
@@ -110212,7 +110271,7 @@ function splitKeywordsForBatchJobBlockIfMixed(block, path22, warnings) {
     (ui) => matchTypeUiToV2(ui)
   );
   warnings.push(
-    `${path22} \u542B\u591A\u79CD\u5339\u914D\u7C7B\u578B\uFF0C\u5DF2\u81EA\u52A8\u62C6\u5206\u4E3A ${groups.size} \u4E2A KeywordsForBatchJob \u5757\uFF08${labels.join("\u3001")}\uFF09`
+    `${path23} \u542B\u591A\u79CD\u5339\u914D\u7C7B\u578B\uFF0C\u5DF2\u81EA\u52A8\u62C6\u5206\u4E3A ${groups.size} \u4E2A KeywordsForBatchJob \u5757\uFF08${labels.join("\u3001")}\uFF09`
   );
   const shell = cloneKeywordBlockShell(block);
   const splitBlocks = [];
@@ -110232,16 +110291,16 @@ function splitKeywordsForBatchJobBlockIfMixed(block, path22, warnings) {
   }
   return splitBlocks;
 }
-function validateKeywordCore(core, path22, errors, lengthViolations) {
+function validateKeywordCore(core, path23, errors, lengthViolations) {
   const trimmed = core.trim();
   if (!trimmed) {
-    errors.push(`${path22} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
+    errors.push(`${path23} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
     return false;
   }
   if (trimmed.length > GOOGLE_KEYWORD_MAX_CORE_LENGTH) {
     if (lengthViolations) {
       pushLengthViolation(lengthViolations, {
-        path: path22,
+        path: path23,
         field: "KeywordText",
         kind: "keyword_core",
         limit: GOOGLE_KEYWORD_MAX_CORE_LENGTH,
@@ -110251,13 +110310,13 @@ function validateKeywordCore(core, path22, errors, lengthViolations) {
       });
     }
     errors.push(
-      `${path22} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed}"`
+      `${path23} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed}"`
     );
     return false;
   }
   if (!VALID_CORE_REGEX.test(trimmed)) {
     errors.push(
-      `${path22} \u542B Google \u4E0D\u5141\u8BB8\u7684\u5B57\u7B26\uFF08\u8BCD\u5E72\u4EC5\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u7A7A\u683C/\u8FDE\u5B57\u7B26/\u53E5\u70B9\uFF09\uFF1A"${trimmed.slice(0, 40)}${trimmed.length > 40 ? "\u2026" : ""}"`
+      `${path23} \u542B Google \u4E0D\u5141\u8BB8\u7684\u5B57\u7B26\uFF08\u8BCD\u5E72\u4EC5\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u7A7A\u683C/\u8FDE\u5B57\u7B26/\u53E5\u70B9\uFF09\uFF1A"${trimmed.slice(0, 40)}${trimmed.length > 40 ? "\u2026" : ""}"`
     );
     return false;
   }
@@ -110314,24 +110373,24 @@ function canonicalizeKeywordBatchBlock(block, resolvedMatchV2, normalizedTexts,
     }
   }
 }
-function pushKeywordAutoFixWarning(warnings, path22, fieldLabel, trimmedRaw, formatted, declaredUi, beforeUi, matchType, inferredMatchType) {
+function pushKeywordAutoFixWarning(warnings, path23, fieldLabel, trimmedRaw, formatted, declaredUi, beforeUi, matchType, inferredMatchType) {
   if (inferredMatchType) {
     warnings.push(
-      `${path22}.${fieldLabel} \u672A\u6307\u5B9A MatchTypeV2\uFF0C\u5DF2\u6309\u8BCD\u9762\u63A8\u65AD\u4E3A ${matchTypeUiToV2(matchType)}`
+      `${path23}.${fieldLabel} \u672A\u6307\u5B9A MatchTypeV2\uFF0C\u5DF2\u6309\u8BCD\u9762\u63A8\u65AD\u4E3A ${matchTypeUiToV2(matchType)}`
     );
     return;
   }
   if (declaredUi && beforeUi !== declaredUi) {
     warnings.push(
-      `${path22}.${fieldLabel} MatchTypeV2=${matchTypeUiToV2(declaredUi)} \u4E0E\u8BCD\u9762\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u4FEE\u590D\u4E3A\uFF1A${formatted}`
+      `${path23}.${fieldLabel} MatchTypeV2=${matchTypeUiToV2(declaredUi)} \u4E0E\u8BCD\u9762\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u4FEE\u590D\u4E3A\uFF1A${formatted}`
     );
     return;
   }
   if (formatted !== trimmedRaw) {
-    warnings.push(`${path22}.${fieldLabel} \u5DF2\u81EA\u52A8\u4FEE\u590D\u8BCD\u9762\uFF1A${trimmedRaw} \u2192 ${formatted}`);
+    warnings.push(`${path23}.${fieldLabel} \u5DF2\u81EA\u52A8\u4FEE\u590D\u8BCD\u9762\uFF1A${trimmedRaw} \u2192 ${formatted}`);
   }
 }
-function normalizeKeywordTextList(texts, matchTypeRaw, path22, fieldLabel, errors, warnings, lengthViolations) {
+function normalizeKeywordTextList(texts, matchTypeRaw, path23, fieldLabel, errors, warnings, lengthViolations) {
   const declaredUi = matchTypeV2ToUi(matchTypeRaw);
   const normalized = [];
   const seen = /* @__PURE__ */ new Set();
@@ -110339,7 +110398,7 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path22, fieldLabel, error
   for (let k = 0; k < texts.length; k++) {
     const raw = texts[k];
     if (typeof raw !== "string" || !raw.trim()) {
-      errors.push(`${path22}.${fieldLabel}[${k}] \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
+      errors.push(`${path23}.${fieldLabel}[${k}] \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
       continue;
     }
     const trimmedRaw = collapseDuplicateSpacesInKeywordText(raw.trim());
@@ -110347,7 +110406,7 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path22, fieldLabel, error
     const { formatted, matchType, inferredMatchType } = normalizeKeywordSurface(trimmedRaw, matchTypeRaw);
     pushKeywordAutoFixWarning(
       warnings,
-      path22,
+      path23,
       fieldLabel,
       trimmedRaw,
       formatted,
@@ -110357,10 +110416,10 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path22, fieldLabel, error
       inferredMatchType
     );
     const core = unwrapKeywordDisplayTextForEdit(formatted);
-    if (!validateKeywordCore(core, `${path22}.${fieldLabel}[${k}]`, errors, lengthViolations)) continue;
+    if (!validateKeywordCore(core, `${path23}.${fieldLabel}[${k}]`, errors, lengthViolations)) continue;
     const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
     if (seen.has(dedupeKey)) {
-      warnings.push(`${path22}.${fieldLabel}[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
+      warnings.push(`${path23}.${fieldLabel}[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
       continue;
     }
     seen.add(dedupeKey);
@@ -110369,12 +110428,12 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path22, fieldLabel, error
   }
   return { normalized, resolvedUi };
 }
-function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, lengthViolations) {
+function normalizeKeywordsForBatchJobBlock(block, path23, errors, warnings, lengthViolations) {
   const matchTypeRaw = readBlockMatchTypeRaw(block);
   const declaredUi = matchTypeV2ToUi(matchTypeRaw);
   if (matchTypeRaw !== void 0 && declaredUi === null) {
     errors.push(
-      `${path22}.MatchTypeV2 \u65E0\u6548\uFF08${String(matchTypeRaw)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1ABROAD | PHRASE | EXACT`
+      `${path23}.MatchTypeV2 \u65E0\u6548\uFF08${String(matchTypeRaw)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1ABROAD | PHRASE | EXACT`
     );
     return;
   }
@@ -110389,7 +110448,7 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, leng
     const result = normalizeKeywordTextList(
       texts,
       matchTypeRaw,
-      path22,
+      path23,
       "KeywordText",
       errors,
       warnings,
@@ -110398,7 +110457,7 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, leng
     normalizedTexts = result.normalized;
     if (result.resolvedUi) resolvedUi = result.resolvedUi;
     if (normalizedTexts.length === 0 && texts.length > 0) {
-      errors.push(`${path22}.KeywordText \u7ECF\u6821\u9A8C\u540E\u65E0\u6709\u6548\u5173\u952E\u8BCD\uFF0C\u8BF7\u4FEE\u6B63\u8BCD\u9762\u6216 MatchTypeV2`);
+      errors.push(`${path23}.KeywordText \u7ECF\u6821\u9A8C\u540E\u65E0\u6709\u6548\u5173\u952E\u8BCD\uFF0C\u8BF7\u4FEE\u6B63\u8BCD\u9762\u6216 MatchTypeV2`);
     }
   }
   if (hasItems && items) {
@@ -110406,12 +110465,12 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, leng
     for (let k = 0; k < items.length; k++) {
       const item = items[k];
       if (!item || typeof item !== "object") {
-        errors.push(`${path22}.Items[${k}] \u5FC5\u987B\u662F\u5BF9\u8C61`);
+        errors.push(`${path23}.Items[${k}] \u5FC5\u987B\u662F\u5BF9\u8C61`);
         continue;
       }
       const raw = readItemText(item);
       if (raw === null || !raw.trim()) {
-        errors.push(`${path22}.Items[${k}].Text \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
+        errors.push(`${path23}.Items[${k}].Text \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
         continue;
       }
       const trimmedRaw = collapseDuplicateSpacesInKeywordText(raw.trim());
@@ -110419,7 +110478,7 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, leng
       const { formatted, matchType, inferredMatchType } = normalizeKeywordSurface(trimmedRaw, matchTypeRaw);
       pushKeywordAutoFixWarning(
         warnings,
-        path22,
+        path23,
         `Items[${k}].Text`,
         trimmedRaw,
         formatted,
@@ -110429,10 +110488,10 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, leng
         inferredMatchType
       );
       const core = unwrapKeywordDisplayTextForEdit(formatted);
-      if (!validateKeywordCore(core, `${path22}.Items[${k}].Text`, errors, lengthViolations)) continue;
+      if (!validateKeywordCore(core, `${path23}.Items[${k}].Text`, errors, lengthViolations)) continue;
       const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
       if (seen.has(dedupeKey)) {
-        warnings.push(`${path22}.Items[${k}].Text \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
+        warnings.push(`${path23}.Items[${k}].Text \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
         continue;
       }
       seen.add(dedupeKey);
@@ -113031,12 +113090,12 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           for (let ki = 0; ki < texts.length; ki++) {
             const t = texts[ki];
             if (typeof t !== "string" || !t.trim()) continue;
-            const path22 = `${groupPath}.KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
+            const path23 = `${groupPath}.KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
             const key = keywordKey(t, matchTypeV2);
             if (!liveKwKeys.has(key)) {
               missing.push({
                 layer: "keyword",
-                path: path22,
+                path: path23,
                 adGroupName: groupName,
                 plannedContent: `\u8BCD\u9762: ${t}  |  \u5339\u914D: ${matchTypeV2}`,
                 liveNote: `\u540C\u7EC4\u5DF2\u6709 ${liveKwInGroup.length} \u6761\u5173\u952E\u8BCD\uFF0C\u65E0\u952E ${key}`,
@@ -113054,12 +113113,12 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
         for (let ai = 0; ai < ads.length; ai++) {
           const ad = asRecord(ads[ai]);
           if (!ad) continue;
-          const path22 = `${groupPath}.AdsForBatchJob[${ai}]`;
+          const path23 = `${groupPath}.AdsForBatchJob[${ai}]`;
           const primary = pickString(ad["headlinePart1"], ad["AdTitle"]);
           if (!primary) {
             missing.push({
               layer: "ad",
-              path: path22,
+              path: path23,
               adGroupName: groupName,
               plannedContent: `AdsForBatchJob[${ai}]\uFF08\u7F3A\u5C11 headlinePart1\uFF0C\u65E0\u6CD5\u6BD4\u5BF9\uFF09`,
               liveNote: `\u540C\u7EC4\u5DF2\u6709 ${liveAdsInGroup.length} \u6761\u521B\u610F`,
@@ -113072,7 +113131,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           if (!found) {
             missing.push({
               layer: "ad",
-              path: path22,
+              path: path23,
               adGroupName: groupName,
               plannedContent: `RSA \u9996\u6807\u9898: ${primary}${finalUrl ? `  |  \u843D\u5730\u9875: ${finalUrl}` : ""}`,
               liveNote: `\u540C\u7EC4\u5DF2\u6709 ${liveAdsInGroup.length} \u6761 RSA\uFF0C\u65E0\u6B64\u9996\u6807\u9898`,
@@ -114212,13 +114271,13 @@ function pmaxChannelTypesUrl(googleApiUrl) {
 }
 function pmaxCampaignUrl(googleApiUrl, accountId, campaignId) {
   const base = googleApiUrl.replace(/\/$/, "");
-  const path22 = `${base}/accounts/${accountId}/campaign/pmax`;
-  return campaignId ? `${path22}/${campaignId}` : path22;
+  const path23 = `${base}/accounts/${accountId}/campaign/pmax`;
+  return campaignId ? `${path23}/${campaignId}` : path23;
 }
 function pmaxAssetGroupUrl(googleApiUrl, accountId, assetGroupId, suffix) {
   const base = googleApiUrl.replace(/\/$/, "");
-  const path22 = `${base}/accounts/${accountId}/campaign/pmax/asset-group/${assetGroupId}`;
-  return suffix ? `${path22}/${suffix.replace(/^\//, "")}` : path22;
+  const path23 = `${base}/accounts/${accountId}/campaign/pmax/asset-group/${assetGroupId}`;
+  return suffix ? `${path23}/${suffix.replace(/^\//, "")}` : path23;
 }
 function pmaxCampaignAssetGroupUrl(googleApiUrl, accountId, campaignId) {
   const base = googleApiUrl.replace(/\/$/, "");
@@ -120900,13 +120959,265 @@ function register25(program2) {
 // src/index.ts
 init_google_analysis3();
 init_google_analysis_batch();
+
+// src/commands/facebook-analysis/sections.ts
+var FACEBOOK_SECTIONS = [
+  {
+    name: "overview",
+    description: "\u603B\u89C8 OverviewSectionData\uFF08\u542B currentPeriod / previousPeriod \u73AF\u6BD4\uFF09",
+    segment: "OverviewSectionData"
+  },
+  {
+    name: "ad-sets",
+    description: "\u5E7F\u544A\u7EC4 AdSetSectionData\uFF08Meta Ad Set\uFF0C\u5B57\u6BB5 adGroups\uFF09",
+    segment: "AdSetSectionData"
+  },
+  {
+    name: "platform",
+    description: "\u6295\u653E\u5E73\u53F0 PlatformSectionData\uFF08facebook / instagram \u7B49\uFF09",
+    segment: "PlatformSectionData"
+  },
+  {
+    name: "country",
+    description: "\u56FD\u5BB6 CountrySectionData\uFF08\u53EF\u6309 spend \u964D\u5E8F limit\uFF09",
+    segment: "CountrySectionData",
+    countryLimitOption: true
+  },
+  {
+    name: "audience",
+    description: "\u53D7\u4F17 AudienceSectionData\uFF08\u5E74\u9F84 \xD7 \u6027\u522B\uFF09",
+    segment: "AudienceSectionData"
+  },
+  {
+    name: "creative",
+    description: "\u521B\u610F CreativeSectionData\uFF08\u9ED8\u8BA4\u521B\u610F\u62A5\u544A\uFF0C\u6240\u6709\u8D26\u6237\u53EF\u7528\uFF09",
+    segment: "CreativeSectionData"
+  },
+  {
+    name: "material",
+    description: "\u7D20\u6750 MaterialSectionData\uFF08\u4EC5 Dynamic Creative\uFF1B\u6807\u51C6\u8D26\u6237\u5E38\u4E3A\u7A7A\uFF09",
+    segment: "MaterialSectionData"
+  }
+];
+var FACEBOOK_SECTION_NAMES = FACEBOOK_SECTIONS.map((s) => s.name);
+var FACEBOOK_SECTION_ALIASES = {
+  campaigns: "ad-sets",
+  "ad-groups": "ad-sets",
+  geographic: "country",
+  geo: "country",
+  devices: "platform",
+  network: "platform",
+  networks: "platform",
+  ads: "creative",
+  materials: "material",
+  "asset-images": "material",
+  videos: "material"
+};
+
+// src/commands/facebook-analysis/fetch.ts
+init_auth();
+function normalizeFacebookAccountId(raw) {
+  const t = raw.trim();
+  if (!t) {
+    console.error("\n\u274C --account \u4E0D\u80FD\u4E3A\u7A7A\u3002\n");
+    process.exit(1);
+  }
+  const digits = t.startsWith("act_") ? t.slice(4) : t;
+  if (!/^\d+$/.test(digits)) {
+    console.error(
+      "\n\u274C --account \u987B\u4E3A Facebook \u5E7F\u544A\u8D26\u6237 ID\uFF08\u6570\u5B57 mediaCustomerId\uFF0C\u6216 act_<\u6570\u5B57>\uFF0C\u4E0E list-accounts -m MetaAd \u4E00\u81F4\uFF09\u3002\n"
+    );
+    process.exit(1);
+  }
+  return { apiId: `act_${digits}`, manifestId: digits };
+}
+function resolveFacebookDateRange(start, end) {
+  if (start && end) return { startDate: start, endDate: end };
+  if (!start && !end) {
+    const endD = /* @__PURE__ */ new Date();
+    endD.setDate(endD.getDate() - 1);
+    const startD = new Date(endD);
+    startD.setDate(startD.getDate() - 6);
+    const fmt2 = (d) => d.toISOString().slice(0, 10);
+    return { startDate: fmt2(startD), endDate: fmt2(endD) };
+  }
+  console.error("\n\u274C --start \u4E0E --end \u987B\u540C\u65F6\u4F20\u5165\uFF0C\u6216\u540C\u65F6\u7701\u7565\u4EE5\u4F7F\u7528\u9ED8\u8BA4\u8FD1 7 \u5929\uFF08\u622A\u81F3\u6628\u5929\uFF09\u3002\n");
+  process.exit(1);
+}
+function facebookReportingUrl(config, apiId, segment, query) {
+  const q = query ? query.startsWith("?") ? query : `?${query}` : "";
+  return `${config.apiBaseUrl}/reporting/media-account/FacebookAds/${encodeURIComponent(apiId)}/${segment}${q}`;
+}
+async function fetchFacebookSectionPayload(def, opts, config, apiId) {
+  const { startDate, endDate } = resolveFacebookDateRange(opts.start, opts.end);
+  const params = new URLSearchParams({ startDate, endDate });
+  if (def.countryLimitOption && opts.limit !== void 0 && Number.isFinite(opts.limit)) {
+    params.set("limit", String(Math.max(1, Math.floor(opts.limit))));
+  }
+  const url = facebookReportingUrl(config, apiId, def.segment, params.toString());
+  return apiFetch2(url, config, {}, opts.verbose ?? false);
+}
+function endpointHintForFacebookSection(def, apiId) {
+  return `GET \u2026/FacebookAds/${apiId}/${def.segment}`;
+}
+
+// src/commands/facebook-analysis/run-batch.ts
+init_auth();
+import * as path21 from "path";
+import { performance as performance5 } from "perf_hooks";
+init_version();
+
+// src/commands/facebook-analysis/resolve-sections.ts
+function normalizeSectionToken(raw) {
+  const t = raw.trim();
+  if (!t) return null;
+  if (FACEBOOK_SECTION_NAMES.includes(t)) {
+    return t;
+  }
+  return FACEBOOK_SECTION_ALIASES[t] ?? null;
+}
+function resolveSectionList2(sections, exclude) {
+  const splitClean = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const include = splitClean(sections);
+  const dropRaw = splitClean(exclude);
+  const unknown = [...include, ...dropRaw].filter((n) => normalizeSectionToken(n) === null);
+  if (unknown.length > 0) {
+    console.error(
+      `
+\u274C \u672A\u77E5\u7684 section \u540D\u79F0\uFF1A${unknown.join(", ")}
+   \u53EF\u9009\uFF1A${FACEBOOK_SECTION_NAMES.join(", ")}
+   Google \u522B\u540D\uFF1A${Object.keys(FACEBOOK_SECTION_ALIASES).join(", ")}
+`
+    );
+    process.exit(1);
+  }
+  const includeCanonical = new Set(
+    include.map((n) => normalizeSectionToken(n)).filter(Boolean)
+  );
+  const dropCanonical = new Set(
+    dropRaw.map((n) => normalizeSectionToken(n)).filter(Boolean)
+  );
+  const base = include.length > 0 ? FACEBOOK_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...FACEBOOK_SECTIONS];
+  return base.filter((s) => !dropCanonical.has(s.name));
+}
+
+// src/commands/facebook-analysis/run-batch.ts
+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 () => {
+    while (true) {
+      const i = cursor++;
+      if (i >= tasks.length) return;
+      results[i] = await tasks[i]();
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function runAllFacebookSections(opts) {
+  const { apiId, manifestId } = normalizeFacebookAccountId(opts.account);
+  const config = loadConfig(opts.token);
+  if (!opts.jsonOut?.trim()) {
+    console.error("\n\u274C \u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF08\u5404\u7EF4\u5EA6\u843D\u76D8\u540E\u7531 report-manifest \u7D22\u5F15\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const targets = resolveSectionList2(opts.sections, opts.exclude);
+  if (targets.length === 0) {
+    console.error("\n\u274C \u6CA1\u6709\u8981\u6267\u884C\u7684 section\uFF08\u8BF7\u68C0\u67E5 --sections / --exclude\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const { startDate, endDate } = resolveFacebookDateRange(opts.start, opts.end);
+  const concurrency = Math.max(
+    1,
+    Math.min(typeof opts.concurrency === "number" ? opts.concurrency : 5, 16)
+  );
+  const cliVersion = getCurrentVersion2();
+  const overallT0 = performance5.now();
+  const tasks = targets.map((def) => async () => {
+    const t0 = performance5.now();
+    const hint = endpointHintForFacebookSection(def, apiId);
+    try {
+      const payload = await fetchFacebookSectionPayload(def, opts, config, apiId);
+      const summary2 = await writeReportAnalysisSnapshot({
+        snapshotDir: opts.jsonOut,
+        section: def.name,
+        accountId: manifestId,
+        dateRange: { start: startDate, end: endDate },
+        payload,
+        cliVersion
+      });
+      return {
+        section: def.name,
+        ok: true,
+        elapsedMs: performance5.now() - t0,
+        file: summary2.writtenFiles[0],
+        endpointHint: hint
+      };
+    } catch (err) {
+      return {
+        section: def.name,
+        ok: false,
+        elapsedMs: performance5.now() - t0,
+        error: err instanceof Error ? err.message : String(err),
+        endpointHint: hint
+      };
+    }
+  });
+  const results = await runWithConcurrency2(tasks, concurrency);
+  const succeeded = results.filter((r) => r.ok).length;
+  const failed = results.length - succeeded;
+  const absoluteSnapshotDir = path21.resolve(opts.jsonOut);
+  const summary = {
+    kind: "siluzan-tso-facebook-analysis-snapshot-batch",
+    absoluteSnapshotDir,
+    manifestFile: reportManifestFile(manifestId),
+    accountId: manifestId,
+    totalSections: results.length,
+    succeeded,
+    failed,
+    concurrency,
+    elapsedMs: performance5.now() - overallT0,
+    results
+  };
+  console.log(JSON.stringify(summary));
+  if (failed > 0) process.exit(2);
+}
+
+// src/commands/facebook-analysis/register-cli.ts
+function registerFacebookAnalysisCommands(program2) {
+  const sectionHelp = FACEBOOK_SECTION_NAMES.join(", ");
+  program2.command("facebook-analysis").description(
+    "Facebook Ads \u8D26\u6237\u5206\u6790\u6279\u91CF\u62C9\u53D6\uFF08TSO reporting/media-account/FacebookAds/\u2026\uFF0C7 \u4E2A Section\uFF09"
+  ).requiredOption(
+    "-a, --account <id>",
+    "Facebook \u5E7F\u544A\u8D26\u6237 mediaCustomerId\uFF08\u6570\u5B57\u6216 act_<\u6570\u5B57>\uFF09"
+  ).requiredOption(
+    "--json-out <dir>",
+    "\u7ED3\u679C\u843D\u76D8\u76EE\u5F55\uFF1B\u6BCF\u7EF4\u5EA6 `<section>-<accountId>.json` + `report-manifest-<accountId>.json`"
+  ).option("-t, --token <token>", "Auth Token").option(
+    "--start <date>",
+    "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF1B\u7701\u7565=\u8FD1 7 \u5929\u622A\u81F3\u6628\u5929\uFF09"
+  ).option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option(
+    "--sections <list>",
+    `\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,ad-sets,platform\uFF1B\u7701\u7565=\u5168\u90E8 7 \u4E2A\u3002\u53EF\u9009\uFF1A${sectionHelp}\uFF1BGoogle \u522B\u540D\uFF1Acampaigns,geographic,devices,ads,materials`
+  ).option("--exclude <list>", "\u6392\u9664\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u4E0E --sections \u53EF\u53E0\u52A0").option(
+    "--limit <n>",
+    "\u4EC5 country \u7EF4\u5EA6\uFF1A\u6309 spend \u964D\u5E8F\u53D6\u524D N \u6761\uFF08\u4E0D\u4F20\u5219\u8FD4\u56DE\u5168\u90E8\u56FD\u5BB6\uFF09",
+    (v) => parseInt(v, 10)
+  ).option("--concurrency <n>", "\u5E76\u53D1\u6570\uFF0C\u9ED8\u8BA4 5\uFF0C\u4E0A\u9650 16", (v) => parseInt(v, 10)).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
+    await runAllFacebookSections(opts);
+  });
+}
+
+// src/index.ts
 init_version();
 init_cli_json_snapshot();
 installProcessHandlers();
 function getVersion() {
   try {
-    const __dirname3 = path21.dirname(fileURLToPath4(import.meta.url));
-    const pkgPath = path21.join(__dirname3, "..", "package.json");
+    const __dirname3 = path22.dirname(fileURLToPath4(import.meta.url));
+    const pkgPath = path22.join(__dirname3, "..", "package.json");
     const pkg = JSON.parse(fs14.readFileSync(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
@@ -120946,6 +121257,7 @@ var REGISTRARS = [
   register13,
   registerGoogleAnalysisCommands,
   registerGoogleAnalysisBatchCommands,
+  registerFacebookAnalysisCommands,
   register14,
   register15,
   register16,