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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/README.md +2 -1
  2. package/dist/index.js +897 -194
  3. package/dist/skill/SKILL.md +2 -1
  4. package/dist/skill/_meta.json +2 -2
  5. package/dist/skill/references/accounts/accounts-list.md +1 -1
  6. package/dist/skill/references/accounts/accounts-permissions.md +2 -2
  7. package/dist/skill/references/accounts/finance.md +1 -1
  8. package/dist/skill/references/accounts/open-account-by-media.md +72 -68
  9. package/dist/skill/references/accounts/open-account-google-ui.md +30 -27
  10. package/dist/skill/references/analytics/rag.md +1 -1
  11. package/dist/skill/references/analytics/reporting.md +5 -5
  12. package/dist/skill/references/core/agent-conventions.md +5 -3
  13. package/dist/skill/references/core/setup.md +5 -5
  14. package/dist/skill/references/core/workflows.md +7 -6
  15. package/dist/skill/references/misc/tso-home.md +2 -2
  16. package/dist/skill/references/operations/guard.md +94 -0
  17. package/dist/skill/references/operations/hosted-automation-self-control.md +35 -15
  18. package/dist/skill/references/operations/hosted-automation-user-catalog.md +5 -5
  19. package/dist/skill/references/report-templates/bing-period-report.md +3 -3
  20. package/dist/skill/references/report-templates/google-period-report.md +1 -1
  21. package/dist/skill/references/report-templates/meta-account-diagnosis-report.md +1 -1
  22. package/dist/skill/references/report-templates/meta-period-report.md +2 -2
  23. package/dist/skill/references/report-templates/tiktok-period-report.md +1 -1
  24. package/dist/skill/report-templates/bing-period-report.md +3 -3
  25. package/dist/skill/report-templates/google-period-report.md +1 -1
  26. package/dist/skill/report-templates/meta-account-diagnosis-report.md +1 -1
  27. package/dist/skill/report-templates/meta-period-report.md +2 -2
  28. package/dist/skill/report-templates/tiktok-period-report.md +1 -1
  29. package/dist/skill/scripts/install.ps1 +3 -3
  30. package/dist/skill/scripts/install.sh +3 -3
  31. package/eval/cases/guard-budget-circuit-all-google.scenario.json +25 -0
  32. package/eval/cases/guard-zero-conv-empty-spend.scenario.json +21 -0
  33. package/eval/stub-fixtures/guard-budget-circuit.json +36 -0
  34. package/eval/stub-fixtures/guard-zero-conv.json +41 -0
  35. package/package.json +1 -1
package/dist/skill/SKILL.md CHANGED
@@ -102,7 +102,8 @@ siluzan-tso -h
102
102
  | 智能预警：创建/查询/启停/触发记录 | W10 | `references/operations/forewarning.md` |
103
103
  | TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |
104
104
  | 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |
105
- | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP） |
105
+ | 超预算熔断 / 空耗熔断（全户 Google） | — | `references/operations/guard.md`（`guard budget-circuit` / `guard zero-conv`；禁止逐户 for-loop） |
106
+ | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP；预算/空耗熔断优先 guard.md） |
106
107
 
107
108
  ---
108
109
 
package/dist/skill/_meta.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.39",
4
- "publishedAt": 1785141614907
3
+ "version": "1.1.40-beta.1",
4
+ "publishedAt": 1785225395652
5
5
  }
package/dist/skill/references/accounts/accounts-list.md CHANGED
@@ -164,7 +164,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
164
164
  | 状态 | 含义 | 下一步操作 |
165
165
  | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
166
166
  | `Pending` | 审核中 | 等待，可反复运行此命令轮询；审核周期因媒体而异 |
167
- | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
167
+ | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
168
168
  | `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |
169
169
 
170
170
  ---
package/dist/skill/references/accounts/accounts-permissions.md CHANGED
@@ -472,7 +472,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
472
472
 
473
473
  | 功能 | 媒体 | 网页路径 |
474
474
  | --------------------------------------- | ------ | ------------------------------------------------- |
475
- | **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
475
+ | **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
476
476
 
477
477
  **Agent 建议话术**：
478
478
 
@@ -481,5 +481,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
481
481
  siluzan-tso config show # 查看 webUrl 字段
482
482
 
483
483
  # 账户激活（Google）→ 引导至账户管理页
484
- # https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
484
+ # https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
485
485
  ```
package/dist/skill/references/accounts/finance.md CHANGED
@@ -127,7 +127,7 @@ siluzan-tso config show
127
127
 
128
128
  ### 充值页链接（按媒体 × 类型）
129
129
 
130
- 链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
130
+ 链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
131
131
 
132
132
  | 充值类型 | `<page>` | 支持媒体（`mediaType` 参数） |
133
133
  | ------------------------- | --------------------- | ------------------------------------------- |
package/dist/skill/references/accounts/open-account-by-media.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 各媒体开户
2
2
 
