siluzan-tso-cli 1.1.54 → 1.1.55-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.
Files changed (34) hide show
  1. package/README.md +2 -1
  2. package/dist/index.js +473 -231
  3. package/dist/skill/SKILL.md +2 -2
  4. package/dist/skill/_meta.json +2 -2
  5. package/dist/skill/references/accounts/accounts-list.md +3 -1
  6. package/dist/skill/references/accounts/accounts-permissions.md +2 -2
  7. package/dist/skill/references/accounts/finance.md +1 -1
  8. package/dist/skill/references/accounts/open-account-by-media.md +1 -1
  9. package/dist/skill/references/accounts/open-account-google-ui.md +1 -1
  10. package/dist/skill/references/analytics/rag.md +1 -1
  11. package/dist/skill/references/analytics/reporting.md +5 -5
  12. package/dist/skill/references/core/agent-conventions.md +6 -4
  13. package/dist/skill/references/core/playbooks.md +1 -1
  14. package/dist/skill/references/core/setup.md +5 -5
  15. package/dist/skill/references/core/subagent-orchestration.md +1 -1
  16. package/dist/skill/references/misc/tso-home.md +2 -2
  17. package/dist/skill/references/operations/guard.md +1 -1
  18. package/dist/skill/references/report-templates/README.md +1 -1
  19. package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +1 -1
  20. package/dist/skill/references/report-templates/okki-weekly-google-client.md +55 -42
  21. package/dist/skill/report-templates/README.md +1 -1
  22. package/dist/skill/report-templates/REPORT-WORKFLOW.md +1 -1
  23. package/dist/skill/report-templates/okki-weekly-google-client.md +55 -42
  24. package/dist/skill/scripts/install.ps1 +3 -3
  25. package/dist/skill/scripts/install.sh +3 -3
  26. package/dist/skill/snippets/handoff-p6-okki.md +2 -2
  27. package/eval/cases/compat-account-balance.scenario.json +23 -0
  28. package/eval/cases/compat-cpa-risk-scan.scenario.json +26 -0
  29. package/eval/cases/compat-d-group-mcc.scenario.json +31 -0
  30. package/eval/cases/compat-google-analysis-run-is-real.scenario.json +23 -0
  31. package/eval/cases/compat-playbook-code-w1.scenario.json +23 -0
  32. package/eval/cases/hosted-sop-daily-budget-circuit-breaker.scenario.json +8 -2
  33. package/eval/cases/uj-patrol-google-balances-low.scenario.json +9 -3
  34. package/package.json +1 -1
package/dist/skill/SKILL.md CHANGED
@@ -128,7 +128,7 @@ siluzan-tso -h
128
128
  | Yandex 账户分析 / 周期 / 月报 | **P4** | `report-templates/yandex-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `yandex-period-report-excel.md` |
129
129
  | 账户级按日 Excel | **P4-DAILY** | `report-templates/stats-daily-excel.md` |
130
130
  | 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |
131
- | OKKI 周报 / 表格形式（OKKI） | **P6** | `report-templates/okki-weekly-google-client.md`（写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet `.xlsx`；「表格形式」= Excel） |
131
+ | OKKI 周报 / 表格形式（OKKI） | **P6** | `report-templates/okki-weekly-google-client.md`（写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet `.xlsx`；客户话术默认 7 条、一条一行；「表格形式」= Excel） |
132
132
  | Google 询盘分析（**须 CRM 询盘资料**；口语零询盘/CPA → **P3**） | **P7** | `report-templates/google-inquiry-analysis.md` + `references/analytics/geo-continents.json` |
133
133
  | 网址/域名/官网 + 诊断·检测·监测·报告 / **是否符合广告投放要求** / 能不能投 | **P8** | `references/core/intent-routing.md` §零 + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必** `website-diagnosis collect`；**≠ P9 ≠ W3**；禁纯 WebFetch） |
134
134
  | 市场/行业分析报告 / 战略市场 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（须 collect+render；**≠ P8**） |
@@ -141,7 +141,7 @@ siluzan-tso -h
141
141
  | ------------------ | ------ | -------- |
142
142
  | 智能预警：创建/查询/启停/触发记录 | W10 | `references/operations/forewarning.md` |
143
143
  | TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |
144
- | 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |
144
+ | 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md`（交付物是 CLI 的 `userDelivery`，宿主 `present_files`） |
145
145
  | 超预算熔断 / 空耗熔断（全户 Google） | — | `references/operations/guard.md`（`guard budget-circuit` / `guard zero-conv`；禁止逐户 for-loop） |
146
146
  | Bing 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-bing.md`（只读告警，不能自动暂停/改价） |
147
147
  | Yandex 自动化巡检（归档/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-yandex.md`（只读告警，不能自动暂停/改价） |
package/dist/skill/_meta.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.54",
4
- "publishedAt": 1791961273451
3
+ "version": "1.1.55-beta.2",
4
+ "publishedAt": 1792410289749
5
5
  }
package/dist/skill/references/accounts/accounts-list.md CHANGED
@@ -28,6 +28,8 @@ siluzan-tso list-accounts [选项]
28
28
 
