siluzan-tso-cli 1.0.0-beta.36 → 1.0.0-beta.37

package/README.md

@@ -20,7 +20,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.0.0-beta.36），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.0.0-beta.37），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手 | 建议 `--ai` |
 |------|-------------|

package/dist/skill/SKILL.md

@@ -8,8 +8,9 @@ description: >-
   industry/timezone lookup helpers); account lifecycle (add OAuth, delink,
   share/unshare, Google MCC bind/unbind, Meta BM bind, TikTok BC bind/unbind,
   TikTok close, suspended-Google withdraw, Google email access invites);
-  optimization reports, report email push, Meta/TikTok/Bing account analytics,
-  and Google analysis via the configured gateway; inter-account transfers;
+  optimization reports (TSO steward), report email push, Meta/TikTok/Bing account analytics,
+  and Google analysis via the configured gateway; for written analytics/diagnosis reports from CLI data,
+  confirm report dimensions with the user first (except steward optimization reports); inter-account transfers;
   invoices plus invoice billing profiles (invoice-info); AI smart campaigns
   (list/get/publish/update) and AIGC data prep or one-shot create; AI ad
   optimization and intelligent forewarning; TikTok/Meta lead forms; full Google
@@ -40,12 +41,30 @@ description: >-
 | `references/google-ads.md` | Google 广告 CRUD（系列 / 组 / 创意 / 关键词） |
 | `references/google-ads-test.md` | Google 广告业务矩阵与 Agent 测试 |
 | `references/aigc.md` | AIGC 广告方案数据准备（`aigc prepare`）及落地流程 |
-| `references/reporting.md` | TSO steward 报告、Google 网关分析、`google-analysis`、**Meta/TikTok/Bing TSO 分析**（`report meta-overview`、`report tiktok-*`、`report bing-*`）、AI 智投 / 优化 / 预警 / 线索 |
-| `report-templates/` | Google / Meta / TikTok / Bing 报告资源目录。**`.md` 是内容必选纲要；`.html` 只是视觉样式参考**（与 `google-analysis`、`report tiktok-*`、`report bing-*` 等配合） |
+| `references/reporting.md` | TSO steward **优化报告**、Google 网关分析、`google-analysis`、**Meta/TikTok/Bing TSO 分析**（`report meta-overview`、`report tiktok-*`、`report bing-*`）、AI 智投 / 优化 / 预警 / 线索 |
+| `report-templates/` | 分析/诊断类报告纲要（`.md`）与 HTML 样式；**生成前须确认维度**见本节「报告与维度」 |
 | `references/finance.md` | 转账 / 发票（充值需网页） |
 | `references/tso-home.md` | TSO 首页看板页面与 CLI 对照 |
 | `references/setup.md` | 安装 / 登录 / 配置 / 环境切换 |
-| `EVAL-HARNESS.md`|自我升级|
+
+---
+
+## 分析报告生成规则
+
+两类报告，规则不同：
+
+| 类型 | 操作 | 规则 |
+|------|------|------|
+| **TSO 优化报告** | `report list` / `report create` / `report push` 等 | 由平台生成，直接操作，不需要额外询问维度 |
+| **分析报告**（Agent 撰写） | `google-analysis *` / `report tiktok-*` / `report bing-*` / `report meta-overview` 拉数后撰写 | 按下方规则执行 |
+
+### 分析报告做法
+
+1. **按 `report-templates/google-period-report.md`（或对应媒体的 `*.md`）中的默认维度直接拉数**：执行摘要、每日投放趋势、月度汇总、广告系列表现、设备分布、地域分布、关键词表现、优化建议。
+2. **同时**向用户发一条消息，展示当前平台支持的**全部可选追加维度**（见 `google-period-report.md` 的可选列表），询问是否需要加入报告。
+3. 报告主体按默认维度写完；用户追加了维度，数据回来后补充在报告末尾。
+4. 用户说「不用加」或不回复，只输出默认内容。
+
 ---
 
 ## 业务流程速查
@@ -57,7 +76,8 @@ description: >-
 | 手动搭建 Google 广告（系列→组→词→广告） | `references/workflows.md` 流程三 |
 | 查看 AI 优化建议并执行 | `references/workflows.md` 流程四 |
 | 创建/管理智能预警规则 | `references/workflows.md` 流程五 |
-| 生成报告 → 设置推送 → 获取查看链接 | `references/workflows.md` 流程六 |
+| TSO 优化报告 → 推送 → 查看链接 | `references/workflows.md` 流程六 |
+| CLI 拉数撰写的分析/诊断报告 | `references/workflows.md` 流程六点五 + `report-templates/README.md` |
 | 开票申请完整流程 | `references/workflows.md` 流程七 |
 | 定期拉取 TikTok/Meta 广告线索 | `references/workflows.md` 流程八 |
 | 账户分享 / OAuth 重授权 / 解绑 | `references/workflows.md` 流程九 |
@@ -165,6 +185,8 @@ CLI 命令执行后可能在输出末尾出现以下两种标记，Agent 必须
 - **分页**：默认每页 20 条，数据量大时加 `--page-size 100` 或 `--page` 翻页。
 - **充值等网页操作**：先 `config show` 取 `webUrl`，再拼路径引导用户。
 - **Google 新开户**：终端用户优先建议 `open-account google-wizard`；说明网页「五步」里**充值激活**必须网页完成。详见 `references/open-account-google-ui.md`。
