siluzan-tso-cli 1.1.64-beta.2 → 1.1.64-beta.3

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 (21) hide show
  1. package/README.md +1 -1
  2. package/dist/index.js +689 -561
  3. package/dist/skill/SKILL.md +3 -2
  4. package/dist/skill/_meta.json +2 -2
  5. package/dist/skill/references/README.md +1 -0
  6. package/dist/skill/references/analytics/account-analytics.md +2 -0
  7. package/dist/skill/references/core/intent-routing.md +5 -2
  8. package/dist/skill/references/core/playbooks.md +17 -0
  9. package/dist/skill/references/google-ads/demand-gen-api.md +1 -1
  10. package/dist/skill/references/report-templates/README.md +2 -0
  11. package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +5 -2
  12. package/dist/skill/references/report-templates/demand-gen-analysis-report-excel.md +122 -0
  13. package/dist/skill/references/report-templates/demand-gen-analysis-report.md +166 -0
  14. package/dist/skill/report-templates/README.md +2 -0
  15. package/dist/skill/report-templates/REPORT-WORKFLOW.md +5 -2
  16. package/dist/skill/report-templates/demand-gen-analysis-report-excel.md +122 -0
  17. package/dist/skill/report-templates/demand-gen-analysis-report.html +402 -0
  18. package/dist/skill/report-templates/demand-gen-analysis-report.md +166 -0
  19. package/dist/skill/scripts/install.ps1 +1 -1
  20. package/dist/skill/scripts/install.sh +1 -1
  21. package/package.json +1 -1
package/dist/skill/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: siluzan-tso
3
- 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 --min-monthly-search，禁止分批洗词脚本，禁止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/Demand Gen（W3，无 Display；Demand Gen 用 ad demand-gen；含 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。
3
+ 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 --min-monthly-search，禁止分批洗词脚本，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；只要周期数据/8维/花费转化汇总/Excel→P4；Demand Gen/需求开发投放数据分析或汇总报告→P4-DG（demand-gen-render 出 HTML，要 Excel 走对应纲要，不是创建 W3）；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/Demand Gen（W3，无 Display；Demand Gen 用 ad demand-gen；含 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。
4
4
  license: MIT
5
5
  compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
6
6
  metadata:
@@ -100,7 +100,7 @@ siluzan-tso -h
100
100
  | 用户意图（关键词） | 工作流 | 必读文档 |
101
101
  | ------------------ | ------ | -------- |
102
102
  | 新建搜索系列 / 出投放方案 / Excel·表格方案 / 官网生成搜索广告 | **W3** | `references/google-ads/google-ads-campaign-plan.md`（§**仅出方案 vs 创建**）+ **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md` + `rules/google-ads-launch-plan-template.md`（JSON 后**写代码**投影完整审查稿）；有方案文件时加 `rules/google-ads-plan-source-fidelity.md`。**≠ P8 / ≠ P9 / ≠ W5**；**禁止**因缺账户阻塞出方案、**禁止**只交概览表 |
103
- | Demand Gen / 需求开发 / 需求生成广告 | **W3** | `references/google-ads/demand-gen-api.md` + **`assets/demand-gen-create-template.json`**。只用 `ad demand-gen`。创建固定暂停；启用须用户同意且 `--confirm-enable --i-confirm`。**≠ Display ≠ PMax** |
103
+ | Demand Gen / 需求开发 **创建·搭建·改预算·启停**（**不是**分析报告） | **W3** | `references/google-ads/demand-gen-api.md` + **`assets/demand-gen-create-template.json`**。只用 `ad demand-gen`。创建固定暂停；启用须用户同意且 `--confirm-enable --i-confirm`。**≠ Display ≠ PMax**。投放数据分析 / 汇总报告走 **P4-DG** |
104
104
  | 展示广告 / Display / 自适应展示广告（RDA） | — | **不支持**。向用户说明后改推 Search、PMax 或 Demand Gen（W3）；勿创建、勿假装已支持 |
105
105
  | 广告系列/组/广告/关键词 **查询** / 拒审字段 | W3 | `references/google-ads/google-ads-read.md` |
106
106
  | 广告系列/组/广告/关键词 **创建·编辑·启停** | W3 | `references/google-ads/google-ads-write.md` |
@@ -126,6 +126,7 @@ siluzan-tso -h
126
126
  | ------------------ | ------ | -------- |
127
127
  | Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |
128
128
  | Google 账户周期 **数据汇总**（只要花费/转化/9 章/Excel；**无**规划/客户版/大族） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |
129
+ | **Demand Gen / 需求开发投放数据分析、汇总报告**（客户与运营共用；**不是**创建广告） | **P4-DG** | `report-templates/demand-gen-analysis-report.md`；要 Excel 加 `demand-gen-analysis-report-excel.md`。HTML：`google-analysis demand-gen-render`。**≠ P4 全账户周期 ≠ W3 创建** |
129
130
  | Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md` + **`report-templates/google-quarterly-plan.md`**（**未带询盘表须先问并等待**，禁止不问就 collect；有表须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；规划九章；花费三档基于本期、不是已批预算；**不做**行业数据；**render 成功立刻交付 HTML**，禁止改 HTML / 转 PDF / 截图验收） |
130
131
  | Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |
131
132
  | TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |
package/dist/skill/_meta.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.64-beta.2",
4
- "publishedAt": 1793612804179
3
+ "version": "1.1.64-beta.3",
4
+ "publishedAt": 1793619016782
5
5
  }
package/dist/skill/references/README.md CHANGED
@@ -107,6 +107,7 @@
107
107
  | 文件 | 适用场景 |
108
108
  | ---------------------------------------------------------------- | ------------------------------ |
109
109
  | `google-period-report.md` | Google 账户周期/月度报告（P4） |
110
+ | `demand-gen-analysis-report.md` / `demand-gen-analysis-report-excel.md` | Demand Gen 投放数据分析汇总（P4-DG） |
110
111
  | `google-quarterly-report.md` | Google 季度经营报告（P10） |
111
112
  | `google-quarterly-plan.md` | P10 下期规划规则（九章） |
112
113
  | `google-period-report-excel.md` | P4 用户要 Excel |
package/dist/skill/references/analytics/account-analytics.md CHANGED
@@ -540,6 +540,8 @@ siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
540
540
  | 模板 | 用途 |
541
541
  | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