29
29
  **命令定位**：`list-accounts` 主打**精准查询账号信息**（列表、计数、按名称/ID 找户、`entityId` / `mediaCustomerId` / 币种 / 状态等元数据），**不是余额/消耗汇总工具**。JSON **不含**余额/消耗字段，表格也不显示余额列；**禁止**臆造数值——单户余额用 `balance`、全量余额预警用 `balance-scan`（P2）、多户消耗画像用 `accounts-digest`（P3）、单户消耗用 `stats`（均见 `accounts-balance-stats.md`）。
30
30
 
31
+ `--login-customer-id <id>` 只保留 `ma.loginCustomerId` 匹配的账户（Google MCC，`397-889-3117` 与 `3978893117` 相同）。D 组日巡检用 `--login-customer-id 3978893117`。没有这个参数名的写法会失败。同一参数也用于 `balance-scan`、`accounts-digest`、`guard`：先拉全量清单，再按该字段过滤，然后才拉消耗。不传时结果与原来一致。`--json-out` 下列全部时带 `--page-size 999`，否则只过滤本页。
32
+
31
33
  ### Agent 意图速查（**必读 · 避免多次试探**）
32
34
 
33
35
  用户问「有哪些 / 列出全部 / 有多少」某媒体广告账户时，**第一次 CLI 就应带大 `--page-size`**，**禁止**先用默认 20 条再翻页重试：
@@ -168,7 +170,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
168
170
  | 状态 | 含义 | 下一步操作 |
169
171
  | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
170
172
  | `Pending` | 审核中 | 等待，可反复运行此命令轮询；审核周期因媒体而异 |
171
- | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
173
+ | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
172
174
  | `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |
173
175
 
174
176
  ---
package/dist/skill/references/accounts/accounts-permissions.md CHANGED
@@ -490,7 +490,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
490
490
 
491
491
  | 功能 | 媒体 | 网页路径 |
492
492
  | --------------------------------------- | ------ | ------------------------------------------------- |
493
- | **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
493
+ | **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
494
494
 
495
495
  **Agent 建议话术**：
496
496
 
@@ -499,5 +499,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
499
499
  siluzan-tso config show # 查看 webUrl 字段
500
500
 
501
501
  # 账户激活（Google）→ 引导至账户管理页
502
- # https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
502
+ # https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
503
503
  ```
package/dist/skill/references/accounts/finance.md CHANGED
@@ -126,7 +126,7 @@ siluzan-tso config show
126
126
 
127
127
  ### 充值页链接（按媒体 × 类型）
128
128
 
129
- 链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
129
+ 链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
130
130
 
131
131
  | 充值类型 | `<page>` | 支持媒体（`mediaType` 参数） |
132
132
  | ------------------------- | --------------------- | ------------------------------------------- |
package/dist/skill/references/accounts/open-account-by-media.md CHANGED
@@ -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
  ## Contents
package/dist/skill/references/accounts/open-account-google-ui.md CHANGED
@@ -65,7 +65,7 @@ siluzan-tso open-account google-wizard
65
65
 
66
66
  ```bash
67
67
  siluzan-tso account-history -m Google
68
- # 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
68
+ # 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
69
69
  ```
70
70
 
71
71
  ---
package/dist/skill/references/analytics/rag.md CHANGED
@@ -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
 
package/dist/skill/references/analytics/reporting.md CHANGED
@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
190
190
 
191
191
  | 媒体 | 报告类型 | URL 模板 |
192
192
  | ------ | ---------------- | ----------------------------------------------------------- |
193
- | Google | 日报（Daily） | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
194
- | Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
195
- | TikTok | 日报 | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
193
+ | Google | 日报（Daily） | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
194
+ | Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
195
+ | TikTok | 日报 | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
196
196
 
197
197
  `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
198
198
 
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
205
205
 
206
206
  # 第二步：查看 webUrl
207
207
  siluzan-tso config show
208
- # webUrl: https://www.siluzan.com
208
+ # webUrl: https://www-ci.siluzan.com
209
209
 
210
210
  # 第三步：拼接链接（Google 日报）
211
- # https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
211
+ # https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
212
212
  ```
package/dist/skill/references/core/agent-conventions.md CHANGED
@@ -224,7 +224,7 @@
224
224
 
225
225
  **A · 币种**：首行含 `统计区间：…（货币：CNY|USD）`；全文符号与 `currencyCode` 一致（CNY=￥、USD=$，未混用）；与当次 `list-accounts -k` 结果相同；多账户分币种分表、无跨币种「总计」行。
226
226
 
