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

package/README.md

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

package/dist/index.js

@@ -5544,6 +5544,32 @@ var init_daily_metrics_range = __esm({
   }
 });
 
+// src/utils/snapshot/async-lock.ts
+async function withAsyncLock(key, fn) {
+  const prev = chains.get(key) ?? Promise.resolve();
+  let release;
+  const gate = new Promise((resolve21) => {
+    release = resolve21;
+  });
+  chains.set(
+    key,
+    prev.catch(() => void 0).then(() => gate)
+  );
+  await prev.catch(() => void 0);
+  try {
+    return await fn();
+  } finally {
+    release();
+  }
+}
+var chains;
+var init_async_lock = __esm({
+  "src/utils/snapshot/async-lock.ts"() {
+    "use strict";
+    chains = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/commands/google-analysis/wrap-snapshot-envelope.ts
 function coerceToRowArray(value) {
   if (Array.isArray(value)) return value;
@@ -5766,26 +5792,29 @@ async function writeGoogleAnalysisSnapshot(params) {
   const outlineBody = formatOutlineFileBody(fileName, normalizedWrapped, outlineExtra);
   await fs7.writeFile(path11.join(absDir, outlineFileName), `${outlineBody}
 `, "utf8");
-  const existing = await readManifestIfExists(absDir, accountSlug || void 0);
   const newArtifact = {
     section: params.section,
     file: relativeFile,
     writtenAt,
     ...params.endpointHint !== void 0 ? { endpointHint: params.endpointHint } : {}
   };
-  const merged = mergeGoogleAnalysisManifest(existing, {
-    accountId: params.accountId,
-    dateRange: params.dateRange,
-    cliVersion: params.cliVersion,
-    newArtifact
-  });
   const manifestFile = googleAnalysisManifestFile(accountSlug || void 0);
-  await fs7.writeFile(
-    path11.join(absDir, manifestFile),
-    `${JSON.stringify(stringifyIdsDeep(merged), null, 2)}
+  const manifestPath = path11.join(absDir, manifestFile);
+  await withAsyncLock(manifestPath, async () => {
+    const existing = await readManifestIfExists(absDir, accountSlug || void 0);
+    const merged = mergeGoogleAnalysisManifest(existing, {
+      accountId: params.accountId,
+      dateRange: params.dateRange,
+      cliVersion: params.cliVersion,
+      newArtifact
+    });
+    await fs7.writeFile(
+      manifestPath,
+      `${JSON.stringify(stringifyIdsDeep(merged), null, 2)}
 `,
-    "utf8"
-  );
+      "utf8"
+    );
+  });
   return {
     kind: "siluzan-tso-google-analysis-snapshot",
     schemaVersion: SCHEMA_VERSION2,
@@ -5803,6 +5832,7 @@ var init_google_analysis = __esm({
     "use strict";
     init_cli_json();
     init_wrap_snapshot_envelope();
+    init_async_lock();
     init_dir();
     LEGACY_MANIFEST_FILE = "manifest.json";
     CLI_PACKAGE = "siluzan-tso-cli";
@@ -102288,6 +102318,56 @@ async function loadSectionFile(snapshotDir, file) {
     return null;
   }
 }
+function dateTagFromRange(dateRange) {
+  if (!dateRange || dateRange.mode !== "range") return void 0;
+  return `${dateRange.start.replace(/-/g, "")}-${dateRange.end.replace(/-/g, "")}`;
+}
+function dateTagFromMeta(meta) {
+  const start = typeof meta?.startDate === "string" ? meta.startDate : "";
+  const end = typeof meta?.endDate === "string" ? meta.endDate : "";
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(start) || !/^\d{4}-\d{2}-\d{2}$/.test(end)) return void 0;
+  return `${start.replace(/-/g, "")}-${end.replace(/-/g, "")}`;
+}
+function pickSectionSnapshotFile(files, section, accountId, preferredDateTag) {
+  const escapedSection = section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const escapedId = accountId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const re = new RegExp(`^${escapedSection}-${escapedId}(?:_(\\d{8}-\\d{8}))?\\.json$`);
+  const matches = files.filter((f) => re.test(f));
+  if (matches.length === 0) return null;
+  if (preferredDateTag) {
+    const preferred = matches.find((f) => f.endsWith(`_${preferredDateTag}.json`));
+    if (preferred) return preferred;
+  }
+  return [...matches].sort().at(-1) ?? null;
+}
+async function recoverMissingReportSections(sectionMap, absDir, accountId, preferredDateTag) {
+  if (!accountId) return;
+  let entries;
+  try {
+    entries = await fs20.readdir(absDir);
+  } catch {
+    return;
+  }
+  for (const section of REPORT_MERGE_SECTIONS) {
+    if (sectionMap.has(section)) continue;
+    const file = pickSectionSnapshotFile(entries, section, accountId, preferredDateTag);
+    if (!file) continue;
+    const data = await loadSectionFile(absDir, file);
+    if (data) sectionMap.set(section, data);
+  }
+}
+function periodMetricsFromRow(row) {
+  if (!row) return null;
+  return {
+    cost: num2(row.spend),
+    impressions: num2(row.impressions),
+    clicks: num2(row.clicks),
+    conversions: num2(row.conversions),
+    ctr: num2(row.ctr),
+    averageCpc: num2(row.averageCpc),
+    costPerConversion: num2(row.costPerConversion)
+  };
+}
 function items(envelope) {
   if (!envelope || !Array.isArray(envelope.items)) return [];
   return envelope.items.filter((row) => asRecord11(row) !== null);
@@ -102342,16 +102422,18 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
   if (!manifest) {
     throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C google-analysis --json-out`);
   }
+  const accountId = manifest.googleAnalysis?.accountId ?? metaAccountId;
+  const dateRange = manifest.googleAnalysis?.dateRange;
+  const preferredDateTag = dateTagFromRange(dateRange) ?? dateTagFromMeta(asRecord11(payload.meta) ?? void 0);
   const sectionMap = /* @__PURE__ */ new Map();
   for (const art of manifest.artifacts ?? []) {
     const data = await loadSectionFile(absDir, art.file);
     if (data) sectionMap.set(art.section, data);
   }
+  await recoverMissingReportSections(sectionMap, absDir, accountId, preferredDateTag);
   const overviewRecord = record(sectionMap.get("overview"));
   const currentPeriod = asRecord11(overviewRecord?.currentPeriod);
   const previousPeriod = asRecord11(overviewRecord?.previousPeriod);
-  const accountId = manifest.googleAnalysis?.accountId ?? metaAccountId;
-  const dateRange = manifest.googleAnalysis?.dateRange;
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountId && accountId) meta.accountId = accountId;
   if (!meta.currency) {
@@ -102363,16 +102445,9 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
   if (!meta.generatedAt) meta.generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const campaignRows2 = items(sectionMap.get("campaigns"));
   const campaignKpis = sumCampaignRowsToPeriodKpis(campaignRows2);
+  const dimensionSummaryRecord = record(sectionMap.get("dimension-summary"));
   const kpis = { ...payload.kpis ?? {} };
-  const currentKpiSource = campaignKpis ?? (currentPeriod ? {
-    cost: num2(currentPeriod.spend),
-    impressions: num2(currentPeriod.impressions),
-    clicks: num2(currentPeriod.clicks),
-    conversions: num2(currentPeriod.conversions),
-    ctr: num2(currentPeriod.ctr),
-    averageCpc: num2(currentPeriod.averageCpc),
-    costPerConversion: num2(currentPeriod.costPerConversion)
-  } : null);
+  const currentKpiSource = campaignKpis ?? periodMetricsFromRow(currentPeriod) ?? periodMetricsFromRow(dimensionSummaryRecord);
   if (currentKpiSource) {
     if (currentKpiSource.cost != null) kpis.cost = currentKpiSource.cost;
     if (currentKpiSource.impressions != null) kpis.impressions = currentKpiSource.impressions;
@@ -102411,22 +102486,21 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     }
   }
   const tables = { ...payload.tables ?? {} };
-  {
-    const summary = record(sectionMap.get("dimension-summary"));
-    if (summary) {
-      tables.dimensionSummary = {
-        cost: num2(summary.spend),
-        impressions: num2(summary.impressions),
-        clicks: num2(summary.clicks),
-        conversions: num2(summary.conversions),
-        ctr: num2(summary.ctr),
-        averageCpc: num2(summary.averageCpc),
-        costPerConversion: num2(summary.costPerConversion),
-        searchImpressionShare: num2(summary.searchImpressionShare),
-        searchBudgetLostImpressionShare: num2(summary.searchBudgetLostImpressionShare),
-        searchRankLostImpressionShare: num2(summary.searchRankLostImpressionShare)
-      };
-    }
+  if (dimensionSummaryRecord) {
+    tables.dimensionSummary = {
+      cost: num2(dimensionSummaryRecord.spend),
+      impressions: num2(dimensionSummaryRecord.impressions),
+      clicks: num2(dimensionSummaryRecord.clicks),
+      conversions: num2(dimensionSummaryRecord.conversions),
+      ctr: num2(dimensionSummaryRecord.ctr),
+      averageCpc: num2(dimensionSummaryRecord.averageCpc),
+      costPerConversion: num2(dimensionSummaryRecord.costPerConversion),
+      searchImpressionShare: num2(dimensionSummaryRecord.searchImpressionShare),
+      searchBudgetLostImpressionShare: num2(
+        dimensionSummaryRecord.searchBudgetLostImpressionShare
+      ),
+      searchRankLostImpressionShare: num2(dimensionSummaryRecord.searchRankLostImpressionShare)
+    };
   }
   if (campaignRows2.length > 0) {
     tables.campaigns = campaignRows2.map((r) => ({
@@ -102464,10 +102538,20 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     tables
   };
 }
+var REPORT_MERGE_SECTIONS;
 var init_merge_snapshot = __esm({
   "src/commands/google-analysis/merge-snapshot.ts"() {
     "use strict";
     init_google_analysis();
+    REPORT_MERGE_SECTIONS = [
+      "overview",
+      "daily-metrics",
+      "dimension-summary",
+      "campaigns",
+      "devices",
+      "geographic",
+      "keywords"
+    ];
   }
 });
 
@@ -102511,6 +102595,19 @@ function validateGooglePeriodReportContent(data) {
       "\u22651 \u6BB5\u6267\u884C\u6458\u8981\uFF0C\u6982\u8FF0\u672C\u671F\u6D88\u8017/\u8F6C\u5316/CTR/CPA \u8D70\u52BF"
     );
   }
+  const kpis = asRecord12(data.kpis);
+  const hasCoreKpi = ["cost", "impressions", "clicks"].some(
+    (key) => Number.isFinite(Number(kpis?.[key]))
+  );
+  if (!hasCoreKpi) {
+    pushMissing(
+      missing,
+      "kpis-core-metrics",
+      "\u6267\u884C\u6458\u8981 KPI",
+      "kpis.cost / kpis.impressions / kpis.clicks",
+      "\u81F3\u5C11\u4E00\u9879\u987B\u4E3A\u6709\u6548\u6570\u5B57\uFF1B\u8BF7\u52A0 --snapshot-dir \u4ECE google-analysis \u5FEB\u7167\u5408\u5E76\uFF08\u52FF\u624B\u586B HTML\uFF09"
+    );
+  }
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS) {
@@ -102571,7 +102668,7 @@ function formatGooglePeriodReportErrors(result) {
     ...lines,
     "",
     "\u8BF7\u8865\u5168 narrative.sections.<dimension>.{analysis,suggestions} \u4E0E narrative.recommendations \u540E\u91CD\u65B0\u6267\u884C render\u3002",
-    "\u6570\u503C\u7C7B\u5B57\u6BB5\uFF08kpis/charts/tables\uFF09\u53EF\u7701\u7565\uFF0C\u52A0 --snapshot-dir \u7531 CLI \u4ECE google-analysis \u5FEB\u7167\u81EA\u52A8\u5408\u5E76\uFF1BAgent \u53EA\u9700\u64B0\u5199\u53D9\u4E8B\u6587\u5B57\uFF0C\u7981\u6B62\u624B\u5199 HTML\u3002"
+    "kpis/charts/tables \u987B\u7531 --snapshot-dir \u4ECE google-analysis \u5FEB\u7167\u81EA\u52A8\u5408\u5E76\uFF08Agent \u53EA\u5199 narrative\uFF09\uFF1B\u5408\u5E76\u540E kpis \u4ECD\u4E3A\u7A7A\u65F6\u68C0\u67E5\u5FEB\u7167\u76EE\u5F55 manifest \u662F\u5426\u542B overview/campaigns/dimension-summary\u3002\u7981\u6B62\u624B\u5199 HTML\u3002"
   ].join("\n");
 }
 var SECTION_KEYS, SECTION_LABELS;
@@ -108342,6 +108439,7 @@ init_cli_table();
 init_cli_json_snapshot();
 
 // src/utils/snapshot/report-analysis.ts
+init_async_lock();
 init_google_analysis();
 init_cli_json();
 import * as fs8 from "fs/promises";
@@ -108415,25 +108513,24 @@ async function writeReportAnalysisSnapshot(params) {
 `,
     "utf8"
   );
-  const existing = await readReportManifestIfExists(absDir, accountSlug || void 0);
   const newArtifact = {
     section: params.section,
     file: fileName,
     writtenAt
   };
-  const merged = mergeReportAnalysisManifest(existing, {
-    accountId: params.accountId,
-    dateRange: params.dateRange,
-    cliVersion: params.cliVersion,
-    newArtifact
-  });
   const manifestFile = reportManifestFile(accountSlug || void 0);
-  await fs8.writeFile(
-    path12.join(absDir, manifestFile),
-    `${JSON.stringify(merged, null, 2)}
-`,
-    "utf8"
-  );
+  const manifestPath = path12.join(absDir, manifestFile);
+  await withAsyncLock(manifestPath, async () => {
+    const existing = await readReportManifestIfExists(absDir, accountSlug || void 0);
+    const merged = mergeReportAnalysisManifest(existing, {
+      accountId: params.accountId,
+      dateRange: params.dateRange,
+      cliVersion: params.cliVersion,
+      newArtifact
+    });
+    await fs8.writeFile(manifestPath, `${JSON.stringify(merged, null, 2)}
+`, "utf8");
+  });
   return {
     kind: "siluzan-tso-report-analysis-snapshot",
     schemaVersion: SCHEMA_VERSION3,

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.43-beta.1",
-  "publishedAt": 1785983688138
+  "version": "1.1.43-beta.2",
+  "publishedAt": 1785994362313
 }

package/dist/skill/assets/google-period-report.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "siluzan-tso/google-period-report.schema.json",
   "title": "GooglePeriodReport",
-  "description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 8 默认维度；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative 字段，kpis/charts/tables 可省略由 --snapshot-dir 从 google-analysis 落盘快照自动合并。",
+  "description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 8 默认维度；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative；kpis/charts/tables 由 --snapshot-dir 从 google-analysis 快照合并。render 校验要求合并后 kpis.cost/impressions/clicks 至少一项为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。",
   "type": "object",
   "required": ["meta", "narrative"],
   "properties": {
@@ -21,7 +21,7 @@
     },
     "kpis": {
       "type": "object",
-      "description": "账户级 KPI（执行摘要 KPI 网格）；可省略，由 --snapshot-dir 从 overview 合并",
+      "description": "账户级 KPI（执行摘要 KPI 网格）；Agent 可省略，但 render 时须经 --snapshot-dir 合并出 cost/impressions/clicks",
       "properties": {
         "cost": { "type": "number" },
         "impressions": { "type": "number" },

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

@@ -15,7 +15,7 @@
 | ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **1. 拉数**      | Agent 调 CLI | `google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google --sections <见下方默认维度对应 CLI>`                                                               |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察                                                                              |
-| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：仅 `meta` + `narrative`（8 维度叙事）为必填，`kpis`/`charts`/`tables` 可省略由 CLI 自动合并 |
+| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（8 维度叙事）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 会拒绝出 HTML） |
 | **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 8 维度必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                           |
 
 ```bash
@@ -33,7 +33,7 @@ siluzan-tso google-analysis render \
 `google-period-report.json` 顶层结构：
 
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
-- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；可省略。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率（规避 overview/stats 相对 Google API 延迟）；无 campaigns 快照时回退 `overview.currentPeriod`。环比仍来自 `overview.previousPeriod`。
+- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。环比仍来自 `overview.previousPeriod`。
 - `charts.dailyTrend`：每日趋势（`dates`/`cost`/`conversions`/`cpa`）；可省略由 `daily-metrics` 自动合并。
 - `tables.{dimensionSummary,campaigns,devices,geographic,keywords}`：对应 §3～§7 表格数据；可省略由同名 `google-analysis` section 自动合并。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
@@ -53,7 +53,7 @@ siluzan-tso google-analysis render \
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
 `render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加；Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加。若 manifest 缺条目但磁盘上仍有对应 `*.json`，CLI 会按文件名自愈补齐。Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---
 

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

@@ -15,7 +15,7 @@
 | ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **1. 拉数**      | Agent 调 CLI | `google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google --sections <见下方默认维度对应 CLI>`                                                               |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察                                                                              |
-| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：仅 `meta` + `narrative`（8 维度叙事）为必填，`kpis`/`charts`/`tables` 可省略由 CLI 自动合并 |
+| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（8 维度叙事）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 会拒绝出 HTML） |
 | **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 8 维度必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                           |
 
 ```bash
@@ -33,7 +33,7 @@ siluzan-tso google-analysis render \
 `google-period-report.json` 顶层结构：
 
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
-- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；可省略。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率（规避 overview/stats 相对 Google API 延迟）；无 campaigns 快照时回退 `overview.currentPeriod`。环比仍来自 `overview.previousPeriod`。
+- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。环比仍来自 `overview.previousPeriod`。
 - `charts.dailyTrend`：每日趋势（`dates`/`cost`/`conversions`/`cpa`）；可省略由 `daily-metrics` 自动合并。
 - `tables.{dimensionSummary,campaigns,devices,geographic,keywords}`：对应 §3～§7 表格数据；可省略由同名 `google-analysis` section 自动合并。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
@@ -53,7 +53,7 @@ siluzan-tso google-analysis render \
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
 `render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加；Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加。若 manifest 缺条目但磁盘上仍有对应 `*.json`，CLI 会按文件名自愈补齐。Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---
 

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