542
542
  | `google-period-report.md` | Google 周期汇总报告章节 |
543
+ | `demand-gen-analysis-report.md` | Demand Gen 投放数据分析汇总报告（P4-DG，`google-analysis demand-gen-render`） |
544
+ | `demand-gen-analysis-report-excel.md`| Demand Gen 汇总报告 Excel（9 Sheet，Agent 脚本） |
543
545
  | `google-quarterly-report.md` | Google 季度经营报告（`google-quarterly collect`+`render`，P10） |
544
546
  | `google-quarterly-plan.md` | P10 下期规划规则（写 `narrative.plan` 前必读） |
545
547
  | `google-account-diagnosis-report.md` | Google 诊断报告纲要 |
package/dist/skill/references/core/intent-routing.md CHANGED
@@ -222,7 +222,8 @@
222
222
  | **P8** | **单个网站 / 落地页 / URL** 的质量 | 见 **§零**（含网站/网络混说）；另：官网体检、投放前网站检查 | **URL** | HTML（`website-diagnosis render`） |
223
223
  | **P9** | **行业 / 市场 / 战略**（**无网址主诉求**） | 市场分析、**行业分析**、**行业分析报告**、市场调查报告、战略市场报告、KA 市场报告、竞品/GTM、「写一份 **XX 行业** 报告」（电商/制造/医疗…） | 客户名 / 行业 / 核心产品 **至少一项**（**不是** URL+诊断） | HTML（`market-analysis render`） |
224
224
  | **P1** | **单个 Google 广告账户** 的投放健康 / 诊断 | Google **广告**诊断、**账户**诊断报告、投放诊断、**账户**健康检查、**账户**体检（**且含 Google 账户 ID**） | 账户 ID + 统计区间 | HTML（`google-ads-diagnosis render`） |
225
- | **P4** | **单个媒体广告账户** 某区间的 **周期数据汇总** | 周期报告、投放月报、**只要**花费/转化/8 维/Excel（**没有**规划/客户版/大族/询盘结构） | 媒体 + 账户 ID + 区间 | HTML（默认）；用户要 Excel 见 P4 excel 纲要 |
225
+ | **P4** | **单个媒体广告账户** 某区间的 **周期数据汇总** | 周期报告、投放月报、**只要**花费/转化/8 维/Excel（**没有**规划/客户版/大族/询盘结构；**没有**点名 Demand Gen） | 媒体 + 账户 ID + 区间 | HTML（默认）；用户要 Excel 见 P4 excel 纲要 |
226
+ | **P4-DG** | **Demand Gen** 投放数据分析 / 汇总报告 | Demand Gen 投放数据分析、需求开发汇总报告、需求生成数据分析、客户与运营共用版 | Google 账户 ID + 区间 | HTML（`google-analysis demand-gen-render`）；要 Excel 见 P4-DG excel 纲要 |
226
227
  | **P10** | **单个 Google 账户** 客户版经营复盘 + **下期规划** | **月度报告**、**月总结与规划**、**季度报告**、**Q3 汇总**、**Q4 规划**、**季度汇报**、**投放季报**、客户版、大族模板、下月规划、效率+区域询盘+国家明细 | 账户 ID（季度可省略=上一完整季；月度=上一完整月） | HTML（`google-quarterly render`） |
227
228
  | **P4-DAILY** | **账户级按日表**（无多维） | 按天导出、投放数据 Excel（非 Google/Meta 周期报告） | 媒体 + 账户 ID + 区间 | xlsx（`stats --by-day`） |
228
229
  | **P4-FB** | **Meta/Facebook 账户** 周期或诊断 | Facebook 报告、Meta 月报、FB **账户**诊断报告 | Meta 账户 ID + 区间 | HTML（`facebook-analysis render`）；要表格 `--format xlsx` |
@@ -274,7 +275,8 @@
274
275
  | `转化成本监控` / `CPA 监控` / `谷歌ADS转化成本` / `低余额账户转化成本` | **P3（§零·D）** | `accounts-digest --max-cpa --skip-balance`；贴 `agentBrief.userDelivery` |
275
276
  | `昨日零询盘` / `零询盘账户` / `0 转化` / `有消耗无转化`（**无 CRM 附件**） | **P3（§零·D）** | `--zero-conversions`；**不是 P7** |
276
277
  | `根据 … 生成 Google **搜索**广告` / `搜索广告方案` / `关键词表` + 官网 URL | **W3** | ≠ P8 ≠ P9；若同时要 **搜索量/竞争度** → **W5** |
277
- | `Demand Gen` / `需求开发` / `需求生成广告` | **W3** | `ad demand-gen` + `demand-gen-api.md`。不是 Display，不是 PMax，禁止 `campaign-create` |
278
+ | `Demand Gen` / `需求开发` / `需求生成` + **分析 / 汇总报告 / 投放数据 / 月报 / 周报**（不要创建） | **P4-DG** | `demand-gen-analysis-report.md`；HTML 用 `google-analysis demand-gen-render`。不是 P4 全账户，不是 W3 |
279
+ | `创建 Demand Gen` / `搭建需求开发` / `需求生成广告`（方案、创建、改预算、启停） | **W3** | `ad demand-gen` + `demand-gen-api.md`。不是 Display，不是 PMax，禁止 `campaign-create`。句子里有分析/汇总报告时改 **P4-DG** |
278
280
  | `展示广告` / `Display 广告` / `自适应展示广告` / `RDA`（要创建/出方案） | **不支持** | 不是 Demand Gen。告知后可改推 Search / PMax / Demand Gen（W3） |
279
281
  | `建 TikTok 广告` / `建抖音广告` / `建 Bing 广告` / `建 Yandex 广告` | **不支持搭建** | 可改 P4 账户分析或 W2 开户；禁止 `ad` / `meta-ad` |
280
282
  | **月搜索量** / **竞争度** / **Keyword Planner** / **长尾关键词** / **针对核心词推荐** | **W5（§零·C）** | 必 `keyword --google-only` |
@@ -294,6 +296,7 @@
294
296
  | **生成搜索广告 / 投放方案**（完整 campaign 结构） | P8、P9、P5、W5 |
295
297
  | **建 TikTok / Bing / Yandex 广告** | W3、W13（禁止用 Google `ad` 或 Meta `meta-ad` 伪装） |
