siluzan-tso-cli 1.1.39 → 1.1.40-beta.2

package/dist/skill/references/misc/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`
 
 ---
 
@@ -25,7 +25,7 @@ siluzan-tso config show   # 取 webUrl
 
 ## 推荐话术
 
-1. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/v3/foreign_trade/tso/home`。
+1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
 2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
 3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。
 

package/dist/skill/references/operations/forewarning.md

@@ -7,6 +7,8 @@
 智能预警允许设置监控规则，当广告账户的消耗、余额、CTR 等指标满足指定条件时，自动通过**微信公众号**发送通知。
 这是siluzan 提供的全链路服务，除非用户提到需要使用这个否则默认不推荐使用这个智能预警
 
+> **Siluzan Agent（`IS_SILUZAN_AGENT_ENV=true`）**：全部 `forewarning` 子命令**不执行**（不打 API）。请改为**创建自动化任务**，在任务中调用 siluzan-tso 本 Skill（拉数 / `guard` / 写命令等）完成预警与巡检。必读 `references/operations/hosted-automation-user-catalog.md`。
+
 ---
 
 ## 通知机制

package/dist/skill/references/operations/guard.md

@@ -0,0 +1,94 @@
+# guard —— Google 全户熔断扫描
+
+> 流程见 `hosted-automation-user-catalog.md`（预算/空耗自控）。单户排障仍可用 `ad campaigns` / `ad groups`。
+> **仅 Google**。非 Google 媒体本 CLI 无系列/组/创意暂停写能力。
+
+## Contents
+
+- 何时用
+- budget-circuit（超预算）
+- zero-conv（空耗）
+- 输出与交付
+- 与旧编排对照
+
+---
+
+## 何时用
+
+| 用户话术 | 命令 |
+| -------- | ---- |
+| 所有账户系列当日花费 ≥ 日预算 110% → 暂停 | `guard budget-circuit` |
+| 空耗熔断：花 ≥ 目标 CPA × N 且转化 0 → 暂停组/创意 | `guard zero-conv` |
+| 只查某一户 / 改预算后复核单系列 | 仍用 `ad campaigns -a … --start=--end` |
+
+**禁止**外层 for-loop：`list-accounts` × 多媒体再逐户 `ad campaigns` 做全户熔断。
+
+---
+
+## budget-circuit（超预算）
+
+```bash
+siluzan-tso guard budget-circuit -m Google \
+  [--date YYYY-MM-DD] [--ratio 1.1] [-a id1,id2] \
+  --json-out ./snap-guard
+
+# 确认命中后暂停（须全局 --commit）
+siluzan-tso guard budget-circuit -m Google --date 2026-07-28 --ratio 1.1 \
+  --apply --json-out ./snap-guard --commit "budget-circuit 2026-07-28"
+```
+
+| 选项 | 说明 |
+| ---- | ---- |
+| `-m Google` | 必填；其它媒体 exit 1 |
+| `-a` | 子集 mediaCustomerId；省略则扫名下全部 Google 户 |
+| `--date` | 统计日；默认 Asia/Shanghai 今天；**强制当日 spend**（start=end） |
+| `--ratio` | 默认 `1.1`（建议 1.10–1.20） |
+| `--status` | 默认只查 `Enabled`；传 `*` 不过滤 |
+| `--apply` | 默认 dry-run；加此旗才 `Paused` |
+| `--json-out` | Agent 必带 |
+
+命中条件：`budget > 0` 且 `spend >= budget * ratio`（`budget`/`spend` 均为元；`spend` 为该日合计）。
+
+---
+
+## zero-conv（空耗）
+
+```bash
+siluzan-tso guard zero-conv -m Google \
+  [--date YYYY-MM-DD] [--cpa-multiple 3] [--level adgroup|ad|both] \
+  [--fallback-target-cpa <元>] \
+  --json-out ./snap-guard
+
+siluzan-tso guard zero-conv -m Google --cpa-multiple 3 --apply \
+  --json-out ./snap-guard --commit "zero-conv 空耗熔断"
+```
+
+| 选项 | 说明 |
+| ---- | ---- |
+| `--cpa-multiple` | 默认 `3` |
+| `--level` | 默认 `adgroup`；`ad`/`both` 需 `--fallback-target-cpa`（创意无组级 CPA 字段） |
+| `--fallback-target-cpa` | 组无 `targetCpaAmountYuan` 时回退；缺失则进 `skipped[]` |
+| `--apply` / `--json-out` | 同 budget-circuit |
+
+命中：`conversions === 0` 且 `spend >= targetCpaYuan * N`。`summary.label` 固定为 **「空耗熔断」**（宿主发 P1 时用此文案；CLI 不代发通知）。
+
+---
+
+## 输出与交付
+
+- 落盘 section：`guard-budget-circuit` / `guard-zero-conv`
+- 字段：`meta`、`summary`、`hits[]`、`paused[]`、`errors[]`（zero-conv 另有 `skipped[]`）
+- stdout：一行摘要 JSON（若 `--json-out`）+ **人类可读命中表**（无命中也打印「无命中」——巡检必须收口）
+- dry-run 命中后提示追加 `--apply --commit …`
+
+恢复：人工加预算 / 改出价后，用 `ad campaign-status|adgroup-status|ad-status … --status Enabled`（或网页），**禁止**无人值守自动恢复。
+
+---
+
+## 与旧编排对照
+
+| 旧（易失败） | 新 |
+| ------------ | -- |
+| 6 媒体 list-accounts → 逐户 ad campaigns → 脚本比 budget | `guard budget-circuit -m Google` |
+| 逐户 ad groups + 手写阈值 | `guard zero-conv -m Google` |
+| `ad campaigns -m Google`（非法） | 单户用 `-a`；全户熔断用 `guard` |

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

