siluzan-tso-cli 1.1.27-beta.3 → 1.1.28-beta.1

package/README.md

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

package/dist/index.js

@@ -258,9 +258,9 @@ var require_semver = __commonJS({
         } else {
           this.prerelease = m[4].split(".").map((id) => {
             if (/^[0-9]+$/.test(id)) {
-              const num = +id;
-              if (num >= 0 && num < MAX_SAFE_INTEGER) {
-                return num;
+              const num2 = +id;
+              if (num2 >= 0 && num2 < MAX_SAFE_INTEGER) {
+                return num2;
               }
             }
             return id;
@@ -101099,14 +101099,14 @@ function computeBackoffMs(attempt, policy) {
   return capped + jitter;
 }
 function sleep3(ms, signal) {
-  return new Promise((resolve14, reject) => {
+  return new Promise((resolve15, reject) => {
     if (signal?.aborted) {
       reject(new Error("retry sleep aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve14();
+      resolve15();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -102726,9 +102726,9 @@ var init_google_analysis3 = __esm({
 // src/index.ts
 init_dist();
 init_dist();
-import * as fs16 from "fs";
-import * as path24 from "path";
-import { fileURLToPath as fileURLToPath5 } from "url";
+import * as fs18 from "fs";
+import * as path26 from "path";
+import { fileURLToPath as fileURLToPath6 } from "url";
 import { Command } from "commander";
 
 // src/commands/login/urls.ts
@@ -103212,8 +103212,8 @@ function deriveWebUrl(apiBaseUrl) {
 }
 var TSO_UMI_ROUTE_PREFIX = "/v3umijs/tso";
 function buildTsoPageWebUrl(webUrl, tsoSubRoute, extraQuery) {
-  const path25 = tsoSubRoute.replace(/^\/+/, "");
-  const umiPath = `${TSO_UMI_ROUTE_PREFIX}/${path25}`;
+  const path27 = tsoSubRoute.replace(/^\/+/, "");
+  const umiPath = `${TSO_UMI_ROUTE_PREFIX}/${path27}`;
   const q = new URLSearchParams({ tso: umiPath });
   if (extraQuery) {
     for (const [key, value] of Object.entries(extraQuery)) {
@@ -103221,7 +103221,7 @@ function buildTsoPageWebUrl(webUrl, tsoSubRoute, extraQuery) {
       if (v) q.set(key, v);
     }
   }
-  return `${webUrl.replace(/\/+$/, "")}/v3/foreign_trade/tso/${path25}?${q.toString()}`;
+  return `${webUrl.replace(/\/+$/, "")}/v3/foreign_trade/tso/${path27}?${q.toString()}`;
 }
 function cmdConfigShow() {
   const shared = readSharedConfig();
@@ -110408,7 +110408,7 @@ function cloneKeywordBlockShell(block) {
   delete shell["matchTypeV2"];
   return shell;
 }
-function splitKeywordsForBatchJobBlockIfMixed(block, path25, warnings) {
+function splitKeywordsForBatchJobBlockIfMixed(block, path27, warnings) {
   const declaredUi = matchTypeV2ToUi(readBlockMatchTypeRaw(block));
   const entries = collectKeywordEntriesFromBlock(block);
   if (entries.length === 0) return [block];
@@ -110427,7 +110427,7 @@ function splitKeywordsForBatchJobBlockIfMixed(block, path25, warnings) {
     (ui) => matchTypeUiToV2(ui)
   );
   warnings.push(
-    `${path25} \u542B\u591A\u79CD\u5339\u914D\u7C7B\u578B\uFF0C\u5DF2\u81EA\u52A8\u62C6\u5206\u4E3A ${groups.size} \u4E2A KeywordsForBatchJob \u5757\uFF08${labels.join("\u3001")}\uFF09`
+    `${path27} \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 = [];
@@ -110447,16 +110447,16 @@ function splitKeywordsForBatchJobBlockIfMixed(block, path25, warnings) {
   }
   return splitBlocks;
 }
-function validateKeywordCore(core, path25, errors, lengthViolations) {
+function validateKeywordCore(core, path27, errors, lengthViolations) {
   const trimmed = core.trim();
   if (!trimmed) {
-    errors.push(`${path25} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
+    errors.push(`${path27} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
     return false;
   }
   if (trimmed.length > GOOGLE_KEYWORD_MAX_CORE_LENGTH) {
     if (lengthViolations) {
       pushLengthViolation(lengthViolations, {
-        path: path25,
+        path: path27,
         field: "KeywordText",
         kind: "keyword_core",
         limit: GOOGLE_KEYWORD_MAX_CORE_LENGTH,
@@ -110466,13 +110466,13 @@ function validateKeywordCore(core, path25, errors, lengthViolations) {
       });
     }
     errors.push(
-      `${path25} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed}"`
+      `${path27} \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(
-      `${path25} \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" : ""}"`
+      `${path27} \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;
   }
@@ -110529,24 +110529,24 @@ function canonicalizeKeywordBatchBlock(block, resolvedMatchV2, normalizedTexts,
     }
   }
 }
-function pushKeywordAutoFixWarning(warnings, path25, fieldLabel, trimmedRaw, formatted, declaredUi, beforeUi, matchType, inferredMatchType) {
+function pushKeywordAutoFixWarning(warnings, path27, fieldLabel, trimmedRaw, formatted, declaredUi, beforeUi, matchType, inferredMatchType) {
   if (inferredMatchType) {
     warnings.push(
-      `${path25}.${fieldLabel} \u672A\u6307\u5B9A MatchTypeV2\uFF0C\u5DF2\u6309\u8BCD\u9762\u63A8\u65AD\u4E3A ${matchTypeUiToV2(matchType)}`
+      `${path27}.${fieldLabel} \u672A\u6307\u5B9A MatchTypeV2\uFF0C\u5DF2\u6309\u8BCD\u9762\u63A8\u65AD\u4E3A ${matchTypeUiToV2(matchType)}`
     );
     return;
   }
   if (declaredUi && beforeUi !== declaredUi) {
     warnings.push(
-      `${path25}.${fieldLabel} MatchTypeV2=${matchTypeUiToV2(declaredUi)} \u4E0E\u8BCD\u9762\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u4FEE\u590D\u4E3A\uFF1A${formatted}`
+      `${path27}.${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(`${path25}.${fieldLabel} \u5DF2\u81EA\u52A8\u4FEE\u590D\u8BCD\u9762\uFF1A${trimmedRaw} \u2192 ${formatted}`);
+    warnings.push(`${path27}.${fieldLabel} \u5DF2\u81EA\u52A8\u4FEE\u590D\u8BCD\u9762\uFF1A${trimmedRaw} \u2192 ${formatted}`);
   }
 }
-function normalizeKeywordTextList(texts, matchTypeRaw, path25, fieldLabel, errors, warnings, lengthViolations) {
+function normalizeKeywordTextList(texts, matchTypeRaw, path27, fieldLabel, errors, warnings, lengthViolations) {
   const declaredUi = matchTypeV2ToUi(matchTypeRaw);
   const normalized = [];
   const seen = /* @__PURE__ */ new Set();
@@ -110554,7 +110554,7 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path25, fieldLabel, error
   for (let k = 0; k < texts.length; k++) {
     const raw = texts[k];
     if (typeof raw !== "string" || !raw.trim()) {
-      errors.push(`${path25}.${fieldLabel}[${k}] \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
+      errors.push(`${path27}.${fieldLabel}[${k}] \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
       continue;
     }
     const trimmedRaw = collapseDuplicateSpacesInKeywordText(raw.trim());
@@ -110562,7 +110562,7 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path25, fieldLabel, error
     const { formatted, matchType, inferredMatchType } = normalizeKeywordSurface(trimmedRaw, matchTypeRaw);
     pushKeywordAutoFixWarning(
       warnings,
-      path25,
+      path27,
       fieldLabel,
       trimmedRaw,
       formatted,
@@ -110572,10 +110572,10 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path25, fieldLabel, error
       inferredMatchType
     );
     const core = unwrapKeywordDisplayTextForEdit(formatted);
-    if (!validateKeywordCore(core, `${path25}.${fieldLabel}[${k}]`, errors, lengthViolations)) continue;
+    if (!validateKeywordCore(core, `${path27}.${fieldLabel}[${k}]`, errors, lengthViolations)) continue;
     const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
     if (seen.has(dedupeKey)) {
-      warnings.push(`${path25}.${fieldLabel}[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
+      warnings.push(`${path27}.${fieldLabel}[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
       continue;
     }
     seen.add(dedupeKey);
@@ -110584,12 +110584,12 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path25, fieldLabel, error
   }
   return { normalized, resolvedUi };
 }
-function normalizeKeywordsForBatchJobBlock(block, path25, errors, warnings, lengthViolations) {
+function normalizeKeywordsForBatchJobBlock(block, path27, errors, warnings, lengthViolations) {
   const matchTypeRaw = readBlockMatchTypeRaw(block);
   const declaredUi = matchTypeV2ToUi(matchTypeRaw);
   if (matchTypeRaw !== void 0 && declaredUi === null) {
     errors.push(
-      `${path25}.MatchTypeV2 \u65E0\u6548\uFF08${String(matchTypeRaw)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1ABROAD | PHRASE | EXACT`
+      `${path27}.MatchTypeV2 \u65E0\u6548\uFF08${String(matchTypeRaw)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1ABROAD | PHRASE | EXACT`
     );
     return;
   }
@@ -110604,7 +110604,7 @@ function normalizeKeywordsForBatchJobBlock(block, path25, errors, warnings, leng
     const result = normalizeKeywordTextList(
       texts,
       matchTypeRaw,
-      path25,
+      path27,
       "KeywordText",
       errors,
       warnings,
@@ -110613,7 +110613,7 @@ function normalizeKeywordsForBatchJobBlock(block, path25, errors, warnings, leng
     normalizedTexts = result.normalized;
     if (result.resolvedUi) resolvedUi = result.resolvedUi;
     if (normalizedTexts.length === 0 && texts.length > 0) {
-      errors.push(`${path25}.KeywordText \u7ECF\u6821\u9A8C\u540E\u65E0\u6709\u6548\u5173\u952E\u8BCD\uFF0C\u8BF7\u4FEE\u6B63\u8BCD\u9762\u6216 MatchTypeV2`);
+      errors.push(`${path27}.KeywordText \u7ECF\u6821\u9A8C\u540E\u65E0\u6709\u6548\u5173\u952E\u8BCD\uFF0C\u8BF7\u4FEE\u6B63\u8BCD\u9762\u6216 MatchTypeV2`);
     }
   }
   if (hasItems && items) {
@@ -110621,12 +110621,12 @@ function normalizeKeywordsForBatchJobBlock(block, path25, errors, warnings, leng
     for (let k = 0; k < items.length; k++) {
       const item = items[k];
       if (!item || typeof item !== "object") {
-        errors.push(`${path25}.Items[${k}] \u5FC5\u987B\u662F\u5BF9\u8C61`);
+        errors.push(`${path27}.Items[${k}] \u5FC5\u987B\u662F\u5BF9\u8C61`);
         continue;
       }
       const raw = readItemText(item);
       if (raw === null || !raw.trim()) {
-        errors.push(`${path25}.Items[${k}].Text \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
+        errors.push(`${path27}.Items[${k}].Text \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
         continue;
       }
       const trimmedRaw = collapseDuplicateSpacesInKeywordText(raw.trim());
@@ -110634,7 +110634,7 @@ function normalizeKeywordsForBatchJobBlock(block, path25, errors, warnings, leng
       const { formatted, matchType, inferredMatchType } = normalizeKeywordSurface(trimmedRaw, matchTypeRaw);
       pushKeywordAutoFixWarning(
         warnings,
-        path25,
+        path27,
         `Items[${k}].Text`,
         trimmedRaw,
         formatted,
@@ -110644,10 +110644,10 @@ function normalizeKeywordsForBatchJobBlock(block, path25, errors, warnings, leng
         inferredMatchType
       );
       const core = unwrapKeywordDisplayTextForEdit(formatted);
-      if (!validateKeywordCore(core, `${path25}.Items[${k}].Text`, errors, lengthViolations)) continue;
+      if (!validateKeywordCore(core, `${path27}.Items[${k}].Text`, errors, lengthViolations)) continue;
       const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
       if (seen.has(dedupeKey)) {
-        warnings.push(`${path25}.Items[${k}].Text \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
+        warnings.push(`${path27}.Items[${k}].Text \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
         continue;
       }
       seen.add(dedupeKey);
@@ -113255,12 +113255,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 path25 = `${groupPath}.KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
+            const path27 = `${groupPath}.KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
             const key = keywordKey(t, matchTypeV2);
             if (!liveKwKeys.has(key)) {
               missing.push({
                 layer: "keyword",
-                path: path25,
+                path: path27,
                 adGroupName: groupName,
                 plannedContent: `\u8BCD\u9762: ${t}  |  \u5339\u914D: ${matchTypeV2}`,
                 liveNote: `\u540C\u7EC4\u5DF2\u6709 ${liveKwInGroup.length} \u6761\u5173\u952E\u8BCD\uFF0C\u65E0\u952E ${key}`,
@@ -113278,12 +113278,12 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
         for (let ai = 0; ai < ads.length; ai++) {
           const ad = asRecord2(ads[ai]);
           if (!ad) continue;
-          const path25 = `${groupPath}.AdsForBatchJob[${ai}]`;
+          const path27 = `${groupPath}.AdsForBatchJob[${ai}]`;
           const primary = pickString(ad["headlinePart1"], ad["AdTitle"]);
           if (!primary) {
             missing.push({
               layer: "ad",
-              path: path25,
+              path: path27,
               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`,
@@ -113296,7 +113296,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           if (!found) {
             missing.push({
               layer: "ad",
-              path: path25,
+              path: path27,
               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`,
@@ -114494,13 +114494,13 @@ function pmaxChannelTypesUrl(googleApiUrl) {
 }
 function pmaxCampaignUrl(googleApiUrl, accountId, campaignId) {
   const base = googleApiUrl.replace(/\/$/, "");
-  const path25 = `${base}/accounts/${accountId}/campaign/pmax`;
-  return campaignId ? `${path25}/${campaignId}` : path25;
+  const path27 = `${base}/accounts/${accountId}/campaign/pmax`;
+  return campaignId ? `${path27}/${campaignId}` : path27;
 }
 function pmaxAssetGroupUrl(googleApiUrl, accountId, assetGroupId, suffix) {
   const base = googleApiUrl.replace(/\/$/, "");
-  const path25 = `${base}/accounts/${accountId}/campaign/pmax/asset-group/${assetGroupId}`;
-  return suffix ? `${path25}/${suffix.replace(/^\//, "")}` : path25;
+  const path27 = `${base}/accounts/${accountId}/campaign/pmax/asset-group/${assetGroupId}`;
+  return suffix ? `${path27}/${suffix.replace(/^\//, "")}` : path27;
 }
 function pmaxCampaignAssetGroupUrl(googleApiUrl, accountId, campaignId) {
   const base = googleApiUrl.replace(/\/$/, "");
@@ -122476,9 +122476,296 @@ function endpointHintForFacebookSection(def, apiId) {
   return `GET \u2026/FacebookAds/${apiId}/${def.segment}`;
 }
 
+// src/commands/facebook-analysis/render-report.ts
+import fs17 from "fs";
+import fsPromises2 from "fs/promises";
+import path24 from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
+
+// src/commands/facebook-analysis/merge-snapshot.ts
+import * as fs16 from "fs/promises";
+import * as path23 from "path";
+function asRecord5(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function num(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
+function audienceLabel(age, gender) {
+  const g = String(gender ?? "").toLowerCase();
+  const genderZh = g === "male" ? "male" : g === "female" ? "female" : String(gender ?? "");
+  return `${age ?? "\u2014"} \xB7 ${genderZh}`;
+}
+function fatigueFromFrequency(freq) {
+  if (freq == null) return { level: "\u4F4E", score: 25 };
+  if (freq >= 2.2) return { level: "\u9AD8", score: 75 };
+  if (freq >= 1.6) return { level: "\u4E2D", score: 55 };
+  return { level: "\u4F4E", score: 25 };
+}
+function statusFromCpl(cpl, avg) {
+  if (cpl == null || avg <= 0) return { tag: "yellow", label: "\u89C2\u5BDF" };
+  if (cpl <= avg * 0.9) return { tag: "green", label: "\u76C8\u5229" };
+  if (cpl >= avg * 1.15) return { tag: "red", label: "\u5371\u9669" };
+  return { tag: "yellow", label: "\u89C2\u5BDF" };
+}
+async function readManifest(snapshotDir) {
+  const entries = await fs16.readdir(snapshotDir);
+  const manifestNames = entries.filter((n) => n.startsWith("report-manifest") && n.endsWith(".json"));
+  const ordered = [
+    ...manifestNames.filter((n) => n !== REPORT_MANIFEST_FILE),
+    ...manifestNames.includes(REPORT_MANIFEST_FILE) ? [REPORT_MANIFEST_FILE] : []
+  ];
+  for (const name2 of ordered) {
+    try {
+      const raw = await fs16.readFile(path23.join(snapshotDir, name2), "utf8");
+      const parsed = JSON.parse(raw);
+      if (parsed?.artifacts?.length) return parsed;
+    } catch {
+    }
+  }
+  return null;
+}
+async function loadSectionFile(snapshotDir, file) {
+  try {
+    const raw = await fs16.readFile(path23.join(snapshotDir, file), "utf8");
+    return asRecord5(JSON.parse(raw));
+  } catch {
+    return null;
+  }
+}
+function aggregatePlatform(networks) {
+  const map = /* @__PURE__ */ new Map();
+  for (const row of networks) {
+    const platform = String(row.publisherPlatform ?? row.network ?? "unknown");
+    const prev = map.get(platform) ?? { spend: 0, results: 0 };
+    map.set(platform, {
+      spend: prev.spend + (num(row.spend) ?? 0),
+      results: prev.results + (num(row.results) ?? 0)
+    });
+  }
+  const labels = [];
+  const cpl = [];
+  const spend = [];
+  for (const [label, agg] of [...map.entries()].sort((a, b) => b[1].spend - a[1].spend)) {
+    labels.push(label);
+    spend.push(agg.spend);
+    cpl.push(agg.results > 0 ? agg.spend / agg.results : 0);
+  }
+  return { labels, cpl, spend };
+}
+function buildAudienceRows(audiences) {
+  return audiences.map((a) => ({
+    label: audienceLabel(a.age, a.gender),
+    spend: num(a.spend) ?? 0,
+    results: num(a.results) ?? 0,
+    costPerResult: num(a.costPerResult) ?? (num(a.results) ? (num(a.spend) ?? 0) / (num(a.results) ?? 1) : 0),
+    frequency: num(a.frequency)
+  })).filter((r) => r.spend > 0 || r.results > 0);
+}
+async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
+  const absDir = path23.resolve(snapshotDir);
+  const manifest = await readManifest(snapshotDir);
+  if (!manifest) {
+    throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 report-manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C facebook-analysis --json-out`);
+  }
+  const sectionMap = /* @__PURE__ */ new Map();
+  for (const art of manifest.artifacts) {
+    const data = await loadSectionFile(absDir, art.file);
+    if (data) sectionMap.set(art.section, data);
+  }
+  const overview = sectionMap.get("overview");
+  const current = asRecord5(overview?.currentPeriod);
+  const accountName = typeof overview?.accountName === "string" ? overview.accountName : void 0;
+  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;
+  }
+  const meta = { ...payload.meta ?? {} };
+  if (!meta.accountName && accountName) meta.accountName = accountName;
+  if (!meta.accountId && accountId) meta.accountId = accountId;
+  if (!meta.startDate && manifest.dateRange?.start) meta.startDate = manifest.dateRange.start;
+  if (!meta.endDate && manifest.dateRange?.end) meta.endDate = manifest.dateRange.end;
+  if (!meta.attributionSetting && current?.attributionSetting) {
+    meta.attributionSetting = String(current.attributionSetting);
+  }
+  if (!meta.resultType && current?.resultType) meta.resultType = String(current.resultType);
+  const charts = { ...payload.charts ?? {} };
+  const avgCpl = num(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) {
+      const sorted = [...countries].sort((a, b) => (num(b.spend) ?? 0) - (num(a.spend) ?? 0));
+      charts.country = {
+        labels: sorted.map((c) => String(c.countryOrRegion ?? "\u2014")),
+        cpl: sorted.map((c) => num(c.costPerResult) ?? 0)
+      };
+    }
+  }
+  if (!charts.audience) {
+    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);
+      charts.audience = {
+        labels: rows.map((r) => r.label),
+        cpl: rows.map((r) => r.costPerResult),
+        leads: rows.map((r) => r.results)
+      };
+    }
+  }
+  if (!charts.funnel && num(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) {
+      tables.adSets = groups.map((g) => {
+        const cpl = num(g.costPerResult);
+        const freq = num(g.frequency);
+        const fatigue = fatigueFromFrequency(freq);
+        const status = statusFromCpl(cpl, avgCpl);
+        return {
+          name: String(g.adGroupName ?? g.campaignName ?? "\u2014"),
+          spend: num(g.spend) ?? 0,
+          results: num(g.results) ?? 0,
+          costPerResult: cpl ?? 0,
+          frequency: freq,
+          fatigueLevel: fatigue.level,
+          fatigueScore: fatigue.score,
+          statusTag: status.tag,
+          statusLabel: status.label
+        };
+      }).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;
+    }
+  }
+  return {
+    ...payload,
+    meta,
+    kpis,
+    charts,
+    tables
+  };
+}
+
+// src/commands/facebook-analysis/render-report.ts
+var TEMPLATE_BASENAMES2 = {
+  html: "meta-period-report.html",
+  runtime: "meta-period-report.runtime.js"
+};
+var INJECT_MARKER = "window.__META_PERIOD_REPORT__ = window.__META_PERIOD_REPORT__ || null;";
+function resolveSkillTemplatePath2(basename11) {
+  const dir = path24.dirname(fileURLToPath5(import.meta.url));
+  const candidates = [
+    path24.join(dir, "skill", "report-templates", basename11),
+    path24.join(dir, "skill", "siluzan-ads", "report-templates", basename11),
+    path24.join(dir, "..", "..", "assets", "siluzan-ads", "report-templates", basename11)
+  ];
+  for (const p of candidates) {
+    if (fs17.existsSync(p)) return p;
+  }
+  return candidates[0];
+}
+function metaPeriodReportTemplatePath() {
+  return resolveSkillTemplatePath2(TEMPLATE_BASENAMES2.html);
+}
+function metaPeriodReportRuntimePath() {
+  return resolveSkillTemplatePath2(TEMPLATE_BASENAMES2.runtime);
+}
+async function readJsonFile2(filePath) {
+  const text = await fsPromises2.readFile(filePath, "utf8");
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
+  }
+}
+function asRecord6(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
+}
+function injectReportData2(html, payload) {
+  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  if (!html.includes(INJECT_MARKER)) {
+    throw new Error("\u62A5\u544A\u6A21\u677F\u7F3A\u5C11\u6570\u636E\u6CE8\u5165\u951A\u70B9\uFF0C\u8BF7\u66F4\u65B0 meta-period-report.html");
+  }
+  return html.replace(INJECT_MARKER, `window.__META_PERIOD_REPORT__ = ${json};`);
+}
+async function runFacebookAnalysisRender(opts) {
+  const dataPath = path24.resolve(opts.dataFile);
+  let data = asRecord6(await readJsonFile2(dataPath));
+  if (opts.snapshotDir?.trim()) {
+    data = await mergeFacebookSnapshotIntoReport(data, path24.resolve(opts.snapshotDir));
+  }
+  const templatePath = metaPeriodReportTemplatePath();
+  let html;
+  try {
+    html = await fsPromises2.readFile(templatePath, "utf8");
+  } catch {
+    console.error(`
+\u274C \u672A\u627E\u5230\u62A5\u544A\u6A21\u677F\uFF1A${templatePath}
+\u8BF7\u5148\u6267\u884C npm run build
+`);
+    process.exit(1);
+  }
+  const outPath = path24.resolve(
+    opts.out ?? path24.join(path24.dirname(dataPath), "meta-period-report.html")
+  );
+  const outDir = path24.dirname(outPath);
+  await fsPromises2.mkdir(outDir, { recursive: true });
+  await fsPromises2.writeFile(outPath, injectReportData2(html, data), "utf8");
+  const runtimeSrc = metaPeriodReportRuntimePath();
+  const runtimeOut = path24.join(outDir, TEMPLATE_BASENAMES2.runtime);
+  try {
+    await fsPromises2.copyFile(runtimeSrc, runtimeOut);
+  } catch {
+    console.error(`
+\u274C \u672A\u627E\u5230\u62A5\u544A\u8FD0\u884C\u65F6\uFF1A${runtimeSrc}
+\u8BF7\u5148\u6267\u884C npm run build
+`);
+    process.exit(1);
+  }
+  console.log(`
+\u2705 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+`);
+  console.log(`   \u8FD0\u884C\u65F6\u811A\u672C\uFF1A${runtimeOut}
+`);
+  console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u56FE\u8868\u4E0E\u5B8C\u6574\u7AE0\u8282\uFF08\u9700\u8054\u7F51\u52A0\u8F7D Chart.js CDN\uFF09\u3002\n");
+}
+
 // src/commands/facebook-analysis/run-batch.ts
 init_auth();
-import * as path23 from "path";
+import * as path25 from "path";
 import { performance as performance5 } from "perf_hooks";
 init_version();
 
@@ -122582,7 +122869,7 @@ async function runAllFacebookSections(opts) {
   const results = await runWithConcurrency2(tasks, concurrency);
   const succeeded = results.filter((r) => r.ok).length;
   const failed = results.length - succeeded;
-  const absoluteSnapshotDir = path23.resolve(opts.jsonOut);
+  const absoluteSnapshotDir = path25.resolve(opts.jsonOut);
   const summary = {
     kind: "siluzan-tso-facebook-analysis-snapshot-batch",
     absoluteSnapshotDir,
@@ -122602,7 +122889,7 @@ async function runAllFacebookSections(opts) {
 // src/commands/facebook-analysis/register-cli.ts
 function registerFacebookAnalysisCommands(program2) {
   const sectionHelp = FACEBOOK_SECTION_NAMES.join(", ");
-  program2.command("facebook-analysis").description(
+  const root = 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>",
@@ -122623,6 +122910,18 @@ function registerFacebookAnalysisCommands(program2) {
   ).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);
   });
+  root.command("render").description(
+    "\u6839\u636E Agent \u64B0\u5199\u7684\u62A5\u544A JSON \u751F\u6210 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u7EC8\u7A3F\uFF08meta-period-report.html\uFF09"
+  ).requiredOption("--data <file>", "Agent \u4EA7\u51FA\u7684 meta-period-report.json").option(
+    "--snapshot-dir <dir>",
+    "\u53EF\u9009\uFF1Afacebook-analysis --json-out \u76EE\u5F55\uFF0C\u81EA\u52A8\u5408\u5E76 KPI / \u56FE\u8868 / \u8868\u683C"
+  ).option("--out <file>", "\u8F93\u51FA HTML \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\uFF09").action(async (opts) => {
+    await runFacebookAnalysisRender({
+      dataFile: opts.data,
+      snapshotDir: opts.snapshotDir,
+      out: opts.out
+    });
+  });
 }
 
 // src/index.ts
@@ -122631,9 +122930,9 @@ init_cli_json_snapshot();
 installProcessHandlers();
 function getVersion() {
   try {
-    const __dirname3 = path24.dirname(fileURLToPath5(import.meta.url));
-    const pkgPath = path24.join(__dirname3, "..", "package.json");
-    const pkg = JSON.parse(fs16.readFileSync(pkgPath, "utf8"));
+    const __dirname3 = path26.dirname(fileURLToPath6(import.meta.url));
+    const pkgPath = path26.join(__dirname3, "..", "package.json");
+    const pkg = JSON.parse(fs18.readFileSync(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";