296
298
  | **§零·C 命中**（拓词 / 月搜索量 / 竞争度 / Keyword Planner） | P8、P9、P1、P4；**禁止**纯 WebSearch 代替 `keyword` |
299
+ | **Demand Gen 投放数据分析 / 汇总报告** | W3 创建、P4 全账户 9 章 |
297
300
  | **OKKI** | P4 默认周期 |
298
301
  | **§零·D 命中**（转化成本 / CPA / 零转化 / 零询盘且无 CRM） | P7、P4、P1；**禁止**猜 `--period`；须交付表或「无命中」 |
299
302
  | **询盘** + Google 账户 + **CRM 询盘资料** | P4、P1 简版诊断、P3 账户级 CPA 巡检 |
package/dist/skill/references/core/playbooks.md CHANGED
@@ -89,6 +89,23 @@
89
89
 
90
90
  > 用户用「OKKI 周报」固定话术 → 改走 **P6**，不按默认 10 章追问。
91
91
  > 只要账户级按日 Excel（无多维章节）→ **P4-DAILY**。
92
+ > 用户要的是 **Demand Gen / 需求开发** 投放数据分析或汇总报告 → **P4-DG**，不要用本卡的 9 个拉数维。
93
+
94
+ ---
95
+
96
+ ## P4-DG · Demand Gen 投放数据分析汇总报告
97
+
98
+ - **触发**：Demand Gen / 需求开发 / 需求生成的投放数据分析、汇总报告、客户与运营共用版。只要 Excel 也走本卡。
99
+ - **不是**：创建或修改 Demand Gen（**W3**，`ad demand-gen` 写入）；也不是 Google 全账户周期报告（**P4**）。
100
+ - **必读**：`report-templates/demand-gen-analysis-report.md`。要 Excel 再读 `report-templates/demand-gen-analysis-report-excel.md`。
101
+ - **步骤**：
102
+ 1. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-dg`。
103
+ 2. `google-analysis -a <id> --start … --end … --sections overview,campaigns,daily-metrics,devices,geographic,audience --json-out ./snap-dg`。系列只留 `channelTypeV2 = DEMAND_GEN`。
104
+ 3. `ad demand-gen list -a <id> --json-out ./snap-dg`，再对每个系列 `ad demand-gen report -a <id> --campaign-id <id> --start-date … --end-date … --json-out ./snap-dg`。
105
+ 4. 脚本读盘写 `demand-gen-analysis-report.json`。有效线索、商机、成交、业务 ROAS 用户没给就写 `未提供`。禁止抄模板演示数。
106
+ 5. 默认 HTML：`google-analysis demand-gen-render --data ./demand-gen-analysis-report.json --out ./demand-gen-analysis-report.html --lang <zh|en>`。
107
+ 6. 用户要 Excel：按 excel 纲要写 9 张表。**不要**用 `demand-gen-render` 代替 xlsx。
108
+ - **产物**：8 节 HTML，或 9 Sheet xlsx。`accountId` 与用户给的 ID 一致。
92
109
 
93
110
  ---
94
111
 
package/dist/skill/references/google-ads/demand-gen-api.md CHANGED
@@ -66,7 +66,7 @@
66
66
  | `ad demand-gen audience` / `audience-keywords` | 换受众 / 换词 |
67
67
  | `ad demand-gen add-adgroup` / `add-ad` | 再加一组或一条 |
68
68
  | `ad demand-gen delete-ad` / `delete-adgroup` | 须 `--i-confirm`，且不能删光 |
69
- | `ad demand-gen report -a <id> --campaign-id <id>` | 版位报表 |
69
+ | `ad demand-gen report -a <id> --campaign-id <id>` | 版位报表。投放数据分析汇总报告走 **P4-DG**（`report-templates/demand-gen-analysis-report.md`），不要用创建流程出报告 |
70
70
  | `ad demand-gen conversions-validate` | 离线转化只校验 |
71
71
 
72
72
  写操作都要 `--commit "说明"`。
package/dist/skill/references/report-templates/README.md CHANGED
@@ -24,6 +24,8 @@
24
24
  | 文件 | 适用场景 |
25
25
  | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
26
  | `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |
27
+ | `demand-gen-analysis-report.md` | **Demand Gen 投放数据分析汇总报告（P4-DG）**：终稿=HTML，8 节 → `google-analysis demand-gen-render`。不是全账户 P4，也不是创建广告 |
28
+ | `demand-gen-analysis-report-excel.md` | **仅用户要 Excel 时**：9 Sheet，Agent 脚本写 xlsx；不调用 `demand-gen-render` |
27
29
  | `google-quarterly-report.md` / `.html` | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章 |
28
30
  | `google-quarterly-plan.md` | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读 |
29
31
  | `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |
package/dist/skill/references/report-templates/REPORT-WORKFLOW.md CHANGED
@@ -26,6 +26,7 @@
26
26
  | 意图 | Google | Meta | TikTok | Bing | Yandex |
27
27
  | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------- | ----------------------- | ------------------------- |
28
28
  | 周期分析 / 月报 / 周报 | `google-period-report.md` | `meta-period-report.md` | `tiktok-period-report.md` | `bing-period-report.md` | `yandex-period-report.md` |
29
+ | **Demand Gen 投放数据分析 / 汇总报告**（不是创建） | `demand-gen-analysis-report.md`（**P4-DG**；要 Excel 加 `demand-gen-analysis-report-excel.md`） | — | — | — | — |
29
30
  | OKKI 周报 / 固定话术发客户（Google） | `okki-weekly-google-client.md` | — | — | — |
30
31
  | **询盘分析** / 固定运营触发（Goog账户询盘分析 / 我给你询盘信息分析Google账号XXX效果） | `google-inquiry-analysis.md`（**严格 3 个月** + 用户上传询盘资料 + 8 Sheet xlsx；见 SKILL **P7**） | — | — | — |
31
32
  | 深度诊断 / 健康检查 | `google-account-diagnosis-report.md` | `meta-account-diagnosis-report.md`（`facebook-analysis diagnosis-render` 出 HTML） | 同周期，注明能力受限 | 同周期 |
@@ -36,7 +37,7 @@
36
37
 
37
38
  ### 步骤 3：展示默认维度 + 询问追加
38
39
 
39
- **例外**：模板为 `okki-weekly-google-client.md` 或 `google-inquiry-analysis.md` 时**跳过**本节「追问可选追加」，按该文件固定维度拉数即可。`google-inquiry-analysis.md` 还要求**严格 3 个月**时间窗（分析月份 + 向前 2 个完整自然月），不可扩展。
40
+ **例外**：模板为 `okki-weekly-google-client.md`、`google-inquiry-analysis.md` 或 `demand-gen-analysis-report.md` 时**跳过**本节「追问可选追加」，按该文件固定章节拉数即可。`google-inquiry-analysis.md` 还要求**严格 3 个月**时间窗（分析月份 + 向前 2 个完整自然月），不可扩展。
40
41
 
41
42
  1. 按选定 `*.md` 的**默认维度**开始拉数（**不必等用户回复后再拉**，可并行）。
42
43
  2. 同时向用户发一条消息，说明本次默认包含哪些维度，并列出当前平台支持的**可选追加维度**，询问是否需要添加。
@@ -93,6 +94,7 @@
93
94
  | **Meta/Facebook 周期** | `facebook-analysis render` → **HTML**（必做） | `facebook-analysis render --format xlsx`（五 Sheet，见 `meta-period-report-excel.md`） |
94
95
  | **Meta/Facebook 诊断** | `facebook-analysis diagnosis-render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `diagnosis-render` |
