siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

package/dist/skill/references/operations/hosted-automation-user-catalog.md

@@ -6,11 +6,11 @@
 
 三条均为 **Google 宿主编排 + siluzan-tso** 路径；IF/定时/通知在宿主，命令与 JSON 以详规为准。
 
-| 提醒名称            | 系统在后台默默帮你做什么？(自动动作)                                                                                                                                  | 文档（references）                                                                                                                                                                                                                                                                                                                                |
-| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1. 单日预算熔断     | 当日系列 **花费**相对**日预算**达到设定比例（如 ≥110%，可配 110%–120% 抗延迟）时，**暂停 Campaign**；恢复需人工加预算后再启用。                                       | [场景 1 · 单日预算熔断](operations/hosted-automation-self-control.md) · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`ad campaigns`、`ad campaign-status`、预算口径） · [`core/tips.md`](core/tips.md)（`--json-out`）                                                                                                                                                                |
+| 提醒名称            | 系统在后台默默帮你做什么？(自动动作)                                                                                                                                  | 文档（references）                                                                                                                                                                                                                                                                                                                                                                                                           |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1. 单日预算熔断     | 当日系列 **花费**相对**日预算**达到设定比例（如 ≥110%，可配 110%–120% 抗延迟）时，**暂停 Campaign**；恢复需人工加预算后再启用。                                       | [场景 1 · 单日预算熔断](operations/hosted-automation-self-control.md) · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`ad campaigns`、`ad campaign-status`、预算口径） · [`core/tips.md`](core/tips.md)（`--json-out`）                                                                                                                                                                                            |
 | 2. CPA 飙升自动降价 | 滑动时间窗内 **转化数**达置信阈值且 **实际 CPA** 高于 **目标 CPA×飙升比例** 时，在 **Campaign / Ad Group** 上**下调** tCPA 或 eCPC 等**出价上限**（具体策略依账户）。 | [场景 2 · CPA 飙升自动降价](operations/hosted-automation-self-control.md) · [`operations/hosted-automation-optimize-weak-downbid.md`](operations/hosted-automation-optimize-weak-downbid.md)（组/创意侧降价关停，可与宿主组合） · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`campaign-edit`、`adgroup-edit`） · [`analytics/account-analytics.md`](analytics/account-analytics.md)（窗口粒度不足时的报表拉数） |
-| 3. 连续空耗自动暂停 | **当日**累计 **花费 ≥ 目标 CPA×N** 且 **转化为 0** 时，**暂停**广告组或创意；宿主发 **P1** 且文案含 **「空耗熔断」**。                                                | [场景 3 · 连续空耗自动暂停](operations/hosted-automation-self-control.md) · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`ad groups`、`ad list`、`adgroup-status`、`ad-status`） · [`operations/hosted-automation-monitoring-json.md`](operations/hosted-automation-monitoring-json.md)（JSON 键名勿套用 Google Ads API 官方名）                                                              |
+| 3. 连续空耗自动暂停 | **当日**累计 **花费 ≥ 目标 CPA×N** 且 **转化为 0** 时，**暂停**广告组或创意；宿主发 **P1** 且文案含 **「空耗熔断」**。                                                | [场景 3 · 连续空耗自动暂停](operations/hosted-automation-self-control.md) · [`google-ads/google-ads.md`](google-ads/google-ads.md)（`ad groups`、`ad list`、`adgroup-status`、`ad-status`） · [`operations/hosted-automation-monitoring-json.md`](operations/hosted-automation-monitoring-json.md)（JSON 键名勿套用 Google Ads API 官方名）                                                                                  |
 
 **总索引**：[`operations/hosted-automation-scenarios.md`](operations/hosted-automation-scenarios.md) · **自控全文**：[`operations/hosted-automation-self-control.md`](operations/hosted-automation-self-control.md) · **金额硬规范**（展示用 `*Display` 等）：[`SKILL.md`](../SKILL.md)「金额与货币单位硬约束」。
 
@@ -18,11 +18,11 @@
 
 编排（定时、HTTP 探活、通知）在宿主；**读哪些 JSON 字段、用什么命令** 以 **[`operations/hosted-automation-monitoring-json.md`](operations/hosted-automation-monitoring-json.md)** 为准（键名以当次 `--json-out` 落盘 JSON 为准，勿套用 Google Ads API 官方字段名解析本 CLI 输出）。
 
