npm - siluzan-tso-cli - Versions diffs - 1.1.52 → 1.1.53-beta.2 - Mend

siluzan-tso-cli 1.1.52 → 1.1.53-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 (37) hide show

package/dist/skill/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: siluzan-tso
-description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网+诊断/检测/监测/评估/体检/报告/符合投放要求/能不能投（含「网络诊断」混说）→P8 website-diagnosis collect（禁纯WebFetch/肉眼看页），禁止P9/P1/W3、禁止A/B/C/D追问；细则见 intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类话术→必走P9 market-analysis collect+render出HTML，禁止纯WebSearch/WebFetch在对话里写Markdown/HTML当终稿、禁止改走P8/P1/P4/W5/google-analysis；细则见 references/core/intent-routing.md §零·B。【§零·C·关键词规划】Google Ads/谷歌广告拓词、关键词规划/推荐、Keyword Planner、长尾关键词、月搜索量/搜索量、竞争度、核心词/种子词扩词（含「阅读网址/文章/页面后针对核心词出带搜索量词表」，无论是否提及丝路赞/TSO/账户）→必走W5 keyword -k … --google-only --json-out，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/campaign JSON→W3；Meta Instant Form 线索广告→W13；仅要词表+搜索量/竞争度→W5；平台优化报告列表/推送→W7；对象仍不清→Read intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、五大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】**搭建仅 Google+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
+description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网+诊断/检测/监测/评估/体检/报告/符合投放要求/能不能投（含「网络诊断」混说）→P8 website-diagnosis collect（禁纯WebFetch/肉眼看页），禁止P9/P1/W3、禁止A/B/C/D追问；细则见 intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类话术→必走P9 market-analysis collect+render出HTML，禁止纯WebSearch/WebFetch在对话里写Markdown/HTML当终稿、禁止改走P8/P1/P4/W5/google-analysis；细则见 references/core/intent-routing.md §零·B。【§零·C·关键词规划】Google Ads/谷歌广告拓词、关键词规划/推荐、Keyword Planner、长尾关键词、月搜索量/搜索量、竞争度、核心词/种子词扩词（含「阅读网址/文章/页面后针对核心词出带搜索量词表」，无论是否提及丝路赞/TSO/账户）→必走W5 keyword -k … --google-only --json-out，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；只要周期数据/8维/花费转化汇总/Excel→P4；Google/谷歌广告月度报告、月总结与规划、季度报告、Q3汇总、Q4规划、季度汇报、投放季报、客户版、大族模板、下月规划→P10 google-quarterly；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/campaign JSON→W3；Meta Instant Form 线索广告→W13；仅要词表+搜索量/竞争度→W5；平台优化报告列表/推送→W7；对象仍不清→Read intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、五大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】**搭建仅 Google+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
 license: MIT
 compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
 metadata:
@@ -13,14 +13,14 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 本文件只做 **任务路由**：意图 → **唯一**工作流 → 按需 Read 子文档（参数与步骤不在此重复）。
-- 分析 / 报告 → `references/core/playbooks.md`（P1–P9）
+- 分析 / 报告 → `references/core/playbooks.md`（P1–P10）
 - 操作 / 管理 → `references/core/workflows.md`（W1–W13）
 - 命令参数 → 路由表「必读文档」
 - 通用纪律与沟通 → `references/core/agent-conventions.md`
 > **加载**：按下方路由表 Read **一个**工作流卡片 + **一个**命令/报告 reference 后执行。写操作、报告交付、批量拉数、对用户写结论、或上下文被压缩时，再 Read `references/core/agent-conventions.md`（含 §十四沟通）。
 >
-> **报告 / 诊断 / 分析 / 拓词 / 转化成本·CPA·零询盘话术模糊**：先 Read `references/core/intent-routing.md`（含 **§零·D**：无 CRM 的转化巡检 → P3，不是 P7），再回路由表。数据任务一律 `--json-out` + 代码读盘（示例见 `references/core/tips.md`）。未指定格式时 P1/P4/P4-FB/P8/P9 默认 **HTML**；**P6 默认 `okki-render` 出 5 Sheet `.xlsx`**、**P7 默认 8 Sheet `.xlsx`**（「表格形式」= xlsx，禁止 Markdown 表 / 手写 HTML / P6 Agent 手写 xlsx）。巡检类任务须交付摘要或显式失败原因。
+> **报告 / 诊断 / 分析 / 拓词 / 转化成本·CPA·零询盘话术模糊**：先 Read `references/core/intent-routing.md`（含 **§零·D**：无 CRM 的转化巡检 → P3，不是 P7），再回路由表。数据任务一律 `--json-out` + 代码读盘（示例见 `references/core/tips.md`）。未指定格式时 P1/P4/P4-FB/P8/P9/P10 默认 **HTML**；**P6 默认 `okki-render` 出 5 Sheet `.xlsx`**、**P7 默认 8 Sheet `.xlsx`**（「表格形式」= xlsx，禁止 Markdown 表 / 手写 HTML / P6 Agent 手写 xlsx）。巡检类任务须交付摘要或显式失败原因。
 ---
