siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

package/dist/skill/assets/pmax-create-template.md

@@ -10,15 +10,31 @@
 
 ## Agent 常见坑
 
-| 场景 | 正确做法 |
-|------|----------|
-| 创建 PMax | `pmax-validate` → 用户确认 → `pmax-create` |
-| 文案超长 | `pmax-validate --json-out` 读 `lengthViolations`（含完整 `text`）；**勿自动截断**，列改写方案给用户确认后再改 JSON 并重跑 validate（同 Search `campaign-validate`） |
-| 金额 | JSON 填**主币种「元」**；CLI 提交前 `budget`、`targetCpa_BidingAmount` ×100 |
-| 图片 | **只填 `imagePaths`** 指向本地 PNG/JPEG；`pmax-create` 会自动 multipart 上传并用 assetId 创建（勿把 Base64 提交进 Git） |
-| 视频 | JSON 填 **`videoPath`**（别名 `video` 亦可）；`pmax-create` 成功后 **必定**经 PyAPI 上传并链接（含 `--json-out`）。已有 YouTube 用 `youtubeUrlOrId` |
-| 改已上线 PMax | `ad pmax-get` / `pmax-edit` / `pmax-assets-update` 等（见 `references/google-ads/pmax-api.md`） |
-| 列表复核 | `ad campaigns -a <id> --json-out ./snap`，`channelTypeV2` 应为 `PERFORMANCE_MAX` |
+| 场景          | 正确做法                                                                                                                                                            |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 创建 PMax     | `pmax-validate` → 用户确认 → `pmax-create`                                                                                                                          |
+| 文案超长      | `pmax-validate --json-out` 读 `lengthViolations`（含完整 `text`）；**勿自动截断**，列改写方案给用户确认后再改 JSON 并重跑 validate（同 Search `campaign-validate`） |
+| 金额          | JSON 填**主币种「元」**；CLI 提交前 `budget`、`targetCpa_BidingAmount` ×100                                                                                         |
+| 图片          | **只填 `imagePaths`** 指向本地 PNG/JPEG；`pmax-create` 会自动 multipart 上传并用 assetId 创建（勿把 Base64 提交进 Git）                                             |
+| 视频          | JSON 填 **`videoPath`**（别名 `video` 亦可）；`pmax-create` 成功后 **必定**经 PyAPI 上传并链接（含 `--json-out`）。已有 YouTube 用 `youtubeUrlOrId`                 |
+| 附加资产      | **必填** `campaignExtensions`：宣传信息 ≥20、结构化摘要 ≥20、站内链接 ≥6、leadForm、WhatsApp |
+| 文案数量      | 短标题 15、长 nga 5（Google API 上限，须填满）、描述 5 |
+| Lead Gen 方案 | **默认**在 `campaignExtensions` 含 **`leadForm`**（B2B/询盘/留资）；仅 callouts/snippets 不算完整方案；用户明确不要才省略                                        |
+| 存量补表单    | 活动已创建时用 `ad extension lead-form`（见 `pmax-lead-form-template.md` 方式 B）                                                                                   |
+| 改已上线 PMax | 先 `ad pmax-get` 看 `_brandGuidelinesActive`；改品牌见 `pmax-api.md` § Brand Guidelines                                                                             |
+| 列表复核      | `ad campaigns -a <id> --json-out ./snap`，`channelTypeV2` 应为 `PERFORMANCE_MAX`                                                                                    |
+
+---
+
+## 方案生成（Agent 出投放方案时）
+
+出 PMax **投放方案**（Markdown + JSON）时，除标题/描述/图片外，**Lead Gen / B2B 场景默认包含潜在客户表单**：
+
+1. JSON：`campaignExtensions.leadForm` 字段结构与 `pmax-lead-form-template.json` 的 `leadForm` 相同（`businessName`、`headline`、`description`、`privacyPolicyUrl`、`finalUrl`、`fields`）。
+2. Markdown：单独一节 **「潜在客户表单」**，列出表单标题、描述、收集字段、隐私政策 URL；**不得**只在 JSON 里写而方案正文遗漏。
+3. `privacyPolicyUrl`：从落地页站点找 `/privacy`、`/terms` 等；找不到时向用户确认，**禁止**编造 URL。
+4. 用户说「不要表单 / 仅品牌曝光 / 纯电商 Shopping」→ 可省略 `leadForm` 并在方案中说明原因。
+5. `pmax-validate` 会校验 `leadForm`；创建后 `--json-out` 的 `campaignExtensions.leadForm` 段含 `ok` / `error`。
 
 ---
 
