siluzan-tso-cli 1.1.44 → 1.1.45-beta.2

package/dist/index.js

@@ -258,9 +258,9 @@ var require_semver = __commonJS({
         } else {
           this.prerelease = m[4].split(".").map((id) => {
             if (/^[0-9]+$/.test(id)) {
-              const num10 = +id;
-              if (num10 >= 0 && num10 < MAX_SAFE_INTEGER) {
-                return num10;
+              const num11 = +id;
+              if (num11 >= 0 && num11 < MAX_SAFE_INTEGER) {
+                return num11;
               }
             }
             return id;
@@ -4026,7 +4026,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -4046,6 +4046,9 @@ function deriveTiktokApiUrl(tsoApiBaseUrl) {
 function deriveFacebookApiUrl(tsoApiBaseUrl) {
   return tsoApiBaseUrl.includes("-ci") ? "https://facebookapi-ci.mysiluzan.com" : "https://facebookapi.mysiluzan.com";
 }
+function deriveYandexApiUrl(tsoApiBaseUrl) {
+  return tsoApiBaseUrl.includes("-ci") ? "https://yandexapi-ci.mysiluzan.com" : "https://yandexapi.mysiluzan.com";
+}
 function deriveChatGptApiUrl(tsoApiBaseUrl) {
   return tsoApiBaseUrl.includes("-ci") ? "https://chatgpt-ci.mysiluzan.com" : "https://chatgpt.mysiluzan.com";
 }
@@ -4431,6 +4434,7 @@ function loadConfig(tokenArg) {
     mainApiUrl: deriveMainApiUrl(apiBaseUrl),
     tiktokApiUrl: deriveTiktokApiUrl(apiBaseUrl),
     facebookApiUrl: deriveFacebookApiUrl(apiBaseUrl),
+    yandexApiUrl: process.env.SILUZAN_YANDEX_API ?? deriveYandexApiUrl(apiBaseUrl),
     chatGptApiUrl: deriveChatGptApiUrl(apiBaseUrl),
     csoBaseUrl,
     dataPermission: process.env.SILUZAN_DATA_PERMISSION ?? shared.dataPermission
@@ -5561,8 +5565,8 @@ var init_daily_metrics_range = __esm({
 async function withAsyncLock(key, fn) {
   const prev = chains.get(key) ?? Promise.resolve();
   let release;
-  const gate = new Promise((resolve21) => {
-    release = resolve21;
+  const gate = new Promise((resolve23) => {
+    release = resolve23;
   });
   chains.set(
     key,
@@ -6151,14 +6155,14 @@ function computeBackoffMs(attempt, policy) {
   return capped + jitter;
 }
 function sleep3(ms, signal) {
-  return new Promise((resolve21, reject) => {
+  return new Promise((resolve23, reject) => {
     if (signal?.aborted) {
       reject(new Error("retry sleep aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve21();
+      resolve23();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -104361,10 +104365,10 @@ var init_google_analysis3 = __esm({
 // src/index.ts
 init_dist();
 init_dist();
-import * as fs33 from "fs";
-import * as path43 from "path";
-import { fileURLToPath as fileURLToPath11 } from "url";
-import { Command as Command5 } from "commander";
+import * as fs35 from "fs";
+import * as path46 from "path";
+import { fileURLToPath as fileURLToPath12 } from "url";
+import { Command as Command6 } from "commander";
 
 // src/commands/login/urls.ts
 init_defaults();
@@ -104849,8 +104853,8 @@ function deriveWebUrl(apiBaseUrl) {
 }
 var TSO_UMI_ROUTE_PREFIX = "/v3umijs/tso";
 function buildTsoPageWebUrl(webUrl, tsoSubRoute, extraQuery) {
-  const path44 = tsoSubRoute.replace(/^\/+/, "");
-  const umiPath = `${TSO_UMI_ROUTE_PREFIX}/${path44}`;
+  const path47 = tsoSubRoute.replace(/^\/+/, "");
+  const umiPath = `${TSO_UMI_ROUTE_PREFIX}/${path47}`;
   const q = new URLSearchParams({ tso: umiPath });
   if (extraQuery) {
     for (const [key, value] of Object.entries(extraQuery)) {
@@ -104858,7 +104862,7 @@ function buildTsoPageWebUrl(webUrl, tsoSubRoute, extraQuery) {
       if (v) q.set(key, v);
     }
   }
-  return `${webUrl.replace(/\/+$/, "")}/v3/foreign_trade/tso/${path44}?${q.toString()}`;
+  return `${webUrl.replace(/\/+$/, "")}/v3/foreign_trade/tso/${path47}?${q.toString()}`;
 }
 function cmdConfigShow() {
   const shared = readSharedConfig();
@@ -106984,6 +106988,63 @@ function assessBalanceScanDataHealth(input) {
   return null;
 }
 
+// src/commands/balance-scan/evaluate.ts
+function evaluateBalanceScanAccounts(params) {
+  const {
+    items: items2,
+    balanceMap,
+    overviewMap,
+    spendDays,
+    thresholdDays,
+    minBalance,
+    minDailySpend,
+    targetDays,
+    includeInvalidOAuth
+  } = params;
+  const evaluated = [];
+  for (const item of items2) {
+    const ma = item.ma;
+    const id = ma?.mediaCustomerId ? String(ma.mediaCustomerId) : "";
+    if (!id) continue;
+    if (!includeInvalidOAuth && ma.invalidOAuthToken) continue;
+    const bal = balanceMap.get(id);
+    const ov = overviewMap.get(id);
+    const balance = bal?.remainingAccountBudget ?? null;
+    const windowSpend = Number(ov?.spend ?? 0);
+    const dailySpend = windowSpend > 0 ? windowSpend / spendDays : 0;
+    let remainingDays = null;
+    let recommendedTopup = null;
+    if (dailySpend >= minDailySpend && balance !== null) {
+      remainingDays = +(balance / dailySpend).toFixed(1);
+      const needed = dailySpend * targetDays - balance;
+      recommendedTopup = needed > 0 ? +needed.toFixed(2) : 0;
+    }
+    const lowDays = remainingDays !== null && remainingDays <= thresholdDays;
+    const lowBalance = minBalance !== null && balance !== null && balance <= minBalance;
+    const hitReason = lowDays && lowBalance ? "both" : lowDays ? "low-days" : lowBalance ? "low-balance" : "none";
+    evaluated.push({
+      mediaCustomerId: id,
+      name: ma.mediaCustomerName ?? bal?.name ?? ov?.mediaCustomerName ?? null,
+      advertiserName: item.mag?.advertiserName ?? null,
+      currencyCode: bal?.currencyCode ?? ma.currencyCode ?? ov?.currencyCode ?? null,
+      balance,
+      dailySpend: dailySpend > 0 ? +dailySpend.toFixed(2) : null,
+      remainingDays,
+      recommendedTopup,
+      invalidOAuthToken: !!ma.invalidOAuthToken,
+      status: bal?.status ?? bal?.accountStatus ?? ov?.status ?? null,
+      hitReason
+    });
+  }
+  evaluated.sort((a, b) => {
+    const ad = a.remainingDays ?? Number.POSITIVE_INFINITY;
+    const bd = b.remainingDays ?? Number.POSITIVE_INFINITY;
+    return ad - bd;
+  });
+  const hitCount = evaluated.filter((x) => x.hitReason !== "none").length;
+  return { items: evaluated, hitCount };
+}
+
 // src/commands/balance-scan/run.ts
 async function runBalanceScan(opts) {
   let config = loadConfig(opts.token);
@@ -107089,48 +107150,19 @@ async function runBalanceScan(opts) {
     balanceMap = fetched.balanceMap;
     overviewMap = fetched.overviewMap;
     batchChunkSize = fetched.chunkSize;
-    process.stderr.write(`\u23F3 [balance-scan] \u4F59\u989D\u4E0E\u6D88\u8017\u5DF2\u9F50\uFF0C\u6B63\u5728\u6309\u9608\u503C\u7B5B\u9009\u2026
+    process.stderr.write(`\u23F3 [balance-scan] \u4F59\u989D\u4E0E\u6D88\u8017\u5DF2\u9F50\uFF0C\u6B63\u5728\u6C47\u603B\u5168\u90E8\u5DF2\u68C0\u67E5\u8D26\u6237\u2026
 `);
   }
-  const evaluated = [];
-  for (const item of allItems) {
-    const ma = item.ma;
-    const id = ma?.mediaCustomerId ? String(ma.mediaCustomerId) : "";
-    if (!id) continue;
-    const bal = balanceMap.get(id);
-    const ov = overviewMap.get(id);
-    const balance = bal?.remainingAccountBudget ?? null;
-    const windowSpend = Number(ov?.spend ?? 0);
-    const dailySpend = windowSpend > 0 ? windowSpend / spendDays : 0;
-    let remainingDays = null;
-    let recommendedTopup = null;
-    if (dailySpend >= minDailySpend && balance !== null) {
-      remainingDays = +(balance / dailySpend).toFixed(1);
-      const needed = dailySpend * targetDays - balance;
-      recommendedTopup = needed > 0 ? +needed.toFixed(2) : 0;
-    }
-    const lowDays = remainingDays !== null && remainingDays <= thresholdDays;
-    const lowBalance = minBalance !== null && balance !== null && balance <= minBalance;
-    if (!lowDays && !lowBalance && !isSubset) continue;
-    const hitReason = lowDays && lowBalance ? "both" : lowDays ? "low-days" : lowBalance ? "low-balance" : "none";
-    evaluated.push({
-      mediaCustomerId: id,
-      name: ma.mediaCustomerName ?? bal?.name ?? ov?.mediaCustomerName ?? null,
-      advertiserName: item.mag?.advertiserName ?? null,
-      currencyCode: bal?.currencyCode ?? ma.currencyCode ?? ov?.currencyCode ?? null,
-      balance,
-      dailySpend: dailySpend > 0 ? +dailySpend.toFixed(2) : null,
-      remainingDays,
-      recommendedTopup,
-      invalidOAuthToken: !!ma.invalidOAuthToken,
-      status: bal?.status ?? bal?.accountStatus ?? ov?.status ?? null,
-      hitReason
-    });
-  }
-  evaluated.sort((a, b) => {
-    const ad = a.remainingDays ?? Number.POSITIVE_INFINITY;
-    const bd = b.remainingDays ?? Number.POSITIVE_INFINITY;
-    return ad - bd;
+  const { items: evaluated, hitCount } = evaluateBalanceScanAccounts({
+    items: allItems,
+    balanceMap,
+    overviewMap,
+    spendDays,
+    thresholdDays,
+    minBalance,
+    minDailySpend,
+    targetDays,
+    includeInvalidOAuth: isSubset
   });
   const balancesForHealth = validIds.map((id) => balanceMap.get(id)?.remainingAccountBudget);
   const dataIssue = assessBalanceScanDataHealth({
@@ -107144,7 +107176,7 @@ async function runBalanceScan(opts) {
     scannedAccounts: allItems.length,
     validAccounts: validIds.length,
     skippedInvalidOAuth: allItems.length - validIds.length,
-    hitCount: evaluated.length,
+    hitCount,
     nullBalanceCount: balancesForHealth.filter((b) => b == null).length,
     dataIssue: dataIssue?.code ?? null,
     dataIssueMessage: dataIssue?.message ?? null,
@@ -107184,22 +107216,23 @@ async function runBalanceScan(opts) {
   if (wroteJson) {
     return;
   }
+  const thresholdHint = `\u9608\u503C\uFF1A\u7EED\u822A \u2264 ${thresholdDays} \u5929` + (minBalance !== null ? ` \u6216 \u4F59\u989D \u2264 ${minBalance}` : "");
   if (isSubset) {
     console.log(
       `
 ${media} \u8D26\u6237\u4F59\u989D\u753B\u50CF\uFF08\u5B50\u96C6\u6A21\u5F0F\uFF0C-a \u6307\u5B9A ${filterIds.length} \u4E2A\u8D26\u6237\uFF0C\u5168\u90E8\u5C55\u793A\uFF09
-  \u9608\u503C\u53C2\u8003\uFF1A\u7EED\u822A \u2264 ${thresholdDays} \u5929` + (minBalance !== null ? ` \u6216 \u4F59\u989D \u2264 ${minBalance}` : "") + `
+  \u5DF2\u68C0\u67E5 ${evaluated.length} \u6237\uFF0C\u5176\u4E2D\u9884\u8B66\u547D\u4E2D ${hitCount} \u4E2A\uFF08${thresholdHint}\uFF09
 `
     );
   } else {
     console.log(
       `
-${media} \u8D26\u6237\u4F59\u989D\u626B\u63CF\u5B8C\u6210\uFF1A\u5171\u626B\u63CF ${meta.scannedAccounts} \u4E2A\u8D26\u6237\uFF08\u6709\u6548 ${meta.validAccounts}\uFF09\uFF0C\u547D\u4E2D ${meta.hitCount} \u4E2A\uFF08\u9608\u503C\uFF1A\u7EED\u822A \u2264 ${thresholdDays} \u5929` + (minBalance !== null ? ` \u6216 \u4F59\u989D \u2264 ${minBalance}` : "") + `\uFF09
+${media} \u8D26\u6237\u4F59\u989D\u626B\u63CF\u5B8C\u6210\uFF1A\u5171\u626B\u63CF ${meta.scannedAccounts} \u4E2A\u8D26\u6237\uFF08\u6709\u6548 ${meta.validAccounts}\uFF09\uFF0C\u8FD4\u56DE\u5DF2\u68C0\u67E5 ${evaluated.length} \u6237\uFF0C\u5176\u4E2D\u9884\u8B66\u547D\u4E2D ${hitCount} \u4E2A\uFF08${thresholdHint}\uFF09
 `
     );
   }
   if (evaluated.length === 0) {
-    console.log("  \u2705 \u65E0\u547D\u4E2D\u8D26\u6237\uFF08\u9608\u503C\u5185\u65E0\u9884\u8B66\uFF1B\u6570\u636E\u5DF2\u6B63\u5E38\u8FD4\u56DE\uFF09\u3002\n");
+    console.log("  \u2705 \u6CA1\u6709\u53EF\u5C55\u793A\u7684\u5DF2\u68C0\u67E5\u8D26\u6237\uFF08\u6570\u636E\u5DF2\u6B63\u5E38\u8FD4\u56DE\uFF09\u3002\n");
     return;
   }
   const cols = [
@@ -107213,7 +107246,7 @@ ${media} \u8D26\u6237\u4F59\u989D\u626B\u63CF\u5B8C\u6210\uFF1A\u5171\u626B\u63C
     { key: "reason", header: "\u547D\u4E2D\u539F\u56E0" }
   ];
   const reasonText = {
-    none: "\u2014\uFF08\u5B50\u96C6\u5C55\u793A\uFF0C\u672A\u89E6\u9608\u503C\uFF09",
+    none: "\u2014\uFF08\u672A\u89E6\u9608\u503C\uFF09",
     "low-days": `\u7EED\u822A \u2264 ${thresholdDays} \u5929`,
     "low-balance": `\u4F59\u989D \u2264 ${minBalance ?? 0}`,
     both: `\u7EED\u822A + \u4F59\u989D\u53CC\u4F4E`
@@ -107231,7 +107264,7 @@ ${media} \u8D26\u6237\u4F59\u989D\u626B\u63CF\u5B8C\u6210\uFF1A\u5171\u626B\u63C
   printCliTable(rows, cols);
   console.log(
     `
-  \u63D0\u793A\uFF1A\u4E0A\u8868\u5DF2\u6309\u5269\u4F59\u5929\u6570\u5347\u5E8F\u6392\u5E8F\u3002
+  \u63D0\u793A\uFF1A\u4E0A\u8868\u4E3A\u5168\u90E8\u5DF2\u68C0\u67E5\u8D26\u6237\uFF0C\u6309\u5269\u4F59\u5929\u6570\u5347\u5E8F\uFF1B\u9884\u8B66\u770B\u300C\u547D\u4E2D\u539F\u56E0\u300D\u5217\uFF08JSON \u7528 hitReason !== "none"\uFF09\u3002
        - \u5982\u9700\u8C03\u6574\u9608\u503C\uFF1A--threshold-days 14 / --min-balance 500
        - \u5982\u9700\u8C03\u6574\u65E5\u5747\u56DE\u770B\u5929\u6570\uFF1A--spend-days 3
        - \u5982\u9700\u8C03\u6574\u5EFA\u8BAE\u5145\u503C\u76EE\u6807\u7EED\u822A\uFF1A--target-days 60
@@ -107243,13 +107276,13 @@ ${media} \u8D26\u6237\u4F59\u989D\u626B\u63CF\u5B8C\u6210\uFF1A\u5171\u626B\u63C
 // src/commands/balance-scan/_register.ts
 function register9(program2) {
   program2.command("balance-scan").description(
-    "\u4E00\u952E\u626B\u63CF\u67D0\u5A92\u4F53\u4E0B\u6240\u6709\u8D26\u6237\u7684\u4F59\u989D\uFF0C\u7B5B\u51FA\u7EED\u822A\u5929\u6570\u4E0D\u8DB3\u7684\u8D26\u6237\u3002\u66FF\u4EE3\u5FAA\u73AF\u8C03\u7528 balance \u7684\u4F20\u7EDF\u505A\u6CD5\uFF0C\u5178\u578B\u573A\u666F\uFF1A\u300C\u5E2E\u6211\u627E\u51FA 117 \u4E2A Bing \u8D26\u6237\u91CC\u4F59\u989D\u4E0D\u8DB3 7 \u5929\u7684\u300D\u3002"
+    "\u4E00\u952E\u626B\u63CF\u67D0\u5A92\u4F53\u4E0B\u6709\u6548\u8D26\u6237\u7684\u4F59\u989D\u4E0E\u65E5\u5747\u6D88\u8017\uFF0C\u8FD4\u56DE\u5168\u90E8\u5DF2\u68C0\u67E5\u8D26\u6237\uFF1B\u7528 hitReason \u6807\u8BB0\u7EED\u822A/\u4F59\u989D\u4E0D\u8DB3\u7684\u9884\u8B66\u884C\u3002\u66FF\u4EE3\u5FAA\u73AF\u8C03\u7528 balance \u7684\u4F20\u7EDF\u505A\u6CD5\u3002"
   ).requiredOption(
     "-m, --media <type>",
     "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | MetaAd | BingV2 | Kwai"
   ).option(
     "-a, --accounts <ids>",
-    "\u6307\u5B9A mediaCustomerId\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF1B\u8DF3\u8FC7\u6E05\u5355\u7FFB\u9875\uFF0C\u62C9\u53D6\u540E\u5168\u90E8\u8F93\u51FA\uFF08\u4E0D\u6309\u9608\u503C\u8FC7\u6EE4\uFF09"
+    "\u6307\u5B9A mediaCustomerId\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF1B\u8DF3\u8FC7\u6E05\u5355\u7FFB\u9875\uFF0C\u5BF9\u8FD9\u4E9B ID \u62C9\u4F59\u989D+\u6D88\u8017\u540E\u5168\u90E8\u8F93\u51FA"
   ).option("--threshold-days <n>", "\u5269\u4F59\u7EED\u822A\u5929\u6570\u9608\u503C\uFF08\u9ED8\u8BA4 7\uFF09", (v) => parseFloat(v)).option(
     "--spend-days <n>",
     "\u65E5\u5747\u6D88\u8017\u56DE\u770B\u81EA\u7136\u65E5\u6570\uFF08\u622A\u81F3\u6628\u5929\u4E0D\u542B\u4ECA\u5929\uFF1B\u9ED8\u8BA4 7\uFF1B\u65E5\u5747=\u7A97\u53E3\u5408\u8BA1/\u5929\u6570\uFF09",
@@ -112413,7 +112446,7 @@ function cloneKeywordBlockShell(block) {
   delete shell["matchTypeV2"];
   return shell;
 }
-function splitKeywordsForBatchJobBlockIfMixed(block, path44, warnings) {
+function splitKeywordsForBatchJobBlockIfMixed(block, path47, warnings) {
   const declaredUi = matchTypeV2ToUi(readBlockMatchTypeRaw(block));
   const entries = collectKeywordEntriesFromBlock(block);
   if (entries.length === 0) return [block];
@@ -112432,7 +112465,7 @@ function splitKeywordsForBatchJobBlockIfMixed(block, path44, warnings) {
     (ui) => matchTypeUiToV2(ui)
   );
   warnings.push(
-    `${path44} \u542B\u591A\u79CD\u5339\u914D\u7C7B\u578B\uFF0C\u5DF2\u81EA\u52A8\u62C6\u5206\u4E3A ${groups.size} \u4E2A KeywordsForBatchJob \u5757\uFF08${labels.join("\u3001")}\uFF09`
+    `${path47} \u542B\u591A\u79CD\u5339\u914D\u7C7B\u578B\uFF0C\u5DF2\u81EA\u52A8\u62C6\u5206\u4E3A ${groups.size} \u4E2A KeywordsForBatchJob \u5757\uFF08${labels.join("\u3001")}\uFF09`
   );
   const shell = cloneKeywordBlockShell(block);
   const splitBlocks = [];
@@ -112452,16 +112485,16 @@ function splitKeywordsForBatchJobBlockIfMixed(block, path44, warnings) {
   }
   return splitBlocks;
 }
-function validateKeywordCore(core, path44, errors, lengthViolations) {
+function validateKeywordCore(core, path47, errors, lengthViolations) {
   const trimmed = core.trim();
   if (!trimmed) {
-    errors.push(`${path44} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
+    errors.push(`${path47} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
     return false;
   }
   if (trimmed.length > GOOGLE_KEYWORD_MAX_CORE_LENGTH) {
     if (lengthViolations) {
       pushLengthViolation(lengthViolations, {
-        path: path44,
+        path: path47,
         field: "KeywordText",
         kind: "keyword_core",
         limit: GOOGLE_KEYWORD_MAX_CORE_LENGTH,
@@ -112471,13 +112504,13 @@ function validateKeywordCore(core, path44, errors, lengthViolations) {
       });
     }
     errors.push(
-      `${path44} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed}"`
+      `${path47} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed}"`
     );
     return false;
   }
   if (!VALID_CORE_REGEX.test(trimmed)) {
     errors.push(
-      `${path44} \u542B Google \u4E0D\u5141\u8BB8\u7684\u5B57\u7B26\uFF08\u8BCD\u5E72\u4EC5\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u7A7A\u683C/\u8FDE\u5B57\u7B26/\u53E5\u70B9\uFF09\uFF1A"${trimmed.slice(0, 40)}${trimmed.length > 40 ? "\u2026" : ""}"`
+      `${path47} \u542B Google \u4E0D\u5141\u8BB8\u7684\u5B57\u7B26\uFF08\u8BCD\u5E72\u4EC5\u5141\u8BB8\u5B57\u6BCD/\u6570\u5B57/\u7A7A\u683C/\u8FDE\u5B57\u7B26/\u53E5\u70B9\uFF09\uFF1A"${trimmed.slice(0, 40)}${trimmed.length > 40 ? "\u2026" : ""}"`
     );
     return false;
   }
@@ -112534,24 +112567,24 @@ function canonicalizeKeywordBatchBlock(block, resolvedMatchV2, normalizedTexts,
     }
   }
 }
-function pushKeywordAutoFixWarning(warnings, path44, fieldLabel, trimmedRaw, formatted, declaredUi, beforeUi, matchType, inferredMatchType) {
+function pushKeywordAutoFixWarning(warnings, path47, fieldLabel, trimmedRaw, formatted, declaredUi, beforeUi, matchType, inferredMatchType) {
   if (inferredMatchType) {
     warnings.push(
-      `${path44}.${fieldLabel} \u672A\u6307\u5B9A MatchTypeV2\uFF0C\u5DF2\u6309\u8BCD\u9762\u63A8\u65AD\u4E3A ${matchTypeUiToV2(matchType)}`
+      `${path47}.${fieldLabel} \u672A\u6307\u5B9A MatchTypeV2\uFF0C\u5DF2\u6309\u8BCD\u9762\u63A8\u65AD\u4E3A ${matchTypeUiToV2(matchType)}`
     );
     return;
   }
   if (declaredUi && beforeUi !== declaredUi) {
     warnings.push(
-      `${path44}.${fieldLabel} MatchTypeV2=${matchTypeUiToV2(declaredUi)} \u4E0E\u8BCD\u9762\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u4FEE\u590D\u4E3A\uFF1A${formatted}`
+      `${path47}.${fieldLabel} MatchTypeV2=${matchTypeUiToV2(declaredUi)} \u4E0E\u8BCD\u9762\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u4FEE\u590D\u4E3A\uFF1A${formatted}`
     );
     return;
   }
   if (formatted !== trimmedRaw) {
-    warnings.push(`${path44}.${fieldLabel} \u5DF2\u81EA\u52A8\u4FEE\u590D\u8BCD\u9762\uFF1A${trimmedRaw} \u2192 ${formatted}`);
+    warnings.push(`${path47}.${fieldLabel} \u5DF2\u81EA\u52A8\u4FEE\u590D\u8BCD\u9762\uFF1A${trimmedRaw} \u2192 ${formatted}`);
   }
 }
-function normalizeKeywordTextList(texts, matchTypeRaw, path44, fieldLabel, errors, warnings, lengthViolations) {
+function normalizeKeywordTextList(texts, matchTypeRaw, path47, fieldLabel, errors, warnings, lengthViolations) {
   const declaredUi = matchTypeV2ToUi(matchTypeRaw);
   const normalized = [];
   const seen = /* @__PURE__ */ new Set();
@@ -112559,7 +112592,7 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path44, fieldLabel, error
   for (let k = 0; k < texts.length; k++) {
     const raw = texts[k];
     if (typeof raw !== "string" || !raw.trim()) {
-      errors.push(`${path44}.${fieldLabel}[${k}] \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
+      errors.push(`${path47}.${fieldLabel}[${k}] \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
       continue;
     }
     const trimmedRaw = collapseDuplicateSpacesInKeywordText(raw.trim());
@@ -112570,7 +112603,7 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path44, fieldLabel, error
     );
     pushKeywordAutoFixWarning(
       warnings,
-      path44,
+      path47,
       fieldLabel,
       trimmedRaw,
       formatted,
@@ -112580,11 +112613,11 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path44, fieldLabel, error
       inferredMatchType
     );
     const core = unwrapKeywordDisplayTextForEdit(formatted);
-    if (!validateKeywordCore(core, `${path44}.${fieldLabel}[${k}]`, errors, lengthViolations))
+    if (!validateKeywordCore(core, `${path47}.${fieldLabel}[${k}]`, errors, lengthViolations))
       continue;
     const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
     if (seen.has(dedupeKey)) {
-      warnings.push(`${path44}.${fieldLabel}[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
+      warnings.push(`${path47}.${fieldLabel}[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
       continue;
     }
     seen.add(dedupeKey);
@@ -112593,12 +112626,12 @@ function normalizeKeywordTextList(texts, matchTypeRaw, path44, fieldLabel, error
   }
   return { normalized, resolvedUi };
 }
-function normalizeKeywordsForBatchJobBlock(block, path44, errors, warnings, lengthViolations) {
+function normalizeKeywordsForBatchJobBlock(block, path47, errors, warnings, lengthViolations) {
   const matchTypeRaw = readBlockMatchTypeRaw(block);
   const declaredUi = matchTypeV2ToUi(matchTypeRaw);
   if (matchTypeRaw !== void 0 && declaredUi === null) {
     errors.push(
-      `${path44}.MatchTypeV2 \u65E0\u6548\uFF08${String(matchTypeRaw)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1ABROAD | PHRASE | EXACT`
+      `${path47}.MatchTypeV2 \u65E0\u6548\uFF08${String(matchTypeRaw)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1ABROAD | PHRASE | EXACT`
     );
     return;
   }
@@ -112613,7 +112646,7 @@ function normalizeKeywordsForBatchJobBlock(block, path44, errors, warnings, leng
     const result = normalizeKeywordTextList(
       texts,
       matchTypeRaw,
-      path44,
+      path47,
       "KeywordText",
       errors,
       warnings,
@@ -112622,7 +112655,7 @@ function normalizeKeywordsForBatchJobBlock(block, path44, errors, warnings, leng
     normalizedTexts = result.normalized;
     if (result.resolvedUi) resolvedUi = result.resolvedUi;
     if (normalizedTexts.length === 0 && texts.length > 0) {
-      errors.push(`${path44}.KeywordText \u7ECF\u6821\u9A8C\u540E\u65E0\u6709\u6548\u5173\u952E\u8BCD\uFF0C\u8BF7\u4FEE\u6B63\u8BCD\u9762\u6216 MatchTypeV2`);
+      errors.push(`${path47}.KeywordText \u7ECF\u6821\u9A8C\u540E\u65E0\u6709\u6548\u5173\u952E\u8BCD\uFF0C\u8BF7\u4FEE\u6B63\u8BCD\u9762\u6216 MatchTypeV2`);
     }
   }
   if (hasItems && items2) {
@@ -112630,12 +112663,12 @@ function normalizeKeywordsForBatchJobBlock(block, path44, errors, warnings, leng
     for (let k = 0; k < items2.length; k++) {
       const item = items2[k];
       if (!item || typeof item !== "object") {
-        errors.push(`${path44}.Items[${k}] \u5FC5\u987B\u662F\u5BF9\u8C61`);
+        errors.push(`${path47}.Items[${k}] \u5FC5\u987B\u662F\u5BF9\u8C61`);
         continue;
       }
       const raw = readItemText(item);
       if (raw === null || !raw.trim()) {
-        errors.push(`${path44}.Items[${k}].Text \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
+        errors.push(`${path47}.Items[${k}].Text \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32`);
         continue;
       }
       const trimmedRaw = collapseDuplicateSpacesInKeywordText(raw.trim());
@@ -112646,7 +112679,7 @@ function normalizeKeywordsForBatchJobBlock(block, path44, errors, warnings, leng
       );
       pushKeywordAutoFixWarning(
         warnings,
-        path44,
+        path47,
         `Items[${k}].Text`,
         trimmedRaw,
         formatted,
@@ -112656,11 +112689,11 @@ function normalizeKeywordsForBatchJobBlock(block, path44, errors, warnings, leng
         inferredMatchType
       );
       const core = unwrapKeywordDisplayTextForEdit(formatted);
-      if (!validateKeywordCore(core, `${path44}.Items[${k}].Text`, errors, lengthViolations))
+      if (!validateKeywordCore(core, `${path47}.Items[${k}].Text`, errors, lengthViolations))
         continue;
       const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
       if (seen.has(dedupeKey)) {
-        warnings.push(`${path44}.Items[${k}].Text \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
+        warnings.push(`${path47}.Items[${k}].Text \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
         continue;
       }
       seen.add(dedupeKey);
@@ -112805,16 +112838,16 @@ function warnIfNegativeKeywordsInPositiveKeywords(campaign, warnings) {
         const raw = texts[ki];
         if (typeof raw !== "string" || !raw.trim()) continue;
         const core = normalizeKeywordCoreForNegativeCheck(raw);
-        const path44 = `campaign.AdGroupsForBatchJob[${gi}].KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
+        const path47 = `campaign.AdGroupsForBatchJob[${gi}].KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
         if (plannedNegCores.has(core)) {
           warnings.push(
-            `${path44} \u8BCD\u9762\u300C${raw}\u300D\u5DF2\u51FA\u73B0\u5728 campaign.NegativeKeywordsForBatchJob\uFF0C\u4E0D\u5E94\u91CD\u590D\u5199\u5165\u6B63\u5411 KeywordsForBatchJob\uFF1B\u5426\u8BCD\u53EA\u653E NegativeKeywordsForBatchJob`
+            `${path47} \u8BCD\u9762\u300C${raw}\u300D\u5DF2\u51FA\u73B0\u5728 campaign.NegativeKeywordsForBatchJob\uFF0C\u4E0D\u5E94\u91CD\u590D\u5199\u5165\u6B63\u5411 KeywordsForBatchJob\uFF1B\u5426\u8BCD\u53EA\u653E NegativeKeywordsForBatchJob`
           );
           continue;
         }
         if (looksLikeStandaloneNegativeKeyword(core)) {
           warnings.push(
-            `${path44} \u8BCD\u9762\u300C${raw}\u300D\u7591\u4F3C\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u5E38\u89C1\u5426\u8BCD\u8BCD\u6839\uFF09\uFF0C\u5E94\u5199\u5165 campaign.NegativeKeywordsForBatchJob\uFF08MatchTypeV2: BROAD\uFF09\uFF0C\u52FF\u653E\u5165 KeywordsForBatchJob`
+            `${path47} \u8BCD\u9762\u300C${raw}\u300D\u7591\u4F3C\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u5E38\u89C1\u5426\u8BCD\u8BCD\u6839\uFF09\uFF0C\u5E94\u5199\u5165 campaign.NegativeKeywordsForBatchJob\uFF08MatchTypeV2: BROAD\uFF09\uFF0C\u52FF\u653E\u5165 KeywordsForBatchJob`
           );
         }
       }
@@ -116445,13 +116478,13 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           for (let ki = 0; ki < texts.length; ki++) {
             const t = texts[ki];
             if (typeof t !== "string" || !t.trim()) continue;
-            const path44 = `${groupPath}.KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
+            const path47 = `${groupPath}.KeywordsForBatchJob[${bi}].KeywordText[${ki}]`;
             const key = keywordKey(t, matchTypeV2);
             const plannedContent = `\u8BCD\u9762: ${t}  |  \u5339\u914D: ${matchTypeV2}`;
             if (groupAbsent) {
               pushItem(items2, {
                 layer: "keyword",
-                path: path44,
+                path: path47,
                 adGroupName: groupName,
                 plannedContent,
                 status: "skipped",
@@ -116463,7 +116496,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
             if (!liveKwKeys.has(key)) {
               pushItem(items2, {
                 layer: "keyword",
-                path: path44,
+                path: path47,
                 adGroupName: groupName,
                 plannedContent,
                 status: "missing",
@@ -116473,7 +116506,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
             } else {
               pushItem(items2, {
                 layer: "keyword",
-                path: path44,
+                path: path47,
                 adGroupName: groupName,
                 plannedContent,
                 status: "ok",
@@ -116498,14 +116531,14 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
         for (let ai = 0; ai < ads.length; ai++) {
           const ad = asRecord3(ads[ai]);
           if (!ad) continue;
-          const path44 = `${groupPath}.AdsForBatchJob[${ai}]`;
+          const path47 = `${groupPath}.AdsForBatchJob[${ai}]`;
           const primary = pickString2(ad["headlinePart1"], ad["AdTitle"]);
           const finalUrl = pickString2(ad["Finalurl"], ad["DestinationUrl"], ad["finalUrl"]);
           const rsaAssets = listPlannedRsaAssets(ad, groupPath, ai, groupName);
           if (groupAbsent) {
             pushItem(items2, {
               layer: "ad",
-              path: path44,
+              path: path47,
               adGroupName: groupName,
               plannedContent: primary ? `RSA \u9996\u6807\u9898: ${primary}${finalUrl ? `  |  \u843D\u5730\u9875: ${finalUrl}` : ""}` : `AdsForBatchJob[${ai}]\uFF08\u7F3A\u5C11 headlinePart1\uFF09`,
               status: "skipped",
@@ -116529,7 +116562,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           if (!primary) {
             pushItem(items2, {
               layer: "ad",
-              path: path44,
+              path: path47,
               adGroupName: groupName,
               plannedContent: `AdsForBatchJob[${ai}]\uFF08\u7F3A\u5C11 headlinePart1\uFF0C\u65E0\u6CD5\u6BD4\u5BF9\u6574\u6761 RSA\uFF09`,
               status: "missing",
@@ -116555,7 +116588,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           const rsaFound = liveAdsInGroup.some((la) => liveAdHasHeadline(la, primary));
           pushItem(items2, {
             layer: "ad",
-            path: path44,
+            path: path47,
             adGroupName: groupName,
             plannedContent: `RSA \u9996\u6807\u9898: ${primary}${finalUrl ? `  |  \u843D\u5730\u9875: ${finalUrl}` : ""}`,
             status: rsaFound ? "ok" : "missing",
@@ -116621,11 +116654,11 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
     for (let ei = 0; ei < extBlocks.length; ei++) {
       const ext = asRecord3(extBlocks[ei]);
       const plannedContent = formatExtensionPlanned(ext);
-      const path44 = `campaign.ExtensionsForBatchJob[${ei}]`;
+      const path47 = `campaign.ExtensionsForBatchJob[${ei}]`;
       if (campaignMissing) {
         pushItem(items2, {
           layer: "extension",
-          path: path44,
+          path: path47,
           plannedContent,
           status: "skipped",
           liveNote: "\u7CFB\u5217\u672A\u627E\u5230\uFF0C\u8DF3\u8FC7\u9644\u52A0\u4FE1\u606F\u6BD4\u5BF9",
@@ -116637,7 +116670,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const remediateCommand = !found && ext && accountId && campaignId ? buildExtensionRemediateCommandLine({ accountId, campaignId, ext }) ?? void 0 : void 0;
       pushItem(items2, {
         layer: "extension",
-        path: path44,
+        path: path47,
         plannedContent,
         status: found ? "ok" : "missing",
         liveNote: `\u7CFB\u5217\u7EA7\u9644\u52A0\u4FE1\u606F\u8D26\u6237\u5185 ${liveExt}/${plannedExt} \u6761`,
@@ -116664,11 +116697,11 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       if (!id) continue;
       const displayName = locationNames[li] || pickString2(loc["locationName"], loc["name"], loc["countryOrRegion"]) || "";
       const plannedContent = `locationId: ${id}${displayName ? `  |  \u540D\u79F0: ${displayName}` : ""}`;
-      const path44 = `campaign.targetedLocations[${li}]`;
+      const path47 = `campaign.targetedLocations[${li}]`;
       if (campaignMissing) {
         pushItem(items2, {
           layer: "location",
-          path: path44,
+          path: path47,
           plannedContent,
           status: "skipped",
           liveNote: "\u7CFB\u5217\u672A\u627E\u5230\uFF0C\u8DF3\u8FC7\u5730\u57DF\u6BD4\u5BF9",
@@ -116680,7 +116713,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const remediateCommand = !found && accountId && campaignId ? buildGeoRemediateCommandLine({ accountId, campaignId, locationId: id }) : void 0;
       pushItem(items2, {
         layer: "location",
-        path: path44,
+        path: path47,
         plannedContent,
         status: found ? "ok" : "missing",
         liveNote: `\u7CFB\u5217\u5DF2\u5B9A\u5411 ${liveLocIds.size}/${plannedLocCount} \u4E2A\u5730\u57DF`,
@@ -118192,8 +118225,8 @@ function pmaxChannelTypesUrl(googleApiUrl) {
 }
 function pmaxCampaignUrl(googleApiUrl, accountId, campaignId) {
   const base = googleApiUrl.replace(/\/$/, "");
-  const path44 = `${base}/accounts/${accountId}/campaign/pmax`;
-  return campaignId ? `${path44}/${campaignId}` : path44;
+  const path47 = `${base}/accounts/${accountId}/campaign/pmax`;
+  return campaignId ? `${path47}/${campaignId}` : path47;
 }
 function pmaxBrandAssetsUrl(googleApiUrl, accountId, campaignId) {
   return `${pmaxCampaignUrl(googleApiUrl, accountId, campaignId)}/brand-assets`;
@@ -118203,8 +118236,8 @@ function pmaxBrandGuidelinesEnableUrl(googleApiUrl, accountId, campaignId) {
 }
 function pmaxAssetGroupUrl(googleApiUrl, accountId, assetGroupId, suffix) {
   const base = googleApiUrl.replace(/\/$/, "");
-  const path44 = `${base}/accounts/${accountId}/campaign/pmax/asset-group/${assetGroupId}`;
-  return suffix ? `${path44}/${suffix.replace(/^\//, "")}` : path44;
+  const path47 = `${base}/accounts/${accountId}/campaign/pmax/asset-group/${assetGroupId}`;
+  return suffix ? `${path47}/${suffix.replace(/^\//, "")}` : path47;
 }
 function pmaxCampaignAssetGroupUrl(googleApiUrl, accountId, campaignId) {
   const base = googleApiUrl.replace(/\/$/, "");
@@ -120945,8 +120978,8 @@ async function runAdPmaxImageConvert(opts) {
 }
 
 // src/commands/ad/pmax-brand-mgmt.ts
-function loadBrandConfig(path44, accountId, campaignId) {
-  const cfg = loadPmaxJsonFile(path44);
+function loadBrandConfig(path47, accountId, campaignId) {
+  const cfg = loadPmaxJsonFile(path47);
   return {
     ...cfg,
     account: String(cfg["account"] ?? accountId).trim(),
@@ -129664,9 +129697,9 @@ function asRecord7(value) {
   }
   return null;
 }
-function getNestedValue(root, path44) {
+function getNestedValue(root, path47) {
   let cur = root;
-  for (const key of path44) {
+  for (const key of path47) {
     const rec = asRecord7(cur);
     if (!rec) return void 0;
     cur = rec[key];
@@ -133961,6 +133994,855 @@ function registerTikTokAnalysisCommands(program2) {
   );
 }
 
+// src/commands/yandex-analysis/register-cli.ts
+import { Command as Command5 } from "commander";
+
+// src/commands/yandex-analysis/sections.ts
+var YANDEX_SECTIONS = [
+  {
+    name: "overview",
+    description: "\u8D26\u6237\u603B\u89C8\uFF1A\u4F59\u989D + \u533A\u95F4\u6C47\u603B KPI",
+    path: "overview"
+  },
+  {
+    name: "daily",
+    description: "\u6309\u65E5\u7EE9\u6548\uFF08\u53EF\u4F9B\u8C03\u7528\u65B9\u81EA\u884C\u805A\u5468\uFF09",
+    path: "daily"
+  },
+  {
+    name: "search",
+    description: "\u7F51\u7EDC\u7EF4\u5EA6\uFF08\u4EC5 SEARCH\uFF09",
+    path: "search"
+  },
+  {
+    name: "campaigns",
+    description: "Campaign \u7EE9\u6548 + \u9884\u7B97/\u6218\u7565/targetCpa",
+    path: "campaigns",
+    limitOption: true
+  },
+  {
+    name: "keywords",
+    description: "\u5173\u952E\u8BCD\uFF08Criteria\uFF09\u7EE9\u6548",
+    path: "keywords",
+    limitOption: true
+  },
+  {
+    name: "search-terms",
+    description: "\u641C\u7D22\u8BCD\u7EE9\u6548\uFF08Direct \u9650\u5236\uFF1A\u4EC5\u8FD1 180 \u5929\uFF09",
+    path: "search-terms",
+    limitOption: true,
+    searchTermsMaxDays: 180
+  },
+  {
+    name: "geo",
+    description: "\u5730\u57DF\u7EE9\u6548\uFF08\u4EC5 SEARCH\uFF09",
+    path: "geo",
+    limitOption: true
+  },
+  {
+    name: "devices",
+    description: "\u8BBE\u5907\u7EE9\u6548\uFF08\u4EC5 SEARCH\uFF09",
+    path: "devices"
+  }
+];
+var YANDEX_SECTION_NAMES = YANDEX_SECTIONS.map((s) => s.name);
+var YANDEX_SECTION_ALIASES = {
+  geographic: "geo",
+  device: "devices",
+  "search-queries": "search-terms"
+};
+
+// src/commands/yandex-analysis/run-batch.ts
+init_auth();
+import * as path43 from "path";
+import { performance as performance8 } from "perf_hooks";
+init_version();
+
+// src/commands/yandex-analysis/fetch.ts
+init_auth();
+var YANDEX_KEYWORD_LIMIT_DEFAULT = 100;
+var YANDEX_KEYWORD_LIMIT_MAX = 1e4;
+var YANDEX_SEARCH_TERMS_MAX_DAYS = 180;
+function stripLocalDate2(d) {
+  return new Date(d.getFullYear(), d.getMonth(), d.getDate());
+}
+function parseLocalYmd2(ymd) {
+  const parts = ymd.trim().split("-").map((x) => parseInt(x, 10));
+  if (parts.length !== 3 || parts.some((n) => !Number.isFinite(n))) {
+    return /* @__PURE__ */ new Date(NaN);
+  }
+  const [y, m, day] = parts;
+  return new Date(y, m - 1, day);
+}
+function formatLocalYmd2(d) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+function daysInclusive(start, end) {
+  const ms = stripLocalDate2(end).getTime() - stripLocalDate2(start).getTime();
+  return Math.floor(ms / 864e5) + 1;
+}
+function resolveYandexDateRange(start, end) {
+  if (start && end) {
+    const s = parseLocalYmd2(start);
+    const e = parseLocalYmd2(end);
+    if (Number.isNaN(s.getTime()) || Number.isNaN(e.getTime())) {
+      console.error("\n\u274C --start / --end \u987B\u4E3A\u6709\u6548\u65E5\u671F YYYY-MM-DD\u3002\n");
+      process.exit(1);
+    }
+    if (s > e) {
+      console.error("\n\u274C \u5F00\u59CB\u65E5\u671F\u4E0D\u80FD\u665A\u4E8E\u7ED3\u675F\u65E5\u671F\u3002\n");
+      process.exit(1);
+    }
+    const today = stripLocalDate2(/* @__PURE__ */ new Date());
+    if (stripLocalDate2(s) > today || stripLocalDate2(e) > today) {
+      console.error("\n\u274C Yandex \u62A5\u8868\u8D77\u6B62\u65E5\u671F\u4E0D\u80FD\u665A\u4E8E\u4ECA\u5929\u3002\n");
+      process.exit(1);
+    }
+    return { startDate: start.trim(), endDate: end.trim() };
+  }
+  if (!start && !end) {
+    const endD = stripLocalDate2(/* @__PURE__ */ new Date());
+    const startD = new Date(endD);
+    startD.setDate(startD.getDate() - 6);
+    return { startDate: formatLocalYmd2(startD), endDate: formatLocalYmd2(endD) };
+  }
+  console.error(
+    "\n\u274C --start \u4E0E --end \u987B\u540C\u65F6\u4F20\u5165\uFF0C\u6216\u540C\u65F6\u7701\u7565\u4EE5\u4F7F\u7528\u9ED8\u8BA4\u533A\u95F4\uFF08\u8FD1 7 \u5929\uFF0C\u542B\u4ECA\u5929\uFF09\u3002\n"
+  );
+  process.exit(1);
+}
+function assertYandexSearchTermsRange(startDate, endDate) {
+  const s = parseLocalYmd2(startDate);
+  const e = parseLocalYmd2(endDate);
+  const today = stripLocalDate2(/* @__PURE__ */ new Date());
+  const earliest = new Date(today);
+  earliest.setDate(earliest.getDate() - (YANDEX_SEARCH_TERMS_MAX_DAYS - 1));
+  if (stripLocalDate2(s) < earliest || stripLocalDate2(e) > today) {
+    console.error(
+      `
+\u274C search-terms \u4EC5\u652F\u6301\u8FD1 ${YANDEX_SEARCH_TERMS_MAX_DAYS} \u5929\uFF08Direct \u9650\u5236\uFF09\u3002\u8BF7\u5C06 --start/--end \u9650\u5236\u5728 ${formatLocalYmd2(earliest)} ~ ${formatLocalYmd2(today)}\u3002
+`
+    );
+    process.exit(1);
+  }
+  if (daysInclusive(s, e) > YANDEX_SEARCH_TERMS_MAX_DAYS) {
+    console.error(
+      `
+\u274C search-terms \u67E5\u8BE2\u8DE8\u5EA6\u4E0D\u80FD\u8D85\u8FC7 ${YANDEX_SEARCH_TERMS_MAX_DAYS} \u5929\u3002
+`
+    );
+    process.exit(1);
+  }
+}
+function assertYandexAccountId(id) {
+  const t = id.trim();
+  if (!t) {
+    console.error("\n\u274C --account \u4E0D\u80FD\u4E3A\u7A7A\uFF08Yandex Client-Login / mediaCustomerId\uFF0C\u5982 porg-xxx\uFF09\u3002\n");
+    process.exit(1);
+  }
+  return t;
+}
+function requireYandexApi(config) {
+  const base = (config.yandexApiUrl ?? "").replace(/\/$/, "");
+  if (!base) {
+    console.error(
+      "\n\u274C \u672A\u627E\u5230 Yandex API \u5730\u5740\uFF08yandexApiUrl\uFF09\u3002\n   \u4ECE TSO API \u5730\u5740\u81EA\u52A8\u63A8\u5BFC\uFF0C\u4E5F\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF SILUZAN_YANDEX_API \u8986\u76D6\u3002\n"
+    );
+    process.exit(1);
+  }
+  return base;
+}
+function resolveYandexLimit(raw) {
+  const n = typeof raw === "number" ? raw : parseInt(String(raw ?? ""), 10);
+  if (!Number.isFinite(n) || n <= 0) return YANDEX_KEYWORD_LIMIT_DEFAULT;
+  return Math.min(Math.floor(n), YANDEX_KEYWORD_LIMIT_MAX);
+}
+function analysisUrl(yandexApiUrl, pathSeg, query) {
+  const base = yandexApiUrl.replace(/\/$/, "");
+  const q = query ? query.startsWith("?") ? query : `?${query}` : "";
+  return `${base}/yandex-analysis/${pathSeg}${q}`;
+}
+async function fetchYandexSectionPayload(def, opts, config, accountId) {
+  const { startDate, endDate } = resolveYandexDateRange(opts.start, opts.end);
+  if (def.searchTermsMaxDays) {
+    assertYandexSearchTermsRange(startDate, endDate);
+  }
+  const yandexApiUrl = requireYandexApi(config);
+  const params = new URLSearchParams({
+    account: accountId,
+    start: startDate,
+    end: endDate
+  });
+  if (def.limitOption) {
+    params.set("limit", String(resolveYandexLimit(opts.limit)));
+  }
+  const url = analysisUrl(yandexApiUrl, def.path, params.toString());
+  return apiFetch2(url, config, {}, !!opts.verbose);
+}
+function endpointHintForYandexSection(def) {
+  return `GET \u2026/yandex-analysis/${def.path}?account=&start=&end=`;
+}
+
+// src/commands/yandex-analysis/resolve-sections.ts
+function normalizeSectionToken4(raw) {
+  const t = raw.trim();
+  if (!t) return null;
+  if (YANDEX_SECTION_NAMES.includes(t)) {
+    return t;
+  }
+  return YANDEX_SECTION_ALIASES[t] ?? null;
+}
+function resolveSectionList5(sections, exclude) {
+  const splitClean = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const include = splitClean(sections);
+  const dropRaw = splitClean(exclude);
+  const unknown = [...include, ...dropRaw].filter((n) => normalizeSectionToken4(n) === null);
+  if (unknown.length > 0) {
+    console.error(
+      `
+\u274C \u672A\u77E5\u7684 section \u540D\u79F0\uFF1A${unknown.join(", ")}
+   \u53EF\u9009\uFF1A${YANDEX_SECTION_NAMES.join(", ")}
+   \u522B\u540D\uFF1A${Object.keys(YANDEX_SECTION_ALIASES).join(", ")}
+`
+    );
+    process.exit(1);
+  }
+  const includeCanonical = new Set(include.map((n) => normalizeSectionToken4(n)).filter(Boolean));
+  const dropCanonical = new Set(dropRaw.map((n) => normalizeSectionToken4(n)).filter(Boolean));
+  const base = include.length > 0 ? YANDEX_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...YANDEX_SECTIONS];
+  return base.filter((s) => !dropCanonical.has(s.name));
+}
+
+// src/commands/yandex-analysis/run-batch.ts
+async function runWithConcurrency6(tasks, concurrency) {
+  const results = new Array(tasks.length);
+  let cursor = 0;
+  const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
+    while (true) {
+      const i = cursor++;
+      if (i >= tasks.length) return;
+      results[i] = await tasks[i]();
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function runAllYandexSections(opts) {
+  const id = assertYandexAccountId(opts.account);
+  const config = loadConfig(opts.token);
+  if (!opts.jsonOut?.trim()) {
+    console.error("\n\u274C \u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF08\u5404\u7EF4\u5EA6\u843D\u76D8\u540E\u7531 report-manifest \u7D22\u5F15\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const targets = resolveSectionList5(opts.sections, opts.exclude);
+  if (targets.length === 0) {
+    console.error("\n\u274C \u6CA1\u6709\u8981\u6267\u884C\u7684 section\uFF08\u8BF7\u68C0\u67E5 --sections / --exclude\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const { startDate, endDate } = resolveYandexDateRange(opts.start, opts.end);
+  const concurrency = Math.max(
+    1,
+    Math.min(typeof opts.concurrency === "number" ? opts.concurrency : 5, 16)
+  );
+  const cliVersion = getCurrentVersion2();
+  const overallT0 = performance8.now();
+  const tasks = targets.map((def) => async () => {
+    const t0 = performance8.now();
+    const hint = endpointHintForYandexSection(def);
+    try {
+      const payload = await fetchYandexSectionPayload(
+        def,
+        { ...opts, start: startDate, end: endDate },
+        config,
+        id
+      );
+      const summary2 = await writeReportAnalysisSnapshot({
+        snapshotDir: opts.jsonOut,
+        section: def.name,
+        accountId: id,
+        dateRange: { start: startDate, end: endDate },
+        payload,
+        cliVersion
+      });
+      return {
+        section: def.name,
+        ok: true,
+        elapsedMs: performance8.now() - t0,
+        file: summary2.writtenFiles[0],
+        endpointHint: hint
+      };
+    } catch (err) {
+      return {
+        section: def.name,
+        ok: false,
+        elapsedMs: performance8.now() - t0,
+        error: err instanceof Error ? err.message : String(err),
+        endpointHint: hint
+      };
+    }
+  });
+  const results = await runWithConcurrency6(tasks, concurrency);
+  const succeeded = results.filter((r) => r.ok).length;
+  const failed = results.length - succeeded;
+  const absoluteSnapshotDir = path43.resolve(opts.jsonOut);
+  const summary = {
+    kind: "siluzan-tso-yandex-analysis-snapshot-batch",
+    absoluteSnapshotDir,
+    manifestFile: reportManifestFile(id),
+    accountId: id,
+    totalSections: results.length,
+    succeeded,
+    failed,
+    concurrency,
+    elapsedMs: performance8.now() - overallT0,
+    results
+  };
+  console.log(JSON.stringify(summary));
+  if (failed > 0) process.exit(2);
+}
+
+// src/commands/yandex-analysis/render-report.ts
+import fs34 from "fs";
+import fsPromises7 from "fs/promises";
+import path45 from "path";
+import { fileURLToPath as fileURLToPath11 } from "url";
+
+// src/commands/yandex-analysis/merge-snapshot.ts
+import * as fs33 from "fs/promises";
+import * as path44 from "path";
+function asRecord26(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function num10(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
+function round25(value) {
+  return value == null ? void 0 : Math.round(value * 100) / 100;
+}
+function asItems(payload) {
+  const obj = asRecord26(payload);
+  if (!obj) return [];
+  const items2 = obj.items;
+  if (!Array.isArray(items2)) return [];
+  return items2.filter((r) => asRecord26(r) !== null);
+}
+function pickMetrics2(row, extras = []) {
+  const out = {
+    spend: num10(row.spend) ?? 0,
+    impressions: num10(row.impressions) ?? 0,
+    clicks: num10(row.clicks) ?? 0,
+    ctr: num10(row.ctr),
+    averageCpc: num10(row.averageCpc),
+    conversions: num10(row.conversions) ?? 0,
+    conversionRate: num10(row.conversionRate),
+    costPerConversion: num10(row.costPerConversion),
+    roi: num10(row.roi)
+  };
+  for (const f of extras) {
+    if (row[f] !== void 0 && row[f] !== null) out[f] = row[f];
+  }
+  return out;
+}
+async function loadSectionPayload3(snapshotDir, file) {
+  try {
+    const raw = await fs33.readFile(path44.join(snapshotDir, file), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function readManifest6(snapshotDir, accountId) {
+  const candidates = [];
+  if (accountId) candidates.push(reportManifestFile(accountId));
+  try {
+    const entries = await fs33.readdir(snapshotDir);
+    for (const name2 of entries.filter(
+      (n) => n.startsWith("report-manifest") && n.endsWith(".json")
+    )) {
+      if (!candidates.includes(name2)) candidates.push(name2);
+    }
+  } catch {
+  }
+  for (const name2 of candidates) {
+    try {
+      const raw = await fs33.readFile(path44.join(snapshotDir, name2), "utf8");
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed.artifacts) && parsed.artifacts.length > 0) return parsed;
+    } catch {
+    }
+  }
+  return null;
+}
+function parseYmd2(value) {
+  const s = String(value ?? "").trim().slice(0, 10);
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(s);
+  if (!m) return null;
+  const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+  return Number.isNaN(d.getTime()) ? null : d;
+}
+function formatYmd2(d) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+function isoWeekKey(d) {
+  const day = new Date(d.getFullYear(), d.getMonth(), d.getDate());
+  const dow = (day.getDay() + 6) % 7;
+  const weekStart = new Date(day);
+  weekStart.setDate(weekStart.getDate() - dow);
+  const thursday = new Date(weekStart);
+  thursday.setDate(thursday.getDate() + 3);
+  const yearStart = new Date(thursday.getFullYear(), 0, 1);
+  const week = Math.floor((thursday.getTime() - yearStart.getTime()) / 864e5 / 7) + 1;
+  const label = `W${String(week).padStart(2, "0")}`;
+  return { key: `${thursday.getFullYear()}-${label}`, label, weekStart };
+}
+function aggregateDailyToWeekly(dailyRows) {
+  const map = /* @__PURE__ */ new Map();
+  for (const row of dailyRows) {
+    const d = parseYmd2(row.date);
+    if (!d) continue;
+    const { key, label, weekStart } = isoWeekKey(d);
+    let acc = map.get(key);
+    if (!acc) {
+      acc = {
+        label,
+        weekStart,
+        minDate: d,
+        maxDate: d,
+        spend: 0,
+        impressions: 0,
+        clicks: 0,
+        conversions: 0
+      };
+      map.set(key, acc);
+    }
+    if (d < acc.minDate) acc.minDate = d;
+    if (d > acc.maxDate) acc.maxDate = d;
+    acc.spend += num10(row.spend) ?? 0;
+    acc.impressions += num10(row.impressions) ?? 0;
+    acc.clicks += num10(row.clicks) ?? 0;
+    acc.conversions += num10(row.conversions) ?? 0;
+  }
+  return [...map.values()].sort((a, b) => a.weekStart.getTime() - b.weekStart.getTime()).map((acc) => {
+    const days = Math.floor((acc.maxDate.getTime() - acc.minDate.getTime()) / 864e5) + 1;
+    return {
+      weekLabel: acc.label,
+      startDate: formatYmd2(acc.minDate),
+      endDate: formatYmd2(acc.maxDate),
+      days,
+      spend: round25(acc.spend),
+      impressions: Math.round(acc.impressions),
+      clicks: Math.round(acc.clicks),
+      conversions: round25(acc.conversions),
+      ctr: acc.impressions > 0 ? acc.clicks / acc.impressions : void 0,
+      averageCpc: acc.clicks > 0 ? round25(acc.spend / acc.clicks) : void 0,
+      costPerConversion: acc.conversions > 0 ? round25(acc.spend / acc.conversions) : void 0
+    };
+  });
+}
+function mapDailyRows(payload) {
+  return asItems(payload).map((r) => {
+    const dateRaw = r.date;
+    const date = typeof dateRaw === "string" ? dateRaw.slice(0, 10) : dateRaw != null ? String(dateRaw).slice(0, 10) : "";
+    return pickMetrics2({ ...r, date }, ["date"]);
+  });
+}
+function mapSearchRows(payload) {
+  return asItems(payload).map((r) => pickMetrics2(r, ["network"]));
+}
+function mapCampaignRows2(payload) {
+  return asItems(payload).map(
+    (r) => pickMetrics2(r, [
+      "campaignId",
+      "campaignName",
+      "status",
+      "state",
+      "campaignType",
+      "budget",
+      "strategy",
+      "targetCpa",
+      "network"
+    ])
+  );
+}
+function mapKeywordRows2(payload) {
+  return asItems(payload).map(
+    (r) => pickMetrics2(r, [
+      "campaignId",
+      "campaignName",
+      "adGroupId",
+      "keyword",
+      "criteriaType",
+      "network"
+    ])
+  );
+}
+function mapSearchTermRows2(payload) {
+  return asItems(payload).map(
+    (r) => pickMetrics2(r, [
+      "searchQuery",
+      "matchedKeyword",
+      "campaignId",
+      "campaignName",
+      "adGroupId"
+    ])
+  );
+}
+function mapGeoRows(payload) {
+  return asItems(payload).map(
+    (r) => pickMetrics2(r, ["locationName", "targetingLocationName", "network"])
+  );
+}
+function mapDeviceRows2(payload) {
+  return asItems(payload).map((r) => pickMetrics2(r, ["device", "network"]));
+}
+async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
+  const absDir = path44.resolve(snapshotDir);
+  const metaAccountId = typeof asRecord26(payload.meta)?.accountId === "string" ? asRecord26(payload.meta)?.accountId : void 0;
+  const manifest = await readManifest6(snapshotDir, metaAccountId);
+  if (!manifest) {
+    throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 report-manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C yandex-analysis --json-out`);
+  }
+  const sectionMap = /* @__PURE__ */ new Map();
+  for (const art of manifest.artifacts ?? []) {
+    const data = await loadSectionPayload3(absDir, art.file);
+    if (data != null) sectionMap.set(art.section, data);
+  }
+  const overview = asRecord26(sectionMap.get("overview"));
+  const totals = asRecord26(overview?.totals);
+  const accountId = manifest.accountId ?? metaAccountId;
+  const meta = { ...payload.meta ?? {} };
+  if (!meta.accountId && accountId) meta.accountId = accountId;
+  if (!meta.currency && typeof overview?.currency === "string") meta.currency = overview.currency;
+  if (!meta.startDate && manifest.dateRange) meta.startDate = manifest.dateRange.start;
+  if (!meta.endDate && manifest.dateRange) meta.endDate = manifest.dateRange.end;
+  if (!meta.generatedAt) meta.generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  if (!meta.platform) meta.platform = "Yandex Direct";
+  const kpis = { ...payload.kpis ?? {} };
+  if (totals) {
+    if (num10(totals.spend) != null) kpis.spend = round25(num10(totals.spend));
+    if (num10(totals.impressions) != null) kpis.impressions = Math.round(num10(totals.impressions));
+    if (num10(totals.clicks) != null) kpis.clicks = Math.round(num10(totals.clicks));
+    if (num10(totals.conversions) != null) kpis.conversions = round25(num10(totals.conversions));
+    if (num10(totals.ctr) != null) kpis.ctr = num10(totals.ctr);
+    if (num10(totals.averageCpc) != null) kpis.averageCpc = round25(num10(totals.averageCpc));
+    if (num10(totals.costPerConversion) != null) {
+      kpis.costPerConversion = round25(num10(totals.costPerConversion));
+    }
+    if (num10(totals.conversionRate) != null) kpis.conversionRate = num10(totals.conversionRate);
+    if (num10(totals.roi) != null) kpis.roi = num10(totals.roi);
+  }
+  if (overview) {
+    if (num10(overview.balance) != null) kpis.balance = round25(num10(overview.balance));
+    if (num10(overview.avgDailySpend) != null) kpis.avgDailySpend = round25(num10(overview.avgDailySpend));
+    if (num10(overview.activeDays) != null) kpis.activeDays = num10(overview.activeDays);
+    if (overview.balanceAsOf != null) kpis.balanceAsOf = overview.balanceAsOf;
+  }
+  if (kpis.balance != null && kpis.avgDailySpend != null && Number(kpis.avgDailySpend) > 0) {
+    kpis.runwayDays = Math.round(Number(kpis.balance) / Number(kpis.avgDailySpend));
+  }
+  const tables = { ...payload.tables ?? {} };
+  const dailyRows = mapDailyRows(sectionMap.get("daily"));
+  if (dailyRows.length > 0) {
+    tables.daily = dailyRows;
+    tables.weekly = aggregateDailyToWeekly(dailyRows);
+  }
+  {
+    const rows = mapSearchRows(sectionMap.get("search"));
+    if (rows.length > 0) tables.search = rows;
+  }
+  {
+    const rows = mapCampaignRows2(sectionMap.get("campaigns"));
+    if (rows.length > 0) tables.campaigns = rows;
+  }
+  {
+    const rows = mapKeywordRows2(sectionMap.get("keywords"));
+    if (rows.length > 0) tables.keywords = rows;
+  }
+  {
+    const rows = mapSearchTermRows2(sectionMap.get("search-terms"));
+    if (rows.length > 0) tables.searchTerms = rows;
+  }
+  {
+    const rows = mapGeoRows(sectionMap.get("geo"));
+    if (rows.length > 0) tables.geo = rows;
+  }
+  {
+    const rows = mapDeviceRows2(sectionMap.get("devices"));
+    if (rows.length > 0) tables.devices = rows;
+  }
+  return { ...payload, meta, kpis, tables };
+}
+
+// src/commands/yandex-analysis/report-content.ts
+var SECTION_KEYS4 = [
+  "overview",
+  "search",
+  "campaigns",
+  "keywords",
+  "searchTerms",
+  "geo",
+  "devices",
+  "daily"
+];
+var SECTION_LABELS5 = {
+  overview: "\u2460\u8D26\u6237\u603B\u89C8",
+  search: "\u2461Search \u7F51\u7EDC",
+  campaigns: "\u2462Campaign",
+  keywords: "\u2463\u5173\u952E\u8BCD",
+  searchTerms: "\u2464\u641C\u7D22\u8BCD",
+  geo: "\u2465\u5730\u57DF",
+  devices: "\u2466\u8BBE\u5907",
+  daily: "\u2467\u65E5\u671F/\u5468\u62A5"
+};
+function textLen7(value) {
+  return typeof value === "string" ? value.trim().length : 0;
+}
+function asArray7(value) {
+  return Array.isArray(value) ? value : [];
+}
+function asRecord27(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function pushMissing6(missing, id, chapter, dimension, hint) {
+  missing.push({ id, chapter, dimension, hint });
+}
+function validateYandexPeriodReportContent(data) {
+  const missing = [];
+  const meta = asRecord27(data.meta) ?? {};
+  const narrative = asRecord27(data.narrative) ?? {};
+  const sections = asRecord27(narrative.sections) ?? {};
+  const kpis = asRecord27(data.kpis) ?? {};
+  if (!textLen7(meta.accountId)) {
+    pushMissing6(missing, "meta-account", "\u5143\u4FE1\u606F", "\u8D26\u6237 ID", "meta.accountId \u5FC5\u586B");
+  }
+  const executiveSummary = asArray7(narrative.executiveSummary).filter((p) => textLen7(p) > 0);
+  if (executiveSummary.length < 1) {
+    pushMissing6(
+      missing,
+      "narrative-executive-summary",
+      "\u6267\u884C\u6458\u8981",
+      "narrative.executiveSummary",
+      "\u22651 \u6BB5\u6267\u884C\u6458\u8981\uFF0C\u6982\u8FF0\u672C\u671F\u6D88\u8017/\u70B9\u51FB/\u8F6C\u5316/CTR/CPC \u8D70\u52BF"
+    );
+  }
+  const sectionAnalysisCounts = {};
+  const sectionSuggestionCounts = {};
+  for (const key of SECTION_KEYS4) {
+    const section = asRecord27(sections[key]);
+    const analysis = asArray7(section?.analysis).filter((s) => textLen7(s) > 0);
+    const suggestions = asArray7(section?.suggestions).filter((s) => textLen7(s) > 0);
+    sectionAnalysisCounts[key] = analysis.length;
+    sectionSuggestionCounts[key] = suggestions.length;
+    if (analysis.length < 1) {
+      pushMissing6(
+        missing,
+        `section-${key}-analysis`,
+        SECTION_LABELS5[key],
+        `narrative.sections.${key}.analysis`,
+        `\u22651 \u6761\u603B\u7ED3\uFF08\u5F53\u524D ${analysis.length} \u6761\uFF09\uFF0C\u987B\u5199\u6E05\u73B0\u8C61+\u4F9D\u636E\u6570\u5B57`
+      );
+    }
+    if (suggestions.length < 1) {
+      pushMissing6(
+        missing,
+        `section-${key}-suggestions`,
+        SECTION_LABELS5[key],
+        `narrative.sections.${key}.suggestions`,
+        `\u22651 \u6761\u53EF\u6267\u884C\u5EFA\u8BAE\uFF08\u5F53\u524D ${suggestions.length} \u6761\uFF09`
+      );
+    }
+  }
+  const recommendations = asArray7(narrative.recommendations).filter((r) => {
+    if (typeof r === "string") return textLen7(r) > 0;
+    const rec = asRecord27(r);
+    return textLen7(rec?.content) > 0 || textLen7(rec?.text) > 0;
+  });
+  if (recommendations.length < 3) {
+    pushMissing6(
+      missing,
+      "narrative-recommendations",
+      "\u540E\u7EED\u4F18\u5316\u52A8\u4F5C",
+      "narrative.recommendations",
+      `\u22653 \u6761\u8DE8\u7EF4\u5EA6\u4F18\u5316\u5EFA\u8BAE\uFF08\u5F53\u524D ${recommendations.length} \u6761\uFF1B\u53EF\u7528 {priority,text,anchor}\uFF09`
+    );
+  }
+  const hasKpi = Number.isFinite(Number(kpis.spend)) || Number.isFinite(Number(kpis.clicks)) || Number.isFinite(Number(kpis.impressions));
+  if (!hasKpi) {
+    pushMissing6(
+      missing,
+      "kpis-core",
+      "KPI",
+      "kpis.spend|clicks|impressions",
+      "\u81F3\u5C11\u4E00\u9879\u6709\u6548\u6570\u5B57\uFF08\u8BF7\u4F20 --snapshot-dir \u7531 CLI \u4ECE overview \u5408\u5E76\uFF09"
+    );
+  }
+  return {
+    ok: missing.length === 0,
+    missing,
+    stats: {
+      executiveSummaryCount: executiveSummary.length,
+      recommendationCount: recommendations.length,
+      sectionAnalysisCounts,
+      sectionSuggestionCounts
+    }
+  };
+}
+function formatYandexPeriodReportErrors(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 yandex-period-report.md\uFF09\uFF1A`,
+    ...lines,
+    "",
+    "\u8BF7\u8865\u5168 narrative.sections.<dimension>.{analysis,suggestions} \u4E0E narrative.recommendations \u540E\u91CD\u65B0\u6267\u884C render\u3002",
+    "\u6570\u503C\u7C7B\u5B57\u6BB5\uFF08kpis/tables\uFF09\u987B\u7531 --snapshot-dir \u4ECE\u843D\u76D8 JSON \u5408\u5E76\uFF1BAgent \u53EA\u64B0\u5199\u53D9\u4E8B\uFF0C\u7981\u6B62\u624B\u5199 HTML\u3002"
+  ].join("\n");
+}
+
+// src/commands/yandex-analysis/render-report.ts
+var TEMPLATE_BASENAME5 = "yandex-period-report.html";
+var INJECT_MARKER6 = "window.__YANDEX_PERIOD_REPORT__ = window.__YANDEX_PERIOD_REPORT__ || null;";
+function resolveSkillTemplatePath8(basename11) {
+  const dir = path45.dirname(fileURLToPath11(import.meta.url));
+  const candidates = [
+    path45.join(dir, "skill", "report-templates", basename11),
+    path45.join(dir, "skill", "siluzan-ads", "report-templates", basename11),
+    path45.join(dir, "..", "..", "assets", "siluzan-ads", "report-templates", basename11)
+  ];
+  for (const p of candidates) {
+    if (fs34.existsSync(p)) return p;
+  }
+  return candidates[0];
+}
+function yandexPeriodReportTemplatePath() {
+  return resolveSkillTemplatePath8(TEMPLATE_BASENAME5);
+}
+async function readJsonFile7(filePath) {
+  const text = await fsPromises7.readFile(filePath, "utf8");
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
+  }
+}
+function asRecord28(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
+}
+function injectReportData7(html, payload) {
+  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  if (!html.includes(INJECT_MARKER6)) {
+    throw new Error("\u62A5\u544A\u6A21\u677F\u7F3A\u5C11\u6570\u636E\u6CE8\u5165\u951A\u70B9\uFF0C\u8BF7\u66F4\u65B0 yandex-period-report.html");
+  }
+  return html.replace(INJECT_MARKER6, `window.__YANDEX_PERIOD_REPORT__ = ${json};`);
+}
+async function runYandexAnalysisRender(opts) {
+  const dataPath = path45.resolve(opts.dataFile);
+  let data = asRecord28(await readJsonFile7(dataPath));
+  if (opts.snapshotDir?.trim()) {
+    data = await mergeYandexAnalysisSnapshotIntoReport(data, path45.resolve(opts.snapshotDir));
+  }
+  const contentCheck = validateYandexPeriodReportContent(data);
+  if (!contentCheck.ok) {
+    console.error(`
+\u274C ${formatYandexPeriodReportErrors(contentCheck)}
+`);
+    const { stats: stats2 } = contentCheck;
+    const sectionSummary = Object.entries(stats2.sectionAnalysisCounts).map(([key, count]) => `${key} \u603B\u7ED3${count}/\u5EFA\u8BAE${stats2.sectionSuggestionCounts[key] ?? 0}`).join("\uFF5C");
+    console.error(
+      `   \u7EDF\u8BA1\uFF1A\u6267\u884C\u6458\u8981 ${stats2.executiveSummaryCount} \u6BB5\uFF5C\u4F18\u5316\u5EFA\u8BAE ${stats2.recommendationCount} \u6761\uFF5C${sectionSummary}
+`
+    );
+    process.exit(1);
+  }
+  const templatePath = yandexPeriodReportTemplatePath();
+  let html;
+  try {
+    html = await fsPromises7.readFile(templatePath, "utf8");
+  } catch {
+    console.error(`
+\u274C \u672A\u627E\u5230\u62A5\u544A\u6A21\u677F\uFF1A${templatePath}
+\u8BF7\u5148\u6267\u884C npm run build
+`);
+    process.exit(1);
+  }
+  const outPath = path45.resolve(
+    opts.out ?? path45.join(path45.dirname(dataPath), "yandex-period-report.html")
+  );
+  const outDir = path45.dirname(outPath);
+  await fsPromises7.mkdir(outDir, { recursive: true });
+  await fsPromises7.writeFile(outPath, injectReportData7(html, data), "utf8");
+  const { stats } = contentCheck;
+  console.log(`
+\u2705 Yandex \u5E7F\u544A\u8D26\u6237\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+`);
+  console.log(
+    `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u6267\u884C\u6458\u8981 ${stats.executiveSummaryCount} \u6BB5\uFF5C\u4F18\u5316\u5EFA\u8BAE ${stats.recommendationCount} \u6761\uFF5C8 \u4E2A\u5206\u6790\u7AE0\u8282\u5747\u5DF2\u9F50\u5168
+`
+  );
+  console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u5B8C\u6574\u7AE0\u8282\uFF08\u6837\u5F0F\u5BF9\u9F50\u5F00\u53D1\u6837\u4F8B\uFF09\u3002\n");
+}
+
+// src/commands/yandex-analysis/register-cli.ts
+function registerBatchCommand4(sectionHelp, aliasHelp) {
+  return new Command5("run").description(
+    "\u6279\u91CF\u62C9\u53D6 YandexAPI /yandex-analysis \u5404\u7EF4\u5EA6\uFF08\u7701\u7565\u5B50\u547D\u4EE4\u540D\u65F6\u9ED8\u8BA4\u6267\u884C\u672C\u547D\u4EE4\uFF09"
+  ).requiredOption(
+    "-a, --account <id>",
+    "Yandex Client-Login / mediaCustomerId\uFF08\u5982 porg-xxx\uFF0C\u4E0E list-accounts -m Yandex \u4E00\u81F4\uFF09"
+  ).requiredOption(
+    "--json-out <dir>",
+    "\u7ED3\u679C\u843D\u76D8\u76EE\u5F55\uFF1B\u6BCF\u7EF4\u5EA6 `<section>-<accountId>.json` + `report-manifest-<accountId>.json`"
+  ).option("-t, --token <token>", "Auth Token").option(
+    "--start <date>",
+    "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF1B\u4E0D\u80FD\u665A\u4E8E\u4ECA\u5929\uFF1B\u9ED8\u8BA4\u8FD1 7 \u5929\u542B\u4ECA\u5929\uFF09"
+  ).option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option(
+    "--sections <list>",
+    `\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,campaigns,keywords\uFF1B\u7701\u7565=\u5168\u90E8 8 \u4E2A\u3002\u53EF\u9009\uFF1A${sectionHelp}\uFF1B\u522B\u540D\uFF1A${aliasHelp}`
+  ).option("--exclude <list>", "\u6392\u9664\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u4E0E --sections \u53EF\u53E0\u52A0").option(
+    "--limit <n>",
+    "\u4EC5 campaigns / keywords / search-terms / geo\uFF1A\u6761\u6570\u4E0A\u9650\uFF08\u9ED8\u8BA4 100\uFF0C\u6700\u5927 10000\uFF09",
+    (v) => parseInt(v, 10)
+  ).option("--concurrency <n>", "\u5E76\u53D1\u6570\uFF0C\u9ED8\u8BA4 5\uFF0C\u4E0A\u9650 16", (v) => parseInt(v, 10)).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
+    await runAllYandexSections(opts);
+  });
+}
+function registerYandexAnalysisCommands(program2) {
+  const sectionHelp = YANDEX_SECTION_NAMES.join(", ");
+  const aliasHelp = Object.keys(YANDEX_SECTION_ALIASES).join(", ");
+  const root = program2.command("yandex-analysis").description(
+    "Yandex \u8D26\u6237\u5206\u6790\uFF1A\u6279\u91CF\u62C9\u53D6 /yandex-analysis \u53EA\u8BFB\u6570\u636E\uFF08\u9ED8\u8BA4 run\uFF09\uFF0C\u6216\u7531 render \u751F\u6210 yandex-period-report.html \u7EC8\u7A3F\uFF08\u91D1\u989D\u5DF2\u4E3A\u8D26\u6237\u5E01\u79CD\u5C0F\u6570\uFF1Bsearch-terms \u4EC5\u8FD1 180 \u5929\uFF09"
+  );
+  root.addCommand(registerBatchCommand4(sectionHelp, aliasHelp), { isDefault: true });
+  root.command("render").description(
+    "\u6839\u636E Agent \u64B0\u5199\u7684\u62A5\u544A JSON \u751F\u6210 Yandex \u5E7F\u544A\u8D26\u6237\u5206\u6790 HTML \u7EC8\u7A3F\uFF08\u6821\u9A8C 8 \u4E2A\u5206\u6790\u7AE0\u8282\u5FC5\u542B\u5B57\u6BB5\uFF0C\u7F3A\u9879\u62D2\u7EDD\u6E32\u67D3\uFF09"
+  ).requiredOption("--data <file>", "Agent \u4EA7\u51FA\u7684 yandex-period-report.json").option(
+    "--snapshot-dir <dir>",
+    "\u53EF\u9009\uFF1Ayandex-analysis --json-out \u76EE\u5F55\uFF0C\u81EA\u52A8\u8865\u5168 meta / kpis / tables"
+  ).option("--out <file>", "\u8F93\u51FA HTML \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\uFF09").action(async (opts) => {
+    await runYandexAnalysisRender({
+      dataFile: opts.data,
+      snapshotDir: opts.snapshotDir,
+      out: opts.out
+    });
+  });
+}
+
 // src/index.ts
 init_version();
 init_cli_json_snapshot();
@@ -134035,9 +134917,9 @@ function interceptAgentCompatArgv(argv) {
 installProcessHandlers();
 function getVersion() {
   try {
-    const __dirname3 = path43.dirname(fileURLToPath11(import.meta.url));
-    const pkgPath = path43.join(__dirname3, "..", "package.json");
-    const pkg = JSON.parse(fs33.readFileSync(pkgPath, "utf8"));
+    const __dirname3 = path46.dirname(fileURLToPath12(import.meta.url));
+    const pkgPath = path46.join(__dirname3, "..", "package.json");
+    const pkg = JSON.parse(fs35.readFileSync(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -134056,9 +134938,9 @@ configureCliJsonSnapshot({
   ]
 });
 configureSiluzanClientIdentity({ client: "tso-cli", resolveVersion: getVersion });
-var program = new Command5();
+var program = new Command6();
 program.name("siluzan-tso").description(
-  "Siluzan \u5E7F\u544A\u8D26\u6237\u7BA1\u7406\uFF1A\u8D26\u6237\u67E5\u8BE2\u3001\u4F59\u989D\u3001\u6295\u653E\u6570\u636E\u3001\u5F00\u6237\u7533\u8BF7\uFF08Google/TikTok/Yandex/Bing/Kwai\uFF09\u3001\n\u8D26\u53F7\u5206\u4EAB/\u89E3\u7ED1\u3001\u4F18\u5316\u62A5\u544A\u3001Google \u8D26\u6237\u5206\u6790\u7F51\u5173\uFF08google-analysis\uFF09\u3001Google \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF08google-ads-diagnosis render\uFF09\u3001\u7F51\u7AD9\u8BCA\u65AD\uFF08website-diagnosis\uFF09\u3001\u6218\u7565\u5E02\u573A\u5206\u6790\uFF08market-analysis\uFF0CAgent \u751F\u6210\u62A5\u544A\uFF09\u3001\u5145\u503C\u8F6C\u8D26\u3001\u5F00\u7968\u3001\u667A\u80FD\u9884\u8B66\u3001Google \u5E7F\u544A\u7BA1\u7406\uFF08\u542B\u5F02\u6B65\u6279\u91CF\uFF09\u3002"
+  "Siluzan \u5E7F\u544A\u8D26\u6237\u7BA1\u7406\uFF1A\u8D26\u6237\u67E5\u8BE2\u3001\u4F59\u989D\u3001\u6295\u653E\u6570\u636E\u3001\u5F00\u6237\u7533\u8BF7\uFF08Google/TikTok/Yandex/Bing/Kwai\uFF09\u3001\n\u8D26\u53F7\u5206\u4EAB/\u89E3\u7ED1\u3001\u4F18\u5316\u62A5\u544A\u3001Google/Meta/TikTok/Bing/Yandex \u8D26\u6237\u5206\u6790\u3001Google \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF08google-ads-diagnosis render\uFF09\u3001\u7F51\u7AD9\u8BCA\u65AD\uFF08website-diagnosis\uFF09\u3001\u6218\u7565\u5E02\u573A\u5206\u6790\uFF08market-analysis\uFF0CAgent \u751F\u6210\u62A5\u544A\uFF09\u3001\u5145\u503C\u8F6C\u8D26\u3001\u5F00\u7968\u3001\u667A\u80FD\u9884\u8B66\u3001Google \u5E7F\u544A\u7BA1\u7406\uFF08\u542B\u5F02\u6B65\u6279\u91CF\uFF09\u3002"
 ).version(getVersion());
 program.option("--commit <text>", "\u5199\u64CD\u4F5C\u8BF4\u660E\uFF1B\u8BB0\u5165\u672C\u673A\u5199\u5BA1\u8BA1 JSONL");
 program.hook("preAction", async () => {
@@ -134093,6 +134975,7 @@ var REGISTRARS = [
   registerFacebookAnalysisCommands,
   registerBingAnalysisCommands,
   registerTikTokAnalysisCommands,
+  registerYandexAnalysisCommands,
   register15,
   register16,
   register17,