@@ -46,7 +46,7 @@ siluzan-tso -h
 - **Google 广告类型边界**：CLI/Skill **仅支持** Google **搜索广告（Search）** 与 **Performance Max（PMax）** 的方案、创建与精细管理；**不支持展示广告（Display）**（含自适应展示广告 RDA、独立 Display 系列）。用户要做展示广告时须明确告知不支持，可改推 Search / PMax；**禁止**用 `campaign-create` / `ad-create` 伪装创建 Display。
 - **创建完成后交付（硬性）**：`ad batch diff` 的 stdout 含 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN`——**立刻**把中间全文原样发给用户（可先于补建）；禁止只摘要、禁止只说「创建成功/详情已交付/未发现缺失」、禁止等全部补建结束再交付。
 - `list-accounts` 无余额/消耗；列全部用 `--page-size 999`。
-- 多户余额用 `balance-scan`（P2），多户消耗用 `accounts-digest`（P3）；禁止外层 for-loop 逐户拉数。
+- 多户余额用 `balance-scan`（P2），多户消耗 / **转化成本·CPA 巡检**用 `accounts-digest`（P3，`--max-cpa`；**没有** `cpa-risk-scan`）。禁止外层 for-loop 逐户拉数。
 - `stats` 的 `spend` = **区间合计**，不是日消耗。
 - 行业/市场报告禁止纯 WebSearch 当终稿；须 P9 `market-analysis collect`+`render`。
 - **禁止编造平台网址**：给用户 `*.siluzan.com` / `mysiluzan.com` 链接前，**必须**当轮 `config show` 取 `webUrl`，路径**只**用已 Read 文档中的相对路径表拼接；CLI 输出的授权 URL **原样粘贴**；文档未给路径则**不拼链接**。细则见 `agent-conventions.md`。
@@ -120,7 +120,8 @@ siluzan-tso -h
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
 | Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |
-| Google 账户周期 / 月度 / 季度报告（非 OKKI / 非询盘 / 非强调健康诊断） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |
+| Google 账户周期 **数据汇总**（只要花费/转化/8 维/Excel；**无**规划/客户版/大族） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |
+| Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md`（询盘载体须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；花费默认 +30%～+50%；**不做**行业数据） |
 | Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |
 | TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |
 | Yandex 账户分析 / 周期 / 月报 | **P4** | `report-templates/yandex-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `yandex-period-report-excel.md` |

package/dist/skill/_meta.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.52",
-  "publishedAt": 1789457680165
+  "version": "1.1.53-beta.2",
+  "publishedAt": 1789552686722
 }

package/dist/skill/assets/google-quarterly-report.schema.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "siluzan-tso/google-quarterly-report.schema.json",
+  "title": "GoogleQuarterlyReport",
+  "description": "Google 季度经营报告。Agent 只写 narrative；kpis/monthly/specialAds/planDefaults/usStates（消耗最高国家的一级行政区）由 collect 覆盖。",
+  "type": "object",
+  "required": ["narrative"],
+  "properties": {
+    "narrative": {
+      "type": "object",
+      "required": ["executiveSummary", "sections", "plan"],
+      "properties": {
+        "executiveSummary": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string" }
+        },
+        "agenda": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "sections": {
+          "type": "object",
+          "required": ["efficiency", "adType", "region", "summary"],
+          "properties": {
+            "efficiency": { "$ref": "#/$defs/analysisBlock" },
+            "adType": { "$ref": "#/$defs/analysisBlock" },
+            "region": { "$ref": "#/$defs/analysisBlock" },
+            "summary": { "$ref": "#/$defs/analysisBlock" }
+          }
+        },
+        "plan": { "$ref": "#/$defs/analysisBlock" }
+      }
+    }
+  },
+  "$defs": {
+    "analysisBlock": {
+      "type": "object",
+      "properties": {
+        "analysis": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "goals": { "type": "array", "items": { "type": "string" } },
+        "text": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/skill/references/README.md CHANGED Viewed

@@ -92,6 +92,7 @@
 | `website-diagnosis-rules.md`            | 网站诊断评分项与 JSON Schema                              |
 | `meta-period-report-rules.md`           | Meta 周期报告内容丰富度与建议撰写规则                     |
 | `meta-period-report.schema.json`        | Meta 周期报告 Agent JSON Schema                           |
+| `google-quarterly-report.schema.json`   | Google 季度经营报告 Agent JSON Schema                     |
 | `pmax-create-template.md` / `.json`     | PMax 新建契约                                             |
 | `meta-lead-create-template.json` + `.md` | Meta Instant Form Lead Ad 契约                          |
 | `pmax-asset-group-template.json`        | PMax 素材组                                               |
@@ -106,6 +107,7 @@
 | 文件                                                             | 适用场景                       |
 | ---------------------------------------------------------------- | ------------------------------ |
 | `google-period-report.md`                                        | Google 账户周期/月度报告（P4） |
+| `google-quarterly-report.md`                                     | Google 季度经营报告（P10）     |
 | `google-period-report-excel.md`                                  | P4 用户要 Excel                |
 | `stats-daily-excel.md`                                           | P4-DAILY 按日 Excel            |
 | `meta-period-report.md` / `meta-period-report-excel.md`          | Meta 周期（P4-FB）             |

package/dist/skill/references/accounts/accounts-balance-stats.md CHANGED Viewed

@@ -96,7 +96,8 @@ siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 >
 > - **无** `--period` / `--date-start`；区间只用 `--start`/`--end`（别名 `--start-date`/`--end-date`）。
 > - 口语「零询盘 / 转化成本」且**无 CRM 询盘附件** → 本命令（P3），**不是** P7。
-> - `conversions` / `cpa` 可能为 **null**（overview 未返回转化）→ 交付写「转化未返回」；脚本勿对 null 做数值比较。过滤用 `--max-cpa` / `--zero-conversions`，勿手写脆弱 Python。
+> - `conversions` / `cpa` 可能为 **null**（overview 未返回转化）→ 交付写「转化未返回」；脚本勿对 null 做数值比较。过滤用 `--max-cpa` / `--zero-conversions`，巡检交付用 `agentBrief.userDelivery`，勿手写脆弱 Python 重算 CTR/合计。
+> - **没有** `cpa-risk-scan`。`--max-cpa` 的零转化仅当消耗已超过阈值才命中。`meta.totals` **只合计 returned**，禁止写成全部账户。`ctr` 已是百分数。
 ```bash
 siluzan-tso accounts-digest -m <媒体类型> [选项]
