siluzan-tso-cli 1.1.19-beta.2 → 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.2），供内部测试使用。正式发布后安装命令将改为 `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

@@ -5,7 +5,7 @@ description: >-
   写 Google 搜索方案/计划/待确认结构表时先读 references/google-ads.md。
   关键字规划师/拓词/竞品网址拓词/词包清洗/否词/建户关键词编排：先读 references/keyword-planner-workflows.md。
   ①竞品URL+种子拓词→JSON筛排TopN ②多种子长尾 ③月搜阈值与词根/意图洗词 ④google-analysis keywords 叠分批 keyword 市场指标 ⑤search-terms 与拓词对照否词线索 ⑥CPC/竞争度/搜索量筛高意图 ⑦否词表+ad keyword-negative-create ⑧Campaign→AdGroup→匹配表+ad 落地 ⑨keyword --json-out 供脚本复用。无 Forecast、无 Planner 官方按月 12 个月趋势接口。
-  运营「OKKI 周报」固定话术（如「使用okki周报模板生成…」）→ `report-templates/okki-weekly-google-client.md`，仅用现有 `stats`/`balance`/`google-analysis`，不新增拉数命令。
+  运营「OKKI 周报」固定话术（如「使用okki周报模板生成…」）→ `report-templates/okki-weekly-google-client.md`：拉数仅用现有 `stats`/`balance`/`google-analysis`（不新增拉数子命令）；**多 Sheet Excel 由 Agent 落盘后写脚本生成**，CLI **不**提供内置「写 Excel」子命令。
 license: MIT
 metadata:
   requires: nodejs,siluzan-tso-cli
@@ -56,7 +56,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 | `references/finance.md`                        | 转账、开票、发票抬头、充值网页引导                                                                                                                                                                                                                                                                                                       |
 | `references/write-audit-restore.md`            | 本机写审计、`--commit`、补偿写 `audit restore-plan` / `restore-apply`                                                                                                                                                                                                                                                                    |
 | `report-templates/report-template.html`        | 默认 HTML 报告样式参考                                                                                                                                                                                                                                                                                                                   |
-| `report-templates/okki-weekly-google-client.md` | **OKKI 周报**：固定客户话术 + 精简维度（`google-analysis` + `stats` + `balance`），见 Playbook P6                                                                                                                                                                                                                                        |
+| `report-templates/okki-weekly-google-client.md` | **OKKI 周报**：固定话术 + 精简维度 CLI 拉数；**Excel 由 Agent 脚本写**（见 P6），无 CLI 内置写表命令                                                                                                                                                                                                                                        |
 
 ---
 
@@ -219,8 +219,8 @@ 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`。
-4. **先 outline 后脚本**：读各 `*.outline.txt`，编写并执行代码从 JSON 填「客户话术」块；复盘与优化建议可附于后；可选按该模板「可选交付」节写多 Sheet Excel。
+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。
 
 ### P5 · 多账户多维度报告

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.19-beta.2",
-  "publishedAt": 1778567157660
+  "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/README.md

@@ -21,7 +21,7 @@
 | `meta-period-report.md`              | Meta（Facebook）账户周期报告                      |
 | `tiktok-period-report.md`            | TikTok 广告主周期报告                             |
 | `bing-period-report.md`              | Bing（BingV2）分析报告                            |
-| `okki-weekly-google-client.md`       | **OKKI 周报**：Google 发客户固定话术 + 精简维度（见 SKILL P6） |
+| `okki-weekly-google-client.md`       | **OKKI 周报**：Google 发客户固定话术 + 精简维度 CLI；**Excel 仅 Agent 脚本**（无 CLI 写表子命令），见 SKILL P6 |
 
 ---
 

package/dist/skill/report-templates/REPORT-WORKFLOW.md

@@ -74,7 +74,7 @@
 | 用户措辞                       | 映射                                                              |
 | ------------------------------ | ----------------------------------------------------------------- |
 | 月报、周报、投放总结、效果回顾 | 周期分析 → 对应媒体 `*-period-report.md`                          |
