siluzan-tso-cli 1.1.21 → 1.1.22-beta.10

package/dist/skill/references/accounts/open-account-by-media.md

@@ -0,0 +1,153 @@
+# 各媒体开户
+
+> 对应页面：`/accountOpeningHistory`  
+> 网页链接：`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 多命令串联见 `references/core/workflows.md` § 流程一。
+
+## Agent 注意
+
+- **`open-account google-wizard` 需要真实 TTY**，Agent 环境无法使用，始终用非交互 `open-account <media> ...`。
+- 各媒体所需资料和参数**完全不同**，不要混用。
+- 提交后轮询：`account-history -m <Media>`；通过后 `list-accounts -m <Media>`。
+- 充值激活**必须在网页**完成（见 `references/accounts/finance.md`）。
+
+---
+
+## Google
+
+**所需信息**：公司名称、推广网址、推广类型（b2b/b2c/app）、账户名称、币种（CNY/USD）、时区、邀请邮箱
+
+**网页对照**（字段映射）：`references/accounts/open-account-google-ui.md`
+
+**常用时区**（完整：`siluzan-tso open-account google-timezones`）：
+
+| Code | 含义 |
+| ---- | ---- |
+| `Asia/Shanghai` | CNY 默认 |
+| `Asia/Hong_Kong` | USD 默认 |
+| `America/New_York` | 美东 |
+| `America/Los_Angeles` | 美西 |
+| `Europe/London` | 伦敦 |
+
+```bash
+siluzan-tso open-account google \
+  --company "Brand A Inc." \
+  --promotion-link "https://www.brand-a.com" \
+  --promotion-type b2c \
+  --account-name "品牌A美国推广账户" \
+  --currency USD \
+  --timezone "America/New_York" \
+  --invite-email "marketing@brand-a.com"
+
+siluzan-tso account-history -m Google
+siluzan-tso list-accounts -m Google
+```
+
+---
+
+## TikTok
+
+**所需信息**：营业执照图片路径、执照编号、公司名、注册地代码、行业 ID（叶子节点）、推广链接、账户名称、币种、时区
+
+> CLI 不做执照 OCR，需用户手动提供 `--company` 和 `--license-no`。
+
+```bash
+siluzan-tso open-account tiktok-areas --keyword China
+siluzan-tso open-account tiktok-industries --keyword "电商"
+siluzan-tso open-account tiktok-timezones --keyword Shanghai
+
+siluzan-tso open-account tiktok \
+  --company "Brand A Inc." \
+  --account-name "品牌A TikTok账户" \
+  --currency USD \
+  --timezone "Asia/Shanghai" \
+  --industry-id <叶子节点 ID> \
+  --registered-area CN \
+  --promotion-link "https://www.brand-a.com" \
+  --license-no "91440300XXXXXXXXXX" \
+  --license-file "/path/to/license.jpg"
+
+siluzan-tso account-history -m TikTok
+```
+
+---
+
+## Yandex
+
+**所需信息**：公司名称、Yandex 登录名、邮箱、税号（TIN）、电话
+
+```bash
+siluzan-tso open-account yandex \
+  --company "Brand A Inc." \
+  --login "brandainc_yandex" \
+  --first-name "San" \
+  --last-name "Zhang" \
+  --email "contact@brand-a.com" \
+  --tin "XXXXXXXXXX" \
+  --phone "+86XXXXXXXXXXX"
+
+siluzan-tso account-history -m Yandex
+```
+
+---
+
+## BingV2
+
+**所需信息**：广告主全称/简称、地址（省市区）、推广链接、行业名称、营业执照图片路径
+
+```bash
+siluzan-tso open-account bing-industries --keyword "科技"
+
+siluzan-tso open-account bing \
+  --advertiser-name "深圳XX科技有限公司" \
+  --name-short "XX科技" \
+  --province "广东省" \
+  --city "深圳市" \
+  --address "南山区科技园XX路XX号" \
+  --promotion-link "https://www.brand-a.com" \
+  --trade-id "IT/消费电子-其他" \
+  --license-file "/path/to/license.jpg"
+
+siluzan-tso account-history -m BingV2
+```
+
+---
+
+## Kwai
+
+**所需信息**：公司名称、主体信息、行业多级 ID、产品网址、账户类型、营业执照图片路径
+
+> **双上传**（与网页 `KwaiOpenAnAccount.vue` 一致）：CLI 先 `POST /command/attachment` 得 `imageId`（更新广告主组 MAG），再 `POST /KwaiAccount/Management/Upload` 得 `blobstoreKey`（写入 `KwaiAccountInfo.mainCertPhotos`）。二者不可混用。
+
+```bash
+siluzan-tso open-account kwai \
+  --company-name "深圳XX科技有限公司" \
+  --licence-id "91440300XXXXXXXXXX" \
+  --licence-country CN \
+  --licence-location "广东省深圳市南山区XX路XX号" \
+  --business-scope "电商零售" \
+  --product "品牌A" \
+  --ad-type 1 \
+  --product-url "https://www.brand-a.com" \
+  --licence-id-type ENTERPRISE \
+  --account-name "品牌A Kwai账户" \
+  --industry-id1 "1234" \
+  --industry-id2 "5678" \
+  --expire-type 2 \
+  --target-country US \
+  --license-file "/path/to/license.jpg"
+
+siluzan-tso account-history -m Kwai
+```
+
+---
+
+## 审核结果
+
+| 状态 | 含义 | 下一步 |
+| ---- | ---- | ------ |
+| 审核中 | 等待媒体审核 | 继续 `account-history` 轮询 |
+| 已通过 | 账户可用 | `list-accounts` 确认 + 网页充值 |
+| 已拒绝 | 资料问题 | 查看拒绝原因，修正后重新提交 |
+
+完整参数：`siluzan-tso open-account <subcommand> -h`

package/dist/skill/references/{open-account-google-ui.md → accounts/open-account-google-ui.md}

@@ -8,7 +8,7 @@
 | ②    | 填写申请     | 网页里完成第 1、2 步表单并提交     | **`open-account google-wizard`** 或 **`open-account google`** |
 | ③    | 等待审核     | 等待媒体/平台审核                  | **`account-history -m Google`** 轮询                          |
 | ④    | 审核通过     | 查看通过结果                       | 同上                                                          |
-| ⑤    | 充值并激活   | **必须在网页完成充值**             | 引导 `config show` → `webUrl` + 充值路径（见 `finance.md`）   |
+| ⑤    | 充值并激活   | **必须在网页完成充值**             | 引导 `config show` → `webUrl` + 充值路径（见 `accounts/finance.md`）   |
 
 页面上还有提示：**美元账户最低充值约 100 USD、人民币约 700 CNY**（以实际页面为准）。
 
@@ -115,4 +115,4 @@ siluzan-tso account-history -m Google
 | `open-account google`           | 非交互一次性提交                        |
 | `account-history -m Google`     | 开户审核进度                            |
 
-更完整的参数表见 `accounts.md` → **open-account** 章节。
+更完整的参数表见 `accounts/accounts.md` → **open-account** 章节。

package/dist/skill/references/{write-audit-restore.md → accounts/write-audit-restore.md}

@@ -117,11 +117,11 @@ siluzan-tso audit restore-apply \
 
 ## 自主回退工作流（Agent / 人类）
 
-1. **定位 audit**：`siluzan-tso audit list --days 14 --match "关键词" --json`。
-2. **看完整审计行**：`siluzan-tso audit show --id <auditId> --json`，确认 `preSnapshotFileReadable === true`。
-3. **生成回退计划**：`siluzan-tso audit restore-plan --id <auditId> --json`。
+1. **定位 audit**：`siluzan-tso audit list --days 14 --match "关键词" --json-out ./snap`。
+2. **看完整审计行**：`siluzan-tso audit show --id <auditId> --json-out ./snap`，确认 `preSnapshotFileReadable === true`。
+3. **生成回退计划**：`siluzan-tso audit restore-plan --id <auditId> --json-out ./snap`。
    - 检查 `plan.supportability.code === "ready_put_patch"`。
-   - **必读** `plan.subsequentWrites`：若存在成功的后续写，意味着回退会覆盖那些更晚的修改；按需可先用 `siluzan-tso audit list --resource-key "<plan.resourceKey>" --json` 把同资源全量历史拉出来交叉确认。
+   - **必读** `plan.subsequentWrites`：若存在成功的后续写，意味着回退会覆盖那些更晚的修改；按需可先用 `siluzan-tso audit list --resource-key "<plan.resourceKey>" --json-out ./snap` 把同资源全量历史拉出来交叉确认。
    - 决定是接受这个覆盖，还是放弃回退/换另一种修复路径。
 4. **执行**：`siluzan-tso audit restore-apply --id <auditId> --i-confirm --ack-subsequent-writes <N>`，N 来自 plan.guardChecks.ackSubsequentWrites。
 

package/dist/skill/references/{account-analytics.md → analytics/account-analytics.md}

@@ -1,6 +1,6 @@
 # 账户分析数据拉取与周期报告
 
-> 所属 skill：`siluzan-tso`。本文档说明如何通过 CLI 拉取 Google / Meta / TikTok / Bing 的账户分析数据并撰写报告。TSO 平台优化报告见 `references/reporting.md`。
+> 所属 skill：`siluzan-tso`。本文档说明如何通过 CLI 拉取 Google / Meta / TikTok / Bing 的账户分析数据并撰写报告。TSO 平台优化报告见 `references/analytics/reporting.md`。
 
 ---
 
@@ -80,23 +80,23 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 
 | 命令 / Section                                      | 元字段                                                                                                                                    |
 | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `ad campaigns --json`                               | `budget`（元，与 `--budget` 写参同口径）                                                                                                  |
-| `ad groups --json`                                  | `maxCPCAmountYuan`、`targetCpaAmountYuan`                                                                                                 |
+| `ad campaigns --json-out ./snap`                               | `budget`（元，与 `--budget` 写参同口径）                                                                                                  |
+| `ad groups --json-out ./snap`                                  | `maxCPCAmountYuan`、`targetCpaAmountYuan`                                                                                                 |
 | `google-analysis campaigns` 落盘 `campaigns-*.json` | `budgetAmountYuan`、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`；同行 `spend` / `averageCpc` / `costPerConversion` 也是元 |