@@ -36,48 +52,65 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 
 ## 字段说明（camelCase）
 
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|:----:|------|
-| `account` | string | ✅ | Google 媒体客户 ID（`list-accounts` → `mediaCustomerId`） |
-| `name` | string | ✅ | 广告系列名称 |
-| `budget` | number | ✅ | 日预算（**元**），如 `50` = 主币种 50.00/天 |
-| `budgetName` | string | | 预算资源名称 |
-| `assetGroupName` | string | | 首个资产组名称；缺省由服务端生成 |
-| `finalUrls` | string[] | ✅ | 至少 1 个 `https://` 落地页 |
-| `businessName` | string | ✅ | BUSINESS_NAME：1 条，≤25 字符 |
-| `headlines` | string[] | ✅ | HEADLINE：3–15 条，每条 ≤30 字符（CJK×2） |
-| `longHeadlines` | string[] | ✅ | LONG_HEADLINE：1–5 条，每条 ≤90 字符 |
-| `descriptions` | string[] | ✅ | DESCRIPTION：2–5 条，每条 ≤90 字符 |
-| `imagePaths.marketing` | string | ✅* | MARKETING_IMAGE 横图 1.91:1，≤5MB（创建 JSON 1 张；资产组 API 最多 20） |
-| `imagePaths.square` | string | ✅* | SQUARE_MARKETING_IMAGE 方图 1:1，≤5MB（创建 1 张；最多 20） |
-| `imagePaths.logo` | string | ✅* | LOGO 方图 1:1，≤5MB（创建 1 张；最多 5） |
-| `marketingImageAssetId` | string | ✅* | 已上传横图 asset.id（与 path/base64 三选一） |
-| `squareMarketingImageAssetId` | string | ✅* | 已上传方图 asset.id |
-| `logoImageAssetId` | string | ✅* | 已上传 Logo asset.id |
-| `marketingImageBase64` | string | ✅* | 内联 Base64（不推荐；无 path 时用） |
-| `squareMarketingImageBase64` | string | ✅* | 内联方图 Base64 |
-| `logoImageBase64` | string | ✅* | 内联 Logo Base64 |
-| `targetedLocations` | `{ id }[]` | | 地理 criterion ID，如 `{ "id": "2840" }`（美国） |
-| `targetedLanguages` | `{ id }[]` | | 语言 ID，如 `{ "id": 1000 }`（英语） |
-| `biddingStrategyTypeV2` | string | | 默认 `MAXIMIZE_CONVERSIONS` |
-| `targetCpa_BidingAmount` | number | | `TARGET_CPA` 或带目标 CPA 的 `MAXIMIZE_CONVERSIONS` 时必填（**元**） |
-| `targetRoas` | number | | `TARGET_ROAS` 时必填（如 `2.5` = 250%） |
-| `videoPath` | string | | YOUTUBE_VIDEO（可选）：本地视频 ≥10s；与 `youtubeUrlOrId` 二选一，创建时最多 1 条；更多视频创建后用 `pmax-youtube-link` / `pmax-assets-update` 追加 |
-| `videoTitle` | string | | PyAPI 上传标题（默认文件名） |
-| `videoDescription` | string | | PyAPI 上传描述（可选） |
-| `youtubeUrlOrId` | string | | 已有 YouTube URL 或 11 位 ID；`pmax-create` 后自动链接 |
-| `youtubeAssetName` | string | | 链接 YouTube 时的资产显示名 |
+| 字段                          | 类型       | 必填 | 说明                                                                                                                                                |
+| ----------------------------- | ---------- | :--: | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `account`                     | string     |  ✅  | Google 媒体客户 ID（`list-accounts` → `mediaCustomerId`）                                                                                           |
+| `name`                        | string     |  ✅  | 广告系列名称                                                                                                                                        |
+| `budget`                      | number     |  ✅  | 日预算（**元**），如 `50` = 主币种 50.00/天                                                                                                         |
+| `budgetName`                  | string     |      | 预算资源名称                                                                                                                                        |
+| `assetGroupName`              | string     |      | 首个资产组名称；缺省由服务端生成                                                                                                                    |
+| `finalUrls`                   | string[]   |  ✅  | 至少 1 个 `https://` 落地页                                                                                                                         |
+| `businessName`                | string     |  ✅  | BUSINESS_NAME：1 条，≤25 字符                                                                                                                       |
+| `headlines`                   | string[]   |  ✅  | HEADLINE：3–15 条，每条 ≤30 字符（CJK×2）                                                                                                           |
+| `longHeadlines`               | string[]   |  ✅  | LONG_HEADLINE：1–5 条，每条 ≤90 字符                                                                                                                |
+| `descriptions`                | string[]   |  ✅  | DESCRIPTION：2–5 条，每条 ≤90 字符                                                                                                                  |
+| `imagePaths.marketing`        | string     | ✅\* | MARKETING_IMAGE 横图 1.91:1，≤5MB（创建 JSON 1 张；资产组 API 最多 20）                                                                             |
+| `imagePaths.square`           | string     | ✅\* | SQUARE_MARKETING_IMAGE 方图 1:1，≤5MB（创建 1 张；最多 20）                                                                                         |
+| `imagePaths.logo`             | string     | ✅\* | LOGO 方图 1:1，≤5MB（创建 1 张；最多 5）                                                                                                            |
+| `marketingImageAssetId`       | string     | ✅\* | 已上传横图 asset.id（与 path/base64 三选一）                                                                                                        |
+| `squareMarketingImageAssetId` | string     | ✅\* | 已上传方图 asset.id                                                                                                                                 |
+| `logoImageAssetId`            | string     | ✅\* | 已上传 Logo asset.id                                                                                                                                |
+| `marketingImageBase64`        | string     | ✅\* | 内联 Base64（不推荐；无 path 时用）                                                                                                                 |
+| `squareMarketingImageBase64`  | string     | ✅\* | 内联方图 Base64                                                                                                                                     |
+| `logoImageBase64`             | string     | ✅\* | 内联 Logo Base64                                                                                                                                    |
+| `targetedLocations`           | `{ id }[]` |      | 地理 criterion ID，如 `{ "id": "2840" }`（美国）                                                                                                    |
+| `targetedLanguages`           | `{ id }[]` |      | 语言 ID，如 `{ "id": 1000 }`（英语）                                                                                                                |
+| `biddingStrategyTypeV2`       | string     |      | 默认 `MAXIMIZE_CONVERSIONS`                                                                                                                         |
+| `targetCpa_BidingAmount`      | number     |      | `TARGET_CPA` 或带目标 CPA 的 `MAXIMIZE_CONVERSIONS` 时必填（**元**）                                                                                |
+| `targetRoas`                  | number     |      | `TARGET_ROAS` 时必填（如 `2.5` = 250%）                                                                                                             |
+| `brandGuidelinesEnabled`      | boolean    |      | 省略 = 网关默认 `true`（Campaign 级 BG）；`false` = 品牌在 AssetGroup（旧路径）                                                                     |
+| `videoPath`                   | string     |      | YOUTUBE_VIDEO（可选）：本地视频 ≥10s；与 `youtubeUrlOrId` 二选一，创建时最多 1 条；更多视频创建后用 `pmax-youtube-link` / `pmax-assets-update` 追加 |
+| `videoTitle`                  | string     |      | PyAPI 上传标题（默认文件名）                                                                                                                        |
+| `videoDescription`            | string     |      | PyAPI 上传描述（可选）                                                                                                                              |
+| `youtubeUrlOrId`              | string     |      | 已有 YouTube URL 或 11 位 ID；`pmax-create` 后自动链接                                                                                              |
+| `youtubeAssetName`            | string     |      | 链接 YouTube 时的资产显示名                                                                                                                         |
+| `campaignExtensions`          | object     |      | 创建成功后自动挂载的 Campaign 级扩展（见下表）                                                                                                      |
 
 \* 三张图各须有一种来源（路径或 Base64）。
 
