siluzan-tso-cli 1.1.39 → 1.1.40-beta.2
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.
- package/README.md +2 -1
- package/dist/index.js +926 -194
- package/dist/skill/SKILL.md +4 -3
- package/dist/skill/_meta.json +2 -2
- package/dist/skill/references/accounts/accounts-list.md +1 -1
- package/dist/skill/references/accounts/accounts-permissions.md +2 -2
- package/dist/skill/references/accounts/finance.md +1 -1
- package/dist/skill/references/accounts/open-account-by-media.md +72 -68
- package/dist/skill/references/accounts/open-account-google-ui.md +30 -27
- package/dist/skill/references/analytics/rag.md +1 -1
- package/dist/skill/references/analytics/reporting.md +5 -5
- package/dist/skill/references/analytics/website-diagnosis-guide.md +2 -0
- package/dist/skill/references/core/agent-conventions.md +5 -3
- package/dist/skill/references/core/intent-routing.md +10 -7
- package/dist/skill/references/core/playbooks.md +2 -1
- package/dist/skill/references/core/setup.md +5 -5
- package/dist/skill/references/core/workflows.md +7 -6
- package/dist/skill/references/misc/tso-home.md +2 -2
- package/dist/skill/references/operations/forewarning.md +2 -0
- package/dist/skill/references/operations/guard.md +94 -0
- package/dist/skill/references/operations/hosted-automation-self-control.md +35 -15
- package/dist/skill/references/operations/hosted-automation-user-catalog.md +5 -5
- package/dist/skill/references/report-templates/bing-period-report.md +3 -3
- package/dist/skill/references/report-templates/google-period-report.md +1 -1
- package/dist/skill/references/report-templates/meta-account-diagnosis-report.md +1 -1
- package/dist/skill/references/report-templates/meta-period-report.md +2 -2
- package/dist/skill/references/report-templates/tiktok-period-report.md +1 -1
- package/dist/skill/report-templates/bing-period-report.md +3 -3
- package/dist/skill/report-templates/google-period-report.md +1 -1
- package/dist/skill/report-templates/meta-account-diagnosis-report.md +1 -1
- package/dist/skill/report-templates/meta-period-report.md +2 -2
- package/dist/skill/report-templates/tiktok-period-report.md +1 -1
- package/dist/skill/scripts/install.ps1 +3 -3
- package/dist/skill/scripts/install.sh +3 -3
- package/eval/cases/guard-budget-circuit-all-google.scenario.json +25 -0
- package/eval/cases/guard-zero-conv-empty-spend.scenario.json +21 -0
- package/eval/cases/ir-p8-meets-google-ads-requirements-with-url.scenario.json +39 -0
- package/eval/stub-fixtures/guard-budget-circuit.json +36 -0
- package/eval/stub-fixtures/guard-zero-conv.json +41 -0
- package/package.json +1 -1
package/dist/skill/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: siluzan-tso
|
|
3
|
-
description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill
|
|
3
|
+
description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网+诊断/检测/监测/评估/体检/报告/符合投放要求/能不能投（含「网络诊断」混说）→P8 website-diagnosis collect（禁纯WebFetch/肉眼看页），禁止P9/P1/W3、禁止A/B/C/D追问；细则见 intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类话术→必走P9 market-analysis collect+render出HTML，禁止纯WebSearch/WebFetch在对话里写Markdown/HTML当终稿、禁止改走P8/P1/P4/W5/google-analysis；细则见 references/core/intent-routing.md §零·B。【§零·C·关键词规划】Google Ads/谷歌广告拓词、关键词规划/推荐、Keyword Planner、长尾关键词、月搜索量/搜索量、竞争度、核心词/种子词扩词（含「阅读网址/文章/页面后针对核心词出带搜索量词表」，无论是否提及丝路赞/TSO/账户）→必走W5 keyword -k … --google-only --json-out，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/campaign JSON→W3；仅要词表+搜索量/竞争度→W5；平台优化报告列表/推送→W7；对象仍不清→Read intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、六大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】Google搜索系列方案与 campaign-validate/create（W3）、系列/组/广告/关键词 CRUD/拒审、PMax 创建与素材、AI智投草稿 batch（W4）、拓词 keyword -k（W5）、AI广告优化 optimize（W6）、优化合规 SOP。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
|
|
4
4
|
license: MIT
|
|
5
5
|
compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
|
|
6
6
|
metadata:
|
|
@@ -90,7 +90,7 @@ siluzan-tso -h
|
|
|
90
90
|
| 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |
|
|
91
91
|
| OKKI 周报 | **P6** | `report-templates/okki-weekly-google-client.md` |
|
|
92
92
|
| Google 询盘分析（**须 CRM 询盘资料**；口语零询盘/CPA → **P3**） | **P7** | `report-templates/google-inquiry-analysis.md` + `references/analytics/geo-continents.json` |
|
|
93
|
-
| 网址/域名/官网 +
|
|
93
|
+
| 网址/域名/官网 + 诊断·检测·监测·报告 / **是否符合广告投放要求** / 能不能投 | **P8** | `references/core/intent-routing.md` §零 + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必** `website-diagnosis collect`；**≠ P9 ≠ W3**；禁纯 WebFetch） |
|
|
94
94
|
| 市场/行业分析报告 / 战略市场 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（须 collect+render；**≠ P8**） |
|
|
95
95
|
| TSO 平台优化报告：列表/生成/推送 | W7 | `references/analytics/reporting.md` |
|
|
96
96
|
| RAG 知识库检索 | W5 | `references/analytics/rag.md` |
|
|
@@ -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
|
-
|
|
|
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
|
@@ -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
|
---
|
|
@@ -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
|
```
|
|
@@ -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
|
| ------------------------- | --------------------- | ------------------------------------------- |
|
|
@@ -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
|
-
|
|
32
|
+
**对用户清单只写**：业务项含义、格式/枚举（如「b2b / b2c / app」）、是否需本地文件路径。
|
|
33
|
+
**禁止**在对用户回复中出现：`--flag`、CLI 选项名、命令行参数列、``siluzan-tso …`` 完整命令块、本文件「Agent 参数」列内容。
|
|
34
|
+
CLI 参数仅供 Agent **内部**组命令使用（见下表第三列）。用户补齐后再确认并提交；写入前仍须用户确认（见 `references/core/agent-conventions.md`）。
|
|
33
35
|
|
|
34
|
-
只有Google开户时需要询问用户账户币种（USD|CNY
|
|
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
|
-
| 业务项 |
|
|
57
|
-
| -------- |
|
|
58
|
-
| 公司名称 | `--company`
|
|
59
|
-
| 推广链接 | `--promotion-link`
|
|
60
|
-
| 推广类型 |
|
|
61
|
-
| 账户名称 | `--account-name`
|
|
62
|
-
| 币种 |
|
|
63
|
-
| 时区 | `--timezone`
|
|
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
|
-
| 业务项 |
|
|
69
|
-
| ------------ |
|
|
70
|
-
| 公司名称 |
|
|
71
|
-
| 账户名称 | `--account-name` |
|
|
72
|
-
| 时区 | `--timezone` |
|
|
73
|
-
| 行业 ID | `--industry-id` |
|
|
74
|
-
| 注册地 |
|
|
75
|
-
| 推广链接 | `--promotion-link` |
|
|
76
|
-
| 执照编号 | `--license-no` |
|
|
77
|
-
| 执照图片 |
|
|
78
|
-
| 法人姓名 | `--representative-name` |
|
|
79
|
-
| 法人身份证 | `--representative-id` |
|
|
80
|
-
| 法人银联账号 | `--unionpay-account` |
|
|
81
|
-
| 法人手机 | `--representative-phone` |
|
|
82
|
-
| 币种 | 只支持USD
|
|
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
|
-
| 业务项 |
|
|
87
|
-
| ------------ |
|
|
88
|
-
| 公司名称 | `--company`
|
|
89
|
-
| 联系邮箱 | `--email`
|
|
90
|
-
| 税号 TIN/INN |
|
|
90
|
+
| 业务项 | 说明 | Agent 参数（勿展示） |
|
|
91
|
+
| ------------ | ------------------------ | -------------------- |
|
|
92
|
+
| 公司名称 | | `--company` |
|
|
93
|
+
| 联系邮箱 | | `--email` |
|
|
94
|
+
| 税号 TIN/INN | 类型固定 `FOREIGN_LEGAL` | `--tin` |
|
|
91
95
|
|
|
92
96
|
### BingV2（`open-account bing`，需营业执照图片）
|
|
93
97
|
|
|
94
|
-
| 业务项 |
|
|
95
|
-
| ---------- |
|
|
96
|
-
| 直接/代理 |
|
|
97
|
-
| 广告主全称 | `--advertiser-name` |
|
|
98
|
-
| 公司简称 | `--name-short` |
|
|
99
|
-
| 开户名称 | `--name-remark-list` |
|
|
100
|
-
| 省份 | `--province` |
|
|
101
|
-
| 城市 | `--city` |
|
|
102
|
-
| 详细地址 | `--address` |
|
|
103
|
-
| 邮编 | `--postcode` |
|
|
104
|
-
| 行业 | `--trade-id` |
|
|
105
|
-
| 推广链接 | `--promotion-link` |
|
|
106
|
-
| 执照图片 |
|
|
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
|
-
| 业务项 |
|
|
111
|
-
| ------------- |
|
|
112
|
-
| 营业执照号 | `--licence-id` |
|
|
113
|
-
| 注册国家 | `--licence-country` |
|
|
114
|
-
| 注册地址 | `--licence-location` |
|
|
115
|
-
| 营业范围 | `--business-scope` |
|
|
116
|
-
| 产品/品牌名 | `--product` |
|
|
117
|
-
| 账户类型 |
|
|
118
|
-
| 产品网址 | `--product-url` |
|
|
119
|
-
| 执照/证件类型 |
|
|
120
|
-
| 账户名称 | `--account-name` |
|
|
121
|
-
| 公司主体名 | `--company-name` |
|
|
122
|
-
| 一级行业 ID | `--industry-id1` |
|
|
123
|
-
| 二级行业 ID | `--industry-id2` |
|
|
124
|
-
| 有效期类型 |
|
|
125
|
-
| 投放地区 |
|
|
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
|
|
|
@@ -1,38 +1,41 @@
|
|
|
1
1
|
## 一、开户流程（五步语义）
|
|
2
2
|
|
|
3
|
-
| 步骤 | 含义 |
|
|
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
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
|
21
|
-
|
|
|
22
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
27
|
-
|
|
|
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
|
-
|
|
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
|
|
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
|
| ------------------------------- | ---------- |
|
|
@@ -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
|
```
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
> **CLI 负责拉数**；**6 模块 × 29 子项评分**由 Agent 按规则 + 采集数据生成 JSON。
|
|
5
5
|
> **最终交付**：与线上一致，为**一份可浏览器打开、含 ECharts 图表的单文件 HTML 报告**（雷达图、模块得分条形图、Lighthouse 对比图等）。**用户未指定格式时默认交付 HTML**；Skill/CLI **Agent 只写诊断 JSON，HTML 一律由 `website-diagnosis render` 生成**（禁止 Agent 手写 HTML，禁止仅 Markdown/JSON 充当终稿）。
|
|
6
6
|
|
|
7
|
+
> **硬约束（100% CLI）**：凡 P8（含「诊断网站 / 是否符合广告投放要求 / 能不能投」+ URL），**必须**执行 `siluzan-tso website-diagnosis collect`（及后续 prepare/render）。**禁止**仅用 WebFetch / 浏览器打开官网 / 通用搜索写「是否符合 Google 广告」结论当交付。
|
|
8
|
+
|
|
7
9
|
---
|
|
8
10
|
|
|
9
11
|
## CLI 命令
|
|
@@ -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`
|
|
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
|
-
| 单日预算熔断 /
|
|
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
|
- 禁止用户未要求时输出冗长「执行计划」清单；尽快进入执行。
|
|
@@ -39,13 +39,15 @@
|
|
|
39
39
|
| 报告向 | **报告**、**分析报告**、**诊断报告**、**检测报告**、**监测报告**、**评估报告**、**质量报告** |
|
|
40
40
|
| 网站/网络混用 | **网站诊断**、**网络诊断**、**网站检测**、**网络检测**、**网站监测**、**网络监测**、**网站分析**、**网络分析**、**网站体检**、**网络体检**、**网站评分**、**网络质量** |
|
|
41
41
|
| 落地页 | **落地页诊断**、**落地页检测**、**落地页报告**、**页面质量**、**页面检测** |
|
|
42
|
-
| 投放前 |
|
|
42
|
+
| 投放前 | **能不能投**、**适不适合投广告**、**符合广告投放要求**、**是否符合投放要求**、**符不符合 Google 广告**、**适不适合投 Google 广告**、**网站好不好**、**官网行不行**、Lighthouse、PageSpeed、**速度检测**（**且带网址**） |
|
|
43
43
|
|
|
44
|
-
### 0.3 命中后的 Agent
|
|
44
|
+
### 0.3 命中后的 Agent 行为（强制，100% 走 CLI）
|
|
45
45
|
|
|
46
46
|
1. **直接定工作流 P8** → Read `playbooks.md` P8 + `website-diagnosis-guide.md`。
|
|
47
|
-
2.
|
|
48
|
-
3.
|
|
47
|
+
2. **必走 CLI 闭环**：`siluzan-tso website-diagnosis collect --url <url> --json-out ./snap-web --include-html` → `prepare` → 按 rules 补全 `diagnosis.json` → `website-diagnosis render` 出 HTML。
|
|
48
|
+
3. **有 URL 就开工**：缺 URL 才问一句「请发完整网址」；**禁止**因用户说「网络」而非「网站」改走 P9 或账户诊断。
|
|
49
|
+
4. **提到「Google 广告」仍是 P8**：只要诉求是「能不能投 / 是否符合投放要求 / 适不适合投」而**没有**「生成搜索广告方案 / 关键词表 / campaign JSON」，**禁止**改走 W3，也**禁止**用 WebFetch/WebSearch 肉眼看官网写结论代替 CLI。
|
|
50
|
+
5. **唯一例外（仍不是 P8）**：用户**同时**明确要求 **生成 Google 搜索广告 / 关键词表 / 投放方案 / 广告文案**（W3 强意图）→ 走 **W3**，见 §四。
|
|
49
51
|
|
|
50
52
|
### 0.4 示例（全部 → P8，不再消歧）
|
|
51
53
|
|
|
@@ -56,6 +58,7 @@
|
|
|
56
58
|
| 「这个**官网**做个**检测**」 | **P8**（先追问 URL 若未给出完整链接） |
|
|
57
59
|
| 「**域名** xxx.cn **监测报告**」 | **P8** |
|
|
58
60
|
| 「**落地页** **分析一下**能不能投」 | **P8** |
|
|
61
|
+
| 「请诊断网站 **https://www.siluzan.com** 是否符合 **Google 广告投放要求**」 | **P8**（必 `website-diagnosis`；≠ W3） |
|
|
59
62
|
|
|
60
63
|
---
|
|
61
64
|
|
|
@@ -233,8 +236,8 @@
|
|
|
233
236
|
|
|
234
237
|
| 用户侧重点 | 正确工作流 | 典型错误 |
|
|
235
238
|
| ------------------------------------------------------------------ | --------------- | ------------------------------------- |
|
|
236
|
-
| **有网址** + 诊断/检测/监测/报告（含说「**网络**」） | **P8（§零）** | 误走 P9「行业/网络分析」、P1
|
|
237
|
-
| 「这个**网站**好不好 /
|
|
239
|
+
| **有网址** + 诊断/检测/监测/报告（含说「**网络**」） | **P8（§零）** | 误走 P9「行业/网络分析」、P1 账户诊断；或纯 WebFetch 不跑 CLI |
|
|
240
|
+
| 「这个**网站**好不好 / 能不能投 / **是否符合投放要求**」（无广告方案诉求） | **P8** | 误走 W3（因带「Google 广告」）；或 WebFetch 当终稿 |
|
|
238
241
|
| 「**电商/制造**行业怎么样 / 市场格局」（**无 URL**） | **P9** | 误走 P8 |
|
|
239
242
|
| 「根据**官网**做 **Google 搜索广告** / 关键词表」 | **W3**（可无账户先出方案） | 误走 P8；或卡在要账户才出方案 |
|
|
240
243
|
| 「读**网址/文章** + **核心词** + 要 **月搜索量/竞争度** 长尾词表」 | **W5（§零·C）** | 纯 WebSearch 编数；误走 P8/P9/W3 |
|
|
@@ -255,7 +258,7 @@
|
|
|
255
258
|
|
|
256
259
|
| 用户话术（含子串即可） | 工作流 | 备注 |
|
|
257
260
|
| ----------------------------------------------------------------------------------------------------------------- | --------------- | ---------------------------------------------- |
|
|
258
|
-
| **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 /
|
|
261
|
+
| **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 / 报告 / 符合投放要求 / 能不能投**（含「网络诊断」「网络检测」） | **P8** | 与 **§零** 同义；**优先 §零**；必 `website-diagnosis` CLI |
|
|
259
262
|
| `OKKI 周报` / `okki 周报` / `使用 okki 周报模板` | **P6** | **不按 P4 默认 8 维** |
|
|
260
263
|
| `Google 账户询盘分析` / `分析 … Google 账号的询盘效果`（**且有询盘附件/字段表**） | **P7** | 严格 3 个月窗口；无 CRM → 改 **§零·D / P3** |
|
|
261
264
|
| `转化成本监控` / `CPA 监控` / `谷歌ADS转化成本` / `低余额账户转化成本` | **P3（§零·D）** | `accounts-digest`；可加 `--max-cpa` |
|
|
@@ -156,7 +156,8 @@
|
|
|
156
156
|
|
|
157
157
|
## P8 · 网站诊断
|
|
158
158
|
|
|
159
|
-
- **触发**：对某 URL
|
|
159
|
+
- **触发**：对某 URL 做网站/落地页诊断、投放前网站评分；话术含「网站诊断/检测/监测/质量**报告**」「落地页报告」「官网体检」「**是否符合（Google）广告投放要求**」「**能不能投 / 适不适合投广告**」（**非** Google 账户诊断、**非** 行业报告、**非** 生成搜索广告方案）。同义词见 `intent-routing.md` §零 / §二 P8。
|
|
160
|
+
- **典型误路由**：用户说「诊断网站 https://… 是否符合 Google 广告投放要求」→ **仍是 P8**；须 `website-diagnosis collect --url …`，**禁止**因带「Google 广告」改走 W3，**禁止**只用 WebFetch/浏览器肉眼看页写结论。
|
|
160
161
|
- **必读**：`references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `report-templates/website-diagnosis-report.md`。
|
|
161
162
|
- **默认产物**：**HTML**（`website-diagnosis render`）；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。
|
|
162
163
|
- **步骤**：
|
|
@@ -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
|
|
|
@@ -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
|
|
39
|
+
- **必读**：`references/accounts/open-account-by-media.md`（各媒体必填业务项，**含 §「首次响应硬规范」：首次进入开户话题必须先列全必填清单；对用户禁止展示 CLI 参数名**）；Google 字段加 `references/accounts/open-account-google-ui.md`。所有媒体均**无需**手动查 magKey，CLI 按公司名自动创建/关联广告主组。
|
|
40
40
|
- **步骤**：
|
|
41
|
-
1.
|
|
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.
|
|
212
|
-
4.
|
|
213
|
-
|
|
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 给的是单账户粒度的近似巡检；熔断任务须交付命中表或显式「无命中」。
|