-| 功能名称          | 监控层级 / 说明                                                                                    | CLI 检查入口（`--json-out`）                                                                                                                                                             |
+| 功能名称          | 监控层级 / 说明                                                                                    | CLI 检查入口（`--json-out`）                                                                                                                                                         |
 | ----------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| 1. 账户被封禁     | 账户级；与 Google `CustomerStatus` 及 `list-accounts` 的字段映射**暂不写进本 skill**，由宿主约定。 | `list-accounts`、`balance` 等见 [`accounts/accounts.md`](accounts/accounts.md)                                                                                                                         |
+| 1. 账户被封禁     | 账户级；与 Google `CustomerStatus` 及 `list-accounts` 的字段映射**暂不写进本 skill**，由宿主约定。 | `list-accounts`、`balance` 等见 [`accounts/accounts.md`](accounts/accounts.md)                                                                                                       |
 | 2. 落地页死链强停 | URL 不可用或跳错页时暂停关联创意，避免无效消耗。                                                   | **`google-analysis --sections final-urls`**；或 **`ad list`** / **`google-analysis --sections ads`** 取落地页字段后由宿主 HTTP 校验                                                  |
-| 3. 广告素材拒审   | 创意政策状态异常时告警或配合工单。                                                                 | **`ad list`** / **`google-analysis --sections ads`**：`policyApprovalStatusV2`、`approvalStatusDetails` 等（见 **[`google-ads/google-ads.md`](google-ads/google-ads.md)**）                                |
+| 3. 广告素材拒审   | 创意政策状态异常时告警或配合工单。                                                                 | **`ad list`** / **`google-analysis --sections ads`**：`policyApprovalStatusV2`、`approvalStatusDetails` 等（见 **[`google-ads/google-ads.md`](google-ads/google-ads.md)**）          |
 | 4. 花费异动监控   | 系列或账户维度花费相对历史异常波动。                                                               | **`google-analysis --sections campaign-hour`**：按 `campaignId` + `date` + `hour` 看 **`spend`**                                                                                     |
 | 5. 余额枯竭预警   | 余额过低或按日均推算续航不足。                                                                     | **`balance-scan`**（`balance`、`remainingDays`、`hitReason`、`meta`）或 **`balance`** / **`google-analysis --sections overview`**（`remainingAccountBudget`、`averageDailyCost` 等） |
 
@@ -30,9 +30,9 @@
 
 编排与阈值在宿主；**命令、JSON 键名、聚合与写后复核** 见 **[`operations/hosted-automation-optimize-index.md`](operations/hosted-automation-optimize-index.md)**（及链出的三份 SOP）。
 
-| 功能名称                | 说明                                                                                                                           | SOP                                                                                        |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
-| 1. 表现差广告降价/关停  | 组/创意：CTR、CPA、转化等触达后 **下调 `targetCpa` 或 `Paused`**。                                                             | [`operations/hosted-automation-optimize-weak-downbid.md`](operations/hosted-automation-optimize-weak-downbid.md) |
-| 2. 高转化广告提价扩量   | 系列/组：ROAS 代理、预算丢失份额等触达后 **提预算 / 上调目标 CPA**。                                                           | [`operations/hosted-automation-optimize-scale.md`](operations/hosted-automation-optimize-scale.md)               |
-| 3. A/B 测试自动决出胜者 | 同组多创意：聚合后比 **CVPI / all conv** 等，**停输家**。                                                                      | [`operations/hosted-automation-optimize-ab-winner.md`](operations/hosted-automation-optimize-ab-winner.md)       |
-| 4. 异动根因自动排查建议 | 诊断报告与归因：用 `account-analytics`、报告模板等，见 [`analytics/account-analytics.md`](analytics/account-analytics.md) 与 `report-templates/`。 | （未单独拆 SOP，沿用分析文档）                                                             |
+| 功能名称                | 说明                                                                                                                                               | SOP                                                                                                              |
+| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| 1. 表现差广告降价/关停  | 组/创意：CTR、CPA、转化等触达后 **下调 `targetCpa` 或 `Paused`**。                                                                                 | [`operations/hosted-automation-optimize-weak-downbid.md`](operations/hosted-automation-optimize-weak-downbid.md) |
+| 2. 高转化广告提价扩量   | 系列/组：ROAS 代理、预算丢失份额等触达后 **提预算 / 上调目标 CPA**。                                                                               | [`operations/hosted-automation-optimize-scale.md`](operations/hosted-automation-optimize-scale.md)               |
+| 3. A/B 测试自动决出胜者 | 同组多创意：聚合后比 **CVPI / all conv** 等，**停输家**。                                                                                          | [`operations/hosted-automation-optimize-ab-winner.md`](operations/hosted-automation-optimize-ab-winner.md)       |
+| 4. 异动根因自动排查建议 | 诊断报告与归因：用 `account-analytics`、报告模板等，见 [`analytics/account-analytics.md`](analytics/account-analytics.md) 与 `report-templates/`。 | （未单独拆 SOP，沿用分析文档）                                                                                   |