227
- **B · 结构完整**（对照当次 `report-templates/*.md`）：模板要求的每一章/Sheet 都存在；无整章空白（缺数据章节写 `[ 数据不可用：… ]`，禁止编造数字填坑）；优化建议独立成节、引用当次数字（Meta 周期：四问 + 3 张建议卡 + 各章 analysis/advice；Google 诊断：每模块除表格外有「分析」+「建议」）；Excel 的表头列须能在当次 `*.outline.txt` 找到对应字段、产物内账户 ID = 用户当轮给出的 `mediaCustomerId`；**Excel 内全部 ID 列为文本**（见上文「写 Excel 时所有 ID 必须是文本」）。**P6**：磁盘上必须已有 `google-analysis okki-render` 写出的 `.xlsx`（禁止 Agent 手写表）。**P7**：磁盘上必须已有 `.xlsx`。对话 Markdown 表、手写 HTML/PDF **不能**当作终稿通过自检（用户明确只要话术除外）。
227
+ **B · 结构完整**（对照当次 `report-templates/*.md`）：模板要求的每一章/Sheet 都存在；无整章空白（缺数据章节写 `[ 数据不可用：… ]`，禁止编造数字填坑）；优化建议独立成节、引用当次数字（Meta 周期：四问 + 3 张建议卡 + 各章 analysis/advice；Google 诊断：每模块除表格外有「分析」+「建议」）；Excel 的表头列须能在当次 `*.outline.txt` 找到对应字段、产物内账户 ID = 用户当轮给出的 `mediaCustomerId`；**Excel 内全部 ID 列为文本**（见上文「写 Excel 时所有 ID 必须是文本」）。**P6**：磁盘上必须已有 `google-analysis okki-render` 写出的 `.xlsx`（禁止 Agent 手写表）。可复制话术为默认 7 条且一条一行；禁止改成「一、二、三、四」或合成一段。只有用户本轮粘贴骨架或点名增删某一条时才改被点名的行。**P7**：磁盘上必须已有 `.xlsx`。对话 Markdown 表、手写 HTML/PDF **不能**当作终稿通过自检（用户明确只要话术除外）。
228
228
 
229
229
  **C · 数字可信**（抽样，不读大 JSON）：总消耗/CPA 数量级与生成过程中脚本 stdout 打印的汇总一致（若无，补跑一次极小 `node -e` 只打印 totals）；账户 ID、区间与用户需求一致；无「示例账户」「占位 123456」等模板残留；表格行数符合预期（如 P3 每个 `-a` ID 占一行）。
230
230
 
@@ -238,7 +238,7 @@
238
238
  - 区间：2026-04-01 ~ 2026-04-30
