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

package/README.md

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

package/dist/index.js

@@ -7241,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({
@@ -104656,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");
   }
@@ -104699,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
@@ -104716,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;";
   }
@@ -137077,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]);
@@ -137093,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) {
@@ -137104,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,
@@ -137139,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) {
@@ -137159,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",
@@ -137180,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))
   };
 }
 
@@ -138053,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) {
@@ -139011,6 +139109,7 @@ function formatMetaPeriodReportErrors(result) {
 }
 
 // src/commands/facebook-analysis/render-report.ts
+init_report_period();
 var TEMPLATE_BASENAMES2 = {
   html: "meta-period-report.html"
 };
@@ -139060,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");
   }
@@ -139123,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}
@@ -141619,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) {
@@ -141651,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");
   }
@@ -141694,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
@@ -142516,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) {
@@ -142548,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");
   }
@@ -142591,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
@@ -144290,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) {
@@ -144335,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");
   }
@@ -144377,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

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.57-beta.1",
-  "publishedAt": 1792724333584
+  "version": "1.1.57-beta.2",
+  "publishedAt": 1792735232928
 }

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

@@ -221,7 +221,9 @@
 
 ## 七、交付前自检（报告 / Excel / 含金额话术）
 
-> 在产物文件已写入磁盘**之后、发给用户之前**执行；不靠外部校验脚本，由 Agent **亲自 Read 最终产物文件**（HTML / Markdown 等；二进制 xlsx 无法 Read 时在对话贴自检表逐条勾选，依据为生成脚本的 stdout 摘要）。审阅阶段只看最终产物 + 已掌握的账户元数据，**不**回头 Read 落盘业务 JSON。
+> CLI `render` 写出的 HTML（P1、P4、P4-FB、P8、P9、P10，以及 Bing / TikTok / Yandex / Meta 周期或诊断）：命令成功并打印路径就是自检通过。**立刻交付该 HTML**。P10 与各媒体周期报告的「季度 / 月度」已按日期写进封面（对不上的周期报告仍写「周期」或「账户」），不要 Read、grep 或修改成品，不要为此再 render。用户没要 PDF 就不要转；要了也只转一次，不要用 pdftotext、PyMuPDF、截图或视觉模型读页面。下面 A/B/C 只用于 Agent 自己写的 Excel / Markdown。
+
+> 在 Agent 自写产物已写入磁盘**之后、发给用户之前**执行；不靠外部校验脚本，由 Agent **亲自 Read 最终产物文件**（Markdown 等；二进制 xlsx 无法 Read 时在对话贴自检表逐条勾选，依据为生成脚本的 stdout 摘要）。审阅阶段只看最终产物 + 已掌握的账户元数据，**不**回头 Read 落盘业务 JSON。
 
 **A · 币种**：首行含 `统计区间：…（货币：CNY|USD）`；全文符号与 `currencyCode` 一致（CNY=￥、USD=$，未混用）；与当次 `list-accounts -k` 结果相同；多账户分币种分表、无跨币种「总计」行。
 

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

@@ -82,7 +82,7 @@
   4. **门禁**：对每个 section Read `<section>-<accountId>_*.outline.txt` 后再写脚本。
   5. 脚本读盘写产物：默认 **HTML**（`report-template*.html` 版式参考）；用户要 **Excel** → Agent 脚本写 xlsx（**禁止**宿主第三方 xlsx Skill；**无** CLI excel 子命令）。
   6. 默认 HTML 报告须含：账户概览、投放趋势、Top 关键词/系列/地区/受众分布、优化建议；用户定制 Excel 以用户 Sheet 清单为准。
-- **产物**：按 conventions §七 自检；`accountId` 须与用户给的 `mediaCustomerId` 一致。
+- **产物**：按 conventions §七 自检；`accountId` 须与用户给的 `mediaCustomerId` 一致。HTML 封面按区间写成「季度」或「月度」，对不上则仍是「周期」。不要打开 HTML 改称呼。
 
 > 用户用「OKKI 周报」固定话术 → 改走 **P6**，不按默认 9 章追问。
 > 只要账户级按日 Excel（无多维章节）→ **P4-DAILY**。