3
- > 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
3
+ > 网页链接：`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
4
4
  > 多命令串联见 `references/core/workflows.md` § 流程一。
5
5
 
6
6
 
@@ -23,15 +23,17 @@
23
23
 
24
24
  用户提出开户（或本轮对话**首次**进入开户话题）时，Agent **必须先输出完整必填清单**，再收集资料或执行 CLI。**禁止**在未列清单的情况下直接 `open-account …` 或只问一两个字段。
25
25
 
26
- | 用户说法 | 首次回复必须包含 |
27
- | --------------------------------------- | ------------------------------------------------------------------------- |
28
- | 未指明媒体 / 「开个户」/ 「各平台开户」 | 下文 **§ 全平台必填总览** 六张表（或等价完整列表） |
29
- | 已指明单一媒体（如「Google 开户」） | 该媒体 **§ 必填字段** 表 + 辅助查询命令（若有）+ 资料类说明（执照路径等） |
30
- | 多媒体同时开 | 每个目标媒体各一张必填表，**禁止**混用字段 |
26
+ | 用户说法 | 首次回复必须包含 |
27
+ | --------------------------------------- | --------------------------------------------------------------------------------------------------------- |
28
+ | 未指明媒体 / 「开个户」/ 「各平台开户」 | 下文 **§ 全平台必填总览** 六媒体的**业务项 + 说明**（或等价完整列表） |
29
+ | 已指明单一媒体（如「Google 开户」） | 该媒体 **业务项 + 说明**（格式/枚举、是否需本地文件）+ 资料类说明（执照路径等）；时区等可用业务语言辅助表 |
30
+ | 多媒体同时开 | 每个目标媒体各一份业务清单，**禁止**混用字段 |
31
31
 
32
- 清单须写清：**业务含义**、**CLI 选项名**、**格式/枚举**、**是否需本地文件路径**。用户补齐后再确认并提交；写入前仍须用户确认（见 `references/core/agent-conventions.md`）。
32
+ **对用户清单只写**：业务项含义、格式/枚举（如「b2b / b2c / app」）、是否需本地文件路径。
33
+ **禁止**在对用户回复中出现：`--flag`、CLI 选项名、命令行参数列、``siluzan-tso …`` 完整命令块、本文件「Agent 参数」列内容。
34
+ CLI 参数仅供 Agent **内部**组命令使用（见下表第三列）。用户补齐后再确认并提交；写入前仍须用户确认（见 `references/core/agent-conventions.md`）。
33
35
 
34
- 只有Google开户时需要询问用户账户币种（USD|CNY）,其他广告平台禁止询问用户币种因为都仅支持USD一种
36
+ 只有 Google 开户时需要询问用户账户币种（USD|CNY）；其他广告平台禁止询问币种（均仅支持 USD）。
35
37
 
36
38
  不确定字段时：先 `siluzan-tso open-account <subcommand> -h`，再以本文件与 CLI 为准，勿猜。
37
39
 
@@ -40,6 +42,7 @@
40
42
  ## Agent 注意
41
43
 
42
44
  - 始终用非交互 `open-account <media> ...`。
45
+ - **对用户永不展示 CLI 参数名 / 命令行选项**（见上节）；示例 bash 块仅供 Agent 执行参考，勿原样贴进对话。
43
46
  - **Meta/Facebook 开户**无表单提交命令，使用 `open-account meta` 获取官方 OE 链接交给用户在浏览器完成。
44
47
  - 各媒体所需资料和参数**完全不同**，不要混用。
45
48
  - 提交后轮询：`account-history -m <Media>`；通过后 `list-accounts -m <Media>`。
@@ -49,81 +52,82 @@
49
52
 
50
53
  ## 全平台必填总览
51
54
 
52
- > 与 `siluzan-tso open-account <media> -h` 的 `requiredOption` 对齐；可选字段见各媒体 §。
55
+ > 与 `siluzan-tso open-account <media> -h` 的 `requiredOption` 对齐；可选字段见各媒体 §。
56
+ > 表中 **Agent 参数**列仅供内部映射；**对用户展示时删除该列**，只保留「业务项 + 说明」。
53
57
 
54
58
  ### Google（`open-account google`，无需图片）
55
59
 
56
- | 业务项 | CLI 选项 | 说明 |
57
- | -------- | ------------------ | ------------------------------------------- |
58
- | 公司名称 | `--company` | 用于匹配/创建广告主组 |
59
- | 推广链接 | `--promotion-link` | 可只写域名，CLI 补 `https://` |
60
- | 推广类型 | `--promotion-type` | `b2b` \| `b2c` \| `app` |
61
- | 账户名称 | `--account-name` | 建议 ≤22 字 |
62
- | 币种 | `--currency` | `USD` \| `CNY` |
63
- | 时区 | `--timezone` | IANA；列表：`open-account google-timezones` |
64
- | 邀请邮箱 | `--invite-email` | 账户邀请发往此邮箱 |
60
+ | 业务项 | 说明 | Agent 参数（勿展示） |
61
+ | -------- | --------------------------------------------- | ------------------------------------ |
62
+ | 公司名称 | 用于匹配/创建广告主组 | `--company` |
63
+ | 推广链接 | 可只写域名，提交时会自动补 `https://` | `--promotion-link` |
64
+ | 推广类型 | `b2b`（企业对企业）/ `b2c`（企业对消费者）/ `app`（应用） | `--promotion-type` |
65
+ | 账户名称 | 广告账户显示名，建议 ≤22 字 | `--account-name` |
66
+ | 币种 | `USD`（美元）或 `CNY`（人民币） | `--currency` |
67
+ | 时区 | IANA 时区，如北京时间、美东；可用常用时区表辅助 | `--timezone` |
68
+ | 邀请邮箱 | 开通后接收账户邀请的邮箱 | `--invite-email` |
65
69
 
