# 报告模板目录

本目录包含两类文件：

| 文件类型                | 用途                                            |
| ----------------------- | ----------------------------------------------- |
| `*.md`                  | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |
| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容    |

> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。

---

## 内容纲要文件

| 文件                                 | 适用场景                                                                                                       |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| `google-period-report.md`            | Google 账户分析报告（周期/月度/诊断均用此模板）                                                                |
| `google-period-report-excel.md`      | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |
| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等）                                                                      |
| `google-ads-diagnosis.md`            | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**）                      |
| `meta-period-report.md` / `.html`    | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |
| `meta-period-report-excel.md`        | **仅用户要 Excel 时**：5 Sheet xlsx 版式；Agent 脚本写表，无 CLI excel 子命令 |
| `meta-account-diagnosis-report.md`   | Meta（Facebook）诊断报告（在 7 Section 内对齐 Google 诊断结构）                                                |
| `tiktok-period-report.md`            | TikTok 广告主周期报告                                                                                          |
| `bing-period-report.md`              | Bing（BingV2）分析报告                                                                                         |
| `okki-weekly-google-client.md`       | **OKKI 周报**：Google 发客户固定话术 + 精简维度 CLI；**Excel 仅 Agent 脚本**，见 `references/core/playbooks.md` P6 |
| `google-inquiry-analysis.md`         | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |
| `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |

---

## 样式参考文件

| 文件                            | 风格                  |
| ------------------------------- | --------------------- |
| `report-template.html`          | 商务/数据看板（默认） |
| `report-template-formal.html`   | 正式文件/对外         |
| `report-template-dark.html`     | 深色/投屏             |
| `report-template-onepager.html` | 单页摘要              |
| `report-template-mobile.html`   | 移动端                |
| `report-template-print.html`    | 打印归档              |
| `report-template-academic.html` | 学术/研究口吻         |

---

## 生成报告的规则

### 分析报告的维度确认

生成**分析报告**时：

1. 根据对应 `*.md` 的**默认维度**直接开始拉数（见各 `*.md` 首节）。
2. 同时向用户展示该文件里的**可选维度列表**，询问是否需要追加任何维度。
3. 用户追加的维度，补充拉数后追加到报告末尾。
4. 用户说「不用加」或不回复，只输出默认维度的内容。

### 禁止事项

- 不能使用 HTML 样式文件里的假数据填报告
- 不能凭印象写具体数字，所有数字来自 CLI 执行结果
- 某个维度的数据获取失败，在对应章节注明原因，不写推测内容

### 数据不可用时

在对应章节写：`[ 数据不可用：{原因} ]`，不做猜测。