-| **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间） | **固定话术 + 精简表** → `okki-weekly-google-client.md`（见 SKILL **P6**），**不**再走 `google-period-report.md` 的默认 8 维追问 |
+| **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间） | **固定话术 + 精简表 +（按需）Excel** → `okki-weekly-google-client.md`（见 SKILL **P6**）；Excel **仅**由 Agent 脚本生成，**无** CLI 内置写表子命令 |
 | 健康检查、诊断、账户分析       | 诊断 → `google-account-diagnosis-report.md`（Google）或周期型降级 |
 | 对比、汇报、给客户看           | 以周期型为骨架，简化版本                                          |
 

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

@@ -3,7 +3,8 @@
 > **触发话术（等价即可）**  
 > `使用okki周报模板生成<账户名或ID>，<YYYY-MM-DD>--<YYYY-MM-DD>的投放报告`  
 > 同义：`OKKI 周报`、`okki 周报模板`、`运营 OKKI 周报`。  
-> **媒体**：当前模板仅规范 **Google**（`mediaCustomerId`）。其他媒体用各自 `*-period-report.md`。
+> **媒体**：当前模板仅规范 **Google**（`mediaCustomerId`）。其他媒体用各自 `*-period-report.md`。  
+> **Excel 版式基准**：与运营样表《**数据复盘分析**》类 xlsx 对齐（如 `2025.12数据复盘分析.xlsx`）：**工作簿 5 个 Sheet、顺序与表头**以本文「最终 xlsx 版式规范」为准；Agent 生成产物须可与之逐 Sheet 对照验收。
 
 识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程；按本文**固定维度 + 固定客户话术**交付即可（数据仍全部来自 CLI 落盘 JSON，见 `references/account-analytics.md`）。
 
@@ -14,6 +15,15 @@
 1. **账户**：`mediaCustomerId` 来自 `list-accounts -m Google -k <id>`，禁止猜 ID。  
 2. **统计区间**：`--start` / `--end`（用户未给齐时按 SKILL 反问；授权默认时可用「上一完整自然周」白名单并写明）。  
 3. **询盘口径**：模板正文第 7 条默认使用 **区间内 `conversions`（转化次数）**（来自 `stats` 或 `overview` 汇总）。若运营将「询盘」定义为某一类转化，须在报告首段脚注说明数据来源（必要时补拉 `google-analysis --sections conversion-actions` 仅作说明，不替代统计口径 unless 用户确认）。
+4. **日期写法**：用户可能写 `2026.4.1`、`2026/4/1` 等，Agent 须先规范为 CLI 要求的 **`YYYY-MM-DD`**（如 `2026-04-01`）再传 `--start` / `--end`。
+
+---
+
+## 架构约定（Excel 谁来做）
+
+- **`siluzan-tso` 不提供**「一键生成 OKKI Excel」的内置子命令，也**不要**在 CLI 里新增此类能力。
+- **需要交付 Excel 时**：由 **Agent（含 WorkBuddy 编排）** 在下列 CLI **`--json-out` 落盘完成后**，自行编写并执行 **Node.js / Python** 脚本（可选用 `exceljs`、`xlsx`、`openpyxl` 等）读取目录内 JSON → 按本文「多 Sheet 版式」写出 `.xlsx`。
+- 脚本与依赖可在当前工作区临时添加（如 `package.json` + `npm install` 或 `pip install`），或由宿主环境预装；**数值一律来自落盘 JSON**，禁止在脚本源码里写死业务数字。
 
 ---
 