95
96
  | **Google 周期报告** | `google-analysis render` → **HTML**（必做） | **周期/定制 Sheet**：`google-period-report-excel.md`（P4，先 outline 后脚本）；**不**默认 `render` |
97
+ | **Demand Gen 汇总报告** | `google-analysis demand-gen-render` → **HTML**（P4-DG，8 节） | `demand-gen-analysis-report-excel.md`（9 Sheet，Agent 脚本）；**不**调用 `demand-gen-render` |
96
98
  | **TikTok 周期报告** | `tiktok-analysis render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `render` |
97
99
  | **Bing 周期报告** | `bing-analysis render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `render` |
98
100
  | **Yandex 周期报告** | `yandex-analysis render` → **HTML**（必做） | Agent 脚本按 `yandex-period-report-excel.md` 写 xlsx；**不**默认 `render` |
@@ -101,7 +103,7 @@
101
103
  | **Google 询盘（P7）** | **必产 8 Sheet `.xlsx`**（Agent 脚本） | 同左 |
102
104
  | **网站诊断** | `website-diagnosis render` → HTML | — |
103
105
 
104
- **禁止**：Meta / Google / TikTok / Bing 周期报告与 Meta 诊断报告默认只交 Markdown/JSON；禁止 Agent 手写以上报告 HTML。**禁止 P6/P7** 用对话 Markdown 表或手写 HTML 代替 `.xlsx`。
106
+ **禁止**：Meta / Google / TikTok / Bing 周期报告、Demand Gen 汇总报告与 Meta 诊断报告默认只交 Markdown/JSON；禁止 Agent 手写以上报告 HTML。**禁止 P6/P7** 用对话 Markdown 表或手写 HTML 代替 `.xlsx`。Demand Gen 要 Excel 时按 `demand-gen-analysis-report-excel.md` 写 9 张表，不要调用 `demand-gen-render`。
105
107
 
106
108
  **Google 广告诊断报告**（`google-ads-diagnosis.md` / `google-account-diagnosis-report.md`）额外必遵：
107
109
 
@@ -125,6 +127,7 @@
125
127
  | 用户措辞 | 映射 |
126
128
  | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
127
129
  | 月报、周报、投放总结、效果回顾 | 周期分析 → 对应媒体 `*-period-report.md` |
130
+ | **Demand Gen / 需求开发 / 需求生成** + 分析、汇总报告、投放数据 | **P4-DG** → `demand-gen-analysis-report.md`（HTML：`google-analysis demand-gen-render`；Excel：`demand-gen-analysis-report-excel.md`） |
128
131
  | **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间；含「表格形式」） | **固定话术 + 必产 5 Sheet `.xlsx`** → `okki-weekly-google-client.md`（见 SKILL **P6**）；终稿必须 `google-analysis okki-render`；「表格形式」= Excel，**禁止**对话 Markdown 表 / 手写 HTML / Agent 手写 xlsx |
129
132
  | **Goog账户询盘分析 / Google 账户询盘分析 / 分析XXX Google账号的询盘效果 / 我给你询盘信息分析Google账号XXX效果**（或含「询盘 + 账户 + Google」三要素） | **询盘 + 账户合并分析 + 严格 3 个月 + 8 Sheet xlsx** → `google-inquiry-analysis.md`（见 SKILL **P7**）；询盘资料用户上传任意载体，宿主 Agent 解析落盘 `inquiries.json`，xlsx **仅**由 Agent 脚本生成 |
130
133
  | 健康检查、诊断、账户分析 | 诊断 → `google-account-diagnosis-report.md`（Google）或周期型降级 |
