siluzan-tso-cli 1.1.19 → 1.1.20-beta.2

package/dist/skill/SKILL.md

@@ -277,7 +277,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
    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`「重点国家配置」节）判桶，无需走大洲表；**禁止**在脚本中硬编码任何具体国家名。
+5. **国家 → 大洲映射**：脚本里读 `references/geo-continents.json`，未命中标 `未知大洲` 不阻塞，结尾打印未命中清单。Sheet 3 国家透视 / Sheet 6 国家维度 / Sheet 4 下半区切片**均应按行的 `countryNameZh` 字段聚合**（CLI 已用 Google Ads geotargets 字典自动把 `Mumbai → 印度` / `Davao Region → 菲律宾` 等 city / region 级归并到国家，未命中时回落 `countryOrRegionZh`）。Sheet 4「重点国 vs 非重点国」切片：按 `focusCountries`（中文国家名数组，运营未指定时默认取分析月询盘 Top1 国家，详见 `report-templates/google-inquiry-analysis.md`「重点国家配置」节）判桶，用 `focusCountries.includes(countryNameZh)` 即可；**禁止**在脚本中硬编码任何具体国家名。
 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。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.19",
-  "publishedAt": 1778754808006
+  "version": "1.1.20-beta.2",
+  "publishedAt": 1778828241807
 }

package/dist/skill/references/finance.md

@@ -7,7 +7,7 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`https://www.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
+对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
@@ -133,10 +133,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：https://www.siluzan.com/recharge/pay
-- 现金充值（批量）：https://www.siluzan.com/recharge/pay_batch
-- 月结充值：        https://www.siluzan.com/recharge/accountBillingQuota
-- 丝路赞钱包：      https://www.siluzan.com/recharge/siluzanWallet
+- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
+- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
+- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
+- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
 ```
 
 ---

package/dist/skill/references/geo-continents.json

@@ -84,8 +84,10 @@
   "德国": "欧洲",
   "俄罗斯": "欧洲",
   "法国": "欧洲",
+  "法罗群岛": "欧洲",
   "梵蒂冈": "欧洲",
   "芬兰": "欧洲",
+  "根西岛": "欧洲",
   "荷兰": "欧洲",
   "黑山": "欧洲",
   "捷克": "欧洲",
@@ -108,46 +110,69 @@
   "圣马力诺": "欧洲",
   "斯洛伐克": "欧洲",
   "斯洛文尼亚": "欧洲",
+  "斯瓦尔巴和扬马延": "欧洲",
   "乌克兰": "欧洲",
   "西班牙": "欧洲",
   "希腊": "欧洲",
   "匈牙利": "欧洲",
   "意大利": "欧洲",
   "英国": "欧洲",
+  "泽西岛": "欧洲",
+  "直布罗陀": "欧洲",
 
+  "阿鲁巴": "北美",
+  "安圭拉": "北美",
   "安提瓜和巴布达": "北美",
   "巴巴多斯": "北美",
   "巴哈马": "北美",
   "巴拿马": "北美",
+  "百慕大": "北美",
   "波多黎各": "北美",
   "伯利兹": "北美",
   "多米尼加共和国": "北美",
   "多米尼克": "北美",
+  "法属圣马丁": "北美",
   "哥斯达黎加": "北美",
   "格林纳达": "北美",
+  "格陵兰": "北美",
   "古巴": "北美",
+  "瓜德罗普": "北美",
   "海地": "北美",
+  "荷属加勒比区": "北美",
+  "荷属圣马丁": "北美",
   "洪都拉斯": "北美",
   "加拿大": "北美",
+  "开曼群岛": "北美",
+  "库拉索": "北美",
+  "马提尼克": "北美",
   "美国": "北美",
+  "美属维尔京群岛": "北美",
+  "蒙特塞拉特": "北美",
   "墨西哥": "北美",
   "尼加拉瓜": "北美",
   "萨尔瓦多": "北美",
+  "圣巴泰勒米": "北美",
   "圣基茨和尼维斯": "北美",
   "圣卢西亚": "北美",
+  "圣皮埃尔和密克隆群岛": "北美",
   "圣文森特和格林纳丁斯": "北美",
+  "特克斯和凯科斯群岛": "北美",
   "特立尼达和多巴哥": "北美",
   "危地马拉": "北美",
   "牙买加": "北美",
+  "英属维尔京群岛": "北美",
 
   "阿根廷": "南美",
   "巴拉圭": "南美",
   "巴西": "南美",
   "玻利维亚": "南美",
   "厄瓜多尔": "南美",
+  "法属圭亚那": "南美",
+  "福克兰群岛": "南美",
   "哥伦比亚": "南美",
   "圭亚那": "南美",
   "秘鲁": "南美",
+  "南乔治亚和南桑威奇群岛": "南美",
   "苏里南": "南美",
   "委内瑞拉": "南美",
   "乌拉圭": "南美",
@@ -181,10 +206,12 @@
   "莱索托": "非洲",
   "利比里亚": "非洲",
   "利比亚": "非洲",
+  "留尼汪": "非洲",
   "卢旺达": "非洲",
   "马达加斯加": "非洲",
   "马拉维": "非洲",
   "马里": "非洲",
+  "马约特": "非洲",
   "毛里求斯": "非洲",
   "毛里塔尼亚": "非洲",
   "摩洛哥": "非洲",
@@ -198,12 +225,15 @@
   "塞内加尔": "非洲",
   "塞舌尔": "非洲",
   "圣多美和普林西比": "非洲",
+  "圣赫勒拿": "非洲",
   "斯威士兰": "非洲",
   "苏丹": "非洲",
   "索马里": "非洲",
   "坦桑尼亚": "非洲",
   "突尼斯": "非洲",
   "乌干达": "非洲",
+  "西撒哈拉": "非洲",
+  "英属印度洋领地": "非洲",
   "约翰内斯堡": "非洲",
   "赞比亚": "非洲",
   "乍得": "非洲",
@@ -211,16 +241,35 @@
 
   "澳大利亚": "大洋洲",
   "巴布亚新几内亚": "大洋洲",
+  "北马里亚纳群岛": "大洋洲",
+  "法属波利尼西亚": "大洋洲",
   "斐济": "大洋洲",
+  "关岛": "大洋洲",
+  "赫德岛和麦克唐纳群岛": "大洋洲",
   "基里巴斯": "大洋洲",
+  "科科斯（基林）群岛": "大洋洲",
+  "库克群岛": "大洋洲",
   "马绍尔群岛": "大洋洲",
+  "美国本土外小岛屿": "大洋洲",
+  "美属萨摩亚": "大洋洲",
   "密克罗尼西亚": "大洋洲",
   "瑙鲁": "大洋洲",
+  "纽埃": "大洋洲",
+  "诺福克岛": "大洋洲",
   "帕劳": "大洋洲",
+  "皮特凯恩群岛": "大洋洲",
   "萨摩亚": "大洋洲",
+  "圣诞岛": "大洋洲",
   "所罗门群岛": "大洋洲",
   "汤加": "大洋洲",
   "图瓦卢": "大洋洲",
+  "托克劳": "大洋洲",
+  "瓦利斯和富图纳": "大洋洲",
   "瓦努阿图": "大洋洲",
-  "新西兰": "大洋洲"
+  "新喀里多尼亚": "大洋洲",
+  "新西兰": "大洋洲",
+
+  "布韦岛": "南极洲",
+  "法属南部领地": "南极洲",
+  "南极洲": "南极洲"
 }

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

@@ -2,7 +2,7 @@
 
 > 拓词、竞品网址拓词、词包清洗、否词、建户关键词结构：**先 Read 本文件**，再按需打开 `references/google-ads.md`（命令参数）与 `references/google-ads-rules/google-ads-keyword-strategy.md`（匹配与分组原则）。
 >
-> **数据口径**：`siluzan-tso keyword` 走网关 `keywordidea/google`（关键字创意/体量与竞价参考），可选 `--url` 叠加站内网址拓词服务；与账户内 **`google-analysis` 投放表现**不是同一套数据，文档与回复中须区分「市场参考」与「账户实际花费/转化」。
+> **数据口径**：`siluzan-tso keyword` 走网关 `keywordidea/google`（市场侧关键字创意/体量与竞价参考；后端使用共享 MCC + 缓存全局 OAuth Token，**无需用户绑账户**），可选 `--url` 叠加站内网址拓词服务；与账户内 **`google-analysis` 投放表现**不是同一套数据，文档与回复中须区分「市场参考」与「账户实际花费/转化」。
 
 ---
 
@@ -77,8 +77,8 @@
 
 ### 5）高商业意图粗筛（出价 + 竞争度 + 搜索量）
 
-1. `siluzan-tso keyword … --json-out ./snap-kw`
-2. 对落盘 `items` 按 `averageCpc`（JSON 内常为微单位；表格 stdout 已换算展示）、`competition` / `competitionV2`、`montlySearch` 综合排序截断；**勿承诺**「页首出价高位」等 CLI 未文档化字段，除非当次 outline 中明确存在。
+1. `siluzan-tso keyword -k "..." --json-out ./snap-kw`
+2. 对落盘 `items` 按 `averageCpc`（JSON 内常为微单位；表格 stdout 已换算展示）、`competition` / `competitionV2`、`montlySearch` 综合排序截断；此外 `lowTopOfPageBidMicros` / `highTopOfPageBidMicros`（页首出价 20/80 分位，**微单位**）可用于评估合理出价区间。
 
 ### 6）Campaign → AdGroup → 关键词 映射表 + 匹配建议
 
@@ -101,4 +101,6 @@
 siluzan-tso keyword -k "<必填，逗号分隔多词>" [--url <url>] [--include <words>] [--exclude <words>] [--json] [--json-out <dir>] [--verbose]
 ```
 