@@ -110,8 +111,9 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
 | `--end <YYYY-MM-DD>`          | 统计结束日期                                                                                                  | 昨天    |
 | `--start-date` / `--end-date` | 同 `--start` / `--end`（兼容别名）                                                                            | —       |
 | `--min-spend <n>`             | 过滤：区间内消耗 ≤ 此值的账户不返回                                                                           | `0`     |
-| `--max-cpa <n>`               | 过滤：保留 CPA > n 的账户；有消耗且转化为 0 视为命中（CPA 无穷）                                              | —       |
+| `--max-cpa <n>`               | 过滤：保留 CPA > n 的账户；零转化仅当消耗已 > n 才命中                                                        | —       |
 | `--zero-conversions`          | 过滤：保留区间消耗 > 0 且转化 = 0 或转化未返回的账户                                                          | off     |
+| `--skip-balance`              | 只拉消耗、不拉余额（转化成本巡检推荐）                                                                        | off     |
 | `--page-size <n>`             | 全量扫描时清单分页大小（上限 500）                                                                            | `200`   |
 | `--max-pages <n>`             | 全量扫描时最多页数（上限 200）                                                                                | `20`    |
 | `--json-out <path>`           | **Agent 推荐**：落盘目录或 `*.json` 文件；stdout 一行摘要（含 `outlineFile`、`writtenFiles`、`manifestFile`） | —       |
@@ -119,9 +121,10 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
 **`--json-out` 落盘**：
 - 目录模式典型文件：`accounts-digest-<媒体小写>.json`、同 stem 的 `*.outline.txt`、`cli-manifest-<媒体小写>.json`（读盘协议见 `references/core/agent-conventions.md` §三）。
-- 响应结构：`{ ok, data: { items: [...] }, meta: { media, window, scanned, returned, source, totals, nullConversionCount, currencyNote, generatedAt } }`。
+- 响应结构：`{ ok, data: { items: [...] }, meta, agentBrief }`。`meta.totalsScope` 恒为 `returned`（只合计命中行）。`agentBrief.userDelivery` 是可粘贴表或「全部正常」句；巡检任务**只发这一段**。
 - `meta.source`：`list` = 全量翻清单后拉数；`subset` = 传了 `-a`，跳过清单翻页（**`advertiserName` 会缺失**，公司名列显示 `-`）。
 - `meta.nullConversionCount`：`conversions == null` 的行数；交付时勿把 null 当 0 硬比。
+- `items[].ctr` 已是百分数（`11.01` = 11.01%）。`--json-out` 后 stderr 有一行防误读摘要。
 **与 `stats` / `balance-scan` 的分工**见 `references/core/agent-conventions.md` §八 批量任务硬约束。
@@ -141,9 +144,10 @@ siluzan-tso accounts-digest -m BingV2 --start 2026-05-01 --end 2026-05-24 \
 siluzan-tso accounts-digest -m Google -a id1,id2 --min-spend 10 \
   --start 2026-04-01 --end 2026-04-15 --json-out ./snap-p3
-# 转化成本巡检：CPA > 500（含有消耗零转化）
+# 转化成本巡检：CPA > 500（零转化仅消耗已超 500 才命中）；不拉余额
 siluzan-tso accounts-digest -m Google --start 2026-07-14 --end 2026-07-20 \
-  --max-cpa 500 --json-out ./snap-cpa
+  --max-cpa 500 --skip-balance --json-out ./snap-cpa
+# 读盘后 print(data.agentBrief.userDelivery) 原样发给用户
 # 零转化 / 口语「零询盘」巡检（无 CRM 附件时用本命令，不是 P7）
 siluzan-tso accounts-digest -m Google --start 2026-07-20 --end 2026-07-20 \

package/dist/skill/references/accounts/accounts-list.md CHANGED Viewed

@@ -167,7 +167,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 ---

package/dist/skill/references/accounts/accounts-permissions.md CHANGED Viewed

@@ -490,7 +490,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 | 功能                                    | 媒体   | 网页路径                                          |
 | --------------------------------------- | ------ | ------------------------------------------------- |
-| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
+| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 **Agent 建议话术**：
@@ -499,5 +499,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 siluzan-tso config show   # 查看 webUrl 字段
 # 账户激活（Google）→ 引导至账户管理页
-# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
 ```

package/dist/skill/references/accounts/finance.md CHANGED Viewed

@@ -126,7 +126,7 @@ siluzan-tso config show
 ### 充值页链接（按媒体 × 类型）
-链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
 | 充值类型                  | `<page>`              | 支持媒体（`mediaType` 参数）                |
 | ------------------------- | --------------------- | ------------------------------------------- |

package/dist/skill/references/accounts/open-account-by-media.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # 各媒体开户
-> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
+> 网页链接：`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 ## Contents

package/dist/skill/references/accounts/open-account-google-ui.md CHANGED Viewed

@@ -65,7 +65,7 @@ siluzan-tso open-account google-wizard
 ```bash
 siluzan-tso account-history -m Google
-# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 ---

package/dist/skill/references/analytics/account-analytics.md CHANGED Viewed

@@ -534,6 +534,7 @@ siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
 | 模板                                 | 用途                                                                                                            |
 | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
 | `google-period-report.md`            | Google 周期汇总报告章节                                                                                         |
+| `google-quarterly-report.md`         | Google 季度经营报告（`google-quarterly collect`+`render`，P10）                                                 |
 | `google-account-diagnosis-report.md` | Google 诊断报告纲要                                                                                             |
 | `google-ads-diagnosis.md`            | Google Ads 诊断报告完整骨架                                                                                     |
 | `meta-period-report.md`              | Meta（Facebook）周期报告                                                                                        |

package/dist/skill/references/analytics/rag.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。

package/dist/skill/references/analytics/reporting.md CHANGED Viewed

@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 | 媒体   | 报告类型         | URL 模板                                                    |
 | ------ | ---------------- | ----------------------------------------------------------- |
-| Google | 日报（Daily）    | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
-| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
-| TikTok | 日报             | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 日报（Daily）    | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
+| TikTok | 日报             | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
 `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

package/dist/skill/references/core/agent-conventions.md CHANGED Viewed

@@ -244,7 +244,7 @@
 | 任务                                   | 推荐命令                                                                                      | 禁止                                                                                         |
 | -------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
 | 多账户余额 / 预算不足预警              | `balance-scan -m <媒体> --threshold-days 7`（用 **`dailySpend`** / `remainingDays`）          | 逐账户 `balance --accounts ...`；把 `stats` 多日 **`spend` 当「日消耗」**                    |
-| 多账户投放画像                         | `accounts-digest -m <媒体> [-a ...] --start --end --json-out`（**`spend`=区间合计**）         | 逐账户 `stats`；把合计 `spend` 说成「每天花了」                                              |
+| 多账户投放画像 / 转化成本巡检          | `accounts-digest -m <媒体> [-a ...] --start --end --json-out`（CPA 加 `--max-cpa --skip-balance`；**`spend`=区间合计**；交付 `agentBrief.userDelivery`） | 发明 `cpa-risk-scan`；逐账户 `stats`；把 `meta.totals` 说成全部账户；把 `ctr` 再乘 100 |
 | 单户按日 Excel                         | `stats … --by-day --json-out`（P4-DAILY）                                                     | 默认 `stats` 当按日                                                                          |
 | 多账户 × 多维度 Google 数据            | 全量：`google-analysis-batch run`（省略 `-a`）；2~10：`google-analysis -a id1,id2,...`        | 外层 for-loop；先 list 再拼 `-a`                                                             |
 | 多系列诊断                             | `ad campaigns --json-out` + node 读文件过滤                                                   | 逐系列 `ad campaign-get`                                                                     |

package/dist/skill/references/core/cli-enums.md CHANGED Viewed

@@ -26,6 +26,15 @@
 > 逗号分隔；省略=全部。`final-urls`、`campaign-types` 不传日期。
+### `google-quarterly collect`
+| 命令 | 选项 | 说明 |
+| ---- | ---- | ---- |
+| google-quarterly collect | --inquiries | 运营询盘 **JSON**（数组或 `items`）；禁止传 xlsx/csv，由 Agent 先转 |
+| google-quarterly collect | --inquiry-conversion | 转化动作名称兜底 |
+| google-quarterly collect | --youtube-channel | 可选；本期报告不展示频道订阅总数 / 来源饼 |
+| google-quarterly collect | --keyword-seeds | 逗号分隔种子词（Keyword Planner，不是行业指数） |
 ### `google-analysis --level`（extensions 维度）
 | 命令                                  | 选项    | 合法值                          |

package/dist/skill/references/core/intent-routing.md CHANGED Viewed

@@ -144,7 +144,7 @@
 ## 零·D、强制规则：转化成本 / CPA / 零转化 /「零询盘」巡检（无 CRM）→ P3
-> 线上高频「**转化成本监控 / 昨日零询盘 / CPA 过高**」指的是 Google Ads **账户级转化次数与 CPA**，**不是** P7（P7 要用户上传 CRM 询盘明细）。命中下方信号且**未附带询盘附件/字段表**时，**一律 P3**，用 `accounts-digest`（可加 `--max-cpa` / `--zero-conversions`）。
+> 线上高频「**转化成本监控 / 昨日零询盘 / CPA 过高**」指的是 Google Ads **账户级转化次数与 CPA**，**不是** P7（P7 要用户上传 CRM 询盘明细）。命中下方信号且**未附带询盘附件/字段表**时，**一律 P3**，用 `accounts-digest`（`--max-cpa` / `--zero-conversions`；**没有** `cpa-risk-scan`）。
 ### D.1 信号词（命中任一即可；且无 CRM 询盘资料）
