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

package/dist/skill/references/{hosted-automation-self-control.md → operations/hosted-automation-self-control.md}

@@ -1,18 +1,18 @@
 # 宿主编排：三类 Google 投放自控（详细步骤）
 
-> **主题索引**：[`hosted-automation-scenarios.md`](hosted-automation-scenarios.md)  
+> **主题索引**：[`operations/hosted-automation-scenarios.md`](operations/hosted-automation-scenarios.md)  
 > **编排责任**：定时、多条件 IF、滑动时间窗、通知（含 P1 /「空耗熔断」文案）由 **OpenClaw / WorkBuddy / Cron** 等宿主实现。  
 > **本页责任**：说明如何用 `siluzan-tso` **拉检查项**、**执行最终写操作**、**写后复核**。
 
 **必读交叉引用**：
 
-- 金额与展示：`SKILL.md`「金额与货币单位硬约束」；**`ad campaigns --json` 的 `budget` 已为元**；组级等 `*Display` 与原始分字段关系见 `references/google-ads.md`、`ad groups` 的 `--json` 说明。
-- `--json` 与 Node 过滤：`references/tips.md`
-- 写命令语法：`references/google-ads.md`（系列编辑、广告组编辑、启停等）
-- 账户/维度分析、时间窗：`references/account-analytics.md`
-- **异常监控**（余额、小时花费、落地页、拒审等 **`--json` 键名**）：[`hosted-automation-monitoring-json.md`](hosted-automation-monitoring-json.md)
+- 金额与展示：`SKILL.md`「金额与货币单位硬约束」；**`ad campaigns --json-out ./snap` 的 `budget` 已为元**；组级等 `*Display` 与原始分字段关系见 `references/google-ads/google-ads.md`、`ad groups` 的 `--json-out` 说明。
+- `--json-out` 与 Node 过滤：`references/core/tips.md`
+- 写命令语法：`references/google-ads/google-ads.md`（系列编辑、广告组编辑、启停等）
+- 账户/维度分析、时间窗：`references/analytics/account-analytics.md`
+- **异常监控**（余额、小时花费、落地页、拒审等 **`--json-out` 落盘 JSON 键名**）：[`operations/hosted-automation-monitoring-json.md`](operations/hosted-automation-monitoring-json.md)
 
-**前置**：已 `siluzan-tso login`，并已用 `list-accounts -m Google -k <mediaCustomerId> --json` 确认账户与 `mediaCustomerId`。
+**前置**：已 `siluzan-tso login`，并已用 `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap` 确认账户与 `mediaCustomerId`。
 
 ---
 
@@ -22,17 +22,17 @@
 
 「今日累计」口径须与宿主配置一致。默认建议 **账户业务日 `Asia/Shanghai`** 的日历日；若宿主使用 UTC 或其他时区，须在配置中固定并在以下命令的 `--start` / `--end` 中显式换算为 **`YYYY-MM-DD`**，**不要**在文档未约定时自行假设。
 
-### 检查项常用 JSON 字段（以当次 `siluzan-tso … --json` 为准）
+### 检查项常用 JSON 字段（以当次 `siluzan-tso … --json-out ./snap` 为准）
 
 | 检查意图              | 可关注的 JSON 字段（键名以实际 stdout 为准）                                                                                                             |
 | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | 周期内费用            | 系列/组/创意列表中的 **`spend`**；报表类子命令中带费用的指标字段                                                                                         |
-| 日预算与费用比        | **`ad campaigns --json`**：`**budget`**（CLI 已为元）与 **`spend`**；比较时须**统一货币与单位\*\*（见 `SKILL.md` 金额硬规范）                            |
+| 日预算与费用比        | **`ad campaigns --json-out ./snap`**：`**budget`**（CLI 已为元）与 **`spend`**；比较时须**统一货币与单位\*\*（见 `SKILL.md` 金额硬规范）                            |
 | 转化次数              | **`conversions`**（或报表里等价字段名）                                                                                                                  |
 | 实际 CPA              | 宿主侧 **`spend / conversions`**（`conversions` 为 0 时不做 CPA 判断）                                                                                   |
-| 目标 CPA（系列 / 组） | 系列列表 JSON 中的 **`targetCpa_BidingAmount`** 等；组列表 **`ad groups --json`** 中的 **`targetCpaAmount`**（写入口径见 `google-ads.md`「广告组编辑」） |
+| 目标 CPA（系列 / 组） | 系列列表 JSON 中的 **`targetCpa_BidingAmount`** 等；组列表 **`ad groups --json-out ./snap`** 中的 **`targetCpaAmount`**（写入口径见 `google-ads/google-ads.md`「广告组编辑」） |
 
-若某条检查所需字段在**当前** `--json` 中不存在，**禁止猜测**：先换用 `references/account-analytics.md` 中其它子命令拉数，或与维护方确认是否需扩展 `siluzan-tso`；宿主侧不得编造字段。
+若某条检查所需字段在**当前**落盘 JSON 中不存在，**禁止猜测**：先换用 `references/analytics/account-analytics.md` 中其它子命令拉数，或与维护方确认是否需扩展 `siluzan-tso`；宿主侧不得编造字段。
 
 ---
 
@@ -46,7 +46,7 @@
 2. 拉系列列表（**统计日 = 当日**，起止同为该日或业务日定义）：
 
 ```bash
-siluzan-tso ad campaigns -a <mediaCustomerId> --start <YYYY-MM-DD> --end <YYYY-MM-DD> --json
+siluzan-tso ad campaigns -a <mediaCustomerId> --start <YYYY-MM-DD> --end <YYYY-MM-DD> --json-out ./snap
 ```
 
 3. 对 `items[]` 中每条系列（`id` 为系列 ID）：
@@ -63,7 +63,7 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status P
 ### 写后复核
 
 ```bash
-siluzan-tso ad campaigns -a <mediaCustomerId> --start <当日> --end <当日> --json
+siluzan-tso ad campaigns -a <mediaCustomerId> --start <当日> --end <当日> --json-out ./snap
 ```
 
 确认该 `id` 的 **`statusV2`**（或等价状态字段）为 **`Paused`**。
@@ -78,7 +78,7 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status E
 
 | 状态 | 说明                                                                                    |
 | ---- | --------------------------------------------------------------------------------------- |
-| 有   | 读：`ad campaigns --json`；写：`ad campaign-status`；复核：再次 `ad campaigns --json`。 |
+| 有   | 读：`ad campaigns --json-out ./snap`；写：`ad campaign-status`；复核：再次 `ad campaigns --json-out ./snap`。 |
 
 ---
 
@@ -87,15 +87,15 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status E
 **业务目标**：在过去 **X 小时**（或等价滑动窗口，由宿主定义）内 **`conversions ≥ 3`** 且 **实际 CPA > 目标 CPA × 飙升阈值**（如 **1.3**）时降价：
 
 - 系列为 **tCPA**：下调 **target_cpa** 约 **10%–15%**（具体比例配置在宿主）。