package/dist/skill/references/operations/optimize.md

@@ -1,7 +1,7 @@
 # AI 广告优化记录（optimize）
 
 > 所属 skill：`siluzan-tso`。
->
+
 ```bash
 siluzan-tso optimize list    [选项]                  # 账户级优化主列表
 siluzan-tso optimize records [选项]                  # 优化操作记录列表（系列粒度，见下）
@@ -9,14 +9,14 @@ siluzan-tso optimize get --id <id>                   # 单条详情
 siluzan-tso optimize children --parent-id <id>       # 广告系列级明细
 ```
 
-| 选项                             | 说明                                                                                                                                                              |
-| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `-a, --account <id>`             | 账户 `mediaCustomerId`（走接口筛选；**已脱管账户可能为空**）                                                                                                      |
-| `--match-media-customer-id <id>` | **仅 `list`**：不按接口筛账户，拉全量后自动翻页、客户端匹配 `mediaCustomerId`（适合已不在 Siluzan 托管、但历史上仍有优化批次的 Google 客户号）                    |
-| `--start / --end <date>`         | 日期范围（YYYY-MM-DD，所有日期按北京时间（UTC+8）解释，调用时自动附加 `+08:00` 时区偏移）                                                                         |
+| 选项                             | 说明                                                                                                                                                                                    |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `-a, --account <id>`             | 账户 `mediaCustomerId`（走接口筛选；**已脱管账户可能为空**）                                                                                                                            |
+| `--match-media-customer-id <id>` | **仅 `list`**：不按接口筛账户，拉全量后自动翻页、客户端匹配 `mediaCustomerId`（适合已不在 Siluzan 托管、但历史上仍有优化批次的 Google 客户号）                                          |
+| `--start / --end <date>`         | 日期范围（YYYY-MM-DD，所有日期按北京时间（UTC+8）解释，调用时自动附加 `+08:00` 时区偏移）                                                                                               |
 | `--id <id>`                      | `optimize get` 专用：UUID。常见来源——**账户批次**：`optimize list --json-out ./snap` 的 `items[].id` / `entityId`；**系列级记录**：`optimize records --json-out ./snap` 的 `items[].id` |
-| `--parent-id <id>`               | 父级 ID（`children` 专用；与账户批次 `list` 里 `items[].id` 一致）                                                                                                |
-| `--json-out`                         | 输出原始 JSON（`list` / `records` / `children`）                                                                                                                  |
+| `--parent-id <id>`               | 父级 ID（`children` 专用；与账户批次 `list` 里 `items[].id` 一致）                                                                                                                      |
+| `--json-out`                     | 输出原始 JSON（`list` / `records` / `children`）                                                                                                                                        |
 
 ## 已脱管 / 非当前托管账户：怎么查历史优化？
 

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

