siluzan-tso-cli 1.1.12 → 1.1.13

package/dist/skill/report-templates/google-ads-diagnosis.md

@@ -1,4 +1,4 @@
-# Google Ads 账户诊断报告 
+# Google Ads 账户诊断报告
 
 > 本模板与「Google Ads 账户诊断报告」网页版章节、数据块一一对应，便于用 Markdown 复刻或对接 `google-analysis` CLI 拉数后填充。  
 > 占位符：`{reportDate}` `{companyName}` `{period}` 等。
@@ -7,12 +7,12 @@
 
 ## 页眉信息（报告头）
 
-| 字段 | 占位 / 说明 |
-|------|-------------|
-| 账户名称 | `{companyName}` |
-| 诊断周期 | `{period}`（如 `2026-03-01 ~ 2026-03-31`） |
-| 核心转化行为 | 如「询盘/转化」 |
-| 账户 ID / 货币 / 网址 | 副栏展示用 |
+| 字段                  | 占位 / 说明                                |
+| --------------------- | ------------------------------------------ |
+| 账户名称              | `{companyName}`                            |
+| 诊断周期              | `{period}`（如 `2026-03-01 ~ 2026-03-31`） |
+| 核心转化行为          | 如「询盘/转化」                            |
+| 账户 ID / 货币 / 网址 | 副栏展示用                                 |
 
 **对应数据对象**：`accountInfo`（`companyId`、`companyName`、`currencyCode`、`period`、`conversionAction`、`website`、`businessModel`）
 
@@ -22,15 +22,15 @@
 
 **区块 ID**：`section-account-info`
 
-| 字段（中英） | 内容 |
-|--------------|------|
-| 账户名称 (Company) | |
-| 网址 (Website) | |
-| 账户 ID (ID) | |
-| 核心业务模式 (Core Business Model) | |
-| 诊断时间 (Period) | |
-| 核心转化行为 (Core Conversion Action) | |
-| 货币单位 (Currency) | |
+| 字段（中英）                          | 内容 |
+| ------------------------------------- | ---- |
+| 账户名称 (Company)                    |      |
+| 网址 (Website)                        |      |
+| 账户 ID (ID)                          |      |
+| 核心业务模式 (Core Business Model)    |      |
+| 诊断时间 (Period)                     |      |
+| 核心转化行为 (Core Conversion Action) |      |
+| 货币单位 (Currency)                   |      |
 
 ---
 
@@ -62,25 +62,25 @@
 
 按顺序呈现（与页面「数据概览」一致）：
 
-| 步骤 | 指标 | 数值 | 附注 |
-|------|------|------|------|
-| 1 | 消耗 (Cost) | | |
-| 2 | 展示次数 (Impressions) | | |
-| 3 | 点击次数 (Clicks) | | 点击率 CTR |
-| 4 | 转化次数 (Conversions) | | 转化率 CVR |
-| 5 | 每次转化费用 (CPA) | | |
+| 步骤 | 指标                   | 数值 | 附注       |
+| ---- | ---------------------- | ---- | ---------- |
+| 1    | 消耗 (Cost)            |      |            |
+| 2    | 展示次数 (Impressions) |      |            |
+| 3    | 点击次数 (Clicks)      |      | 点击率 CTR |
+| 4    | 转化次数 (Conversions) |      | 转化率 CVR |
+| 5    | 每次转化费用 (CPA)     |      |            |
 
 ### 3.2 账户结构
 
-| 项目 | 数量 |
-|------|------|
-| 有效广告系列 (Effective Ad Campaigns) | |
-| 有效广告组 (Effective Ad Groups) | |
-| 有效关键字 (Effective Keywords) | |
-| 有效广告 (Effective Ads) | |
-| 附加链接 (Sitelinks) | |
-| 否定关键字 (Negative Keywords) | |
-| 有效国家 (Effective Countries) | |
+| 项目                                  | 数量 |
+| ------------------------------------- | ---- |
+| 有效广告系列 (Effective Ad Campaigns) |      |
+| 有效广告组 (Effective Ad Groups)      |      |
+| 有效关键字 (Effective Keywords)       |      |
+| 有效广告 (Effective Ads)              |      |
+| 附加链接 (Sitelinks)                  |      |
+| 否定关键字 (Negative Keywords)        |      |
+| 有效国家 (Effective Countries)        |      |
 
 **对应字段**：`structure.campaignCount`、`adGroupCount`、`keywordCount`、`adCount`、`extensionCount`、`negativeKeywordCount`、`countriesWithConversionsCount`
 
