siluzan-tso-cli 1.1.12 → 1.1.13

package/dist/skill/SKILL.md

@@ -2,12 +2,11 @@
 name: siluzan-tso
 description: 当判断用户可能需要以下功能时可以使用siluzan-tso这个skillGoogle,Bing,Yandex,Tiktok,Kwai等广告账户的开户，账号数据分析共享/取消共享、Google MCC 绑定/解绑、Meta BM 绑定、TikTok BC 绑定/解绑TikTok 关闭、暂停 Google 账户撤回、Google 电子邮件访问邀请）；优化报告（TSO 管理员）、报告电子邮件推送、Meta/TikTok/Bing 账户分析发票及发票结算配置文件（发票信息）；优化和智能预警；TikTok/Meta潜在客户表单完整的Google广告管理，包括附加信息、地理位置定位和搜索词，以及关键词建议。Google广告账户详细的投放数据分析。
 license: MIT
-metadata: 
+metadata:
   requires: nodejs,siluzan-tso-cli
 allowed-tools: Bash(siluzan-tso:*) Read
 ---
 
-
 # Siluzan TSO Skill
 
 本 Skill 只保留任务边界、文档路由与执行规则。具体业务细节、参数、模板、流程与示例均以下方 references 文档为准。遇到具体业务时，先读对应 references
@@ -36,10 +35,11 @@ allowed-tools: Bash(siluzan-tso:*) Read
 使用本 Skill 前，以下组件必须已安装并就绪：
 
 ### 可选环境变量
-| 变量 | 说明 |
-|------|------|
-| `SILUZAN_API_KEY` | 从环境变量读取 API Key（优先级高于 config.json，CI/CD 推荐） |
-| `SILUZAN_AUTH_TOKEN` | 从环境变量读取 JWT Token（优先级高于 config.json） |
+
+| 变量                      | 说明                                                               |
+| ------------------------- | ------------------------------------------------------------------ |
+| `SILUZAN_API_KEY`         | 从环境变量读取 API Key（优先级高于 config.json，CI/CD 推荐）       |
+| `SILUZAN_AUTH_TOKEN`      | 从环境变量读取 JWT Token（优先级高于 config.json）                 |
 | `SILUZAN_DATA_PERMISSION` | 从环境变量读取数据权限标识（优先级高于 config.json，跳过自动拉取） |
 
 如果上述依赖缺失，请先参照 `references/setup.md` 完成安装与配置。
@@ -62,48 +62,65 @@ allowed-tools: Bash(siluzan-tso:*) Read
 | `references/forewarning.md` | 智能预警规则与通知 |
 | `references/finance.md` | 转账、开票、发票抬头、充值网页引导 |
 | `report-templates/report-template.html` | 默认 HTML 报告样式参考 |
+
 ---
 
 ## Skill要如何使用
 
 ### 报告的生成
+
 报告分为两种：
+
 - （不推荐）由siluzan平台在你调用接口提交后直接异步生成的报告(调用对应命令后，会返回一条报告链接)（详情请读取：`references/reporting.md`）
   - 这种报告你无法用它来做数据分析除非用户明确要求（Siluzan平台的优化报告）
 - （推荐，默认生成这种报告）由你主动拉取数据，并按照skill给出的格式，输出给用户：详情请查看（`references/account-analytics.md`）
 
 ### 广告账户相关
+
 - 广告账户开户请阅读： `references/open-account-by-media.md`
 - 广告账户管理请阅读：`references/accounts.md`
 - 广告账户分析请阅读：`references/account-analytics.md`
 - Google广告的创建、修改、优化、查询广告详情等广告管理相关的功能：请阅读：`google-ads.md`
 
 ### 只调用接口，最终交付的内容不需要你输出的功能
+
 - Google广告优化记录功能(`references/optimize.md`)，这个也跟优化报告类似，你调用接口，Siluzan平台按照一定的优化逻辑自动执行，你只能查询到结果，不能控制优化流程 注意不要与`google-ads.md`中的优化流程混淆两个是互相独立的功能，`references/google-ads.md`中的优化功能更为强大，在实际的优化过程中，也推荐使用`references/google-ads.md`中提供的内容
 - TikTok / Meta 线索表单请阅读：`references/clue.md`
 - Siluzan平台提供的预警功能请阅读：`references/forewarning.md`
   - 预警由Siluzan平台发送，当前仅支持微信推送，如果需要自定义的通知触达端，需要安装对应插件或skill+创建定时任务来完成
 - 转账、开票、发票抬头、充值网页引导请阅读：`references/finance.md`
-- 
+-
+
 ## AI 行为规范
+
 ### 如何更好的使用本skill执行任务