-| `keyword suggest --json`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；根级与每条 `bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD） |
+| `keyword suggest --json-out ./snap`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；根级与每条 `bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD） |
 | `balance` 等账户余额接口                            | 余额字段为`remainingAccountBudget`（元） |
 
-旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。
+旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/accounts/currency.md`。
 
 ### 预算建议
 
-基于当前实际预算（如 `ad campaigns --json` 的 `budget`（元）或 `google-analysis campaigns-*.json` 的 `budgetAmountYuan`（元））、历史日均消耗、用户给的预算上限给出建议。数据不足以判断时，在报告里写明「建议区间需用户确认」而非直接给高风险数字。
+基于当前实际预算（如 `ad campaigns --json-out ./snap` 的 `budget`（元）或 `google-analysis campaigns-*.json` 的 `budgetAmountYuan`（元））、历史日均消耗、用户给的预算上限给出建议。数据不足以判断时，在报告里写明「建议区间需用户确认」而非直接给高风险数字。
 
 ---
 
 ## Google 账户分析：`google-analysis` 命令
 
-> **重要**：`google-analysis` 是统一入口，所有 23 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
+> **重要**：`google-analysis` 是统一入口，所有 25 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
 
 ```bash
 # 单维度
@@ -106,7 +106,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>
 
-# 全量 23 个（省略 --sections）
+# 全量 25 个（省略 --sections）
 siluzan-tso google-analysis -a <id> --json-out <dir>
 
 # 排除慢/不需要的维度