package/dist/skill/references/report-templates/demand-gen-analysis-report-excel.md ADDED
@@ -0,0 +1,122 @@
1
+ # Demand Gen 投放数据分析汇总报告 — Excel
2
+
3
+ > **终稿语言**：Sheet 名和表头跟 `meta.lang`。英文用下面的英文表名和表头，不要另起结构。
4
+ > **适用场景**：用户明确要求 **Demand Gen 汇总报告 + Excel/xlsx**。工作流 **P4-DG**。
5
+ > **工作流**：与 `demand-gen-analysis-report.md` 共用拉数和 JSON。交付形态不同。
6
+ > **禁止**：调用 `google-analysis demand-gen-render` 代替 xlsx；加载宿主「xlsx / Excel」第三方 Skill；把 HTML 样例里的演示数字写入单元格。
7
+
8
+ 用户没要 Excel 时，只走 HTML 纲要。两样都要时，先写同一份 `demand-gen-analysis-report.json`，再渲染 HTML，并用本文把这份 JSON 写成 xlsx。
9
+
10
+ 样式按 `excel-style-guide.md`，脚本可 `import` 同目录 `excel-style-kit.mjs`。账户 ID、系列 ID、广告组 ID 用文本（`numFmt: '@'`）。
11
+
12
+ ---
13
+
14
+ ## 执行门禁
15
+
16
+ | # | 门禁 | 动作 |
17
+ | --- | --- | --- |
18
+ | 1 | Read | `agent-conventions.md`、`demand-gen-analysis-report.md`、本文 |
19
+ | 2 | 账户 | `list-accounts -m Google -k <id> --json-out ./snap-dg` |
20
+ | 3 | 币种 | `items[].ma.currencyCode` |
21
+ | 4 | 拉数 | 与 HTML 纲要相同。Demand Gen 过滤 `channelTypeV2 = DEMAND_GEN`。版位用 `ad demand-gen report` |
22
+ | 5 | outline | 每个 `google-analysis` section 先 Read `*.outline.txt` |
23
+ | 6 | JSON | 脚本写入 `demand-gen-analysis-report.json`。缺 CRM 的格子写 `未提供` |
24
+ | 7 | 写簿 | 脚本只读这份 JSON 和落盘快照。9 张表都要有，空表也保留表头并写 `未提供` |
25
+ | 8 | 审阅 | `agent-conventions.md` §七。xlsx 无法 Read 时贴自检表和脚本 stdout |
26
+
27
+ ---
28
+
29
+ ## 9 张表
30
+
31
+ 中文表名固定如下。英文终稿换成括号里的名字。
32
+
33
+ | 表 | 内容来源 |
34
+ | --- | --- |
35
+ | `01_管理层总览`（`01_Overview`） | `meta`、`headline`、`summaryParagraph`、`headlineKpis`、`summaryPoints` |
36
+ | `02_分析范围`（`02_Scope`） | `scopeRows`、`conversionLevels` |
37
+ | `03_漏斗`（`03_Funnel`） | `funnel.stages`、`funnel.rates`、两条建议 |
38
+ | `04_核心指标`（`04_KPIs`） | `kpiGroups` |
39
+ | `05_趋势异常`（`05_Trend`） | `narrative.trend`。HTML 没有这一章 |
40
+ | `06_各维度数据`（`06_Dimensions`） | `dimensions`，每个维度一块，块标题用 `title` |
41
+ | `07_线索质量`（`07_Lead_Quality`） | `quality` |
42
+ | `08_行动建议`（`08_Actions`） | `actions` |
43
+ | `09_测试计划`（`09_Tests`） | `tests` |
44
+
45
+ ### 01_管理层总览
46
+
47
+ - 第 1 行标题：`Demand Gen 投放数据分析汇总报告`（英文 `Demand Gen performance summary`）。
48
+ - 第 2 行：账户名、账户 ID、本期、对比期、币种、时区、业务目标、主转化。
49
+ - 第 3 行：可信度说明。
50
+ - 接着一块「一句话结论」。
51
+ - KPI 表头：`指标 | 本期 | 对比期变化 | 备注`。英文 `Metric | Current | Change | Note`。
52
+ - 要点表头：`标签 | 标题 | 说明 | 参见`。英文 `Tag | Title | Detail | See`。
53
+
54
+ ### 02_分析范围
55
+
56
+ 两块，不要合成一张没有表头的说明。
57
+
58
+ - 范围：`项目 | 内容`（`Item | Definition`），来自 `scopeRows`。
59
+ - 转化层级：`层级 | 定义 | 来源 | 报告用途`（`Level | Definition | Source | Use`）。
60
+
61
+ ### 03_漏斗
62
+
63
+ `阶段 | 数量 | 逐级转化率 | 主要影响因素`（`Stage | Volume | Step rate | Driver`）。
64
+
65
+ 阶段名和数量来自 `stages`，转化率和影响因素来自 `rates`。对不上的行分开写，不要为了对齐而编造。表下两行写 `adsAdvice`、`salesAdvice`。
66
+
67
+ ### 04_核心指标
68
+
69
+ `层级 | 指标 | 本期 | 对比期变化`（`Layer | Metric | Current | Change`）。`层级` 用 `kpiGroups[].title`。
70
+
71
+ ### 05_趋势异常
72
+
73
+ 日表：`日期 | 花费 | 平台转化 | 平台CPA | 有效线索 | 备注`（`Date | Spend | Platform conversions | Platform CPA | Qualified leads | Note`）。
74
+
75
+ 异常表：`现象 | 证据 | 原因 | 动作`（`What happened | Evidence | Cause | Action`）。
76
+
77
+ 日花费和平台转化来自 `daily-metrics` 里 Demand Gen 能拆出来的部分。拆不出来就用账户日花费，并在备注写「账户合计，含非 Demand Gen」。有效线索没有 CRM 就写 `未提供`。
78
+
79
+ ### 06_各维度数据
80
+
81
+ 每个 `dimensions[]` 一块。表头用该块的 `columns`，不要改成另一套列。建议列（有数据才出现）：
82
+
83
+ | 块 | 中文列 | 英文列 |
84
+ | --- | --- | --- |
85
+ | Campaign | 投放组合、花费、有效线索、有效成本、有效率、商机率、状态、修改建议 | Mix, Spend, Qualified leads, Cost per qualified, Qualified rate, Opportunity rate, Status, Change |
86
+ | 素材 | 素材角度 + 同上，可无商机率 | Angle |
87
+ | 受众 | 受众 + Campaign 列 | Audience |
88
+ | 地域 | 地域 + Campaign 列 | Location |
89
+ | 设备 | 设备 + Campaign 列 | Device |
90
+ | 版位 | 版位 + Campaign 列 | Channel |
91
+ | 来源 | 来源 + Campaign 列 | Source |
92
+
93
+ 没有 CRM 时删掉有效线索及之后的业务列，改留「花费、平台转化、平台 CPA、修改建议」，并在块下注明。不要留一列全是 `未提供` 假装算过。
94
+
95
+ 版位块只来自 `ad demand-gen report`。地域、设备、受众若仍是账户合计，块下写明，不要把它们说成 Demand Gen 已对账。
96
+
97
+ ### 07_线索质量
98
+
99
+ `线索批次 | 表单 | 有效线索 | 商机 | 成交 | 成交收入 | 成熟度 | 建议`（`Cohort | Forms | Qualified | Opportunities | Wins | Revenue | Maturity | Note`）。
100
+
101
+ 没有批次资料时只留一行 `未提供`。表下写 `businessConclusion` 和 `splitFactors`。
102
+
103
+ ### 08_行动建议
104
+
105
+ `优先级 | 动作 | 证据 | 具体修改 | 验证阈值 | 负责人 | 时限 | 风险`（`Priority | Action | Evidence | Change | Check | Owner | Due | Risk`）。
106
+
107
+ 优先级只用 `P0` / `P1` / `P2`。
108
+
109
+ ### 09_测试计划
110
+
111
+ `测试项 | 假设 | 对照 / 实验组 | 主指标 | 样本量 | 周期 | 停止规则`（`Test | Hypothesis | Control / variant | Metric | Sample | Window | Stop rule`）。
112
+
113
+ 一个测试只改一个主要变量。样本还没达到时，停止规则写「样本不足则不判胜负」。
114
+
115
+ ---
116
+
117
+ ## 不要做的事
118
+
119
+ - 不要把 9 张表收成 1 张「汇总」。
120
+ - 不要把 Search / PMax 系列写进 Campaign 块。
121
+ - 不要用模板演示账户的 29 天、$42,680、286、74、19、ROAS 2.84。
122
+ - 对比期没拉时，变化列写 `未拉对比期`，不要写 0% 或 `—` 假装持平。
package/dist/skill/references/report-templates/demand-gen-analysis-report.md ADDED
@@ -0,0 +1,166 @@
1
+ # Demand Gen 投放数据分析汇总报告 — HTML
2
+
3
+ > **终稿语言**：章节标题跟 `meta.lang`（`zh` 或 `en`）。叙事正文用同一种语言。
4
+ > **适用场景**：用户要 **Demand Gen / 需求开发 / 需求生成** 的投放数据分析、汇总报告、客户与运营共用版。工作流 **P4-DG**。
5
+ > **默认终稿**：HTML。用户要 Excel / xlsx 时改读 `demand-gen-analysis-report-excel.md`，**不要**调用 `demand-gen-render`。
6
+ > **禁止**：手写 HTML；把本模板样例里的演示数字（如 $42,680、286 条有效线索、ROAS 2.84）写进 JSON；把本报告当成 Google 全账户周期报告（那是 P4）或当成创建广告（那是 W3）。
7
+
8
+ 客户与运营共用一份报告，不拆两版。HTML 固定 8 节：结论、口径、核心指标、漏斗、各维度、线索质量、行动建议、测试计划。趋势异常只在 Excel 第 5 张表。
9
+
10
+ ---
11
+
12
+ ## 执行步骤
13
+
14
+ 1. Read `references/core/agent-conventions.md`、本文。
15
+ 2. `siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-dg`。无记录则停止。币种用 `items[].ma.currencyCode`。
16
+ 3. 确认本期起止。用户给了对比期就用用户的；没给则取紧挨着的等长上一期，并在可信度说明里写明。
17
+ 4. 拉数（见下节）。对每个 `google-analysis` section Read 同目录 `*.outline.txt` 后再写脚本。业务 JSON 只在脚本里读。
18
+ 5. 脚本把能对上的数字写入 `demand-gen-analysis-report.json`（结构见下）。对不上的格子写 `未提供`，不要推算。
19
+ 6. 渲染：
20
+
21
+ ```bash
22
+ siluzan-tso google-analysis demand-gen-render \
23
+ --data ./demand-gen-analysis-report.json \
24
+ --out ./demand-gen-analysis-report.html \
25
+ --lang zh
26
+ ```
27
+
28
+ 7. 按 `agent-conventions.md` §七 自检。`meta.accountId` 必须是用户给的 `mediaCustomerId`。
29
+
30
+ ---
31
+
32
+ ## 拉数
33
+
34
+ ```bash
35
+ mkdir -p ./snap-dg
36
+ siluzan-tso list-accounts -m Google -k <id> --json-out ./snap-dg
37
+
38
+ siluzan-tso google-analysis -a <id> --start <S> --end <E> --json-out ./snap-dg \
39
+ --sections overview,campaigns,daily-metrics,devices,geographic,audience
40
+
41
+ siluzan-tso ad demand-gen list -a <id> --json-out ./snap-dg
42
+ ```
43
+
44
+ `campaigns` 只保留 `channelTypeV2` 为 `DEMAND_GEN` 的行。Search / PMax / Display 不要并进本报告。
45
+
46
+ 每个 Demand Gen 系列再拉版位（日期参数是 `--start-date` / `--end-date`，不是 `google-analysis` 的 `--start`）：
47
+
48
+ ```bash
49
+ siluzan-tso ad demand-gen report -a <id> --campaign-id <campaignId> \
50
+ --start-date <S> --end-date <E> --json-out ./snap-dg
51
+ ```
52
+
53
+ `spend` 是账户币种浮点，不要拿去当预算。暂停系列全 0 仍是成功，在该行注明。
54
+
55
+ 对比期再拉一遍 `campaigns` 与 `ad demand-gen report`。不要用本期数字充对比期。
56
+
57
+ ### 哪些数不能从广告接口来
58
+
59
+ 有效线索、有效率、商机、商机率、成交、成交收入、业务 ROAS、表单提交、CRM 批次成熟度，都要用户另行提供。用户没给就写 `未提供`，结论里说明因此不能判断该不该加预算。
60
+
61
+ `devices` / `geographic` / `audience` 是**账户合计**，含非 Demand Gen。不能拆到 Demand Gen 时，该维度整表写一行 `未提供：当前接口是账户合计，不是 Demand Gen 专属`。版位只用 `ad demand-gen report`。
62
+
63
+ 字段名以当次 outline 和版位落盘的键为准。禁止猜 `keywordText`、`geoName` 这类名字。
64
+
65
+ ---
66
+
67
+ ## JSON 结构
68
+
69
+ 根上只有 `meta` 和 `narrative`。金额、比率写成展示字符串（`$120.00`、`1.92%`）。比率若来自 0~1 小数，先乘 100 再写入字符串。
70
+
71
+ ```json
72
+ {
73
+ "meta": {
74
+ "lang": "zh",
75
+ "accountId": "6326027735",
76
+ "accountName": "账户名",
77
+ "currency": "USD",
78
+ "timezone": "America/Los_Angeles",
79
+ "startDate": "2026-10-01",
80
+ "endDate": "2026-10-29",
81
+ "compareStartDate": "2026-09-02",
82
+ "compareEndDate": "2026-09-30",
83
+ "periodDays": 29,
84
+ "compareDays": 29,
85
+ "objective": "用户给的业务目标，没有则省略",
86
+ "primaryConversion": "用户给的主转化，没有则省略",
87
+ "credibilityNote": "写清哪些层已对账、哪些是未提供",
88
+ "generatedAt": "2026-11-02",
89
+ "confidence": "广告数据已对账"
90
+ },
91
+ "narrative": {
92
+ "headline": "一句话结论",
93
+ "summaryParagraph": "展开一句",
94
+ "summaryPoints": [{ "tag": "有效", "title": "标题", "detail": "依据", "owner": "见第 3 节" }],
95
+ "headlineKpis": [{ "label": "花费", "value": "$120.00", "delta": "▲10%", "tone": "down" }],
96
+ "customerRead": "给客户的一句解释",
97
+ "scopeRows": [{ "item": "投放范围", "value": "Google Ads Demand Gen" }],
98
+ "conversionLevels": [{ "level": "平台转化", "definition": "Google Ads 点击归因", "source": "Google Ads", "use": "判断前端效率" }],
99
+ "kpiGroups": [{ "title": "前端层", "items": [{ "label": "花费", "value": "$120.00", "delta": "▲10%", "tone": "down" }] }],
100
+ "funnel": {
101
+ "bottleneck": "最大流失环节；不知道就写未提供",
102
+ "stages": [{ "name": "展示", "value": "1,200", "width": 100, "tone": "blue" }],
103
+ "rates": [{ "stage": "点击 → 访问", "rate": "未提供", "factor": "无访问字段" }],
104
+ "adsAdvice": "广告侧修改",
105
+ "salesAdvice": "销售侧修改；没有 CRM 就写未提供"
106
+ },
107
+ "dimensions": [{
108
+ "title": "5.1 Campaign",
109
+ "width": "full",
110
+ "columns": ["投放组合", "花费", "平台转化", "修改建议"],
111
+ "rows": [{ "cells": ["系列名", "$120.00", "3", "先看质量"], "tone": "neutral" }],
112
+ "note": "只含 DEMAND_GEN"
113
+ }],
114
+ "quality": {
115
+ "badge": "CRM 未提供",
116
+ "columns": ["线索批次", "表单", "有效", "商机", "成交", "成交收入", "成熟度"],
117
+ "rows": [{ "cells": ["未提供", "未提供", "未提供", "未提供", "未提供", "未提供", "未提供"], "tone": "neutral" }],
118
+ "businessConclusion": "没有 CRM，不能计算业务 ROAS",
119
+ "splitFactors": "广告只对平台转化负责"
120
+ },
121
+ "actionBadge": "先补数据，再谈扩量",
122
+ "actions": [{
123
+ "priority": "P0",
124
+ "title": "补齐业务层",
125
+ "evidence": "有效线索列为未提供",
126
+ "action": "向用户要批次、有效线索、商机、成交",
127
+ "verify": "三列不再是未提供",
128
+ "owner": "运营",
129
+ "deadline": "拿到资料后",
130
+ "risk": "没有业务层时不要加预算"
131
+ }],
132
+ "tests": [{
133
+ "name": "创意开头",
134
+ "hypothesis": "痛点开头优于功能清单",
135
+ "groups": "功能清单 / 痛点+演示",
136
+ "metric": "有效线索成本",
137
+ "sample": "每组 ≥50 有效线索",
138
+ "period": "14–21 天",
139
+ "stop": "样本不足则不判胜负"
140
+ }],
141
+ "trend": {
142
+ "note": "只给 Excel 第 5 张表，HTML 不展示",
143
+ "columns": ["日期", "花费", "平台转化", "平台CPA", "有效线索", "备注"],
144
+ "rows": [{ "cells": ["2026-10-01", "12.00", "1", "12.00", "未提供", ""], "tone": "neutral" }],
145
+ "anomalies": [{ "phenomenon": "某日花费抬升", "evidence": "来自 daily-metrics", "cause": "只写数据里看得到的原因", "action": "次日复核" }]
146
+ }
147
+ }
148
+ }
149
+ ```
150
+
151
+ `tone`：指标用 `up` / `down` / `neutral`（变好 / 变差 / 只是变化）。表格行用 `good` / `warn` / `bad` / `neutral`。漏斗条用 `blue` / `green` / `purple` / `orange`，`width` 是 0–100 的条宽，不是转化率。
152
+
153
+ `dimensions` 建议顺序：Campaign、素材、受众、地域、设备、版位、落地页来源。没有数据的维度保留标题，行内写 `未提供` 和原因。`width: "full"` 独占一行，`"half"` 与下一张并排。
154
+
155
+ 渲染会拒绝：缺 `accountId`、币种、日期、`headline`、核心指标、漏斗阶段、维度、行动、测试。
156
+
157
+ ---
158
+
159
+ ## 口径
160
+
161
+ - 花费、展示、点击、平台转化只加总 Demand Gen 系列。
162
+ - 平台 CPA = Demand Gen 花费 / Demand Gen 平台转化。转化是 0 时写 `未提供`，不要写 0 成本。
163
+ - 有效成本、有效率、商机率只有用户给了分子分母才算。分母是 0 写 `未提供`。
164
+ - 业务 ROAS = 用户给的已归因收入 / Demand Gen 花费。没给收入就不算。
165
+ - 地域有效线索少于 30 只观察，不写扩量或关停。
166
+ - 系列 ID、广告组 ID 在 Excel 里是文本。HTML 展示名优先用名称，没有名称再展示 ID。
package/dist/skill/report-templates/README.md CHANGED
@@ -24,6 +24,8 @@
24
24
  | 文件 | 适用场景 |
