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

package/README.md

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

package/dist/index.js

@@ -4611,6 +4611,118 @@ var init_accounts_digest2 = __esm({
   }
 });
 
+// src/commands/google-analysis/wrap-snapshot-envelope.ts
+function coerceToRowArray(value) {
+  if (Array.isArray(value)) return value;
+  if (value === null || typeof value !== "object") return [];
+  const o = value;
+  const keys = Object.keys(o);
+  if (keys.length === 0) return [];
+  if (keys.every((k) => /^\d+$/.test(k))) {
+    return keys.sort((a, b) => Number(a) - Number(b)).map((k) => o[k]);
+  }
+  return [];
+}
+function asRecord(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function readGatewayList(bag) {
+  const items = coerceToRowArray(bag.data);
+  const meta = {};
+  if (typeof bag.code === "number") meta.code = bag.code;
+  if (typeof bag.message === "string") meta.message = bag.message;
+  return { items, ...Object.keys(meta).length > 0 ? { meta } : {} };
+}
+function flattenMaterials(payload) {
+  const bag = asRecord(payload);
+  if (!bag) return [];
+  const images = coerceToRowArray(bag.images).map(
+    (row) => asRecord(row) ? { ...row, assetType: "image" } : row
+  );
+  const videos = coerceToRowArray(bag.videos).map(
+    (row) => asRecord(row) ? { ...row, assetType: "video" } : row
+  );
+  return [...images, ...videos];
+}
+function wrapGoogleAnalysisSnapshotPayload(section, payload) {
+  let items = [];
+  let record = null;
+  let meta;
+  if (COMPOSITE_SECTIONS.has(section)) {
+    items = flattenMaterials(payload);
+  } else if (RECORD_ONLY_SECTIONS.has(section)) {
+    record = asRecord(payload);
+  } else if (GATEWAY_LIST_SECTIONS.has(section)) {
+    const bag = asRecord(payload);
+    if (bag) {
+      const r = readGatewayList(bag);
+      items = r.items;
+      meta = r.meta;
+    }
+  } else if (ROOT_ARRAY_SECTIONS.has(section)) {
+    items = coerceToRowArray(payload);
+  } else {
+    const rowKey = ROW_KEY_BY_SECTION[section];
+    const bag = asRecord(payload);
+    if (rowKey && bag) {
+      items = coerceToRowArray(bag[rowKey]);
+    } else {
+      const arr = coerceToRowArray(payload);
+      if (arr.length > 0) items = arr;
+      else record = asRecord(payload);
+    }
+  }
+  return {
+    schemaVersion: GOOGLE_ANALYSIS_FILE_SCHEMA_VERSION,
+    section,
+    itemCount: items.length,
+    items,
+    record,
+    ...meta !== void 0 ? { meta } : {}
+  };
+}
+var GOOGLE_ANALYSIS_FILE_SCHEMA_VERSION, ROW_KEY_BY_SECTION, RECORD_ONLY_SECTIONS, COMPOSITE_SECTIONS, ROOT_ARRAY_SECTIONS, GATEWAY_LIST_SECTIONS;
+var init_wrap_snapshot_envelope = __esm({
+  "src/commands/google-analysis/wrap-snapshot-envelope.ts"() {
+    "use strict";
+    GOOGLE_ANALYSIS_FILE_SCHEMA_VERSION = 3;
+    ROW_KEY_BY_SECTION = {
+      keywords: "keywords",
+      campaigns: "campaigns",
+      devices: "devices",
+      geographic: "countries",
+      "geo-matched": "countries",
+      "campaign-geo": "countries",
+      "campaign-geo-matched": "countries",
+      "campaign-device": "devices",
+      audience: "audience"
+    };
+    RECORD_ONLY_SECTIONS = /* @__PURE__ */ new Set([
+      "overview",
+      "resource-counts",
+      "dimension-summary",
+      "gold-account",
+      "final-urls",
+      "campaign-types",
+      "ads-index"
+    ]);
+    COMPOSITE_SECTIONS = /* @__PURE__ */ new Set(["materials"]);
+    ROOT_ARRAY_SECTIONS = /* @__PURE__ */ new Set([
+      "campaign-hour",
+      "extensions",
+      "asset-images",
+      "videos",
+      "daily-metrics",
+      "conversion-actions"
+    ]);
+    GATEWAY_LIST_SECTIONS = /* @__PURE__ */ new Set([
+      "search-terms",
+      "ads"
+    ]);
+  }
+});
+
 // src/utils/snapshot/google-analysis.ts
 import * as fs7 from "fs/promises";
 import * as path11 from "path";
@@ -4618,7 +4730,7 @@ function googleAnalysisManifestFile(accountId) {
   return `${applyIdSuffix("manifest", accountId)}.json`;
 }
 function buildOutlineHints(section) {
-  const hints = [];
+  const hints = [...GOOGLE_ANALYSIS_ENVELOPE_OUTLINE_HINTS];
   if (RATE_BEARING_SECTIONS.has(section)) {
     hints.push(...GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS);
   }
@@ -4656,7 +4768,8 @@ async function readManifestIfExists(absDir, accountId) {
     try {
       const raw = await fs7.readFile(manifestPath, "utf8");
       const parsed = JSON.parse(raw);
-      if (parsed?.schemaVersion !== SCHEMA_VERSION2 || !Array.isArray(parsed.artifacts)) {
+      const sv = parsed?.schemaVersion;
+      if (sv !== 2 && sv !== SCHEMA_VERSION2 || !Array.isArray(parsed.artifacts)) {
         continue;
       }
       return parsed;
@@ -4696,12 +4809,16 @@ async function writeGoogleAnalysisSnapshot(params) {
   );
   const relativeFile = fileName;
   const writtenAt = (/* @__PURE__ */ new Date()).toISOString();
-  const body = JSON.stringify(params.payload, null, 2);
+  const wrapped = wrapGoogleAnalysisSnapshotPayload(
+    params.section,
+    params.payload
+  );
+  const body = JSON.stringify(wrapped, null, 2);
   await fs7.writeFile(path11.join(absDir, fileName), `${body}
 `, "utf8");
   const outlineFileName = snapshotOutlineFileName(fileName);
   const outlineExtra = buildOutlineHints(params.section);
-  const outlineBody = formatOutlineFileBody(fileName, params.payload, outlineExtra);
+  const outlineBody = formatOutlineFileBody(fileName, wrapped, outlineExtra);
   await fs7.writeFile(path11.join(absDir, outlineFileName), `${outlineBody}
 `, "utf8");
   const existing = await readManifestIfExists(absDir, accountSlug || void 0);
@@ -4735,15 +4852,16 @@ async function writeGoogleAnalysisSnapshot(params) {
     agentHint: OUTLINE_AGENT_HINT
   };
 }
-var LEGACY_MANIFEST_FILE, CLI_PACKAGE2, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE2, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
+var LEGACY_MANIFEST_FILE, CLI_PACKAGE2, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE2, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ENVELOPE_OUTLINE_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
 var init_google_analysis = __esm({
   "src/utils/snapshot/google-analysis.ts"() {
     "use strict";
     init_cli_json();
+    init_wrap_snapshot_envelope();
     init_dir();
     LEGACY_MANIFEST_FILE = "manifest.json";
     CLI_PACKAGE2 = "siluzan-tso-cli";
-    SCHEMA_VERSION2 = 2;
+    SCHEMA_VERSION2 = 3;
     DEFAULT_FIELD_GUIDE2 = {
       markdownRefs: ["references/accounts/currency.md", "references/analytics/account-analytics.md"],
       tsTypesModule: "tso-cli/src/types/google-analysis-api.ts"
@@ -4782,6 +4900,10 @@ var init_google_analysis = __esm({
       "// \u6982\u7387\u5B57\u6BB5\uFF1A`ctr` / `conversionRate` \u81EA manifest schemaVersion 2\uFF082026-05\uFF09\u8D77\u5DF2\u7531 CLI \u7EDF\u4E00\u5F52\u4E00\u4E3A **0~1 \u5C0F\u6570**\uFF08\u5982 `0.0964` = 9.64%\uFF09\u3002",
       "// \u5199 Excel 0~1 \u5C0F\u6570\u5217\uFF1A\u76F4\u63A5\u5199\u5165\uFF1B\u5199\u300Cx%\u300D\u6587\u6848\uFF1A`(v * 100).toFixed(2) + '%'`\uFF1B**\u7981\u6B62**\u518D \xF7100\u3002`interactionRate` \u4ECD\u662F\u5B57\u7B26\u4E32 0~1 \u5C0F\u6570\uFF0C`parseFloat` \u540E\u4F7F\u7528\u3002"
     ];
+    GOOGLE_ANALYSIS_ENVELOPE_OUTLINE_HINTS = [
+      "// \u7EDF\u4E00\u8BBF\u95EE\u5C42\uFF08manifest / \u6587\u4EF6\u5185\u5747\u4E3A `schemaVersion: 3`\uFF09\uFF1A\u5224\u522B\u53EA\u6709\u4E00\u6761\u2014\u2014`record` \u975E null \u5373**\u6C47\u603B\u7EF4\u5EA6**\uFF08overview/resource-counts/gold-account/ads-index/dimension-summary/final-urls/campaign-types\uFF09\uFF0C\u8BFB `record`\uFF1B\u5426\u5219\u8BFB `items[]`\uFF08\u6240\u6709\u5217\u8868\u7EF4\u5EA6\uFF0C\u542B materials\uFF0C\u884C\u5DF2\u7EDF\u4E00\u642C\u5165\uFF0C`itemCount` = `items.length`\uFF09\u3002",
+      "// \u7EF4\u5EA6\u4E13\u5C5E\u539F\u952E\u540D\uFF08keywords/campaigns/countries/data \u7B49\uFF09\u5DF2**\u79FB\u9664**\uFF0C\u4E0D\u8981\u518D\u6309\u7EF4\u5EA6\u731C\u952E\u540D\uFF1B`search-terms`/`ads` \u7684\u7F51\u5173 `code`/`message` \u5728 `meta`\uFF08\u4E0E\u6570\u636E\u65E0\u5173\uFF09\uFF1Bmaterials \u884C\u5E26 `assetType: 'image'|'video'`\u3002"
+    ];
     GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION = {
       keywords: [
         "// \u4E2D\u6587\u8BD1\u540D\uFF1A`keywordMatchTypeZh`\uFF08\u7531 `keywordMatchType` \u7ECF match-type-en2zh.json \u7FFB\u8BD1\uFF0C\u8986\u76D6 BROAD/PHRASE/EXACT \u4E0E Broad/Phrase/Exact \u5927\u5C0F\u5199\uFF1B\u672A\u547D\u4E2D\u65F6\u8BE5\u5B57\u6BB5\u7F3A\u7701\uFF09\u3002"
@@ -102574,6 +102696,7 @@ var init_google_analysis2 = __esm({
     init_normalize_rates();
     init_normalize_impression_shares();
     init_translate_fields();
+    init_wrap_snapshot_envelope();
     init_register_cli();
   }
 });
@@ -112931,7 +113054,7 @@ init_cli_table();
 // src/commands/ad/campaign-batch-diff.ts
 init_auth();
 init_cli_json_snapshot();
-function asRecord(v) {
+function asRecord2(v) {
   return v && typeof v === "object" && !Array.isArray(v) ? v : null;
 }
 function pickString(...vals) {
@@ -112985,7 +113108,7 @@ function liveAdHasHeadline(ad, headline) {
 function formatExtensionPlanned(ext) {
   if (!ext) return "\u2014";
   const type = pickString(ext["typeV2"], ext["AssetFieldType"], ext["type"]);
-  const props = asRecord(ext["Properties"]);
+  const props = asRecord2(ext["Properties"]);
   const phone = props ? pickString(props["PhoneNumber"], props["phoneNumber"]) : "";
   const code = props ? pickString(props["ContryCode"], props["CountryCode"]) : "";
   const parts = [type ? `\u7C7B\u578B: ${type}` : "", code || phone ? `\u7535\u8BDD: ${code}${phone}` : ""].filter(Boolean);
@@ -112996,13 +113119,13 @@ function listPlannedKeywords(campaign) {
   if (!Array.isArray(groups)) return [];
   const out = [];
   for (let gi = 0; gi < groups.length; gi++) {
-    const g = asRecord(groups[gi]);
+    const g = asRecord2(groups[gi]);
     if (!g) continue;
     const groupName = pickString(g["Name"], g["name"]) || `AdGroupsForBatchJob[${gi}]`;
     const blocks = g["KeywordsForBatchJob"];
     if (!Array.isArray(blocks)) continue;
     for (let bi = 0; bi < blocks.length; bi++) {
-      const block = asRecord(blocks[bi]);
+      const block = asRecord2(blocks[bi]);
       if (!block) continue;
       const matchTypeV2 = pickString(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
       const texts = block["KeywordText"];
@@ -113026,7 +113149,7 @@ function listPlannedNegativeKeywords(campaign) {
   if (!Array.isArray(blocks)) return [];
   const out = [];
   for (let bi = 0; bi < blocks.length; bi++) {
-    const block = asRecord(blocks[bi]);
+    const block = asRecord2(blocks[bi]);
     if (!block) continue;
     const matchTypeV2 = pickString(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
     const texts = block["KeywordText"];
@@ -113066,7 +113189,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
   const plannedGroupCount = Array.isArray(groups) ? groups.length : 0;
   if (Array.isArray(groups)) {
     for (let gi = 0; gi < groups.length; gi++) {
-      const g = asRecord(groups[gi]);
+      const g = asRecord2(groups[gi]);
       if (!g) continue;
       const groupName = pickString(g["Name"], g["name"]) || `AdGroupsForBatchJob[${gi}]`;
       const groupPath = `campaign.AdGroupsForBatchJob[${gi}]`;
@@ -113097,7 +113220,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const blocks = g["KeywordsForBatchJob"];
       if (Array.isArray(blocks)) {
         for (let bi = 0; bi < blocks.length; bi++) {
-          const block = asRecord(blocks[bi]);
+          const block = asRecord2(blocks[bi]);
           if (!block) continue;
           const matchTypeV2 = pickString(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
           const texts = block["KeywordText"];
@@ -113126,7 +113249,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const ads = g["AdsForBatchJob"];
       if (Array.isArray(ads)) {
         for (let ai = 0; ai < ads.length; ai++) {
-          const ad = asRecord(ads[ai]);
+          const ad = asRecord2(ads[ai]);
           if (!ad) continue;
           const path24 = `${groupPath}.AdsForBatchJob[${ai}]`;
           const primary = pickString(ad["headlinePart1"], ad["AdTitle"]);
@@ -113182,7 +113305,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
   ).length;
   if (plannedExt > liveExt && Array.isArray(extBlocks)) {
     for (let ei = liveExt; ei < extBlocks.length; ei++) {
-      const ext = asRecord(extBlocks[ei]);
+      const ext = asRecord2(extBlocks[ei]);
       missing.push({
         layer: "extension",
         path: `campaign.ExtensionsForBatchJob[${ei}]`,
@@ -113210,7 +113333,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       plannedKeywords: plannedKeywords.length,
       liveKeywords: liveKwCount,
       plannedAds: Array.isArray(groups) ? groups.reduce((n, g) => {
-        const gr = asRecord(g);
+        const gr = asRecord2(g);
         const ads = gr?.["AdsForBatchJob"];
         return n + (Array.isArray(ads) ? ads.length : 0);
       }, 0) : 0,
@@ -113284,7 +113407,7 @@ async function fetchLiveSnapshotForCampaign(config, accountId, campaignId, campa
   };
 }
 function resolveCampaignIdFromBatch(record) {
-  const campaign = asRecord(record["campaign"]);
+  const campaign = asRecord2(record["campaign"]);
   return pickString(campaign?.["Id"], campaign?.["id"], record["campaignId"]);
 }
 function shellArgPath(p) {
@@ -121390,7 +121513,7 @@ function readJsonFile(filePath) {
     }
   });
 }
-function asRecord2(value) {
+function asRecord3(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -121416,10 +121539,10 @@ function injectReportData(html, payload) {
 async function runWebsiteDiagnosisRender(opts) {
   const dataPath = path17.resolve(opts.dataFile);
   const dataRaw = await readJsonFile(dataPath);
-  let data = asRecord2(dataRaw);
+  let data = asRecord3(dataRaw);
   if (opts.collectFile) {
     const collectRaw = await readJsonFile(path17.resolve(opts.collectFile));
-    data = mergeCollectLighthouse(data, asRecord2(collectRaw));
+    data = mergeCollectLighthouse(data, asRecord3(collectRaw));
   }
   const templatePath = websiteDiagnosisReportTemplatePath();
   let html;

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.25-beta.1",
-  "publishedAt": 1780455474013
+  "version": "1.1.25-beta.2",
+  "publishedAt": 1780469383389
 }

package/dist/skill/references/accounts/currency.md

@@ -34,7 +34,7 @@
 1. **`list-accounts`**（推荐第一步）：`items[].ma.currencyCode`；表格有 **「币种」** 列。
 2. **`balance` / `balance-scan` / `accounts-digest`**：`items[].currencyCode` 或行内已格式化的金额（含代码）。
 3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `accounts/accounts.md` 时效性说明）。
-4. **`google-analysis --sections overview`**：`overview-*.json` 根级或 `account.currencyCode`。
+4. **`google-analysis --sections overview`**：`overview-*.json` 的 `record.currencyCode`（汇总维度，`schemaVersion 3` 起整块在 `record`）。
 5. **`ad campaigns` / `ad groups`**：JSON 内 `currencyCode`（与账户主币种一致）。
 6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `accounts/finance.md`。
 

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

@@ -140,7 +140,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `keywords`               | 关键词；默认 `costGreater=0`（仅有消耗）、`limit=0`（不封顶）、`orderByCost=true`；可用 `--limit` 限制 Top N |
 | `search-terms`           | 搜索词；默认 `limit=0`（不封顶）、`orderByCost=true`；落盘前过滤 `spend>0`；含 `queryTargetingStatus` / `queryTargetingStatusZh`（已添加/已排除/都没有）；可用 `--limit` 限制 Top N |
 | `campaigns`              | 广告系列                                                                                            |
-| `campaign-hour`          | 系列按小时（根为 JSON 数组）                                                                        |
+| `campaign-hour`          | 系列按小时（行在 `items[]`）                                                                        |
 | `ads`                    | 广告；与 `ad list` 同源                                                                             |
 | `extensions`             | 附加信息；可选 `--level`                                                                            |
 | `devices`                | 设备分布（账户级 `DeviceSectionData`）                                                              |
@@ -152,7 +152,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `audience`           | 受众；可选 `--audience-type`                                                                        |
 | `asset-images`       | 图片素材                                                                                            |
 | `videos`             | 视频                                                                                                |
-| `materials`          | 合并图片+视频 `{ images, videos }`                                                                  |
+| `materials`          | 图片+视频拍平进 `items[]`，每行带 `assetType: 'image' \| 'video'`                                   |
 | `resource-counts`    | 结构统计                                                                                            |
 | `conversion-actions` | 转化动作                                                                                            |
 | `daily-metrics`      | 按日指标（主平台 `GET …/report/media-account/google/account-daily-reports`，`--json-out` 落盘为按日数组）。**广告诊断报告**中：金额/CPA **保留 2 位小数**，转化/点击/展示为整数；须配趋势**分析**段落（见 `google-ads-diagnosis.md`） |
@@ -162,6 +162,33 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `dimension-summary`  | 账户汇总                                                                                            |
 | `campaign-types`     | 系列类型（实时，可查当天；不传 `--start`/`--end`）                                                  |
 
+### 落盘 JSON
+
+| 字段 | 含义 |
+| ---- | ---- |
+| `schemaVersion` | 文件内固定 `3` |
+| `section` | 维度名（与文件名 stem 一致；仅标识，读数据用不到） |
+| `itemCount` | `items.length` |
+| `items` | **所有列表维度的行数据**统一入口（含 `materials`）；汇总维度为 `[]` |
+| `record` | **汇总维度**的整块对象；列表维度为 `null` |
+| `meta` | 仅 `search-terms` / `ads`：网关 `code`/`message`（与数据无关，可忽略） |
+
+**唯一判别规则**：`record` 非 `null` → 读 `record`（汇总维度）；否则 → 读 `items[]`（列表维度）。
+
+| 桶 | 维度 | 读法 |
+| -- | ---- | ---- |
+| **列表** | `keywords`、`search-terms`、`campaigns`、`campaign-hour`、`ads`、`extensions`、`devices`、`geographic`、`geo-matched`、`campaign-geo`、`campaign-geo-matched`、`campaign-device`、`audience`、`asset-images`、`videos`、`materials`、`daily-metrics`、`conversion-actions` | `d.items[]` |
+| **汇总** | `overview`、`resource-counts`、`dimension-summary`、`gold-account`、`ads-index`、`final-urls`、`campaign-types` | `d.record` |
+
+脚本示例（Node）—— 所有维度同一套读法：
+
+```javascript
+const d = require("./snap/campaigns-9526903813_20260401-20260430.json");
+const data = d.record ?? d.items; // record 非空=汇总维度；否则=列表行
+```
+
+旧快照（manifest `schemaVersion` 1/2，无 `items`/`record`）须按 `*.outline.txt` 最后一行类型读取。
+
 ### stdout 摘要
 
 ```json
@@ -196,24 +223,11 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | 平均点击成本 | `averageCpc`        |
 | 转化成本     | `costPerConversion` |
 
-### 中文化字段（En→Zh 字典补充）
-
-CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文字段保留**，便于排错；字典未命中时该字段缺省）：
-
-| 维度           | 源字段（英文）     | 新增字段（中文）     | 字典源                                                          |
-| -------------- | ------------------ | -------------------- | --------------------------------------------------------------- |
-| `keywords`     | `keywordMatchType` | `keywordMatchTypeZh` | `match-type-en2zh.json`（覆盖 `BROAD/PHRASE/EXACT` 大小写写法） |
-| `search-terms` | `matchType`        | `matchTypeZh`        | `match-type-en2zh.json`                                         |
-| `search-terms` | `queryTargetingStatus` | `queryTargetingStatusZh` | 网关 `Added`→已添加、`Excluded`→已排除、`None`→都没有（写 Excel「已添加/已排除」列用此字段） |
-| `campaign-geo`         | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`（覆盖 105 个国家/地区）                        |
-| `geo-matched`          | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`                                                |
-| `campaign-geo-matched` | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`                                                |
-
-写 Excel / 报表脚本可直接读 `keywordMatchTypeZh` / `matchTypeZh` / `countryOrRegionZh` 输出中文，**不要**自己维护字典或在线翻译。判断覆盖率用 `if (row.xxxZh)` 即可。
-
 ### CampaignSectionData 关键字段
 
-`campaigns[]` 每行额外包含：`conversionsValue`、`conversionsValuePerCost`（`spend ≤ 0` 时为 0）、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`、`manualCpcEnhancedCpcEnabled`、`percentCpcEnhancedCpcEnabled`。所有金额字段（`*Yuan` 后缀）已统一为元，可直接展示，无需换算。
+> `campaigns` 维度的系列行在 `items[]`（`schemaVersion 3` 起统一信封；本节下文的 `campaigns[]` 即指 `items[]`）。
+
+`items[]` 每行额外包含：`conversionsValue`、`conversionsValuePerCost`（`spend ≤ 0` 时为 0）、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`、`manualCpcEnhancedCpcEnabled`、`percentCpcEnhancedCpcEnabled`。所有金额字段（`*Yuan` 后缀）已统一为元，可直接展示，无需换算。
 
 日预算字段为 `budgetAmountYuan`（元），脚本可直接 `row.budgetAmountYuan`；网关原始 `budgetAmount`（分）已不再落盘。
 
@@ -239,11 +253,11 @@ CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文
 
 #### 行顶 legacy 份额（与 `competitiveMetrics` 同名 3 项）
 
-`campaigns[]` / `keywords[]` 行顶仍保留 `searchImpressionShare`、`searchBudgetLostImpressionShare`、`searchRankLostImpressionShare`。CLI 落盘前已统一为 **0~1 小数**（与 `competitiveMetrics` 同名项一致；有嵌套时以 `competitiveMetrics` 为准）。Top/AbsoluteTop/Content/ClickShare 等扩展项仅存在于 `competitiveMetrics`。展示为百分比：`(v * 100).toFixed(2) + '%'`。
+`campaigns` / `keywords` 维度的 `items[]` 行顶仍保留 `searchImpressionShare`、`searchBudgetLostImpressionShare`、`searchRankLostImpressionShare`。CLI 落盘前已统一为 **0~1 小数**（与 `competitiveMetrics` 同名项一致；有嵌套时以 `competitiveMetrics` 为准）。Top/AbsoluteTop/Content/ClickShare 等扩展项仅存在于 `competitiveMetrics`。展示为百分比：`(v * 100).toFixed(2) + '%'`。
 
 ### campaign-hour 字段
 
-`campaignId`、`campaignName`、`date`、`hour`、`spend`、`impressions`、`clicks`、`conversions`。根为 JSON 数组（非 `{ campaigns: … }` 包装）。
+`items[]` 每行：`campaignId`、`campaignName`、`date`、`hour`、`spend`、`impressions`、`clicks`、`conversions`（`schemaVersion 3` 起行统一在 `items[]`，不再是裸数组根）。
 
 ---
 

package/dist/skill/references/operations/hosted-automation-monitoring-json.md

@@ -71,7 +71,7 @@ mkdir -p ./snap-monitor && siluzan-tso google-analysis -a <mediaCustomerId> --se
 mkdir -p ./snap-monitor && siluzan-tso google-analysis -a <mediaCustomerId> --sections final-urls --json-out ./snap-monitor
 ```
 
-读 **`./snap-monitor/final-urls.json`**。根为 **对象**：**键名**为网关返回的资源标识（以当次 JSON 为准），**值为字符串数组**（每个元素是一条最终到达网址）。CLI **不**代发 HTTP 请求判断 4xx/5xx；死链判定须在宿主对 URL 执行 HEAD/GET（注意频率与 robots/合规）。
+读 **`./snap-monitor/final-urls.json`**。`final-urls` 为**汇总维度**，整块对象在 **`record`**（`schemaVersion 3` 起；`items` 为 `[]`）：`record` 的**键名**为网关返回的资源标识（以当次 JSON 为准），**值为字符串数组**（每个元素是一条最终到达网址）。CLI **不**代发 HTTP 请求判断 4xx/5xx；死链判定须在宿主对 URL 执行 HEAD/GET（注意频率与 robots/合规）。
 
 **按创意行拉数**（可与拒审、启停共用一轮数据）：
 

package/dist/skill/references/operations/hosted-automation-optimize-scale.md

@@ -18,7 +18,7 @@
 mkdir -p ./snap-scale && siluzan-tso google-analysis -a <mediaCustomerId> --sections campaigns --start <YYYY-MM-DD> --end <YYYY-MM-DD> --json-out ./snap-scale
 ```
 
-读 **`./snap-scale/campaigns-<accountId>.json`**（具体路径见 stdout 摘要的 `writtenFiles[0]` 或 `manifest-<accountId>.json` 的 `artifacts`）。根对象常见 **`campaigns[]`**，单行关注（键名以当次落盘 JSON 为准）：
+读 **`./snap-scale/campaigns-<accountId>.json`**（具体路径见 stdout 摘要的 `writtenFiles[0]` 或 `manifest-<accountId>.json` 的 `artifacts`）。系列行在 **`items[]`**（`schemaVersion 3` 统一信封），单行关注（键名以当次落盘 JSON 为准）：
 
 - **`conversionsValuePerCost`**（与 Google「转化价值/费用」语义一致，作 ROAS 代理）
 - **`searchBudgetLostImpressionShare`**、**`searchRankLostImpressionShare`**、**`searchImpressionShare`**
@@ -40,7 +40,7 @@ siluzan-tso ad campaigns -a <mediaCustomerId> --start <YYYY-MM-DD> --end <YYYY-M
 mkdir -p ./snap-scale && siluzan-tso google-analysis -a <mediaCustomerId> --sections campaign-hour --start <YYYY-MM-DD> --end <YYYY-MM-DD> --json-out ./snap-scale
 ```
 
-读 **`./snap-scale/campaign-hour.json`**。根为**数组**：**`campaignId`**、**`date`**、**`hour`**、**`spend`**。宿主可做「近若干小时花费 vs 预期」的辅助条件。
+读 **`./snap-scale/campaign-hour.json`**。行在 **`items[]`**：**`campaignId`**、**`date`**、**`hour`**、**`spend`**。宿主可做「近若干小时花费 vs 预期」的辅助条件。
 
 ### 4. 条件示例（仅示意）
 

package/dist/skill/references/operations/hosted-automation-self-control.md

@@ -125,7 +125,7 @@ siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主
 
 见 **`references/google-ads/google-ads.md`**「广告组编辑」。
 
-写前**必须**先 **`ad groups --json-out ./snap` / `ad campaigns --json-out ./snap`** 取当前值，**读取主币种金额**：组侧读 `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）；系列列表侧 `ad campaigns` 的 `budget` 也是元（与写参 `--budget` 一致）；`google-analysis campaigns-*.json` 的 `budgetAmountYuan` 同。在宿主内按主币种算新值（如下调 12%：`newYuan = round(oldYuan * 0.88 * 100) / 100`），再以主币种金额作为 `--target-cpa` / `--max-cpc` / `--budget` 传回。
+写前**必须**先 **`ad groups --json-out ./snap` / `ad campaigns --json-out ./snap`** 取当前值，**读取主币种金额**：组侧读 `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）；系列列表侧 `ad campaigns` 的 `budget` 也是元（与写参 `--budget` 一致）；`google-analysis campaigns-*.json` 的 `items[]` 行 `budgetAmountYuan` 同。在宿主内按主币种算新值（如下调 12%：`newYuan = round(oldYuan * 0.88 * 100) / 100`），再以主币种金额作为 `--target-cpa` / `--max-cpc` / `--budget` 传回。
 **严禁** 自己再做 `÷100` / `÷1_000_000` 换算——`*Yuan` 字段已经是元，再换算就是错的。
 
 ### 写后复核

package/dist/skill/report-templates/google-inquiry-analysis.md

@@ -89,7 +89,7 @@ for month in <S月, S+1月, E月>:
 **说明**：
 
 - **禁止**用 `daily-metrics` 填 Sheet 4 上区：该维度走 TSO 主平台 `account-daily-reports`，与 Google 前台 / Web 分析（`CampaignSectionData`）**不同数据源**，产品已确认存在不可接受偏差。
-- **Sheet 4 上区（账户月汇总）**：读 `./<YYYY-MM>/campaigns-*.json`，对 `campaigns[]` **全系列求和**得到当月账户级点击/展示/费用/转化，再算 CTR/CPC/CPA/CVR（公式见下文 Sheet 4）；与 Google「广告系列」页同区间加总口径一致。
+- **Sheet 4 上区（账户月汇总）**：读 `./<YYYY-MM>/campaigns-*.json`，对 `items[]`（`schemaVersion 3` 行统一在 `items`）**全系列求和**得到当月账户级点击/展示/费用/转化，再算 CTR/CPC/CPA/CVR（公式见下文 Sheet 4）；与 Google「广告系列」页同区间加总口径一致。
 - `./snap-inquiry/campaigns-<accountId>_<S>-<E>.json`（步骤 2，整段 S~E）：仅用于 **Sheet 5** 系列明细；**不得**用它按月拆行填 Sheet 4。
 - `geographic`：账户级国家聚合；Sheet 6 与 Sheet 4 **下区**（重点国切片）按月目录读取。
 - `keywords` / `search-terms`：Sheet 7 / 8；默认拉取**全部有消耗**行（`keywords` 网关 `costGreater=0`，`limit=0` 不封顶）；需 TOP N 时加 `--limit <n>`。
@@ -186,7 +186,7 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 ### 数值格式（强约束）
 
 - **金额、CPL / CPA / CPC / 平均费用**：保留 **2 位小数**，写明货币代码（如 `¥123.45 CNY`）。
-- **点击率 / 转化率 / 互动率**（`ctr` / `conversionRate` / `interactionRate`）：CLI 已归一为 **0~1 小数**（schemaVersion: 2），写入 Excel 时**直接写 0~1**（与运营样表对齐，Excel 单元格用百分比格式自动渲染）。话术 `x%` 用 `(v * 100).toFixed(2) + "%"`。
+- **点击率 / 转化率 / 互动率**（`ctr` / `conversionRate` / `interactionRate`）：CLI 已归一为 **0~1 小数**（schemaVersion ≥ 2），写入 Excel 时**直接写 0~1**（与运营样表对齐，Excel 单元格用百分比格式自动渲染）。话术 `x%` 用 `(v * 100).toFixed(2) + "%"`。
 - **空值**：`interactions === 0` 时「平均费用」「互动率」填 `—`，**禁止**除零。
 
 ### 分析输出区位置（**全局硬约束**）
@@ -317,14 +317,14 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 | 项 | 约定 |
 | --- | --- |
 | 数据源 | `./snap-inquiry/<YYYY-MM>/campaigns-<accountId>_<月1号>-<月末>.json`（每月单独拉 `campaigns`；见「落盘防覆盖」） |
-| 聚合范围 | 该月内 **全部** `campaigns[]` 行（含已暂停但在区间内有消耗的系列；**禁止**只取 Top N 或手工筛系列） |
+| 聚合范围 | 该月内 **全部** `items[]` 行（`schemaVersion 3` 行统一在 `items`；含已暂停但在区间内有消耗的系列；**禁止**只取 Top N 或手工筛系列） |
 | 数据口径 | `google-analysis campaigns` 与账户月表一致；账户月表 = 各系列在当月起止日内指标之和 |
 | 禁止 | `daily-metrics` / `stats` / `overview` 填上区投放列（询盘列仍来自 `inquiries.json`） |
 
 **脚本聚合（每月一份 `campaigns-*.json`）**：
 
 ```text
-rows = payload.campaigns ?? []
+rows = payload.items ?? []
 spend        = Σ rows[].spend
 clicks       = Σ rows[].clicks
 impressions  = Σ rows[].impressions
@@ -339,7 +339,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 
 `时间` 列写 `YYYY-MM` 或 `YYYY年M月`（与样表一致即可）。金额列用 `list-accounts` 的 `currencyCode`。
 
-**可选校验（不写入 Excel，仅日志）**：同月再拉 `overview`，对比 `currentPeriod.spend` 与系列 `spend` 之和；偏差 >1% 时在 Agent 交付说明中脚注差异，**仍以系列加总为准**。
+**可选校验（不写入 Excel，仅日志）**：同月再拉 `overview`，对比 `record.currentPeriod.spend`（汇总维度在 `record`）与系列 `spend` 之和；偏差 >1% 时在 Agent 交付说明中脚注差异，**仍以系列加总为准**。
 
 **上区**（B→L，跳过 A 列保持与运营样表一致）3 行月汇总：
 
@@ -347,7 +347,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | R1     | （A 列空）`汇总`                                                                                                                                                                                                                                                                                                                                     |
 | R2     | `时间` \| `点击次数` \| `展示次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` \| `询盘个数` \| `CPL`                                                                                                                                                                                                    |
-| R3..R5 | 倒序写 3 个月（**E 月在上**，S 月在下）：脚本读 `./<YYYY-MM>/campaigns-*.json` 按上表对 `campaigns[]` 全量求和；`询盘个数` = `inquiries.json` 按月 count；`CPL` = `费用 / 询盘个数`（询盘 0 填 `—`） |
+| R3..R5 | 倒序写 3 个月（**E 月在上**，S 月在下）：脚本读 `./<YYYY-MM>/campaigns-*.json` 按上表对 `items[]` 全量求和；`询盘个数` = `inquiries.json` 按月 count；`CPL` = `费用 / 询盘个数`（询盘 0 填 `—`） |
 
 **下区**（B→G）3 月 × **重点国家 / 非重点国** 切片（共 6 行）：
 
@@ -381,7 +381,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | R1               | `广告系列表现明细  ·  账户 <mediaCustomerId(带连字符)>  ·  <数据开始月>-<数据结束月>`                                                                                                                                                                                                                                                                                                                                    |
 | R2（A→M，13 列） | `系列名称` \| `系列ID` \| `策略` \| `开始日期` \| `消耗 (¥)` \| `展示` \| `点击` \| `CTR` \| `平均CPC` \| `转化` \| `CPA (¥)` \| `转化率` \| `消耗占比`                                                                                                                                                                                                                                                   |
-| R3…              | 读 `campaigns-*.json`：`campaignName` / `campaignId` / `biddingStrategyTypeV2`（中文化：`MAXIMIZE_CONVERSIONS` → `Max转化`、`TARGET_SPEND` → `目标支出`、`MANUAL_CPC` → `手动CPC` 等；未命中保留原文）/ `startDate` / `spend` / `impressions` / `clicks` / `ctr` / `averageCpc` / `conversions` / `costPerConversion` / `conversionRate` / **`消耗占比` = `spend` / `sum(spend)`**（脚本算，写 0~1 小数） |
+| R3…              | 读 `campaigns-*.json` 的 `items[]`：`campaignName` / `campaignId` / `biddingStrategyTypeV2`（中文化：`MAXIMIZE_CONVERSIONS` → `Max转化`、`TARGET_SPEND` → `目标支出`、`MANUAL_CPC` → `手动CPC` 等；未命中保留原文）/ `startDate` / `spend` / `impressions` / `clicks` / `ctr` / `averageCpc` / `conversions` / `costPerConversion` / `conversionRate` / **`消耗占比` = `spend` / `sum(spend)`**（脚本算，写 0~1 小数） |
 | 末行             | `合计`：A 列写 `合计`；金额、展示、点击、转化 求和；CTR/CVR/CPA 按合计反推（**禁止**对各行比率求平均）                                                                                                                                                                                                                                                                                                    |
 
 **下区**：
@@ -427,7 +427,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | R1               | `关键词表现  ·  账户 <id>  ·  <分析月份>`                                                                                                                                                                                              |
 | R2（A→J，10 列） | `关键词` \| `匹配方式` \| `系列` \| `消耗 (¥)` \| `展示` \| `点击` \| `CTR` \| `平均CPC` \| `转化` \| `CPA (¥)`                                                                                                                        |
-| R3…              | 读 `keywords-*.json`（`keywords[]`）：`keyword` / `keywordMatchTypeZh`（中文匹配方式：`Broad` / `Phrase` / `Exact`）/ `campaignName` / `spend` / `impressions` / `clicks` / `ctr` / `averageCpc` / `conversions` / `costPerConversion` |
+| R3…              | 读 `keywords-*.json` 的 `items[]`：`keyword` / `keywordMatchTypeZh`（中文匹配方式：`Broad` / `Phrase` / `Exact`）/ `campaignName` / `spend` / `impressions` / `clicks` / `ctr` / `averageCpc` / `conversions` / `costPerConversion` |
 
 按 `转化` 降序、`消耗` 降序双排序。
 

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

@@ -28,7 +28,7 @@
 
 | 维度          | CLI                                             | 备注                                                         |
 | ------------- | ----------------------------------------------- | ------------------------------------------------------------ |
-| 系列按小时    | `google-analysis --sections campaign-hour`      | `campaign-hour`；根为 JSON 数组，含 `date`/`hour`/消耗与效果 |
+| 系列按小时    | `google-analysis --sections campaign-hour`      | 行在 `items[]`，含 `date`/`hour`/消耗与效果 |
 | 受众分布      | `google-analysis --sections audience`           | 可分 `SystemDefined` / `UserDefined`                         |
 | 搜索词报告    | `google-analysis --sections search-terms`       | 高消耗搜索词；`queryTargetingStatusZh` 列（已添加/已排除/都没有） |
 | 广告创意表现  | `google-analysis --sections ads`                | 广告标题/类型/到达网址                                       |

package/dist/skill/report-templates/okki-weekly-google-client.md

@@ -79,7 +79,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 ### 点击率 / 转化率 / 互动率
 
-> **2026-05 起 CLI 已统一归一**（manifest `schemaVersion: 2`）：所有 `<section>-*.json` 中的 `ctr` / `conversionRate` 一律为 **0~1 小数**（如 `0.10` = 10.00%）。详见 `references/analytics/account-analytics.md`「指标字段对照」。
+> **2026-05 起 CLI 已统一归一**（manifest `schemaVersion ≥ 2`）：所有 `<section>-*.json` 中的 `ctr` / `conversionRate` 一律为 **0~1 小数**（如 `0.10` = 10.00%）。`schemaVersion 3` 起行数据统一在 `items[]`、汇总在 `record`。详见 `references/analytics/account-analytics.md`「指标字段对照」「落盘 JSON 统一信封」。
 
 | 场景                                              | 处理                                                                       |
 | ------------------------------------------------- | -------------------------------------------------------------------------- |
@@ -116,7 +116,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1               | `广告系列报告`（如运营改名，可改文案但 Sheet 名仍为 `账户报告`）                                                                                                                                                                                                                                                                                             |
 | R2               | 统计区间                                                                                                                                                                                                                                                                                                                                                     |
 | R3（A→K，11 列） | `广告系列` \| `预算` \| `费用` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `所有转化次数` \| `转化次数` \| `每次转化费用` \| `转化率`                                                                                                                                                                                                   |
-| R4…              | 来自 `campaigns-*.json`：`campaignName`、`budgetAmountYuan`（元）、`spend`、`impressions`、`clicks`、`ctr`（已归一直接写入「点击率」）、`averageCpc`、`allConversions`→「所有转化次数」、`conversions`→「转化次数」、`costPerConversion`、`conversionRate`（已归一直接写入「转化率」）；缺 `allConversions` 时与「转化次数」同值或填 `0` / `—`，并在脚注说明 |
+| R4…              | 来自 `campaigns-*.json` 的 `items[]`（`schemaVersion 3` 行统一在 `items`）：`campaignName`、`budgetAmountYuan`（元）、`spend`、`impressions`、`clicks`、`ctr`（已归一直接写入「点击率」）、`averageCpc`、`allConversions`→「所有转化次数」、`conversions`→「转化次数」、`costPerConversion`、`conversionRate`（已归一直接写入「转化率」）；缺 `allConversions` 时与「转化次数」同值或填 `0` / `—`，并在脚注说明 |
 | 末行「合计」     | **广告系列**列填 `总计`；**预算**列填 `--`；**展示 / 点击 / 所有转化次数 / 转化次数 / 费用** 做列求和；**点击率** = 合计点击 ÷ 合计展示；**转化率** = 合计转化 ÷ 合计点击（**禁止**用合计转化 ÷ 合计展示）；**每次转化费用** = 合计费用 ÷ 合计转化（转化为 0 时填 `—`）；禁止对各行比率取算术平均                                                            |
 
 表下**留白若干行**后写 **「数据复盘」**：
@@ -183,7 +183,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1               | `地理位置报告`                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | R2               | 统计区间                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | R3（A→M，13 列） | `地理位置` \| `广告系列` \| `展示次数` \| `互动次数` \| `互动率` \| `费用` \| `平均费用` \| `点击次数` \| `点击率` \| `所有转化次数` \| `转化次数` \| `每次转化费用` \| `转化率`                                                                                                                                                                                                                                                                            |
-| R4…              | `campaign-geo-matched-*.json`（`countries[]`）：`countryOrRegion`→地理位置；`campaignName`→「广告系列」；`allConversions`→「所有转化次数」；`conversions`→「转化次数」；**互动次数**→`interactions`；**互动率**→`interactionRate`（字符串须解析）或 `interactions/impressions`，`interactions` 为 0 时填 `—`；**平均费用 必须** = `spend / interactions`，`interactions` 为 0 / null / undefined 时填 `—`；`ctr` / `conversionRate` 直接写入；其余列按 outline 映射 |
+| R4…              | `campaign-geo-matched-*.json` 的 `items[]`（`schemaVersion 3` 行统一在 `items`）：`countryOrRegion`→地理位置；`campaignName`→「广告系列」；`allConversions`→「所有转化次数」；`conversions`→「转化次数」；**互动次数**→`interactions`；**互动率**→`interactionRate`（字符串须解析）或 `interactions/impressions`，`interactions` 为 0 时填 `—`；**平均费用 必须** = `spend / interactions`，`interactions` 为 0 / null / undefined 时填 `—`；`ctr` / `conversionRate` 直接写入；其余列按 outline 映射 |
 
 ---
 
@@ -207,7 +207,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 ```
 
 - **第 1 条「平均每天」**：`区间总消耗 / 区间日历天数`（含起止日），脚本计算，禁止手填。
-- **第 3 条**：CLI 返回的若是账户整体 CTR，写「整体点击率」而非「搜索点击率」；可区分时再写「搜索点击率」。`overview-*.json`（`schemaVersion: 2`）的 `ctr` 已是 0~1 小数（如 `0.10`），话术 `x%` 用 `(ctr * 100).toFixed(2) + "%"`，**禁止**直接打印数值得到 "0.10%"。
+- **第 3 条**：CLI 返回的若是账户整体 CTR，写「整体点击率」而非「搜索点击率」；可区分时再写「搜索点击率」。`overview-*.json`（汇总维度，`schemaVersion 3` 起整块在 `record`）的 `record.ctr` 已是 0~1 小数（如 `0.10`），话术 `x%` 用 `(ctr * 100).toFixed(2) + "%"`，**禁止**直接打印数值得到 "0.10%"。
 - **所有金额、百分比** 一律 **2 位小数**。
 
 ---

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