@@ -119,41 +119,43 @@ 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>`         | 仅执行指定维度（逗号分隔）；省略=全部 23 个                                          |
+| `--sections <list>`         | 仅执行指定维度（逗号分隔）；省略=全部 25 个                                          |
 | `--exclude <list>`          | 排除指定维度；与 `--sections` 可叠加                                                 |
 | `--start` / `--end`         | 统计区间（YYYY-MM-DD）；省略=近 7 天截至昨天；`final-urls`/`campaign-types` 自动忽略 |
 | `--concurrency <n>`         | 并发数，默认 5，上限 16                                                              |
-| `--limit <n>`               | 透传给 `keywords`/`search-terms`（默认 **200**，`orderByCost=true`）                 |
+| `--limit <n>`               | 透传给 `keywords`/`search-terms`（默认 **0**=不封顶；`orderByCost=true`）           |
 | `--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`                                     |
+| `--cost-greater <n>`        | 仅 **`geo-matched` / `campaign-geo` / `campaign-geo-matched`**：网关 `costGreater`（整数，单位以后端为准） |
+| `--click-greater <n>`       | 仅 **`geo-matched` / `campaign-geo` / `campaign-geo-matched`**：网关 `clickGreater`                        |
+| `--conversions-greater <n>` | 仅 **`geo-matched` / `campaign-geo` / `campaign-geo-matched`**：网关 `conversionsGreater`                |
 | `--verbose`                 | 打印详细错误                                                                         |
 
-### 维度列表（23 个）
-
-| 维度                 | 说明                                                                                                |
-| -------------------- | --------------------------------------------------------------------------------------------------- |
-| `overview`           | 总览（实时，可查当天；当天高消耗账号排行首选）                                                      |
-| `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` 同源                                                                             |
-| `extensions`         | 附加信息；可选 `--level`                                                                            |
-| `devices`            | 设备分布（账户级 `DeviceSectionData`）                                                              |
-| `geographic`         | 地域分布（账户级 `GeographicSectionData`，网关侧常按国家聚合）                                      |
-| `campaign-geo`       | 广告系列维度地理 （可选 `--cost-greater` / `--click-greater` / `--conversions-greater` 与网关一致） |
-| `campaign-device`    | 广告系列维度设备 （行可含系列/组）                                                                  |
+### 维度列表（25 个）
+
+| 维度                     | 说明                                                                                                |
+| ------------------------ | --------------------------------------------------------------------------------------------------- |
+| `overview`               | 总览（实时，可查当天；当天高消耗账号排行首选）                                                      |
+| `keywords`               | 关键词；默认 `costGreater=0`（仅有消耗）、`limit=0`（不封顶）、`orderByCost=true`；可用 `--limit` 限制 Top N |
+| `search-terms`           | 搜索词；默认 `limit=0`（不封顶）、`orderByCost=true`；落盘前过滤 `spend>0`；含 `queryTargetingStatus` / `queryTargetingStatusZh`（已添加/已排除/都没有）；可用 `--limit` 限制 Top N |
+| `campaigns`              | 广告系列                                                                                            |
+| `campaign-hour`          | 系列按小时（根为 JSON 数组）                                                                        |
+| `ads`                    | 广告；与 `ad list` 同源                                                                             |
+| `extensions`             | 附加信息；可选 `--level`                                                                            |
+| `devices`                | 设备分布（账户级 `DeviceSectionData`）                                                              |
+| `geographic`             | 地域分布（账户级 `GeographicSectionData`，网关侧常按国家聚合）                                      |
+| `geo-matched`            | 相符地理位置（Matched locations，`user_location_view`）账户级按国家/地区汇总                        |
+| `campaign-geo`           | 广告系列维度地理（可选 `--cost-greater` / `--click-greater` / `--conversions-greater` 与网关一致）  |
+| `campaign-geo-matched`   | 相符地理位置（Matched locations）系列级明细（可选同上阈值参数）                                     |
+| `campaign-device`        | 广告系列维度设备（行可含系列/组）                                                                   |
 | `audience`           | 受众；可选 `--audience-type`                                                                        |
 | `asset-images`       | 图片素材                                                                                            |
 | `videos`             | 视频                                                                                                |
 | `materials`          | 合并图片+视频 `{ images, videos }`                                                                  |
 | `resource-counts`    | 结构统计                                                                                            |
 | `conversion-actions` | 转化动作                                                                                            |
-| `daily-metrics`      | 按日指标（主平台 `GET …/report/media-account/google/account-daily-reports`，`--json` 根为按日数组） |
+| `daily-metrics`      | 按日指标（主平台 `GET …/report/media-account/google/account-daily-reports`，`--json-out` 落盘为按日数组） |
 | `gold-account`       | 黄金账户                                                                                            |
 | `ads-index`          | 质量指标                                                                                            |
 | `final-urls`         | 最终到达网址（不传 `--start`/`--end`）                                                              |
@@ -168,8 +170,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": 23,
-  "succeeded": 23,
+  "totalSections": 25,
+  "succeeded": 25,
   "failed": 0,
   "concurrency": 5,
   "elapsedMs": 18712,
@@ -202,7 +204,10 @@ CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文
 | -------------- | ------------------ | -------------------- | --------------------------------------------------------------- |
 | `keywords`     | `keywordMatchType` | `keywordMatchTypeZh` | `match-type-en2zh.json`（覆盖 `BROAD/PHRASE/EXACT` 大小写写法） |
 | `search-terms` | `matchType`        | `matchTypeZh`        | `match-type-en2zh.json`                                         |
-| `campaign-geo` | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`（覆盖 105 个国家/地区）                        |
+| `search-terms` | `queryTargetingStatus` | `queryTargetingStatusZh` | 网关 `Added`→已添加、`Excluded`→已排除、`None`→都没有（写 Excel「已添加/已排除」列用此字段） |
+| `campaign-geo`         | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`（覆盖 105 个国家/地区）                        |
+| `geo-matched`          | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`                                                |
+| `campaign-geo-matched` | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`                                                |
 
 写 Excel / 报表脚本可直接读 `keywordMatchTypeZh` / `matchTypeZh` / `countryOrRegionZh` 输出中文，**不要**自己维护字典或在线翻译。判断覆盖率用 `if (row.xxxZh)` 即可。
 

package/dist/skill/references/{google-analysis-batch.md → analytics/google-analysis-batch.md}

@@ -2,7 +2,7 @@
 
 > 适用：账户数 ≥ 5 且需拉 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop 替代。中断后**必须** `resume`，不得重跑 `run`。
 >
-> **数据时效性**：维度的实时 / 每日同步口径见 `references/account-analytics.md` 顶部「数据时效性」表。当天高消耗排行只能用 `--sections overview`，且**禁止**加 `--min-spend`（其预筛选来自非实时 `accountsoverview`）。
+> **数据时效性**：维度的实时 / 每日同步口径见 `references/analytics/account-analytics.md` 顶部「数据时效性」表。当天高消耗排行只能用 `--sections overview`，且**禁止**加 `--min-spend`（其预筛选来自非实时 `accountsoverview`）。
 
 单 Node 进程，复用 keep-alive，双层并发（账户级 × 维度级），断点续跑，错误自动分类重试。
 
@@ -69,7 +69,7 @@ siluzan-tso google-analysis-batch status --json-out ./snap-batch --run-id <runId
 | `--run-id <id>`                      | 自定义 runId                                                                                                   | 自动 `run-YYYYMMDD-HHmmss-<rand4>` |
 | `-a, --accounts <ids>`               | 显式 ID 列表；传入则跳过清单拉取与 `--min-spend`                                                               | 省略时自动拉全量 Google 账号       |
 | `--start` / `--end`                  | 统计区间（YYYY-MM-DD）                                                                                         | 近 7 天截至昨天                    |
-| `--sections <list>`                  | 维度（逗号分隔），合法值见 `references/account-analytics.md`                                                   | `campaigns,geographic,keywords`    |
+| `--sections <list>`                  | 维度（逗号分隔），合法值见 `references/analytics/account-analytics.md`                                                   | `campaigns,geographic,keywords`    |
 | `--account-concurrency <n>`          | 账户级并发（1~16）                                                                                             | 4                                  |
 | `--section-concurrency <n>`          | 单账户内维度并发（1~16）                                                                                       | 6                                  |
 | `--keyword-limit <n>`                | keywords / search-terms 条数上限                                                                               | google-analysis 默认               |

package/dist/skill/references/{keyword-planner-workflows.md → analytics/keyword-planner-workflows.md}

@@ -1,6 +1,6 @@
 # 关键词规划师工作流
 
-> **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads-campaign-plan.md`。关键词数量规则：`google-ads-rules/google-ads-keyword-taxonomy.md`。
+> **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads/google-ads-campaign-plan.md`。关键词数量规则：`google-ads/rules/google-ads-keyword-taxonomy.md`。
 >
 > **数据口径**：`siluzan-tso keyword` 默认走 `keywordidea/google`（共享 MCC，出价 **USD**）；传 **`-a <mediaCustomerId>`** 时走 `keywordrecommendation/recommend/{id}/google`，出价币种为 `list-accounts` 的 **`currencyCode`**（如 CNY）。可选 `--url` 叠加 **网址拓词**（`websitereco`）。与 **`google-analysis` 投放表现**不是同一套数据。
 
@@ -60,7 +60,7 @@
 | 4   | 账户关键词表现 + 市场侧指标：`google-analysis` keywords → 抽词 → 分批 `keyword`  | §3                   |
 | 5   | 搜索词 + 拓词：浪费流量 / 否词线索                                               | §4                   |
 | 6   | 高商业意图粗筛：CPC、竞争度、搜索量                                              | §5                   |
-| 7   | 否词或否词根落地：`ad keyword-negative-create` 等                                | §4 + `google-ads.md` |
+| 7   | 否词或否词根落地：`ad keyword-negative-create` 等                                | §4 + `google-ads/google-ads.md` |
 | 8   | Campaign → AdGroup → JSON：`ad campaign-validate` → `ad campaign-create` | §6                   |
 | 9   | 拓词结果导出：`keyword … --json-out`，供脚本消费                                 | §7                   |
 
@@ -119,8 +119,8 @@ siluzan-tso keyword -k "pipe" --geo 2840,2826 --json-out ./snap-kw-merged
 
 ## 通用执行规范
 
-- **一律**对可复用中间结果使用 `--json-out <目录>`（或等价快照参数），再读 `cli-manifest*.json` / 各 section 的 `*.outline.txt` 了解字段；详见 **`references/tips.md`**。
-- **写账户**（新建系列/加词/加否词）：新建系列走 **`references/google-ads-campaign-plan.md`**（含 `campaign-validate`）；其余写操作先与用户确认，写后用成对读命令复核（命令见 `google-ads.md`）。
+- **一律**对可复用中间结果使用 `--json-out <目录>`（或等价快照参数），再读 `cli-manifest*.json` / 各 section 的 `*.outline.txt` 了解字段；详见 **`references/core/tips.md`**。
+- **写账户**（新建系列/加词/加否词）：新建系列走 **`references/google-ads/google-ads-campaign-plan.md`**（含 `campaign-validate`）；其余写操作先与用户确认，写后用成对读命令复核（命令见 `google-ads/google-ads.md`）。
 
 ---
 
@@ -128,19 +128,19 @@ siluzan-tso keyword -k "pipe" --geo 2840,2826 --json-out ./snap-kw-merged
 
 ### 0）先知识库、再市场侧拓词（推荐）
 
-当用户给出**客户/品牌**或需要**产品型号、英文类目、应用场景**才能写出靠谱种子词时，**先**走 `references/rag.md`，**再**调用 `keyword`（市场侧指标与账户内表现仍须区分，见文首「数据口径」）。
+当用户给出**客户/品牌**或需要**产品型号、英文类目、应用场景**才能写出靠谱种子词时，**先**走 `references/analytics/rag.md`，**再**调用 `keyword`（市场侧指标与账户内表现仍须区分，见文首「数据口径」）。
 
 1. 选定客户知识库：  
-   `siluzan-tso rag list --rag-only --json`
+   `siluzan-tso rag list --rag-only --json-out ./snap`
 2. 检索产品/行业背景（锁定 `--folder-id`，长正文优先 `--partition wiki`）：  
-   `siluzan-tso rag query -q "产品型号 英文类目 应用场景 认证" --folder-id <id> --partition wiki --top-k 12 --json`
+   `siluzan-tso rag query -q "产品型号 英文类目 应用场景 认证" --folder-id <id> --partition wiki --top-k 12 --json-out ./snap`
 3. 从 RAG 片段归纳 **2–8 个种子词**（含官网/画册中的英文写法），再拓词：  
    `siluzan-tso keyword -k "种子1,种子2,..." [--url "<落地页>"] --json-out ./snap-kw`
 4. 报告/词包说明中标注：**卖点与术语来自知识库片段**；搜索量/CPC/竞争度来自 `keyword`（市场参考）。
 
 ```bash