-- **eCPC**：下调 **cpc_bid_ceiling** 约 **15%**（系列侧多为 `ad campaign-edit --bid-ceiling` 等，见 `google-ads.md`；组侧手动上限可用 **`ad adgroup-edit --max-cpc`**，策略以实际账户为准）。
+- **eCPC**：下调 **cpc_bid_ceiling** 约 **15%**（系列侧多为 `ad campaign-edit --bid-ceiling` 等，见 `google-ads/google-ads.md`；组侧手动上限可用 **`ad adgroup-edit --max-cpc`**，策略以实际账户为准）。
 
 ### 检查项（宿主每轮执行）
 
-1. **时间窗**：由宿主将「过去 X 小时」映射为 **`--start` / `--end`**（或按小时粒度拆多次拉取再聚合，以 `account-analytics.md` 与接口能力为准）。
+1. **时间窗**：由宿主将「过去 X 小时」映射为 **`--start` / `--end`**（或按小时粒度拆多次拉取再聚合，以 `analytics/account-analytics.md` 与接口能力为准）。
 2. **拉数**（至少覆盖费用、转化；字段以实际 JSON 为准）：
-   - 系列维度：`ad campaigns … --json`
-   - 组维度：`ad groups … --json`
-   - 若列表不足以算「过去 X 小时」，使用 **`account-analytics`** 或报表子命令中可下到系列/组且带时间粒度的接口（见 `account-analytics.md`）。
+   - 系列维度：`ad campaigns … --json-out ./snap`
+   - 组维度：`ad groups … --json-out ./snap`
+   - 若列表不足以算「过去 X 小时」，使用 **`account-analytics`** 或报表子命令中可下到系列/组且带时间粒度的接口（见 `analytics/account-analytics.md`）。
 3. 对候选对象：
    - `conversions`（窗口内）**≥ 3**
    - `actual_cpa = spend / conversions`（`conversions > 0`）
@@ -113,7 +113,7 @@ siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --target-cpa
 # siluzan-tso ad campaign-edit ... --bid-ceiling <主币种金额> --bidding TARGET_SPEND
 ```
 
-参数与单位见 **`references/google-ads.md`**「ad campaign-edit」金额单位说明。
+参数与单位见 **`references/google-ads/google-ads.md`**「ad campaign-edit」金额单位说明。
 
 **广告组**：
 
@@ -123,14 +123,14 @@ siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --target-cpa <
 siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主币种金额>
 ```
 
-见 **`references/google-ads.md`**「广告组编辑」。
+见 **`references/google-ads/google-ads.md`**「广告组编辑」。
 
-写前**必须**先 **`ad groups --json` / `ad campaigns --json`** 取当前值，**读取主币种金额**：组侧读 `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）；系列列表侧 `ad campaigns` 的 `budget` 也是元（与写参 `--budget` 一致）；`google-analysis campaigns-*.json` 的 `budgetAmountYuan` 同。在宿主内按主币种算新值（如下调 12%：`newYuan = round(oldYuan * 0.88 * 100) / 100`），再以主币种金额作为 `--target-cpa` / `--max-cpc` / `--budget` 传回。
+写前**必须**先 **`ad groups --json-out ./snap` / `ad campaigns --json-out ./snap`** 取当前值，**读取主币种金额**：组侧读 `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）；系列列表侧 `ad campaigns` 的 `budget` 也是元（与写参 `--budget` 一致）；`google-analysis campaigns-*.json` 的 `budgetAmountYuan` 同。在宿主内按主币种算新值（如下调 12%：`newYuan = round(oldYuan * 0.88 * 100) / 100`），再以主币种金额作为 `--target-cpa` / `--max-cpc` / `--budget` 传回。
 **严禁** 自己再做 `÷100` / `÷1_000_000` 换算——`*Yuan` 字段已经是元，再换算就是错的。
 
 ### 写后复核
 
-再次 **`ad campaigns --json`** 或 **`ad groups --json`**：
+再次 **`ad campaigns --json-out ./snap`** 或 **`ad groups --json-out ./snap`**：
 
 - 优先比对 **`*Display` 字段**（主币种）与预期主币种金额一致；
 - 整数字段 `targetCpa_BidingAmount` / `targetCpaAmount` / `maxCPCAmount` / `budget` 应等于 `主币种 × 100` 后的整数。
@@ -153,7 +153,7 @@ siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主
 2. **广告组**：
 
 ```bash
-siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --json
+siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --json-out ./snap
 ```
 
 对 `items[]`：读取 **`spend`**（费用）、**`conversions`**；目标 CPA 来自 **`targetCpaAmount`** 与 **`toDisplayMoney` 逆运算** 或宿主配置的「目标 CPA（主币种）」；计算 `limit = target_cpa_main_currency * N`（**N** 为配置）。
@@ -163,7 +163,7 @@ siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --jso
 3. **广告（创意）**级：若策略在创意维熔断：
 
 ```bash
-siluzan-tso ad list -a <mediaCustomerId> --start <当日> --end <当日> --json
+siluzan-tso ad list -a <mediaCustomerId> --start <当日> --end <当日> --json-out ./snap
 ```
 
 同样判断费用与转化；命中则 **`ad ad-status`**。
@@ -176,7 +176,7 @@ siluzan-tso ad adgroup-status -a <mediaCustomerId> --id <adGroupId> --status Pau
 siluzan-tso ad ad-status -a <mediaCustomerId> --id <adId> --status Paused
 ```
 
-（`ad-status` 若需 `--start`/`--end` 见 `google-ads.md`。）
+（`ad-status` 若需 `--start`/`--end` 见 `google-ads/google-ads.md`。）
 
 ### 通知（宿主）
 
@@ -185,7 +185,7 @@ siluzan-tso ad ad-status -a <mediaCustomerId> --id <adId> --status Paused
 ### 写后复核
 
 ```bash
-siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --json
+siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --json-out ./snap
 # 或 ad list …
 ```
 
@@ -204,7 +204,7 @@ siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --jso
 | 步骤 | 说明                                                         |
 | ---- | ------------------------------------------------------------ |
 | 1    | 配置：账户列表、系数、N、X 小时、白名单、是否自动写、通知    |
-| 2    | 每轮：`list-accounts` 或固定 `mediaCustomerId` → 拉 `--json` |
+| 2    | 每轮：`list-accounts` 或固定 `mediaCustomerId` → 拉 `--json-out` |
 | 3    | 宿主内算 IF（本页公式）                                      |
 | 4    | 命中则调用写命令（可批量，注意 API 限速）                    |
 | 5    | 每写一条即复核读；失败重试与告警由宿主处理                   |

package/{assets/siluzan-ads/references → dist/skill/references/operations}/hosted-automation-user-catalog.md

@@ -8,31 +8,31 @@
 
 | 提醒名称            | 系统在后台默默帮你做什么？(自动动作)                                                                                                                                  | 文档（references）                                                                                                                                                                                                                                                                                                                                |
 | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1. 单日预算熔断     | 当日系列 **花费**相对**日预算**达到设定比例（如 ≥110%，可配 110%–120% 抗延迟）时，**暂停 Campaign**；恢复需人工加预算后再启用。                                       | [场景 1 · 单日预算熔断](hosted-automation-self-control.md) · [`google-ads.md`](google-ads.md)（`ad campaigns`、`ad campaign-status`、预算口径） · [`tips.md`](tips.md)（`--json`）                                                                                                                                                                |
-| 2. CPA 飙升自动降价 | 滑动时间窗内 **转化数**达置信阈值且 **实际 CPA** 高于 **目标 CPA×飙升比例** 时，在 **Campaign / Ad Group** 上**下调** tCPA 或 eCPC 等**出价上限**（具体策略依账户）。 | [场景 2 · CPA 飙升自动降价](hosted-automation-self-control.md) · [`hosted-automation-optimize-weak-downbid.md`](hosted-automation-optimize-weak-downbid.md)（组/创意侧降价关停，可与宿主组合） · [`google-ads.md`](google-ads.md)（`campaign-edit`、`adgroup-edit`） · [`account-analytics.md`](account-analytics.md)（窗口粒度不足时的报表拉数） |
-| 3. 连续空耗自动暂停 | **当日**累计 **花费 ≥ 目标 CPA×N** 且 **转化为 0** 时，**暂停**广告组或创意；宿主发 **P1** 且文案含 **「空耗熔断」**。                                                | [场景 3 · 连续空耗自动暂停](hosted-automation-self-control.md) · [`google-ads.md`](google-ads.md)（`ad groups`、`ad list`、`adgroup-status`、`ad-status`） · [`hosted-automation-monitoring-json.md`](hosted-automation-monitoring-json.md)（JSON 键名勿套用 Google Ads API 官方名）                                                              |
+| 1. 单日预算熔断     | 当日系列 **花费**相对**日预算**达到设定比例（如 ≥110%，可配 110%–120% 抗延迟）时，**暂停 Campaign**；恢复需人工加预算后再启用。                                       | [场景 1 · 单日预算熔断](operations/hosted-automation-self-control.md) · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`ad campaigns`、`ad campaign-status`、预算口径） · [`core/tips.md`](core/tips.md)（`--json-out`）                                                                                                                                                                |
+| 2. CPA 飙升自动降价 | 滑动时间窗内 **转化数**达置信阈值且 **实际 CPA** 高于 **目标 CPA×飙升比例** 时，在 **Campaign / Ad Group** 上**下调** tCPA 或 eCPC 等**出价上限**（具体策略依账户）。 | [场景 2 · CPA 飙升自动降价](operations/hosted-automation-self-control.md) · [`operations/hosted-automation-optimize-weak-downbid.md`](operations/hosted-automation-optimize-weak-downbid.md)（组/创意侧降价关停，可与宿主组合） · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`campaign-edit`、`adgroup-edit`） · [`analytics/account-analytics.md`](analytics/account-analytics.md)（窗口粒度不足时的报表拉数） |
+| 3. 连续空耗自动暂停 | **当日**累计 **花费 ≥ 目标 CPA×N** 且 **转化为 0** 时，**暂停**广告组或创意；宿主发 **P1** 且文案含 **「空耗熔断」**。                                                | [场景 3 · 连续空耗自动暂停](operations/hosted-automation-self-control.md) · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`ad groups`、`ad list`、`adgroup-status`、`ad-status`） · [`operations/hosted-automation-monitoring-json.md`](operations/hosted-automation-monitoring-json.md)（JSON 键名勿套用 Google Ads API 官方名）                                                              |
 
-**总索引**：[`hosted-automation-scenarios.md`](hosted-automation-scenarios.md) · **自控全文**：[`hosted-automation-self-control.md`](hosted-automation-self-control.md) · **金额硬规范**（展示用 `*Display` 等）：[`SKILL.md`](../SKILL.md)「金额与货币单位硬约束」。
+**总索引**：[`operations/hosted-automation-scenarios.md`](operations/hosted-automation-scenarios.md) · **自控全文**：[`operations/hosted-automation-self-control.md`](operations/hosted-automation-self-control.md) · **金额硬规范**（展示用 `*Display` 等）：[`SKILL.md`](../SKILL.md)「金额与货币单位硬约束」。
 
 ## 异常监控与报警系统
 
-编排（定时、HTTP 探活、通知）在宿主；**读哪些 JSON 字段、用什么命令** 以 **[`hosted-automation-monitoring-json.md`](hosted-automation-monitoring-json.md)** 为准（键名以当次 `--json` 为准，勿套用 Google Ads API 官方字段名解析本 CLI 输出）。
+编排（定时、HTTP 探活、通知）在宿主；**读哪些 JSON 字段、用什么命令** 以 **[`operations/hosted-automation-monitoring-json.md`](operations/hosted-automation-monitoring-json.md)** 为准（键名以当次 `--json-out` 落盘 JSON 为准，勿套用 Google Ads API 官方字段名解析本 CLI 输出）。
 
-| 功能名称          | 监控层级 / 说明                                                                                    | CLI 检查入口（`--json`）                                                                                                                                                             |
+| 功能名称          | 监控层级 / 说明                                                                                    | CLI 检查入口（`--json-out`）                                                                                                                                                             |
 | ----------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| 1. 账户被封禁     | 账户级；与 Google `CustomerStatus` 及 `list-accounts` 的字段映射**暂不写进本 skill**，由宿主约定。 | `list-accounts`、`balance` 等见 [`accounts.md`](accounts.md)                                                                                                                         |
+| 1. 账户被封禁     | 账户级；与 Google `CustomerStatus` 及 `list-accounts` 的字段映射**暂不写进本 skill**，由宿主约定。 | `list-accounts`、`balance` 等见 [`accounts/accounts.md`](accounts/accounts.md)                                                                                                                         |
 | 2. 落地页死链强停 | URL 不可用或跳错页时暂停关联创意，避免无效消耗。                                                   | **`google-analysis --sections final-urls`**；或 **`ad list`** / **`google-analysis --sections ads`** 取落地页字段后由宿主 HTTP 校验                                                  |
-| 3. 广告素材拒审   | 创意政策状态异常时告警或配合工单。                                                                 | **`ad list`** / **`google-analysis --sections ads`**：`policyApprovalStatusV2`、`approvalStatusDetails` 等（见 **[`google-ads.md`](google-ads.md)**）                                |
+| 3. 广告素材拒审   | 创意政策状态异常时告警或配合工单。                                                                 | **`ad list`** / **`google-analysis --sections ads`**：`policyApprovalStatusV2`、`approvalStatusDetails` 等（见 **[`google-ads/google-ads.md`](google-ads/google-ads.md)**）                                |
 | 4. 花费异动监控   | 系列或账户维度花费相对历史异常波动。                                                               | **`google-analysis --sections campaign-hour`**：按 `campaignId` + `date` + `hour` 看 **`spend`**                                                                                     |
 | 5. 余额枯竭预警   | 余额过低或按日均推算续航不足。                                                                     | **`balance-scan`**（`balance`、`remainingDays`、`hitReason`、`meta`）或 **`balance`** / **`google-analysis --sections overview`**（`remainingAccountBudget`、`averageDailyCost` 等） |
 
 ## 自动优化
 
-编排与阈值在宿主；**命令、JSON 键名、聚合与写后复核** 见 **[`hosted-automation-optimize-index.md`](hosted-automation-optimize-index.md)**（及链出的三份 SOP）。
+编排与阈值在宿主；**命令、JSON 键名、聚合与写后复核** 见 **[`operations/hosted-automation-optimize-index.md`](operations/hosted-automation-optimize-index.md)**（及链出的三份 SOP）。
 
 | 功能名称                | 说明                                                                                                                           | SOP                                                                                        |
 | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
-| 1. 表现差广告降价/关停  | 组/创意：CTR、CPA、转化等触达后 **下调 `targetCpa` 或 `Paused`**。                                                             | [`hosted-automation-optimize-weak-downbid.md`](hosted-automation-optimize-weak-downbid.md) |
-| 2. 高转化广告提价扩量   | 系列/组：ROAS 代理、预算丢失份额等触达后 **提预算 / 上调目标 CPA**。                                                           | [`hosted-automation-optimize-scale.md`](hosted-automation-optimize-scale.md)               |
-| 3. A/B 测试自动决出胜者 | 同组多创意：聚合后比 **CVPI / all conv** 等，**停输家**。                                                                      | [`hosted-automation-optimize-ab-winner.md`](hosted-automation-optimize-ab-winner.md)       |
-| 4. 异动根因自动排查建议 | 诊断报告与归因：用 `account-analytics`、报告模板等，见 [`account-analytics.md`](account-analytics.md) 与 `report-templates/`。 | （未单独拆 SOP，沿用分析文档）                                                             |
+| 1. 表现差广告降价/关停  | 组/创意：CTR、CPA、转化等触达后 **下调 `targetCpa` 或 `Paused`**。                                                             | [`operations/hosted-automation-optimize-weak-downbid.md`](operations/hosted-automation-optimize-weak-downbid.md) |
+| 2. 高转化广告提价扩量   | 系列/组：ROAS 代理、预算丢失份额等触达后 **提预算 / 上调目标 CPA**。                                                           | [`operations/hosted-automation-optimize-scale.md`](operations/hosted-automation-optimize-scale.md)               |
+| 3. A/B 测试自动决出胜者 | 同组多创意：聚合后比 **CVPI / all conv** 等，**停输家**。                                                                      | [`operations/hosted-automation-optimize-ab-winner.md`](operations/hosted-automation-optimize-ab-winner.md)       |
+| 4. 异动根因自动排查建议 | 诊断报告与归因：用 `account-analytics`、报告模板等，见 [`analytics/account-analytics.md`](analytics/account-analytics.md) 与 `report-templates/`。 | （未单独拆 SOP，沿用分析文档）                                                             |

package/dist/skill/references/{optimize.md → operations/optimize.md}

@@ -16,15 +16,15 @@ siluzan-tso optimize children --parent-id <id>       # 广告系列级明细
 | `-a, --account <id>`             | 账户 `mediaCustomerId`（走接口筛选；**已脱管账户可能为空**）                                                                                                      |
 | `--match-media-customer-id <id>` | **仅 `list`**：不按接口筛账户，拉全量后自动翻页、客户端匹配 `mediaCustomerId`（适合已不在 Siluzan 托管、但历史上仍有优化批次的 Google 客户号）                    |
 | `--start / --end <date>`         | 日期范围（YYYY-MM-DD，所有日期按北京时间（UTC+8）解释，调用时自动附加 `+08:00` 时区偏移）                                                                         |
-| `--id <id>`                      | `optimize get` 专用：UUID。常见来源——**账户批次**：`optimize list --json` 的 `items[].id` / `entityId`；**系列级记录**：`optimize records --json` 的 `items[].id` |
+| `--id <id>`                      | `optimize get` 专用：UUID。常见来源——**账户批次**：`optimize list --json-out ./snap` 的 `items[].id` / `entityId`；**系列级记录**：`optimize records --json-out ./snap` 的 `items[].id` |
 | `--parent-id <id>`               | 父级 ID（`children` 专用；与账户批次 `list` 里 `items[].id` 一致）                                                                                                |
-| `--json`                         | 输出原始 JSON（`list` / `records` / `children`）                                                                                                                  |
+| `--json-out`                         | 输出原始 JSON（`list` / `records` / `children`）                                                                                                                  |
 
 ## 已脱管 / 非当前托管账户：怎么查历史优化？
 
 1. **不要用** `optimize list -a <客户号>`（后端常按当前可管账户过滤，脱管后可能 0 条）。
 2. **也不要依赖** `optimize records -a <客户号>`（列表项往往没有 `mediaCustomerId`，接口侧筛选也可能无效）。
-3. **应使用**：`optimize list --match-media-customer-id <Google 客户号> [--start … --end …] --json`，在结果里取每条批次的 **`id`**（与 **`entityId`** 相同）。
+3. **应使用**：`optimize list --match-media-customer-id <Google 客户号> [--start … --end …] --json-out ./snap`，在结果里取每条批次的 **`id`**（与 **`entityId`** 相同）。
 4. 用该 **`id`**：`optimize get --id <id>` 看详情；`optimize children --parent-id <id>` 看该批次下各广告系列级明细。
 
 **示例：**
@@ -34,7 +34,7 @@ siluzan-tso optimize children --parent-id <id>       # 广告系列级明细
 siluzan-tso optimize list -a 6326027735
 
 # 已脱管：从全量历史里筛出该 Google 客户号（自动翻页）
-siluzan-tso optimize list --match-media-customer-id 3013981480 --start 2025-05-01 --json
+siluzan-tso optimize list --match-media-customer-id 3013981480 --start 2025-05-01 --json-out ./snap
 
 # 查询所有账户本月优化记录（系列级列表）
 siluzan-tso optimize records --start 2026-03-01 --end 2026-03-31
@@ -46,7 +46,7 @@ siluzan-tso optimize children --parent-id 4ced1f51-da71-4aac-84f9-4e2c4a25675f
 siluzan-tso optimize get --id 4ced1f51-da71-4aac-84f9-4e2c4a25675f
 
 # JSON 输出
-siluzan-tso optimize list -a 6326027735 --json
+siluzan-tso optimize list -a 6326027735 --json-out ./snap
 ```
 
 **接口说明（`optimize get`）**：`GET {apiBaseUrl}/Smart-Ads-Optimize/v2/{id}`。请求带 Datapermission（CLI 自动 `ensureDataPermission`）。响应体字段以后端为准，通常为格式化 JSON 打印到 stdout。

