siluzan-tso-cli 1.1.35-beta.3 → 1.1.35-beta.4

package/README.md

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

package/dist/index.js

@@ -105346,12 +105346,12 @@ init_cli_json_snapshot();
 
 // src/utils/list-json-envelope.ts
 function wrapListJson(params) {
-  const itemCount = Array.isArray(params.items) ? params.items.length : 0;
+  const itemCount2 = Array.isArray(params.items) ? params.items.length : 0;
   return {
     page: params.page,
     pageSize: params.pageSize,
     total: params.total === void 0 || params.total === null ? null : params.total,
-    itemCount,
+    itemCount: itemCount2,
     items: params.items
   };
 }
@@ -124534,7 +124534,7 @@ function buildGoogleAdsDiagnosisCollectAgentHint(snapDir) {
     "Google Ads \u8BCA\u65AD collect \u5DF2\u5B8C\u6210\uFF08\u4EC5\u4E8B\u5B9E\u6570\u636E\uFF0C\u4E0D\u542B\u5EFA\u8BAE\u6027\u6587\u6848\uFF09\u3002",
     `1) Read ${dir}/${GOOGLE_ADS_DIAGNOSIS_COLLECT_BASENAME}\uFF08reportData + agentBrief\uFF09\uFF1B`,
     "2) Read references/report-templates/google-ads-diagnosis.md\uFF0C\u7531 Agent \u64B0\u5199\u5168\u90E8 analysis/suggestions\u3001diagnosisOverview\u3001summary\u3001accountInfo.businessModel/industry\u3001budgetCompetitiveness[].strategy\u3001newFeatures[].optimizerRecommendation\u3001adCreativeOptimization.items[].suggestion \u7B49\uFF1B",
-    `3) \u5C06 reportData \u4E0E\u53D9\u4E8B\u5B57\u6BB5\u5408\u5E76\u5199\u5165 ${dir}/${GOOGLE_ADS_DIAGNOSIS_REPORT_BASENAME}\uFF08**\u7981\u6B62\u6539\u5199** campaigns/geographic/keywords \u7684 items \u884C\uFF0C\u53EA\u586B analysis/suggestions\uFF09\uFF1B`,
+    `3) \u5C06 reportData \u4E0E\u53D9\u4E8B\u5B57\u6BB5\u5408\u5E76\u5199\u5165 ${dir}/${GOOGLE_ADS_DIAGNOSIS_REPORT_BASENAME}\uFF08**\u7981\u6B62\u5199\u5165/\u8986\u76D6** campaigns/geographic/keywords \u7684 items \u884C\uFF0C\u53EA\u586B analysis/suggestions\uFF1Bitems \u4EE5 collect \u4E3A\u51C6\uFF0Crender \u4F1A\u81EA\u52A8\u8986\u76D6 Agent \u6539\u52A8\u7684\u5BF9\u6BD4\u8868\uFF09\uFF1B`,
     `4) siluzan-tso google-ads-diagnosis render --data ${dir}/${GOOGLE_ADS_DIAGNOSIS_REPORT_BASENAME} --out ${dir}/google-ads-diagnosis-report.html\uFF08\u9ED8\u8BA4\u540C\u76EE\u5F55 collect \u81EA\u52A8\u6062\u590D\u88AB\u6539\u574F\u7684 items\uFF09\u3002`,
     "\u7981\u6B62\u5728\u672A\u7ECF\u8FC7 Agent \u64B0\u5199\u7684\u60C5\u51B5\u4E0B\u76F4\u63A5 render collect \u4EA7\u7269\uFF1B\u7F3A\u4EFB\u4E00\u5EFA\u8BAE\u5B57\u6BB5 render \u4F1A\u5931\u8D25\u3002"
   ].join("\n");
@@ -124587,6 +124587,20 @@ function buildGoogleAdsDiagnosisAgentBrief(input) {
       campaigns: input.campaignHints,
       keywords: input.keywordHints
     },
+    comparisonTableItemCounts: input.comparisonTableItemCounts,
+    agentRules: {
+      doNotModifyItemRows: [
+        "campaigns.items",
+        "geographic.items",
+        "keywords.items"
+      ],
+      renderRestoresComparisonItemsFromCollect: "render \u9ED8\u8BA4\u540C\u76EE\u5F55 google-ads-diagnosis-collect.json \u4F1A\u4EE5 collect \u8986\u76D6\u4E0A\u8FF0 items\uFF08Agent \u53EA\u586B analysis/suggestions\uFF09",
+      mayEditItemFields: [
+        "biddingStrategy.items[].recommendationReason",
+        "newFeatures.items[].optimizerRecommendation",
+        "adCreativeOptimization.items[].suggestion"
+      ]
+    },
     agentDeliverable: {
       outputFile: "google-ads-diagnosis.json",
       structure: "\u4E0E reportData \u540C\u7ED3\u6784\u7684 sectionData\uFF1B\u987B\u586B diagnosisOverview\u3001metrics.analysis/suggestions\u3001\u5404\u6A21\u5757 analysis/suggestions\u3001summary.keyIssues\u3001summary.optimizationRoadmap[]\uFF08priority/focusArea/actionItems/expectedOutcome\uFF09\u3001budgetCompetitiveness[].strategy\u3001newFeatures[].optimizerRecommendation \u7B49",
@@ -125380,11 +125394,58 @@ function buildGoogleAdsDiagnosisCollectPayload(opts) {
       profile.industry,
       ...campaignCurrent.map((r) => String(r.campaignName ?? ""))
     ].filter(Boolean),
-    keywordHints: zeroConvKw.slice(0, 5).map((r) => String(r.keyword ?? ""))
+    keywordHints: zeroConvKw.slice(0, 5).map((r) => String(r.keyword ?? "")),
+    comparisonTableItemCounts: {
+      campaigns: campaignItems.length,
+      geographic: geoItems.length,
+      keywords: kwItems.length
+    }
   });
   return { reportData: data, agentBrief };
 }
 