25
25
  | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
26
  | `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |
27
+ | `demand-gen-analysis-report.md` | **Demand Gen 投放数据分析汇总报告（P4-DG）**：终稿=HTML，8 节 → `google-analysis demand-gen-render`。不是全账户 P4，也不是创建广告 |
28
+ | `demand-gen-analysis-report-excel.md` | **仅用户要 Excel 时**：9 Sheet，Agent 脚本写 xlsx；不调用 `demand-gen-render` |
27
29
  | `google-quarterly-report.md` / `.html` | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章 |
28
30
  | `google-quarterly-plan.md` | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读 |
29
31
  | `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |
package/dist/skill/report-templates/REPORT-WORKFLOW.md CHANGED
@@ -26,6 +26,7 @@
26
26
  | 意图 | Google | Meta | TikTok | Bing | Yandex |
27
27
  | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------- | ----------------------- | ------------------------- |
28
28
  | 周期分析 / 月报 / 周报 | `google-period-report.md` | `meta-period-report.md` | `tiktok-period-report.md` | `bing-period-report.md` | `yandex-period-report.md` |
29
+ | **Demand Gen 投放数据分析 / 汇总报告**（不是创建） | `demand-gen-analysis-report.md`（**P4-DG**；要 Excel 加 `demand-gen-analysis-report-excel.md`） | — | — | — | — |
29
30
  | OKKI 周报 / 固定话术发客户（Google） | `okki-weekly-google-client.md` | — | — | — |