@@ -89,12 +89,12 @@
 将下列指标与「行业/健康标准」对照（页面配置：消耗↔`averageCost`，转化↔`averageConversions`，CPA↔`averageCpa`，CTR↔`averageCtr`，CVR↔`averageCvr`）：
 
 | 指标 (Metric) | 数据 (Data) | 行业/健康标准 |
-|-----------------|-------------|----------------|
-| 消耗 | | |
-| 转化次数 | | |
-| 每次转化费用 | | |
-| 点击率 | | |
-| 转化率 | | |
+| ------------- | ----------- | ------------- |
+| 消耗          |             |               |
+| 转化次数      |             |               |
+| 每次转化费用  |             |               |
+| 点击率        |             |               |
+| 转化率        |             |               |
 
 ### 分析 / 建议
 
@@ -103,9 +103,9 @@
 
 ### 3.4 转化目标
 
-| 事件名称 | 状态 | 转化次数 | 转化价值 |
-|----------|------|----------|----------|
-| | 启用/停用… | | |
+| 事件名称 | 状态       | 转化次数 | 转化价值 |
+| -------- | ---------- | -------- | -------- |
+|          | 启用/停用… |          |          |
 
 **数据**：`conversionGoals.items`（`name` / `eventName`、`status`、`allConversions`、`allConversionsValue`）
 
@@ -122,12 +122,12 @@
 
 #### 国家地区分析
 
-- 维度列：**国家/地区**  
+- 维度列：**国家/地区**
 - **数据**：`geographic.items`（同上结构）
 
 #### 关键词分析
 
-- 维度列：**关键词**  
+- 维度列：**关键词**
 - **数据**：`keywords.items`
 
 #### 转化成本 / 按日趋势（若页面已渲染）
@@ -147,20 +147,20 @@
 
 ### 黄金账户明细表
 
-| 项目名称 | 是否达标 | 优化建议 |
-|----------|----------|----------|
-| 转化追踪设置 | 达标/未达标 | |
-| G A与广告账户联结 | | |
-| 文字广告 | | |
-| 自适应搜索广告 | | |
-| 自适应展示广告 | | |
-| 附加结构化信息摘要 | | |
-| 附加链接 | | |
-| 附加宣传信息 | | |
-| 附加电话信息 | | |
-| 否定词添加 | | |
-| 受众群体设置 | | |
-| 出价策略 | | |
+| 项目名称           | 是否达标    | 优化建议 |
+| ------------------ | ----------- | -------- |
+| 转化追踪设置       | 达标/未达标 |          |
+| G A与广告账户联结  |             |          |
+| 文字广告           |             |          |
+| 自适应搜索广告     |             |          |
+| 自适应展示广告     |             |          |
+| 附加结构化信息摘要 |             |          |
+| 附加链接           |             |          |
+| 附加宣传信息       |             |          |
+| 附加电话信息       |             |          |
+| 否定词添加         |             |          |
+| 受众群体设置       |             |          |
+| 出价策略           |             |          |
 
 **得分**：`goldAccountScore`；**未达标项数**：若有 `goldAccountUnqualifiedCount` 可注明。
 
@@ -179,8 +179,8 @@
 ### 竞争力表
 
 | 指标 (Metric) | 报告值 (Report Value) | 健康标准 (Health Benchmark) | 优化策略 (Optimization Strategy) |
-|----------------|------------------------|-------------------------------|-----------------------------------|
-| | | | |
+| ------------- | --------------------- | --------------------------- | -------------------------------- |
+|               |                       |                             |                                  |
 
 ---
 
@@ -213,12 +213,12 @@
 **区块 ID**：`section-landing-page`  
 **数据**：`landingPageAnalysis`（经页面加工为下列四行）
 
-| 指标 (Metric) | 报告值 (Report Value) | 健康标准 (Health Benchmark) | 优先级与行动 (Priority & Action) |
-|---------------|------------------------|-------------------------------|-----------------------------------|
-| 达标率 (Compliance Rate) | | 100% | |
-| PC 网站打开速度 | | ≤ 3 s | |
-| 移动网站打开速度 | | ≤ 3 s | |
-| 手机性能指数 | | ≥ 75 | |
+| 指标 (Metric)            | 报告值 (Report Value) | 健康标准 (Health Benchmark) | 优先级与行动 (Priority & Action) |
+| ------------------------ | --------------------- | --------------------------- | -------------------------------- |
+| 达标率 (Compliance Rate) |                       | 100%                        |                                  |
+| PC 网站打开速度          |                       | ≤ 3 s                       |                                  |
+| 移动网站打开速度         |                       | ≤ 3 s                       |                                  |
+| 手机性能指数             |                       | ≥ 75                        |                                  |
 
 ---
 