@@ -56,7 +56,19 @@
 
 **业务目标**：当**当日**系列花费相对**日预算**达到设定比例（如 **≥ 110%**，建议 **110%–120%** 缓冲 API 延迟）时，**将系列状态置为 Paused**；恢复由人工加预算后在网页或 CLI 再启用。
 
-### 检查项（宿主每轮执行）
+### 首选（全户 / 多户 Google）
+
+一条命令扫描名下 Google 户并交付命中表（默认 dry-run）：
+
+```bash
+siluzan-tso guard budget-circuit -m Google --date <当日YYYY-MM-DD> --ratio 1.1 --json-out ./snap-guard
+# 确认后：
+siluzan-tso guard budget-circuit -m Google --date <当日> --ratio 1.1 --apply --json-out ./snap-guard --commit "budget-circuit"
+```
+
+参数与落盘字段见 **`references/operations/guard.md`**。**禁止** `list-accounts` 六媒体循环 + 逐户 `ad campaigns`。
+
+### 单户排障（可选细粒度）
 
 1. 解析 `mediaCustomerId`（见上文前置）。
 2. 拉系列列表（**必须** `--start` = `--end` = **当日**统计日；**禁止**用默认近 7 天窗口做本场景）：
@@ -71,7 +83,7 @@ siluzan-tso ad campaigns -a <mediaCustomerId> --start <当日YYYY-MM-DD> --end <
    - **IF** `spend >= threshold` **且**宿主策略允许对该系列熔断（如排除白名单），则进入写操作。
    - **禁止**：`--start`≠`--end` 时仍用 `spend` 对比 `budget`（会把多日合计误判成单日超预算）。
 
-### 最终操作
+### 最终操作（单户手写时）
 
 ```bash
 siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status Paused
@@ -93,9 +105,10 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status E
 
 ### CLI 能力摘要
 
-| 状态 | 说明                                                                                                          |
-| ---- | ------------------------------------------------------------------------------------------------------------- |
-| 有   | 读：`ad campaigns --json-out ./snap`；写：`ad campaign-status`；复核：再次 `ad campaigns --json-out ./snap`。 |
+| 状态 | 说明 |
+| ---- | ---- |
+| 首选 | `guard budget-circuit -m Google`（全户扫描 + 可选 `--apply`） |
+| 单户 | 读：`ad campaigns --json-out`；写：`ad campaign-status`；复核：再次 `ad campaigns` |
 
 ---
 
@@ -164,7 +177,16 @@ siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主
 
 **业务目标**：**今日**（或约定日）累计 **`cost`（费用）≥ 目标 CPA × N`** 且 **`conversions = 0`** 时，**暂停**广告组或广告；**P1 告警 + 文案「空耗熔断」** 由宿主通知 skill 发送（本 CLI 不发送 P1）。
 
