siluzan-tso-cli 1.1.29-beta.17 → 1.1.29-beta.18

package/README.md

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

package/dist/index.js

@@ -114916,13 +114916,13 @@ var VALID_PMAX_BIDDING_STRATEGIES = [
   "TARGET_CPA",
   "TARGET_ROAS"
 ];
-var PMAX_HEADLINE_MIN = 3;
+var PMAX_HEADLINE_MIN = 15;
 var PMAX_HEADLINE_MAX = 15;
 var PMAX_HEADLINE_CHAR_MAX = 30;
-var PMAX_LONG_HEADLINE_MIN = 1;
+var PMAX_LONG_HEADLINE_MIN = 5;
 var PMAX_LONG_HEADLINE_MAX = 5;
 var PMAX_LONG_HEADLINE_CHAR_MAX = 90;
-var PMAX_DESCRIPTION_MIN = 2;
+var PMAX_DESCRIPTION_MIN = 5;
 var PMAX_DESCRIPTION_MAX = 5;
 var PMAX_DESCRIPTION_CHAR_MAX = 90;
 var PMAX_BUSINESS_NAME_CHAR_MAX = 25;
@@ -115629,6 +115629,431 @@ function assertPmaxImageSlotsResolved(slots, requiredKinds = ["marketing", "squa
 
 // src/commands/ad/pmax-load.ts
 import { readFileSync as readFileSync9 } from "fs";
+
+// src/commands/ad/pmax-campaign-extensions.ts
+init_auth();
+var PMAX_POLICY_CALLOUT_MIN = 20;
+var PMAX_POLICY_STRUCTURED_SNIPPET_MIN = 20;
+var PMAX_POLICY_SITELINK_MIN = 6;
+var PMAX_EXTENSIONS_POLICY_HINT = `\u987B\u542B\uFF1A\u5BA3\u4F20\u4FE1\u606F \u2265${PMAX_POLICY_CALLOUT_MIN}\u3001\u7ED3\u6784\u5316\u6458\u8981 \u2265${PMAX_POLICY_STRUCTURED_SNIPPET_MIN}\u3001\u7AD9\u5185\u94FE\u63A5 \u2265${PMAX_POLICY_SITELINK_MIN}\u3001\u6F5C\u5728\u5BA2\u6237\u8868\u5355 leadForm\u3001WhatsApp businessMessage`;
+function countNonEmptyCallouts(callouts) {
+  return (callouts ?? []).filter((t) => t?.trim()).length;
+}
+function countValidSnippets(snippets) {
+  return (snippets ?? []).filter(
+    (s) => s?.header?.trim() && (s.values ?? []).filter((v) => v?.trim()).length >= 3
+  ).length;
+}
+function countValidSitelinks(sitelinks) {
+  return (sitelinks ?? []).filter((s) => s?.text?.trim() && s?.destinationUrl?.trim()).length;
+}
+function validatePmaxSitelinkSpec(link, prefix, errors, warnings) {
+  if (!link) {
+    errors.push(`${prefix} \u4E0D\u80FD\u4E3A\u7A7A`);
+    return;
+  }
+  const text = link.text?.trim();
+  const url = link.destinationUrl?.trim();
+  if (!text) errors.push(`${prefix}.text \u4E0D\u80FD\u4E3A\u7A7A`);
+  if (!url) {
+    errors.push(`${prefix}.destinationUrl \u4E0D\u80FD\u4E3A\u7A7A`);
+  } else if (!/^https?:\/\/.+/i.test(url)) {
+    errors.push(`${prefix}.destinationUrl \u683C\u5F0F\u4E0D\u6B63\u786E\uFF1A${url}`);
+  }
+  if (text && url) {
+    validateSitelinkProperties(
+      prefix,
+      {
+        Text: text,
+        DestinationUrl: url,
+        Line2: link.line2?.trim() ?? "",
+        Line3: link.line3?.trim() ?? ""
+      },
+      errors,
+      warnings,
+      []
+    );
+  }
+}
+function validatePmaxExtensionsPolicyCounts(ext, errors) {
+  const calloutCount = countNonEmptyCallouts(ext.callouts);
+  if (calloutCount < PMAX_POLICY_CALLOUT_MIN) {
+    errors.push(
+      `campaignExtensions.callouts \u81F3\u5C11 ${PMAX_POLICY_CALLOUT_MIN} \u6761\u975E\u7A7A\u5BA3\u4F20\u4FE1\u606F\uFF08\u5F53\u524D ${calloutCount}\uFF09`
+    );
+  }
+  const snippetCount = countValidSnippets(ext.structuredSnippets);
+  if (snippetCount < PMAX_POLICY_STRUCTURED_SNIPPET_MIN) {
+    errors.push(
+      `campaignExtensions.structuredSnippets \u81F3\u5C11 ${PMAX_POLICY_STRUCTURED_SNIPPET_MIN} \u6761\u6709\u6548\u7ED3\u6784\u5316\u6458\u8981\uFF08\u6BCF\u6761 header + \u22653 values\uFF0C\u5F53\u524D ${snippetCount}\uFF09`
+    );
+  }
+  const sitelinkCount = countValidSitelinks(ext.sitelinks);
+  if (sitelinkCount < PMAX_POLICY_SITELINK_MIN) {
+    errors.push(
+      `campaignExtensions.sitelinks \u81F3\u5C11 ${PMAX_POLICY_SITELINK_MIN} \u6761\u7AD9\u5185\u94FE\u63A5\uFF08text + destinationUrl\uFF0C\u5F53\u524D ${sitelinkCount}\uFF09`
+    );
+  }
+  if (!ext.leadForm) {
+    errors.push("campaignExtensions.leadForm \u5FC5\u586B\uFF08\u6F5C\u5728\u5BA2\u6237\u8868\u5355\uFF09");
+  }
+  if (!ext.businessMessage) {
+    errors.push("campaignExtensions.businessMessage \u5FC5\u586B\uFF08WhatsApp \u79C1\u4FE1\uFF09");
+  }
+}
+function convertExtensionsForBatchJobToCampaignExtensions(items) {
+  const config = {
+    callouts: [],
+    structuredSnippets: [],
+    sitelinks: []
+  };
+  const warnings = [];
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    if (!item || typeof item !== "object") continue;
+    const ext = item;
+    const type = String(ext.typeV2 ?? ext.TypeV2 ?? ext.AssetFieldType ?? "").toUpperCase();
+    const props = ext.Properties ?? {};
+    if (type === "CALLOUT") {
+      const text = String(props.Text ?? props.CalloutText ?? "").trim();
+      if (text) config.callouts.push(text);
+      continue;
+    }
+    if (type === "SITELINK") {
+      const text = String(props.Text ?? props.LinkText ?? "").trim();
+      const destinationUrl = String(props.DestinationUrl ?? "").trim();
+      if (text && destinationUrl) {
+        config.sitelinks.push({
+          text,
+          destinationUrl,
+          line2: String(props.Line2 ?? props.Description1 ?? "").trim() || void 0,
+          line3: String(props.Line3 ?? props.Description2 ?? "").trim() || void 0
+        });
+      }
+      continue;
+    }
+    if (type === "STRUCTURED_SNIPPET") {
+      const headerValue = ext.structuredSnippetHeaderValue ?? ext.StructuredSnippetHeaderValue;
+      if (headerValue && typeof headerValue === "object") {
+        const hv = headerValue;
+        const header = String(hv.key ?? hv.Key ?? "").trim();
+        const rawValues = hv.value ?? hv.Value;
+        const values = Array.isArray(rawValues) ? rawValues.map((v) => String(v).trim()).filter(Boolean) : [];
+        if (header && values.length >= 3) {
+          config.structuredSnippets.push({ header, values });
+        }
+      }
+      continue;
+    }
+    if (type === "LEAD_FORM" && ext.leadForm && typeof ext.leadForm === "object") {
+      config.leadForm = ext.leadForm;
+      continue;
+    }
+    if (type === "CALL" || type === "BUSINESS_MESSAGE") {
+      warnings.push(
+        `ExtensionsForBatchJob[${i}]\uFF08${type}\uFF09\u65E0\u6CD5\u81EA\u52A8\u8F6C\u4E3A campaignExtensions\uFF1BPMax \u8BF7\u7528 campaignExtensions \u6216\u521B\u5EFA\u540E ad extension * \u8865\u6302`
+      );
+    }
+  }
+  if ((config.callouts?.length ?? 0) === 0) delete config.callouts;
+  if ((config.structuredSnippets?.length ?? 0) === 0) delete config.structuredSnippets;
+  if ((config.sitelinks?.length ?? 0) === 0) delete config.sitelinks;
+  return { config, warnings };
+}
+function validatePmaxCampaignExtensions(ext, opts) {
+  const errors = [];
+  const warnings = [];
+  const skip = opts?.skipCampaignExtensions === true;
+  if (!ext && !skip) {
+    const batchExt = opts?.rawConfig?.["ExtensionsForBatchJob"];
+    if (Array.isArray(batchExt) && batchExt.length > 0) {
+      errors.push(
+        `\u68C0\u6D4B\u5230 ExtensionsForBatchJob\uFF08Search \u6A21\u677F\u5B57\u6BB5\uFF09\uFF1APMax \u987B\u6539\u7528 campaignExtensions\u3002${PMAX_EXTENSIONS_POLICY_HINT}`
+      );
+      const { config: converted, warnings: convertWarnings } = convertExtensionsForBatchJobToCampaignExtensions(batchExt);
+      warnings.push(...convertWarnings);
+      if (hasExtensionsToAttach(converted)) {
+        errors.push(
+          "\u53EF\u4ECE ExtensionsForBatchJob \u81EA\u52A8\u6620\u5C04\u90E8\u5206\u5B57\u6BB5\uFF1B\u8BF7\u5728 JSON \u6839\u7EA7\u6DFB\u52A0 campaignExtensions \u540E\u5220\u9664 ExtensionsForBatchJob"
+        );
+      }
+    } else {
+      errors.push(
+        `\u672A\u914D\u7F6E campaignExtensions\uFF1A${PMAX_EXTENSIONS_POLICY_HINT}\uFF1B\u7528\u6237\u660E\u786E\u4E0D\u8981\u9644\u52A0\u8D44\u4EA7\u65F6\u8BBE skipCampaignExtensions: true`
+      );
+    }
+    return { errors, warnings };
+  }
+  if (skip && !ext) return { errors, warnings };
+  if (!ext) return { errors, warnings };
+  if (opts?.rawConfig?.["ExtensionsForBatchJob"]) {
+    warnings.push(
+      "JSON \u4ECD\u542B ExtensionsForBatchJob\uFF08Search \u6A21\u677F\u5B57\u6BB5\uFF09\uFF1B\u8BF7\u5220\u8BE5\u5B57\u6BB5\u5E76\u4EC5\u4FDD\u7559 campaignExtensions"
+    );
+  }
+  const callouts = ext.callouts ?? [];
+  for (let i = 0; i < callouts.length; i++) {
+    const text = callouts[i]?.trim();
+    if (!text) {
+      errors.push(`campaignExtensions.callouts[${i}] \u4E0D\u80FD\u4E3A\u7A7A`);
+      continue;
+    }
+    if (text.length > CALLOUT_TEXT_MAX_LEN) {
+      errors.push(
+        `campaignExtensions.callouts[${i}] \u8D85\u8FC7 ${CALLOUT_TEXT_MAX_LEN} \u5B57\u7B26\uFF08\u5F53\u524D ${text.length}\uFF09\uFF1A"${text}"`
+      );
+    }
+  }
+  const snippets = ext.structuredSnippets ?? [];
+  for (let i = 0; i < snippets.length; i++) {
+    const s = snippets[i];
+    const prefix = `campaignExtensions.structuredSnippets[${i}]`;
+    if (!s?.header?.trim()) {
+      errors.push(`${prefix}.header \u4E0D\u80FD\u4E3A\u7A7A`);
+    }
+    const values = (s?.values ?? []).map((v) => v?.trim()).filter(Boolean);
+    if (values.length < 3) {
+      errors.push(`${prefix}.values \u81F3\u5C11 3 \u4E2A\u975E\u7A7A\u503C\uFF08\u5F53\u524D ${values.length}\uFF09`);
+    }
+  }
+  const sitelinks = ext.sitelinks ?? [];
+  for (let i = 0; i < sitelinks.length; i++) {
+    validatePmaxSitelinkSpec(sitelinks[i], `campaignExtensions.sitelinks[${i}]`, errors, warnings);
+  }
+  if (ext.leadForm) {
+    errors.push(...validateLeadFormPayload(ext.leadForm, "campaignExtensions.leadForm"));
+  }
+  if (ext.businessMessage) {
+    errors.push(
+      ...validateBusinessMessagePayload(ext.businessMessage, "campaignExtensions.businessMessage")
+    );
+    warnings.push(
+      "WhatsApp\uFF08BUSINESS_MESSAGE\uFF09\u9700 Google API \u767D\u540D\u5355\uFF1B\u672A\u5F00\u901A\u4F1A\u8FD4\u56DE CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS"
+    );
+  }
+  if (!skip) {
+    validatePmaxExtensionsPolicyCounts(ext, errors);
+  }
+  return { errors, warnings };
+}
+function hasExtensionsToAttach(ext) {
+  if (!ext) return false;
+  return countNonEmptyCallouts(ext.callouts) > 0 || countValidSnippets(ext.structuredSnippets) > 0 || countValidSitelinks(ext.sitelinks) > 0 || Boolean(ext.leadForm) || Boolean(ext.businessMessage);
+}
+async function postExtension(config, googleApiUrl, accountId, body, verbose) {
+  const url = `${googleApiUrl}/extensionmanagement/extension/${accountId}`;
+  try {
+    const data = await apiFetch2(
+      url,
+      config,
+      { method: "POST", body: JSON.stringify(body) },
+      verbose
+    );
+    return { ok: true, data };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
+function buildCalloutBody(accountId, campaignId, text) {
+  return {
+    activeuseridg: accountId,
+    campaignId,
+    level: "Campaign",
+    typeV2: "CALLOUT",
+    assetFieldType: "CALLOUT",
+    properties: { Text: text.trim() }
+  };
+}
+function buildSnippetBody(accountId, campaignId, header, values) {
+  return {
+    activeuseridg: accountId,
+    campaignId,
+    level: "Campaign",
+    typeV2: "STRUCTURED_SNIPPET",
+    assetFieldType: "STRUCTURED_SNIPPET",
+    structuredSnippetHeaderValue: {
+      key: header.trim(),
+      value: values.map((v) => v.trim()).filter(Boolean)
+    }
+  };
+}
+function buildSitelinkBody(accountId, campaignId, link) {
+  const text = link.text.trim();
+  const line2 = link.line2?.trim() || text;
+  const line3 = link.line3?.trim() || line2;
+  return {
+    activeuseridg: accountId,
+    campaignId,
+    level: "Campaign",
+    typeV2: "SITELINK",
+    assetFieldType: "SITELINK",
+    properties: {
+      Text: text,
+      Line2: line2,
+      Line3: line3,
+      DestinationUrl: link.destinationUrl.trim()
+    }
+  };
+}
+function buildLeadFormBodyForCampaign(accountId, campaignId, leadForm) {
+  return buildLeadFormExtensionBody({ account: accountId, campaignId, leadForm });
+}
+async function attachPmaxCampaignExtensions(opts) {
+  const ext = opts.extensions;
+  if (!hasExtensionsToAttach(ext)) {
+    return {
+      callouts: [],
+      structuredSnippets: [],
+      sitelinks: [],
+      allOk: true,
+      skippedReason: "\u672A\u914D\u7F6E campaignExtensions \u6216\u5185\u5BB9\u4E3A\u7A7A"
+    };
+  }
+  const result = {
+    callouts: [],
+    structuredSnippets: [],
+    sitelinks: [],
+    allOk: true
+  };
+  for (const raw of ext.callouts ?? []) {
+    const text = raw?.trim();
+    if (!text) continue;
+    if (opts.logProgress) console.log(`
+   \u6302\u8F7D\u5BA3\u4F20\u4FE1\u606F\uFF1A${text}`);
+    const posted = await postExtension(
+      opts.config,
+      opts.googleApiUrl,
+      opts.accountId,
+      buildCalloutBody(opts.accountId, opts.campaignId, text),
+      opts.verbose
+    );
+    if (posted.ok) {
+      result.callouts.push({
+        ok: true,
+        id: String(posted.data["id"] ?? ""),
+        label: text
+      });
+    } else {
+      result.allOk = false;
+      result.callouts.push({ ok: false, error: posted.error, label: text });
+    }
+  }
+  for (const s of ext.structuredSnippets ?? []) {
+    const header = s?.header?.trim();
+    const values = (s?.values ?? []).map((v) => v?.trim()).filter(Boolean);
+    if (!header || values.length < 3) continue;
+    const label = `${header}: ${values.join(", ")}`;
+    if (opts.logProgress) console.log(`
+   \u6302\u8F7D\u7ED3\u6784\u5316\u6458\u8981\uFF1A${label}`);
+    const posted = await postExtension(
+      opts.config,
+      opts.googleApiUrl,
+      opts.accountId,
+      buildSnippetBody(opts.accountId, opts.campaignId, header, values),
+      opts.verbose
+    );
+    if (posted.ok) {
+      result.structuredSnippets.push({
+        ok: true,
+        id: String(posted.data["id"] ?? ""),
+        label
+      });
+    } else {
+      result.allOk = false;
+      result.structuredSnippets.push({ ok: false, error: posted.error, label });
+    }
+  }
+  for (const link of ext.sitelinks ?? []) {
+    const text = link?.text?.trim();
+    const url = link?.destinationUrl?.trim();
+    if (!text || !url) continue;
+    if (opts.logProgress) console.log(`
+   \u6302\u8F7D\u7AD9\u5185\u94FE\u63A5\uFF1A${text} \u2192 ${url}`);
+    const posted = await postExtension(
+      opts.config,
+      opts.googleApiUrl,
+      opts.accountId,
+      buildSitelinkBody(opts.accountId, opts.campaignId, link),
+      opts.verbose
+    );
+    if (posted.ok) {
+      result.sitelinks.push({
+        ok: true,
+        id: String(posted.data["id"] ?? ""),
+        label: text
+      });
+    } else {
+      result.allOk = false;
+      result.sitelinks.push({ ok: false, error: posted.error, label: text });
+    }
+  }
+  if (ext.leadForm) {
+    const headline = ext.leadForm.headline?.trim() || "Lead Form";
+    if (opts.logProgress) console.log(`
+   \u6302\u8F7D\u6F5C\u5728\u5BA2\u6237\u8868\u5355\uFF1A${headline}`);
+    const posted = await postExtension(
+      opts.config,
+      opts.googleApiUrl,
+      opts.accountId,
+      buildLeadFormBodyForCampaign(opts.accountId, opts.campaignId, ext.leadForm),
+      opts.verbose
+    );
+    if (posted.ok) {
+      result.leadForm = {
+        ok: true,
+        id: String(posted.data["id"] ?? ""),
+        label: headline
+      };
+    } else {
+      result.allOk = false;
+      result.leadForm = { ok: false, error: posted.error, label: headline };
+    }
+  }
+  if (ext.businessMessage) {
+    const label = ext.businessMessage.starterMessage?.trim().slice(0, 40) || "WhatsApp";
+    if (opts.logProgress) console.log(`
+   \u6302\u8F7D WhatsApp \u79C1\u4FE1\uFF1A${label}`);
+    const posted = await postExtension(
+      opts.config,
+      opts.googleApiUrl,
+      opts.accountId,
+      buildBusinessMessageBodyForCampaign(opts.accountId, opts.campaignId, ext.businessMessage),
+      opts.verbose
+    );
+    if (posted.ok) {
+      result.whatsapp = {
+        ok: true,
+        id: String(posted.data["id"] ?? ""),
+        label
+      };
+    } else {
+      result.allOk = false;
+      result.whatsapp = { ok: false, error: posted.error, label };
+    }
+  }
+  return result;
+}
+function formatPmaxExtensionsAttachErrors(result) {
+  const msgs = [];
+  for (const c of result.callouts) {
+    if (!c.ok) msgs.push(`\u5BA3\u4F20\u4FE1\u606F\u300C${c.label}\u300D\u5931\u8D25\uFF1A${c.error}`);
+  }
+  for (const s of result.structuredSnippets) {
+    if (!s.ok) msgs.push(`\u7ED3\u6784\u5316\u6458\u8981\u300C${s.label}\u300D\u5931\u8D25\uFF1A${s.error}`);
+  }
+  for (const sl of result.sitelinks) {
+    if (!sl.ok) msgs.push(`\u7AD9\u5185\u94FE\u63A5\u300C${sl.label}\u300D\u5931\u8D25\uFF1A${sl.error}`);
+  }
+  if (result.leadForm && !result.leadForm.ok) {
+    msgs.push(`\u6F5C\u5728\u5BA2\u6237\u8868\u5355\u300C${result.leadForm.label}\u300D\u5931\u8D25\uFF1A${result.leadForm.error}`);
+  }
+  if (result.whatsapp && !result.whatsapp.ok) {
+    msgs.push(`WhatsApp\u300C${result.whatsapp.label}\u300D\u5931\u8D25\uFF1A${result.whatsapp.error}`);
+  }
+  return msgs;
+}
+
+// src/commands/ad/pmax-load.ts
 function loadPmaxCreateConfig(configFile) {
   const cfg = tryLoadPmaxCreateConfig(configFile);
   if (!cfg) {
@@ -115640,9 +116065,35 @@ function loadPmaxCreateConfig(configFile) {
   return cfg;
 }
 var PMAX_VIDEO_PATH_ALIASES = ["video", "videoFile", "localVideo"];
+function normalizeCampaignExtensions(stripped, cfg) {
+  const migrationWarnings = [];
+  if (!cfg.campaignExtensions) {
+    const alias = stripped["extensions"];
+    if (alias && typeof alias === "object" && !Array.isArray(alias)) {
+      cfg.campaignExtensions = alias;
+      migrationWarnings.push("\u5DF2\u5C06 extensions \u522B\u540D\u6620\u5C04\u4E3A campaignExtensions");
+    }
+  }
+  const batchExt = stripped["ExtensionsForBatchJob"];
+  if (!cfg.campaignExtensions && Array.isArray(batchExt) && batchExt.length > 0) {
+    const { config: converted, warnings } = convertExtensionsForBatchJobToCampaignExtensions(batchExt);
+    migrationWarnings.push(...warnings);
+    if (hasExtensionsToAttach(converted)) {
+      cfg.campaignExtensions = converted;
+      migrationWarnings.push(
+        "\u5DF2\u5C06 ExtensionsForBatchJob \u81EA\u52A8\u8F6C\u6362\u4E3A campaignExtensions\uFF08\u8BF7\u6539 JSON \u6839\u7EA7\u5B57\u6BB5\u5E76\u5220\u9664 ExtensionsForBatchJob\uFF09"
+      );
+    }
+  }
+  if (stripped["skipCampaignExtensions"] === true) {
+    cfg.skipCampaignExtensions = true;
+  }
+  return migrationWarnings;
+}
 function normalizePmaxCreateConfig(raw) {
   const stripped = stripMetaKeys(raw);
   const cfg = { ...stripped };
+  normalizeCampaignExtensions(stripped, cfg);
   if (!cfg.videoPath?.trim()) {
     for (const key of PMAX_VIDEO_PATH_ALIASES) {
       const v = stripped[key];
@@ -116155,230 +116606,6 @@ async function linkPmaxVideoAfterCreate(opts) {
   }
 }
 
-// src/commands/ad/pmax-campaign-extensions.ts
-init_auth();
-function validatePmaxCampaignExtensions(ext) {
-  const errors = [];
-  const warnings = [];
-  if (!ext) return { errors, warnings };
-  const callouts = ext.callouts ?? [];
-  for (let i = 0; i < callouts.length; i++) {
-    const text = callouts[i]?.trim();
-    if (!text) {
-      errors.push(`campaignExtensions.callouts[${i}] \u4E0D\u80FD\u4E3A\u7A7A`);
-      continue;
-    }
-    if (text.length > CALLOUT_TEXT_MAX_LEN) {
-      errors.push(
-        `campaignExtensions.callouts[${i}] \u8D85\u8FC7 ${CALLOUT_TEXT_MAX_LEN} \u5B57\u7B26\uFF08\u5F53\u524D ${text.length}\uFF09\uFF1A"${text}"`
-      );
-    }
-  }
-  const snippets = ext.structuredSnippets ?? [];
-  for (let i = 0; i < snippets.length; i++) {
-    const s = snippets[i];
-    const prefix = `campaignExtensions.structuredSnippets[${i}]`;
-    if (!s?.header?.trim()) {
-      errors.push(`${prefix}.header \u4E0D\u80FD\u4E3A\u7A7A`);
-    }
-    const values = (s?.values ?? []).map((v) => v?.trim()).filter(Boolean);
-    if (values.length < 3) {
-      errors.push(`${prefix}.values \u81F3\u5C11 3 \u4E2A\u975E\u7A7A\u503C\uFF08\u5F53\u524D ${values.length}\uFF09`);
-    }
-  }
-  if (ext.leadForm) {
-    const lfErrors = validateLeadFormPayload(ext.leadForm, "campaignExtensions.leadForm");
-    errors.push(...lfErrors);
-  }
-  if (ext.businessMessage) {
-    errors.push(
-      ...validateBusinessMessagePayload(ext.businessMessage, "campaignExtensions.businessMessage")
-    );
-    warnings.push(
-      "WhatsApp\uFF08BUSINESS_MESSAGE\uFF09\u9700 Google API \u767D\u540D\u5355\uFF1B\u672A\u5F00\u901A\u4F1A\u8FD4\u56DE CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS"
-    );
-  }
-  if (callouts.length === 0 && snippets.length === 0 && !ext.leadForm && !ext.businessMessage) {
-    warnings.push(
-      "campaignExtensions \u5DF2\u58F0\u660E\u4F46 callouts / structuredSnippets / leadForm / businessMessage \u5747\u4E3A\u7A7A\uFF0C\u521B\u5EFA\u65F6\u5C06\u8DF3\u8FC7\u9644\u52A0\u8D44\u4EA7"
-    );
-  }
-  return { errors, warnings };
-}
-function hasExtensionsToAttach(ext) {
-  if (!ext) return false;
-  const hasCallouts = (ext.callouts ?? []).some((t) => t?.trim());
-  const hasSnippets = (ext.structuredSnippets ?? []).some(
-    (s) => s?.header?.trim() && (s.values ?? []).some((v) => v?.trim())
-  );
-  return hasCallouts || hasSnippets || Boolean(ext.leadForm) || Boolean(ext.businessMessage);
-}
-async function postExtension(config, googleApiUrl, accountId, body, verbose) {
-  const url = `${googleApiUrl}/extensionmanagement/extension/${accountId}`;
-  try {
-    const data = await apiFetch2(
-      url,
-      config,
-      { method: "POST", body: JSON.stringify(body) },
-      verbose
-    );
-    return { ok: true, data };
-  } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err) };
-  }
-}
-function buildCalloutBody(accountId, campaignId, text) {
-  return {
-    activeuseridg: accountId,
-    campaignId,
-    level: "Campaign",
-    typeV2: "CALLOUT",
-    assetFieldType: "CALLOUT",
-    properties: { Text: text.trim() }
-  };
-}
-function buildSnippetBody(accountId, campaignId, header, values) {
-  return {
-    activeuseridg: accountId,
-    campaignId,
-    level: "Campaign",
-    typeV2: "STRUCTURED_SNIPPET",
-    assetFieldType: "STRUCTURED_SNIPPET",
-    structuredSnippetHeaderValue: {
-      key: header.trim(),
-      value: values.map((v) => v.trim()).filter(Boolean)
-    }
-  };
-}
-function buildLeadFormBodyForCampaign(accountId, campaignId, leadForm) {
-  return buildLeadFormExtensionBody({ account: accountId, campaignId, leadForm });
-}
-async function attachPmaxCampaignExtensions(opts) {
-  const ext = opts.extensions;
-  if (!hasExtensionsToAttach(ext)) {
-    return {
-      callouts: [],
-      structuredSnippets: [],
-      allOk: true,
-      skippedReason: "\u672A\u914D\u7F6E campaignExtensions \u6216\u5185\u5BB9\u4E3A\u7A7A"
-    };
-  }
-  const result = {
-    callouts: [],
-    structuredSnippets: [],
-    allOk: true
-  };
-  for (const raw of ext.callouts ?? []) {
-    const text = raw?.trim();
-    if (!text) continue;
-    if (opts.logProgress) console.log(`
-   \u6302\u8F7D\u5BA3\u4F20\u4FE1\u606F\uFF1A${text}`);
-    const posted = await postExtension(
-      opts.config,
-      opts.googleApiUrl,
-      opts.accountId,
-      buildCalloutBody(opts.accountId, opts.campaignId, text),
-      opts.verbose
-    );
-    if (posted.ok) {
-      result.callouts.push({
-        ok: true,
-        id: String(posted.data["id"] ?? ""),
-        label: text
-      });
-    } else {
-      result.allOk = false;
-      result.callouts.push({ ok: false, error: posted.error, label: text });
-    }
-  }
-  for (const s of ext.structuredSnippets ?? []) {
-    const header = s?.header?.trim();
-    const values = (s?.values ?? []).map((v) => v?.trim()).filter(Boolean);
-    if (!header || values.length < 3) continue;
-    const label = `${header}: ${values.join(", ")}`;
-    if (opts.logProgress) console.log(`
-   \u6302\u8F7D\u7ED3\u6784\u5316\u6458\u8981\uFF1A${label}`);
-    const posted = await postExtension(
-      opts.config,
-      opts.googleApiUrl,
-      opts.accountId,
-      buildSnippetBody(opts.accountId, opts.campaignId, header, values),
-      opts.verbose
-    );
-    if (posted.ok) {
-      result.structuredSnippets.push({
-        ok: true,
-        id: String(posted.data["id"] ?? ""),
-        label
-      });
-    } else {
-      result.allOk = false;
-      result.structuredSnippets.push({ ok: false, error: posted.error, label });
-    }
-  }
-  if (ext.leadForm) {
-    const headline = ext.leadForm.headline?.trim() || "Lead Form";
-    if (opts.logProgress) console.log(`
-   \u6302\u8F7D\u6F5C\u5728\u5BA2\u6237\u8868\u5355\uFF1A${headline}`);
-    const posted = await postExtension(
-      opts.config,
-      opts.googleApiUrl,
-      opts.accountId,
-      buildLeadFormBodyForCampaign(opts.accountId, opts.campaignId, ext.leadForm),
-      opts.verbose
-    );
-    if (posted.ok) {
-      result.leadForm = {
-        ok: true,
-        id: String(posted.data["id"] ?? ""),
-        label: headline
-      };
-    } else {
-      result.allOk = false;
-      result.leadForm = { ok: false, error: posted.error, label: headline };
-    }
-  }
-  if (ext.businessMessage) {
-    const label = ext.businessMessage.starterMessage?.trim().slice(0, 40) || "WhatsApp";
-    if (opts.logProgress) console.log(`
-   \u6302\u8F7D WhatsApp \u79C1\u4FE1\uFF1A${label}`);
-    const posted = await postExtension(
-      opts.config,
-      opts.googleApiUrl,
-      opts.accountId,
-      buildBusinessMessageBodyForCampaign(opts.accountId, opts.campaignId, ext.businessMessage),
-      opts.verbose
-    );
-    if (posted.ok) {
-      result.whatsapp = {
-        ok: true,
-        id: String(posted.data["id"] ?? ""),
-        label
-      };
-    } else {
-      result.allOk = false;
-      result.whatsapp = { ok: false, error: posted.error, label };
-    }
-  }
-  return result;
-}
-function formatPmaxExtensionsAttachErrors(result) {
-  const msgs = [];
-  for (const c of result.callouts) {
-    if (!c.ok) msgs.push(`\u5BA3\u4F20\u4FE1\u606F\u300C${c.label}\u300D\u5931\u8D25\uFF1A${c.error}`);
-  }
-  for (const s of result.structuredSnippets) {
-    if (!s.ok) msgs.push(`\u7ED3\u6784\u5316\u6458\u8981\u300C${s.label}\u300D\u5931\u8D25\uFF1A${s.error}`);
-  }
-  if (result.leadForm && !result.leadForm.ok) {
-    msgs.push(`\u6F5C\u5728\u5BA2\u6237\u8868\u5355\u300C${result.leadForm.label}\u300D\u5931\u8D25\uFF1A${result.leadForm.error}`);
-  }
-  if (result.whatsapp && !result.whatsapp.ok) {
-    msgs.push(`WhatsApp\u300C${result.whatsapp.label}\u300D\u5931\u8D25\uFF1A${result.whatsapp.error}`);
-  }
-  return msgs;
-}
-
 // src/commands/ad/pmax-create.ts
 function printVideoLinkRecoveryHint(accountId, assetGroupId, campaignId, youtubeTarget) {
   const cid = campaignId != null ? ` --campaign-id ${campaignId}` : "";
@@ -116406,7 +116633,11 @@ async function runAdPmaxCreate(opts) {
     cfg
   );
   const { errors: extErrors, warnings: extWarnings } = validatePmaxCampaignExtensions(
-    cfg.campaignExtensions
+    cfg.campaignExtensions,
+    {
+      skipCampaignExtensions: cfg.skipCampaignExtensions,
+      rawConfig: rawCfg
+    }
   );
   const errors = [...deprecatedVideoKeys, ...cfgErrors, ...imgErrors, ...videoErrors, ...extErrors];
   const warnings = [...cfgWarnings, ...imgWarnings, ...videoWarnings, ...extWarnings];
@@ -116551,7 +116782,7 @@ async function runAdPmaxCreate(opts) {
       `   \u53EF\u624B\u52A8\u8865\u6302\uFF1Asiluzan-tso ad extension callout|snippet|lead-form -a ${accountId} --campaign-id ${campaignId} \u2026
 `
     );
-  } else if (extensionsResult?.allOk && extensionsResult.callouts.length + extensionsResult.structuredSnippets.length + (extensionsResult.leadForm ? 1 : 0) + (extensionsResult.whatsapp ? 1 : 0) > 0) {
+  } else if (extensionsResult?.allOk && extensionsResult.callouts.length + extensionsResult.structuredSnippets.length + extensionsResult.sitelinks.length + (extensionsResult.leadForm ? 1 : 0) + (extensionsResult.whatsapp ? 1 : 0) > 0) {
     if (!opts.jsonOut) {
       console.log("\n\u2705 Campaign \u9644\u52A0\u8D44\u4EA7\u5DF2\u6302\u8F7D");
     }
@@ -116609,7 +116840,11 @@ async function runAdPmaxValidate(opts) {
     cfg
   );
   const { errors: extErrors, warnings: extWarnings } = validatePmaxCampaignExtensions(
-    cfg.campaignExtensions
+    cfg.campaignExtensions,
+    {
+      skipCampaignExtensions: cfg.skipCampaignExtensions,
+      rawConfig: rawCfg
+    }
   );
   const errors = [...deprecatedVideoKeys, ...cfgErrors, ...imgErrors, ...videoErrors, ...extErrors];
   const warnings = [...cfgWarnings, ...imgWarnings, ...videoWarnings, ...extWarnings];

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.17",
-  "publishedAt": 1781748956615
+  "version": "1.1.29-beta.18",
+  "publishedAt": 1781751946624
 }

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

@@ -11,10 +11,12 @@
       "改已上线品牌：先 pmax-get 看 _brandGuidelinesActive；true 用 pmax-brand-assets-edit，false 用 pmax-assets-update 或 pmax-brand-guidelines-enable",
       "本地视频：填 videoPath（或别名 video）；创建后 CLI 自动 PyAPI 上传并链接，与 --json-out 无关",
       "提交前：ad pmax-validate → 用户确认 → ad pmax-create",
-      "campaignExtensions 可选：创建成功后 CLI 自动挂 callout/snippet/leadForm（非 pmax POST body）",
+      "campaignExtensions 默认必填：宣传信息≥20、结构化摘要≥20、站内链接≥6、leadForm、businessMessage",
+      "文案门禁：headlines 15、longHeadlines 5（Google 上限须填满）、descriptions 5",
+      "勿用 Search 的 ExtensionsForBatchJob；PMax 用 campaignExtensions（CLI 会尝试自动转换 CALLOUT/SNIPPET）",
       "Lead Gen/B2B 询盘方案：默认保留 campaignExtensions.leadForm（勿只写 callouts/snippets）；用户明确不要表单才删 leadForm",
       "方案 Markdown 须单列「潜在客户表单」节（标题/描述/字段/privacyPolicyUrl）；与 JSON 一致",
-      "不需要任何附加资产时删除整个 campaignExtensions 块"
+      "不需要任何附加资产时设 skipCampaignExtensions: true（勿仅删除 campaignExtensions 块）"
     ]
   },
 

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

@@ -17,7 +17,8 @@
 | 金额          | 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`**                                                                                                                                     |
+| 附加资产      | **必填** `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                                                                             |

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

@@ -65,7 +65,7 @@
 - **步骤（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 须单列表单节）。
+  3. 复制 `pmax-create-template.json` 填文案/预算/图片；**必须**含 `campaignExtensions`（至少 callouts + structuredSnippets）；**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` 补挂。

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.17'
+$PKG_VERSION = '1.1.29-beta.18'
 $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.17"
+readonly PKG_VERSION="1.1.29-beta.18"
 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.17",
+  "version": "1.1.29-beta.18",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",