66
70
  ### TikTok（`open-account tiktok`，需营业执照图片）
67
71
 
68
- | 业务项 | CLI 选项 | 说明 |
69
- | ------------ | ----------------------------- | -------------------------------------------------------- |
70
- | 公司名称 | `--company` | 无 OCR，须用户手填 |
71
- | 账户名称 | `--account-name` | |
72
- | 时区 | `--timezone` | 列表：`open-account tiktok-timezones` |
73
- | 行业 ID | `--industry-id` | **叶子节点**数字；列表：`open-account tiktok-industries` |
74
- | 注册地 | `--registered-area` | 国家代码如 `CN`；列表：`open-account tiktok-areas` |
75
- | 推广链接 | `--promotion-link` | |
76
- | 执照编号 | `--license-no` | 统一社会信用代码 |
77
- | 执照图片 | `--license-file` | 本地 JPG/PNG 路径 |
78
- | 法人姓名 | `--representative-name` | CLI 必填 |
79
- | 法人身份证 | `--representative-id` | CLI 必填 |
80
- | 法人银联账号 | `--unionpay-account` | CLI 必填 |
81
- | 法人手机 | `--representative-phone` | CLI 必填 |
82
- | 币种 | 只支持USD， 无需 `--currency` |
72
+ | 业务项 | 说明 | Agent 参数（勿展示） |
73
+ | ------------ | -------------------------------------------------------- | ----------------------------- |
74
+ | 公司名称 | 无 OCR，须用户手填 | `--company` |
75
+ | 账户名称 | 广告账户显示名 | `--account-name` |
76
+ | 时区 | IANA；不确定时先查时区列表 | `--timezone` |
77
+ | 行业 ID | **叶子节点**数字；不确定时先查行业列表 | `--industry-id` |
78
+ | 注册地 | 国家代码如 `CN`；不确定时先查地区列表 | `--registered-area` |
79
+ | 推广链接 | 推广网址 | `--promotion-link` |
80
+ | 执照编号 | 统一社会信用代码 | `--license-no` |
81
+ | 执照图片 | 本地 JPG/PNG 路径 | `--license-file` |
82
+ | 法人姓名 | 必填 | `--representative-name` |
83
+ | 法人身份证 | 必填 | `--representative-id` |
84
+ | 法人银联账号 | 必填 | `--unionpay-account` |
85
+ | 法人手机 | 必填 | `--representative-phone` |
86
+ | 币种 | 只支持 USD，无需再问用户 | （无 `--currency`） |
83
87
 
84
88
  ### Yandex（`open-account yandex`，无需图片）
85
89
 
86
- | 业务项 | CLI 选项 | 说明 |
87
- | ------------ | ----------- | ------------------------ |
88
- | 公司名称 | `--company` | |
89
- | 联系邮箱 | `--email` | |
90
- | 税号 TIN/INN | `--tin` | 类型固定 `FOREIGN_LEGAL` |
90
+ | 业务项 | 说明 | Agent 参数（勿展示） |
91
+ | ------------ | ------------------------ | -------------------- |
92
+ | 公司名称 | | `--company` |
93
+ | 联系邮箱 | | `--email` |
94
+ | 税号 TIN/INN | 类型固定 `FOREIGN_LEGAL` | `--tin` |
91
95
 
92
96
  ### BingV2（`open-account bing`，需营业执照图片）
93
97
 
94
- | 业务项 | CLI 选项 | 说明 |
95
- | ---------- | -------------------- | ------------------------------------------------------------------------ |
96
- | 直接/代理 | `--pattern` | `Direct` \| `Agency` |
97
- | 广告主全称 | `--advertiser-name` | 用于匹配/创建广告主组 |
98
- | 公司简称 | `--name-short` | |
99
- | 开户名称 | `--name-remark-list` | 账户显示名 |
100
- | 省份 | `--province` | |
101
- | 城市 | `--city` | |
102
- | 详细地址 | `--address` | |
103
- | 邮编 | `--postcode` | |
104
- | 行业 | `--trade-id` | 先 `bing-industries`；传输出 **id**（与网页下拉 value 一致），勿猜中文名 |
105
- | 推广链接 | `--promotion-link` | |
106
- | 执照图片 | `--license-file` | JPG/PNG/PDF 本地路径 |
98
+ | 业务项 | 说明 | Agent 参数（勿展示） |
99
+ | ---------- | ------------------------------------------------------------------------ | -------------------- |
100
+ | 直接/代理 | `Direct`（直接）或 `Agency`（代理） | `--pattern` |
101
+ | 广告主全称 | 用于匹配/创建广告主组 | `--advertiser-name` |
102
+ | 公司简称 | | `--name-short` |
103
+ | 开户名称 | 账户显示名 | `--name-remark-list` |
104
+ | 省份 | | `--province` |
105
+ | 城市 | | `--city` |
106
+ | 详细地址 | | `--address` |
107
+ | 邮编 | | `--postcode` |
108
+ | 行业 | 先查行业列表，传输出的 **id**（与网页下拉一致），勿猜中文名 | `--trade-id` |
109
+ | 推广链接 | | `--promotion-link` |
110
+ | 执照图片 | JPG/PNG/PDF 本地路径 | `--license-file` |
107
111
 
108
112
  ### Kwai（`open-account kwai`，需营业执照图片）