@@ -158,7 +158,7 @@
 ### D.2 命中后的 Agent 行为（强制）
 1. **直接定工作流 P3** → Read `playbooks.md` P3 + `accounts-balance-stats.md`（§ accounts-digest）。
-2. **必走 CLI**：确认区间后 `accounts-digest -m Google … --start <S> --end <D> --json-out ./snap-p3`；高 CPA 加 `--max-cpa <n>`；零转化/零询盘巡检加 `--zero-conversions`。
+2. **必走 CLI**：确认区间后 `accounts-digest -m Google … --start <S> --end <D> --json-out ./snap-p3`。高 CPA / 转化成本：`--max-cpa <n> --skip-balance`（零转化仅当消耗已 > n 才命中）；要全部空耗户加 `--zero-conversions`。**没有** `cpa-risk-scan`。读盘后把 `agentBrief.userDelivery` 原样发给用户。
 3. **需要转化动作明细**（conversion actions 拆解）时升 **P5**：`google-analysis-batch run --sections overview,conversion-actions …`（仍**禁止**当 P7）。
 4. **唯一例外 → P7**：用户**同时**给出 CRM 询盘资料（附件或粘贴字段表）且要「询盘效果 / 询盘分析」→ 走 **P7**。
@@ -168,6 +168,7 @@
 - **禁止**猜 `--period` / `--date-start`；只用 `--start`/`--end`（或 `--start-date`/`--end-date`）。
 - **禁止** WebSearch 编造转化/CPA；`conversions`/`cpa` 为 null 时写「转化未返回」，**禁止**对 null 做数值比较导致脚本崩溃。
 - **禁止**只落盘 JSON 不向用户交付排序表或「无命中」说明。
+- **禁止**发明 `cpa-risk-scan`；**禁止**把 `meta.totals` 当全量扫描合计；**禁止**把 `ctr` 再乘 100。
 ### D.4 示例
@@ -219,7 +220,8 @@
 | **P8**       | **单个网站 / 落地页 / URL** 的质量             | 见 **§零**（含网站/网络混说）；另：官网体检、投放前网站检查                                                                                 | **URL**                                                    | HTML（`website-diagnosis render`）          |
 | **P9**       | **行业 / 市场 / 战略**（**无网址主诉求**）     | 市场分析、**行业分析**、**行业分析报告**、市场调查报告、战略市场报告、KA 市场报告、竞品/GTM、「写一份 **XX 行业** 报告」（电商/制造/医疗…） | 客户名 / 行业 / 核心产品 **至少一项**（**不是** URL+诊断） | HTML（`market-analysis render`）            |
 | **P1**       | **单个 Google 广告账户** 的投放健康 / 诊断     | Google **广告**诊断、**账户**诊断报告、投放诊断、**账户**健康检查、**账户**体检（**且含 Google 账户 ID**）                                  | 账户 ID + 统计区间                                         | HTML（`google-ads-diagnosis render`）       |
-| **P4**       | **单个媒体广告账户** 某区间的 **周期汇总**     | 周期报告、月度报告、季度报告、月报、投放月报、Google 账户报告（**未强调「诊断/健康/网站/网址」**）                                          | 媒体 + 账户 ID + 区间                                      | HTML（默认）；用户要 Excel 见 P4 excel 纲要 |
+| **P4**       | **单个媒体广告账户** 某区间的 **周期数据汇总** | 周期报告、投放月报、**只要**花费/转化/8 维/Excel（**没有**规划/客户版/大族/询盘结构）                                                        | 媒体 + 账户 ID + 区间                                      | HTML（默认）；用户要 Excel 见 P4 excel 纲要 |
+| **P10**      | **单个 Google 账户** 客户版经营复盘 + **下期规划** | **月度报告**、**月总结与规划**、**季度报告**、**Q3 汇总**、**Q4 规划**、**季度汇报**、**投放季报**、客户版、大族模板、下月规划、效率+区域询盘+国家明细 | 账户 ID（季度可省略=上一完整季；月度=上一完整月）          | HTML（`google-quarterly render`）           |
 | **P4-DAILY** | **账户级按日表**（无多维）                     | 按天导出、投放数据 Excel（非 Google/Meta 周期报告）                                                                                         | 媒体 + 账户 ID + 区间                                      | xlsx（`stats --by-day`）                    |
 | **P4-FB**    | **Meta/Facebook 账户** 周期或诊断              | Facebook 报告、Meta 月报、FB **账户**诊断报告                                                                                               | Meta 账户 ID + 区间                                        | HTML（`facebook-analysis render`）；要表格 `--format xlsx` |
 | **P6**       | **OKKI 周报**（固定客户模板）                  | 见 §三魔法短语；「表格形式 / 表格 / 各维度表格」仍是 P6                                                                                      | 账户 ID + 区间                                             | **必产** 5 Sheet xlsx（`google-analysis okki-render`；禁止 Markdown 表/手写 HTML/Agent 手写 xlsx） |
@@ -253,7 +255,8 @@
 | 用户侧重点                                     | 正确工作流                            |
 | ---------------------------------------------- | ------------------------------------- |
 | 给了 **Google 账户 ID**，要健康/诊断/优化建议  | **P1**（`google-ads-diagnosis`）      |
