siluzan-tso-cli 1.1.20-beta.21 → 1.1.20-beta.22

package/README.md

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

package/dist/index.js

@@ -2418,12 +2418,12 @@ function createVersionNotifier(opts) {
   const HOURS_24 = 24 * 60 * 60 * 1e3;
   const TTL_MAIN_TAG_MS = 60 * 60 * 1e3;
   const TTL_MIN_REQUIRED_MS = HOURS_24;
-  async function fetchVersionByTag(tag, cacheKey2, fetchAtKey, cfg, maxAgeMs) {
+  async function fetchVersionByTag(tag, cacheKey, fetchAtKey, cfg, maxAgeMs) {
     const lastAt = cfg[fetchAtKey];
-    if (typeof lastAt === "string" && cacheKey2 in cfg) {
+    if (typeof lastAt === "string" && cacheKey in cfg) {
       const lastMs = new Date(lastAt).getTime();
       if (Date.now() - lastMs < maxAgeMs) {
-        const v = cfg[cacheKey2];
+        const v = cfg[cacheKey];
         const sv = typeof v === "string" && v ? v : null;
         return { version: sv, hitNetwork: false };
       }
@@ -109480,6 +109480,31 @@ init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
 
+// src/commands/ad/campaign-length-violations.ts
+function pushLengthViolation(violations, item) {
+  violations.push({ ...item, excess: item.actual - item.limit });
+}
+function formatLengthViolationsReport(violations) {
+  if (violations.length === 0) return "";
+  const lines = [
+    "",
+    `\u{1F4CF} \u8D85\u957F\u5185\u5BB9\u6E05\u5355\uFF08\u5171 ${violations.length} \u9879\uFF09`,
+    "   \u8BF7\u52FF\u5728 JSON \u4E2D\u81EA\u52A8\u622A\u65AD\uFF1B\u8BF7\u5C06\u5168\u90E8\u6761\u76EE\u4E0E\u4FEE\u6539\u65B9\u6848\u5217\u7ED9\u7528\u6237\uFF0C\u786E\u8BA4\u540E\u518D\u6539 JSON \u5E76\u91CD\u65B0 campaign-validate\u3002",
+    ""
+  ];
+  for (let i = 0; i < violations.length; i++) {
+    const v = violations[i];
+    const mode = v.countMode === "google" ? "Google \u5B57\u7B26\u5BBD\uFF08CJK\xD72\uFF09" : "\u5B57\u7B26\u6570";
+    lines.push(
+      `   ${i + 1}. ${v.path}`,
+      `      \u5B57\u6BB5 ${v.field} \xB7 \u4E0A\u9650 ${v.limit} \xB7 \u5F53\u524D ${v.actual}\uFF08${mode}\uFF0C\u8D85\u51FA ${v.excess}\uFF09`,
+      `      \u539F\u6587\uFF1A${JSON.stringify(v.text)}`
+    );
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
 // src/commands/ad/campaign-extensions.ts
 var SITELINK_DESCRIPTION_MAX_LEN = 25;
 function pushErr(errors, msg) {
@@ -109506,12 +109531,11 @@ function coercePropertiesFromRaw(raw) {
   return props;
 }
 function normalizeSitelinkProperties(props) {
-  const trimSitelinkDesc = (s) => s.length <= SITELINK_DESCRIPTION_MAX_LEN ? s : `${s.slice(0, SITELINK_DESCRIPTION_MAX_LEN - 1)}\u2026`;
   if (props.LinkText && !props.Text) props.Text = props.LinkText;
   const d1 = props.Description1 ?? props.Line2 ?? props.Text ?? props.LinkText;
   const d2 = props.Description2 ?? props.Line3;
-  props.Line2 = trimSitelinkDesc((d1 ?? "").trim() || props.Text || " ");
-  props.Line3 = trimSitelinkDesc((d2 ?? "").trim() || props.Line2);
+  props.Line2 = (d1 ?? "").trim() || props.Text || " ";
+  props.Line3 = (d2 ?? "").trim() || props.Line2;
   delete props.LinkText;
   delete props.Description1;
   delete props.Description2;
@@ -109530,7 +109554,7 @@ function normalizeExtensionsForBatchJob(extensions) {
     return out;
   });
 }
-function validateSitelinkProperties(prefix, raw, errors, warnings) {
+function validateSitelinkProperties(prefix, raw, errors, warnings, lengthViolations) {
   if (Array.isArray(raw["FinalUrls"])) {
     pushErr(
       errors,
@@ -109559,15 +109583,33 @@ function validateSitelinkProperties(prefix, raw, errors, warnings) {
   const line2Raw = props.Description2 ?? props.Line3;
   const line2 = typeof line2Raw === "string" ? line2Raw.trim() : "";
   if (line1.length > SITELINK_DESCRIPTION_MAX_LEN) {
+    pushLengthViolation(lengthViolations, {
+      path: `${prefix}.Properties`,
+      field: "Description1/Line2",
+      kind: "sitelink_description",
+      limit: SITELINK_DESCRIPTION_MAX_LEN,
+      actual: line1.length,
+      countMode: "ascii",
+      text: line1
+    });
     pushErr(
       errors,
-      `${prefix}.Properties \u63CF\u8FF0\u884C 1 \u8D85\u8FC7 ${SITELINK_DESCRIPTION_MAX_LEN} \u5B57\u7B26\uFF08\u5F53\u524D ${line1.length}\uFF09\uFF1A"${line1.slice(0, 40)}${line1.length > 40 ? "\u2026" : ""}"`
+      `${prefix}.Properties \u63CF\u8FF0\u884C 1 \u8D85\u8FC7 ${SITELINK_DESCRIPTION_MAX_LEN} \u5B57\u7B26\uFF08\u5F53\u524D ${line1.length}\uFF09\uFF1A"${line1}"`
     );
   }
   if (line2.length > SITELINK_DESCRIPTION_MAX_LEN) {
+    pushLengthViolation(lengthViolations, {
+      path: `${prefix}.Properties`,
+      field: "Description2/Line3",
+      kind: "sitelink_description",
+      limit: SITELINK_DESCRIPTION_MAX_LEN,
+      actual: line2.length,
+      countMode: "ascii",
+      text: line2
+    });
     pushErr(
       errors,
-      `${prefix}.Properties \u63CF\u8FF0\u884C 2 \u8D85\u8FC7 ${SITELINK_DESCRIPTION_MAX_LEN} \u5B57\u7B26\uFF08\u5F53\u524D ${line2.length}\uFF09\uFF1A"${line2.slice(0, 40)}${line2.length > 40 ? "\u2026" : ""}"`
+      `${prefix}.Properties \u63CF\u8FF0\u884C 2 \u8D85\u8FC7 ${SITELINK_DESCRIPTION_MAX_LEN} \u5B57\u7B26\uFF08\u5F53\u524D ${line2.length}\uFF09\uFF1A"${line2}"`
     );
   }
   const rawDesc2 = raw["Description2"];
@@ -109581,7 +109623,7 @@ function validateSitelinkProperties(prefix, raw, errors, warnings) {
     );
   }
 }
-function validateCampaignExtensionsForBatchJob(campaign, errors, warnings) {
+function validateCampaignExtensionsForBatchJob(campaign, errors, warnings, lengthViolations = []) {
   const extensions = campaign["ExtensionsForBatchJob"];
   if (extensions === void 0) return;
   if (!Array.isArray(extensions)) {
@@ -109603,7 +109645,13 @@ function validateCampaignExtensionsForBatchJob(campaign, errors, warnings) {
       continue;
     }
     if (type === "SITELINK" && props && typeof props === "object") {
-      validateSitelinkProperties(prefix, props, errors, warnings);
+      validateSitelinkProperties(
+        prefix,
+        props,
+        errors,
+        warnings,
+        lengthViolations
+      );
     } else if (type === "SITELINK") {
       pushErr(errors, `${prefix}\uFF08SITELINK\uFF09\u7F3A\u5C11 Properties`);
     }
@@ -109651,6 +109699,11 @@ function firstKeywordTextFromRecord(k) {
   }
   return "";
 }
+function keywordRowToYuan(item) {
+  const { maxCPC: rawMaxCpc, ...rest } = item;
+  if (rawMaxCpc == null) return item;
+  return { ...rest, maxCPCYuan: toDisplayMoney(rawMaxCpc) };
+}
 async function runAdKeywords(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
@@ -109678,8 +109731,9 @@ async function runAdKeywords(opts) {
   });
   const label = opts.negative ? "\u5426\u5B9A\u5173\u952E\u8BCD" : "\u5173\u952E\u8BCD";
   const n = items.length;
+  const displayItems = opts.negative ? items : items.map((row) => keywordRowToYuan(row));
   const kwPayload = stripLegacyGoogleFieldsIfV2Present(
-    wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+    wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: displayItems })
   );
   if (await emitCliJsonOrSnapshot(opts, {
     section: `ad-keywords-${opts.account}-${opts.negative ? "negative" : "positive"}`,
@@ -109870,7 +109924,7 @@ async function runAdKeywordEdit(opts) {
   } else if (opts.text !== void 0) {
     body["keywordText"] = [opts.text];
   }
-  if (opts.maxCpc !== void 0) body["maxCPC"] = opts.maxCpc;
+  if (opts.maxCpc !== void 0) body["maxCPC"] = toCentAmount(opts.maxCpc);
   if (opts.finalUrl !== void 0) body["finalURL"] = opts.finalUrl;
   if (opts.status !== void 0) body["userStatusV2"] = opts.status;
   const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
@@ -110040,15 +110094,26 @@ function inferMatchTypeFromDisplayText(text) {
   if (t.length >= 2 && t.startsWith("[") && t.endsWith("]")) return "Exact";
   return "Broad";
 }
-function validateKeywordCore(core, path22, errors) {
+function validateKeywordCore(core, path22, errors, lengthViolations) {
   const trimmed = core.trim();
   if (!trimmed) {
     errors.push(`${path22} \u5173\u952E\u8BCD\u8BCD\u5E72\u4E0D\u80FD\u4E3A\u7A7A`);
     return false;
   }
   if (trimmed.length > GOOGLE_KEYWORD_MAX_CORE_LENGTH) {
+    if (lengthViolations) {
+      pushLengthViolation(lengthViolations, {
+        path: path22,
+        field: "KeywordText",
+        kind: "keyword_core",
+        limit: GOOGLE_KEYWORD_MAX_CORE_LENGTH,
+        actual: trimmed.length,
+        countMode: "ascii",
+        text: trimmed
+      });
+    }
     errors.push(
-      `${path22} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed.slice(0, 40)}${trimmed.length > 40 ? "\u2026" : ""}"`
+      `${path22} \u5173\u952E\u8BCD\u8BCD\u5E72\u8D85\u8FC7 ${GOOGLE_KEYWORD_MAX_CORE_LENGTH} \u5B57\u7B26\uFF08\u5F53\u524D ${trimmed.length}\uFF09\uFF1A"${trimmed}"`
     );
     return false;
   }
@@ -110066,7 +110131,7 @@ function normalizeKeywordSurface(raw, matchTypeV2) {
   const formatted = formatKeywordTextForMatchType(raw, matchType);
   return { formatted, matchType, inferredMatchType: fromField === null };
 }
-function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings) {
+function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings, lengthViolations) {
   const texts = block["KeywordText"];
   if (!Array.isArray(texts)) return;
   const declaredUi = matchTypeV2ToUi(block["MatchTypeV2"]);
@@ -110100,7 +110165,8 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings) {
       warnings.push(`${path22}.KeywordText[${k}] \u8BCD\u9762\u5DF2\u89C4\u8303\u5316\uFF1A${trimmedRaw} \u2192 ${formatted}`);
     }
     const core = unwrapKeywordDisplayTextForEdit(formatted);
-    if (!validateKeywordCore(core, `${path22}.KeywordText[${k}]`, errors)) continue;
+    if (!validateKeywordCore(core, `${path22}.KeywordText[${k}]`, errors, lengthViolations))
+      continue;
     const dedupeKey = `${matchTypeUiToV2(matchType)}:${core.toLowerCase()}`;
     if (seen.has(dedupeKey)) {
       warnings.push(`${path22}.KeywordText[${k}] \u4E0E\u540C\u7EC4\u91CD\u590D\uFF0C\u5DF2\u8DF3\u8FC7\uFF1A${formatted}`);
@@ -110118,7 +110184,7 @@ function normalizeKeywordsForBatchJobBlock(block, path22, errors, warnings) {
     block["MatchTypeV2"] = matchTypeUiToV2(resolvedUi);
   }
 }
-function normalizeCampaignKeywordTrees(campaign, errors, warnings) {
+function normalizeCampaignKeywordTrees(campaign, errors, warnings, lengthViolations) {
   const neg = campaign["NegativeKeywordsForBatchJob"];
   if (Array.isArray(neg)) {
     for (let i = 0; i < neg.length; i++) {
@@ -110129,7 +110195,8 @@ function normalizeCampaignKeywordTrees(campaign, errors, warnings) {
           block,
           `campaign.NegativeKeywordsForBatchJob[${i}]`,
           errors,
-          warnings
+          warnings,
+          lengthViolations
         );
       }
     }
@@ -110147,7 +110214,8 @@ function normalizeCampaignKeywordTrees(campaign, errors, warnings) {
           block,
           `campaign.AdGroupsForBatchJob[${i}].KeywordsForBatchJob[${j}]`,
           errors,
-          warnings
+          warnings,
+          lengthViolations
         );
       }
     }
@@ -110265,7 +110333,7 @@ function calcGoogleCharLength(text) {
   }
   return len;
 }
-function validateRsaDisplayPath(prefix, ad, errors) {
+function validateRsaDisplayPath(prefix, ad, errors, lengthViolations) {
   const jsonHint = `\u5728 ${prefix} \u589E\u52A0 "Path1"\u3001"Path2"\uFF08PascalCase\uFF0C\u52FF\u7528 path1/path2\uFF1B\u6A21\u677F\u89C1 assets/campaign-create-template.json\uFF09`;
   if (ad["path1"] !== void 0 && ad["Path1"] === void 0) {
     pushErr2(
@@ -110307,6 +110375,15 @@ function validateRsaDisplayPath(prefix, ad, errors) {
     }
     const len = calcGoogleCharLength(raw);
     if (len > 15) {
+      pushLengthViolation(lengthViolations, {
+        path: `${prefix}.${field}`,
+        field,
+        kind: "rsa_path",
+        limit: 15,
+        actual: len,
+        countMode: "google",
+        text: raw
+      });
       pushErr2(
         errors,
         `${prefix}.${field} \u8D85\u8FC7 15 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u6309 2 \u8BA1\uFF09\uFF1A"${raw}"`
@@ -110320,7 +110397,7 @@ function validateRsaDisplayPath(prefix, ad, errors) {
     }
   }
 }
-function validateRsaAd(prefix, ad, errors, warnings) {
+function validateRsaAd(prefix, ad, errors, warnings, lengthViolations) {
   const h1 = ad["headlinePart1"];
   const h2 = ad["headlinePart2"];
   const h3 = ad["headlinePart3"];
@@ -110341,12 +110418,28 @@ function validateRsaAd(prefix, ad, errors, warnings) {
   } else if (headlines.length < 12) {
     pushWarn2(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`);
   }
+  const headlineFields = [
+    "headlinePart1",
+    "headlinePart2",
+    "headlinePart3",
+    ...moreH.map((_, idx) => `AddtionalHeadlines[${idx}]`)
+  ];
   for (let i = 0; i < headlines.length; i++) {
     const len = calcGoogleCharLength(headlines[i]);
     if (len > 30) {
+      const field = headlineFields[i] ?? `headline[${i}]`;
+      pushLengthViolation(lengthViolations, {
+        path: `${prefix}.${field}`,
+        field,
+        kind: "rsa_headline",
+        limit: 30,
+        actual: len,
+        countMode: "google",
+        text: headlines[i]
+      });
       pushErr2(
         errors,
-        `${prefix} \u6807\u9898[${i}] \u8D85\u8FC7 30 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A"${headlines[i].slice(0, 30)}"`
+        `${prefix} \u6807\u9898[${i}] \u8D85\u8FC7 30 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A"${headlines[i]}"`
       );
     }
   }
@@ -110360,13 +110453,28 @@ function validateRsaAd(prefix, ad, errors, warnings) {
   } else if (descriptions.length < 4) {
     pushWarn2(warnings, `${prefix} \u63CF\u8FF0\u63A8\u8350 4 \u6761\uFF08\u5F53\u524D ${descriptions.length} \u6761\uFF09`);
   }
+  const descriptionFields = [
+    "adDescription",
+    "adDescription2",
+    ...moreD.map((_, idx) => `AddtionalAdDescriptions[${idx}]`)
+  ];
   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)}"`);
+      const field = descriptionFields[i] ?? `description[${i}]`;
+      pushLengthViolation(lengthViolations, {
+        path: `${prefix}.${field}`,
+        field,
+        kind: "rsa_description",
+        limit: 90,
+        actual: len,
+        countMode: "google",
+        text: descriptions[i]
+      });
+      pushErr2(errors, `${prefix} \u63CF\u8FF0[${i}] \u8D85\u8FC7 90 \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF09\uFF1A"${descriptions[i]}"`);
     }
   }
-  validateRsaDisplayPath(prefix, ad, errors);
+  validateRsaDisplayPath(prefix, ad, errors, lengthViolations);
   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}`);
@@ -110376,8 +110484,14 @@ function validateRsaAd(prefix, ad, errors, warnings) {
 function validateCampaignCreateConfigCore(cfg) {
   const errors = [];
   const warnings = [];
+  const lengthViolations = [];
   if (cfg.campaign && typeof cfg.campaign === "object" && !Array.isArray(cfg.campaign)) {
-    normalizeCampaignKeywordTrees(cfg.campaign, errors, warnings);
+    normalizeCampaignKeywordTrees(
+      cfg.campaign,
+      errors,
+      warnings,
+      lengthViolations
+    );
   }
   if (!cfg.account?.toString().trim()) {
     pushErr2(errors, "account\uFF08\u9876\u5C42 customerId\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
@@ -110391,7 +110505,7 @@ function validateCampaignCreateConfigCore(cfg) {
   }
   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");
-    return { errors, warnings };
+    return { errors, warnings, lengthViolations };
   }
   const campaign = cfg.campaign;
   if (campaign["TargetPartnerSearchNetwork"] === true) {
@@ -110554,7 +110668,7 @@ function validateCampaignCreateConfigCore(cfg) {
         for (let j = 0; j < ads.length; j++) {
           const ad = ads[j];
           if (ad && typeof ad === "object") {
-            validateRsaAd(`${gPrefix}.AdsForBatchJob[${j}]`, ad, errors, warnings);
+            validateRsaAd(`${gPrefix}.AdsForBatchJob[${j}]`, ad, errors, warnings, lengthViolations);
           }
         }
       }
@@ -110571,8 +110685,8 @@ function validateCampaignCreateConfigCore(cfg) {
     }
     validateCampaignRsaCrossGroupHeadlines(campaign, errors);
   }
-  validateCampaignExtensionsForBatchJob(campaign, errors, warnings);
-  return { errors, warnings };
+  validateCampaignExtensionsForBatchJob(campaign, errors, warnings, lengthViolations);
+  return { errors, warnings, lengthViolations };
 }
 function runCampaignCreateValidation(cfg) {
   return validateCampaignCreateConfigCore(cfg);
@@ -113146,46 +113260,53 @@ async function runAiCreationUpdate(opts) {
 
 // src/commands/ad/campaign-validate.ts
 import { writeFileSync as writeFileSync3 } from "fs";
+init_cli_json_snapshot();
+var LENGTH_VIOLATION_AGENT_HINT = "\u52FF\u81EA\u52A8\u622A\u65AD JSON\u3002\u8BFB\u53D6\u843D\u76D8 JSON \u7684 lengthViolations\uFF0C\u5C06\u5168\u90E8\u6761\u76EE\u4E0E\u4FEE\u6539\u65B9\u6848\u5217\u7ED9\u7528\u6237\uFF0C\u786E\u8BA4\u540E\u5199\u5165 campaign.json \u5E76\u91CD\u65B0 campaign-validate\u3002";
 async function runAdCampaignValidate(opts) {
   const cfg = loadCampaignCreateConfig(opts.configFile);
-  const { errors, warnings } = runCampaignCreateValidation(cfg);
+  const { errors, warnings, lengthViolations } = runCampaignCreateValidation(cfg);
   if (opts.writeNormalized) {
     const toWrite = stripMetaKeysForExport(cfg);
     writeFileSync3(opts.writeNormalized, `${JSON.stringify(toWrite, null, 2)}
 `, "utf8");
   }
-  if (opts.json) {
-    console.log(
-      JSON.stringify(
-        {
-          ok: errors.length === 0,
-          errors,
-          warnings
-        },
-        null,
-        2
-      )
-    );
-  } else {
-    if (warnings.length > 0) {
-      console.warn("\n\u26A0\uFE0F  \u6295\u653E\u914D\u7F6E\u8B66\u544A\uFF1A");
-      for (const w of warnings) console.warn(`   \u2022 ${w}`);
-    }
-    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();
-      process.exit(1);
-    }
-    console.log("\n\u2705 \u6295\u653E\u914D\u7F6E\u6821\u9A8C\u901A\u8FC7");
-    if (opts.writeNormalized) {
-      console.log(`   \u5DF2\u5199\u5165\u89C4\u8303\u5316 JSON\uFF1A${opts.writeNormalized}`);
-    }
-    console.log();
+  const payload = {
+    ok: errors.length === 0,
+    configFile: opts.configFile,
+    account: cfg.account?.toString().trim() || void 0,
+    errors,
+    warnings,
+    lengthViolations,
+    agentHint: lengthViolations.length > 0 ? LENGTH_VIOLATION_AGENT_HINT : void 0
+  };
+  const accountSuffix = payload.account || void 0;
+  if (await emitCliJsonOrSnapshot(opts, {
+    section: "ad-campaign-validate",
+    commandLabel: "ad campaign-validate",
+    commandHint: opts.configFile,
+    payload,
+    idSuffix: accountSuffix
+  })) {
+    if (!payload.ok) process.exit(1);
+    return;
+  }
+  if (warnings.length > 0) {
+    console.warn("\n\u26A0\uFE0F  \u6295\u653E\u914D\u7F6E\u8B66\u544A\uFF1A");
+    for (const w of warnings) console.warn(`   \u2022 ${w}`);
   }
   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}`);
+    const lengthReport = formatLengthViolationsReport(lengthViolations);
+    if (lengthReport) console.error(lengthReport);
+    console.error();
     process.exit(1);
   }
+  console.log("\n\u2705 \u6295\u653E\u914D\u7F6E\u6821\u9A8C\u901A\u8FC7");
+  if (opts.writeNormalized) {
+    console.log(`   \u5DF2\u5199\u5165\u89C4\u8303\u5316 JSON\uFF1A${opts.writeNormalized}`);
+  }
+  console.log();
 }
 
 // src/commands/ad/_register.ts
@@ -113535,16 +113656,20 @@ function register20(program2) {
     }
   );
   adCmd.command("campaign-validate").description(
-    "\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"
+    "\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 --json-out ./snap-campaign\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 }", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  ).option("--json", "\u8F93\u51FA { ok, errors, warnings, lengthViolations }\uFF08\u4E0E --json-out \u4E92\u65A5\uFF09", false).option(
+    "--json-out <path>",
+    "\u843D\u76D8\u6821\u9A8C\u7ED3\u679C\uFF08\u542B lengthViolations\uFF09\u5E76\u66F4\u65B0 cli-manifest\uFF1B\u4E0E --json \u4E92\u65A5"
+  ).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAdCampaignValidate({
         configFile: opts.configFile,
         writeNormalized: opts.writeNormalized,
         json: opts.json,
+        jsonOut: opts.jsonOut,
         verbose: opts.verbose
       });
     }
@@ -113705,7 +113830,7 @@ function register20(program2) {
     '\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u5199 matchTypeV2\uFF0C\u5E76\u9ED8\u8BA4\u540C\u6B65\u6539\u5199 keywordText \u4E3A\u8BCD\u5E72/"\u8BCD"/[\u8BCD] \u4EE5\u7B26\u5408\u7F51\u5173\u63A8\u65AD\uFF09'
   ).option(
     "--max-cpc <n>",
-    "\u6700\u9AD8\u6BCF\u6B21\u70B9\u51FB\u8D39\u7528 maxCPC\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 5 \u8868\u793A \xA55\uFF1B\u26A0\uFE0F \u8FD9\u4E2A\u5B57\u6BB5\u540E\u7AEF\u5355\u4F4D\u5C31\u662F\u300C\u4E3B\u5E01\u79CD\u5143\u300D\uFF0CCLI \u76F4\u63A5\u900F\u4F20\u4E0D\u505A \xD7100\uFF0C\u4E0E budget / \u7EC4 maxCPCAmount \u4E0D\u540C\uFF1B0 \u8868\u793A\u6309\u5E73\u53F0/\u8BA1\u5212\u9ED8\u8BA4\uFF09"
+    "\u6700\u9AD8\u6BCF\u6B21\u70B9\u51FB\u8D39\u7528 maxCPC\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 10 \u8868\u793A \xA510\uFF1BCLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF0C\u4E0E adgroup-edit --max-cpc \u540C\u53E3\u5F84\uFF1B0 \u8868\u793A\u6309\u5E73\u53F0/\u8BA1\u5212\u9ED8\u8BA4\uFF09"
   ).option("--final-url <url>", "\u5173\u952E\u8BCD\u7EA7\u6700\u7EC8\u5230\u8FBE\u7F51\u5740 finalURL").option("--status <Enabled|Paused>", "\u7528\u6237\u72B6\u6001\uFF08\u5199\u5165 userStatusV2\uFF0C\u4E0E Web \u5173\u952E\u8BCD\u5F00\u5173\u4E00\u81F4\uFF09").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.matchType && !["Broad", "Phrase", "Exact"].includes(opts.matchType)) {
@@ -114022,59 +114147,6 @@ function register20(program2) {
 
 // src/commands/keyword.ts
 init_auth();
-
-// src/utils/usd-cny-rate.ts
-init_auth();
-var RATE_CACHE_TTL_MS = 10 * 60 * 1e3;
-var rateCache = null;
-function cacheKey(config) {
-  return `${config.apiBaseUrl.replace(/\/$/, "")}|USD|CNY`;
-}
-function parseExrate(data) {
-  if (data == null || typeof data !== "object") return null;
-  const raw = data.exrate;
-  const n = typeof raw === "string" ? Number(raw) : Number(raw);
-  if (!Number.isFinite(n) || n <= 0) return null;
-  return n;
-}
-async function getUsdToCnyExchangeRate(config, verbose) {
-  const key = cacheKey(config);
-  const now = Date.now();
-  if (rateCache && rateCache.key === key && now - rateCache.fetchedAt < RATE_CACHE_TTL_MS) {
-    if (verbose) {
-      console.error(`  [\u6C47\u7387] \u4F7F\u7528\u7F13\u5B58 USD\u2192CNY=${rateCache.rate}\uFF08${Math.round((now - rateCache.fetchedAt) / 1e3)}s \u524D\uFF09`);
-    }
-    return rateCache.rate;
-  }
-  const base = config.apiBaseUrl.replace(/\/$/, "");
-  const url = `${base}/allinpay/GetRate?srcccy=USD&dstccy=CNY`;
-  try {
-    const data = await apiFetch2(url, config, { method: "GET" }, verbose);
-    const rate = parseExrate(data);
-    if (rate == null) {
-      console.error("\n\u26A0 \u83B7\u53D6\u6C47\u7387\u5931\u8D25\uFF1AGetRate \u672A\u8FD4\u56DE\u6709\u6548 exrate\uFF0C\u51FA\u4EF7 CNY \u5B57\u6BB5\u5C06\u7701\u7565\u3002\n");
-      return null;
-    }
-    rateCache = { key, rate, fetchedAt: now };
-    if (verbose) {
-      console.error(`  [\u6C47\u7387] USD\u2192CNY=${rate}\uFF08\u5DF2\u7F13\u5B58 ${RATE_CACHE_TTL_MS / 6e4} \u5206\u949F\uFF09`);
-    }
-    return rate;
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    console.error(`
-\u26A0 \u83B7\u53D6 USD\u2192CNY \u6C47\u7387\u5931\u8D25\uFF08\u51FA\u4EF7 CNY \u5B57\u6BB5\u5C06\u7701\u7565\uFF09\uFF1A${msg}
-`);
-    return null;
-  }
-}
-function convertUsdToCny(amountUsd, rate) {
-  if (amountUsd == null || !Number.isFinite(amountUsd)) return null;
-  if (!Number.isFinite(rate) || rate <= 0) return null;
-  return Math.round(amountUsd * rate * 100) / 100;
-}
-
-// src/commands/keyword.ts
 init_cli_json_snapshot();
 init_cli_table();
 
@@ -114145,40 +114217,16 @@ function requireGoogleApi2(config) {
   return config.googleApiUrl;
 }
 var KEYWORD_SUGGEST_BID_AMOUNT_CURRENCY = "USD";
-function applyUsdBidAmountsInCny(item, usdToCnyRate) {
-  return {
-    ...item,
-    averageCpcCNY: convertUsdToCny(item.averageCpc, usdToCnyRate),
-    lowTopOfPageBidCNY: convertUsdToCny(item.lowTopOfPageBid, usdToCnyRate),
-    highTopOfPageBidCNY: convertUsdToCny(item.highTopOfPageBid, usdToCnyRate)
-  };
-}
-function withUsdFieldAliases(item) {
-  return {
-    ...item,
-    averageCpcUSD: item.averageCpc,
-    lowTopOfPageBidUSD: item.lowTopOfPageBid,
-    highTopOfPageBidUSD: item.highTopOfPageBid
-  };
-}
 function buildKeywordSuggestJsonPayload(items, opts) {
   const currency = opts.bidAmountCurrency.toUpperCase();
-  let normalized = items.map((row) => ({
+  const normalized = items.map((row) => ({
     ...microsItemToBidAmounts(row),
     bidAmountCurrency: currency
   }));
-  const rate = opts.usdToCnyRate;
-  const isUsdPlanner = currency === KEYWORD_SUGGEST_BID_AMOUNT_CURRENCY;
-  if (isUsdPlanner && rate != null && Number.isFinite(rate) && rate > 0) {
-    normalized = normalized.map((row) => withUsdFieldAliases(applyUsdBidAmountsInCny(row, rate)));
-  } else if (isUsdPlanner) {
-    normalized = normalized.map(withUsdFieldAliases);
-  }
   const n = normalized.length;
   return {
     ...wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: normalized }),
-    bidAmountCurrency: currency,
-    ...isUsdPlanner && rate != null && Number.isFinite(rate) && rate > 0 ? { usdToCnyExchangeRate: rate } : {}
+    bidAmountCurrency: currency
   };
 }
 async function fetchUrlKeywords(url, keywords, verbose) {
@@ -114367,12 +114415,7 @@ async function runKeywordSuggest(opts) {
     });
   }
   const n = items.length;
-  const isUsdPlanner = bidAmountCurrency === KEYWORD_SUGGEST_BID_AMOUNT_CURRENCY;
-  const usdToCnyRate = isUsdPlanner ? await getUsdToCnyExchangeRate(config, opts.verbose) : null;
-  const kwPayload = buildKeywordSuggestJsonPayload(items, {
-    bidAmountCurrency,
-    usdToCnyRate
-  });
+  const kwPayload = buildKeywordSuggestJsonPayload(items, { bidAmountCurrency });
   const displayItems = kwPayload.items;
   if (await emitCliJsonOrSnapshot(opts, {
     section: "keyword-suggest",
@@ -114390,16 +114433,7 @@ async function runKeywordSuggest(opts) {
   }
   const fmtAmt = (v) => v != null && Number.isFinite(v) ? v.toFixed(2) : "\u2014";
   const cur = bidAmountCurrency;
-  const hasCnyRef = isUsdPlanner && usdToCnyRate != null && usdToCnyRate > 0;
-  const cols = hasCnyRef ? [
-    { key: "keyword", header: "\u5173\u952E\u8BCD" },
-    { key: "montlySearch", header: "\u6708\u5747\u641C\u7D22" },
-    { key: "cpcMain", header: `\u5E73\u5747CPC(${cur})` },
-    { key: "cpcCny", header: "\u5E73\u5747CPC(CNY\u53C2\u8003)" },
-    { key: "bidRangeMain", header: `\u9875\u9996\u51FA\u4EF7(${cur})` },
-    { key: "bidRangeCny", header: "\u9875\u9996\u51FA\u4EF7(CNY\u53C2\u8003)" },
-    { key: "competition", header: "\u7ADE\u4E89\u5EA6" }
-  ] : [
+  const cols = [
     { key: "keyword", header: "\u5173\u952E\u8BCD" },
     { key: "montlySearch", header: "\u6708\u5747\u641C\u7D22" },
     { key: "cpcMain", header: `\u5E73\u5747CPC(${cur})` },
@@ -114412,33 +114446,21 @@ async function runKeywordSuggest(opts) {
     const highMain = fmtAmt(item.highTopOfPageBid);
     const bidRangeMain = lowMain === "\u2014" && highMain === "\u2014" ? "\u2014" : `${lowMain} ~ ${highMain}`;
     const competitionDisplay = item.competitionV2 ?? (item.competition != null ? item.competition.toFixed(2) : "\u2014");
-    const row = {
+    return {
       keyword: item.keyword ?? "",
       montlySearch: String(item.montlySearch ?? "\u2014"),
       cpcMain,
       bidRangeMain,
       competition: competitionDisplay
     };
-    if (hasCnyRef) {
-      const cpcCny = fmtAmt(item.averageCpcCNY);
-      const lowCny = fmtAmt(item.lowTopOfPageBidCNY);
-      const highCny = fmtAmt(item.highTopOfPageBidCNY);
-      row.cpcCny = cpcCny;
-      row.bidRangeCny = lowCny === "\u2014" && highCny === "\u2014" ? "\u2014" : `${lowCny} ~ ${highCny}`;
-    }
-    return row;
   });
   printCliTable(rows, cols);
-  if (hasCnyRef) {
-    console.log(
-      `  \uFF08\u51FA\u4EF7\u5E01\u79CD ${cur}\uFF1BCNY \u4E3A\u6C47\u7387 ${usdToCnyRate} \u6362\u7B97\u53C2\u8003\uFF0C\u975E Google \u8D26\u6237\u5E01\u79CD\u53E3\u5F84\uFF09
-`
-    );
-  } else if (accountId) {
+  if (accountId) {
     console.log(`  \uFF08\u51FA\u4EF7\u5E01\u79CD\uFF1A${cur}\uFF0C\u4E0E\u8D26\u6237 currencyCode \u4E00\u81F4\uFF09
 `);
   } else {
-    console.log();
+    console.log(`  \uFF08\u51FA\u4EF7\u5E01\u79CD\uFF1A${cur}\uFF09
+`);
   }
 }
 function microsToAmount(v) {
@@ -115686,8 +115708,8 @@ async function runAccountWithdrawSubmit(opts) {
   });
   const feeRateCache = /* @__PURE__ */ new Map();
   for (const { currency, availableAmount } of accountDetails) {
-    const cacheKey2 = `${currency}-${availableAmount.toFixed(2)}`;
-    if (feeRateCache.has(cacheKey2)) continue;
+    const cacheKey = `${currency}-${availableAmount.toFixed(2)}`;
+    if (feeRateCache.has(cacheKey)) continue;
     try {
       const feeParams = new URLSearchParams({
         mediaType: "Google",
@@ -115700,16 +115722,16 @@ async function runAccountWithdrawSubmit(opts) {
         {},
         opts.verbose
       );
-      feeRateCache.set(cacheKey2, feeData?.feeRate ?? 0);
+      feeRateCache.set(cacheKey, feeData?.feeRate ?? 0);
     } catch {
       console.warn(`  \u26A0\uFE0F  ${currency} \u7BA1\u7406\u8D39\u67E5\u8BE2\u5931\u8D25\uFF0C\u5C06\u4EE5 0 \u8D39\u7387\u63D0\u4EA4\u3002`);
-      feeRateCache.set(cacheKey2, 0);
+      feeRateCache.set(cacheKey, 0);
     }
   }
   const body = accountDetails.map(
     ({ ma, mai, currency, balance, adjustments, availableAmount }) => {
-      const cacheKey2 = `${currency}-${availableAmount.toFixed(2)}`;
-      const feeRate = feeRateCache.get(cacheKey2) ?? 0;
+      const cacheKey = `${currency}-${availableAmount.toFixed(2)}`;
+      const feeRate = feeRateCache.get(cacheKey) ?? 0;
       const taxRate = currency === "CNY" ? 0.06 : 0;
       const totalAmounts = availableAmount * (1 + feeRate) * (1 + taxRate);
       return {

package/dist/skill/SKILL.md

@@ -152,7 +152,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
   - `ad campaigns --json/--json-out` → `budget`（元，与 `campaign-edit --budget` 同口径）
   - `ad groups --json` → `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）
   - `google-analysis campaigns-*.json` → `budgetAmountYuan` / `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan` / `spend` / `averageCpc` / `costPerConversion`（均元）
-  - `keyword --json` → `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` + 每条 `bidAmountCurrency`（无 `-a` 为 USD，可选 `averageCpcCNY` 汇率参考；有 `-a` 为账户 `currencyCode`，勿用汇率换算）；`-a <mediaCustomerId>` 走账户级推荐接口；限定市场用 `keyword geo-list` + `--geo <id>`（**多 id = 汇总指标**；分市场须多次调用、每次一个 `--geo`，见 `references/keyword-planner-workflows.md`）
+  - `keyword --json` → `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` + 根级与每条 `bidAmountCurrency`（无 `-a` 为 USD；有 `-a` 为账户 `currencyCode`）；`-a <mediaCustomerId>` 走账户级推荐接口；限定市场用 `keyword geo-list` + `--geo <id>`（**多 id = 汇总指标**；分市场须多次调用、每次一个 `--geo`，见 `references/keyword-planner-workflows.md`）
 - **品牌名优先级**：(1) 用户明确提供 → (2) `list-accounts.mag.advertiserName` → (3) 用户提供网址 → 域名占位并标注 `[待确认品牌名]`。**严禁**把英文域名翻译为虚构中文品牌。
 - 完整字段表见 `references/currency.md`。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.20-beta.21",
-  "publishedAt": 1779348843065
+  "version": "1.1.20-beta.22",
+  "publishedAt": 1779355357943
 }

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

@@ -23,11 +23,11 @@ JSON 模板：同目录 [`campaign-create-template.json`](campaign-create-templa
 
 | 命令 | 支持 `--json-out`？ | 推荐用法 |
 | ---- | :-----------------: | -------- |
-| `ad campaign-validate` | **否** | `siluzan-tso ad campaign-validate --config-file ./campaign.json` 或加 `--json`；规范化输出用 `--write-normalized ./campaign.normalized.json` |
-| `ad campaign-create` | **是**（较新版本） | 落盘任务响应：`--json-out ./snap-campaign`；与 `--json` 互斥。若报 `unknown option --json-out`，升级 `siluzan-tso` 或暂用 `--json` |
+| `ad campaign-validate` | **是** | **推荐** `--json-out ./snap-campaign`（落盘 `ad-campaign-validate-<account>.json`，含 `lengthViolations`）；与 `--json` 互斥。人读：`--config-file` 即可；词面规范化：`--write-normalized`。超长勿自动截断，见 `google-ads-campaign-plan.md` § 超长人工确认 |
+| `ad campaign-create` | **是** | 落盘任务响应：`--json-out ./snap-campaign`；与 `--json` 互斥 |
 | `ad batch get` / `ad batch diff` | **是** | 轮询与 diff 结果落盘，见 `references/tips.md` |
 
-**禁止**：对 `campaign-validate` 加 `--json-out`（会报参数不支持，浪费多轮重试）。
+**Agent**：校验与 create/batch 共用同一 `--json-out` 目录时，按 stdout 摘要里的 `outlineFile` → 再读对应 JSON（勿把 outline 当数据）。
 
 ### RSA 落地页：`Finalurl` 必填
 

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

@@ -83,7 +83,7 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 | `ad campaigns --json`                               | `budget`（元，与 `--budget` 写参同口径）                                                                                                  |
 | `ad groups --json`                                  | `maxCPCAmountYuan`、`targetCpaAmountYuan`                                                                                                 |
 | `google-analysis campaigns` 落盘 `campaigns-*.json` | `budgetAmountYuan`、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`；同行 `spend` / `averageCpc` / `costPerConversion` 也是元 |
-| `keyword suggest --json`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；`bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD，可选 `averageCpcCNY` 参考） |
+| `keyword suggest --json`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；根级与每条 `bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD） |
 | `balance` 等账户余额接口                            | `remainingAccountBudget`（元）                                                                                                            |
 
 旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。

package/dist/skill/references/currency.md

@@ -46,7 +46,7 @@
 
 ## 金额单位约定
 
-- **CLI 出口的大多数 JSON / 表格金额以「元」为单位**：`budget`、`*Yuan` 后缀（`budgetAmountYuan`、`maxCPCAmountYuan` 等）、`spend` / `averageCpc` / `costPerConversion` 等。**`keyword suggest`**：`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 的币种见根级与每条 **`bidAmountCurrency`**（传 `-a` 时为账户 `currencyCode`；无 `-a` 时为 **USD**，可选 `averageCpcCNY` 为汇率参考、非 Google 账户口径）。
+- **CLI 出口的大多数 JSON / 表格金额以「元」为单位**：`budget`、`*Yuan` 后缀（`budgetAmountYuan`、`maxCPCAmountYuan` 等）、`spend` / `averageCpc` / `costPerConversion` 等。**`keyword suggest`**：`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 的币种见根级与每条 **`bidAmountCurrency`**（传 `-a` 时为账户 `currencyCode`；无 `-a` 时为 **USD**）。
 - **写 CLI 参数**（`--budget`、`--max-cpc`、`--target-cpa`、`--amount` 等）：同样传**主币种元**，与账户 `currencyCode` 一致；CLI 内部按需 ×100 / ×1_000_000 写后端。
 - 旧版网关字段（`budgetAmount` 分、`*Micros` 微元、`maxCPCAmountDisplay` 等）**已不再落盘到 CLI 输出**，下游脚本无需做单位换算。
 

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

@@ -26,7 +26,7 @@
 | 2 | 可选 `rag query`；`keyword` / `keyword geo-list` 拓词 | `references/keyword-planner-workflows.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） | 下文「校验」 |
+| 5 | **`ad campaign-validate --config-file <json>`**（失败只改 JSON；超长见下文「超长人工确认」） | 下文「校验」 |
 | 6 | 输出：**JSON 代码块** → **Markdown**（`google-ads-launch-plan-template.md` 正文）→ 待确认 | — |
 | 7 | 用户确认后 **`ad campaign-create`** | `google-ads.md`|
 | 8 | 每隔5s 获取创建结果| `ad batch get --id <taskId> --config-file ./campaign.json` |
@@ -72,7 +72,8 @@
 ## 校验与创建（命令速查）
 
 ```bash
-siluzan-tso ad campaign-validate --config-file ./campaign.json [--json] [--write-normalized <path>] --commit "xxx"
+siluzan-tso ad campaign-validate --config-file ./campaign.json --json-out ./snap-campaign
+siluzan-tso ad campaign-validate --config-file ./campaign.json [--json] [--write-normalized <path>]
 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
@@ -81,6 +82,17 @@ siluzan-tso ad geo search
 
 validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 + 后端/Google 硬约束（预算、RSA、匹配符号与 `MatchTypeV2` 对齐、搜索网络等）。**不含**关键词分层数量、匹配占比、否词条数下限。
 
+### 超长内容：禁止 Agent 自动截断
+
+标题/描述/Path/关键词/Sitelink 超限时 CLI **报错阻断**，不会在 JSON 里静默改短。
+
+1. 使用 **`ad campaign-validate --config-file <json> --json-out <dir>`**（与 create/batch 同一落盘目录），读落盘文件中的 `lengthViolations`（每项含 `path`、`limit`、`actual`、**完整** `text`）。小文件可用 `--json` 代替。
+2. Agent 将 **全部** 超长条目整理成表（路径、原文、上限、超出量），并为每条给出 **1–2 个改写方案**（保留卖点、符合字符计数；CJK 按 2 计见 `google-ads-compliance.md` §3.2.1）。
+3. **用户确认**选用方案后，Agent **只改 JSON 对应字段**，再执行 `campaign-validate`；通过后再 `campaign-create`。
+4. **禁止**：未确认前 `slice`/省略号截断、仅改 `--write-normalized` 而不经用户确认。
+
+人读模式失败时 CLI 会额外打印「📏 超长内容清单」；`--json-out` / `--json` 时见 `lengthViolations` + `agentHint`。
+
 ---
 
 ## 已上线后的修改

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

@@ -54,7 +54,7 @@
 | 技术词 | api/sdk/integration | payment sdk integration |
 | 问题词 | how to + 问题 | how to reduce failed payments |
 
-拓词编排见 `references/keyword-planner-workflows.md`；Planner 出价用 `*USD` 与 `*CNY`，根级 `bidAmountCurrency` / `usdToCnyExchangeRate`。
+拓词编排见 `references/keyword-planner-workflows.md`；Planner 出价见 `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 与根级、每条 `bidAmountCurrency`。
 
 ---
 

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

@@ -6,8 +6,7 @@
 
 ## 金额单位（全局重要）
 
-> **所有 CLI 金额参数均按「主币种金额」传入**（如 `1.5` = ¥1.50 / $1.50）
-> **唯一例外**：`ad keyword-edit --max-cpc` 单位为「主币种元」（直接透传，不做 ×100 转换）。
+> **所有 CLI 金额参数均按「主币种金额」传入**（如 `1.5` = ¥1.50 / $1.50）；CLI 写入网关前对「分」字段 ×100（含 `ad keyword-edit --max-cpc` → `maxCPC`）。
 > **禁止** 按 Google micros（×1,000,000）填写任何金额参数。
 
 ---
@@ -277,6 +276,8 @@ siluzan-tso keyword geo-list [--country-code <US,CN,...>] [--name-contains <text
 
 不提交 API；创建系列前**建议**跑。命令、选项、与 create 共用校验逻辑见 **`references/google-ads-campaign-plan.md`** § 校验与创建（后端/Google 硬约束，不含关键词分层占比）。
 
+**超长内容**：加 **`--json-out <dir>`**（推荐，与 create/batch 共用目录）或 `--json` 时响应含 `lengthViolations`（完整 `text` + JSON `path`）。Agent **勿自动截断**；须列出全部超长项与改写方案，用户确认后再改 JSON 并重跑 validate（流程见 `google-ads-campaign-plan.md` § 超长人工确认）。
+
 ---
 
 ## ad campaign-create — 广告系列创建
@@ -442,7 +443,7 @@ siluzan-tso ad keyword-edit \
   [--max-cpc <n>] [--final-url <url>] [--status Enabled|Paused]
 ```
 
-传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为「主币种元」（见文首金额单位说明）。`--status` 写入 `userStatusV2`（与 Web 关键词开关一致，非系列的 `statusV2`）。
+传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为主币种元（CLI ×100 写入 `maxCPC`「分」字段，与 `adgroup-edit --max-cpc` 同口径）。`ad keywords --json` 出价见 `maxCPCYuan`。`--status` 写入 `userStatusV2`（与 Web 关键词开关一致，非系列的 `statusV2`）。
 
 ---
 

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

@@ -205,6 +205,6 @@ siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [
 
 `--google-only`：只调 Google 推荐主接口（有 `-a` 为账户接口，无 `-a` 为 `keywordidea/google`），不叠加 `--url` 的网址拓词；**分支 B（仅 Google）必加**。
 
-**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级与每条 **`bidAmountCurrency`**（无账户=`USD`；有账户=`list-accounts` 的 `currencyCode`）；`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（微元 ÷1,000,000，**与 `bidAmountCurrency` 一致**）。无账户 USD 时可选 `usdToCnyExchangeRate` 与 `averageCpcCNY` 等**参考**字段（非 Google 账户币种口径）。另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。
+**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级与每条 **`bidAmountCurrency`**（无账户=`USD`；有账户=`list-accounts` 的 `currencyCode`）；`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（微元 ÷1,000,000，**与 `bidAmountCurrency` 一致**）。另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。
 
 与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。

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