@@ -207,4 +207,5 @@
   5. 读 `google-quarterly-collect.json`，只写 `narrative` 到 `google-quarterly.json`（禁止改 kpis / monthly / planDefaults 数字）。
   6. 下期规划按 `google-quarterly-plan.md` 写九章。预算默认三档（维持本期 / +30% / +50%）+ 建议档月度 30/35/35，标「基于历史数据」，不是已批预算；CPA/询盘不外推；禁止自动调价/暂停指令。
   7. `google-quarterly render --data ./snap-p10/google-quarterly.json --out ./snap-p10/google-quarterly-report.html`。
+  8. **render 成功即停并交付**该 HTML。封面称呼已按区间写好：完整自然季是「季度」，从 1 号起的同一个月（含未过完的本月）是「月度」，其余是「本期」。**禁止**打开或修改 HTML，**禁止**再把「季度 / 月度」改一遍，**禁止**再 render，**禁止**未要求就转 PDF、截图或用视觉模型验收。
 - **产物**：HTML 路径；新探索（视频 / PMax / 发现 / 展示）全无量则模板自动隐藏该章。

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

@@ -2,7 +2,7 @@
 
 > 统计区间：`{startDate}` ~ `{endDate}`（**不可包含今天或昨天**，见下文）  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）  
-> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`bing-period-report.html`）。  
+> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`bing-period-report.html`）。封面按日期写成「季度」或「月度」，对不上仍是「账户分析」。不要打开 HTML 改称呼。  
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止** Agent 手写/拼接 HTML（语法错误会导致报告无法显示）。  
 > **用户明确要求 Excel / xlsx** 时：拉数步骤不变，改为 Agent 脚本写 `.xlsx`；**不要**调用 `bing-analysis render`；禁止假设存在内置 excel 子命令。
 

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

@@ -52,7 +52,7 @@ siluzan-tso google-analysis render \
 
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
-`render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
+`render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。封面按 `meta.startDate/endDate` 写成「季度分析」或「月度分析」；不是完整自然季、也不是从 1 号起的同一个月时，仍写「周期分析」。不要打开 HTML 改这几个字。  
 传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/受众/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加。若 manifest 缺条目但磁盘上仍有对应 `*.json`，CLI 会按文件名自愈补齐。Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---

package/dist/skill/references/report-templates/google-quarterly-plan.md

@@ -5,6 +5,8 @@
 > 数据只消费 `google-quarterly-collect.json`（及用户明确给的业务约束）。**禁止**再算一遍账户诊断，**禁止**编造预算 / CPA / 询盘 / 市场数。
 >
 > 编号 Q01–Q30 是规划条，**不是** playbook P10。
+>
+> 正文称呼跟区间走，和封面同一套：完整自然季写「季度」；从 1 号起的同一个月写「月度 / 本月」，路线图写「本月 / 次月 / 再次月」。封面由 `render` 生成，写完不要再改 HTML。
 
 ## 范围
 

package/dist/skill/references/report-templates/google-quarterly-report.md