-| 给了 **账户 ID**，要某月/某季 **投放数据汇总** | **P4**（按日表无多维 → **P4-DAILY**） |
+| 给了 **账户 ID**，**只要**花费/转化/8 维 **数据汇总**（无规划、无客户版结构） | **P4**（按日表无多维 → **P4-DAILY**） |
+| 给了 **Google 账户 ID**（或谷歌广告+客户），要 **月度/季度客户报告、Q 汇总&规划、季报、下月/下季规划** | **P10**（`google-quarterly`）          |
 | 给了 **URL / 网址 / 域名** + 诊断类词（§零）   | **P8**                                |
 | 只给 **行业名**（无 URL），要行业分析          | **P9**                                |
@@ -266,13 +269,14 @@
 | **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 / 报告 / 符合投放要求 / 能不能投**（含「网络诊断」「网络检测」） | **P8**          | 与 **§零** 同义；**优先 §零**；必 `website-diagnosis` CLI |
 | `OKKI 周报` / `okki 周报` / `使用 okki 周报模板`                                                                                            | **P6**          | **不按 P4 默认 8 维**；写 JSON 后 `okki-render` 出 xlsx；「表格形式」= Excel，禁止对话 Markdown 表 / Agent 手写 xlsx |
 | `Google 账户询盘分析` / `分析 … Google 账号的询盘效果`（**且有询盘附件/字段表**）                                                           | **P7**          | 严格 3 个月窗口；无 CRM → 改 **§零·D / P3**               |
-| `转化成本监控` / `CPA 监控` / `谷歌ADS转化成本` / `低余额账户转化成本`                                                                      | **P3（§零·D）** | `accounts-digest`；可加 `--max-cpa`                       |
+| `转化成本监控` / `CPA 监控` / `谷歌ADS转化成本` / `低余额账户转化成本`                                                                      | **P3（§零·D）** | `accounts-digest --max-cpa --skip-balance`；贴 `agentBrief.userDelivery` |
 | `昨日零询盘` / `零询盘账户` / `0 转化` / `有消耗无转化`（**无 CRM 附件**）                                                                  | **P3（§零·D）** | `--zero-conversions`；**不是 P7**                         |
 | `根据 … 生成 Google **搜索**广告` / `搜索广告方案` / `关键词表` + 官网 URL                                                                  | **W3**          | ≠ P8 ≠ P9；若同时要 **搜索量/竞争度** → **W5**            |
 | `展示广告` / `Display 广告` / `自适应展示广告` / `RDA`（要创建/出方案）                                                                     | **不支持**      | 仅 Search + PMax；告知后可改推 W3                         |
 | `建 TikTok 广告` / `建抖音广告` / `建 Bing 广告` / `建 Yandex 广告`                                                                        | **不支持搭建**  | 可改 P4 账户分析或 W2 开户；禁止 `ad` / `meta-ad`         |
 | **月搜索量** / **竞争度** / **Keyword Planner** / **长尾关键词** / **针对核心词推荐**                                                       | **W5（§零·C）** | 必 `keyword --google-only`                                |
 | `丝路赞` / `Siluzan` + `优化报告列表` / `报告推送`                                                                                          | **W7**          | ≠ 自拉数 P1/P4                                            |
+| `季度经营报告` / `季度报告` / `季度汇报` / `投放季报` / `季度客户报告` / `Q3汇总` / `Q4规划` / `Q3Q4` / `下季度规划` / `下月规划` / `月总结与规划` / `月度报告`（含效率/区域询盘/国家/规划/客户版/大族） | **P10**         | ≠ P4「只要花费转化」；≠ P1；提「行业参考」仍 P10，禁止编行业数 |
 ---
@@ -292,6 +296,7 @@
 | **询盘** + Google 账户 + **CRM 询盘资料**                                 | P4、P1 简版诊断、P3 账户级 CPA 巡检                     |
 | 仅 **WebSearch 写行业长文**                                               | 代替 P9 `collect`+`render`                              |
 | 仅 **Markdown 摘要**                                                      | 代替 P8/P9/P1 的 HTML `render`                          |
+| **月度报告 / 月总结与规划 / 季度报告 / 季度汇报 / 投放季报 / Q 汇总 & 规划 / 大族 / 客户版** | P4「只要花费转化」、P1 诊断、P9 行业（即使用户带「行业参考」） |
 ---
@@ -315,8 +320,10 @@
 | ----------- | ------------ | ----------------------------------------------------------------- |
 | P8          | URL          | 「网站诊断需要完整网址，请发官网链接（`https://` 或域名均可）。」 |
 | P9          | 四选一全空   | 「请给行业名（如电商）或客户名/核心产品至少一项。」               |
-| P1 / P4     | 账户 ID      | 「请提供 Google 广告账户 ID（mediaCustomerId）。」                |
+| P1 / P4 / P10 | 账户 ID    | 「请提供 Google 广告账户 ID（mediaCustomerId）。」                |
 | P1 / P4     | 时间         | 按 `agent-conventions.md` §五 反问区间                            |
