siluzan-tso-cli 1.1.45-beta.3 → 1.1.45-beta.5

package/README.md

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

package/dist/index.js

@@ -134013,7 +134013,7 @@ var YANDEX_SECTIONS = [
   },
   {
     name: "daily",
-    description: "\u6309\u65E5\u7EE9\u6548\uFF08\u53EF\u4F9B\u8C03\u7528\u65B9\u81EA\u884C\u805A\u5468\uFF09",
+    description: "\u6309\u65E5\u7EE9\u6548\uFF1B\u843D\u76D8\u542B weekly[]\uFF08ISO \u5468\uFF09\uFF0C\u7981\u6B62\u81EA\u884C\u805A\u5468",
     path: "daily"
   },
   {
@@ -134061,7 +134061,7 @@ var YANDEX_SECTION_ALIASES = {
 
 // src/commands/yandex-analysis/run-batch.ts
 init_auth();
-import * as path43 from "path";
+import * as path44 from "path";
 import { performance as performance8 } from "perf_hooks";
 init_version();
 
@@ -134193,133 +134193,9 @@ function endpointHintForYandexSection(def) {
   return `GET \u2026/yandex-analysis/${def.path}?account=&start=&end=`;
 }
 
-// src/commands/yandex-analysis/resolve-sections.ts
-function normalizeSectionToken4(raw) {
-  const t = raw.trim();
-  if (!t) return null;
-  if (YANDEX_SECTION_NAMES.includes(t)) {
-    return t;
-  }
-  return YANDEX_SECTION_ALIASES[t] ?? null;
-}
-function resolveSectionList5(sections, exclude) {
-  const splitClean = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
-  const include = splitClean(sections);
-  const dropRaw = splitClean(exclude);
-  const unknown = [...include, ...dropRaw].filter((n) => normalizeSectionToken4(n) === null);
-  if (unknown.length > 0) {
-    console.error(
-      `
-\u274C \u672A\u77E5\u7684 section \u540D\u79F0\uFF1A${unknown.join(", ")}
-   \u53EF\u9009\uFF1A${YANDEX_SECTION_NAMES.join(", ")}
-   \u522B\u540D\uFF1A${Object.keys(YANDEX_SECTION_ALIASES).join(", ")}
-`
-    );
-    process.exit(1);
-  }
-  const includeCanonical = new Set(include.map((n) => normalizeSectionToken4(n)).filter(Boolean));
-  const dropCanonical = new Set(dropRaw.map((n) => normalizeSectionToken4(n)).filter(Boolean));
-  const base = include.length > 0 ? YANDEX_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...YANDEX_SECTIONS];
-  return base.filter((s) => !dropCanonical.has(s.name));
-}
-
-// src/commands/yandex-analysis/run-batch.ts
-async function runWithConcurrency6(tasks, concurrency) {
-  const results = new Array(tasks.length);
-  let cursor = 0;
-  const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
-    while (true) {
-      const i = cursor++;
-      if (i >= tasks.length) return;
-      results[i] = await tasks[i]();
-    }
-  });
-  await Promise.all(workers);
-  return results;
-}
-async function runAllYandexSections(opts) {
-  const id = assertYandexAccountId(opts.account);
-  const config = loadConfig(opts.token);
-  if (!opts.jsonOut?.trim()) {
-    console.error("\n\u274C \u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF08\u5404\u7EF4\u5EA6\u843D\u76D8\u540E\u7531 report-manifest \u7D22\u5F15\uFF09\u3002\n");
-    process.exit(1);
-  }
-  const targets = resolveSectionList5(opts.sections, opts.exclude);
-  if (targets.length === 0) {
-    console.error("\n\u274C \u6CA1\u6709\u8981\u6267\u884C\u7684 section\uFF08\u8BF7\u68C0\u67E5 --sections / --exclude\uFF09\u3002\n");
-    process.exit(1);
-  }
-  const { startDate, endDate } = resolveYandexDateRange(opts.start, opts.end);
-  const concurrency = Math.max(
-    1,
-    Math.min(typeof opts.concurrency === "number" ? opts.concurrency : 5, 16)
-  );
-  const cliVersion = getCurrentVersion2();
-  const overallT0 = performance8.now();
-  const tasks = targets.map((def) => async () => {
-    const t0 = performance8.now();
-    const hint = endpointHintForYandexSection(def);
-    try {
-      const payload = await fetchYandexSectionPayload(
-        def,
-        { ...opts, start: startDate, end: endDate },
-        config,
-        id
-      );
-      const summary2 = await writeReportAnalysisSnapshot({
-        snapshotDir: opts.jsonOut,
-        section: def.name,
-        accountId: id,
-        dateRange: { start: startDate, end: endDate },
-        payload,
-        cliVersion
-      });
-      return {
-        section: def.name,
-        ok: true,
-        elapsedMs: performance8.now() - t0,
-        file: summary2.writtenFiles[0],
-        endpointHint: hint
-      };
-    } catch (err) {
-      return {
-        section: def.name,
-        ok: false,
-        elapsedMs: performance8.now() - t0,
-        error: err instanceof Error ? err.message : String(err),
-        endpointHint: hint
-      };
-    }
-  });
-  const results = await runWithConcurrency6(tasks, concurrency);
-  const succeeded = results.filter((r) => r.ok).length;
-  const failed = results.length - succeeded;
-  const absoluteSnapshotDir = path43.resolve(opts.jsonOut);
-  const summary = {
-    kind: "siluzan-tso-yandex-analysis-snapshot-batch",
-    absoluteSnapshotDir,
-    manifestFile: reportManifestFile(id),
-    accountId: id,
-    totalSections: results.length,
-    succeeded,
-    failed,
-    concurrency,
-    elapsedMs: performance8.now() - overallT0,
-    results
-  };
-  console.log(JSON.stringify(summary));
-  if (failed > 0) process.exit(2);
-}
-
-// src/commands/yandex-analysis/render-report.ts
-import fs34 from "fs";
-import fsPromises7 from "fs/promises";
-import path45 from "path";
-import { fileURLToPath as fileURLToPath11 } from "url";
-
 // src/commands/yandex-analysis/merge-snapshot.ts
 import * as fs33 from "fs/promises";