@@ -63,6 +63,8 @@ siluzan-tso google-quarterly render \
   --out ./snap-p10/google-quarterly-report.html
 ```
 
+`render` 打印 HTML 路径后**立刻交付该文件并结束**。封面和章节称呼由日期决定，不用改 HTML：完整自然季 →「Q3 季度…」；从 1 号起、起止在同一个月（含未过完的本月，如 10-01～10-22）→「10月 月度…」；跨月但不是完整自然季 →「本期」。**禁止**打开、grep 或改写 HTML，**禁止**为改「季度 / 月度」再跑一遍 render。用户没要 PDF 不要转换；要了也只转一次，不要读 PDF 正文、不要截图、不要用视觉模型验收。
+
 省略 `--start/--end` 时 collect 用上一完整自然季（上海日历）。
 
 可选：`--keyword-seeds "a,b"` 走 Keyword Planner（标注数据源，禁止写成行业指数）。**不做**频道订阅总数、订阅来源饼、视频类型（要 YouTube Analytics / 人工分类）。YouTube 广告能拿到的曝光 / TrueView / 完播 / CPV / 频道 ID /（若已关联）广告带来订阅，collect 写入 `exploreAds.types[video]` + `videosSummary`；PMax / 发现 / 展示并行写入 `exploreAds`。render 用 tab 切换，不编造 ABCD / 素材组 / 受众切分。

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

@@ -3,7 +3,7 @@
 > 统计区间：`{startDate}` ~ `{endDate}`  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
 
-> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`meta-period-report.html`）。  
+> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`meta-period-report.html`）。封面按日期写成「季度复盘」或「月度复盘」，对不上仍是「周期复盘」。不要打开 HTML 改称呼。  
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。  
 > 用户要 **表格 / Excel / xlsx** 时：步骤 1～3 相同，步骤 4 改 `--format xlsx`（见文末）。
 

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

@@ -5,7 +5,7 @@
 
 数据块：总览、系列/组/广告、视频素材、受众（含性别/年龄/兴趣合并）（**以 `--json-out` 实际字段为准**）。
 
-**默认交付：HTML（`tiktok-analysis render` 注入 Agent JSON 生成；禁止手写/拼接 HTML）**。用户指定 Excel 时 Agent 脚本写 xlsx。
+**默认交付：HTML（`tiktok-analysis render` 注入 Agent JSON 生成；禁止手写/拼接 HTML）**。用户指定 Excel 时 Agent 脚本写 xlsx。封面按日期写成「季度」或「月度」，对不上仍是「账户分析」。不要打开 HTML 改称呼。
 
 ---
 

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

@@ -2,7 +2,7 @@
 
 > 统计区间：`{startDate}` ~ `{endDate}`（**不能晚于今天**；省略默认近 7 天含今天）  
 > 账户：`{mediaCustomerId}`（如 `porg-xxx`，与 `list-accounts -m Yandex` 一致）  
-> **默认交付物**：一份可打开的 **HTML 文件**（`yandex-period-report.html`，样式对齐开发样例）。  
+> **默认交付物**：一份可打开的 **HTML 文件**（`yandex-period-report.html`，样式对齐开发样例）。封面按日期写成「季度」或「月度」，对不上仍是「账户分析」。不要打开 HTML 改称呼。  
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止** Agent 手写/拼接 HTML。  
 > **用户明确要求 Excel / xlsx** 时：拉数步骤不变，改为 Agent 脚本写 `.xlsx`；**不要**调用 `yandex-analysis render`；禁止假设存在内置 excel 子命令。见 `yandex-period-report-excel.md`。
 

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

@@ -609,6 +609,12 @@
       (function () {
         "use strict";
 
+        /** 只读 render 注入的 periodChrome，规则与 report-period.ts 相同。 */
+        function periodWord(data, neutral) {
+          const unit = data && data.periodChrome && data.periodChrome.unit;
+          return unit === "季度" || unit === "月度" ? unit : neutral;
+        }
+
         const PALETTE = [
           "#0ea5e9",
           "#6366f1",
@@ -772,7 +778,7 @@
             .join("");
           return `
 <div class="hero">
-  <div class="eyebrow">BING ADS · 账户分析报告</div>
+  <div class="eyebrow">BING ADS · ${periodWord(data, "账户")}分析报告</div>
   <h1>${escapeHtml(meta.accountName || "Bing 广告账户")}</h1>
   <div class="meta-chips">
     <span class="meta-chip">📅 <b>${escapeHtml(period)}</b></span>
@@ -1159,7 +1165,7 @@ ${titleNotice}
 
         function renderFooter(data) {
           const generatedAt = data.meta?.generatedAt || new Date().toISOString();
-          return `<div class="footer"><span class="brand">siluzan-tso</span> · Bing 广告账户分析报告 · ${escapeHtml(generatedAt)} · 数据来源 bing-analysis</div>`;
+          return `<div class="footer"><span class="brand">siluzan-tso</span> · Bing 广告${periodWord(data, "账户")}分析报告 · ${escapeHtml(generatedAt)} · 数据来源 bing-analysis</div>`;
         }
 
         function styleAxis(extra) {
@@ -1326,6 +1332,12 @@ ${titleNotice}
               '<div class="card">未找到报告数据（window.__BING_PERIOD_REPORT__ 为空），请通过 `bing-analysis render` 生成本文件。</div>';
             return;
           }