@@ -237,11 +237,11 @@
 
 ### 8.2 广泛匹配关键词洞察
 
-| 统计项 | 数值 |
-|--------|------|
+| 统计项             | 数值         |
+| ------------------ | ------------ |
 | 广泛匹配关键词数量 | `broadTotal` |
-| 总关键词数量 | `total` |
-| 广泛匹配占比 | % |
+| 总关键词数量       | `total`      |
+| 广泛匹配占比       | %            |
 
 - **数据分析** / **优化建议**：`broadKeywordsCount.analysis`、`suggestions`
 
@@ -259,8 +259,8 @@
 **数据**：`biddingStrategy.items`（仅「有问题」的系列进入表格；无数据时页面为「出价策略配置良好」）
 
 | 广告系列 | 投放时长 | 当前出价策略 | 推荐出价策略 | 状态 |
-|----------|----------|--------------|--------------|------|
-| | | | | |
+| -------- | -------- | ------------ | ------------ | ---- |
+|          |          |              |              |      |
 
 ---
 
@@ -271,14 +271,14 @@
 
 ### 搜索广告 — 检测规则
 
-- **Headlines**：推荐大于 2 个，最多 4 个  
+- **Headlines**：推荐大于 2 个，最多 4 个
 - **Descriptions**：推荐 8–10 个，最多 15 个；含 1–2 个关键字相关 + 3 个不含关键字的通用标题
 
 ### 创意表
 
 | 广告 | Headlines | Descriptions | 优化建议 |
-|------|-----------|--------------|----------|
-| | | | |
+| ---- | --------- | ------------ | -------- |
+|      |           |              |          |
 
 - **分析** / **优化建议**：`adCreativeOptimization.analysis`、`suggestions`
 
@@ -290,8 +290,8 @@
 **数据**：`newFeatures.items`
 
 | 策略/功能 (Strategy/Feature) | 账户状态 (Account Status) | 优化师建议 (Senior Optimizer Recommendation) |
-|------------------------------|---------------------------|-----------------------------------------------|
-| | | |
+| ---------------------------- | ------------------------- | -------------------------------------------- |
+|                              |                           |                                              |
 
 ---
 
@@ -307,8 +307,8 @@
 ### 12.2 优先级优化路线图
 
 | 优先级 | 优化重点 | 关键行动 | 预期效果 |
-|--------|----------|----------|----------|
-| | | | |
+| ------ | -------- | -------- | -------- |
+|        |          |          |          |
 
 **数据**：`summary.optimizationRoadmap`
 
@@ -316,14 +316,14 @@
 
 ## 附录：与 CLI 拉数对照（可选）
 
-| 报告块 | 可参考的 `siluzan-tso google-analysis` 子命令 |
-|--------|-----------------------------------------------|
+| 报告块                                             | 可参考的 `siluzan-tso google-analysis` 子命令                                           |
+| -------------------------------------------------- | --------------------------------------------------------------------------------------- |
 | 账户结构 / 转化 / 黄金账户 / 系列类型 / 落地页主域 | `resource-counts`、`conversion-actions`、`gold-account`、`campaign-types`、`final-urls` |
-| 概览与维度汇总 | `overview`、`dimension-summary` |
-| 重点项对比（系列/地域/词） | `campaigns`、`geographic`、`keywords`（本期/上期各拉一次后在文外对比） |
-| 定向全表 | `geographic`、`devices`、`audience`（SystemDefined / UserDefined 各一次） |
-| 搜索词与广告 | `search-terms`、`ads` |
-| 按日 CPA | `daily-metrics` |
-| 预算竞争力（展示份额等） | `dimension-summary` + `campaigns` 等组合计算 |
+| 概览与维度汇总                                     | `overview`、`dimension-summary`                                                         |
+| 重点项对比（系列/地域/词）                         | `campaigns`、`geographic`、`keywords`（本期/上期各拉一次后在文外对比）                  |
+| 定向全表                                           | `geographic`、`devices`、`audience`（SystemDefined / UserDefined 各一次）               |
+| 搜索词与广告                                       | `search-terms`、`ads`                                                                   |
+| 按日 CPA                                           | `daily-metrics`                                                                         |
+| 预算竞争力（展示份额等）                           | `dimension-summary` + `campaigns` 等组合计算                                            |
 
 详见 `references/account-analytics.md`。

package/dist/skill/report-templates/google-period-report.md

@@ -9,16 +9,16 @@
 
 生成报告时，**默认包含**以下 8 个维度：
 