+**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：`keyword` / `montlySearch` / `averageCpc`（微单位）/ `competition`（0~1 数值）/ `competitionV2`（`Low/Medium/High/Unknown`）/ `keywordPlanCompetitionLevel`（1~4 整数）/ `lowTopOfPageBidMicros` / `highTopOfPageBidMicros`（页首出价 P20/P80，微单位）/ `source`（`"Google"` 或 `"Cgy"`）。后端已按 `keywordPlanCompetitionLevel` 降序排序。
+
 与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。

package/dist/skill/references/reporting.md

@@ -214,8 +214,8 @@ siluzan-tso report list -m Google --json
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

package/dist/skill/references/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -129,9 +129,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

package/dist/skill/references/tso-home.md

@@ -6,7 +6,7 @@
 
 用 `siluzan-tso config show` 读取 **`webUrl`**，再拼接路径：
 
-首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 
 > 若用户已登录 TSO，也可从左侧菜单进入「首页」。
 

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

@@ -84,7 +84,10 @@ for month in <S月, S+1月, E月>:
 - `keywords` / `search-terms`：Sheet 7 / 8；默认 `limit=200`（TOP200）。
 - `campaign-geo`：含 `campaignName`，用于 Sheet 6「暂停的系列」列辅助派生（若运营不需要可留空）；也用于 Sheet 3 国家级消耗 join。
 - `geographic`：账户级国家聚合；Sheet 6 月度循环主源；Sheet 4 下半区「重点国家 vs 非重点国」按月切片（重点国默认取分析月询盘 Top1 国家，可由运营覆盖，详见下文 Sheet 4 节）。
