siluzan-tso-cli 1.1.29-beta.15 → 1.1.29-beta.16

package/README.md

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

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.15",
-  "publishedAt": 1781680166141
+  "version": "1.1.29-beta.16",
+  "publishedAt": 1781686919463
 }

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

@@ -12,7 +12,9 @@
       "本地视频：填 videoPath（或别名 video）；创建后 CLI 自动 PyAPI 上传并链接，与 --json-out 无关",
       "提交前：ad pmax-validate → 用户确认 → ad pmax-create",
       "campaignExtensions 可选：创建成功后 CLI 自动挂 callout/snippet/leadForm（非 pmax POST body）",
-      "不需要附加资产时删除整个 campaignExtensions 块"
+      "Lead Gen/B2B 询盘方案：默认保留 campaignExtensions.leadForm（勿只写 callouts/snippets）；用户明确不要表单才删 leadForm",
+      "方案 Markdown 须单列「潜在客户表单」节（标题/描述/字段/privacyPolicyUrl）；与 JSON 一致",
+      "不需要任何附加资产时删除整个 campaignExtensions 块"
     ]
   },
 

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

@@ -18,11 +18,25 @@
 | 图片          | **只填 `imagePaths`** 指向本地 PNG/JPEG；`pmax-create` 会自动 multipart 上传并用 assetId 创建（勿把 Base64 提交进 Git）                                             |
 | 视频          | JSON 填 **`videoPath`**（别名 `video` 亦可）；`pmax-create` 成功后 **必定**经 PyAPI 上传并链接（含 `--json-out`）。已有 YouTube 用 `youtubeUrlOrId`                 |
 | 附加资产      | 可选填 **`campaignExtensions`**                                                                                                                                     |
+| 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`。
+
+---
+
 ## 推荐命令顺序
 
 ```bash

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

@@ -4,9 +4,10 @@
     "doc": "pmax-lead-form-template.md",
     "note": "以 _ 开头的键仅作说明，CLI 提交前会剥离",
     "agentPitfalls": [
-      "LEAD_FORM 仅支持 Campaign 级，须挂到已存在的 PMax 活动 campaignId",
-      "勿在 pmax-create 流程内创建；先 pmax-create 再 ad extension lead-form",
-      "每个 PMax 活动通常仅允许 1 个 Lead Form；创建前用 ad extension list --type LEAD_FORM --campaign-id 检查",
+      "新建 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"
     ]

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

@@ -1,8 +1,15 @@
 # `ad extension lead-form` JSON 配置说明
 
-为**已创建的 PMax 活动**挂载潜在客户表单（`LEAD_FORM`）。不走 `pmax-create` 主流程。
+PMax **潜在客户表单**（`LEAD_FORM`）有两种挂载方式：
 
-模板 JSON：同目录 [`pmax-lead-form-template.json`](pmax-lead-form-template.json)。
+| 方式 | 何时用 | 入口 |
+| ---- | ------ | ---- |
+| **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）。
 
 ---
 

package/dist/skill/references/core/workflows.md

@@ -59,9 +59,17 @@
 - **必读**：方案与门禁 `google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md`；命令参数 `google-ads/google-ads.md`；PMax 加 **`assets/pmax-create-template.json`** + `assets/pmax-create-template.md` + `google-ads/pmax-api.md`。
 - **创建路径选择**：
   - 已有 AI 智投草稿 → 走 **W4**。