-### 检查项（宿主每轮执行）
+### 首选（全户 / 多户 Google）
+
+```bash
+siluzan-tso guard zero-conv -m Google --date <当日> --cpa-multiple 3 --level adgroup --json-out ./snap-guard
+# 确认后 --apply --commit …；创意维加 --level ad|both --fallback-target-cpa <元>
+```
+
+见 **`references/operations/guard.md`**。`summary.label` =「空耗熔断」。
+
+### 单户排障（可选）
 
 1. 确定「今日」`--start` / `--end`（同场景 1 时区约定）。
 2. **广告组**：
@@ -173,9 +195,9 @@ siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主
 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** 为配置）。
+对 `items[]`：读取 **`spend`**（费用）、**`conversions`**；目标 CPA 来自 **`targetCpaAmountYuan`**（元）或宿主配置；计算 `limit = target_cpa * N`。
 
-- **IF** `conversions === 0` **且** `spend >= limit`（注意 **`spend` 与 limit 单位一致**），则对该 `id` 执行组暂停。
+- **IF** `conversions === 0` **且** `spend >= limit`，则对该 `id` 执行组暂停。
 
 3. **广告（创意）**级：若策略在创意维熔断：
 
@@ -185,7 +207,7 @@ siluzan-tso ad list -a <mediaCustomerId> --start <当日> --end <当日> --json-
 
 同样判断费用与转化；命中则 **`ad ad-status`**。
 
-### 最终操作
+### 最终操作（单户手写时）
 
 ```bash
 siluzan-tso ad adgroup-status -a <mediaCustomerId> --id <adGroupId> --status Paused
@@ -193,8 +215,6 @@ 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` 见 `references/google-ads/google-ads.md`。）
-
 ### 通知（宿主）
 
 调用组织规定的 **P1** 通道（钉钉/飞书/Slack 等），标题或正文须含 **「空耗熔断」** 及 `mediaCustomerId`、对象类型、对象 `id`、当次 `spend` / 阈值。
@@ -203,16 +223,16 @@ siluzan-tso ad ad-status -a <mediaCustomerId> --id <adId> --status Paused
 
 ```bash
 siluzan-tso ad groups -a <mediaCustomerId> --start <当日> --end <当日> --json-out ./snap
-# 或 ad list …
 ```
 
 确认对应 **`statusV2`** 为 **`Paused`**。
 
 ### CLI 能力摘要
 
-| 状态 | 说明                                                                                           |
-| ---- | ---------------------------------------------------------------------------------------------- |
-| 有   | 读：`ad groups` / `ad list`；写：`adgroup-status` / `ad-status`；通知：宿主；复核：再次 list。 |
+| 状态 | 说明 |
+| ---- | ---- |
+| 首选 | `guard zero-conv -m Google` |
+| 单户 | 读：`ad groups` / `ad list`；写：`adgroup-status` / `ad-status`；通知：宿主 |
 
 ---
 

package/dist/skill/references/operations/hosted-automation-user-catalog.md

@@ -14,13 +14,13 @@
 
 ## 预算与 ROI 自控
 
-| 场景 | 自动动作（摘要） | SOP（只读这一份） |
-| ---- | ---------------- | ----------------- |
-| 单日预算熔断 | 当日花费相对日预算达阈值 → 暂停系列 | `references/operations/hosted-automation-self-control.md` |
+| 场景 | 自动动作（摘要） | 首选 CLI / SOP（只读一份） |
+| ---- | ---------------- | -------------------------- |
+| 单日预算熔断 | 当日花费相对日预算达阈值 → 暂停系列 | **首选** `references/operations/guard.md`（`guard budget-circuit`）；细节/单户排障见 `hosted-automation-self-control.md` |
 | CPA 飙升自动降价 | 窗内 CPA 超目标 → 下调出价上限 | `references/operations/hosted-automation-optimize-weak-downbid.md` |
-| 连续空耗自动暂停 | 当日花费达阈值且 0 转化 → 暂停组/创意；宿主发 **告警P1**「空耗熔断」 | `references/operations/hosted-automation-self-control.md` |
+| 连续空耗自动暂停 | 当日花费达阈值且 0 转化 → 暂停组/创意；宿主发 **告警P1**「空耗熔断」 | **首选** `references/operations/guard.md`（`guard zero-conv`）；细节见 `hosted-automation-self-control.md` |
 
-> **消耗 ≠ 日消耗**：`spend` 为 `--start`～`--end` 合计。单日熔断须 `start=end=当日`；续航日均用 `balance-scan.dailySpend`。
+> **消耗 ≠ 日消耗**：`spend` 为 `--start`～`--end` 合计。`guard` 命令已强制 `--date` 单日；手写 `ad campaigns` 时须 `start=end=当日`。续航日均用 `balance-scan.dailySpend`。
 
 ## 异常监控
 