+          const cover = periodWord(data, "账户");
+          document.title =
+            (data.meta && data.meta.accountName ? data.meta.accountName + " · " : "") +
+            "Bing 广告" +
+            cover +
+            "分析报告";
           root.innerHTML = [
             renderHero(data),
             renderExecutiveSummary(data),

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

@@ -2,7 +2,7 @@
 
 > 统计区间：`{startDate}` ~ `{endDate}`（**不可包含今天或昨天**，见下文）  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）  
-> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`bing-period-report.html`）。  
+> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`bing-period-report.html`）。封面按日期写成「季度」或「月度」，对不上仍是「账户分析」。不要打开 HTML 改称呼。  
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止** Agent 手写/拼接 HTML（语法错误会导致报告无法显示）。  
 > **用户明确要求 Excel / xlsx** 时：拉数步骤不变，改为 Agent 脚本写 `.xlsx`；**不要**调用 `bing-analysis render`；禁止假设存在内置 excel 子命令。
 

package/dist/skill/report-templates/google-period-report.html

@@ -656,6 +656,12 @@
       (function () {
         "use strict";
 
+        /** 只读 render 注入的 periodChrome，规则与 report-period.ts 相同。 */
+        function periodWord(data, neutral) {
+          const unit = data && data.periodChrome && data.periodChrome.unit;
+          return unit === "季度" || unit === "月度" ? unit : neutral;
+        }
+
         const PALETTE = [
           "#3b82f6",
           "#8b5cf6",
@@ -785,7 +791,7 @@
             .join("");
           return `
 <div class="hero">
-  <div class="eyebrow">GOOGLE ADS · 周期分析报告</div>
+  <div class="eyebrow">GOOGLE ADS · ${periodWord(data, "周期")}分析报告</div>
   <h1>${escapeHtml(meta.accountName || "Google Ads 账户")}</h1>
   <div class="meta-chips">
     <span class="meta-chip">📅 <b>${escapeHtml(period)}</b></span>
@@ -1117,7 +1123,7 @@
 
         function renderFooter(data) {
           const generatedAt = data.meta?.generatedAt || new Date().toISOString();
-          return `<div class="footer"><span class="brand">siluzan-tso</span> · Google Ads 周期分析报告 · ${escapeHtml(generatedAt)} · 数据来源 google-analysis</div>`;
+          return `<div class="footer"><span class="brand">siluzan-tso</span> · Google Ads ${periodWord(data, "周期")}分析报告 · ${escapeHtml(generatedAt)} · 数据来源 google-analysis</div>`;
         }
 
         function styleAxis(extra) {
@@ -1375,6 +1381,12 @@
               '<div class="card">未找到报告数据（window.__GOOGLE_PERIOD_REPORT__ 为空），请通过 `google-analysis render` 生成本文件。</div>';
             return;
           }
+          const cover = periodWord(data, "周期");
+          document.title =
+            (data.meta && data.meta.accountName ? data.meta.accountName + " · " : "") +
+            "Google Ads " +
+            cover +
+            "分析报告";
           root.innerHTML = [
             renderHero(data),
             renderExecutiveSummary(data),

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

@@ -52,7 +52,7 @@ siluzan-tso google-analysis render \
 
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
-`render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
+`render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。封面按 `meta.startDate/endDate` 写成「季度分析」或「月度分析」；不是完整自然季、也不是从 1 号起的同一个月时，仍写「周期分析」。不要打开 HTML 改这几个字。  
 传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/受众/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加。若 manifest 缺条目但磁盘上仍有对应 `*.json`，CLI 会按文件名自愈补齐。Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---

package/dist/skill/report-templates/google-quarterly-plan.md

@@ -5,6 +5,8 @@
 > 数据只消费 `google-quarterly-collect.json`（及用户明确给的业务约束）。**禁止**再算一遍账户诊断，**禁止**编造预算 / CPA / 询盘 / 市场数。
 >
 > 编号 Q01–Q30 是规划条，**不是** playbook P10。
+>
+> 正文称呼跟区间走，和封面同一套：完整自然季写「季度」；从 1 号起的同一个月写「月度 / 本月」，路线图写「本月 / 次月 / 再次月」。封面由 `render` 生成，写完不要再改 HTML。
 
 ## 范围
 

package/dist/skill/report-templates/google-quarterly-report.html

@@ -593,14 +593,24 @@
         const adminLabel = meta.drillAdminLabel || "一级行政区";
         const drillTitle = drillCountry ? drillCountry + "下钻" : "消耗最高国家下钻";
         const showDrill = meta.usGeoSource === "subdivisions" && (data.usStates || []).length > 0;
-        document.title = name + " · Google 季度经营报告";
+        const chrome = data.periodChrome || {
+          current: quarterTag(meta.current) || "本期",
+          previous: quarterTag(meta.previous) || "上期",
+          next: nextQuarterTag(meta.current),
+          unit: "季度",
+          reportTitle: "Google 季度经营报告",
+          coverEn: "QUARTERLY REPORT",
+        };
+        const curQ = chrome.current || "本期";
+        const prevQ = chrome.previous || "上期";
+        const nextQ = chrome.next || "下期";
+        const unit = chrome.unit || "";
+        const periodHead = unit ? curQ + " " + unit : curQ;
+        document.title = name + " · " + (chrome.reportTitle || "Google 经营报告");
         document.getElementById("nav-brand").innerHTML = esc(name) + ' · <span>Google Ads</span>';
         document.getElementById("nav-explore").classList.toggle("hidden", hideSpecial);
 
         const exec = lines(narrative.executiveSummary);
-        const curQ = quarterTag(meta.current) || "本期";
-        const prevQ = quarterTag(meta.previous) || "上期";
-        const nextQ = nextQuarterTag(meta.current);
         const prev = kpis.previous || {};
         const vsYoy = kpis.vsYoy || {};
         const months = data.monthly || [];
@@ -631,9 +641,9 @@
         const root = document.getElementById("report-root");
         root.innerHTML = `
           <header class="cover" id="cover">
-            <div class="cover-tag">GOOGLE ADS · QUARTERLY REPORT</div>
+            <div class="cover-tag">GOOGLE ADS · ${esc(chrome.coverEn || "QUARTERLY REPORT")}</div>
             <h1>${esc(name)}</h1>
-            <p class="subtitle">${esc(curQ)} 季度数据汇总 &amp; ${esc(nextQ)} 规划</p>
+            <p class="subtitle">${esc(periodHead)}数据汇总 &amp; ${esc(nextQ)} 规划</p>
             <div class="cover-meta">
               <span>账户：<strong>${esc(meta.accountId || "—")}</strong></span>
               <span>渠道：<strong>${esc(channelsLabel)}</strong></span>
@@ -677,7 +687,7 @@
           </section>
           <section class="chapter" id="s1">
             <p class="num">PART 01</p>
-            <h2>${esc(curQ)} 季度数据表现</h2>
+            <h2>${esc(periodHead)}数据表现</h2>
             <p>先看效率是否变好，再看预算花在哪，最后看询盘从哪些国家来。</p>
           </section>
           <section class="page" id="efficiency">
@@ -1594,14 +1604,14 @@
       function planChapters(plan) {
         if (!plan || typeof plan !== "object") return analysisBlock(plan, "规划");
         const chapters = [
-          ["analysis", "季度投放结论"],
-          ["goals", "季度目标与 KPI"],
+          ["analysis", "投放结论"],
+          ["goals", "目标与 KPI"],
           ["budget", "预算与市场规划"],
           ["structure", "广告账户结构"],
           ["keywords", "关键词与搜索主题"],
           ["audience", "受众规划"],
           ["creative", "素材与落地页"],
-          ["roadmap", "季度执行路线图"],
+          ["roadmap", "执行路线图"],
           ["risks", "风险与待确认"],
         ];
         const parts = chapters.map(([key, title]) => {

package/dist/skill/report-templates/google-quarterly-report.md

@@ -63,6 +63,8 @@ siluzan-tso google-quarterly render \
   --out ./snap-p10/google-quarterly-report.html
 ```
 
+`render` 打印 HTML 路径后**立刻交付该文件并结束**。封面和章节称呼由日期决定，不用改 HTML：完整自然季 →「Q3 季度…」；从 1 号起、起止在同一个月（含未过完的本月，如 10-01～10-22）→「10月 月度…」；跨月但不是完整自然季 →「本期」。**禁止**打开、grep 或改写 HTML，**禁止**为改「季度 / 月度」再跑一遍 render。用户没要 PDF 不要转换；要了也只转一次，不要读 PDF 正文、不要截图、不要用视觉模型验收。
+
 省略 `--start/--end` 时 collect 用上一完整自然季（上海日历）。
 
 可选：`--keyword-seeds "a,b"` 走 Keyword Planner（标注数据源，禁止写成行业指数）。**不做**频道订阅总数、订阅来源饼、视频类型（要 YouTube Analytics / 人工分类）。YouTube 广告能拿到的曝光 / TrueView / 完播 / CPV / 频道 ID /（若已关联）广告带来订阅，collect 写入 `exploreAds.types[video]` + `videosSummary`；PMax / 发现 / 展示并行写入 `exploreAds`。render 用 tab 切换，不编造 ABCD / 素材组 / 受众切分。

package/dist/skill/report-templates/meta-period-report.html

@@ -126,7 +126,7 @@ table.data th,table.data td{white-space:nowrap;font-size:.8rem}
 </nav>
 <div class="wrap">
 <header class="hero">
-  <div class="hero-badge">Facebook Ads · 周期复盘</div>
+  <div class="hero-badge" id="heroBadge">Facebook Ads · 周期复盘</div>
   <h1 id="heroTitle">Meta / Facebook 广告投放分析报告</h1>
   <p class="sub" id="heroSub"></p>
 </header>
@@ -269,7 +269,11 @@ window.__META_PERIOD_REPORT__ = window.__META_PERIOD_REPORT__ || null;
   var brand = meta.accountName || meta.brandName || "Facebook 广告账户";
   var period = meta.periodLabel || ((meta.startDate || "") + " ~ " + (meta.endDate || ""));
   var campaign = meta.campaignName || "";
-  document.title = brand + " Facebook 广告报告" + (campaign ? " | " + campaign : "");
+  var coverUnit = data.periodChrome && data.periodChrome.unit;
+  var coverWord = coverUnit === "季度" || coverUnit === "月度" ? coverUnit : "周期";
+  document.title = brand + " · Facebook " + coverWord + "分析报告" + (campaign ? " | " + campaign : "");
+  var heroBadge = document.getElementById("heroBadge");
+  if (heroBadge) heroBadge.textContent = "Facebook Ads · " + coverWord + "复盘";
   document.getElementById("heroTitle").innerHTML = esc(brand) + " · Facebook 广告投放<br/>" + esc(period) + "分析报告";
   document.getElementById("heroSub").textContent =
     (campaign ? "广告系列：" + campaign + " ｜ " : "") +

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

@@ -3,7 +3,7 @@
 > 统计区间：`{startDate}` ~ `{endDate}`  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
 
-> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`meta-period-report.html`）。  
+> **默认交付物**：一份可打开的、带 ECharts 图表的 **HTML 文件**（`meta-period-report.html`）。封面按日期写成「季度复盘」或「月度复盘」，对不上仍是「周期复盘」。不要打开 HTML 改称呼。  
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。  
 > 用户要 **表格 / Excel / xlsx** 时：步骤 1～3 相同，步骤 4 改 `--format xlsx`（见文末）。
 

package/dist/skill/report-templates/tiktok-period-report.html

@@ -639,6 +639,12 @@
       (function () {
         "use strict";
 
+        /** 只读 render 注入的 periodChrome，规则与 report-period.ts 相同。 */
+        function periodWord(data, neutral) {
+          const unit = data && data.periodChrome && data.periodChrome.unit;
+          return unit === "季度" || unit === "月度" ? unit : neutral;
+        }
+
         const PALETTE = [
           "#fe2c55",
           "#25f4ee",
@@ -765,7 +771,7 @@
             .join("");
           return `
 <div class="hero">
-  <div class="eyebrow">TIKTOK ADS · 账户分析报告</div>
+  <div class="eyebrow">TIKTOK ADS · ${periodWord(data, "账户")}分析报告</div>
   <h1>${escapeHtml(meta.accountName || "TikTok 广告主账户")}</h1>
   <div class="meta-chips">
     <span class="meta-chip">📅 <b>${escapeHtml(period)}</b></span>
@@ -1031,7 +1037,7 @@
 
         function renderFooter(data) {
           const generatedAt = data.meta?.generatedAt || new Date().toISOString();
-          return `<div class="footer"><span class="brand">siluzan-tso</span> · TikTok 广告主账户分析报告 · ${escapeHtml(generatedAt)} · 数据来源 tiktok-analysis</div>`;
+          return `<div class="footer"><span class="brand">siluzan-tso</span> · TikTok 广告主${periodWord(data, "账户")}分析报告 · ${escapeHtml(generatedAt)} · 数据来源 tiktok-analysis</div>`;
         }
 
         function styleAxis(extra) {
@@ -1122,6 +1128,12 @@
               '<div class="card">未找到报告数据（window.__TIKTOK_PERIOD_REPORT__ 为空），请通过 `tiktok-analysis render` 生成本文件。</div>';
             return;
           }
+          const cover = periodWord(data, "账户");
+          document.title =
+            (data.meta && data.meta.accountName ? data.meta.accountName + " · " : "") +
+            "TikTok 广告主" +
+            cover +
+            "分析报告";
           root.innerHTML = [
             renderHero(data),
             renderExecutiveSummary(data),

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

@@ -5,7 +5,7 @@
 
 数据块：总览、系列/组/广告、视频素材、受众（含性别/年龄/兴趣合并）（**以 `--json-out` 实际字段为准**）。
 
-**默认交付：HTML（`tiktok-analysis render` 注入 Agent JSON 生成；禁止手写/拼接 HTML）**。用户指定 Excel 时 Agent 脚本写 xlsx。
+**默认交付：HTML（`tiktok-analysis render` 注入 Agent JSON 生成；禁止手写/拼接 HTML）**。用户指定 Excel 时 Agent 脚本写 xlsx。封面按日期写成「季度」或「月度」，对不上仍是「账户分析」。不要打开 HTML 改称呼。
 
 ---
 

package/dist/skill/report-templates/yandex-period-report.html

@@ -445,6 +445,12 @@
       (function () {
         "use strict";
 
+        /** 只读 render 注入的 periodChrome，规则与 report-period.ts 相同。 */
+        function periodWord(data, neutral) {
+          const unit = data && data.periodChrome && data.periodChrome.unit;
+          return unit === "季度" || unit === "月度" ? unit : neutral;
+        }
+
         const EMPTY_NOTE = "本节暂无数据";
 
         function escapeHtml(s) {
@@ -703,7 +709,9 @@
               " 数据报告";
           return (
             '<div class="wrap hero">' +
-            '<div class="eyebrow">YANDEX DIRECT · 账户分析报告</div>' +
+            '<div class="eyebrow">YANDEX DIRECT · ' +
+            periodWord(data, "账户") +
+            "分析报告</div>" +
             "<h1>" +
             escapeHtml(title) +
             "</h1>" +
@@ -1470,6 +1478,12 @@
               '<div class="wrap"><div class="panel empty-note">未找到报告数据（window.__YANDEX_PERIOD_REPORT__ 为空），请通过 `yandex-analysis render` 生成本文件。</div></div>';
             return;
           }
+          const cover = periodWord(data, "账户");
+          document.title =
+            (data.meta && data.meta.accountName ? data.meta.accountName + " · " : "") +
+            "Yandex 广告" +
+            cover +
+            "分析报告";
           root.innerHTML = renderAll(data);
           bindNav();
         });

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

@@ -2,7 +2,7 @@
 
 > 统计区间：`{startDate}` ~ `{endDate}`（**不能晚于今天**；省略默认近 7 天含今天）  
 > 账户：`{mediaCustomerId}`（如 `porg-xxx`，与 `list-accounts -m Yandex` 一致）  
-> **默认交付物**：一份可打开的 **HTML 文件**（`yandex-period-report.html`，样式对齐开发样例）。  
+> **默认交付物**：一份可打开的 **HTML 文件**（`yandex-period-report.html`，样式对齐开发样例）。封面按日期写成「季度」或「月度」，对不上仍是「账户分析」。不要打开 HTML 改称呼。  
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止** Agent 手写/拼接 HTML。  
 > **用户明确要求 Excel / xlsx** 时：拉数步骤不变，改为 Agent 脚本写 `.xlsx`；**不要**调用 `yandex-analysis render`；禁止假设存在内置 excel 子命令。见 `yandex-period-report-excel.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.57-beta.1'
+$PKG_VERSION = '1.1.57-beta.2'
 $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.57-beta.1"
+readonly PKG_VERSION="1.1.57-beta.2"
 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.57-beta.1",
+  "version": "1.1.57-beta.2",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",