siluzan-tso-cli 1.0.0-beta.44 → 1.0.0-beta.46

package/README.md

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

package/dist/index.js

@@ -10275,7 +10275,7 @@ invoiceInfoCmd.command("delete <id>").description("\u5220\u9664\u53D1\u7968\u62A
 var optimizeCmd = program.command("optimize").description("AI \u5E7F\u544A\u4F18\u5316\uFF08Google\uFF09");
 optimizeCmd.command("list").description("\u67E5\u8BE2\u8D26\u6237\u7EA7\u4F18\u5316\u4E3B\u5217\u8868\uFF08\u5BF9\u5E94\u9875\u9762 /advertising/intelligentOptimization\uFF09").option("-a, --account <id>", "\u8D26\u6237 mediaCustomerId\uFF08\u7559\u7A7A\u67E5\u5168\u90E8\uFF09").option(
   "--match-media-customer-id <id>",
-  "\u5728\u5168\u91CF\u5217\u8868\u4E2D\u7B5B\u9009\u8BE5 Google \u5BA2\u6237 ID\uFF08\u81EA\u52A8\u7FFB\u9875\uFF1B\u5DF2\u8131\u7BA1\u52FF\u7528 -a\uFF0C\u89C1 reporting.md\uFF09"
+  "\u5728\u5168\u91CF\u5217\u8868\u4E2D\u7B5B\u9009\u8BE5 Google \u5BA2\u6237 ID\uFF08\u81EA\u52A8\u7FFB\u9875\uFF1B\u5DF2\u8131\u7BA1\u52FF\u7528 -a\uFF0C\u89C1 optimize.md\uFF09"
 ).option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF", parseInt).option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
   await runOptimizeList({
     token: opts.token,

package/dist/skill/SKILL.md

@@ -21,39 +21,25 @@ description: >-
 
 # Siluzan TSO Skill
 
-通过 `siluzan-tso` CLI 完成广告投放管理，不要手动调接口。
-
-配置查看与更新详见 `references/setup.md`。
-
----
-## 使用指南
-调用本skill前，必须使用-h查看命令行工具的说明
-为了节省token, 尽量使用--json获取一条数据的数据结构后，再通过编写代码的方式对大量的数据进行操作，而不是直接获取大量的原始json这会造成巨量的token浪费！
-对于用户侧请不要透露出命令行的任何参数，因为不太友好
-## 参考文档导航
-
+## 文档索引
 | 文档 | 内容 |
 |------|------|
-| `references/workflows.md`| **多命令组合流程**（优先读取） |
-| `references/tips.md` | **`--json` + Node.js 精准查询技巧**（过滤 / 提取 / 多步串联） |
-| `references/accounts.md` | 账户查询 / 余额 / 消耗 / 开户 / 账号管理 |
-| `references/open-account-google-ui.md` | **Google 开户**：网页五步 + 两步表单与 CLI 对照（向导/时区列表） |
-| `references/open-account-by-media.md` | **各媒体开户差异**：路由、所需资料、接口路径与 CLI 对照（Google/TikTok/Yandex/Bing/Kwai） |
-| `references/google-ads.md` | Google 广告 CRUD（系列 / 组 / 创意 / 关键词） |
-| `references/google-ads-test.md` | Google 广告业务矩阵与 Agent 测试 |
-| `references/aigc.md` | AIGC 智能广告（`ad smart prepare` / `ad smart create`）及落地流程 |
-| `references/reporting.md` | TSO steward **优化报告**、Google 网关分析、`google-analysis`、**Meta/TikTok/Bing TSO 分析**（`report meta-overview`、`report tiktok-*`、`report bing-*`）、AI 智投 / 优化 / 预警 / 线索 |
-| `report-templates/` | 分析/诊断类报告纲要（`.md`）与样式参考；**生成前须确认维度**见本节「报告与维度」 |
+| `references/setup.md` | 安装 / 登录 / 配置 / 环境切换 |
+| `references/workflows.md`| 一般业务流程 |
+| `references/tips.md` | 使用技巧 |
+| `references/accounts.md` | 账户相关 |
+| `references/open-account-by-media.md` | 开户相关 |
+| `references/google-ads.md` | Google广告创建/修改 |
+| `references/aigc.md` | 智能创建广告 / `ad smart`、异步批量 `ad batch` |
+| `references/reporting.md` | TSO 优化报告（list/create/delete）、推送、网页查看 |
+| `references/account-analytics.md` | 各个媒体平台的数据获取 |
+| `references/optimize.md` | `optimize` AI 广告优化记录 |
+| `references/clue.md` | `clue` TikTok/Meta 线索表单 |
+| `references/forewarning.md` | 智能预警（含微信通知、`forewarning` 命令） |
 | `references/finance.md` | 转账 / 发票（充值需网页） |
 | `references/tso-home.md` | TSO 首页看板页面与 CLI 对照 |
-| `references/setup.md` | 安装 / 登录 / 配置 / 环境切换 |
-| `references/google-ads-compliance.md` | **Google 广告合规指南**：关键词 & 文案审核通过规则、编辑规范、禁止内容、虚假承诺处理、商标规则、多语言规则 |
-| `references/sensitive-industries.md` | **敏感行业合规细则**：酒精 / 赌博 / 金融 / 加密 / 医疗 / 法律等 12 个行业的关键词生成规则与地区限制 |
-| `references/google-ads-keyword-strategy.md` | **关键词策略与优化技巧**：匹配类型策略、分组结构、否定词技巧、出价意图分层、搜索词挖掘、竞品策略、PMax/AI Max 协同、信号污染防治 |
-| `references/google-ads-keyword-optimization.md` | **关键词持续优化指南**：基于投放数据的迭代优化闭环——指标解读、决策框架（暂停/提价/降价/加否定）、优化节奏、转化归因、预算再分配、衰减检测、竞争响应、CRM 反馈 |
-| `references/google-ads-creative-optimization.md` | **广告创意与素材优化**：RSA 六类主题法、Ad Strength 评分、文案 A/B 测试、创意疲劳管理、附加信息（Sitelink/Callout/Snippet/Image）优化、DKI/倒计时/IF 函数、落地页 CRO、PMax 创意策略、多语言管理 |
-| `references/google-ads-campaign-optimization.md` | **广告系列结构与投放优化**：系列类型选择决策树、电商/线索/本地/SaaS 架构模板、出价策略校准与启动协议、地域/设备优化、转化追踪（Enhanced Conversions/离线导入/价值规则）、预算优化、网络设置、实验设计、账户健康诊断 |
-| `references/google-ads-creation-plan.md` | **广告创建确认方案模板**（**创建前必读**）：执行任何广告创建命令前，必须按此模板输出完整方案等待用户确认——系列配置、关键词列表、RSA 文案、附加信息、合规检查、执行计划；含等待确认话术和特殊场景（AIGC/关键词追加/草稿发布）处理规则 |
+| `report-templates/report-template.html` | **默认 HTML 样式参考**：凡输出带「总结 / 报告 / 汇总」性质的 HTML（不限于账户分析或诊断），均应以本文件为版式、配色与区块结构的参照；需其他视觉风格时再从同目录 `report-template*.html` 选用或询问用户（见 `report-templates/README.md`） |
+
 ---
 
 ## 分析报告生成规则
@@ -63,14 +49,15 @@ description: >-
 | 类型 | 操作 | 规则 |
 |------|------|------|
 | **TSO 优化报告** | `report list` / `report create` / `report push` 等 | 由平台生成，直接操作，不需要额外询问维度 |
-| **分析报告**（Agent 撰写） | `google-analysis *` / `report tiktok-*` / `report bing-*` / `report meta-overview` 拉数据后撰写 | 按下方规则执行 |
+| **分析报告**（Agent 撰写） | `google-analysis *` / `report tiktok-*` / `report bing-*` / `report meta-overview` 拉数据后撰写 | 按下方规则执行；子命令与模板见 `references/account-analytics.md` |
 
 ### 分析报告做法
 1. 询问用户需要生成哪些维度的报告，或直接生成默认报告：包含以下维度：执行摘要、每日投放趋势、月度汇总、广告系列表现、设备分布、地域分布、关键词表现、优化建议
-2. 默认在**在report-templates/*.html** 文件中找到报告的样式参考，有多个必要时询问用户
+2. 需输出 HTML 时：**默认**以 `report-templates/report-template.html` 为样式基准（适用于一切总结性、报告性、汇总性成稿）；若场景更适合作正式件、深色、单页等，再从 `report-templates/report-template*.html` 中选或询问用户，并对照 `report-templates/README.md`
 3. 输出成html后可以转成pdf方便用户查看
 ---
 
+
 ## 业务流程速查
 
 | 场景 | 参考 |
@@ -81,7 +68,7 @@ description: >-
 | 查看 AI 优化建议并执行 | `references/workflows.md` 流程四 |
 | 创建/管理智能预警规则 | `references/workflows.md` 流程五 |
 | TSO 优化报告 → 推送 → 查看链接 | `references/workflows.md` 流程六 |
-| CLI 拉数撰写的分析/诊断报告 | `references/workflows.md` 流程六点五 + `report-templates/README.md` |
+| CLI 拉数撰写的分析/诊断报告 | `references/workflows.md` 流程六点五 + `references/account-analytics.md` + `report-templates/README.md` |
 | 开票申请完整流程 | `references/workflows.md` 流程七 |
 | 定期拉取 TikTok/Meta 广告线索 | `references/workflows.md` 流程八 |
 | 账户分享 / OAuth 重授权 / 解绑 | `references/workflows.md` 流程九 |
@@ -97,6 +84,7 @@ description: >-
 | 创建/优化广告创意 | `references/google-ads-creative-optimization.md` 全文 |
 | 设计系列架构/调优投放 | `references/google-ads-campaign-optimization.md` 全文 |
 | **创建广告前输出确认方案** | `references/google-ads-launch-plan-template.md` 全文 |
+
 ---
 
 ## 常用命令速查
@@ -134,17 +122,17 @@ description: >-
 | AIGC 方案数据准备 | `siluzan-tso ad smart prepare -a <accountId> --url <url> -w "词1,词2"`（详见 `references/aigc.md`） |
 | 优化报告列表 | `siluzan-tso report list -m Google` |
 | 优化报告推送 | 页 `/dataReport/optimizationReport`：`report push list|create|update|history|receive-emails|start|stop|delete`；记录页 `/dataReport/pushRecord` 对应 `push history --setting-id <entityId>`；详见 `references/reporting.md` |
-| TikTok 账户分析（总览/系列/受众等） | `siluzan-tso report tiktok-overview -a <mediaCustomerId> [--json]`（另有 `tiktok-campaigns`、`tiktok-audience` 等，见 `report --help`） |
-| Bing（BingV2）账户分析 | `siluzan-tso report bing-overview -a <mediaCustomerId> [--json]`（区间不可含今天/昨天；另有 `bing-keywords`、`bing-search-terms` 等，见 `report --help`） |
+| TikTok 账户分析（总览/系列/受众等） | `siluzan-tso report tiktok-overview -a <mediaCustomerId> [--json]`（另有 `tiktok-campaigns`、`tiktok-audience` 等，见 `report --help`）；详见 `references/account-analytics.md` |
+| Bing（BingV2）账户分析 | `siluzan-tso report bing-overview -a <mediaCustomerId> [--json]`（区间不可含今天/昨天；另有 `bing-keywords`、`bing-search-terms` 等，见 `report --help`）；详见 `references/account-analytics.md` |
 | 充值 / 钱包（网页） | 见 `references/finance.md` |
 | 媒体转账记录 | `siluzan-tso transfer list -m Google` |
 | 提交账户间转账 | `siluzan-tso transfer create -m Google --out <转出ID> --in <转入ID> --amount <金额>` |
 | 开票记录 | `siluzan-tso invoice list` |
-| 异步批量 / 智投记录 | `siluzan-tso ad batch list` |
+| 异步批量 / 智投记录 | `siluzan-tso ad batch list`（详见 `references/aigc.md`） |
 | 记录 / 草稿详情 | `siluzan-tso ad batch get --id <id>` |
 | 发布草稿 | `siluzan-tso ad batch publish --id <id>` |
 | 更新草稿 | `siluzan-tso ad batch update --id <id> --budget <n>` |
-| AI 广告优化 | 托管中：`optimize list -a <id>`。已脱管：全量筛 `optimize list --match-media-customer-id <Google客户号> --json` 取批次 `id`，再 `optimize get` / `optimize children --parent-id`；系列列表 `optimize records`（勿依赖 `-a`）；详见 `references/reporting.md` |
+| AI 广告优化 | 托管中：`optimize list -a <id>`。已脱管：全量筛 `optimize list --match-media-customer-id <Google客户号> --json` 取批次 `id`，再 `optimize get` / `optimize children --parent-id`；系列列表 `optimize records`（勿依赖 `-a`）；详见 `references/optimize.md` |
 | Google 广告诊断链接 | `siluzan-tso diagnostic` |
 | 线索表单（TikTok） | `siluzan-tso clue -m TikTok -a <advertiserId>` |
 | 线索表单（Meta） | `siluzan-tso clue -m Meta -a <pageId>` |
@@ -161,7 +149,7 @@ description: >-
 
 ---
 
-## 自动更新规则（必须遵守）
+## 自动更新规则
 
 CLI 命令执行后可能在输出末尾出现以下两种标记，Agent 必须按对应规则处理：
 
@@ -185,8 +173,8 @@ CLI 命令执行后可能在输出末尾出现以下两种标记，Agent 必须
 ---
 
 ## AI 行为规范
-- **合理使用命令行的帮助功能**：使用命令前，调用-h查看命令有哪些参数
-- **先查账户再操作**：对具体账户做操作前，先通过 `list-accounts -m [mediaType] -k {id}` 确认 ID。特别是不确定是Google/Bing/TikTok这些媒体平台中的哪一个的时候
+- **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件或使用-h查看命令帮助，不要猜参数。
+- **先查账户再操作**：对具体账户做操作前，先通过 `list-accounts -m [mediaType] -k [mediaCustomerId]` 确认。特别是不确定是Google/Bing/TikTok这些媒体平台中的哪一个的时候
 - **使用 --json 处理数据**：需对返回数据做计算或筛选时，加 `--json`，再用 `node -e` 过滤提取（见 `references/tips.md`）。
 - **不要猜测账户 ID**：`entityId` ≠ `mediaCustomerId`，两者均来自 `list-accounts`。
 - **媒体类型区分大小写**：`Google`、`TikTok`、`MetaAd`、`BingV2`、`Kwai`。
@@ -197,11 +185,5 @@ CLI 命令执行后可能在输出末尾出现以下两种标记，Agent 必须
 - **Google 新开户**：终端用户优先建议 `open-account google-wizard`；说明网页「五步」里**充值激活**必须网页完成。详见 `references/open-account-google-ui.md`。
 - **分析报告**：按默认维度直接拉数 + 撰写，同时列出可选追加维度询问用户；见上文「分析报告生成规则」与 `report-templates/google-period-report.md`。
 - **优化报告**（`report list/create/push`）：由平台生成，直接操作，不额外询问维度。
-- **报告内容以 `*.md` 纲要为准**，`report-template*.html` 仅提供样式，内容优先级高于样式。
-- **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件，不要猜参数。
-- **关键词/文案合规**：执行 `ad keyword-create`、`ad ad-create`、`ad campaign-create`、`ad smart create` 前，先读 `references/google-ads-compliance.md` 中的生成前检查清单（第十一章）；如行业属于 Tier 2/3（受限/高度管制），还须读 `references/sensitive-industries.md` 对应章节。
-- **关键词策略优化**：生成关键词时，参考 `references/google-ads-keyword-strategy.md` 的匹配类型选择（第二章）、分组结构（第三章）和否定词策略（第四章）；优化已有广告系列时，参考搜索词挖掘（第八章）和信号污染防治（第十五章）。
-- **投放后持续优化**：有投放数据后，按 `references/google-ads-keyword-optimization.md` 的优化节奏（第五章）执行每周/每月任务；使用决策框架（第三章）判断关键词去留；用 `google-analysis` 系列命令拉取数据（第十三章）。
-- **广告创意优化**：创建/编辑广告创意（`ad ad-create`/`ad-edit`）时，参考 `references/google-ads-creative-optimization.md` 的 RSA 六类主题法（第一章）和 Ad Strength 指南（第二章）；管理附加信息时参考第五章；定期检查创意疲劳（第四章）。
-- **系列架构与投放**：新建广告系列（`ad campaign-create`）时，参考 `references/google-ads-campaign-optimization.md` 的架构模板（第二章）和出价启动协议（第三章）；调整地域/设备/预算时参考对应章节；定期用 `google-analysis gold-account` 检查账户健康。
-- **广告创建前必须输出确认方案**：执行 `ad campaign-create`、`ad adgroup-create`、`ad ad-create`、`ad keyword-create`、`ad smart create`、`ad batch publish` 之前，必须先读 `references/google-ads-launch-plan-template.md`，按模板格式输出完整方案，明确等待用户回复「确认」后才能开始执行创建命令；未经用户确认不得提前调用任何写入类命令。
+- **报告内容以 `*.md` 纲要为准**，`report-template*.html` 仅提供样式，内容优先级高于样式；**总结 / 报告 / 汇总类 HTML** 未另指定模板时，默认对齐 `report-templates/report-template.html`（见上文「文档索引」）。
+- **一个完整的产品，不应该暴露内部命令**: 除了setup中的login命令，所有命令行工具都是交由你完全代替用户执行。禁止向用户透露任何命令行，参数，代码逻辑

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.0.0-beta.44",
-  "publishedAt": 1774864067173
+  "version": "1.0.0-beta.46",
+  "publishedAt": 1774927955987
 }

package/dist/skill/references/account-analytics.md

@@ -0,0 +1,174 @@
+# 账户分析数据拉取与周期报告
+
+> 所属 skill：`siluzan-tso`。
+>
+> 本文档说明如何通过 CLI 拉取 **Google / Meta / TikTok / Bing** 的账户分析数据，供撰写**分析报告、诊断报告**使用。  
+> **TSO 平台生成的优化报告**（`report list` / `create` / `push`）见 `references/reporting.md`。
+
+---
+
+## Google 账户分析数据接口
+
+| `report-templates/` | 分析/诊断类报告纲要（`.md`）与输出汇总内容的 style 参考；**生成前须确认维度**见下文「报告模板」 |
+
+用于按账户维度拉取 Google Ads 报表、结构类数据。
+
+### 指标字段对照
+
+多条报表行的原始体里，消耗类指标常用下列字段名（调用方若要做统一展示，可按此对照；**以实际响应为准**）：
+
+| 常见展示名 | 响应中常见字段名 |
+|------------|------------------|
+| 消耗 | `spend` |
+| 展示 | `impressions` |
+| 点击 | `clicks` |
+| 转化 | `conversions` |
+| 点击率 | `ctr` |
+| 转化率 | `conversionRate` |
+| 平均点击成本 | `averageCpc` |
+| 转化成本 | `costPerConversion` |
+
+---
+
+### google-analysis
+
+使用已配置的 `googleApiUrl` 与 Token，无需手写 curl。
+
+```text
+siluzan-tso google-analysis <子命令> -a <mediaCustomerId> [选项]
+```
+
+**通用选项**
+
+| 选项 | 说明 |
+|------|------|
+| `-a, --account` | Google `mediaCustomerId`（必填） |
+| `--start` / `--end` | 统计区间；**须同传或同省略**（省略则默认近 7 天截至昨天） |
+| `--json` | 输出完整响应 JSON |
+| `-t, --token` | 鉴权 Token（可选，默认读配置） |
+| `--verbose` | 打印详细错误 |
+
+**子命令与网关路径对应**
+
+| 子命令 | 说明 |
+|--------|------|
+| `overview` | 总览 `OverviewSectionData` |
+| `keywords` | 关键词 `KeywordSectionData`；可选 `--limit`、`--no-order-by-cost` |
+| `search-terms` | 搜索词 `searchtermmanagement/v2/list`；同上 |
+| `campaigns` | 系列 `CampaignSectionData` |
+| `ads` | 广告 `admanagement/v2/list` |
+| `extensions` | 附加信息 `extensionmanagement/v2/list`；可选 `--level`（Account / Campaign / Ad Group） |
+| `devices` | 设备 `DeviceSectionData` |
+| `geographic` | 地域 `GeographicSectionData` |
+| `audience` | 受众 `AdGroupAudienceData`；可选 `--audience-type SystemDefined \| UserDefined` |
+| `asset-images` | 图片素材 `CampaignAssetView` |
+| `videos` | 视频 `Videos` |
+| `materials` | 合并 `CampaignAssetView` + `Videos`（一次输出 `{ images, videos }`） |
+| `resource-counts` | 结构 `resource-counts` |
+| `conversion-actions` | 转化动作 |
+| `daily-metrics` | 按日 `reports` |
+| `gold-account` | 黄金账户 `GoldAccountData` |
+| `ads-index` | 质量指标 `AdsIndexData` |
+| `final-urls` | 最终到达网址（**不要**传 `--start`/`--end`） |
+| `dimension-summary` | 账户汇总 `reports/combined` |
+| `campaign-types` | 系列类型（**不要**传 `--start`/`--end`） |
+
+**示例**
+
+```bash
+siluzan-tso google-analysis overview -a 6326027735 --start 2026-03-01 --end 2026-03-31 --json
+siluzan-tso google-analysis keywords -a 6326027735 --limit 50
+siluzan-tso google-analysis final-urls -a 6326027735 --json
+```
+
+---
+
+## Meta 账户分析总览（TSO）
+
+```bash
+siluzan-tso report meta-overview -a <mediaCustomerId> [--start YYYY-MM-DD --end YYYY-MM-DD] [--json]
+```
+
+`--start` / `--end` 须**同传或同省略**；省略时默认**近 7 天（截至昨天）**，与 `google-analysis` 日期规则一致。
+
+响应结构可与 Google 总览类比（如 `accountId`、`totalCost`、`currentPeriod` / `previousPeriod`、`optimizationScore` 等），**以实际 JSON 为准**。
+
+**报告模板**：`report-templates/meta-period-report.md`
+
+---
+
+## TikTok 账户分析（TSO）
+
+与周期报告常见数据块对应关系见 **`report-templates/tiktok-period-report.md`**。
+
+| 子命令 | HTTP 段 / 说明 |
+|--------|----------------|
+| `report tiktok-overview` | `.../OverviewSectionData?startDate=&endDate=` |
+| `report tiktok-campaigns` | `.../CampaignSectionData?startDate=&endDate=&take=`（默认 `take=100`） |
+| `report tiktok-ad-groups` | `.../AdGroupReport?...` |
+| `report tiktok-ads` | `.../AdReport?...` |
+| `report tiktok-videos` | `.../VideoReport?...` |
+| `report tiktok-audience` | `.../AudienceReport?...&dimensions=` + `-d` 取值见 CLI 帮助（gender / age / interest_category 等） |
+| `report tiktok-audience-merged` | 同上接口三次（`gender`、`age`、`interest_category`），**合并输出 JSON** |
+| `report tiktok-areacode` | `GET {mainApiUrl}/query/media-account/tiktok/TikTokAreacode/Read` |
+| `report tiktok-interest-list` | `{tiktokApiUrl}/.../GetInterestList?mediaCustomerId=`（需配置 `tiktokApiUrl`） |
+
+**日期与鉴权**：`--start` / `--end` 须**同传或同省略**；省略时默认**近 7 天（截至昨天）**。鉴权与 TSO 其他接口相同。
+
+**示例**
+
+```bash
+siluzan-tso report tiktok-overview -a 1234567890 --json
+siluzan-tso report tiktok-campaigns -a 1234567890 --start 2026-03-01 --end 2026-03-31 --take 50 --json
+siluzan-tso report tiktok-audience -a 1234567890 -d gender --json
+siluzan-tso report tiktok-audience-merged -a 1234567890 --start 2026-03-01 --end 2026-03-07
+siluzan-tso report tiktok-areacode --json
+```
+
+---
+
+## Bing（BingV2）账户分析（TSO）
+
+章节与数据块对照见 **`report-templates/bing-period-report.md`**。
+
+**重要（日期）**：Bing 报表**不能包含「今天」或「昨天」**（接口限制，与 Web 端校验一致）。`--start` / `--end` 须**同传或同省略**；**省略时** CLI 默认区间为**截至前天**的近 7 天（避免误含昨天）。
+
+| 子命令 | HTTP 段 / 说明 |
+|--------|----------------|
+| `report bing-overview` | `.../OverviewSectionData?startDate=&endDate=` |
+| `report bing-device` | `.../DeviceSectionData?...` |
+| `report bing-geographic` | `.../GeographicSectionData?...` |
+| `report bing-age-audience` | `.../AgeAudienceData?...` |
+| `report bing-gender-audience` | `.../GenderAudienceData?...` |
+| `report bing-audience-merged` | 上两项并行拉取，**合并输出 JSON** |
+| `report bing-campaigns` | `.../CampaignReport?...` |
+| `report bing-ad-groups` | `.../AdGroupReport?...` |
+| `report bing-ads` | `.../AdReport?...` |
+| `report bing-keywords` | `.../KeywordReport?startDate=&endDate=&limit=&orderByCost=true`（默认 `limit=100`） |
+| `report bing-search-terms` | `.../SearchQueryReport?...`（同上） |
+
+**示例**
+
+```bash
+siluzan-tso report bing-overview -a <mediaCustomerId> --json
+siluzan-tso report bing-keywords -a <mediaCustomerId> --start 2026-03-01 --end 2026-03-20 --limit 50 --json
+siluzan-tso report bing-audience-merged -a <mediaCustomerId>
+```
+
+---
+
+## 报告模板与输出形式
+
+报告输出内容参考 **`report-templates/`**：
+
+- `report-templates/google-period-report.md` — 单周期汇总报告章节
+- `report-templates/google-account-diagnosis-report.md` — 诊断类报告章节（纲要）
+- `report-templates/google-ads-diagnosis.md` — 与网页版《Google Ads 账户诊断报告》**章节与数据块对齐**的完整骨架
+- `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` 目录下的 `.html` 文件（如 `report-template.html`、`report-template-academic.html` 等）为**样式参考**，可先生成 HTML 再转为 PDF。
+
+> **分析报告做法**：按 `google-period-report.md`（或对应媒体 `*.md`）中的默认维度拉数撰写，同时列出可选追加维度询问用户。**TSO 优化报告**（`report list` / `create` / `push`）不走此流程，详见 `references/reporting.md`。

package/dist/skill/references/aigc.md

@@ -223,7 +223,7 @@ ChatGPT 通常会生成 20-25 条标题，若全部发送则触发此错误。CL
 
 ---
 
-## 后续步骤：草稿管理
+## 后续步骤：草稿管理（速查）
 
 ```bash
 # 查看 AI 智投记录（含草稿和已发布）
@@ -235,3 +235,67 @@ siluzan-tso ad batch publish --id <草稿ID>
 # 查看创建进度（异步任务）
 siluzan-tso ad batch get --id <记录ID>
 ```
+
+完整参数与边界说明见下文 **「ad batch — 异步批量创建 / AI 智投记录」**。
+
+---
+
+## ad batch — 异步批量创建 / AI 智投记录
+
+对应页面：`/advertising/AICreationList`。与 `ad campaign-create` / `ad smart create` 等同源异步创建链路。
+
+### list — 查询列表
+
+```bash
+siluzan-tso ad batch list [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-s, --state <state>` | 状态：`Creating \| Successfully \| Failed \| HasFailed \| Unpublished` |
+| `--customer-id <id>` | Google mediaCustomerId |
+| `--customer-name <name>` | 客户名称关键字 |
+| `-k, --keyword <text>` | 关键字 |
+| `--start / --end <date>` | 创建日期范围 |
+| `-p, --page <n>` | 页码（默认 1） |
+| `--page-size <n>` | 每页数量（默认 20） |
+| `--json` | 输出原始 JSON |
+
+**示例：**
+
+```bash
+siluzan-tso ad batch list
+siluzan-tso ad batch list --customer-id 6326027735
+siluzan-tso ad batch list --state Failed --json
+siluzan-tso ad batch list --state Unpublished --start 2026-03-01
+```
+
+### get — 获取记录 / 草稿详情
+
+```bash
+siluzan-tso ad batch get --id <recordId>
+```
+
+输出完整 JSON（含广告系列、预算、关键词、定向位置等）。
+
+### update — 更新草稿字段
+
+只有 `draftStatus === "Draft"` 的记录可更新。
+
+```bash
+siluzan-tso ad batch update --id <recordId> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `--budget <amount>` | 新预算（最小货币单位，如 `8500` = 85 元 CNY） |
+| `--url <url>` | 新推广链接 |
+| `--campaign-name <name>` | 新广告系列名称 |
+
+### publish — 发布草稿
+
+只有 `draftStatus === "Draft"` 的记录可发布。发布后状态变为 `Creating`，Google 后台异步执行创建。
+
+```bash
+siluzan-tso ad batch publish --id <recordId>
+```

package/dist/skill/references/clue.md

@@ -0,0 +1,57 @@
+# 广告线索表单（clue）
+
+> 所属 skill：`siluzan-tso`。
+>
+> 对应页面：`/clue-form`。支持 **TikTok** 和 **Meta（Facebook）** 两种媒体。
+
+> **注意**：线索数据直接来自媒体 API，**不支持服务端分页**，数据量大时建议 `--json` 导出后自行处理。
+
+```bash
+siluzan-tso clue -m <媒体> -a <账户ID> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-m, --media` | `TikTok \| Meta`（默认 TikTok） |
+| `-a, --account <id>` | TikTok：`advertiserId`（mediaCustomerId）；Meta：Facebook 页面 ID |
+| `--region <region>` | TikTok 专用：`eu \| us \| other \| ALL`（默认 ALL） |
+| `--start <date>` | Meta 专用：开始日期（YYYY-MM-DD） |
+| `--end <date>` | Meta 专用：结束日期（YYYY-MM-DD） |
+| `--json` | 输出原始 JSON |
+
+**TikTok 示例：**
+
+```bash
+# 查询 TikTok 全部区域线索
+siluzan-tso clue -m TikTok -a 1234567890
+
+# 只查欧洲区线索
+siluzan-tso clue -m TikTok -a 1234567890 --region eu
+
+# 查美国区，JSON 输出
+siluzan-tso clue -m TikTok -a 1234567890 --region us --json
+```
+
+**Meta 示例：**
+
+```bash
+# 查询 Meta 线索（3月份）
+siluzan-tso clue -m Meta -a 987654321 --start 2026-03-01 --end 2026-03-31
+
+# JSON 输出
+siluzan-tso clue -m Meta -a 987654321 --start 2026-03-01 --json
+```
+
+**输出字段说明（TikTok）：**
+
+| 字段 | 来源 |
+|------|------|
+| 姓名、邮箱、手机 | `custom_fields` |
+| 表单名、广告名、区域、时间、lead_id | `system_fields` |
+
+**输出字段说明（Meta）：**
+
+| 字段 | 来源 |
+|------|------|
+| 姓名、邮箱、手机 | `field_data` |
+| 表单名、创建时间 | 顶层字段 |

package/dist/skill/references/{google-ads-launch-plan-template.md → google-ads/google-ads-launch-plan-template.md}

@@ -108,7 +108,7 @@ AI 生成计划时，按以下格式输出。`{{占位符}}` 由 AI 根据用户
 
 ### 3.2 广告系列（Campaign）基础设置
 
-**表项**：按系列列展开（常见 **1–3 个搜索系列**；多于 3 个时继续增列并写清预算占比）。**广告轮换**统一建议：**优先展示效果最佳的广告（Optimize）**。
+**表项**：按系列列展开（常见 **2–3 个搜索系列**；多于 3 个时继续增列并写清预算占比）。**广告轮换**统一建议：**优先展示效果最佳的广告（Optimize）**。
 
 | 设置项 | {{系列 1 名称}} | {{系列 2 名称}} | {{系列 3（可选）}} |
 |---|---|---|---|

package/dist/skill/references/google-ads.md

@@ -1,15 +1,21 @@
 # Google 广告管理命令详解
-
 > 所属 skill：`siluzan-tso`。
-> 所有 `ad` 和 `keyword` 命令均需先配置 Google API 地址：
-> ```bash
-> siluzan-tso config set --google-api https://googleapi.mysiluzan.com      # 生产
-> siluzan-tso config set --google-api https://googleapi-ci.mysiluzan.com   # 测试
-> ```
-> 运行前通过 `siluzan-tso config show` 确认 `googleApiUrl` 已配置。
-
 ---
 
+## 相关文档规范
+
+在创建相关内容时，需要阅读下面的文档以提高广告的整体质量
+
+| 文档地址 | 文档内容 |
+|----------|-----------|
+| `references/google-ads/google-ads-keyword-strategy.md` | **关键词策略与优化技巧**：匹配类型策略、分组结构、否定词技巧、出价意图分层、搜索词挖掘、竞品策略、PMax/AI Max 协同、信号污染防治 |
+| `references/google-ads/google-ads-keyword-optimization.md` | **关键词持续优化指南**：基于投放数据的迭代优化闭环——指标解读、决策框架（暂停/提价/降价/加否定）、优化节奏、转化归因、预算再分配、衰减检测、竞争响应、CRM 反馈 |
+| `references/google-ads/google-ads-creative-optimization.md` | **广告创意与素材优化**：RSA 六类主题法、Ad Strength 评分、文案 A/B 测试、创意疲劳管理、附加信息（Sitelink/Callout/Snippet/Image）优化、DKI/倒计时/IF 函数、落地页 CRO、PMax 创意策略、多语言管理 |
+| `references/google-ads/google-ads-campaign-optimization.md` | **广告系列结构与投放优化**：系列类型选择决策树、电商/线索/本地/SaaS 架构模板、出价策略校准与启动协议、地域/设备优化、转化追踪（Enhanced Conversions/离线导入/价值规则）、预算优化、网络设置、实验设计、账户健康诊断 |
+| `references/google-ads/google-ads-creation-plan.md` | **广告创建确认方案模板**（**创建前必读**）：执行任何广告创建命令前，必须按此模板输出完整方案等待用户确认——系列配置、关键词列表、RSA 文案、附加信息、合规检查、执行计划；含等待确认话术和特殊场景（AIGC/关键词追加/草稿发布）处理规则 |
+| `references/google-ads/google-ads-compliance.md` | **Google 广告合规指南**：关键词 & 文案审核通过规则、编辑规范、禁止内容、虚假承诺处理、商标规则、多语言规则 |
+| `references/google-ads/google-ads-launch-plan-template.md` | **广告创建计划输出模板**：必须使用这个模板输出广告计划|
+| `references/google-ads/sensitive-industries.md` | **敏感行业合规细则**：酒精 / 赌博 / 金融 / 加密 / 医疗 / 法律等 12 个行业的关键词生成规则与地区限制 |
 ## 操作顺序建议
 
 Google 广告管理的典型工作流：
@@ -17,7 +23,7 @@ Google 广告管理的典型工作流：
 ```
 查广告系列列表 → 查广告组列表 → 查广告/关键词
      ↓                ↓              ↓
-  启停/删除        创建/启停/删除   创建/删除
+  启停/删除     创建/启停/删除   创建/删除
 ```
 
 **ID 来源说明：**
@@ -29,7 +35,6 @@ Google 广告管理的典型工作流：
 | 广告组 `id`、`name` | `siluzan-tso ad groups -a <accountId> --json` → `id`、`name` |
 | 广告 `id` | `siluzan-tso ad list -a <accountId> --json` → `id` |
 | 关键词 `id` | `siluzan-tso ad keywords -a <accountId> --json` → `id` |
-
 ---
 
 ## ad campaigns — 广告系列管理

package/dist/skill/references/optimize.md

@@ -0,0 +1,52 @@
+# AI 广告优化记录（optimize）
+
+> 所属 skill：`siluzan-tso`。
+>
+> 对应页面：`/advertising/AiGoogleOptimize`
+
+```bash
+siluzan-tso optimize list    [选项]                  # 账户级优化主列表
+siluzan-tso optimize records [选项]                  # 优化操作记录列表（系列粒度，见下）
+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，自动附加 +08:00） |
+| `--id <id>` | `optimize get` 专用：UUID。常见来源——**账户批次**：`optimize list --json` 的 `items[].id` / `entityId`；**系列级记录**：`optimize records --json` 的 `items[].id` |
+| `--parent-id <id>` | 父级 ID（`children` 专用；与账户批次 `list` 里 `items[].id` 一致） |
+| `--json` | 输出原始 JSON（`list` / `records` / `children`） |
+
+## 已脱管 / 非当前托管账户：怎么查历史优化？
+
+1. **不要用** `optimize list -a <客户号>`（后端常按当前可管账户过滤，脱管后可能 0 条）。
+2. **也不要依赖** `optimize records -a <客户号>`（列表项往往没有 `mediaCustomerId`，接口侧筛选也可能无效）。
+3. **应使用**：`optimize list --match-media-customer-id <Google 客户号> [--start … --end …] --json`，在结果里取每条批次的 **`id`**（与 **`entityId`** 相同）。
+4. 用该 **`id`**：`optimize get --id <id>` 看详情；`optimize children --parent-id <id>` 看该批次下各广告系列级明细。
+
+**示例：**
+
+```bash
+# 查询指定账户的优化建议列表（当前仍托管、接口可筛时）
+siluzan-tso optimize list -a 6326027735
+
+# 已脱管：从全量历史里筛出该 Google 客户号（自动翻页）
+siluzan-tso optimize list --match-media-customer-id 3013981480 --start 2025-05-01 --json
+
+# 查询所有账户本月优化记录（系列级列表）
+siluzan-tso optimize records --start 2026-03-01 --end 2026-03-31
+
+# 查询某账户广告系列级明细（parentId = 上一步 list 里某条批次的 id）
+siluzan-tso optimize children --parent-id 4ced1f51-da71-4aac-84f9-4e2c4a25675f
+
+# 单条详情（id 可为 list 批次 id 或 records 系列记录 id）
+siluzan-tso optimize get --id 4ced1f51-da71-4aac-84f9-4e2c4a25675f
+
+# JSON 输出
+siluzan-tso optimize list -a 6326027735 --json
+```
+
+**接口说明（`optimize get`）**：`GET {apiBaseUrl}/Smart-Ads-Optimize/v2/{id}`。请求带 Datapermission（CLI 自动 `ensureDataPermission`）。响应体字段以后端为准，通常为格式化 JSON 打印到 stdout。