-- **报告目录优先级**：生成报告时，先读 `report-templates/*.md` 定义内容，再读 `report-template*.html` 选择样式；**内容优先级永远高于样式**。
+- **分析报告**：按默认维度直接拉数 + 撰写，同时列出可选追加维度询问用户；见上文「分析报告生成规则」与 `report-templates/google-period-report.md`。
+- **优化报告**（`report list/create/push`）：由平台生成，直接操作，不额外询问维度。
+- **报告内容以 `*.md` 纲要为准**，`report-template*.html` 仅提供样式，内容优先级高于样式。
 - **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件，不要猜参数。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.0.0-beta.36",
-  "publishedAt": 1774591613486
+  "version": "1.0.0-beta.37",
+  "publishedAt": 1774595766004
 }

package/dist/skill/references/reporting.md

@@ -360,7 +360,9 @@ siluzan-tso report bing-audience-merged -a <mediaCustomerId>
 - `report-templates/meta-period-report.md` — Meta（Facebook）周期报告纲要（当前仅总览）
 - `report-templates/tiktok-period-report.md` — TikTok 周期报告纲要（与 `report tiktok-*` 对齐）
 - `report-templates/bing-period-report.md` — Bing（BingV2）分析纲要（与 `report bing-*` 对齐）
-- `report-templates/README.md` — 索引
+- `report-templates/README.md` — 索引与规则
+
+> **分析报告做法**：按 `google-period-report.md`（或对应媒体 `*.md`）中的默认维度拉数撰写，同时列出可选追加维度询问用户。TSO 优化报告（`report list` / `create` / `push`）不走此流程。
 
 ---
 

package/dist/skill/references/workflows.md

@@ -537,6 +537,26 @@ siluzan-tso report delete --ids <id1>,<id2>
 
 ---
 
+## 流程六点五：账户分析报告（CLI 拉数 + Agent 撰稿）
+
+对应能力：`google-analysis`、`report meta-overview`、`report tiktok-*`、`report bing-*` 与 `report-templates/*.md`。
+
+### 与流程六的区别
+
+| 流程六 | 流程六点五 |
+|--------|------------|
+| TSO **优化报告**：`report create` / `list` / 推送 / 查看链接 | Agent **撰写**的分析报告：CLI 取数后按纲要组织 Markdown/HTML |
+
+### 步骤
+
+1. 确认账户 ID（`list-accounts`）与日期区间。
+2. 选定对应媒体的 `report-templates/*.md`（Google 用 `google-period-report.md`，其他类推）。
+3. 按该 `*.md` 的**默认维度**直接拉数；同时向用户发消息，展示**可选追加维度**列表（见该 `*.md`），询问是否追加。
+4. 用默认维度数据撰写报告；用户追加的维度数据到位后，补充在末尾。
+5. 可选：按 `report-template*.html` 选择 HTML 样式输出（未指定时默认 `report-template.html`）。
+
+---
+
 ## 流程七：开票申请完整流程
 
 对应页面：`/recharge/invoicingApplicationList`、`/recharge/invoiceList`

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

@@ -1,145 +1,66 @@
-# 报告模板（账户分析纲要）
+# 报告模板目录
 
-本目录包含两类文件，职责**完全不同**，使用前必须区分：
+本目录包含两类文件：
 
-| 文件类型 | 职责 | 权威性 |
-|---------|------|--------|
-| `*.md` | **内容合同**：必写章节、数据来源、最低交付标准 | 最高 — 冲突时以此为准 |
-| `report-template*.html` | **样式参考**：排版、卡片、图表、打印或移动端视觉方案 | 仅限视觉 — 不定义内容 |
+| 文件类型 | 用途 |
+|---------|------|
+| `*.md` | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |
+| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容 |
 
-> 完整的能力边界（哪些媒体能拉哪些数据、命令参数）**只维护**在 `references/reporting.md`，本目录不重复描述。
+> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。
 
-## 使用顺序（必须遵守）
+---
 
-1. **先读对应的 `*.md`** — 确认"这份报告必须写什么"
-2. **再读 `report-template*.html`** — 确认"这些内容怎么展示"
-3. **冲突时以 `*.md` 为准** — 不能因 HTML 缺某章节就省略 `.md` 要求的内容
-4. **HTML 中的假数据不是内容** — 示例里的假标题、假数字只是 UI 演示
-
-## 内容合同文件（先读这些）
+## 内容纲要文件
 
 | 文件 | 适用场景 |
 |------|---------|