-siluzan-tso rag list --rag-only --json
-siluzan-tso rag query -q "结构胶 型号 SG 建筑幕墙" --folder-id <id> --partition wiki --top-k 12 --json
+siluzan-tso rag list --rag-only --json-out ./snap
+siluzan-tso rag query -q "结构胶 型号 SG 建筑幕墙" --folder-id <id> --partition wiki --top-k 12 --json-out ./snap
 siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "https://example.com/products" --json-out ./snap-kw
 ```
 
@@ -174,7 +174,7 @@ siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "
 
 1. `siluzan-tso google-analysis -a <id> --sections search-terms --start <S> --end <E> --json-out ./snap-st`
 2. 与 `keyword` 拓词结果对照，由 AI 列否词根或精确否词；落地执行：  
-   `siluzan-tso ad keyword-negative-create …`（见 `references/google-ads.md`）。
+   `siluzan-tso ad keyword-negative-create …`（见 `references/google-ads/google-ads.md`）。
 
 ### 5）高商业意图粗筛（出价 + 竞争度 + 搜索量）
 
@@ -183,22 +183,22 @@ siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "
 
 ### 6）词包 → campaign-create JSON
 
-拓词落盘结果 + `google-ads-keyword-taxonomy.md` 分层建议 → 填 JSON（`KeywordsForBatchJob`、`campaign-validate`、`campaign-create`）见 **`references/google-ads-campaign-plan.md`** § 标准流水线 **步 3–7**。
+拓词落盘结果 + `google-ads-keyword-taxonomy.md` 分层建议 → 填 JSON（`KeywordsForBatchJob`、`campaign-validate`、`campaign-create`）见 **`references/google-ads/google-ads-campaign-plan.md`** § 标准流水线 **步 3–7**。
 
 ### 7）拓词结果标准化导出
 
 1. ```bash
    siluzan-tso keyword -k "..." [--url ...] [--include ...] [--exclude ...] --json-out ./snap-kw
    ```
-2. 消费顺序：**先**读该目录下 `cli-manifest*.json` 与 **`*.outline.txt`（字段结构）**，**再**用脚本 `require()` 或聚合逻辑读真实数据 JSON；禁止跳过 outline 猜字段。总约定见 **`references/tips.md`**。
+2. 消费顺序：**先**读该目录下 `cli-manifest*.json` 与 **`*.outline.txt`（字段结构）**，**再**用脚本 `require()` 或聚合逻辑读真实数据 JSON；禁止跳过 outline 猜字段。总约定见 **`references/core/tips.md`**。
 
 ---
 
 ## 单命令速查
 
 ```bash
