siluzan-tso-cli 1.1.56 → 1.1.57-beta.2

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.57-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -4049,7 +4049,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";
   }
 });
 
@@ -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
       });
     }
   );
@@ -7039,6 +7241,80 @@ var init_geo_en2zh = __esm({
   }
 });
 
+// src/commands/report-period.ts
+function classifyReportPeriod(current, previous) {
+  const start = tryParse(current?.start);
+  const end = tryParse(current?.end);
+  if (!start || !end) return customPeriod();
+  if (isFullCalendarQuarter(start, end)) {
+    const tag = quarterTagFromMonth(start.m);
+    const prev = tryParse(previous?.start);
+    const prevEnd = tryParse(previous?.end);
+    return {
+      current: tag,
+      previous: prev && prevEnd && isFullCalendarQuarter(prev, prevEnd) ? quarterTagFromMonth(prev.m) : "\u4E0A\u671F",
+      next: tag === "Q4" ? "Q1" : `Q${Number(tag.slice(1)) + 1}`,
+      unit: "\u5B63\u5EA6"
+    };
+  }
+  if (start.d === 1 && start.y === end.y && start.m === end.m) {
+    const prev = tryParse(previous?.start);
+    const prevEnd = tryParse(previous?.end);
+    const prevSameMonth = prev && prevEnd && prev.y === prevEnd.y && prev.m === prevEnd.m;
+    const nextMonth = start.m === 12 ? 1 : start.m + 1;
+    return {
+      current: `${start.m}\u6708`,
+      previous: prevSameMonth ? `${prev.m}\u6708` : "\u4E0A\u671F",
+      next: `${nextMonth}\u6708`,
+      unit: "\u6708\u5EA6"
+    };
+  }
+  return customPeriod();
+}
+function rangeFromMeta(meta) {
+  if (!meta || typeof meta !== "object") return null;
+  const record2 = meta;
+  if (typeof record2.startDate !== "string" || typeof record2.endDate !== "string") return null;
+  return { start: record2.startDate, end: record2.endDate };
+}
+function attachPeriodChrome(payload) {
+  return { ...payload, periodChrome: classifyReportPeriod(rangeFromMeta(payload.meta)) };
+}
+function periodWord(unit, neutral) {
+  return unit || neutral;
+}
+function customPeriod() {
+  return { current: "\u672C\u671F", previous: "\u4E0A\u671F", next: "\u4E0B\u671F", unit: "" };
+}
+function tryParse(iso) {
+  if (!iso) return null;
+  const match = DATE_RE2.exec(iso.trim());
+  if (!match) return null;
+  const y = Number(match[1]);
+  const m = Number(match[2]);
+  const d = Number(match[3]);
+  if (m < 1 || m > 12 || d < 1 || d > 31) return null;
+  return { y, m, d };
+}
+function lastDayOfMonth(y, m) {
+  return new Date(Date.UTC(y, m, 0)).getUTCDate();
+}
+function isFullCalendarQuarter(start, end) {
+  if (start.y !== end.y || start.d !== 1) return false;
+  if (![1, 4, 7, 10].includes(start.m)) return false;
+  return end.m === start.m + 2 && end.d === lastDayOfMonth(end.y, end.m);
+}
+function quarterTagFromMonth(month) {
+  return `Q${Math.ceil(month / 3)}`;
+}
+var DATE_RE2;
+var init_report_period = __esm({
+  "src/commands/report-period.ts"() {
+    "use strict";
+    DATE_RE2 = /^(\d{4})-(\d{2})-(\d{2})/;
+  }
+});
+
 // src/commands/google-analysis/sections.ts
 var SECTIONS;
 var init_sections = __esm({
@@ -104454,7 +104730,7 @@ function asRecord23(value) {
   throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
 function injectReportData2(html, payload) {
-  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  const json = JSON.stringify(attachPeriodChrome(payload)).replace(/</g, "\\u003c");
   if (!html.includes(INJECT_MARKER)) {
     throw new Error("\u62A5\u544A\u6A21\u677F\u7F3A\u5C11\u6570\u636E\u6CE8\u5165\u951A\u70B9\uFF0C\u8BF7\u66F4\u65B0 google-period-report.html");
   }
@@ -104497,8 +104773,9 @@ async function runGoogleAnalysisRender(opts) {
   await fsPromises2.mkdir(outDir, { recursive: true });
   await fsPromises2.writeFile(outPath, injectReportData2(html, data), "utf8");
   const { stats } = contentCheck;
+  const cover = periodWord(attachPeriodChrome(data).periodChrome.unit, "\u5468\u671F");
   console.log(`
-\u2705 Google Ads \u5468\u671F\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+\u2705 Google Ads ${cover}\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\u6570\u636E\u7EF4\u5206\u6790+\u5EFA\u8BAE\u5747\u5DF2\u9F50\u5168
@@ -104514,6 +104791,7 @@ var init_render_report = __esm({
     "use strict";
     init_merge_snapshot();
     init_report_content();
+    init_report_period();
     TEMPLATE_BASENAME = "google-period-report.html";
     INJECT_MARKER = "window.__GOOGLE_PERIOD_REPORT__ = window.__GOOGLE_PERIOD_REPORT__ || null;";
   }
@@ -136875,9 +137153,10 @@ async function fetchYoutubeChannel(opts) {
 }
 
 // src/commands/google-quarterly/windows.ts
-var DATE_RE2 = /^(\d{4})-(\d{2})-(\d{2})$/;
+init_report_period();
+var DATE_RE3 = /^(\d{4})-(\d{2})-(\d{2})$/;
 function parseIsoDate(iso) {
-  const match = DATE_RE2.exec(iso.trim());
+  const match = DATE_RE3.exec(iso.trim());
   if (!match) throw new Error(`\u65E5\u671F\u987B\u4E3A YYYY-MM-DD\uFF1A${iso}`);
   const y = Number(match[1]);
   const m = Number(match[2]);
@@ -136891,7 +137170,7 @@ function pad(n) {
 function isoDate(y, m, d) {
   return `${y}-${pad(m)}-${pad(d)}`;
 }
-function lastDayOfMonth(y, m) {
+function lastDayOfMonth2(y, m) {
   return new Date(Date.UTC(y, m, 0)).getUTCDate();
 }
 function listMonths(start, end) {
@@ -136902,7 +137181,7 @@ function listMonths(start, end) {
   let m = s.m;
   while (y < e.y || y === e.y && m <= e.m) {
     const monthStart = y === s.y && m === s.m ? start : isoDate(y, m, 1);
-    const monthEnd = y === e.y && m === e.m ? end : isoDate(y, m, lastDayOfMonth(y, m));
+    const monthEnd = y === e.y && m === e.m ? end : isoDate(y, m, lastDayOfMonth2(y, m));
     months.push({
       start: monthStart,
       end: monthEnd,
@@ -136937,14 +137216,14 @@ function previousCalendarQuarter(start, end) {
   const e = parseIsoDate(end);
   const quarterStartMonths = [1, 4, 7, 10];
   if (s.d !== 1 || !quarterStartMonths.includes(s.m)) return null;
-  if (e.m !== s.m + 2 || e.d !== lastDayOfMonth(e.y, e.m)) return null;
+  if (e.m !== s.m + 2 || e.d !== lastDayOfMonth2(e.y, e.m)) return null;
   const prevEndMonth = s.m - 1;
   const year = prevEndMonth < 1 ? s.y - 1 : s.y;
   const endM = prevEndMonth < 1 ? 12 : prevEndMonth;
   const startM = endM - 2;
   return {
     start: isoDate(year, startM, 1),
-    end: isoDate(year, endM, lastDayOfMonth(year, endM))
+    end: isoDate(year, endM, lastDayOfMonth2(year, endM))
   };
 }
 function yearOverYearRange(start, end) {
@@ -136957,13 +137236,23 @@ function yearOverYearRange(start, end) {
 }
 function shiftYear(p, delta) {
   const y = p.y + delta;
-  const last = lastDayOfMonth(y, p.m);
+  const last = lastDayOfMonth2(y, p.m);
   return isoDate(y, p.m, Math.min(p.d, last));
 }
 function utcToIso(ms) {
   const d = new Date(ms);
   return isoDate(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate());
 }
+function reportPeriodChrome(current, previous) {
+  const kind = classifyReportPeriod(current, previous);
+  if (kind.unit === "\u5B63\u5EA6") {
+    return { ...kind, reportTitle: "Google \u5B63\u5EA6\u7ECF\u8425\u62A5\u544A", coverEn: "QUARTERLY REPORT" };
+  }
+  if (kind.unit === "\u6708\u5EA6") {
+    return { ...kind, reportTitle: "Google \u6708\u5EA6\u7ECF\u8425\u62A5\u544A", coverEn: "MONTHLY REPORT" };
+  }
+  return { ...kind, reportTitle: "Google \u7ECF\u8425\u62A5\u544A", coverEn: "PERFORMANCE REPORT" };
+}
 function lastCompleteQuarter(now = /* @__PURE__ */ new Date()) {
   const parts = new Intl.DateTimeFormat("en-CA", {
     timeZone: "Asia/Shanghai",
@@ -136978,7 +137267,7 @@ function lastCompleteQuarter(now = /* @__PURE__ */ new Date()) {
   const year = m <= 3 ? y - 1 : y;
   return {
     start: isoDate(year, qStartMonth, 1),
-    end: isoDate(year, qEndMonth, lastDayOfMonth(year, qEndMonth))
+    end: isoDate(year, qEndMonth, lastDayOfMonth2(year, qEndMonth))
   };
 }
 
@@ -137851,17 +138140,28 @@ async function runGoogleQuarterlyRender(opts) {
   }
   const outPath = path31.resolve(opts.out ?? path31.join(path31.dirname(dataPath), GOOGLE_QUARTERLY_HTML_BASENAME));
   await fs26.mkdir(path31.dirname(outPath), { recursive: true });
-  const outHtml = injectQuarterlyReport(html, merged);
+  const periodChrome = reportPeriodChrome(readMetaRange(merged, "current"), readMetaRange(merged, "previous"));
+  const outHtml = injectQuarterlyReport(html, { ...merged, periodChrome });
   if (!outHtml.includes("homeCDN/echarts.min.js") || /new Chart\s*\(/.test(outHtml)) {
     console.error("\n\u274C \u6A21\u677F\u5FC5\u987B\u4F7F\u7528 ECharts\uFF0C\u7981\u6B62 Chart.js\u3002\n");
     process.exit(1);
   }
   await fs26.writeFile(outPath, outHtml, "utf8");
   console.log(`
-\u2705 Google \u5B63\u5EA6\u7ECF\u8425\u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+\u2705 ${periodChrome.reportTitle}\u5DF2\u751F\u6210\uFF1A${outPath}
 `);
   console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u5373\u53EF\u67E5\u770B\uFF08ECharts\uFF1Astaticpn.siluzan.com/homeCDN/echarts.min.js\uFF09\u3002\n");
 }
+function readMetaRange(payload, key) {
+  const meta = payload.meta;
+  if (!meta || typeof meta !== "object") return null;
+  const block = meta[key];
+  if (!block || typeof block !== "object") return null;
+  const start = block.start;
+  const end = block.end;
+  if (typeof start !== "string" || typeof end !== "string") return null;
+  return { start, end };
+}
 
 // src/commands/google-quarterly/register.ts
 function registerGoogleQuarterlyCommands(program2) {
@@ -138809,6 +139109,7 @@ function formatMetaPeriodReportErrors(result) {
 }
 
 // src/commands/facebook-analysis/render-report.ts
+init_report_period();
 var TEMPLATE_BASENAMES2 = {
   html: "meta-period-report.html"
 };
@@ -138858,7 +139159,7 @@ function asRecord27(value) {
   throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
 function injectReportData3(html, payload) {
-  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  const json = JSON.stringify(attachPeriodChrome(payload)).replace(/</g, "\\u003c");
   if (!html.includes(INJECT_MARKER2)) {
     throw new Error("\u62A5\u544A\u6A21\u677F\u7F3A\u5C11\u6570\u636E\u6CE8\u5165\u951A\u70B9\uFF0C\u8BF7\u66F4\u65B0 meta-period-report.html");
   }
@@ -138921,8 +139222,9 @@ async function runFacebookAnalysisRender(opts) {
     written.push(outPath);
   }
   const { stats } = contentCheck;
+  const cover = periodWord(attachPeriodChrome(data).periodChrome.unit, "\u5468\u671F");
   console.log(`
-\u2705 Meta/Facebook \u5468\u671F\u5206\u6790\u62A5\u544A\u5DF2\u751F\u6210\uFF1A${written.join(" \u3001 ")}
+\u2705 Meta/Facebook ${cover}\u5206\u6790\u62A5\u544A\u5DF2\u751F\u6210\uFF1A${written.join(" \u3001 ")}
 `);
   console.log(
     `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u5EFA\u8BAE ${stats.recommendationCount}\uFF5C\u56DB\u95EE ${stats.fourQuestionsCount}\uFF5C\u65E5 ${stats.dailyRows}\uFF5C\u56FD\u5BB6 ${stats.countryRows}\uFF5C\u7CFB\u5217 ${stats.campaignRows}\uFF5C\u53D7\u4F17 ${stats.audienceRows}
@@ -141417,6 +141719,7 @@ function formatBingPeriodReportErrors(result) {
 }
 
 // src/commands/bing-analysis/render-report.ts
+init_report_period();
 var TEMPLATE_BASENAME3 = "bing-period-report.html";
 var INJECT_MARKER4 = "window.__BING_PERIOD_REPORT__ = window.__BING_PERIOD_REPORT__ || null;";
 function resolveSkillTemplatePath6(basename13) {
@@ -141449,7 +141752,7 @@ function asRecord34(value) {
   throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
 function injectReportData5(html, payload) {
-  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  const json = JSON.stringify(attachPeriodChrome(payload)).replace(/</g, "\\u003c");
   if (!html.includes(INJECT_MARKER4)) {
     throw new Error("\u62A5\u544A\u6A21\u677F\u7F3A\u5C11\u6570\u636E\u6CE8\u5165\u951A\u70B9\uFF0C\u8BF7\u66F4\u65B0 bing-period-report.html");
   }
@@ -141492,8 +141795,9 @@ async function runBingAnalysisRender(opts) {
   await fsPromises5.mkdir(outDir, { recursive: true });
   await fsPromises5.writeFile(outPath, injectReportData5(html, data), "utf8");
   const { stats } = contentCheck;
+  const cover = periodWord(attachPeriodChrome(data).periodChrome.unit, "\u8D26\u6237");
   console.log(`
-\u2705 Bing \u5E7F\u544A\u8D26\u6237\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+\u2705 Bing \u5E7F\u544A${cover}\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\uFF5C9 \u4E2A\u5206\u6790\u5C0F\u8282\u5747\u5DF2\u9F50\u5168
@@ -142314,6 +142618,7 @@ function formatTikTokPeriodReportErrors(result) {
 }
 
 // src/commands/tiktok-analysis/render-report.ts
+init_report_period();
 var TEMPLATE_BASENAME4 = "tiktok-period-report.html";
 var INJECT_MARKER5 = "window.__TIKTOK_PERIOD_REPORT__ = window.__TIKTOK_PERIOD_REPORT__ || null;";
 function resolveSkillTemplatePath7(basename13) {
@@ -142346,7 +142651,7 @@ function asRecord37(value) {
   throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
 function injectReportData6(html, payload) {
-  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  const json = JSON.stringify(attachPeriodChrome(payload)).replace(/</g, "\\u003c");
   if (!html.includes(INJECT_MARKER5)) {
     throw new Error("\u62A5\u544A\u6A21\u677F\u7F3A\u5C11\u6570\u636E\u6CE8\u5165\u951A\u70B9\uFF0C\u8BF7\u66F4\u65B0 tiktok-period-report.html");
   }
@@ -142389,8 +142694,9 @@ async function runTikTokAnalysisRender(opts) {
   await fsPromises6.mkdir(outDir, { recursive: true });
   await fsPromises6.writeFile(outPath, injectReportData6(html, data), "utf8");
   const { stats } = contentCheck;
+  const cover = periodWord(attachPeriodChrome(data).periodChrome.unit, "\u8D26\u6237");
   console.log(`
-\u2705 TikTok \u5E7F\u544A\u4E3B\u8D26\u6237\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+\u2705 TikTok \u5E7F\u544A\u4E3B${cover}\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\uFF5C\u5206\u6790\u5C0F\u8282\u5DF2\u6309\u6709\u6570\u636E\u7684\u7EF4\u5EA6\u6821\u9A8C
@@ -144088,6 +144394,7 @@ function formatYandexPeriodReportErrors(result) {
 }
 
 // src/commands/yandex-analysis/render-report.ts
+init_report_period();
 var TEMPLATE_BASENAME5 = "yandex-period-report.html";
 var INJECT_MARKER6 = "window.__YANDEX_PERIOD_REPORT__ = window.__YANDEX_PERIOD_REPORT__ || null;";
 function resolveSkillTemplatePath8(basename13) {
@@ -144133,7 +144440,7 @@ function refreshWeeklyFromDaily(data) {
   };
 }
 function injectReportData7(html, payload) {
-  const json = JSON.stringify(payload).replace(/</g, "\\u003c");
+  const json = JSON.stringify(attachPeriodChrome(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");
   }
@@ -144175,8 +144482,9 @@ async function runYandexAnalysisRender(opts) {
   await fsPromises7.mkdir(outDir, { recursive: true });
   await fsPromises7.writeFile(outPath, injectReportData7(html, data), "utf8");
   const { stats } = contentCheck;
+  const cover = periodWord(attachPeriodChrome(data).periodChrome.unit, "\u8D26\u6237");
   console.log(`
-\u2705 Yandex \u5E7F\u544A\u8D26\u6237\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
+\u2705 Yandex \u5E7F\u544A${cover}\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
 `);
   console.log(
     `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u4F18\u5316\u5EFA\u8BAE ${stats.recommendationCount} \u6761\uFF5C8 \u4E2A\u5206\u6790\u7AE0\u8282\u5747\u5DF2\u9F50\u5168
@@ -144781,7 +145089,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/SKILL.md

@@ -46,6 +46,7 @@ siluzan-tso -h
 - **Google 广告类型边界**：CLI/Skill **仅支持** Google **搜索广告（Search）** 与 **Performance Max（PMax）** 的方案、创建与精细管理；**不支持展示广告（Display）**（含自适应展示广告 RDA、独立 Display 系列）。用户要做展示广告时须明确告知不支持，可改推 Search / PMax；**禁止**用 `campaign-create` / `ad-create` 伪装创建 Display。
 - **删系列 / 测试系列须先问（硬性）**：「尽快创建 / 按方案搭建」不含删除授权。创建失败（政策违规、名称占用、半成品）时**禁止**自行建测试系列逐地域排查、**禁止**自行 `ad campaign-delete`（含 Agent 自建系列）；先报告原因与选项，用户同意后才带 `--i-confirm --commit`。也**禁止**为让创建通过而整类删减方案内容（否词/排除地域/投放国家）：按 `batch get` 的 `failedOperations[]` 只改报错项。见 `google-ads-write.md`「创建失败时禁止的做法」。
 - **创建完成后交付（硬性）**：`ad batch diff` 的 stdout 含 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN`——**立刻**把中间全文原样发给用户（可先于补建）；禁止只摘要、禁止只说「创建成功/详情已交付/未发现缺失」、禁止等全部补建结束再交付。
+- **报告 render 成功即交付（硬性）**：`google-quarterly render`、`google-analysis render`、`google-ads-diagnosis render`、`website-diagnosis render`、`market-analysis render`，以及 Bing / TikTok / Yandex / Meta 的 `render`，stdout 给出 HTML 路径后**立刻**把该文件交给用户。P10 与各媒体周期报告封面的「季度 / 月度」已按日期写好（其余仍是「周期」或「账户」）。**禁止**再打开、grep 或修改这份 HTML，**禁止**为此再 render。用户没要 PDF 就不要 `html_to_pdf`；要了也只转一次，**禁止**再用 pdftotext、PyMuPDF、截图或视觉模型读 PDF/页面。细则见 `agent-conventions.md` §七。
 - `list-accounts` 无余额/消耗；列全部用 `--page-size 999`。查单户必须 `-k`；`itemCount < total` 时**禁止**判定账户未绑定。
 - 多户余额用 `balance-scan`（P2），多户消耗 / **转化成本·CPA 巡检**用 `accounts-digest`（P3，`--max-cpa`；**没有** `cpa-risk-scan`）。禁止外层 for-loop 逐户拉数。
 - `stats` 的 `spend` = **区间合计**，不是日消耗。
@@ -122,7 +123,7 @@ siluzan-tso -h
 | ------------------ | ------ | -------- |
 | Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |
 | Google 账户周期 **数据汇总**（只要花费/转化/9 章/Excel；**无**规划/客户版/大族） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |
-| Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md` + **`report-templates/google-quarterly-plan.md`**（**未带询盘表须先问并等待**，禁止不问就 collect；有表须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；规划九章；花费三档基于本期、不是已批预算；**不做**行业数据） |
+| Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md` + **`report-templates/google-quarterly-plan.md`**（**未带询盘表须先问并等待**，禁止不问就 collect；有表须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；规划九章；花费三档基于本期、不是已批预算；**不做**行业数据；**render 成功立刻交付 HTML**，禁止改 HTML / 转 PDF / 截图验收） |
 | Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |
 | TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |
 | Yandex 账户分析 / 周期 / 月报 | **P4** | `report-templates/yandex-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `yandex-period-report-excel.md` |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.56",
-  "publishedAt": 1792590212548
+  "version": "1.1.57-beta.2",
+  "publishedAt": 1792735232928
 }