package/dist/skill/report-templates/README.md

@@ -21,7 +21,8 @@
 | `meta-period-report.md`              | Meta（Facebook）账户周期报告                                                                                   |
 | `tiktok-period-report.md`            | TikTok 广告主周期报告                                                                                          |
 | `bing-period-report.md`              | Bing（BingV2）分析报告                                                                                         |
-| `okki-weekly-google-client.md`       | **OKKI 周报**：Google 发客户固定话术 + 精简维度 CLI；**Excel 仅 Agent 脚本**（无 CLI 写表子命令），见 SKILL P6 |
+| `okki-weekly-google-client.md`       | **OKKI 周报**：Google 发客户固定话术 + 精简维度 CLI；**Excel 仅 Agent 脚本**，见 `references/core/playbooks.md` P6 |
+| `google-inquiry-analysis.md`         | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |
 
 ---
 

package/dist/skill/report-templates/REPORT-WORKFLOW.md

@@ -44,8 +44,8 @@
 
 ### 步骤 4：拉取数据
 
-- **`google-analysis` / `report …` 账户分析子命令**：统一 **`--json-out <目录>`** 落盘，再由脚本读 **`manifest-<accountId>.json` / `report-manifest-<accountId>.json`**（清单文件名见 stdout 摘要的 `manifestFile`）与各 **`<section>-<accountId>.json`**（见 `references/account-analytics.md`）。
-- **`stats`、`ad campaigns` 等辅助命令**：按 `references/tips.md` 与各命令文档做结构化拉数。
+- **`google-analysis` / `report …` 账户分析子命令**：统一 **`--json-out <目录>`** 落盘，再由脚本读 **`manifest-<accountId>.json` / `report-manifest-<accountId>.json`**（清单文件名见 stdout 摘要的 `manifestFile`）与各 **`<section>-<accountId>.json`**（见 `references/analytics/account-analytics.md`）。
+- **`stats`、`ad campaigns` 等辅助命令**：按 `references/core/tips.md` 与各命令文档做结构化拉数。
 - 仅执行与**本次报告维度**对应的命令（默认 + 用户追加）。
 - 数据失败/缺失：在对应章节写 `[ 数据不可用：{原因} ]`，不写推测。
 