-| `google-period-report.md` | Google 账户周期分析（系列 / 地域 / 设备 / 关键词汇总） |
-| `google-account-diagnosis-report.md` | Google 账户健康度诊断（结构、定向、创意、搜索词等分章） |
-| `google-ads-diagnosis.md` | 与网页版《Google Ads 账户诊断报告》对齐的完整 Markdown 骨架 |
-| `meta-period-report.md` | Meta（Facebook）账户周期报告（当前仅总览；见 `report meta-overview`） |
-| `tiktok-period-report.md` | TikTok 广告主周期报告（见 `report tiktok-*` 子命令） |
-| `bing-period-report.md` | Bing（BingV2）分析（见 `report bing-*`；日期不可含今天/昨天） |
-
-**数据来源**：
-- Google：`siluzan-tso google-analysis <子命令>`（需配置 `googleApiUrl`）
-- Meta / TikTok / Bing：`siluzan-tso report <媒体>-overview`，见 `references/reporting.md`
-
-## 样式参考文件（后读这些）
-
-技术栈：Tailwind Play CDN + Font Awesome 6 + ECharts 5
-
-| 样式文件 | 风格 | 适用场景 |
-|---------|------|---------|
-| `report-template.html` | 商务 / 数据看板 | 对内经营分析、运营周报 |
-| `report-template-academic.html` | 专业学术 | 研究 / 方法说明口吻 |
-| `report-template-formal.html` | 正式文件 / 公文 | 对外说明性、留痕类文档 |
-| `report-template-dark.html` | 深色 / 演示投屏 | 会议室大屏 |
-| `report-template-print.html` | 黑白打印 | 归档与传真式阅读 |
-| `report-template-onepager.html` | 对客单页精华 | 首屏摘要 + 折叠详情 |
-| `report-template-mobile.html` | 移动端优先 | 手机查看 |
-
-## 未知报告名的处理
+| `google-period-report.md` | Google 账户分析报告（周期/月度/诊断均用此模板） |
+| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |
+| `google-ads-diagnosis.md` | 与网页版《Google Ads 账户诊断报告》对齐的完整骨架 |
+| `meta-period-report.md` | Meta（Facebook）账户周期报告 |
+| `tiktok-period-report.md` | TikTok 广告主周期报告 |
+| `bing-period-report.md` | Bing（BingV2）分析报告 |
 
-当用户要求不在上表中的报告名时，参见 `REPORT-WORKFLOW.md` 中的映射与降级流程。
+---
 
-## 报告生成规则
+## 样式参考文件
 
-> 设计哲学：**先建轨道，再跑模型**。未知报告名不是失败，编造数据才是失败。
+| 文件 | 风格 |
+|------|------|
+| `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` | 学术/研究口吻 |
 
-### 报告资源目录的角色划分（单一事实源）
+---
 
-| 文件类型 | 职责 | 权威性 |
-|---------|------|--------|
-| `report-templates/*.md` | **内容合同**：必写章节、数据来源、最少交付要求 | 最高，冲突时以此为准 |
-| `report-template*.html` | **样式样板**：排版、色彩、图表、响应式 | 仅限视觉，不定义内容 |
-| `references/reporting.md` | **能力边界**：哪些媒体能拉哪些数据、命令参数 | 能力唯一真源，不在其他地方重复 |
+## 生成报告的规则
 
-### 门禁一：开始前必须声明（不可跳过）
+### 优化报告 vs 分析报告
 
-任何报告生成任务，在拉取数据或写任何内容之前，**先在对话中输出以下声明**：
+| 类型 | 典型操作 | 是否询问维度 |
+|------|---------|-------------|
+| **优化报告**（TSO steward） | `report list` / `report create` / `report push` | 不需要 |
+| **分析报告**（CLI 拉数 + Agent 撰写） | `google-analysis *`、`report tiktok-*`、`report bing-*` 等 | 是 |
 
-```
-报告类型判断：
-- 用户意图：[周期分析 / 诊断 / 对比 / 汇报摘要]
-- 媒体：[Google / Meta / TikTok / Bing / ...]
-- 使用的内容合同（.md）：[文件名]
-- 使用的样式模板（.html）：[文件名，若需要]
-- 能力覆盖预判：[能覆盖的章节] / [因接口缺失暂无法覆盖的章节]
-```
+### 分析报告的维度确认
 
-未知报告名映射规则（详见 `report-templates/REPORT-WORKFLOW.md`）：
-- 无法识别的报告名 → 先映射到 4 个原型之一（周期 / 诊断 / 对比 / 汇报），再选最接近的 `.md`
-- 无对应媒体的 `.md` → 以 Google 对应原型纲要为骨架，注明适配
+生成**分析报告**时：
+1. 根据对应 `*.md` 的**默认维度**直接开始拉数（见各 `*.md` 首节）。
+2. 同时向用户展示该文件里的**可选维度列表**，询问是否需要追加任何维度。
+3. 用户追加的维度，补充拉数后追加到报告末尾。
+4. 用户说「不用加」或不回复，只输出默认维度的内容。
 
-### 门禁二：数据驱动，禁止编造
+### 禁止事项
 
-- **必须**：所有数字结论来自实际执行的 CLI 命令输出；命令 → 字段路径 → 结论，三者可追溯
-- **禁止**：照抄 HTML 示例中的假数据（如 `¥12,580`、`18,420`）填入报告
-- **禁止**：在缺乏接口支持时生成"看起来完整"的章节
-- 若某章节数据无法获取，在报告中**明确标注**，不写内容、不做猜测
+- 不能使用 HTML 样式文件里的假数据填报告
+- 不能凭印象写具体数字，所有数字来自 CLI 执行结果
+- 某个维度的数据获取失败，在对应章节注明原因，不写推测内容
 
