siluzan-tso-cli 1.1.19-beta.3 → 1.1.19-beta.4

package/README.md

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

package/dist/index.js

@@ -4738,10 +4738,23 @@ var init_sections = __esm({
       },
       {
         name: "geographic",
-        description: "\u56FD\u5BB6/\u5730\u533A\u5206\u6BB5 GeographicSectionData",
+        description: "\u56FD\u5BB6/\u5730\u533A\u5206\u6BB5 GeographicSectionData\uFF08\u8D26\u6237\u7EA7\u805A\u5408\uFF09",
         dateMode: "range",
         path: (id) => `/reporting/media-account/${id}/GeographicSectionData`
       },
+      {
+        name: "campaign-geo",
+        description: "\u5E7F\u544A\u7CFB\u5217\u7EF4\u5EA6\u5730\u7406 GET \u2026/campaigns/reports/geo\uFF08GetCampaignGeoReport\uFF1B\u884C\u53EF\u542B campaign/adGroup\uFF09",
+        dateMode: "range",
+        path: (id) => `/reporting/media-account/${id}/campaigns/reports/geo`,
+        campaignGeoFilterOption: true
+      },
+      {
+        name: "campaign-device",
+        description: "\u5E7F\u544A\u7CFB\u5217\u7EF4\u5EA6\u8BBE\u5907 GET \u2026/campaigns/reports/device\uFF08GetCampaignDeviceReport\uFF1B\u884C\u53EF\u542B campaign/adGroup\uFF09",
+        dateMode: "range",
+        path: (id) => `/reporting/media-account/${id}/campaigns/reports/device`
+      },
       {
         name: "audience",
         description: "\u53D7\u4F17\u5206\u6BB5 AdGroupAudienceData",
@@ -4885,6 +4898,10 @@ async function fetchGoogleAnalysisSectionJson(config, fullPath, verbose, name) {
       return fetchJson(config, fullPath, verbose);
     case "geographic":
       return fetchJson(config, fullPath, verbose);
+    case "campaign-geo":
+      return fetchJson(config, fullPath, verbose);
+    case "campaign-device":
+      return fetchJson(config, fullPath, verbose);
     case "audience":
       return fetchJson(config, fullPath, verbose);
     case "asset-images":
@@ -4935,6 +4952,12 @@ async function fetchSectionPayload(def, opts, config, id) {
   if (def.audienceFilterOption && opts.audienceType) {
     extras.audienceTypeFilter = opts.audienceType;
   }
+  if (def.campaignGeoFilterOption) {
+    const n = (x) => typeof x === "number" && Number.isFinite(x);
+    if (n(opts.costGreater)) extras.costGreater = opts.costGreater;
+    if (n(opts.clickGreater)) extras.clickGreater = opts.clickGreater;
+    if (n(opts.conversionsGreater)) extras.conversionsGreater = opts.conversionsGreater;
+  }
   if (def.name === "materials") {
     const { startDate, endDate } = resolveDateRange2(opts.start, opts.end);
     const q = `?${new URLSearchParams({ startDate, endDate }).toString()}`;
@@ -4986,7 +5009,10 @@ async function fetchOneGoogleSection(opts) {
       limit: opts.limit,
       noOrderByCost: opts.noOrderByCost,
       level: opts.level,
-      audienceType: opts.audienceType
+      audienceType: opts.audienceType,
+      costGreater: opts.costGreater,
+      clickGreater: opts.clickGreater,
+      conversionsGreater: opts.conversionsGreater
     },
     opts.config,
     opts.accountId
@@ -5594,7 +5620,10 @@ async function runBatch(opts) {
               section: task.section,
               start: opts.start,
               end: opts.end,
-              limit: opts.keywordLimit
+              limit: opts.keywordLimit,
+              costGreater: opts.campaignGeoCostGreater,
+              clickGreater: opts.campaignGeoClickGreater,
+              conversionsGreater: opts.campaignGeoConversionsGreater
             }),
             {
               label: `${task.section}/${task.accountId}`,
@@ -5715,6 +5744,9 @@ async function persistRunMetadata(input) {
     },
     minSpend: input.minSpend,
     keywordLimit: input.keywordLimit,
+    campaignGeoCostGreater: input.campaignGeoCostGreater,
+    campaignGeoClickGreater: input.campaignGeoClickGreater,
+    campaignGeoConversionsGreater: input.campaignGeoConversionsGreater,
     deadlineMs: input.deadlineMs,
     accountsTotal: input.accounts.length,
     invocation: input.invocation
@@ -5868,6 +5900,9 @@ function decideExitCode(state, tokenInvalidated) {
   if (state === "paused") return EXIT_PARTIAL;
   return EXIT_FAILED;
 }
+function finiteBatchOpt(n) {
+  return typeof n === "number" && Number.isFinite(n) ? n : void 0;
+}
 async function resolveBatchAccounts(config, opts) {
   if (opts.explicitAccountIds && opts.explicitAccountIds.length > 0) {
     const accounts2 = opts.explicitAccountIds.map((id) => ({
@@ -5963,6 +5998,9 @@ async function executeBatchRun(input) {
     start: input.start,
     end: input.end,
     keywordLimit: input.keywordLimit,
+    campaignGeoCostGreater: input.campaignGeoCostGreater,
+    campaignGeoClickGreater: input.campaignGeoClickGreater,
+    campaignGeoConversionsGreater: input.campaignGeoConversionsGreater,
     minSpend: input.minSpend,
     accountConcurrency: input.accountConcurrency,
     sectionConcurrency: input.sectionConcurrency,
@@ -6015,6 +6053,9 @@ async function executeBatchRun(input) {
       start: input.start,
       end: input.end,
       keywordLimit: input.keywordLimit,
+      campaignGeoCostGreater: input.campaignGeoCostGreater,
+      campaignGeoClickGreater: input.campaignGeoClickGreater,
+      campaignGeoConversionsGreater: input.campaignGeoConversionsGreater,
       accountConcurrency: input.accountConcurrency,
       sectionConcurrency: input.sectionConcurrency,
       retry: input.retry,
@@ -6089,6 +6130,9 @@ async function cmdRun(opts) {
     accountConcurrency,
     sectionConcurrency,
     keywordLimit: opts.keywordLimit,
+    campaignGeoCostGreater: finiteBatchOpt(opts.campaignGeoCostGreater),
+    campaignGeoClickGreater: finiteBatchOpt(opts.campaignGeoClickGreater),
+    campaignGeoConversionsGreater: finiteBatchOpt(opts.campaignGeoConversionsGreater),
     minSpend,
     deadlineMs,
     retry,
@@ -6161,6 +6205,9 @@ async function cmdResume(opts) {
     start: manifest.dateRange.start,
     end: manifest.dateRange.end,
     keywordLimit: manifest.keywordLimit,
+    campaignGeoCostGreater: finiteBatchOpt(manifest.campaignGeoCostGreater),
+    campaignGeoClickGreater: finiteBatchOpt(manifest.campaignGeoClickGreater),
+    campaignGeoConversionsGreater: finiteBatchOpt(manifest.campaignGeoConversionsGreater),
     accountConcurrency: manifest.concurrency.account,
     sectionConcurrency: manifest.concurrency.section,
     retry: { ...DEFAULT_RETRY_POLICY, ...manifest.retry },
@@ -6264,6 +6311,18 @@ function registerGoogleAnalysisBatchCommands(program2) {
     "--keyword-limit <n>",
     "\u900F\u4F20\u7ED9 keywords / search-terms \u7684\u6761\u6570\u4E0A\u9650\uFF08\u63A7\u5236\u5927\u8D26\u6237\u54CD\u5E94\u4F53\u79EF\uFF09",
     (v) => parseInt(v, 10)
+  ).option(
+    "--campaign-geo-cost-greater <n>",
+    "\u4EC5 campaign-geo\uFF1A\u7F51\u5173 costGreater \u8FC7\u6EE4\uFF08\u6574\u6570\uFF09",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--campaign-geo-click-greater <n>",
+    "\u4EC5 campaign-geo\uFF1A\u7F51\u5173 clickGreater \u8FC7\u6EE4\uFF08\u6574\u6570\uFF09",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--campaign-geo-conversions-greater <n>",
+    "\u4EC5 campaign-geo\uFF1A\u7F51\u5173 conversionsGreater \u8FC7\u6EE4\uFF08\u6574\u6570\uFF09",
+    (v) => parseInt(v, 10)
   ).option(
     "--min-spend <n>",
     "\u533A\u95F4\u5185\u6D88\u8017 \u2264 \u6B64\u503C\u7684\u8D26\u6237\u8DF3\u8FC7\uFF1B0=\u4E0D\u8FC7\u6EE4\uFF08\u4E0E --accounts \u540C\u4F20\u65F6\u65E0\u6548\uFF09",
@@ -6349,7 +6408,7 @@ async function runAllSections(opts) {
   }
   if (!opts.jsonOut || !opts.jsonOut.trim()) {
     console.error(
-      "\n\u274C all \u6A21\u5F0F\u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF0821 \u4E2A\u7EF4\u5EA6\u7ED3\u679C\u843D\u76D8\u540E\u7531 manifest \u7D22\u5F15\uFF09\u3002\n"
+      "\n\u274C all \u6A21\u5F0F\u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF0823 \u4E2A\u7EF4\u5EA6\u7ED3\u679C\u843D\u76D8\u540E\u7531 manifest \u7D22\u5F15\uFF09\u3002\n"
     );
     process.exit(1);
   }
@@ -6411,6 +6470,9 @@ async function runAllSections(opts) {
   console.log(JSON.stringify(summary));
   if (failed > 0) process.exit(2);
 }
+function finiteOpt(n) {
+  return typeof n === "number" && Number.isFinite(n) ? n : void 0;
+}
 function parseAccountIdsForAnalysis(input) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
@@ -6451,6 +6513,9 @@ async function runMultiAccountViaBatch(accountIds, opts) {
     accountConcurrency,
     sectionConcurrency: concurrency,
     keywordLimit: opts.limit,
+    campaignGeoCostGreater: finiteOpt(opts.costGreater),
+    campaignGeoClickGreater: finiteOpt(opts.clickGreater),
+    campaignGeoConversionsGreater: finiteOpt(opts.conversionsGreater),
     minSpend: 0,
     retry: DEFAULT_RETRY_POLICY,
     token: opts.token,
@@ -6500,7 +6565,7 @@ function registerGoogleAnalysisCommands(program2) {
     "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08range \u7C7B\u7EF4\u5EA6\u751F\u6548\uFF1B\u7701\u7565=\u8FD1 7 \u5929\u622A\u81F3\u6628\u5929\uFF1B\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\uFF09"
   ).option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option(
     "--sections <list>",
-    "\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,keywords,ads\uFF1B\u7701\u7565=\u5168\u90E8 21 \u4E2A"
+    "\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,keywords,ads\uFF1B\u7701\u7565=\u5168\u90E8 23 \u4E2A"
   ).option(
     "--exclude <list>",
     "\u6392\u9664\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 materials,gold-account\uFF1B\u4E0E --sections \u53EF\u53E0\u52A0"
@@ -6511,15 +6576,27 @@ function registerGoogleAnalysisCommands(program2) {
   ).option("--limit <n>", "\u900F\u4F20\u7ED9 keywords / search-terms \u7EF4\u5EA6\u7684\u6761\u6570\u4E0A\u9650", (v) => parseInt(v, 10)).option("--no-order-by-cost", "\u900F\u4F20\uFF1Akeywords / search-terms \u4E0D\u6309\u6D88\u8017\u6392\u5E8F", false).option("--level <level>", "\u900F\u4F20\u7ED9 extensions \u7EF4\u5EA6\u7684 level \u8FC7\u6EE4\uFF1AAccount | Campaign | Ad Group").option(
     "--audience-type <type>",
     "\u900F\u4F20\u7ED9 audience \u7EF4\u5EA6\u7684 audienceTypeFilter\uFF1ASystemDefined | UserDefined"
+  ).option(
+    "--cost-greater <n>",
+    "\u4EC5 campaign-geo\uFF1A\u7F51\u5173\u53EF\u9009\u8FC7\u6EE4 costGreater\uFF08\u6574\u6570\uFF0C\u5355\u4F4D\u4EE5\u540E\u7AEF\u4E3A\u51C6\uFF09",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--click-greater <n>",
+    "\u4EC5 campaign-geo\uFF1A\u7F51\u5173\u53EF\u9009\u8FC7\u6EE4 clickGreater\uFF08\u6574\u6570\uFF09",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--conversions-greater <n>",
+    "\u4EC5 campaign-geo\uFF1A\u7F51\u5173\u53EF\u9009\u8FC7\u6EE4 conversionsGreater\uFF08\u6574\u6570\uFF09",
+    (v) => parseInt(v, 10)
   ).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).addHelpText(
     "after",
     [
       "",
-      "\u53EF\u7528\u7EF4\u5EA6\uFF0821 \u4E2A\uFF0C\u4E0E --sections / --exclude \u53D6\u503C\u4E00\u81F4\uFF09\uFF1A",
+      "\u53EF\u7528\u7EF4\u5EA6\uFF0823 \u4E2A\uFF0C\u4E0E --sections / --exclude \u53D6\u503C\u4E00\u81F4\uFF09\uFF1A",
       ...SECTIONS.map((s) => `  ${s.name.padEnd(20)} ${s.description}`),
       "",
       "\u793A\u4F8B\uFF1A",
-      "  # \u5355\u8D26\u6237\uFF1A\u62C9\u5168\u90E8 21 \u4E2A\u7EF4\u5EA6",
+      "  # \u5355\u8D26\u6237\uFF1A\u62C9\u5168\u90E8 23 \u4E2A\u7EF4\u5EA6",
       "  siluzan-tso google-analysis -a <mediaCustomerId> --json-out ./snap",
       "",
       "  # \u5355\u8D26\u6237\uFF1A\u4EC5\u62C9\u5355\u4E2A\u7EF4\u5EA6\uFF08\u66FF\u4EE3\u5386\u53F2\u7684 google-analysis overview ...\uFF09",
@@ -6533,7 +6610,11 @@ function registerGoogleAnalysisCommands(program2) {
       "  siluzan-tso google-analysis -a id1,id2,id3 --start 2026-04-01 --end 2026-04-30 \\",
       "    --sections campaigns,geographic,keywords --json-out ./snap",
       "",
-      "  # \u591A\u8D26\u6237\u573A\u666F\u5982\u9700 resume / \u81EA\u9002\u5E94\u9650\u6D41 / deadline\uFF0C\u8BF7\u76F4\u63A5\u7528 google-analysis-batch run -a ..."
+      "  # \u591A\u8D26\u6237\u573A\u666F\u5982\u9700 resume / \u81EA\u9002\u5E94\u9650\u6D41 / deadline\uFF0C\u8BF7\u76F4\u63A5\u7528 google-analysis-batch run -a ...",
+      "",
+      "  # campaign-geo \u53EF\u9009\u9608\u503C\uFF08\u4E0E\u7F51\u5173 GetCampaignsGeoReport \u4E00\u81F4\uFF09",
+      "  siluzan-tso google-analysis -a <id> --sections campaign-geo --start <s> --end <e> \\",
+      "    --cost-greater 1000000 --json-out ./snap"
     ].join("\n")
   ).action(async (legacySection, opts) => {
     if (legacySection) {

package/dist/skill/SKILL.md

@@ -219,7 +219,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 
 1. **不要**按 `google-period-report.md` 展开默认 8 维并追问追加；改读 **`report-templates/okki-weekly-google-client.md`** 全文并按其结构交付。
 2. 确认 `mediaCustomerId` 与 `--start` / `--end`（未给齐则按上文「时间范围强制反问」）。
-3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选但推荐）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,devices,geographic`。
+3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选但推荐）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo`。
 4. **先 outline 后脚本**：读各 `*.outline.txt`，再编写并执行代码从 JSON 计算并写出：① 客户话术（Markdown/纯文本均可）；② 若需 **Excel**：**必须**产出多 Sheet `.xlsx`（版式与 Sheet 名见模板「必选交付」节），**只能**由 Agent 在当前环境执行脚本生成，**禁止**假设存在 `siluzan-tso … excel` 类 CLI 子命令。WorkBuddy 等编排器须在流程中显式包含「写 `.xlsx` 脚本并执行」一步，否则易缺产物。
 5. 遵守 SKILL 硬规范：金额 `*Display`、禁止手填业务数、禁止编造 ID。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.19-beta.3",
-  "publishedAt": 1778568598630
+  "version": "1.1.19-beta.4",
+  "publishedAt": 1778574504296
 }

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

@@ -89,7 +89,7 @@
 
 ## Google 账户分析：`google-analysis` 命令
 
-> **重要**：`google-analysis` 是统一入口，所有 21 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
+> **重要**：`google-analysis` 是统一入口，所有 23 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
 
 ```bash
 # 单维度
@@ -99,7 +99,7 @@ siluzan-tso google-analysis -a <id> --sections overview --json-out <dir>
 siluzan-tso google-analysis -a <id> --start YYYY-MM-DD --end YYYY-MM-DD \
   --sections overview,campaigns,devices,geographic,keywords,daily-metrics --json-out <dir>
 
-# 全量 21 个（省略 --sections）
+# 全量 23 个（省略 --sections）
 siluzan-tso google-analysis -a <id> --json-out <dir>
 
 # 排除慢/不需要的维度
@@ -112,7 +112,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | ------------------------ | ------------------------------------------------------------------------------------ |
 | `-a, --account <id>`     | Google `mediaCustomerId`（必填）                                                     |
 | `--json-out <dir>`       | 必填；每维一个 `<section>-<accountId>.json` + `manifest-<accountId>.json`            |
-| `--sections <list>`      | 仅执行指定维度（逗号分隔）；省略=全部 21 个                                          |
+| `--sections <list>`      | 仅执行指定维度（逗号分隔）；省略=全部 23 个                                          |
 | `--exclude <list>`       | 排除指定维度；与 `--sections` 可叠加                                                 |
 | `--start` / `--end`      | 统计区间（YYYY-MM-DD）；省略=近 7 天截至昨天；`final-urls`/`campaign-types` 自动忽略 |
 | `--concurrency <n>`      | 并发数，默认 5，上限 16                                                              |
@@ -120,9 +120,12 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `--level <lvl>`          | 透传给 `extensions`（Account/Campaign/Ad Group）                                     |
 | `--audience-type <type>` | 透传给 `audience`（SystemDefined/UserDefined）                                       |
 | `--no-order-by-cost`     | 透传给 `keywords`/`search-terms`                                                     |
+| `--cost-greater <n>`     | 仅 **`campaign-geo`**：网关 `costGreater`（整数，单位以后端为准）                    |
+| `--click-greater <n>`    | 仅 **`campaign-geo`**：网关 `clickGreater`                                           |
+| `--conversions-greater <n>` | 仅 **`campaign-geo`**：网关 `conversionsGreater`                                    |
 | `--verbose`              | 打印详细错误                                                                         |
 
-### 维度列表（21 个）
+### 维度列表（23 个）
 
 | 维度                 | 说明                                                                                                |
 | -------------------- | --------------------------------------------------------------------------------------------------- |
@@ -133,8 +136,10 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `campaign-hour`      | 系列按小时（根为 JSON 数组）                                                                        |
 | `ads`                | 广告；与 `ad list` 同源                                                                             |
 | `extensions`         | 附加信息；可选 `--level`                                                                            |
-| `devices`            | 设备分布                                                                                            |
-| `geographic`         | 地域分布                                                                                            |
+| `devices`            | 设备分布（账户级 `DeviceSectionData`）                                                              |
+| `geographic`         | 地域分布（账户级 `GeographicSectionData`，网关侧常按国家聚合）                                    |
+| `campaign-geo`       | 广告系列维度地理 （可选 `--cost-greater` / `--click-greater` / `--conversions-greater` 与网关一致） |
+| `campaign-device`    | 广告系列维度设备 （行可含系列/组）      |
 | `audience`           | 受众；可选 `--audience-type`                                                                        |
 | `asset-images`       | 图片素材                                                                                            |
 | `videos`             | 视频                                                                                                |
@@ -156,8 +161,8 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
   "absoluteSnapshotDir": "/abs/path/to/snap-google",
   "manifestFile": "manifest-9526903813.json",
   "accountId": "9526903813",
-  "totalSections": 21,
-  "succeeded": 21,
+  "totalSections": 23,
+  "succeeded": 23,
   "failed": 0,
   "concurrency": 5,
   "elapsedMs": 18712,

package/dist/skill/references/google-analysis-batch.md

@@ -73,6 +73,7 @@ siluzan-tso google-analysis-batch status --json-out ./snap-batch --run-id <runId
 | `--account-concurrency <n>` | 账户级并发（1~16）                                           | 4                                  |
 | `--section-concurrency <n>` | 单账户内维度并发（1~16）                                     | 6                                  |
 | `--keyword-limit <n>`       | keywords / search-terms 条数上限                             | google-analysis 默认               |
+| `--campaign-geo-cost-greater <n>` 等 | 仅 **`campaign-geo`**：与网关 `GetCampaignsGeoReport` 可选 query 一致；写入 `run-manifest.json`，`resume` 沿用 | 不设                               |
 | `--min-spend <n>`           | 区间消耗 ≤ 此值跳过（与 `-a` 同传无效）                      | 0                                  |
 | `--deadline <dur>`          | 整任务硬截止（如 `30m` / `2h`），到期标记 paused             | 不设                               |
 | `--task-timeout-ms <n>`     | 单 task 硬超时                                               | 60000                              |

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

@@ -41,14 +41,16 @@ siluzan-tso stats -m Google -a <mediaCustomerId> --start <S> --end <E> --json-ou
 siluzan-tso balance -m Google -a <mediaCustomerId> --json-out ./snap-okki
 
 siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-okki \
-  --sections overview,campaigns,keywords,search-terms,devices,geographic
+  --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo
 ```
 
 **说明**：
 
 - `stats`：区间消耗、曝光、点击、转化、CTR、CPC 等与**账户级周报摘要**对齐；金额用 `*Display` 或文档规定的展示字段。  
 - `balance`：**当前**账户余额（非历史快照）；话术里写清「截至查询时点」。  
-- `google-analysis`：系列 / 词 / 搜索词 / 设备 / 国家或地区**明细表**；TopN 排序在脚本里对 JSON 做，禁止心算。  
+- `google-analysis`：系列 / 词 / 搜索词；**设备与国家两 Sheet 的数据源**须用 **`campaign-device` / `campaign-geo`**（网关 `…/campaigns/reports/device` 与 `…/campaigns/reports/geo`，**按广告系列（及常见广告组）拆行**），**不要**再用账户级 `devices` / `geographic`。JSON 根结构仍为 `devices[]` / `countries[]`，落盘文件名分别为 `campaign-device-<id>.json`、`campaign-geo-<id>.json`。若运营需对「国家」「设备」做跨系列汇总，在脚本中聚合，**禁止**改回账户级维度冒充系列口径。  
+- 可选：`campaign-geo` 支持网关阈值过滤，与 CLI 一致时追加 `--cost-greater` / `--click-greater` / `--conversions-greater`（见 `references/account-analytics.md`）。  
+- TopN、排序、跨系列汇总均在脚本内对 JSON 完成，禁止心算。  
 - **写脚本前**先读各 `<section>-<id>.outline.txt`（及 stats/balance 的 outline，若有），再读对应 `.json`。
 
 ---
@@ -64,8 +66,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | 1 | `账户报告` | `campaigns` + 复盘文案（stats/overview 汇总后由 Agent 撰写） |
 | 2 | `关键词` | `keywords` |
 | 3 | `搜索词` | `search-terms` |
-| 4 | `设备` | `devices` |
-| 5 | `国家` | `geographic`（列「地理位置」为**国家/地区**中文名） |
+| 4 | `设备` | **`campaign-device`**（`campaign-device-*.json`；按系列/组拆行，非账户级 `devices`） |
+| 5 | `国家` | **`campaign-geo`**（`campaign-geo-*.json`；按系列/地域拆行，非账户级 `geographic`） |
 
 ### 各 Sheet 共同版式
 
@@ -98,8 +100,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
   **1. 账户层级**（整体消耗、展示、点击、点击率与 3% 基准对比、询盘/转化数、平均询盘成本等，数来自 stats/overview 与上表合计）；  
   **2. 关键词层级**（高转化词、高消耗低转化词及出价/竞争力建议）；  
   **3. 搜索字词层级**（标红/高意向词、否词与加词建议）；  
-  **4. 设备层级**（消耗与转化在各设备的分布）；  
-  **5. 国家层级**（高消耗/低转化国家与降权/调价建议）。  
+  **4. 设备层级**（基于 **`campaign-device`**：各设备在系列上的消耗/转化分布；复盘可汇总或点出高消耗系列×设备组合）；  
+  **5. 国家层级**（基于 **`campaign-geo`**：各国家/地区在系列上的消耗/转化；高消耗/低转化地域与降权/调价建议）。  
   文案由 Agent 据 JSON 撰写，**不得编造**表中不存在的数字。
 
 ---
@@ -133,7 +135,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1 标题 | `设备报告` |
 | R2 | 统计区间 |
 | R3 表头（A→M，共 13 列） | `设备` \| `级别` \| `出价调整` \| `广告系列` \| `广告组` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
-| R4… | `devices-*.json`：`deviceType` → 设备；**级别 / 出价调整** 若 JSON 无字段则留空或「—」 |
+| R4… | **`campaign-device-*.json`**（根字段仍为 `devices[]`）：`deviceType` → 设备；`campaignName` / `adGroupName` 等映射「广告系列」「广告组」列；**级别 / 出价调整** 若 JSON 无字段则留空或「—」 |
 
 ---
 
@@ -144,7 +146,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1 标题 | `地理位置报告` |
 | R2 | 统计区间 |
 | R3 表头（A→L，共 12 列） | `地理位置` \| `广告系列` \| `展示次数` \| `互动次数` \| `互动率` \| `费用` \| `平均费用` \| `点击次数` \| `点击率` \| `转化次数` \| `每次转化费用` \| `转化率` |
-| R4… | `geographic-*.json`：`countryOrRegion` → 地理位置；**互动次数 / 互动率 / 平均费用** 按 outline 与网关字段映射，无则留空或从 `interactions` 等派生并注释 |
+| R4… | **`campaign-geo-*.json`**（根字段仍为 `countries[]`）：`countryOrRegion` → 地理位置；`campaignName` 映射「广告系列」列；**互动次数 / 互动率 / 平均费用** 按 outline 与网关字段映射，无则留空或从 `interactions` 等派生并注释 |
 
 ---
 
@@ -183,7 +185,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 ## 复盘小结 + 优化建议（对内或可附在客户邮件末段）
 
-基于同一批 JSON（尤其 `campaigns`、`keywords`、`search-terms`、`devices`、`geographic`、`overview`）：
+基于同一批 JSON（尤其 `campaigns`、`keywords`、`search-terms`、**`campaign-device`**、**`campaign-geo`**、`overview`）：
 
 - **复盘**：3～6 条 bullet：消耗集中度、高消耗系列/词、地域与设备差异、CTR/CPC 相对水平。  
 - **优化建议**：3～5 条可执行项（预算、否词、落地页、系列状态等），**不额外拉数**；缺数据则标 `[数据不可用：原因]`。
@@ -194,6 +196,10 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 | 项 | 周期报告 `google-period-report.md` | 本文 OKKI 周报 |
 | -- | ---------------------------------- | ---------------- |
-| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,devices,geographic` + `stats` + `balance` |
+| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo` + `stats` + `balance` |
 | 输出形态 | 长文分析报告 | **固定话术** + 短复盘 + **多 Sheet Excel（Agent 脚本写，非 CLI）** |
 | 典型用户 | 内部分析 | **发客户**的同步简报 |
+
+
+
+

package/package.json

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