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

package/README.md

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

package/dist/index.js

@@ -4329,6 +4329,44 @@ function groupAccountIdsByOverviewRoute(cliMedia, accountIds, accountMediaTypes)
   }
   return groups;
 }
+function routeToBalanceMedia(route) {
+  if (route === "FacebookAds") return "MetaAd";
+  if (BALANCE_SUPPORTED_MEDIA.includes(route)) {
+    return route;
+  }
+  return null;
+}
+function applyRealtimeBalanceIfNeeded(item, bal) {
+  if (bal == null || typeof bal.remainingAccountBudget !== "number") return;
+  if (bal.remainingAccountBudget > 0) {
+    item.remainingAccountBudget = bal.remainingAccountBudget;
+  }
+  if (bal.currencyCode) item.currencyCode = bal.currencyCode;
+  if (bal.status) item.status = bal.status;
+}
+async function overlayRealtimeBalanceOnOverviewMap(route, overviewMap, config, verbose) {
+  const media = routeToBalanceMedia(route);
+  if (!media || overviewMap.size === 0) return;
+  const ids = [...overviewMap.keys()];
+  const balanceMap = await fetchBalanceMap(media, ids, config, void 0, void 0, verbose);
+  for (const [id, item] of overviewMap) {
+    applyRealtimeBalanceIfNeeded(item, balanceMap.get(id));
+  }
+}
+async function enrichOverviewRecordWithRealtimeBalance(media, accountId, config, record, verbose) {
+  if (!BALANCE_SUPPORTED_MEDIA.includes(media)) {
+    return record;
+  }
+  const balanceMap = await fetchBalanceMap(media, [accountId], config, void 0, void 0, verbose);
+  const bal = balanceMap.get(accountId);
+  if (bal == null) return record;
+  const out = { ...record };
+  applyRealtimeBalanceIfNeeded(out, bal);
+  if (bal.name && out["accountName"] == null && out["mediaCustomerName"] == null) {
+    out["mediaCustomerName"] = bal.name;
+  }
+  return out;
+}
 async function fetchBalanceMap(media, accountIds, config, startDate, endDate, verbose) {
   const result = /* @__PURE__ */ new Map();
   if (accountIds.length === 0) return result;
@@ -4462,70 +4500,73 @@ async function fetchOverviewMap(route, accountIds, config, startDate, endDate, v
       for (const row of rows) {
         result.set(row.mediaAccountId, row);
       }
-      return result;
-    }
-    const fetchLegacyBatch = async (ids) => {
-      const batch = /* @__PURE__ */ new Map();
-      const params = new URLSearchParams({
-        period: "true",
-        startDate: start,
-        endDate: end,
-        mediaCustomerIds: ids.join(",")
-      });
-      const url = `${config.apiBaseUrl}/report/media-account/${route}/accountsoverview?${params}`;
-      const raw = await apiFetch2(url, config, {}, verbose);
-      const items = Array.isArray(raw) ? raw : [];
-      for (const item of items) {
-        if (item.mediaAccountId != null) {
-          batch.set(String(item.mediaAccountId), item);
+    } else {
+      const fetchLegacyBatch = async (ids) => {
+        const batch = /* @__PURE__ */ new Map();
+        const params = new URLSearchParams({
+          period: "true",
+          startDate: start,
+          endDate: end,
+          mediaCustomerIds: ids.join(",")
+        });
+        const url = `${config.apiBaseUrl}/report/media-account/${route}/accountsoverview?${params}`;
+        const raw = await apiFetch2(url, config, {}, verbose);
+        const items = Array.isArray(raw) ? raw : [];
+        for (const item of items) {
+          if (item.mediaAccountId != null) {
+            batch.set(String(item.mediaAccountId), item);
+          }
         }
-      }
-      return batch;
-    };
-    const mergeOverview = (batch) => {
-      for (const [k, v] of batch) result.set(k, v);
-    };
-    if (accountIds.length === 1) {
-      mergeOverview(await fetchLegacyBatch(accountIds));
-      return result;
-    }
-    try {
-      const batch = await fetchLegacyBatch(accountIds);
-      mergeOverview(batch);
-      if (batch.size === 0) {
-        for (const id of accountIds) {
-          try {
-            mergeOverview(await fetchLegacyBatch([id]));
-          } catch (singleErr) {
-            if (verbose) {
-              process.stderr.write(
-                `[fetchOverviewMap] \u9010\u6237\u91CD\u8BD5\u5931\u8D25 ${id}\uFF1A${singleErr instanceof Error ? singleErr.message : String(singleErr)}
+        return batch;
+      };
+      const mergeOverview = (batch) => {
+        for (const [k, v] of batch) result.set(k, v);
+      };
+      if (accountIds.length === 1) {
+        mergeOverview(await fetchLegacyBatch(accountIds));
+      } else {
+        try {
+          const batch = await fetchLegacyBatch(accountIds);
+          mergeOverview(batch);
+          if (batch.size === 0) {
+            for (const id of accountIds) {
+              try {
+                mergeOverview(await fetchLegacyBatch([id]));
+              } catch (singleErr) {
+                if (verbose) {
+                  process.stderr.write(
+                    `[fetchOverviewMap] \u9010\u6237\u91CD\u8BD5\u5931\u8D25 ${id}\uFF1A${singleErr instanceof Error ? singleErr.message : String(singleErr)}
 `
-              );
+                  );
+                }
+              }
             }
           }
-        }
-      }
-    } catch (err) {
-      if (verbose) {
-        process.stderr.write(
-          `[fetchOverviewMap] \u6279\u91CF\u5F02\u5E38\uFF0C\u9010\u6237\u91CD\u8BD5\uFF1A${err instanceof Error ? err.message : String(err)}
-`
-        );
-      }
-      for (const id of accountIds) {
-        try {
-          mergeOverview(await fetchLegacyBatch([id]));
-        } catch (singleErr) {
+        } catch (err) {
           if (verbose) {
             process.stderr.write(
-              `[fetchOverviewMap] \u9010\u6237\u91CD\u8BD5\u5931\u8D25 ${id}\uFF1A${singleErr instanceof Error ? singleErr.message : String(singleErr)}
+              `[fetchOverviewMap] \u6279\u91CF\u5F02\u5E38\uFF0C\u9010\u6237\u91CD\u8BD5\uFF1A${err instanceof Error ? err.message : String(err)}
 `
             );
           }
+          for (const id of accountIds) {
+            try {
+              mergeOverview(await fetchLegacyBatch([id]));
+            } catch (singleErr) {
+              if (verbose) {
+                process.stderr.write(
+                  `[fetchOverviewMap] \u9010\u6237\u91CD\u8BD5\u5931\u8D25 ${id}\uFF1A${singleErr instanceof Error ? singleErr.message : String(singleErr)}
+`
+                );
+              }
+            }
+          }
         }
       }
     }
+    if (result.size > 0) {
+      await overlayRealtimeBalanceOnOverviewMap(route, result, config, verbose);
+    }
   } catch (err) {
     if (verbose) {
       process.stderr.write(
@@ -106210,11 +106251,15 @@ async function runStats(opts) {
         }
       }
     } else {
-      const params = new URLSearchParams({ startDate, endDate, period: "true" });
-      params.set("mediaCustomerIds", ids.join(","));
-      const url = `${config.apiBaseUrl}/report/media-account/${opts.media}/accountsoverview?${params.toString()}`;
-      const raw = await apiFetch2(url, config, {}, opts.verbose);
-      items = Array.isArray(raw) ? raw : raw.items ?? [];
+      const map = await fetchOverviewMap(
+        opts.media,
+        ids,
+        config,
+        startDate,
+        endDate,
+        opts.verbose
+      );
+      items = [...map.values()];
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -107748,6 +107793,7 @@ async function fetchBingJson(config, url, verbose) {
 
 // src/commands/report-bing-analysis/run.ts
 init_auth();
+init_balance();
 async function runReportBingOverview(opts) {
   const id = assertBingAccountId(opts.account);
   const { startDate, endDate } = resolveBingDateRange(opts.start, opts.end);
@@ -107755,7 +107801,14 @@ async function runReportBingOverview(opts) {
   const params = new URLSearchParams({ startDate, endDate });
   const url = reportingUrl2(config, id, "OverviewSectionData", params.toString());
   try {
-    const data = await fetchBingJson(config, url, !!opts.verbose);
+    const raw = await fetchBingJson(config, url, !!opts.verbose);
+    const data = raw && typeof raw === "object" && !Array.isArray(raw) ? await enrichOverviewRecordWithRealtimeBalance(
+      "BingV2",
+      id,
+      config,
+      raw,
+      opts.verbose
+    ) : raw;
     if (opts.jsonOut) {
       await emitBingSnapshot(opts, "bing-overview", id, startDate, endDate, data);
       return;
@@ -121000,6 +121053,27 @@ async function runAccountAuth(opts) {
     tryOpenBrowser: tryOpenHttpsUrlInBrowser
   });
 }
+async function runAccountReauth(opts) {
+  if (!opts.id && (!opts.ids || opts.ids.length === 0)) {
+    console.error(
+      "\n\u274C \u91CD\u65B0\u6388\u6743\u987B\u6307\u5B9A\u8981\u89E3\u7ED1\u7684\u8D26\u6237 entityId\uFF1A--id <entityId> \u6216 --ids id1,id2\n   entityId \u6765\u81EA list-accounts --json-out \u7684 ma.entityId\uFF08\u4E0D\u662F mediaCustomerId\uFF09\n"
+    );
+    process.exit(1);
+  }
+  console.log("\n\u6B65\u9AA4 1/2\uFF1A\u65AD\u5F00\u5173\u8054\uFF08\u91CD\u65B0\u6388\u6743\u524D\u5FC5\u987B\u5148\u89E3\u7ED1\uFF0C\u5BF9\u9F50\u7F51\u9875\u300C\u91CD\u65B0\u6388\u6743\u300D\uFF09\u2026\n");
+  await runAccountDelink({
+    token: opts.token,
+    id: opts.id,
+    ids: opts.ids,
+    verbose: opts.verbose
+  });
+  console.log("\u6B65\u9AA4 2/2\uFF1A\u53D1\u8D77 OAuth \u6388\u6743\u2026\n");
+  await runAccountAuth({
+    token: opts.token,
+    media: opts.media,
+    verbose: opts.verbose
+  });
+}
 
 // src/commands/account-manage/google-mcc.ts
 init_auth();
@@ -121959,12 +122033,30 @@ function register23(program2) {
       });
     }
   );
-  accountCmd.command("auth").description("\u6DFB\u52A0\u6388\u6743\uFF1A\u53D1\u8D77\u5A92\u4F53 OAuth\uFF0C\u6D4F\u89C8\u5668\u6253\u5F00\u6388\u6743\u9875\uFF08\u7F51\u9875 manageAccounts\u300C\u6DFB\u52A0\u6388\u6743\u300D\uFF09").requiredOption(
+  accountCmd.command("auth").description(
+    "\u6DFB\u52A0\u6388\u6743\uFF1A\u9996\u6B21\u7ED1\u5B9A\u5A92\u4F53\u8D26\u6237 OAuth\uFF08\u7F51\u9875 manageAccounts\u300C\u6DFB\u52A0\u6388\u6743\u300D\uFF09\uFF1BOAuth \u5931\u6548\u8BF7\u7528 reauth"
+  ).requiredOption(
     "-m, --media <type>",
     "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Meta | Yandex | BingV2 | Kwai"
   ).option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
     await runAccountAuth({ token: opts.token, media: opts.media, verbose: opts.verbose });
   });
+  accountCmd.command("reauth").description(
+    "\u91CD\u65B0\u6388\u6743\uFF1A\u5148\u89E3\u7ED1\u518D OAuth\uFF08\u7F51\u9875 manageAccounts\u300C\u91CD\u65B0\u6388\u6743\u300D\uFF1BinvalidOAuthToken \u5931\u6548\u65F6\u5FC5\u8D70\u6B64\u547D\u4EE4\uFF09"
+  ).requiredOption(
+    "-m, --media <type>",
+    "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Meta | Yandex | BingV2 | Kwai"
+  ).option("--id <entityId>", "\u5355\u4E2A\u8D26\u6237 entityId\uFF08\u6765\u81EA list-accounts \u7684 ma.entityId\uFF09").option("--ids <entityIds>", "\u6279\u91CF entityId\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u4E0E --id \u4E8C\u9009\u4E00\uFF0C\u53EF\u540C\u65F6\u4F20\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runAccountReauth({
+        token: opts.token,
+        media: opts.media,
+        id: opts.id,
+        ids: opts.ids ? opts.ids.split(",").map((s) => s.trim()).filter(Boolean) : void 0,
+        verbose: opts.verbose
+      });
+    }
+  );
   accountCmd.command("mcc-bind").description("Google\uFF1A\u5C06\u5B50\u8D26\u6237\u7ED1\u5B9A\u5230\u7ECF\u7406\u8D26\u6237\uFF08MCC\uFF09\uFF0C\u9700\u5DF2\u914D\u7F6E googleApiUrl").requiredOption(
     "--customers <ids>",
     "\u5B50\u8D26\u6237 mediaCustomerId\uFF0C\u591A\u4E2A\u9017\u53F7\u5206\u9694\uFF08\u6765\u81EA list-accounts \u7684 ma.mediaCustomerId\uFF09"
@@ -124937,8 +125029,8 @@ 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}\uFF1B`,
-    `4) siluzan-tso google-ads-diagnosis render --data ${dir}/${GOOGLE_ADS_DIAGNOSIS_REPORT_BASENAME} --out ${dir}/google-ads-diagnosis-report.html\u3002`,
+    `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`,
+    `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");
 }