package/dist/skill/references/report-templates/bing-period-report.md

@@ -67,10 +67,10 @@ siluzan-tso bing-analysis render \
 
 `render` 传 `--snapshot-dir` 时，CLI 自动补全：
 
-1. `meta` / `kpis`（含余额、日均、环比；本期 KPI 优先 campaigns 累加）
-2. `tables.*`（按上表落盘形状映射；Agent 已填字段不覆盖）
+1. `meta`（仅补空字段）
+2. **`kpis` / `tables.*` 一律以 CLI 快照覆盖**（有对应 section 时；本期 KPI 优先 campaigns 累加）——数值口径不以 Agent 预填为准
 
-Agent 只需撰写 `narrative`；**禁止手写 HTML**。`ctr` / `conversionRate` 落盘已为 0~1 小数。
+Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kpis`/`tables` 数值（尤其 `ctr` 须为 CLI 落盘的 0~1 小数）。
 
 ---
 

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

@@ -53,7 +53,7 @@ siluzan-tso google-analysis render \
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
 `render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格（Agent JSON 中已有字段不覆盖）。本期 KPI 优先 `campaigns` 累加，勿用延迟的 `stats`/overview 手工填账户级消耗。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加；Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---
 

package/dist/skill/references/report-templates/meta-account-diagnosis-report.md

@@ -24,7 +24,7 @@ siluzan-tso facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb
 | **3. 写 JSON**   | Agent        | 撰写 `meta-account-diagnosis-report.json`：仅 `meta.accountId` + `narrative` 为必填；`kpis`/`tables` 可省略，由 `--snapshot-dir` 自动合并                                        |
 | **4. 渲染 HTML** | CLI          | `facebook-analysis diagnosis-render` — **校验 narrative 11 个分析小节必含字段**（4 个媒体未覆盖小节可标 `notAvailable`），缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML |
 
-> `--snapshot-dir` 自动补全 `meta` / `kpis`（仅 overview；**禁止**用 ad-sets/creative 行 results 加总对比 overview）与 `tables.*`（按 `facebook-analysis-guide.md`：`adGroups`/`networks`/`countries`/`audiences`/`creatives`/`materials`）。Agent 已填字段不覆盖。
+> `--snapshot-dir` 自动补全 `meta` / `kpis`（仅 overview；**禁止**用 ad-sets/creative 行 results 加总对比 overview）与 `tables.*`（按 `facebook-analysis-guide.md`：`adGroups`/`networks`/`countries`/`audiences`/`creatives`/`materials`）。**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。
 
 ### JSON 契约（`meta-account-diagnosis-report.json`）
 

package/dist/skill/references/report-templates/meta-period-report.md

@@ -34,7 +34,7 @@ siluzan-tso facebook-analysis render \
   --out ./meta-period-report.html
 ```
 
-`--snapshot-dir` 与步骤 1 的 `--json-out` 同目录；CLI 自动合并 KPI、平台/国家/受众图表与表格（Agent JSON 已有字段不覆盖）。
+`--snapshot-dir` 与步骤 1 的 `--json-out` 同目录；CLI 自动合并 KPI、平台/国家/受众图表与表格（**数值一律以 CLI 快照覆盖**；`meta` 仅补空）。
 
 ---
 
@@ -66,7 +66,7 @@ siluzan-tso facebook-analysis render \
 - `report-templates/meta-period-report.runtime.js` — 可选外链运行时（逻辑已内联于 HTML；ECharts 渲染 + 章节 DOM 拼装）
 
 `render` 会向输出目录写入 HTML + `meta-period-report.runtime.js`，并注入 `window.__META_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、平台/国家/受众图表数据、广告组与受众表格（Agent JSON 中已有字段不覆盖）。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、平台/国家/受众图表数据、广告组与受众表格（**数值以 CLI 为准**，覆盖 Agent 预填）。
 
 ---
 

package/dist/skill/references/report-templates/tiktok-period-report.md

@@ -18,7 +18,7 @@
 | **3. 写 JSON**   | Agent        | 撰写 `tiktok-period-report.json`：仅 `meta.accountId` + `narrative` 为必填；`kpis`/`tables` 可省略，由 `--snapshot-dir` 按网关类型自动合并                                         |
 | **4. 渲染 HTML** | CLI          | `tiktok-analysis render` — **校验 narrative 6 个分析小节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                           |
 
