npm - siluzan-tso-cli - Versions diffs - 1.1.25-beta.1 → 1.1.25-beta.3 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/README.md CHANGED Viewed

@@ -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.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js CHANGED Viewed

@@ -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 CHANGED Viewed

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

package/dist/skill/references/accounts/accounts.md CHANGED Viewed

@@ -257,7 +257,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                  |
 | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                              |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，打开 `{webUrl}/v3/foreign_trade/tso/recharge`） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                    |
 ---

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

@@ -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/accounts/finance.md CHANGED Viewed

@@ -105,36 +105,86 @@ siluzan-tso config show
 ### 功能总览
-| 功能                         | 引导用户打开的网页路径               | CLI 支持                                |
-| ---------------------------- | ------------------------------------ | --------------------------------------- |
-| 现金充值（单笔）             | `/recharge/pay`                      | ❌ 引导网页                             |
-| 现金充值（批量）             | `/recharge/pay_batch`                | ❌ 引导网页                             |
-| 月结充值                     | `/recharge/accountBillingQuota`      | ❌ 引导网页                             |
-| 丝路赞钱包（充值/提现/明细） | `/recharge/siluzanWallet`            | ❌ 引导网页                             |
-| 媒体转账记录                 | `/recharge/accountTransfer`          | ✅ `transfer` 命令                      |
-| 开票记录                     | `/recharge/invoiceList`              | ✅ `invoice list`                       |
-| 开票申请列表                 | `/recharge/invoicingApplicationList` | ✅ `invoice billable` / `invoice apply` |
+| 功能                         | 引导用户打开的网页路径                                                  | CLI 支持                                |
+| ---------------------------- | ----------------------------------------------------------------------- | --------------------------------------- |
+| 传统充值/现金充值（单笔，仅 Google/TikTok/Meta/Microsoft） | `/v3/foreign_trade/tso/recharge/pay?mediaType=<mediaType>`              | ❌ 引导网页                             |
+| 现金充值（批量，仅 Google/TikTok） | `/v3/foreign_trade/tso/recharge/pay_batch?mediaType=<Google|TikTok>`     | ❌ 引导网页                             |
+| 月结充值（仅 Google/TikTok/Meta/Microsoft） | `/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=<mediaType>` | ❌ 引导网页                             |
+| 丝路赞钱包（充值/提现/明细） | `/v3/foreign_trade/tso/recharge/siluzanWallet`                          | ❌ 引导网页                             |
+| 媒体转账记录                 | `/v3/foreign_trade/tso/recharge/accountTransfer`                        | ✅ `transfer` 命令                      |
+| 开票记录                     | `/v3/foreign_trade/tso/recharge/invoiceList`                            | ✅ `invoice list`                       |
+| 开票申请列表                 | `/v3/foreign_trade/tso/recharge/invoicingApplicationList`               | ✅ `invoice billable` / `invoice apply` |
+### 充值页媒体参数
+当用户指明媒体平台时，优先给出对应媒体的传统充值/现金充值直达页：
+| 媒体 | `mediaType` 参数 | 传统充值/现金充值链接 |
+| ---- | ---------------- | ------------ |
+| Google | `Google` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google` |
+| TikTok | `TikTok` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok` |
+| Meta / Facebook | `MetaAd` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd` |
+| Microsoft / Bing | `MicrosoftAd` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd` |
+> Yandex、Kwai 当前没有传统充值/现金充值界面；用户询问这些媒体充值时，不要拼接充值页链接，应说明当前网页不提供对应充值入口，并建议联系丝路赞客服或业务负责人确认处理方式。
+批量充值页面当前仅支持 Google 和 TikTok：
+| 媒体 | 批量充值链接 |
+| ---- | ------------ |
+| Google | `{webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google` |
+| TikTok | `{webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok` |
+> Meta、Microsoft/Bing、Yandex、Kwai 当前不要引导到批量充值页。
+月结充值页面当前仅支持 Google、TikTok、Meta 和 Microsoft/Bing：
+| 媒体 | 月结充值链接 |
+| ---- | ------------ |
+| Google | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google` |
+| TikTok | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok` |
+| Meta / Facebook | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd` |
+| Microsoft / Bing | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd` |
+> Yandex、Kwai 当前不要引导到月结充值页。
 ### 引导用户的标准话术