+### `campaignExtensions`（可选，CLI 编排）
+
+**不**随 `POST .../campaign/pmax` 提交；活动创建成功后 CLI 自动调用 `extensionmanagement`。
+
+| 子字段               | 类型     | 说明                                                                     |
+| -------------------- | -------- | ------------------------------------------------------------------------ |
+| `callouts`           | string[] | 宣传信息（CALLOUT），每条 ≤25 字符，各创建 1 个扩展                      |
+| `structuredSnippets` | object[] | `{ header, values }`；`values` 至少 3 项                                 |
+| `leadForm`           | object   | 潜在客户表单；字段同 `pmax-lead-form-template.json` 的 `leadForm`        |
+| `businessMessage`    | object   | WhatsApp 私信；字段同 `pmax-whatsapp-template.json` 的 `businessMessage` |
+
+标头可选值：`ad extension snippet-headers`。WhatsApp 需 Google API 白名单（见 `pmax-whatsapp-template.md`）。
+
+若挂载失败，活动仍已创建；`--json-out` 的 `campaignExtensions` 段含各条 `ok` / `error`，可手动 `ad extension *` 补挂。
+
 ### 出价策略（PMax 支持子集）
 
-| 值 | 说明 |
-|----|------|
-| `MAXIMIZE_CONVERSIONS` | 默认 |
-| `MAXIMIZE_CONVERSION_VALUE` | 最大化转化价值 |
-| `TARGET_CPA` | 目标 CPA（须 `targetCpa_BidingAmount`） |
-| `TARGET_ROAS` | 目标 ROAS（须 `targetRoas`） |
+| 值                          | 说明                                    |
+| --------------------------- | --------------------------------------- |
+| `MAXIMIZE_CONVERSIONS`      | 默认                                    |
+| `MAXIMIZE_CONVERSION_VALUE` | 最大化转化价值                          |
+| `TARGET_CPA`                | 目标 CPA（须 `targetCpa_BidingAmount`） |
+| `TARGET_ROAS`               | 目标 ROAS（须 `targetRoas`）            |
 
 ---
 
