siluzan-tso-cli 1.1.56-beta.4 → 1.1.57-beta.1

package/README.md

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

package/dist/index.js

@@ -5376,6 +5376,119 @@ var init_brief = __esm({
   }
 });
 
+// src/commands/accounts-digest/campaign-types.ts
+function presenceCount(value) {
+  if (value == null || value === false || value === "") return 0;
+  if (typeof value === "number") return Number.isFinite(value) ? value : 0;
+  if (typeof value === "string") {
+    const n = Number(value);
+    if (value.trim() !== "" && Number.isFinite(n)) return n;
+    return 0;
+  }
+  if (Array.isArray(value)) return value.length;
+  if (typeof value === "object") {
+    const obj = value;
+    for (const key of COUNT_KEYS) {
+      if (key in obj) return presenceCount(obj[key]);
+    }
+    return Object.keys(obj).length > 0 ? 1 : 0;
+  }
+  return 0;
+}
+function summarizeCampaignTypes(record2, depth = 0) {
+  const empty = {
+    campaignTypesStatus: "ok",
+    campaignTypes: [],
+    hasDisplay: false,
+    hasPmax: false,
+    campaignTypesError: null
+  };
+  if (record2 == null || typeof record2 !== "object" || Array.isArray(record2)) return empty;
+  const bag = record2;
+  const types = [];
+  let hasDisplay = false;
+  let hasPmax = false;
+  for (const [key, value] of Object.entries(bag)) {
+    if (key === "ok" || key === "meta" || key.startsWith("_")) continue;
+    if (NESTED_KEYS.includes(key)) continue;
+    if (presenceCount(value) <= 0) continue;
+    types.push(key);
+    if (DISPLAY_KEY.test(key)) hasDisplay = true;
+    if (PMAX_KEY.test(key)) hasPmax = true;
+  }
+  if (types.length === 0 && depth === 0) {
+    for (const nest of NESTED_KEYS) {
+      const inner = bag[nest];
+      if (inner && typeof inner === "object") return summarizeCampaignTypes(inner, 1);
+    }
+  }
+  return {
+    campaignTypesStatus: "ok",
+    campaignTypes: types,
+    hasDisplay,
+    hasPmax,
+    campaignTypesError: null
+  };
+}
+function skippedNoSpendCampaignTypes() {
+  return {
+    campaignTypesStatus: "skipped-no-spend",
+    campaignTypes: null,
+    hasDisplay: null,
+    hasPmax: null,
+    campaignTypesError: null
+  };
+}
+function errorCampaignTypes(message) {
+  const text2 = message.replace(/\s+/g, " ").trim().slice(0, 180);
+  return {
+    campaignTypesStatus: "error",
+    campaignTypes: null,
+    hasDisplay: null,
+    hasPmax: null,
+    campaignTypesError: text2 || "unknown error"
+  };
+}
+function errorMessage(err) {
+  if (err instanceof Error) return err.message;
+  return String(err);
+}
+async function fetchCampaignTypeSummaries(accountIds, fetchOne, opts) {
+  const ids = [...new Set(accountIds.filter((id) => id.trim() !== ""))];
+  const out = /* @__PURE__ */ new Map();
+  if (ids.length === 0) return out;
+  const concurrency = Math.max(1, Math.min(opts?.concurrency ?? 8, 16, ids.length));
+  let cursor = 0;
+  let done = 0;
+  const workers = new Array(concurrency).fill(0).map(async () => {
+    while (true) {
+      const index = cursor++;
+      if (index >= ids.length) return;
+      const id = ids[index];
+      try {
+        const record2 = await fetchOne(id);
+        out.set(id, summarizeCampaignTypes(record2));
+      } catch (err) {
+        out.set(id, errorCampaignTypes(errorMessage(err)));
+      }
+      done += 1;
+      opts?.onProgress?.(done, ids.length);
+    }
+  });
+  await Promise.all(workers);
+  return out;
+}
+var DISPLAY_KEY, PMAX_KEY, NESTED_KEYS, COUNT_KEYS;
+var init_campaign_types = __esm({
+  "src/commands/accounts-digest/campaign-types.ts"() {
+    "use strict";
+    DISPLAY_KEY = /^(display|responsive_display|display_network)$/i;
+    PMAX_KEY = /^(performance_?max|performancemax)$/i;
+    NESTED_KEYS = ["data", "record", "types", "typesSummary"];
+    COUNT_KEYS = ["count", "total", "campaignCount", "value", "campaigns"];
+  }
+});
+
 // src/commands/accounts-digest/filters.ts
 function keepDigestRow(row, opts) {
   const { maxCpa, zeroConversions } = opts;
@@ -5404,6 +5517,18 @@ var init_filters = __esm({
 });
 
 // src/commands/accounts-digest/run.ts
+function formatCampaignTypesCell(row) {
+  if (row.campaignTypesStatus === "ok") {
+    const flags = [
+      row.hasDisplay ? "Display" : "\u65E0Display",
+      row.hasPmax ? "PMax" : "\u65E0PMax"
+    ];
+    return flags.join(" ");
+  }
+  if (row.campaignTypesStatus === "skipped-no-spend") return "\u672A\u67E5(\u65E0\u6D88\u8017)";
+  if (row.campaignTypesStatus === "error") return "\u67E5\u8BE2\u5931\u8D25";
+  return "-";
+}
 function round2(n) {
   if (n == null) return null;
   const v = Number(n);
@@ -5422,6 +5547,16 @@ async function runAccountsDigest(opts) {
     process.exit(1);
   }
   const media = opts.media;
+  if (opts.withCampaignTypes && media !== "Google") {
+    console.error(
+      "\n\u274C --with-campaign-types \u53EA\u652F\u6301 -m Google\uFF08\u7CFB\u5217\u7C7B\u578B\u6765\u81EA Google campaigns/types-summary\uFF09\u3002\n"
+    );
+    process.exit(1);
+  }
+  if (opts.withCampaignTypes && !config.googleApiUrl) {
+    console.error("\n\u274C \u5F53\u524D\u914D\u7F6E\u6CA1\u6709 googleApiUrl\uFF0C\u65E0\u6CD5\u62C9\u53D6\u5E7F\u544A\u7CFB\u5217\u7C7B\u578B\u3002\n");
+    process.exit(1);
+  }
   const filterIds = (opts.accounts ?? "").split(",").map((s) => s.trim()).filter(Boolean);
   const filterSet = new Set(filterIds);
   const minSpend = opts.minSpend ?? 0;
@@ -5565,6 +5700,56 @@ async function runAccountsDigest(opts) {
     rows.push(row);
   }
   rows.sort((a, b) => (b.spend ?? 0) - (a.spend ?? 0));
+  let campaignTypeMeta = null;
+  if (opts.withCampaignTypes) {
+    const concurrency = Math.max(1, Math.min(opts.campaignTypeConcurrency ?? 8, 16));
+    const spendIds = rows.filter((row) => (row.spend ?? 0) > 0).map((row) => row.mediaCustomerId);
+    process.stderr.write(
+      `\u23F3 [accounts-digest] \u7CFB\u5217\u7C7B\u578B\uFF1A${spendIds.length} \u4E2A\u6709\u6D88\u8017\u8D26\u6237\uFF0C\u5E76\u53D1 ${concurrency}\uFF08\u6D88\u8017\u4E3A 0 \u7684\u4E0D\u8BF7\u6C42\uFF09\u3002
+`
+    );
+    const summaries = await fetchCampaignTypeSummaries(
+      spendIds,
+      (accountId) => {
+        const url = `${config.googleApiUrl}/reporting/media-account/${encodeURIComponent(accountId)}/campaigns/types-summary`;
+        return apiFetch2(url, config, {}, !!opts.verbose);
+      },
+      {
+        concurrency,
+        onProgress: (done, total) => {
+          if (done === total || done % 50 === 0) {
+            process.stderr.write(`   \u2713 [\u7CFB\u5217\u7C7B\u578B] ${done}/${total}
+`);
+          }
+        }
+      }
+    );
+    let ok = 0;
+    let failed = 0;
+    let skippedNoSpend = 0;
+    for (const row of rows) {
+      const fields = (row.spend ?? 0) > 0 ? summaries.get(row.mediaCustomerId) ?? errorCampaignTypes("\u672A\u8FD4\u56DE\u8BE5\u8D26\u6237\u7684\u7CFB\u5217\u7C7B\u578B") : skippedNoSpendCampaignTypes();
+      row.campaignTypesStatus = fields.campaignTypesStatus;
+      row.campaignTypes = fields.campaignTypes;
+      row.hasDisplay = fields.hasDisplay;
+      row.hasPmax = fields.hasPmax;
+      row.campaignTypesError = fields.campaignTypesError;
+      if (fields.campaignTypesStatus === "ok") ok += 1;
+      else if (fields.campaignTypesStatus === "error") failed += 1;
+      else skippedNoSpend += 1;
+    }
+    campaignTypeMeta = {
+      requested: spendIds.length,
+      ok,
+      failed,
+      skippedNoSpend,
+      concurrency
+    };
+    process.stderr.write(
+      `   \u2713 [\u7CFB\u5217\u7C7B\u578B] \u5B8C\u6210\uFF1A\u6210\u529F ${ok}\uFF0C\u5931\u8D25 ${failed}\uFF0C\u672A\u67E5\uFF08\u65E0\u6D88\u8017\uFF09${skippedNoSpend}
+`
+    );
+  }
   const totals = rows.reduce(
     (acc, r) => {
       acc.spend += r.spend ?? 0;
@@ -5606,7 +5791,9 @@ async function runAccountsDigest(opts) {
     },
     totalsScope: "returned",
     currencyNote: "\u5404\u8D26\u6237\u4E3B\u5E01\u79CD\u53EF\u80FD\u4E0D\u540C\uFF1Btotals \u53EA\u5408\u8BA1 returned\uFF08\u547D\u4E2D\uFF09\u884C\uFF0C\u7981\u6B62\u5199\u6210\u5168\u90E8\u8D26\u6237\u3002\u8DE8\u5E01\u79CD\u8BF7\u6309 currencyCode \u5206\u8868",
-    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    /** 未传 --with-campaign-types 时为 null。失败户的 hasDisplay 是 null，不能当成「无展示」。 */
+    campaignTypes: campaignTypeMeta
   };
   const agentBrief = buildDigestAgentBrief({
     rows,
@@ -5649,6 +5836,9 @@ ${media} \u8D26\u6237\u6295\u653E\u753B\u50CF\uFF1A\u8FD4\u56DE ${rows.length} \
     { key: "cpa", header: "CPA" },
     { key: "balance", header: "\u4F59\u989D" }
   ];
+  if (opts.withCampaignTypes) {
+    cols.push({ key: "types", header: "\u7CFB\u5217\u7C7B\u578B" });
+  }
   const tableRows = rows.map((r) => ({
     id: r.mediaCustomerId,
     company: r.advertiserName ?? "-",
@@ -5660,7 +5850,8 @@ ${media} \u8D26\u6237\u6295\u653E\u753B\u50CF\uFF1A\u8FD4\u56DE ${rows.length} \
     ctr: r.ctr != null ? r.ctr.toFixed(2) : "-",
     cpc: formatMoneyDisplay(r.cpc, r.currencyCode),
     cpa: formatMoneyDisplay(r.cpa, r.currencyCode),
-    balance: formatMoneyDisplay(r.balance, r.currencyCode)
+    balance: formatMoneyDisplay(r.balance, r.currencyCode),
+    types: formatCampaignTypesCell(r)
   }));
   printCliTable(tableRows, cols);
   if (meta.nullConversionCount > 0) {
@@ -5693,6 +5884,7 @@ var init_run = __esm({
     init_list_fetch();
     init_login_customer_id();
     init_brief();
+    init_campaign_types();
     init_filters();
   }
 });
@@ -5716,7 +5908,15 @@ function register10(program2) {
     "--skip-balance",
     "\u53EA\u62C9\u6D88\u8017\u3001\u4E0D\u62C9\u4F59\u989D\uFF08\u8F6C\u5316\u6210\u672C/CPA \u5DE1\u68C0\u63A8\u8350\uFF1B\u53EF\u5C11\u4E00\u534A\u8BF7\u6C42\u65F6\u95F4\uFF09",
     false
-  ).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF0C\u4E0A\u9650 500\uFF09", (v) => parseInt(v, 10)).option("--login-customer-id <id>", LOGIN_CUSTOMER_ID_OPTION_HELP).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF0C\u4E0A\u9650 200\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option(
+  ).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF0C\u4E0A\u9650 500\uFF09", (v) => parseInt(v, 10)).option("--login-customer-id <id>", LOGIN_CUSTOMER_ID_OPTION_HELP).option(
+    "--with-campaign-types",
+    "\u4EC5 Google\uFF1A\u5BF9\u533A\u95F4\u6D88\u8017 > 0 \u7684\u8D26\u6237\u5E76\u53D1\u62C9\u53D6 campaigns/types-summary\uFF0C\u5728\u6BCF\u884C\u5199\u5165 hasDisplay / hasPmax\u3002\u7528\u6765\u505A\u300C\u65E0\u5C55\u793A\u6216\u65E0 PMax\u300D\u5DE1\u68C0\uFF0C\u4E0D\u8981\u518D\u9010\u6237\u8C03 ad campaigns\u3002",
+    false
+  ).option(
+    "--campaign-type-concurrency <n>",
+    "\u7CFB\u5217\u7C7B\u578B\u8BF7\u6C42\u5E76\u53D1\uFF081\u201316\uFF0C\u9ED8\u8BA4 8\uFF09",
+    (v) => parseInt(v, 10)
+  ).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF0C\u4E0A\u9650 200\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
     void 0
@@ -5737,7 +5937,9 @@ function register10(program2) {
         jsonOut: opts.jsonOut,
         refreshDp: opts.refreshDp,
         verbose: opts.verbose,
-        loginCustomerId: opts.loginCustomerId
+        loginCustomerId: opts.loginCustomerId,
+        withCampaignTypes: opts.withCampaignTypes,
+        campaignTypeConcurrency: opts.campaignTypeConcurrency
       });
     }
   );