+| P10         | 时间         | 季度话术可省略（上一完整季）；月度报告 / 下月规划用上一完整月或用户指定月 |
+| P10         | 询盘附件     | 先转 `inquiries.json` 再 `--inquiries`；**禁止**把 xlsx/csv 原文件传给 collect |
 | P6          | 非 OKKI 话术 | 若用户实际要普通周期报告 → 改 P4 并说明                           |
 | P7          | 无询盘文件   | 贴字段清单，**禁止编造询盘**；若用户只要账户级零转化 → 改 **P3**  |
 | P3（§零·D） | 时间区间     | 按 `agent-conventions.md` §五 反问；巡检默认近 7 天须写明区间     |
@@ -328,7 +335,7 @@
 | SKILL 路由表章节                                  | 本文件章节                                        |
 | ------------------------------------------------- | ------------------------------------------------- |
-| 分析与报告（P1–P9）                               | **§零**、**§零·B**、**§零·D**、§二、§三           |
+| 分析与报告（P1–P10）                              | **§零**、**§零·B**、**§零·D**、§二、§三           |
 | 行业 / 市场分析报告 P9（100% 走 CLI）             | **§零·B**、§二 P9、§四                            |
 | Google Ads 关键词规划 W5（100% 走 `keyword` CLI） | **§零·C**、§二 W5、§三、§四                       |
 | 转化成本 / CPA / 零转化巡检 P3                    | **§零·D**、§二 P3、§三、§四                       |

package/dist/skill/references/core/playbooks.md CHANGED Viewed

@@ -1,4 +1,4 @@
-# 工作流目录 · 分析 / 报告类（P1–P9）
+# 工作流目录 · 分析 / 报告类（P1–P10）
 > **范围**：CLI 拉数 → 脚本读盘 → Agent 撰稿 → 交付的报告/分析任务。操作/管理类见 `references/core/workflows.md`（W1–W12）。
 > **通用纪律见 `references/core/agent-conventions.md`**（读盘、时间范围、币种、交付自检）；各卡片只写本任务步骤。卡片字段：`触发 / 必读 / 步骤 / 产物`。完整参数表见「必读」指向的命令文档。
@@ -16,6 +16,7 @@
 | P7    | Google 询盘分析        | 严格 3 个月 8 Sheet xlsx               |
 | P8    | 网站诊断               | website-diagnosis，默认 HTML           |
 | P9    | 战略市场分析           | market-analysis，默认 HTML             |
+| P10   | Google 季度经营报告    | 复盘 + 下期规划 HTML（大族版式）       |
 ---
@@ -54,19 +55,23 @@
 - **反模式**：
   - **有 CRM 询盘附件/字段表** → 改 **P7**，不要用本卡片。
   - **禁止**猜 `--period` / `--date-start`；只用 `--start`/`--end`（或 `--start-date`/`--end-date`）。
+  - **禁止**发明 `cpa-risk-scan` / `cpa-scan`（拦截会提示改用本命令）。
   - `conversions`/`cpa` 为 null 时写「转化未返回」，**禁止**对 null 做 `>` 比较导致脚本崩溃。
+  - **禁止**把 `meta.totals` 写成「全部账户」合计（`totalsScope=returned`，只合计命中行）。
+  - **禁止**把 `ctr` 再 `.2%` / `*100`（已是百分数）。
 - **步骤**：
   1. 确认时间范围后执行 `accounts-digest -m <媒体> -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3`（全量则省略 `-a`）。
-  2. **高 CPA 巡检**：加 `--max-cpa <n>`（保留 CPA > n，或有消耗且转化为 0 的账户）。
-  3. **零转化 / 零询盘巡检**：加 `--zero-conversions`（有消耗且转化 = 0 或未返回）。
-  4. 基于落盘 `data.items` 与 `meta.totals` 生成报告，**不要**再逐账户 `stats`。
-- **产物**：向用户交付排序表（或明确「无命中」）；表格覆盖用户请求的**每一个** ID（未返回的占一行标注「未返回」）。Markdown 单元格须把 `|` 换成 `｜`。**禁止**只落盘不说话。
+  2. **高 CPA / 转化成本巡检**：`--max-cpa <n> --skip-balance`（CPA > n，或零转化且消耗已 > n）。读盘后**只把 `agentBrief.userDelivery` 原样发给用户**（无命中即「全部正常」句；有命中只贴表）。
+  3. **零转化 / 零询盘巡检**（要全部空耗户，含小额）：加 `--zero-conversions`。
+  4. 指定子集对比表：基于 `data.items`；**不要**再逐账户 `stats`。
+- **产物**：巡检任务交付 `agentBrief.userDelivery`（或用户给的固定「全部正常」句）；对比表覆盖用户请求的**每一个** ID（未返回的占一行标注「未返回」）。Markdown 单元格须把 `|` 换成 `｜`。没有系列/关键词数据时**禁止**写暂停关键词、改落地页。**禁止**只落盘不说话。
 ---
 ## P4 · Google 账户周期报告