@@ -85,11 +118,11 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 
 网关同步返回（camelCase）：
 
-| 字段 | 说明 |
-|------|------|
-| `campaignId` | 活动 ID |
-| `assetGroupId` | 首个资产组 ID |
-| `budgetId` | 日预算 ID（后续 PATCH 改预算时需与 `budget` 成对） |
+| 字段           | 说明                                               |
+| -------------- | -------------------------------------------------- |
+| `campaignId`   | 活动 ID                                            |
+| `assetGroupId` | 首个资产组 ID                                      |
+| `budgetId`     | 日预算 ID（后续 PATCH 改预算时需与 `budget` 成对） |
 
 ---
 

package/dist/skill/assets/pmax-lead-form-template.json

@@ -0,0 +1,36 @@
+{
+  "_meta": {
+    "schema": "pmax-lead-form/v1",
+    "doc": "pmax-lead-form-template.md",
+    "note": "以 _ 开头的键仅作说明，CLI 提交前会剥离",
+    "agentPitfalls": [
+      "新建 PMax（Lead Gen/B2B）：优先 campaignExtensions.leadForm 随 pmax-create 一次挂载（见 pmax-create-template.json）",
+      "存量补挂：用本文件 + ad extension lead-form（须已有 campaignId）",
+      "LEAD_FORM 仅 Campaign 级；每活动通常 1 个；补挂前 ad extension list --type LEAD_FORM --campaign-id 检查",
+      "privacyPolicyUrl 须为 https 可访问页（可从官网 footer 找 privacy/terms）",
+      "账户须在 Google Ads UI 接受 Lead Form ToS",
+      "WhatsApp 见 pmax-whatsapp-template.json 或 campaignExtensions.businessMessage"
+    ]
+  },
+  "account": "REPLACE_mediaCustomerId",
+  "campaignId": "REPLACE_pmaxCampaignId",
+  "leadForm": {
+    "businessName": "Example Brand Co",
+    "headline": "Get a free quote",
+    "description": "Tell us about your project and we will contact you.",
+    "privacyPolicyUrl": "https://www.example.com/privacy",
+    "finalUrl": "https://www.example.com",
+    "callToActionType": "LEARN_MORE",
+    "callToActionDescription": "Contact us",
+    "fields": [
+      { "inputType": "FULL_NAME" },
+      { "inputType": "EMAIL" },
+      { "inputType": "PHONE_NUMBER" }
+    ],
+    "webhook": {
+      "advertiserWebhookUrl": "https://your-crm.example.com/webhook",
+      "googleSecret": "your-google-secret",
+      "payloadSchemaVersion": 3
+    }
+  }
+}