@@ -144781,7 +144983,7 @@ function playbookCodeFatal(cmd) {
   const known = {
     W1: "siluzan-tso list-accounts [-m Google] --json-out <dir>",
     P2: "siluzan-tso balance-scan -m Google --json-out <dir>",
-    P3: "siluzan-tso accounts-digest -m Google --start <S> --end <D> --json-out <dir>"
+    P3: "siluzan-tso accounts-digest -m Google --start <S> --end <D> --json-out <dir>\uFF08\u8981\u5224\u65AD Display/PMax \u518D\u52A0 --with-campaign-types\uFF0C\u4E0D\u8981\u9010\u6237 ad campaigns\uFF09"
   };
   const replacement = known[key];
   if (replacement) {

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.56-beta.4",
-  "publishedAt": 1792573193457
+  "version": "1.1.57-beta.1",
+  "publishedAt": 1792724333584
 }

package/dist/skill/references/accounts/accounts-balance-stats.md

@@ -98,6 +98,7 @@ siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 > - 口语「零询盘 / 转化成本」且**无 CRM 询盘附件** → 本命令（P3），**不是** P7。
 > - `conversions` / `cpa` 可能为 **null**（overview 未返回转化）→ 交付写「转化未返回」；脚本勿对 null 做数值比较。过滤用 `--max-cpa` / `--zero-conversions`，巡检交付用 `agentBrief.userDelivery`，勿手写脆弱 Python 重算 CTR/合计。
 > - **没有** `cpa-risk-scan`。`--max-cpa` 的零转化仅当消耗已超过阈值才命中。`meta.totals` **只合计 returned**，禁止写成全部账户。`ctr` 已是百分数。
+> - **没有**按户循环 `ad campaigns` 来判断 Display / PMax 的做法。要系列类型就加 `--with-campaign-types`（仅 Google，只查消耗 > 0 的户）。
 
 ```bash
 siluzan-tso accounts-digest -m <媒体类型> [选项]
@@ -116,6 +117,9 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
 | `--skip-balance`              | 只拉消耗、不拉余额（转化成本巡检推荐）                                                                        | off     |
 | `--page-size <n>`             | 全量扫描时清单分页大小（上限 500）                                                                            | `200`   |
 | `--max-pages <n>`             | 全量扫描时最多页数（上限 200）                                                                                | `20`    |
+| `--login-customer-id <id>`    | 只保留该 MCC（`ma.loginCustomerId`）下的账户。可带横杠。先拉清单再过滤，**不要**先 `list-accounts` 把 ID 拼进 `-a` | —       |
+| `--with-campaign-types`       | **仅 Google**。对区间消耗 > 0 的账户并发请求 `campaigns/types-summary`，每行写入系列类型。四项巡检用这个，禁止逐户 `ad campaigns` | off     |
+| `--campaign-type-concurrency <n>` | 上面这个请求的并发（1–16）                                                                              | `8`     |
 | `--json-out <path>`           | **Agent 推荐**：落盘目录或 `*.json` 文件；stdout 一行摘要（含 `outlineFile`、`writtenFiles`、`manifestFile`） | —       |
 
 **`--json-out` 落盘**：
@@ -152,10 +156,29 @@ siluzan-tso accounts-digest -m Google --start 2026-07-14 --end 2026-07-20 \
 # 零转化 / 口语「零询盘」巡检（无 CRM 附件时用本命令，不是 P7）
 siluzan-tso accounts-digest -m Google --start 2026-07-20 --end 2026-07-20 \
   --zero-conversions --json-out ./snap-zero-conv
+
+# Google 四项巡检：CPA、余额、零转化、有没有 Display/PMax。一条命令，不要再逐户拉系列
+siluzan-tso accounts-digest -m Google --login-customer-id 397-889-3117 \
+  --with-campaign-types --start 2026-10-16 --end 2026-10-22 \
+  --json-out ./snap-inspect
 ```
 
+四项都要时不要加 `--max-cpa` / `--zero-conversions`（会丢掉其它行）。外层命令必须直接是 `siluzan-tso`，不要写进 Python 再调用。
+
 **`data.items[]` 主要字段**：`mediaCustomerId`、`name`、`advertiserName`、`currencyCode`、`balance`、`spend`（**区间合计**，同 `stats`）、`impressions`、`clicks`、`conversions`（可为 null）、`ctr`（%）、`cpc`、`cpa`（可为 null）。跨币种汇总见 `references/accounts/currency.md`（**禁止**对 `meta.totals` 跨币种直接当最终结论）。
 
+**`--with-campaign-types` 额外字段**（只在打开开关时出现）：
+
+| 字段 | 含义 |
+| --- | --- |
+| `campaignTypesStatus` | `ok` 查到了；`skipped-no-spend` 区间消耗为 0，没请求；`error` 这一户失败 |
+| `campaignTypes` | `ok` 时是计数 > 0 的类型名（如 `Search`、`Display`、`PerformanceMax`）；否则 `null` |
+| `hasDisplay` | `ok` 时才是布尔。`Display` 计数 > 0 为 true |
+| `hasPmax` | `ok` 时才是布尔。`PerformanceMax` / `PERFORMANCE_MAX` 计数 > 0 为 true |
+| `campaignTypesError` | `error` 时的短原因 |
+
+脚本规则：`campaignTypesStatus === "ok" && hasDisplay === false && hasPmax === false` 才算「无展示且无 PMax」。`error` 和 `skipped-no-spend` 单独列出，**禁止**当成「无」。`meta.campaignTypes` 有 `requested` / `ok` / `failed` / `skippedNoSpend`。
+
 ---
 
 ## stats — 查询投放消耗数据

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

@@ -249,6 +249,7 @@
 | -------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
 | 多账户余额 / 预算不足预警              | `balance-scan -m <媒体> --threshold-days 7`（用 **`dailySpend`** / `remainingDays`；交付 `agentBrief.userDelivery`） | 逐账户 `balance --accounts ...`；`account balance`；把 `stats` 多日 **`spend` 当「日消耗」** |
 | 多账户投放画像 / 转化成本巡检          | `accounts-digest -m <媒体> [-a ...] --start --end --json-out`（CPA 加 `--max-cpa --skip-balance`；**`spend`=区间合计**；交付 `agentBrief.userDelivery`） | 发明 `cpa-risk-scan`；逐账户 `stats`；把 `meta.totals` 说成全部账户；把 `ctr` 再乘 100 |
+| Google 巡检要「有没有 Display / PMax」 | 同一条 `accounts-digest -m Google --with-campaign-types [--login-customer-id <MCC>]`。只对消耗 > 0 的户查类型 | 逐户 `ad campaigns` / `google-analysis --sections campaign-types`；把 `siluzan-tso` 写进 Python 再 subprocess；把 `campaignTypesStatus≠ok` 当成「无展示」 |
 | 单户按日 Excel                         | `stats … --by-day --json-out`（P4-DAILY）                                                     | 默认 `stats` 当按日                                                                          |
 | 多账户 × 多维度 Google 数据            | 全量：`google-analysis-batch run`（省略 `-a`）；2~10：`google-analysis -a id1,id2,...`        | 外层 for-loop；先 list 再拼 `-a`                                                             |
 | 多系列诊断                             | `ad campaigns --json-out` + node 读文件过滤                                                   | 逐系列 `ad campaign-get`                                                                     |

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

@@ -59,8 +59,10 @@
   - `conversions`/`cpa` 为 null 时写「转化未返回」，**禁止**对 null 做 `>` 比较导致脚本崩溃。
   - **禁止**把 `meta.totals` 写成「全部账户」合计（`totalsScope=returned`，只合计命中行）。
   - **禁止**把 `ctr` 再 `.2%` / `*100`（已是百分数）。
+  - **Google 四项巡检**（CPA、余额、零转化、无 Display/PMax，常带 MCC）：只跑下面这一条，**禁止**再逐户 `ad campaigns` / `google-analysis --sections campaign-types`，**禁止**把 `siluzan-tso` 写进脚本再 subprocess。
 - **步骤**：
-  1. 确认时间范围后执行 `accounts-digest -m <媒体> -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3`（全量则省略 `-a`）。
+  1. 确认时间范围后执行 `accounts-digest -m <媒体> -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3`（全量则省略 `-a`）。指定 MCC 时加 `--login-customer-id <id>`，不要先 `list-accounts` 再把全部 ID 拼进 `-a`。
+  1b. **要系列类型时**（仅 Google）：同一条命令加 `--with-campaign-types`。四项都要时**不要**再加 `--max-cpa` / `--zero-conversions`（那两个开关会丢掉其它行）。脚本读 `data.items`：`cpa`、`balance`、`spend`+`conversions`，以及 `hasDisplay` / `hasPmax`。只有 `campaignTypesStatus=ok` 且两项都为 false 才写入「无展示且无 PMax」；`error` / `skipped-no-spend` 另列。
   2. **高 CPA / 转化成本巡检**：`--max-cpa <n> --skip-balance`（CPA > n，或零转化且消耗已 > n）。读盘后**只把 `agentBrief.userDelivery` 原样发给用户**（无命中即「全部正常」句；有命中只贴表）。
   3. **零转化 / 零询盘巡检**（要全部空耗户，含小额）：加 `--zero-conversions`。
   4. 指定子集对比表：基于 `data.items`；**不要**再逐账户 `stats`。

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

@@ -213,7 +213,7 @@
 - **必读**：`references/accounts/accounts-balance-stats.md`；首页看板口径见 `references/misc/tso-home.md`。Google 超预算/空耗熔断另读 `references/operations/guard.md`。Bing / Yandex / TikTok / Facebook 只读巡检读 `hosted-automation-bing.md` / `hosted-automation-yandex.md` / `hosted-automation-tiktok.md` / `hosted-automation-facebook.md`。
 - **步骤**：
   1. 余额：`list-accounts -m <媒体> --json-out ./snap` → `balance -m <媒体> -a <mediaCustomerId,...>`（多户续航预警走 **P2**）。
-  2. 消耗：`stats -m <媒体> -a <id> --start <昨天/上周一> --end <昨天/上周日>`（多户汇总走 **P3**；Bing/Yandex **今天**不要用 `stats`）。
+  2. 消耗：多户汇总走 **P3** `accounts-digest`（Bing/Yandex **今天**不要用 `stats`）。Google 还要判断有没有 Display / PMax 时，同一条命令加 `--with-campaign-types`（可加 `--login-customer-id`），**禁止**逐户 `ad campaigns` 或把 CLI 塞进 Python。
   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` 跑归档/拒审/当日超预算或空耗预警（只告警，不暂停）。

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