-### 门禁三：输出前覆盖声明（必须附在每份报告末尾）
+### 数据不可用时
 
-```
-覆盖说明：
-✅ 已覆盖：[已输出的章节列表]
-⚠️ 未覆盖：[章节名] — 原因：[缺接口/缺参数/缺权限/用户未提供账户ID]
-```
-
-### 快速路径（数据已齐全时）
-
-满足以下全部条件时，可跳过门禁一声明，直接生成：
-1. 报告类型已明确（有对应 `.md`）
-2. 账户 ID 已确认（来自 `list-accounts` 或用户明确提供）
-3. 数据已拉取（命令已执行，结果在上下文中）
-
-### HTML 报告默认样式选择
-
-| 场景 | 默认模板 |
-|------|---------|
-| 对内分析 / 运营周报 | `report-template.html` |
-| 正式汇报 / 对外文档 | `report-template-formal.html` |
-| 投屏演示 | `report-template-dark.html` |
-| 单页摘要 | `report-template-onepager.html` |
-| 手机查看 | `report-template-mobile.html` |
-| 打印归档 | `report-template-print.html` |
-
-"带图表"= 在满足 `.md` 内容要求的前提下，把趋势/结构/对比优先用图表展示，**不是**只给图表不写结论。
-
-### 少样本决策示例（3 个必读模式）
-
-**示例 A — 标准报告生成**
-
-用户说："帮我做个 Google 月度投放总结"
-→ 意图：周期分析 → 媒体：Google
-→ 内容合同：读 `google-period-report.md`
-→ 执行门禁一声明：输出类型判断 + 覆盖预判
-→ 执行数据拉取：`google-analysis overview / campaigns / devices / keywords`
-→ 填充章节，末尾附覆盖声明
-→ 样式默认：`report-template.html`（未指定时）
-
-**示例 B — 未知报告名映射**
-
-用户说："给客户一份 Meta 广告账户健康检查"
-→ "健康检查"= 诊断型 → 媒体：Meta
-→ 当前 Meta 无诊断专用 `.md`
-→ 映射：以 `google-account-diagnosis-report.md` 为骨架，查 `references/reporting.md` 校验 Meta 能力
-→ 发现 Meta 当前只有 overview 接口（无系列/受众/搜索词细分）
-→ 声明：降级生成，注明未覆盖章节与原因
-→ 执行：`report meta-overview -a <id> --json`，仅填能覆盖的节
-→ 末尾覆盖声明：列出未覆盖原因
-
-**示例 C — 账户操作 ID 门禁**
-
-用户说："查一下 Google 账户 123456 的余额"
-→ 禁止直接用"123456"执行命令
-→ 先执行 `siluzan-tso list-accounts -m Google` 确认该 ID 在列表中
-→ 确认后取 `mediaCustomerId`，再执行 `siluzan-tso balance -m Google -a <mediaCustomerId>`
-→ 不在列表中：告知用户该 ID 未找到，请确认账户归属
+在对应章节写：`[ 数据不可用：{原因} ]`，不做猜测。

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

@@ -1,144 +1,76 @@
-# 报告生成工作流（未知报告名处理流程）
-
-本文档定义当用户请求的报告名不在已知模板列表中时的**标准处理流程**，以及每种情况下的降级规则与覆盖声明格式。
-
----
-
-## 六步处理流程
-
-```
-步骤 1 识别意图
-   ↓
-步骤 2 原型映射
-   ↓
-步骤 3 数据能力校验
-   ↓
-步骤 4 声明（门禁一）
-   ↓
-步骤 5 执行 + 降级生成
-   ↓
-步骤 6 输出 + 覆盖声明（门禁三）
-```
+# 报告生成流程
 
 ---
 
-### 步骤 1：识别意图
+## 分析报告生成步骤
 
-从用户措辞中提取两个维度：
+适用于：`google-analysis *`、`report tiktok-*`、`report bing-*`、`report meta-overview` 等 CLI 拉数后由 Agent 撰写的报告。
 
-| 维度 | 识别方法 | 示例 |
-|------|---------|------|
-| **媒体** | 关键词：Google / Meta / TikTok / Bing / Kwai | "Meta 广告分析" → MetaAd |
-| **报告类型** | 关键词映射（见下表） | "健康检查" → 诊断型 |
+**不适用**于 TSO 优化报告（`report create` / `report push` 等），那类报告由平台生成，不走此流程。
 
-**类型关键词映射表**
+---
 
-| 用户说的词 | 映射到的原型 |
-|-----------|------------|
-| 月报、周报、日报、阶段分析、投放总结、效果回顾 | **周期型** |
-| 健康检查、诊断、体检、问题排查、账户分析 | **诊断型** |
-| 对比、AB测试、竞品、同期比较 | **对比型** |
-| 汇报、PPT、给客户、精华版、摘要 | **汇报摘要型** |
+### 步骤 1：确认账户与区间
 
-> 若仍无法确定，默认为**周期型**，并在声明中注明推断依据。
+- 账户 ID 须来自 `siluzan-tso list-accounts -m <媒体>` 的实际输出，不能凭印象猜测。
+- 明确起止日期（`--start` / `--end`）。
 
 ---
 