239
239
  ```
240
240
 
241
- **D · 巡检 / 定时任务必须收口**：余额预警、转化成本 / CPA / 零转化、多户汇总等任务，结束时必须向用户交付 **排序表摘要** 或 **显式失败原因**（命令报错、无命中、转化字段未返回等）。**禁止**只跑 CLI / 调试脚本后沉默结束。
241
+ **D · 巡检 / 定时任务必须收口**：余额预警、转化成本 / CPA / 零转化、多户汇总等任务，结束时必须向用户交付 **排序表摘要** 或 **显式失败原因**（命令报错、无命中、转化字段未返回等）。定时巡检的交付物就是 CLI 的 `userDelivery`，宿主负责 `present_files`。**禁止**只跑 CLI / 调试脚本后沉默结束。
242
242
 
243
243
  ---
244
244
 
@@ -246,12 +246,12 @@
246
246
 
247
247
  | 任务 | 推荐命令 | 禁止 |
248
248
  | -------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
249
- | 多账户余额 / 预算不足预警 | `balance-scan -m <媒体> --threshold-days 7`（用 **`dailySpend`** / `remainingDays`） | 逐账户 `balance --accounts ...`；把 `stats` 多日 **`spend` 当「日消耗」** |
249
+ | 多账户余额 / 预算不足预警 | `balance-scan -m <媒体> --threshold-days 7`（用 **`dailySpend`** / `remainingDays`；交付 `agentBrief.userDelivery`） | 逐账户 `balance --accounts ...`；`account balance`；把 `stats` 多日 **`spend` 当「日消耗」** |
250
250
  | 多账户投放画像 / 转化成本巡检 | `accounts-digest -m <媒体> [-a ...] --start --end --json-out`（CPA 加 `--max-cpa --skip-balance`；**`spend`=区间合计**；交付 `agentBrief.userDelivery`） | 发明 `cpa-risk-scan`；逐账户 `stats`；把 `meta.totals` 说成全部账户；把 `ctr` 再乘 100 |
251
251
  | 单户按日 Excel | `stats … --by-day --json-out`（P4-DAILY） | 默认 `stats` 当按日 |
252
252
  | 多账户 × 多维度 Google 数据 | 全量：`google-analysis-batch run`（省略 `-a`）；2~10：`google-analysis -a id1,id2,...` | 外层 for-loop；先 list 再拼 `-a` |
253
253
  | 多系列诊断 | `ad campaigns --json-out` + node 读文件过滤 | 逐系列 `ad campaign-get` |
254
- | 单日预算熔断 / 空耗熔断（全户 Google） | `guard budget-circuit` / `guard zero-conv -m Google --json-out`（见 `operations/guard.md`） | 六媒体 `list-accounts` + 逐户 `ad campaigns`/`ad groups` for-loop；`ad campaigns -m`（非法） |
254
+ | 单日预算熔断 / 空耗熔断（全户 Google） | `guard budget-circuit` / `guard zero-conv -m Google --json-out`（交付 `userDelivery`；见 `operations/guard.md`） | 六媒体 `list-accounts` + 逐户 `ad campaigns`/`ad groups` for-loop；`ad campaigns -m`（非法） |
255
255
  | 单户当日花费比日预算 | `ad campaigns -a <id> --start <当日> --end <当日>`（**start=end**）后再比 `spend` 与 `budget` | 用默认近 7 天窗口的 `spend` 对比日预算 |
256
256
 
257
257
  **消耗口径（自动化必读）**：凡 `--start`/`--end` 读命令的 `spend` = **闭区间合计**，默认近 7 天 ≠ 一天。日均用 `balance-scan.dailySpend` 或 `合计÷天数`；详见 `references/operations/hosted-automation-self-control.md`「检查项常用 JSON 字段」。
@@ -327,6 +327,8 @@
327
327
  4. **行动建议**：1～3 条，点名对象并引用数据；若建议含「打开网页 / 去充值 / 去授权」，链接须遵守 §四「禁止编造平台网页地址」，**禁止**随口给一个未经验证的 URL。
328
328
  5. **下一步**：一句邀请。客户端 suggestion chips 另展示；**不要**在 skill 各任务文档维护 chips 全文清单。
329
329
 
330
+ **OKKI 周报例外**：上面 5 步只用于代码块**外面**的运营摘要（最多 3～5 行）。发给客户复制的正文按 `okki-weekly-google-client.md` 的默认 7 条填写，一条一行。禁止把摘要结构写进可复制块，禁止沿用上一轮或其他账户的话术。
331
+
330
332
  长任务（>30s）：中间用进度短句，勿长时间沉默后突然扔大表。
331
333
 
332
334
  ### 14.3 先执行后解释
package/dist/skill/references/core/playbooks.md CHANGED
@@ -142,7 +142,7 @@
142
142
  3. 同一 `--json-out` 目录执行模板命令组合：`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched`。
143
143
  4. 脚本读盘 → 只写 `okki-weekly-report.json` 的 `meta` + `narrative`（5 Sheet 表末分析 + 账户 Sheet 固定 5 维数据复盘；表为空也须写）。`deviceType` 是 `Desktop`/`Mobile`，禁止 `.get("DESKTOP")`，按大小写不敏感分类累加后再写设备金额。
144
144
  5. `google-analysis okki-render --data ./okki-weekly-report.json --snapshot-dir ./snap-okki --out <xlsx>`。缺分析 / 缺 5 维复盘 / 缺 `campaign-device` 或 `campaign-geo-matched` 会拒绝出文件；按 stderr 补 JSON 后重跑。**禁止** Agent 手写 xlsx。
145
- 6. 按 `okki-weekly-google-client.md` **默认客户话术**填数交付（用户另有话术/增删条目时从其自定义）；数值与 xlsx 一致。
145
+ 6. 按 `okki-weekly-google-client.md` **默认 7 条话术**填数，放进代码块，一条一行（第 6 条的 ①②③ 也各占一行）。禁止合成一段，禁止改成「一、二、三、四」。上一轮或其他账户的话术不算本轮骨架；只有用户**本轮**粘贴全文或点名增删某一条时才改被点名的条目。数值与 xlsx 一致。
146
146
  - **产物**：`okki-render` 写出的 `.xlsx` 路径（缺文件 = 未完成）+ 对话内客户话术；**不**按 P4 默认 9 章追加。仅用户明确「只要话术 / 不要文件」时才省略 xlsx。
147
147
 
148
148
  ---
package/dist/skill/references/core/setup.md CHANGED
@@ -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 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -127,9 +127,9 @@ siluzan-tso config show
127
127
 
128
128
  ```
129
129
  构建环境 : production
130
- apiBaseUrl : https://tso-api.siluzan.com
131
- googleApiUrl : https://googleapi.mysiluzan.com
132
- webUrl : https://www.siluzan.com
130
+ apiBaseUrl : https://tso-api-ci.siluzan.com
131
+ googleApiUrl : https://googleapi-ci.mysiluzan.com
132
+ webUrl : https://www-ci.siluzan.com
133
133
  apiKey : abcd****1234
