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 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
@@ -3774,7 +3774,7 @@ var DEFAULT_API_BASE;
3774
3774
  var init_defaults = __esm({
3775
3775
  "src/config/defaults.ts"() {
3776
3776
  "use strict";
3777
- DEFAULT_API_BASE = "https://tso-api.siluzan.com";
3777
+ DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
3778
3778
  }
3779
3779
  });
3780
3780
 
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.31",
4
- "publishedAt": 1782782763204
3
+ "version": "1.1.32-beta.1",
4
+ "publishedAt": 1782807062947
5
5
  }
@@ -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
  ---
@@ -1,6 +1,6 @@
1
1
  # rag:知识库检索(TSO 广告投放辅助)
2
2
 
3
- 知识库管理页面在 https://www.siluzan.com/knowledge-base/
3
+ 知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
4
4
 
5
5
  为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
6
6
 
@@ -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. 脚本读盘 → 交付话术 + Sheet `.xlsx`(无 CLI 写表命令)。
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 维 + 追问追加」流程;按本文**固定维度 + 固定客户话术**交付(数据全部来自 CLI 落盘 JSON,见 `references/analytics/account-analytics.md`)。
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
- ## 对外客户话术(固定结构,填数来自 JSON)
177
+ ## 对外客户话术(默认结构,填数来自 JSON)
178
178
 
179
- 首行:`统计区间:<S> ~ <E>(货币:<币种>)`
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. 搜索点击率 <CTR%>,<高于/低于/处于>正常水平(3%以上为正常)
189
- 4. CPC:<金额+币种>
190
- 5. 核心消费关键词:<列 Top5~10,词 + 消耗,可一句概括>
191
- 6. 核心消费地区:<列 Top5~10 国家/地区 + 消耗占比或消耗,可一句概括>
192
- 7. 询盘:<N>个<若口径为 conversions 则括号注明「转化次数」>
193
- 8. 账户余额:<金额+币种>(截至查询时点)
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
- - **第 1 条「平均每天」**:`区间总消耗 / 区间日历天数`(含起止日),脚本计算,禁止手填。
197
- - **第 3 条**:CLI 返回的若是账户整体 CTR,写「整体点击率」而非「搜索点击率」;可区分时再写「搜索点击率」。`overview-*.json`(汇总维度,`schemaVersion 3` 起整块在 `record`)的 `record.ctr` 已是 0~1 小数(如 `0.10`),话术 `x%` 用 `(ctr * 100).toFixed(2) + "%"`,**禁止**直接打印数值得到 "0.10%"。
198
- - **所有金额、百分比** 一律 **2 位小数**。
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
- | 输出形态 | 长文分析报告 | **固定话术** + 短复盘 + **多 Sheet Excel(Agent 脚本写)** |
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 维 + 追问追加」流程;按本文**固定维度 + 固定客户话术**交付(数据全部来自 CLI 落盘 JSON,见 `references/analytics/account-analytics.md`)。
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
- ## 对外客户话术(固定结构,填数来自 JSON)
177
+ ## 对外客户话术(默认结构,填数来自 JSON)
178
178
 
179
- 首行:`统计区间:<S> ~ <E>(货币:<币种>)`
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. 搜索点击率 <CTR%>,<高于/低于/处于>正常水平(3%以上为正常)
189
- 4. CPC:<金额+币种>
190
- 5. 核心消费关键词:<列 Top5~10,词 + 消耗,可一句概括>
191
- 6. 核心消费地区:<列 Top5~10 国家/地区 + 消耗占比或消耗,可一句概括>
192
- 7. 询盘:<N>个<若口径为 conversions 则括号注明「转化次数」>
193
- 8. 账户余额:<金额+币种>(截至查询时点)
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
- - **第 1 条「平均每天」**:`区间总消耗 / 区间日历天数`(含起止日),脚本计算,禁止手填。
197
- - **第 3 条**:CLI 返回的若是账户整体 CTR,写「整体点击率」而非「搜索点击率」;可区分时再写「搜索点击率」。`overview-*.json`(汇总维度,`schemaVersion 3` 起整块在 `record`)的 `record.ctr` 已是 0~1 小数(如 `0.10`),话术 `x%` 用 `(ctr * 100).toFixed(2) + "%"`,**禁止**直接打印数值得到 "0.10%"。
198
- - **所有金额、百分比** 一律 **2 位小数**。
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
- | 输出形态 | 长文分析报告 | **固定话术** + 短复盘 + **多 Sheet Excel(Agent 脚本写)** |
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.31'
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.31"
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 版式(若子会话可 Read skill 内路径)。
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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.1.31",
3
+ "version": "1.1.32-beta.1",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据,管理绑定关系与充值。",
5
5
  "keywords": [
6
6
  "ad-account",