siluzan-tso-cli 1.1.19-beta.8 → 1.1.19

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli@beta
+npm install -g siluzan-tso-cli
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,7 +51,6 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.19-beta.8），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -3292,7 +3292,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
   }
 });
 
@@ -4526,6 +4526,18 @@ import * as path11 from "path";
 function googleAnalysisManifestFile(accountId) {
   return `${applyIdSuffix("manifest", accountId)}.json`;
 }
+function buildOutlineHints(section) {
+  const hints = [];
+  if (RATE_BEARING_SECTIONS.has(section)) {
+    hints.push(...GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS);
+  }
+  if (section === "campaigns") {
+    hints.push(...GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS);
+  }
+  const zhHints = GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION[section];
+  if (zhHints) hints.push(...zhHints);
+  return hints.length > 0 ? hints : void 0;
+}
 function sectionToFilename(section, accountId) {
   if (!/^[a-z0-9-]+$/.test(section)) {
     throw new Error(`\u975E\u6CD5\u5B50\u547D\u4EE4\u540D\uFF0C\u65E0\u6CD5\u751F\u6210\u6587\u4EF6\u540D\uFF1A${section}`);
@@ -4585,7 +4597,7 @@ async function writeGoogleAnalysisSnapshot(params) {
   await fs7.writeFile(path11.join(absDir, fileName), `${body}
 `, "utf8");
   const outlineFileName = snapshotOutlineFileName(fileName);
-  const outlineExtra = params.section === "campaigns" ? GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS : void 0;
+  const outlineExtra = buildOutlineHints(params.section);
   const outlineBody = formatOutlineFileBody(fileName, params.payload, outlineExtra);
   await fs7.writeFile(path11.join(absDir, outlineFileName), `${outlineBody}
 `, "utf8");
@@ -4620,7 +4632,7 @@ 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;
+var LEGACY_MANIFEST_FILE, CLI_PACKAGE2, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE2, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
 var init_google_analysis = __esm({
   "src/utils/snapshot/google-analysis.ts"() {
     "use strict";
@@ -4628,7 +4640,7 @@ var init_google_analysis = __esm({
     init_dir();
     LEGACY_MANIFEST_FILE = "manifest.json";
     CLI_PACKAGE2 = "siluzan-tso-cli";
-    SCHEMA_VERSION2 = 1;
+    SCHEMA_VERSION2 = 2;
     DEFAULT_FIELD_GUIDE2 = {
       markdownRefs: ["references/account-analytics.md"],
       tsTypesModule: "tso-cli/src/types/google-analysis-api.ts"
@@ -4637,6 +4649,40 @@ var init_google_analysis = __esm({
       "// \u91D1\u989D\uFF1A`campaigns[].budgetAmount`\uFF1D\u7F51\u5173\u300C\u5206\u300D\uFF08\u4E3B\u5E01\u79CD\xD7100 \u7684\u6574\u6570\uFF09\uFF0C**\u5143\uFF1D\xF7100**\uFF1B**\u7981\u6B62**\u6309\u5FAE\u5143 **\xF71_000_000**\uFF08\u4F1A\u7EA6\u5C0F\u4E00\u4E07\u500D\uFF09\u3002",
       "// \u540C\u6587\u4EF6 `spend`\u3001`averageCpc`\u3001`costPerConversion` \u7B49\u5DF2\u4E3A\u300C\u5143\u300D\u5C0F\u6570\u3002\u8BE6 `references/account-analytics.md`\u300CCampaignSectionData\u300D\u3002"
     ];
+    RATE_BEARING_SECTIONS = /* @__PURE__ */ new Set([
+      "overview",
+      "keywords",
+      "search-terms",
+      "campaigns",
+      "ads",
+      "extensions",
+      "devices",
+      "geographic",
+      "campaign-geo",
+      "campaign-device",
+      "audience",
+      "asset-images",
+      "videos",
+      "materials",
+      "daily-metrics",
+      "dimension-summary",
+      "ads-index"
+    ]);
+    GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS = [
+      "// \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_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"
+      ],
+      "search-terms": [
+        "// \u4E2D\u6587\u8BD1\u540D\uFF1A`matchTypeZh`\uFF08\u7531 `matchType` \u7ECF match-type-en2zh.json \u7FFB\u8BD1\uFF1B\u672A\u547D\u4E2D\u65F6\u8BE5\u5B57\u6BB5\u7F3A\u7701\uFF09\u3002"
+      ],
+      "campaign-geo": [
+        "// \u4E2D\u6587\u8BD1\u540D\uFF1A`countryOrRegionZh`\uFF08\u7531 `countryOrRegion` \u7ECF geo-en2zh.json \u7FFB\u8BD1\uFF0C\u76EE\u524D\u8986\u76D6 105 \u4E2A\u56FD\u5BB6/\u5730\u533A\uFF1B\u672A\u547D\u4E2D\u65F6\u8BE5\u5B57\u6BB5\u7F3A\u7701\uFF09\u3002"
+      ]
+    };
   }
 });
 
@@ -4694,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
       },
       {
@@ -4702,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
       },
       {
@@ -4833,6 +4879,340 @@ var init_sections = __esm({
   }
 });
 
+// src/commands/google-analysis/normalize-rates.ts
+function divIfFiniteNumber(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v / 100 : v;
+}
+function divideRatesInPlace(value, seen) {
+  if (value === null || typeof value !== "object") return;
+  if (seen.has(value)) return;
+  seen.add(value);
+  if (Array.isArray(value)) {
+    for (const item of value) divideRatesInPlace(item, seen);
+    return;
+  }
+  const obj = value;
+  for (const k of Object.keys(obj)) {
+    if (RATE_FIELD_NAMES.has(k)) {
+      obj[k] = divIfFiniteNumber(obj[k]);
+    } else {
+      divideRatesInPlace(obj[k], seen);
+    }
+  }
+}
+function normalizeRateScales(payload, section) {
+  if (!PERCENT_SCALE_SECTIONS.has(section)) return payload;
+  divideRatesInPlace(payload, /* @__PURE__ */ new WeakSet());
+  return payload;
+}
+var PERCENT_SCALE_SECTIONS, RATE_FIELD_NAMES;
+var init_normalize_rates = __esm({
+  "src/commands/google-analysis/normalize-rates.ts"() {
+    "use strict";
+    PERCENT_SCALE_SECTIONS = /* @__PURE__ */ new Set([
+      "overview",
+      "keywords",
+      "search-terms",
+      "campaigns",
+      "ads",
+      "extensions",
+      "devices",
+      "ads-index"
+    ]);
+    RATE_FIELD_NAMES = /* @__PURE__ */ new Set(["ctr", "conversionRate"]);
+  }
+});
+
+// src/commands/google-analysis/match-type-en2zh.json
+var match_type_en2zh_default;
+var init_match_type_en2zh = __esm({
+  "src/commands/google-analysis/match-type-en2zh.json"() {
+    match_type_en2zh_default = {
+      BROAD: "\u5E7F\u6CDB\u5339\u914D",
+      PHRASE: "\u8BCD\u7EC4\u5339\u914D",
+      EXACT: "\u7CBE\u786E\u5339\u914D",
+      NEAR_PHRASE: "\u8FD1\u4E49\u8BCD\u7EC4\u5339\u914D",
+      NEAR_EXACT: "\u8FD1\u4E49\u7CBE\u786E\u5339\u914D",
+      Broad: "\u5E7F\u6CDB\u5339\u914D",
+      Phrase: "\u8BCD\u7EC4\u5339\u914D",
+      Exact: "\u7CBE\u786E\u5339\u914D",
+      Near_Phrase: "\u8FD1\u4E49\u8BCD\u7EC4\u5339\u914D",
+      Near_Exact: "\u8FD1\u4E49\u7CBE\u786E\u5339\u914D"
+    };
+  }
+});
+
+// src/commands/google-analysis/geo-en2zh.json
+var geo_en2zh_default;
+var init_geo_en2zh = __esm({
+  "src/commands/google-analysis/geo-en2zh.json"() {
+    geo_en2zh_default = {
+      Afghanistan: "\u963F\u5BCC\u6C57",
+      Albania: "\u963F\u5C14\u5DF4\u5C3C\u4E9A",
+      Algeria: "\u963F\u5C14\u53CA\u5229\u4E9A",
+      Andorra: "\u5B89\u9053\u5C14",
+      Angola: "\u5B89\u54E5\u62C9",
+      "Antigua & Barbuda": "\u5B89\u63D0\u74DC\u548C\u5DF4\u5E03\u8FBE",
+      "Antigua and Barbuda": "\u5B89\u63D0\u74DC\u548C\u5DF4\u5E03\u8FBE",
+      Argentina: "\u963F\u6839\u5EF7",
+      Armenia: "\u4E9A\u7F8E\u5C3C\u4E9A",
+      Australia: "\u6FB3\u5927\u5229\u4E9A",
+      Austria: "\u5965\u5730\u5229",
+      Azerbaijan: "\u963F\u585E\u62DC\u7586",
+      Bahamas: "\u5DF4\u54C8\u9A6C",
+      Bahrain: "\u5DF4\u6797",
+      Bangladesh: "\u5B5F\u52A0\u62C9\u56FD",
+      Barbados: "\u5DF4\u5DF4\u591A\u65AF",
+      Belarus: "\u767D\u4FC4\u7F57\u65AF",
+      Belgium: "\u6BD4\u5229\u65F6",
+      Belize: "\u4F2F\u5229\u5179",
+      Benin: "\u8D1D\u5B81",
+      Bhutan: "\u4E0D\u4E39",
+      Bolivia: "\u73BB\u5229\u7EF4\u4E9A",
+      "Bosnia & Herzegovina": "\u6CE2\u65AF\u5C3C\u4E9A\u548C\u9ED1\u585E\u54E5\u7EF4\u90A3",
+      "Bosnia and Herzegovina": "\u6CE2\u65AF\u5C3C\u4E9A\u548C\u9ED1\u585E\u54E5\u7EF4\u90A3",
+      Botswana: "\u535A\u8328\u74E6\u7EB3",
+      Brazil: "\u5DF4\u897F",
+      Brunei: "\u6587\u83B1",
+      Bulgaria: "\u4FDD\u52A0\u5229\u4E9A",
+      "Burkina Faso": "\u5E03\u57FA\u7EB3\u6CD5\u7D22",
+      Burundi: "\u5E03\u9686\u8FEA",
+      "Cabo Verde": "\u4F5B\u5F97\u89D2",
+      Cambodia: "\u67EC\u57D4\u5BE8",
+      Cameroon: "\u5580\u9EA6\u9686",
+      Canada: "\u52A0\u62FF\u5927",
+      "Central African Republic": "\u4E2D\u975E\u5171\u548C\u56FD",
+      Chad: "\u4E4D\u5F97",
+      Chile: "\u667A\u5229",
+      China: "\u4E2D\u56FD",
+      Colombia: "\u54E5\u4F26\u6BD4\u4E9A",
+      Comoros: "\u79D1\u6469\u7F57",
+      "Costa Rica": "\u54E5\u65AF\u8FBE\u9ECE\u52A0",
+      "Cote d'Ivoire": "\u79D1\u7279\u8FEA\u74E6",
+      Croatia: "\u514B\u7F57\u5730\u4E9A",
+      Cuba: "\u53E4\u5DF4",
+      Cyprus: "\u585E\u6D66\u8DEF\u65AF",
+      Czechia: "\u6377\u514B",
+      "Democratic Republic of the Congo": "\u521A\u679C\u6C11\u4E3B\u5171\u548C\u56FD",
+      Denmark: "\u4E39\u9EA6",
+      Djibouti: "\u5409\u5E03\u63D0",
+      Dominica: "\u591A\u7C73\u5C3C\u514B",
+      "Dominican Republic": "\u591A\u7C73\u5C3C\u52A0\u5171\u548C\u56FD",
+      Ecuador: "\u5384\u74DC\u591A\u5C14",
+      Egypt: "\u57C3\u53CA",
+      "El Salvador": "\u8428\u5C14\u74E6\u591A",
+      "Equatorial Guinea": "\u8D64\u9053\u51E0\u5185\u4E9A",
+      Eritrea: "\u5384\u7ACB\u7279\u91CC\u4E9A",
+      Estonia: "\u7231\u6C99\u5C3C\u4E9A",
+      Eswatini: "\u65AF\u5A01\u58EB\u5170",
+      Ethiopia: "\u57C3\u585E\u4FC4\u6BD4\u4E9A",
+      Fiji: "\u6590\u6D4E",
+      Finland: "\u82AC\u5170",
+      France: "\u6CD5\u56FD",
+      Gabon: "\u52A0\u84EC",
+      Gambia: "\u5188\u6BD4\u4E9A",
+      Georgia: "\u683C\u9C81\u5409\u4E9A",
+      Germany: "\u5FB7\u56FD",
+      Ghana: "\u52A0\u7EB3",
+      Greece: "\u5E0C\u814A",
+      Grenada: "\u683C\u6797\u7EB3\u8FBE",
+      Guatemala: "\u5371\u5730\u9A6C\u62C9",
+      Guinea: "\u51E0\u5185\u4E9A",
+      "Guinea-Bissau": "\u51E0\u5185\u4E9A\u6BD4\u7ECD",
+      Guyana: "\u572D\u4E9A\u90A3",
+      Haiti: "\u6D77\u5730",
+      Honduras: "\u6D2A\u90FD\u62C9\u65AF",
+      "Hong Kong": "\u9999\u6E2F",
+      Hungary: "\u5308\u7259\u5229",
+      Iceland: "\u51B0\u5C9B",
+      India: "\u5370\u5EA6",
+      Indonesia: "\u5370\u5EA6\u5C3C\u897F\u4E9A",
+      Iran: "\u4F0A\u6717",
+      Iraq: "\u4F0A\u62C9\u514B",
+      Ireland: "\u7231\u5C14\u5170",
+      "Isle of Man": "\u9A6C\u6069\u5C9B",
+      Israel: "\u4EE5\u8272\u5217",
+      Italy: "\u610F\u5927\u5229",
+      Jamaica: "\u7259\u4E70\u52A0",
+      Japan: "\u65E5\u672C",
+      Johannesburg: "\u7EA6\u7FF0\u5185\u65AF\u5821",
+      Jordan: "\u7EA6\u65E6",
+      Kazakhstan: "\u54C8\u8428\u514B\u65AF\u5766",
+      Kenya: "\u80AF\u5C3C\u4E9A",
+      Kiribati: "\u57FA\u91CC\u5DF4\u65AF",
+      Kosovo: "\u79D1\u7D22\u6C83",
+      Kuwait: "\u79D1\u5A01\u7279",
+      Kyrgyzstan: "\u5409\u5C14\u5409\u65AF\u65AF\u5766",
+      Laos: "\u8001\u631D",
+      Latvia: "\u62C9\u8131\u7EF4\u4E9A",
+      Lebanon: "\u9ECE\u5DF4\u5AE9",
+      Lesotho: "\u83B1\u7D22\u6258",
+      Liberia: "\u5229\u6BD4\u91CC\u4E9A",
+      Libya: "\u5229\u6BD4\u4E9A",
+      Liechtenstein: "\u5217\u652F\u6566\u58EB\u767B",
+      Lithuania: "\u7ACB\u9676\u5B9B",
+      Luxembourg: "\u5362\u68EE\u5821",
+      Macau: "\u6FB3\u95E8",
+      Madagascar: "\u9A6C\u8FBE\u52A0\u65AF\u52A0",
+      Malawi: "\u9A6C\u62C9\u7EF4",
+      Malaysia: "\u9A6C\u6765\u897F\u4E9A",
+      Maldives: "\u9A6C\u5C14\u4EE3\u592B",
+      Mali: "\u9A6C\u91CC",
+      Malta: "\u9A6C\u8033\u4ED6",
+      "Marshall Islands": "\u9A6C\u7ECD\u5C14\u7FA4\u5C9B",
+      Mauritania: "\u6BDB\u91CC\u5854\u5C3C\u4E9A",
+      Mauritius: "\u6BDB\u91CC\u6C42\u65AF",
+      Mexico: "\u58A8\u897F\u54E5",
+      Micronesia: "\u5BC6\u514B\u7F57\u5C3C\u897F\u4E9A",
+      Moldova: "\u6469\u5C14\u591A\u74E6",
+      Monaco: "\u6469\u7EB3\u54E5",
+      Mongolia: "\u8499\u53E4",
+      Montenegro: "\u9ED1\u5C71",
+      Morocco: "\u6469\u6D1B\u54E5",
+      Mozambique: "\u83AB\u6851\u6BD4\u514B",
+      "Myanmar (Burma)": "\u7F05\u7538",
+      Namibia: "\u7EB3\u7C73\u6BD4\u4E9A",
+      Nauru: "\u7459\u9C81",
+      Nepal: "\u5C3C\u6CCA\u5C14",
+      Netherlands: "\u8377\u5170",
+      "New Zealand": "\u65B0\u897F\u5170",
+      Nicaragua: "\u5C3C\u52A0\u62C9\u74DC",
+      Niger: "\u5C3C\u65E5\u5C14",
+      Nigeria: "\u5C3C\u65E5\u5229\u4E9A",
+      "North Korea": "\u671D\u9C9C",
+      "North Macedonia": "\u5317\u9A6C\u5176\u987F",
+      Norway: "\u632A\u5A01",
+      Oman: "\u963F\u66FC",
+      Pakistan: "\u5DF4\u57FA\u65AF\u5766",
+      Palau: "\u5E15\u52B3",
+      Palestine: "\u5DF4\u52D2\u65AF\u5766",
+      Panama: "\u5DF4\u62FF\u9A6C",
+      "Papua New Guinea": "\u5DF4\u5E03\u4E9A\u65B0\u51E0\u5185\u4E9A",
+      Paraguay: "\u5DF4\u62C9\u572D",
+      Peru: "\u79D8\u9C81",
+      Philippines: "\u83F2\u5F8B\u5BBE",
+      Poland: "\u6CE2\u5170",
+      Portugal: "\u8461\u8404\u7259",
+      "Puerto Rico": "\u6CE2\u591A\u9ECE\u5404",
+      Qatar: "\u5361\u5854\u5C14",
+      "Republic of the Congo": "\u521A\u679C\u5171\u548C\u56FD",
+      Romania: "\u7F57\u9A6C\u5C3C\u4E9A",
+      Russia: "\u4FC4\u7F57\u65AF",
+      Rwanda: "\u5362\u65FA\u8FBE",
+      "Saint Kitts and Nevis": "\u5723\u57FA\u8328\u548C\u5C3C\u7EF4\u65AF",
+      "Saint Lucia": "\u5723\u5362\u897F\u4E9A",
+      "Saint Vincent and the Grenadines": "\u5723\u6587\u68EE\u7279\u548C\u683C\u6797\u7EB3\u4E01\u65AF",
+      Samoa: "\u8428\u6469\u4E9A",
+      "San Marino": "\u5723\u9A6C\u529B\u8BFA",
+      "S\xE3o Tom\xE9 & Pr\xEDncipe": "\u5723\u591A\u7F8E\u548C\u666E\u6797\u897F\u6BD4",
+      "Sao Tome and Principe": "\u5723\u591A\u7F8E\u548C\u666E\u6797\u897F\u6BD4",
+      "Saudi Arabia": "\u6C99\u7279\u963F\u62C9\u4F2F",
+      Senegal: "\u585E\u5185\u52A0\u5C14",
+      Serbia: "\u585E\u5C14\u7EF4\u4E9A",
+      Seychelles: "\u585E\u820C\u5C14",
+      "Sierra Leone": "\u585E\u62C9\u5229\u6602",
+      Singapore: "\u65B0\u52A0\u5761",
+      Slovakia: "\u65AF\u6D1B\u4F10\u514B",
+      Slovenia: "\u65AF\u6D1B\u6587\u5C3C\u4E9A",
+      "Solomon Islands": "\u6240\u7F57\u95E8\u7FA4\u5C9B",
+      Somalia: "\u7D22\u9A6C\u91CC",
+      "South Africa": "\u5357\u975E",
+      "South Korea": "\u97E9\u56FD",
+      "South Sudan": "\u5357\u82CF\u4E39",
+      Spain: "\u897F\u73ED\u7259",
+      "Spanish Fork": "Spanish Fork",
+      "Sri Lanka": "\u65AF\u91CC\u5170\u5361",
+      "St. Kitts & Nevis": "\u5723\u57FA\u8328\u548C\u5C3C\u7EF4\u65AF",
+      "St. Lucia": "\u5723\u5362\u897F\u4E9A",
+      "St. Vincent & Grenadines": "\u5723\u6587\u68EE\u7279\u548C\u683C\u6797\u7EB3\u4E01\u65AF",
+      Sudan: "\u82CF\u4E39",
+      Suriname: "\u82CF\u91CC\u5357",
+      Sweden: "\u745E\u5178",
+      Switzerland: "\u745E\u58EB",
+      Syria: "\u53D9\u5229\u4E9A",
+      Taiwan: "\u53F0\u6E7E",
+      Tajikistan: "\u5854\u5409\u514B\u65AF\u5766",
+      Tanzania: "\u5766\u6851\u5C3C\u4E9A",
+      Thailand: "\u6CF0\u56FD",
+      "Timor-Leste": "\u4E1C\u5E1D\u6C76",
+      Togo: "\u591A\u54E5",
+      Tonga: "\u6C64\u52A0",
+      "Trinidad & Tobago": "\u7279\u7ACB\u5C3C\u8FBE\u548C\u591A\u5DF4\u54E5",
+      "Trinidad and Tobago": "\u7279\u7ACB\u5C3C\u8FBE\u548C\u591A\u5DF4\u54E5",
+      Tunisia: "\u7A81\u5C3C\u65AF",
+      Turkiye: "\u571F\u8033\u5176",
+      Turkmenistan: "\u571F\u5E93\u66FC\u65AF\u5766",
+      Tuvalu: "\u56FE\u74E6\u5362",
+      Uganda: "\u4E4C\u5E72\u8FBE",
+      Ukraine: "\u4E4C\u514B\u5170",
+      "United Arab Emirates": "\u963F\u8054\u914B",
+      "United Kingdom": "\u82F1\u56FD",
+      "United States": "\u7F8E\u56FD",
+      Uruguay: "\u4E4C\u62C9\u572D",
+      Uzbekistan: "\u4E4C\u5179\u522B\u514B\u65AF\u5766",
+      Vanuatu: "\u74E6\u52AA\u963F\u56FE",
+      "Vatican City": "\u68B5\u8482\u5188",
+      Venezuela: "\u59D4\u5185\u745E\u62C9",
+      Vietnam: "\u8D8A\u5357",
+      Yemen: "\u4E5F\u95E8",
+      Zambia: "\u8D5E\u6BD4\u4E9A",
+      Zimbabwe: "\u6D25\u5DF4\u5E03\u97E6"
+    };
+  }
+});
+
+// src/commands/google-analysis/translate-fields.ts
+function lookupZh(dict, key) {
+  if (typeof key !== "string" || key === "") return void 0;
+  return dict[key];
+}
+function annotateRow(row, source, target, dict) {
+  if (row[target] !== void 0) return;
+  const zh = lookupZh(dict, row[source]);
+  if (zh !== void 0) row[target] = zh;
+}
+function annotateArrayRows(rows, source, target, dict) {
+  if (!Array.isArray(rows)) return;
+  for (const r of rows) {
+    if (r && typeof r === "object" && !Array.isArray(r)) {
+      annotateRow(r, source, target, dict);
+    }
+  }
+}
+function annotateZhFields(payload, section) {
+  if (payload === null || typeof payload !== "object") return payload;
+  switch (section) {
+    case "keywords": {
+      const rows = payload.keywords;
+      annotateArrayRows(rows, "keywordMatchType", "keywordMatchTypeZh", MATCH_TYPE_DICT);
+      break;
+    }
+    case "search-terms": {
+      const rows = payload.data;
+      annotateArrayRows(rows, "matchType", "matchTypeZh", MATCH_TYPE_DICT);
+      break;
+    }
+    case "campaign-geo": {
+      const rows = payload.countries;
+      annotateArrayRows(rows, "countryOrRegion", "countryOrRegionZh", GEO_DICT);
+      break;
+    }
+    default:
+      break;
+  }
+  return payload;
+}
+var MATCH_TYPE_DICT, GEO_DICT;
+var init_translate_fields = __esm({
+  "src/commands/google-analysis/translate-fields.ts"() {
+    "use strict";
+    init_match_type_en2zh();
+    init_geo_en2zh();
+    MATCH_TYPE_DICT = match_type_en2zh_default;
+    GEO_DICT = geo_en2zh_default;
+  }
+});
+
 // src/commands/google-analysis/fetch.ts
 function defaultDateRange3() {
   const end = /* @__PURE__ */ new Date();
@@ -4870,6 +5250,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)}`);
 }
@@ -4968,7 +5373,27 @@ async function fetchSectionPayload(def, opts, config, id) {
       fetchJson(config, videoPath, !!opts.verbose)
     ]);
     const merged = { images, videos };
-    return stripLegacyGoogleFieldsIfV2Present(merged);
+    return annotateZhFields(
+      normalizeRateScales(stripLegacyGoogleFieldsIfV2Present(merged), "materials"),
+      "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);
@@ -4980,7 +5405,10 @@ async function fetchSectionPayload(def, opts, config, id) {
     const url = `${config.apiBaseUrl}/report/media-account/google/account-daily-reports?${params.toString()}`;
     const raw = await apiFetch2(url, config, {}, !!opts.verbose);
     const rows = rowsFromAccountDailyReportsEnvelope(raw, id);
-    return stripLegacyGoogleFieldsIfV2Present(rows);
+    return annotateZhFields(
+      normalizeRateScales(stripLegacyGoogleFieldsIfV2Present(rows), "daily-metrics"),
+      "daily-metrics"
+    );
   }
   const sectionPath = def.path(id);
   const query = buildSearchParams(def, opts.start, opts.end, extras);
@@ -4990,7 +5418,10 @@ async function fetchSectionPayload(def, opts, config, id) {
     !!opts.verbose,
     def.name
   );
-  return stripLegacyGoogleFieldsIfV2Present(data);
+  return annotateZhFields(
+    normalizeRateScales(stripLegacyGoogleFieldsIfV2Present(data), def.name),
+    def.name
+  );
 }
 function endpointHintForSection(def) {
   if (def.name === "materials") return "CampaignAssetView+Videos";
@@ -5030,6 +5461,8 @@ var init_fetch = __esm({
     init_auth();
     init_strip_legacy_google_fields();
     init_sections();
+    init_normalize_rates();
+    init_translate_fields();
   }
 });
 
@@ -6573,7 +7006,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(
@@ -6664,6 +7097,8 @@ var init_google_analysis2 = __esm({
     "use strict";
     init_sections();
     init_fetch();
+    init_normalize_rates();
+    init_translate_fields();
     init_register_cli();
   }
 });

package/dist/skill/SKILL.md

@@ -2,10 +2,7 @@
 name: siluzan-tso
 description: >-
   Siluzan TSO 广告 skill（siluzan-tso-cli）：Google/Bing/Yandex/TikTok/Kwai 账户开户、授权与分享、数据与消耗、Google 广告管理、发票与转账、优化报告与智能预警、TikTok/Meta 线索。
-  写 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`（不新增拉数子命令）；**多 Sheet Excel 由 Agent 落盘后写脚本生成**，CLI **不**提供内置「写 Excel」子命令。
+  各能力执行细节按本文「功能以及对应文档」表路由到 references/；周期报告、OKKI 周报、Google 账户询盘分析等固定触发模板见 report-templates/ 与 REPORT-WORKFLOW.md。
 license: MIT
 metadata:
   requires: nodejs,siluzan-tso-cli
@@ -57,6 +54,8 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 | `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 周报**：固定话术 + 精简维度 CLI 拉数；**Excel 由 Agent 脚本写**（见 P6），无 CLI 内置写表命令                                                                                                                                                                                                                                        |
+| `report-templates/google-inquiry-analysis.md`  | **Google 询盘分析**：固定话术（`Goog账户询盘分析` 等）→ 严格 3 个月窗口 + 用户上传询盘资料 + 8 Sheet xlsx（见 P7）；国家→大洲映射见 `references/geo-continents.json`                                                                                                                                                                       |
+| `references/geo-continents.json`               | 国家中文名 → 7 大洲映射（亚洲/中东/欧洲/北美/南美/非洲/大洋洲），供询盘分析 Sheet 3 大洲透视 / Sheet 4 重点国切片（重点国可配置）使用                                                                                                                                                                                                       |
 
 ---
 
@@ -255,6 +254,33 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
    - **强制顺序**：先 `fs.readFileSync(outlineFile,'utf8')` 读 outline 的最后一行（TS 式类型，几百字节）→ 再写聚合脚本 → 由脚本 `require()` 真实 JSON 做计算。**禁止**直接 `Read` JSON 看结构——批跑常见 `keywords-*.json` 数 MB × N 账户，几次 `Read` 就把对话窗口塞满。
    - 注意 outline 是 **`.outline.txt`** 不是 `.outline.json`，**禁止 `require()`**；其第 1 行注释明确写了 `// schema-only, NOT the data.`，**禁止**把它当业务数据贴给用户。
 
+### P7 · Google 账户询盘分析（运营固定模板）
+
+> **触发**：用户话术含 **`Goog账户询盘分析`** / **`Google 账户询盘分析`** / **`分析XXX Google账号的询盘效果`** / **`我给你询盘信息分析Google账号XXX效果`**，或同时包含「询盘 + 账户 + Google」三要素。
+>
+> **不要**按 `google-period-report.md` 默认 8 维流程；改读 **`report-templates/google-inquiry-analysis.md`** 全文并按其结构交付。
+
+1. **时间窗口强约束**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月。**禁止**扩展到 7 个月（即使样表里有 7 个月）；样表的 4~7 列旧数据由 Agent 在 Sheet 4/6 中跨 7 月写时**留空或不写**，仅写当前 3 月。
+2. **询盘资料入场**：
+   - **流程 A**（用户已附文件）：宿主 Agent 解析任意载体（xlsx/csv/pdf/截图/文本表格）→ 抽取询盘行 → 落盘 `./snap-inquiry/inquiries.json`（字段见模板「询盘字段清单」）。
+   - **流程 B**（仅给账户 ID）：先反问账户 + 分析月份，同时贴出字段清单 + 1 行示例让用户回贴/上传。**禁止**自行编造询盘数据。
+3. **CLI 拉数**（同一 `--json-out` 目录）：
+   ```bash
+   siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-inquiry
+   siluzan-tso google-analysis -a <mediaCustomerId> \
+     --start <S> --end <D> \
+     --sections daily-metrics,campaigns,keywords,search-terms,campaign-geo,geographic \
+     --json-out ./snap-inquiry
+   # Sheet 6 月份×国家明细：3 次月度 geographic 循环
+   siluzan-tso google-analysis -a <mediaCustomerId> --start <M1S> --end <M1E> --sections geographic --json-out ./snap-inquiry/m1
+   siluzan-tso google-analysis -a <mediaCustomerId> --start <M2S> --end <M2E> --sections geographic --json-out ./snap-inquiry/m2
+   siluzan-tso google-analysis -a <mediaCustomerId> --start <M3S> --end <M3E> --sections geographic --json-out ./snap-inquiry/m3
+   ```
+4. **先 outline 后脚本**：与 P6 同纪律。读各 `*.outline.txt` 拿字段结构 → 写聚合脚本读 JSON → 计算 8 Sheet 数据。
+5. **国家 → 大洲映射**：脚本里读 `references/geo-continents.json`，未命中标 `未知大洲` 不阻塞，结尾打印未命中清单。Sheet 4「重点国 vs 非重点国」切片：按 `focusCountries`（中文国家名数组，运营未指定时默认取分析月询盘 Top1 国家，详见 `report-templates/google-inquiry-analysis.md`「重点国家配置」节）判桶，无需走大洲表；**禁止**在脚本中硬编码任何具体国家名。
+6. **必产 8 Sheet xlsx**：版式/Sheet 名/列定义/数值格式以 `report-templates/google-inquiry-analysis.md` 为准；**只能**由 Agent 在当前环境执行脚本（Node `xlsx`/`exceljs`，Python `openpyxl` 均可）生成，**禁止**假设 `siluzan-tso … excel` 这类 CLI 子命令存在。
+7. 遵守 SKILL 硬规范：金额 `*Display`、`budgetAmount` 是分（÷100）、禁止手填业务数、禁止编造 ID。
+
 ---
 
 ## Tips

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.19-beta.8",
-  "publishedAt": 1778652640240
+  "version": "1.1.19",
+  "publishedAt": 1778754808006
 }