-| # | 维度 | CLI |
-|---|------|-----|
-| 1 | 执行摘要（消耗/展示/点击/转化/CTR/CPC/CPA 本期概览） | `google-analysis overview` |
-| 2 | 每日投放趋势（按日消耗/点击/转化曲线） | `google-analysis daily-metrics` |
-| 3 | 月度汇总（全周期汇总数据） | `google-analysis dimension-summary` |
-| 4 | 广告系列表现（预算/出价策略/各系列消耗与效果） | `google-analysis campaigns` |
-| 5 | 设备分布（PC/移动/平板 消耗/点击/转化） | `google-analysis devices` |
-| 6 | 地域分布（国家/地区 消耗占比） | `google-analysis geographic` |
-| 7 | 关键词表现（词/消耗/CTR/CPC 排行） | `google-analysis keywords` |
-| 8 | 优化建议（根据以上数据给出可执行改进建议） | 不额外拉数，基于已有数据撰写 |
+| #   | 维度                                                 | CLI                                 |
+| --- | ---------------------------------------------------- | ----------------------------------- |
+| 1   | 执行摘要（消耗/展示/点击/转化/CTR/CPC/CPA 本期概览） | `google-analysis overview`          |
+| 2   | 每日投放趋势（按日消耗/点击/转化曲线）               | `google-analysis daily-metrics`     |
+| 3   | 月度汇总（全周期汇总数据）                           | `google-analysis dimension-summary` |
+| 4   | 广告系列表现（预算/出价策略/各系列消耗与效果）       | `google-analysis campaigns`         |
+| 5   | 设备分布（PC/移动/平板 消耗/点击/转化）              | `google-analysis devices`           |
+| 6   | 地域分布（国家/地区 消耗占比）                       | `google-analysis geographic`        |
+| 7   | 关键词表现（词/消耗/CTR/CPC 排行）                   | `google-analysis keywords`          |
+| 8   | 优化建议（根据以上数据给出可执行改进建议）           | 不额外拉数，基于已有数据撰写        |
 
 **在执行任何数据拉取之前**，先向用户展示以下可选维度，询问是否需要追加：
 
@@ -26,19 +26,19 @@
 
 ## 平台支持的全部可选维度
 
-| 维度 | CLI | 备注 |
-|------|-----|------|
-| 受众分布 | `google-analysis audience` | 可分 `SystemDefined` / `UserDefined` |
-| 搜索词报告 | `google-analysis search-terms` | 高消耗搜索词与关键词匹配关系 |
-| 广告创意表现 | `google-analysis ads` | 广告标题/类型/到达网址 |
-| 附加信息 | `google-analysis extensions` | 附加链接/电话/宣传信息等状态 |
-| 图片/视频素材 | `google-analysis materials` | 图片 + 视频合并视图 |
-| 账户落地页 | `google-analysis final-urls` | 主投放域名/落地页（不传日期） |
-| 黄金账户评分 | `google-analysis gold-account` | 健康度评分与各项达标状态 |
-| 广告质量指标 | `google-analysis ads-index` | 质量得分汇总 |
-| 转化动作配置 | `google-analysis conversion-actions` | 已配置的转化目标列表 |
-| 账户结构统计 | `google-analysis resource-counts` | 系列/组/广告/词数量 |
-| 广告系列类型 | `google-analysis campaign-types` | 系列类型分布（不传日期） |
+| 维度          | CLI                                  | 备注                                 |
+| ------------- | ------------------------------------ | ------------------------------------ |
+| 受众分布      | `google-analysis audience`           | 可分 `SystemDefined` / `UserDefined` |
+| 搜索词报告    | `google-analysis search-terms`       | 高消耗搜索词与关键词匹配关系         |
+| 广告创意表现  | `google-analysis ads`                | 广告标题/类型/到达网址               |
+| 附加信息      | `google-analysis extensions`         | 附加链接/电话/宣传信息等状态         |
+| 图片/视频素材 | `google-analysis materials`          | 图片 + 视频合并视图                  |
+| 账户落地页    | `google-analysis final-urls`         | 主投放域名/落地页（不传日期）        |
+| 黄金账户评分  | `google-analysis gold-account`       | 健康度评分与各项达标状态             |
+| 广告质量指标  | `google-analysis ads-index`          | 质量得分汇总                         |
+| 转化动作配置  | `google-analysis conversion-actions` | 已配置的转化目标列表                 |
+| 账户结构统计  | `google-analysis resource-counts`    | 系列/组/广告/词数量                  |
+| 广告系列类型  | `google-analysis campaign-types`     | 系列类型分布（不传日期）             |
 
 ---