@@ -0,0 +1,45 @@
+# 报告模板纲要（report-templates）
+
+> **Agent Read 路径（推荐）**：`references/report-templates/<文件名>.md`  
+> **同源副本**：`report-templates/<文件名>.md`（Skill 根目录，与 HTML 样式模板同目录）  
+> **HTML 样式参考**（仅排版，不定义章节）：`report-templates/report-template*.html`、`report-templates/*-report.html`
+
+安装包构建时会将根目录 `report-templates/*.md` **同步到本目录**，避免 Agent 按 `references/` 前缀查找时 404。
+
+---
+
+## 周期 / 账户报告
+
+| 文件                               | 工作流    | 说明                                  |
+| ---------------------------------- | --------- | ------------------------------------- |
+| `google-period-report.md`          | **P4**    | Google 账户周期报告（默认 HTML 纲要） |
+| `google-period-report-excel.md`    | **P4**    | 用户要 Excel 时全文必读               |
+| `meta-period-report.md`            | **P4-FB** | Meta/Facebook 周期报告（默认 HTML）   |
+| `meta-period-report-excel.md`      | **P4-FB** | Meta Excel 五 Sheet                   |
+| `meta-account-diagnosis-report.md` | **P4-FB** | Meta 深度诊断                         |
+| `tiktok-period-report.md`          | **P4**    | TikTok 周期报告                       |
+| `bing-period-report.md`            | **P4**    | Bing 周期报告                         |
+
+## 诊断 / 专项
+
+| 文件                                 | 工作流 | 说明                                        |
+| ------------------------------------ | ------ | ------------------------------------------- |
+| `google-ads-diagnosis.md`            | **P1** | Google 广告诊断完整纲要                     |
+| `google-account-diagnosis-report.md` | **P1** | Google 账户深度诊断                         |
+| `website-diagnosis-report.md`        | **P8** | 网站诊断（配合 `website-diagnosis render`） |
+| `market-analysis-report.md`          | **P9** | 战略市场分析交付检查清单                    |
+
+## 客户交付 / Excel
+
+| 文件                           | 工作流 | 说明                        |
+| ------------------------------ | ------ | --------------------------- |
+| `okki-weekly-google-client.md` | **P6** | OKKI 周报（全文必读）       |
+| `google-inquiry-analysis.md`   | **P7** | Google 询盘分析（全文必读） |
+
+## 通用
+
+| 文件                 | 说明             |
+| -------------------- | ---------------- |
+| `REPORT-WORKFLOW.md` | 六步报告流程总览 |
+
+章节细则另见 `references/core/playbooks.md`（P1–P9）与 `references/analytics/account-analytics.md`。

package/dist/skill/references/report-templates/REPORT-WORKFLOW.md