-  - 需先出投放方案（口述/官网/拓词）→ `google-ads-campaign-plan.md`：JSON → `campaign-validate`（门禁，失败只改 JSON）→ 用户确认 → `campaign-create`。
-  - 已有完整结构化 JSON → 直接 `campaign-validate` → `campaign-create`。
-- **步骤（一体化创建）**：
+  - **PMax 出方案/创建** → **`assets/pmax-create-template.json`**（先 Read）+ `pmax-create-template.md` + `pmax-api.md`：`pmax-validate` → 用户确认 → `pmax-create`（**勿**用 Search `campaign-create`）。
+  - 搜索系列出方案 → `google-ads-campaign-plan.md`：JSON → `campaign-validate` → 用户确认 → `campaign-create`。
+  - 已有完整结构化 JSON → 对应 validate → create。
+- **步骤（PMax 方案 → 创建）**：
+  1. 账户：`list-accounts -m Google -k <id>`；落地页与品牌从官网/RAG 归纳。
+  2. 地域/语言：`ad geo search` 取 location id；语言 id 写入 JSON。
+  3. 复制 `pmax-create-template.json` 填文案/预算/图片；**Lead Gen/B2B 默认** `campaignExtensions.leadForm`（方案 Markdown 须单列表单节）。
+  4. 门禁：`ad pmax-validate --config-file ./pmax.json --json-out ./snap-pmax`。
+  5. 输出 JSON + Markdown 方案 → 用户确认 → `ad pmax-create --commit "…"`。
+  6. 复核：`ad campaigns` / `ad pmax-get`；缺表单时 `ad extension lead-form` 补挂。
+- **步骤（Search 一体化创建）**：
   1. 地域 ID：`ad geo search -a <id> -q "United States"` 写入 `campaign.targetedLocations[].id`。
   2. 门禁：`ad campaign-validate --config-file ./campaign.json`（必跑）。
   3. 用户确认后创建：`ad campaign-create --config-file ./campaign.json`，记录返回 taskId。

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

@@ -14,7 +14,7 @@
 - 可执行真相只有 **JSON**（`assets/campaign-create-template.json` 同构）；Markdown 只读投影。
 - **Agent Read 顺序（建系列前必做）**：① `assets/campaign-create-template.json`（复制/改写的结构真相源）→ ② `assets/campaign-create-template.md`（字段说明与踩坑）。**禁止**只读 `.md` 凭印象拼 JSON。
 - 改需求 **只改 JSON**，再 `campaign-validate`，再刷新 Markdown。
-- **PMax 系列创建**走独立流水线（勿用本文件 JSON 模板）：`assets/pmax-create-template.md` + `ad pmax-validate` / `ad pmax-create`；运营诊断见 `google-ads/rules/google-ads-pmax-guide.md`。
+- **PMax 系列创建**走独立流水线（勿用本文件 JSON 模板）：**先 Read `assets/pmax-create-template.json`** + `assets/pmax-create-template.md` + `ad pmax-validate` / `ad pmax-create`；**Lead Gen/B2B 方案默认含 `campaignExtensions.leadForm`**（方案 Markdown 须单列表单）；运营诊断见 `google-ads/rules/google-ads-pmax-guide.md`。
 - 搜索网络：仅 Google 搜索（`TargetSearchNetwork`/`TargetContentNetwork`/`TargetPartnerSearchNetwork` 均为 false）。
 
 ---

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

@@ -41,7 +41,7 @@
 
 网关 `POST .../campaign/pmax` **不**接受扩展字段；CLI 通过 **`campaignExtensions`** 在 `pmax-create` 成功后**自动编排** `extensionmanagement`（与手动 `ad extension *` 等价）。
 
-**方式 A（推荐，一条命令）**：在 `pmax-create` JSON 中填 `campaignExtensions`：
+**方式 A（推荐，一条命令）**：在 `pmax-create` JSON 中填 `campaignExtensions`。**Lead Gen / B2B 询盘方案须含 `leadForm`**（勿只写 callouts/snippets；用户明确不要表单才省略）：
 
 ```json
 {

package/dist/skill/references/google-ads/rules/google-ads-pmax-guide.md

@@ -122,6 +122,8 @@ Asset Group 是 PMax 中素材与受众信号的组合单元。**推荐分组维
 素材组 C: 通用品牌认知 → 首页 + 广泛受众信号
 ```
 
+**新建活动（CLI）**：方案 JSON 默认含 `campaignExtensions.leadForm`（潜在客户表单），与 callouts/snippets 一并由 `pmax-create` 挂载；字段见 `assets/pmax-create-template.md` § 方案生成。存量活动补挂见 `assets/pmax-lead-form-template.md`。
+
 ### 3.5 每个素材组的完整性要求
 
 每个素材组必须包含**完整素材套件**：长标题 × 5、短标题 × 5、描述 × 5；横版图 (1.91:1) × 4+、方形图 (1:1) × 4+、竖版图 (4:5) × 2+；视频 × 1+（建议 3 个）；商家名称、Logo、最终网址、行动号召。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.29-beta.15'
+$PKG_VERSION = '1.1.29-beta.16'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.29-beta.15"
+readonly PKG_VERSION="1.1.29-beta.16"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.29-beta.15",
+  "version": "1.1.29-beta.16",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",