-- **`countryOrRegionZh`** 中文国家名在 `campaign-geo` / `geographic` 中**自动补字段**（见 `references/account-analytics.md`「中文化字段」）；未命中字典时回落英文 `countryOrRegion`。
+- **地理字段自动补齐**（由 `translate-fields.ts` 在 `campaign-geo` / `geographic` 行上自动补，未命中字典则不补，详见 `references/account-analytics.md`「中文化字段」）：
+  - `countryOrRegionZh`：与 `countryOrRegion` **同粒度**的中文翻译（`Mumbai → 孟买` / `India → 印度` / `Davao Region → 达沃地区`）
+  - `countryCode`：归并到的 ISO alpha-2 国家代码（`Mumbai → "IN"` / `Davao Region → "PH"` / `India → "IN"`），数据源 Google Ads 官方 geotargets CSV（约 9.5 万条目）
+  - `countryNameZh`：归并后的**国家级中文名**（`Mumbai → "印度"` / `Davao Region → "菲律宾"`）。**Sheet 3 国家透视、Sheet 6 国家维度均应按 `countryNameZh` 聚合**，自动把城市/地区行归并到所属国家，不再出现"未知大洲"。
 
 **写脚本前先读 `<section>-<id>.outline.txt`**（几百字节 TS 类型字面量），别直接 `Read` 几 MB 的 JSON。
 
@@ -239,7 +242,7 @@ for month in <S月, S+1月, E月>:
    表头：`国家(分析月份询盘国家)` \| `询盘个数` \| `所属大洲` \| `消耗`  
    `询盘个数` = `inquiries.json` 按国家 count；  
    `所属大洲` = 按上文「运营常用 5 桶合并」规则；  
-   `消耗` = `campaign-geo-*.json` 按 `countryOrRegionZh` 聚合的 `spend`（同一国家多系列累加）；  
+   `消耗` = `campaign-geo-*.json` 按 **`countryNameZh`** 聚合的 `spend`（同一国家的所有 city / region 行也归并；未命中归并字典时回落 `countryOrRegionZh`）；  
    末行 `总计`。
 
 2. **客户来源 × 询盘数**（H→I，国家透视下方留空 1 行后接续）  