@@ -0,0 +1,114 @@
+# 报告生成流程
+
+---
+
+## 分析报告生成步骤
+
+适用于：`google-analysis *`、`facebook-analysis *`、`report tiktok-*`、`report bing-*`、`report meta-overview` 等 CLI 拉数后由 Agent 撰写的报告。
+
+**不适用**于 TSO 优化报告（`report create` / `report push` 等），那类报告由平台生成，不走此流程。
+
+---
+
+### 步骤 1：确认账户与区间
+
+- 账户 ID 须来自 `siluzan-tso list-accounts -m <媒体>` 的实际输出，不能凭印象猜测。
+- 明确起止日期（`--start` / `--end`）。
+
+---
+
+### 步骤 2：选定内容模板
+
+根据媒体与用户意图，选择 `report-templates/` 下对应的 `*.md`：
+
+| 意图                                                                                  | Google                                                                                             | Meta                               | TikTok                    | Bing                    |
+| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------------------- | ----------------------- |
+| 周期分析 / 月报 / 周报                                                                | `google-period-report.md`                                                                          | `meta-period-report.md`            | `tiktok-period-report.md` | `bing-period-report.md` |
+| OKKI 周报 / 固定话术发客户（Google）                                                  | `okki-weekly-google-client.md`                                                                     | —                                  | —                         | —                       |
+| **询盘分析** / 固定运营触发（Goog账户询盘分析 / 我给你询盘信息分析Google账号XXX效果） | `google-inquiry-analysis.md`（**严格 3 个月** + 用户上传询盘资料 + 8 Sheet xlsx；见 SKILL **P7**） | —                                  | —                         | —                       |
+| 深度诊断 / 健康检查                                                                   | `google-account-diagnosis-report.md`                                                               | `meta-account-diagnosis-report.md` | 同周期，注明能力受限      | 同周期                  |
+
+无精确匹配时，用最接近媒体的同类 `*.md`，并在报告开头注明。
+
+---
+
+### 步骤 3：展示默认维度 + 询问追加
+
+**例外**：模板为 `okki-weekly-google-client.md` 或 `google-inquiry-analysis.md` 时**跳过**本节「追问可选追加」，按该文件固定维度拉数即可。`google-inquiry-analysis.md` 还要求**严格 3 个月**时间窗（分析月份 + 向前 2 个完整自然月），不可扩展。
+
+1. 按选定 `*.md` 的**默认维度**开始拉数（**不必等用户回复后再拉**，可并行）。
+2. 同时向用户发一条消息，说明本次默认包含哪些维度，并列出当前平台支持的**可选追加维度**，询问是否需要添加。
+3. 报告正文按默认维度写；若用户追加了维度，数据回来后在末尾补充对应章节。
+
+---
+
+### 步骤 3b：Google Excel 门禁（用户要 xlsx 时必做）
+
+在步骤 4 拉数完成、步骤 5 写脚本**之前**：
+
+1. `list-accounts -m Google -k <用户 ID> --json-out` 核验账户（**禁止**全表 grep 换 ID）。
+2. Read 本次每个 section 的 **`*.outline.txt`**（见 `google-period-report-excel.md` §执行门禁）。
+3. **禁止** `cat|json.tool|head` 或 Read 业务 `*.json` 探字段；**禁止**加载宿主第三方 xlsx Skill。
+
+### 步骤 4：拉取数据
+
+- **`google-analysis` / `report …` 账户分析子命令**：统一 **`--json-out <目录>`** 落盘，再由脚本读 **`manifest-<accountId>.json` / `report-manifest-<accountId>.json`**（清单文件名见 stdout 摘要的 `manifestFile`）与各 **`<section>-<accountId>.json`**（见 `references/analytics/account-analytics.md`）。
+- **`stats`、`ad campaigns` 等辅助命令**：按 `references/core/tips.md` 与各命令文档做结构化拉数。
+- 仅执行与**本次报告维度**对应的命令（默认 + 用户追加）。
+- 数据失败/缺失：在对应章节写 `[ 数据不可用：{原因} ]`，不写推测。
+
+---
+
+### 步骤 4b：交付前审阅最终产物（**必做**）
+
+- 按 `references/core/agent-conventions.md` §七 自检表 A/B/C 审阅。
+- **Read 刚生成的报告文件**（HTML/Markdown 等），对照当次 `report-templates/*.md` 逐项确认章节与币种。
+- 未通过：**修改产物或补拉数据后重新生成**，再次 Read 审阅；不得在未审阅时交付。
+
+---
+
+### 步骤 5：分析并撰写中间产物
+
+- 用 **node/python 脚本**读落盘 JSON，完成聚合与洞察（禁止 Read 业务 JSON、禁止对话手填数）。
+- 按 `*.md` 章节结构组织叙事与建议；所有数字可追溯到 JSON 字段。
+- **Meta/Facebook**：产出 `meta-period-report.json`（见 `meta-period-report.md`）。
+- **Google 等**：可直接组织 Markdown/HTML 正文。
+
+### 步骤 5b：生成终稿（按媒体与格式）
+
+| 媒体              | 用户未指定格式                                                    | 用户指定 Excel                                                                                            |
+| ----------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| **Meta/Facebook** | `facebook-analysis render` → **HTML**（必做）                     | Agent 脚本按 `meta-period-report-excel.md` 写 xlsx；**不**默认 `render`                                   |
+| **Google**        | 按 `report-template*.html` 写 HTML（默认 `report-template.html`） | **周期/定制 Sheet**：`google-period-report-excel.md`（P4，先 outline 后脚本）；**OKKI**：P6；**询盘**：P7 |
+| **网站诊断**      | `website-diagnosis render` → HTML                                 | —                                                                                                         |
+
+**禁止**：Meta 周期报告默认只交 Markdown/JSON；禁止 Agent 手写 Meta HTML。
+
+**Google 广告诊断报告**（`google-ads-diagnosis.md` / `google-account-diagnosis-report.md`）额外必遵：
+
+1. **每日趋势**（`daily-metrics` / `conversionCost`）：金额、CPA **2 位小数**；转化/点击/展示为整数；图表轴与 tooltip 同规则。
+2. **每个模块**在表/图后写 **分析**（≥2 条，有数据依据）+ **建议**（≥1 条）；禁止只贴表不写分析。详见 `google-ads-diagnosis.md` § 撰写硬约束。
+
+---
+
+### 步骤 6：末尾附数据来源（可选）
+
+```
+📌 数据来源：
+- siluzan-tso google-analysis -a <id> --sections overview --start <s> --end <e>
+- ...
+```
+
+---
+
+## 未知报告名处理
+
+| 用户措辞                                                                                                                                              | 映射                                                                                                                                                                                                 |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 月报、周报、投放总结、效果回顾                                                                                                                        | 周期分析 → 对应媒体 `*-period-report.md`                                                                                                                                                             |
+| **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间）                                                                                       | **固定话术 + 精简表 +（按需）Excel** → `okki-weekly-google-client.md`（见 SKILL **P6**）；Excel **仅**由 Agent 脚本生成，**无** CLI 内置写表子命令                                                   |
+| **Goog账户询盘分析 / Google 账户询盘分析 / 分析XXX Google账号的询盘效果 / 我给你询盘信息分析Google账号XXX效果**（或含「询盘 + 账户 + Google」三要素） | **询盘 + 账户合并分析 + 严格 3 个月 + 8 Sheet xlsx** → `google-inquiry-analysis.md`（见 SKILL **P7**）；询盘资料用户上传任意载体，宿主 Agent 解析落盘 `inquiries.json`，xlsx **仅**由 Agent 脚本生成 |
+| 健康检查、诊断、账户分析                                                                                                                              | 诊断 → `google-account-diagnosis-report.md`（Google）或周期型降级                                                                                                                                    |
+| 对比、汇报、给客户看                                                                                                                                  | 以周期型为骨架，简化版本                                                                                                                                                                             |
+
+无法识别时，默认按**周期分析**处理，并在报告开头注明推断。