-### 步骤 2：原型映射
+### 步骤 2：选定内容模板
 
-根据「媒体 + 类型」找到最近似的内容合同（`.md`）：
+根据媒体与用户意图，选择 `report-templates/` 下对应的 `*.md`：
 
-| 媒体 | 周期型 | 诊断型 | 对比型 | 汇报摘要型 |
-|------|--------|--------|--------|-----------|
-| Google | `google-period-report.md` | `google-account-diagnosis-report.md` | 无专用，以周期型为骨架 | 以诊断型精简 |
-| Meta | `meta-period-report.md` | 无专用 → 以诊断纲要降级 | 无专用 | 以周期型精简 |
-| TikTok | `tiktok-period-report.md` | 无专用 → 以诊断纲要降级 | 无专用 | 以周期型精简 |
-| Bing | `bing-period-report.md` | 无专用 → 以诊断纲要降级 | 无专用 | 以周期型精简 |
-| 未知媒体 | 以 Google 对应原型为骨架 | → | → | → |
+| 意图 | Google | Meta | TikTok | Bing |
+|------|--------|------|--------|------|
+| 周期分析 / 月报 / 周报 | `google-period-report.md` | `meta-period-report.md` | `tiktok-period-report.md` | `bing-period-report.md` |
+| 深度诊断 / 健康检查 | `google-account-diagnosis-report.md` | 同周期，注明能力受限 | 同周期 | 同周期 |
 
-**降级规则（从高到低）**：
-1. 有精确对应 `.md` → 直接使用
-2. 有同媒体其他类型 `.md` → 用最接近的，声明已适配
-3. 有同类型其他媒体 `.md` → 用 Google 对应型，声明能力受限
-4. 完全无对应 → 以 `google-period-report.md` 为最小骨架，声明原因
+无精确匹配时，用最接近媒体的同类 `*.md`，并在报告开头注明。
 
 ---
 
-### 步骤 3：数据能力校验
-
-打开 `references/reporting.md`，查询该媒体**当前支持的 CLI 命令**。
+### 步骤 3：展示默认维度 + 询问追加
 
-按章节检查哪些能覆盖，哪些无法覆盖：
-
-```
-[能覆盖]   = 有对应 CLI 命令且参数已确认
-[受限]     = 有命令但需额外参数（用户未提供 accountId 等）
-[无法覆盖] = 当前无对应接口 / 命令不存在
-```
+1. 按选定 `*.md` 的**默认维度**开始拉数（**不必等用户回复后再拉**，可并行）。
+2. 同时向用户发一条消息，说明本次默认包含哪些维度，并列出当前平台支持的**可选追加维度**，询问是否需要添加。
+3. 报告正文按默认维度写；若用户追加了维度，数据回来后在末尾补充对应章节。
 
 ---
 
-### 步骤 4：声明（门禁一，不可跳过）
+### 步骤 4：拉取数据
 
-在开始拉数据前，向用户输出以下声明：
-
-```
-报告类型判断：
-- 用户意图：[从步骤 1 识别出的类型]
-- 媒体：[媒体名]
-- 内容合同：[选用的 .md 文件名]（若为降级，注明"适配自 xxx"]）
-- 样式模板：[.html 文件名，若未指定写"默认"]
-- 能覆盖的章节：[列表]
-- 当前无法覆盖：[章节名 + 原因]（若全覆盖写"全部覆盖"）
-```
+- 每条命令加 `--json`。
+- 仅执行与**本次报告维度**对应的命令（默认 + 用户追加）。
+- 数据失败/缺失：在对应章节写 `[ 数据不可用：{原因} ]`，不写推测。
 
 ---
 
-### 步骤 5：执行 + 降级生成
+### 步骤 5：撰写报告
 
-**正常执行路径**：
-1. 按 `.md` 中列出的 CLI 命令依次执行
-2. 每个命令加 `--json` 获取结构化数据
-3. 用实际数据填充对应章节
-
-**降级生成规则**：
-- 章节数据缺失 → 用 `[ 数据不可用：{原因} ]` 占位，不写任何推测性内容
-- 命令执行失败 → 记录错误信息，注明此章节基于上次已有数据或跳过
-- 账户 ID 未确认 → 暂停，提示用户先执行 `list-accounts` 确认
-
-**禁止**：
-- 使用 HTML 模板中的假数字填充真实报告
-- 在没有执行命令的情况下凭印象写出具体数字
-- 把无数据章节写成"暂无异常"（这是误导性结论，需说明原因）
+- 按 `*.md` 章节结构组织内容。
+- 所有数字可追溯到具体命令的 JSON 输出字段。
+- 最后写**优化建议**（基于已有数据，不额外拉数）。
+- 可选：按 `report-template*.html` 选择 HTML 样式输出（未指定时默认 `report-template.html`）。
 
 ---
 