-> `--snapshot-dir` 自动补全 `meta` / `kpis` / `tables.*`。网关形状见 `src/types/tiktok-analysis-api.ts`（对齐前端 `periodReport/tiktok.js`）：`campaigns` 为 `{ campaigns:[] }`；ad-groups/videos/audience 为 `{ data.list[].metrics }`（snake_case）；ads 为根数组。**本期 KPI 优先 campaigns 累加**。Agent 已填字段不覆盖。
+> `--snapshot-dir` 自动补全 `meta` / `kpis` / `tables.*`。网关形状见 `src/types/tiktok-analysis-api.ts`（对齐前端 `periodReport/tiktok.js`）：`campaigns` 为 `{ campaigns:[] }`；ad-groups/videos/audience 为 `{ data.list[].metrics }`（snake_case）；ads 为根数组。**本期 KPI 优先 campaigns 累加**。**数值一律以 CLI 快照覆盖**（`meta` 仅补空）；Agent 只写 `narrative`。
 
 ### JSON 契约（`tiktok-period-report.json`）
 

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

@@ -67,10 +67,10 @@ siluzan-tso bing-analysis render \
 
 `render` 传 `--snapshot-dir` 时，CLI 自动补全：
 
-1. `meta` / `kpis`（含余额、日均、环比；本期 KPI 优先 campaigns 累加）
-2. `tables.*`（按上表落盘形状映射；Agent 已填字段不覆盖）
+1. `meta`（仅补空字段）
+2. **`kpis` / `tables.*` 一律以 CLI 快照覆盖**（有对应 section 时；本期 KPI 优先 campaigns 累加）——数值口径不以 Agent 预填为准
 
-Agent 只需撰写 `narrative`；**禁止手写 HTML**。`ctr` / `conversionRate` 落盘已为 0~1 小数。
+Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kpis`/`tables` 数值（尤其 `ctr` 须为 CLI 落盘的 0~1 小数）。
 
 ---
 

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

@@ -53,7 +53,7 @@ siluzan-tso google-analysis render \
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
 `render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格（Agent JSON 中已有字段不覆盖）。本期 KPI 优先 `campaigns` 累加，勿用延迟的 `stats`/overview 手工填账户级消耗。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加；Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---
 

package/dist/skill/report-templates/meta-account-diagnosis-report.md

@@ -24,7 +24,7 @@ siluzan-tso facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb
 | **3. 写 JSON**   | Agent        | 撰写 `meta-account-diagnosis-report.json`：仅 `meta.accountId` + `narrative` 为必填；`kpis`/`tables` 可省略，由 `--snapshot-dir` 自动合并                                        |
 | **4. 渲染 HTML** | CLI          | `facebook-analysis diagnosis-render` — **校验 narrative 11 个分析小节必含字段**（4 个媒体未覆盖小节可标 `notAvailable`），缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML |
 
-> `--snapshot-dir` 自动补全 `meta` / `kpis`（仅 overview；**禁止**用 ad-sets/creative 行 results 加总对比 overview）与 `tables.*`（按 `facebook-analysis-guide.md`：`adGroups`/`networks`/`countries`/`audiences`/`creatives`/`materials`）。Agent 已填字段不覆盖。
+> `--snapshot-dir` 自动补全 `meta` / `kpis`（仅 overview；**禁止**用 ad-sets/creative 行 results 加总对比 overview）与 `tables.*`（按 `facebook-analysis-guide.md`：`adGroups`/`networks`/`countries`/`audiences`/`creatives`/`materials`）。**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。
 
 ### JSON 契约（`meta-account-diagnosis-report.json`）
 

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

@@ -34,7 +34,7 @@ siluzan-tso facebook-analysis render \
   --out ./meta-period-report.html
 ```
 
-`--snapshot-dir` 与步骤 1 的 `--json-out` 同目录；CLI 自动合并 KPI、平台/国家/受众图表与表格（Agent JSON 已有字段不覆盖）。
+`--snapshot-dir` 与步骤 1 的 `--json-out` 同目录；CLI 自动合并 KPI、平台/国家/受众图表与表格（**数值一律以 CLI 快照覆盖**；`meta` 仅补空）。
 
 ---
 
@@ -66,7 +66,7 @@ siluzan-tso facebook-analysis render \
 - `report-templates/meta-period-report.runtime.js` — 可选外链运行时（逻辑已内联于 HTML；ECharts 渲染 + 章节 DOM 拼装）
 
 `render` 会向输出目录写入 HTML + `meta-period-report.runtime.js`，并注入 `window.__META_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、平台/国家/受众图表数据、广告组与受众表格（Agent JSON 中已有字段不覆盖）。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、平台/国家/受众图表数据、广告组与受众表格（**数值以 CLI 为准**，覆盖 Agent 预填）。
 
 ---
 

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