package/dist/skill/references/report-templates/bing-period-report.md

@@ -0,0 +1,65 @@
+# Bing（Microsoft Advertising / BingV2）— 账户分析报告（模板纲要）
+
+> 统计区间：`{startDate}` ~ `{endDate}`（**不可包含今天或昨天**，见下文）  
+> 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
+
+数据块：总览、设备、地域、受众（年龄/性别）、系列、广告组、广告、关键词、搜索字词。
+
+---
+
+## 日期规则（必读）
+
+- Bing 接口**无法**拉取过新的数据；时间范围内**任意一天**若为**今天**或**昨天**，请求会失败。
+- **CLI**：`--start` / `--end` 须**同传或同省略**；省略时默认**截至前天**的近 7 天（与 `report bing-*` 实现一致）。
+- 自选区间时请确保结束日 ≤ **前天**。
+
+---
+
+## 1. 执行摘要（总览）
+
+- **CLI**：`siluzan-tso report bing-overview -a <mediaCustomerId> [--start … --end …] --json-out <dir>`
+
+## 2. 设备与地域
+
+- 设备：`report bing-device` → `DeviceSectionData`
+- 地域：`report bing-geographic` → `GeographicSectionData`（响应中常见 `countries` 等字段，**以实际 JSON 为准**）
+
+## 3. 受众
+
+- 年龄：`report bing-age-audience` → `AgeAudienceData`
+- 性别：`report bing-gender-audience` → `GenderAudienceData`
+- 合并输出：`report bing-audience-merged`（**固定输出合并 JSON**，含年龄+性别）
+
+## 4. 广告结构
+
+- 系列：`report bing-campaigns` → `CampaignReport`
+- 广告组：`report bing-ad-groups` → `AdGroupReport`
+- 广告：`report bing-ads` → `AdReport`
+
+## 5. 关键词与搜索字词
+
+- 关键词：`report bing-keywords` → `KeywordReport`，Query 含 `limit`（默认 **100**）、`orderByCost=true`
+- 搜索字词：`report bing-search-terms` → `SearchQueryReport`，参数同上
+
+## 6. 附录
+
+- 鉴权：与 TSO 其他接口相同（`config show` 中 `tsoApiBaseUrl` / Token）。
+- 与 steward「优化报告」区别：见 `meta-period-report.md` 末节；此处为**实时分析 JSON**。
+
+---
+
+### CLI 速查表
+
+| 数据块   | 子命令                        |
+| -------- | ----------------------------- |
+| 总览     | `report bing-overview`        |
+| 设备     | `report bing-device`          |
+| 地域     | `report bing-geographic`      |
+| 年龄受众 | `report bing-age-audience`    |
+| 性别受众 | `report bing-gender-audience` |
+| 受众合并 | `report bing-audience-merged` |
+| 系列     | `report bing-campaigns`       |
+| 广告组   | `report bing-ad-groups`       |
+| 广告     | `report bing-ads`             |
+| 关键词   | `report bing-keywords`        |
+| 搜索字词 | `report bing-search-terms`    |