30
31
  | **询盘分析** / 固定运营触发（Goog账户询盘分析 / 我给你询盘信息分析Google账号XXX效果） | `google-inquiry-analysis.md`（**严格 3 个月** + 用户上传询盘资料 + 8 Sheet xlsx；见 SKILL **P7**） | — | — | — |
31
32
  | 深度诊断 / 健康检查 | `google-account-diagnosis-report.md` | `meta-account-diagnosis-report.md`（`facebook-analysis diagnosis-render` 出 HTML） | 同周期，注明能力受限 | 同周期 |
@@ -36,7 +37,7 @@
36
37
 
37
38
  ### 步骤 3：展示默认维度 + 询问追加
38
39
 
39
- **例外**：模板为 `okki-weekly-google-client.md` 或 `google-inquiry-analysis.md` 时**跳过**本节「追问可选追加」，按该文件固定维度拉数即可。`google-inquiry-analysis.md` 还要求**严格 3 个月**时间窗（分析月份 + 向前 2 个完整自然月），不可扩展。
40
+ **例外**：模板为 `okki-weekly-google-client.md`、`google-inquiry-analysis.md` 或 `demand-gen-analysis-report.md` 时**跳过**本节「追问可选追加」，按该文件固定章节拉数即可。`google-inquiry-analysis.md` 还要求**严格 3 个月**时间窗（分析月份 + 向前 2 个完整自然月），不可扩展。
40
41
 