@@ -31,18 +41,121 @@ 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`。
 
 ---
 
+## 最终 xlsx 版式规范（与运营样表对齐）
+
+以下按 **工作簿 → Sheet 名（须完全一致）→ 版式** 约定，便于 WorkBuddy / 人工用样表对照验收。**不**再单独建名为「广告系列」的 Sheet（系列表在 **`账户报告`** 内）。
+
+### 工作簿级
+
+| 顺序 | Sheet 名 | 数据来源（CLI 落盘） |
+| ---: | ---------- | -------------------- |
+| 1 | `账户报告` | `campaigns` + 复盘文案（stats/overview 汇总后由 Agent 撰写） |
+| 2 | `关键词` | `keywords` |
+| 3 | `搜索词` | `search-terms` |
+| 4 | `设备` | **`campaign-device`**（`campaign-device-*.json`；按系列/组拆行，非账户级 `devices`） |
+| 5 | `国家` | **`campaign-geo`**（`campaign-geo-*.json`；按系列/地域拆行，非账户级 `geographic`） |
+
+### 各 Sheet 共同版式
+
+- **第 1 行（A1）**：该 Sheet 的**报告标题**（见下表「R1 标题」）。建议合并单元格横跨数据区（样表约 A1:K1 / A1:N1）。
+- **第 2 行（A2）**：统计区间，**中文可读**：`YYYY年M月D日 - YYYY年M月D日`（由 `--start` / `--end` 转换，与样表一致）。
+- **第 3 行**：**表头**（列名、顺序须与下表一致）。
+- **第 4 行起**：数据行；列宽与自动筛选、首行冻结为可选（样表含 `autoFilter`、部分 Sheet 对数据区设默认**按费用/转化相关列降序**排序，Agent 可复现或省略，**不得**因此改数）。
+
+### 百分比与金额（与样表一致）
+
+- **点击率、转化率、互动率**等列：样表为 **0～1 小数**（例如 7.95% 存 `0.0795`）；若写百分比数字列须与运营约定二选一，**禁止**同一文件混用。
+- **费用、CPC、每次转化费用、预算**等：与 `references/account-analytics.md` 一致；`campaigns` 中 **`budgetAmount` 为分**，展示为「元」须 **÷100**；同条 `spend`、`averageCpc` 等已为**元**。
+
+---
+
+### Sheet `账户报告`
+
+| 行 | 内容 |
+| --- | --- |
+| R1 标题 | `广告系列报告`（与样表一致；若运营统一改名，可改文案但须保持 Sheet 名仍为 `账户报告`） |
+| R2 | 统计区间（中文日期，见上） |
+| R3 表头（A→K，共 11 列） | `广告系列` \| `预算` \| `费用` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `所有转化次数` \| `转化次数` \| `每次转化费用` \| `转化率` |
+| R4… | 每行一条广告系列：来自 `campaigns-*.json` 的 `campaignName`、`budgetAmount`（÷100 为元）、`spend`、`impressions`、`clicks`、`ctr`（或 `clicks/impressions`）、`averageCpc`、**所有转化**与 **转化**字段以 JSON 及 outline 为准映射（若网关仅提供 `conversions`，缺列填 `0` 或留空并在脚注说明） |
+| 末行「合计」 | **广告系列**列填 `总计`；**预算**列填 `--`；其余列按列语义对上方数据行做**求和或可加和指标**；**点击率 / 转化率**须用合计展示、点击、转化等**重算**，禁止对各行比率取算术平均 |
+
+表下**留白若干行**后写 **「数据复盘」**（与样表一致）：
+
+- 首行标题：`{结束日所在月份}月份数据复盘：`（例：`12月份数据复盘：`）。
+- 接续 **5 条结构化要点**（每条一行或自动换行，对应样表逻辑）：  
+  **1. 账户层级**（整体消耗、展示、点击、点击率与 3% 基准对比、询盘/转化数、平均询盘成本等，数来自 stats/overview 与上表合计）；  
+  **2. 关键词层级**（高转化词、高消耗低转化词及出价/竞争力建议）；  
+  **3. 搜索字词层级**（标红/高意向词、否词与加词建议）；  
+  **4. 设备层级**（基于 **`campaign-device`**：各设备在系列上的消耗/转化分布；复盘可汇总或点出高消耗系列×设备组合）；  
+  **5. 国家层级**（基于 **`campaign-geo`**：各国家/地区在系列上的消耗/转化；高消耗/低转化地域与降权/调价建议）。  
+  文案由 Agent 据 JSON 撰写，**不得编造**表中不存在的数字。
+
+---
+
+### Sheet `关键词`
+
+| 行 | 内容 |
+| --- | --- |
+| R1 标题 | `搜索关键字报告` |
+| R2 | 统计区间（同 `账户报告`） |
+| R3 表头（A→L，共 12 列） | `关键字` \| `匹配类型` \| `广告系列` \| `广告组` \| `费用` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
+| R4… | `keywords-*.json` 行映射；`keywordMatchType` → 匹配类型；`campaignName` / `adGroupName` 等按 outline |
+
+---
+
+### Sheet `搜索词`
+
+| 行 | 内容 |
+| --- | --- |
+| R1 标题 | `搜索字词报告` |
+| R2 | 统计区间 |
+| R3 表头（A→N，共 14 列） | `搜索字词` \| `匹配类型` \| `已添加/已排除` \| `广告系列` \| `广告组` \| `关键字` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
+| R4… | `search-terms-*.json`；`已添加/已排除` 若 JSON 无此枚举则留空或填「—」，禁止臆造状态 |
+
+---
+
+### Sheet `设备`
+
+| 行 | 内容 |
+| --- | --- |
+| R1 标题 | `设备报告` |
+| R2 | 统计区间 |
+| R3 表头（A→M，共 13 列） | `设备` \| `级别` \| `出价调整` \| `广告系列` \| `广告组` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
+| R4… | **`campaign-device-*.json`**（根字段仍为 `devices[]`）：`deviceType` → 设备；`campaignName` / `adGroupName` 等映射「广告系列」「广告组」列；**级别 / 出价调整** 若 JSON 无字段则留空或「—」 |
+
+---
+
+### Sheet `国家`
+
+| 行 | 内容 |
+| --- | --- |
+| R1 标题 | `地理位置报告` |
+| R2 | 统计区间 |
+| R3 表头（A→L，共 12 列） | `地理位置` \| `广告系列` \| `展示次数` \| `互动次数` \| `互动率` \| `费用` \| `平均费用` \| `点击次数` \| `点击率` \| `转化次数` \| `每次转化费用` \| `转化率` |
+| R4… | **`campaign-geo-*.json`**（根字段仍为 `countries[]`）：`countryOrRegion` → 地理位置；`campaignName` 映射「广告系列」列；**互动次数 / 互动率 / 平均费用** 按 outline 与网关字段映射，无则留空或从 `interactions` 等派生并注释 |
+
+---
+
+## Excel 交付（谁来做）
+
+若用户或运营要求交付 **xlsx**：须满足上文**最终 xlsx 版式规范**；实现仍遵守本文开头「架构约定」——**仅**由 Agent 写脚本生成，**无** CLI 内置写表命令。
+
+---
+
 ## 对外客户话术（固定结构，填数来自 JSON）
 
 首行建议：
@@ -52,7 +165,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 正文模板：
 
 ```