package/dist/skill/report-templates/google-ads-diagnosis.md

@@ -247,7 +247,7 @@
 
 ### 8.3 搜索词洞察
 
-列：搜索词、展示、点击、点击率、转化、转化率、每次转化费用
+列：搜索词、**已添加/已排除**（`queryTargetingStatusZh`）、展示、点击、点击率、转化、转化率、每次转化费用
 
 - **数据分析** / **优化建议**：`fullSearchTerms.analysis`、`fullSearchTerms.suggestions`
 
@@ -326,4 +326,4 @@
 | 按日 CPA                                           | `daily-metrics`                                                                         |
 | 预算竞争力（展示份额等）                           | `dimension-summary` + `campaigns` 等组合计算                                            |
 
-详见 `references/account-analytics.md`。
+详见 `references/analytics/account-analytics.md`。

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

@@ -7,7 +7,7 @@
 > - `我给你询盘信息分析Google账号XXX效果`（附询盘资料 + 账户 ID）
 > - 含「询盘 + 账户 + Google」三要素的近义表述
 
-命中以上触发词时：**不要**按 `google-period-report.md` 的「8 维 + 追问」流程；按本文**固定字段 + 固定话术 + 固定时间窗**交付（数据全部来自 CLI 落盘 JSON，见 `references/account-analytics.md`）。
+命中以上触发词时：**不要**按 `google-period-report.md` 的「8 维 + 追问」流程；按本文**固定字段 + 固定话术 + 固定时间窗**交付（数据全部来自 CLI 落盘 JSON，见 `references/analytics/account-analytics.md`）。
 
 ---
 
@@ -66,8 +66,7 @@ siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-inqui
 
 # 2) 区间维度（Sheet 5/7/8；系列为整段 S~E 汇总）
 siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-inquiry \
-  --sections campaigns,keywords,search-terms,campaign-geo \
-  --limit 200
+  --sections campaigns,keywords,search-terms,campaign-geo
 
 # 3) 按月循环（Sheet 4 上区 + Sheet 4 下区 + Sheet 6）
 for month in <S月, S+1月, E月>:
@@ -83,10 +82,10 @@ for month in <S月, S+1月, E月>:
 - **Sheet 4 上区（账户月汇总）**：读 `./<YYYY-MM>/campaigns-*.json`，对 `campaigns[]` **全系列求和**得到当月账户级点击/展示/费用/转化，再算 CTR/CPC/CPA/CVR（公式见下文 Sheet 4）；与 Google「广告系列」页同区间加总口径一致。
 - `./snap-inquiry/campaigns-<accountId>_<S>-<E>.json`（步骤 2，整段 S~E）：仅用于 **Sheet 5** 系列明细；**不得**用它按月拆行填 Sheet 4。
 - `geographic`：账户级国家聚合；Sheet 6 与 Sheet 4 **下区**（重点国切片）按月目录读取。
-- `keywords` / `search-terms`：Sheet 7 / 8；默认 `limit=200`（TOP200）。
+- `keywords` / `search-terms`：Sheet 7 / 8；默认拉取**全部有消耗**行（`keywords` 网关 `costGreater=0`，`limit=0` 不封顶）；需 TOP N 时加 `--limit <n>`。
 - `campaign-geo`：含 `campaignName`，用于 Sheet 6「暂停的系列」列辅助派生（若运营不需要可留空）；也用于 Sheet 3 国家级消耗 join。
 - `geographic`：账户级国家聚合；Sheet 6 月度循环主源；Sheet 4 下半区「重点国家 vs 非重点国」按月切片（重点国默认取分析月询盘 Top1 国家，可由运营覆盖，详见下文 Sheet 4 节）。
-- **地理字段自动补齐**（由 `translate-fields.ts` 在 `campaign-geo` / `geographic` 行上自动补，未命中字典则不补，详见 `references/account-analytics.md`「中文化字段」）：
+- **地理字段自动补齐**（由 `translate-fields.ts` 在 `campaign-geo` / `geographic` 行上自动补，未命中字典则不补，详见 `references/analytics/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` 聚合**，自动把城市/地区行归并到所属国家，不再出现"未知大洲"。
@@ -150,7 +149,7 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 
 ## 国家 → 大洲映射
 
-- **数据源**：`references/geo-continents.json`（中文国家名 → 7 大洲，覆盖 200+ 主权国家 + 港澳台/巴勒斯坦/马恩岛/波多黎各等领土，由 `tso-cli/scripts/generate-geo-dictionaries.mjs` 与 `geo-en2zh.json` 同步生成；新增国家请加 `ISO_TO_CONTINENT` 映射后跑 `pnpm --filter siluzan-tso-cli run geo:generate`，**不要**手改 JSON）。
+- **数据源**：`references/analytics/geo-continents.json`（中文国家名 → 7 大洲，覆盖 200+ 主权国家 + 港澳台/巴勒斯坦/马恩岛/波多黎各等领土，由 `tso-cli/scripts/generate-geo-dictionaries.mjs` 与 `geo-en2zh.json` 同步生成；新增国家请加 `ISO_TO_CONTINENT` 映射后跑 `pnpm --filter siluzan-tso-cli run geo:generate`，**不要**手改 JSON）。
 - **默认 7 桶**：`亚洲` / `中东` / `欧洲` / `北美` / `南美` / `非洲` / `大洋洲`。
 - **运营常用 5 桶合并**（与样表 Sheet 3 一致）：`<重点国>` / `中东` / `非洲` / `欧美` / `亚洲(除重点国)`。**由脚本在写表前做二次合并**，伪代码：
 