+// src/commands/google-ads-diagnosis/collect-integrity.ts
+function asRecord5(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function itemCount(block) {
+  const items = asRecord5(block)?.items;
+  return Array.isArray(items) ? items.length : 0;
+}
+function getCollectIntegrityWarnings(reportData) {
+  const warnings = [];
+  const kwItems = itemCount(reportData.keywords);
+  const fullKwItems = itemCount(reportData.fullKeywords);
+  const keywordCount = Number(asRecord5(reportData.structure)?.keywordCount ?? 0);
+  if (kwItems === 0 && fullKwItems > 0) {
+    warnings.push(
+      `keywords.items \u5BF9\u6BD4\u8868\u4E3A\u7A7A\uFF0C\u4F46 fullKeywords.items \u6709 ${fullKwItems} \u884C\uFF1B\u8BF7\u786E\u8BA4 collect \u662F\u5426\u6210\u529F\u62C9\u53D6\u4E0A\u4E00\u5468\u671F keywords \u5FEB\u7167\uFF08\u73AF\u6BD4\u5217\u4F9D\u8D56 prev \u5468\u671F JSON\uFF09\u3002`
+    );
+  } else if (kwItems === 0 && keywordCount > 0) {
+    warnings.push(
+      `keywords.items \u5BF9\u6BD4\u8868\u4E3A\u7A7A\uFF0C\u4F46 structure.keywordCount=${keywordCount}\uFF1B\u8BF7\u786E\u8BA4\u4E0A\u4E00\u5468\u671F keywords \u5FEB\u7167\u662F\u5426\u62C9\u53D6\u6210\u529F\u3002`
+    );
+  }
+  const campaignItems = itemCount(reportData.campaigns);
+  const campaignCount = Number(asRecord5(reportData.structure)?.campaignCount ?? 0);
+  if (campaignItems === 0 && campaignCount > 0) {
+    warnings.push(
+      `campaigns.items \u5BF9\u6BD4\u8868\u4E3A\u7A7A\uFF0C\u4F46 structure.campaignCount=${campaignCount}\uFF1B\u8BF7\u786E\u8BA4\u4E0A\u4E00\u5468\u671F campaigns \u5FEB\u7167\u662F\u5426\u62C9\u53D6\u6210\u529F\u3002`
+    );
+  }
+  const geoItems = itemCount(reportData.geographic);
+  const fullGeoItems = itemCount(reportData.fullGeographic);
+  if (geoItems === 0 && fullGeoItems > 0) {
+    warnings.push(
+      `geographic.items \u5BF9\u6BD4\u8868\u4E3A\u7A7A\uFF0C\u4F46 fullGeographic.items \u6709 ${fullGeoItems} \u884C\uFF1B\u8BF7\u786E\u8BA4\u4E0A\u4E00\u5468\u671F geographic \u5FEB\u7167\u662F\u5426\u62C9\u53D6\u6210\u529F\u3002`
+    );
+  }
+  return warnings;
+}
+
 // src/commands/google-ads-diagnosis/invoke-google-analysis.ts
 import { spawnSync as spawnSync2 } from "child_process";
 function invokeGoogleAnalysisCli(opts) {
@@ -125527,6 +125588,12 @@ async function runGoogleAdsDiagnosisCollect(opts) {
     website: websiteUrl || opts.website,
     landingPage
   });
+  for (const warning of getCollectIntegrityWarnings(reportData)) {
+    console.error(`
+\u26A0\uFE0F  collect \u5B8C\u6574\u6027\uFF1A${warning}
+`);
+    degraded = true;
+  }
   const collectPayload = {
     kind: "siluzan-tso-google-ads-diagnosis-collect",
     collectedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -125567,7 +125634,7 @@ import fs18 from "fs/promises";
 import path23 from "path";
 
 // src/commands/google-ads-diagnosis/report-content.ts
-function asRecord5(value) {
+function asRecord6(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125576,7 +125643,7 @@ function asRecord5(value) {
 function getNestedValue(root, path34) {
   let cur = root;
   for (const key of path34) {
-    const rec = asRecord5(cur);
+    const rec = asRecord6(cur);
     if (!rec) return void 0;
     cur = rec[key];
   }
@@ -125593,7 +125660,7 @@ function validateBudgetCompetitivenessStrategies(data) {
   }
   const warnings = [];
   for (let i = 0; i < items.length; i++) {
-    const row = asRecord5(items[i]);
+    const row = asRecord6(items[i]);
     const name2 = String(row?.name ?? row?.metric ?? i);
     if (!hasNarrativeContent(row?.strategy)) {
       warnings.push(`budgetCompetitiveness[${name2}].strategy \u4E3A\u7A7A\uFF08\u987B\u7531 Agent \u586B\u5199\uFF09`);
@@ -125602,13 +125669,13 @@ function validateBudgetCompetitivenessStrategies(data) {
   return warnings;
 }
 function validateNewFeatureRecommendations(data) {
-  const nf = asRecord5(data.newFeatures);
+  const nf = asRecord6(data.newFeatures);
   if (!nf) return [];
   const items = nf.items;
   if (!Array.isArray(items)) return [];
   const warnings = [];
   for (let i = 0; i < items.length; i++) {
-    const row = asRecord5(items[i]);
+    const row = asRecord6(items[i]);
     const name2 = String(row?.strategyName ?? row?.feature ?? row?.strategy ?? i);
     if (!hasNarrativeContent(row?.optimizerRecommendation)) {
       warnings.push(`newFeatures.items[${name2}].optimizerRecommendation \u4E3A\u7A7A\uFF08\u987B\u7531 Agent \u586B\u5199\uFF09`);
@@ -125617,13 +125684,13 @@ function validateNewFeatureRecommendations(data) {
   return warnings;
 }
 function validateAdCreativeItemSuggestions(data) {
-  const creative = asRecord5(data.adCreativeOptimization);
+  const creative = asRecord6(data.adCreativeOptimization);
   if (!creative) return [];
   const items = creative.items;
   if (!Array.isArray(items) || items.length === 0) return [];
   const warnings = [];
   for (let i = 0; i < items.length; i++) {
-    const row = asRecord5(items[i]);
+    const row = asRecord6(items[i]);
     const title = String(row?.adTitle ?? i);
     if (!hasNarrativeContent(row?.suggestion ?? row?.suggestions)) {
       warnings.push(
@@ -125638,7 +125705,7 @@ function validateGoogleAdsDiagnosisContent(data) {
     (key) => data[key] === void 0
   );
   const warnings = [];
-  const accountInfo = asRecord5(data.accountInfo);
+  const accountInfo = asRecord6(data.accountInfo);
   if (accountInfo && !accountInfo.companyName && !accountInfo.period) {
     warnings.push("accountInfo \u7F3A\u5C11 companyName \u4E0E period\uFF0C\u9875\u7709\u53EF\u80FD\u4E3A\u7A7A");
   }
@@ -125686,7 +125753,7 @@ var GOOGLE_ADS_DIAGNOSIS_RESTORE_ITEM_MODULES = [
   GOOGLE_ADS_DIAGNOSIS_BIDDING_STRATEGY_MODULE,
   GOOGLE_ADS_DIAGNOSIS_NEW_FEATURES_MODULE
 ];
-function asRecord6(value) {
+function asRecord7(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125697,7 +125764,7 @@ function isValidRateChange(value) {
   return typeof value === "number" && Number.isFinite(value);
 }
 function isComparisonTableRowValid(row) {
-  const rec = asRecord6(row);
+  const rec = asRecord7(row);
   if (!rec) return false;
   if (!String(rec.title ?? "").trim()) return false;
   if (!Number.isFinite(Number(rec.currentCost))) return false;
@@ -125709,12 +125776,12 @@ function isComparisonTableRowValid(row) {
   return true;
 }
 function isNewFeatureRowValid(row) {
-  const rec = asRecord6(row);
+  const rec = asRecord7(row);
   if (!rec) return false;
   return Boolean(String(rec.strategyName ?? rec.feature ?? rec.strategy ?? "").trim());
 }
 function isBiddingStrategyRowValid(row) {
-  const rec = asRecord6(row);
+  const rec = asRecord7(row);
   if (!rec) return false;
   if (!String(rec.campaignName ?? "").trim()) return false;
   if (!Number.isFinite(Number(rec.duration)) || Number(rec.duration) <= 0) return false;
@@ -125739,14 +125806,32 @@ function moduleItemsNeedRestore(items, validator) {
   if (!Array.isArray(items) || items.length === 0) return false;
   return items.some((row) => !validator(row));
 }
+function isComparisonTableModule(mod) {
+  return GOOGLE_ADS_DIAGNOSIS_COMPARISON_MODULES.includes(mod);
+}
+function comparisonItemsDifferFromCollect(finalItems, collectItems) {
+  if (!Array.isArray(finalItems)) return true;
+  if (finalItems.length !== collectItems.length) return true;
+  return JSON.stringify(finalItems) !== JSON.stringify(collectItems);
+}
 function getFactItemsErrors(data) {
   const errors = [];
   for (const mod of GOOGLE_ADS_DIAGNOSIS_RESTORE_ITEM_MODULES) {
     const validator = MODULE_ITEM_VALIDATORS[mod];
     const hint = MODULE_ITEM_ERROR_HINT[mod];
-    const block = asRecord6(data[mod]);
+    const block = asRecord7(data[mod]);
     const items = block?.items;
-    if (!Array.isArray(items) || items.length === 0) continue;
+    if (!Array.isArray(items) || items.length === 0) {
+      if (mod === "keywords") {
+        const fullKw = asRecord7(data.fullKeywords)?.items;
+        if (Array.isArray(fullKw) && fullKw.length > 0) {
+          errors.push(
+            "keywords.items \u4E3A\u7A7A\u4F46 fullKeywords.items \u6709\u6570\u636E\uFF1B\u8BF7\u4FDD\u7559\u540C\u76EE\u5F55 google-ads-diagnosis-collect.json \u540E\u91CD\u65B0 render\uFF08\u4F1A\u81EA\u52A8\u6062\u590D\u5BF9\u6BD4\u8868\uFF09"
+          );
+        }
+      }
+      continue;
+    }
     for (let i = 0; i < items.length; i++) {
       if (!validator(items[i])) {
         errors.push(`${mod}.items[${i}] ${hint}`);
@@ -125763,15 +125848,15 @@ var LANDING_PAGE_SPEED_KEYS = [
   "speedIndex"
 ];
 function isLandingPageSpeedValid(value) {
-  const rec = asRecord6(value);
+  const rec = asRecord7(value);
   if (!rec) return false;
   return LANDING_PAGE_SPEED_KEYS.every(
     (key) => typeof rec[key] === "number" && Number.isFinite(rec[key])
   );
 }
 function restoreLandingPageSpeedFromCollect(finalData, collectReportData) {
-  const finalBlock = asRecord6(finalData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
-  const collectBlock = asRecord6(collectReportData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
+  const finalBlock = asRecord7(finalData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
+  const collectBlock = asRecord7(collectReportData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
   if (!collectBlock) return { data: finalData, restored: false };
   const needsDesktop = !isLandingPageSpeedValid(finalBlock?.desktop) && isLandingPageSpeedValid(collectBlock.desktop);
   const needsMobile = !isLandingPageSpeedValid(finalBlock?.mobile) && isLandingPageSpeedValid(collectBlock.mobile);
@@ -125789,12 +125874,13 @@ function mergeComparisonItemsFromCollect(finalData, collectReportData) {
   const restoredModules = [];
   for (const mod of GOOGLE_ADS_DIAGNOSIS_RESTORE_ITEM_MODULES) {
     const validator = MODULE_ITEM_VALIDATORS[mod];
-    const finalBlock = asRecord6(data[mod]);
-    const collectBlock = asRecord6(collectReportData[mod]);
+    const finalBlock = asRecord7(data[mod]);
+    const collectBlock = asRecord7(collectReportData[mod]);
     const finalItems = finalBlock?.items;
     const collectItems = collectBlock?.items;
-    if (!moduleItemsNeedRestore(finalItems, validator)) continue;
     if (!Array.isArray(collectItems) || collectItems.length === 0) continue;
+    const needsRestore = isComparisonTableModule(mod) ? comparisonItemsDifferFromCollect(finalItems, collectItems) : moduleItemsNeedRestore(finalItems, validator);
+    if (!needsRestore) continue;
     data[mod] = {
       ...finalBlock ?? {},
       items: collectItems
@@ -125805,7 +125891,7 @@ function mergeComparisonItemsFromCollect(finalData, collectReportData) {
 }
 
 // src/commands/google-ads-diagnosis/narrative-consistency-check.ts
-function asRecord7(value) {
+function asRecord8(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125813,14 +125899,14 @@ function asRecord7(value) {
 }
 function collectNarrativeTexts(data) {
   const texts = [];
-  const summary = asRecord7(data.summary);
+  const summary = asRecord8(data.summary);
   if (Array.isArray(summary?.keyIssues)) {
     for (const item of summary.keyIssues) texts.push(String(item ?? ""));
   }
-  const overview = asRecord7(data.diagnosisOverview);
+  const overview = asRecord8(data.diagnosisOverview);
   if (Array.isArray(overview?.disadvantages)) {
     for (const item of overview.disadvantages) {
-      const rec = asRecord7(item);
+      const rec = asRecord8(item);
       if (rec) {
         texts.push(String(rec.title ?? ""), String(rec.description ?? ""));
       } else {
@@ -125831,16 +125917,16 @@ function collectNarrativeTexts(data) {
   return texts.filter((t) => t.trim().length > 0);
 }
 function newFeatureAccountStatus(data, strategy) {
-  const nf = asRecord7(data.newFeatures);
+  const nf = asRecord8(data.newFeatures);
   const items = nf?.items;
   if (!Array.isArray(items)) return null;
-  const row = items.find((it) => asRecord7(it)?.strategy === strategy);
-  const rec = asRecord7(row);
+  const row = items.find((it) => asRecord8(it)?.strategy === strategy);
+  const rec = asRecord8(row);
   if (!rec || typeof rec.accountStatus !== "boolean") return null;
   return rec.accountStatus;
 }
 function goldAccountFlag(data, key) {
-  const gold = asRecord7(data.goldAccount);
+  const gold = asRecord8(data.goldAccount);
   const value = gold?.[key];
   return typeof value === "boolean" ? value : null;
 }
@@ -125871,7 +125957,7 @@ function getNarrativeConsistencyErrors(data) {
 }
 
 // src/commands/google-ads-diagnosis/render-report.ts
-function asRecord8(value) {
+function asRecord9(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125880,8 +125966,8 @@ function asRecord8(value) {
 async function tryLoadCollectReportData(collectPath) {
   try {
     const raw = JSON.parse(await fs18.readFile(collectPath, "utf8"));
-    const root = asRecord8(raw);
-    const reportData = asRecord8(root?.reportData);
+    const root = asRecord9(raw);
+    const reportData = asRecord9(root?.reportData);
     return reportData ?? root;
   } catch {
     return null;
@@ -125898,7 +125984,7 @@ async function runGoogleAdsDiagnosisRender(opts) {
 `);
     process.exit(1);
   }
-  let data = asRecord8(dataRaw);
+  let data = asRecord9(dataRaw);
   if (!opts.noMergeCollect) {
     const collectPath = path23.resolve(
       opts.collectFile ?? path23.join(path23.dirname(dataPath), GOOGLE_ADS_DIAGNOSIS_COLLECT_BASENAME)
@@ -126411,7 +126497,7 @@ function ensureScorecardFromSnapshot(healthDiagnosis, merged) {
 }
 
 // src/commands/facebook-analysis/merge-snapshot.ts
-function asRecord9(value) {
+function asRecord10(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126460,7 +126546,7 @@ async function readManifest(snapshotDir) {
 async function loadSectionFile(snapshotDir, file) {
   try {
     const raw = await fs21.readFile(path28.join(snapshotDir, file), "utf8");
-    return asRecord9(JSON.parse(raw));
+    return asRecord10(JSON.parse(raw));
   } catch {
     return null;
   }
@@ -126508,7 +126594,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
     if (data) sectionMap.set(art.section, data);
   }
   const overview = sectionMap.get("overview");
-  const current = asRecord9(overview?.currentPeriod);
+  const current = asRecord10(overview?.currentPeriod);
   const accountName = typeof overview?.accountName === "string" ? overview.accountName : void 0;
   const accountId = manifest.accountId ?? (typeof overview?.accountId === "string" ? overview.accountId : void 0);
   const kpis = { ...payload.kpis ?? {} };
@@ -126630,7 +126716,7 @@ function isFiniteNumber(value) {
 function asArray2(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord10(value) {
+function asRecord11(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126642,26 +126728,26 @@ function pushMissing(missing, id, chapter, dimension, hint) {
 function countAdSetsWithSpend(tables) {
   const rows = asArray2(tables?.adSets);
   return rows.filter((row) => {
-    const r = asRecord10(row);
+    const r = asRecord11(row);
     const spend = r?.spend;
     return isFiniteNumber(spend) && spend > 0;
   }).length;
 }
 function chartLabels(chart) {
-  const c = asRecord10(chart);
+  const c = asRecord11(chart);
   return asArray2(c?.labels).length;
 }
 function validateMetaPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord10(data.meta) ?? {};
-  const kpis = asRecord10(data.kpis) ?? {};
-  const narrative = asRecord10(data.narrative) ?? {};
-  const tables = asRecord10(data.tables);
-  const charts = asRecord10(data.charts);
-  const sections = asRecord10(data.sections);
-  const health = asRecord10(data.healthDiagnosis);
-  const priorityPlan = asRecord10(data.priorityPlan);
-  const actionChecklist = asRecord10(data.actionChecklist);
+  const meta = asRecord11(data.meta) ?? {};
+  const kpis = asRecord11(data.kpis) ?? {};
+  const narrative = asRecord11(data.narrative) ?? {};
+  const tables = asRecord11(data.tables);
+  const charts = asRecord11(data.charts);
+  const sections = asRecord11(data.sections);
+  const health = asRecord11(data.healthDiagnosis);
+  const priorityPlan = asRecord11(data.priorityPlan);
+  const actionChecklist = asRecord11(data.actionChecklist);
   const adSetsWithSpend2 = countAdSetsWithSpend(tables ?? void 0);
   const regionalNarratives = asArray2(narrative.regional).length;
   const recommendations = asArray2(narrative.recommendations);
@@ -126733,7 +126819,7 @@ function validateMetaPeriodReportContent(data) {
       "charts.audience.labels \u81F3\u5C11 1 \u9879"
     );
   }
-  const funnel = asRecord10(charts?.funnel);
+  const funnel = asRecord11(charts?.funnel);
   if (!isFiniteNumber(funnel?.reach)) {
     pushMissing(
       missing,
@@ -126797,7 +126883,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < regionalNarratives; i++) {
-      const row = asRecord10(asArray2(narrative.regional)[i]);
+      const row = asRecord11(asArray2(narrative.regional)[i]);
       if (textLen2(row?.text) < 80) {
         pushMissing(
           missing,
@@ -126827,7 +126913,7 @@ function validateMetaPeriodReportContent(data) {
       "\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) => asRecord10(r)?.title);
+    const titles = recommendations.map((r) => asRecord11(r)?.title);
     for (const title of RECOMMENDATION_TITLES) {
       if (!titles.includes(title)) {
         pushMissing(
@@ -126840,7 +126926,7 @@ function validateMetaPeriodReportContent(data) {
       }
     }
     for (let i = 0; i < recommendations.length; i++) {
-      const rec = asRecord10(recommendations[i]);
+      const rec = asRecord11(recommendations[i]);
       if (textLen2(rec?.content) < 150) {
         pushMissing(
           missing,
@@ -126862,7 +126948,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < supplementary.length; i++) {
-      const row = asRecord10(supplementary[i]);
+      const row = asRecord11(supplementary[i]);
       if (!textLen2(row?.dimension) || !textLen2(row?.issue)) {
         pushMissing(
           missing,
@@ -126944,7 +127030,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < fourQuestions.length; i++) {
-      const q = asRecord10(fourQuestions[i]);
+      const q = asRecord11(fourQuestions[i]);
       const evidence = asArray2(q?.evidence).filter((e) => textLen2(e) > 0);
       if (evidence.length < 2) {
         pushMissing(
@@ -126968,7 +127054,7 @@ function validateMetaPeriodReportContent(data) {
   }
   let scorecardValidRows = 0;
   for (let i = 0; i < scorecard.length; i++) {
-    const row = asRecord10(scorecard[i]);
+    const row = asRecord11(scorecard[i]);
     const itemOk = textLen2(row?.item) > 0;
     const dataOk = textLen2(row?.data) > 0;
     const signalOk = SCORECARD_SIGNALS.includes(row?.signal);
@@ -127010,7 +127096,7 @@ function validateMetaPeriodReportContent(data) {
     );
   }
   for (const key of ["platform", "country", "adSets"]) {
-    const insight = textLen2(asRecord10(sections?.[key])?.insight);
+    const insight = textLen2(asRecord11(sections?.[key])?.insight);
     if (insight < 200) {
       pushMissing(
         missing,
@@ -127021,7 +127107,7 @@ function validateMetaPeriodReportContent(data) {
       );
     }
   }
-  const audience = asRecord10(sections?.audience);
+  const audience = asRecord11(sections?.audience);
   if (asArray2(audience?.goldenProfile).filter((s) => textLen2(s) > 0).length < 3) {
     pushMissing(
       missing,
@@ -127049,7 +127135,7 @@ function validateMetaPeriodReportContent(data) {
       "\u2265150 \u5B57"
     );
   }
-  const landingRows = asArray2(asRecord10(sections?.landingPage)?.rows);
+  const landingRows = asArray2(asRecord11(sections?.landingPage)?.rows);
   if (landingRows.length < 3) {
     pushMissing(
       missing,
@@ -127134,7 +127220,7 @@ async function readJsonFile2(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord11(value) {
+function asRecord12(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -127149,7 +127235,7 @@ function injectReportData2(html, payload) {
 }
 async function runFacebookAnalysisRender(opts) {
   const dataPath = path29.resolve(opts.dataFile);
-  let data = asRecord11(await readJsonFile2(dataPath));
+  let data = asRecord12(await readJsonFile2(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeFacebookSnapshotIntoReport(data, path29.resolve(opts.snapshotDir));
   }

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.35-beta.3",
-  "publishedAt": 1783323427829
+  "version": "1.1.35-beta.4",
+  "publishedAt": 1783328413873
 }

package/dist/skill/references/report-templates/google-ads-diagnosis.md

@@ -47,7 +47,7 @@ siluzan-tso google-ads-diagnosis render \
 - 若环比列全为 `null`，检查落盘目录是否存在上一周期文件（如 `campaigns-<id>_20260503-20260602.json`）；不存在则**重新执行 collect**（勿用手动拼装或 Python 脚本绕过 CLI）。
 
 - **render 自动合并（默认开启）**：若同目录存在 `google-ads-diagnosis-collect.json`，且 Agent 改坏了 `campaigns` / `geographic` / `keywords` 的 `items`（缺 `title`/`currentCost` 或环比写成字符串）或整体覆盖丢弃了 `landingPageAnalysis.desktop`/`mobile`，CLI **自动从 collect.reportData 恢复**，保留 Agent 的 `analysis`/`suggestions`。可用 `--no-merge-collect` 关闭；`--collect <file>` 指定 collect 路径。
-- **render 硬校验**：合并后对比表仍不完整则 **exit 1**（避免 HTML 表体全空）；`summary.keyIssues` / `diagnosisOverview.disadvantages` 与 `newFeatures`/`goldAccount` 等事实字段出现已知矛盾模式（见「撰写硬约束」第 5 条）时同样 **exit 1**。
+- **render 硬校验**：合并后对比表仍不完整则 **exit 1**（避免 HTML 表体全空）；`campaigns/geographic/keywords.items` 默认同目录 collect **整表覆盖** Agent 改动（Agent 只填 analysis/suggestions）；`summary.keyIssues` / `diagnosisOverview.disadvantages` 与 `newFeatures`/`goldAccount` 等事实字段出现已知矛盾模式（见「撰写硬约束」第 5 条）时同样 **exit 1**。
 
 - **禁止**在 `collect` 阶段生成或写入 `analysis` / `suggestions` / `diagnosisOverview` / `summary` 等建议性文案。
 - **禁止**跳过 Agent 直接 `render` collect 产物（`render` 会校验全部叙事 / 建议字段；调试可加 `--lenient`）。
@@ -130,6 +130,13 @@ siluzan-tso google-ads-diagnosis render \
 - `render` 会在同目录存在 `google-ads-diagnosis-collect.json` 时自动从 collect 恢复缺失/损坏的 `desktop`/`mobile`（保留 Agent 写的 `analysis`/`suggestions`），但**不能依赖这个兜底**——终稿应本就保留完整字段。
 - 若 `collect` 里 `desktop`/`mobile` 本身就是空/全 0（说明 Lighthouse 没有抓到数据），`analysis` 必须写「着陆页测速数据未获取」，**禁止**编造评分或分析文字。
 
+### 7. 环比对比表 `campaigns/geographic/keywords.items` — Agent 禁止写入
+
+- `collect` 已根据当期 + 上一周期快照生成对比行（`title`、`currentCost`/`previousCost`、`costRateChange`、`currentClicks`/`previousClicks`、`clicksRateChange`、`currentCvr`/`previousCvr`、`cvrRateChange`）。Agent 撰写终稿时**只填** `analysis` / `suggestions`，**禁止**写入、清空、删减或「手工重写」`items` 数组
+- `agentBrief.comparisonTableItemCounts` 给出 collect 侧行数（如 `keywords: 15`）；终稿 `keywords.items.length` 须与之一致。若 Agent 误改，`render` 会**始终以**同目录 `google-ads-diagnosis-collect.json` **覆盖**上述三个模块的 `items`（保留 Agent 的 narrative）。
+- 分析文案须引用对比表中的具体词/系列/国家名与环比数字（如「fitness mat 消耗 $230.60，环比下降 39.6%」），**禁止**在 `items` 有数据时写「关键词对比表为空」类结论。
+- `biddingStrategy.items` / `newFeatures.items` 行结构由 collect 生成，Agent 可在合法行上填写 `recommendationReason` / `optimizerRecommendation`，但勿篡改 `duration`（须为天数 number）、`biddingStrategyType`、`strategyName` 等事实字段。
+
 ---
 
 ## 页眉信息（报告头）
@@ -246,17 +253,19 @@ siluzan-tso google-ads-diagnosis render \
 - 指标列：花费(上期/本期/环比)、点击(上期/本期/环比)、转化率(上期/本期/环比)
 - **数据**：`campaigns.items`（`title`、`previousCost`、`currentCost`、`costRateChange`、`previousClicks`、`currentClicks`、`clicksRateChange`、`previousCvr`、`currentCvr`、`cvrRateChange`）
 - **分析 / 建议**：`campaigns.analysis`、`campaigns.suggestions`
-- **Agent 禁止改写 `items` 行**（须原样保留 collect `reportData`）；`render` 会从同目录 collect 自动恢复被改坏的 items
+- **Agent 禁止写入 `items` 行**（只填 `analysis`/`suggestions`）；`render` 会以 collect 为准**自动覆盖** Agent 改动的对比表 items
 
 #### 国家地区分析
 
 - 维度列：**国家/地区**
 - **数据**：`geographic.items`（同上结构）
+- **Agent 禁止写入 `items` 行**；`render` 自动从 collect 恢复
 
 #### 关键词分析
 
 - 维度列：**关键词**
-- **数据**：`keywords.items`
+- **数据**：`keywords.items`（字段同上；行数见 `agentBrief.comparisonTableItemCounts.keywords`）
+- **Agent 禁止写入/清空 `items`**；分析须引用表中具体词名与环比，勿写「对比表为空」
 
 #### 转化成本 / 按日趋势（若页面已渲染）
 

package/dist/skill/report-templates/google-ads-diagnosis.md

@@ -47,7 +47,7 @@ siluzan-tso google-ads-diagnosis render \
 - 若环比列全为 `null`，检查落盘目录是否存在上一周期文件（如 `campaigns-<id>_20260503-20260602.json`）；不存在则**重新执行 collect**（勿用手动拼装或 Python 脚本绕过 CLI）。
 
 - **render 自动合并（默认开启）**：若同目录存在 `google-ads-diagnosis-collect.json`，且 Agent 改坏了 `campaigns` / `geographic` / `keywords` 的 `items`（缺 `title`/`currentCost` 或环比写成字符串）或整体覆盖丢弃了 `landingPageAnalysis.desktop`/`mobile`，CLI **自动从 collect.reportData 恢复**，保留 Agent 的 `analysis`/`suggestions`。可用 `--no-merge-collect` 关闭；`--collect <file>` 指定 collect 路径。
-- **render 硬校验**：合并后对比表仍不完整则 **exit 1**（避免 HTML 表体全空）；`summary.keyIssues` / `diagnosisOverview.disadvantages` 与 `newFeatures`/`goldAccount` 等事实字段出现已知矛盾模式（见「撰写硬约束」第 5 条）时同样 **exit 1**。
+- **render 硬校验**：合并后对比表仍不完整则 **exit 1**（避免 HTML 表体全空）；`campaigns/geographic/keywords.items` 默认同目录 collect **整表覆盖** Agent 改动（Agent 只填 analysis/suggestions）；`summary.keyIssues` / `diagnosisOverview.disadvantages` 与 `newFeatures`/`goldAccount` 等事实字段出现已知矛盾模式（见「撰写硬约束」第 5 条）时同样 **exit 1**。
 
 - **禁止**在 `collect` 阶段生成或写入 `analysis` / `suggestions` / `diagnosisOverview` / `summary` 等建议性文案。
 - **禁止**跳过 Agent 直接 `render` collect 产物（`render` 会校验全部叙事 / 建议字段；调试可加 `--lenient`）。
@@ -130,6 +130,13 @@ siluzan-tso google-ads-diagnosis render \
 - `render` 会在同目录存在 `google-ads-diagnosis-collect.json` 时自动从 collect 恢复缺失/损坏的 `desktop`/`mobile`（保留 Agent 写的 `analysis`/`suggestions`），但**不能依赖这个兜底**——终稿应本就保留完整字段。
 - 若 `collect` 里 `desktop`/`mobile` 本身就是空/全 0（说明 Lighthouse 没有抓到数据），`analysis` 必须写「着陆页测速数据未获取」，**禁止**编造评分或分析文字。
 
+### 7. 环比对比表 `campaigns/geographic/keywords.items` — Agent 禁止写入
+
+- `collect` 已根据当期 + 上一周期快照生成对比行（`title`、`currentCost`/`previousCost`、`costRateChange`、`currentClicks`/`previousClicks`、`clicksRateChange`、`currentCvr`/`previousCvr`、`cvrRateChange`）。Agent 撰写终稿时**只填** `analysis` / `suggestions`，**禁止**写入、清空、删减或「手工重写」`items` 数组
+- `agentBrief.comparisonTableItemCounts` 给出 collect 侧行数（如 `keywords: 15`）；终稿 `keywords.items.length` 须与之一致。若 Agent 误改，`render` 会**始终以**同目录 `google-ads-diagnosis-collect.json` **覆盖**上述三个模块的 `items`（保留 Agent 的 narrative）。
+- 分析文案须引用对比表中的具体词/系列/国家名与环比数字（如「fitness mat 消耗 $230.60，环比下降 39.6%」），**禁止**在 `items` 有数据时写「关键词对比表为空」类结论。
+- `biddingStrategy.items` / `newFeatures.items` 行结构由 collect 生成，Agent 可在合法行上填写 `recommendationReason` / `optimizerRecommendation`，但勿篡改 `duration`（须为天数 number）、`biddingStrategyType`、`strategyName` 等事实字段。
+
 ---
 
 ## 页眉信息（报告头）
@@ -246,17 +253,19 @@ siluzan-tso google-ads-diagnosis render \
 - 指标列：花费(上期/本期/环比)、点击(上期/本期/环比)、转化率(上期/本期/环比)
 - **数据**：`campaigns.items`（`title`、`previousCost`、`currentCost`、`costRateChange`、`previousClicks`、`currentClicks`、`clicksRateChange`、`previousCvr`、`currentCvr`、`cvrRateChange`）
 - **分析 / 建议**：`campaigns.analysis`、`campaigns.suggestions`
-- **Agent 禁止改写 `items` 行**（须原样保留 collect `reportData`）；`render` 会从同目录 collect 自动恢复被改坏的 items
+- **Agent 禁止写入 `items` 行**（只填 `analysis`/`suggestions`）；`render` 会以 collect 为准**自动覆盖** Agent 改动的对比表 items
 
 #### 国家地区分析
 
 - 维度列：**国家/地区**
 - **数据**：`geographic.items`（同上结构）
+- **Agent 禁止写入 `items` 行**；`render` 自动从 collect 恢复
 
 #### 关键词分析
 
 - 维度列：**关键词**
-- **数据**：`keywords.items`
+- **数据**：`keywords.items`（字段同上；行数见 `agentBrief.comparisonTableItemCounts.keywords`）
+- **Agent 禁止写入/清空 `items`**；分析须引用表中具体词名与环比，勿写「对比表为空」
 
 #### 转化成本 / 按日趋势（若页面已渲染）
 

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