-您好，同步一下谷歌<S>--<E>的投放报告投放数据：
+您好，同步一下谷歌<S>--<E>的投放数据：
 
 1. 消耗：共消耗<金额+币种>，平均每天消耗<金额+币种>
 2. 展示点击：带来<曝光>次曝光，<点击>个点击；
@@ -72,34 +185,21 @@ 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 条可执行项（预算、否词、落地页、系列状态等），**不额外拉数**；缺数据则标 `[数据不可用：原因]`。
 
 ---
 
-## 可选交付：多 Sheet Excel（版式约定）
-
-无新 CLI 命令时，由 **脚本**（Node/Python + 所选 xlsx 库）从快照目录读 JSON 写出：
-
-| Sheet 名   | 内容 |
-| ---------- | ---- |
-| `账户报告` | 上文「客户话术」全文 + 「复盘小结」+「优化建议」+ **广告系列**数据表（与 `campaigns` JSON 一致列） |
-| `广告系列` | 可选：与上表相同仅表；若运营希望单 Sheet「账户报告」含表，则可省略本 Sheet |
-| `关键词`   | `keywords` 落盘表 |
-| `搜索词`   | `search-terms` 落盘表 |
-| `设备`     | `devices` 落盘表 |
-| `国家`     | `geographic` 落盘表（列名含国家/地区即可） |
-
-列名与单位与 JSON / `references/account-analytics.md` 金额规则一致（`campaigns` 的 `budgetAmount` 为分，须 ÷100 为元等）。
-
----
-
 ## 与 `google-period-report.md` 的差异
 
 | 项 | 周期报告 `google-period-report.md` | 本文 OKKI 周报 |
 | -- | ---------------------------------- | ---------------- |
-| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,devices,geographic` + `stats` + `balance` |
-| 输出形态 | 长文分析报告 | **固定话术** + 短复盘 + 可选 Excel |
+| 默认维度 | 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.2",
+  "version": "1.1.19-beta.4",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",