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

package/README.md

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

package/dist/index.js

@@ -102729,7 +102729,7 @@ init_dist();
 import * as fs18 from "fs";
 import * as path26 from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 
 // src/commands/login/urls.ts
 init_defaults();
@@ -106072,6 +106072,55 @@ async function writeReportAnalysisSnapshot(params) {
 
 // src/commands/report/main.ts
 init_version();
+
+// 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/report/main.ts
 async function runReportList(opts) {
   if (!VALID_MEDIA_TYPES5.includes(opts.media)) {
     console.error(`
@@ -106173,30 +106222,61 @@ function fmtNum2(n, digits = 2) {
   parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",");
   return parts.join(".");
 }
+function metaOverviewManifestId(raw) {
+  const t = raw.trim();
+  if (t.startsWith("act_")) return t.slice(4);
+  return t;
+}
+function buildMetaOverviewUrl(config, accountId, mediaAccountType, startDate, endDate) {
+  const { apiId, manifestId } = normalizeFacebookAccountId(accountId);
+  const params = new URLSearchParams({ startDate, endDate }).toString();
+  if (mediaAccountType === "FacebookAds") {
+    return facebookReportingUrl(config, apiId, "OverviewSectionData", params);
+  }
+  return `${config.apiBaseUrl}/reporting/media-account/MetaAd/${manifestId}/OverviewSectionData?${params}`;
+}
 async function runReportMetaOverview(opts) {
-  const id = opts.account.trim();
-  if (!/^\d+$/.test(id)) {
-    console.error("\n\u274C --account \u987B\u4E3A\u6570\u5B57 mediaCustomerId\uFF08\u4E0E list-accounts \u4E00\u81F4\uFF09\u3002\n");
+  const rawAccount = opts.account.trim();
+  let manifestId;
+  try {
+    manifestId = normalizeFacebookAccountId(rawAccount).manifestId;
+  } catch {
+    console.error(
+      "\n\u274C --account \u987B\u4E3A\u6570\u5B57 mediaCustomerId \u6216 act_<\u6570\u5B57>\uFF08\u4E0E list-accounts -m MetaAd \u4E00\u81F4\uFF09\u3002\n"
+    );
     process.exit(1);
   }
   const { startDate, endDate } = resolveMetaOverviewDateRange(opts.startDate, opts.endDate);
   const config = loadConfig(opts.token);
-  const params = new URLSearchParams({ startDate, endDate });
-  const url = `${config.apiBaseUrl}/reporting/media-account/MetaAd/${id}/OverviewSectionData?${params}`;
+  const accountDetail = await lookupMetaAccountForOverview(config, manifestId, opts.verbose);
+  const mediaAccountType = accountDetail?.mediaAccountType ?? "FacebookAds";
+  const url = buildMetaOverviewUrl(config, rawAccount, mediaAccountType, startDate, endDate);
   let data;
   try {
     data = await apiFetch2(url, config, {}, opts.verbose);
   } catch (err) {
-    console.error(`
-\u274C \u8BF7\u6C42\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("403")) {
+      console.error(
+        `
+\u274C \u8BF7\u6C42\u5931\u8D25\uFF1AHTTP 403
+   \u8D26\u6237 ${manifestId} \u7684 mediaAccountType=${mediaAccountType ?? "\u672A\u77E5"}\u3002
+   Facebook \u6388\u6743\u8D26\u6237\uFF08FacebookAds\uFF09\u987B\u8D70 FacebookAds/act_ \u8DEF\u5F84\uFF1B\u4E1D\u8DEF\u8D5E Meta \u5F00\u6237\u8D70 MetaAd \u8DEF\u5F84\u3002
+   \u5468\u671F/\u591A\u7EF4\u5EA6\u62A5\u544A\u8BF7\u6539\u7528\uFF1Asiluzan-tso facebook-analysis -a ${manifestId} --sections overview --json-out <dir>
+`
+      );
+    } else {
+      console.error(`
+\u274C \u8BF7\u6C42\u5931\u8D25\uFF1A${msg}
 `);
+    }
     process.exit(1);
   }
   if (opts.jsonOut) {
     const summary = await writeReportAnalysisSnapshot({
       snapshotDir: opts.jsonOut,
       section: "meta-overview",
-      accountId: id,
+      accountId: manifestId,
       dateRange: { start: startDate, end: endDate },
       payload: data,
       cliVersion: getCurrentVersion2()
@@ -106211,7 +106291,7 @@ async function runReportMetaOverview(opts) {
   const optRaw = row.optimizationScore;
   const optPct = typeof optRaw === "number" && optRaw <= 1 && optRaw >= 0 ? (optRaw * 100).toFixed(0) : typeof optRaw === "number" ? String(optRaw) : "\u2014";
   console.log(`
-\u2705 Meta \u8D26\u6237\u603B\u89C8  ${id}  \u533A\u95F4 ${startDate} ~ ${endDate}
+\u2705 Meta \u8D26\u6237\u603B\u89C8  ${manifestId}  \u533A\u95F4 ${startDate} ~ ${endDate}
 `);
   console.log(
     `   \u8D27\u5E01 ${currency}  \u4F18\u5316\u5F97\u5206 ${optPct}${typeof optRaw === "number" && optRaw <= 1 ? "%\uFF080\u20131 \u5DF2\u6362\u7B97\uFF09" : ""}  \u603B\u6D88\u8017 ${fmtNum2(typeof row.totalCost === "number" ? row.totalCost : cur.spend)}  \u4F59\u989D ${fmtNum2(typeof row.remainingAccountBudget === "number" ? row.remainingAccountBudget : void 0)}  \u6D3B\u8DC3\u5929\u6570 ${row.activeDays ?? "\u2014"}  \u65E5\u5747\u6D88\u8017 ${fmtNum2(typeof row.averageDailyCost === "number" ? row.averageDailyCost : void 0)}
@@ -106227,6 +106307,42 @@ async function runReportMetaOverview(opts) {
 function toSlashDate(date) {
   return date.replace(/-/g, "/");
 }
+async function lookupMetaAccountForOverview(config, manifestId, verbose = false) {
+  for (const idCandidate of [manifestId, `act_${manifestId}`]) {
+    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 cidDigits = metaOverviewManifestId(String(ma.mediaCustomerId ?? ""));
+        if (cidDigits === manifestId) {
+          return {
+            entityId: String(ma.entityId ?? ""),
+            mediaCustomerId: String(ma.mediaCustomerId ?? ""),
+            mediaCustomerName: String(ma.mediaCustomerName ?? ""),
+            mediaAccountType: String(ma.mediaAccountType ?? ""),
+            mediaAccountGroupId: String(ma.mediaAccountGroupId ?? "")
+          };
+        }
+      }
+    } catch {
+    }
+  }
+  return void 0;
+}
 async function lookupAccountsByCustomerIds(apiBaseUrl, config, mediaType, customerIds, verbose = false) {
   const params = new URLSearchParams({
     MediaType: mediaType,
@@ -106239,14 +106355,17 @@ async function lookupAccountsByCustomerIds(apiBaseUrl, config, mediaType, custom
     {},
     verbose
   );
-  const idSet = new Set(customerIds.map((id) => id.trim()));
+  const idSet = new Set(
+    customerIds.map((id) => metaOverviewManifestId(id.trim())).filter(Boolean)
+  );
   const result = /* @__PURE__ */ new Map();
   const items = Array.isArray(data) ? data : [];
   for (const item of items) {
     const ma = item.ma ?? {};
     const cid = String(ma.mediaCustomerId ?? "");
-    if (idSet.has(cid)) {
-      result.set(cid, {
+    const cidDigits = metaOverviewManifestId(cid);
+    if (idSet.has(cidDigits)) {
+      result.set(cidDigits, {
         entityId: String(ma.entityId ?? ""),
         mediaCustomerId: cid,
         mediaCustomerName: String(ma.mediaCustomerName ?? ""),
@@ -107480,7 +107599,9 @@ function register13(program2) {
       verbose: opts.verbose
     });
   });
-  reportCmd.command("meta-overview").description("Meta \u8D26\u6237\u5206\u6790\u603B\u89C8\uFF08OverviewSectionData\uFF0C\u9700 tsoApiBaseUrl \u9274\u6743\uFF09").requiredOption("-a, --account <id>", "Meta \u5E7F\u544A\u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("--token <token>", "Auth Token").option(
+  reportCmd.command("meta-overview").description(
+    "Meta \u8D26\u6237\u5206\u6790\u603B\u89C8\uFF08OverviewSectionData\uFF1BFacebookAds \u6388\u6743\u6237\u8D70 FacebookAds/act_\uFF0CMetaAd \u5F00\u6237\u8D70 MetaAd\uFF09"
+  ).requiredOption("-a, --account <id>", "Meta \u5E7F\u544A\u8D26\u6237 mediaCustomerId\uFF08\u6570\u5B57\u6216 act_<\u6570\u5B57>\uFF09").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("--token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\u76EE\u5F55\u5E76\u66F4\u65B0 report-manifest[-<accountId>].json\uFF1B\u6587\u4EF6\u540D\u4E3A `<section>[-<accountId>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09"
   ).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
@@ -121435,6 +121556,8 @@ function register25(program2) {
     console.log("    CLI \u62C9\u6570\uFF1A");
     console.log("      siluzan-tso website-diagnosis collect --url <url> --json-out ./snap-web");
     console.log("      siluzan-tso website-diagnosis performance --url <url> --json-out ./snap-web");
+    console.log("    \u9ED8\u8BA4\u4EA4\u4ED8 HTML\uFF1A");
+    console.log("      siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json");
     console.log("    Skill\uFF1Areferences/analytics/website-diagnosis-guide.md\n");
     console.log("  \u3010\u8D26\u6237\u5217\u8868 ARIT \u5206\u3011");
     console.log("    list-accounts \u4F1A\u8865\u5145 ma.diagnoseReports \u4E2D reportSource=ARIT \u7684\u5F97\u5206\uFF1B");
@@ -121633,7 +121756,7 @@ async function runWebsiteDiagnosisCollect(opts) {
     htmlPreview,
     ...htmlFull ? { htmlContent: htmlFull } : {},
     ...htmlError ? { htmlError } : {},
-    agentHint: "1) \u6309 website-diagnosis-rules.md \u751F\u6210\u8BCA\u65AD JSON\uFF1B2) siluzan-tso website-diagnosis render --data <diagnosis.json> --collect <\u672C\u6587\u4EF6> \u8F93\u51FA\u5E26\u56FE\u8868\u7684 website-diagnosis-report.html\u3002"
+    agentHint: "1) \u6309 website-diagnosis-rules.md \u751F\u6210\u8BCA\u65AD JSON\uFF1B2) siluzan-tso website-diagnosis render --data <diagnosis.json> --collect <\u672C\u6587\u4EF6> \u9ED8\u8BA4\u4EA7\u51FA HTML \u7EC8\u7A3F website-diagnosis-report.html\uFF08\u7981\u6B62\u4EC5 Markdown/JSON \u4EA4\u4ED8\uFF09\u3002"
   };
   if (await emitCliJsonOrSnapshot(
     { jsonOut: opts.jsonOut },
@@ -121756,7 +121879,7 @@ async function runWebsiteDiagnosisRender(opts) {
 // src/commands/website-diagnosis/register.ts
 function registerWebsiteDiagnosisCommands(program2) {
   const root = program2.command("website-diagnosis").description(
-    "\u7F51\u7AD9\u8BCA\u65AD\uFF1ALighthouse \u6027\u80FD\u3001HTML \u91C7\u96C6\uFF08Agent download-assets\uFF09\u3001ARIT \u5386\u53F2\u5F97\u5206\u67E5\u8BE2"
+    "\u7F51\u7AD9\u8BCA\u65AD\uFF1ALighthouse \u6027\u80FD\u3001HTML \u91C7\u96C6\u3001ARIT \u5386\u53F2\u5F97\u5206\uFF1B\u9ED8\u8BA4\u4EA4\u4ED8 HTML \u62A5\u544A\uFF08render \u5B50\u547D\u4EE4\uFF09"
   );
   root.command("performance").description("\u62C9\u53D6 Lighthouse \u6027\u80FD\u6570\u636E\uFF08GET WebsiteDiagnosisReports/performance\uFF09").requiredOption("--url <url>", "\u7F51\u7AD9 URL\uFF08\u53EF\u7701\u7565 https://\uFF0C\u81EA\u52A8\u8865\u5168\uFF09").option("--token <token>", "JWT\uFF08\u9ED8\u8BA4\u8BFB config / \u73AF\u5883\u53D8\u91CF\uFF09").option("--verbose", "\u6253\u5370\u8BF7\u6C42\u8BE6\u60C5").option("--json-out <dir>", "\u843D\u76D8 cli-manifest + JSON").action(async (opts) => {
     await runWebsiteDiagnosisPerformance({
@@ -121789,7 +121912,7 @@ function registerWebsiteDiagnosisCommands(program2) {
     }
   );
   root.command("render").description(
-    "\u6839\u636E\u8BCA\u65AD JSON \u751F\u6210\u5E26\u56FE\u8868\u7684\u5355\u6587\u4EF6 HTML \u62A5\u544A\uFF08website-diagnosis-report.html\uFF09"
+    "\u6839\u636E\u8BCA\u65AD JSON \u751F\u6210 HTML \u7EC8\u7A3F\uFF08\u9ED8\u8BA4\u4EA4\u4ED8\u683C\u5F0F\uFF0Cwebsite-diagnosis-report.html\uFF09"
   ).requiredOption("--data <file>", "\u8BCA\u65AD\u7ED3\u679C JSON\uFF08getWebsiteDiagnosisData \u540C\u7ED3\u6784\uFF09").option("--collect <file>", "\u53EF\u9009\uFF1Acollect \u843D\u76D8 JSON\uFF0C\u7528\u4E8E\u5408\u5E76 lighthouse").option("--out <file>", "\u8F93\u51FA HTML \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\uFF09").action(async (opts) => {
     await runWebsiteDiagnosisRender({
       dataFile: opts.data,
@@ -122429,52 +122552,8 @@ var FACEBOOK_SECTION_ALIASES = {
   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/register-cli.ts
+import { Command } from "commander";
 
 // src/commands/facebook-analysis/render-report.ts
 import fs17 from "fs";
@@ -122746,20 +122825,19 @@ async function runFacebookAnalysisRender(opts) {
   await fsPromises2.writeFile(outPath, injectReportData2(html, data), "utf8");
   const runtimeSrc = metaPeriodReportRuntimePath();
   const runtimeOut = path24.join(outDir, TEMPLATE_BASENAMES2.runtime);
+  let runtimeCopied = false;
   try {
     await fsPromises2.copyFile(runtimeSrc, runtimeOut);
+    runtimeCopied = true;
   } 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}
+  if (runtimeCopied) {
+    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");
 }
 
@@ -122887,10 +122965,9 @@ async function runAllFacebookSections(opts) {
 }
 
 // src/commands/facebook-analysis/register-cli.ts
-function registerFacebookAnalysisCommands(program2) {
-  const sectionHelp = FACEBOOK_SECTION_NAMES.join(", ");
-  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"
+function registerBatchCommand(sectionHelp) {
+  return new Command("run").description(
+    "\u6279\u91CF\u62C9\u53D6 TSO reporting/media-account/FacebookAds Section \u6570\u636E\uFF08\u7701\u7565\u5B50\u547D\u4EE4\u540D\u65F6\u9ED8\u8BA4\u6267\u884C\u672C\u547D\u4EE4\uFF09"
   ).requiredOption(
     "-a, --account <id>",
     "Facebook \u5E7F\u544A\u8D26\u6237 mediaCustomerId\uFF08\u6570\u5B57\u6216 act_<\u6570\u5B57>\uFF09"
@@ -122910,6 +122987,13 @@ 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);
   });
+}
+function registerFacebookAnalysisCommands(program2) {
+  const sectionHelp = FACEBOOK_SECTION_NAMES.join(", ");
+  const root = program2.command("facebook-analysis").description(
+    "Facebook Ads \u8D26\u6237\u5206\u6790\uFF1A\u6279\u91CF\u62C9\u53D6 Section \u6570\u636E\uFF08\u9ED8\u8BA4\uFF09\uFF0C\u6216\u7531 render \u751F\u6210 HTML \u5468\u671F\u62A5\u544A"
+  );
+  root.addCommand(registerBatchCommand(sectionHelp), { isDefault: true });
   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(
@@ -122938,7 +123022,7 @@ function getVersion() {
     return "0.0.0";
   }
 }
-var program = new Command();
+var program = new Command2();
 program.name("siluzan-tso").description(
   "Siluzan \u5E7F\u544A\u8D26\u6237\u7BA1\u7406\uFF1A\u8D26\u6237\u67E5\u8BE2\u3001\u4F59\u989D\u3001\u6295\u653E\u6570\u636E\u3001\u5F00\u6237\u7533\u8BF7\uFF08Google/TikTok/Yandex/Bing/Kwai\uFF09\u3001\n\u8D26\u53F7\u5206\u4EAB/\u89E3\u7ED1\u3001\u4F18\u5316\u62A5\u544A\u3001Google \u8D26\u6237\u5206\u6790\u7F51\u5173\uFF08google-analysis\uFF09\u3001\u7F51\u7AD9\u8BCA\u65AD\uFF08website-diagnosis\uFF09\u3001\u6218\u7565\u5E02\u573A\u5206\u6790\uFF08market-analysis\uFF0CAgent \u751F\u6210\u62A5\u544A\uFF09\u3001\u5145\u503C\u8F6C\u8D26\u3001\u5F00\u7968\u3001\u667A\u80FD\u9884\u8B66\u3001Google \u5E7F\u544A\u7BA1\u7406\uFF08\u542B\u5F02\u6B65\u6279\u91CF\uFF09\u3002"
 ).version(getVersion());

package/dist/skill/SKILL.md

@@ -19,6 +19,8 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 >
 > **报告/Excel 交付前**：Read `references/core/deliverable-preflight.md`，**Read 最终产物**并按自检表确认币种与章节完整；币种只认当次 `list-accounts` 的 `currencyCode`。
 >
+> **HTML 终稿类报告（用户未指定格式时默认 HTML）**：网站诊断 P8（`website-diagnosis render`）、Meta 周期 P4-FB（`facebook-analysis render`）、战略市场 P9（`market-analysis render`）。Agent 只写 JSON，**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
+>
 > **开户**：首次进入开户话题须先向用户罗列该媒体（或未指明媒体时六平台）**全部必填项**，见 `references/accounts/open-account-by-media.md` §「首次响应硬规范」。
 >
 > **Subagent（可选）**：若宿主支持 Task / 子会话，复杂报告（P5/P6/P7）或长 CLI 输出前 Read `references/core/subagent-orchestration.md`，**自行决定**是否委派；写操作确认与对用户的最终交付留在主 Agent。
@@ -84,10 +86,10 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | 用户意图（关键词） | 必读（Read 后再 `-h` / 执行） |
 | ------------------ | ----------------------------- |
 | 任意任务（首次） | `core/agent-conventions.md` |
-| 账户列表 / 余额 / 消耗 / 分享 / MCC / 多账户汇总 | `accounts/accounts.md`；金额加 `accounts/currency.md` |
+| 账户列表 / 有多少 / 列出全部 / 余额 / 消耗 / 分享 / MCC | `accounts/accounts.md`（§ list-accounts **Agent 意图速查**：`-m <媒体> --page-size 999 --json-out` 一步拉全）；金额加 `accounts/currency.md` |
 | google ads 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md` + **`core/deliverable-preflight.md`**；多账户加 `analytics/google-analysis-batch.md` |
-| Meta/Facebook 周期或诊断报告 / `facebook-analysis` | `report-templates/meta-period-report-excel.md`（Excel 五 Sheet 基准）+ `meta-period-report.md` + `analytics/facebook-analysis-guide.md`；Agent 写 `meta-period-report.json`，`facebook-analysis render` 出 HTML |
-| 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `core/playbooks.md` P8；Agent 只写 JSON，`website-diagnosis render` 出 HTML |
+| Meta/Facebook 周期或诊断报告 / `facebook-analysis` | **默认 HTML**：`meta-period-report.md` + **`assets/meta-period-report-rules.md`**（内容丰富度必读）+ `facebook-analysis-guide.md` + `deliverable-preflight.md` → 拉数 → 分析 → JSON（4 条建议≥150字+7维补充+HTML扩展）→ `render`；**仅用户要 Excel** 时加读 `meta-period-report-excel.md` |
+| 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `core/playbooks.md` P8 + `core/deliverable-preflight.md`；Agent 只写 JSON，**默认交付** `website-diagnosis render` 产出的 **HTML**（禁止仅 Markdown/JSON） |
 | 市场分析 / 行业分析 / 战略市场报告 / `market-analysis` | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `report-templates/market-analysis-report.md` + `core/playbooks.md` P9；`collect` → Agent 按维度调研写 `market-report.json` → `render`（缺项校验） |
 | Google 新建搜索系列 | `google-ads/google-ads-campaign-plan.md` |
 | Google 广告 CRUD / 拒审 | `google-ads/google-ads.md` |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.28-beta.1",
-  "publishedAt": 1780888059129
+  "version": "1.1.28-beta.3",
+  "publishedAt": 1780909080666
 }

package/dist/skill/assets/meta-period-report-rules.md

@@ -0,0 +1,169 @@
+# Meta 周期报告撰写规则（Agent 用）
+
+> 对齐 **P8 网站诊断** 的「结构化 + 全量覆盖 + 每条必有建议」思路。  
+> 源：业务 Excel 模板（`无锡顺晟Facebook4月报告.xlsx`）+ `meta-period-report.html` 深度分析章节。  
+> **禁止**只写 KPI 表、4 条一句话建议或空白占位后交付。
+
+---
+
+## 与网站诊断的对照（为何 FB 报告会显得「建议太少」）
+
+| 网站诊断（P8） | Meta 周期报告（P4-FB） |
+| -------------- | ---------------------- |
+| `website-diagnosis-rules.md` 规定 29 子项全覆盖 | 本文件规定 **5 维数据 + 叙事 + 建议** 全覆盖 |
+| 每项 `issue` + `suggestion`（较差项以「强烈建议：」开头） | 每条建议 `content` 须 **引用当次数字** + **可执行动作** |
+| `coreIssuesIds` + `PriorityPlan` 高/中/低 | `priorityPlan` + `narrative.recommendations` 4 条 + `supplementaryRecommendations` |
+| HTML 由 `render` 渲染全部章节 | HTML **必须**填 `executiveSummary`、`healthDiagnosis`、`sections.*.insight` 等（见下） |
+| 交付前 Read HTML 对照章节清单 | 交付前 Read HTML/xlsx 对照 `deliverable-preflight.md` § P4-FB |
+
+**常见失误（导致建议偏少）**：
+
+1. 只写 Excel 叙事 4 条标题、每条 1～2 句泛化话术，未引用 CPL/花费/国家名。
+2. HTML 默认路径只填 `narrative`，**未填** `executiveSummary` / `healthDiagnosis` / `sections.insight`（模板原先不展示 `narrative.recommendations`，现已修复）。
+3. 未按 **7 维数据驱动清单** 逐条给建议，只写「优化素材」「调整预算」等空话。
+
+---
+
+## JSON 结构（摘要）
+
+完整 Schema：`assets/meta-period-report.schema.json`。  
+**Excel 与 HTML 共用** `narrative`；**HTML 默认交付**还须填「深度分析扩展」字段。
+
+---
+
+## 一、Excel / 总数据叙事（`narrative` · 必填）
+
+### 1. `narrative.overall`（整体表现）
+
+| 要求 | 细则 |
+| ---- | ---- |
+| 字数 | **≥ 120 字**（中文） |
+| 必含数字 | 花费、`results`、CPL（`costPerResult`）、`reach`、`impressions`、`frequency` **至少 5 项** |
+| 必含口径 | `resultType`、`attributionSetting`（写入 `meta` 并在段中提及） |
+| 可选 | 若有 `previousPeriod`，写 1～2 句环比（花费 ±%、CPL ±%） |
+
+### 2. `narrative.regional[]`（区域 / 广告组）
+
+| 要求 | 细则 |
+| ---- | ---- |
+| 条数 | **每个** `ad-sets` 中花费 >0 的广告组 **各 1 段**（不得合并成 1 句带过） |
+| 字数 | 每段 **≥ 80 字** |
+| 必含 | 组名、花费占比或绝对值、线索数、`costPerResult`、频次；判断「曝光不足 / 频次过高 / 效率领先」 |
+| 数据依据 | `ad-sets-<id>.json` → `adGroups[]` |
+
+### 3. `narrative.country`（国家报告）
+
+| 要求 | 细则 |
+| ---- | ---- |
+| 字数 | **≥ 80 字** |
+| 必含 | CPL **最低** 与 **最高** 国家名及具体 CPL；中间梯队 1～2 国；花费集中度 |
+| 数据依据 | `country-<id>.json` → `countries[]` |
+
+### 4. `narrative.recommendations[]`（固定 4 条标题）
+
+**必须恰好 4 条**，`title` 仅限下表枚举；`content` 须**数据驱动**，不得模板空话。
+
+| title | content 最低要求（每条 **≥ 150 字**） |
+| ----- | ------------------------------------- |
+| **简化表单问题** | 结合 **高频次 + 高 CPL** 的国家/组（写出名称与数字）；建议字段从 N 减到 3；说明预期对 CPL 的影响 |
+| **区域调整** | 按 **具体广告组** 写语言/市场策略（如土/葡/德）；引用各组 CPL 对比；写清「加谁、减谁、暂停谁」 |
+| **预算重构** | 给出 **具体比例**（如 4:3:3 或按 spend 占比调整）；测试周期（7/14 天）；优胜劣汰阈值（CPL > 账户均值 ×1.2 则减 30%） |
+| **素材建议** | 按 **平台**（IG/FB）与 **国家** 分述；素材套数、视频时长、形态；至少点名 1 个高花费低结果创意/版位 |
+
+**建议前缀（对齐网站诊断）**：
+
+- 问题严重（CPL > 均值 1.3 倍、频次 >2.5、零成效花费 >$50）→ `content` 以 **「强烈建议：」** 开头  
+- 其余优化项 → **「推荐优化：」** 开头  
+
+---
+
+## 二、数据驱动补充建议（`supplementaryRecommendations` · 必填）
+
+在 4 条固定标题之外，**必须**再写 **7 维清单**，每条 `{ "dimension", "issue", "suggestion" }`：
+
+| dimension | issue（发现了什么） | suggestion（怎么办） |
+| --------- | ------------------- | -------------------- |
+| 预算与广告组 | 点名高 `spendPercentage`、差 `costPerResult` 的组 | 降预算 %、暂停、或合并受众 |
+| 平台与版位 | `publisherPlatform` + `platformPosition` 组合 | 减投差版位、加码 winner 平台 |
+| 地域 | 高消耗低结果国家 | geo 排除 / 收窄 / 单独组 |
+| 受众 | 低效 age×gender | 排除或降 bid；扩量高效段 |
+| 创意 | 高花费低 `results` 的 ad | 关停、复制 winner 结构 |
+| 频次与疲劳 | `frequency` >2.5 且转化差 | 扩受众、换创意、降预算 |
+| 接口限制 | 无按日/关键词等 | 一句说明「Meta 接口未提供」，**禁止编造** |
+
+每条 `suggestion` **≥ 60 字**，须含 **至少 1 个当次数字或名称**。
+
+---
+
+## 三、优先级改进计划（`priorityPlan` · HTML 必填 · Excel 推荐）
+
+对齐网站诊断 `PriorityPlan`：
+
+```jsonc
+{
+  "priorityPlan": {
+    "high": ["…", "…"],    // ≥2 条，本周必须做
+    "medium": ["…", "…"],  // ≥2 条
+    "low": ["…", "…"]      // ≥2 条，持续优化
+  }
+}
+```
+
+每条 **≥ 40 字**，带责任维度（预算/素材/地域等）。
+
+---
+
+## 四、HTML 默认交付 · 深度分析扩展（必填）
+
+用户未指定 Excel 时，除 §一～§三外 **还必须** 填写：
+
+| 字段 | 最低要求 |
+| ---- | -------- |
+| `executiveSummary` | **3～5 段**，每段 **≥ 80 字**；解释「为什么」而不只报数；可拆自 `narrative.overall` 但须加深因果 |
+| `healthDiagnosis.lifecyclePhase` | `test-market` / `find-winner` / `scale` 三选一 |
+| `healthDiagnosis.lifecycleVerdict` | **≥ 60 字**，结合总花费与维度分散度 |
+| `healthDiagnosis.fourQuestions` | **恰好 4 张卡片**（钱花得值不值 / 赢在哪 / 输在哪 / 下月重点） |
+| 每张 `fourQuestions[]` | `verdict` + `evidence` **≥2 条**（含数字）+ `action` **≥ 40 字** |
+| `healthDiagnosis.scorecard` | **≥ 6 行**（平台、国家、广告组、受众等分项红绿灯） |
+| `sections.platform.insight` | **≥ 200 字** |
+| `sections.country.insight` | **≥ 200 字** |
+| `sections.adSets.insight` | **≥ 200 字** |
+| `sections.audience` | `goldenProfile` **≥3 条** + `antiProfile` **≥2 条** + `insight` **≥ 150 字** |
+| `sections.landingPage.rows` | **≥ 3 行**（心理阻碍 / 数据信号 / 推演 / 优先级） |
+| `abTests` | **≥ 3 个**实验（变量、假设、成功标准） |
+| `actionChecklist` | `today` **≥2**、`thisWeek` **≥3**、`thisMonth` **≥3** 条可执行项 |
+
+**禁止**：HTML 中大量「（待 Agent 撰写）」占位；交付前 Read HTML 确认无空节。
+
+---
+
+## 五、撰写流程（对齐 P8）
+
+1. **拉数**：`facebook-analysis` + `--json-out`（默认 5 维）。
+2. **脚本读盘**：聚合 KPI、Top/Bottom 国家、平台、受众、广告组（禁止 Read 业务 JSON 进对话）。
+3. **先 outline 后 JSON**：列出将引用的数字与 7 维建议要点，再写 `meta-period-report.json`。
+4. **渲染**：`facebook-analysis render`（HTML）或脚本写 xlsx（Excel）。
+5. **Read 终稿**：对照 `deliverable-preflight.md` § P4-FB。
+
+---
+
+## 六、自检清单（Agent 交付前勾选）
+
+- [ ] `narrative.recommendations` 4 条，每条 content ≥150 字且含真实数字
+- [ ] `supplementaryRecommendations` 7 维齐全
+- [ ] `priorityPlan` high/medium/low 各 ≥2 条
+- [ ] HTML：`executiveSummary` ≥3 段、`fourQuestions` =4、`scorecard` ≥6 行
+- [ ] HTML：`sections.platform/country/adSets.insight` 各 ≥200 字
+- [ ] HTML：`actionChecklist` 三列非空；`abTests` ≥3
+- [ ] Excel：总数据 Sheet 叙事块 4 节齐全，无 1 句话敷衍
+- [ ] 未编造 Meta 无接口维度（按日、关键词等）
+
+---
+
+## 相关文档
+
+- `report-templates/meta-period-report.md` — 流程与章节
+- `report-templates/meta-period-report-excel.md` — Excel 五 Sheet
+- `references/analytics/facebook-analysis-guide.md` — API 字段
+- `references/core/deliverable-preflight.md` — 交付审阅
+- `assets/website-diagnosis-rules.md` — 网站诊断（对照参考）

package/dist/skill/assets/meta-period-report.schema.json

@@ -60,8 +60,9 @@
         },
         "recommendations": {
           "type": "array",
-          "description": "优化建议固定 4 条",
-          "minItems": 1,
+          "description": "优化建议固定 4 条；每条 content ≥150 字且引用当次数据（见 meta-period-report-rules.md）",
+          "minItems": 4,
+          "maxItems": 4,
           "items": {
             "type": "object",
             "required": ["title", "content"],
@@ -70,12 +71,39 @@
                 "type": "string",
                 "enum": ["简化表单问题", "区域调整", "预算重构", "素材建议"]
               },
-              "content": { "type": "string" }
+              "content": {
+                "type": "string",
+                "description": "≥150 字；严重问题以「强烈建议：」开头，其余以「推荐优化：」开头"
+              }
             }
           }
         }
       }
     },
+    "supplementaryRecommendations": {
+      "type": "array",
+      "description": "7 维数据驱动补充建议（预算/平台/地域/受众/创意/频次/接口限制）；每条 suggestion ≥60 字",
+      "minItems": 7,
+      "maxItems": 7,
+      "items": {
+        "type": "object",
+        "required": ["dimension", "issue", "suggestion"],
+        "properties": {
+          "dimension": { "type": "string" },
+          "issue": { "type": "string" },
+          "suggestion": { "type": "string" }
+        }
+      }
+    },
+    "priorityPlan": {
+      "type": "object",
+      "description": "高/中/低优先级改进计划（对齐网站诊断 PriorityPlan）",
+      "properties": {
+        "high": { "type": "array", "items": { "type": "string" }, "minItems": 2 },
+        "medium": { "type": "array", "items": { "type": "string" }, "minItems": 2 },
+        "low": { "type": "array", "items": { "type": "string" }, "minItems": 2 }
+      }
+    },
     "tables": {
       "type": "object",
       "description": "Sheet2～5 表格数据；可省略，由 --snapshot-dir 合并",
@@ -106,11 +134,12 @@
     "executiveSummary": {
       "type": "array",
       "items": { "type": "string" },
-      "description": "HTML 深度分析扩展：多段执行摘要（可选，优先用 narrative.overall）"
+      "minItems": 3,
+      "description": "HTML 默认交付必填：3～5 段执行摘要，每段 ≥80 字；可深化 narrative.overall"
     },
     "healthDiagnosis": {
       "type": "object",
-      "description": "HTML 深度分析扩展：账户健康诊断（Excel 不含）",
+      "description": "HTML 默认交付必填：四问卡片 + 红绿灯表（Excel 不含）",
       "properties": {
         "lifecyclePhase": { "enum": ["test-market", "find-winner", "scale"] },
         "lifecycleVerdict": { "type": "string" },