@@ -293,7 +292,7 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 | 3   | **客户来源集中度**（透视 2）                                   | Top1 渠道占 `{p1}%`、Top3 合计 `{p3}%`；> 70% 高亮"渠道高度集中，风险敞口大"                 |
 | 4   | **长尾渠道**（透视 2）                                         | 占比 < 5% 的渠道数量与合计占比；用于会议讨论"是否归并/精简"                                  |
 | 5   | **产品 CPL 偏差**（透视 3，仅当产品→系列映射已配置）           | 列出 CPL > 整体均值 × 1.5 的产品（拖累），CPL < 整体均值 × 0.5 的产品（明星）                |
-| 6   | **大洲映射缺漏**                                               | 透视 1 中"所属大洲 = 未知大洲"的国家清单（提示运营回流 `geo-continents.json`）               |
+| 6   | **大洲映射缺漏**                                               | 透视 1 中"所属大洲 = 未知大洲"的国家清单（提示运营回流 `analytics/geo-continents.json`）               |
 
 **条数**：上表 6 条为**完整模板**；若某条数据为空（如未配置产品映射、无大洲缺漏），可省略该行，但其余必出。
 
@@ -444,7 +443,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 | R1               | `搜索字词--TOP100`                                                                                                                                                                                                                                                                      |
 | R2               | `<S> - <E>`（如 `2026年4月1日 - 2026年4月30日` 等中文区间）                                                                                                                                                                                                                             |
 | R3（A→Q，17 列） | `搜索字词` \| `搜索字词匹配类型` \| `已添加/已排除` \| `广告系列` \| `广告组` \| `搜索广告关键字` \| `点击次数` \| `展示次数` \| `点击率` \| `货币代码` \| `平均每次点击费用` \| `费用` \| `绝对页首展示次数百分比` \| `页首展示次数百分比` \| `转化次数` \| `每次转化费用` \| `转化率` |
-| R4…              | 读 `search-terms-*.json`（`data[]`）：`searchTermText` / `matchTypeZh` / **`已添加/已排除`**（若 JSON 字段不存在则填 `—`，**禁止**臆造）/ `campaignName` / `adGroupName` / `keywordText`（关键字）/ 数值字段；`货币代码` 来自 `list-accounts` 同账户 `currencyCode`                     |
+| R4…              | 读 `search-terms-*.json`（`data[]`）：`searchTermText` / `matchTypeZh` / **`queryTargetingStatusZh`**（已添加/已排除/都没有；网关字段 `queryTargetingStatus`）/ `campaignName` / `adGroupName` / `keywordText` / 数值字段；`货币代码` 来自 `list-accounts` 同账户 `currencyCode` |
 
 按 `费用` 降序前 100。
 
@@ -454,8 +453,8 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 
 | #   | 洞察类别                                                            | 内容（每条引用本 Sheet 具体数字）                                                                                                                              |
 | --- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | **未添加但高转化搜索词**（候选加为关键词）                          | 列 `已添加/已排除` ≠ "已添加" 且 `转化次数` ≥ `{阈值}` 的搜索词，按转化降序前 10；阈值取本期搜索词转化中位数                                                   |
-| 2   | **已添加但 0 转化高消耗搜索词**（候选加为否定关键词）               | 列 `已添加/已排除` = "已添加" 且 `转化次数` = 0 且 `费用` > `¥{阈值}` 的搜索词，按消耗降序前 10；阈值取本期搜索词消耗 P75                                      |
+| 1   | **未添加但高转化搜索词**（候选加为关键词）                          | `queryTargetingStatusZh` = "都没有" 且 `转化次数` ≥ `{阈值}`，按转化降序前 10；阈值取本期搜索词转化中位数                                                     |
+| 2   | **已添加但 0 转化高消耗搜索词**（候选加为否定关键词）               | `queryTargetingStatusZh` = "已添加" 且 `转化次数` = 0 且 `费用` > `¥{阈值}`，按消耗降序前 10；阈值取本期搜索词消耗 P75                                        |
 | 3   | **无关搜索词**（意图偏离候选）                                      | 基于 `搜索字词` 文本扫描，标出与广告组 / 关键字 主题明显不符的词（如"工厂"系列出现"价格便宜""免费""教程"等），前 5；**仅展示**，**不**自动判定，由运营会上拍板 |
 | 4   | **匹配方式分布**                                                    | `Broad`：`{n_b}` 个、占消耗 `{p_b}%`；`Phrase`：`{n_p}` 个、占消耗 `{p_p}%`；`Exact`：`{n_e}` 个、占消耗 `{p_e}%`                                              |
 | 5   | **页首展示低 / 高消耗搜索词**（仅当 `页首展示次数百分比` 字段可用） | 列 `费用` Top20 中 `页首展示次数百分比` < 50% 的搜索词，前 5；提示"花了钱但很少展示到页首，出价/质量得分待优化"                                                |
@@ -488,7 +487,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 2. **默认值（运营未指定时）**：取**分析月（最后一个月 E 月）`inquiries.json` 询盘数 Top1 国家**。脚本在控制台打印一行：`[focusCountry auto-pick] {E月}询盘 Top1 = {国家}（{count} 条），如需调整请回填运营配置`。
 3. **空数组兜底**：若分析月询盘 0 条，`focusCountries = []`；Sheet 3 跳过「重点国」单桶（直接走默认 5 桶里的对应大洲），Sheet 4 下半区**整段省略**并在 Sheet 标题留脚注 `[ 本期无询盘，省略国家切片 ]`。
 
-**禁止**：在脚本里硬编码 `"印度"`、`"India"` 等具体国家名作为业务逻辑（仅 `geo-en2zh.json` / `geo-continents.json` 这种字典数据除外）。
+**禁止**：在脚本里硬编码 `"印度"`、`"India"` 等具体国家名作为业务逻辑（仅 `geo-en2zh.json` / `analytics/geo-continents.json` 这种字典数据除外）。
 
 ---
 
@@ -519,7 +518,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 | 是否需要询盘原始数据     | 否                        | 否                             | **是**（用户上传 / 反问索要）                 |
 | 输出形态                 | 长文报告                  | 客户话术 + 多 Sheet xlsx       | **8 Sheet xlsx（不含客户话术）**              |
 | Excel 由谁写             | Agent 脚本（可选）        | Agent 脚本                     | **Agent 脚本（必需）**                        |