134
134
  ```
135
135
 
package/dist/skill/references/core/subagent-orchestration.md CHANGED
@@ -107,7 +107,7 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
107
107
  1. 主 Agent：确认账户与日期区间。
108
108
  2. **决策**：拉数阶段若日志长 → Bash/Task + `handoff-p6-okki.md` §拉数；否则主会话执行模板 §拉数命令。
109
109
  3. **决策**：写叙事 JSON + `okki-render` → Task handoff（只读 `snapDir`，先 outline 后 JSON，见 `references/core/tips.md`）；或主会话若上下文充足。**禁止** Agent 手写 xlsx。
110
- 4. 主 Agent：合并交付 **xlsx 路径**（须来自 `okki-render`）+ 客户话术；金额与 ID 与 manifest 一致。**没有 `.xlsx` 不得收口**（用户明确只要话术除外）。
110
+ 4. 主 Agent：合并交付 **xlsx 路径**（须来自 `okki-render`）+ 客户话术。话术用模板默认 7 条、一条一行，禁止另写「一、二、三、四」。**没有 `.xlsx` 不得收口**（用户明确只要话术除外）。
111
111
 
112
112
  ### P5 · 多账户多维度
113
113
 
package/dist/skill/references/misc/tso-home.md CHANGED
@@ -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
 
package/dist/skill/references/operations/guard.md CHANGED
@@ -69,7 +69,7 @@ siluzan-tso ad adgroup-status -a <mediaCustomerId> --id <adGroupId> \
69
69
 
70
70
  ## 输出与交付
71
71
 
72
- - `--json-out` 落盘命中表；无命中也必须收口（打印「无命中」）
72
+ - `--json-out` 的 stdout 含 `agentBrief.userDelivery`（命中表或原文「今日无命中」）。定时巡检原样粘贴，宿主负责 `present_files`
73
73
  - 命中后用 **逐账户** `ad *-status` 暂停，**没有** `--apply`
74
74
 
75
75
  恢复：人工加预算 / 改出价后，用 `ad campaign-status|adgroup-status|ad-status … --status Enabled`（或网页），**禁止**无人值守自动恢复。
package/dist/skill/references/report-templates/README.md CHANGED
@@ -35,7 +35,7 @@
35
35
  | `bing-period-report.md` / `.html` | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML |
36
36
  | `yandex-period-report.md` / `.html` | **Yandex Direct 周期报告（默认）**：四步流程 → `yandex-analysis render` 出 HTML（样式对齐开发样例） |
37
37
  | `yandex-period-report-excel.md` | **仅用户要 Excel 时**：Agent 脚本写 xlsx；无 CLI excel 子命令 |
38
- | `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术，见 `references/core/playbooks.md` P6 |
38
+ | `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术（默认 7 条、一条一行），见 `references/core/playbooks.md` P6 |
39
39
  | `google-inquiry-analysis.md` | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |
40
40
  | `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |
41
41
 
package/dist/skill/references/report-templates/REPORT-WORKFLOW.md CHANGED
@@ -84,7 +84,7 @@
84
84
  - **TikTok 周期报告**：产出 `tiktok-period-report.json`（见 `tiktok-period-report.md`，`meta` 可由 `--snapshot-dir` 自动合并）。
85
85
  - **Bing 周期报告**：产出 `bing-period-report.json`（见 `bing-period-report.md`，`meta`/`kpis` 可由 `--snapshot-dir` 自动合并）。
86
86
  - **Yandex 周期报告**：产出 `yandex-period-report.json`（见 `yandex-period-report.md`，`meta`/`kpis`/`tables` 可由 `--snapshot-dir` 自动合并）。
87
- - **OKKI（P6）**：产出 `okki-weekly-report.json` 后走 `google-analysis okki-render` 出 **5 Sheet `.xlsx`**（必产）；**询盘（P7）**仍由 Agent 脚本写 8 Sheet `.xlsx`。对话 Markdown 表 / 手写 HTML **不能**代替终稿。
87
+ - **OKKI（P6）**：产出 `okki-weekly-report.json` 后走 `google-analysis okki-render` 出 **5 Sheet `.xlsx`**（必产）；客户话术按模板默认 7 条、一条一行，禁止另写「一、二、三、四」。**询盘（P7）**仍由 Agent 脚本写 8 Sheet `.xlsx`。对话 Markdown 表 / 手写 HTML **不能**代替终稿。
88
88
 
89
89
  ### 步骤 5b：生成终稿（按媒体与格式）
90
90
 
package/dist/skill/references/report-templates/okki-weekly-google-client.md CHANGED
@@ -9,7 +9,7 @@
9
9
  > **默认交付（硬性，缺文件 = 任务未完成）**：磁盘上的 **5 Sheet `.xlsx`**（由 `google-analysis okki-render` 生成）+ 对话内客户话术。
10
10
  > 「表格形式 / 表格 / 各维度表格 / 表 / 做成表」= **Excel `.xlsx`**，**不是**对话 Markdown 表，**不是**手写 HTML/PDF。
11
11
  > 仅当用户明确「只要话术 / 不要文件 / 不要 Excel」时才省略 xlsx。
12
- > **禁止**：用对话 Markdown 表、手写 HTML、PDF 代替 `.xlsx`；**禁止** Agent 手写 / 脚本写 xlsx。
12
+ > **禁止**：用对话 Markdown 表、手写 HTML、PDF 代替 `.xlsx`；**禁止** Agent 手写 / 脚本写 xlsx。话术由 Agent 按下文「对外客户话术」填写，**不要**另写脚本生成话术。
13
13
 
14
14
  ## Contents
15
15
 
@@ -17,13 +17,13 @@
17
17
  - 标准四步流程（拉数 → 写 JSON → okki-render）
18
18
  - 拉数（一次目录）
19
19
  - xlsx 版式规范（由 CLI 锁死）
20
- - 对外客户话术（默认结构，填数来自 JSON）
20
+ - 对外客户话术（默认 7 条，一条一行）
21
21
  - 复盘小结（Excel「数据复盘」区块 / 对内补充）
22
22
  - 与 `google-period-report.md` 的差异