package/dist/skill/assets/pmax-lead-form-template.md

@@ -0,0 +1,70 @@
+# `ad extension lead-form` JSON 配置说明
+
+PMax **潜在客户表单**（`LEAD_FORM`）有两种挂载方式：
+
+| 方式 | 何时用 | 入口 |
+| ---- | ------ | ---- |
+| **A（推荐·新建活动）** | `pmax-create` 一次性创建系列 + 扩展 | `pmax-create` JSON 的 `campaignExtensions.leadForm`（见 `pmax-create-template.json`） |
+| **B（存量补挂）** | 活动已存在、需单独加/改表单 | 本文件 + `ad extension lead-form` |
+
+**Lead Gen / B2B 询盘类 PMax 方案**：默认在 `campaignExtensions` 中包含 `leadForm`；用户明确不要表单时才省略。
+
+模板 JSON：同目录 [`pmax-lead-form-template.json`](pmax-lead-form-template.json)（方式 B 用；方式 A 只取其中的 `leadForm` 对象嵌入 `pmax-create` JSON）。
+
+---
+
+## 推荐命令顺序
+
+```bash
+# 1. 确认 PMax 活动 ID
+siluzan-tso ad campaigns -a <accountId> --json-out ./snap
+
+# 2. 查看 PMax 支持的扩展类型
+siluzan-tso ad extension pmax-types --json-out ./snap
+
+# 3. 检查活动上是否已有 Lead Form
+siluzan-tso ad extension list -a <accountId> --type LEAD_FORM --campaign-id <campaignId> --json-out ./snap
+
+# 4. 创建
+siluzan-tso ad extension lead-form -a <accountId> --config-file ./lead-form.json --json-out ./snap
+
+# 5. 更新（须带完整 leadForm 对象）
+siluzan-tso ad extension update -a <accountId> --id <extensionId> --config-file ./lead-form.json
+```
+
+---
+
+## 字段说明
+
+| 字段                               | 类型     | 必填 | 说明                                                           |
+| ---------------------------------- | -------- | :--: | -------------------------------------------------------------- |
+| `account`                          | string   |  ✅  | Google 媒体客户 ID                                             |
+| `campaignId`                       | string   |  ✅  | PMax 活动 ID（`channelTypeV2=PERFORMANCE_MAX`）                |
+| `leadForm.businessName`            | string   |  ✅  | 商家名称                                                       |
+| `leadForm.headline`                | string   |  ✅  | 表单标题                                                       |
+| `leadForm.description`             | string   |  ✅  | 表单描述                                                       |
+| `leadForm.privacyPolicyUrl`        | string   |  ✅  | 隐私政策 URL                                                   |
+| `leadForm.finalUrl`                | string   |  ✅  | 落地页 URL                                                     |
+| `leadForm.callToActionType`        | string   |      | 默认 `LEARN_MORE`                                              |
+| `leadForm.callToActionDescription` | string   |      | 默认 `Contact us`                                              |
+| `leadForm.fields`                  | object[] |  ✅  | 至少 1 项；`inputType` 如 `FULL_NAME`、`EMAIL`、`PHONE_NUMBER` |
+| `leadForm.webhook`                 | object   |      | 写入 Google 的 Webhook（非平台接收端）                         |
+
+---
+
+## PMax 附加资产对照
+
+| 中文          | 类型                 | CLI 命令                                                        |
+| ------------- | -------------------- | --------------------------------------------------------------- |
+| 宣传信息      | `CALLOUT`            | `ad extension callout`                                          |
+| 结构化摘要    | `STRUCTURED_SNIPPET` | `ad extension snippet`                                          |
+| 潜在客户表单  | `LEAD_FORM`          | `ad extension lead-form`                                        |
+| 附加链接      | `SITELINK`           | `ad extension sitelink`                                         |
+| 附加电话      | `CALL`               | `ad extension call`                                             |
+| 私信 WhatsApp | `BUSINESS_MESSAGE`   | `ad extension whatsapp` 或 `campaignExtensions.businessMessage` |
+
+**层级**：PMax 仅 `Account` / `Campaign`；`Ad Group` 会 **400**。
+
+**副作用**：创建 Lead Form 后，后端会自动尝试将 `SUBMIT_LEAD_FORM` + `GOOGLE_HOSTED` 转化目标设为 `biddable=true`。
+
+详见 `references/google-ads/pmax-api.md` § 附加资产。

