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

package/README.md

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

package/dist/index.js

@@ -110086,292 +110086,6 @@ function validateCampaignRsaCrossGroupHeadlines(campaign, errors) {
   }
 }
 
-// src/commands/ad/campaign-launch-strategy.ts
-import { readFileSync as readFileSync4 } from "fs";
-var KEYWORD_TIERS = ["core", "longtail"];
-var KEYWORD_CLASSES = [
-  "product",
-  "service",
-  "pain",
-  "competitor",
-  "industry",
-  "scenario",
-  "geo",
-  "tech",
-  "question"
-];
-var CORE_MIN = 5;
-var CORE_MAX = 15;
-var LONGTAIL_MIN = 10;
-var LONGTAIL_MAX = 25;
-var EXACT_MIN = 2;
-var EXACT_MAX = 8;
-var PHRASE_MIN = 3;
-var PHRASE_MAX = 10;
-var BROAD_MIN = 1;
-var BROAD_MAX = 3;
-var NEGATIVE_MIN = 20;
-var AD_GROUP_MAX = 20;
-var EXACT_RATIO_MIN = 0.3;
-var EXACT_RATIO_MAX = 0.4;
-var PHRASE_RATIO_MIN = 0.5;
-var PHRASE_RATIO_MAX = 0.6;
-var BROAD_RATIO_MIN = 0.1;
-var BROAD_RATIO_MAX = 0.2;
-function normalizeGroupKey(name) {
-  return name.trim().toLowerCase();
-}
-function pushErr(errors, msg) {
-  errors.push(msg);
-}
-function isValidTier(t) {
-  return typeof t === "string" && KEYWORD_TIERS.includes(t);
-}
-function isValidClass(c) {
-  return typeof c === "string" && KEYWORD_CLASSES.includes(c);
-}
-function keywordStemFromDisplay(text) {
-  return unwrapKeywordDisplayTextForEdit(text).trim().toLowerCase();
-}
-function countNegatives(campaign) {
-  const neg = campaign["NegativeKeywordsForBatchJob"];
-  if (!Array.isArray(neg)) return 0;
-  const seen = /* @__PURE__ */ new Set();
-  for (const block of neg) {
-    const texts = block?.["KeywordText"];
-    if (!Array.isArray(texts)) continue;
-    for (const t of texts) {
-      if (typeof t !== "string") continue;
-      const stem = keywordStemFromDisplay(t);
-      if (stem) seen.add(stem);
-    }
-  }
-  return seen.size;
-}
-function countMatchTypeInGroup(kws) {
-  let exact = 0;
-  let phrase = 0;
-  let broad = 0;
-  const stems = /* @__PURE__ */ new Set();
-  if (!Array.isArray(kws)) return { exact, phrase, broad, stems };
-  for (const block of kws) {
-    const b = block;
-    const mt = String(b["MatchTypeV2"] ?? "").toUpperCase();
-    const texts = b["KeywordText"];
-    if (!Array.isArray(texts)) continue;
-    for (const raw of texts) {
-      if (typeof raw !== "string") continue;
-      const stem = keywordStemFromDisplay(raw);
-      if (!stem) continue;
-      stems.add(stem);
-      if (mt === "EXACT") exact++;
-      else if (mt === "PHRASE") phrase++;
-      else broad++;
-    }
-  }
-  return { exact, phrase, broad, stems };
-}
-function parseV2ByGroup(v2) {
-  const map = /* @__PURE__ */ new Map();
-  if (!Array.isArray(v2)) return map;
-  for (const entry of v2) {
-    const key = typeof entry?.Key === "string" ? normalizeGroupKey(entry.Key) : "";
-    if (!key) continue;
-    let core = 0;
-    let longtail = 0;
-    const stems = /* @__PURE__ */ new Set();
-    const values = entry.Value;
-    if (!Array.isArray(values)) {
-      map.set(key, { core: 0, longtail: 0, stems });
-      continue;
-    }
-    for (const item of values) {
-      const row = item;
-      const kw = typeof row["keyword"] === "string" ? row["keyword"].trim() : "";
-      if (!kw) continue;
-      stems.add(kw.toLowerCase());
-      const tier = row["tier"];
-      if (tier === "core") core++;
-      else if (tier === "longtail") longtail++;
-    }
-    map.set(key, { core, longtail, stems });
-  }
-  return map;
-}
-function validateCampaignLaunchStrategy(cfg, errors, options = {}) {
-  const stats = {
-    adGroups: 0,
-    core: 0,
-    longtail: 0,
-    exact: 0,
-    phrase: 0,
-    broad: 0,
-    negatives: 0
-  };
-  if (!cfg.campaign || typeof cfg.campaign !== "object" || Array.isArray(cfg.campaign)) {
-    return stats;
-  }
-  const campaign = cfg.campaign;
-  stats.negatives = countNegatives(campaign);
-  if (stats.negatives < NEGATIVE_MIN) {
-    pushErr(
-      errors,
-      `campaign.NegativeKeywordsForBatchJob \u53BB\u91CD\u540E\u987B \u2265 ${NEGATIVE_MIN} \u6761\uFF08\u5F53\u524D ${stats.negatives}\uFF09`
-    );
-  }
-  const v2 = cfg.KeywordRecommendationsV2;
-  if (!Array.isArray(v2) || v2.length === 0) {
-    pushErr(
-      errors,
-      "\u7F3A\u5C11\u9876\u5C42 KeywordRecommendationsV2\uFF08\u987B\u6309\u5E7F\u544A\u7EC4\u586B\u5199 tier=core|longtail \u4E0E class\uFF09"
-    );
-    return stats;
-  }
-  const v2ByGroup = parseV2ByGroup(v2);
-  const adGroups = campaign["AdGroupsForBatchJob"];
-  if (!Array.isArray(adGroups)) return stats;
-  stats.adGroups = adGroups.length;
-  if (adGroups.length > AD_GROUP_MAX) {
-    pushErr(
-      errors,
-      `campaign.AdGroupsForBatchJob \u6570\u91CF\u987B\u5728 1\u2013${AD_GROUP_MAX}\uFF08\u5F53\u524D ${adGroups.length}\uFF09`
-    );
-  }
-  for (let i = 0; i < adGroups.length; i++) {
-    const g = adGroups[i];
-    const gPrefix = `campaign.AdGroupsForBatchJob[${i}]`;
-    const gName = typeof g["Name"] === "string" ? g["Name"].trim() : "";
-    if (!gName) continue;
-    const gKey = normalizeGroupKey(gName);
-    const v2Row = v2ByGroup.get(gKey);
-    if (!v2Row) {
-      pushErr(
-        errors,
-        `${gPrefix}\uFF08${gName}\uFF09\u5728 KeywordRecommendationsV2 \u4E2D\u7F3A\u5C11 Key \u6761\u76EE`
-      );
-      continue;
-    }
-    if (v2Row.stems.size === 0) {
-      pushErr(errors, `KeywordRecommendationsV2 Key="${gName}" \u7684 Value \u4E0D\u80FD\u4E3A\u7A7A`);
-      continue;
-    }
-    stats.core += v2Row.core;
-    stats.longtail += v2Row.longtail;
-    if (v2Row.core < CORE_MIN || v2Row.core > CORE_MAX) {
-      pushErr(
-        errors,
-        `${gPrefix} \u6838\u5FC3\u8BCD\uFF08tier=core\uFF09\u987B ${CORE_MIN}\u2013${CORE_MAX} \u6761\uFF08\u5F53\u524D ${v2Row.core}\uFF09`
-      );
-    }
-    if (v2Row.longtail < LONGTAIL_MIN || v2Row.longtail > LONGTAIL_MAX) {
-      pushErr(
-        errors,
-        `${gPrefix} \u957F\u5C3E\u8BCD\uFF08tier=longtail\uFF09\u987B ${LONGTAIL_MIN}\u2013${LONGTAIL_MAX} \u6761\uFF08\u5F53\u524D ${v2Row.longtail}\uFF09`
-      );
-    }
-    for (const entry of v2) {
-      if (normalizeGroupKey(String(entry.Key)) !== gKey) continue;
-      const values = entry.Value;
-      if (!Array.isArray(values)) break;
-      for (let vi = 0; vi < values.length; vi++) {
-        const row = values[vi];
-        if (!isValidTier(row["tier"])) {
-          pushErr(
-            errors,
-            `KeywordRecommendationsV2["${gName}"].Value[${vi}].tier \u987B\u4E3A core | longtail`
-          );
-        }
-        if (row["class"] !== void 0 && !isValidClass(row["class"])) {
-          pushErr(
-            errors,
-            `KeywordRecommendationsV2["${gName}"].Value[${vi}].class \u65E0\u6548\uFF08\u89C1 google-ads-keyword-taxonomy.md\uFF09`
-          );
-        }
-      }
-      break;
-    }
-    const { exact, phrase, broad, stems } = countMatchTypeInGroup(g["KeywordsForBatchJob"]);
-    stats.exact += exact;
-    stats.phrase += phrase;
-    stats.broad += broad;
-    if (exact < EXACT_MIN || exact > EXACT_MAX) {
-      pushErr(
-        errors,
-        `${gPrefix} EXACT \u5173\u952E\u8BCD\u987B ${EXACT_MIN}\u2013${EXACT_MAX} \u6761\uFF08\u5F53\u524D ${exact}\uFF09`
-      );
-    }
-    if (phrase < PHRASE_MIN || phrase > PHRASE_MAX) {
-      pushErr(
-        errors,
-        `${gPrefix} PHRASE \u5173\u952E\u8BCD\u987B ${PHRASE_MIN}\u2013${PHRASE_MAX} \u6761\uFF08\u5F53\u524D ${phrase}\uFF09`
-      );
-    }
-    if (broad < BROAD_MIN || broad > BROAD_MAX) {
-      pushErr(
-        errors,
-        `${gPrefix} BROAD \u5173\u952E\u8BCD\u987B ${BROAD_MIN}\u2013${BROAD_MAX} \u6761\uFF08\u5F53\u524D ${broad}\uFF09`
-      );
-    }
-    const total = exact + phrase + broad;
-    if (total > 0) {
-      const er = exact / total;
-      const pr = phrase / total;
-      const br = broad / total;
-      if (er < EXACT_RATIO_MIN || er > EXACT_RATIO_MAX) {
-        pushErr(
-          errors,
-          `${gPrefix} EXACT \u5360\u6BD4\u987B\u5728 ${EXACT_RATIO_MIN * 100}\u2013${EXACT_RATIO_MAX * 100}%\uFF08\u5F53\u524D ${(er * 100).toFixed(1)}%\uFF09`
-        );
-      }
-      if (pr < PHRASE_RATIO_MIN || pr > PHRASE_RATIO_MAX) {
-        pushErr(
-          errors,
-          `${gPrefix} PHRASE \u5360\u6BD4\u987B\u5728 ${PHRASE_RATIO_MIN * 100}\u2013${PHRASE_RATIO_MAX * 100}%\uFF08\u5F53\u524D ${(pr * 100).toFixed(1)}%\uFF09`
-        );
-      }
-      if (br < BROAD_RATIO_MIN || br > BROAD_RATIO_MAX) {
-        pushErr(
-          errors,
-          `${gPrefix} BROAD \u5360\u6BD4\u987B\u5728 ${BROAD_RATIO_MIN * 100}\u2013${BROAD_RATIO_MAX * 100}%\uFF08\u5F53\u524D ${(br * 100).toFixed(1)}%\uFF09`
-        );
-      }
-    }
-    for (const stem of v2Row.stems) {
-      if (!stems.has(stem)) {
-        pushErr(
-          errors,
-          `${gPrefix} KeywordsForBatchJob \u672A\u5305\u542B KeywordRecommendationsV2 \u8BCD\u5E72\uFF1A${stem}`
-        );
-      }
-    }
-  }
-  if (!options.skipManifest && options.manifestPath) {
-    validateManifestRoles(options.manifestPath, errors);
-  }
-  return stats;
-}
-function validateManifestRoles(manifestPath, errors) {
-  let raw;
-  try {
-    raw = JSON.parse(readFileSync4(manifestPath, "utf8"));
-  } catch {
-    pushErr(errors, `\u65E0\u6CD5\u8BFB\u53D6 campaign-manifest\uFF1A${manifestPath}`);
-    return;
-  }
-  const m = raw;
-  if (!m?.campaigns || !Array.isArray(m.campaigns)) {
-    pushErr(errors, "campaign-manifest \u987B\u5305\u542B campaigns \u6570\u7EC4");
-    return;
-  }
-  const roles = new Set(m.campaigns.map((c) => c.role?.toLowerCase()).filter(Boolean));
-  if (!roles.has("brand")) {
-    pushErr(errors, "campaign-manifest \u987B\u81F3\u5C11\u5305\u542B role=brand \u7684\u7CFB\u5217");
-  }
-  if (!roles.has("competitor")) {
-    pushErr(errors, "campaign-manifest \u987B\u81F3\u5C11\u5305\u542B role=competitor \u7684\u7CFB\u5217");
-  }
-}
-
 // src/commands/ad/campaign-create-validate.ts
 var VALID_BIDDING_STRATEGIES = [
   "TARGET_SPEND",
@@ -110386,7 +110100,7 @@ var VALID_STATUS_V2 = ["Enabled", "Paused"];
 var VALID_CHANNEL_V2 = ["SEARCH", "DISPLAY", "VIDEO", "SHOPPING", "MULTI_CHANNEL"];
 var URL_REGEX = /^https?:\/\/.+/;
 var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
-function pushErr2(errors, msg) {
+function pushErr(errors, msg) {
   errors.push(msg);
 }
 function pushWarn(warnings, msg) {
@@ -110419,48 +110133,48 @@ function validateRsaAd(prefix, ad, errors, warnings) {
     (x) => typeof x === "string" && x.length > 0
   );
   if (headlines.length < 3) {
-    pushErr2(errors, `${prefix} \u6807\u9898\u81F3\u5C11 3 \u6761\uFF08headlinePart1/2/3 \u5FC5\u586B\uFF09\uFF0C\u5F53\u524D ${headlines.length} \u6761`);
+    pushErr(errors, `${prefix} \u6807\u9898\u81F3\u5C11 3 \u6761\uFF08headlinePart1/2/3 \u5FC5\u586B\uFF09\uFF0C\u5F53\u524D ${headlines.length} \u6761`);
   } else if (headlines.length > 15) {
-    pushErr2(errors, `${prefix} \u6807\u9898\u6700\u591A 15 \u6761\uFF08\u542B AddtionalHeadlines\uFF09\uFF0C\u5F53\u524D ${headlines.length} \u6761`);
+    pushErr(errors, `${prefix} \u6807\u9898\u6700\u591A 15 \u6761\uFF08\u542B AddtionalHeadlines\uFF09\uFF0C\u5F53\u524D ${headlines.length} \u6761`);
   } else if (headlines.length < 12) {
     pushWarn(warnings, `${prefix} \u6807\u9898\u63A8\u8350 12\u201315 \u6761\uFF08\u5F53\u524D ${headlines.length} \u6761\uFF09\uFF0C\u66F4\u591A\u7EC4\u5408\u53EF\u63D0\u5347\u6295\u653E\u8868\u73B0`);
   }
   for (let i = 0; i < headlines.length; i++) {
     const len = calcGoogleCharLength(headlines[i]);
     if (len > 30) {
-      pushErr2(
+      pushErr(
         errors,
         `${prefix} \u6807\u9898[${i}] \u8D85\u8FC7 30 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A"${headlines[i].slice(0, 30)}"`
       );
     }
   }
   if (descriptions.length < 2) {
-    pushErr2(
+    pushErr(
       errors,
       `${prefix} \u63CF\u8FF0\u81F3\u5C11 2 \u6761\uFF08adDescription/adDescription2 \u5FC5\u586B\uFF09\uFF0C\u5F53\u524D ${descriptions.length} \u6761`
     );
   } else if (descriptions.length > 4) {
-    pushErr2(errors, `${prefix} \u63CF\u8FF0\u6700\u591A 4 \u6761\uFF0C\u5F53\u524D ${descriptions.length} \u6761`);
+    pushErr(errors, `${prefix} \u63CF\u8FF0\u6700\u591A 4 \u6761\uFF0C\u5F53\u524D ${descriptions.length} \u6761`);
   } else if (descriptions.length < 4) {
     pushWarn(warnings, `${prefix} \u63CF\u8FF0\u63A8\u8350 4 \u6761\uFF08\u5F53\u524D ${descriptions.length} \u6761\uFF09`);
   }
   for (let i = 0; i < descriptions.length; i++) {
     const len = calcGoogleCharLength(descriptions[i]);
     if (len > 90) {
-      pushErr2(errors, `${prefix} \u63CF\u8FF0[${i}] \u8D85\u8FC7 90 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF09\uFF1A"${descriptions[i].slice(0, 40)}"`);
+      pushErr(errors, `${prefix} \u63CF\u8FF0[${i}] \u8D85\u8FC7 90 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF09\uFF1A"${descriptions[i].slice(0, 40)}"`);
     }
   }
   const p1 = ad["Path1"];
   const p2 = ad["Path2"];
   if (typeof p1 === "string" && calcGoogleCharLength(p1) > 15) {
-    pushErr2(errors, `${prefix} Path1 \u8D85\u8FC7 15 \u5B57\u7B26\uFF08CJK \u8BA1 2\uFF09\uFF1A"${p1}"`);
+    pushErr(errors, `${prefix} Path1 \u8D85\u8FC7 15 \u5B57\u7B26\uFF08CJK \u8BA1 2\uFF09\uFF1A"${p1}"`);
   }
   if (typeof p2 === "string" && calcGoogleCharLength(p2) > 15) {
-    pushErr2(errors, `${prefix} Path2 \u8D85\u8FC7 15 \u5B57\u7B26\uFF08CJK \u8BA1 2\uFF09\uFF1A"${p2}"`);
+    pushErr(errors, `${prefix} Path2 \u8D85\u8FC7 15 \u5B57\u7B26\uFF08CJK \u8BA1 2\uFF09\uFF1A"${p2}"`);
   }
   const finalUrl = ad["Finalurl"] ?? ad["DestinationUrl"];
   if (typeof finalUrl === "string" && finalUrl.length > 0 && !URL_REGEX.test(finalUrl)) {
-    pushErr2(errors, `${prefix} Finalurl \u683C\u5F0F\u4E0D\u6B63\u786E\uFF08\u5E94\u4EE5 http(s):// \u5F00\u5934\uFF09\uFF1A${finalUrl}`);
+    pushErr(errors, `${prefix} Finalurl \u683C\u5F0F\u4E0D\u6B63\u786E\uFF08\u5E94\u4EE5 http(s):// \u5F00\u5934\uFF09\uFF1A${finalUrl}`);
   }
   validateRsaHeadlinesWithinAd(prefix, ad, errors);
 }
@@ -110471,18 +110185,18 @@ function validateCampaignCreateConfigCore(cfg) {
     normalizeCampaignKeywordTrees(cfg.campaign, errors, warnings);
   }
   if (!cfg.account?.toString().trim()) {
-    pushErr2(errors, "account\uFF08\u9876\u5C42 customerId\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
+    pushErr(errors, "account\uFF08\u9876\u5C42 customerId\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
   }
   if (!cfg.customerName?.trim()) {
-    pushErr2(errors, "customerName \u4E0D\u80FD\u4E3A\u7A7A\uFF08\u540E\u7AEF\uFF1Acustomer name is null or empty\uFF09");
+    pushErr(errors, "customerName \u4E0D\u80FD\u4E3A\u7A7A\uFF08\u540E\u7AEF\uFF1Acustomer name is null or empty\uFF09");
   }
   if (!cfg.campaign || typeof cfg.campaign !== "object" || Array.isArray(cfg.campaign)) {
-    pushErr2(errors, "campaign \u5BF9\u8C61\u4E0D\u80FD\u4E3A\u7A7A\uFF08\u540E\u7AEF\uFF1Acampaign is null\uFF09");
+    pushErr(errors, "campaign \u5BF9\u8C61\u4E0D\u80FD\u4E3A\u7A7A\uFF08\u540E\u7AEF\uFF1Acampaign is null\uFF09");
     return { errors, warnings };
   }
   const campaign = cfg.campaign;
   if (campaign["TargetPartnerSearchNetwork"] === true) {
-    pushErr2(
+    pushErr(
       errors,
       "campaign.TargetPartnerSearchNetwork \u4E0D\u80FD\u4E3A true\uFF08\u540E\u7AEF\u62D2\u7EDD\uFF1Acannot set TargetPartnerSearchNetwork\uFF09"
     );
@@ -110492,48 +110206,48 @@ function validateCampaignCreateConfigCore(cfg) {
   const targetGoogleSearch = tgs === void 0 ? true : tgs === true;
   const targetSearchNetwork = tsn === true;
   if (!targetGoogleSearch && targetSearchNetwork) {
-    pushErr2(
+    pushErr(
       errors,
       "campaign.TargetSearchNetwork=true \u65F6 campaign.TargetGoogleSearch \u5FC5\u987B\u4E3A true\uFF08\u540E\u7AEF\u62D2\u7EDD\uFF1ATargetGoogleSearch cannot be set to false when TargetSearchNetwork is set to true\uFF09"
     );
   }
   if (targetSearchNetwork) {
-    pushErr2(
+    pushErr(
       errors,
       "campaign.TargetSearchNetwork \u5FC5\u987B\u4E3A false\uFF08\u641C\u7D22\u4E13\u5C5E\u65B9\u6848\uFF1A\u7981\u6B62 Google \u641C\u7D22\u5408\u4F5C\u4F19\u4F34\u7F51\u7EDC\uFF09"
     );
   }
   if (campaign["TargetContentNetwork"] === true) {
-    pushErr2(
+    pushErr(
       errors,
       "campaign.TargetContentNetwork \u5FC5\u987B\u4E3A false\uFF08\u641C\u7D22\u4E13\u5C5E\u65B9\u6848\uFF1A\u7981\u6B62\u5C55\u793A\u5E7F\u544A\u7F51\u7EDC\uFF09"
     );
   }
   const name = campaign["Name"];
   if (typeof name !== "string" || !name.trim()) {
-    pushErr2(errors, "campaign.Name \u4E0D\u80FD\u4E3A\u7A7A");
+    pushErr(errors, "campaign.Name \u4E0D\u80FD\u4E3A\u7A7A");
   }
   const budget = campaign["Budget"];
   if (typeof budget !== "number" || !Number.isFinite(budget) || budget <= 0) {
-    pushErr2(errors, "campaign.Budget\uFF08\u65E5\u9884\u7B97\uFF0C\u5355\u4F4D\u300C\u5143\u300D\uFF09\u5FC5\u987B\u4E3A\u6B63\u6570");
+    pushErr(errors, "campaign.Budget\uFF08\u65E5\u9884\u7B97\uFF0C\u5355\u4F4D\u300C\u5143\u300D\uFF09\u5FC5\u987B\u4E3A\u6B63\u6570");
   }
   const channelType = campaign["ChannelTypeV2"];
   if (channelType !== void 0 && !VALID_CHANNEL_V2.includes(String(channelType))) {
-    pushErr2(
+    pushErr(
       errors,
       `campaign.ChannelTypeV2 \u65E0\u6548\uFF08${String(channelType)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1A${VALID_CHANNEL_V2.join(" | ")}`
     );
   }
   const statusV2 = campaign["StatusV2"];
   if (statusV2 !== void 0 && !VALID_STATUS_V2.includes(String(statusV2))) {
-    pushErr2(
+    pushErr(
       errors,
       `campaign.StatusV2 \u65E0\u6548\uFF08${String(statusV2)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1A${VALID_STATUS_V2.join(" | ")}`
     );
   }
   const deliveryMethod = campaign["BudgetBudgetDeliveryMethodV2"];
   if (deliveryMethod !== void 0 && !VALID_BUDGET_DELIVERY.includes(String(deliveryMethod))) {
-    pushErr2(
+    pushErr(
       errors,
       `campaign.BudgetBudgetDeliveryMethodV2 \u65E0\u6548\uFF08${String(deliveryMethod)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1A${VALID_BUDGET_DELIVERY.join(" | ")}`
     );
@@ -110541,7 +110255,7 @@ function validateCampaignCreateConfigCore(cfg) {
   const bidding = campaign["BiddingStrategyTypeV2"];
   const biddingStr = typeof bidding === "string" ? bidding : "";
   if (!VALID_BIDDING_STRATEGIES.includes(biddingStr)) {
-    pushErr2(
+    pushErr(
       errors,
       `campaign.BiddingStrategyTypeV2 \u65E0\u6548\uFF08${String(bidding)}\uFF09\uFF0C\u5408\u6CD5\u503C\uFF1A${VALID_BIDDING_STRATEGIES.join(" | ")}`
     );
@@ -110549,7 +110263,7 @@ function validateCampaignCreateConfigCore(cfg) {
     if (biddingStr === "TARGET_SPEND") {
       const ceiling = campaign["TargetSpend_BidCeilingAmount"];
       if (typeof ceiling !== "number" || !Number.isFinite(ceiling) || ceiling <= 0) {
-        pushErr2(
+        pushErr(
           errors,
           "TARGET_SPEND \u51FA\u4EF7\u7B56\u7565\u4E0B campaign.TargetSpend_BidCeilingAmount\uFF08CPC \u4E0A\u9650\uFF0C\u5143\uFF09\u5FC5\u987B\u4E3A\u6B63\u6570"
         );
@@ -110558,13 +110272,13 @@ function validateCampaignCreateConfigCore(cfg) {
     if (biddingStr === "TARGET_CPA") {
       const cpa = campaign["TargetCpa_BidingAmount"];
       if (typeof cpa !== "number" || !Number.isFinite(cpa) || cpa <= 0) {
-        pushErr2(errors, "TARGET_CPA \u51FA\u4EF7\u7B56\u7565\u4E0B campaign.TargetCpa_BidingAmount\uFF08\u5143\uFF09\u5FC5\u987B\u4E3A\u6B63\u6570");
+        pushErr(errors, "TARGET_CPA \u51FA\u4EF7\u7B56\u7565\u4E0B campaign.TargetCpa_BidingAmount\uFF08\u5143\uFF09\u5FC5\u987B\u4E3A\u6B63\u6570");
       }
     }
     if (biddingStr === "TARGET_ROAS") {
       const roas = campaign["TargetRoas"];
       if (typeof roas !== "number" || !Number.isFinite(roas) || roas <= 0) {
-        pushErr2(errors, "TARGET_ROAS \u51FA\u4EF7\u7B56\u7565\u4E0B campaign.TargetRoas \u5FC5\u987B\u4E3A\u6B63\u6570");
+        pushErr(errors, "TARGET_ROAS \u51FA\u4EF7\u7B56\u7565\u4E0B campaign.TargetRoas \u5FC5\u987B\u4E3A\u6B63\u6570");
       } else if (roas > 1e3) {
         pushWarn(
           warnings,
@@ -110575,7 +110289,7 @@ function validateCampaignCreateConfigCore(cfg) {
   }
   const targetedLocations = campaign["targetedLocations"];
   if (!Array.isArray(targetedLocations) || targetedLocations.length === 0) {
-    pushErr2(
+    pushErr(
       errors,
       "campaign.targetedLocations \u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u8BF7\u5148\u6267\u884C\uFF1Asiluzan-tso ad geo search -a <accountId> -q <\u5730\u533A\u540D>"
     );
@@ -110583,52 +110297,52 @@ function validateCampaignCreateConfigCore(cfg) {
     for (let i = 0; i < targetedLocations.length; i++) {
       const loc = targetedLocations[i];
       if (!loc || loc["id"] === void 0 && loc["Id"] === void 0) {
-        pushErr2(errors, `campaign.targetedLocations[${i}] \u7F3A\u5C11 id \u5B57\u6BB5`);
+        pushErr(errors, `campaign.targetedLocations[${i}] \u7F3A\u5C11 id \u5B57\u6BB5`);
       }
     }
   }
   const targetedLanguages = campaign["targetedLanguages"];
   if (!Array.isArray(targetedLanguages) || targetedLanguages.length === 0) {
-    pushErr2(errors, "campaign.targetedLanguages \u4E0D\u80FD\u4E3A\u7A7A\uFF08\u82F1\u8BED id=1000\uFF0C\u4E2D\u6587 id=1017\uFF09");
+    pushErr(errors, "campaign.targetedLanguages \u4E0D\u80FD\u4E3A\u7A7A\uFF08\u82F1\u8BED id=1000\uFF0C\u4E2D\u6587 id=1017\uFF09");
   }
   const start = campaign["StartTime"];
   const end = campaign["EndTime"];
   if (typeof start === "string" && start.length > 0 && !DATE_REGEX.test(start)) {
-    pushErr2(errors, `campaign.StartTime \u683C\u5F0F\u4E0D\u6B63\u786E\uFF08${start}\uFF09\uFF0C\u5E94\u4E3A YYYY-MM-DD`);
+    pushErr(errors, `campaign.StartTime \u683C\u5F0F\u4E0D\u6B63\u786E\uFF08${start}\uFF09\uFF0C\u5E94\u4E3A YYYY-MM-DD`);
   }
   if (typeof end === "string" && end.length > 0 && !DATE_REGEX.test(end)) {
-    pushErr2(errors, `campaign.EndTime \u683C\u5F0F\u4E0D\u6B63\u786E\uFF08${end}\uFF09\uFF0C\u5E94\u4E3A YYYY-MM-DD`);
+    pushErr(errors, `campaign.EndTime \u683C\u5F0F\u4E0D\u6B63\u786E\uFF08${end}\uFF09\uFF0C\u5E94\u4E3A YYYY-MM-DD`);
   }
   if (typeof start === "string" && typeof end === "string" && DATE_REGEX.test(start) && DATE_REGEX.test(end)) {
     if (end <= start) {
-      pushErr2(errors, `campaign.EndTime\uFF08${end}\uFF09\u5FC5\u987B\u665A\u4E8E StartTime\uFF08${start}\uFF09`);
+      pushErr(errors, `campaign.EndTime\uFF08${end}\uFF09\u5FC5\u987B\u665A\u4E8E StartTime\uFF08${start}\uFF09`);
     }
   }
   if (cfg.url !== void 0 && cfg.url !== "" && !URL_REGEX.test(cfg.url)) {
-    pushErr2(errors, `url\uFF08${cfg.url}\uFF09\u683C\u5F0F\u4E0D\u6B63\u786E\uFF0C\u5E94\u4EE5 http(s):// \u5F00\u5934`);
+    pushErr(errors, `url\uFF08${cfg.url}\uFF09\u683C\u5F0F\u4E0D\u6B63\u786E\uFF0C\u5E94\u4EE5 http(s):// \u5F00\u5934`);
   }
   const adGroups = campaign["AdGroupsForBatchJob"];
   if (!Array.isArray(adGroups) || adGroups.length === 0) {
-    pushErr2(errors, "campaign.AdGroupsForBatchJob \u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u81F3\u5C11\u914D\u7F6E\u4E00\u4E2A\u5E7F\u544A\u7EC4");
+    pushErr(errors, "campaign.AdGroupsForBatchJob \u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u81F3\u5C11\u914D\u7F6E\u4E00\u4E2A\u5E7F\u544A\u7EC4");
   } else {
     for (let i = 0; i < adGroups.length; i++) {
       const g = adGroups[i];
       const gPrefix = `campaign.AdGroupsForBatchJob[${i}]`;
       if (!g || typeof g !== "object") {
-        pushErr2(errors, `${gPrefix} \u5FC5\u987B\u662F\u5BF9\u8C61`);
+        pushErr(errors, `${gPrefix} \u5FC5\u987B\u662F\u5BF9\u8C61`);
         continue;
       }
       const gName = g["Name"];
       if (typeof gName !== "string" || !gName.trim()) {
-        pushErr2(errors, `${gPrefix}.Name \u4E0D\u80FD\u4E3A\u7A7A`);
+        pushErr(errors, `${gPrefix}.Name \u4E0D\u80FD\u4E3A\u7A7A`);
       }
       const mc = g["MaxCPCAmount"];
       if (mc !== void 0 && (typeof mc !== "number" || !Number.isFinite(mc) || mc < 0)) {
-        pushErr2(errors, `${gPrefix}.MaxCPCAmount \u5FC5\u987B\u4E3A\u975E\u8D1F\u6570\u5B57\uFF08\u5355\u4F4D\u300C\u5143\u300D\uFF09`);
+        pushErr(errors, `${gPrefix}.MaxCPCAmount \u5FC5\u987B\u4E3A\u975E\u8D1F\u6570\u5B57\uFF08\u5355\u4F4D\u300C\u5143\u300D\uFF09`);
       }
       if (biddingStr === "MANUAL_CPC") {
         if (typeof mc !== "number" || mc <= 0) {
-          pushErr2(errors, `MANUAL_CPC \u4E0B ${gPrefix}.MaxCPCAmount \u5FC5\u987B\u4E3A\u6B63\u6570`);
+          pushErr(errors, `MANUAL_CPC \u4E0B ${gPrefix}.MaxCPCAmount \u5FC5\u987B\u4E3A\u6B63\u6570`);
         }
       }
       const ads = g["AdsForBatchJob"];
@@ -110646,7 +110360,7 @@ function validateCampaignCreateConfigCore(cfg) {
           const block = kws[j];
           const texts = block?.["KeywordText"];
           if (!Array.isArray(texts) || texts.length === 0) {
-            pushErr2(errors, `${gPrefix}.KeywordsForBatchJob[${j}].KeywordText \u4E0D\u80FD\u4E3A\u7A7A\u6570\u7EC4`);
+            pushErr(errors, `${gPrefix}.KeywordsForBatchJob[${j}].KeywordText \u4E0D\u80FD\u4E3A\u7A7A\u6570\u7EC4`);
           }
         }
       }
@@ -110655,17 +110369,12 @@ function validateCampaignCreateConfigCore(cfg) {
   }
   return { errors, warnings };
 }
-function runCampaignCreateValidation(cfg, options = {}) {
-  const { errors, warnings } = validateCampaignCreateConfigCore(cfg);
-  const stats = validateCampaignLaunchStrategy(cfg, errors, {
-    manifestPath: options.manifestPath,
-    skipManifest: options.skipManifest
-  });
-  return { errors, warnings, stats };
+function runCampaignCreateValidation(cfg) {
+  return validateCampaignCreateConfigCore(cfg);
 }
 
 // src/commands/ad/campaign-load.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 function stripMetaKeys(value) {
   if (Array.isArray(value)) {
     return value.map((item) => stripMetaKeys(item));
@@ -110696,7 +110405,7 @@ function loadCampaignCreateConfig(configFile) {
 function tryLoadCampaignCreateConfig(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync5(configFile, "utf8"));
+    raw = JSON.parse(readFileSync4(configFile, "utf8"));
   } catch {
     return null;
   }
@@ -110919,9 +110628,6 @@ async function runAdCampaignCreate(opts) {
     DraftStatus: cfg.draft ? "Draft" : "Published",
     campaign: campaignWithCents
   };
-  if (cfg.KeywordRecommendationsV2 !== void 0) {
-    body["KeywordRecommendationsV2"] = cfg.KeywordRecommendationsV2;
-  }
   const url = `${config.apiBaseUrl}/command/campaign-creation-record/campaign-batch-asyncs`;
   let data;
   try {
@@ -113220,10 +112926,7 @@ async function runAiCreationUpdate(opts) {
 import { writeFileSync as writeFileSync3 } from "fs";
 async function runAdCampaignValidate(opts) {
   const cfg = loadCampaignCreateConfig(opts.configFile);
-  const { errors, warnings, stats } = runCampaignCreateValidation(cfg, {
-    manifestPath: opts.manifestFile,
-    skipManifest: opts.skipManifest
-  });
+  const { errors, warnings } = runCampaignCreateValidation(cfg);
   if (opts.writeNormalized) {
     const toWrite = stripMetaKeysForExport(cfg);
     writeFileSync3(opts.writeNormalized, `${JSON.stringify(toWrite, null, 2)}
@@ -113235,8 +112938,7 @@ async function runAdCampaignValidate(opts) {
         {
           ok: errors.length === 0,
           errors,
-          warnings,
-          stats
+          warnings
         },
         null,
         2
@@ -113250,17 +112952,10 @@ async function runAdCampaignValidate(opts) {
     if (errors.length > 0) {
       console.error("\n\u274C \u6295\u653E\u914D\u7F6E\u6821\u9A8C\u5931\u8D25\uFF1A");
       for (const e of errors) console.error(`   \u2022 ${e}`);
-      console.error(
-        `
-   \u7EDF\u8BA1\uFF1A\u5E7F\u544A\u7EC4 ${stats.adGroups} | \u6838\u5FC3 ${stats.core} | \u957F\u5C3E ${stats.longtail} | Exact ${stats.exact} | Phrase ${stats.phrase} | Broad ${stats.broad} | \u5426\u8BCD ${stats.negatives}
-`
-      );
+      console.error();
       process.exit(1);
     }
     console.log("\n\u2705 \u6295\u653E\u914D\u7F6E\u6821\u9A8C\u901A\u8FC7");
-    console.log(
-      `   \u5E7F\u544A\u7EC4 ${stats.adGroups} | \u6838\u5FC3 ${stats.core} | \u957F\u5C3E ${stats.longtail} | Exact ${stats.exact} | Phrase ${stats.phrase} | Broad ${stats.broad} | \u5426\u8BCD ${stats.negatives}`
-    );
     if (opts.writeNormalized) {
       console.log(`   \u5DF2\u5199\u5165\u89C4\u8303\u5316 JSON\uFF1A${opts.writeNormalized}`);
     }
@@ -113618,16 +113313,14 @@ function register20(program2) {
     }
   );
   adCmd.command("campaign-validate").description(
-    "\u6821\u9A8C campaign-create JSON\uFF08\u8BCD\u9762\u89C4\u8303\u5316 + \u540E\u7AEF\u786C\u7EA6\u675F + \u6295\u653E\u7ED3\u6784\u7B56\u7565\uFF1B\u4E0D\u8C03\u7528 API\uFF09\n\n  \u7528\u6CD5\uFF1A\n    siluzan-tso ad campaign-validate --config-file ./campaign.json\n    siluzan-tso ad campaign-validate --config-file ./campaign.json --write-normalized ./campaign.normalized.json"
-  ).requiredOption("--config-file <path>", "campaign-create JSON \u8DEF\u5F84").option("--manifest-file <path>", "\u591A\u7CFB\u5217 campaign-manifest.json\uFF08\u6821\u9A8C brand/competitor \u89D2\u8272\uFF09").option("--skip-manifest", "\u8DF3\u8FC7\u591A\u7CFB\u5217 manifest \u89D2\u8272\u68C0\u67E5", false).option(
+    "\u6821\u9A8C campaign-create JSON\uFF08\u8BCD\u9762\u89C4\u8303\u5316 + \u540E\u7AEF\u786C\u7EA6\u675F\uFF1B\u4E0D\u8C03\u7528 API\uFF09\n\n  \u7528\u6CD5\uFF1A\n    siluzan-tso ad campaign-validate --config-file ./campaign.json\n    siluzan-tso ad campaign-validate --config-file ./campaign.json --write-normalized ./campaign.normalized.json"
+  ).requiredOption("--config-file <path>", "campaign-create JSON \u8DEF\u5F84").option(
     "--write-normalized <path>",
     "\u5C06\u89C4\u8303\u5316\u540E\u7684 JSON \u5199\u5165\u8BE5\u8DEF\u5F84\uFF08\u5173\u952E\u8BCD\u8BCD\u9762\u5DF2\u4FEE\u6B63\uFF09"
-  ).option("--json", "\u8F93\u51FA { ok, errors, warnings, stats }", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  ).option("--json", "\u8F93\u51FA { ok, errors, warnings }", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAdCampaignValidate({
         configFile: opts.configFile,
-        manifestFile: opts.manifestFile,
-        skipManifest: opts.skipManifest,
         writeNormalized: opts.writeNormalized,
         json: opts.json,
         verbose: opts.verbose

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.20-beta.15",
-  "publishedAt": 1779268611318
+  "version": "1.1.20-beta.16",
+  "publishedAt": 1779273967078
 }

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

@@ -1,6 +1,6 @@
 # `ad campaign-create` JSON 配置说明
 
-`siluzan-tso ad campaign-create` **仅**接受 `--config-file` 指向的 JSON 文件。该 JSON 的字段名与后端 `POST /command/campaign-creation-record/campaign-batch-asyncs` 的请求体 **完全一致**（PascalCase）：外层是 `CampaignCreationRecord`，内层 `campaign` 直接对齐 `Samm.Domain.AdsAcctMgmt.Campaign`。
+`siluzan-tso ad campaign-create` **仅**接受 `--config-file` 指向的 JSON 文件
 
 **CLI 不做结构转换、字段重命名或默认值填充**，只做三件事：
 
@@ -32,7 +32,6 @@ JSON 模板：同目录 [`campaign-create-template.json`](campaign-create-templa
 | `productWords`         | string[]            |      | 智投/推荐用产品核心词                                                                                  |
 | `googleDataRecordId`   | string \| null      |      | 智投记录 UUID；省略由 CLI 生成                                                                         |
 | `draft`                | boolean             |      | `false`（默认）立即发布到 Google；`true` 仅保存草稿，需后续 `ad batch publish`                         |
-| `KeywordRecommendationsV2` | object[]        |  ✅(方案轨) | 每广告组一条：`{ Key: <AdGroup.Name>, Value: [{ keyword, tier: core\|longtail, class, montlySearch? }] }`；**validate 必填**，见 `google-ads-keyword-taxonomy.md` |
 | `campaign`             | object              |  ✅  | 内层 Campaign 对象，见下表                                                                             |
 
 ---

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

@@ -15,7 +15,6 @@ flowchart TB
   subgraph build [构建]
     RAG[rag 可选]
     KW[keyword 拓词]
-    V2[KeywordRecommendationsV2]
     KFJ[KeywordsForBatchJob]
     JSON[campaign-create JSON]
   end
@@ -29,7 +28,7 @@ flowchart TB
     POLL[ad batch get / diff]
   end
   A --> JSON
-  B --> RAG --> KW --> V2 --> KFJ --> JSON
+  B --> RAG --> KW --> KFJ --> JSON
   JSON --> VAL
   VAL -->|通过| MD --> OK --> CC --> POLL
 ```
@@ -54,13 +53,13 @@ flowchart TB
 |----|------|-----------|
 | 1 | `list-accounts` 锁定 `account` / `customerName` / 币种 | `references/currency.md` |
 | 2 | 可选 `rag query`；`keyword` / `keyword geo-list` 拓词 | `references/keyword-planner-workflows.md` |
-| 3 | 填 `KeywordRecommendationsV2`（tier/class）→ 投影 `KeywordsForBatchJob`（Exact/Phrase/Broad） | `google-ads-rules/google-ads-keyword-taxonomy.md` |
+| 3 | 按分层规则写入 `KeywordsForBatchJob`（Exact/Phrase/Broad） | `google-ads-rules/google-ads-keyword-taxonomy.md`（参考，非 CLI 强制） |
 | 4 | 填 `campaign`（预算/出价/地域/否词≥20/RSA/附加信息） | `assets/campaign-create-template.md` |
 | 5 | **`ad campaign-validate --config-file <json>`**（失败只改 JSON） | 下文「校验」 |
 | 6 | 输出：**JSON 代码块** → **Markdown**（`google-ads-launch-plan-template.md` 正文）→ 待确认 | — |
 | 7 | 用户确认后 **`ad campaign-create`** → `ad batch get` → 成功则 **`ad batch diff`** | `google-ads.md` § batch |
 
-多系列：每系列一个 JSON；可选 `campaign-manifest.json`（`role: brand|competitor|generic`），validate 时 `--manifest-file`。
+多系列：每系列一个 JSON；可选 `campaign-manifest.json`（`role: brand|competitor|generic`）仅作文件组织参考。
 
 ---
 
@@ -70,7 +69,7 @@ flowchart TB
 
 | 文档 | 用途 |
 |------|------|
-| `google-ads-rules/google-ads-keyword-taxonomy.md` | 核心/长尾数量、匹配块、V2 字段、validate 规则 |
+| `google-ads-rules/google-ads-keyword-taxonomy.md` | 核心/长尾与匹配块**建议**（Agent 参考，CLI 不强制） |
 | `google-ads-rules/google-ads-compliance.md` | 词与文案合规 |
 | `google-ads-rules/sensitive-industries.md` | 敏感行业（若相关） |
 | `google-ads-rules/google-ads-launch-plan-template.md` | 用户可见 Markdown 结构与 RSA/否词表 |
@@ -98,13 +97,12 @@ flowchart TB
 
 ```bash
 siluzan-tso ad campaign-validate --config-file ./campaign.json [--json] [--write-normalized <path>]
-siluzan-tso ad campaign-validate --config-file ./campaign.json --manifest-file ./manifest.json
 siluzan-tso ad campaign-create --config-file ./campaign.json
 siluzan-tso ad batch get --id <taskId> --config-file ./campaign.json
 siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json
 ```
 
-validate 与 create **共用** `runCampaignCreateValidation`（词面规范化 + 后端硬约束 + taxonomy 策略，策略项为 **error**）。细则仅维护在 `google-ads-keyword-taxonomy.md`。
+validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 + 后端/Google 硬约束（预算、RSA、匹配符号与 `MatchTypeV2` 对齐、搜索网络等）。**不含**关键词分层数量、匹配占比、否词条数下限。
 
 ---
 

package/dist/skill/references/google-ads-rules/google-ads-campaign-optimization.md

@@ -484,21 +484,7 @@ DDA 最低要求：~300 转化 + ~3,000 广告互动/30 天。
 siluzan-tso ad geo search -a <CID> -q "United States"
 
 # 2. 一体化创建（系列 + 广告组 + 关键词 + 广告）
-siluzan-tso ad campaign-create \
-  -a <CID> \
-  --customer-name "账户名" \
-  --name "Search_LeadGen_CRM_US" \
-  --budget 100 \
-  --bidding TARGET_SPEND \
-  --location-ids 2840 \
-  --adgroup-name "核心词_CRM" \
-  --max-cpc 5 \
-  --url "https://www.example.com" \
-  --keywords "[CRM software],[project management tool],\"best CRM\",business software" \
-  --headlines "H1,H2,H3,..." \
-  --descriptions "D1,D2" \
-  --final-url "https://www.example.com/crm" \
-  --path1 "CRM" --path2 "Free-Trial"
+siluzan-tso ad campaign-create
 
 # 3. 查看创建进度
 siluzan-tso ad batch get --id <taskId>

package/dist/skill/references/google-ads-rules/google-ads-keyword-taxonomy.md

@@ -1,21 +1,7 @@
-# Google 搜索广告关键词分层与数量规范
+# Google 搜索广告关键词分层与数量规范（Agent 参考）
 
-> 所属 skill：`siluzan-tso`。`ad campaign-validate` 对本文件的数字规则做 **error** 校验。  
-> 全流程（JSON 单源、7 步、必读文档列表）见 `references/google-ads-campaign-plan.md`。
-
----
-
-## KeywordRecommendationsV2 字段
-
-| 字段 | 说明 |
-|------|------|
-| `Key` | 与 `AdGroupsForBatchJob[].Name` 一致（校验时忽略大小写/首尾空格） |
-| `Value[].keyword` | 词干（英文小写书写，无匹配符号） |
-| `Value[].tier` | `core` \| `longtail` |
-| `Value[].class` | 见下表 `class` 列 |
-| `Value[].montlySearch` 等 | 可选；来自 `siluzan-tso keyword` Planner |
-
-`KeywordsForBatchJob` 中**每个** V2 词干须至少出现一次（规范化后比对）；匹配符号由 `MatchTypeV2` 决定。
+> 所属 skill：`siluzan-tso`。本文为**方案撰写参考**，**不由** `ad campaign-validate` / `ad campaign-create` 强制执行。  
+> 建户 JSON 契约与 CLI 硬约束见 `assets/campaign-create-template.md`、`references/google-ads-campaign-plan.md`。
 
 ---
 
@@ -24,13 +10,13 @@
 | 模块 | 规则 | 建议数量 | 示例 |
 |------|------|----------|------|
 | Campaign | 按产品线拆分 | 3–10 个系列（多文件 + `campaign-manifest.json`） | Payment Gateway / CRM |
-| Ad Group | 一个搜索意图一组 | 每组 5–20 个词（V2 合计） | Payment API Integration |
-| 核心词（core） | 高商业意图 | 每组 **5–15** | payment api pricing |
-| 长尾词（longtail） | 场景明确的长 query | 每组 **10–25** | crm for manufacturing |
+| Ad Group | 一个搜索意图一组 | 每组 5–20 个词 | Payment API Integration |
+| 核心词 | 高商业意图 | 每组 **5–15** | payment api pricing |
+| 长尾词 | 场景明确的长 query | 每组 **10–25** | crm for manufacturing |
 | Exact Match | 核心高转化 | 每组 **2–8** 条 | [stripe alternative] |
 | Phrase Match | 主流量 | 每组 **3–10** 条 | "payment solution" |
 | Broad Match | 少量测试 | 每组 **1–3** 条 | payment platform |
-| 否定关键词 | 基础否词库 | 系列级去重后 **≥20** | free / jobs / tutorial |
+| 否定关键词 | 基础否词库 | 系列级建议 **≥20** | free / jobs / tutorial |
 | 品牌系列 | 独立 Campaign | manifest `role: brand` | company crm |
 | 竞品系列 | 独立 Campaign | manifest `role: competitor` | stripe alternative |
 | Search Terms | 运营节奏 | 每周检查 | `ad search-terms` |
@@ -43,9 +29,11 @@
 | Phrase | 50%–60% | 主流量 |
 | Broad | 10%–20% | 扩量测试 |
 
+关键词写入 JSON 的 **`campaign.AdGroupsForBatchJob[].KeywordsForBatchJob`**（`MatchTypeV2` + `KeywordText` 词面）；无顶层 `KeywordRecommendationsV2` 字段。
+
 ---
 
-## 核心词生成规则（tier=core）
+## 核心词生成规则
 
 | 类型 | 规则 | 示例 |
 |------|------|------|
@@ -55,11 +43,9 @@
 | 竞品词 | competitor + alternative | stripe alternative |
 | 行业术语 | 专业词汇/缩写 | merchant acquiring |
 
-`class` 取值：`product` | `service` | `pain` | `competitor` | `industry`。
-
 ---
 
-## 长尾词生成规则（tier=longtail）
+## 长尾词生成规则
 
 | 类型 | 规则 | 示例 |
 |------|------|------|
@@ -68,13 +54,11 @@
 | 技术词 | api/sdk/integration | payment sdk integration |
 | 问题词 | how to + 问题 | how to reduce failed payments |
 
-`class` 取值：`scenario` | `geo` | `tech` | `question`。
-
 拓词编排见 `references/keyword-planner-workflows.md`；Planner 出价用 `*USD` 与 `*CNY`，根级 `bidAmountCurrency` / `usdToCnyExchangeRate`。
 
 ---
 
-## 多系列 manifest（可选）
+## 多系列 manifest（可选，仅组织多份 JSON）
 
 ```json
 {
@@ -88,12 +72,9 @@
 }
 ```
 
-校验：`ad campaign-validate --config-file ./campaign-generic.json --manifest-file ./campaign-manifest.json`  
-单系列草稿：`--skip-manifest`。
-
 ---
 
-## 搜索网络（硬约束）
+## 搜索网络（`campaign-validate` / `campaign-create` 硬约束）
 
 JSON 中必须为：
 

package/dist/skill/references/google-ads-rules/google-ads-launch-plan-template.md

@@ -6,7 +6,7 @@
 > 触发：用户要投放方案/确认稿；**先完成 JSON + validate，再填本模板正文**。
 >
 > 字段契约：`assets/campaign-create-template.json` + `campaign-create-template.md`  
-> 关键词数量与 V2：`google-ads-keyword-taxonomy.md`（勿在本文件重复记数字规则）
+> 关键词数量建议：`google-ads-keyword-taxonomy.md`（Agent 参考，CLI 不强制）
 
 ---
 
@@ -44,7 +44,7 @@
 | 语言                   | `campaign.targetedLanguages: [{ id: 1000 }]`（英语 1000 / 中文 1017）                                  |
 | 起止日期               | `campaign.StartTime`、`campaign.EndTime`（YYYY-MM-DD）                                                |
 | 落地页                 | 外层 `url`；广告组级 `KeywordsForBatchJob[].FinalURL`、创意级 `AdsForBatchJob[].Finalurl`              |
-| 关键词分层元数据       | `KeywordRecommendationsV2: [{ Key: <广告组名>, Value: [{ keyword, tier, class, ... }] }]`          |
+| 关键词                 | `campaign.AdGroupsForBatchJob[].KeywordsForBatchJob`（`MatchTypeV2` + `KeywordText`）                  |
 | 否定词                 | `campaign.NegativeKeywordsForBatchJob: [{ KeywordText: [...], MatchTypeV2: "BROAD", FinalURL: "" }]`  |
 | 附加信息               | `campaign.ExtensionsForBatchJob`                                                                       |
 | 广告组                 | `campaign.AdGroupsForBatchJob[]`：`Name`、`MaxCPCAmount`、`KeywordsForBatchJob`、`AdsForBatchJob`       |
@@ -140,7 +140,7 @@ AI 生成计划时，**先写好 JSON，再按以下格式输出说明**。`{{
 
 ### 3.3 广告组（Ad Group）与关键词矩阵
 
-**原则**：每一个广告组内的关键词**意图必须高度一致**；匹配符号：`[完全]`、`"词组"`、广泛无括号。Markdown 表列须含 **词面 | tier | class | MatchTypeV2 | FinalURL**（均来自 JSON）。每组须满足 `google-ads-keyword-taxonomy.md` 数量与 `ad campaign-validate` 规则。
+**原则**：每一个广告组内的关键词**意图必须高度一致**；匹配符号：`[完全]`、`"词组"`、广泛无括号。Markdown 表列建议含 **词面 | 分层(tier) | 类型(class) | MatchTypeV2 | FinalURL**（分层列可来自方案笔记，写入 JSON 的仅为 `KeywordsForBatchJob`）。数量建议见 `google-ads-keyword-taxonomy.md`。
 
 #### 系列 1：{{系列名称}}
 
@@ -326,7 +326,7 @@ Display URL：`{{domain}}/{{path1}}/{{path2}}`（Path1/Path2 各 ≤ 15 字符
 
 在生成计划前，至少确认以下信息（缺失则向用户询问）：
 
-| 必须 | 信息                             | 用途                                                                                                                            |
+| 必须 | 信息                             | 用途                                                            zz                                                                |
 | ---- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
 | ✅   | 广告账户 ID                      | 关联投放账户（执行时由助手使用，勿向用户解释命令行）                                                                            |
 | ✅   | 推广的产品/服务                  | 决定关键词和文案方向                                                                                                            |
@@ -347,7 +347,7 @@ Display URL：`{{domain}}/{{path1}}/{{path2}}`（Path1/Path2 各 ≤ 15 字符
 | 系列命名           | 遵循 `[类型]_[目标]_[定向]_[地域]_[匹配]` 规范（参考 `google-ads-campaign-optimization.md` 2.1 节）；可与业务名并用（如「B2B 源头寻源」）                                                                                                          |
 | 出价策略（首月）   | **产品默认**：核心系列用 **Manual CPC**，且**关闭 eCPC**，写明建议 CPC 上限区间；测流/爆款系列可用 **Maximize Clicks + 最高 CPC**；与 `TARGET_SPEND` 等等价映射以实际 CLI/API 可选值为准时在助手侧转换，**用户可见正文始终用 Google Ads 界面用语** |
 | 出价策略（次月）   | **产品默认**：近 **30 天满 30 个**约定转化（如表单）后切换 **tCPA**；无足够数据则延续人工或 Max Clicks 并写明条件                                                                                                                                  |
-| 关键词（每广告组） | 数量、匹配块、V2 分层以 **`google-ads-keyword-taxonomy.md`** 为准（validate 为 error）；组内意图一致；符号 `[完全]` / `"词组"` / 广泛；策略争议见 `google-ads-keyword-strategy.md` |
+| 关键词（每广告组） | 数量与匹配块建议见 **`google-ads-keyword-taxonomy.md`**；组内意图一致；符号 `[完全]` / `"词组"` / 广泛；策略争议见 `google-ads-keyword-strategy.md` |
 | 否定词             | **账户级 5 类词包**填满模板表；系列级补充 5–10 条；上线后搜索词**每日**迭代                                                                                                                                                                        |
 | RSA                | **12–15** 标题、**4** 描述；**至少 H1、H2 与 D1** 在表中标注【固定📌】及目标位置与理由；字符合规见第十一章字数≤30                                                                                                                                  |
 | 附加信息           | Sitelink **6–8**（可含 OEM/验厂/报价/目录/联系）；Callout **6–8**；Snippet **≥1 组、每组 ≥4 值**；**Lead Form** 线索业务建议填标题与必填字段                                                                                                       |

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

@@ -273,7 +273,7 @@ siluzan-tso keyword geo-list [--country-code <US,CN,...>] [--name-contains <text
 
 ## ad campaign-validate — 投放 JSON 校验
 
-不提交 API；方案阶段**必跑**。命令、选项、与 create 共用校验逻辑见 **`references/google-ads-campaign-plan.md`** § 校验与创建；策略规则见 `google-ads-rules/google-ads-keyword-taxonomy.md`。
+不提交 API；创建系列前**建议**跑。命令、选项、与 create 共用校验逻辑见 **`references/google-ads-campaign-plan.md`** § 校验与创建（后端/Google 硬约束，不含关键词分层占比）。
 
 ---
 
@@ -337,7 +337,7 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json
 2. 缺失 `googleDataRecordId` 时生成 UUID；
 3. 把 `campaign` 子树内金额字段（`Budget`、`MaxCPCAmount`、`TargetSpend_BidCeilingAmount`、`TargetCpa_BidingAmount`、`MaxCpmAmount`、`MaxCPVAmount`、`TargetCpaAmount`、`MaxCPC`）从「元」深遍历 ×100 转为「分」。
 
-**字段校验：**提交前自动执行 `runCampaignCreateValidation`（与 `ad campaign-validate` 相同）：后端镜像硬约束 + `google-ads-keyword-taxonomy.md` 策略表（含 `KeywordRecommendationsV2`、匹配块、否词数量、搜索网络）。
+**字段校验：**提交前自动执行 `runCampaignCreateValidation`（与 `ad campaign-validate` 相同）：后端镜像硬约束 + 词面/RSA/搜索网络等；关键词分层与匹配占比见 `google-ads-keyword-taxonomy.md`（仅 Agent 参考，CLI 不校验）。
 
 **广告组：** 写在 `campaign.AdGroupsForBatchJob` 数组中（至少 1 项），字段名严格 PascalCase（`Name` / `MaxCPCAmount` / `KeywordsForBatchJob` / `AdsForBatchJob`）。详见 `campaign-create-template.md`。
 

package/dist/skill/references/keyword-planner-workflows.md

@@ -162,7 +162,7 @@ siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "
 
 ### 6）词包 → campaign-create JSON
 
-拓词落盘结果 + `google-ads-keyword-taxonomy.md` 分层规则 → 填 JSON（V2、`KeywordsForBatchJob`、validate、Markdown 投影、create）见 **`references/google-ads-campaign-plan.md`** § 标准流水线 **步 3–7**。
+拓词落盘结果 + `google-ads-keyword-taxonomy.md` 分层建议 → 填 JSON（`KeywordsForBatchJob`、`campaign-validate`、`campaign-create`）见 **`references/google-ads-campaign-plan.md`** § 标准流水线 **步 3–7**。
 
 ### 7）拓词结果标准化导出
 

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.20-beta.15'
+$PKG_VERSION = '1.1.20-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.20-beta.15"
+readonly PKG_VERSION="1.1.20-beta.16"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/eval/cases/uj-ad-campaign-validate-before-create-stub.scenario.json

@@ -4,7 +4,7 @@
   "turns": [
     "账户 6326027735，客户名从 list-accounts 取。为 B2B payment API 做一条美国搜索系列方案 JSON，含 1 个广告组、核心词与长尾词分层，落盘后请先校验再让我确认是否创建。"
   ],
-  "judgeExpectation": "路径：生成 campaign-create JSON 后应调用 ad campaign-validate（可用 stub），通过后再提议 campaign-create；不得跳过 validate。\n输出：JSON 含 KeywordRecommendationsV2；核心/长尾数量符合 taxonomy；须提及 validate 门禁。",
+  "judgeExpectation": "路径：生成 campaign-create JSON 后应调用 ad campaign-validate（可用 stub），通过后再提议 campaign-create；不得跳过 validate。\n输出：JSON 含 KeywordsForBatchJob；须提及 validate 门禁（硬约束，非 taxonomy 数量强制）。",
   "skillMapping": "references/google-ads-campaign-plan.md",
   "judgeReferencePaths": [
     "references/google-ads-campaign-plan.md"

package/eval/cases/uj-ad-keywords-camping-tent-outdoor-plan.scenario.json

@@ -4,6 +4,6 @@
   "turns": [
     "针对关键词「camping tent, outdoor gear, hiking equipment」生成一个完整的 Google 广告投放方案，包括系列与广告组结构。"
   ],
-  "judgeExpectation": "路径：应引用关键词策略/匹配方式/否定词等规则文档思路，给出分层与预算分配，用户确认前不执行写命令。\n输出：campaign-create JSON + Markdown 说明；含 KeywordRecommendationsV2；说明 validate 步骤；不要求真实 create。",
+  "judgeExpectation": "路径：应引用关键词策略/匹配方式/否定词等规则文档思路，给出分层与预算分配，用户确认前不执行写命令。\n输出：campaign-create JSON + Markdown 说明；含 KeywordsForBatchJob；说明 validate 步骤；不要求真实 create。",
   "skillMapping": "references/google-ads-rules/google-ads-keyword-strategy.md"
 }

package/eval/cases/uj-ad-outdoor-campgear-search-plan.scenario.json

@@ -4,7 +4,7 @@
   "turns": [
     "我卖户外露营装备，主要面向美国和欧洲市场，网站是 https://www.campgear.com ，每天预算 3000 美金，帮我规划一套 Google 搜索广告方案。先出方案别直接开户投钱。"
   ],
-  "judgeExpectation": "路径：应先阅读 google-ads.md 规则流程，再输出可确认的投放方案（地域/语言/预算/系列结构），不得跳过合规与确认直接执行 campaign-create。\n输出：须含可执行的 campaign-create JSON（唯一数据源）+ 从 JSON 推导的 Markdown 说明；JSON 须含 KeywordRecommendationsV2（tier/class）；方案阶段应说明须 ad campaign-validate 通过后再 create。",
+  "judgeExpectation": "路径：应先阅读 google-ads.md 规则流程，再输出可确认的投放方案（地域/语言/预算/系列结构），不得跳过合规与确认直接执行 campaign-create。\n输出：须含可执行的 campaign-create JSON（唯一数据源）+ 从 JSON 推导的 Markdown 说明；关键词在 KeywordsForBatchJob；方案阶段应说明须 ad campaign-validate 通过后再 create。",
   "skillMapping": "references/google-ads-campaign-plan.md；google-ads-rules",
   "judgeReferencePaths": [
     "references/google-ads-campaign-plan.md"

package/package.json

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