+
 遵循计划，确认，执行，验证，推测用户下一步意图
+
 1. 计划阶段：
-  - 根据功能以及对应文档读取对应references
-  - 根据references文件中的内容配合命令行工具提供的-h参数，来确认命令行的正确调用方式
-  - 向用户输出一份操作计划，简要说明每一步将做什么
+
+- 根据功能以及对应文档读取对应references
+- 根据references文件中的内容配合命令行工具提供的-h参数，来确认命令行的正确调用方式
+- 向用户输出一份操作计划，简要说明每一步将做什么
+
 2. 确认阶段：与用户确认关键信息（尤其是涉及写入/修改/删除的操作）
 3. 执行阶段：按计划执行，向用户说明每步操作意图
 4. 验证阶段：
-  - 一般情况下，读取/写入的命令都是成对的。通过这两种命令的配合来进行结果验证
-  - 如果是异步任务，需要你轮询读取命令，每5s一次查看任务状态，直到确认所有异步任务都有一个结果
-  - 如果失败则可以查看失败具体原因，或者结合现有命令行使用其他方式进行重试，尽量让任务执行完成，而不是告诉用户任务失败就结束了。
+
+- 一般情况下，读取/写入的命令都是成对的。通过这两种命令的配合来进行结果验证
+- 如果是异步任务，需要你轮询读取命令，每5s一次查看任务状态，直到确认所有异步任务都有一个结果
+- 如果失败则可以查看失败具体原因，或者结合现有命令行使用其他方式进行重试，尽量让任务执行完成，而不是告诉用户任务失败就结束了。
+
 5. 对话历史验证：
-  - 如果任务前面有计划，你需要确认每个步骤都已经按计划中的内容执行完毕
+
+- 如果任务前面有计划，你需要确认每个步骤都已经按计划中的内容执行完毕
+
 6. 完成任务后的输出
-  - 结合命令行工具与references文件中的说明，对用户下一步的操作进行合理预测
+
+- 结合命令行工具与references文件中的说明，对用户下一步的操作进行合理预测
 
 ### 硬规范
+
 - **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件或使用-h查看命令帮助，不要猜参数。
 - **先查账户再操作**：对具体账户做操作前，先通过 `list-accounts -m [mediaType] -k [mediaCustomerId]` 确认。特别是不确定是Google/Bing/TikTok这些媒体平台中的哪一个的时候
 - **使用 --json 处理数据**：需对返回数据做计算或筛选时，加 `--json`，再用 `node -e` 过滤提取（见 `references/tips.md`）。
@@ -127,13 +144,13 @@ allowed-tools: Bash(siluzan-tso:*) Read
 
 ### 默认值白名单（仅在用户明确授权"你决定"时才能使用）
 
-| 场景 | 允许的默认窗口 |
-|------|--------|
-| 日常投放巡检 / 余额扫描 | `now - 7d` ~ `now`（本地时间） |
-| 周报 | 上一个完整自然周（周一 00:00 ~ 周日 23:59） |
-| 月报 | 上一个完整自然月（1 号 ~ 月末） |
-| Google 关键词/系列分析 | `now - 30d` ~ `now`（与 TSO Google 接口最小窗口对齐） |
-| MetaAd 账户分析 | 不得默认，必须问（Meta 接口对窗口敏感） |
+| 场景                    | 允许的默认窗口                                        |
+| ----------------------- | ----------------------------------------------------- |
+| 日常投放巡检 / 余额扫描 | `now - 7d` ~ `now`（本地时间）                        |
+| 周报                    | 上一个完整自然周（周一 00:00 ~ 周日 23:59）           |
+| 月报                    | 上一个完整自然月（1 号 ~ 月末）                       |
+| Google 关键词/系列分析  | `now - 30d` ~ `now`（与 TSO Google 接口最小窗口对齐） |
+| MetaAd 账户分析         | 不得默认，必须问（Meta 接口对窗口敏感）               |
 
 ### 金额与货币单位硬约束
 
@@ -154,13 +171,14 @@ allowed-tools: Bash(siluzan-tso:*) Read
 
 以下情形**必须**使用批量 / 扫描命令而非循环单条调用，否则严重拖慢并易卡死：
 