109
113
 
110
- | 业务项 | CLI 选项 | 说明 |
111
- | ------------- | -------------------- | ------------------------------------------------------------------------------------------ |
112
- | 营业执照号 | `--licence-id` | |
113
- | 注册国家 | `--licence-country` | 如 `CN` |
114
- | 注册地址 | `--licence-location` | 省市区详细地址 |
115
- | 营业范围 | `--business-scope` | |
116
- | 产品/品牌名 | `--product` | |
117
- | 账户类型 | `--ad-type` | `1` 效果 / `2` 品牌 |
118
- | 产品网址 | `--product-url` | |
119
- | 执照/证件类型 | `--licence-id-type` | `1` 统一社会信用代码 / `2` DUNS / `3` CNPJ（与网页下拉 value 一致；**勿用** `ENTERPRISE`） |
120
- | 账户名称 | `--account-name` | |
121
- | 公司主体名 | `--company-name` | |
122
- | 一级行业 ID | `--industry-id1` | |
123
- | 二级行业 ID | `--industry-id2` | |
124
- | 有效期类型 | `--expire-type` | `1` 有限期（须 `--expire-at`）/ `2` 长期 |
125
- | 投放地区 | `--target-country` | ISO 如 `US` |
126
- | 执照图片 | `--license-file` | 本地路径 |
114
+ | 业务项 | 说明 | Agent 参数（勿展示） |
115
+ | ------------- | ------------------------------------------------------------------------------------------ | -------------------- |
116
+ | 营业执照号 | | `--licence-id` |
117
+ | 注册国家 | 如 `CN` | `--licence-country` |
118
+ | 注册地址 | 省市区详细地址 | `--licence-location` |
119
+ | 营业范围 | | `--business-scope` |
120
+ | 产品/品牌名 | | `--product` |
121
+ | 账户类型 | `1` 效果 / `2` 品牌 | `--ad-type` |
122
+ | 产品网址 | | `--product-url` |
123
+ | 执照/证件类型 | `1` 统一社会信用代码 / `2` DUNS / `3` CNPJ（与网页下拉一致；**勿用** `ENTERPRISE`） | `--licence-id-type` |
124
+ | 账户名称 | | `--account-name` |
125
+ | 公司主体名 | | `--company-name` |
126
+ | 一级行业 ID | | `--industry-id1` |
127
+ | 二级行业 ID | | `--industry-id2` |
128
+ | 有效期类型 | `1` 有限期（须同时提供到期日）/ `2` 长期 | `--expire-type` |
129
+ | 投放地区 | ISO 如 `US` | `--target-country` |
130
+ | 执照图片 | 本地路径 | `--license-file` |
127
131
 
128
132
  ### MetaAd（`open-account meta`）
129
133
 
package/dist/skill/references/accounts/open-account-google-ui.md CHANGED
@@ -1,38 +1,41 @@
1
1
  ## 一、开户流程（五步语义）
2
2
 
3
- | 步骤 | 含义 | CLI / Skill |
4
- | ---- | ---------- | -------------------------------------------------------------------- |
5
- | ① | 准备资料 | 向用户说明清单；无法代替用户准备资质 |
6
- | ② | 填写并提交 | `open-account google-wizard`（TTY）或 `open-account google` |
7
- | ③ | 等待审核 | `account-history -m Google` |
8
- | ④ | 审核通过 | 同上 |
9
- | ⑤ | 充值激活 | **必须网页**；`config show` → `webUrl` + 充值路径（见 `finance.md`） |
3
+ | 步骤 | 含义 | Agent 内部动作（勿原样贴给用户） |
4
+ | ---- | ---------- | ------------------------------------------------------------------------ |
5
+ | ① | 准备资料 | 向用户说明**业务项清单**；无法代替用户准备资质 |
6
+ | ② | 填写并提交 | `open-account google-wizard`（TTY）或 `open-account google` |
7
+ | ③ | 等待审核 | `account-history -m Google` |
8
+ | ④ | 审核通过 | 同上 |
9
+ | ⑤ | 充值激活 | **必须网页**；`config show` → `webUrl` + 充值路径（见 `finance.md`） |
10
10
 
11
11
  美元账户最低充值约 **100 USD**，人民币约 **700 CNY**（以平台为准）。
12
12
 
13
13
  ---
14
14
 
15
- ## 二、非交互提交字段
15
+ ## 二、字段（对用户 vs Agent）
16
16
 