package/dist/skill/references/report-templates/google-account-diagnosis-report.md

@@ -0,0 +1,83 @@
+# Google 账户 — 诊断类报告
+
+> 统计区间：`{startDate}` ~ `{endDate}`  
+> 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
+
+按章节组织结论与建议；各节所需数据与建议 CLI 如下（**`google-analysis` 子命令请使用 `--json-out <目录>`** 落盘，脚本读磁盘 JSON 再写入报告）。
+
+**完整章节结构、HTML 区块 ID、分析/建议必填规则、每日趋势小数格式** → 必读同目录 **`google-ads-diagnosis.md` § 撰写硬约束**（产品验收）。
+
+### 撰写要点（摘要）
+
+1. **每日趋势**（§7 / `daily-metrics`）：金额、CPA **保留 2 位小数**；展示/点击/转化用整数；图表 tooltip 同规则。
+2. **每一章**除表格外须有 **分析**（≥2 条）+ **建议**（≥1 条）；禁止只罗列数据。
+
+---
+
+## 1. 账户画像与落地页
+
+- 主投放域名 / 落地页线索（若有）
+- **CLI**：`google-analysis --sections final-urls`（无日期参数）
+
+## 2. 核心指标快照
+
+- 本期消耗、展示、点击、转化、CTR、CVR、CPA 等
+- **CLI**：`google-analysis --sections overview`、`google-analysis --sections dimension-summary`
+
+## 3. 账户结构与转化目标
+
+- 系列/组/广告等数量级（以接口返回为准）
+- 已配置的转化动作列表摘要
+- **CLI**：`google-analysis --sections resource-counts`、`google-analysis --sections conversion-actions`
+
+## 4. 黄金账户与健康度
+
+- 得分与各项是否达标（转化跟踪、GA、RSA、附加信息、否定词、受众、出价策略等）
+- **CLI**：`google-analysis --sections gold-account`
+
+## 5. 广告系列类型与分布
+
+- 各类型系列占比或列表摘要
+- **CLI**：`google-analysis --sections campaign-types`（无日期参数）
+
+## 6. 重点维度对比（本期 vs 上期）
+
+- 系列、地域、关键词：建议各拉两段时间分别对比（脚本层控制 `--start` / `--end`）
+- **CLI**：`google-analysis --sections campaigns`、`google-analysis --sections geographic`、`google-analysis --sections keywords`
+
+## 7. 转化成本曲线
+
+- 按日 CPA / 转化数趋势
+- **CLI**：`google-analysis --sections daily-metrics`
+
+## 8. 设备、地域、受众（全量表）
+
+- 设备、国家/地区、系统定义受众、自定义受众
+- **CLI**：`google-analysis --sections devices`、`google-analysis --sections geographic`、`google-analysis --sections audience`（`SystemDefined` / `UserDefined`）
+
+## 9. 搜索词与广告创意
+
+- 高消耗搜索词、与关键词匹配关系
+- 高消耗搜索广告标题、类型、到达网址
+- **CLI**：`google-analysis --sections search-terms`、`google-analysis --sections ads`
+
+## 10. 附加信息与素材
+
+- 附加链接/电话/宣传信息等状态与层级
+- 图片 / 视频素材消耗（若需合并视图）
+- **CLI**：`google-analysis --sections extensions`（可选 `--level`）、`google-analysis --sections materials` 或分别 `asset-images`、`videos`
+
+## 11. 质量得分（汇总）
+
+- **CLI**：`google-analysis --sections ads-index`
+
+## 12. 总结与行动项
+
+- 优先修复项（健康度未达标项）
+- 预算/出价/关键词/搜索词否词等可执行清单
+
+---
+
+### 并行拉取提示
+
+诊断场景可在同一统计区间内并行执行多条 `google-analysis`（注意接口限流）；合并后再套入本模板各章节。