siluzan-tso-cli 1.1.31 → 1.1.32-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/dist/index.js +1 -1
- 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/playbooks.md +2 -2
- 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/okki-weekly-google-client.md +47 -20
- package/dist/skill/report-templates/okki-weekly-google-client.md +47 -20
- package/dist/skill/scripts/install.ps1 +3 -3
- package/dist/skill/scripts/install.sh +3 -3
- package/dist/skill/snippets/handoff-p6-okki.md +1 -1
- 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@beta
|
|
47
47
|
siluzan-tso init --ai cursor # 写入 Cursor(默认)
|
|
48
48
|
siluzan-tso init --ai cursor,claude # 同时写入多个平台
|
|
49
49
|
siluzan-tso init --ai all # 写入所有支持的平台
|
|
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
|
|
|
51
51
|
siluzan-tso init --force # 强制覆盖已存在文件
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
+
> **注意**:当前为测试版(1.1.32-beta.1),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
54
55
|
|
|
55
56
|
| 助手 | 建议 `--ai` |
|
|
56
57
|
| ----------------------- | ------------------------------------ |
|
package/dist/index.js
CHANGED
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.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
|
---
|
|
@@ -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.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
|
|
857
|
+
| **账户激活**(邀请他人激活 / 充值激活) | Google | `https://www-ci.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.siluzan.com/v3/foreign_trade/tso/manageAccounts
|
|
866
|
+
# https://www-ci.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.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
|
```
|
|
@@ -121,8 +121,8 @@
|
|
|
121
121
|
1. (可选)Read `subagent-orchestration.md` § P6 决定是否分阶段委派。
|
|
122
122
|
2. 确认 `mediaCustomerId` 与 `--start` / `--end`。
|
|
123
123
|
3. 同一 `--json-out` 目录执行模板命令组合:`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched`。
|
|
124
|
-
4. 脚本读盘 →
|
|
125
|
-
- **交付/确认**:**不**按 P4 默认 8 维追加;金额读 `*Yuan`
|
|
124
|
+
4. 脚本读盘 → 按 `okki-weekly-google-client.md` **默认客户话术**填数交付(用户另有话术/增删条目时从其自定义);并产出多 Sheet `.xlsx`(无 CLI 写表命令)。
|
|
125
|
+
- **交付/确认**:**不**按 P4 默认 8 维追加;金额读 `*Yuan` 字段;对外话术数值须与 xlsx 一致。
|
|
126
126
|
|
|
127
127
|
---
|
|
128
128
|
|
|
@@ -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
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
> **媒体**:当前模板仅规范 **Google**(`mediaCustomerId`)。其他媒体用各自 `*-period-report.md`。
|
|
7
7
|
> **Excel 版式基准**:与运营样表《**数据复盘分析**》类 xlsx 对齐(如 `2025.12数据复盘分析.xlsx`);工作簿 5 个 Sheet、顺序与表头以下文规范为准。
|
|
8
8
|
|
|
9
|
-
识别到上述意图时:**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程;按本文**固定维度 +
|
|
9
|
+
识别到上述意图时:**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程;按本文**固定维度 + 默认客户话术(可用户自定义)**交付(数据全部来自 CLI 落盘 JSON,见 `references/analytics/account-analytics.md`)。
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -174,34 +174,61 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
174
174
|
|
|
175
175
|
---
|
|
176
176
|
|
|
177
|
-
##
|
|
177
|
+
## 对外客户话术(默认结构,填数来自 JSON)
|
|
178
178
|
|
|
179
|
-
|
|
179
|
+
> **默认**:用户未指定话术样式时,使用下方**默认模板**输出终稿。
|
|
180
|
+
> **用户自定义**:用户可(1)粘贴自有话术骨架;(2)要求增删改某几条(如「不要 5.1」「第 3 条改成…」);(3)指定 CTR 基准或币种展示方式。**自定义时仍须**:数值/百分比一律来自 CLI 落盘 JSON + 脚本计算,禁止编造;缺数据标 `[数据不可用:原因]`,不得留空占位符糊弄客户。
|
|
180
181
|
|
|
181
|
-
|
|
182
|
+
**日期写法(首行)**:`<S>` / `<E>` 转为中文可读,如 `4月1号-4月7号` 或 `2026年4月1日-4月7日`(与用户习惯一致即可,须与 `--start` / `--end` 对应)。
|
|
183
|
+
|
|
184
|
+
**默认模板**:
|
|
182
185
|
|
|
183
186
|
```
|
|
184
|
-
您好,同步一下谷歌<S>--<E
|
|
185
|
-
|
|
186
|
-
1
|
|
187
|
-
2
|
|
188
|
-
3
|
|
189
|
-
4
|
|
190
|
-
5
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
187
|
+
您好,同步一下谷歌<S>--<E>投放的情况:
|
|
188
|
+
|
|
189
|
+
1、消耗:共消耗<金额+币种>,平均每天消耗<金额+币种>;
|
|
190
|
+
2、展示点击:带来<曝光>个曝光,<点击>个点击;
|
|
191
|
+
3、点击率:<CTR%>,处于<优秀/正常/偏低>水平(搜索正常水平 3%~5%,展示正常水平 1%~2%;按账户实际以搜索或展示为主选基准,无法区分时写「整体」并说明依据)
|
|
192
|
+
4、平均点击单价:<金额+币种>
|
|
193
|
+
5、转化:记录到网站表单+会话询盘<N>个;直接写邮件咨询和 WhatsApp 咨询无法记录,需贵司自行统计后反馈具体咨询产品和国家,方便广告及时调整
|
|
194
|
+
5.1 有转化的关键词:<据 keywords / search-terms JSON 填写;无转化则写「本周期暂无带转化关键词」>
|
|
195
|
+
5.2 有转化的国家:<据 campaign-geo-matched JSON 填写;无转化则写「本周期暂无带转化国家/地区」>
|
|
196
|
+
6、优化建议:<据 campaigns / keywords / search-terms / device / geo JSON 撰写 3~5 条可执行建议,禁止编造数据>
|
|
197
|
+
7、账户余额:<金额+币种>(截至查询时点)
|
|
194
198
|
```
|
|
195
199
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
200
|
+
### 填数规则
|
|
201
|
+
|
|
202
|
+
| 条目 | 数据来源 / 计算 |
|
|
203
|
+
| ---- | ---------------- |
|
|
204
|
+
| 1 消耗 / 日均 | `stats` 或 `overview` 区间 `spend`;日均 = `总消耗 ÷ 区间日历天数`(含起止日),脚本计算 |
|
|
205
|
+
| 2 曝光 / 点击 | `stats` / `overview` 的 `impressions`、`clicks` |
|
|
206
|
+
| 3 点击率 | `overview.record.ctr` 或 `stats` 同级字段;已是 **0~1 小数**,话术 `(ctr * 100).toFixed(2) + "%"`,**禁止**直接打印得到 `0.10%` |
|
|
207
|
+
| 3 水平判定 | **搜索为主**(Search 系列占消耗大头):`<3%` 偏低,`3%~5%` 正常,`>5%` 优秀;**展示为主**:`<1%` 偏低,`1%~2%` 正常,`>2%` 优秀;混合账户说明以哪类为准 |
|
|
208
|
+
| 4 CPC | `stats` / `overview` 的 `averageCpc` 或 `cost / clicks` |
|
|
209
|
+
| 5 转化数 | 默认 `conversions`(与「须先确认 §3 询盘口径」一致);括号说明若口径不同须在首段脚注 |
|
|
210
|
+
| 5.1 / 5.2 | 从 `keywords` / `campaign-geo-matched` 筛 `conversions > 0`,列词或国家 + 转化数(可 TopN);用户自定义模板时仍可保留或合并为一条 |
|
|
211
|
+
| 6 优化建议 | 同批 JSON,不额外拉数;用户若提供「只写预算/否词」等范围,按用户范围写 |
|
|
212
|
+
| 7 余额 | `balance` 当前余额,标注截至查询时点 |
|
|
213
|
+
|
|
214
|
+
- **所有金额、百分比** 一律 **2 位小数**(与 xlsx 规范一致)。
|
|
215
|
+
- 用户自定义模板时:**保留用户条目顺序与措辞**,仅替换 `<…>` 占位或等价位置为 JSON 实数;用户删掉的条目不再输出。
|
|
216
|
+
|
|
217
|
+
### 用户自定义示例
|
|
218
|
+
|
|
219
|
+
| 用户说法 | Agent 行为 |
|
|
220
|
+
| -------- | ---------- |
|
|
221
|
+
| 「按默认 OKKI 话术发客户」 | 用上方默认模板 |
|
|
222
|
+
| 「话术用我这份:…」(粘贴全文) | 以用户全文为骨架填数;缺项不擅自补回默认条目,除非用户要求 |
|
|
223
|
+
| 「不要 5.1 / 5.2,其它不变」 | 输出默认模板但省略 5.1、5.2 |
|
|
224
|
+
| 「第 3 条只写搜索点击率,基准 4%」 | 按用户基准改写判定话术,数值仍来自 JSON |
|
|
225
|
+
| 「优化建议只要 3 条 bullet」 | 压缩第 6 条条数,内容仍须有据 |
|
|
199
226
|
|
|
200
227
|
---
|
|
201
228
|
|
|
202
|
-
##
|
|
229
|
+
## 复盘小结(Excel「数据复盘」区块 / 对内补充)
|
|
203
230
|
|
|
204
|
-
基于同一批 JSON(`campaigns`、`keywords`、`search-terms`、`campaign-device`、`campaign-geo-matched`、`overview
|
|
231
|
+
基于同一批 JSON(`campaigns`、`keywords`、`search-terms`、`campaign-device`、`campaign-geo-matched`、`overview`)写入 Sheet `账户报告` 下方 **「数据复盘」**(5 条结构化要点,见上文 xlsx 规范);与对外话术 **第 6 条优化建议** 可呼应但 **Excel 内须更细**,不得与话术数字矛盾。
|
|
205
232
|
|
|
206
233
|
- **复盘**:3~6 条 bullet:消耗集中度、高消耗系列/词、地域与设备差异、CTR/CPC 相对水平。
|
|
207
234
|
- **优化建议**:3~5 条可执行项(预算、否词、落地页、系列状态等),**不额外拉数**;缺数据则标 `[数据不可用:原因]`。
|
|
@@ -213,5 +240,5 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
213
240
|
| 项 | `google-period-report.md` | 本文 OKKI 周报 |
|
|
214
241
|
| -------- | ------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
|
215
242
|
| 默认维度 | 8 维 + 主动追问追加 | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched` + `stats` + `balance` |
|
|
216
|
-
| 输出形态 | 长文分析报告 |
|
|
243
|
+
| 输出形态 | 长文分析报告 | **默认客户话术(可自定义)** + Excel 数据复盘 + **多 Sheet Excel(Agent 脚本写)** |
|
|
217
244
|
| 典型用户 | 内部分析 | **发客户**的同步简报 |
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
> **媒体**:当前模板仅规范 **Google**(`mediaCustomerId`)。其他媒体用各自 `*-period-report.md`。
|
|
7
7
|
> **Excel 版式基准**:与运营样表《**数据复盘分析**》类 xlsx 对齐(如 `2025.12数据复盘分析.xlsx`);工作簿 5 个 Sheet、顺序与表头以下文规范为准。
|
|
8
8
|
|
|
9
|
-
识别到上述意图时:**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程;按本文**固定维度 +
|
|
9
|
+
识别到上述意图时:**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程;按本文**固定维度 + 默认客户话术(可用户自定义)**交付(数据全部来自 CLI 落盘 JSON,见 `references/analytics/account-analytics.md`)。
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -174,34 +174,61 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
174
174
|
|
|
175
175
|
---
|
|
176
176
|
|
|
177
|
-
##
|
|
177
|
+
## 对外客户话术(默认结构,填数来自 JSON)
|
|
178
178
|
|
|
179
|
-
|
|
179
|
+
> **默认**:用户未指定话术样式时,使用下方**默认模板**输出终稿。
|
|
180
|
+
> **用户自定义**:用户可(1)粘贴自有话术骨架;(2)要求增删改某几条(如「不要 5.1」「第 3 条改成…」);(3)指定 CTR 基准或币种展示方式。**自定义时仍须**:数值/百分比一律来自 CLI 落盘 JSON + 脚本计算,禁止编造;缺数据标 `[数据不可用:原因]`,不得留空占位符糊弄客户。
|
|
180
181
|
|
|
181
|
-
|
|
182
|
+
**日期写法(首行)**:`<S>` / `<E>` 转为中文可读,如 `4月1号-4月7号` 或 `2026年4月1日-4月7日`(与用户习惯一致即可,须与 `--start` / `--end` 对应)。
|
|
183
|
+
|
|
184
|
+
**默认模板**:
|
|
182
185
|
|
|
183
186
|
```
|
|
184
|
-
您好,同步一下谷歌<S>--<E
|
|
185
|
-
|
|
186
|
-
1
|
|
187
|
-
2
|
|
188
|
-
3
|
|
189
|
-
4
|
|
190
|
-
5
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
187
|
+
您好,同步一下谷歌<S>--<E>投放的情况:
|
|
188
|
+
|
|
189
|
+
1、消耗:共消耗<金额+币种>,平均每天消耗<金额+币种>;
|
|
190
|
+
2、展示点击:带来<曝光>个曝光,<点击>个点击;
|
|
191
|
+
3、点击率:<CTR%>,处于<优秀/正常/偏低>水平(搜索正常水平 3%~5%,展示正常水平 1%~2%;按账户实际以搜索或展示为主选基准,无法区分时写「整体」并说明依据)
|
|
192
|
+
4、平均点击单价:<金额+币种>
|
|
193
|
+
5、转化:记录到网站表单+会话询盘<N>个;直接写邮件咨询和 WhatsApp 咨询无法记录,需贵司自行统计后反馈具体咨询产品和国家,方便广告及时调整
|
|
194
|
+
5.1 有转化的关键词:<据 keywords / search-terms JSON 填写;无转化则写「本周期暂无带转化关键词」>
|
|
195
|
+
5.2 有转化的国家:<据 campaign-geo-matched JSON 填写;无转化则写「本周期暂无带转化国家/地区」>
|
|
196
|
+
6、优化建议:<据 campaigns / keywords / search-terms / device / geo JSON 撰写 3~5 条可执行建议,禁止编造数据>
|
|
197
|
+
7、账户余额:<金额+币种>(截至查询时点)
|
|
194
198
|
```
|
|
195
199
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
200
|
+
### 填数规则
|
|
201
|
+
|
|
202
|
+
| 条目 | 数据来源 / 计算 |
|
|
203
|
+
| ---- | ---------------- |
|
|
204
|
+
| 1 消耗 / 日均 | `stats` 或 `overview` 区间 `spend`;日均 = `总消耗 ÷ 区间日历天数`(含起止日),脚本计算 |
|
|
205
|
+
| 2 曝光 / 点击 | `stats` / `overview` 的 `impressions`、`clicks` |
|
|
206
|
+
| 3 点击率 | `overview.record.ctr` 或 `stats` 同级字段;已是 **0~1 小数**,话术 `(ctr * 100).toFixed(2) + "%"`,**禁止**直接打印得到 `0.10%` |
|
|
207
|
+
| 3 水平判定 | **搜索为主**(Search 系列占消耗大头):`<3%` 偏低,`3%~5%` 正常,`>5%` 优秀;**展示为主**:`<1%` 偏低,`1%~2%` 正常,`>2%` 优秀;混合账户说明以哪类为准 |
|
|
208
|
+
| 4 CPC | `stats` / `overview` 的 `averageCpc` 或 `cost / clicks` |
|
|
209
|
+
| 5 转化数 | 默认 `conversions`(与「须先确认 §3 询盘口径」一致);括号说明若口径不同须在首段脚注 |
|
|
210
|
+
| 5.1 / 5.2 | 从 `keywords` / `campaign-geo-matched` 筛 `conversions > 0`,列词或国家 + 转化数(可 TopN);用户自定义模板时仍可保留或合并为一条 |
|
|
211
|
+
| 6 优化建议 | 同批 JSON,不额外拉数;用户若提供「只写预算/否词」等范围,按用户范围写 |
|
|
212
|
+
| 7 余额 | `balance` 当前余额,标注截至查询时点 |
|
|
213
|
+
|
|
214
|
+
- **所有金额、百分比** 一律 **2 位小数**(与 xlsx 规范一致)。
|
|
215
|
+
- 用户自定义模板时:**保留用户条目顺序与措辞**,仅替换 `<…>` 占位或等价位置为 JSON 实数;用户删掉的条目不再输出。
|
|
216
|
+
|
|
217
|
+
### 用户自定义示例
|
|
218
|
+
|
|
219
|
+
| 用户说法 | Agent 行为 |
|
|
220
|
+
| -------- | ---------- |
|
|
221
|
+
| 「按默认 OKKI 话术发客户」 | 用上方默认模板 |
|
|
222
|
+
| 「话术用我这份:…」(粘贴全文) | 以用户全文为骨架填数;缺项不擅自补回默认条目,除非用户要求 |
|
|
223
|
+
| 「不要 5.1 / 5.2,其它不变」 | 输出默认模板但省略 5.1、5.2 |
|
|
224
|
+
| 「第 3 条只写搜索点击率,基准 4%」 | 按用户基准改写判定话术,数值仍来自 JSON |
|
|
225
|
+
| 「优化建议只要 3 条 bullet」 | 压缩第 6 条条数,内容仍须有据 |
|
|
199
226
|
|
|
200
227
|
---
|
|
201
228
|
|
|
202
|
-
##
|
|
229
|
+
## 复盘小结(Excel「数据复盘」区块 / 对内补充)
|
|
203
230
|
|
|
204
|
-
基于同一批 JSON(`campaigns`、`keywords`、`search-terms`、`campaign-device`、`campaign-geo-matched`、`overview
|
|
231
|
+
基于同一批 JSON(`campaigns`、`keywords`、`search-terms`、`campaign-device`、`campaign-geo-matched`、`overview`)写入 Sheet `账户报告` 下方 **「数据复盘」**(5 条结构化要点,见上文 xlsx 规范);与对外话术 **第 6 条优化建议** 可呼应但 **Excel 内须更细**,不得与话术数字矛盾。
|
|
205
232
|
|
|
206
233
|
- **复盘**:3~6 条 bullet:消耗集中度、高消耗系列/词、地域与设备差异、CTR/CPC 相对水平。
|
|
207
234
|
- **优化建议**:3~5 条可执行项(预算、否词、落地页、系列状态等),**不额外拉数**;缺数据则标 `[数据不可用:原因]`。
|
|
@@ -213,5 +240,5 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
213
240
|
| 项 | `google-period-report.md` | 本文 OKKI 周报 |
|
|
214
241
|
| -------- | ------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
|
215
242
|
| 默认维度 | 8 维 + 主动追问追加 | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched` + `stats` + `balance` |
|
|
216
|
-
| 输出形态 | 长文分析报告 |
|
|
243
|
+
| 输出形态 | 长文分析报告 | **默认客户话术(可自定义)** + Excel 数据复盘 + **多 Sheet Excel(Agent 脚本写)** |
|
|
217
244
|
| 典型用户 | 内部分析 | **发客户**的同步简报 |
|
|
@@ -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.
|
|
12
|
+
$PKG_VERSION = '1.1.32-beta.1'
|
|
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.siluzan.com'
|
|
15
|
+
$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
|
|
16
|
+
$WEB_BASE = 'https://www-ci.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.
|
|
12
|
+
readonly PKG_VERSION="1.1.32-beta.1"
|
|
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.siluzan.com"
|
|
15
|
+
readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
|
|
16
|
+
readonly WEB_BASE="https://www-ci.siluzan.com"
|
|
17
17
|
|
|
18
18
|
# -- Constants ----------------------------------------------------------------
|
|
19
19
|
readonly NODE_MAJOR_MIN=18
|
|
@@ -44,7 +44,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
44
44
|
|
|
45
45
|
**任务**:
|
|
46
46
|
|
|
47
|
-
1. Read `report-templates/okki-weekly-google-client.md` 中 xlsx
|
|
47
|
+
1. Read `report-templates/okki-weekly-google-client.md` 中 xlsx 版式与 **§对外客户话术**(默认 7 条模板;主 Agent 若指定自定义话术则从其指示)。
|
|
48
48
|
2. 编写并执行 Node/Python 脚本,产出 `.xlsx` + 客户话术。
|
|
49
49
|
3. 设备/国家 Sheet 必须用 `campaign-device` / `campaign-geo-matched` 落盘文件。
|
|
50
50
|
|