23
23
 
24
24
  ---
25
25
 
26
- 识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 9 章 + 追问追加」流程；按本文**固定维度 + 默认客户话术（可用户自定义）+ `okki-render` 出 5 Sheet `.xlsx`** 交付。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。
26
+ 识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 9 章 + 追问追加」流程；按本文**固定维度 + 默认客户话术（可用户自定义）+ `okki-render` 出 5 Sheet `.xlsx`** 交付。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。话术骨架见下文，禁止另起一套标题。
27
27
 
28
28
  ---
29
29
 
@@ -33,7 +33,7 @@
33
33
  2. **统计区间**：`--start` / `--end`（用户未给齐时按 SKILL 反问；授权默认时可用「上一完整自然周」白名单并写明）。
34
34
  3. **询盘口径**：默认使用区间内 `conversions`（转化次数，来自 `stats` 或 `overview`）。若运营定义为某类转化，须在首段脚注说明（必要时补拉 `google-analysis --sections conversion-actions` 仅作说明）。
35
35
  4. **日期写法**：`2026.4.1`、`2026/4/1` 等先规范为 `YYYY-MM-DD`（如 `2026-04-01`）再传 `--start` / `--end`。
36
- 5. **交付**：默认 **客户话术 + 5 Sheet `.xlsx`（必产，由 `okki-render` 写出）**。「表格形式」一律当 Excel。仅用户明确只要可复制话术、不要文件时，才省略 xlsx。
36
+ 5. **交付**：默认 **客户话术 + 5 Sheet `.xlsx`（xlsx 必产，由 `okki-render` 写出）**。「表格形式」一律当 Excel。仅用户明确只要可复制话术、不要文件时，才省略 xlsx。话术按下文默认 7 条填写。
37
37
 
38
38
  ---
39
39
 