-当用户需要充值/查看钱包时，先取 `webUrl`，再给出完整链接：
+当用户需要充值/查看钱包时，先取 `webUrl`，再给出完整链接。用户已指定媒体时，优先给对应媒体的单笔充值链接；未指定媒体时，先询问媒体或给出下列通用入口：
 ```
 需要进行充值，请访问丝路赞平台对应页面完成操作：
-- 现金充值（单笔）：{webUrl}/recharge/pay
-- 现金充值（批量）：{webUrl}/recharge/pay_batch
-- 月结充值：        {webUrl}/recharge/accountBillingQuota
-- 丝路赞钱包：      {webUrl}/recharge/siluzanWallet
+- Google 充值：        {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+- TikTok 充值：        {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok
+- Meta 充值：          {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd
+- Microsoft/Bing 充值：{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd
+- Google 批量充值：   {webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google
+- TikTok 批量充值：   {webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok
+- Google 月结充值：   {webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google
+- TikTok 月结充值：   {webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok
+- Meta 月结充值：     {webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd
+- Microsoft/Bing 月结充值：{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd
+- 丝路赞钱包：         {webUrl}/v3/foreign_trade/tso/recharge/siluzanWallet
+Yandex、Kwai 当前没有传统充值/现金充值和月结充值界面，需联系丝路赞客服或业务负责人确认处理方式。
+批量充值当前仅支持 Google 和 TikTok；Meta、Microsoft/Bing、Yandex、Kwai 不要引导到批量充值页。
 ```
 **示例：**
 ```
-- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
-- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
-- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
-- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
+- Google 充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+- TikTok 充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok
+- Meta 充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd
+- Microsoft/Bing 充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd
+- Google 批量充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google
+- TikTok 批量充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok
+- Google 月结充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google
+- TikTok 月结充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok
+- Meta 月结充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd
+- Microsoft/Bing 月结充值：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd
+- 丝路赞钱包：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet
 ```
 ---

package/dist/skill/references/accounts/open-account-by-media.md CHANGED Viewed

@@ -282,7 +282,7 @@ siluzan-tso list-accounts -m MetaAd
 | 状态 | 含义 | 下一步 |
 | ---- | ---- | ------ |
 | 审核中 | 等待媒体审核 | 继续 `account-history` 轮询 |
-| 已通过 | 账户可用 | `list-accounts` 确认 + 网页充值 |
+| 已通过 | 账户可用 | `list-accounts` 确认 + 按 `finance.md` 打开对应媒体充值页（传统充值/月结充值仅 Google/TikTok/Meta/Microsoft 有页面；Kwai、Yandex 当前没有对应充值界面） |
 | 已拒绝 | 资料问题 | 查看拒绝原因，修正后重新提交 |
 完整参数：`siluzan-tso open-account <subcommand> -h`

package/dist/skill/references/accounts/open-account-google-ui.md CHANGED Viewed

@@ -60,7 +60,7 @@ siluzan-tso open-account google-wizard
 ```bash
 siluzan-tso account-history -m Google
-# 审核通过后：config show → {webUrl}/v3/foreign_trade/tso/recharge
+# 审核通过后：config show → {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 ---

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

@@ -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/core/workflows.md CHANGED Viewed

@@ -70,7 +70,7 @@ siluzan-tso account-history -m Google
 siluzan-tso list-accounts -m Google
 # 第四步：充值激活（必须网页完成）
-# siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge
+# siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 # 美元账户最低约 100 USD，人民币账户约 700 CNY
 ```
@@ -197,7 +197,7 @@ siluzan-tso account-history -m Google
 | 状态       | 含义     | 下一步                                                                                                                |
 | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复轮询                                                                                                      |
-| `Approved` | 审核通过 | `list-accounts` 确认账户出现；引导用户充值激活（见各媒体第四步）                                                      |
+| `Approved` | 审核通过 | `list-accounts` 确认账户出现；按 `accounts/finance.md` 引导用户打开对应媒体充值页（传统充值/月结充值仅 Google/TikTok/Meta/Microsoft 有页面；Kwai、Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看拒绝原因（`account-history --json-out ./snap` 的 `reason` 字段）；修改资料后重新提交；如无法确定原因，引导用户联系丝路赞客服 |
 ---

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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.3'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh CHANGED Viewed

@@ -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.3"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.25-beta.1",
+  "version": "1.1.25-beta.3",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",