17
- | 字段 | CLI 选项 |
18
- | -------------------- | --------------------------------------------------- |
19
- | 公司名称 | `--company` |
20
- | 推广网址 | `--promotion-link`（可只写域名，CLI 补协议） |
21
- | 推广类型 B2B/B2C/APP | `--promotion-type`：`b2b` \| `b2c` \| `app` |
22
- | 行业（可选） | `--industry1` / `--industry2` |
23
- | 账户名称 | `--account-name` |
24
- | 币种 CNY/USD | `--currency` |
25
- | 时区 IANA | `--timezone`；列表：`open-account google-timezones` |
26
- | 开户数量 1～3 | `--counts` |
27
- | 邀请邮箱 | `--invite-email` |
17
+ **对用户说明时**只使用「字段 / 说明」两列（业务语言）。
18
+ **Agent 参数**列仅供内部组命令，**禁止**写入对用户回复。
19
+
20
+ | 字段 | 说明（可对用户说） | Agent 参数（勿展示） |
21
+ | -------------------- | ---------------------------------------------------- | --------------------------------------------------- |
22
+ | 公司名称 | 用于匹配/创建广告主组 | `--company` |
23
+ | 推广网址 | 可只写域名，提交时会自动补协议 | `--promotion-link` |
24
+ | 推广类型 | 企业对企业（b2b）/ 企业对消费者（b2c）/ 应用（app） | `--promotion-type`：`b2b` \| `b2c` \| `app` |
25
+ | 行业（可选） | | `--industry1` / `--industry2` |
26
+ | 账户名称 | 广告账户显示名 | `--account-name` |
27
+ | 币种 | CNY 或 USD | `--currency` |
28
+ | 时区 | IANA；可用常用时区表或查完整列表 | `--timezone`；列表：`open-account google-timezones` |
29
+ | 开户数量 | 1～3 | `--counts` |
30
+ | 邀请邮箱 | 开通后接收账户邀请的邮箱 | `--invite-email` |
28
31
 
29
32
  **币种默认时区**：CNY → `Asia/Shanghai`；USD（或其它非 CNY）→ `Asia/Hong_Kong`。其它时区从 `google-timezones` 取 **Code** 列。
30
33
 
31
- 提交时按 `--company` 自动查找/创建广告主组并拿 `magKey`，**无需**手动填 magKey。
34
+ 提交时按公司名称自动查找/创建广告主组并拿 `magKey`，**无需**让用户填 magKey。
32
35
 
33
36
  ---
34
37
 
35
- ## 三、推荐用法
38
+ ## 三、推荐用法（Agent 执行参考，勿贴给用户）
36
39
 
37
40
  ### 非交互（Agent / 脚本首选）
38
41
 
@@ -60,22 +63,22 @@ siluzan-tso open-account google-wizard
60
63
 
61
64
  ```bash
62
65
  siluzan-tso account-history -m Google
63
- # 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
66
+ # 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
64
67
  ```
65
68
 
66
69
  ---
67
70
 
68
71
  ## 四、Agent 指令模板
69
72
 
70
- 1. **首次回复**：向用户输出 Google **全部必填项**（见 § 二表格；与 `open-account-by-media.md` § 全平台总览一致），含 CLI 选项名与枚举，再请用户逐项提供；勿只问一两个字段。
71
- 2. 时区不明时运行 `google-timezones` 或给出常用时区表。
72
- 3. 用户确认资料齐全后执行 `open-account google`。
73
- 4. `account-history -m Google` 轮询。
73
+ 1. **首次回复**：向用户输出 Google **全部必填业务项**（见 § 二「字段 / 说明」；与 `open-account-by-media.md` § 全平台总览一致），含格式/枚举（如 b2b/b2c/app、USD/CNY），再请用户逐项提供；**勿**输出 `--flag` / CLI 选项名 / 命令行参数列；勿只问一两个字段。
74
+ 2. 时区不明时运行 `google-timezones`，或用业务语言给出常用时区表（勿贴完整 CLI）。
75
+ 3. 用户确认资料齐全后执行 `open-account google`（命令留在工具侧，勿把完整命令块贴进对话）。
76
+ 4. `account-history -m Google` 轮询；向用户只说进度结论。
74
77
  5. 通过后引导充值（`finance.md`）。
75
78
 
76
79
  ---
77
80
 
78
- ## 五、命令速查
81
+ ## 五、命令速查（Agent 内部）
79
82
 
80
83
  | 命令 | 作用 |
81
84
  | ------------------------------- | ---------- |
package/dist/skill/references/analytics/rag.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # rag：知识库检索（TSO 广告投放辅助）
2
2
 
3
- 知识库管理页面在 https://www.siluzan.com/knowledge-base/
3
+ 知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
4
4
 
5
5
  为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
6
6
 
package/dist/skill/references/analytics/reporting.md CHANGED
@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
190
190
 
191
191
  | 媒体 | 报告类型 | URL 模板 |
192
192
  | ------ | ---------------- | ----------------------------------------------------------- |
193
- | Google | 日报（Daily） | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
194
- | Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
195
- | TikTok | 日报 | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
193
+ | Google | 日报（Daily） | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
194
+ | Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
195
+ | TikTok | 日报 | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
196
196
 
197
197
  `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
198
198
 
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
205
205
 
206
206
  # 第二步：查看 webUrl
207
207
  siluzan-tso config show
208
- # webUrl: https://www.siluzan.com
208
+ # webUrl: https://www-ci.siluzan.com
209
209
 
210
210
  # 第三步：拼接链接（Google 日报）
211
- # https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
211
+ # https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
212
212
  ```
package/dist/skill/references/core/agent-conventions.md CHANGED
@@ -147,8 +147,8 @@
147
147
  - **「根据官网生成 Google 搜索广告 / 表格格式」**：仍属新建搜索系列 → **W3 + 本文件上条**；用户要的「表格」是 `google-ads-launch-plan-template.md` 对 JSON 的投影，**不是**可跳过 JSON 的独立交付物。**仅出方案**时可先交付 JSON+表格（跳过 validate）；**创建前**必须 `campaign-validate`。**禁止**与 P8 网站诊断、P9 市场分析、W5 仅拓词混用；**禁止**因缺账户 ID 拒出方案。