package/dist/skill/assets/pmax-signals-template.json

@@ -2,10 +2,6 @@
   "_comment": "PUT signals 全量同步；空数组会清空对应类型",
   "account": "6326027735",
   "assetGroupId": "98765432101",
-  "audienceResourceNames": [
-    "customers/6326027735/audiences/348219404"
-  ],
-  "searchThemes": [
-    "industrial equipment supplier"
-  ]
+  "audienceResourceNames": ["customers/6326027735/audiences/348219404"],
+  "searchThemes": ["industrial equipment supplier"]
 }

package/dist/skill/assets/pmax-whatsapp-template.json

@@ -0,0 +1,26 @@
+{
+  "_meta": {
+    "schema": "pmax-whatsapp/v1",
+    "doc": "pmax-whatsapp-template.md",
+    "note": "以 _ 开头的键仅作说明，CLI 提交前会剥离",
+    "agentPitfalls": [
+      "BUSINESS_MESSAGE 仅支持 Campaign / Account 级；PMax 用 Campaign + campaignId",
+      "每 Campaign 仅 1 个 ENABLED WhatsApp；重复 POST 会 400，须 DELETE 或 PUT 更新",
+      "PUT 成功后 asset id 会变化，后续删除/更新须用响应中的新 id",
+      "账户须已开通 Google Business Message API 白名单，否则 CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS",
+      "勿与 pmax-create 同时挂 businessMessage 若活动上已有 WhatsApp"
+    ]
+  },
+  "account": "REPLACE_mediaCustomerId",
+  "campaignId": "REPLACE_pmaxCampaignId",
+  "businessMessage": {
+    "messageProvider": "WHATSAPP",
+    "starterMessage": "Hi! How can we help you today?",
+    "callToActionSelection": "CONTACT_US",
+    "callToActionDescription": "Message us on WhatsApp",
+    "whatsapp": {
+      "countryCode": "US",
+      "phoneNumber": "2125550100"
+    }
+  }
+}

package/dist/skill/assets/pmax-whatsapp-template.md

@@ -0,0 +1,45 @@
+# `ad extension whatsapp` JSON 配置说明
+
+为**已创建的 PMax 活动**挂载 WhatsApp 私信（`BUSINESS_MESSAGE`）。也可写入 `pmax-create` JSON 的 `campaignExtensions.businessMessage` 由 CLI 自动编排。
+
+模板：`pmax-whatsapp-template.json`。
+
+---
+
+## 命令
+
+```bash
+# 单独挂载
+siluzan-tso ad extension whatsapp -a <accountId> --config-file ./whatsapp.json --json-out ./snap
+
+# 更新（PUT 后 id 会变，用响应新 id）
+siluzan-tso ad extension update -a <accountId> --id <extensionId> --config-file ./whatsapp.json
+
+# 或在 pmax-create 一并挂载
+# campaignExtensions.businessMessage 见 pmax-create-template.md
+```
+
+---
+
+## 字段
+
+| 字段                                      | 必填 | 说明                                                 |
+| ----------------------------------------- | :--: | ---------------------------------------------------- |
+| `account`                                 |  ✅  | Google 媒体客户 ID                                   |
+| `campaignId`                              |  ✅  | PMax 活动 ID                                         |
+| `businessMessage.starterMessage`          |  ✅  | 欢迎语                                               |
+| `businessMessage.callToActionDescription` |      | 默认 `Message us on WhatsApp`                        |
+| `businessMessage.callToActionSelection`   |      | 默认 `CONTACT_US`；可选 `LEARN_MORE`、`GET_QUOTE` 等 |
+| `businessMessage.messageProvider`         |      | 默认 `WHATSAPP`                                      |
+| `businessMessage.whatsapp.countryCode`    |  ✅  | 两位国家码（如 `US`）                                |
+| `businessMessage.whatsapp.phoneNumber`    |  ✅  | WhatsApp Business 注册号码                           |
+
+---
+
+## 前置条件
+
+1. **Google API 白名单**（阻塞项）：未开通返回 `CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS`；须 MCC 运营联系 Google AM 申请。
+2. 号码已在 **WhatsApp Business** 注册。
+3. 同 Campaign **仅 1 个** ENABLED WhatsApp；已有则 POST 400，须 DELETE 或 PUT。
+
+详见 Sammamish `pmax-frontend-api.md` §3.2.4。