-### 步骤 6：输出 + 覆盖声明（门禁三，每份报告必须附）
-
-报告正文末尾追加：
+### 步骤 6：末尾附数据来源（可选）
 
 ```
----
-## 覆盖说明
-
-✅ 已覆盖：
-- [章节一]
-- [章节二]
+📌 数据来源：
+- siluzan-tso google-analysis overview -a <id> --start <s> --end <e>
 - ...
-
-⚠️ 未覆盖：
-- [章节名] — 原因：[缺接口 / 缺参数 / 账户未授权 / 用户未提供 ID]
-
-📌 本报告数据来源：[实际执行的命令列表]
 ```
 
 ---
 
-## 常见场景速查
+## 未知报告名处理
+
+| 用户措辞 | 映射 |
+|---------|------|
+| 月报、周报、投放总结、效果回顾 | 周期分析 → 对应媒体 `*-period-report.md` |
+| 健康检查、诊断、账户分析 | 诊断 → `google-account-diagnosis-report.md`（Google）或周期型降级 |
+| 对比、汇报、给客户看 | 以周期型为骨架，简化版本 |
 
-| 场景 | 处理方式 |
-|------|---------|
-| 用户说"帮我看下 Kwai 账户" | 无 Kwai 专用模板 → 用 `google-period-report.md` 骨架 → 查 `reporting.md` 确认 Kwai 支持哪些命令 → 声明降级 |
-| 用户说"生成一份竞品对比报告" | 对比型 → 当前无专用模板 → 降级为周期型 → 声明：当前无竞品数据接口，仅输出本账户数据 |
-| 用户未提供账户 ID | 步骤 5 暂停 → 提示：请先运行 `siluzan-tso list-accounts -m <媒体>` 获取 mediaCustomerId |
-| 用户要求"尽量完整"但接口有限 | 声明能力边界，在能覆盖的章节写实，在无数据章节用占位标注 — 不要为了"看起来完整"编造数据 |
+无法识别时，默认按**周期分析**处理，并在报告开头注明推断。

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

@@ -1,50 +1,55 @@
-# Google 账户 — 周期分析报告（模板纲要）
+# Google 账户分析报告
 
 > 统计区间：`{startDate}` ~ `{endDate}`  
-> 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
-
-以下每一节对应一段独立分析叙述；数据由 CLI 拉取后填入表格或 bullet。
+> 账户：`{mediaCustomerId}`
 
 ---
 
-## 1. 执行摘要
-
-- 消耗、展示、点击、转化、CTR、CVR、CPC、CPA（本期 vs 若有上期可对比）
-- **CLI**：`google-analysis overview`、`google-analysis dimension-summary`
-
-## 2. 广告系列表现
-
-- 系列名称、预算、出价策略、搜索广告展示份额相关指标（若有）
-- **CLI**：`google-analysis campaigns`
-
-## 3. 地域分布
-
-- 国家/地区、消耗占比、展示份额类字段（若有）
-- **CLI**：`google-analysis geographic`
+## 默认报告维度
 
-## 4. 设备分布
+生成报告时，**默认包含**以下 8 个维度：
 
-- 设备类型、互动量、CTR、消耗
-- **CLI**：`google-analysis devices`
+| # | 维度 | 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 | 优化建议（根据以上数据给出可执行改进建议） | 不额外拉数，基于已有数据撰写 |
 
-## 5. 关键词概览
-
-- 词、匹配方式、质量得分、排名、消耗与转化
-- **CLI**：`google-analysis keywords`（默认 `limit=100`、`orderByCost=true`，可调 `--limit` / `--no-order-by-cost`）
-
-## 6. 受众（如本期需要）
-
-- 系统定义 / 自定义受众分段
-- **CLI**：`google-analysis audience --audience-type SystemDefined` 与 `UserDefined` 各拉一次后合并叙述
-
-## 7. 附录
-
-- 原始 JSON 存档路径、拉取命令、数据时间戳
+**在执行任何数据拉取之前**，先向用户展示以下可选维度，询问是否需要追加：
 
 ---
 