41
42
  1. 按选定 `*.md` 的**默认维度**开始拉数（**不必等用户回复后再拉**，可并行）。
42
43
  2. 同时向用户发一条消息，说明本次默认包含哪些维度，并列出当前平台支持的**可选追加维度**，询问是否需要添加。
@@ -93,6 +94,7 @@
93
94
  | **Meta/Facebook 周期** | `facebook-analysis render` → **HTML**（必做） | `facebook-analysis render --format xlsx`（五 Sheet，见 `meta-period-report-excel.md`） |
94
95
  | **Meta/Facebook 诊断** | `facebook-analysis diagnosis-render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `diagnosis-render` |
95
96
  | **Google 周期报告** | `google-analysis render` → **HTML**（必做） | **周期/定制 Sheet**：`google-period-report-excel.md`（P4，先 outline 后脚本）；**不**默认 `render` |
97
+ | **Demand Gen 汇总报告** | `google-analysis demand-gen-render` → **HTML**（P4-DG，8 节） | `demand-gen-analysis-report-excel.md`（9 Sheet，Agent 脚本）；**不**调用 `demand-gen-render` |
96
98
  | **TikTok 周期报告** | `tiktok-analysis render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `render` |
97
99
  | **Bing 周期报告** | `bing-analysis render` → **HTML**（必做） | Agent 脚本写 xlsx；**不**默认 `render` |
98
100
  | **Yandex 周期报告** | `yandex-analysis render` → **HTML**（必做） | Agent 脚本按 `yandex-period-report-excel.md` 写 xlsx；**不**默认 `render` |
@@ -101,7 +103,7 @@
101
103
  | **Google 询盘（P7）** | **必产 8 Sheet `.xlsx`**（Agent 脚本） | 同左 |
102
104
  | **网站诊断** | `website-diagnosis render` → HTML | — |
103
105
 
104
- **禁止**：Meta / Google / TikTok / Bing 周期报告与 Meta 诊断报告默认只交 Markdown/JSON；禁止 Agent 手写以上报告 HTML。**禁止 P6/P7** 用对话 Markdown 表或手写 HTML 代替 `.xlsx`。
106
+ **禁止**：Meta / Google / TikTok / Bing 周期报告、Demand Gen 汇总报告与 Meta 诊断报告默认只交 Markdown/JSON；禁止 Agent 手写以上报告 HTML。**禁止 P6/P7** 用对话 Markdown 表或手写 HTML 代替 `.xlsx`。Demand Gen 要 Excel 时按 `demand-gen-analysis-report-excel.md` 写 9 张表，不要调用 `demand-gen-render`。
105
107
 
106
108
  **Google 广告诊断报告**（`google-ads-diagnosis.md` / `google-account-diagnosis-report.md`）额外必遵：
107
109
 
@@ -125,6 +127,7 @@
125
127
  | 用户措辞 | 映射 |
126
128
  | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
127
129
  | 月报、周报、投放总结、效果回顾 | 周期分析 → 对应媒体 `*-period-report.md` |
130
+ | **Demand Gen / 需求开发 / 需求生成** + 分析、汇总报告、投放数据 | **P4-DG** → `demand-gen-analysis-report.md`（HTML：`google-analysis demand-gen-render`；Excel：`demand-gen-analysis-report-excel.md`） |
128
131
  | **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间；含「表格形式」） | **固定话术 + 必产 5 Sheet `.xlsx`** → `okki-weekly-google-client.md`（见 SKILL **P6**）；终稿必须 `google-analysis okki-render`；「表格形式」= Excel，**禁止**对话 Markdown 表 / 手写 HTML / Agent 手写 xlsx |
129
132
  | **Goog账户询盘分析 / Google 账户询盘分析 / 分析XXX Google账号的询盘效果 / 我给你询盘信息分析Google账号XXX效果**（或含「询盘 + 账户 + Google」三要素） | **询盘 + 账户合并分析 + 严格 3 个月 + 8 Sheet xlsx** → `google-inquiry-analysis.md`（见 SKILL **P7**）；询盘资料用户上传任意载体，宿主 Agent 解析落盘 `inquiries.json`，xlsx **仅**由 Agent 脚本生成 |
130
133
  | 健康检查、诊断、账户分析 | 诊断 → `google-account-diagnosis-report.md`（Google）或周期型降级 |