@@ -126063,13 +126155,90 @@ function formatGoogleAdsDiagnosisContentErrors(check) {
   return parts.join("\n");
 }
 
-// src/commands/google-ads-diagnosis/render-report.ts
+// src/commands/google-ads-diagnosis/merge-collect-facts.ts
+var GOOGLE_ADS_DIAGNOSIS_COMPARISON_MODULES = [
+  "campaigns",
+  "geographic",
+  "keywords"
+];
 function asRecord6(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function isValidRateChange(value) {
+  if (value === null || value === void 0) return true;
+  return typeof value === "number" && Number.isFinite(value);
+}
+function isComparisonTableRowValid(row) {
+  const rec = asRecord6(row);
+  if (!rec) return false;
+  if (!String(rec.title ?? "").trim()) return false;
+  if (!Number.isFinite(Number(rec.currentCost))) return false;
+  if (!Number.isFinite(Number(rec.currentClicks))) return false;
+  if (!Number.isFinite(Number(rec.currentCvr))) return false;
+  if (!isValidRateChange(rec.costRateChange)) return false;
+  if (!isValidRateChange(rec.clicksRateChange)) return false;
+  if (!isValidRateChange(rec.cvrRateChange)) return false;
+  return true;
+}
+function moduleItemsNeedRestore(items) {
+  if (!Array.isArray(items) || items.length === 0) return false;
+  return items.some((row) => !isComparisonTableRowValid(row));
+}
+function getComparisonTableErrors(data) {
+  const errors = [];
+  for (const mod of GOOGLE_ADS_DIAGNOSIS_COMPARISON_MODULES) {
+    const block = asRecord6(data[mod]);
+    const items = block?.items;
+    if (!Array.isArray(items) || items.length === 0) continue;
+    for (let i = 0; i < items.length; i++) {
+      if (!isComparisonTableRowValid(items[i])) {
+        errors.push(
+          `${mod}.items[${i}] \u7F3A\u5C11 title/currentCost/currentClicks \u6216\u73AF\u6BD4\u5B57\u6BB5\u88AB\u5199\u6210\u5B57\u7B26\u4E32\uFF08\u987B\u4FDD\u7559 collect \u4E8B\u5B9E\u884C\uFF0C\u4EC5\u7531 Agent \u586B\u5199 analysis/suggestions\uFF09`
+        );
+      }
+    }
+  }
+  return errors;
+}
+function mergeComparisonItemsFromCollect(finalData, collectReportData) {
+  const data = { ...finalData };
+  const restoredModules = [];
+  for (const mod of GOOGLE_ADS_DIAGNOSIS_COMPARISON_MODULES) {
+    const finalBlock = asRecord6(data[mod]);
+    const collectBlock = asRecord6(collectReportData[mod]);
+    const finalItems = finalBlock?.items;
+    const collectItems = collectBlock?.items;
+    if (!moduleItemsNeedRestore(finalItems)) continue;
+    if (!Array.isArray(collectItems) || collectItems.length === 0) continue;
+    data[mod] = {
+      ...finalBlock ?? {},
+      items: collectItems
+    };
+    restoredModules.push(mod);
+  }
+  return { data, restoredModules };
+}
+
+// src/commands/google-ads-diagnosis/render-report.ts
+function asRecord7(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
   throw new Error("\u8BCA\u65AD\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
+async function tryLoadCollectReportData(collectPath) {
+  try {
+    const raw = JSON.parse(await fs18.readFile(collectPath, "utf8"));
+    const root = asRecord7(raw);
+    const reportData = asRecord7(root?.reportData);
+    return reportData ?? root;
+  } catch {
+    return null;
+  }
+}
 async function runGoogleAdsDiagnosisRender(opts) {
   const dataPath = path23.resolve(opts.dataFile);
   let dataRaw;
@@ -126081,7 +126250,39 @@ async function runGoogleAdsDiagnosisRender(opts) {
 `);
     process.exit(1);
   }
-  const data = asRecord6(dataRaw);
+  let data = asRecord7(dataRaw);
+  if (!opts.noMergeCollect) {
+    const collectPath = path23.resolve(
+      opts.collectFile ?? path23.join(path23.dirname(dataPath), GOOGLE_ADS_DIAGNOSIS_COLLECT_BASENAME)
+    );
+    const collectReportData = await tryLoadCollectReportData(collectPath);
+    if (collectReportData) {
+      const { data: merged, restoredModules } = mergeComparisonItemsFromCollect(
+        data,
+        collectReportData
+      );
+      data = merged;
+      if (restoredModules.length > 0) {
+        console.log(
+          `
+\u2139\uFE0F  \u5DF2\u4ECE collect \u6062\u590D \xA73.5 \u5BF9\u6BD4\u8868 items\uFF08${restoredModules.join("\u3001")}\uFF09\uFF1BAgent \u53EA\u5E94\u586B\u5199 analysis/suggestions\uFF0C\u52FF\u6539\u5199 items \u884C\u6570\u636E\u3002
+   \u6765\u6E90\uFF1A${collectPath}
+`
+        );
+      }
+    }
+  }
+  const comparisonErrors = getComparisonTableErrors(data);
+  if (comparisonErrors.length > 0) {
+    console.error("\n\u274C \u5BF9\u6BD4\u8868 items \u4E0D\u5B8C\u6574\uFF0CHTML \u4E2D\u7CFB\u5217/\u5730\u57DF/\u5173\u952E\u8BCD\u8868\u4F1A\u663E\u793A\u4E3A\u7A7A\uFF1A\n");
+    for (const err of comparisonErrors) {
+      console.error(`   \xB7 ${err}`);
+    }
+    console.error(
+      "\n   \u4FEE\u590D\uFF1A\u540C\u76EE\u5F55\u4FDD\u7559 google-ads-diagnosis-collect.json \u540E\u91CD\u65B0 render\uFF08\u9ED8\u8BA4\u81EA\u52A8\u5408\u5E76\uFF09\uFF1B\u6216\u624B\u52A8\u4ECE collect.reportData \u590D\u5236 campaigns/geographic/keywords.items\u3002\n"
+    );
+    process.exit(1);
+  }
   const contentCheck = validateGoogleAdsDiagnosisContent(data);
   if (!contentCheck.ok) {
     console.error(`
@@ -126172,13 +126373,20 @@ function registerGoogleAdsDiagnosisCommands(program2) {
   );
   root.command("render").description(
     "\u5C06 google-ads-diagnosis.json \u6CE8\u5165 GoogleAdsDiagnosisReport.html\uFF0C\u8F93\u51FA\u4E0E MarkAI \u4E00\u81F4\u7684 HTML \u7EC8\u7A3F"
-  ).requiredOption("--data <file>", "Agent \u4EA7\u51FA\u7684\u8BCA\u65AD JSON\uFF08\u4E0E MarkAI sectionData \u540C\u7ED3\u6784\uFF09").option("--out <file>", "\u8F93\u51FA HTML \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\uFF09").option("--lenient", "\u7ED3\u6784\u8B66\u544A\uFF08\u5982\u7F3A analysis\uFF09\u65F6\u4E0D\u963B\u65AD\u6E32\u67D3", false).action(async (opts) => {
-    await runGoogleAdsDiagnosisRender({
-      dataFile: opts.data,
-      out: opts.out,
-      lenient: opts.lenient
-    });
-  });
+  ).requiredOption("--data <file>", "Agent \u4EA7\u51FA\u7684\u8BCA\u65AD JSON\uFF08\u4E0E MarkAI sectionData \u540C\u7ED3\u6784\uFF09").option("--out <file>", "\u8F93\u51FA HTML \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\uFF09").option(
+    "--collect <file>",
+    "collect JSON \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\u7684 google-ads-diagnosis-collect.json\uFF0C\u7528\u4E8E\u6062\u590D\u5BF9\u6BD4\u8868 items\uFF09"
+  ).option("--no-merge-collect", "\u4E0D\u4ECE collect \u81EA\u52A8\u6062\u590D campaigns/geographic/keywords.items", false).option("--lenient", "\u7ED3\u6784\u8B66\u544A\uFF08\u5982\u7F3A analysis\uFF09\u65F6\u4E0D\u963B\u65AD\u6E32\u67D3", false).action(
+    async (opts) => {
+      await runGoogleAdsDiagnosisRender({
+        dataFile: opts.data,
+        out: opts.out,
+        collectFile: opts.collect,
+        noMergeCollect: opts.noMergeCollect,
+        lenient: opts.lenient
+      });
+    }
+  );
 }
 
 // src/index.ts
@@ -126535,7 +126743,7 @@ function ensureScorecardFromSnapshot(healthDiagnosis, merged) {
 }
 
 // src/commands/facebook-analysis/merge-snapshot.ts
-function asRecord7(value) {
+function asRecord8(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126584,7 +126792,7 @@ async function readManifest(snapshotDir) {
 async function loadSectionFile(snapshotDir, file) {
   try {
     const raw = await fs21.readFile(path28.join(snapshotDir, file), "utf8");
-    return asRecord7(JSON.parse(raw));
+    return asRecord8(JSON.parse(raw));
   } catch {
     return null;
   }
@@ -126632,7 +126840,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
     if (data) sectionMap.set(art.section, data);
   }
   const overview = sectionMap.get("overview");
-  const current = asRecord7(overview?.currentPeriod);
+  const current = asRecord8(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 ?? {} };
@@ -126754,7 +126962,7 @@ function isFiniteNumber(value) {
 function asArray2(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord8(value) {
+function asRecord9(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126766,26 +126974,26 @@ function pushMissing(missing, id, chapter, dimension, hint) {
 function countAdSetsWithSpend(tables) {
   const rows = asArray2(tables?.adSets);
   return rows.filter((row) => {
-    const r = asRecord8(row);
+    const r = asRecord9(row);
     const spend = r?.spend;
     return isFiniteNumber(spend) && spend > 0;
   }).length;
 }
 function chartLabels(chart) {
-  const c = asRecord8(chart);
+  const c = asRecord9(chart);
   return asArray2(c?.labels).length;
 }
 function validateMetaPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord8(data.meta) ?? {};
-  const kpis = asRecord8(data.kpis) ?? {};
-  const narrative = asRecord8(data.narrative) ?? {};
-  const tables = asRecord8(data.tables);
-  const charts = asRecord8(data.charts);
-  const sections = asRecord8(data.sections);
-  const health = asRecord8(data.healthDiagnosis);
-  const priorityPlan = asRecord8(data.priorityPlan);
-  const actionChecklist = asRecord8(data.actionChecklist);
+  const meta = asRecord9(data.meta) ?? {};
+  const kpis = asRecord9(data.kpis) ?? {};
+  const narrative = asRecord9(data.narrative) ?? {};
+  const tables = asRecord9(data.tables);
+  const charts = asRecord9(data.charts);
+  const sections = asRecord9(data.sections);
+  const health = asRecord9(data.healthDiagnosis);
+  const priorityPlan = asRecord9(data.priorityPlan);
+  const actionChecklist = asRecord9(data.actionChecklist);
   const adSetsWithSpend2 = countAdSetsWithSpend(tables ?? void 0);
   const regionalNarratives = asArray2(narrative.regional).length;
   const recommendations = asArray2(narrative.recommendations);
@@ -126857,7 +127065,7 @@ function validateMetaPeriodReportContent(data) {
       "charts.audience.labels \u81F3\u5C11 1 \u9879"
     );
   }
-  const funnel = asRecord8(charts?.funnel);
+  const funnel = asRecord9(charts?.funnel);
   if (!isFiniteNumber(funnel?.reach)) {
     pushMissing(
       missing,
@@ -126921,7 +127129,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < regionalNarratives; i++) {
-      const row = asRecord8(asArray2(narrative.regional)[i]);
+      const row = asRecord9(asArray2(narrative.regional)[i]);
       if (textLen2(row?.text) < 80) {
         pushMissing(
           missing,
@@ -126951,7 +127159,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) => asRecord8(r)?.title);
+    const titles = recommendations.map((r) => asRecord9(r)?.title);
     for (const title of RECOMMENDATION_TITLES) {
       if (!titles.includes(title)) {
         pushMissing(
@@ -126964,7 +127172,7 @@ function validateMetaPeriodReportContent(data) {
       }
     }
     for (let i = 0; i < recommendations.length; i++) {
-      const rec = asRecord8(recommendations[i]);
+      const rec = asRecord9(recommendations[i]);
       if (textLen2(rec?.content) < 150) {
         pushMissing(
           missing,
@@ -126986,7 +127194,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < supplementary.length; i++) {
-      const row = asRecord8(supplementary[i]);
+      const row = asRecord9(supplementary[i]);
       if (!textLen2(row?.dimension) || !textLen2(row?.issue)) {
         pushMissing(
           missing,
@@ -127068,7 +127276,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < fourQuestions.length; i++) {
-      const q = asRecord8(fourQuestions[i]);
+      const q = asRecord9(fourQuestions[i]);
       const evidence = asArray2(q?.evidence).filter((e) => textLen2(e) > 0);
       if (evidence.length < 2) {
         pushMissing(
@@ -127092,7 +127300,7 @@ function validateMetaPeriodReportContent(data) {
   }
   let scorecardValidRows = 0;
   for (let i = 0; i < scorecard.length; i++) {
-    const row = asRecord8(scorecard[i]);
+    const row = asRecord9(scorecard[i]);
     const itemOk = textLen2(row?.item) > 0;
     const dataOk = textLen2(row?.data) > 0;
     const signalOk = SCORECARD_SIGNALS.includes(row?.signal);
@@ -127134,7 +127342,7 @@ function validateMetaPeriodReportContent(data) {
     );
   }
   for (const key of ["platform", "country", "adSets"]) {
-    const insight = textLen2(asRecord8(sections?.[key])?.insight);
+    const insight = textLen2(asRecord9(sections?.[key])?.insight);
     if (insight < 200) {
       pushMissing(
         missing,
@@ -127145,7 +127353,7 @@ function validateMetaPeriodReportContent(data) {
       );
     }
   }
-  const audience = asRecord8(sections?.audience);
+  const audience = asRecord9(sections?.audience);
   if (asArray2(audience?.goldenProfile).filter((s) => textLen2(s) > 0).length < 3) {
     pushMissing(
       missing,
@@ -127173,7 +127381,7 @@ function validateMetaPeriodReportContent(data) {
       "\u2265150 \u5B57"
     );
   }
-  const landingRows = asArray2(asRecord8(sections?.landingPage)?.rows);
+  const landingRows = asArray2(asRecord9(sections?.landingPage)?.rows);
   if (landingRows.length < 3) {
     pushMissing(
       missing,
@@ -127258,7 +127466,7 @@ async function readJsonFile2(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord9(value) {
+function asRecord10(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -127273,7 +127481,7 @@ function injectReportData2(html, payload) {
 }
 async function runFacebookAnalysisRender(opts) {
   const dataPath = path29.resolve(opts.dataFile);
-  let data = asRecord9(await readJsonFile2(dataPath));
+  let data = asRecord10(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.33-beta.1",
-  "publishedAt": 1782810997774
+  "version": "1.1.33-beta.3",
+  "publishedAt": 1782887114389
 }

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

@@ -307,9 +307,11 @@ siluzan-tso account me --check-phone 15130150466 --json-out ./snap-me
 
 ---
 
-### auth — 添加媒体平台 OAuth 授权
+### auth — 添加媒体平台 OAuth 授权（首次绑定）
 
-在浏览器中打开对应媒体的 OAuth 授权页面，授权后账户自动绑定到丝路赞。
+在浏览器中打开对应媒体的 OAuth 授权页面，授权后账户自动绑定到丝路赞。对应网页 **「添加授权」**。
+
+> **OAuth 已失效**（`invalidOAuthToken=true`）时**不要**用本命令，须走下方 **`reauth`**（重新授权必须先解绑）。
 
 ```bash
 siluzan-tso account auth -m <媒体类型>
@@ -322,13 +324,13 @@ siluzan-tso account auth -m <媒体类型>
 **示例：**
 
 ```bash
-# 授权 Google Ads 账户
+# 首次授权 Google Ads 账户
 siluzan-tso account auth -m Google
 
-# 授权 TikTok Ads 账户
+# 首次授权 TikTok Ads 账户
 siluzan-tso account auth -m TikTok
 
-# 授权 Meta（Facebook）Ads 账户
+# 首次授权 Meta（Facebook）Ads 账户
 siluzan-tso account auth -m Meta
 ```
 
@@ -336,6 +338,38 @@ siluzan-tso account auth -m Meta
 
 ---
 
+### reauth — 重新授权（先解绑再 OAuth）
+
+OAuth 失效时恢复授权。对齐 TSO 网页 **「重新授权」**：程序会先 **delink** 断开关联，再跳转媒体 OAuth。**禁止**对失效账户跳过解绑直接用 `account auth`。
+
+```bash
+siluzan-tso account reauth -m <媒体类型> --id <entityId>
+siluzan-tso account reauth -m Google --ids <id1,id2>
+```
+
+| 选项                 | 说明                                                                     |
+| -------------------- | ------------------------------------------------------------------------ |
+| `-m, --media <type>` | 媒体类型（必填）                                                         |
+| `--id <entityId>`    | 单个账户 `entityId`（来自 `list-accounts` 的 `ma.entityId`）             |
+| `--ids <id1,id2>`    | 批量 `entityId`，逗号分隔（与 `--id` 二选一）                            |
+
+**示例：**
+
+```bash
+# 1. 查失效账户的 entityId
+siluzan-tso list-accounts -m Google --json-out ./snap
+
+# 2. 重新授权（内置 delink → OAuth）
+siluzan-tso account reauth -m Google --id abc123def456
+
+# 3. 验证
+siluzan-tso list-accounts -m Google
+```
+
+> 手动两步等价于 `reauth`：`account delink --id …` → `account auth -m …`（须用户确认解绑风险）。
+
+---
+
 ### delink — 解除授权 / 断开账户关联
 
 从当前丝路赞账号下移除媒体账户绑定。

package/dist/skill/references/core/agent-conventions.md

@@ -219,7 +219,7 @@
 ## 十一、常见 HTTP 状态码
 
 - **400**：参数错误，查看对应 reference 或 `-h`
-- **401**：平台方返回则需用户重新授权；**我方凭据失效**则优先 `send-login-code` + `login --phone --code`，见 `references/core/setup.md`
+- **401**：媒体 OAuth 失效 → `account reauth -m <媒体> --id <entityId>`（须先 delink，见 W9）；**丝路赞登录凭据失效** → `send-login-code` + `login --phone --code`，见 `references/core/setup.md`
 - **500**：服务可能正在部署/升级，建议反馈 Siluzan 相关人员
 
 ---

package/dist/skill/references/core/workflows.md

@@ -152,7 +152,8 @@
 - **步骤（按场景）**：
   - **分享**：`list-accounts --json-out` 取 `entityId` → `account share --id <entityId> --phone <手机号>`；查 `account share-detail --customer-id <mediaCustomerId>`；取消 `account unshare --id <entityId> --account-id <userId>`。
   - **解绑**：`account delink --id <entityId>` / `--ids id1,id2`。
-  - **OAuth 重授权**：`invalidOAuthToken=true` → `account auth -m <媒体>`（浏览器授权）→ `list-accounts` 验证。
+  - **OAuth 重授权**：`invalidOAuthToken=true` → `list-accounts --json-out` 取 `ma.entityId` → **`account reauth -m <媒体> --id <entityId>`**（内置先 delink 再 OAuth，对齐网页「重新授权」）→ `list-accounts` 验证。**禁止**对失效账户直接用 `account auth`（首次「添加授权」专用）。
+  - **首次 OAuth 添加授权**：`account auth -m <媒体>`（无需先 delink）。
   - **MCC**：`account mcc-bind --customers <mediaCustomerId,...> --mcc <MCC客户ID>` / `mcc-unbind`（走 `googleApiUrl`，先 `config show`）。
   - **BC（TikTok）**：`account bc-bind --customers <id> --bc-ids <id>` / `bc-unbind --bc-id <id>`（解绑一次一个）。
   - **BM（Meta）**：`account bm-bind --account-id <mediaCustomerId> --bm-id <bmId>`。

package/dist/skill/references/report-templates/bing-period-report.md

@@ -18,6 +18,7 @@
 ## 1. 执行摘要（总览）
 
 - **CLI**：`siluzan-tso report bing-overview -a <mediaCustomerId> [--start … --end …] --json-out <dir>`
+- **余额**：若 `OverviewSectionData` 误返 `remainingAccountBudget: 0`，CLI 会自动用 `GetMediaAccountInfo` 实时余额回填（与 Web 账户列表一致）；**仍建议**单查余额用 `balance -m BingV2`。
 
 ## 2. 设备与地域
 

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

@@ -33,6 +33,9 @@ siluzan-tso google-ads-diagnosis render \
 | `collect` | 拉 google-analysis + 可选 Lighthouse；输出 `google-ads-diagnosis-collect.json` |
 | `render`  | 读取 Agent 产出的 `google-ads-diagnosis.json`，注入 `GoogleAdsDiagnosisReport.html` |
 
+- **render 自动合并（默认开启）**：若同目录存在 `google-ads-diagnosis-collect.json`，且 Agent 改坏了 `campaigns` / `geographic` / `keywords` 的 `items`（缺 `title`/`currentCost` 或环比写成字符串），CLI **自动从 collect.reportData 恢复 items**，保留 Agent 的 `analysis`/`suggestions`。可用 `--no-merge-collect` 关闭；`--collect <file>` 指定 collect 路径。
+- **render 硬校验**：合并后对比表仍不完整则 **exit 1**（避免 HTML 表体全空）。
+
 - **禁止**在 `collect` 阶段生成或写入 `analysis` / `suggestions` / `diagnosisOverview` / `summary` 等建议性文案。
 - **禁止**跳过 Agent 直接 `render` collect 产物（`render` 会校验全部叙事 / 建议字段；调试可加 `--lenient`）。
 - JSON 顶层结构须与 MarkAI `sectionData.js` / `fetchData` 输出一致（见下文各 `section-*` 数据对象）。
@@ -204,6 +207,7 @@ 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
 
 #### 国家地区分析
 

package/dist/skill/report-templates/GoogleAdsDiagnosisReport.html

@@ -4296,6 +4296,75 @@
             const labels = items.map((item, index) =>
               formatDateLabel(item?.date, index),
             );
+            const totalConversions = items.reduce(
+              (sum, item) => sum + (Number(item?.conversions) || 0),
+              0,
+            );
+            // 零转化账户：CPA/转化折线全为 0 视觉上像空图，改展示消耗 + 点击按日趋势
+            const useCostClickTrend = totalConversions === 0;
+
+            if (useCostClickTrend) {
+              const costData = items.map((item) => Number(item?.cost) || 0);
+              const clicksData = items.map((item) => Number(item?.clicks) || 0);
+              return {
+                type: "line",
+                data: {
+                  labels,
+                  datasets: [
+                    {
+                      label: "消耗",
+                      data: costData,
+                      borderColor: "#3b82f6",
+                      backgroundColor: "rgba(59, 130, 246, 0.12)",
+                      tension: 0.3,
+                      yAxisID: "y1",
+                      pointRadius: 3,
+                    },
+                    {
+                      label: "点击次数",
+                      data: clicksData,
+                      borderColor: "#10b981",
+                      backgroundColor: "rgba(16, 185, 129, 0.12)",
+                      tension: 0.3,
+                      yAxisID: "y2",
+                      pointRadius: 3,
+                    },
+                  ],
+                },
+                options: {
+                  responsive: true,
+                  maintainAspectRatio: false,
+                  interaction: { mode: "index", intersect: false },
+                  stacked: false,
+                  plugins: {
+                    legend: { labels: { font: { size: 12 } } },
+                  },
+                  scales: {
+                    y1: {
+                      type: "linear",
+                      position: "left",
+                      beginAtZero: true,
+                      ticks: { font: { size: 11 } },
+                      title: { display: true, text: "消耗", font: { size: 12 } },
+                    },
+                    y2: {
+                      type: "linear",
+                      position: "right",
+                      beginAtZero: true,
+                      ticks: { font: { size: 11 } },
+                      grid: { drawOnChartArea: false },
+                      title: {
+                        display: true,
+                        text: "点击次数",
+                        font: { size: 12 },
+                      },
+                    },
+                    x: { ticks: { font: { size: 11 } } },
+                  },
+                },
+              };
+            }
+
             const cpaData = items.map((item) => Number(item?.cpa) || 0);
             const conversionsData = items.map((item) =>
               Number(item?.conversions ?? 0),
@@ -4401,6 +4470,40 @@
           };
         };
 
+        const buildConversionCostDailyTableHtml = (items) => {
+          const rows = Array.isArray(items) ? items : [];
+          if (!rows.length) {
+            return '<tr><td colspan="5" class="empty-row">暂无按日趋势数据</td></tr>';
+          }
+          return rows
+            .map((item) => {
+              const rawDate = item?.date;
+              let dateLabel = rawDate;
+              const parsed = new Date(rawDate);
+              if (!Number.isNaN(parsed.getTime())) {
+                dateLabel = parsed.toISOString().slice(0, 10);
+              }
+              const cost = Number(item?.cost);
+              const clicks = Number(item?.clicks);
+              const conversions = Number(item?.conversions ?? 0);
+              const cpa = Number(item?.cpa);
+              const cpaDisplay =
+                conversions > 0 && Number.isFinite(cpa)
+                  ? formatNumber(cpa, 2)
+                  : "—";
+              return `
+                <tr>
+                  <td data-label="日期">${escapeHtml(String(dateLabel || "—"))}</td>
+                  <td data-label="消耗">${escapeHtml(formatNumber(cost, 2))}</td>
+                  <td data-label="点击">${escapeHtml(formatNumber(clicks, 0))}</td>
+                  <td data-label="转化">${escapeHtml(formatNumber(conversions, 0))}</td>
+                  <td data-label="CPA">${escapeHtml(cpaDisplay)}</td>
+                </tr>
+              `;
+            })
+            .join("");
+        };
+
         const createAccountInfoSection = () => {
           const reportMain = document.getElementById("report-main");
           if (!reportMain) return null;
@@ -4883,17 +4986,47 @@
           const conversionTrendSuggestionsList = toArray(
             conversionCost.suggestions,
           ).map((item) => `<li class="insight-item">${escapeHtml(item)}</li>`);
+          const conversionCostDailyItems = Array.isArray(conversionCost.items)
+            ? conversionCost.items
+            : [];
+          const conversionDailyTableHtml = buildConversionCostDailyTableHtml(
+            conversionCostDailyItems,
+          );
           const conversionTrendContent =
             (chartConfig ||
+              conversionCostDailyItems.length ||
               conversionTrendAnalysisList.length ||
               conversionTrendSuggestionsList.length) &&
             `
               <div class="analysis-dimension conversion-trend-section">
                 <h4 class="dimension-title">转化成本与转化趋势优化</h4>
                 <div class="dimension-content">
+                  <div class="table-block" data-table-key="conversion-cost-daily">
+                    <table class="data-table">
+                      <thead>
+                        <tr>
+                          <th>日期</th>
+                          <th>消耗</th>
+                          <th>点击</th>
+                          <th>转化</th>
+                          <th>CPA</th>
+                        </tr>
+                      </thead>
+                      <tbody>
+                        ${conversionDailyTableHtml}
+                      </tbody>
+                    </table>
+                  </div>
                   ${
                     chartConfig
                       ? `
+                          <p class="conversion-trend-chart-note" style="margin:12px 0 8px;font-size:13px;color:#64748b;">${
+                            conversionCostDailyItems.every(
+                              (item) => !(Number(item?.conversions) > 0),
+                            ) && conversionCostDailyItems.length
+                              ? "本期无转化记录，下图展示消耗与点击按日趋势。"
+                              : "下图展示 CPA 与转化次数按日趋势。"
+                          }</p>
                           <div class="chart-card conversion-trend-chart">
                             <div style="height: 280px;">
                               <canvas id="${chartId}" height="260"></canvas>

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

@@ -18,6 +18,7 @@
 ## 1. 执行摘要（总览）
 
 - **CLI**：`siluzan-tso report bing-overview -a <mediaCustomerId> [--start … --end …] --json-out <dir>`
+- **余额**：若 `OverviewSectionData` 误返 `remainingAccountBudget: 0`，CLI 会自动用 `GetMediaAccountInfo` 实时余额回填（与 Web 账户列表一致）；**仍建议**单查余额用 `balance -m BingV2`。
 
 ## 2. 设备与地域
 

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

@@ -33,6 +33,9 @@ siluzan-tso google-ads-diagnosis render \
 | `collect` | 拉 google-analysis + 可选 Lighthouse；输出 `google-ads-diagnosis-collect.json` |
 | `render`  | 读取 Agent 产出的 `google-ads-diagnosis.json`，注入 `GoogleAdsDiagnosisReport.html` |
 
+- **render 自动合并（默认开启）**：若同目录存在 `google-ads-diagnosis-collect.json`，且 Agent 改坏了 `campaigns` / `geographic` / `keywords` 的 `items`（缺 `title`/`currentCost` 或环比写成字符串），CLI **自动从 collect.reportData 恢复 items**，保留 Agent 的 `analysis`/`suggestions`。可用 `--no-merge-collect` 关闭；`--collect <file>` 指定 collect 路径。
+- **render 硬校验**：合并后对比表仍不完整则 **exit 1**（避免 HTML 表体全空）。
+
 - **禁止**在 `collect` 阶段生成或写入 `analysis` / `suggestions` / `diagnosisOverview` / `summary` 等建议性文案。
 - **禁止**跳过 Agent 直接 `render` collect 产物（`render` 会校验全部叙事 / 建议字段；调试可加 `--lenient`）。
 - JSON 顶层结构须与 MarkAI `sectionData.js` / `fetchData` 输出一致（见下文各 `section-*` 数据对象）。
@@ -204,6 +207,7 @@ 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
 
 #### 国家地区分析
 

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