-import * as path44 from "path";
+import * as path43 from "path";
 function asRecord26(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
@@ -134342,15 +134218,19 @@ function asItems(payload) {
   return items2.filter((r) => asRecord26(r) !== null);
 }
 function pickMetrics2(row, extras = []) {
+  const spend = num10(row.spend) ?? 0;
+  const impressions = num10(row.impressions) ?? 0;
+  const clicks = num10(row.clicks) ?? 0;
+  const conversions = num10(row.conversions) ?? 0;
   const out = {
-    spend: num10(row.spend) ?? 0,
-    impressions: num10(row.impressions) ?? 0,
-    clicks: num10(row.clicks) ?? 0,
-    ctr: num10(row.ctr),
-    averageCpc: num10(row.averageCpc),
-    conversions: num10(row.conversions) ?? 0,
-    conversionRate: num10(row.conversionRate),
-    costPerConversion: num10(row.costPerConversion),
+    spend,
+    impressions,
+    clicks,
+    conversions,
+    ctr: num10(row.ctr) ?? (impressions > 0 ? clicks / impressions : void 0),
+    averageCpc: num10(row.averageCpc) ?? (clicks > 0 ? round25(spend / clicks) : void 0),
+    conversionRate: num10(row.conversionRate) ?? (clicks > 0 ? conversions / clicks : void 0),
+    costPerConversion: num10(row.costPerConversion) ?? (conversions > 0 ? round25(spend / conversions) : void 0),
     roi: num10(row.roi)
   };
   for (const f of extras) {
@@ -134360,7 +134240,7 @@ function pickMetrics2(row, extras = []) {
 }
 async function loadSectionPayload3(snapshotDir, file) {
   try {
-    const raw = await fs33.readFile(path44.join(snapshotDir, file), "utf8");
+    const raw = await fs33.readFile(path43.join(snapshotDir, file), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -134380,7 +134260,7 @@ async function readManifest6(snapshotDir, accountId) {
   }
   for (const name2 of candidates) {
     try {
-      const raw = await fs33.readFile(path44.join(snapshotDir, name2), "utf8");
+      const raw = await fs33.readFile(path43.join(snapshotDir, name2), "utf8");
       const parsed = JSON.parse(raw);
       if (Array.isArray(parsed.artifacts) && parsed.artifacts.length > 0) return parsed;
     } catch {
@@ -134388,8 +134268,12 @@ async function readManifest6(snapshotDir, accountId) {
   }
   return null;
 }
+function normalizeYandexDailyDate(value) {
+  const m = /(\d{4}-\d{2}-\d{2})/.exec(String(value ?? "").trim());
+  return m?.[1] ?? "";
+}
 function parseYmd2(value) {
-  const s = String(value ?? "").trim().slice(0, 10);
+  const s = normalizeYandexDailyDate(value);
   const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(s);
   if (!m) return null;
   const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
@@ -134406,26 +134290,28 @@ function isoWeekKey(d) {
   const dow = (day.getDay() + 6) % 7;
   const weekStart = new Date(day);
   weekStart.setDate(weekStart.getDate() - dow);
+  const weekEnd = new Date(weekStart);
+  weekEnd.setDate(weekEnd.getDate() + 6);
   const thursday = new Date(weekStart);
   thursday.setDate(thursday.getDate() + 3);
   const yearStart = new Date(thursday.getFullYear(), 0, 1);
   const week = Math.floor((thursday.getTime() - yearStart.getTime()) / 864e5 / 7) + 1;
   const label = `W${String(week).padStart(2, "0")}`;
-  return { key: `${thursday.getFullYear()}-${label}`, label, weekStart };
+  return { key: `${thursday.getFullYear()}-${label}`, label, weekStart, weekEnd };
 }
 function aggregateDailyToWeekly(dailyRows) {
   const map = /* @__PURE__ */ new Map();
   for (const row of dailyRows) {
     const d = parseYmd2(row.date);
     if (!d) continue;
-    const { key, label, weekStart } = isoWeekKey(d);
+    const { key, label, weekStart, weekEnd } = isoWeekKey(d);
     let acc = map.get(key);
     if (!acc) {
       acc = {
         label,
         weekStart,
-        minDate: d,
-        maxDate: d,
+        weekEnd,
+        days: 0,
         spend: 0,
         impressions: 0,
         clicks: 0,
@@ -134433,20 +134319,21 @@ function aggregateDailyToWeekly(dailyRows) {
       };
       map.set(key, acc);
     }
-    if (d < acc.minDate) acc.minDate = d;
-    if (d > acc.maxDate) acc.maxDate = d;
+    acc.days += 1;
     acc.spend += num10(row.spend) ?? 0;
     acc.impressions += num10(row.impressions) ?? 0;
     acc.clicks += num10(row.clicks) ?? 0;
     acc.conversions += num10(row.conversions) ?? 0;
   }
   return [...map.values()].sort((a, b) => a.weekStart.getTime() - b.weekStart.getTime()).map((acc) => {
-    const days = Math.floor((acc.maxDate.getTime() - acc.minDate.getTime()) / 864e5) + 1;
+    const startDate = formatYmd2(acc.weekStart);
+    const endDate = formatYmd2(acc.weekEnd);
     return {
       weekLabel: acc.label,
-      startDate: formatYmd2(acc.minDate),
-      endDate: formatYmd2(acc.maxDate),
-      days,
+      isoWeek: acc.label,
+      startDate,
+      endDate,
+      days: acc.days,
       spend: round25(acc.spend),
       impressions: Math.round(acc.impressions),
       clicks: Math.round(acc.clicks),
@@ -134457,10 +134344,25 @@ function aggregateDailyToWeekly(dailyRows) {
     };
   });
 }
+function prepareYandexDailyPayload(payload) {
+  const obj = asRecord26(payload) ?? {};
+  const items2 = asItems(obj).map((r) => {
+    const date = normalizeYandexDailyDate(r.date);
+    return date ? { ...r, date } : r;
+  });
+  return { ...obj, items: items2, weekly: aggregateDailyToWeekly(items2) };
+}
+var YANDEX_DAILY_OUTLINE_HINTS = [
+  "// `items[].date` \u5DF2\u89C4\u8303\u4E3A YYYY-MM-DD\u3002\u63A5\u53E3\u53EF\u80FD\u8FD4\u56DE ISO \u65F6\u95F4\u6233\uFF08\u5982 2026-07-01T00:00:00+00:00\uFF09\uFF0CCLI \u5DF2\u622A\u65AD\uFF1B\u7981\u6B62\u518D\u62FC\u63A5 T00:00:00Z\uFF0C\u5426\u5219 new Date() \u4F1A Invalid Date\uFF0C\u5468\u6807\u7B7E\u53D8\u6210 NaN\u3002",
+  "// \u5468\u8D8B\u52BF\u8BFB\u672C\u6587\u4EF6 `weekly[]`\uFF08ISO \u5468\u4E00~\u5468\u65E5\uFF1B`days` \u4E3A\u6709\u6570\u636E\u7684\u5929\u6570\uFF09\u3002\u7981\u6B62\u81EA\u884C\u6309 date \u805A\u5468\u3002"
+];
+function buildYandexOutlineHints(section) {
+  if (section === "daily") return YANDEX_DAILY_OUTLINE_HINTS;
+  return void 0;
+}
 function mapDailyRows(payload) {
   return asItems(payload).map((r) => {
-    const dateRaw = r.date;
-    const date = typeof dateRaw === "string" ? dateRaw.slice(0, 10) : dateRaw != null ? String(dateRaw).slice(0, 10) : "";
+    const date = normalizeYandexDailyDate(r.date);
     return pickMetrics2({ ...r, date }, ["date"]);
   });
 }
@@ -134514,7 +134416,7 @@ function mapDeviceRows2(payload) {
   return asItems(payload).map((r) => pickMetrics2(r, ["device", "network"]));
 }
 async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
-  const absDir = path44.resolve(snapshotDir);
+  const absDir = path43.resolve(snapshotDir);
   const metaAccountId = typeof asRecord26(payload.meta)?.accountId === "string" ? asRecord26(payload.meta)?.accountId : void 0;
   const manifest = await readManifest6(snapshotDir, metaAccountId);
   if (!manifest) {
@@ -134591,6 +134493,132 @@ async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
   return { ...payload, meta, kpis, tables };
 }
 
+// src/commands/yandex-analysis/resolve-sections.ts
+function normalizeSectionToken4(raw) {
+  const t = raw.trim();
+  if (!t) return null;
+  if (YANDEX_SECTION_NAMES.includes(t)) {
+    return t;
+  }
+  return YANDEX_SECTION_ALIASES[t] ?? null;
+}
+function resolveSectionList5(sections, exclude) {
+  const splitClean = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const include = splitClean(sections);
+  const dropRaw = splitClean(exclude);
+  const unknown = [...include, ...dropRaw].filter((n) => normalizeSectionToken4(n) === null);
+  if (unknown.length > 0) {
+    console.error(
+      `
+\u274C \u672A\u77E5\u7684 section \u540D\u79F0\uFF1A${unknown.join(", ")}
+   \u53EF\u9009\uFF1A${YANDEX_SECTION_NAMES.join(", ")}
+   \u522B\u540D\uFF1A${Object.keys(YANDEX_SECTION_ALIASES).join(", ")}
+`
+    );
+    process.exit(1);
+  }
+  const includeCanonical = new Set(include.map((n) => normalizeSectionToken4(n)).filter(Boolean));
+  const dropCanonical = new Set(dropRaw.map((n) => normalizeSectionToken4(n)).filter(Boolean));
+  const base = include.length > 0 ? YANDEX_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...YANDEX_SECTIONS];
+  return base.filter((s) => !dropCanonical.has(s.name));
+}
+
+// src/commands/yandex-analysis/run-batch.ts
+async function runWithConcurrency6(tasks, concurrency) {
+  const results = new Array(tasks.length);
+  let cursor = 0;
+  const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
+    while (true) {
+      const i = cursor++;
+      if (i >= tasks.length) return;
+      results[i] = await tasks[i]();
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function runAllYandexSections(opts) {
+  const id = assertYandexAccountId(opts.account);
+  const config = loadConfig(opts.token);
+  if (!opts.jsonOut?.trim()) {
+    console.error("\n\u274C \u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF08\u5404\u7EF4\u5EA6\u843D\u76D8\u540E\u7531 report-manifest \u7D22\u5F15\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const targets = resolveSectionList5(opts.sections, opts.exclude);
+  if (targets.length === 0) {
+    console.error("\n\u274C \u6CA1\u6709\u8981\u6267\u884C\u7684 section\uFF08\u8BF7\u68C0\u67E5 --sections / --exclude\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const { startDate, endDate } = resolveYandexDateRange(opts.start, opts.end);
+  const concurrency = Math.max(
+    1,
+    Math.min(typeof opts.concurrency === "number" ? opts.concurrency : 5, 16)
+  );
+  const cliVersion = getCurrentVersion2();
+  const overallT0 = performance8.now();
+  const tasks = targets.map((def) => async () => {
+    const t0 = performance8.now();
+    const hint = endpointHintForYandexSection(def);
+    try {
+      const raw = await fetchYandexSectionPayload(
+        def,
+        { ...opts, start: startDate, end: endDate },
+        config,
+        id
+      );
+      const payload = def.name === "daily" ? prepareYandexDailyPayload(raw) : raw;
+      const summary2 = await writeReportAnalysisSnapshot({
+        snapshotDir: opts.jsonOut,
+        section: def.name,
+        accountId: id,
+        dateRange: { start: startDate, end: endDate },
+        payload,
+        cliVersion,
+        outlineExtraHints: buildYandexOutlineHints(def.name)
+      });
+      return {
+        section: def.name,
+        ok: true,
+        elapsedMs: performance8.now() - t0,
+        file: summary2.writtenFiles[0],
+        endpointHint: hint
+      };
+    } catch (err) {
+      return {
+        section: def.name,
+        ok: false,
+        elapsedMs: performance8.now() - t0,
+        error: err instanceof Error ? err.message : String(err),
+        endpointHint: hint
+      };
+    }
+  });
+  const results = await runWithConcurrency6(tasks, concurrency);
+  const succeeded = results.filter((r) => r.ok).length;
+  const failed = results.length - succeeded;
+  const absoluteSnapshotDir = path44.resolve(opts.jsonOut);
+  const summary = {
+    kind: "siluzan-tso-yandex-analysis-snapshot-batch",
+    absoluteSnapshotDir,
+    manifestFile: reportManifestFile(id),
+    accountId: id,
+    totalSections: results.length,
+    succeeded,
+    failed,
+    concurrency,
+    elapsedMs: performance8.now() - overallT0,
+    results
+  };
+  console.log(JSON.stringify(summary));
+  if (failed > 0) process.exit(2);
+}
+
+// src/commands/yandex-analysis/render-report.ts
+import fs34 from "fs";
+import fsPromises7 from "fs/promises";
+import path45 from "path";
+import { fileURLToPath as fileURLToPath11 } from "url";
+
 // src/commands/yandex-analysis/report-content.ts
 var SECTION_KEYS4 = [
   "overview",
@@ -134627,6 +134655,39 @@ function asRecord27(value) {
 function pushMissing6(missing, id, chapter, dimension, hint) {
   missing.push({ id, chapter, dimension, hint });
 }
+function normKey(value) {
+  return String(value ?? "").trim().toLowerCase();
+}
+function insightMatchRecord(item) {
+  const rec = asRecord27(item);
+  if (!rec) return {};
+  return asRecord27(rec.match) ?? rec;
+}
+function findRowInsight(list, primaryField, primaryValue, row) {
+  const target = normKey(primaryValue);
+  if (!target) return null;
+  const candidates = list.filter((it) => normKey(insightMatchRecord(it)[primaryField]) === target);
+  if (candidates.length <= 1) return asRecord27(candidates[0]);
+  const campaign = normKey(row.campaignName);
+  const narrowed = candidates.find(
+    (it) => normKey(insightMatchRecord(it).campaignName) === campaign
+  );
+  return asRecord27(narrowed ?? candidates[0]);
+}
+function topRowsBySpend(rows, limit) {
+  return rows.map((r) => asRecord27(r)).filter((r) => r != null).sort((a, b) => (Number(b.spend) || 0) - (Number(a.spend) || 0)).slice(0, limit);
+}
+var ROW_INSIGHT_SPECS = [
+  {
+    tableKey: "keywords",
+    insightKey: "keywords",
+    matchField: "keyword",
+    requiredField: "translation",
+    limit: 40,
+    chapter: "\u2463\u5173\u952E\u8BCD",
+    label: "\u4E2D\u6587\u7FFB\u8BD1"
+  }
+];
 function validateYandexPeriodReportContent(data) {
   const missing = [];
   const meta = asRecord27(data.meta) ?? {};
@@ -134697,6 +134758,51 @@ function validateYandexPeriodReportContent(data) {
       "\u81F3\u5C11\u4E00\u9879\u6709\u6548\u6570\u5B57\uFF08\u8BF7\u4F20 --snapshot-dir \u7531 CLI \u4ECE overview \u5408\u5E76\uFF09"
     );
   }
+  const tables = asRecord27(data.tables) ?? {};
+  const weeklyRows = asArray7(tables.weekly).map((r) => asRecord27(r)).filter((r) => r != null);
+  for (const [i, row] of weeklyRows.entries()) {
+    const label = `${row.weekLabel ?? ""} ${row.startDate ?? ""} ${row.endDate ?? ""}`;
+    if (/nan/i.test(label) || !normalizeYandexDailyDate(row.startDate) || !normalizeYandexDailyDate(row.endDate)) {
+      pushMissing6(
+        missing,
+        `tables-weekly-${i}`,
+        "\u2467\u65E5\u671F/\u5468\u62A5",
+        `tables.weekly[${i}]`,
+        "\u5468\u6807\u7B7E/\u8D77\u6B62\u65E5\u671F\u65E0\u6548\uFF08\u542B NaN \u6216\u975E YYYY-MM-DD\uFF09\u3002\u8BF7\u4F20 --snapshot-dir\uFF0C\u7531 CLI \u4ECE daily \u805A\u5408 weekly\uFF0C\u7981\u6B62\u81EA\u884C\u6309 date \u62FC T00:00:00Z \u805A\u5468\u3002"
+      );
+    }
+  }
+  const rowInsights = asRecord27(narrative.rowInsights) ?? {};
+  const rowInsightCoverage = {};
+  for (const spec of ROW_INSIGHT_SPECS) {
+    const shown = topRowsBySpend(asArray7(tables[spec.tableKey]), spec.limit).filter(
+      (row) => textLen7(row[spec.matchField])
+    );
+    const insights = asArray7(rowInsights[spec.insightKey]);
+    let covered = 0;
+    const uncovered = [];
+    for (const row of shown) {
+      const insight = findRowInsight(insights, spec.matchField, row[spec.matchField], row);
+      if (insight && textLen7(insight[spec.requiredField]) > 0) {
+        covered += 1;
+      } else {
+        uncovered.push(String(row[spec.matchField]));
+      }
+    }
+    rowInsightCoverage[spec.insightKey] = { shown: shown.length, covered };
+    if (shown.length === 0) continue;
+    if (covered < shown.length) {
+      const sample = uncovered.slice(0, 3).join("\u3001");
+      const more = uncovered.length > 3 ? ` \u7B49 ${uncovered.length} \u884C` : "";
+      pushMissing6(
+        missing,
+        `row-insights-${spec.insightKey}`,
+        spec.chapter,
+        `narrative.rowInsights.${spec.insightKey}.${spec.requiredField}`,
+        `HTML \u5C06\u5C55\u793A ${shown.length} \u884C\uFF0C\u6BCF\u884C\u987B\u6709${spec.label}\uFF08\u5F53\u524D ${covered}/${shown.length}\uFF09\u3002\u672A\u8986\u76D6\u793A\u4F8B\uFF1A${sample}${more}`
+      );
+    }
+  }
   return {
     ok: missing.length === 0,
     missing,
@@ -134704,7 +134810,8 @@ function validateYandexPeriodReportContent(data) {
       executiveSummaryCount: executiveSummary.length,
       recommendationCount: recommendations.length,
       sectionAnalysisCounts,
-      sectionSuggestionCounts
+      sectionSuggestionCounts,
+      rowInsightCoverage
     }
   };
 }
@@ -134715,7 +134822,7 @@ function formatYandexPeriodReportErrors(result) {
     `\u62A5\u544A JSON \u7F3A\u5C11 ${result.missing.length} \u9879\u5FC5\u542B\u5185\u5BB9\uFF08\u5BF9\u9F50 yandex-period-report.md\uFF09\uFF1A`,
     ...lines,
     "",
-    "\u8BF7\u8865\u5168 narrative.sections.<dimension>.{analysis,suggestions} \u4E0E narrative.recommendations \u540E\u91CD\u65B0\u6267\u884C render\u3002",
+    "\u8BF7\u8865\u5168 narrative.sections.<dimension>.{analysis,suggestions}\u3001narrative.recommendations\uFF0C\u4EE5\u53CA\u8868\u683C\u884C\u5BF9\u5E94\u7684 narrative.rowInsights\uFF08\u5173\u952E\u8BCD translation\uFF09\u540E\u91CD\u65B0\u6267\u884C render\u3002",
     "\u6570\u503C\u7C7B\u5B57\u6BB5\uFF08kpis/tables\uFF09\u987B\u7531 --snapshot-dir \u4ECE\u843D\u76D8 JSON \u5408\u5E76\uFF1BAgent \u53EA\u64B0\u5199\u53D9\u4E8B\uFF0C\u7981\u6B62\u624B\u5199 HTML\u3002"
   ].join("\n");
 }
@@ -134752,6 +134859,19 @@ function asRecord28(value) {
   }
   throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
+function refreshWeeklyFromDaily(data) {
+  const tables = data.tables;
+  if (!tables || typeof tables !== "object" || Array.isArray(tables)) return data;
+  const daily = Array.isArray(tables.daily) ? tables.daily : [];
+  if (daily.length === 0) return data;
+  return {
+    ...data,
+    tables: {
+      ...tables,
+      weekly: aggregateDailyToWeekly(daily)
+    }
+  };
+}
 function injectReportData7(html, payload) {
   const json = JSON.stringify(payload).replace(/</g, "\\u003c");
   if (!html.includes(INJECT_MARKER6)) {
@@ -134765,6 +134885,7 @@ async function runYandexAnalysisRender(opts) {
   if (opts.snapshotDir?.trim()) {
     data = await mergeYandexAnalysisSnapshotIntoReport(data, path45.resolve(opts.snapshotDir));
   }
+  data = refreshWeeklyFromDaily(data);
   const contentCheck = validateYandexPeriodReportContent(data);
   if (!contentCheck.ok) {
     console.error(`

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.45-beta.3",
-  "publishedAt": 1786677354676
+  "version": "1.1.45-beta.5",
+  "publishedAt": 1786693588914
 }

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

@@ -405,7 +405,7 @@ siluzan-tso yandex-analysis render \
   --out ./yandex-period-report.html
 ```
 
-`search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。无 Metrica / 写操作。报告模板：`report-templates/yandex-period-report.md`（8 个分析章节必写总结+建议；`tables.weekly` 由 daily 聚合）。
+`search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。无 Metrica / 写操作。报告模板：`report-templates/yandex-period-report.md`（8 个分析章节必写总结+建议；周趋势读落盘 `daily.weekly[]`，**禁止**自行按 `date` 聚周）。
 
 ---
 

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

@@ -35,7 +35,7 @@
 | --------------- | ------------------------- | ---------------------------- |
 | 账户总览        | `overview`                | 对象：`totals` / `balance` … |
 | 日报表          | `daily`                   | `items[]`                    |
-| 周报表          | （无）                    | 脚本按 ISO 周聚合 `daily`    |
+| 周报表          | `daily` 的 `weekly[]`     | **读落盘 weekly，禁止自行聚周** |
 | Search 网络     | `search`                  | `items[]`                    |
 | 广告系列        | `campaigns`               | `items[]`                    |
 | 关键词          | `keywords`                | `items[]`                    |
@@ -78,7 +78,7 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 | 地域     | `locationName` / `targetingLocationName`                                      |
 | 设备     | `device`                                                                      |
 | 日报     | `date`                                                                        |
-| 周报     | `weekLabel`、`startDate`、`endDate`、`days`（脚本生成）                       |
+| 周报     | `daily.weekly[]` 的 `weekLabel`、`startDate`、`endDate`、`days`（CLI 已算） |
 
 **账户总览 Sheet**：KPI 区（余额、本期消耗、日均、点击、CTR、CPC、转化）+ **全部叙事**（执行摘要、各维总结/建议、≥3 条跨维优化建议）写在本 Sheet；列表 Sheet 仅数据表。
 
@@ -89,7 +89,8 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 | ❌ 禁止                              | ✅ 正确                                              |
 | ------------------------------------ | ---------------------------------------------------- |
 | 把 `ctr` 当已是百分数再 ÷100         | 落盘为 0~1；Excel 用百分比格式或 `*100` 后加 `%`     |
-| 编造学习期 / 翻译字段                | API 无则叙事说明「数据不可用」                       |
+| 编造学习期、搜索词分类等无接口硬事实 | 无字段且算不出则不写该列；关键词翻译走 rowInsights   |
+| 自行按 `daily.date` 聚周（易出 `NaN-NaN-NaN`） | 读 `daily.weekly[]`；`date` 已是 YYYY-MM-DD，禁止再拼 `T00:00:00Z` |
 | `campaignId` 写成数字                | `String(id)` + 文本格式                              |
 | search-terms 拉超过 180 天           | 缩短区间或排除该维                                   |