siluzan-tso-cli 1.1.20-beta.14 → 1.1.20-beta.15

package/README.md

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

package/dist/index.js

@@ -2418,12 +2418,12 @@ function createVersionNotifier(opts) {
   const HOURS_24 = 24 * 60 * 60 * 1e3;
   const TTL_MAIN_TAG_MS = 60 * 60 * 1e3;
   const TTL_MIN_REQUIRED_MS = HOURS_24;
-  async function fetchVersionByTag(tag, cacheKey, fetchAtKey, cfg, maxAgeMs) {
+  async function fetchVersionByTag(tag, cacheKey2, fetchAtKey, cfg, maxAgeMs) {
     const lastAt = cfg[fetchAtKey];
-    if (typeof lastAt === "string" && cacheKey in cfg) {
+    if (typeof lastAt === "string" && cacheKey2 in cfg) {
       const lastMs = new Date(lastAt).getTime();
       if (Date.now() - lastMs < maxAgeMs) {
-        const v = cfg[cacheKey];
+        const v = cfg[cacheKey2];
         const sv = typeof v === "string" && v ? v : null;
         return { version: sv, hitNetwork: false };
       }
@@ -4118,7 +4118,7 @@ async function fetchBalanceMap(media, accountIds, config, startDate, endDate, ve
   return result;
 }
 function parseGoogleAccountSpendOverviewRows(raw) {
-  const microsToYuan2 = (v) => {
+  const microsToYuan = (v) => {
     if (v == null) return null;
     const n = Number(v);
     if (!Number.isFinite(n)) return null;
@@ -4138,8 +4138,8 @@ function parseGoogleAccountSpendOverviewRows(raw) {
       currencyCode: it.currencyCode ?? void 0,
       status: it.status ?? void 0,
       remainingAccountBudget: typeof it.remainingAccountBudget === "number" ? it.remainingAccountBudget : void 0,
-      adjustedSpendingLimitYuan: microsToYuan2(it.adjustedSpendingLimitMicros),
-      lastCostYuan: microsToYuan2(it.lastCostMicros)
+      adjustedSpendingLimitYuan: microsToYuan(it.adjustedSpendingLimitMicros),
+      lastCostYuan: microsToYuan(it.lastCostMicros)
     };
   };
   if (Array.isArray(raw)) {
@@ -114107,6 +114107,59 @@ function register20(program2) {
 
 // src/commands/keyword.ts
 init_auth();
+
+// src/utils/usd-cny-rate.ts
+init_auth();
+var RATE_CACHE_TTL_MS = 10 * 60 * 1e3;
+var rateCache = null;
+function cacheKey(config) {
+  return `${config.apiBaseUrl.replace(/\/$/, "")}|USD|CNY`;
+}
+function parseExrate(data) {
+  if (data == null || typeof data !== "object") return null;
+  const raw = data.exrate;
+  const n = typeof raw === "string" ? Number(raw) : Number(raw);
+  if (!Number.isFinite(n) || n <= 0) return null;
+  return n;
+}
+async function getUsdToCnyExchangeRate(config, verbose) {
+  const key = cacheKey(config);
+  const now = Date.now();
+  if (rateCache && rateCache.key === key && now - rateCache.fetchedAt < RATE_CACHE_TTL_MS) {
+    if (verbose) {
+      console.error(`  [\u6C47\u7387] \u4F7F\u7528\u7F13\u5B58 USD\u2192CNY=${rateCache.rate}\uFF08${Math.round((now - rateCache.fetchedAt) / 1e3)}s \u524D\uFF09`);
+    }
+    return rateCache.rate;
+  }
+  const base = config.apiBaseUrl.replace(/\/$/, "");
+  const url = `${base}/allinpay/GetRate?srcccy=USD&dstccy=CNY`;
+  try {
+    const data = await apiFetch2(url, config, { method: "GET" }, verbose);
+    const rate = parseExrate(data);
+    if (rate == null) {
+      console.error("\n\u26A0 \u83B7\u53D6\u6C47\u7387\u5931\u8D25\uFF1AGetRate \u672A\u8FD4\u56DE\u6709\u6548 exrate\uFF0C\u51FA\u4EF7 CNY \u5B57\u6BB5\u5C06\u7701\u7565\u3002\n");
+      return null;
+    }
+    rateCache = { key, rate, fetchedAt: now };
+    if (verbose) {
+      console.error(`  [\u6C47\u7387] USD\u2192CNY=${rate}\uFF08\u5DF2\u7F13\u5B58 ${RATE_CACHE_TTL_MS / 6e4} \u5206\u949F\uFF09`);
+    }
+    return rate;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`
+\u26A0 \u83B7\u53D6 USD\u2192CNY \u6C47\u7387\u5931\u8D25\uFF08\u51FA\u4EF7 CNY \u5B57\u6BB5\u5C06\u7701\u7565\uFF09\uFF1A${msg}
+`);
+    return null;
+  }
+}
+function convertUsdToCny(amountUsd, rate) {
+  if (amountUsd == null || !Number.isFinite(amountUsd)) return null;
+  if (!Number.isFinite(rate) || rate <= 0) return null;
+  return Math.round(amountUsd * rate * 100) / 100;
+}
+
+// src/commands/keyword.ts
 init_cli_json_snapshot();
 init_cli_table();
 
@@ -114169,12 +114222,25 @@ function requireGoogleApi2(config) {
   return config.googleApiUrl;
 }
 var KEYWORD_SUGGEST_BID_AMOUNT_CURRENCY = "USD";
-function buildKeywordSuggestJsonPayload(items) {
-  const yuanItems = items.map(microsItemToYuan);
-  const n = yuanItems.length;
+function applyUsdBidAmountsInCny(item, usdToCnyRate) {
+  return {
+    ...item,
+    averageCpcCNY: convertUsdToCny(item.averageCpcUSD, usdToCnyRate),
+    lowTopOfPageBidCNY: convertUsdToCny(item.lowTopOfPageBidUSD, usdToCnyRate),
+    highTopOfPageBidCNY: convertUsdToCny(item.highTopOfPageBidUSD, usdToCnyRate)
+  };
+}
+function buildKeywordSuggestJsonPayload(items, opts) {
+  let usdItems = items.map(microsItemToUSD);
+  const rate = opts?.usdToCnyRate;
+  if (rate != null && Number.isFinite(rate) && rate > 0) {
+    usdItems = usdItems.map((row) => applyUsdBidAmountsInCny(row, rate));
+  }
+  const n = usdItems.length;
   return {
-    ...wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: yuanItems }),
-    bidAmountCurrency: KEYWORD_SUGGEST_BID_AMOUNT_CURRENCY
+    ...wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: usdItems }),
+    bidAmountCurrency: KEYWORD_SUGGEST_BID_AMOUNT_CURRENCY,
+    ...rate != null && Number.isFinite(rate) && rate > 0 ? { usdToCnyExchangeRate: rate } : {}
   };
 }
 async function fetchUrlKeywords(url, keywords, verbose) {
@@ -114329,8 +114395,9 @@ async function runKeywordSuggest(opts) {
     });
   }
   const n = items.length;
-  const kwPayload = buildKeywordSuggestJsonPayload(items);
-  const yuanItems = kwPayload.items;
+  const usdToCnyRate = await getUsdToCnyExchangeRate(config, opts.verbose);
+  const kwPayload = buildKeywordSuggestJsonPayload(items, { usdToCnyRate });
+  const usdItems = kwPayload.items;
   if (await emitCliJsonOrSnapshot(opts, {
     section: "keyword-suggest",
     commandLabel: "keyword suggest",
@@ -114345,49 +114412,107 @@ async function runKeywordSuggest(opts) {
     console.log("  \u6682\u65E0\u63A8\u8350\u5173\u952E\u8BCD\u3002\n");
     return;
   }
-  const cols = [
+  const fmtAmt = (v) => v != null && Number.isFinite(v) ? v.toFixed(2) : "\u2014";
+  const hasCny = usdToCnyRate != null && usdToCnyRate > 0;
+  const cols = hasCny ? [
     { key: "keyword", header: "\u5173\u952E\u8BCD" },
     { key: "montlySearch", header: "\u6708\u5747\u641C\u7D22" },
-    { key: "cpc", header: "\u5E73\u5747CPC(USD)" },
-    { key: "bidRange", header: "\u9875\u9996\u51FA\u4EF7\u533A\u95F4(USD)" },
+    { key: "cpcUsd", header: "\u5E73\u5747CPC(USD)" },
+    { key: "cpcCny", header: "\u5E73\u5747CPC(CNY)" },
+    { key: "bidRangeUsd", header: "\u9875\u9996\u51FA\u4EF7(USD)" },
+    { key: "bidRangeCny", header: "\u9875\u9996\u51FA\u4EF7(CNY)" },
+    { key: "competition", header: "\u7ADE\u4E89\u5EA6" }
+  ] : [
+    { key: "keyword", header: "\u5173\u952E\u8BCD" },
+    { key: "montlySearch", header: "\u6708\u5747\u641C\u7D22" },
+    { key: "cpcUsd", header: "\u5E73\u5747CPC(USD)" },
+    { key: "bidRangeUsd", header: "\u9875\u9996\u51FA\u4EF7(USD)" },
     { key: "competition", header: "\u7ADE\u4E89\u5EA6" }
   ];
-  const fmtYuan = (v) => v != null && Number.isFinite(v) ? v.toFixed(2) : "\u2014";
-  const rows = yuanItems.map((item) => {
-    const cpc = fmtYuan(item.averageCpcYuan);
-    const low = fmtYuan(item.lowTopOfPageBidYuan);
-    const high = fmtYuan(item.highTopOfPageBidYuan);
-    const bidRange = low === "\u2014" && high === "\u2014" ? "\u2014" : `${low} ~ ${high}`;
+  const rows = usdItems.map((item) => {
+    const cpcUsd = fmtAmt(item.averageCpcUSD);
+    const lowUsd = fmtAmt(item.lowTopOfPageBidUSD);
+    const highUsd = fmtAmt(item.highTopOfPageBidUSD);
+    const bidRangeUsd = lowUsd === "\u2014" && highUsd === "\u2014" ? "\u2014" : `${lowUsd} ~ ${highUsd}`;
     const competitionDisplay = item.competitionV2 ?? (item.competition != null ? item.competition.toFixed(2) : "\u2014");
-    return {
+    const row = {
       keyword: item.keyword ?? "",
       montlySearch: String(item.montlySearch ?? "\u2014"),
-      cpc,
-      bidRange,
+      cpcUsd,
+      bidRangeUsd,
       competition: competitionDisplay
     };
+    if (hasCny) {
+      const cpcCny = fmtAmt(item.averageCpcCNY);
+      const lowCny = fmtAmt(item.lowTopOfPageBidCNY);
+      const highCny = fmtAmt(item.highTopOfPageBidCNY);
+      row.cpcCny = cpcCny;
+      row.bidRangeCny = lowCny === "\u2014" && highCny === "\u2014" ? "\u2014" : `${lowCny} ~ ${highCny}`;
+    }
+    return row;
   });
   printCliTable(rows, cols);
-  console.log();
+  if (hasCny) {
+    console.log(`  \uFF08USD\u2192CNY \u6C47\u7387 ${usdToCnyRate}\uFF0C\u7F13\u5B58 10 \u5206\u949F\uFF1BJSON \u542B averageCpcCNY \u7B49\u5B57\u6BB5\uFF09
+`);
+  } else {
+    console.log();
+  }
 }
-function microsToYuan(v) {
+function microsToUSD(v) {
   if (v == null) return null;
   const n = Number(v);
   if (!Number.isFinite(n)) return null;
   return Math.round(n / 1e6 * 100) / 100;
 }
-function microsItemToYuan(item) {
+function legacyUsdAmount(...candidates) {
+  for (const v of candidates) {
+    if (v != null && Number.isFinite(v)) return v;
+  }
+  return null;
+}
+function microsItemToUSD(item) {
   const {
     averageCpc: _legacyCpc,
     lowTopOfPageBidMicros: _legacyLow,
     highTopOfPageBidMicros: _legacyHigh,
+    averageCpcYuan: _legacyCpcYuan,
+    lowTopOfPageBidYuan: _legacyLowYuan,
+    highTopOfPageBidYuan: _legacyHighYuan,
+    averageCpcUSD: _existingCpcUsd,
+    lowTopOfPageBidUSD: _existingLowUsd,
+    highTopOfPageBidUSD: _existingHighUsd,
+    averageCpcDollar: _legacyCpcDollar,
+    lowTopOfPageBidDollar: _legacyLowDollar,
+    highTopOfPageBidDollar: _legacyHighDollar,
+    averageCpcCny: _dropCny1,
+    lowTopOfPageBidCny: _dropCny2,
+    highTopOfPageBidCny: _dropCny3,
+    averageCpcCNY: _dropCny4,
+    lowTopOfPageBidCNY: _dropCny5,
+    highTopOfPageBidCNY: _dropCny6,
     ...rest
   } = item;
   return {
     ...rest,
-    averageCpcYuan: microsToYuan(_legacyCpc),
-    lowTopOfPageBidYuan: microsToYuan(_legacyLow),
-    highTopOfPageBidYuan: microsToYuan(_legacyHigh)
+    averageCpcUSD: legacyUsdAmount(
+      microsToUSD(_legacyCpc),
+      _existingCpcUsd,
+      _legacyCpcDollar,
+      _legacyCpcYuan
+    ),
+    lowTopOfPageBidUSD: legacyUsdAmount(
+      microsToUSD(_legacyLow),
+      _existingLowUsd,
+      _legacyLowDollar,
+      _legacyLowYuan
+    ),
+    highTopOfPageBidUSD: legacyUsdAmount(
+      microsToUSD(_legacyHigh),
+      _existingHighUsd,
+      _legacyHighDollar,
+      _legacyHighYuan
+    )
   };
 }
 function attachBaseCliOptions(cmd) {
@@ -115575,8 +115700,8 @@ async function runAccountWithdrawSubmit(opts) {
   });
   const feeRateCache = /* @__PURE__ */ new Map();
   for (const { currency, availableAmount } of accountDetails) {
-    const cacheKey = `${currency}-${availableAmount.toFixed(2)}`;
-    if (feeRateCache.has(cacheKey)) continue;
+    const cacheKey2 = `${currency}-${availableAmount.toFixed(2)}`;
+    if (feeRateCache.has(cacheKey2)) continue;
     try {
       const feeParams = new URLSearchParams({
         mediaType: "Google",
@@ -115589,16 +115714,16 @@ async function runAccountWithdrawSubmit(opts) {
         {},
         opts.verbose
       );
-      feeRateCache.set(cacheKey, feeData?.feeRate ?? 0);
+      feeRateCache.set(cacheKey2, feeData?.feeRate ?? 0);
     } catch {
       console.warn(`  \u26A0\uFE0F  ${currency} \u7BA1\u7406\u8D39\u67E5\u8BE2\u5931\u8D25\uFF0C\u5C06\u4EE5 0 \u8D39\u7387\u63D0\u4EA4\u3002`);
-      feeRateCache.set(cacheKey, 0);
+      feeRateCache.set(cacheKey2, 0);
     }
   }
   const body = accountDetails.map(
     ({ ma, mai, currency, balance, adjustments, availableAmount }) => {
-      const cacheKey = `${currency}-${availableAmount.toFixed(2)}`;
-      const feeRate = feeRateCache.get(cacheKey) ?? 0;
+      const cacheKey2 = `${currency}-${availableAmount.toFixed(2)}`;
+      const feeRate = feeRateCache.get(cacheKey2) ?? 0;
       const taxRate = currency === "CNY" ? 0.06 : 0;
       const totalAmounts = availableAmount * (1 + feeRate) * (1 + taxRate);
       return {

package/dist/skill/SKILL.md

@@ -148,11 +148,11 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 
 ### 金额与品牌名
 
-- **金额单位统一为「元」**：CLI 出口的所有 JSON / 表格里，金额字段一律以**元**为单位；带 `*Yuan` 后缀的字段（如 `budgetAmountYuan`、`maxCPCAmountYuan`、`averageCpcYuan`）尤其表明这一约定。报告/表格金额保留 2 位小数，格式示例：`￥50.00 CNY`、`$50.00 USD`（符号与 `currencyCode` 一致）。
+- **金额单位统一为「元」**：CLI 出口的所有 JSON / 表格里，账户/投放类金额字段一般以**元**为单位（如 `budgetAmountYuan`、`maxCPCAmountYuan`）。报告/表格金额保留 2 位小数，格式示例：`￥50.00 CNY`、`$50.00 USD`（符号与 `currencyCode` 一致）。
 - **`ad campaigns --json`/`--json-out`**：列表里的 `budget` 已是主币种「元」（与 `ad campaign-edit --budget` 写参同口径），可直接作用户可见日预算。
 - **`ad groups --json`**：日预算/CPA 读 `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）。
 - **`google-analysis` 落盘 `campaigns-*.json`**：日预算读 `budgetAmountYuan`（元），系列目标 CPA 读 `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan`（元）；同文件 `spend` / `averageCpc` / `costPerConversion` 也是元。
-- **`keyword --json`**：CPC 与页首出价读 `averageCpcYuan` / `lowTopOfPageBidYuan` / `highTopOfPageBidYuan`（已 ÷1,000,000）；根级 **`bidAmountCurrency: "USD"`** 标明出价为**美元**（共享 MCC Keyword Planner）。限定市场地区：`keyword geo-list` 查国家 `geoTargetConstant` ID，拓词时 `--geo 2840,2826`（对应 `keywordidea/google?geoTargetConstantIds=...`）。
+- **`keyword --json`**：美元出价读 `averageCpcUSD` / `lowTopOfPageBidUSD` / `highTopOfPageBidUSD`；人民币读 `averageCpcCNY` / `lowTopOfPageBidCNY` / `highTopOfPageBidCNY`（根级 `usdToCnyExchangeRate`）。根级 `bidAmountCurrency: "USD"`。限定市场：`keyword geo-list` + `--geo 2840,2826`。
 - **品牌名**必须来自（按优先级）：(1) 用户明确提供 (2) `list-accounts` 返回的 `mag.advertiserName` (3) 用户提供的网址→域名占位并标注 `[待确认品牌名]`。**严禁**把英文域名自行翻译为虚构中文品牌。
 
 ### 批量任务硬约束

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.20-beta.14",
-  "publishedAt": 1779264968433
+  "version": "1.1.20-beta.15",
+  "publishedAt": 1779268611318
 }

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

@@ -83,7 +83,7 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 | `ad campaigns --json`                               | `budget`（元，与 `--budget` 写参同口径）                                                                                                  |
 | `ad groups --json`                                  | `maxCPCAmountYuan`、`targetCpaAmountYuan`                                                                                                 |
 | `google-analysis campaigns` 落盘 `campaigns-*.json` | `budgetAmountYuan`、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`；同行 `spend` / `averageCpc` / `costPerConversion` 也是元 |
-| `keyword suggest --json`                            | `averageCpcYuan`、`lowTopOfPageBidYuan`、`highTopOfPageBidYuan`                                                                           |
+| `keyword suggest --json`                            | `averageCpcUSD`、`lowTopOfPageBidUSD`、`highTopOfPageBidUSD`；`averageCpcCNY`                                            |
 | `balance` 等账户余额接口                            | `remainingAccountBudget`（元）                                                                                                            |
 
 旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。

package/dist/skill/references/currency.md

@@ -46,7 +46,7 @@
 
 ## 金额单位约定
 
-- **CLI 出口的所有 JSON / 表格金额一律以「元」为单位**：`budget`、`*Yuan` 后缀字段（`budgetAmountYuan`、`maxCPCAmountYuan`、`averageCpcYuan` 等）、`spend` / `averageCpc` / `costPerConversion`、`remainingAccountBudget` 等都是元。
+- **CLI 出口的大多数 JSON / 表格金额以「元」为单位**：`budget`、`*Yuan` 后缀（`budgetAmountYuan`、`maxCPCAmountYuan` 等）、`spend` / `averageCpc` / `costPerConversion` 等。**例外**：`keyword suggest` 的 Planner 出价为美元，字段名为 `averageCpcUSD` / `lowTopOfPageBidUSD` / `highTopOfPageBidUSD`，并可选附带 `averageCpcCNY` 等换算值。
 - **写 CLI 参数**（`--budget`、`--max-cpc`、`--target-cpa`、`--amount` 等）：同样传**主币种元**，与账户 `currencyCode` 一致；CLI 内部按需 ×100 / ×1_000_000 写后端。
 - 旧版网关字段（`budgetAmount` 分、`*Micros` 微元、`maxCPCAmountDisplay` 等）**已不再落盘到 CLI 输出**，下游脚本无需做单位换算。
 

package/dist/skill/references/google-ads-rules/google-ads-keyword-taxonomy.md

@@ -70,7 +70,7 @@
 
 `class` 取值：`scenario` | `geo` | `tech` | `question`。
 
-拓词编排见 `references/keyword-planner-workflows.md`；Planner 数据须标注 `bidAmountCurrency`（美元）并按账户币种换算后写入说明。
+拓词编排见 `references/keyword-planner-workflows.md`；Planner 出价用 `*USD` 与 `*CNY`，根级 `bidAmountCurrency` / `usdToCnyExchangeRate`。
 
 ---
 

package/dist/skill/references/keyword-planner-workflows.md

@@ -3,8 +3,7 @@
 > **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads-campaign-plan.md`。关键词数量规则：`google-ads-rules/google-ads-keyword-taxonomy.md`。
 >
 > **数据口径**：`siluzan-tso keyword` 走网关 `keywordidea/google`（Google Keyword Planner 市场指标）；可选 `--url` 叠加 **网址拓词**（`websitereco`，非 Google API）。与账户内 **`google-analysis` 投放表现**不是同一套数据，文档与回复中须区分「市场参考」与「账户实际花费/转化」。
-> 用户提供了google广告账户时，需要获取到广告账户的币种，因为关键词推荐返回的关键词最高最低出价都是美金，所以当账户为人民币账户时，需要你按当前汇率转换为人民币，如果当前账户是美金则不需要转换
-> 最终如果用户要求输出excel, 金额相关的表头需要注明是美元($)或人民币(￥)
+
 ---
 
 ## 路径选择（拓词前先定分支）
@@ -23,7 +22,7 @@
 
 1. （可选）宿主 **联网搜索** 或 `rag query` 归纳 **2–8 个英文种子词**（RAG 见 §0，联网搜索勿与 Google 指标混写在同一列）。
 2. `siluzan-tso keyword -k "种子1,种子2,..." [--url "<落地页或竞品站>"] --json-out ./snap-kw`
-3. 对落盘 `items`：以 **`keyword` 返回行为准**（有 `montlySearch` / `averageCpcYuan` 等）；联网搜索得到的词若无对应行，可并入词包但须标注 **「无 Google 市场数据」**，或丢弃。
+3. 对落盘 `items`：以 **`keyword` 返回行为准**（有 `montlySearch` / `averageCpcUSD` 等）；联网搜索得到的词若无对应行，可并入词包但须标注 **「无 Google 市场数据」**，或丢弃。
 
 ### 分支 B — 仅 Google 市场数据（默认）
 
@@ -159,7 +158,7 @@ siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "
 ### 5）高商业意图粗筛（出价 + 竞争度 + 搜索量）
 
 1. `siluzan-tso keyword -k "..." --json-out ./snap-kw`
-2. 对落盘 `items` 按 `averageCpcYuan`（CLI 出口已 ÷1,000,000，货币见根级 **`bidAmountCurrency: "USD"`**）、`competition` / `competitionV2`、`montlySearch` 综合排序截断；此外 `lowTopOfPageBidYuan` / `highTopOfPageBidYuan`（页首出价 20/80 分位，**美元**）可用于评估合理出价区间。
+2. 对落盘 `items` 按 `averageCpcUSD`（CLI 出口已 ÷1,000,000，货币见根级 **`bidAmountCurrency: "USD"`**）、`competition` / `competitionV2`、`montlySearch` 综合排序截断；此外 `lowTopOfPageBidUSD` / `highTopOfPageBidUSD`（页首出价 20/80 分位，**美元**）可用于评估合理出价区间。
 
 ### 6）词包 → campaign-create JSON
 
@@ -183,6 +182,6 @@ siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [
 
 `--google-only`：只调 `keywordidea/google`，不叠加 `--url` 的网址拓词；**分支 B（仅 Google）必加**。
 
-**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级 `bidAmountCurrency: "USD"`（出价货币）；`keyword` / `montlySearch` / `averageCpcYuan` / `competition`（0~1 数值）/ `competitionV2`（`Low/Medium/High/Unknown`）/ `keywordPlanCompetitionLevel`（1~4 整数）/ `lowTopOfPageBidYuan` / `highTopOfPageBidYuan`（页首出价 P20/P80，**美元**）/ `source`（`"Google"` 或 `"Cgy"`）。金额字段已由网关微元 ÷1,000,000。后端已按 `keywordPlanCompetitionLevel` 降序排序。
+**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级 `bidAmountCurrency: "USD"`、`usdToCnyExchangeRate`（可选）；每条 `averageCpcUSD` / `lowTopOfPageBidUSD` / `highTopOfPageBidUSD`（**美元**）及对应 `averageCpcCNY` / `lowTopOfPageBidCNY` / `highTopOfPageBidCNY`（CLI 换算）；另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。金额已由网关微元 ÷1,000,000。
 
 与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.20-beta.14'
+$PKG_VERSION = '1.1.20-beta.15'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.20-beta.14"
+readonly PKG_VERSION="1.1.20-beta.15"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

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