148
148
  - **Excel/表格投放方案 → 创建广告**：必读 `references/google-ads/rules/google-ads-plan-source-fidelity.md`。Agent **写代码**直接转成 campaign-create JSON；地域用 **`ad geo resolve`**；**禁止**对话手填完整 JSON、**禁止**编造 geo id；有方案匹配类型时勿压成一律 BROAD。**方案不合规时必须询问**：「您自己改还是我帮您改？」——**禁止**未问就静默改用户方案内容后 create。用户选「我帮您改」时：代改同步落盘变更账本；**创建完成后必出报告**（创建了哪些 + 从 xxx→xxx + 原因）。
149
149
  - **「行业分析 / 行业分析报告 / 生成 XX 行业报告」**（例：「帮我生成一份电商行业的行业分析报告」）→ **P9 战略市场分析**。**必须**先 `siluzan-tso market-analysis collect … --json-out`，再 WebSearch 补数据、写 `market-report.json`，最后 `market-analysis render` 出 HTML。**禁止**不调用 CLI、仅在对话里用 WebSearch 写 Markdown 充当终稿。**不是** `google-analysis`、**不是** P8 网站诊断。
150
- - **开户首次响应**：对话内首次进入开户话题时，**必须先**按 `references/accounts/open-account-by-media.md` §「首次响应硬规范」输出**完整必填清单**（未指明媒体则列全平台六表），再收集资料；**禁止**未列清单就执行 `open-account` 或零散追问。
151
- - **Google 开户**：`open-account google-wizard` 仅限真实 TTY；Agent/自动化用非交互 `open-account google ...`，审核进度用 `account-history`。
150
+ - **开户首次响应**：对话内首次进入开户话题时，**必须先**按 `references/accounts/open-account-by-media.md` §「首次响应硬规范」输出**完整必填业务清单**（未指明媒体则列全平台六媒体业务项），再收集资料；**禁止**未列清单就执行 `open-account` 或零散追问。清单**只写业务项与说明**；**禁止**向用户展示 `--flag` / CLI 选项名 / 命令行参数列（参数仅 Agent 内部组命令用）。
151
+ - **Google 开户**：`open-account google-wizard` 仅限真实 TTY；Agent/自动化用非交互 `open-account google ...`，审核进度用 `account-history`；对用户话术仍只用业务语言。
152
152
  - **主动更新**：详见 `references/core/setup.md`。
153
153
 
154
154
  ---
@@ -225,7 +225,8 @@
225
225
  | 单户按日 Excel | `stats … --by-day --json-out`（P4-DAILY） | 默认 `stats` 当按日 |
226
226
  | 多账户 × 多维度 Google 数据 | 全量：`google-analysis-batch run`（省略 `-a`）；2~10：`google-analysis -a id1,id2,...` | 外层 for-loop；先 list 再拼 `-a` |
227
227
  | 多系列诊断 | `ad campaigns --json-out` + node 读文件过滤 | 逐系列 `ad campaign-get` |
228
- | 单日预算熔断 / 当日花费比日预算 | `ad campaigns --start <当日> --end <当日>`（**start=end**）后再比 `spend` 与 `budget` | 用默认近 7 天窗口的 `spend` 对比日预算 |
228
+ | 单日预算熔断 / 空耗熔断（全户 Google） | `guard budget-circuit` / `guard zero-conv -m Google --json-out`（见 `operations/guard.md`） | 六媒体 `list-accounts` + 逐户 `ad campaigns`/`ad groups` for-loop；`ad campaigns -m`（非法） |
229
+ | 单户当日花费比日预算 | `ad campaigns -a <id> --start <当日> --end <当日>`（**start=end**）后再比 `spend` 与 `budget` | 用默认近 7 天窗口的 `spend` 对比日预算 |
229
230
 
230
231
  **消耗口径（自动化必读）**：凡 `--start`/`--end` 读命令的 `spend` = **闭区间合计**，默认近 7 天 ≠ 一天。日均用 `balance-scan.dailySpend` 或 `合计÷天数`；详见 `references/operations/hosted-automation-self-control.md`「检查项常用 JSON 字段」。
231
232
 
@@ -333,6 +334,7 @@
333
334
  ### 14.5 禁止事项（机械感）
334
335
 
335
336
  - 禁止把 playbook 编号、CLI 命令名、JSON 字段名当对用户主回复。
337
+ - **禁止向用户展示任何 CLI 选项 / 命令行参数名**（如 `--company`、`--promotion-link`、`--json-out`）及完整 ``siluzan-tso …`` 命令块；开户/查数清单只用业务项与说明。CLI 参数仅 Agent 内部组命令时使用。
336
338
  - 禁止无结论的数据堆砌；禁止空泛「建议优化」而无数字/对象名。
337
339
  - 禁止冷冰冰系统提示语气而不给下一步。
338
340
  - 禁止用户未要求时输出冗长「执行计划」清单；尽快进入执行。
package/dist/skill/references/core/setup.md CHANGED
@@ -10,7 +10,7 @@
10
10
  ## 安装 CLI
11
11
 
12
12
  ```bash
13
- npm install -g siluzan-tso-cli
13
+ npm install -g siluzan-tso-cli@beta
14
14
  ```
15
15
 
16
16
  ---
