siluzan-tso-cli 1.1.30-beta.8 → 1.1.30-beta.9

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 CHANGED
@@ -51,7 +51,7 @@ 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`。
54
+ > **注意**:当前为测试版(1.1.30-beta.9),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
55
55
 
56
56
  | 助手 | 建议 `--ai` |
57
57
  | ----------------------- | ------------------------------------ |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: siluzan-tso
3
- description: 丝路赞 TSO 广告平台(Google/Bing/Yandex/TikTok/Kwai/MetaAd),凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理须加载本 skill。【报告/诊断消歧】用户说报告/诊断/分析/检测/监测/月报时禁止默认某一 CLI——先识别对象:URL→P8 website-diagnosis(网站诊断·检测·监测/落地页报告);行业/市场/战略→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 references/core/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。
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`**,按 §一 三步协议定 **唯一** 工作流后再执行 CLI。**禁止**见「报告」就默认 P4 周期或 P1 诊断。
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 三步法**:① 报告/分析类若话术模糊,先 Read `references/core/intent-routing.md` → ② 在下方路由表锁定**唯一**工作流行 → ③ Read 该行「必读文档」与工作流卡片 → ④ 按卡片**编号步骤**执行,写操作前先与用户确认。
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`。**用户只说「报告 / 诊断 / 分析 / 检测 / 监测」且对象不清** → 必须先 Read `references/core/intent-routing.md`(P1–P9 与 W3/W7 统一消歧)。下表每行指向**唯一**工作流;找不到时查 `references/README.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
- | 网站诊断 / **网站诊断·检测·监测报告** / 落地页报告 / 网站质量评分 / 官网体检(**要 URL**) | **P8** | `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`(**必须先** `website-diagnosis collect` + `render`,**默认交付 HTML**;**≠ P9 ≠ W3**) |
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` |
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.30-beta.8",
4
- "publishedAt": 1782442092875
3
+ "version": "1.1.30-beta.9",
4
+ "publishedAt": 1782460163509
5
5
  }
@@ -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
- ### 1. 提取信号(按优先级,命中即停)
12
-
13
- | 优先级 | 信号类型 | 规则 |
14
- | ------ | -------- | ---- |
15
- | **S0 魔法短语** | 固定话术 | §三「魔法短语表」—— 命中则**直接**定工作流,不再追问 |
16
- | **S1 强否定** | 互斥词 | 见 §四「互斥矩阵」—— 排除错误工作流 |
17
- | **S2 强肯定** | 实体 / 对象 | §二「对象 → 工作流」—— 账户 ID、URL、行业名、媒体、OKKI/询盘等 |
18
- | **S3 弱关键词** | 同义词 | 见 §二「用户说法 → 工作流」—— **单独出现「报告」不算** |
19
- | **S4 缺参** | 信息不足 | 走 §五「一次追问模板」,**最多 1 个二选一**,禁止连问多个问题 |
20
-
21
- ### 2. 锁定唯一工作流
22
-
23
- - 每个用户任务对应 **一个** P* 或 W* 编号(见 `playbooks.md` / `workflows.md`)。
24
- - **禁止**因用户说「报告」就默认 P4 周期报告或 P1 账户诊断。
25
-
26
- ### 3. Read 卡片 → 执行 CLI
27
-
28
- - Read 该编号工作流卡片 + 路由表「必读文档」。
29
- - 分析 / 报告类一律 `--json-out` + 脚本读盘(见 `agent-conventions.md`)。
30
- - 默认 HTML 交付的工作流:**禁止**用 Markdown 长文或 WebSearch 代替 CLI `render` 终稿(P8 / P9 / P1 诊断 / P4-FB 等)。
31
-
32
- ---
33
-
34
- ## 二、对象 → 工作流 · 用户说法同义词表
35
-
36
- > **读法**:先找「用户主要在问什么对象」,再查同义词;对象冲突时按 §四互斥矩阵 + §五追问。
37
-
38
- | 工作流 | 用户在问什么(对象) | 常见说法(含错字 / 口语) | 最小必填 | 默认交付 |
39
- | ------ | -------------------- | ------------------------- | -------- | -------- |
40
- | **P8** | **单个网站 / 落地页 / URL** 的质量 | 网站诊断、**网站诊断报告**、**网站检测报告**、**网站监测报告**、落地页报告、网站质量报告、网站评分、官网体检、Lighthouse、投放前网站检查 | **URL**(`https://` 可省略) | HTML(`website-diagnosis render`) |
41
- | **P9** | **行业 / 市场 / 战略**(可带客户名) | 市场分析、**行业分析**、**行业分析报告**、市场调查报告、战略市场报告、KA 市场报告、竞品/GTM、「写一份 **XX 行业** 报告」(电商/制造/医疗…) | 客户名 / 网站 / 行业 / 核心产品 **至少一项** | HTML(`market-analysis render`) |
42
- | **P1** | **单个 Google 广告账户** 的投放健康 / 诊断 | Google 广告诊断、账户诊断报告、投放诊断、账户健康检查、账户体检、广告账户分析报告、账户画像(**且含 Google 账户 ID 或明确单户**) | 账户 ID + 统计区间 | HTML(`google-ads-diagnosis render`) |
43
- | **P4** | **单个媒体广告账户** 某区间的 **周期汇总** | 周期报告、月度报告、季度报告、月报、投放月报、Google 账户报告(**未强调「诊断/健康/网站」**) | 媒体 + 账户 ID + 区间 | HTML(默认);用户要 Excel 见 P4 excel 纲要 |
44
- | **P4-FB** | **Meta/Facebook 账户** 周期或诊断 | Facebook 报告、Meta 月报、FB 账户诊断报告 | Meta 账户 ID + 区间 | HTML(`facebook-analysis render`) |
45
- | **P6** | **OKKI 周报**(固定客户模板) | 见 §三魔法短语 | 账户 ID + 区间 | 多 Sheet xlsx |
46
- | **P7** | **Google 账户 + 询盘** 效果 | 见 §三魔法短语 | 账户 + 分析月 + 询盘资料 | 8 Sheet xlsx |
47
- | **P3** | **多个广告账户** 消耗对比 | 多账户对比、多户汇总报告、账户消耗排名 | 媒体 + 账户列表或全量 + 区间 | 表格 / 话术 |
48
- | **P2** | **多账户余额** 续航预警 | 余额扫描、快没钱了、充值预警 | 媒体(可选账户子集) | 列表 |
49
- | **P5** | **多账户 × 多维度** 批拉 | 批量分析、多户 google-analysis | ≥2 户 + ≥2 维度 + 区间 | 聚合报告 |
50
- | **W3** | 根据 **官网 / URL 生成 Google 搜索广告方案** | 根据网站出广告、搜索广告方案/计划/文案/关键词**表**、投放方案表格 | 官网 URL + 预算/地域等(缺则追问) | JSON + 表格投影 |
51
- | **W7** | **丝路赞平台内** 已生成的优化报告 / 推送 | Siluzan 优化报告列表、报告推送、邮件推送配置 | 按 `reporting.md` | 平台侧列表 |
52
-
53
- ### P8 vs P9 vs W3(最高频误路由)
54
-
55
- | 用户侧重点 | 正确工作流 | 典型错误 |
56
- | ---------- | ---------- | -------- |
57
- | 「这个**网站**好不好 / 能不能投」 | **P8** | 误走 P9 行业报告、W3 出广告 |
58
- | 「**电商/制造**行业怎么样 / 市场格局」 | **P9** | 误走 P8、误走 P4 账户周期 |
59
- | 「根据**官网**做 **Google 搜索广告** / 关键词表」 | **W3** | 误走 P8 只诊断不出方案 |
60
-
61
- ### P1 vs P4 vs P8(「报告」三字歧义)
62
-
63
- | 用户侧重点 | 正确工作流 |
64
- | ---------- | ---------- |
65
- | 给了 **Google 账户 ID**,要健康/诊断/优化建议 | **P1**(`google-ads-diagnosis`) |
66
- | 给了 **账户 ID**,要某月/某季 **投放数据汇总** | **P4** |
67
- | 给了 **URL**,要网站/落地页质量 | **P8** |
68
- | 只给 **行业名**,要行业分析 | **P9** |
69
-
70
- ---
71
-
72
- ## 三、魔法短语表(S0:命中直接定工作流)
73
-
74
- | 用户话术(含子串即可) | 工作流 | 备注 |
75
- | ---------------------- | ------ | ---- |
76
- | `OKKI 周报` / `okki 周报` / `使用 okki 周报模板` | **P6** | **不按 P4 默认 8 维** |
77
- | `Google 账户询盘分析` / `分析 … Google 账号的询盘效果` / 同时含「询盘 + Google + 账户」 | **P7** | 严格 3 个月窗口 |
78
- | `根据 生成 Google **搜索**广告` / `搜索广告方案` / `关键词表` + 官网 URL | **W3** | P8 ≠ P9 |
79
- | `丝路赞` / `Siluzan` + `优化报告列表` / `报告推送` | **W7** | 自拉数 P1/P4 |
80
-
81
- ---
82
-
83
- ## 四、互斥矩阵(S1:见到 A 则禁止选 B)
84
-
85
- | 若用户明确… | 禁止误选 |
86
- | ----------- | -------- |
87
- | **URL / 官网 / 落地页**(且未要求「生成搜索广告方案」) | P9、P4、P1、W5 |
88
- | **XX 行业 / 市场分析 / 战略**(且无账户 ID 主诉求) | P8、P1、P4、W3 |
89
- | **Google 账户 ID / 消耗 / 系列 / 关键词**(且无 URL 主诉求) | P8、P9 |
90
- | **生成搜索广告 / 投放方案 / 关键词表** | P8、P9、P5 |
91
- | **OKKI** | P4 默认周期 |
92
- | **询盘** + Google 账户 | P4、P1 简版诊断 |
93
- | **WebSearch 写行业长文** | 代替 P9 `collect`+`render` |
94
- | 仅 **Markdown 摘要** | 代替 P8/P9/P1 的 HTML `render` |
95
-
96
- ---
97
-
98
- ## 五、一次追问模板(S4:只允许 1 个问题)
99
-
100
- 用户**只说**「帮我出份报告 / 做个诊断 / 分析一下」且 S0–S3 均无法定工作流时,用下面 **四选一**(选最省事的 1 条):
101
-
102
- > 您要的更像是哪一种?回复 **A/B/C/D** 即可:
103
- > **A** — **网站/落地页**质量报告(需要发我 **网址**)→ P8
104
- > **B** **行业/市场**战略报告(需要 **行业或客户名**)→ P9
105
- > **C** **Google 广告账户**诊断或周期报告(需要 **账户 ID**)→ P1 或 P4
106
- > **D** — 根据官网 **生成 Google 搜索广告方案**(需要 **网址 + 预算/地域**)→ W3
107
-
108
- 若用户已隐含答案(例如同时给了 URL 和「网站检测」),**禁止**再追问,直接 P8
109
-
110
- ---
111
-
112
- ## 六、各工作流缺参时的补参话术(定工作流后)
113
-
114
- | 工作流 | 缺什么 | Agent 怎么说(示例) |
115
- | ------ | ------ | -------------------- |
116
- | P8 | URL | 「网站诊断需要完整网址,请发官网链接。」 |
117
- | P9 | 四选一全空 | 「请给行业名(如电商)或客户名/网站/核心产品至少一项。」 |
118
- | P1 / P4 | 账户 ID | 「请提供 Google 广告账户 ID(mediaCustomerId)。」 |
119
- | P1 / P4 | 时间 | `agent-conventions.md` §五 反问区间 |
120
- | P6 | OKKI 话术 | 若用户实际要普通周期报告 P4 并说明 |
121
- | P7 | 无询盘文件 | 贴字段清单,**禁止编造询盘** |
122
- | W3 | 预算/地域 | 先列待确认项,再进入 campaign-plan 流水线 |
123
-
124
- ---
125
-
126
- ## 七、与 SKILL 路由表的对应
127
-
128
- | SKILL 路由表章节 | 本文件章节 |
129
- | ---------------- | ---------- |
130
- | 分析与报告(P1–P9) | §二、§三 |
131
- | Google 广告投放 W3 | §二 W3、§四 |
132
- | TSO 平台优化报告 W7 | §二 W7、§三 |
133
- | `agent-preamble.md` 消歧摘要 | 本文件 §二 P8/P9/W3 |
134
-
135
- **维护约定**:新增报告类工作流时,必须同步更新本文件 §二 一行 + §三(若有魔法短语)+ 可选 eval 场景(`eval/scenarios/intent-routing.ts`)。
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
+ | **生成搜索广告 / 投放方案 / 关键词表** | P8P9、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
+
@@ -9,7 +9,7 @@ $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-beta.8'
12
+ $PKG_VERSION = '1.1.30-beta.9'
13
13
  $CLI_BIN = 'siluzan-tso'
14
14
  $SKILL_LABEL = 'Siluzan TSO'
15
15
  $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
@@ -9,7 +9,7 @@ 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-beta.8"
12
+ readonly PKG_VERSION="1.1.30-beta.9"
13
13
  readonly CLI_BIN="siluzan-tso"
14
14
  readonly SKILL_LABEL="Siluzan TSO"
15
15
  readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.1.30-beta.8",
3
+ "version": "1.1.30-beta.9",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据,管理绑定关系与充值。",
5
5
  "keywords": [
6
6
  "ad-account",