@@ -286,7 +289,7 @@ for month in <S月, S+1月, E月>:
 | R | 内容 |
 | --- | --- |
 | R7 | `时间` \| `国家` \| `消费` \| `线索数` \| `成本` \| `备注`|
-| R8..R13 | 每月一对（`<focusLabel>` / `非<focusLabel>`，其中 `focusLabel` = `focusCountries.join("+")`）：脚本读 `./<YYYY-MM>/geographic-*.json`，按 `focusCountries.includes(countryOrRegionZh) \|\| focusCountries.includes(geoEn2Zh[countryOrRegion])` 二分；`消费` = 该桶 `spend` 求和；`线索数` = `inquiries.json` 同月同桶（按 `country` 字段匹配 `focusCountries`） count；`成本` = `消费 / 线索数`，线索 0 填 `—` |
+| R8..R13 | 每月一对（`<focusLabel>` / `非<focusLabel>`，其中 `focusLabel` = `focusCountries.join("+")`）：脚本读 `./<YYYY-MM>/geographic-*.json`，**按 `countryNameZh` 字段判桶**（CLI 已自动归并 city → country；未命中时回落 `countryOrRegionZh`）：`focusCountries.includes(countryNameZh)`；`消费` = 该桶 `spend` 求和；`线索数` = `inquiries.json` 同月同桶（按 `country` 字段匹配 `focusCountries`） count；`成本` = `消费 / 线索数`，线索 0 填 `—` |
 
 **`Agent 数据洞察`**（**位置**：下区（重点国切片）最末行下方留空 1 行接续，**A 列起**；Agent 基于本 Sheet 上 + 下区数据自动生成，**禁止**编造；每条**必带**具体数字）：
 
@@ -330,7 +333,7 @@ for month in <S月, S+1月, E月>:
 | R | 内容 |
 | --- | --- |
 | R1（A→N，14 列） | `月份(Excel 序列号)` \| `国家/地区（匹配）` \| `点击次数` \| `展示次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` \| `询盘个数` \| `(留空)` \| `(留空)` \| `暂停的系列` |
-| R2… | 笛卡尔积：`3 个月 × N 个国家`；脚本循环读 `./<YYYY-MM>/geographic-*.json`，每行 `countryOrRegionZh`（回落 `countryOrRegion`）+ 该月该国家的指标；`询盘个数` = `inquiries.json` 同月同国家 count（左 join，缺失为 0）；`暂停的系列` 留空给运营手填（不要编造） |
+| R2… | 笛卡尔积：`3 个月 × N 个国家`；脚本循环读 `./<YYYY-MM>/geographic-*.json`，每行**按 `countryNameZh` 聚合**（自动把 `Mumbai / Karachi / London` 等 city / region 行归并到所属国家；未命中归并字典回落 `countryOrRegionZh`）+ 该月该国家的指标；`询盘个数` = `inquiries.json` 同月同国家 count（左 join，缺失为 0）；`暂停的系列` 留空给运营手填（不要编造） |
 
 排序：按月份升序（与运营样表"45931 / 45962 / 45992 / 46023"顺序一致——分别对应 2025-10 ~ 2026-01 起算的 Excel 日期序列号）；同月内按 `点击次数` 降序。
 

package/dist/skill/scripts/install.ps1

@@ -10,8 +10,8 @@ $ErrorActionPreference = 'Stop'
 $PKG_NAME    = 'siluzan-tso-cli'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
-$WEB_BASE    = 'https://www.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN    = 18

package/dist/skill/scripts/install.sh

@@ -10,8 +10,8 @@ set -euo pipefail
 readonly PKG_NAME="siluzan-tso-cli"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
-readonly WEB_BASE="https://www.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
+readonly WEB_BASE="https://www-ci.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.19",
+  "version": "1.1.20-beta.2",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",
@@ -79,6 +79,7 @@
     "eval:export-cases": "tsx eval/scripts/export-scenarios.mts",
     "geo:generate": "node scripts/generate-geo-dictionaries.mjs",
     "geo:check": "node scripts/generate-geo-dictionaries.mjs --check",
+    "geo:fetch": "node scripts/fetch-google-ads-geo.mjs",
     "test:ad-read": "node scripts/test-ad-api-read.mjs",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit -p tsconfig.json"