siluzan-tso-cli 1.1.48-beta.8 → 1.1.48-beta.9

package/README.md

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

package/dist/index.js

@@ -103520,8 +103520,8 @@ var init_batch_runner = __esm({
       shouldDowngrade(now = Date.now()) {
         if (this.window.length < this.opts.windowSize) return false;
         if (now - this.lastDowngradeAt < this.opts.cooldownMs) return false;
-        const fail3 = this.window.filter((s) => !s).length;
-        const rate = fail3 / this.window.length;
+        const fail4 = this.window.filter((s) => !s).length;
+        const rate = fail4 / this.window.length;
         if (rate >= this.opts.errorRateThreshold) {
           this.lastDowngradeAt = now;
           this.window.length = 0;
@@ -123849,9 +123849,9 @@ function xfXml(x) {
 function stylesXml(reg) {
   return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"><fonts count="${reg.fonts.length}">${reg.fonts.map(fontXml).join("")}</fonts><fills count="${reg.fills.length}">${reg.fills.map(fillXml).join("")}</fills><borders count="${reg.borders.length}">${reg.borders.map(borderXml).join("")}</borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="${reg.xfs.length}">${reg.xfs.map(xfXml).join("")}</cellXfs><cellStyles count="1"><cellStyle name="\u5E38\u89C4" xfId="0" builtinId="0"/></cellStyles></styleSheet>`;
 }
-function cellXml(ref, cell2) {
-  if (cell2 == null) return "";
-  const { value, styleId } = cell2;
+function cellXml(ref, cell3) {
+  if (cell3 == null) return "";
+  const { value, styleId } = cell3;
   const sAttr = styleId ? ` s="${styleId}"` : "";
   if (value == null || value === "") {
     return styleId ? `<c r="${ref}"${sAttr}/>` : "";
@@ -123866,7 +123866,7 @@ function sheetXml(sheet) {
   const rowsXml = sheet.rows.map((row, i) => {
     const r = i + 1;
     const htAttr = row.height ? ` ht="${row.height}" customHeight="1"` : "";
-    const cells = row.cells.map((cell2, cIdx) => cellXml(`${colLetter(cIdx)}${r}`, cell2)).join("");
+    const cells = row.cells.map((cell3, cIdx) => cellXml(`${colLetter(cIdx)}${r}`, cell3)).join("");
     return `<row r="${r}"${htAttr}>${cells}</row>`;
   }).join("");
   const mergesXml = sheet.merges.length ? `<mergeCells count="${sheet.merges.length}">${sheet.merges.map((m) => `<mergeCell ref="${m}"/>`).join("")}</mergeCells>` : "";
@@ -133577,10 +133577,10 @@ function estimateColWidths(rows) {
   const colCount = rows.reduce((max, row) => Math.max(max, row.length), 0);
   const widths = new Array(colCount).fill(MIN_COL_WIDTH);
   for (const row of rows) {
-    row.forEach((cell2, idx) => {
-      if (cell2 == null) return;
+    row.forEach((cell3, idx) => {
+      if (cell3 == null) return;
       const longestLine = Math.max(
-        ...String(cell2).split("\n").map((l) => l.length)
+        ...String(cell3).split("\n").map((l) => l.length)
       );
       const width = Math.min(MAX_COL_WIDTH, Math.max(MIN_COL_WIDTH, Math.ceil(longestLine * 1.3)));
       if (width > widths[idx]) widths[idx] = width;
@@ -139411,7 +139411,472 @@ async function runYandexAnalysisRender(opts) {
   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/entities.ts
+init_auth();
+init_cli_json_snapshot();
+init_cli_table();
+
+// src/commands/yandex-analysis/yandex-api.ts
+init_auth();
+var YANDEX_AD_STATUSES = [
+  "DRAFT",
+  "MODERATION",
+  "PREACCEPTED",
+  "ACCEPTED",
+  "REJECTED",
+  "UNKNOWN"
+];
+var YANDEX_INSIGHTS_LEVELS = [
+  "daily",
+  "geo",
+  "devices",
+  "keywords",
+  "campaigns",
+  "adgroups",
+  "ads"
+];
+var YANDEX_PATH_CAPS = {
+  overview: {},
+  daily: {},
+  campaigns: { limit: true, timeIncrement: true, network: true },
+  adgroups: { limit: true, timeIncrement: true, campaignId: true },
+  ads: { limit: true, timeIncrement: true, status: true, campaignId: true, adGroupId: true },
+  keywords: { limit: true },
+  geo: { limit: true, network: true },
+  devices: { network: true }
+};
+function localYmd(d = /* @__PURE__ */ new Date()) {
+  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 parseYandexTimeIncrement(raw) {
+  if (raw == null || String(raw).trim() === "") return void 0;
+  const t = String(raw).trim();
+  if (t !== "1") {
+    throw new Error("--time-increment \u53EA\u5141\u8BB8 1\uFF08\u6309\u65E5\uFF09\uFF1B\u4E0D\u4F20=\u533A\u95F4\u6C47\u603B\u3002Direct \u6CA1\u6709\u5C0F\u65F6\u7EF4\u5EA6\u3002");
+  }
+  return 1;
+}
+function parseYandexNetwork(raw) {
+  if (raw == null || String(raw).trim() === "") return void 0;
+  const t = String(raw).trim().toUpperCase();
+  if (t !== "SEARCH" && t !== "ALL") {
+    throw new Error(
+      "--network \u53EA\u5141\u8BB8 SEARCH \u6216 ALL\uFF08\u9ED8\u8BA4 SEARCH\uFF1BALL=\u5168\u7F51\u4E00\u884C\u5408\u8BA1\uFF0C\u884C\u5185 network \u4E3A null\uFF09\u3002"
+    );
+  }
+  return t;
+}
+function parseYandexAdStatus(raw) {
+  if (raw == null || String(raw).trim() === "") return void 0;
+  const parts = String(raw).split(",").map((x) => x.trim().toUpperCase()).filter(Boolean);
+  if (parts.length === 0) return void 0;
+  const unknown = parts.filter((p) => !YANDEX_AD_STATUSES.includes(p));
+  if (unknown.length > 0) {
+    throw new Error(
+      `--status \u975E\u6CD5\u503C\uFF1A${unknown.join(", ")}\u3002\u5408\u6CD5\uFF1A${YANDEX_AD_STATUSES.join(", ")}\u3002`
+    );
+  }
+  return [...new Set(parts)].join(",");
+}
+function parseYandexInsightsLevel(raw) {
+  const t = raw.trim();
+  if (!YANDEX_INSIGHTS_LEVELS.includes(t)) {
+    throw new Error(
+      `--level \u53EA\u5141\u8BB8 ${YANDEX_INSIGHTS_LEVELS.join(" / ")}\uFF08daily/geo/devices/keywords \u6216\u4E0E\u5B9E\u4F53\u5B50\u547D\u4EE4\u540C\u53E3\u5F84\u7684 campaigns/adgroups/ads\uFF09\u3002`
+    );
+  }
+  return t;
+}
+function optionalId(raw) {
+  const t = raw?.trim();
+  return t ? t : void 0;
+}
+function insightsLevelToPath(level) {
+  return level;
+}
+function assertYandexAnalysisQuery(path49, query) {
+  const caps = YANDEX_PATH_CAPS[path49];
+  if (query.timeIncrement != null && !caps.timeIncrement) {
+    throw new Error(`--time-increment \u4E0D\u80FD\u7528\u4E8E /${path49}\uFF08\u4EC5 campaigns / adgroups / ads\uFF09\u3002`);
+  }
+  if (query.network != null && !caps.network) {
+    throw new Error(`--network \u4E0D\u80FD\u7528\u4E8E /${path49}\uFF08\u4EC5 campaigns / geo / devices\uFF09\u3002`);
+  }
+  if (query.status != null && !caps.status) {
+    throw new Error(`--status \u4EC5\u7528\u4E8E /ads\uFF08\u62D2\u5BA1/\u5BA1\u6838\u6001\u8D70\u7ED3\u6784\u67E5\u8BE2\uFF0C\u884C\u5185 spend \u4E3A 0\uFF09\u3002`);
+  }
+  if (query.campaignId != null && !caps.campaignId) {
+    throw new Error(`--campaign-id \u4EC5\u7528\u4E8E /adgroups \u4E0E /ads\u3002`);
+  }
+  if (query.adGroupId != null && !caps.adGroupId) {
+    throw new Error(`--adgroup-id \u4EC5\u7528\u4E8E /ads\u3002`);
+  }
+  if (query.status != null && query.timeIncrement != null) {
+    throw new Error(
+      "--status \u4E0E --time-increment \u4E0D\u80FD\u540C\u65F6\u4F20\uFF08\u7F51\u5173 400\uFF09\u3002\u62D2\u5BA1\u7528\u533A\u95F4\u6C47\u603B\uFF0C\u4E0D\u8981\u52A0\u6309\u65E5\u3002"
+    );
+  }
+  if (query.limit != null && !caps.limit) {
+    throw new Error(`--limit \u4E0D\u80FD\u7528\u4E8E /${path49}\uFF08overview / daily / devices \u65E0\u6B64\u53C2\u6570\uFF09\u3002`);
+  }
+}
+function buildYandexAnalysisSearchParams(path49, query) {
+  assertYandexAnalysisQuery(path49, query);
+  const caps = YANDEX_PATH_CAPS[path49];
+  const params = new URLSearchParams({
+    account: query.account,
+    start: query.start,
+    end: query.end
+  });
+  if (caps.limit && query.limit != null) {
+    params.set("limit", String(resolveYandexLimit(query.limit)));
+  }
+  if (caps.timeIncrement && query.timeIncrement === 1) {
+    params.set("timeIncrement", "1");
+  }
+  if (caps.network && query.network) {
+    params.set("network", query.network);
+  }
+  if (caps.status && query.status) {
+    params.set("status", query.status);
+  }
+  if (caps.campaignId && query.campaignId) {
+    params.set("campaignId", query.campaignId);
+  }
+  if (caps.adGroupId && query.adGroupId) {
+    params.set("adGroupId", query.adGroupId);
+  }
+  return params;
+}
+async function fetchYandexAnalysisPath(config, path49, query, verbose) {
+  const yandexApiUrl = requireYandexApi(config);
+  const params = buildYandexAnalysisSearchParams(path49, query);
+  const url = analysisUrl(yandexApiUrl, path49, params.toString());
+  return apiFetch2(url, config, {}, verbose);
+}
+function unwrapYandexItems(raw) {
+  if (raw && typeof raw === "object" && Array.isArray(raw.items)) {
+    return raw.items;
+  }
+  return [];
+}
+function asRecord31(raw) {
+  return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+}
+
+// src/commands/yandex-analysis/entities.ts
+function fail3(label, err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  console.error(`
+\u274C ${label}\uFF1A${msg}
+`);
+  process.exit(1);
+}
+function cell2(value) {
+  if (value == null || value === "") return "";
+  if (Array.isArray(value)) return value.map((x) => String(x)).join(" | ");
+  return String(value);
+}
+function resolveRange(start, end) {
+  if (!start && !end) {
+    const today = localYmd();
+    return resolveYandexDateRange(today, today);
+  }
+  return resolveYandexDateRange(start, end);
+}
+function parseCommonFlags(opts) {
+  return {
+    timeIncrement: parseYandexTimeIncrement(opts.timeIncrement),
+    network: parseYandexNetwork(opts.network),
+    status: parseYandexAdStatus(opts.status),
+    campaignId: optionalId(opts.campaignId),
+    adGroupId: optionalId(opts.adGroupId)
+  };
+}
+async function emitOrTable(opts, args) {
+  if (await emitCliJsonOrSnapshot(opts, {
+    section: args.section,
+    commandLabel: args.commandLabel,
+    commandHint: args.accountId,
+    payload: args.payload,
+    idSuffix: args.accountId
+  })) {
+    return;
+  }
+  console.log(`
+${args.title}
+`);
+  if (args.rows.length === 0) {
+    console.log(`  ${args.empty}
+`);
+    return;
+  }
+  printCliTable(args.rows, args.columns);
+  console.log(`  ${args.footnote}
+`);
+}
+async function fetchPath(opts, path49, extra) {
+  const accountId = assertYandexAccountId(opts.account);
+  const { startDate, endDate } = resolveRange(opts.start, opts.end);
+  const config = loadConfig(opts.token);
+  const raw = await fetchYandexAnalysisPath(
+    config,
+    path49,
+    {
+      account: accountId,
+      start: startDate,
+      end: endDate,
+      ...extra
+    },
+    !!opts.verbose
+  );
+  return { accountId, startDate, endDate, raw };
+}
+async function runYandexAccountStatus(opts) {
+  let result;
+  try {
+    result = await fetchPath(opts, "overview", {});
+  } catch (err) {
+    fail3("\u67E5\u8BE2 Yandex \u8D26\u6237\u603B\u89C8\u5931\u8D25", err);
+  }
+  const row = asRecord31(result.raw);
+  await emitOrTable(opts, {
+    section: "yandex-account-status",
+    commandLabel: "yandex-analysis account-status",
+    accountId: result.accountId,
+    payload: result.raw,
+    title: `Yandex \u8D26\u6237\u603B\u89C8\uFF08${result.accountId}\uFF0C${result.startDate}~${result.endDate}\uFF09`,
+    empty: "\u65E0\u603B\u89C8\u6570\u636E\u3002",
+    footnote: "archived=true \u8868\u793A\u5E7F\u544A\u4E3B\u5DF2\u5F52\u6863\uFF08inactive\uFF09\u3002\u5B98\u65B9\u65E0\u5C01\u6237\u72B6\u6001\u4E0E\u539F\u56E0\u3002\u4F59\u989D\u770B balance / currency\uFF1B\u5B98\u65B9\u65E0\u72EC\u7ACB\u989D\u5EA6\u3002",
+    rows: [
+      {
+        account: cell2(row.account ?? result.accountId),
+        archived: cell2(row.archived),
+        balance: cell2(row.balance),
+        currency: cell2(row.currency),
+        spend: cell2(row.spend),
+        conversions: cell2(row.conversions)
+      }
+    ],
+    columns: [
+      { key: "account", header: "\u8D26\u6237" },
+      { key: "archived", header: "archived" },
+      { key: "balance", header: "\u4F59\u989D" },
+      { key: "currency", header: "\u5E01\u79CD" },
+      { key: "spend", header: "\u533A\u95F4\u82B1\u8D39" },
+      { key: "conversions", header: "\u8F6C\u5316" }
+    ]
+  });
+}
+async function runYandexCampaignEntities(opts) {
+  let flags;
+  let result;
+  try {
+    flags = parseCommonFlags(opts);
+    result = await fetchPath(opts, "campaigns", {
+      limit: opts.limit,
+      timeIncrement: flags.timeIncrement,
+      network: flags.network
+    });
+  } catch (err) {
+    fail3("\u67E5\u8BE2 Yandex \u7CFB\u5217\u5931\u8D25", err);
+  }
+  const items2 = unwrapYandexItems(result.raw);
+  await emitOrTable(opts, {
+    section: "yandex-campaign-entities",
+    commandLabel: "yandex-analysis campaign-entities",
+    accountId: result.accountId,
+    payload: result.raw,
+    title: `Yandex \u5E7F\u544A\u7CFB\u5217\uFF08${result.accountId}\uFF0C${result.startDate}~${result.endDate}\uFF0C\u5171 ${items2.length} \u884C\uFF09`,
+    empty: "\u5F53\u524D\u8FC7\u6EE4\u4E0B\u65E0\u7CFB\u5217\u884C\uFF08\u9ED8\u8BA4\u53EA\u51FA\u73B0\u6709\u6D88\u8017\u7684\u5BF9\u8C61\uFF09\u3002",
+    footnote: "\u9ED8\u8BA4 SEARCH\u3002\u5168\u6E20\u9053\u82B1\u8D39\u987B --network ALL\uFF08\u884C\u5185 network \u4E3A null\uFF09\u3002budget \u662F\u7CFB\u5217\u65E5\u9884\u7B97\uFF0C\u81EA\u52A8\u7B56\u7565\u5E38\u4E3A\u7A7A\uFF1B\u5BF9\u7167 weeklyBudget\u3002\u81EA\u52A8\u51FA\u4EF7\u4E0D\u8981\u5F53\u624B\u52A8 CPC \u6539\u4EF7\u3002",
+    rows: items2.map((r) => ({
+      campaignId: cell2(r.campaignId),
+      name: cell2(r.campaignName),
+      spend: cell2(r.spend),
+      budget: cell2(r.budget),
+      weeklyBudget: cell2(r.weeklyBudget),
+      strategy: cell2(r.strategy),
+      targetCpa: cell2(r.targetCpa),
+      status: cell2(r.status),
+      date: cell2(r.date)
+    })),
+    columns: [
+      { key: "campaignId", header: "\u7CFB\u5217ID" },
+      { key: "name", header: "\u540D\u79F0" },
+      { key: "spend", header: "spend" },
+      { key: "budget", header: "\u65E5\u9884\u7B97" },
+      { key: "weeklyBudget", header: "\u5468\u9884\u7B97" },
+      { key: "strategy", header: "\u7B56\u7565" },
+      { key: "targetCpa", header: "\u76EE\u6807CPA" },
+      { key: "status", header: "\u72B6\u6001" },
+      { key: "date", header: "date" }
+    ]
+  });
+}
+async function runYandexAdGroupEntities(opts) {
+  let flags;
+  let result;
+  try {
+    flags = parseCommonFlags(opts);
+    result = await fetchPath(opts, "adgroups", {
+      limit: opts.limit,
+      timeIncrement: flags.timeIncrement,
+      campaignId: flags.campaignId
+    });
+  } catch (err) {
+    fail3("\u67E5\u8BE2 Yandex \u5E7F\u544A\u7EC4\u5931\u8D25", err);
+  }
+  const items2 = unwrapYandexItems(result.raw);
+  await emitOrTable(opts, {
+    section: "yandex-adgroup-entities",
+    commandLabel: "yandex-analysis adgroup-entities",
+    accountId: result.accountId,
+    payload: result.raw,
+    title: `Yandex \u5E7F\u544A\u7EC4\uFF08${result.accountId}\uFF0C${result.startDate}~${result.endDate}\uFF0C\u5171 ${items2.length} \u884C\uFF09`,
+    empty: "\u5F53\u524D\u8FC7\u6EE4\u4E0B\u65E0\u5E7F\u544A\u7EC4\u884C\uFF08\u9ED8\u8BA4\u53EA\u51FA\u73B0\u6709\u6D88\u8017\u7684\u5BF9\u8C61\uFF09\u3002",
+    footnote: "campaignTargetCpa \u662F\u7CFB\u5217\u76EE\u6807\uFF08\u53EA\u53D6 Search\uFF09\uFF0C\u4E0D\u662F\u7EC4\u7EA7\u76EE\u6807\u4EF7\u3002conversions<=0 \u65F6\u4E0D\u8981\u5224 CPA\u3002\u672C\u6279\u6CA1\u6709\u6539\u4EF7\u63A5\u53E3\u3002",
+    rows: items2.map((r) => ({
+      adGroupId: cell2(r.adGroupId),
+      name: cell2(r.adGroupName),
+      campaignId: cell2(r.campaignId),
+      spend: cell2(r.spend),
+      conversions: cell2(r.conversions),
+      cpa: cell2(r.costPerConversion),
+      targetCpa: cell2(r.campaignTargetCpa),
+      weeklyBudget: cell2(r.campaignWeeklyBudget),
+      strategy: cell2(r.campaignStrategy),
+      date: cell2(r.date)
+    })),
+    columns: [
+      { key: "adGroupId", header: "\u7EC4ID" },
+      { key: "name", header: "\u540D\u79F0" },
+      { key: "campaignId", header: "\u7CFB\u5217ID" },
+      { key: "spend", header: "spend" },
+      { key: "conversions", header: "\u8F6C\u5316" },
+      { key: "cpa", header: "\u5B9E\u9645CPA" },
+      { key: "targetCpa", header: "\u7CFB\u5217\u76EE\u6807CPA" },
+      { key: "weeklyBudget", header: "\u7CFB\u5217\u5468\u9884\u7B97" },
+      { key: "strategy", header: "\u7B56\u7565" },
+      { key: "date", header: "date" }
+    ]
+  });
+}
+async function runYandexAdEntities(opts) {
+  let flags;
+  let result;
+  try {
+    flags = parseCommonFlags(opts);
+    result = await fetchPath(opts, "ads", {
+      limit: opts.limit,
+      timeIncrement: flags.timeIncrement,
+      status: flags.status,
+      campaignId: flags.campaignId,
+      adGroupId: flags.adGroupId
+    });
+  } catch (err) {
+    fail3("\u67E5\u8BE2 Yandex \u5E7F\u544A\u5931\u8D25", err);
+  }
+  const items2 = unwrapYandexItems(result.raw);
+  const filtered = flags.status != null;
+  await emitOrTable(opts, {
+    section: "yandex-ad-entities",
+    commandLabel: "yandex-analysis ad-entities",
+    accountId: result.accountId,
+    payload: result.raw,
+    title: `Yandex \u5E7F\u544A\uFF08${result.accountId}\uFF0C${result.startDate}~${result.endDate}\uFF0C\u5171 ${items2.length} \u884C\uFF09`,
+    empty: filtered ? "\u5F53\u524D\u5BA1\u6838\u8FC7\u6EE4\u4E0B\u65E0\u8BB0\u5F55\uFF08\u7A7A\u5217\u8868=\u6210\u529F\u4E14\u6CA1\u6709\u672A\u5F52\u6863\u5339\u914D\u9879\uFF09\u3002" : "\u5F53\u524D\u8FC7\u6EE4\u4E0B\u65E0\u5E7F\u544A\u884C\uFF08\u9ED8\u8BA4\u53EA\u51FA\u73B0\u533A\u95F4\u5185\u6709\u6D88\u8017\u7684\u5E7F\u544A\uFF09\u3002",
+    footnote: "landingUrls \u7A7A\u6570\u7EC4\u4E0D\u662F\u6B7B\u94FE\uFF08Dynamic/Smart/Shopping \u6216\u4EC5 TurboPage \u5E38\u4E3A []\uFF09\u3002CLI \u4E0D\u63A2\u6D3B HTTP\u3002\u62D2\u5BA1\u7528 --status REJECTED\uFF08\u4E0E --time-increment \u4E92\u65A5\uFF1B\u5DF2\u5F52\u6863\u4E0D\u4F1A\u51FA\u73B0\uFF09\u3002",
+    rows: items2.map((r) => ({
+      adId: cell2(r.adId),
+      campaignId: cell2(r.campaignId),
+      adGroupId: cell2(r.adGroupId),
+      spend: cell2(r.spend),
+      conversions: cell2(r.conversions),
+      ctr: cell2(r.ctr),
+      roi: cell2(r.roi),
+      status: cell2(r.status),
+      landing: cell2(r.landingUrls)
+    })),
+    columns: [
+      { key: "adId", header: "\u5E7F\u544AID" },
+      { key: "campaignId", header: "\u7CFB\u5217ID" },
+      { key: "adGroupId", header: "\u7EC4ID" },
+      { key: "spend", header: "spend" },
+      { key: "conversions", header: "\u8F6C\u5316" },
+      { key: "ctr", header: "ctr" },
+      { key: "roi", header: "roi" },
+      { key: "status", header: "\u5BA1\u6838\u6001" },
+      { key: "landing", header: "\u843D\u5730\u9875" }
+    ]
+  });
+}
+async function runYandexInsights(opts) {
+  let level;
+  let flags;
+  let result;
+  try {
+    level = parseYandexInsightsLevel(opts.level);
+    flags = parseCommonFlags(opts);
+    result = await fetchPath(opts, insightsLevelToPath(level), {
+      limit: opts.limit,
+      timeIncrement: flags.timeIncrement,
+      network: flags.network,
+      status: flags.status,
+      campaignId: flags.campaignId,
+      adGroupId: flags.adGroupId
+    });
+  } catch (err) {
+    fail3("\u67E5\u8BE2 Yandex insights \u5931\u8D25", err);
+  }
+  const items2 = unwrapYandexItems(result.raw);
+  await emitOrTable(opts, {
+    section: "yandex-insights",
+    commandLabel: "yandex-analysis insights",
+    accountId: result.accountId,
+    payload: result.raw,
+    title: `Yandex insights ${level}\uFF08${result.accountId}\uFF0C${result.startDate}~${result.endDate}\uFF0C\u5171 ${items2.length} \u884C\uFF09`,
+    empty: "\u65E0\u62A5\u8868\u884C\uFF08\u9ED8\u8BA4\u53EA\u51FA\u73B0\u533A\u95F4\u5185\u6709\u6D88\u8017\u7684\u5BF9\u8C61\uFF09\u3002",
+    footnote: "revenue \u662F\u6210\u4EA4\u989D PurchaseRevenue\uFF0C\u4E0D\u662F\u76EE\u6807\u8D4B\u503C\u3002roi=(\u6210\u4EA4\u989D\u2212\u82B1\u8D39)/\u82B1\u8D39\u3002geo/devices \u9ED8\u8BA4 SEARCH\uFF0C\u5168\u7F51\u987B --network ALL\u3002\u65E0\u5C0F\u65F6\u7EF4\u5EA6\u3002",
+    rows: items2.map((r) => ({
+      id: cell2(
+        r.adId ?? r.adGroupId ?? r.campaignId ?? r.keywordId ?? r.regionName ?? r.device ?? r.date
+      ),
+      name: cell2(
+        r.adName ?? r.adGroupName ?? r.campaignName ?? r.keyword ?? r.regionName ?? r.device
+      ),
+      spend: cell2(r.spend),
+      conversions: cell2(r.conversions),
+      ctr: cell2(r.ctr),
+      roi: cell2(r.roi),
+      date: cell2(r.date)
+    })),
+    columns: [
+      { key: "id", header: "\u5BF9\u8C61" },
+      { key: "name", header: "\u540D\u79F0" },
+      { key: "spend", header: "spend" },
+      { key: "conversions", header: "\u8F6C\u5316" },
+      { key: "ctr", header: "ctr" },
+      { key: "roi", header: "roi" },
+      { key: "date", header: "date" }
+    ]
+  });
+}
+
 // src/commands/yandex-analysis/register-cli.ts
+var ACCOUNT_OPTION4 = [
+  "-a, --account <id>",
+  "Yandex Client-Login / mediaCustomerId\uFF08\u5982 porg-xxx\uFF0C\u4E0E list-accounts -m Yandex \u4E00\u81F4\uFF09"
+];
+var JSON_OUT_OPTION_DESC4 = "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON";
+var START_OPTION = [
+  "--start <date>",
+  "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF1B\u7701\u7565=\u5F53\u5929\uFF09"
+];
+var END_OPTION = ["--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD"];
 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>",
@@ -139437,7 +139902,7 @@ 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"
+    "Yandex \u8D26\u6237\u5206\u6790\uFF1A\u6279\u91CF\u62C9\u53D6 /yandex-analysis \u5468\u671F\u62A5\u8868\uFF08\u9ED8\u8BA4 run\uFF09\u3001render HTML\uFF0C\u6216\u67E5\u8BE2\u8D26\u6237\u5F52\u6863/\u7CFB\u5217/\u7EC4/\u5E7F\u544A/insights\uFF08\u53EA\u8BFB\u8FD0\u8425\uFF1B\u672C\u6279\u4E0D\u80FD\u6682\u505C/\u6539\u4EF7/\u6539\u9884\u7B97\uFF09"
   );
   root.addCommand(registerBatchCommand4(sectionHelp, aliasHelp), { isDefault: true });
   root.command("render").description(
@@ -139452,6 +139917,44 @@ function registerYandexAnalysisCommands(program2) {
       out: opts.out
     });
   });
+  root.command("account-status").description(
+    "\u8D26\u6237\u5F52\u6863/\u4F59\u989D/\u533A\u95F4 KPI\uFF08GET /overview\uFF1Barchived=true \u4E3A\u5DF2\u5F52\u6863\uFF1B\u5B98\u65B9\u65E0\u5C01\u6237\u539F\u56E0\uFF1B\u7701\u7565\u65E5\u671F=\u5F53\u5929\uFF09"
+  ).requiredOption(...ACCOUNT_OPTION4).option(...START_OPTION).option(...END_OPTION).option("-t, --token <token>", "Auth Token").option("--json-out <path>", JSON_OUT_OPTION_DESC4).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runYandexAccountStatus(opts);
+    }
+  );
+  root.command("campaign-entities").description(
+    "\u7CFB\u5217\u7EE9\u6548+\u9884\u7B97/\u7B56\u7565\uFF08GET /campaigns\uFF1Aspend/weeklyBudget/budget/strategy/targetCpa\uFF1B\u5168\u6E20\u9053\u82B1\u8D39\u987B --network ALL\uFF1B\u53EF --time-increment 1 \u6309\u65E5\uFF09"
+  ).requiredOption(...ACCOUNT_OPTION4).option(...START_OPTION).option(...END_OPTION).option("--time-increment <n>", "\u4F20 1 \u6309\u65E5\u5207\u5206\uFF1B\u4E0D\u4F20=\u533A\u95F4\u6C47\u603B\u3002Direct \u65E0\u5C0F\u65F6\u7EF4\u5EA6").option("--network <value>", "SEARCH\uFF08\u9ED8\u8BA4\uFF09\u6216 ALL\uFF08\u5168\u7F51\u4E00\u884C\u5408\u8BA1\uFF0C\u884C\u5185 network \u4E3A null\uFF09").option("--limit <n>", "\u6761\u6570\u4E0A\u9650\uFF08\u9ED8\u8BA4\u7F51\u5173 100\uFF0C\u6700\u5927 10000\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Auth Token").option("--json-out <path>", JSON_OUT_OPTION_DESC4).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runYandexCampaignEntities(opts);
+    }
+  );
+  root.command("adgroup-entities").description(
+    "\u5E7F\u544A\u7EC4\u7EE9\u6548+\u7CFB\u5217\u76EE\u6807 CPA/\u5468\u9884\u7B97\uFF08GET /adgroups\uFF1B\u9ED8\u8BA4\u5168\u7F51\uFF1BCPA \u98D9\u5347\u770B\u8FD1 3 \u65E5\u533A\u95F4\u6C47\u603B\uFF0C\u4E0D\u8981\u4F20 timeIncrement\uFF09"
+  ).requiredOption(...ACCOUNT_OPTION4).option(...START_OPTION).option(...END_OPTION).option("--time-increment <n>", "\u4F20 1 \u6309\u65E5\u5207\u5206\uFF1B\u4E0D\u4F20=\u533A\u95F4\u6C47\u603B").option("--campaign-id <id>", "\u53EA\u62C9\u8BE5\u7CFB\u5217\u4E0B\u7684\u7EC4").option("--limit <n>", "\u6761\u6570\u4E0A\u9650\uFF08\u9ED8\u8BA4\u7F51\u5173 100\uFF0C\u6700\u5927 10000\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Auth Token").option("--json-out <path>", JSON_OUT_OPTION_DESC4).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runYandexAdGroupEntities(opts);
+    }
+  );
+  root.command("ad-entities").description(
+    `\u5E7F\u544A\u7EE9\u6548+\u843D\u5730\u9875/\u62D2\u5BA1\uFF08GET /ads\uFF1B\u62D2\u5BA1\u4F20 --status REJECTED\uFF1B\u5408\u6CD5\uFF1A${YANDEX_AD_STATUSES.join(",")}\uFF1B\u4E0E --time-increment \u4E92\u65A5\uFF09`
+  ).requiredOption(...ACCOUNT_OPTION4).option(...START_OPTION).option(...END_OPTION).option("--time-increment <n>", "\u4F20 1 \u6309\u65E5\u5207\u5206\uFF1B\u4E0D\u4F20=\u533A\u95F4\u6C47\u603B\u3002\u4E0D\u8981\u548C --status \u540C\u65F6\u4F20").option(
+    "--status <list>",
+    "\u5BA1\u6838\u6001\u9017\u53F7\u5206\u9694\uFF0C\u5982 REJECTED \u6216 MODERATION,REJECTED\uFF1B\u5E26 status \u65F6\u4E0D\u62C9\u7EE9\u6548\uFF08spend=0\uFF09"
+  ).option("--campaign-id <id>", "\u53EA\u62C9\u8BE5\u7CFB\u5217\u4E0B\u7684\u5E7F\u544A").option("--adgroup-id <id>", "\u53EA\u62C9\u8BE5\u7EC4\u4E0B\u7684\u5E7F\u544A").option("--limit <n>", "\u6761\u6570\u4E0A\u9650\uFF08\u9ED8\u8BA4\u7F51\u5173 100\uFF0C\u6700\u5927 10000\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Auth Token").option("--json-out <path>", JSON_OUT_OPTION_DESC4).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runYandexAdEntities(opts);
+    }
+  );
+  root.command("insights").description(
+    "YandexAPI \u62A5\u8868\u5207\u7247\uFF08GET /daily|/geo|/devices|/keywords \u6216 campaigns/adgroups/ads\uFF1B\u53EF\u542B\u4ECA\u5929\uFF1B\u65E0\u5C0F\u65F6\u7EF4\u5EA6\u3002geo/devices \u5168\u7F51\u987B --network ALL\uFF09"
+  ).requiredOption(...ACCOUNT_OPTION4).requiredOption("--level <level>", YANDEX_INSIGHTS_LEVELS.join(" / ")).option(...START_OPTION).option(...END_OPTION).option("--time-increment <n>", "\u4EC5 campaigns/adgroups/ads\uFF1A\u4F20 1 \u6309\u65E5\uFF1B\u4E0D\u8981\u548C --status \u540C\u65F6\u4F20").option("--network <value>", "\u4EC5 campaigns/geo/devices\uFF1ASEARCH \u6216 ALL").option("--status <list>", "\u4EC5 --level ads\uFF1A\u5BA1\u6838\u6001\u8FC7\u6EE4").option("--campaign-id <id>", "\u4EC5 adgroups/ads").option("--adgroup-id <id>", "\u4EC5 ads").option("--limit <n>", "\u6709 limit \u7684 path\uFF1A\u9ED8\u8BA4\u7F51\u5173 100\uFF0C\u6700\u5927 10000", (v) => parseInt(v, 10)).option("-t, --token <token>", "Auth Token").option("--json-out <path>", JSON_OUT_OPTION_DESC4).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runYandexInsights(opts);
+    }
+  );
 }
 
 // src/index.ts

package/dist/skill/SKILL.md

@@ -125,7 +125,7 @@ siluzan-tso -h
 | 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |
 | 超预算熔断 / 空耗熔断（全户 Google） | — | `references/operations/guard.md`（`guard budget-circuit` / `guard zero-conv`；禁止逐户 for-loop） |
 | Bing 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-bing.md`（只读告警，不能自动暂停/改价） |
-| Yandex 自动化巡检（余额/CPA/日花费预警） | — | `references/operations/hosted-automation-yandex.md`（只读告警，不能自动改投放） |
+| Yandex 自动化巡检（归档/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-yandex.md`（只读告警，不能自动暂停/改价） |
 | TikTok 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-tiktok.md`（只读告警，不能自动暂停/改价） |
 | Facebook / MetaAd 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-facebook.md`（只读告警，不能自动暂停/改价） |
 | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP；Google 熔断优先 guard.md；Bing/Yandex/TikTok/Facebook 走上四行） |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.48-beta.8",
-  "publishedAt": 1787738525935
+  "version": "1.1.48-beta.9",
+  "publishedAt": 1787813752940
 }

package/dist/skill/references/analytics/account-analytics.md

@@ -460,7 +460,7 @@ siluzan-tso bing-analysis run -a <mediaCustomerId> --json-out ./snap --sections
 
 ## Yandex 账户分析
 
-> **自动化巡检步骤**（余额 / 多账户 CPA / 日报花费，只读告警）：`references/operations/hosted-automation-yandex.md`。
+> **自动化巡检步骤**（归档 / 拒审 / 落地页 / 当日超预算 / 空耗预警，只读告警）：`references/operations/hosted-automation-yandex.md`。
 >
 > **网关**：直打 YandexAPI `{yandexApiUrl}/yandex-analysis/*`（从 TSO `apiBaseUrl` 推导：`tso-api-ci` → `yandexapi-ci.mysiluzan.com`；可用 `SILUZAN_YANDEX_API` 覆盖）。
 >
@@ -498,6 +498,30 @@ siluzan-tso yandex-analysis render \
 
 `search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。无 Metrica / 写操作。报告模板：`report-templates/yandex-period-report.md`（8 个分析章节必写总结+建议；周趋势读落盘 `daily.weekly[]`，**禁止**自行按 `date` 聚周）。
 
+### Yandex 只读运营（`yandex-analysis` 子命令，YandexAPI）
+
+> 与上面 `run` 的周期报表不同。归档/余额、当日全网花费、组级 CPA、拒审、落地页、按日环比走以下子命令。省略 `--start/--end` 默认当天。金额已是账户币种小数。本批**不能**暂停 / 改价 / 改预算。
+
+| 子命令 | 说明 |
+| --- | --- |
+| `account-status` | `GET /overview`：`archived` / `balance` / `currency`；官方无封户原因 |
+| `campaign-entities` | `GET /campaigns`：`spend` / `weeklyBudget` / `budget` / `strategy` / `targetCpa`；全网加 `--network ALL`；按日加 `--time-increment 1` |
+| `adgroup-entities` | `GET /adgroups`：组绩效 + `campaignTargetCpa` / `campaignWeeklyBudget`；默认全网 |
+| `ad-entities` | `GET /ads`：落地页 `landingUrls`；拒审 `--status REJECTED`（与 `--time-increment` 互斥） |
+| `insights` | `--level daily\|geo\|devices\|keywords\|campaigns\|adgroups\|ads`；geo/devices 全网须 `--network ALL` |
+
+```bash
+siluzan-tso yandex-analysis account-status -a <porg-xxx> --json-out ./snap-yandex
+siluzan-tso yandex-analysis campaign-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start 2026-08-27 --end 2026-08-27 --time-increment 1 --network ALL
+siluzan-tso yandex-analysis ad-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --status REJECTED --start 2026-08-27 --end 2026-08-27
+siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
+  --level daily --start 2026-08-25 --end 2026-08-27
+```
+
+**要点**：Direct 无小时维度。默认报表只出现有消耗对象。`budget` 是系列日预算（自动策略常空），对照 `weeklyBudget`。`campaignTargetCpa` 只取 Search。`roi` 按成交额算。
+
 ---
 
 ## 报告模板

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

@@ -215,7 +215,7 @@
   2. 消耗：`stats -m <媒体> -a <id> --start <昨天/上周一> --end <昨天/上周日>`（多户汇总走 **P3**；Bing/Yandex **今天**不要用 `stats`）。
   3. Google 当日超预算/空耗熔断（若用户要求）：`guard budget-circuit` / `guard zero-conv -m Google --json-out`（**禁止**逐户 for-loop）。
   4. Bing 巡检（若用户要求）：按 `hosted-automation-bing.md` 跑封禁/拒审/当日超预算或空耗预警（只告警，不暂停）。
-  5. Yandex 巡检（若用户要求）：按 `hosted-automation-yandex.md` 跑 `balance-scan` / `accounts-digest` / `yandex-analysis`（只告警）。
+  5. Yandex 巡检（若用户要求）：按 `hosted-automation-yandex.md` 跑归档/拒审/当日超预算或空耗预警（只告警，不暂停）。
   6. TikTok 巡检（若用户要求）：按 `hosted-automation-tiktok.md` 跑封禁/拒审/当日超预算或空耗预警（只告警，不暂停）。
   7. Facebook / MetaAd 巡检（若用户要求）：按 `hosted-automation-facebook.md` 跑封禁/拒审/当日超预算或空耗预警（只告警，不暂停）。
   8. 预警触发：`forewarning records -m <媒体> --start <S>`（见 **W10**）。

package/dist/skill/references/operations/hosted-automation-scenarios.md

@@ -12,7 +12,7 @@
 | [`references/operations/hosted-automation-monitoring-json.md`](references/operations/hosted-automation-monitoring-json.md) | **Google 异常监控**落盘与读数                                                                                                                |
 | [`references/operations/hosted-automation-optimize-index.md`](references/operations/hosted-automation-optimize-index.md)   | **Google 自动优化**：差素材降价/关停、高转化扩量、A/B 停输家                                                                                 |
 | [`references/operations/hosted-automation-bing.md`](references/operations/hosted-automation-bing.md)                       | **Bing 只读巡检**：余额/IO、封禁、拒审、落地页、当日超预算预警、CPA/空耗预警；**不能**自动暂停/改价                                          |
-| [`references/operations/hosted-automation-yandex.md`](references/operations/hosted-automation-yandex.md)                   | **Yandex 只读巡检**：余额、多账户 CPA/零转化、日报花费异动；**不能**自动改投放                                                               |
+| [`references/operations/hosted-automation-yandex.md`](references/operations/hosted-automation-yandex.md)                   | **Yandex 只读巡检**：归档/余额、拒审、落地页、当日超预算、CPA/空耗、按日异动；**不能**自动暂停/改价                                          |
 | [`references/operations/hosted-automation-tiktok.md`](references/operations/hosted-automation-tiktok.md)                   | **TikTok 只读巡检**：封禁/余额、拒审、落地页、当日超预算、CPA/空耗、小时异动；**不能**自动暂停/改价                                          |
 | [`references/operations/hosted-automation-facebook.md`](references/operations/hosted-automation-facebook.md)               | **Facebook / MetaAd 只读巡检**：封禁/余额、拒审、落地页、当日超预算、CPA/空耗、小时异动；**不能**自动暂停/改价                                |
 

package/dist/skill/references/operations/hosted-automation-user-catalog.md

@@ -70,13 +70,15 @@
 
 ## Yandex：只读巡检
 
-全部步骤只读一份：`references/operations/hosted-automation-yandex.md`。**不能**自动改投放；无封禁/拒审/落地页/小时接口。
-
-| 场景                 | 做什么                                                                 | SOP                                                |
-| -------------------- | ---------------------------------------------------------------------- | -------------------------------------------------- |
-| 余额续航             | `balance-scan -m Yandex`                                               | `references/operations/hosted-automation-yandex.md` |
-| 多账户 CPA / 零转化  | `accounts-digest -m Yandex`（截至昨天）                                | 同上                                               |
-| 当日/近日花费与 CPA  | `yandex-analysis --sections overview,daily,campaigns`（可含今天）      | 同上                                               |
+全部步骤只读一份：`references/operations/hosted-automation-yandex.md`。**不能**自动暂停/改价/改预算。无小时维度。
+
+| 场景         | 做什么                                                                 | SOP                                                |
+| ------------ | ---------------------------------------------------------------------- | -------------------------------------------------- |
+| 余额 / 归档  | `yandex-analysis account-status`；`archived=true` 告警                 | `references/operations/hosted-automation-yandex.md` |
+| 素材拒审     | `ad-entities --status REJECTED`                                        | 同上                                               |
+| 落地页死链   | `ad-entities` 拉 `landingUrls`，宿主 HTTP 探活                         | 同上                                               |
+| 当日超预算   | `campaign-entities --time-increment 1 --network ALL`；只告警           | 同上                                               |
+| CPA / 空耗   | `adgroup-entities` 近 3 日 + 当日 `--time-increment 1`；只告警         | 同上                                               |
 
 ## Facebook / MetaAd：只读巡检
 

package/dist/skill/references/operations/hosted-automation-yandex.md

@@ -1,83 +1,153 @@
 # 宿主编排：Yandex 只读巡检
 
-> **何时 Read**：用户要 Yandex / 直通广告自动化、巡检、熔断、余额或 CPA 预警。Google 熔断走 `references/operations/guard.md`；Bing 走 `hosted-automation-bing.md`。
-> **能做什么**：拉余额、拉日报/周期报表、宿主按阈值告警。
-> **不能做什么**：暂停、改价、改预算、封禁专用接口、拒审列表、落地页列表、小时花费。没有写命令，**禁止**假装已执行熔断。
+> **何时 Read**：用户要 Yandex / 直通广告自动化、巡检、熔断、封禁、拒审、落地页、超预算或空耗。Google 熔断走 `references/operations/guard.md`；Bing 走 `hosted-automation-bing.md`。
+> **能做什么**：拉数、对比阈值、宿主告警。
+> **不能做什么**：暂停系列/组/广告、改价、改预算。本批只读，**禁止**假装已执行熔断。
 
 **前置**：已 `siluzan-tso login`，并用 `list-accounts -m Yandex --json-out ./snap` 确认 `mediaCustomerId`（形如 `porg-…`，**不是**纯数字，也不是 `entityId`）。
 
 **硬约束**：
 
 - `guard` **只支持 Google**。禁止 `guard … -m Yandex`。
-- 没有 `account-status` / `bulk-ads` / `campaign-entities` 这类实体子命令。
-- `yandex-analysis` 日期不能晚于今天；省略则默认近 7 天**含今天**。`search-terms` 只支持近 180 天。
-- `balance-scan` / `accounts-digest` 的消耗是每日同步**截至昨天**；查当天消耗用 `yandex-analysis`，不要用 `stats` 判断今天。
+- `yandex-analysis run` 是**周期报表**（默认 8 维、SEARCH、区间汇总）。当天花费、拒审、落地页、组级 CPA、全网花费走下面的**只读运营子命令**。
+- 省略 `--start/--end` 时运营子命令默认**当天**（本机日历日）。`run` 省略则仍是近 7 天含今天。
+- Direct **没有小时报表**。不要传 hourly，也不要编造近两小时 CPA。
+- `revenue` 是成交额 PurchaseRevenue；`roi = (成交额 − 花费) / 花费`。不要用目标赋值反推。
+- 默认报表路径只出现**有消耗**的对象。拒审须带 `--status`（结构查询，行内 `spend` 为 0）。
+- `--status` 与 `--time-increment` **不能同时传**（400）。
+- `/campaigns` `/geo` `/devices` 默认 SEARCH。全渠道花费须 `--network ALL`（行内 `network` 为 null，不拆行）。
+- 自动策略与共享账户通常只有**周预算**，`budget`（日预算）常为 null。不要把周预算写进日预算字段。
 
 ---
 
-## 1. 余额续航
+## 1. 余额 / 账户状态
+
+```bash
+siluzan-tso yandex-analysis account-status -a <porg-xxx> --json-out ./snap-yandex
+```
+
+读 `archived`、`balance`、`currency`、`balanceAsOf`。`archived=true` → 宿主告警「已归档」。官方**无**封户状态与原因，不要把 `archived` 写成「因违规被封」。官方无独立额度；续航用余额 ÷ 近几日日均花费（日均走 `insights --level daily`）。CLI **不能**自动充值。
+
+多户续航也可先扫 TSO 余额（截至昨天的日均）：
 
 ```bash
 siluzan-tso balance-scan -m Yandex --threshold-days 7 --json-out ./snap-yandex
 ```
 
-已知子集加 `-a porg-xxx,porg-yyy`。命中续航/余额不足 → 宿主通知充值。CLI **不能**自动充值。单户复核：
+---
+
+## 2. 素材拒审
 
 ```bash
-siluzan-tso balance -m Yandex -a <porg-xxx> --json-out ./snap-yandex
+siluzan-tso yandex-analysis ad-entities -a <porg-xxx> \
+  --start <当天> --end <当天> --status REJECTED --json-out ./snap-yandex
 ```
 
+也可 `MODERATION` / `PREACCEPTED`。合法值：`DRAFT,MODERATION,PREACCEPTED,ACCEPTED,REJECTED,UNKNOWN`。空列表 = 成功且没有未归档拒审，不是失败。已归档素材不会出现。命中 → 告警 `adId` / `campaignId` / `status` / `statusClarification`。
+
 ---
 
-## 2. 多账户消耗 / CPA / 零转化（截至昨天）
+## 3. 落地页死链
+
+```bash
+siluzan-tso yandex-analysis ad-entities -a <porg-xxx> \
+  --start <当天> --end <当天> --json-out ./snap-yandex
+```
 
-一条命令扫该媒体全部户（或 `-a` 子集）。区间必须是已结束的日期，**不要把今天当完整日**：
+读每条广告的 `landingUrls`（数组）。空数组 **不要**当死链（Dynamic / Smart / Shopping 或仅 `TurboPageId` 常为 `[]`）。CLI **不**发 HTTP。宿主对非空 URL 做 HEAD/GET，4xx/5xx 或超时 → 告警。扫在投、含 0 消耗素材用 `--status ACCEPTED`（该路径不带花费）。
+
+---
+
+## 4. 当日超预算（只预警，不暂停）
+
+全渠道当日花费 + 周预算（官方常无系列日预算）：
 
 ```bash
-siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --json-out ./snap-yandex
-siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --zero-conversions --json-out ./snap-yandex
-siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --max-cpa <目标CPA> --json-out ./snap-yandex
+siluzan-tso yandex-analysis campaign-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start <当天> --end <当天> --time-increment 1 --network ALL
 ```
 
-命中 → 宿主告警账户、区间花费、转化、CPA。不能自动关停。
+用同一 `campaignId` 看 `spend` 对 `weeklyBudget`（点击策略、投放天数 ≥ 3 时，单日大约最多花到周预算的 35%）。`budget` 仍是系列日预算，自动策略下通常为 null。命中 → **告警P1**，不要写「已暂停」。
 
 ---
 
-## 3. 单户当日 / 近日花费与 CPA（可含今天）
+## 5. CPA / 空耗（只预警，不降价、不暂停）
+
+近 3 日组级转化成本（无小时维度，不要编造近两小时）：
 
 ```bash
-mkdir -p ./snap-yandex
-siluzan-tso yandex-analysis -a <porg-xxx> --json-out ./snap-yandex \
-  --start <当日或近几日> --end <当日> --sections overview,daily,campaigns
+siluzan-tso yandex-analysis adgroup-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start <今天-2> --end <今天>
 ```
 
-宿主侧：
+对照 `conversions`、`costPerConversion`、`campaignTargetCpa`。`conversions <= 0` 时通常不判 CPA。有目标价时可用 `costPerConversion > campaignTargetCpa × 1.5` 作为飙升参考。没有目标价不算读取失败。`campaignStrategy` 只说明策略类型。
 
-- **日花费异动**：读 `daily` 按日对比前一日或近 7 日均值，超阈值告警。
-- **系列花费 / 预算**：同一窗口读 `campaigns`，用落盘里的花费对照 `budget`；缺字段就不要猜，改用日环比。
-- **CPA**：`花费 / 转化`（转化为 0 不算 CPA，改走空耗判断）。超过约定目标倍数 → 告警。
-- **空耗**：当日（或约定日）花费已达「目标 CPA × N」且转化为 0 → 告警「空耗预警」，文案不要写成「已熔断」。目标 CPA 用落盘 `targetCpa` 或账户约定。
+当日空耗（组 / 广告）：
 
-没有小时维度，做不了「近两小时 CPA」。
+```bash
+siluzan-tso yandex-analysis adgroup-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start <当天> --end <当天> --time-increment 1
+siluzan-tso yandex-analysis ad-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start <当天> --end <当天> --time-increment 1
+```
+
+有花费、无转化 → 告警「空耗预警」，文案不要写成「已熔断」。连续天数由宿主按日统计。
 
 ---
 
-## 4. 周期报告（给人看，不代替巡检告警）
+## 6. 花费异动 / 广告效果 / A/B / 根因
+
+按日花费环比（前天～今天）：
 
 ```bash
+siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
+  --level daily --start <前天> --end <今天>
+```
+
+差广告 / A/B（同一份广告列表，按 `adId` 比 `spend` / `ctr` / `conversions` / `roi` / `costPerConversion`）：
+
+```bash
+siluzan-tso yandex-analysis ad-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start <区间起> --end <区间止>
+```
+
+高转化扩量（组绩效 + 关键词搜索出价；自动策略下看系列周预算，不要按手动 CPC 改价）：
+
+```bash
+siluzan-tso yandex-analysis adgroup-entities -a <porg-xxx> --json-out ./snap-yandex \
+  --start <区间起> --end <区间止>
+siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
+  --level keywords --start <区间起> --end <区间止>
+```
+
+异动根因（地域与设备须分别请求；全网加 `--network ALL`）：
+
+```bash
+siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
+  --level geo --start <S> --end <D> --network ALL
+siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
+  --level devices --start <S> --end <D> --network ALL
+```
+
+`/geo` 有 `limit`（默认 100）。截断后的地域 `spend` 合计通常低于全网，不宜直接拿去对 `/devices`。
+
+---
+
+## 7. 周期报告与多账户（给人看，不代替巡检告警）
+
+```bash
+siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --json-out ./snap-yandex
 siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <D> --json-out ./snap-yandex
 ```
 
-出 HTML 按 `report-templates/yandex-period-report.md` 写 narrative 后再 `yandex-analysis render`。自动化任务里报告是可选交付物；阈值告警仍走上面 1–3 步。
+`accounts-digest` / `balance-scan` 的消耗截至**昨天**。出 HTML 按 `report-templates/yandex-period-report.md` 写 narrative 后再 `yandex-analysis render`。阈值告警仍走上面 1–6 步。
 
 ---
 
 ## 做不到（勿编造命令）
 
-| 场景           | 现状                                      |
-| -------------- | ----------------------------------------- |
-| 账户封禁专用   | 无；`list-accounts` 状态仅供人工看        |
-| 素材拒审       | 无拒审列表                                |
-| 落地页探活     | 无最终到达网址接口                        |
-| 小时花费       | 无                                        |
-| 自动暂停 / 改价 | 无写接口；告警后人工在 Yandex 后台处理 |
+| 场景            | 现状                                      |
+| --------------- | ----------------------------------------- |
+| 账户封禁原因    | 无；只能读 `archived`                     |
+| 小时花费 / 小时 CPA | 无；改用按日或近 3 日区间              |
+| 自动暂停 / 改价 / 改预算 | 无写接口；告警后人工在 Yandex 后台处理 |

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