siluzan-tso-cli 1.0.0-beta.10

package/assets/siluzan-ads/references/open-account-by-media.md

@@ -0,0 +1,61 @@
+# 各媒体开户：接口与参数技术细节
+
+> 业务流程（步骤、所需资料、审核处理）见 `references/workflows.md` 流程一。  
+> 本文件仅记录各媒体的底层接口路径与请求体结构，供排查问题或深度定制时参考。
+
+---
+
+## 路由对照
+
+| 媒体 | 前端路由（path） | 说明 |
+|------|------------------|------|
+| **Google** | `/openAnAccount?mediaType=Google` | 与 TikTok 共用 `openAnAccount.vue`；从开户记录进入 Google 时往往先弹 **GGwarn** 合规提示再进表单 |
+| **TikTok** | `/openAnAccount?mediaType=TikTok` | 同上组件，`mediaType` 区分字段与提交流程 |
+| **Yandex** | `/YandexOpenAnAccount` | 独立页面 `YandexOpenAnAccount_v2.vue` |
+| **BingV2** | `/bingOpenAnAccount` | 独立页面 `bingOpenAnAccount.vue` |
+| **Kwai** | `/KwaiOpenAnAccount` | 独立页面 `KwaiOpenAnAccount.vue` |
+
+---
+
+## 广告主组（magKey）接口
+
+所有媒体在提交开户前都需要一个广告主组，并取得 `magKey`（MediaAccountGroupId）：
+
+- **查询列表**：`GET {apiBaseUrl}/query/profile/steward-individual` → `profile.mediaAccountGroups[]`，项上 `key` 即 magKey
+- **创建**：`PUT {apiBaseUrl}/command/profile/steward-individual`，Header `s-command-type: AddMediaAccountGroup`
+- **更新**：`PUT {apiBaseUrl}/command/profile/steward-individual/{id}`，Header `s-command-type: UpdateMediaAccountGroup`
+
+**Google 例外**：CLI 按 `--company` 自动创建或更新广告主组，无需手动查询。
+
+---
+
+## 各媒体提交接口
+
+| CLI 子命令 | 提交接口 | Method | 关键 Header / 特点 |
+|------------|----------|--------|--------------------|
+| `open-account google` | `/command/media-account/google` | POST | `s-command-type: AddExistingMediaAccountList`；前置自动创建广告主组 |
+| `open-account tiktok` | `/command/media-account`（不是 `/google`） | POST | 同上；前置 `POST .../tiktok/Upload` 上传执照图片；可选 `POST .../command/attachment` 存档、`GET .../CheckUnionpayInfo` |
+| `open-account yandex` | `/command/media-account/AddAgencyClient` | POST | Body：`MediaAccountGroupId` + `AgencyClientInfo`（登录名、税号、电话等） |
+| `open-account bing` | `/command/media-account/AddBingV2Account` | POST | Body：`BingCustomerInfo` / `BingV2AccountInfo` + 执照 `FileId`；前置 `POST .../command/attachment` |
+| `open-account kwai` | `/command/media-account/AddKwaiAccount` | POST | Body：Kwai 专用主体/行业/执照结构 + `blobstoreKey`；前置 `POST .../KwaiAccount/Management/Upload` |
+
+---
+
+## 辅助接口
+
+| 用途 | 接口 | CLI 命令 |
+|------|------|---------|
+| Google 时区列表 | `GET {apiBaseUrl}/query/media-account/Google/TimeZoneInfo/ReadFile` | `open-account google-timezones` |
+| TikTok 时区列表 | `GET {apiBaseUrl}/query/media-account/tiktok/TikTokTimeZoneInfo/Read` | `open-account tiktok-timezones` |
+| TikTok 行业列表 | `GET {apiBaseUrl}/query/media-account/tiktok/TikTokIndustryInfo/Read` | `open-account tiktok-industries` |
+| TikTok 注册地列表 | `GET {apiBaseUrl}/query/media-account/tiktok/TikTokAreacode/Read` | `open-account tiktok-areas` |
+| Bing 行业列表 | `GET {apiBaseUrl}/query/media-account/bing/BingTradeList/Read`（返回中文行业名，`name` 字段即为 `--trade-id` 的值） | `open-account bing-industries` |
+| 修改 Google 申请 | `PUT .../command/media-account/google/{entityId}`，`s-command-type: UpdateMediaAccount` | — |
+| 修改 TikTok 申请 | `PUT .../command/media-account/{entityId}`，`s-command-type: UpdateMediaAccount` | — |
+| 修改 Yandex 申请 | `POST .../command/media-account/UpdateAgencyClient/{id}` | — |
+
+## 公司名称（广告主组）联想说明
+
+网页上「公司名称」下拉的数据来自 `GET {apiBaseUrl}/query/profile/steward-individual`（与 `open-account list-groups` 同一接口），**无搜索接口，为本地过滤**。
+
+选中已有广告主后，网页会自动回填推广链接、行业、推广类型等字段。CLI 的 `open-account google` 同样按 `--company` 名称自动匹配或创建广告主组，行为与网页一致。

