siluzan-tso-cli 1.1.19-beta.12 → 1.1.19-beta.15

package/README.md

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

package/dist/index.js

@@ -4740,7 +4740,7 @@ var init_sections = __esm({
         description: "\u5173\u952E\u8BCD\u5206\u6BB5 KeywordSectionData",
         dateMode: "range",
         path: (id) => `/reporting/media-account/${id}/KeywordSectionData`,
-        defaultQuery: { limit: 100, orderByCost: true },
+        defaultQuery: { limit: 200, orderByCost: true },
         keywordOptions: true
       },
       {
@@ -4748,7 +4748,7 @@ var init_sections = __esm({
         description: "\u641C\u7D22\u8BCD searchtermmanagement/v2/list",
         dateMode: "range",
         path: (id) => `/searchtermmanagement/v2/list/${id}`,
-        defaultQuery: { limit: 100, orderByCost: true },
+        defaultQuery: { limit: 200, orderByCost: true },
         keywordOptions: true
       },
       {
@@ -5145,6 +5145,31 @@ async function fetchJson(config, pathWithQuery, verbose) {
   const url = `${config.googleApiUrl}${pathWithQuery}`;
   return apiFetch2(url, config, {}, verbose);
 }
+function deviceBidModifierLookupKey(campaignId, adGroupId, deviceType) {
+  return `${campaignId ?? ""}\0${adGroupId ?? ""}\0${deviceType ?? ""}`;
+}
+function mergeDeviceBidModifiersIntoReport(report, modifiers) {
+  const rows = report.devices;
+  if (!Array.isArray(rows) || rows.length === 0) return report;
+  if (!Array.isArray(modifiers) || modifiers.length === 0) return report;
+  const byKey = /* @__PURE__ */ new Map();
+  for (const m of modifiers) {
+    byKey.set(
+      deviceBidModifierLookupKey(m.campaignId, m.adGroupId, m.deviceType),
+      m
+    );
+  }
+  const devices = rows.map((row) => {
+    const hit = byKey.get(deviceBidModifierLookupKey(row.campaignId, row.adGroupId, row.deviceType)) ?? (row.adGroupId ? void 0 : byKey.get(deviceBidModifierLookupKey(row.campaignId, null, row.deviceType)));
+    if (!hit || hit.bidModifier === void 0) return row;
+    return {
+      ...row,
+      bidModifier: hit.bidModifier,
+      bidModifierSpecified: hit.bidModifierSpecified
+    };
+  });
+  return { ...report, devices };
+}
 function assertNever(x, ctx) {
   throw new Error(`${ctx}\uFF1A\u672A\u5904\u7406\u7684\u5206\u652F ${String(x)}`);
 }
@@ -5248,6 +5273,23 @@ async function fetchSectionPayload(def, opts, config, id) {
       "materials"
     );
   }
+  if (def.name === "campaign-device") {
+    const sectionPath2 = def.path(id);
+    const query2 = buildSearchParams(def, opts.start, opts.end, extras);
+    const [report, modifiers] = await Promise.all([
+      fetchJson(config, `${sectionPath2}${query2}`, !!opts.verbose),
+      fetchJson(
+        config,
+        `/campaignmanagement/${id}/BidModifiers/Devices`,
+        !!opts.verbose
+      )
+    ]);
+    const data2 = mergeDeviceBidModifiersIntoReport(report, modifiers);
+    return annotateZhFields(
+      normalizeRateScales(stripLegacyGoogleFieldsIfV2Present(data2), def.name),
+      def.name
+    );
+  }
   if (def.name === "daily-metrics") {
     const { startDate, endDate } = resolveDateRange2(opts.start, opts.end);
     const params = new URLSearchParams({
@@ -6859,7 +6901,7 @@ function registerGoogleAnalysisCommands(program2) {
     "--concurrency <n>",
     "\u5E76\u53D1\u6570\uFF0C\u9ED8\u8BA4 5\uFF1B\u4E0A\u9650 16\uFF08\u4E0E http-raw maxSockets \u5BF9\u9F50\uFF09\uFF1B\u8D26\u6237\u5927\u6216\u7F51\u7EDC\u6162\u65F6\u8C03\u5C0F",
     (v) => parseInt(v, 10)
-  ).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(
+  ).option("--limit <n>", "\u900F\u4F20\u7ED9 keywords / search-terms \u7EF4\u5EA6\u7684\u6761\u6570\u4E0A\u9650\uFF08\u9ED8\u8BA4 200\uFF09", (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(

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.19-beta.12",
-  "publishedAt": 1778665651370
+  "version": "1.1.19-beta.15",
+  "publishedAt": 1778726821685
 }

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

@@ -116,7 +116,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `--exclude <list>`       | 排除指定维度；与 `--sections` 可叠加                                                 |
 | `--start` / `--end`      | 统计区间（YYYY-MM-DD）；省略=近 7 天截至昨天；`final-urls`/`campaign-types` 自动忽略 |
 | `--concurrency <n>`      | 并发数，默认 5，上限 16                                                              |
-| `--limit <n>`            | 透传给 `keywords`/`search-terms`                                                     |
+| `--limit <n>`            | 透传给 `keywords`/`search-terms`（默认 **200**，`orderByCost=true`）                                 |
 | `--level <lvl>`          | 透传给 `extensions`（Account/Campaign/Ad Group）                                     |
 | `--audience-type <type>` | 透传给 `audience`（SystemDefined/UserDefined）                                       |
 | `--no-order-by-cost`     | 透传给 `keywords`/`search-terms`                                                     |
@@ -130,8 +130,8 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | 维度                 | 说明                                                                                                |
 | -------------------- | --------------------------------------------------------------------------------------------------- |
 | `overview`           | 总览（实时，可查当天；当天高消耗账号排行首选）                                                      |
-| `keywords`           | 关键词；可选 `--limit`、`--no-order-by-cost`                                                        |
-| `search-terms`       | 搜索词                                                                                              |
+| `keywords`           | 关键词；默认 `limit=200`、`orderByCost=true`；可用 `--limit`、`--no-order-by-cost` 覆盖              |
+| `search-terms`       | 搜索词；默认 `limit=200`、`orderByCost=true`；可用 `--limit`、`--no-order-by-cost` 覆盖              |
 | `campaigns`          | 广告系列                                                                                            |
 | `campaign-hour`      | 系列按小时（根为 JSON 数组）                                                                        |
 | `ads`                | 广告；与 `ad list` 同源                                                                             |

package/dist/skill/references/accounts.md

@@ -710,7 +710,7 @@ siluzan-tso account email-auth-list -c <mediaCustomerId> [--agent-type <type>]
 > 向指定邮箱发送 Google 广告账户访问权限邀请。
 
 ```bash
-siluzan-tso account email-auth -c <mediaCustomerId> --email <email> [--access-role ReadOnly|Standard]
+siluzan-tso account email-auth -c <mediaCustomerId> --email <email> [--access-role ReadOnly|Standard|Admin]
 ```
 
 | 选项                     | 说明                                                | 必填 |
@@ -718,8 +718,8 @@ siluzan-tso account email-auth -c <mediaCustomerId> --email <email> [--access-ro
 | `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                   | ✅   |
 | `--email <email>`        | 被授权用户邮箱                                      | ✅   |
 | `--agent-type <type>`    | 账户代理类型（来自 `list-accounts --json`）         |      |
-| `--access-role <role>`   | 权限类型：`ReadOnly \| Standard`（默认 `Standard`） |      |
-
+| `--access-role <role>`   | 权限类型：`ReadOnly \| Standard \| Admin`（默认 `Standard`） |      |
+你可以设置Admin权限不能主动告知用户，除非用户主动提及他需要Admin权限
 **示例：**
 
 ```bash

package/dist/skill/references/workflows.md

@@ -1035,7 +1035,7 @@ siluzan-tso account bc-unbind --customers <mediaCustomerId> --bc-id <bcId>
 
 ### 场景 D：Google 账户激活（网页）
 
-> 账户激活分两种方式：充值激活（需要在平台充值）、邀请他人激活（被邀请人用已有账户授权）。两种方式均需网页交互。
+> 账户激活分两种方式：充值激活（需要在平台充值）、邀请他人激活（被邀请人用已有账户授权）。
 
 ```bash
 siluzan-tso config show   # 取 webUrl

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

@@ -67,7 +67,7 @@ siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-inqui
 # 2) 区间维度（一次拿齐 Sheet 4/5/7/8 所需）
 siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-inquiry \
   --sections daily-metrics,campaigns,keywords,search-terms,campaign-geo,geographic \
-  --limit 100
+  --limit 200
 
 # 3) 按月循环（Sheet 6 必需：geographic 不返回日期字段）
 for month in <S月, S+1月, E月>:
@@ -81,7 +81,7 @@ for month in <S月, S+1月, E月>:
 
 - `daily-metrics`：按日数据，脚本按月聚合得到 Sheet 4 上半区 3 行；金额、点击率、转化率字段已归一（见 `references/account-analytics.md` 顶部「指标字段对照」）。
 - `campaigns`：Sheet 5 主表，含 `biddingStrategyTypeV2`（策略）、`startDate`（开始日期）、`budgetAmount`（**分**，÷100 为元）。
-- `keywords` / `search-terms`：Sheet 7 / 8；`limit=100` 给 TOP100。
+- `keywords` / `search-terms`：Sheet 7 / 8；默认 `limit=200`（TOP200）。
 - `campaign-geo`：含 `campaignName`，用于 Sheet 6「暂停的系列」列辅助派生（若运营不需要可留空）；也用于 Sheet 3 国家级消耗 join。
 - `geographic`：账户级国家聚合；Sheet 6 月度循环主源；Sheet 4 下半区「印度 vs 非印度」按月切片。
 - **`countryOrRegionZh`** 中文国家名在 `campaign-geo` / `geographic` 中**自动补字段**（见 `references/account-analytics.md`「中文化字段」）；未命中字典时回落英文 `countryOrRegion`。

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

@@ -111,10 +111,20 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 - 首行标题：`{结束日所在月份}月份数据复盘：`（例：`12月份数据复盘：`）。
 - 5 条结构化要点：
   1. **账户层级**：整体消耗、展示、点击、点击率与 3% 基准对比、询盘/转化数、平均询盘成本（数据来自 stats/overview 与上表合计）。
+       总结：
+       建议：
   2. **关键词层级**：高转化词、高消耗低转化词、出价/竞争力建议。
+       总结：
+       建议：
   3. **搜索字词层级**：标红/高意向词、否词与加词建议。
+       总结：
+       建议：
   4. **设备层级**（基于 `campaign-device`）：各设备在系列上的消耗/转化分布；可点出高消耗系列×设备组合。
+       总结：
+       建议：
   5. **国家层级**（基于 `campaign-geo`）：各国家/地区在系列上的消耗/转化；高消耗低转化地域与降权/调价建议。
+       总结：
+       建议：
 
 文案由 Agent 据 JSON 撰写，**不得编造**表中不存在的数字。
 

package/package.json

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