@@ -63,7 +63,7 @@ siluzan-tso config set --api-key <Key> # 或 config 直接写入
63
63
  siluzan-tso config set --token <Token> # 备用：设置 JWT Token
64
64
  ```
65
65
 
66
- API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
66
+ API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
67
67
 
68
68
  ```bash
69
69
  # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -126,9 +126,9 @@ siluzan-tso config show
126
126
 
127
127
  ```
128
128
  构建环境 : production
129
- apiBaseUrl : https://tso-api.siluzan.com
130
- googleApiUrl : https://googleapi.mysiluzan.com
131
- webUrl : https://www.siluzan.com
129
+ apiBaseUrl : https://tso-api-ci.siluzan.com
130
+ googleApiUrl : https://googleapi-ci.mysiluzan.com
131
+ webUrl : https://www-ci.siluzan.com
132
132
  apiKey : abcd****1234
133
133
  ```
134
134
 
package/dist/skill/references/core/workflows.md CHANGED
@@ -36,9 +36,9 @@
36
36
  ## W2 · 开户申请（Google / TikTok / Yandex / BingV2 / Kwai / MetaAd）
37
37
 
38
38
  - **触发**：申请开户、新开广告账户、查开户进度。
39
- - **必读**：`references/accounts/open-account-by-media.md`（各媒体必填项与参数，**含 §「首次响应硬规范」：首次进入开户话题必须先列全必填清单**）；Google 字段加 `references/accounts/open-account-google-ui.md`。所有媒体均**无需**手动查 magKey，CLI 按公司名自动创建/关联广告主组。
39
+ - **必读**：`references/accounts/open-account-by-media.md`（各媒体必填业务项，**含 §「首次响应硬规范」：首次进入开户话题必须先列全必填清单；对用户禁止展示 CLI 参数名**）；Google 字段加 `references/accounts/open-account-google-ui.md`。所有媒体均**无需**手动查 magKey，CLI 按公司名自动创建/关联广告主组。
40
40
  - **步骤**：
41
- 1. 列出必填项 → 收集资料（TikTok/Bing/Kwai 需营业执照图片本地路径；CLI 无 OCR）。
41
+ 1. 用业务语言列出必填项（勿贴 `--flag`）→ 收集资料（TikTok/Bing/Kwai 需营业执照图片本地路径；CLI 无 OCR）。
42
42
  2. 前置查询（按需）：TikTok `open-account tiktok-areas/-industries/-timezones`；Bing `open-account bing-industries`；Google `open-account google-timezones`。
43
43
  3. 提交非交互命令 `open-account <media> …`（**禁用** `google-wizard`，需真实 TTY）。MetaAd 无表单，用 `open-account meta` 拉官方 OE 链接引导网页。
44
44
  4. 轮询审核：`account-history -m <媒体>`。
@@ -204,10 +204,11 @@
204
204
  ## W12 · 日 / 周巡检
205
205
 
206
206
  - **触发**：日常/每周快速了解各媒体余额、消耗、预警与报告/智投状态。
207
- - **必读**：`references/accounts/accounts-balance-stats.md`；首页看板口径见 `references/misc/tso-home.md`。
207
+ - **必读**：`references/accounts/accounts-balance-stats.md`；首页看板口径见 `references/misc/tso-home.md`。超预算/空耗熔断另读 `references/operations/guard.md`。
208
208
  - **步骤**：
209
209
  1. 余额：`list-accounts -m <媒体> --json-out ./snap` → `balance -m <媒体> -a <mediaCustomerId,...>`（多户续航预警走 **P2**）。
210
210
  2. 消耗：`stats -m <媒体> -a <id> --start <昨天/上周一> --end <昨天/上周日>`（多户汇总走 **P3**）。
211
- 3. 预警触发：`forewarning records -m <媒体> --start <S>`（见 **W10**）。
212
- 4. 智投/线索（按需）：`ad batch list --state Failed/HasFailed`（**W4**）、`clue …`（**W11**）、`optimize list/records`（**W6**）。
213
- - **产物**：要与网页首页看板数字完全一致（聚合口径）时引导打开首页（`tso-home.md`）；CLI 给的是单账户粒度的近似巡检。
211
+ 3. Google 当日超预算/空耗熔断（若用户要求）：`guard budget-circuit` / `guard zero-conv -m Google --json-out`（**禁止**逐户 for-loop）。
212
+ 4. 预警触发：`forewarning records -m <媒体> --start <S>`（见 **W10**）。
213
+ 5. 智投/线索（按需）：`ad batch list --state Failed/HasFailed`（**W4**）、`clue …`（**W11**）、`optimize list/records`（**W6**）。
214
+ - **产物**：要与网页首页看板数字完全一致（聚合口径）时引导打开首页（`tso-home.md`）；CLI 给的是单账户粒度的近似巡检；熔断任务须交付命中表或显式「无命中」。
package/dist/skill/references/misc/tso-home.md CHANGED
@@ -6,7 +6,7 @@
6
6
  siluzan-tso config show # 取 webUrl
7
7
  ```
8
8
 
9
- 首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
9
+ 首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
10
10
 
11
11
  ---
12
12
 
@@ -25,7 +25,7 @@ siluzan-tso config show # 取 webUrl
25
25
 
26
26
  ## 推荐话术
27
27
 
28
- 1. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/v3/foreign_trade/tso/home`。
28
+ 1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
29
29
  2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
30
30
  3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。