@@ -241,53 +241,66 @@ function deviceKind(deviceType) {
241
241
 
242
242
  ## 对外客户话术（默认结构，填数来自 JSON）
243
243
 
244
- > **默认**：用户未指定话术样式时，使用下方**默认模板**输出终稿。
245
- > **用户自定义**：用户可（1）粘贴自有话术骨架；（2）要求增删改某几条（如「不要 5.1」「第 3 条改成…」）；（3）指定 CTR 基准或币种展示方式。**自定义时仍须**：数值/百分比一律来自 CLI 落盘 JSON + 脚本计算，禁止编造；缺数据标 `[数据不可用：原因]`，不得留空占位符糊弄客户。
244
+ > 话术是给客户看的总结，**由 Agent 填写，不要写脚本生成**。骨架固定；只有措辞和数字随当次数据变。
246
245
 
247
- **日期写法（首行）**：`<S>` / `<E>` 转为中文可读，如 `4月1号-4月7号` 或 `2026年4月1日-4月7日`（与用户习惯一致即可，须与 `--start` / `--end` 对应）。
246
+ **默认就用下面这 7 条。** 放进代码块再发给用户，便于原样复制。换行是骨架的一部分：
248
247
 
249
- **默认模板**：
248
+ - `1`～`5`、`5.1`、`5.2`、`7` 各占一行，行末用分号
249
+ - 第 `6` 条先写「6、优化建议：」，下面 **3～5 条**建议各占一行，用 ①②③④⑤，禁止写进同一句
250
+ - 禁止把 1～7 合成一段
250
251
 
251
252
  ```
252
- 您好，同步一下谷歌<S>--<E>投放的情况：
253
+ 您好，同步一下谷歌<中文日期>投放的情况：
253
254
 
254
- 1、消耗：共消耗<金额+币种>，平均每天消耗<金额+币种>；
255
+ 1、消耗：共消耗<金额>，平均每天消耗<金额>；
255
256
  2、展示点击：带来<曝光>个曝光，<点击>个点击；
256
- 3、点击率：<CTR%>，处于<优秀/正常/偏低>水平（搜索正常水平 3%～5%，展示正常水平 1%～2%；按账户实际以搜索或展示为主选基准，无法区分时写「整体」并说明依据）
257
- 4、平均点击单价：<金额+币种>
258
- 5、转化：记录到网站表单+会话询盘<N>个；直接写邮件咨询和 WhatsApp 咨询无法记录，需贵司自行统计后反馈具体咨询产品和国家，方便广告及时调整
259
- 5.1 有转化的关键词：<据 keywords / search-terms JSON 填写；无转化则写「本周期暂无带转化关键词」>
260
- 5.2 有转化的国家：<据 campaign-geo-matched JSON 填写；无转化则写「本周期暂无带转化国家/地区」>
261
- 6、优化建议：<据 campaigns / keywords / search-terms / device / geo JSON 撰写 3～5 条可执行建议，禁止编造数据>
262
- 7、账户余额：<金额+币种>（截至查询时点）
257
+ 3、点击率：<CTR%>，处于<优秀/正常/偏低>水平（<按下方规则选一条基准>）；
258
+ 4、平均点击单价：<金额>；
259
+ 5、转化：记录到网站表单+会话询盘<N>个；直接写邮件咨询和 WhatsApp 咨询无法记录，需贵司自行统计后反馈具体咨询产品和国家，方便广告及时调整；
260
+ 5.1 有转化的关键词：<词（N 个，CPA 金额）>；
261
+ 5.2 有转化的国家：<国家（N 个，CPA 金额）>；
262
+ 6、优化建议：
263
+ ① <一条可执行建议，点名对象并引用当次数字>
264
+ ② <同上>
265
+ ③ <同上>
266
+ 7、账户余额：<金额>（截至查询时点）。
263
267
  ```
264
268
 
269
+ 日期写成 `2026年4月1日-4月7日`（同年可省略结束年份），须与 `--start` / `--end` 对应。
270
+
271
+ **未获本轮用户改骨架时，禁止：**
272
+
273
+ - 改成「一、本周概览 / 二、本周发现 / 三、下周优化动作 / 四、需要您配合确认」，或任何另一套标题
274
+ - 把上一轮、另一个账户、对话里出现过的话术当成这次的骨架
275
+ - 用「结论先行」重写可复制块。运营摘要最多 3～5 行，放在代码块**外面**
276
+
277
+ **只有本轮用户**粘贴了全文骨架，或点名增删某一条（「不要 5.1」「第 3 条改成…」）时才偏离上面的结构。只改被点名的条目；用户删掉的条目不再输出。数字仍须来自当次 JSON，缺数写 `[数据不可用：原因]`。
278
+
265
279
  ### 填数规则
266
280
 
267
- | 条目 | 数据来源 / 计算 |
268
- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
269
- | 1 消耗 / 日均 | `stats` 或 `overview` 区间 `spend`；日均 = `总消耗 ÷ 区间日历天数`（含起止日），脚本计算 |
270
- | 2 曝光 / 点击 | `stats` / `overview` 的 `impressions`、`clicks` |
271
- | 3 点击率 | `overview.record.ctr` 或 `stats` 同级字段；已是 **0~1 小数**，话术 `(ctr * 100).toFixed(2) + "%"`，**禁止**直接打印得到 `0.10%` |
272
- | 3 水平判定 | **搜索为主**（Search 系列占消耗大头）：`<3%` 偏低，`3%～5%` 正常，`>5%` 优秀；**展示为主**：`<1%` 偏低，`1%～2%` 正常，`>2%` 优秀；混合账户说明以哪类为准 |
273
- | 4 CPC | `stats` / `overview` 的 `averageCpc` 或 `cost / clicks` |
274
- | 5 转化数 | 默认 `conversions`（与「须先确认 §3 询盘口径」一致）；括号说明若口径不同须在首段脚注 |
275
- | 5.1 / 5.2 | 从 `keywords` / `campaign-geo-matched` 筛 `conversions > 0`，列词或国家 + 转化数（可 TopN）；用户自定义模板时仍可保留或合并为一条 |
276
- | 6 优化建议 | 同批 JSON，不额外拉数；用户若提供「只写预算/否词」等范围，按用户范围写 |
277
- | 7 余额 | `balance` 当前余额，标注截至查询时点 |
278
-
279
- - **所有金额、百分比** 一律 **2 位小数**（与 xlsx 规范一致）。
280
- - 用户自定义模板时：**保留用户条目顺序与措辞**，仅替换 `<…>` 占位或等价位置为 JSON 实数；用户删掉的条目不再输出。
281
-
282
- ### 用户自定义示例
283
-
284
- | 用户说法 | Agent 行为 |
285
- | ---------------------------------- | ---------------------------------------------------------- |
286
- | 「按默认 OKKI 话术发客户」 | 用上方默认模板 |
287
- | 「话术用我这份：…」（粘贴全文） | 以用户全文为骨架填数；缺项不擅自补回默认条目，除非用户要求 |
288
- | 「不要 5.1 / 5.2，其它不变」 | 输出默认模板但省略 5.1、5.2 |
289
- | 「第 3 条只写搜索点击率，基准 4%」 | 按用户基准改写判定话术，数值仍来自 JSON |
290
- | 「优化建议只要 3 条 bullet」 | 压缩第 6 条条数，内容仍须有据 |
281
+ | 条目 | 数据来源 / 计算 |
282
+ | --- | --- |
283
+ | 1 消耗 / 日均 | 区间 `spend`；日均 = `总消耗 ÷ 区间日历天数`（含起止日） |
284
+ | 2 曝光 / 点击 | `impressions`、`clicks` |
285
+ | 3 点击率 | 已是 **0~1 小数**时写 `(ctr * 100).toFixed(2) + "%"`，禁止直接打印成 `0.10%` |
286
+ | 3 水平判定 | **搜索消耗 ≥60%**：`<3%` 偏低，`3%～5%` 正常，`>5%` 优秀，括号写「搜索正常水平 3%～5%」。**展示消耗 ≥60%**：`<1%` 偏低，`1%～2%` 正常，`>2%` 优秀，括号写「展示正常水平 1%～2%」。其余写「整体」，并说明依据（如搜索消耗占比）。括号里只留这一句判定，不要把本表规则贴给客户 |
287
+ | 4 CPC | `averageCpc`，或 `cost / clicks` |
288
+ | 5 转化数 | 默认 `conversions` |
289
+ | 5.1 / 5.2 | `keywords` / `campaign-geo-matched` 中 `conversions > 0`，按词或国家合计，最多 5 个，写成「名称（N 个，CPA 金额）」；没有则写「本周期暂无带转化关键词」或「本周期暂无带转化国家/地区」 |
290
+ | 6 优化建议 | 同批 JSON，3～5 条，每条单独一行；不额外拉数。用户若限定「只写预算/否词」，按该范围写，条数仍各自成行 |
291
+ | 7 余额 | `balance` 当前余额，标注截至查询时点 |
292
+
293
+ 金额、百分比一律 2 位小数。CNY 用 `￥`，USD 用 `$`。
294
+
295
+ ### 用户本轮改骨架时
296
+
297
+ | 用户说法 | Agent 行为 |
298
+ | --- | --- |
299
+ | 未提话术样式 / 「按默认 OKKI 话术」 | 用上方 7 条，一条一行 |
300
+ | 「话术用我这份：…」（本轮粘贴全文） | 以这份全文为骨架填数；缺项不擅自补回默认条目 |
301
+ | 「不要 5.1 / 5.2，其它不变」 | 仍是默认 7 条，只删 5.1、5.2 |
302
+ | 「第 3 条只写搜索点击率，基准 4%」 | 只改第 3 条的判定句，数值仍来自 JSON |
303
+ | 「按上次那个账户的四段式」 | 仅当用户**本轮**这样说才换骨架；不要自己从历史里捡 |
291
304
 
292
305
  ---
293
306
 
@@ -304,5 +317,5 @@ function deviceKind(deviceType) {
304
317
  | 项 | `google-period-report.md` | 本文 OKKI 周报 |
305
318
  | -------- | ------------------------- | -------------------------------------------------------------------------------------------------------------- |
306
319
  | 默认维度 | 8 维 + 主动追问追加 | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched` + `stats` + `balance` |
307
- | 输出形态 | 长文分析报告（默认 HTML，`google-analysis render`） | **必产** 5 Sheet `.xlsx`（`google-analysis okki-render`）+ 客户话术；「表格形式」= Excel；**禁止**对话 Markdown 表 / 手写 HTML / Agent 手写 xlsx |
320
+ | 输出形态 | 长文分析报告（默认 HTML，`google-analysis render`） | **必产** 5 Sheet `.xlsx`（`google-analysis okki-render`）+ 客户话术（默认 7 条、一条一行）；「表格形式」= Excel；**禁止**对话 Markdown 表 / 手写 HTML / Agent 手写 xlsx / 另写一套话术标题 |
308
321
  | 典型用户 | 内部分析 | **发客户**的同步简报 |
package/dist/skill/report-templates/README.md CHANGED
@@ -35,7 +35,7 @@
35
35
  | `bing-period-report.md` / `.html` | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML |
36
36
  | `yandex-period-report.md` / `.html` | **Yandex Direct 周期报告（默认）**：四步流程 → `yandex-analysis render` 出 HTML（样式对齐开发样例） |
37
37
  | `yandex-period-report-excel.md` | **仅用户要 Excel 时**：Agent 脚本写 xlsx；无 CLI excel 子命令 |
38
- | `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术，见 `references/core/playbooks.md` P6 |
38
+ | `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术（默认 7 条、一条一行），见 `references/core/playbooks.md` P6 |
39
39
  | `google-inquiry-analysis.md` | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |
40
40
  | `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |
41
41
 
package/dist/skill/report-templates/REPORT-WORKFLOW.md CHANGED
@@ -84,7 +84,7 @@
84
84
  - **TikTok 周期报告**：产出 `tiktok-period-report.json`（见 `tiktok-period-report.md`，`meta` 可由 `--snapshot-dir` 自动合并）。
85
85
  - **Bing 周期报告**：产出 `bing-period-report.json`（见 `bing-period-report.md`，`meta`/`kpis` 可由 `--snapshot-dir` 自动合并）。
86
86
  - **Yandex 周期报告**：产出 `yandex-period-report.json`（见 `yandex-period-report.md`，`meta`/`kpis`/`tables` 可由 `--snapshot-dir` 自动合并）。
87
- - **OKKI（P6）**：产出 `okki-weekly-report.json` 后走 `google-analysis okki-render` 出 **5 Sheet `.xlsx`**（必产）；**询盘（P7）**仍由 Agent 脚本写 8 Sheet `.xlsx`。对话 Markdown 表 / 手写 HTML **不能**代替终稿。
87
+ - **OKKI（P6）**：产出 `okki-weekly-report.json` 后走 `google-analysis okki-render` 出 **5 Sheet `.xlsx`**（必产）；客户话术按模板默认 7 条、一条一行，禁止另写「一、二、三、四」。**询盘（P7）**仍由 Agent 脚本写 8 Sheet `.xlsx`。对话 Markdown 表 / 手写 HTML **不能**代替终稿。
88
88
 
89
89
  ### 步骤 5b：生成终稿（按媒体与格式）
90
90