-### 推荐拉取顺序（脚本化）
+## 平台支持的全部可选维度
+
+| 维度 | 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` | 系列类型分布（不传日期） |
 
-1. `overview` → 2. `campaigns` → 3. `geographic` → 4. `devices` → 5. `keywords` → 6. `audience`（两次）
+---
 
-每条命令追加 `--json` 便于后续用 `jq` 或脚本合并。
+## 拉数顺序（默认 8 个维度）
+
+```bash
+siluzan-tso google-analysis overview          -a <id> --start <s> --end <e> --json
+siluzan-tso google-analysis daily-metrics     -a <id> --start <s> --end <e> --json
+siluzan-tso google-analysis dimension-summary -a <id> --start <s> --end <e> --json
+siluzan-tso google-analysis campaigns         -a <id> --start <s> --end <e> --json
+siluzan-tso google-analysis devices           -a <id> --start <s> --end <e> --json
+siluzan-tso google-analysis geographic        -a <id> --start <s> --end <e> --json
+siluzan-tso google-analysis keywords          -a <id> --start <s> --end <e> --json
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.0.0-beta.36",
+  "version": "1.0.0-beta.37",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "type": "module",
   "bin": {

package/dist/skill/EVAL-HARNESS.md

@@ -1,62 +0,0 @@
-> 改进观察应写入 `user-adaptations.md`（见下方），由 Skill 维护者人工决定是否纳入正式 Skill 版本。
-
-1. 记录失败的测试编号与实际输出
-2. 定位到具体 Skill 文档段落（哪条规则未被遵守）
-3. **将改进建议追加到 `user-adaptations.md`**（格式见下方），不修改 Skill 文件本身
-4. 重新验证失败用例，通过后由维护者决定是否发布
-
----
-
-## user-adaptations.md 格式规范
-
-`user-adaptations.md` 是一份**用户本地适配文件**，存放在userpath/.siluzan/user-adaptations.md (如果没有则你主动创建)
-它**不属于 Skill 包**，执行 `siluzan-tso update` 时不会被覆盖。
-
-### 用途
-
-- 记录用户在本项目中的操作习惯与偏好
-- 记录回归测试中发现的改进点（留给维护者参考）
-- 作为本 Skill 的**补充规则**，优先级低于官方 Skill 文档
-
-
-### 条目格式
-
-```markdown
-## 用户适配记录
-
-### [YYYY-MM-DD] <简短标题>
-
-- **类别**：[报告习惯 / 命令偏好 / 媒体偏好 / 账户配置 / 其他]
-- **观察**：<描述用户表现出的习惯或偏好>
-- **适配规则**：<在本项目中应当如何调整行为>
-- **来源**：[用户明确告知 / 会话观察推断 / 回归测试发现]
-
----
-```
-
-### 示例条目
-
-```markdown
-## 用户适配记录
-
-### [2025-04-01] 用户偏好不展示门禁一声明
-
-- **类别**：报告习惯
-- **观察**：用户多次反馈"不需要看类型判断声明，直接给报告"
-- **适配规则**：本项目中，满足快速路径条件时直接生成，省略门禁一输出
-- **来源**：用户明确告知
-
----
-
-### [2025-04-03] 默认账户 ID
-
-- **类别**：账户配置
-- **观察**：用户本项目主要操作 Google 账户 4545500137
-- **适配规则**：当用户说"那个 Google 账户"未指定 ID 时，优先询问是否为 4545500137
-- **来源**：会话观察推断
-
----
-```
-
----
-

package/dist/skill/report-templates/REPORT-EXAMPLES.md

@@ -1,165 +0,0 @@
-# 报告决策示例（少样本参考）
-
-> **重要**：这些示例记录的是**决策过程**，不是成品文本的模板。  
-> 目的：帮助 AI 理解如何从用户意图映射到正确的工具调用链，而不是照抄任何一份完整输出。
-
----
-
-## 示例 1：标准 Google 周期报告
-
-**用户输入**：帮我做个 Google 上个月的投放总结，账户 4545500137
-
-**决策过程**：
-```
-意图识别：周期型 + Google
-内容合同：google-period-report.md
-账户确认：mediaCustomerId=4545500137（用户明确提供，仍需在 list-accounts 中验证）
-覆盖预判：能覆盖 总览/系列/设备/关键词 → 地域数据视接口状态
-```
-
-**执行命令链**：
-```bash
-siluzan-tso google-analysis overview -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
-siluzan-tso google-analysis campaigns -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
-siluzan-tso google-analysis devices   -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
-siluzan-tso google-analysis keywords  -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
-```
-
-**关键字段提取**（以 overview 为例）：
-```
-cost → 总消耗
-clicks / impressions / ctr / conversions / cpc → 核心 KPI
-costMicros 转换：除以 1,000,000 得到货币值
-```
-
-**章节填充规则**：
-- 有数据的章节：用真实数字，注明环比（需拉上期区间对比）
-- 数据为 0 的章节：如实写 0，说明可能原因（无投放/停投/权限）
-- 无接口的章节：占位标注，不推测
-
-**末尾覆盖声明模板**：
-```
-✅ 已覆盖：总览 / 广告系列表现 / 设备分布 / 关键词消耗
-⚠️ 未覆盖：地域分布 — 原因：overview 接口未返回地域细分，需单独地域命令
-📌 数据来源：google-analysis overview / campaigns / devices / keywords（上述命令已执行）
-```
-
----
-
-## 示例 2：未知报告名 → 降级处理
-
-**用户输入**：给我出一份 Meta 广告账户健康体检报告，账户 ID 112233445
-
-**决策过程**：
-```
-意图识别："健康体检"= 诊断型 + Meta
-内容合同查找：meta 无专用诊断 .md
-映射降级：以 google-account-diagnosis-report.md 为骨架
-能力校验（查 references/reporting.md）：
-  - Meta 当前支持：OverviewSectionData（总览）
-  - Meta 当前不支持：系列细分、受众细分、搜索词、创意诊断
-降级决策：仅填总览章节，其余标注"接口待开放"
-```
-
-**执行命令链**：
-```bash
-siluzan-tso report meta-overview -a 112233445 --json
-```
-
-**声明输出（在开始前向用户说明）**：
-```
-报告类型判断：
-- 用户意图：诊断型
-- 媒体：MetaAd
-- 内容合同：google-account-diagnosis-report.md（降级适配，Meta 暂无专用诊断模板）
-- 能覆盖：账户总览（消耗/点击/展示/转化）
-- 当前无法覆盖：广告系列诊断、受众诊断、创意健康度 — 原因：Meta TSO 当前仅开放 overview 接口
-```
-
-**执行结果中的注意点**：
-- `OverviewSectionData` 返回的是时间段汇总数据，不含历史趋势序列
-- 无法给出"建议优化哪条广告系列"的结论（无系列级数据）
-- 可以给出的结论：CTR/CPC 整体水平判断、消耗趋势方向（若有环比）
-
----
-
-## 示例 3：跨媒体汇总请求
-
-**用户输入**：给我汇总一下上周 Google 和 TikTok 的投放数据
-
-**决策过程**：
-```
-意图识别：周期型 + 多媒体（Google + TikTok）
-内容合同：google-period-report.md + tiktok-period-report.md（分别读）
-执行顺序：先 Google，再 TikTok，最后汇总章节
-```
-
-**执行命令链（分两段）**：
-```bash
-# Google 段
-siluzan-tso google-analysis overview -a <google_id> --start 2025-04-14 --end 2025-04-20 --json
-
-# TikTok 段
-siluzan-tso report tiktok-overview -a <tiktok_id> --start 2025-04-14 --end 2025-04-20 --json
-siluzan-tso report tiktok-campaigns -a <tiktok_id> --start 2025-04-14 --end 2025-04-20 --json
-```
-
-**账户 ID 确认（必须先执行）**：
-```bash
-siluzan-tso list-accounts -m Google
-siluzan-tso list-accounts -m TikTok
-```
-
-**汇总时的报告结构**：
-- 第一节：跨媒体总消耗对比（表格形式，一行一媒体）
-- 第二节：各媒体独立章节（每个媒体按自身 `.md` 要求）
-- 不要把两个媒体的数据混在同一个章节里，口径不同
-
----
-
-## 示例 4：用户提供不存在的报告类型
-
-**用户输入**：给我做一份 Yandex 关键词效果分析报告
-
-**决策过程**：
-```
-意图识别：周期型（关键词聚焦）+ Yandex
-内容合同查找：Yandex 无专用 .md，list-accounts 支持 Yandex，但 reporting.md 无关键词接口
-能力校验：Yandex 当前仅有账户基础数据（stats）
-降级：用 google-period-report.md 骨架中的"关键词分析"章节，但说明数据来源受限
-```
-
-**声明（必须先告知用户）**：
-```
-报告类型判断：
-- 用户意图：关键词效果分析（归属周期型）
-- 媒体：Yandex
-- 内容合同：google-period-report.md 中关键词章节（降级适配）
-- 能覆盖：账户整体消耗、余额（via stats / balance）
-- 当前无法覆盖：Yandex 关键词级数据 — 原因：TSO reporting API 当前未开放 Yandex 关键词细分
-- 建议：若需关键词数据，请直接登录 Yandex Ads 后台查看
-```
-
----
-
-## 示例 5：快速路径（数据已就绪）
-
-**场景**：用户在同一对话中已经执行过 `google-analysis overview --json`，现在说"帮我整理成报告"
-
-**决策过程**：
-```
-快速路径条件检查：
-  ✅ 报告类型明确（周期型 Google）
-  ✅ 账户 ID 已确认（上下文中有）
-  ✅ 数据已拉取（overview JSON 在上下文中）
-→ 跳过门禁一声明，直接填充章节
-→ 仍需输出门禁三覆盖声明（数据仅含 overview，其他章节标注待补充）
-```
-
----
-
-## 这些示例不告诉你的事
-
-- 不要照抄示例中的数字（那些是说明格式用的占位符）
-- 不要把"示例 B 的覆盖声明格式"原文粘贴到真实报告里
-- 示例展示的是**推理路径**，真实报告中的结论必须来自实际命令输出

package/dist/skill/report-templates/google-report-base-html-prompt.md

@@ -1,19 +0,0 @@
-## 视觉基调
-- 以「商务深蓝」为主色调，融合「科技蓝」与「金属铜金」点缀，传递理性、科技与高端感
-
-## 全局样式布局要求
-- 样式布局：CDN: https://staticpn.blob.core.chinacloudapi.cn/assets/slz/homeCDN/bootstrap.min.css
-- 图表渲染：CDN: https://staticpn.blob.core.chinacloudapi.cn/assets/slz/homeCDN/chart.js
-- 字体颜色：亮浅色，不要使用深色，避免与背景颜色混淆，确保可读性
-- 背景色：纯色，不要使用渐变、图案、图片等
-- 主体结构：<body><main>...</main></body>;
-- 默认样式：
-\`\`\`css
-main { max-width: 1200px; margin: 0 auto; }
-canvas { max-height: 400px !important; width: 100% !important; height: auto !important; }
-table { border-collapse: collapse; width: 100%; }
-\`\`\`
-
-## 任务要求
-将以下内容按照[市场与趋势诊断][目标行业深度洞察][目标受众与场景][竞争策略与定位][增长与品牌策略][实施、资源与风险][附录与数据支撑]7个模块进行划分，
-并转换为完整的HTML格式，每个模块要有明显的区域划分和间隔，按内容原有顺序进行展示，不允许添加或删减任何内容，你的任务只是处理样式和布局：