package/dist/skill/assets/website-diagnosis-rules.md

@@ -4,96 +4,96 @@
 
 ## JSON Schema（摘要）
 
-- `url`：被诊断 URL  
-- `ratingId`：`s1`–`s5`  
-- `coreIssuesIds`：`ci1`–`ci10` 子集  
-- `modules[]`：`{ id, score, items[] }`  
-- `items[]`：`{ id, score, status, issue, suggestion }`  
-- `status` 枚举：`Excellent` | `Good` | `Normal` | `Poor` | `Full` | `NeedImprove` | `Absent`  
-- 满分项 `suggestion` 可为空字符串  
+- `url`：被诊断 URL
+- `ratingId`：`s1`–`s5`
+- `coreIssuesIds`：`ci1`–`ci10` 子集
+- `modules[]`：`{ id, score, items[] }`
+- `items[]`：`{ id, score, status, issue, suggestion }`
+- `status` 枚举：`Excellent` | `Good` | `Normal` | `Poor` | `Full` | `NeedImprove` | `Absent`
+- 满分项 `suggestion` 可为空字符串
 
 ## 评分等级（ratingId）
 
-| ID | 等级 | 分数区间 | 说明 |
-| -- | ---- | -------- | ---- |
-| s1 | 优秀 | ≥90 | 可直接投放广告 |
-| s2 | 良好 | 80–89.99 | 小幅优化后可投放 |
-| s3 | 一般 | 70–79.99 | 需要重点优化 |
-| s4 | 较差 | 60–69.99 | 需要大幅改进 |
-| s5 | 不建议投放 | ≤59.99 | 需全面整改 |
+| ID  | 等级       | 分数区间 | 说明             |
+| --- | ---------- | -------- | ---------------- |
+| s1  | 优秀       | ≥90      | 可直接投放广告   |
+| s2  | 良好       | 80–89.99 | 小幅优化后可投放 |
+| s3  | 一般       | 70–79.99 | 需要重点优化     |
+| s4  | 较差       | 60–69.99 | 需要大幅改进     |
+| s5  | 不建议投放 | ≤59.99   | 需全面整改       |
 
 ## 核心问题（coreIssuesIds）
 
-| ID | 问题 |
-| -- | ---- |
-| ci1 | 首屏缺乏清晰 CTA |
-| ci2 | 转化跟踪未部署 |
-| ci3 | 移动端显示异常 |
-| ci4 | 页面加载缓慢 |
-| ci5 | 导航栏与清晰度 |
-| ci6 | 表单复杂或缺乏清晰 |
-| ci7 | 类目页与详情页内容不匹配 |
-| ci8 | 网站语言与广告不一致 |
-| ci9 | 缺少社媒分享入口 |
-| ci10 | 品牌风格不统一 |
+| ID   | 问题                     |
+| ---- | ------------------------ |
+| ci1  | 首屏缺乏清晰 CTA         |
+| ci2  | 转化跟踪未部署           |
+| ci3  | 移动端显示异常           |
+| ci4  | 页面加载缓慢             |
+| ci5  | 导航栏与清晰度           |
+| ci6  | 表单复杂或缺乏清晰       |
+| ci7  | 类目页与详情页内容不匹配 |
+| ci8  | 网站语言与广告不一致     |
+| ci9  | 缺少社媒分享入口         |
+| ci10 | 品牌风格不统一           |
 
 ## m1 · 网站内容及结构（9 项）
 