@@ -18,7 +18,7 @@
 | **3. 写 JSON**   | Agent        | 撰写 `tiktok-period-report.json`：仅 `meta.accountId` + `narrative` 为必填；`kpis`/`tables` 可省略，由 `--snapshot-dir` 按网关类型自动合并                                         |
 | **4. 渲染 HTML** | CLI          | `tiktok-analysis render` — **校验 narrative 6 个分析小节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                           |
 
-> `--snapshot-dir` 自动补全 `meta` / `kpis` / `tables.*`。网关形状见 `src/types/tiktok-analysis-api.ts`（对齐前端 `periodReport/tiktok.js`）：`campaigns` 为 `{ campaigns:[] }`；ad-groups/videos/audience 为 `{ data.list[].metrics }`（snake_case）；ads 为根数组。**本期 KPI 优先 campaigns 累加**。Agent 已填字段不覆盖。
+> `--snapshot-dir` 自动补全 `meta` / `kpis` / `tables.*`。网关形状见 `src/types/tiktok-analysis-api.ts`（对齐前端 `periodReport/tiktok.js`）：`campaigns` 为 `{ campaigns:[] }`；ad-groups/videos/audience 为 `{ data.list[].metrics }`（snake_case）；ads 为根数组。**本期 KPI 优先 campaigns 累加**。**数值一律以 CLI 快照覆盖**（`meta` 仅补空）；Agent 只写 `narrative`。
 
 ### JSON 契约（`tiktok-period-report.json`）
 

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.39'
+$PKG_VERSION = '1.1.40-beta.2'
 $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.39"
+readonly PKG_VERSION="1.1.40-beta.2"
 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/guard-budget-circuit-all-google.scenario.json

@@ -0,0 +1,25 @@
+{
+  "id": "guard-budget-circuit-all-google",
+  "description": "全户 Google 超预算熔断 — 必须用 guard budget-circuit，禁止逐户 ad campaigns for-loop",
+  "turns": [
+    "检查我名下的所有广告账户下所有广告系列的当日花费。如果某个系列的当日花费达到其日预算的 110% 以上，先列出被命中的系列名称、当日花费和日预算（先不要暂停）。用 siluzan-tso，JSON 落盘。这是定时任务，直接执行。"
+  ],
+  "judgeExpectation": "路径：用户要求检查名下所有账户系列当日花费相对日预算达 110% 并列出/暂停时，应执行 `siluzan-tso guard budget-circuit -m Google`（可带 --date/--ratio/--json-out），**不要**对六媒体 list-accounts 后再逐户 `ad campaigns`。\n默认 dry-run 即可交付命中表；未获确认前可不加 --apply。输出须收口（命中列表或明确无命中）。",
+  "skillMapping": "references/operations/guard.md · budget-circuit",
+  "judgeReferencePaths": [
+    "references/operations/guard.md",
+    "references/operations/hosted-automation-user-catalog.md"
+  ],
+  "commandMustInclude": [
+    [
+      "guard",
+      "budget-circuit"
+    ],
+    [
+      "--json-out"
+    ]
+  ],
+  "commandMustNotInclude": [
+    "ad campaigns -m"
+  ]
+}

package/eval/cases/guard-zero-conv-empty-spend.scenario.json

@@ -0,0 +1,21 @@
+{
+  "id": "guard-zero-conv-empty-spend",
+  "description": "空耗熔断扫描 — 必须用 guard zero-conv",
+  "turns": [
+    "检查我名下的所有广告账户的当日数据。对于当日累计花费已达到目标 CPA 3 倍以上、但转化数为 0 的广告组，先列出（标注「空耗熔断」），先不要暂停。用 siluzan-tso，JSON 落盘，直接执行。"
+  ],
+  "judgeExpectation": "路径：用户要求空耗熔断（当日花费 ≥ 目标 CPA × 3 且转化 0）时，应执行 `siluzan-tso guard zero-conv -m Google`（--cpa-multiple 3、--json-out），结果摘要应体现「空耗熔断」。\n默认 dry-run；未确认前可不 --apply。禁止逐户 for-loop `ad groups`。",
+  "skillMapping": "references/operations/guard.md · zero-conv",
+  "judgeReferencePaths": [
+    "references/operations/guard.md"
+  ],
+  "commandMustInclude": [
+    [
+      "guard",
+      "zero-conv"
+    ],
+    [
+      "--json-out"
+    ]
+  ]
+}

