siluzan-tso-cli 1.1.28-beta.5 → 1.1.28-beta.6

package/README.md

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

package/dist/index.js

@@ -122757,6 +122757,411 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
   };
 }
 
+// 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) {
+  return typeof value === "string" ? value.trim().length : 0;
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function asRecord6(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function pushMissing(missing, id, chapter, dimension, hint) {
+  missing.push({ id, chapter, dimension, hint });
+}
+function countAdSetsWithSpend(tables) {
+  const rows = asArray(tables?.adSets);
+  return rows.filter((row) => {
+    const r = asRecord6(row);
+    const spend = r?.spend;
+    return isFiniteNumber(spend) && spend > 0;
+  }).length;
+}
+function chartLabels(chart) {
+  const c = asRecord6(chart);
+  return asArray(c?.labels).length;
+}
+function validateMetaPeriodReportContent(data) {
+  const missing = [];
+  const meta = asRecord6(data.meta) ?? {};
+  const kpis = asRecord6(data.kpis) ?? {};
+  const narrative = asRecord6(data.narrative) ?? {};
+  const tables = asRecord6(data.tables);
+  const charts = asRecord6(data.charts);
+  const sections = asRecord6(data.sections);
+  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)) {
+    pushMissing(
+      missing,
+      "meta-account",
+      "\u5143\u4FE1\u606F",
+      "\u8D26\u6237\u540D\u79F0\u6216 ID",
+      "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))) {
+    pushMissing(
+      missing,
+      "meta-period",
+      "\u5143\u4FE1\u606F",
+      "\u62A5\u544A\u5468\u671F",
+      "meta.periodLabel \u6216 meta.startDate + meta.endDate"
+    );
+  }
+  for (const key of ["spend", "results", "costPerResult", "reach", "impressions", "frequency"]) {
+    if (!isFiniteNumber(kpis[key])) {
+      pushMissing(
+        missing,
+        `kpi-${key}`,
+        "KPI",
+        `\u8D26\u6237\u7EA7 ${key}`,
+        "kpis \u987B\u542B\u6709\u6548\u6570\u503C\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 overview"
+      );
+    }
+  }
+  if (chartLabels(charts?.platform) < 1) {
+    pushMissing(missing, "chart-platform", "\u6570\u636E\u56FE\u8868", "\u5E73\u53F0 CPL \u56FE", "charts.platform.labels \u81F3\u5C11 1 \u9879");
+  }
+  if (chartLabels(charts?.country) < 1) {
+    pushMissing(missing, "chart-country", "\u6570\u636E\u56FE\u8868", "\u56FD\u5BB6 CPL \u56FE", "charts.country.labels \u81F3\u5C11 1 \u9879");
+  }
+  if (chartLabels(charts?.audience) < 1) {
+    pushMissing(missing, "chart-audience", "\u6570\u636E\u56FE\u8868", "\u53D7\u4F17 CPL \u56FE", "charts.audience.labels \u81F3\u5C11 1 \u9879");
+  }
+  const funnel = asRecord6(charts?.funnel);
+  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) {
+    pushMissing(
+      missing,
+      "table-adsets",
+      "\u6570\u636E\u8868\u683C",
+      "\u5E7F\u544A\u7EC4\u8868",
+      "tables.adSets \u81F3\u5C11 1 \u884C\u82B1\u8D39>0\uFF1B\u53EF\u7531 --snapshot-dir \u5408\u5E76 ad-sets"
+    );
+  }
+  if (asArray(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) {
+    pushMissing(
+      missing,
+      "table-audience-bottom",
+      "\u6570\u636E\u8868\u683C",
+      "\u53D7\u4F17 Bottom",
+      "tables.audienceBottom \u81F3\u5C11 1 \u884C"
+    );
+  }
+  if (textLen(narrative.overall) < 120) {
+    pushMissing(
+      missing,
+      "narrative-overall",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.overall",
+      "\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) {
+    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`
+    );
+  } else if (regionalNarratives < 1) {
+    pushMissing(
+      missing,
+      "narrative-regional",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.regional",
+      "\u81F3\u5C11 1 \u6BB5\u533A\u57DF/\u5E7F\u544A\u7EC4\u5206\u6790\uFF0C\u6BCF\u6BB5 \u226580 \u5B57"
+    );
+  } else {
+    for (let i = 0; i < regionalNarratives; i++) {
+      const row = asRecord6(asArray(narrative.regional)[i]);
+      if (textLen(row?.text) < 80) {
+        pushMissing(
+          missing,
+          `narrative-regional-${i}`,
+          "\u603B\u6570\u636E\u53D9\u4E8B",
+          `narrative.regional[${i}]`,
+          "\u6BCF\u6BB5 \u226580 \u5B57\uFF0C\u542B\u7EC4\u540D\u3001\u82B1\u8D39\u3001CPL\u3001\u9891\u6B21"
+        );
+      }
+    }
+  }
+  if (textLen(narrative.country) < 80) {
+    pushMissing(
+      missing,
+      "narrative-country",
+      "\u603B\u6570\u636E\u53D9\u4E8B",
+      "narrative.country",
+      "\u226580 \u5B57\uFF0C\u542B CPL \u6700\u4F4E/\u6700\u9AD8\u56FD\u5BB6\u53CA\u5177\u4F53\u6570\u5B57"
+    );
+  }
+  if (recommendations.length !== 4) {
+    pushMissing(
+      missing,
+      "narrative-recommendations-count",
+      "\u4F18\u5316\u5EFA\u8BAE",
+      "narrative.recommendations",
+      "\u5FC5\u987B\u6070\u597D 4 \u6761\uFF08\u7B80\u5316\u8868\u5355/\u533A\u57DF\u8C03\u6574/\u9884\u7B97\u91CD\u6784/\u7D20\u6750\u5EFA\u8BAE\uFF09"
+    );
+  } else {
+    const titles = recommendations.map((r) => asRecord6(r)?.title);
+    for (const title of RECOMMENDATION_TITLES) {
+      if (!titles.includes(title)) {
+        pushMissing(
+          missing,
+          `narrative-rec-title-${title}`,
+          "\u4F18\u5316\u5EFA\u8BAE",
+          `\u56FA\u5B9A\u6807\u9898\u300C${title}\u300D`,
+          "4 \u6761 title \u987B\u4E0E\u89C4\u5219\u679A\u4E3E\u5B8C\u5168\u4E00\u81F4"
+        );
+      }
+    }
+    for (let i = 0; i < recommendations.length; i++) {
+      const rec = asRecord6(recommendations[i]);
+      if (textLen(rec?.content) < 150) {
+        pushMissing(
+          missing,
+          `narrative-rec-content-${i}`,
+          "\u4F18\u5316\u5EFA\u8BAE",
+          `recommendations[${i}].content`,
+          "\u6BCF\u6761 \u2265150 \u5B57\uFF0C\u5F15\u7528\u5F53\u6B21 CPL/\u56FD\u5BB6/\u7EC4\u540D\u7B49\u6570\u5B57"
+        );
+      }
+    }
+  }
+  if (supplementary.length < 7) {
+    pushMissing(
+      missing,
+      "supplementary-count",
+      "\u8865\u5145\u5EFA\u8BAE",
+      "supplementaryRecommendations",
+      "\u5FC5\u987B 7 \u7EF4\u6E05\u5355\u9F50\u5168\uFF08\u9884\u7B97/\u5E73\u53F0/\u5730\u57DF/\u53D7\u4F17/\u521B\u610F/\u9891\u6B21/\u63A5\u53E3\u9650\u5236\uFF09"
+    );
+  } else {
+    for (let i = 0; i < supplementary.length; i++) {
+      const row = asRecord6(supplementary[i]);
+      if (!textLen(row?.dimension) || !textLen(row?.issue)) {
+        pushMissing(
+          missing,
+          `supplementary-fields-${i}`,
+          "\u8865\u5145\u5EFA\u8BAE",
+          `supplementaryRecommendations[${i}]`,
+          "\u987B\u542B dimension\u3001issue\u3001suggestion"
+        );
+      }
+      if (textLen(row?.suggestion) < 60) {
+        pushMissing(
+          missing,
+          `supplementary-suggestion-${i}`,
+          "\u8865\u5145\u5EFA\u8BAE",
+          `supplementaryRecommendations[${i}].suggestion`,
+          "\u6BCF\u6761 suggestion \u226560 \u5B57\u4E14\u542B\u81F3\u5C11 1 \u4E2A\u5F53\u6B21\u6570\u5B57\u6216\u540D\u79F0"
+        );
+      }
+    }
+  }
+  for (const level of ["high", "medium", "low"]) {
+    const items = asArray(priorityPlan?.[level]).filter((s) => textLen(s) >= 40);
+    if (items.length < 2) {
+      pushMissing(
+        missing,
+        `priority-${level}`,
+        "\u4F18\u5148\u7EA7\u8BA1\u5212",
+        `priorityPlan.${level}`,
+        "\u9AD8/\u4E2D/\u4F4E\u5404 \u22652 \u6761\uFF0C\u6BCF\u6761 \u226540 \u5B57"
+      );
+    }
+  }
+  const summaryOk = executiveSummary.filter((p) => textLen(p) >= 80);
+  if (summaryOk.length < 3) {
+    pushMissing(
+      missing,
+      "executive-summary",
+      "\u6267\u884C\u6458\u8981",
+      "executiveSummary",
+      "3\uFF5E5 \u6BB5\uFF0C\u6BCF\u6BB5 \u226580 \u5B57\uFF0C\u89E3\u91CA\u300C\u4E3A\u4EC0\u4E48\u300D"
+    );
+  }
+  if (!LIFECYCLE_PHASES.includes(health?.lifecyclePhase)) {
+    pushMissing(
+      missing,
+      "health-phase",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.lifecyclePhase",
+      "\u987B\u4E3A test-market / find-winner / scale"
+    );
+  }
+  if (textLen(health?.lifecycleVerdict) < 60) {
+    pushMissing(
+      missing,
+      "health-verdict",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.lifecycleVerdict",
+      "\u226560 \u5B57\uFF0C\u7ED3\u5408\u603B\u82B1\u8D39\u4E0E\u7EF4\u5EA6\u5206\u6563\u5EA6"
+    );
+  }
+  if (fourQuestions.length !== 4) {
+    pushMissing(
+      missing,
+      "health-four-questions",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.fourQuestions",
+      "\u6070\u597D 4 \u5F20\u56DB\u95EE\u5361\u7247"
+    );
+  } else {
+    for (let i = 0; i < fourQuestions.length; i++) {
+      const q = asRecord6(fourQuestions[i]);
+      const evidence = asArray(q?.evidence).filter((e) => textLen(e) > 0);
+      if (evidence.length < 2) {
+        pushMissing(
+          missing,
+          `health-evidence-${i}`,
+          "\u5065\u5EB7\u8BCA\u65AD",
+          `fourQuestions[${i}].evidence`,
+          "\u6BCF\u6761 evidence \u22652 \u6761\u4E14\u542B\u6570\u5B57"
+        );
+      }
+      if (textLen(q?.action) < 40) {
+        pushMissing(
+          missing,
+          `health-action-${i}`,
+          "\u5065\u5EB7\u8BCA\u65AD",
+          `fourQuestions[${i}].action`,
+          "action \u226540 \u5B57"
+        );
+      }
+    }
+  }
+  if (scorecard.length < 6) {
+    pushMissing(
+      missing,
+      "health-scorecard",
+      "\u5065\u5EB7\u8BCA\u65AD",
+      "healthDiagnosis.scorecard",
+      "\u7EA2\u7EFF\u706F\u8868 \u22656 \u884C\uFF08\u5E73\u53F0/\u56FD\u5BB6/\u5E7F\u544A\u7EC4/\u53D7\u4F17\u7B49\uFF09"
+    );
+  }
+  for (const key of ["platform", "country", "adSets"]) {
+    const insight = textLen(asRecord6(sections?.[key])?.insight);
+    if (insight < 200) {
+      pushMissing(
+        missing,
+        `sections-${key}`,
+        "\u6DF1\u5EA6\u89E3\u8BFB",
+        `sections.${key}.insight`,
+        "\u2265200 \u5B57\uFF0C\u5F15\u7528\u5F53\u6B21\u5E73\u53F0/\u56FD\u5BB6/\u5E7F\u544A\u7EC4\u6570\u636E"
+      );
+    }
+  }
+  const audience = asRecord6(sections?.audience);
+  if (asArray(audience?.goldenProfile).filter((s) => textLen(s) > 0).length < 3) {
+    pushMissing(
+      missing,
+      "sections-audience-golden",
+      "\u6DF1\u5EA6\u89E3\u8BFB",
+      "sections.audience.goldenProfile",
+      "\u22653 \u6761\u9EC4\u91D1\u53D7\u4F17\u753B\u50CF"
+    );
+  }
+  if (asArray(audience?.antiProfile).filter((s) => textLen(s) > 0).length < 2) {
+    pushMissing(
+      missing,
+      "sections-audience-anti",
+      "\u6DF1\u5EA6\u89E3\u8BFB",
+      "sections.audience.antiProfile",
+      "\u22652 \u6761\u53CD\u753B\u50CF"
+    );
+  }
+  if (textLen(audience?.insight) < 150) {
+    pushMissing(
+      missing,
+      "sections-audience-insight",
+      "\u6DF1\u5EA6\u89E3\u8BFB",
+      "sections.audience.insight",
+      "\u2265150 \u5B57"
+    );
+  }
+  const landingRows = asArray(asRecord6(sections?.landingPage)?.rows);
+  if (landingRows.length < 3) {
+    pushMissing(
+      missing,
+      "sections-landing",
+      "\u843D\u5730\u9875\u5206\u6790",
+      "sections.landingPage.rows",
+      "\u22653 \u884C\uFF08\u5FC3\u7406\u963B\u788D/\u6570\u636E\u4FE1\u53F7/\u63A8\u6F14/\u4F18\u5148\u7EA7\uFF09"
+    );
+  }
+  if (abTests.length < 3) {
+    pushMissing(
+      missing,
+      "ab-tests",
+      "A/B \u5B9E\u9A8C",
+      "abTests",
+      "\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);
+  if (today.length < 2 || thisWeek.length < 3 || thisMonth.length < 3) {
+    pushMissing(
+      missing,
+      "action-checklist",
+      "\u53EF\u6267\u884C\u6E05\u5355",
+      "actionChecklist",
+      "today \u22652\u3001thisWeek \u22653\u3001thisMonth \u22653 \u6761\u53EF\u6267\u884C\u9879"
+    );
+  }
+  return {
+    ok: missing.length === 0,
+    missing,
+    stats: {
+      recommendationCount: recommendations.length,
+      supplementaryCount: supplementary.length,
+      fourQuestionsCount: fourQuestions.length,
+      scorecardRows: scorecard.length,
+      regionalNarratives,
+      adSetsWithSpend
+    }
+  };
+}
+function formatMetaPeriodReportErrors(result) {
+  if (result.ok) return "";
+  const lines = result.missing.map((m) => `  - [${m.chapter}] ${m.dimension}\uFF1A${m.hint}`);
+  return [
+    `\u62A5\u544A JSON \u7F3A\u5C11 ${result.missing.length} \u9879\u5FC5\u542B\u5185\u5BB9\uFF08\u5BF9\u9F50 meta-period-report-rules.md\uFF09\uFF1A`,
+    ...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"
+  ].join("\n");
+}
+
 // src/commands/facebook-analysis/render-report.ts
 var TEMPLATE_BASENAMES2 = {
   html: "meta-period-report.html",
@@ -122789,7 +123194,7 @@ async function readJsonFile2(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord6(value) {
+function asRecord7(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -122804,10 +123209,22 @@ function injectReportData2(html, payload) {
 }
 async function runFacebookAnalysisRender(opts) {
   const dataPath = path24.resolve(opts.dataFile);
-  let data = asRecord6(await readJsonFile2(dataPath));
+  let data = asRecord7(await readJsonFile2(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeFacebookSnapshotIntoReport(data, path24.resolve(opts.snapshotDir));
   }
+  const contentCheck = validateMetaPeriodReportContent(data);
+  if (!contentCheck.ok) {
+    console.error(`
+\u274C ${formatMetaPeriodReportErrors(contentCheck)}
+`);
+    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}
+`
+    );
+    process.exit(1);
+  }
   const templatePath = metaPeriodReportTemplatePath();
   let html;
   try {
@@ -122833,9 +123250,14 @@ async function runFacebookAnalysisRender(opts) {
     runtimeCopied = true;
   } catch {
   }
+  const { stats } = contentCheck;
   console.log(`
 \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}
+`
+  );
   if (runtimeCopied) {
     console.log(`   \u8FD0\u884C\u65F6\u811A\u672C\uFF1A${runtimeOut}
 `);
@@ -122997,7 +123419,7 @@ function registerFacebookAnalysisCommands(program2) {
   );
   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"
+    "\u6839\u636E Agent \u64B0\u5199\u7684\u62A5\u544A JSON \u751F\u6210 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u7EC8\u7A3F\uFF08\u6821\u9A8C\u5FC5\u542B\u5B57\u6BB5\uFF0C\u7F3A\u9879\u62D2\u7EDD\u6E32\u67D3\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"

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.28-beta.5",
-  "publishedAt": 1780990385456
+  "version": "1.1.28-beta.6",
+  "publishedAt": 1780991035189
 }

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

@@ -20,7 +20,7 @@ Agent JSON Schema：`assets/meta-period-report.schema.json`。
 | **1. 拉数** | Agent 调 CLI | `facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb` |
 | **2. 分析** | Agent | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察 |
 | **3. 写 JSON** | Agent | 按本纲要撰写 `meta-period-report.json`（`meta` / `narrative` / 可选 HTML 扩展字段） |
-| **4. 渲染 HTML** | CLI | `facebook-analysis render` — **禁止** Agent 手写/拼接 HTML |
+| **4. 渲染 HTML** | CLI | `facebook-analysis render` — **校验 JSON 必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML |
 
 ```bash
 # 步骤 1

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.28-beta.5'
+$PKG_VERSION = '1.1.28-beta.6'
 $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.28-beta.5"
+readonly PKG_VERSION="1.1.28-beta.6"
 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.28-beta.5",
+  "version": "1.1.28-beta.6",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",