-| 任务 | 推荐命令 | 禁止做法 |
-|------|----------|----------|
-| 多账户余额 / 预算不足预警 | `balance-scan -m <媒体> --threshold-days 7` | 逐账户循环 `balance --accounts ...` |
-| 多账户投放画像（消耗/点击/转化汇总） | `accounts-digest -m <媒体> [-a id1,id2] --start --end --json` | 对每个账户依次 `stats --id ...` |
-| 多系列诊断 | `ad campaigns --json` + node 过滤 | 逐系列 `ad campaign-get` |
+| 任务                                 | 推荐命令                                                      | 禁止做法                            |
+| ------------------------------------ | ------------------------------------------------------------- | ----------------------------------- |
+| 多账户余额 / 预算不足预警            | `balance-scan -m <媒体> --threshold-days 7`                   | 逐账户循环 `balance --accounts ...` |
+| 多账户投放画像（消耗/点击/转化汇总） | `accounts-digest -m <媒体> [-a id1,id2] --start --end --json` | 对每个账户依次 `stats --id ...`     |
+| 多系列诊断                           | `ad campaigns --json` + node 过滤                             | 逐系列 `ad campaign-get`            |
 
 如果命令行尚未提供批量入口（例如 117 个 Bing 账户的"剩余天数"计算），应：
+
 1. 先用 `list-accounts -m BingV2 --json` 一次性拿到全量账户（含余额/日均消耗），**不要**逐账户轮询余额。
 2. 通过 `node -e` 在本地做 `剩余天数 = 余额 / 近 7 日日均消耗` 的计算并筛选阈值。
 3. 只对命中的账户再做后续写入操作。
@@ -168,6 +186,7 @@ allowed-tools: Bash(siluzan-tso:*) Read
 ### 运行时长与用户可见进度
 
 长任务（多账户、批量优化、报告生成）**必须**满足：
+
 - 预估超过 2 分钟的任务，开始前先告诉用户"预计耗时 X 分钟，将以 X 个账户一批处理"。
 - 每处理一批输出一行进度（例如 `已处理 20 / 117`）。
 - 处理超过 5 分钟仍未完成时，主动检查是否有必要降级（例如从"完整分析"降为"只筛阈值"）并告知用户。