package/assets/siluzan-ads/references/open-account-google-ui.md

@@ -0,0 +1,121 @@
+# Google 开户：网页交互与 CLI 对照（/openAnAccount）
+
+> 路由：`{webUrl}/v3/foreign_trade/tso/openAnAccount?mediaType=Google&...`  
+> 前端组件：`openAnAccount.vue` + 顶部流程条 `GGOPASteps.vue`
+
+---
+
+## 一、页面顶部「五步」是什么？
+
+与**表单分步**不是同一套数字，但语义连贯：
+
+| 步骤 | 文案（意译） | 用户要做什么 | CLI / Skill 能做什么 |
+|------|----------------|----------------|----------------------|
+| ① | 准备开户资料 | 准备公司名、网址、类型、账户信息等 | 说明清单；**无法**代替用户准备资质 |
+| ② | 填写申请 | 网页里完成第 1、2 步表单并提交 | **`open-account google-wizard`** 或 **`open-account google`** |
+| ③ | 等待审核 | 等待媒体/平台审核 | **`account-history -m Google`** 轮询 |
+| ④ | 审核通过 | 查看通过结果 | 同上 |
+| ⑤ | 充值并激活 | **必须在网页完成充值** | 引导 `config show` → `webUrl` + 充值路径（见 `finance.md`） |
+
+页面上还有提示：**美元账户最低充值约 100 USD、人民币约 700 CNY**（以实际页面为准）。
+
+---
+
+## 二、网页里实际填表是「两步」
+
+### 第 1 步（企业 / 推广信息）
+
+| 网页控件 | 说明 | CLI 对应 |
+|----------|------|----------|
+| 公司名称 | 文本，可联想已有广告主 | `--company` |
+| 网址 | 左侧下拉 `https://` / `http://` + 右侧输入框 | `--promotion-link`（可只写域名，CLI 会补协议） |
+| 类型 | 单选 **B2B / B2C / APP** | `--promotion-type`：`b2b` \| `b2c` \| `app` |
+| 行业级联 | 当前前端已隐藏 | 可选 `--industry1` / `--industry2` |
+
+提交第 1 步后，后台会**创建或更新广告主组**并拿到 `magKey`；CLI 已内置该逻辑，**无需**用户自己查 `magKey`。
+
+### 第 2 步（广告账户表格，与下拉菜单一致）
+
+| 网页控件 | 说明 | CLI 对应 |
+|----------|------|----------|
+| 账户名称 | 文本，默认与公司名一致 | `--account-name` |
+| 币种 | 下拉：**CNY / USD**（HKD 对代理商场景为禁用） | `--currency`：`CNY` \| `USD` |
+| 时区 | 下拉：文案为 **`(Time)Name`**，值为 **IANA Code** | `--timezone`；列表用 **`open-account google-timezones`** |
+| 开户数量 | 1～3，且多行总和 ≤3（网页表格） | `--counts`（1～3） |
+| 开户邮箱 | 建议 Gmail；网页校验 **`.com` 结尾** | `--invite-email` |
+
+**币种 ↔ 默认时区（与网页 `changeCurrency` 一致）**
+
+- 选 **CNY** → 默认 **`Asia/Shanghai`**
+- 选 **USD**（或其它非 CNY）→ 默认 **`Asia/Hong_Kong`**
+
+其它时区请从 **`siluzan-tso open-account google-timezones`** 里取 **Code** 列（与网页下拉同一接口）。
+
+---
+
+## 三、推荐用法
+
+### 1）非交互提交（Agent / 脚本首选）
+
+```bash
+# 常用时区速查（无需每次运行 google-timezones）：
+# Asia/Shanghai      北京/上海（CNY 默认）
+# Asia/Hong_Kong     香港（USD 默认）
+# America/New_York   美东
+# America/Los_Angeles 美西
+# Europe/London      伦敦
+# 完整列表：siluzan-tso open-account google-timezones [--keyword <关键词>]
+
+siluzan-tso open-account google \
+  --company "某某公司" \
+  --promotion-link "https://www.example.com" \
+  --promotion-type b2c \
+  --account-name "某某公司-美国投放" \
+  --currency USD \
+  --timezone "America/New_York" \
+  --invite-email "user@gmail.com" \
+  --counts 1
+```
+
+### 2）交互向导（人工终端操作，需要真实 TTY）
+
+```bash
+# 注意：需要真实终端，CI / 管道 / AI Agent 环境下无法使用
+siluzan-tso open-account google-wizard
+```
+
+### 3）审核与后续
+
+```bash
+# 轮询审核进度
+siluzan-tso account-history -m Google
+
+# 审核通过后，充值激活（必须网页完成）
+# siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge
+# 美元账户最低约 100 USD，人民币账户约 700 CNY
+```
+
+---
+
+## 四、给 AI Agent 的简短指令模板
+
+当用户说「我要在丝路赞开 Google 户」时：
+
+1. 收集必填字段：公司名、推广网址、推广类型、账户名、币种、时区、邀请邮箱。
+2. 时区未知时，先给出常用时区表（见上方速查），或运行 `open-account google-timezones --keyword <关键词>` 辅助选择。
+3. 拼一条 `open-account google` 非交互命令提交。
+4. 提交后：`account-history -m Google` 轮询进度。
+5. 审核通过后：引导充值激活，给出充值网页路径（见第三步）。
+
+---
+
+## 五、相关命令速查
+
+| 命令 | 作用 |
+|------|------|
+| `open-account google-wizard` | 交互向导（对齐网页两步表单 + 五步说明） |
+| `open-account google-timezones` | 时区列表（网页下拉同源） |
+| `open-account google` | 非交互一次性提交 |
+| `account-history -m Google` | 开户审核进度 |
+
+更完整的参数表见 `accounts.md` → **open-account** 章节。

