siluzan-tso-cli 1.1.29-beta.4 → 1.1.29-beta.5

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.29-beta.4），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.29-beta.5），供内部测试使用。正式发布后安装命令将改为 `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 num2 = +id;
-              if (num2 >= 0 && num2 < MAX_SAFE_INTEGER) {
-                return num2;
+              const num4 = +id;
+              if (num4 >= 0 && num4 < MAX_SAFE_INTEGER) {
+                return num4;
               }
             }
             return id;
@@ -123395,13 +123395,297 @@ import { fileURLToPath as fileURLToPath5 } from "url";
 // src/commands/facebook-analysis/merge-snapshot.ts
 import * as fs16 from "fs/promises";
 import * as path23 from "path";
+
+// src/commands/facebook-analysis/lifecycle-autofill.ts
+var LIFECYCLE_PHASES = ["test-market", "find-winner", "scale"];
+var PHASE_LABEL = {
+  "test-market": "\u6D4B\u5E02\u573A",
+  "find-winner": "\u627E\u8D62\u5BB6",
+  scale: "\u653E\u91CF"
+};
+function num(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
+function money(value, currency = "USD") {
+  if (value == null) return "\u2014";
+  const sym = currency === "USD" ? "$" : "";
+  return `${sym}${value.toFixed(2)}`;
+}
+function adSetsWithSpend(tables) {
+  const rows = Array.isArray(tables?.adSets) ? tables.adSets : [];
+  return rows.filter((r) => (num(r.spend) ?? 0) > 0);
+}
+function topAdSetConcentration(adSets) {
+  if (!adSets.length) return null;
+  const totalSpend = adSets.reduce((s, r) => s + (num(r.spend) ?? 0), 0);
+  const totalResults = adSets.reduce((s, r) => s + (num(r.results) ?? 0), 0);
+  let best = adSets[0];
+  let bestSpend = num(best.spend) ?? 0;
+  for (const r of adSets) {
+    const sp = num(r.spend) ?? 0;
+    if (sp > bestSpend) {
+      best = r;
+      bestSpend = sp;
+    }
+  }
+  const results = num(best.results) ?? 0;
+  return {
+    name: String(best.adGroupName ?? best.name ?? "\u2014"),
+    spendShare: totalSpend > 0 ? bestSpend / totalSpend : 0,
+    resultsShare: totalResults > 0 ? results / totalResults : 0,
+    cpl: num(best.costPerResult)
+  };
+}
+function winnerSpendShare(adSets, avgCpl, totalSpend) {
+  if (totalSpend <= 0 || avgCpl <= 0) return 0;
+  const winnerSpend = adSets.filter((r) => {
+    const cpl = num(r.costPerResult);
+    return cpl != null && cpl <= avgCpl * 0.9;
+  }).reduce((s, r) => s + (num(r.spend) ?? 0), 0);
+  return winnerSpend / totalSpend;
+}
+function countActiveDimensions(charts, tables) {
+  let n = 0;
+  const platform = charts?.platform;
+  if (asArray(platform?.labels).length > 0) n += 1;
+  const country = charts?.country;
+  if (asArray(country?.labels).length > 0) n += 1;
+  n += adSetsWithSpend(tables).length;
+  return n;
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function inferLifecyclePhase(input) {
+  const { avgCpl, currency = "USD" } = input;
+  const spend = num(input.spend) ?? 0;
+  const adSets = adSetsWithSpend(input.tables);
+  const activeDims = countActiveDimensions(input.charts, input.tables);
+  const winShare = winnerSpendShare(adSets, avgCpl, spend);
+  const top = topAdSetConcentration(adSets);
+  const reasons = [];
+  reasons.push(`\u603B\u82B1\u8D39 ${money(spend, currency)}\uFF0C\u6D3B\u8DC3\u6295\u653E\u7EF4\u5EA6\u7EA6 ${activeDims} \u4E2A`);
+  if (winShare > 0) reasons.push(`CPL \u4F18\u4E8E\u5747\u503C\u7684\u7EF4\u5EA6\u82B1\u8D39\u5360\u6BD4\u7EA6 ${Math.round(winShare * 100)}%`);
+  if (top) {
+    reasons.push(
+      `Top \u5E7F\u544A\u7EC4\u300C${top.name}\u300D\u82B1\u8D39\u5360\u6BD4 ${Math.round(top.spendShare * 100)}%\u3001CPL ${money(top.cpl, currency)}`
+    );
+  }
+  let phase = "find-winner";
+  const lowSpendProbe = spend > 0 && spend < 200;
+  const dispersedNoWinner = activeDims >= 4 && winShare < 0.35;
+  const concentratedWinner = top != null && (top.spendShare >= 0.55 || top.resultsShare >= 0.55) && top.cpl != null && avgCpl > 0 && top.cpl <= avgCpl * 1.05;
+  if (lowSpendProbe || dispersedNoWinner) {
+    phase = "test-market";
+    if (lowSpendProbe) reasons.push("\u603B\u82B1\u8D39\u4ECD\u5904\u4E8E\u8BD5\u63A2\u533A\u95F4");
+    if (dispersedNoWinner) reasons.push("\u591A\u56FD/\u591A\u7EC4\u5206\u6563\u4E14\u5C1A\u672A\u5F62\u6210\u7A33\u5B9A\u8D62\u5BB6");
+  } else if (concentratedWinner) {
+    phase = "scale";
+    reasons.push("\u9884\u7B97\u5DF2\u660E\u663E\u5411\u9AD8\u6548\u5E7F\u544A\u7EC4\u96C6\u4E2D\uFF0C\u9002\u5408\u653E\u91CF");
+  } else {
+    phase = "find-winner";
+    reasons.push("\u5DF2\u51FA\u73B0\u4F18\u52A3\u5206\u5316\uFF0C\u4F46\u9884\u7B97\u5C1A\u672A\u9AD8\u5EA6\u96C6\u4E2D");
+  }
+  const label = PHASE_LABEL[phase];
+  const verdict = `${reasons.join("\uFF1B")}\u3002\u7EFC\u5408\u5224\u65AD\u8D26\u6237\u5904\u4E8E\u300C${label}\u300D\u9636\u6BB5\uFF0C\u5EFA\u8BAE\u6309\u8BE5\u9636\u6BB5\u7B56\u7565\u8C03\u6574\u9884\u7B97\u4E0E\u7ED3\u6784\u3002`;
+  return { phase, verdict, reasons };
+}
+function textLen(value) {
+  return typeof value === "string" ? value.trim().length : 0;
+}
+function isValidPhase(value) {
+  return typeof value === "string" && LIFECYCLE_PHASES.includes(value);
+}
+function ensureLifecycleFromSnapshot(healthDiagnosis, merged) {
+  const hd = { ...healthDiagnosis ?? {} };
+  const inferred = inferLifecyclePhase(merged);
+  hd.lifecyclePhaseInferred = inferred.phase;
+  const agentPhase = hd.lifecyclePhase;
+  const agentVerdict = hd.lifecycleVerdict;
+  if (!isValidPhase(agentPhase)) {
+    hd.lifecyclePhase = inferred.phase;
+    hd.lifecyclePhaseAutofilled = true;
+    if (textLen(agentVerdict) < 60) {
+      hd.lifecycleVerdict = inferred.verdict;
+      hd.lifecycleVerdictAutofilled = true;
+    }
+  } else if (textLen(agentVerdict) < 60) {
+    hd.lifecycleVerdict = inferred.verdict;
+    hd.lifecycleVerdictAutofilled = true;
+  }
+  return hd;
+}
+
+// src/commands/facebook-analysis/scorecard-autofill.ts
+function num2(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
+function money2(value, currency = "USD") {
+  if (value == null) return "\u2014";
+  const sym = currency === "USD" ? "$" : "";
+  return `${sym}${value.toFixed(2)}`;
+}
+function cplSignal(cpl, avg) {
+  if (cpl == null || avg <= 0) {
+    return { signal: "yellow", signalLabel: "\u89C2", advice: "\u6837\u672C\u4E0D\u8DB3\uFF0C\u89C2\u5BDF 7 \u5929" };
+  }
+  if (cpl <= avg * 0.9) {
+    return { signal: "green", signalLabel: "\u52A0", advice: "\u52A0\u7801\u9884\u7B97\u6216\u6269\u91CF" };
+  }
+  if (cpl >= avg * 1.15) {
+    return { signal: "red", signalLabel: "\u51CF", advice: "\u9650\u6D41\u3001\u51CF\u9884\u7B97\u6216\u6682\u505C" };
+  }
+  return { signal: "yellow", signalLabel: "\u89C2", advice: "\u7EF4\u6301\u89C2\u5BDF\uFF0C7 \u5929\u540E\u590D\u76D8" };
+}
+function pushRow(rows, seen, row) {
+  const key = row.item.trim();
+  if (!key || seen.has(key)) return;
+  seen.add(key);
+  rows.push(row);
+}
+function buildScorecardFromMergedData(input) {
+  const { avgCpl, currency = "USD" } = input;
+  const charts = input.charts ?? {};
+  const tables = input.tables ?? {};
+  const rows = [];
+  const seen = /* @__PURE__ */ new Set();
+  const platform = charts.platform;
+  const pLabels = Array.isArray(platform?.labels) ? platform.labels : [];
+  const pCpl = Array.isArray(platform?.cpl) ? platform.cpl : [];
+  const pSpend = Array.isArray(platform?.spend) ? platform.spend : [];
+  if (pLabels.length) {
+    const indexed = pLabels.map((label, i) => ({
+      label: String(label),
+      cpl: num2(pCpl[i]),
+      spend: num2(pSpend[i]) ?? 0
+    })).filter((x) => x.spend > 0 || x.cpl != null && x.cpl > 0);
+    const sorted = [...indexed].sort((a, b) => (a.cpl ?? Infinity) - (b.cpl ?? Infinity));
+    if (sorted[0]) {
+      const s = cplSignal(sorted[0].cpl, avgCpl);
+      pushRow(rows, seen, {
+        item: `\u5E73\u53F0\xB7${sorted[0].label}`,
+        data: `CPL ${money2(sorted[0].cpl, currency)}`,
+        ...s
+      });
+    }
+    if (sorted.length > 1) {
+      const worst = sorted[sorted.length - 1];
+      const s = cplSignal(worst.cpl, avgCpl);
+      pushRow(rows, seen, {
+        item: `\u5E73\u53F0\xB7${worst.label}`,
+        data: `CPL ${money2(worst.cpl, currency)}`,
+        ...s
+      });
+    }
+  }
+  const country = charts.country;
+  const cLabels = Array.isArray(country?.labels) ? country.labels : [];
+  const cCpl = Array.isArray(country?.cpl) ? country.cpl : [];
+  if (cLabels.length) {
+    const indexed = cLabels.map((label, i) => ({ label: String(label), cpl: num2(cCpl[i]) })).filter((x) => x.cpl != null && x.cpl > 0);
+    const sorted = [...indexed].sort((a, b) => (a.cpl ?? 0) - (b.cpl ?? 0));
+    if (sorted[0]) {
+      const s = cplSignal(sorted[0].cpl, avgCpl);
+      pushRow(rows, seen, {
+        item: String(sorted[0].label),
+        data: `CPL ${money2(sorted[0].cpl, currency)}`,
+        ...s
+      });
+    }
+    if (sorted.length > 1) {
+      const worst = sorted[sorted.length - 1];
+      const s = cplSignal(worst.cpl, avgCpl);
+      pushRow(rows, seen, {
+        item: String(worst.label),
+        data: `CPL ${money2(worst.cpl, currency)}`,
+        ...s
+      });
+    }
+  }
+  const adSets = Array.isArray(tables.adSets) ? tables.adSets : [];
+  const adWithSpend = adSets.filter((g) => (num2(g.spend) ?? 0) > 0);
+  if (adWithSpend.length) {
+    const sorted = [...adWithSpend].sort(
+      (a, b) => (num2(a.costPerResult) ?? Infinity) - (num2(b.costPerResult) ?? Infinity)
+    );
+    const best = sorted[0];
+    const sBest = cplSignal(num2(best.costPerResult), avgCpl);
+    pushRow(rows, seen, {
+      item: String(best.name ?? "\u5E7F\u544A\u7EC4"),
+      data: `CPL ${money2(num2(best.costPerResult), currency)}`,
+      ...sBest
+    });
+    if (sorted.length > 1) {
+      const worst = sorted[sorted.length - 1];
+      const sWorst = cplSignal(num2(worst.costPerResult), avgCpl);
+      pushRow(rows, seen, {
+        item: String(worst.name ?? "\u5E7F\u544A\u7EC4"),
+        data: `CPL ${money2(num2(worst.costPerResult), currency)}`,
+        ...sWorst
+      });
+    }
+  }
+  const topAud = Array.isArray(tables.audienceTop) ? tables.audienceTop : [];
+  const bottomAud = Array.isArray(tables.audienceBottom) ? tables.audienceBottom : [];
+  if (topAud[0]) {
+    const s = cplSignal(num2(topAud[0].costPerResult), avgCpl);
+    pushRow(rows, seen, {
+      item: `\u53D7\u4F17\xB7${String(topAud[0].label ?? "Top")}`,
+      data: `CPL ${money2(num2(topAud[0].costPerResult), currency)}`,
+      ...s
+    });
+  }
+  if (bottomAud[0]) {
+    const s = cplSignal(num2(bottomAud[0].costPerResult), avgCpl);
+    pushRow(rows, seen, {
+      item: `\u53D7\u4F17\xB7${String(bottomAud[0].label ?? "Bottom")}`,
+      data: `CPL ${money2(num2(bottomAud[0].costPerResult), currency)}`,
+      ...s
+    });
+  }
+  if (rows.length < 6 && avgCpl > 0) {
+    pushRow(rows, seen, {
+      item: "\u8D26\u6237\u5747\u503C",
+      data: `CPL ${money2(avgCpl, currency)}`,
+      signal: "yellow",
+      signalLabel: "\u89C2",
+      advice: "\u4EE5\u8D26\u6237 CPL \u4E3A\u57FA\u51C6\u5BF9\u6BD4\u5404\u7EF4\u5EA6"
+    });
+  }
+  return rows;
+}
+var MIN_SCORECARD_ROWS = 6;
+function ensureScorecardFromSnapshot(healthDiagnosis, merged) {
+  const hd = { ...healthDiagnosis ?? {} };
+  const existing = Array.isArray(hd.scorecard) ? hd.scorecard : [];
+  if (existing.length >= MIN_SCORECARD_ROWS) return hd;
+  const auto = buildScorecardFromMergedData(merged);
+  const seen = new Set(existing.map((r) => String(r.item ?? "").trim()).filter(Boolean));
+  const combined = [...existing];
+  for (const row of auto) {
+    if (combined.length >= MIN_SCORECARD_ROWS) break;
+    const key = row.item.trim();
+    if (!key || seen.has(key)) continue;
+    seen.add(key);
+    combined.push(row);
+  }
+  hd.scorecard = combined;
+  if (combined.length > 0) {
+    hd.scorecardAutofilled = existing.length < MIN_SCORECARD_ROWS;
+  }
+  return hd;
+}
+
+// src/commands/facebook-analysis/merge-snapshot.ts
 function asRecord5(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
   return null;
 }
-function num(value) {
+function num3(value) {
   const n = Number(value);
   return Number.isFinite(n) ? n : void 0;
 }
@@ -123453,8 +123737,8 @@ function aggregatePlatform(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)
+      spend: prev.spend + (num3(row.spend) ?? 0),
+      results: prev.results + (num3(row.results) ?? 0)
     });
   }
   const labels = [];
@@ -123470,10 +123754,10 @@ function aggregatePlatform(networks) {
 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)
+    spend: num3(a.spend) ?? 0,
+    results: num3(a.results) ?? 0,
+    costPerResult: num3(a.costPerResult) ?? (num3(a.results) ? (num3(a.spend) ?? 0) / (num3(a.results) ?? 1) : 0),
+    frequency: num3(a.frequency)
   })).filter((r) => r.spend > 0 || r.results > 0);
 }
 async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
@@ -123510,7 +123794,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
   }
   if (!meta.resultType && current?.resultType) meta.resultType = String(current.resultType);
   const charts = { ...payload.charts ?? {} };
-  const avgCpl = num(kpis.costPerResult) ?? 0;
+  const avgCpl = num3(kpis.costPerResult) ?? 0;
   if (!charts.platform) {
     const platform = sectionMap.get("platform");
     const networks = Array.isArray(platform?.networks) ? platform.networks : [];
@@ -123520,10 +123804,10 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
     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));
+      const sorted = [...countries].sort((a, b) => (num3(b.spend) ?? 0) - (num3(a.spend) ?? 0));
       charts.country = {
         labels: sorted.map((c) => String(c.countryOrRegion ?? "\u2014")),
-        cpl: sorted.map((c) => num(c.costPerResult) ?? 0)
+        cpl: sorted.map((c) => num3(c.costPerResult) ?? 0)
       };
     }
   }
@@ -123539,7 +123823,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
       };
     }
   }
-  if (!charts.funnel && num(kpis.reach) != null) {
+  if (!charts.funnel && num3(kpis.reach) != null) {
     charts.funnel = { reach: kpis.reach, results: kpis.results ?? 0 };
   }
   const tables = { ...payload.tables ?? {} };
@@ -123548,14 +123832,14 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
     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 cpl = num3(g.costPerResult);
+        const freq = num3(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,
+          spend: num3(g.spend) ?? 0,
+          results: num3(g.results) ?? 0,
           costPerResult: cpl ?? 0,
           frequency: freq,
           fatigueLevel: fatigue.level,
@@ -123577,25 +123861,37 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
       if (!tables.audienceBottom) tables.audienceBottom = bottomN;
     }
   }
+  const currency = typeof meta.currency === "string" ? meta.currency : "USD";
+  const mergeCtx = {
+    spend: num3(kpis.spend),
+    avgCpl,
+    currency,
+    charts,
+    tables
+  };
+  let healthDiagnosis = ensureScorecardFromSnapshot(payload.healthDiagnosis, mergeCtx);
+  healthDiagnosis = ensureLifecycleFromSnapshot(healthDiagnosis, mergeCtx);
   return {
     ...payload,
     meta,
     kpis,
     charts,
-    tables
+    tables,
+    healthDiagnosis
   };
 }
 
 // src/commands/facebook-analysis/report-content.ts
 var RECOMMENDATION_TITLES = ["\u7B80\u5316\u8868\u5355\u95EE\u9898", "\u533A\u57DF\u8C03\u6574", "\u9884\u7B97\u91CD\u6784", "\u7D20\u6750\u5EFA\u8BAE"];
-var LIFECYCLE_PHASES = ["test-market", "find-winner", "scale"];
-function textLen(value) {
+var SCORECARD_SIGNALS = ["green", "yellow", "red"];
+var SNAPSHOT_HEALTH_HINT = "\u53EF\u7701\u7565\u5BF9\u5E94\u5B57\u6BB5\uFF0Crender \u65F6\u52A0 --snapshot-dir \u7531 CLI \u4ECE\u5FEB\u7167\u81EA\u52A8\u8865\u5168\uFF1B\u6216\u6309 meta-period-report-rules.md \u624B\u5199";
+function textLen2(value) {
   return typeof value === "string" ? value.trim().length : 0;
 }
 function isFiniteNumber(value) {
   return typeof value === "number" && Number.isFinite(value);
 }
-function asArray(value) {
+function asArray2(value) {
   return Array.isArray(value) ? value : [];
 }
 function asRecord6(value) {
@@ -123608,7 +123904,7 @@ function pushMissing(missing, id, chapter, dimension, hint) {
   missing.push({ id, chapter, dimension, hint });
 }
 function countAdSetsWithSpend(tables) {
-  const rows = asArray(tables?.adSets);
+  const rows = asArray2(tables?.adSets);
   return rows.filter((row) => {
     const r = asRecord6(row);
     const spend = r?.spend;
@@ -123617,7 +123913,7 @@ function countAdSetsWithSpend(tables) {
 }
 function chartLabels(chart) {
   const c = asRecord6(chart);
-  return asArray(c?.labels).length;
+  return asArray2(c?.labels).length;
 }
 function validateMetaPeriodReportContent(data) {
   const missing = [];
@@ -123630,15 +123926,15 @@ function validateMetaPeriodReportContent(data) {
   const health = asRecord6(data.healthDiagnosis);
   const priorityPlan = asRecord6(data.priorityPlan);
   const actionChecklist = asRecord6(data.actionChecklist);
-  const adSetsWithSpend = countAdSetsWithSpend(tables ?? void 0);
-  const regionalNarratives = asArray(narrative.regional).length;
-  const recommendations = asArray(narrative.recommendations);
-  const supplementary = asArray(data.supplementaryRecommendations);
-  const executiveSummary = asArray(data.executiveSummary);
-  const fourQuestions = asArray(health?.fourQuestions);
-  const scorecard = asArray(health?.scorecard);
-  const abTests = asArray(data.abTests);
-  if (!textLen(meta.accountName) && !textLen(meta.accountId)) {
+  const adSetsWithSpend2 = countAdSetsWithSpend(tables ?? void 0);
+  const regionalNarratives = asArray2(narrative.regional).length;
+  const recommendations = asArray2(narrative.recommendations);
+  const supplementary = asArray2(data.supplementaryRecommendations);
+  const executiveSummary = asArray2(data.executiveSummary);
+  const fourQuestions = asArray2(health?.fourQuestions);
+  const scorecard = asArray2(health?.scorecard);
+  const abTests = asArray2(data.abTests);
+  if (!textLen2(meta.accountName) && !textLen2(meta.accountId)) {
     pushMissing(
       missing,
       "meta-account",
@@ -123647,7 +123943,7 @@ function validateMetaPeriodReportContent(data) {
       "meta.accountName \u6216 meta.accountId \u81F3\u5C11\u4E00\u9879\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 overview"
     );
   }
-  if (!textLen(meta.periodLabel) && !(textLen(meta.startDate) && textLen(meta.endDate))) {
+  if (!textLen2(meta.periodLabel) && !(textLen2(meta.startDate) && textLen2(meta.endDate))) {
     pushMissing(
       missing,
       "meta-period",
@@ -123680,7 +123976,7 @@ function validateMetaPeriodReportContent(data) {
   if (!isFiniteNumber(funnel?.reach)) {
     pushMissing(missing, "chart-funnel", "\u6570\u636E\u56FE\u8868", "\u6F0F\u6597\u56FE reach", "charts.funnel.reach \u987B\u4E3A\u6709\u6548\u6570\u503C");
   }
-  if (adSetsWithSpend < 1) {
+  if (adSetsWithSpend2 < 1) {
     pushMissing(
       missing,
       "table-adsets",
@@ -123689,10 +123985,10 @@ function validateMetaPeriodReportContent(data) {
       "tables.adSets \u81F3\u5C11 1 \u884C\u82B1\u8D39>0\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 ad-sets"
     );
   }
-  if (asArray(tables?.audienceTop).length < 1) {
+  if (asArray2(tables?.audienceTop).length < 1) {
     pushMissing(missing, "table-audience-top", "\u6570\u636E\u8868\u683C", "\u53D7\u4F17 Top", "tables.audienceTop \u81F3\u5C11 1 \u884C");
   }
-  if (asArray(tables?.audienceBottom).length < 1) {
+  if (asArray2(tables?.audienceBottom).length < 1) {
     pushMissing(
       missing,
       "table-audience-bottom",
@@ -123701,7 +123997,7 @@ function validateMetaPeriodReportContent(data) {
       "tables.audienceBottom \u81F3\u5C11 1 \u884C"
     );
   }
-  if (textLen(narrative.overall) < 120) {
+  if (textLen2(narrative.overall) < 120) {
     pushMissing(
       missing,
       "narrative-overall",
@@ -123710,13 +124006,13 @@ function validateMetaPeriodReportContent(data) {
       "\u2265120 \u5B57\uFF0C\u542B\u82B1\u8D39/\u7EBF\u7D22/CPL/\u8986\u76D6/\u5C55\u793A/\u9891\u6B21\u7B49\u81F3\u5C11 5 \u9879\u6570\u5B57"
     );
   }
-  if (adSetsWithSpend > 0 && regionalNarratives < adSetsWithSpend) {
+  if (adSetsWithSpend2 > 0 && regionalNarratives < adSetsWithSpend2) {
     pushMissing(
       missing,
       "narrative-regional",
       "\u603B\u6570\u636E\u53D9\u4E8B",
       "narrative.regional",
-      `\u6BCF\u4E2A\u82B1\u8D39>0 \u7684\u5E7F\u544A\u7EC4\u5404 1 \u6BB5\uFF08\u5F53\u524D ${regionalNarratives}/${adSetsWithSpend}\uFF09`
+      `\u6BCF\u4E2A\u82B1\u8D39>0 \u7684\u5E7F\u544A\u7EC4\u5404 1 \u6BB5\uFF08\u5F53\u524D ${regionalNarratives}/${adSetsWithSpend2}\uFF09`
     );
   } else if (regionalNarratives < 1) {
     pushMissing(
@@ -123728,8 +124024,8 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < regionalNarratives; i++) {
-      const row = asRecord6(asArray(narrative.regional)[i]);
-      if (textLen(row?.text) < 80) {
+      const row = asRecord6(asArray2(narrative.regional)[i]);
+      if (textLen2(row?.text) < 80) {
         pushMissing(
           missing,
           `narrative-regional-${i}`,
@@ -123740,7 +124036,7 @@ function validateMetaPeriodReportContent(data) {
       }
     }
   }
-  if (textLen(narrative.country) < 80) {
+  if (textLen2(narrative.country) < 80) {
     pushMissing(
       missing,
       "narrative-country",
@@ -123772,7 +124068,7 @@ function validateMetaPeriodReportContent(data) {
     }
     for (let i = 0; i < recommendations.length; i++) {
       const rec = asRecord6(recommendations[i]);
-      if (textLen(rec?.content) < 150) {
+      if (textLen2(rec?.content) < 150) {
         pushMissing(
           missing,
           `narrative-rec-content-${i}`,
@@ -123794,7 +124090,7 @@ function validateMetaPeriodReportContent(data) {
   } else {
     for (let i = 0; i < supplementary.length; i++) {
       const row = asRecord6(supplementary[i]);
-      if (!textLen(row?.dimension) || !textLen(row?.issue)) {
+      if (!textLen2(row?.dimension) || !textLen2(row?.issue)) {
         pushMissing(
           missing,
           `supplementary-fields-${i}`,
@@ -123803,7 +124099,7 @@ function validateMetaPeriodReportContent(data) {
           "\u987B\u542B dimension\u3001issue\u3001suggestion"
         );
       }
-      if (textLen(row?.suggestion) < 60) {
+      if (textLen2(row?.suggestion) < 60) {
         pushMissing(
           missing,
           `supplementary-suggestion-${i}`,
@@ -123815,7 +124111,7 @@ function validateMetaPeriodReportContent(data) {
     }
   }
   for (const level of ["high", "medium", "low"]) {
-    const items = asArray(priorityPlan?.[level]).filter((s) => textLen(s) >= 40);
+    const items = asArray2(priorityPlan?.[level]).filter((s) => textLen2(s) >= 40);
     if (items.length < 2) {
       pushMissing(
         missing,
@@ -123826,7 +124122,7 @@ function validateMetaPeriodReportContent(data) {
       );
     }
   }
-  const summaryOk = executiveSummary.filter((p) => textLen(p) >= 80);
+  const summaryOk = executiveSummary.filter((p) => textLen2(p) >= 80);
   if (summaryOk.length < 3) {
     pushMissing(
       missing,
@@ -123836,22 +124132,33 @@ function validateMetaPeriodReportContent(data) {
       "3\uFF5E5 \u6BB5\uFF0C\u6BCF\u6BB5 \u226580 \u5B57\uFF0C\u89E3\u91CA\u300C\u4E3A\u4EC0\u4E48\u300D"
     );
   }
-  if (!LIFECYCLE_PHASES.includes(health?.lifecyclePhase)) {
+  const lifecyclePhase = health?.lifecyclePhase;
+  const lifecyclePhaseInferred = health?.lifecyclePhaseInferred;
+  const phaseValid = LIFECYCLE_PHASES.includes(lifecyclePhase);
+  if (!phaseValid) {
     pushMissing(
       missing,
       "health-phase",
-      "\u5065\u5EB7\u8BCA\u65AD",
+      "\u5065\u5EB7\u8BCA\u65AD \u2460",
       "healthDiagnosis.lifecyclePhase",
-      "\u987B\u4E3A test-market / find-winner / scale"
+      `\u987B\u4E3A test-market / find-winner / scale\uFF1B${SNAPSHOT_HEALTH_HINT}`
+    );
+  } else if (typeof lifecyclePhaseInferred === "string" && LIFECYCLE_PHASES.includes(lifecyclePhaseInferred) && lifecyclePhase !== lifecyclePhaseInferred && health?.lifecyclePhaseAutofilled !== true) {
+    pushMissing(
+      missing,
+      "health-phase-mismatch",
+      "\u5065\u5EB7\u8BCA\u65AD \u2460",
+      "healthDiagnosis.lifecyclePhase",
+      `Agent \u586B\u300C${lifecyclePhase}\u300D\u4F46\u5FEB\u7167\u6570\u636E\u63A8\u65AD\u4E3A\u300C${lifecyclePhaseInferred}\u300D\uFF1B\u5220\u9664 lifecyclePhase \u7531 --snapshot-dir \u81EA\u52A8\u63A8\u65AD\uFF0C\u6216\u6309\u89C4\u5219\u4FEE\u6B63`
     );
   }
-  if (textLen(health?.lifecycleVerdict) < 60) {
+  if (textLen2(health?.lifecycleVerdict) < 60) {
     pushMissing(
       missing,
       "health-verdict",
-      "\u5065\u5EB7\u8BCA\u65AD",
+      "\u5065\u5EB7\u8BCA\u65AD \u2460",
       "healthDiagnosis.lifecycleVerdict",
-      "\u226560 \u5B57\uFF0C\u7ED3\u5408\u603B\u82B1\u8D39\u4E0E\u7EF4\u5EA6\u5206\u6563\u5EA6"
+      `\u226560 \u5B57\uFF0C\u7ED3\u5408\u603B\u82B1\u8D39\u4E0E\u7EF4\u5EA6\u5206\u6563\u5EA6\uFF1B${SNAPSHOT_HEALTH_HINT}`
     );
   }
   if (fourQuestions.length !== 4) {
@@ -123865,7 +124172,7 @@ function validateMetaPeriodReportContent(data) {
   } else {
     for (let i = 0; i < fourQuestions.length; i++) {
       const q = asRecord6(fourQuestions[i]);
-      const evidence = asArray(q?.evidence).filter((e) => textLen(e) > 0);
+      const evidence = asArray2(q?.evidence).filter((e) => textLen2(e) > 0);
       if (evidence.length < 2) {
         pushMissing(
           missing,
@@ -123875,7 +124182,7 @@ function validateMetaPeriodReportContent(data) {
           "\u6BCF\u6761 evidence \u22652 \u6761\u4E14\u542B\u6570\u5B57"
         );
       }
-      if (textLen(q?.action) < 40) {
+      if (textLen2(q?.action) < 40) {
         pushMissing(
           missing,
           `health-action-${i}`,
@@ -123886,17 +124193,51 @@ function validateMetaPeriodReportContent(data) {
       }
     }
   }
+  let scorecardValidRows = 0;
+  for (let i = 0; i < scorecard.length; i++) {
+    const row = asRecord6(scorecard[i]);
+    const itemOk = textLen2(row?.item) > 0;
+    const dataOk = textLen2(row?.data) > 0;
+    const signalOk = SCORECARD_SIGNALS.includes(row?.signal);
+    const labelOk = textLen2(row?.signalLabel) > 0;
+    const adviceOk = textLen2(row?.advice) > 0;
+    if (itemOk && dataOk && signalOk && labelOk && adviceOk) {
+      scorecardValidRows += 1;
+      continue;
+    }
+    const parts = [];
+    if (!itemOk) parts.push("item");
+    if (!dataOk) parts.push("data");
+    if (!signalOk) parts.push("signal(green|yellow|red)");
+    if (!labelOk) parts.push("signalLabel");
+    if (!adviceOk) parts.push("advice");
+    pushMissing(
+      missing,
+      `health-scorecard-row-${i}`,
+      "\u5065\u5EB7\u8BCA\u65AD \u2462",
+      `healthDiagnosis.scorecard[${i}]`,
+      `\u6BCF\u884C\u987B\u542B ${parts.join("\u3001")}`
+    );
+  }
   if (scorecard.length < 6) {
     pushMissing(
       missing,
-      "health-scorecard",
-      "\u5065\u5EB7\u8BCA\u65AD",
+      "health-scorecard-count",
+      "\u5065\u5EB7\u8BCA\u65AD \u2462",
+      "healthDiagnosis.scorecard",
+      `\u7EA2\u7EFF\u706F\u8868 \u22656 \u884C\uFF08\u5E73\u53F0/\u56FD\u5BB6/\u5E7F\u544A\u7EC4/\u53D7\u4F17\u7B49\uFF09\uFF1B\u5F53\u524D ${scorecard.length} \u884C\uFF1B${SNAPSHOT_HEALTH_HINT}`
+    );
+  } else if (scorecardValidRows < 6) {
+    pushMissing(
+      missing,
+      "health-scorecard-valid",
+      "\u5065\u5EB7\u8BCA\u65AD \u2462",
       "healthDiagnosis.scorecard",
-      "\u7EA2\u7EFF\u706F\u8868 \u22656 \u884C\uFF08\u5E73\u53F0/\u56FD\u5BB6/\u5E7F\u544A\u7EC4/\u53D7\u4F17\u7B49\uFF09"
+      `\u6709\u6548\u884C ${scorecardValidRows}/6\uFF08\u6BCF\u884C item/data/signal/signalLabel/advice \u9F50\u5168\uFF09`
     );
   }
   for (const key of ["platform", "country", "adSets"]) {
-    const insight = textLen(asRecord6(sections?.[key])?.insight);
+    const insight = textLen2(asRecord6(sections?.[key])?.insight);
     if (insight < 200) {
       pushMissing(
         missing,
@@ -123908,7 +124249,7 @@ function validateMetaPeriodReportContent(data) {
     }
   }
   const audience = asRecord6(sections?.audience);
-  if (asArray(audience?.goldenProfile).filter((s) => textLen(s) > 0).length < 3) {
+  if (asArray2(audience?.goldenProfile).filter((s) => textLen2(s) > 0).length < 3) {
     pushMissing(
       missing,
       "sections-audience-golden",
@@ -123917,7 +124258,7 @@ function validateMetaPeriodReportContent(data) {
       "\u22653 \u6761\u9EC4\u91D1\u53D7\u4F17\u753B\u50CF"
     );
   }
-  if (asArray(audience?.antiProfile).filter((s) => textLen(s) > 0).length < 2) {
+  if (asArray2(audience?.antiProfile).filter((s) => textLen2(s) > 0).length < 2) {
     pushMissing(
       missing,
       "sections-audience-anti",
@@ -123926,7 +124267,7 @@ function validateMetaPeriodReportContent(data) {
       "\u22652 \u6761\u53CD\u753B\u50CF"
     );
   }
-  if (textLen(audience?.insight) < 150) {
+  if (textLen2(audience?.insight) < 150) {
     pushMissing(
       missing,
       "sections-audience-insight",
@@ -123935,7 +124276,7 @@ function validateMetaPeriodReportContent(data) {
       "\u2265150 \u5B57"
     );
   }
-  const landingRows = asArray(asRecord6(sections?.landingPage)?.rows);
+  const landingRows = asArray2(asRecord6(sections?.landingPage)?.rows);
   if (landingRows.length < 3) {
     pushMissing(
       missing,
@@ -123954,9 +124295,9 @@ function validateMetaPeriodReportContent(data) {
       "\u22653 \u4E2A\u5B9E\u9A8C\uFF08\u53D8\u91CF\u3001\u5047\u8BBE\u3001\u6210\u529F\u6807\u51C6\uFF09"
     );
   }
-  const today = asArray(actionChecklist?.today).filter((s) => textLen(s) > 0);
-  const thisWeek = asArray(actionChecklist?.thisWeek).filter((s) => textLen(s) > 0);
-  const thisMonth = asArray(actionChecklist?.thisMonth).filter((s) => textLen(s) > 0);
+  const today = asArray2(actionChecklist?.today).filter((s) => textLen2(s) > 0);
+  const thisWeek = asArray2(actionChecklist?.thisWeek).filter((s) => textLen2(s) > 0);
+  const thisMonth = asArray2(actionChecklist?.thisMonth).filter((s) => textLen2(s) > 0);
   if (today.length < 2 || thisWeek.length < 3 || thisMonth.length < 3) {
     pushMissing(
       missing,
@@ -123974,8 +124315,11 @@ function validateMetaPeriodReportContent(data) {
       supplementaryCount: supplementary.length,
       fourQuestionsCount: fourQuestions.length,
       scorecardRows: scorecard.length,
+      scorecardValidRows,
+      lifecyclePhase: phaseValid ? String(lifecyclePhase) : void 0,
+      lifecyclePhaseInferred: typeof lifecyclePhaseInferred === "string" ? lifecyclePhaseInferred : void 0,
       regionalNarratives,
-      adSetsWithSpend
+      adSetsWithSpend: adSetsWithSpend2
     }
   };
 }
@@ -123987,7 +124331,7 @@ function formatMetaPeriodReportErrors(result) {
     ...lines,
     "",
     "\u8BF7 Read assets/meta-period-report-rules.md\uFF0C\u8865\u5168 meta-period-report.json \u540E\u91CD\u65B0\u6267\u884C render\u3002",
-    "\u6570\u636E\u7C7B\u5B57\u6BB5\u53EF\u5148 facebook-analysis --json-out\uFF0Crender \u65F6\u52A0 --snapshot-dir \u81EA\u52A8\u5408\u5E76 KPI/\u56FE\u8868/\u8868\u683C\u3002"
+    "\u6570\u636E\u7C7B\u5B57\u6BB5\u53EF\u5148 facebook-analysis --json-out\uFF0Crender \u65F6\u52A0 --snapshot-dir \u81EA\u52A8\u5408\u5E76 KPI/\u56FE\u8868/\u8868\u683C\uFF0C\u5E76\u8865\u5168 \u2460 \u9636\u6BB5\u4E0E \u2462 \u7EA2\u7EFF\u706F\u8868\u3002"
   ].join("\n");
 }
 
@@ -124049,7 +124393,7 @@ async function runFacebookAnalysisRender(opts) {
 `);
     const { stats: stats2 } = contentCheck;
     console.error(
-      `   \u7EDF\u8BA1\uFF1A\u5EFA\u8BAE ${stats2.recommendationCount}/4\uFF5C\u8865\u5145 ${stats2.supplementaryCount}/7\uFF5C\u56DB\u95EE ${stats2.fourQuestionsCount}/4\uFF5C\u7EA2\u7EFF\u706F ${stats2.scorecardRows}/6\uFF5C\u533A\u57DF\u53D9\u4E8B ${stats2.regionalNarratives}/${stats2.adSetsWithSpend}
+      `   \u7EDF\u8BA1\uFF1A\u5EFA\u8BAE ${stats2.recommendationCount}/4\uFF5C\u8865\u5145 ${stats2.supplementaryCount}/7\uFF5C\u56DB\u95EE ${stats2.fourQuestionsCount}/4\uFF5C\u9636\u6BB5 ${stats2.lifecyclePhase ?? "\u2014"}${stats2.lifecyclePhaseInferred ? `\uFF08\u63A8\u65AD ${stats2.lifecyclePhaseInferred}\uFF09` : ""}\uFF5C\u7EA2\u7EFF\u706F ${stats2.scorecardValidRows}/${stats2.scorecardRows} \u6709\u6548\u884C\uFF5C\u533A\u57DF\u53D9\u4E8B ${stats2.regionalNarratives}/${stats2.adSetsWithSpend}
 `
     );
     process.exit(1);
@@ -124084,7 +124428,7 @@ async function runFacebookAnalysisRender(opts) {
 \u2705 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
 `);
   console.log(
-    `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u5EFA\u8BAE ${stats.recommendationCount}\uFF5C\u8865\u5145 ${stats.supplementaryCount}\uFF5C\u56DB\u95EE ${stats.fourQuestionsCount}\uFF5C\u7EA2\u7EFF\u706F ${stats.scorecardRows}
+    `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u5EFA\u8BAE ${stats.recommendationCount}\uFF5C\u8865\u5145 ${stats.supplementaryCount}\uFF5C\u56DB\u95EE ${stats.fourQuestionsCount}\uFF5C\u9636\u6BB5 ${stats.lifecyclePhase ?? "\u2014"}\uFF5C\u7EA2\u7EFF\u706F ${stats.scorecardValidRows} \u6709\u6548\u884C
 `
   );
   if (runtimeCopied) {

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.4",
-  "publishedAt": 1781076395156
+  "version": "1.1.29-beta.5",
+  "publishedAt": 1781081318464
 }

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

@@ -120,11 +120,12 @@
 | 字段 | 最低要求 |
 | ---- | -------- |
 | `executiveSummary` | **3～5 段**，每段 **≥ 80 字**；解释「为什么」而不只报数；可拆自 `narrative.overall` 但须加深因果 |
-| `healthDiagnosis.lifecyclePhase` | `test-market` / `find-winner` / `scale` 三选一 |
-| `healthDiagnosis.lifecycleVerdict` | **≥ 60 字**，结合总花费与维度分散度 |
+| `healthDiagnosis.lifecyclePhase` | `test-market` / `find-winner` / `scale` 三选一。**可省略**：`render --snapshot-dir` 按花费与集中度自动推断；若手写须与数据一致（render 校验 `lifecyclePhase` vs `lifecyclePhaseInferred`） |
+| `healthDiagnosis.lifecycleVerdict` | **≥ 60 字**，结合总花费与维度分散度；可随 phase 由 CLI 补全 |
+| **阶段判定（CLI 推断口径）** | **测市场**：总花费 < $200，或活跃维度 ≥4 且赢家花费占比 <35%；**放量**：Top 广告组花费/结果占比 ≥55% 且 CPL ≤ 账户均值；**找赢家**：其余有优劣分化但未高度集中 |
 | `healthDiagnosis.fourQuestions` | **恰好 4 张卡片**（钱花得值不值 / 赢在哪 / 输在哪 / 下月重点） |
 | 每张 `fourQuestions[]` | `verdict` + `evidence` **≥2 条**（含数字）+ `action` **≥ 40 字** |
-| `healthDiagnosis.scorecard` | **≥ 6 行**（平台、国家、广告组、受众等分项红绿灯） |
+| `healthDiagnosis.scorecard` | **≥ 6 行**有效行；每行须 `item` / `data` / `signal`(green\|yellow\|red) / `signalLabel` / `advice`。**可省略**：`render --snapshot-dir` 自动补全；render 校验行数与字段完整性 |
 | `sections.platform.insight` | **≥ 200 字** |
 | `sections.country.insight` | **≥ 200 字** |
 | `sections.adSets.insight` | **≥ 200 字** |
@@ -152,7 +153,7 @@
 - [ ] `narrative.recommendations` 4 条，每条 content ≥150 字且含真实数字
 - [ ] `supplementaryRecommendations` 7 维齐全
 - [ ] `priorityPlan` high/medium/low 各 ≥2 条
-- [ ] HTML：`executiveSummary` ≥3 段、`fourQuestions` =4、`scorecard` ≥6 行
+- [ ] HTML：`executiveSummary` ≥3 段、`fourQuestions` =4、`lifecyclePhase` 与快照推断一致（或省略由 CLI 补全）、`scorecard` ≥6 行且每行五字段齐全
 - [ ] HTML：`sections.platform/country/adSets.insight` 各 ≥200 字
 - [ ] HTML：`actionChecklist` 三列非空；`abTests` ≥3
 - [ ] Excel：总数据 Sheet 叙事块 4 节齐全，无 1 句话敷衍

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

@@ -16,19 +16,30 @@ siluzan-tso list-accounts [选项]
 | `-p, --page <n>`        | 页码（默认 1）                                                                   |
 | `--page-size <n>`       | 每页数量（默认 20）                                                              |
 | `--json-out`                | 输出原始 JSON                                                                    |
-| `--detail`              | **合并余额与近期消耗**（及展示/点击/转化/CPC、Arit 得分）；**未传时 JSON 不含这些字段**，列表更快 |
+| `--detail`              | **合并余额与近期消耗**（及展示/点击/转化/CPC、Arit 得分）；**未传时 JSON 不含这些字段**，列表更快。**仅适合少量账号**：每户额外并行请求，账号多时明显变慢；全量余额/消耗汇总改用 `balance-scan` / `accounts-digest` |
 | `--unicode`             | 表格使用 Unicode 线框；**默认**为 ASCII `+-                                      | ` 线框（兼容各类终端） |
 | `--plain`               | 已默认 ASCII，无需再传；保留兼容旧脚本                                           |
 | `--refresh-dp`          | 强制重拉 Datapermission（排查「本页全部 OAuth 失效」类会话异常）                 |
 
+**命令定位（Agent 必读）**：`list-accounts` 主打**精准查询账号信息**（列表、计数、按名称/ID 找户、`entityId` / `mediaCustomerId` / 币种 / 状态等元数据）。**它不是余额/消耗汇总工具**——`--detail` 只是给「少量账号」顺带带出余额与近期消耗的增强项。
+
 **`--detail` 说明（Agent 必读）：**
 
-| 模式 | 行为 |
-| ---- | ---- |
-| 默认（无 `--detail`） | 只拉账户列表；JSON **不含**余额、消耗、展示、点击、转化、CPC、Arit；表格对应列为「-」 |
-| `--detail` | 额外并行请求余额与投放概览；JSON 含上述字段的真实数值，**响应明显变慢** |
+| 模式 | 行为 | 适用 |
+| ---- | ---- | ---- |
+| 默认（无 `--detail`） | 只拉账户列表；JSON **不含**余额、消耗、展示、点击、转化、CPC、Arit；表格对应列为「-」 | 任意规模的账号列表/计数/元数据 |
+| `--detail` | 每户额外并行请求余额与投放概览；JSON 含上述字段真实数值，**响应明显变慢** | **仅少量账号**（单户 / 数个 `-k` 命中） |
+
+**何时不要用 `--detail`（改用专用命令）：**
+
+| 需求 | 推荐命令 |
+| ---- | -------- |
+| **全部账号**的余额、续航/充值预警 | `balance-scan`（见 `SKILL.md` Playbook P2） |
+| **全部/多账号**的消耗、点击、转化、CTR/CPC/CPA 投放画像汇总 | `accounts-digest`（本文下方） |
+| 单户/少量户精确余额或消耗 | `balance` / `stats`（`-a` 指定 ID） |
+| 列表顺带看少量户余额/消耗 | `list-accounts --detail` |
 
-需要真实余额或消耗时：单户优先 `balance` / `stats`；列表顺带看余额/消耗时加 `--detail`。**禁止**在 JSON 无余额/消耗字段时臆造数值。
+**禁止**在 JSON 无余额/消耗字段时臆造数值；也**禁止**用 `--detail` 全量扫描所有账号去拼余额/消耗汇总（改用上表专用命令）。
 
 ### Agent 意图速查（**必读 · 避免多次试探**）
 
@@ -40,7 +51,8 @@ siluzan-tso list-accounts [选项]
 | 有多少个 Google 账户 | 同上 | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大） |
 | 列出全部某媒体（TikTok / MetaAd 等） | `list-accounts -m <媒体> --page-size 999 --json-out <dir>` | 同上 |
 | 只查某一个户 | `list-accounts -m <媒体> -k <id或名称> --json-out <dir>` | 无需大 page-size |
-| 列表顺带看余额/消耗 | 在上述命令加 `--detail`（**明显变慢**；仅用户要余额/消耗时） | 含 `ma.balance` 等 enrichment 字段 |
+| **少量账号**顺带看余额/消耗 | 在上述命令加 `--detail`（**明显变慢**；仅少量账号且用户要余额/消耗时） | 含 `ma.balance` 等 enrichment 字段 |
+| **全部账号**的余额/消耗汇总 | **勿用 `--detail` 全量扫描** → 余额预警用 `balance-scan`、消耗画像用 `accounts-digest` | 见各命令章节 |
 
 **执行纪律**：
 
@@ -71,8 +83,9 @@ siluzan-tso list-accounts -m Google -k "品牌A" --json-out ./snap
 # 只看正常状态
 siluzan-tso list-accounts -m TikTok -s normal --page-size 999 --json-out ./snap
 
-# 列表同时带出真实余额与近期消耗（较慢，仅用户要余额/消耗时）
-siluzan-tso list-accounts -m Google --page-size 999 --detail --json-out ./snap
+# 列表同时带出真实余额与近期消耗（较慢，仅少量账号且用户要余额/消耗时）
+# 注意：全部账号的余额/消耗汇总请改用 balance-scan / accounts-digest，勿用 --detail 全量扫描
+siluzan-tso list-accounts -m Google -k "品牌A" --detail --json-out ./snap
 
 # 极少数账户超过 999 条时才翻页（先确认读盘 total > itemCount）
 siluzan-tso list-accounts -m Google --page 2 --page-size 999 --json-out ./snap-p2

package/dist/skill/report-templates/meta-period-report.html

@@ -263,10 +263,10 @@ ${planHtml ? `<h3 style="margin-top:24px">优先级改进计划</h3>${planHtml}`
   function renderHealthDiagnosis(hd) {
     if (!hd) return "";
 
-    const phase = hd.lifecyclePhase || "find-winner";
+    const phase = hd.lifecyclePhase || "";
     const lifecycle = LIFECYCLE_PHASES.map(
       (p) => `
-    <div class="phase${p.id === phase ? " active" : ""}">
+    <div class="phase${phase && p.id === phase ? " active" : ""}">
       <div class="step">${escapeHtml(p.step)}</div>
       <div class="name">${escapeHtml(p.name)}</div>
       <div class="desc">${escapeHtml(p.desc)}</div>

package/dist/skill/report-templates/meta-period-report.md

@@ -166,7 +166,7 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> --start <s> --end <e> --json-
 用户未指定 Excel 时，除 `narrative` 外 **必须** 填写（字数见 `meta-period-report-rules.md` §四）：
 
 - `executiveSummary[]`：**3～5 段**「为什么」解读（每段 ≥80 字）
-- `healthDiagnosis`：三阶段 + **4 张四问卡片** + **≥6 行**红绿灯表
+- `healthDiagnosis`：三阶段 + **4 张四问卡片** + **≥6 行**红绿灯表（③ 该加还是该减；可省略 `scorecard`，render 时由 `--snapshot-dir` 自动补全）
 - `sections.platform/country/adSets.insight`：各 **≥200 字**
 - `sections.audience`：`goldenProfile` ≥3 条 + `antiProfile` ≥2 条
 - `sections.landingPage.rows`：≥3 行
@@ -201,7 +201,7 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> --start <s> --end <e> --json-
 | **`priorityPlan`** | **推荐** | 高/中/低各 ≥2 条；HTML 强烈建议填写 |
 | `tables` / `charts` | 可省略 | Sheet2～5；由快照自动汇总 |
 | `executiveSummary` | **HTML 必填** | 3～5 段深度摘要 |
-| `healthDiagnosis` | **HTML 必填** | 四问 + 红绿灯表 |
+| `healthDiagnosis` | **HTML 必填** | 四问 + 红绿灯表（`scorecard` 可由 CLI 从快照自动补全） |
 | `sections.*.insight` | **HTML 必填** | 各维度 ≥200 字 |
 | `abTests` / `actionChecklist` | **HTML 必填** | ≥3 实验 + 三列行动清单 |
 

package/dist/skill/scripts/install.ps1

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

package/dist/skill/scripts/install.sh

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

package/package.json

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