@@ -221,6 +240,7 @@ siluzan-tso balance-scan -m BingV2 --threshold-days 7 --json
 ```
 
 输出结构（`--json`）：
+
 ```json
 {
   "ok": true,
@@ -230,6 +250,7 @@ siluzan-tso balance-scan -m BingV2 --threshold-days 7 --json
 ```
 
 硬规矩：
+
 - **绝对不要** `for id of ids { balance --accounts id }` 循环，会把 117 个账户拖成几十分钟。
 - 输出报告时按 `remainingDays` 升序（命令默认已排）；金额展示用命令返回的 `balance`/`recommendedTopup` 数值 + `currencyCode`。
 - 若 `--verbose` 发现大量账户进入"僵尸账户（消耗过低）"分支，告诉用户这些账户没真正投放，不纳入预警。
@@ -252,6 +273,7 @@ siluzan-tso accounts-digest -m Google \
 - 不指定 `--start/--end` 时默认近 7 天；**SKILL 要求必须先与用户确认时间范围**，再把用户确认的区间带上。
 
 标准步骤：
+
 1. **反问时间范围**（P 级硬约束），拿到用户回复后再执行 `accounts-digest`。
 2. 如命令已返回 `--json`，直接基于其中 `data.items` 与 `meta.totals` 生成报告；**不要**再逐账户 `stats`。
 3. 跨币种账户：按 `item.currencyCode` 分表或在 meta.currencyNote 提示的前提下分币种小计。
@@ -270,8 +292,9 @@ siluzan-tso accounts-digest -m Google \
 ## 一些tips
 
 ### 账户ID示例
-用于快速确定用户发送账号的类型,xxx是脱敏处理，一般主要通过位数就能确定账号类型，无法确定再查list-account -m [mediatype] -k [id] 
-Google: 4545xxx137
+
+用于快速确定用户发送账号的类型,xxx是脱敏处理，一般主要通过位数就能确定账号类型，无法确定再查list-account -m [mediatype] -k [id]
+Google: 454xxx5137 有些客户可能会发你270-xxx-0720 这种类型的，也是google账户，只不过使用时需要将数字间的-去掉 -> 270xxx0720
 Tiktok: 70083497xxx59820033
 Meta(Facebook): 1716030xxx734076, 6843984xxx14909, 479423xxx752348
 Bing: 138xxx763， 1882xxx80
@@ -279,7 +302,9 @@ Yandex: porg-uthxxxrk
 Kwai: act_1716030xxx734076
 
 ### 报告模板外部资源声明
+
 HTML 报告模板（`report-templates/*.html`）引用了以下外部 CDN 资源，渲染 HTML 报告时浏览器会发出对应的网络请求：
+
 - `cdn.tailwindcss.com` — Tailwind CSS（布局样式）
 - `cdnjs.cloudflare.com` — Font Awesome 6（图标）
 - `cdn.jsdelivr.net` — ECharts 5（图表）
@@ -288,12 +313,46 @@ HTML 报告模板（`report-templates/*.html`）引用了以下外部 CDN 资源
 如果处于离线环境或需要避免外部网络请求，请将上述资源下载到本地后修改模板中的引用路径。
 
 ### 容易出错http状态码
+
 - 400 Bad Request
-参数错误，请你查看对应功能reference或使用-h了解命令行如何使用
+  参数错误，请你查看对应功能reference或使用-h了解命令行如何使用
 
 - 401 Unauthorized
-注意是平台方返回的还是我们自己返回的401，通常，平台方（google,bing, yandex，tiktok,kwai）返回的需要用户重新授权
-如果是我们自己的接口返回的，则可以让用户 重新打开命令行执行 `siluzan-tso login`（详情请读取`references/setup.md`）
+  注意是平台方返回的还是我们自己返回的401，通常，平台方（google,bing, yandex，tiktok,kwai）返回的需要用户重新授权
+  如果是我们自己的接口返回的，则可以让用户 重新打开命令行执行 `siluzan-tso login`（详情请读取`references/setup.md`）
+
+- 500
+  大概率是服务可能正在部署或升级，可以让用户提交给Silizan相关人员
+
+---
+
+## 下面是一部分比较实用的自动化场景，当你回答完用户问题后，可以把下面的内容输出给用户，方便用户使用
+
+您可以选择以下的预警或提醒，输入需想要执行的内容核实规则即可配置。
+
+### 预算 & ROI 控制引擎
+
+| 提醒名称            | 系统在后台默默帮你做什么？(自动动作)                      |
+| ------------------- | --------------------------------------------------------- |
+| 1. 单日预算熔断     | 每日消耗达到设定值，自动暂停计划，杜绝 Google 超额扣费。  |
+| 2. CPA 飙升自动降价 | 光点不转化（如花费超过3倍目标成本），自动关停该条烂广告。 |
+| 3. 连续空耗自动暂停 | 大盘流量变贵、获客成本飙高时，系统自动下调出价避险。      |
+
+### 异常监控与报警系统
+
+| 功能名称          | 监控层级 / 说明                                             |
+| ----------------- | ----------------------------------------------------------- |
+| 1. 账户被封禁     |                                                             |
+| 2. 落地页死链强停 | 网站宕机或链接填错，紧急自动暂停关联广告，防止把钱扔水里。  |
+| 3. 广告素材拒审   | 发现被 Google 封号或快没钱了，立刻发送企微/钉钉高优强提醒。 |
+| 4. 花费异动监控   | 花费突然暴涨或断崖式下跌，系统即时报警提示人工盯盘。        |
+| 5. 余额枯竭预警   | 广告被 Google 拦截，系统自动帮你打包违规原因并定时推送。    |
+
+### 自动优化
 
-- 500 
-大概率是服务可能正在部署或升级，可以让用户提交给Silizan相关人员
+| 功能名称                | 监控层级                                                                   |
+| ----------------------- | -------------------------------------------------------------------------- |
+| 1. 表现差广告降价/关停  | 发现转化极好的「好苗子」，以安全幅度自动涨预算/提价去抢量。                |
+| 2. 高转化广告提价扩量   | 连续几天表现垫底的垃圾素材，系统扮演无情杀手自动关停。                     |
+| 3. A/B测试自动决出胜者  | 科学赛马，根据真实转化价值自动关停输家，把流量全给赢家。                   |
+| 4. 异动根因自动排查建议 | 老板问为什么成本翻倍？系统一键生成诊断报告（揪出外部竞对或内部操作失误）。 |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.12",
-  "publishedAt": 1776410305637
+  "version": "1.1.13",
+  "publishedAt": 1776762370285
 }

package/dist/skill/assets/campaign-create-template.json

@@ -1,104 +1,99 @@
 {
-    "account": "6326027735",
-    "customerName": "账户显示名称（来自 list-accounts --json 的 mediaAccountName）",
-    "name": "搜索-品牌词-2026",
-    "budget": 100,
-    "bidding": "TARGET_SPEND",
-    "bidCeiling": 1.5,
-    "locationIds": ["2840", "2826", "2036"],
-    "languageIds": ["1000", "1017"],
-    "startDate": "2026-04-01",
-    "endDate": "2027-04-01",
-    "url": "https://www.example.com",
-    "status": "Enabled",
-    "adgroupName": "核心词_品牌词",
-    "maxCpc": 1.5,
-    "matchType": "BROAD",
-    "keywords": [
-      "brand keyword 1",
-      "brand keyword 2",
-      "brand keyword 3"
-    ],
-    "headlines": [
-      "Brand Name: Quality Products",
-      "Trusted For Over 20 Years",
-      "Global Reach, Local Impact",
-      "Contact Us Today",
-      "Request A Free Quote Now"
-    ],
-    "descriptions": [
-      "Top-quality products with certified standards. Contact us today!",
-      "Trusted by global partners. Request a free quote now!"
-    ],
-    "finalUrl": "https://www.example.com/products",
-    "path1": "products",
-    "path2": "2026",
-    "productWords": ["brand", "product"],
-    "negativeKeywords": [
-      "free", "cheap", "wikipedia", "pdf", "ebay", "amazon"
-    ],
-    "extensions": [
-      {
-        "level": "Campaign",
-        "typeV2": "CALL",
-        "AssetFieldType": "CALL",
-        "Properties": { "ContryCode": "CN", "PhoneNumber": "+86 400-XXX-XXXX" }
-      },
-      {
-        "level": "Campaign",
-        "typeV2": "SITELINK",
-        "AssetFieldType": "SITELINK",
-        "properties": {
-          "DestinationUrl": "https://www.example.com/about",
-          "Text": "About Us",
-          "Line2": "Learn about our story",
-          "Line3": "Explore our mission"
-        }
-      },
-      {
-        "level": "Campaign",
-        "typeV2": "STRUCTURED_SNIPPET",
-        "AssetFieldType": "STRUCTURED_SNIPPET",
-        "StructuredSnippetHeaderValue": {
-          "key": "Services",
-          "value": ["Quality Certified", "Global Shipping", "24/7 Support"]
-        }
+  "account": "6326027735",
+  "customerName": "账户显示名称（来自 list-accounts --json 的 mediaAccountName）",
+  "name": "搜索-品牌词-2026",
+  "budget": 100,
+  "bidding": "TARGET_SPEND",
+  "bidCeiling": 1.5,
+  "locationIds": ["2840", "2826", "2036"],
+  "languageIds": ["1000", "1017"],
+  "startDate": "2026-04-01",
+  "endDate": "2027-04-01",
+  "url": "https://www.example.com",
+  "status": "Enabled",
+  "adgroupName": "核心词_品牌词",
+  "maxCpc": 1.5,
+  "matchType": "BROAD",
+  "keywords": ["brand keyword 1", "brand keyword 2", "brand keyword 3"],
+  "headlines": [
+    "Brand Name: Quality Products",
+    "Trusted For Over 20 Years",
+    "Global Reach, Local Impact",
+    "Contact Us Today",
+    "Request A Free Quote Now"
+  ],
+  "descriptions": [
+    "Top-quality products with certified standards. Contact us today!",
+    "Trusted by global partners. Request a free quote now!"
+  ],
+  "finalUrl": "https://www.example.com/products",
+  "path1": "products",
+  "path2": "2026",
+  "productWords": ["brand", "product"],
+  "negativeKeywords": ["free", "cheap", "wikipedia", "pdf", "ebay", "amazon"],
+  "extensions": [
+    {
+      "level": "Campaign",
+      "typeV2": "CALL",
+      "AssetFieldType": "CALL",
+      "Properties": { "ContryCode": "CN", "PhoneNumber": "+86 400-XXX-XXXX" }
+    },
+    {
+      "level": "Campaign",
+      "typeV2": "SITELINK",
+      "AssetFieldType": "SITELINK",
+      "properties": {
+        "DestinationUrl": "https://www.example.com/about",
+        "Text": "About Us",
+        "Line2": "Learn about our story",
+        "Line3": "Explore our mission"
       }
-    ],
-    "extraAdGroups": [
-      {
-        "MaxCPCAmount": 150,
-        "Name": "通用词_行业词",
-        "StatusV2": "Enabled",
-        "TypeV2": "SEARCH_STANDARD",
-        "RotationModeV2": "Unspecified",
-        "KeywordsForBatchJob": [
-          {
-            "KeywordText": ["industry keyword 1", "industry keyword 2"],
-            "MatchTypeV2": "BROAD",
-            "Finalurl": "https://www.example.com"
-          }
-        ],
-        "AdsForBatchJob": [
-          {
-            "AdTitle": null,
-            "DestinationUrl": "https://www.example.com",
-            "Finalurl": "https://www.example.com",
-            "Path1": "", "Path2": "",
-            "TypeV2": "RESPONSIVE_SEARCH_AD",
-            "headlinePart1": "Industry Leading Products",
-            "headlinePart2": "Certified Quality Standards",
-            "headlinePart3": "Get A Free Quote Today",
-            "AddtionalHeadlines": [
-              "Trusted By Global Partners",
-              "20+ Years Of Experience",
-              "Contact Us Now"
-            ],
-            "adDescription": "Top-quality industry products with global shipping. Contact us today!",
-            "adDescription2": "Certified standards and reliable delivery. Request a quote now!"
-          }
-        ]
+    },
+    {
+      "level": "Campaign",
+      "typeV2": "STRUCTURED_SNIPPET",
+      "AssetFieldType": "STRUCTURED_SNIPPET",
+      "StructuredSnippetHeaderValue": {
+        "key": "Services",
+        "value": ["Quality Certified", "Global Shipping", "24/7 Support"]
       }
-    ],
-    "draft": false
-  }
+    }
+  ],
+  "extraAdGroups": [
+    {
+      "MaxCPCAmount": 150,
+      "Name": "通用词_行业词",
+      "StatusV2": "Enabled",
+      "TypeV2": "SEARCH_STANDARD",
+      "RotationModeV2": "Unspecified",
+      "KeywordsForBatchJob": [
+        {
+          "KeywordText": ["industry keyword 1", "industry keyword 2"],
+          "MatchTypeV2": "BROAD",
+          "Finalurl": "https://www.example.com"
+        }
+      ],
+      "AdsForBatchJob": [
+        {
+          "AdTitle": null,
+          "DestinationUrl": "https://www.example.com",
+          "Finalurl": "https://www.example.com",
+          "Path1": "",
+          "Path2": "",
+          "TypeV2": "RESPONSIVE_SEARCH_AD",
+          "headlinePart1": "Industry Leading Products",
+          "headlinePart2": "Certified Quality Standards",
+          "headlinePart3": "Get A Free Quote Today",
+          "AddtionalHeadlines": [
+            "Trusted By Global Partners",
+            "20+ Years Of Experience",
+            "Contact Us Now"
+          ],
+          "adDescription": "Top-quality industry products with global shipping. Contact us today!",
+          "adDescription2": "Certified standards and reliable delivery. Request a quote now!"
+        }
+      ]
+    }
+  ],
+  "draft": false
+}

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

@@ -8,6 +8,7 @@
 ---
 
 ## 默认做法
+
 1. **先确认统计区间**：除非用户已明确给出起止日期，否则**必须先反问**时间范围（例如"本月 1 号到昨天？还是自定义 YYYY-MM-DD 起止？"），**不得擅自默认**（参见 SKILL.md 的"时间范围强制反问"）。
 2. 询问用户需要生成哪些维度的报告，或直接生成默认报告：包含以下维度：执行摘要、每日投放趋势、月度汇总、广告系列表现、设备分布、地域分布、关键词表现、优化建议
 3. 确定报告需要如何分析请查看（`report-templates/README.md`）
@@ -30,6 +31,7 @@
 3. 用户仅提供网址时：**使用域名本身作为占位**（例如 `hy-steelpipe.com`），并在交付物里用 `[待确认品牌名]` 标注，让用户补充
 
 反面案例（**绝对禁止**）：
+
 - `https://hy-steelpipe.com/` → 自行臆造成"华悦钢管 / 海悦钢管"
 - `list-accounts` 拿到 `advertiserName: "ABC Steel"`，报告里写成"ABC 钢铁公司"
 
@@ -50,16 +52,16 @@
 
 多条报表行的原始体里，消耗类指标常用下列字段名（调用方若要做统一展示，可按此对照；**以实际响应为准**）：
 
-| 常见展示名 | 响应中常见字段名 |
-|------------|------------------|
-| 消耗 | `spend` |
-| 展示 | `impressions` |
-| 点击 | `clicks` |
-| 转化 | `conversions` |
-| 点击率 | `ctr` |
-| 转化率 | `conversionRate` |
-| 平均点击成本 | `averageCpc` |
-| 转化成本 | `costPerConversion` |
+| 常见展示名   | 响应中常见字段名    |
+| ------------ | ------------------- |
+| 消耗         | `spend`             |
+| 展示         | `impressions`       |
+| 点击         | `clicks`            |
+| 转化         | `conversions`       |
+| 点击率       | `ctr`               |
+| 转化率       | `conversionRate`    |
+| 平均点击成本 | `averageCpc`        |
+| 转化成本     | `costPerConversion` |
 
 ---
 
@@ -73,38 +75,38 @@ siluzan-tso google-analysis <子命令> -a <mediaCustomerId> [选项]
 
 **通用选项**
 
-| 选项 | 说明 |
-|------|------|
-| `-a, --account` | Google `mediaCustomerId`（必填） |
+| 选项                | 说明                                                      |
+| ------------------- | --------------------------------------------------------- |
+| `-a, --account`     | Google `mediaCustomerId`（必填）                          |
 | `--start` / `--end` | 统计区间；**须同传或同省略**（省略则默认近 7 天截至昨天） |
-| `--json` | 输出完整响应 JSON |
-| `-t, --token` | 鉴权 Token（可选，默认读配置） |
-| `--verbose` | 打印详细错误 |
+| `--json`            | 输出完整响应 JSON                                         |
+| `-t, --token`       | 鉴权 Token（可选，默认读配置）                            |
+| `--verbose`         | 打印详细错误                                              |
 
 **子命令与网关路径对应**
 
-| 子命令 | 说明 |
-|--------|------|
-| `overview` | 总览 `OverviewSectionData` |
-| `keywords` | 关键词 `KeywordSectionData`；可选 `--limit`、`--no-order-by-cost` |
-| `search-terms` | 搜索词 `searchtermmanagement/v2/list`；同上 |
-| `campaigns` | 系列 `CampaignSectionData` |
-| `ads` | 广告 `admanagement/v2/list` |
-| `extensions` | 附加信息 `extensionmanagement/v2/list`；可选 `--level`（Account / Campaign / Ad Group） |
-| `devices` | 设备 `DeviceSectionData` |
-| `geographic` | 地域 `GeographicSectionData` |
-| `audience` | 受众 `AdGroupAudienceData`；可选 `--audience-type SystemDefined \| UserDefined` |
-| `asset-images` | 图片素材 `CampaignAssetView` |
-| `videos` | 视频 `Videos` |
-| `materials` | 合并 `CampaignAssetView` + `Videos`（一次输出 `{ images, videos }`） |
-| `resource-counts` | 结构 `resource-counts` |
-| `conversion-actions` | 转化动作 |
-| `daily-metrics` | 按日 `reports` |
-| `gold-account` | 黄金账户 `GoldAccountData` |
-| `ads-index` | 质量指标 `AdsIndexData` |
-| `final-urls` | 最终到达网址（**不要**传 `--start`/`--end`） |
-| `dimension-summary` | 账户汇总 `reports/combined` |
-| `campaign-types` | 系列类型（**不要**传 `--start`/`--end`） |
+| 子命令               | 说明                                                                                    |
+| -------------------- | --------------------------------------------------------------------------------------- |
+| `overview`           | 总览 `OverviewSectionData`                                                              |
+| `keywords`           | 关键词 `KeywordSectionData`；可选 `--limit`、`--no-order-by-cost`                       |
+| `search-terms`       | 搜索词 `searchtermmanagement/v2/list`；同上                                             |
+| `campaigns`          | 系列 `CampaignSectionData`                                                              |
+| `ads`                | 广告 `admanagement/v2/list`                                                             |
+| `extensions`         | 附加信息 `extensionmanagement/v2/list`；可选 `--level`（Account / Campaign / Ad Group） |
+| `devices`            | 设备 `DeviceSectionData`                                                                |
+| `geographic`         | 地域 `GeographicSectionData`                                                            |
+| `audience`           | 受众 `AdGroupAudienceData`；可选 `--audience-type SystemDefined \| UserDefined`         |
+| `asset-images`       | 图片素材 `CampaignAssetView`                                                            |
+| `videos`             | 视频 `Videos`                                                                           |
+| `materials`          | 合并 `CampaignAssetView` + `Videos`（一次输出 `{ images, videos }`）                    |
+| `resource-counts`    | 结构 `resource-counts`                                                                  |
+| `conversion-actions` | 转化动作                                                                                |
+| `daily-metrics`      | 按日 `reports`                                                                          |
+| `gold-account`       | 黄金账户 `GoldAccountData`                                                              |
+| `ads-index`          | 质量指标 `AdsIndexData`                                                                 |
+| `final-urls`         | 最终到达网址（**不要**传 `--start`/`--end`）                                            |
+| `dimension-summary`  | 账户汇总 `reports/combined`                                                             |
+| `campaign-types`     | 系列类型（**不要**传 `--start`/`--end`）                                                |
 
 **示例**
 
@@ -134,17 +136,17 @@ siluzan-tso report meta-overview -a <mediaCustomerId> [--start YYYY-MM-DD --end
 
 与周期报告常见数据块对应关系见 **`report-templates/tiktok-period-report.md`**。
 
-| 子命令 | HTTP 段 / 说明 |
-|--------|----------------|
-| `report tiktok-overview` | `.../OverviewSectionData?startDate=&endDate=` |
-| `report tiktok-campaigns` | `.../CampaignSectionData?startDate=&endDate=&take=`（默认 `take=100`） |
-| `report tiktok-ad-groups` | `.../AdGroupReport?...` |
-| `report tiktok-ads` | `.../AdReport?...` |
-| `report tiktok-videos` | `.../VideoReport?...` |
-| `report tiktok-audience` | `.../AudienceReport?...&dimensions=` + `-d` 取值见 CLI 帮助（gender / age / interest_category 等） |
-| `report tiktok-audience-merged` | 同上接口三次（`gender`、`age`、`interest_category`），**合并输出 JSON** |
-| `report tiktok-areacode` | `GET {mainApiUrl}/query/media-account/tiktok/TikTokAreacode/Read` |
-| `report tiktok-interest-list` | `{tiktokApiUrl}/.../GetInterestList?mediaCustomerId=`（需配置 `tiktokApiUrl`） |
+| 子命令                          | HTTP 段 / 说明                                                                                     |
+| ------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `report tiktok-overview`        | `.../OverviewSectionData?startDate=&endDate=`                                                      |
+| `report tiktok-campaigns`       | `.../CampaignSectionData?startDate=&endDate=&take=`（默认 `take=100`）                             |
+| `report tiktok-ad-groups`       | `.../AdGroupReport?...`                                                                            |
+| `report tiktok-ads`             | `.../AdReport?...`                                                                                 |
+| `report tiktok-videos`          | `.../VideoReport?...`                                                                              |
+| `report tiktok-audience`        | `.../AudienceReport?...&dimensions=` + `-d` 取值见 CLI 帮助（gender / age / interest_category 等） |
+| `report tiktok-audience-merged` | 同上接口三次（`gender`、`age`、`interest_category`），**合并输出 JSON**                            |
+| `report tiktok-areacode`        | `GET {mainApiUrl}/query/media-account/tiktok/TikTokAreacode/Read`                                  |
+| `report tiktok-interest-list`   | `{tiktokApiUrl}/.../GetInterestList?mediaCustomerId=`（需配置 `tiktokApiUrl`）                     |
 
 **日期与鉴权**：`--start` / `--end` 须**同传或同省略**；省略时默认**近 7 天（截至昨天）**。鉴权与 TSO 其他接口相同。
 
@@ -166,19 +168,19 @@ siluzan-tso report tiktok-areacode --json
 
 **重要（日期）**：Bing 报表**不能包含「今天」或「昨天」**（接口限制，与 Web 端校验一致）。`--start` / `--end` 须**同传或同省略**；**省略时** CLI 默认区间为**截至前天**的近 7 天（避免误含昨天）。
 
-| 子命令 | HTTP 段 / 说明 |
-|--------|----------------|
-| `report bing-overview` | `.../OverviewSectionData?startDate=&endDate=` |
-| `report bing-device` | `.../DeviceSectionData?...` |
-| `report bing-geographic` | `.../GeographicSectionData?...` |
-| `report bing-age-audience` | `.../AgeAudienceData?...` |
-| `report bing-gender-audience` | `.../GenderAudienceData?...` |
-| `report bing-audience-merged` | 上两项并行拉取，**合并输出 JSON** |
-| `report bing-campaigns` | `.../CampaignReport?...` |
-| `report bing-ad-groups` | `.../AdGroupReport?...` |
-| `report bing-ads` | `.../AdReport?...` |
-| `report bing-keywords` | `.../KeywordReport?startDate=&endDate=&limit=&orderByCost=true`（默认 `limit=100`） |
-| `report bing-search-terms` | `.../SearchQueryReport?...`（同上） |
+| 子命令                        | HTTP 段 / 说明                                                                      |
+| ----------------------------- | ----------------------------------------------------------------------------------- |
+| `report bing-overview`        | `.../OverviewSectionData?startDate=&endDate=`                                       |
+| `report bing-device`          | `.../DeviceSectionData?...`                                                         |
+| `report bing-geographic`      | `.../GeographicSectionData?...`                                                     |
+| `report bing-age-audience`    | `.../AgeAudienceData?...`                                                           |
+| `report bing-gender-audience` | `.../GenderAudienceData?...`                                                        |
+| `report bing-audience-merged` | 上两项并行拉取，**合并输出 JSON**                                                   |
+| `report bing-campaigns`       | `.../CampaignReport?...`                                                            |
+| `report bing-ad-groups`       | `.../AdGroupReport?...`                                                             |
+| `report bing-ads`             | `.../AdReport?...`                                                                  |
+| `report bing-keywords`        | `.../KeywordReport?startDate=&endDate=&limit=&orderByCost=true`（默认 `limit=100`） |
+| `report bing-search-terms`    | `.../SearchQueryReport?...`（同上）                                                 |
 
 **示例**