siluzan-tso-cli 1.1.36 → 1.1.37-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 +2860 -746
- package/dist/skill/_meta.json +2 -2
- package/dist/skill/assets/google-period-report.schema.json +226 -0
- package/dist/skill/assets/pmax-create-template.md +7 -1
- 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/setup.md +5 -5
- package/dist/skill/references/misc/tso-home.md +2 -2
- package/dist/skill/references/report-templates/README.md +14 -14
- package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +23 -15
- package/dist/skill/references/report-templates/bing-period-report.md +89 -23
- package/dist/skill/references/report-templates/google-period-report.md +55 -5
- package/dist/skill/references/report-templates/meta-account-diagnosis-report.md +144 -16
- package/dist/skill/references/report-templates/tiktok-period-report.md +112 -7
- package/dist/skill/report-templates/README.md +14 -14
- package/dist/skill/report-templates/REPORT-WORKFLOW.md +23 -15
- package/dist/skill/report-templates/bing-period-report.html +1343 -0
- package/dist/skill/report-templates/bing-period-report.md +89 -23
- package/dist/skill/report-templates/google-period-report.html +1314 -0
- package/dist/skill/report-templates/google-period-report.md +55 -5
- package/dist/skill/report-templates/meta-account-diagnosis-report.html +1124 -0
- package/dist/skill/report-templates/meta-account-diagnosis-report.md +144 -16
- package/dist/skill/report-templates/tiktok-period-report.html +1111 -0
- package/dist/skill/report-templates/tiktok-period-report.md +112 -7
- package/dist/skill/scripts/install.ps1 +3 -3
- package/dist/skill/scripts/install.sh +3 -3
- package/package.json +1 -1
package/dist/skill/_meta.json
CHANGED
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "siluzan-tso/google-period-report.schema.json",
|
|
4
|
+
"title": "GooglePeriodReport",
|
|
5
|
+
"description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 8 默认维度；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative 字段，kpis/charts/tables 可省略由 --snapshot-dir 从 google-analysis 落盘快照自动合并。",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"required": ["meta", "narrative"],
|
|
8
|
+
"properties": {
|
|
9
|
+
"meta": {
|
|
10
|
+
"type": "object",
|
|
11
|
+
"description": "报告元信息",
|
|
12
|
+
"required": ["accountId"],
|
|
13
|
+
"properties": {
|
|
14
|
+
"accountId": { "type": "string" },
|
|
15
|
+
"accountName": { "type": "string" },
|
|
16
|
+
"startDate": { "type": "string", "format": "date" },
|
|
17
|
+
"endDate": { "type": "string", "format": "date" },
|
|
18
|
+
"currency": { "type": "string", "default": "CNY" },
|
|
19
|
+
"generatedAt": { "type": "string" }
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"kpis": {
|
|
23
|
+
"type": "object",
|
|
24
|
+
"description": "账户级 KPI（执行摘要 KPI 网格）；可省略，由 --snapshot-dir 从 overview 合并",
|
|
25
|
+
"properties": {
|
|
26
|
+
"cost": { "type": "number" },
|
|
27
|
+
"impressions": { "type": "number" },
|
|
28
|
+
"clicks": { "type": "number" },
|
|
29
|
+
"conversions": { "type": "number" },
|
|
30
|
+
"ctr": { "type": "number", "description": "0~1 小数" },
|
|
31
|
+
"averageCpc": { "type": "number" },
|
|
32
|
+
"costPerConversion": { "type": "number" },
|
|
33
|
+
"previousPeriod": {
|
|
34
|
+
"type": "object",
|
|
35
|
+
"description": "环比上期（用于 KPI 卡片环比箭头），可省略",
|
|
36
|
+
"properties": {
|
|
37
|
+
"cost": { "type": "number" },
|
|
38
|
+
"impressions": { "type": "number" },
|
|
39
|
+
"clicks": { "type": "number" },
|
|
40
|
+
"conversions": { "type": "number" },
|
|
41
|
+
"ctr": { "type": "number" },
|
|
42
|
+
"averageCpc": { "type": "number" },
|
|
43
|
+
"costPerConversion": { "type": "number" }
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
"charts": {
|
|
49
|
+
"type": "object",
|
|
50
|
+
"description": "图表数据；可省略，由 --snapshot-dir 从 daily-metrics 合并",
|
|
51
|
+
"properties": {
|
|
52
|
+
"dailyTrend": {
|
|
53
|
+
"type": "object",
|
|
54
|
+
"description": "每日投放趋势（daily-metrics）；金额/CPA 2 位小数，转化/点击整数",
|
|
55
|
+
"properties": {
|
|
56
|
+
"dates": { "type": "array", "items": { "type": "string" } },
|
|
57
|
+
"cost": { "type": "array", "items": { "type": "number" } },
|
|
58
|
+
"conversions": { "type": "array", "items": { "type": "number" } },
|
|
59
|
+
"cpa": { "type": "array", "items": { "type": "number" } }
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
"tables": {
|
|
65
|
+
"type": "object",
|
|
66
|
+
"description": "表格数据；可省略，由 --snapshot-dir 从对应 google-analysis section 合并",
|
|
67
|
+
"properties": {
|
|
68
|
+
"dimensionSummary": {
|
|
69
|
+
"type": "object",
|
|
70
|
+
"description": "周期汇总（dimension-summary）",
|
|
71
|
+
"properties": {
|
|
72
|
+
"cost": { "type": "number" },
|
|
73
|
+
"impressions": { "type": "number" },
|
|
74
|
+
"clicks": { "type": "number" },
|
|
75
|
+
"conversions": { "type": "number" },
|
|
76
|
+
"ctr": { "type": "number" },
|
|
77
|
+
"averageCpc": { "type": "number" },
|
|
78
|
+
"costPerConversion": { "type": "number" },
|
|
79
|
+
"searchImpressionShare": { "type": "number" },
|
|
80
|
+
"searchBudgetLostImpressionShare": { "type": "number" },
|
|
81
|
+
"searchRankLostImpressionShare": { "type": "number" }
|
|
82
|
+
}
|
|
83
|
+
},
|
|
84
|
+
"campaigns": { "$ref": "#/$defs/campaignRows" },
|
|
85
|
+
"devices": { "$ref": "#/$defs/deviceRows" },
|
|
86
|
+
"geographic": { "$ref": "#/$defs/geographicRows" },
|
|
87
|
+
"keywords": { "$ref": "#/$defs/keywordRows" }
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
"narrative": {
|
|
91
|
+
"type": "object",
|
|
92
|
+
"description": "Agent 必写的叙事字段（唯一由 Agent 产出的内容；render 会硬校验完整性）",
|
|
93
|
+
"required": ["executiveSummary", "sections", "recommendations"],
|
|
94
|
+
"properties": {
|
|
95
|
+
"executiveSummary": {
|
|
96
|
+
"type": "array",
|
|
97
|
+
"items": { "type": "string" },
|
|
98
|
+
"minItems": 1,
|
|
99
|
+
"description": "1～3 段执行摘要，概述本期消耗/转化/CTR/CPA 走势"
|
|
100
|
+
},
|
|
101
|
+
"sections": {
|
|
102
|
+
"type": "object",
|
|
103
|
+
"description": "7 个数据维度各自的分析+建议（对应报告 §1~§7）；每维度 analysis ≥2 条、suggestions ≥1 条",
|
|
104
|
+
"required": [
|
|
105
|
+
"overview",
|
|
106
|
+
"dailyTrend",
|
|
107
|
+
"dimensionSummary",
|
|
108
|
+
"campaigns",
|
|
109
|
+
"devices",
|
|
110
|
+
"geographic",
|
|
111
|
+
"keywords"
|
|
112
|
+
],
|
|
113
|
+
"properties": {
|
|
114
|
+
"overview": { "$ref": "#/$defs/sectionNarrative" },
|
|
115
|
+
"dailyTrend": { "$ref": "#/$defs/sectionNarrative" },
|
|
116
|
+
"dimensionSummary": { "$ref": "#/$defs/sectionNarrative" },
|
|
117
|
+
"campaigns": { "$ref": "#/$defs/sectionNarrative" },
|
|
118
|
+
"devices": { "$ref": "#/$defs/sectionNarrative" },
|
|
119
|
+
"geographic": { "$ref": "#/$defs/sectionNarrative" },
|
|
120
|
+
"keywords": { "$ref": "#/$defs/sectionNarrative" }
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
"recommendations": {
|
|
124
|
+
"type": "array",
|
|
125
|
+
"description": "报告 §8 优化建议；≥3 条，可跨维度综合",
|
|
126
|
+
"minItems": 3,
|
|
127
|
+
"items": {
|
|
128
|
+
"oneOf": [
|
|
129
|
+
{ "type": "string" },
|
|
130
|
+
{
|
|
131
|
+
"type": "object",
|
|
132
|
+
"required": ["content"],
|
|
133
|
+
"properties": {
|
|
134
|
+
"title": { "type": "string" },
|
|
135
|
+
"content": { "type": "string" }
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
]
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
},
|
|
144
|
+
"$defs": {
|
|
145
|
+
"sectionNarrative": {
|
|
146
|
+
"type": "object",
|
|
147
|
+
"required": ["analysis", "suggestions"],
|
|
148
|
+
"properties": {
|
|
149
|
+
"analysis": {
|
|
150
|
+
"type": "array",
|
|
151
|
+
"items": { "type": "string" },
|
|
152
|
+
"minItems": 2,
|
|
153
|
+
"description": "≥2 条，须写清现象 + 依据字段（如具体数字/系列名/国家名）"
|
|
154
|
+
},
|
|
155
|
+
"suggestions": {
|
|
156
|
+
"type": "array",
|
|
157
|
+
"items": { "type": "string" },
|
|
158
|
+
"minItems": 1,
|
|
159
|
+
"description": "≥1 条可执行建议，与 analysis 对应"
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
},
|
|
163
|
+
"campaignRow": {
|
|
164
|
+
"type": "object",
|
|
165
|
+
"properties": {
|
|
166
|
+
"campaignName": { "type": "string" },
|
|
167
|
+
"campaignStatusDisplay": { "type": "string", "description": "投放中/已暂停/已移除" },
|
|
168
|
+
"channelTypeV2": { "type": "string" },
|
|
169
|
+
"budgetAmountYuan": { "type": ["number", "null"] },
|
|
170
|
+
"spend": { "type": "number" },
|
|
171
|
+
"impressions": { "type": "number" },
|
|
172
|
+
"clicks": { "type": "number" },
|
|
173
|
+
"ctr": { "type": "number" },
|
|
174
|
+
"averageCpc": { "type": "number" },
|
|
175
|
+
"conversions": { "type": "number" },
|
|
176
|
+
"costPerConversion": { "type": "number" }
|
|
177
|
+
}
|
|
178
|
+
},
|
|
179
|
+
"campaignRows": { "type": "array", "items": { "$ref": "#/$defs/campaignRow" } },
|
|
180
|
+
"deviceRow": {
|
|
181
|
+
"type": "object",
|
|
182
|
+
"properties": {
|
|
183
|
+
"deviceType": { "type": "string" },
|
|
184
|
+
"spend": { "type": "number" },
|
|
185
|
+
"impressions": { "type": "number" },
|
|
186
|
+
"clicks": { "type": "number" },
|
|
187
|
+
"ctr": { "type": "number" },
|
|
188
|
+
"averageCpc": { "type": "number" },
|
|
189
|
+
"conversions": { "type": "number" },
|
|
190
|
+
"costPerConversion": { "type": "number" }
|
|
191
|
+
}
|
|
192
|
+
},
|
|
193
|
+
"deviceRows": { "type": "array", "items": { "$ref": "#/$defs/deviceRow" } },
|
|
194
|
+
"geographicRow": {
|
|
195
|
+
"type": "object",
|
|
196
|
+
"properties": {
|
|
197
|
+
"countryOrRegion": { "type": "string" },
|
|
198
|
+
"countryOrRegionZh": { "type": "string" },
|
|
199
|
+
"countryNameZh": { "type": "string" },
|
|
200
|
+
"spend": { "type": "number" },
|
|
201
|
+
"impressions": { "type": "number" },
|
|
202
|
+
"clicks": { "type": "number" },
|
|
203
|
+
"ctr": { "type": "number" },
|
|
204
|
+
"averageCpc": { "type": "number" },
|
|
205
|
+
"conversions": { "type": "number" },
|
|
206
|
+
"costPerConversion": { "type": "number" }
|
|
207
|
+
}
|
|
208
|
+
},
|
|
209
|
+
"geographicRows": { "type": "array", "items": { "$ref": "#/$defs/geographicRow" } },
|
|
210
|
+
"keywordRow": {
|
|
211
|
+
"type": "object",
|
|
212
|
+
"properties": {
|
|
213
|
+
"keyword": { "type": "string" },
|
|
214
|
+
"keywordMatchType": { "type": "string" },
|
|
215
|
+
"keywordMatchTypeZh": { "type": "string" },
|
|
216
|
+
"campaignName": { "type": "string" },
|
|
217
|
+
"spend": { "type": "number" },
|
|
218
|
+
"ctr": { "type": "number" },
|
|
219
|
+
"averageCpc": { "type": "number" },
|
|
220
|
+
"conversions": { "type": "number" },
|
|
221
|
+
"costPerConversion": { "type": "number" }
|
|
222
|
+
}
|
|
223
|
+
},
|
|
224
|
+
"keywordRows": { "type": "array", "items": { "$ref": "#/$defs/keywordRow" } }
|
|
225
|
+
}
|
|
226
|
+
}
|
|
@@ -95,7 +95,13 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
|
|
|
95
95
|
| 子字段 | 类型 | 说明 |
|
|
96
96
|
| -------------------- | -------- | ------------------------------------------------------------------------ |
|
|
97
97
|
| `callouts` | string[] | 宣传信息（CALLOUT），每条 ≤25 字符，各创建 1 个扩展 |
|
|
98
|
-
| `structuredSnippets` | object[] | `{ header, values }`；`values` 至少 3
|
|
98
|
+
| `structuredSnippets` | object[] | `{ header, values }`；`values` 至少 3 项、每项 ≤25 字符；`header` 须为 Google 英文枚举 |
|
|
99
|
+
|
|
100
|
+
**`structuredSnippets.header` 合法值（English，与网关 `structuredSnippetHeaders` 一致）**：
|
|
101
|
+
|
|
102
|
+
`Brands`, `Amenities`, `Styles`, `Types`, `Destinations`, `Services`, `Courses`, `Neighbourhoods`, `Shows`, `Insurance coverage`, `Degree programmes`, `Featured hotels`, `Models`
|
|
103
|
+
|
|
104
|
+
勿自创标头（如 `Industries`/`Highlights`/`Certifications`/`Product Types` 等会在挂载时 HTTP 400）。`pmax-validate` 会提前拦截。
|
|
99
105
|
| `leadForm` | object | 潜在客户表单；字段同 `pmax-lead-form-template.json` 的 `leadForm` |
|
|
100
106
|
| `businessMessage` | object | WhatsApp 私信；字段同 `pmax-whatsapp-template.json` 的 `businessMessage` |
|
|
101
107
|
|
|
@@ -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.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
|
|
283
|
+
| `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 当前没有对应充值界面） |
|
|
284
284
|
| `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |
|
|
285
285
|
|
|
286
286
|
---
|
|
@@ -909,7 +909,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
|
|
|
909
909
|
|
|
910
910
|
| 功能 | 媒体 | 网页路径 |
|
|
911
911
|
| --------------------------------------- | ------ | ------------------------------------------------- |
|
|
912
|
-
| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
|
|
912
|
+
| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
|
|
913
913
|
|
|
914
914
|
**Agent 建议话术**：
|
|
915
915
|
|
|
@@ -918,5 +918,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
|
|
|
918
918
|
siluzan-tso config show # 查看 webUrl 字段
|
|
919
919
|
|
|
920
920
|
# 账户激活（Google）→ 引导至账户管理页
|
|
921
|
-
# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
|
|
921
|
+
# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
|
|
922
922
|
```
|
|
@@ -117,7 +117,7 @@ siluzan-tso config show
|
|
|
117
117
|
|
|
118
118
|
### 充值页链接（按媒体 × 类型）
|
|
119
119
|
|
|
120
|
-
链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
|
|
120
|
+
链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.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.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
|
## 首次响应硬规范（必读）
|
|
@@ -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.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
|
|
63
|
+
# 审核通过后：config show → https://www-ci.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.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` |
|
|
195
|
+
| Google | 日报（Daily） | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
|
|
196
|
+
| Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
|
|
197
|
+
| TikTok | 日报 | `https://www-ci.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.siluzan.com
|
|
210
|
+
# webUrl: https://www-ci.siluzan.com
|
|
211
211
|
|
|
212
212
|
# 第三步：拼接链接（Google 日报）
|
|
213
|
-
# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
|
|
213
|
+
# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
|
|
214
214
|
```
|
|
@@ -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
|
---
|
|
@@ -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.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
|
|
67
|
+
API Key 获取入口：`https://www-ci.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.siluzan.com
|
|
133
|
-
googleApiUrl : https://googleapi.mysiluzan.com
|
|
134
|
-
webUrl : https://www.siluzan.com
|
|
132
|
+
apiBaseUrl : https://tso-api-ci.siluzan.com
|
|
133
|
+
googleApiUrl : https://googleapi-ci.mysiluzan.com
|
|
134
|
+
webUrl : https://www-ci.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.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
|
|
|
@@ -15,20 +15,20 @@
|
|
|
15
15
|
|
|
16
16
|
## 内容纲要文件
|
|
17
17
|
|
|
18
|
-
| 文件
|
|
19
|
-
|
|
|
20
|
-
| `google-period-report.md`
|
|
21
|
-
| `google-period-report-excel.md`
|
|
22
|
-
| `google-account-diagnosis-report.md`
|
|
23
|
-
| `google-ads-diagnosis.md`
|
|
24
|
-
| `meta-period-report.md` / `.html`
|
|
25
|
-
| `meta-period-report-excel.md`
|
|
26
|
-
| `meta-account-diagnosis-report.md`
|
|
27
|
-
| `tiktok-period-report.md`
|
|
28
|
-
| `bing-period-report.md`
|
|
29
|
-
| `okki-weekly-google-client.md`
|
|
30
|
-
| `google-inquiry-analysis.md`
|
|
31
|
-
| `website-diagnosis-report.md` / `.html`
|
|
18
|
+
| 文件 | 适用场景 |
|
|
19
|
+
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
20
|
+
| `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |
|
|
21
|
+
| `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |
|
|
22
|
+
| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |
|
|
23
|
+
| `google-ads-diagnosis.md` | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**） |
|
|
24
|
+
| `meta-period-report.md` / `.html` | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |
|
|
25
|
+
| `meta-period-report-excel.md` | **仅用户要 Excel 时**：5 Sheet xlsx 版式；Agent 脚本写表，无 CLI excel 子命令 |
|
|
26
|
+
| `meta-account-diagnosis-report.md` / `.html` | **Meta（Facebook）诊断报告（默认）**：四步流程 → `facebook-analysis diagnosis-render` 出 HTML（在 7 Section 内对齐 Google 诊断结构，未覆盖小节标 `notAvailable`） |
|
|
27
|
+
| `tiktok-period-report.md` / `.html` | **TikTok 广告主周期报告（默认）**：四步流程 → `tiktok-analysis render` 出 HTML |
|
|
28
|
+
| `bing-period-report.md` / `.html` | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML |
|
|
29
|
+
| `okki-weekly-google-client.md` | **OKKI 周报**：Google 发客户固定话术 + 精简维度 CLI；**Excel 仅 Agent 脚本**，见 `references/core/playbooks.md` P6 |
|
|
30
|
+
| `google-inquiry-analysis.md` | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |
|
|
31
|
+
| `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |
|
|
32
32
|
|
|
33
33
|
---
|
|
34
34
|
|
|
@@ -21,12 +21,12 @@
|
|
|
21
21
|
|
|
22
22
|
根据媒体与用户意图，选择 `report-templates/` 下对应的 `*.md`：
|
|
23
23
|
|
|
24
|
-
| 意图 | Google | Meta
|
|
25
|
-
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
|
|
26
|
-
| 周期分析 / 月报 / 周报 | `google-period-report.md` | `meta-period-report.md`
|
|
27
|
-
| OKKI 周报 / 固定话术发客户（Google） | `okki-weekly-google-client.md` | —
|
|
28
|
-
| **询盘分析** / 固定运营触发（Goog账户询盘分析 / 我给你询盘信息分析Google账号XXX效果） | `google-inquiry-analysis.md`（**严格 3 个月** + 用户上传询盘资料 + 8 Sheet xlsx；见 SKILL **P7**） | —
|
|
29
|
-
| 深度诊断 / 健康检查 | `google-account-diagnosis-report.md` | `meta-account-diagnosis-report.md` | 同周期，注明能力受限 | 同周期 |
|
|
24
|
+
| 意图 | Google | Meta | TikTok | Bing |
|
|
25
|
+
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------- | ----------------------- |
|
|
26
|
+
| 周期分析 / 月报 / 周报 | `google-period-report.md` | `meta-period-report.md` | `tiktok-period-report.md` | `bing-period-report.md` |
|
|
27
|
+
| OKKI 周报 / 固定话术发客户（Google） | `okki-weekly-google-client.md` | — | — | — |
|
|
28
|
+
| **询盘分析** / 固定运营触发（Goog账户询盘分析 / 我给你询盘信息分析Google账号XXX效果） | `google-inquiry-analysis.md`（**严格 3 个月** + 用户上传询盘资料 + 8 Sheet xlsx；见 SKILL **P7**） | — | — | — |
|
|
29
|
+
| 深度诊断 / 健康检查 | `google-account-diagnosis-report.md` | `meta-account-diagnosis-report.md`（`facebook-analysis diagnosis-render` 出 HTML） | 同周期，注明能力受限 | 同周期 |
|
|
30
30
|
|
|
31
31
|
无精确匹配时，用最接近媒体的同类 `*.md`，并在报告开头注明。
|
|
32
32
|
|
|
@@ -71,18 +71,26 @@
|
|
|
71
71
|
|
|
72
72
|
- 用 **node/python 脚本**读落盘 JSON，完成聚合与洞察（禁止 Read 业务 JSON、禁止对话手填数）。
|
|
73
73
|
- 按 `*.md` 章节结构组织叙事与建议；所有数字可追溯到 JSON 字段。
|
|
74
|
-
- **Meta/Facebook
|
|
75
|
-
- **
|
|
74
|
+
- **Meta/Facebook 周期**：产出 `meta-period-report.json`（见 `meta-period-report.md`）。
|
|
75
|
+
- **Meta/Facebook 诊断**：产出 `meta-account-diagnosis-report.json`（见 `meta-account-diagnosis-report.md`，`meta`/`kpis` 可由 `--snapshot-dir` 自动合并）。
|
|
76
|
+
- **Google 周期报告**：产出 `google-period-report.json`（见 `google-period-report.md`，仅 `meta` + `narrative` 为必填）。
|
|
77
|
+
- **TikTok 周期报告**：产出 `tiktok-period-report.json`（见 `tiktok-period-report.md`，`meta` 可由 `--snapshot-dir` 自动合并）。
|
|
78
|
+
- **Bing 周期报告**：产出 `bing-period-report.json`（见 `bing-period-report.md`，`meta`/`kpis` 可由 `--snapshot-dir` 自动合并）。
|
|
79
|
+
- **其余场景**（OKKI、询盘等未接入 render 的模板）：可直接组织 Markdown/HTML 正文。
|
|
76
80
|
|
|
77
81
|
### 步骤 5b：生成终稿（按媒体与格式）
|
|
78
82
|
|
|
79
|
-
| 媒体
|
|
80
|
-
|
|
|
81
|
-
| **Meta/Facebook
|
|
82
|
-
| **
|
|
83
|
-
|
|
|
84
|
-
|
|
85
|
-
|
|
83
|
+
| 媒体 | 用户未指定格式 | 用户指定 Excel |
|
|
84
|
+
| ------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
|
|
85
|
+
| **Meta/Facebook 周期** | `facebook-analysis render` → **HTML**（必做） | Agent 脚本按 `meta-period-report-excel.md` 写 xlsx；**不**默认 `render` |
|
|
86
|
+
| **Meta/Facebook 诊断** | `facebook-analysis diagnosis-render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `diagnosis-render` |
|
|
87
|
+
| **Google 周期报告** | `google-analysis render` → **HTML**（必做） | **周期/定制 Sheet**：`google-period-report-excel.md`（P4，先 outline 后脚本）；**不**默认 `render` |
|
|
88
|
+
| **TikTok 周期报告** | `tiktok-analysis render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `render` |
|
|
89
|
+
| **Bing 周期报告** | `bing-analysis render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `render` |
|
|
90
|
+
| **Google 诊断/OKKI/询盘** | 按 `report-template*.html` 写 HTML（默认 `report-template.html`） | **诊断**：同左；**OKKI**：P6；**询盘**：P7 |
|
|
91
|
+
| **网站诊断** | `website-diagnosis render` → HTML | — |
|
|
92
|
+
|
|
93
|
+
**禁止**：Meta / Google / TikTok / Bing 周期报告与 Meta 诊断报告默认只交 Markdown/JSON；禁止 Agent 手写以上报告 HTML。
|
|
86
94
|
|
|
87
95
|
**Google 广告诊断报告**（`google-ads-diagnosis.md` / `google-account-diagnosis-report.md`）额外必遵：
|
|
88
96
|
|