-| 大洲映射                 | 不涉及                    | 不涉及                         | **`references/geo-continents.json`**          |
+| 大洲映射                 | 不涉及                    | 不涉及                         | **`references/analytics/geo-continents.json`**          |
 | 重点国家 vs 非重点国切片 | 否                        | 否                             | **是**（Sheet 4 下半区，重点国可配置）        |
 
 ---

package/dist/skill/report-templates/google-period-report.md

@@ -30,7 +30,7 @@
 | ------------- | ----------------------------------------------- | ------------------------------------------------------------ |
 | 系列按小时    | `google-analysis --sections campaign-hour`      | `campaign-hour`；根为 JSON 数组，含 `date`/`hour`/消耗与效果 |
 | 受众分布      | `google-analysis --sections audience`           | 可分 `SystemDefined` / `UserDefined`                         |
-| 搜索词报告    | `google-analysis --sections search-terms`       | 高消耗搜索词与关键词匹配关系                                 |
+| 搜索词报告    | `google-analysis --sections search-terms`       | 高消耗搜索词；`queryTargetingStatusZh` 列（已添加/已排除/都没有） |
 | 广告创意表现  | `google-analysis --sections ads`                | 广告标题/类型/到达网址                                       |
 | 附加信息      | `google-analysis --sections extensions`         | 附加链接/电话/宣传信息等状态                                 |
 | 图片/视频素材 | `google-analysis --sections materials`          | 图片 + 视频合并视图                                          |
@@ -45,7 +45,7 @@
 
 ## 拉数顺序（默认 7 个维度）
 
-**首选：用 `google-analysis --sections` 一次拉齐**（单进程复用 keep-alive，比逐个 spawn 快 3-7×；详见 `references/account-analytics.md` 的 `all` 子命令说明）：
+**首选：用 `google-analysis --sections` 一次拉齐**（单进程复用 keep-alive，比逐个 spawn 快 3-7×；详见 `references/analytics/account-analytics.md` 的 `all` 子命令说明）：
 
 ```bash
 mkdir -p ./snap-google

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

@@ -6,7 +6,7 @@
 > **媒体**：当前模板仅规范 **Google**（`mediaCustomerId`）。其他媒体用各自 `*-period-report.md`。  
 > **Excel 版式基准**：与运营样表《**数据复盘分析**》类 xlsx 对齐（如 `2025.12数据复盘分析.xlsx`）；工作簿 5 个 Sheet、顺序与表头以下文规范为准。
 
-识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程；按本文**固定维度 + 固定客户话术**交付（数据全部来自 CLI 落盘 JSON，见 `references/account-analytics.md`）。
+识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程；按本文**固定维度 + 固定客户话术**交付（数据全部来自 CLI 落盘 JSON，见 `references/analytics/account-analytics.md`）。
 
 ---
 
@@ -41,15 +41,15 @@ siluzan-tso stats -m Google -a <mediaCustomerId> --start <S> --end <E> --json-ou
 siluzan-tso balance -m Google -a <mediaCustomerId> --json-out ./snap-okki
 
 siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-okki \
-  --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo
+  --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched
 ```
 
 **说明**：
 
 - `stats`：区间消耗 / 曝光 / 点击 / 转化 / CTR / CPC，与账户级周报摘要对齐；金额用 `*Display` 或文档规定的展示字段。
 - `balance`：**当前**余额（非历史快照），话术写「截至查询时点」。
-- 「设备」「国家」两 Sheet **必须**用 **`campaign-device` / `campaign-geo`**（按系列/组拆行），**不要**用账户级 `devices` / `geographic`。落盘文件名为 `campaign-device-<id>.json`、`campaign-geo-<id>.json`。跨系列汇总在脚本中做。
-- 可选：`campaign-geo` 支持 `--cost-greater` / `--click-greater` / `--conversions-greater`（见 `references/account-analytics.md`）。
+- 「设备」「国家」两 Sheet **必须**用 **`campaign-device` / `campaign-geo-matched`**（按系列/组拆行），**不要**用账户级 `devices` / `geographic`，也**不要**用 `campaign-geo`（定向地理位置，与 OKKI「地理位置报告」口径不一致）。落盘文件名为 `campaign-device-<id>.json`、`campaign-geo-matched-<id>.json`。跨系列汇总在脚本中做。
+- 可选：`campaign-geo-matched` 支持 `--cost-greater` / `--click-greater` / `--conversions-greater`（见 `references/analytics/account-analytics.md`）。
 - TopN、排序、汇总均在脚本内对 JSON 完成，禁止心算。
 - 写脚本前先读各 `<section>-<id>.outline.txt` 再读 `.json`。
 
@@ -66,7 +66,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 ### 点击率 / 转化率 / 互动率
 
-> **2026-05 起 CLI 已统一归一**（manifest `schemaVersion: 2`）：所有 `<section>-*.json` 中的 `ctr` / `conversionRate` 一律为 **0~1 小数**（如 `0.10` = 10.00%）。详见 `references/account-analytics.md`「指标字段对照」。
+> **2026-05 起 CLI 已统一归一**（manifest `schemaVersion: 2`）：所有 `<section>-*.json` 中的 `ctr` / `conversionRate` 一律为 **0~1 小数**（如 `0.10` = 10.00%）。详见 `references/analytics/account-analytics.md`「指标字段对照」。
 
 | 场景                                              | 处理                                                                       |
 | ------------------------------------------------- | -------------------------------------------------------------------------- |
@@ -83,7 +83,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 |    2 | `关键词`   | `keywords`                                                 |
 |    3 | `搜索词`   | `search-terms`                                             |
 |    4 | `设备`     | **`campaign-device-*.json`**（按系列/组拆行）              |
-|    5 | `国家`     | **`campaign-geo-*.json`**（按系列/地域拆行）               |
+|    5 | `国家`     | **`campaign-geo-matched-*.json`**（相符地理位置 Matched locations，按系列/地域拆行） |
 
 ### 各 Sheet 共同版式
 
@@ -92,7 +92,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 - **R3**：表头（列名、顺序须与下表一致）。
 - **R4 起**：数据行；列宽、自动筛选、首行冻结、降序排序为可选，**不得**因此改数。
 - **百分比列**：样表为 0~1 小数（如 7.95% 存 `0.08`）；与运营约定二选一，**禁止**同一文件混用。
-- **金额**：与 `references/account-analytics.md` 一致；`campaigns.budgetAmountYuan`、`spend`、`averageCpc`、`costPerConversion` 均为元，可直接写入。
+- **金额**：与 `references/analytics/account-analytics.md` 一致；`campaigns.budgetAmountYuan`、`spend`、`averageCpc`、`costPerConversion` 均为元，可直接写入。
 
 ---
 
@@ -122,7 +122,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
   4. **设备层级**（基于 `campaign-device`）：各设备在系列上的消耗/转化分布；可点出高消耗系列×设备组合。
      总结：
      建议：