31
31
 
package/dist/skill/references/operations/guard.md ADDED
@@ -0,0 +1,94 @@
1
+ # guard —— Google 全户熔断扫描
2
+
3
+ > 流程见 `hosted-automation-user-catalog.md`（预算/空耗自控）。单户排障仍可用 `ad campaigns` / `ad groups`。
4
+ > **仅 Google**。非 Google 媒体本 CLI 无系列/组/创意暂停写能力。
5
+
6
+ ## Contents
7
+
8
+ - 何时用
9
+ - budget-circuit（超预算）
10
+ - zero-conv（空耗）
11
+ - 输出与交付
12
+ - 与旧编排对照
13
+
14
+ ---
15
+
16
+ ## 何时用
17
+
18
+ | 用户话术 | 命令 |
19
+ | -------- | ---- |
20
+ | 所有账户系列当日花费 ≥ 日预算 110% → 暂停 | `guard budget-circuit` |
21
+ | 空耗熔断：花 ≥ 目标 CPA × N 且转化 0 → 暂停组/创意 | `guard zero-conv` |
22
+ | 只查某一户 / 改预算后复核单系列 | 仍用 `ad campaigns -a … --start=--end` |
23
+
24
+ **禁止**外层 for-loop：`list-accounts` × 多媒体再逐户 `ad campaigns` 做全户熔断。
25
+
26
+ ---
27
+
28
+ ## budget-circuit（超预算）
29
+
30
+ ```bash
31
+ siluzan-tso guard budget-circuit -m Google \
32
+ [--date YYYY-MM-DD] [--ratio 1.1] [-a id1,id2] \
33
+ --json-out ./snap-guard
34
+
35
+ # 确认命中后暂停（须全局 --commit）
36
+ siluzan-tso guard budget-circuit -m Google --date 2026-07-28 --ratio 1.1 \
37
+ --apply --json-out ./snap-guard --commit "budget-circuit 2026-07-28"
38
+ ```
39
+
40
+ | 选项 | 说明 |
41
+ | ---- | ---- |
42
+ | `-m Google` | 必填；其它媒体 exit 1 |
43
+ | `-a` | 子集 mediaCustomerId；省略则扫名下全部 Google 户 |
44
+ | `--date` | 统计日；默认 Asia/Shanghai 今天；**强制当日 spend**（start=end） |
45
+ | `--ratio` | 默认 `1.1`（建议 1.10–1.20） |
46
+ | `--status` | 默认只查 `Enabled`；传 `*` 不过滤 |
47
+ | `--apply` | 默认 dry-run；加此旗才 `Paused` |
48
+ | `--json-out` | Agent 必带 |
49
+
50
+ 命中条件：`budget > 0` 且 `spend >= budget * ratio`（`budget`/`spend` 均为元；`spend` 为该日合计）。
51
+
52
+ ---
53
+
54
+ ## zero-conv（空耗）
55
+
56
+ ```bash
57
+ siluzan-tso guard zero-conv -m Google \
58
+ [--date YYYY-MM-DD] [--cpa-multiple 3] [--level adgroup|ad|both] \
59
+ [--fallback-target-cpa <元>] \
60
+ --json-out ./snap-guard
61
+
62
+ siluzan-tso guard zero-conv -m Google --cpa-multiple 3 --apply \
63
+ --json-out ./snap-guard --commit "zero-conv 空耗熔断"
64
+ ```
65
+
66
+ | 选项 | 说明 |
67
+ | ---- | ---- |
68
+ | `--cpa-multiple` | 默认 `3` |
69
+ | `--level` | 默认 `adgroup`；`ad`/`both` 需 `--fallback-target-cpa`（创意无组级 CPA 字段） |
70
+ | `--fallback-target-cpa` | 组无 `targetCpaAmountYuan` 时回退；缺失则进 `skipped[]` |
71
+ | `--apply` / `--json-out` | 同 budget-circuit |
72
+
73
+ 命中：`conversions === 0` 且 `spend >= targetCpaYuan * N`。`summary.label` 固定为 **「空耗熔断」**（宿主发 P1 时用此文案；CLI 不代发通知）。
74
+
75
+ ---
76
+
77
+ ## 输出与交付
78
+
79
+ - 落盘 section：`guard-budget-circuit` / `guard-zero-conv`
80
+ - 字段：`meta`、`summary`、`hits[]`、`paused[]`、`errors[]`（zero-conv 另有 `skipped[]`）
81
+ - stdout：一行摘要 JSON（若 `--json-out`）+ **人类可读命中表**（无命中也打印「无命中」——巡检必须收口）
82
+ - dry-run 命中后提示追加 `--apply --commit …`
83
+
84
+ 恢复：人工加预算 / 改出价后，用 `ad campaign-status|adgroup-status|ad-status … --status Enabled`（或网页），**禁止**无人值守自动恢复。
85
+
86
+ ---
87
+
88
+ ## 与旧编排对照
89
+
90
+ | 旧（易失败） | 新 |
91
+ | ------------ | -- |
92
+ | 6 媒体 list-accounts → 逐户 ad campaigns → 脚本比 budget | `guard budget-circuit -m Google` |
93
+ | 逐户 ad groups + 手写阈值 | `guard zero-conv -m Google` |
94
+ | `ad campaigns -m Google`（非法） | 单户用 `-a`；全户熔断用 `guard` |