package/eval/cases/ir-p8-meets-google-ads-requirements-with-url.scenario.json

@@ -0,0 +1,39 @@
+{
+  "id": "ir-p8-meets-google-ads-requirements-with-url",
+  "description": "是否符合 Google 广告投放要求 + URL — 须 P8 website-diagnosis，禁止 W3/WebFetch 当终稿",
+  "turns": [
+    "请诊断网站 https://www.siluzan.com 是否符合 Google 广告投放要求"
+  ],
+  "judgeExpectation": "路径：「诊断网站 / 是否符合 Google 广告投放要求」+ URL → 必须 P8；须执行 `website-diagnosis collect --url` 且带 --json-out。\n禁止：因带「Google 广告」改走 W3 campaign-validate/create；禁止只用 WebFetch/浏览器看页写结论代替 CLI。\n输出：说明 collect → prepare → render HTML。",
+  "skillMapping": "references/core/intent-routing.md · §零 · P8",
+  "judgeReferencePaths": [
+    "references/core/intent-routing.md",
+    "references/core/playbooks.md",
+    "analytics/website-diagnosis-guide.md"
+  ],
+  "commandMustInclude": [
+    [
+      "website-diagnosis"
+    ],
+    [
+      "collect"
+    ],
+    [
+      "--url"
+    ],
+    [
+      "--json-out"
+    ]
+  ],
+  "commandMustNotInclude": [
+    [
+      "campaign-validate"
+    ],
+    [
+      "campaign-create"
+    ],
+    [
+      "market-analysis"
+    ]
+  ]
+}

package/eval/stub-fixtures/guard-budget-circuit.json

@@ -0,0 +1,36 @@
+{
+  "kind": "siluzan-tso-snapshot-summary",
+  "section": "guard-budget-circuit",
+  "commandLabel": "guard budget-circuit",
+  "ok": true,
+  "meta": {
+    "media": "Google",
+    "date": "2026-07-28",
+    "ratio": 1.1,
+    "apply": false,
+    "stub": true
+  },
+  "summary": {
+    "label": "超预算熔断",
+    "accountCount": 1,
+    "checkedCampaigns": 2,
+    "hitCount": 1,
+    "pausedCount": 0,
+    "errorCount": 0,
+    "mode": "dry-run"
+  },
+  "hits": [
+    {
+      "mediaCustomerId": "4256317784",
+      "campaignId": "111",
+      "campaignName": "stub-over-budget",
+      "spend": 120,
+      "budget": 100,
+      "ratio": 1.1,
+      "threshold": 110,
+      "applied": false
+    }
+  ],
+  "paused": [],
+  "errors": []
+}

package/eval/stub-fixtures/guard-zero-conv.json

@@ -0,0 +1,41 @@
+{
+  "kind": "siluzan-tso-snapshot-summary",
+  "section": "guard-zero-conv",
+  "commandLabel": "guard zero-conv",
+  "ok": true,
+  "meta": {
+    "media": "Google",
+    "date": "2026-07-28",
+    "cpaMultiple": 3,
+    "level": "adgroup",
+    "apply": false,
+    "stub": true
+  },
+  "summary": {
+    "label": "空耗熔断",
+    "accountCount": 1,
+    "checkedObjects": 2,
+    "hitCount": 1,
+    "pausedCount": 0,
+    "skippedCount": 0,
+    "errorCount": 0,
+    "mode": "dry-run"
+  },
+  "hits": [
+    {
+      "mediaCustomerId": "4256317784",
+      "level": "adgroup",
+      "objectId": "222",
+      "objectName": "stub-zero-conv-group",
+      "spend": 300,
+      "conversions": 0,
+      "targetCpaYuan": 100,
+      "multiple": 3,
+      "threshold": 300,
+      "applied": false
+    }
+  ],
+  "paused": [],
+  "skipped": [],
+  "errors": []
+}

package/package.json

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