-  5. **国家层级**（基于 `campaign-geo`）：各国家/地区在系列上的消耗/转化；高消耗低转化地域与降权/调价建议。
+  5. **国家层级**（基于 `campaign-geo-matched`）：各国家/地区在系列上的消耗/转化；高消耗低转化地域与降权/调价建议。
      总结：
      建议：
 
@@ -148,7 +148,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1               | `搜索字词报告`                                                                                                                                                                                        |
 | R2               | 统计区间                                                                                                                                                                                              |
 | R3（A→N，14 列） | `搜索字词` \| `匹配类型` \| `已添加/已排除` \| `广告系列` \| `广告组` \| `关键字` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
-| R4…              | `search-terms-*.json`：`已添加/已排除` 若 JSON 无此枚举则留空或填「—」，禁止臆造；`ctr` / `conversionRate` 已归一，直接写入                                                                           |
+| R4…              | `search-terms-*.json`：`queryTargetingStatusZh`（`Added`→已添加、`Excluded`→已排除、`None`→都没有）；无该字段时读 `queryTargetingStatus` 按上表映射，仍无则「—」；`ctr` / `conversionRate` 已归一，直接写入 |
 
 ---
 
@@ -170,7 +170,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1               | `地理位置报告`                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | R2               | 统计区间                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | R3（A→M，13 列） | `地理位置` \| `广告系列` \| `展示次数` \| `互动次数` \| `互动率` \| `费用` \| `平均费用` \| `点击次数` \| `点击率` \| `所有转化次数` \| `转化次数` \| `每次转化费用` \| `转化率`                                                                                                                                                                                                                                                                            |
-| R4…              | `campaign-geo-*.json`（`countries[]`）：`countryOrRegion`→地理位置；`campaignName`→「广告系列」；`allConversions`→「所有转化次数」；`conversions`→「转化次数」；**互动次数**→`interactions`；**互动率**→`interactionRate`（字符串须解析）或 `interactions/impressions`，`interactions` 为 0 时填 `—`；**平均费用 必须** = `spend / interactions`，`interactions` 为 0 / null / undefined 时填 `—`；`ctr` / `conversionRate` 直接写入；其余列按 outline 映射 |
+| R4…              | `campaign-geo-matched-*.json`（`countries[]`）：`countryOrRegion`→地理位置；`campaignName`→「广告系列」；`allConversions`→「所有转化次数」；`conversions`→「转化次数」；**互动次数**→`interactions`；**互动率**→`interactionRate`（字符串须解析）或 `interactions/impressions`，`interactions` 为 0 时填 `—`；**平均费用 必须** = `spend / interactions`，`interactions` 为 0 / null / undefined 时填 `—`；`ctr` / `conversionRate` 直接写入；其余列按 outline 映射 |
 
 ---
 
@@ -201,7 +201,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 ## 复盘小结 + 优化建议（对内 / 邮件末段）
 
-基于同一批 JSON（`campaigns`、`keywords`、`search-terms`、`campaign-device`、`campaign-geo`、`overview`）：
+基于同一批 JSON（`campaigns`、`keywords`、`search-terms`、`campaign-device`、`campaign-geo-matched`、`overview`）：
 
 - **复盘**：3~6 条 bullet：消耗集中度、高消耗系列/词、地域与设备差异、CTR/CPC 相对水平。
 - **优化建议**：3~5 条可执行项（预算、否词、落地页、系列状态等），**不额外拉数**；缺数据则标 `[数据不可用：原因]`。
@@ -212,6 +212,6 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 | 项       | `google-period-report.md` | 本文 OKKI 周报                                                                                         |
 | -------- | ------------------------- | ------------------------------------------------------------------------------------------------------ |
-| 默认维度 | 8 维 + 主动追问追加       | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo` + `stats` + `balance` |
+| 默认维度 | 8 维 + 主动追问追加       | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched` + `stats` + `balance` |
 | 输出形态 | 长文分析报告              | **固定话术** + 短复盘 + **多 Sheet Excel（Agent 脚本写）**                                             |
 | 典型用户 | 内部分析                  | **发客户**的同步简报                                                                                   |

package/dist/skill/scripts/install.ps1

@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.21'
+$PKG_VERSION = '1.1.22-beta.10'
 $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

@@ -9,11 +9,11 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.21"
+readonly PKG_VERSION="1.1.22-beta.10"
 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/eval/cases/accounts-entityid-vs-mediaccustomerid.scenario.json

@@ -4,10 +4,10 @@
   "turns": [
     "丝路赞后台复制了一个 Google 账户的 entityId：f2a5ca16-cff9-4a9e-9aea-f7429c3e2696。\n我要查它在 2026-04-01 至 2026-04-15 的 stats，请用 siluzan-tso，需要 JSON。不要编造 mediaCustomerId。"
   ],
-  "judgeExpectation": "路径：用户只提供 entityId 时，应先 list-accounts（可加 --json）核对 mediaCustomerId，再对 stats 等传媒体账户 ID；不得把 entityId 当作 mediaCustomerId 直接传给 stats。\n输出：说明映射关系；stub 数据即可。",
-  "skillMapping": "SKILL.md「不要猜测账户 ID」；references/accounts.md",
+  "judgeExpectation": "路径：用户只提供 entityId 时，应先 list-accounts（可加 --json-out）核对 mediaCustomerId，再对 stats 等传媒体账户 ID；不得把 entityId 当作 mediaCustomerId 直接传给 stats。\n输出：说明映射关系；stub 数据即可。",
+  "skillMapping": "SKILL.md「不要猜测账户 ID」；references/accounts/accounts.md",
   "judgeReferencePaths": [
-    "references/accounts.md"
+    "references/accounts/accounts.md"
   ],
   "commandMustInclude": [
     [
@@ -17,7 +17,7 @@
       "stats"
     ],
     [
-      "--json"
+      "--json-out"
     ]
   ]
 }

package/eval/cases/accounts-mcc-bind-inquiry.scenario.json

@@ -4,9 +4,9 @@
   "turns": [
     "我们想把丝路赞里的 Google 户挂到公司 MCC 上，该怎么操作？有哪些命令？先说明白再执行，别直接改账户。"
   ],
-  "judgeExpectation": "路径：用户问如何把账户绑到 MCC/经理账户时，应先 read_skill_reference 查阅 accounts.md 中相关命令与注意点，再给出步骤；**未获确认前不应执行解绑/破坏性 CLI**。\n输出：步骤与风险提示；不要求真实绑定。",
-  "skillMapping": "references/accounts.md · MCC/Google 绑定类",
+  "judgeExpectation": "路径：用户问如何把账户绑到 MCC/经理账户时，应先 read_skill_reference 查阅 accounts/accounts.md 中相关命令与注意点，再给出步骤；**未获确认前不应执行解绑/破坏性 CLI**。\n输出：步骤与风险提示；不要求真实绑定。",
+  "skillMapping": "references/accounts/accounts.md · MCC/Google 绑定类",
   "judgeReferencePaths": [
-    "references/accounts.md"
+    "references/accounts/accounts.md"
   ]
 }