-siluzan-tso keyword -k "<必填，逗号分隔多词>" [-a <mediaCustomerId>] [--geo <id[,id...]>] [--url <url>] [--google-only] [--include <words>] [--exclude <words>] [--json] [--json-out <dir>] [--verbose]
-siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [--json] [--json-out <dir>]
+siluzan-tso keyword -k "<必填，逗号分隔多词>" [-a <mediaCustomerId>] [--geo <id[,id...]>] [--url <url>] [--google-only] [--include <words>] [--exclude <words>] [--json-out ./snap] [--json-out <dir>] [--verbose]
+siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [--json-out ./snap] [--json-out <dir>]
 ```
 
 `-a`：走 `keywordrecommendation/recommend/{id}/google`；先 `list-accounts -m Google -k <id>` 确认账户与 **`currencyCode`**；出价金额字段为 `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（**账户币种「元」**，非汇率换算）。
@@ -207,4 +207,4 @@ siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [
 
 **返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级与每条 **`bidAmountCurrency`**（无账户=`USD`；有账户=`list-accounts` 的 `currencyCode`）；`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（微元 ÷1,000,000，**与 `bidAmountCurrency` 一致**）。另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。
 
-与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。
+与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。

package/dist/skill/references/{rag.md → analytics/rag.md}

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 
@@ -14,7 +14,7 @@
 
 ```bash
 # 1. 列出已建索引的知识库（按客户/品牌选 folder）
-siluzan-tso rag list --rag-only --json
+siluzan-tso rag list --rag-only --json-out ./snap
 
 # 2. 检索产品/行业资料（建议锁定 --folder-id）
 siluzan-tso rag query -q "产品核心卖点 应用场景 目标客群" --folder-id <id> --partition wiki --top-k 12
@@ -27,12 +27,12 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
 
 | 选项          | 默认      | 说明                                                            |
 | ------------- | --------- | --------------------------------------------------------------- |
-| `-q, --query` | 必填      | 检索词。含空白时按词分检、去重合并（`--json` 含 `subQueries`）  |
+| `-q, --query` | 必填      | 检索词。含空白时按词分检、去重合并（`--json-out` 含 `subQueries`）  |
 | `--folder-id` | 全库      | 文件夹 ID，逗号分隔；**已识别客户/品牌时强烈建议锁定**          |
 | `--tags`      | 不过滤    | 不传 = 全库无标签限制                                           |
 | `--partition` | `default` | 仅 `wiki` 或 `default`；长正文优先 `wiki`，缺细节再补 `default` |
 | `--top-k`     | 7         | 每分检 3–30 条；多词合并上限 `min(30, topK×词数)`               |
-| `--json`      | false     | 机器可读输出（含 `score` 0–1，越大越相关）                      |
+| `--json-out`      | false     | 机器可读输出（含 `score` 0–1，越大越相关）                      |
 
 `belongToId` 默认从 `GET /query/account/me` 的 `companyId` 解析；`csoBaseUrl` 从 TSO API 自动推导（`tso-api` → `cso`），可用 `SILUZAN_CSO_BASE` 覆盖。
 
@@ -42,14 +42,14 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
 
 | 用户意图                       | 建议检索词（示例）                        | 后续 TSO 命令                                                     |
 | ------------------------------ | ----------------------------------------- | ----------------------------------------------------------------- |
-| Google 搜索广告方案 / 批量草稿 | 产品卖点、应用行业、目标国家、竞品差异    | `google-ads-campaign-plan.md` + `keyword` / `campaign-create`；草稿发布见 `google-ads.md` § ad batch |
-| 关键字拓词补语境               | 产品型号、英文类目、行业术语、应用场景    | `keyword suggest -k "..."`；编排见 `keyword-planner-workflows.md` |
+| Google 搜索广告方案 / 批量草稿 | 产品卖点、应用行业、目标国家、竞品差异    | `google-ads/google-ads-campaign-plan.md` + `keyword` / `campaign-create`；草稿发布见 `google-ads/google-ads.md` § ad batch |
+| 关键字拓词补语境               | 产品型号、英文类目、行业术语、应用场景    | `keyword suggest -k "..."`；编排见 `analytics/keyword-planner-workflows.md` |
 | 账户诊断 / 周期报告「背景」段  | 公司简介、主营产品、目标市场、认证资质    | `google-analysis` + `report-templates/` 对应模板                  |
 | 询盘分析报告                   | 产品线、出口市场、客户画像、大洲业务侧重  | `report-templates/google-inquiry-analysis.md`                     |
-| 开户行业/资质核对              | 营业执照经营范围、行业描述、品牌全称      | `open-account-by-media.md` 对应媒体开户流                         |
+| 开户行业/资质核对              | 营业执照经营范围、行业描述、品牌全称      | `accounts/open-account-by-media.md` 对应媒体开户流                         |
 | 优化建议解释                   | 产品毛利结构、旺季、转化路径（表单/电话） | `optimize` 记录 + 人工解读；数据仍来自 `google-analysis`          |
 
-检索结果**只作事实参考**：广告标题/描述须符合 `google-ads-rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
+检索结果**只作事实参考**：广告标题/描述须符合 `google-ads/rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
 
 ---
 
@@ -57,7 +57,7 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
 
 ### 1. 先锁客户库
 
-- 运行 `rag list --rag-only --json`，按知识库**名称**匹配用户说的公司/品牌。
+- 运行 `rag list --rag-only --json-out ./snap`，按知识库**名称**匹配用户说的公司/品牌。
 - 多客户代运营：每个客户单独 `--folder-id`，**禁止**混库检索后张冠李戴。
 
 ### 2. 改写为「检索型」问句
@@ -79,7 +79,7 @@ siluzan-tso rag query -q "目标市场 国家 行业" --folder-id <id> --partiti
 典型编排：
 
 ```
-rag list --rag-only --json
+rag list --rag-only --json-out ./snap
   → rag query（产品/行业背景）
   → list-accounts -k <id>
   → keyword suggest / google-analysis / ad campaigns
@@ -99,6 +99,6 @@ rag list --rag-only --json
 | 维度      | siluzan-tso `rag`                         | siluzan-cso `rag`                             |
 | --------- | ----------------------------------------- | --------------------------------------------- |
 | 主要用途  | 广告投放、分析、拓词、报告背景            | 社媒文案、三库素材、口播写稿                  |
-| 默认 tags | 不过滤（按 folder 锁客户）                | 常配合三库 tags（见 CSO `references/rag.md`） |
+| 默认 tags | 不过滤（按 folder 锁客户）                | 常配合三库 tags（见 CSO `references/analytics/rag.md`） |
 | 后续命令  | `ad` / `keyword` / `google-analysis`      | `publish` / 写稿工作流                        |
 | API       | 相同 `cutapi/v1/material/queryknowledges` | 相同                                          |

package/dist/skill/references/{reporting.md → analytics/reporting.md}

@@ -3,10 +3,10 @@
 > 所属 skill：`siluzan-tso`。
 >
 > 本文档仅覆盖 **TSO steward 优化报告**：列表、生成、删除、邮件推送与网页查看。  
-> **账户分析拉数**（`google-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`）与**周期/诊断报告纲要**见 `references/account-analytics.md`。  
-> **异步批量创建记录**（`ad batch`）见 `references/google-ads.md` § ad batch。  
-> **AI 广告优化**（`optimize`）见 `references/optimize.md`。  
-> **广告线索**（`clue`）见 `references/clue.md`。
+> **账户分析拉数**（`google-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`）与**周期/诊断报告纲要**见 `references/analytics/account-analytics.md`。  
+> **异步批量创建记录**（`ad batch`）见 `references/google-ads/google-ads.md` § ad batch。  
+> **AI 广告优化**（`optimize`）见 `references/operations/optimize.md`。  
+> **广告线索**（`clue`）见 `references/operations/clue.md`。
 
 ---
 
@@ -25,7 +25,7 @@ siluzan-tso report list -m <媒体> [选项]
 | `-s, --status <ready>`   | 是否已生成：`true \| false`          |
 | `-k, --keyword <text>`   | 报告名称关键字                       |
 | `--start / --end <date>` | 日期范围（YYYY-MM-DD）               |
-| `--json`                 | 输出原始 JSON                        |
+| `--json-out`                 | 输出原始 JSON                        |
 
 **仅 JSON 交付**：若用户明确要求「只输出一个 JSON / 不要解释」，回复中**只放一个** JSON 代码块（与本次 CLI stdout 一致），前后不加说明文字；分页结果以 JSON 内 `page` / `pageSize` / `total` / `itemCount` 为准，需全量时再翻页执行。
 
@@ -39,7 +39,7 @@ siluzan-tso report list -m Google
 siluzan-tso report list -m TikTok -t Daily --start 2026-03-01 --end 2026-03-31
 
 # 只看已生成完成的报告
-siluzan-tso report list -m Google --status true --json
+siluzan-tso report list -m Google --status true --json-out ./snap
 ```
 
 ---
@@ -113,7 +113,7 @@ siluzan-tso report push list -m <媒体> [选项]
 | `--stopped`          | 仅已停用                        |
 | `--start` / `--end`  | 日期筛选                        |
 | `-p` / `--page-size` | 分页                            |
-| `--json`             | 原始 JSON（列表信封 + `items`） |
+| `--json-out`             | 原始 JSON（列表信封 + `items`） |
 
 #### create — 新建推送
 
@@ -145,12 +145,12 @@ siluzan-tso report push update -m Google --id <配置UUID> \
 #### history — 推送记录
 
 `GET {apiBaseUrl}/query/report-push/settings/{Media}/{settingId}/push-history?...`  
-路径中的 **`settingId`** = 推送规则的 **`entityId`**（与 `push list --json` 的 `items[].entityId` 一致；网页点「推送记录」带入路由的 `entityId`）。
+路径中的 **`settingId`** = 推送规则的 **`entityId`**（与 `push list --json-out ./snap` 的 `items[].entityId` 一致；网页点「推送记录」带入路由的 `entityId`）。
 
 Query：`pageIndex`、`pageSize`、`startDate` / `endDate`（未传时空串；传 `YYYY-MM-DD` 时 CLI 会加成 `T00:00:00+08:00`）、`ReceiveEmail`、`ReportType`、`MediaAccountId`（筛选账户时为账户 **entityId**）。
 
 ```bash
-siluzan-tso report push history -m Google --setting-id <规则entityId> [--json]
+siluzan-tso report push history -m Google --setting-id <规则entityId> [--json-out ./snap]
 siluzan-tso report push history -m Google --setting-id <规则entityId> \
   --start 2026-03-01 --end 2026-03-31 \
   --receive-email x@y.com --report-type Daily --media-account-id <账户entityId>
@@ -169,7 +169,7 @@ siluzan-tso report push delete -m Google --id <entityId>
 **示例：**
 
 ```bash
-siluzan-tso report push list -m Google --page-size 10 --json
+siluzan-tso report push list -m Google --page-size 10 --json-out ./snap
 
 siluzan-tso report push create -m Google --name "测试" \
   --media-accounts 6659e68b-973c-40bb-980c-6af20fbefe7d \
@@ -180,7 +180,7 @@ siluzan-tso report push update -m Google --id be5e4a03-2e0f-4bb2-bcad-e9dd86250e
   --media-accounts 6659e68b-973c-40bb-980c-6af20fbefe7d \
   --emails liuqi@chenggongyi.com --types Daily
 
-siluzan-tso report push history -m Google --setting-id be5e4a03-2e0f-4bb2-bcad-e9dd86250e18 --json
+siluzan-tso report push history -m Google --setting-id be5e4a03-2e0f-4bb2-bcad-e9dd86250e18 --json-out ./snap
 ```
 
 #### receive-emails — 历史收件邮箱（网页下拉同源）
@@ -188,7 +188,7 @@ siluzan-tso report push history -m Google --setting-id be5e4a03-2e0f-4bb2-bcad-e
 `GET /query/report-push/settings/{Media}/all/receive-emails` 返回 `string[]`：当前租户下推送配置曾使用过的收件邮箱，供创建/编辑推送或筛选记录时联想（与网页下拉一致）。
 
 ```bash
-siluzan-tso report push receive-emails -m Google [--json]
+siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 ```
 
 ---
@@ -203,19 +203,19 @@ siluzan-tso report push receive-emails -m Google [--json]
 | Google | 小时报（Hourly） | `{webUrl}/media-report/hour/{entityId}?culture=zh-CN`    |
 | TikTok | 日报             | `{webUrl}/media-report/publish/{entityId}?culture=zh-CN` |
 
-`entityId` 来自 `siluzan-tso report list --json` 中每条记录的 `entityId` 字段。
+`entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
 
 **示例流程：**
 
 ```bash
 # 第一步：查询报告，获取 entityId
-siluzan-tso report list -m Google --json
+siluzan-tso report list -m Google --json-out ./snap
 # 从输出中找到目标报告的 entityId，如 "rpt_abc123"
 
 # 第二步：查看 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
 ```