package/assets/siluzan-ads/references/reporting.md

@@ -0,0 +1,511 @@
+# 报告与优化命令详解
+
+> 所属 skill：`siluzan-tso`。
+
+---
+
+## report — 优化报告
+
+### report list — 查询报告列表
+
+```bash
+siluzan-tso report list -m <媒体> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-m, --media` | 媒体类型（必填）：`Google \| TikTok` |
+| `-t, --type <type>` | 报告类型：`Daily \| Hourly` |
+| `-s, --status <ready>` | 是否已生成：`true \| false` |
+| `-k, --keyword <text>` | 报告名称关键字 |
+| `--start / --end <date>` | 日期范围（YYYY-MM-DD） |
+| `--json` | 输出原始 JSON |
+
+**示例：**
+
+```bash
+# 查询所有 Google 报告
+siluzan-tso report list -m Google
+
+# 查询本月 TikTok 日报
+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
+```
+
+---
+
+### report create — 批量生成报告
+
+```bash
+siluzan-tso report create -m <媒体> -a <账户ID列表> -t <类型> --start <date> --end <date>
+```
+
+| 选项 | 说明 | 必填 |
+|------|------|------|
+| `-m, --media` | 媒体类型 | ✅ |
+| `-a, --accounts <ids>` | 账户 `mediaCustomerId`（数字 ID），逗号分隔。**注意：不是 `entityId`**，内部会自动转换 | ✅ |
+| `-t, --type` | 报告类型 | ✅ |
+| `--start / --end` | 日期范围 | ✅ |
+
+**示例：**
+
+```bash
+# 为 Google 账户生成本月日报（传 mediaCustomerId）
+siluzan-tso report create \
+  -m Google \
+  -a 6326027735 \
+  -t Daily \
+  --start 2026-03-01 \
+  --end 2026-03-31
+
+# 多账户，生成昨天的小时报
+siluzan-tso report create -m Google -a 6326027735,4545500137 -t Hourly --start 2026-03-19 --end 2026-03-19
+```
+
+---
+
+### report delete — 删除报告
+
+```bash
+siluzan-tso report delete --id <entityId>
+siluzan-tso report delete --ids <id1,id2,id3>
+```
+
+**示例：**
+
+```bash
+siluzan-tso report delete --id rpt_abc123
+
+# 批量删除
+siluzan-tso report delete --ids rpt_abc123,rpt_def456
+```
+
+---
+
+### report push — 推送管理
+
+```bash
+siluzan-tso report push list -m <媒体>              # 查询推送配置列表
+siluzan-tso report push start -m <媒体> --id <id>  # 启动推送
+siluzan-tso report push stop  -m <媒体> --id <id>  # 停止推送
+siluzan-tso report push delete -m <媒体> --id <id> # 删除推送配置
+```
+
+**示例：**
+
+```bash
+# 查询 Google 推送列表
+siluzan-tso report push list -m Google
+
+# 启动指定推送
+siluzan-tso report push start -m Google --id push_abc123
+
+# 停止推送
+siluzan-tso report push stop -m Google --id push_abc123
+
+# 删除推送配置
+siluzan-tso report push delete -m Google --id push_abc123
+```
+
+---
+
+### 查看报告（引导打开网页）
+
+报告生成后，在网页查看。先用 `siluzan-tso config show` 获取 `webUrl`，再按以下规则拼接链接：
+
+| 媒体 | 报告类型 | URL 模板 |
+|------|---------|---------|
+| Google | 日报（Daily） | `{webUrl}/media-report/publish/{entityId}?culture=zh-CN` |
+| 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` 字段。
+
+**示例流程：**
+
+```bash
+# 第一步：查询报告，获取 entityId
+siluzan-tso report list -m Google --json
+# 从输出中找到目标报告的 entityId，如 "rpt_abc123"
+
+# 第二步：查看 webUrl
+siluzan-tso config show
+# webUrl: {{WEB_URL}}
+
+# 第三步：拼接链接（Google 日报）
+# {{WEB_URL}}/media-report/publish/rpt_abc123?culture=zh-CN
+```
+
+---
+
+## ai-creation — AI 智投记录
+
+对应页面：`/advertising/AICreationList`
+
+### list — 查询列表
+
+```bash
+siluzan-tso ai-creation list [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-s, --state <state>` | 状态：`Creating \| Successfully \| Failed \| HasFailed \| Unpublished` |
+| `--customer-id <id>` | Google mediaCustomerId |
+| `--customer-name <name>` | 客户名称关键字 |
+| `-k, --keyword <text>` | 关键字 |
+| `--start / --end <date>` | 创建日期范围 |
+| `-p, --page <n>` | 页码（默认 1） |
+| `--page-size <n>` | 每页数量（默认 20） |
+| `--json` | 输出原始 JSON |
+
+**示例：**
+
+```bash
+# 查询全部记录
+siluzan-tso ai-creation list
+
+# 按 Google 账户筛选
+siluzan-tso ai-creation list --customer-id 6326027735
+
+# 查询创建失败的记录
+siluzan-tso ai-creation list --state Failed --json
+
+# 查询本月草稿
+siluzan-tso ai-creation list --state Unpublished --start 2026-03-01
+```
+
+---
+
+### get — 获取草稿详情
+
+```bash
+siluzan-tso ai-creation get --id <recordId>
+```
+
+输出完整 JSON 草稿内容（包含广告系列、预算、关键词、定向位置等）。
+
+**示例：**
+
+```bash
+siluzan-tso ai-creation get --id rec_abc123
+```
+
+---
+
+### update — 更新草稿字段
+
+只有 `draftStatus === "Draft"` 的记录可更新。
+
+```bash
+siluzan-tso ai-creation update --id <recordId> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `--budget <amount>` | 新预算（最小货币单位，如 `8500` = 85元 CNY） |
+| `--url <url>` | 新推广链接 |
+| `--campaign-name <name>` | 新广告系列名称 |
+
+**示例：**
+
+```bash
+# 修改预算为 500 元（CNY，单位为分）
+siluzan-tso ai-creation update --id rec_abc123 --budget 50000
+
+# 同时修改名称和推广链接
+siluzan-tso ai-creation update --id rec_abc123 \
+  --campaign-name "品牌A春季促销" \
+  --url "https://www.brand-a.com/spring-sale"
+```
+
+---
+
+### publish — 发布草稿
+
+只有 `draftStatus === "Draft"` 的记录可发布。发布后状态变为 `Creating`，Google 后台异步执行创建。
+
+```bash
+siluzan-tso ai-creation publish --id <recordId>
+```
+
+**示例：**
+
+```bash
+siluzan-tso ai-creation publish --id rec_abc123
+```
+
+---
+
+## optimize — AI 广告优化
+
+对应页面：`/advertising/AiGoogleOptimize`
+
+```bash
+siluzan-tso optimize list    [选项]                  # 账户级优化主列表
+siluzan-tso optimize records [选项]                  # 优化操作记录列表
+siluzan-tso optimize children --parent-id <id>       # 广告系列级明细
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-a, --account <id>` | 账户 `mediaCustomerId` |
+| `--start / --end <date>` | 日期范围（YYYY-MM-DD，自动附加 +08:00） |
+| `--parent-id <id>` | 父级 ID（`children` 子命令专用） |
+| `--json` | 输出原始 JSON |
+
+**示例：**
+
+```bash
+# 查询指定账户的优化建议列表
+siluzan-tso optimize list -a 6326027735
+
+# 查询所有账户本月优化记录
+siluzan-tso optimize records --start 2026-03-01 --end 2026-03-31
+
+# 查询某账户广告系列级明细
+siluzan-tso optimize children --parent-id opt_parent_abc123
+
+# JSON 输出
+siluzan-tso optimize list -a 6326027735 --json
+```
+
+---
+
+## clue — 广告线索表单
+
+对应页面：`/clue-form`。支持 **TikTok** 和 **Meta（Facebook）** 两种媒体。
+
+> **注意**：线索数据直接来自媒体 API，**不支持服务端分页**，数据量大时建议 `--json` 导出后自行处理。
+
+```bash
+siluzan-tso clue -m <媒体> -a <账户ID> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-m, --media` | `TikTok \| Meta`（默认 TikTok） |
+| `-a, --account <id>` | TikTok：`advertiserId`（mediaCustomerId）；Meta：Facebook 页面 ID |
+| `--region <region>` | TikTok 专用：`eu \| us \| other \| ALL`（默认 ALL） |
+| `--start <date>` | Meta 专用：开始日期（YYYY-MM-DD） |
+| `--end <date>` | Meta 专用：结束日期（YYYY-MM-DD） |
+| `--json` | 输出原始 JSON |
+
+**TikTok 示例：**
+
+```bash
+# 查询 TikTok 全部区域线索
+siluzan-tso clue -m TikTok -a 1234567890
+
+# 只查欧洲区线索
+siluzan-tso clue -m TikTok -a 1234567890 --region eu
+
+# 查美国区，JSON 输出
+siluzan-tso clue -m TikTok -a 1234567890 --region us --json
+```
+
+**Meta 示例：**
+
+```bash
+# 查询 Meta 线索（3月份）
+siluzan-tso clue -m Meta -a 987654321 --start 2026-03-01 --end 2026-03-31
+
+# JSON 输出
+siluzan-tso clue -m Meta -a 987654321 --start 2026-03-01 --json
+```
+
+**输出字段说明（TikTok）：**
+
+| 字段 | 来源 |
+|------|------|
+| 姓名、邮箱、手机 | `custom_fields` |
+| 表单名、广告名、区域、时间、lead_id | `system_fields` |
+
+**输出字段说明（Meta）：**
+
+| 字段 | 来源 |
+|------|------|
+| 姓名、邮箱、手机 | `field_data` |
+| 表单名、创建时间 | 顶层字段 |
+
+---
+
+## forewarning — 智能预警
+
+对应页面：`/advertising/forewarning`
+
+### list — 查询规则列表
+
+```bash
+siluzan-tso forewarning list -m <媒体> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-m, --media` | 媒体类型（必填）：`Google \| TikTok` |
+| `-a, --account <id>` | 账户 ID 筛选 |
+| `-k, --keyword <text>` | 规则名称关键字 |
+| `--start / --end <date>` | 日期范围 |
+| `--json` | 输出原始 JSON |
+
+**示例：**
+
+```bash
+# 查询所有 Google 预警规则
+siluzan-tso forewarning list -m Google
+
+# 按账户筛选
+siluzan-tso forewarning list -m TikTok -a entityId1
+
+# 关键字搜索
+siluzan-tso forewarning list -m Google -k "消费超限"
+```
+
+---
+
+### records — 查询预警触发记录
+
+```bash
+siluzan-tso forewarning records -m <媒体> [选项]
+```
+
+| 选项（额外） | 说明 |
+|------|------|
+| `-r, --rule-id <id>` | 规则 ID（留空查全部规则） |
+| `-s, --status <result>` | 执行结果筛选 |
+
+**示例：**
+
+```bash
+# 查询所有 TikTok 预警触发记录
+siluzan-tso forewarning records -m TikTok
+
+# 查询本月触发记录
+siluzan-tso forewarning records -m Google --start 2026-03-01
+
+# 查询指定规则的触发记录
+siluzan-tso forewarning records -m Google --rule-id rule_abc123
+```
+
+---
+
+### start / stop / delete — 启停/删除规则
+
+```bash
+siluzan-tso forewarning start  -m <媒体> --id <ruleEntityId>   # 启动规则
+siluzan-tso forewarning stop   -m <媒体> --id <ruleEntityId>   # 停止规则
+siluzan-tso forewarning delete -m <媒体> --id <ruleEntityId>   # 删除规则
+```
+
+**示例：**
+
+```bash
+siluzan-tso forewarning stop -m Google --id rule_abc123
+siluzan-tso forewarning start -m Google --id rule_abc123
+siluzan-tso forewarning delete -m TikTok --id rule_def456
+```
+
+---
+
+### create — 创建预警规则（自定义类型）
+
+```bash
+siluzan-tso forewarning create \
+  -m Google \
+  --name "消费超限预警" \
+  --accounts "entityId1,entityId2" \
+  --field cost \
+  --operator GREATER_EQUALS \
+  --value 500 \
+  --days 1 \
+  --frequency QuarterHour \
+  --notify "notifyEntityId"
+```
+
+| 选项 | 说明 | 必填 |
+|------|------|------|
+| `-m, --media` | `Google \| TikTok` | ✅ |
+| `--name` | 规则名称 | ✅ |
+| `--accounts <ids>` | 监控账户 `entityId`，逗号分隔 | ✅ |
+| `--field <field>` | 监控指标（见下表） | ✅ |
+| `--operator <op>` | 比较运算符（见下表） | ✅ |
+| `--value <n>` | 阈值（数字） | ✅ |
+| `--scope <type>` | 层级：`Campaign \| AdGroup \| Ad`（默认 `Campaign`） | |
+| `--days <n>` | 统计周期（天）：`1 \| 3 \| 7`（默认 1） | |
+| `--frequency <freq>` | 检查频率：`QuarterHour \| HalfHour \| Hour`（默认 `QuarterHour`） | |
+| `--notify <ids>` | 通知账户 `entityId`，逗号分隔 | |
+
+**监控指标（--field）：**
+
+| 媒体 | 可选值 |
+|------|--------|
+| Google | `cost` `CPA` `CPM` `CPC` `conversions_count` `conversions_rate` `valid_click_count` `ctr` |
+| TikTok | `spend` `cpc` `cpm` `cost_per_conversion` `conversion` `ctr` `clicks` `result` `result_rate` |
+
+**比较运算符（--operator）：**
+
+`GREATER_EQUALS`（≥）、`GREATER`（>）、`LESS_EQUALS`（≤）、`LESS`（<）、`EQUALS`（=）
+
+**典型场景示例：**
+
+```bash
+# 场景1：Google 账户日消费超过 500 元时预警
+siluzan-tso forewarning create \
+  -m Google \
+  --name "日消费超限" \
+  --accounts "entityId1" \
+  --field cost \
+  --operator GREATER_EQUALS \
+  --value 500
+
+# 场景2：TikTok 广告组 CPM 低于 5 元时预警（每半小时检查一次）
+siluzan-tso forewarning create \
+  -m TikTok \
+  --name "CPM 偏低预警" \
+  --accounts "entityId1,entityId2" \
+  --field cpm \
+  --operator LESS \
+  --value 5 \
+  --scope AdGroup \
+  --frequency HalfHour
+
+# 场景3：Google 近 7 天转化数低于 10 时预警，并通知指定账户
+siluzan-tso forewarning create \
+  -m Google \
+  --name "转化不足预警" \
+  --accounts "entityId1" \
+  --field conversions_count \
+  --operator LESS \
+  --value 10 \
+  --days 7 \
+  --notify "notifyEntityId"
+```
+
+---
+
+### update — 更新预警规则
+
+参数与 `create` 相同，**额外必填 `--id`**（规则 entityId）。
+
+```bash
+siluzan-tso forewarning update \
+  -m Google \
+  --id rule_abc123 \
+  --name "日消费超限（修改版）" \
+  --accounts "entityId1" \
+  --field cost \
+  --operator GREATER_EQUALS \
+  --value 800
+```
+
+---
+
+### get — 查看单条规则详情
+
+编辑前用于获取规则的当前配置。
+
+```bash
+siluzan-tso forewarning get -m Google --id rule_abc123
+```