siluzan-tso-cli 1.1.30-beta.8 → 1.1.30
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 +1 -2
- package/dist/index.js +1 -1
- package/dist/skill/SKILL.md +5 -5
- package/dist/skill/_meta.json +2 -2
- package/dist/skill/references/accounts/accounts.md +3 -3
- package/dist/skill/references/accounts/finance.md +1 -1
- package/dist/skill/references/accounts/open-account-by-media.md +1 -1
- package/dist/skill/references/accounts/open-account-google-ui.md +1 -1
- package/dist/skill/references/analytics/rag.md +1 -1
- package/dist/skill/references/analytics/reporting.md +5 -5
- package/dist/skill/references/core/intent-routing.md +179 -135
- package/dist/skill/references/core/setup.md +5 -5
- package/dist/skill/references/misc/tso-home.md +2 -2
- package/dist/skill/scripts/install.ps1 +3 -3
- package/dist/skill/scripts/install.sh +3 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
|
|
|
43
43
|
在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
npm install -g siluzan-tso-cli
|
|
46
|
+
npm install -g siluzan-tso-cli
|
|
47
47
|
siluzan-tso init --ai cursor # 写入 Cursor（默认）
|
|
48
48
|
siluzan-tso init --ai cursor,claude # 同时写入多个平台
|
|
49
49
|
siluzan-tso init --ai all # 写入所有支持的平台
|
|
@@ -51,7 +51,6 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
|
|
|
51
51
|
siluzan-tso init --force # 强制覆盖已存在文件
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
> **注意**：当前为测试版（1.1.30-beta.8），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
55
54
|
|
|
56
55
|
| 助手 | 建议 `--ai` |
|
|
57
56
|
| ----------------------- | ------------------------------------ |
|
package/dist/index.js
CHANGED
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、投广告、出价预算、广告账户管理须加载本 skill
|
|
3
|
+
description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理须加载本 skill。【§零·最高优先】网址/域名/官网/链接/落地页+诊断/检测/监测/评估/体检/报告等词（含用户混说的「网络诊断/网络检测/网络监测」）→直接P8 website-diagnosis，禁止走P9行业分析或P1账户诊断、禁止A/B/C/D追问；细则见 references/core/intent-routing.md §零。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略→P9 market-analysis；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/关键词表→W3；平台优化报告列表/推送→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 suggest（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:
|
|
@@ -22,7 +22,7 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
|
|
|
22
22
|
|
|
23
23
|
> **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
|
|
24
24
|
>
|
|
25
|
-
> **报告 / 分析类统一消歧（必读）**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 月报 / 周报」等，或对象不清（只有「帮我出份报告」）→ **必须先 Read `references/core/intent-routing.md
|
|
25
|
+
> **报告 / 分析类统一消歧（必读）**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 月报 / 周报」等，或对象不清（只有「帮我出份报告」）→ **必须先 Read `references/core/intent-routing.md`**。**§零 优先**：**网址/域名/官网/链接 + 诊断类词**（含用户说的「网络诊断/网络检测」）→ **直接 P8**，禁止走 P9/P1；再按 §一 定唯一工作流。**禁止**见「报告」就默认 P4 周期或 P1 诊断。
|
|
26
26
|
>
|
|
27
27
|
> **默认交付格式**：用户未指定格式时，网站诊断 P8、Meta 周期 P4-FB、战略市场 P9、**Google 广告诊断 P1** 默认 **HTML**（各自 `render` 子命令），Google 周期 P4 默认 HTML；**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
|
|
28
28
|
|
|
@@ -53,13 +53,13 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
|
|
|
53
53
|
siluzan-tso -h # 查看帮助
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
**Agent 三步法**：①
|
|
56
|
+
**Agent 三步法**：① **网址+诊断类词（含「网络诊断」）→ 直接 P8**（`intent-routing.md` §零）；其余报告类若话术模糊，先 Read `references/core/intent-routing.md` → ② 在下方路由表锁定**唯一**工作流行 → ③ Read 该行「必读文档」与工作流卡片 → ④ 按卡片**编号步骤**执行，写操作前先与用户确认。
|
|
57
57
|
|
|
58
58
|
---
|
|
59
59
|
|
|
60
60
|
## 路由表（意图 → 工作流 → 必读文档）
|
|
61
61
|
|
|
62
|
-
> 首次进入任意任务前先 Read `references/core/agent-conventions.md`。**用户只说「报告 / 诊断 / 分析 / 检测 /
|
|
62
|
+
> 首次进入任意任务前先 Read `references/core/agent-conventions.md`。**网址/域名/官网 + 诊断/检测/监测/报告**（含「网络诊断」）→ **§零 直接 P8**，见 `references/core/intent-routing.md`。**用户只说「报告 / 诊断 / 分析 / 检测 / 监测」且对象仍不清** → 必须先 Read `intent-routing.md`（P1–P9 与 W3/W7 统一消歧）。下表每行指向**唯一**工作流；找不到时查 `references/README.md`。
|
|
63
63
|
|
|
64
64
|
### 账户与财务
|
|
65
65
|
|
|
@@ -101,7 +101,7 @@ siluzan-tso -h # 查看帮助
|
|
|
101
101
|
| 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |
|
|
102
102
|
| OKKI 周报 | **P6** | `references/report-templates/okki-weekly-google-client.md`（全文） |
|
|
103
103
|
| Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `references/analytics/geo-continents.json` |
|
|
104
|
-
|
|
|
104
|
+
| **网址/域名/官网/落地页** + 网站或**网络**诊断·检测·监测·评估·体检·质量报告 / 落地页报告 / 官网体检 | **P8** | `references/core/intent-routing.md` **§零** + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必须先** `website-diagnosis collect` + `render`，**默认交付 HTML**；**≠ P9 ≠ W3**） |
|
|
105
105
|
| 市场分析 / **行业分析** / **行业分析报告** / 市场调查 / 生成 **XX 行业** 报告（如电商）/ 战略市场报告 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**必须先** `market-analysis collect` + `render`，**默认交付 HTML**；**禁止**纯 WebSearch 交 Markdown 终稿；**≠ P8**） |
|
|
106
106
|
| TSO 平台优化报告：列表/生成/推送 | W7 | `references/analytics/reporting.md` |
|
|
107
107
|
| RAG 知识库检索 | W5 | `references/analytics/rag.md` |
|
package/dist/skill/_meta.json
CHANGED
|
@@ -280,7 +280,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
|
|
|
280
280
|
| 状态 | 含义 | 下一步操作 |
|
|
281
281
|
| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
282
282
|
| `Pending` | 审核中 | 等待，可反复运行此命令轮询；审核周期因媒体而异 |
|
|
283
|
-
| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www
|
|
283
|
+
| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
|
|
284
284
|
| `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |
|
|
285
285
|
|
|
286
286
|
---
|
|
@@ -854,7 +854,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
|
|
|
854
854
|
|
|
855
855
|
| 功能 | 媒体 | 网页路径 |
|
|
856
856
|
| --------------------------------------- | ------ | ------------------------------------------------- |
|
|
857
|
-
| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www
|
|
857
|
+
| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
|
|
858
858
|
|
|
859
859
|
**Agent 建议话术**：
|
|
860
860
|
|
|
@@ -863,5 +863,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
|
|
|
863
863
|
siluzan-tso config show # 查看 webUrl 字段
|
|
864
864
|
|
|
865
865
|
# 账户激活（Google）→ 引导至账户管理页
|
|
866
|
-
# https://www
|
|
866
|
+
# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
|
|
867
867
|
```
|
|
@@ -117,7 +117,7 @@ siluzan-tso config show
|
|
|
117
117
|
|
|
118
118
|
### 充值页链接（按媒体 × 类型）
|
|
119
119
|
|
|
120
|
-
链接模式：`https://www
|
|
120
|
+
链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
|
|
121
121
|
|
|
122
122
|
| 充值类型 | `<page>` | 支持媒体（`mediaType` 参数） |
|
|
123
123
|
| ------------------------- | --------------------- | ------------------------------------------- |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 各媒体开户
|
|
2
2
|
|
|
3
|
-
> 网页链接：`https://www
|
|
3
|
+
> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
|
|
4
4
|
> 多命令串联见 `references/core/workflows.md` § 流程一。
|
|
5
5
|
|
|
6
6
|
## 首次响应硬规范（必读）
|
|
@@ -60,7 +60,7 @@ siluzan-tso open-account google-wizard
|
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
62
|
siluzan-tso account-history -m Google
|
|
63
|
-
# 审核通过后：config show → https://www
|
|
63
|
+
# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
|
|
64
64
|
```
|
|
65
65
|
|
|
66
66
|
---
|
|
@@ -192,9 +192,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
|
|
|
192
192
|
|
|
193
193
|
| 媒体 | 报告类型 | URL 模板 |
|
|
194
194
|
| ------ | ---------------- | ----------------------------------------------------------- |
|
|
195
|
-
| Google | 日报（Daily） | `https://www
|
|
196
|
-
| Google | 小时报（Hourly） | `https://www
|
|
197
|
-
| TikTok | 日报 | `https://www
|
|
195
|
+
| Google | 日报（Daily） | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
|
|
196
|
+
| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
|
|
197
|
+
| TikTok | 日报 | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
|
|
198
198
|
|
|
199
199
|
`entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
|
|
200
200
|
|
|
@@ -207,8 +207,8 @@ siluzan-tso report list -m Google --json-out ./snap
|
|
|
207
207
|
|
|
208
208
|
# 第二步：查看 webUrl
|
|
209
209
|
siluzan-tso config show
|
|
210
|
-
# webUrl: https://www
|
|
210
|
+
# webUrl: https://www.siluzan.com
|
|
211
211
|
|
|
212
212
|
# 第三步：拼接链接（Google 日报）
|
|
213
|
-
# https://www
|
|
213
|
+
# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
|
|
214
214
|
```
|
|
@@ -1,135 +1,179 @@
|
|
|
1
|
-
# 报告 / 分析类意图路由（统一消歧）
|
|
2
|
-
|
|
3
|
-
> **何时必读**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 评估 / 体检 / 月报 / 周报」等**任一**词，且尚未明确对应 `SKILL.md` 路由表某一行时，**必须先 Read 本文件**，再 Read 对应工作流卡片（`playbooks.md` P*）与必读 reference。
|
|
4
|
-
>
|
|
5
|
-
> 本文件是 **P1–P9 及易混 W3/W7** 的**唯一消歧真相源**；`SKILL.md` 路由表、`agent-preamble.md` 只保留摘要，**细节以本文件为准**。
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
|
39
|
-
|
|
|
40
|
-
| **
|
|
41
|
-
|
|
|
42
|
-
|
|
|
43
|
-
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
| **
|
|
88
|
-
| **
|
|
89
|
-
| **
|
|
90
|
-
|
|
|
91
|
-
| **
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
|
129
|
-
|
|
|
130
|
-
|
|
|
131
|
-
|
|
|
132
|
-
|
|
|
133
|
-
|
|
|
134
|
-
|
|
135
|
-
|
|
1
|
+
# 报告 / 分析类意图路由（统一消歧）
|
|
2
|
+
|
|
3
|
+
> **何时必读**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 评估 / 体检 / 月报 / 周报」等**任一**词，且尚未明确对应 `SKILL.md` 路由表某一行时，**必须先 Read 本文件**，再 Read 对应工作流卡片（`playbooks.md` P*）与必读 reference。
|
|
4
|
+
>
|
|
5
|
+
> 本文件是 **P1–P9 及易混 W3/W7** 的**唯一消歧真相源**；`SKILL.md` 路由表、`agent-preamble.md` 只保留摘要，**细节以本文件为准**。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 零、强制规则：网址 + 诊断类词 → P8（**最高优先级，覆盖 §一 S0–S4**）
|
|
10
|
+
|
|
11
|
+
> 用户常把「**网站**」和「**网络**」混说（如「网络诊断」「网络检测报告」）。**不要纠正用户用词**，只要同时满足下面两类信号，**一律 P8 网站诊断**，禁止走 P9 行业报告、P1 账户诊断、P4 周期报告，**禁止** §五 A/B/C/D 追问。
|
|
12
|
+
|
|
13
|
+
### 0.1 网址类信号（命中任一即可）
|
|
14
|
+
|
|
15
|
+
- 可解析 URL：`http://` / `https://` / `www.` / 裸域名（`example.com`、`xxx.cn`）
|
|
16
|
+
- 口语：**网址**、**官网**、**域名**、**链接**、**落地页**、**网站地址**、**主页**、**网站链接**
|
|
17
|
+
- 用户粘贴的字符串**像域名或 URL**（含 `.com` / `.cn` / `.net` 等）
|
|
18
|
+
|
|
19
|
+
### 0.2 诊断类信号（近义词 / 同义词，命中任一即可）
|
|
20
|
+
|
|
21
|
+
| 类别 | 常见说法（含错字 / 口语） |
|
|
22
|
+
| ---- | ------------------------- |
|
|
23
|
+
| 核心 | **诊断**、**检测**、**监测**、**监控**、**评估**、**评测**、**体检**、**审查**、**核查** |
|
|
24
|
+
| 报告向 | **报告**、**分析报告**、**诊断报告**、**检测报告**、**监测报告**、**评估报告**、**质量报告** |
|
|
25
|
+
| 网站/网络混用 | **网站诊断**、**网络诊断**、**网站检测**、**网络检测**、**网站监测**、**网络监测**、**网站分析**、**网络分析**、**网站体检**、**网络体检**、**网站评分**、**网络质量** |
|
|
26
|
+
| 落地页 | **落地页诊断**、**落地页检测**、**落地页报告**、**页面质量**、**页面检测** |
|
|
27
|
+
| 投放前 | **能不能投**、**适不适合投广告**、**网站好不好**、**官网行不行**、Lighthouse、PageSpeed、**速度检测**（**且带网址**） |
|
|
28
|
+
|
|
29
|
+
### 0.3 命中后的 Agent 行为
|
|
30
|
+
|
|
31
|
+
1. **直接定工作流 P8** → Read `playbooks.md` P8 + `website-diagnosis-guide.md`。
|
|
32
|
+
2. **有 URL 就开工**：缺 URL 才问一句「请发完整网址」；**禁止**因用户说「网络」而非「网站」改走 P9 或账户诊断。
|
|
33
|
+
3. **唯一例外（仍不是 P8）**：用户**同时**明确要求 **生成 Google 搜索广告 / 关键词表 / 投放方案 / 广告文案**（W3 强意图）→ 走 **W3**，见 §四。
|
|
34
|
+
|
|
35
|
+
### 0.4 示例（全部 → P8，不再消歧）
|
|
36
|
+
|
|
37
|
+
| 用户说法 | 工作流 |
|
|
38
|
+
| -------- | ------ |
|
|
39
|
+
| 「帮我做一下 **www.xxx.com** 的**网络诊断**」 | **P8** |
|
|
40
|
+
| 「**https://a.com** **网站检测报告**」 | **P8** |
|
|
41
|
+
| 「这个**官网**做个**检测**」 | **P8**（先追问 URL 若未给出完整链接） |
|
|
42
|
+
| 「**域名** xxx.cn **监测报告**」 | **P8** |
|
|
43
|
+
| 「**落地页** **分析一下**能不能投」 | **P8** |
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 一、统一路由协议（§零 未命中时才走本段）
|
|
48
|
+
|
|
49
|
+
### 1. 提取信号（按优先级，命中即停）
|
|
50
|
+
|
|
51
|
+
| 优先级 | 信号类型 | 规则 |
|
|
52
|
+
| ------ | -------- | ---- |
|
|
53
|
+
| **§零** | 网址 + 诊断类词 | 见上文 — **强制 P8** |
|
|
54
|
+
| **S0 魔法短语** | 固定话术 | 见 §三「魔法短语表」—— 命中则**直接**定工作流，不再追问 |
|
|
55
|
+
| **S1 强否定** | 互斥词 | 见 §四「互斥矩阵」—— 排除错误工作流 |
|
|
56
|
+
| **S2 强肯定** | 实体 / 对象 | 见 §二「对象 → 工作流」—— 账户 ID、URL、行业名、媒体、OKKI/询盘等 |
|
|
57
|
+
| **S3 弱关键词** | 同义词 | 见 §二「用户说法 → 工作流」—— **单独出现「报告」不算** |
|
|
58
|
+
| **S4 缺参** | 信息不足 | 走 §五「一次追问模板」，**最多 1 个二选一**，禁止连问多个问题 |
|
|
59
|
+
|
|
60
|
+
### 2. 锁定唯一工作流
|
|
61
|
+
|
|
62
|
+
- 每个用户任务对应 **一个** P* 或 W* 编号（见 `playbooks.md` / `workflows.md`）。
|
|
63
|
+
- **禁止**因用户说「报告」就默认 P4 周期报告或 P1 账户诊断。
|
|
64
|
+
- **禁止**因用户说「网络诊断」就当成行业/网络基础设施分析（**不是 P9**）。
|
|
65
|
+
|
|
66
|
+
### 3. Read 卡片 → 执行 CLI
|
|
67
|
+
|
|
68
|
+
- Read 该编号工作流卡片 + 路由表「必读文档」。
|
|
69
|
+
- 分析 / 报告类一律 `--json-out` + 脚本读盘（见 `agent-conventions.md`）。
|
|
70
|
+
- 默认 HTML 交付的工作流：**禁止**用 Markdown 长文或 WebSearch 代替 CLI `render` 终稿（P8 / P9 / P1 诊断 / P4-FB 等）。
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 二、对象 → 工作流 · 用户说法同义词表
|
|
75
|
+
|
|
76
|
+
> **读法**：**先执行 §零**；未命中再按本表。对象冲突时按 §四互斥矩阵 + §五追问。
|
|
77
|
+
|
|
78
|
+
| 工作流 | 用户在问什么（对象） | 常见说法（含错字 / 口语） | 最小必填 | 默认交付 |
|
|
79
|
+
| ------ | -------------------- | ------------------------- | -------- | -------- |
|
|
80
|
+
| **P8** | **单个网站 / 落地页 / URL** 的质量 | 见 **§零**（含网站/网络混说）；另：官网体检、投放前网站检查 | **URL** | HTML（`website-diagnosis render`） |
|
|
81
|
+
| **P9** | **行业 / 市场 / 战略**（**无网址主诉求**） | 市场分析、**行业分析**、**行业分析报告**、市场调查报告、战略市场报告、KA 市场报告、竞品/GTM、「写一份 **XX 行业** 报告」（电商/制造/医疗…） | 客户名 / 行业 / 核心产品 **至少一项**（**不是** URL+诊断） | HTML（`market-analysis render`） |
|
|
82
|
+
| **P1** | **单个 Google 广告账户** 的投放健康 / 诊断 | Google **广告**诊断、**账户**诊断报告、投放诊断、**账户**健康检查、**账户**体检（**且含 Google 账户 ID**） | 账户 ID + 统计区间 | HTML（`google-ads-diagnosis render`） |
|
|
83
|
+
| **P4** | **单个媒体广告账户** 某区间的 **周期汇总** | 周期报告、月度报告、季度报告、月报、投放月报、Google 账户报告（**未强调「诊断/健康/网站/网址」**） | 媒体 + 账户 ID + 区间 | HTML（默认）；用户要 Excel 见 P4 excel 纲要 |
|
|
84
|
+
| **P4-FB** | **Meta/Facebook 账户** 周期或诊断 | Facebook 报告、Meta 月报、FB **账户**诊断报告 | Meta 账户 ID + 区间 | HTML（`facebook-analysis render`） |
|
|
85
|
+
| **P6** | **OKKI 周报**（固定客户模板） | 见 §三魔法短语 | 账户 ID + 区间 | 多 Sheet xlsx |
|
|
86
|
+
| **P7** | **Google 账户 + 询盘** 效果 | 见 §三魔法短语 | 账户 + 分析月 + 询盘资料 | 8 Sheet xlsx |
|
|
87
|
+
| **P3** | **多个广告账户** 消耗对比 | 多账户对比、多户汇总报告、账户消耗排名 | 媒体 + 账户列表或全量 + 区间 | 表格 / 话术 |
|
|
88
|
+
| **P2** | **多账户余额** 续航预警 | 余额扫描、快没钱了、充值预警 | 媒体（可选账户子集） | 列表 |
|
|
89
|
+
| **P5** | **多账户 × 多维度** 批拉 | 批量分析、多户 google-analysis | ≥2 户 + ≥2 维度 + 区间 | 聚合报告 |
|
|
90
|
+
| **W3** | 根据 **官网 / URL 生成 Google 搜索广告方案** | 根据网站**出广告**、搜索广告方案/计划/文案/关键词**表**、**生成**投放方案表格 | 官网 URL + **明确要广告方案** | JSON + 表格投影 |
|
|
91
|
+
| **W7** | **丝路赞平台内** 已生成的优化报告 / 推送 | Siluzan 优化报告列表、报告推送、邮件推送配置 | 按 `reporting.md` | 平台侧列表 |
|
|
92
|
+
|
|
93
|
+
### P8 vs P9 vs W3（最高频误路由）
|
|
94
|
+
|
|
95
|
+
| 用户侧重点 | 正确工作流 | 典型错误 |
|
|
96
|
+
| ---------- | ---------- | -------- |
|
|
97
|
+
| **有网址** + 诊断/检测/监测/报告（含说「**网络**」） | **P8（§零）** | 误走 P9「行业/网络分析」、P1 账户诊断 |
|
|
98
|
+
| 「这个**网站**好不好 / 能不能投」（无广告方案诉求） | **P8** | 误走 P9、W3 |
|
|
99
|
+
| 「**电商/制造**行业怎么样 / 市场格局」（**无 URL**） | **P9** | 误走 P8 |
|
|
100
|
+
| 「根据**官网**做 **Google 搜索广告** / 关键词表」 | **W3** | 误走 P8 只诊断不出方案 |
|
|
101
|
+
|
|
102
|
+
### P1 vs P4 vs P8（「报告」三字歧义）
|
|
103
|
+
|
|
104
|
+
| 用户侧重点 | 正确工作流 |
|
|
105
|
+
| ---------- | ---------- |
|
|
106
|
+
| 给了 **Google 账户 ID**，要健康/诊断/优化建议 | **P1**（`google-ads-diagnosis`） |
|
|
107
|
+
| 给了 **账户 ID**，要某月/某季 **投放数据汇总** | **P4** |
|
|
108
|
+
| 给了 **URL / 网址 / 域名** + 诊断类词（§零） | **P8** |
|
|
109
|
+
| 只给 **行业名**（无 URL），要行业分析 | **P9** |
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 三、魔法短语表（S0：命中直接定工作流）
|
|
114
|
+
|
|
115
|
+
| 用户话术（含子串即可） | 工作流 | 备注 |
|
|
116
|
+
| ---------------------- | ------ | ---- |
|
|
117
|
+
| **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 / 报告**（含「网络诊断」「网络检测」） | **P8** | 与 **§零** 同义；**优先 §零** |
|
|
118
|
+
| `OKKI 周报` / `okki 周报` / `使用 okki 周报模板` | **P6** | **不按 P4 默认 8 维** |
|
|
119
|
+
| `Google 账户询盘分析` / `分析 … Google 账号的询盘效果` / 同时含「询盘 + Google + 账户」 | **P7** | 严格 3 个月窗口 |
|
|
120
|
+
| `根据 … 生成 Google **搜索**广告` / `搜索广告方案` / `关键词表` + 官网 URL | **W3** | ≠ P8 ≠ P9 |
|
|
121
|
+
| `丝路赞` / `Siluzan` + `优化报告列表` / `报告推送` | **W7** | ≠ 自拉数 P1/P4 |
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 四、互斥矩阵（S1：见到 A 则禁止选 B）
|
|
126
|
+
|
|
127
|
+
| 若用户明确… | 禁止误选 |
|
|
128
|
+
| ----------- | -------- |
|
|
129
|
+
| **§零 命中**（网址 + 诊断类词） | P9、P1、P4、P2、P3、W5；**禁止**因「网络」二字改走 P9 |
|
|
130
|
+
| **URL / 官网 / 落地页 / 域名** + 诊断类词（且未要求「生成搜索广告方案」） | P9、P4、P1、W5 |
|
|
131
|
+
| **XX 行业 / 市场分析 / 战略**（**且无 URL + 诊断类词**） | P8、P1、P4、W3 |
|
|
132
|
+
| **Google 账户 ID / 消耗 / 系列 / 关键词**（**且无 URL + 诊断类词**） | P8、P9 |
|
|
133
|
+
| **生成搜索广告 / 投放方案 / 关键词表** | P8、P9、P5 |
|
|
134
|
+
| **OKKI** | P4 默认周期 |
|
|
135
|
+
| **询盘** + Google 账户 | P4、P1 简版诊断 |
|
|
136
|
+
| 仅 **WebSearch 写行业长文** | 代替 P9 `collect`+`render` |
|
|
137
|
+
| 仅 **Markdown 摘要** | 代替 P8/P9/P1 的 HTML `render` |
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 五、一次追问模板（S4：只允许 1 个问题）
|
|
142
|
+
|
|
143
|
+
用户**只说**「帮我出份报告 / 做个诊断 / 分析一下」且 **§零、S0–S3 均未命中** 时，用下面 **四选一**（选最省事的 1 条）：
|
|
144
|
+
|
|
145
|
+
> 您要的更像是哪一种？回复 **A/B/C/D** 即可：
|
|
146
|
+
> **A** — **网站/落地页**质量报告（需要发我 **网址**）→ P8
|
|
147
|
+
> **B** — **行业/市场**战略报告（需要 **行业或客户名**，**不是**网址检测）→ P9
|
|
148
|
+
> **C** — **Google 广告账户**诊断或周期报告（需要 **账户 ID**）→ P1 或 P4
|
|
149
|
+
> **D** — 根据官网 **生成 Google 搜索广告方案**（需要 **网址 + 预算/地域**）→ W3
|
|
150
|
+
|
|
151
|
+
**§零 已命中时禁止本段追问**（例如用户已给 URL 并说「网络诊断」→ 直接 P8）。
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## 六、各工作流缺参时的补参话术（定工作流后）
|
|
156
|
+
|
|
157
|
+
| 工作流 | 缺什么 | Agent 怎么说（示例） |
|
|
158
|
+
| ------ | ------ | -------------------- |
|
|
159
|
+
| P8 | URL | 「网站诊断需要完整网址，请发官网链接（`https://` 或域名均可）。」 |
|
|
160
|
+
| P9 | 四选一全空 | 「请给行业名（如电商）或客户名/核心产品至少一项。」 |
|
|
161
|
+
| P1 / P4 | 账户 ID | 「请提供 Google 广告账户 ID（mediaCustomerId）。」 |
|
|
162
|
+
| P1 / P4 | 时间 | 按 `agent-conventions.md` §五 反问区间 |
|
|
163
|
+
| P6 | 非 OKKI 话术 | 若用户实际要普通周期报告 → 改 P4 并说明 |
|
|
164
|
+
| P7 | 无询盘文件 | 贴字段清单，**禁止编造询盘** |
|
|
165
|
+
| W3 | 预算/地域 | 先列待确认项，再进入 campaign-plan 流水线 |
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
169
|
+
## 七、与 SKILL 路由表的对应
|
|
170
|
+
|
|
171
|
+
| SKILL 路由表章节 | 本文件章节 |
|
|
172
|
+
| ---------------- | ---------- |
|
|
173
|
+
| 分析与报告（P1–P9） | **§零**、§二、§三 |
|
|
174
|
+
| Google 广告投放 W3 | §二 W3、§四 |
|
|
175
|
+
| TSO 平台优化报告 W7 | §二 W7、§三 |
|
|
176
|
+
| `agent-preamble.md` 消歧摘要 | **§零** + §二 P8/P9/W3 段 |
|
|
177
|
+
|
|
178
|
+
**维护约定**：新增报告类工作流时，必须同步更新本文件 §二 一行 + §三（若有魔法短语）+ 可选 eval 场景（`eval/scenarios/intent-routing.ts`）。
|
|
179
|
+
|
|
@@ -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
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
---
|
|
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key> # 或 config 直接写入
|
|
|
64
64
|
siluzan-tso config set --token <Token> # 备用：设置 JWT Token
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
-
API Key 获取入口：`https://www
|
|
67
|
+
API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
|
|
68
68
|
|
|
69
69
|
```bash
|
|
70
70
|
# 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
|
|
@@ -129,9 +129,9 @@ siluzan-tso config show
|
|
|
129
129
|
|
|
130
130
|
```
|
|
131
131
|
构建环境 : production
|
|
132
|
-
apiBaseUrl : https://tso-api
|
|
133
|
-
googleApiUrl : https://googleapi
|
|
134
|
-
webUrl : https://www
|
|
132
|
+
apiBaseUrl : https://tso-api.siluzan.com
|
|
133
|
+
googleApiUrl : https://googleapi.mysiluzan.com
|
|
134
|
+
webUrl : https://www.siluzan.com
|
|
135
135
|
apiKey : abcd****1234
|
|
136
136
|
```
|
|
137
137
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
siluzan-tso config show # 取 webUrl
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
首页地址：`https://www
|
|
9
|
+
首页地址：`https://www.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
|
|
28
|
+
1. **「和首页一样的总览」** → 打开 `https://www.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
|
|
|
@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
|
|
|
9
9
|
# -- Package info (injected at build time) ------------------------------------
|
|
10
10
|
$PKG_NAME = 'siluzan-tso-cli'
|
|
11
11
|
# PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
|
|
12
|
-
$PKG_VERSION = '1.1.30
|
|
12
|
+
$PKG_VERSION = '1.1.30'
|
|
13
13
|
$CLI_BIN = 'siluzan-tso'
|
|
14
14
|
$SKILL_LABEL = 'Siluzan TSO'
|
|
15
|
-
$INSTALL_CMD = 'npm install -g siluzan-tso-cli
|
|
16
|
-
$WEB_BASE = 'https://www
|
|
15
|
+
$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
|
|
16
|
+
$WEB_BASE = 'https://www.siluzan.com'
|
|
17
17
|
|
|
18
18
|
# -- Constants ----------------------------------------------------------------
|
|
19
19
|
$NODE_MAJOR_MIN = 18
|
|
@@ -9,11 +9,11 @@ set -euo pipefail
|
|
|
9
9
|
# -- Package info (injected at build time) ------------------------------------
|
|
10
10
|
readonly PKG_NAME="siluzan-tso-cli"
|
|
11
11
|
# PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
|
|
12
|
-
readonly PKG_VERSION="1.1.30
|
|
12
|
+
readonly PKG_VERSION="1.1.30"
|
|
13
13
|
readonly CLI_BIN="siluzan-tso"
|
|
14
14
|
readonly SKILL_LABEL="Siluzan TSO"
|
|
15
|
-
readonly INSTALL_CMD="npm install -g siluzan-tso-cli
|
|
16
|
-
readonly WEB_BASE="https://www
|
|
15
|
+
readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
|
|
16
|
+
readonly WEB_BASE="https://www.siluzan.com"
|
|
17
17
|
|
|
18
18
|
# -- Constants ----------------------------------------------------------------
|
|
19
19
|
readonly NODE_MAJOR_MIN=18
|