-| ID | 诊断项 | 满分 |
-| -- | ------ | ---- |
-| m1i1 | Banner 轮播图 | 5 |
-| m1i2 | 导航栏 | 2 |
-| m1i3 | 首页信息布局 | 4 |
-| m1i4 | 产品类目页 | 2 |
-| m1i5 | 产品详情页 | 4 |
-| m1i6 | 公司介绍页 | 3 |
-| m1i7 | 联系我们页 | 4 |
-| m1i8 | 表单提交流程 | 4 |
-| m1i9 | 社交媒体链接 | 2 |
+| ID   | 诊断项        | 满分 |
+| ---- | ------------- | ---- |
+| m1i1 | Banner 轮播图 | 5    |
+| m1i2 | 导航栏        | 2    |
+| m1i3 | 首页信息布局  | 4    |
+| m1i4 | 产品类目页    | 2    |
+| m1i5 | 产品详情页    | 4    |
+| m1i6 | 公司介绍页    | 3    |
+| m1i7 | 联系我们页    | 4    |
+| m1i8 | 表单提交流程  | 4    |
+| m1i9 | 社交媒体链接  | 2    |
 
 ## m2 · 网站性能（5 项）
 
-| ID | 诊断项 | 满分 |
-| -- | ------ | ---- |
-| m2i1 | 加载速度（Lighthouse PC/移动） | 8 |
-| m2i2 | HTTPS 安全 | 5 |
-| m2i3 | 404 页面 | 4 |
-| m2i4 | 图片清晰度 | 4 |
-| m2i5 | 移动端适配 | 4 |
+| ID   | 诊断项                         | 满分 |
+| ---- | ------------------------------ | ---- |
+| m2i1 | 加载速度（Lighthouse PC/移动） | 8    |
+| m2i2 | HTTPS 安全                     | 5    |
+| m2i3 | 404 页面                       | 4    |
+| m2i4 | 图片清晰度                     | 4    |
+| m2i5 | 移动端适配                     | 4    |
 
 ## m3 · 营销基础与广告落地页（4 项）
 
-| ID | 诊断项 | 满分 |
-| -- | ------ | ---- |
-| m3i1 | 企业邮箱 | 6 |
-| m3i2 | 联系电话 | 3 |
-| m3i4 | 语言一致性 | 3 |
-| m3i5 | 地址地图 | 3 |
+| ID   | 诊断项     | 满分 |
+| ---- | ---------- | ---- |
+| m3i1 | 企业邮箱   | 6    |
+| m3i2 | 联系电话   | 3    |
+| m3i4 | 语言一致性 | 3    |
+| m3i5 | 地址地图   | 3    |
 
 ## m4 · 用户体验与转化（5 项）
 
-| ID | 诊断项 | 满分 |
-| -- | ------ | ---- |
-| m4i1 | 页面布局 | 3 |
-| m4i2 | CTA 按钮 | 5 |
-| m4i3 | 表单体验 | 3 |
-| m4i4 | 内容可读性 | 3 |
-| m4i5 | 社媒分享可扩展性 | 1 |
+| ID   | 诊断项           | 满分 |
+| ---- | ---------------- | ---- |
+| m4i1 | 页面布局         | 3    |
+| m4i2 | CTA 按钮         | 5    |
+| m4i3 | 表单体验         | 3    |
+| m4i4 | 内容可读性       | 3    |
+| m4i5 | 社媒分享可扩展性 | 1    |
 
 ## m5 · 媒体广告投放辅助（3 项）
 
-| ID | 诊断项 | 满分 |
-| -- | ------ | ---- |
-| m5i1 | 落地页速度 | 3 |
-| m5i2 | 询盘转化路径 | 4 |
-| m5i4 | 跟踪与分析 | 3 |
+| ID   | 诊断项       | 满分 |
+| ---- | ------------ | ---- |
+| m5i1 | 落地页速度   | 3    |
+| m5i2 | 询盘转化路径 | 4    |
+| m5i4 | 跟踪与分析   | 3    |
 
 ## m6 · 社交媒体辅助（3 项）
 
-| ID | 诊断项 | 满分 |
-| -- | ------ | ---- |
-| m6i1 | 内容可引用性 | 2 |
-| m6i2 | 内容可分享性 | 2 |
-| m6i3 | 视觉风格统一 | 1 |
+| ID   | 诊断项       | 满分 |
+| ---- | ------------ | ---- |
+| m6i1 | 内容可引用性 | 2    |
+| m6i2 | 内容可分享性 | 2    |
+| m6i3 | 视觉风格统一 | 1    |
 
 > 各子项**判断规则**与**评分规则**全文见后端 `website_guide.py`；Agent 须按 HTML/Lighthouse 证据打分，不得照抄示例分。