-- **触发**：Google 账户某区间的周期/月度/季度汇总报告；或用户列出 Sheet/章节要 **Excel**（非 OKKI / 询盘）。
+- **触发**：Google 账户某区间的周期**数据汇总**（只要花费/转化/8 维，或用户列出 Sheet 要 **Excel**）。非 OKKI / 询盘 / **非**客户版经营报告。
+- **不是 P10**：出现「月度报告 / 月总结与规划 / 季度报告 / Q3 汇总 / Q4 规划 / 季度汇报 / 投放季报 / 客户版 / 大族模板 / 下月规划 / 效率+区域询盘+国家明细」→ **P10**（即使带「行业参考」也不改 P9）。
 - **必读**：`report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；**要 Excel** 加 `report-templates/google-period-report-excel.md`（全文）。
 - **步骤**：
   1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户。
@@ -184,3 +189,20 @@
   3. 按 `market-analysis-rules.md` 维度表**逐章 WebSearch** 撰写，脚本落盘 `./snap-market/market-report.json`。
   4. 渲染：`market-analysis render --data ./snap-market/market-report.json --out ./snap-market/market-analysis-report.html`；报缺项时**只补缺失维度**后重写 JSON。
 - **产物**：交付 HTML 路径并说明需联网加载 CDN。
+---
+## P10 · Google 季度经营报告
+- **触发**（命中越多越稳）：Google/谷歌广告 **月度报告**、**月总结与规划**、**季度报告**、**Q3 汇总**、**Q4 规划**、**季度汇报**、**投放季报**、客户版/对外、大族模板、下月规划；或要「效率 + 区域询盘 + 国家明细 + 规划」；或「结论→效率→结构→新探索→总结→Q4」。**不是** P1 诊断、**不是** P4「只要花费转化」的周期表。用户提「行业参考」仍走 P10，**禁止编造行业数**（本批无行业章）。
+- **必读**：`report-templates/google-quarterly-report.md`。
+- **默认产物**：**HTML**（`google-quarterly render`）。
+- **步骤**：
+  1. 确认账户与区间：季度话术省略日期 → 上一完整自然季；**月度报告 / 下月规划** → 上一完整自然月（或用户指定月）作 `--start/--end`。
+  2. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p10`（取户名、币种）。
+  3. **询盘载体 → JSON（CLI 不读 xlsx）**：用户给了 xlsx / csv / 截图 / 粘贴表 → Agent 抽行落盘 `./snap-p10/inquiries.json`（字段见 `google-quarterly-report.md`「询盘入场」）再 `--inquiries`；**禁止**把原始文件传给 collect。无载体可 `--inquiry-conversion <名>`；再没有则询盘位留空，**禁止编造**。
+  4. `google-quarterly collect -a <id> --start <S> --end <D> --json-out ./snap-p10 --account-name "<名>"`（可选 `--keyword-seeds`）。YouTube 广告层用 Ads 视频报表，不拉频道订阅总数 / 来源饼 / 视频类型。
+  5. 读 `google-quarterly-collect.json`，只写 `narrative` 到 `google-quarterly.json`（禁止改 kpis / monthly / planDefaults 数字）。
+  6. 下期规划默认花费 +30%～+50%（用 `planDefaults.spendLow`～`spendHigh`）；CPA/询盘目标不自动外推。
+  7. `google-quarterly render --data ./snap-p10/google-quarterly.json --out ./snap-p10/google-quarterly-report.html`。
+- **产物**：HTML 路径；专项广告无量则模板自动隐藏该章。

package/dist/skill/references/core/setup.md CHANGED Viewed

@@ -10,7 +10,7 @@
 ## 安装 CLI
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -127,9 +127,9 @@ siluzan-tso config show
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```

package/dist/skill/references/core/tips.md CHANGED Viewed

@@ -139,11 +139,15 @@ const snap = './snap-p3';
 const d = require(path.join(snap, 'accounts-digest-google.json'));
 const rows = d.data?.items || [];
 const meta = d.meta || {};
-console.log('区间:', meta.window?.startDate, '~', meta.window?.endDate);
-console.log('返回', rows.length, '户，扫描', meta.scanned);
-rows.slice(0, 10).forEach((r) =>
-  console.log(' ', r.mediaCustomerId, r.spend, r.currencyCode, 'CTR%', r.ctr),
-);
+if (d.agentBrief?.userDelivery) {
+  console.log(d.agentBrief.userDelivery);
+} else {
+  console.log('区间:', meta.window?.startDate, '~', meta.window?.endDate);
+  console.log('返回', rows.length, '户，扫描', meta.scanned, 'totalsScope', meta.totalsScope);
+  rows.slice(0, 10).forEach((r) =>
+    console.log(' ', r.mediaCustomerId, r.spend, r.currencyCode, 'CTR%', r.ctr),
+  );
+}
 "
 ```

package/dist/skill/references/misc/tso-home.md CHANGED Viewed

@@ -6,7 +6,7 @@
 siluzan-tso config show   # 取 webUrl
 ```
-首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 ---
@@ -25,7 +25,7 @@ siluzan-tso config show   # 取 webUrl
 ## 推荐话术
-1. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/v3/foreign_trade/tso/home`。
+1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
 2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
 3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。

package/dist/skill/references/report-templates/README.md CHANGED Viewed

@@ -22,6 +22,7 @@
 | 文件                                         | 适用场景                                                                                                                                                          |
 | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `google-period-report.md`                    | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML                                                                           |
+| `google-quarterly-report.md` / `.html`       | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费默认 +30%～+50%；无行业章                                                                |
 | `google-period-report-excel.md`              | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令                                                   |
 | `stats-daily-excel.md`                       | **P4-DAILY**：账户级按日 Excel（`stats --by-day`）                                                                                                                |
 | `google-account-diagnosis-report.md`         | Google 账户深度诊断（健康度/转化/结构等）                                                                                                                         |