siluzan-tso-cli 1.1.35-beta.5 → 1.1.36-beta.1

package/README.md

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

package/dist/index.js

@@ -113676,17 +113676,120 @@ init_cli_table();
 // src/commands/ad/campaign-batch-diff.ts
 init_auth();
 init_cli_json_snapshot();
+
+// src/commands/ad/campaign-extension-remediate.ts
+function shellArg(value) {
+  return /[\s"]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value;
+}
+function pickString(...vals) {
+  for (const v of vals) {
+    if (typeof v === "string" && v.trim()) return v.trim();
+  }
+  return "";
+}
 function asRecord2(v) {
   return v && typeof v === "object" && !Array.isArray(v) ? v : null;
 }
-function pickString(...vals) {
+function extensionType2(ext) {
+  return pickString(ext["typeV2"], ext["TypeV2"], ext["AssetFieldType"], ext["type"]).toUpperCase();
+}
+function extensionLevel(ext) {
+  const level = pickString(ext["level"], ext["Level"]) || "Campaign";
+  return level.charAt(0).toUpperCase() + level.slice(1).toLowerCase();
+}
+function buildExtensionRemediateCommandLine(opts) {
+  const { accountId, campaignId, ext } = opts;
+  const jsonOut = shellArg(opts.jsonOutDir ?? "./snap");
+  const type = extensionType2(ext);
+  const level = extensionLevel(ext);
+  const props = asRecord2(ext["Properties"]) ?? {};
+  const levelFlag = `--level ${level}`;
+  const campaignFlag = level === "Campaign" ? `--campaign-id ${campaignId}` : "";
+  const base = ["siluzan-tso", "ad", "extension"];
+  if (type === "SITELINK") {
+    const text = pickString(props["Text"], props["LinkText"]);
+    const url = pickString(props["DestinationUrl"]);
+    if (!text || !url) return null;
+    const parts = [
+      ...base,
+      "sitelink",
+      `-a ${accountId}`,
+      `--text ${shellArg(text)}`,
+      `--url ${shellArg(url)}`
+    ];
+    const line2 = pickString(props["Line2"], props["Description1"]);
+    const line3 = pickString(props["Line3"], props["Description2"]);
+    if (line2) parts.push(`--line2 ${shellArg(line2)}`);
+    if (line3) parts.push(`--line3 ${shellArg(line3)}`);
+    parts.push(levelFlag);
+    if (campaignFlag) parts.push(campaignFlag);
+    parts.push(`--json-out ${jsonOut}`);
+    return parts.join(" ");
+  }
+  if (type === "CALLOUT") {
+    const text = pickString(props["Text"], props["CalloutText"]);
+    if (!text) return null;
+    const parts = [
+      ...base,
+      "callout",
+      `-a ${accountId}`,
+      `--text ${shellArg(text)}`,
+      levelFlag
+    ];
+    if (campaignFlag) parts.push(campaignFlag);
+    parts.push(`--json-out ${jsonOut}`);
+    return parts.join(" ");
+  }
+  if (type === "CALL") {
+    const code = pickString(props["ContryCode"], props["CountryCode"]);
+    const phone = pickString(props["PhoneNumber"], props["phoneNumber"]);
+    if (!code || !phone) return null;
+    const parts = [
+      ...base,
+      "call",
+      `-a ${accountId}`,
+      `--country-code ${shellArg(code)}`,
+      `--phone ${shellArg(phone)}`,
+      levelFlag
+    ];
+    if (campaignFlag) parts.push(campaignFlag);
+    parts.push(`--json-out ${jsonOut}`);
+    return parts.join(" ");
+  }
+  if (type === "STRUCTURED_SNIPPET") {
+    const ssv = asRecord2(ext["StructuredSnippetHeaderValue"]);
+    const header = pickString(ssv?.["Key"]);
+    const values = ssv?.["Value"];
+    if (!header || !Array.isArray(values) || values.length === 0) return null;
+    const valueStr = values.filter((v) => typeof v === "string" && v.trim().length > 0).join(",");
+    if (!valueStr) return null;
+    const parts = [
+      ...base,
+      "snippet",
+      `-a ${accountId}`,
+      `--header ${shellArg(header)}`,
+      `--values ${shellArg(valueStr)}`,
+      levelFlag
+    ];
+    if (campaignFlag) parts.push(campaignFlag);
+    parts.push(`--json-out ${jsonOut}`);
+    return parts.join(" ");
+  }
+  return null;
+}
+
+// src/commands/ad/campaign-batch-diff.ts
+function asRecord3(v) {
+  return v && typeof v === "object" && !Array.isArray(v) ? v : null;
+}
+function pickString2(...vals) {
   for (const v of vals) {
     if (typeof v === "string" && v.trim()) return v.trim();
   }
   return "";
 }
 function normMatchType(v) {
-  return pickString(v).toUpperCase() || "BROAD";
+  return pickString2(v).toUpperCase() || "BROAD";
 }
 function keywordKey(core, matchType) {
   return `${normMatchType(matchType)}:${unwrapKeywordDisplayTextForEdit(core).trim().toLowerCase()}`;
@@ -113696,19 +113799,19 @@ function liveKeywordTexts(item) {
   if (Array.isArray(kt)) {
     return kt.filter((t2) => typeof t2 === "string" && t2.trim().length > 0);
   }
-  const t = pickString(item["text"], kt);
+  const t = pickString2(item["text"], kt);
   return t ? [t] : [];
 }
 function belongsToCampaign(item, campaignId, campaignName) {
-  const cid = pickString(item["campaignId"], item["campaignid"], item["CampaignId"]);
-  const cname = pickString(item["campaignName"], item["campaign"], item["CampaignName"]);
+  const cid = pickString2(item["campaignId"], item["campaignid"], item["CampaignId"]);
+  const cname = pickString2(item["campaignName"], item["campaign"], item["CampaignName"]);
   if (campaignId && cid) return cid === campaignId;
   if (campaignName && cname) return cname === campaignName;
   return false;
 }
 function belongsToAdGroup(item, adGroupName, adGroupId) {
-  const gid = pickString(item["adGroupId"], item["adgroupId"], item["AdGroupId"]);
-  const gname = pickString(item["adGroupName"], item["adGroup"], item["AdGroupName"]);
+  const gid = pickString2(item["adGroupId"], item["adgroupId"], item["AdGroupId"]);
+  const gname = pickString2(item["adGroupName"], item["adGroup"], item["AdGroupName"]);
   if (adGroupId && gid) return gid === adGroupId;
   return gname === adGroupName;
 }
@@ -113729,10 +113832,10 @@ function liveAdHasHeadline(ad, headline) {
 }
 function formatExtensionPlanned(ext) {
   if (!ext) return "\u2014";
-  const type = pickString(ext["typeV2"], ext["AssetFieldType"], ext["type"]);
-  const props = asRecord2(ext["Properties"]);
-  const phone = props ? pickString(props["PhoneNumber"], props["phoneNumber"]) : "";
-  const code = props ? pickString(props["ContryCode"], props["CountryCode"]) : "";
+  const type = pickString2(ext["typeV2"], ext["AssetFieldType"], ext["type"]);
+  const props = asRecord3(ext["Properties"]);
+  const phone = props ? pickString2(props["PhoneNumber"], props["phoneNumber"]) : "";
+  const code = props ? pickString2(props["ContryCode"], props["CountryCode"]) : "";
   const parts = [type ? `\u7C7B\u578B: ${type}` : "", code || phone ? `\u7535\u8BDD: ${code}${phone}` : ""].filter(
     Boolean
   );
@@ -113743,15 +113846,15 @@ function listPlannedKeywords(campaign) {
   if (!Array.isArray(groups)) return [];
   const out = [];
   for (let gi = 0; gi < groups.length; gi++) {
-    const g = asRecord2(groups[gi]);
+    const g = asRecord3(groups[gi]);
     if (!g) continue;
-    const groupName = pickString(g["Name"], g["name"]) || `AdGroupsForBatchJob[${gi}]`;
+    const groupName = pickString2(g["Name"], g["name"]) || `AdGroupsForBatchJob[${gi}]`;
     const blocks = g["KeywordsForBatchJob"];
     if (!Array.isArray(blocks)) continue;
     for (let bi = 0; bi < blocks.length; bi++) {
-      const block = asRecord2(blocks[bi]);
+      const block = asRecord3(blocks[bi]);
       if (!block) continue;
-      const matchTypeV2 = pickString(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
+      const matchTypeV2 = pickString2(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
       const texts = block["KeywordText"];
       if (!Array.isArray(texts)) continue;
       for (let ki = 0; ki < texts.length; ki++) {
@@ -113773,9 +113876,9 @@ function listPlannedNegativeKeywords(campaign) {
   if (!Array.isArray(blocks)) return [];
   const out = [];
   for (let bi = 0; bi < blocks.length; bi++) {
-    const block = asRecord2(blocks[bi]);
+    const block = asRecord3(blocks[bi]);
     if (!block) continue;
-    const matchTypeV2 = pickString(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
+    const matchTypeV2 = pickString2(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
     const texts = block["KeywordText"];
     if (!Array.isArray(texts)) continue;
     for (let ki = 0; ki < texts.length; ki++) {
@@ -113793,7 +113896,7 @@ function listPlannedNegativeKeywords(campaign) {
 }
 function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
   const campaign = cfg.campaign ?? {};
-  const campaignName = pickString(cfg.name, campaign["Name"], campaign["name"]);
+  const campaignName = pickString2(cfg.name, campaign["Name"], campaign["name"]);
   const accountId = String(cfg.account ?? "");
   const missing = [];
   if (!live.campaignFound) {
@@ -113807,15 +113910,15 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
   }
   const liveGroups = live.adGroups;
   const liveGroupNames = new Set(
-    liveGroups.map((g) => pickString(g["name"], g["Name"]).toLowerCase()).filter(Boolean)
+    liveGroups.map((g) => pickString2(g["name"], g["Name"]).toLowerCase()).filter(Boolean)
   );
   const groups = campaign["AdGroupsForBatchJob"];
   const plannedGroupCount = Array.isArray(groups) ? groups.length : 0;
   if (Array.isArray(groups)) {
     for (let gi = 0; gi < groups.length; gi++) {
-      const g = asRecord2(groups[gi]);
+      const g = asRecord3(groups[gi]);
       if (!g) continue;
-      const groupName = pickString(g["Name"], g["name"]) || `AdGroupsForBatchJob[${gi}]`;
+      const groupName = pickString2(g["Name"], g["name"]) || `AdGroupsForBatchJob[${gi}]`;
       const groupPath = `campaign.AdGroupsForBatchJob[${gi}]`;
       if (!liveGroupNames.has(groupName.toLowerCase())) {
         missing.push({
@@ -113829,9 +113932,9 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
         continue;
       }
       const liveGroup = liveGroups.find(
-        (lg) => pickString(lg["name"], lg["Name"]).toLowerCase() === groupName.toLowerCase()
+        (lg) => pickString2(lg["name"], lg["Name"]).toLowerCase() === groupName.toLowerCase()
       );
-      const liveGroupId = liveGroup ? pickString(liveGroup["id"], liveGroup["Id"]) : "";
+      const liveGroupId = liveGroup ? pickString2(liveGroup["id"], liveGroup["Id"]) : "";
       const liveKwInGroup = live.keywords.filter(
         (k) => belongsToCampaign(k, campaignId, campaignName) && belongsToAdGroup(k, groupName, liveGroupId)
       );
@@ -113844,9 +113947,9 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const blocks = g["KeywordsForBatchJob"];
       if (Array.isArray(blocks)) {
         for (let bi = 0; bi < blocks.length; bi++) {
-          const block = asRecord2(blocks[bi]);
+          const block = asRecord3(blocks[bi]);
           if (!block) continue;
-          const matchTypeV2 = pickString(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
+          const matchTypeV2 = pickString2(block["MatchTypeV2"], block["matchTypeV2"]) || "BROAD";
           const texts = block["KeywordText"];
           if (!Array.isArray(texts)) continue;
           for (let ki = 0; ki < texts.length; ki++) {
@@ -113873,10 +113976,10 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const ads = g["AdsForBatchJob"];
       if (Array.isArray(ads)) {
         for (let ai = 0; ai < ads.length; ai++) {
-          const ad = asRecord2(ads[ai]);
+          const ad = asRecord3(ads[ai]);
           if (!ad) continue;
           const path34 = `${groupPath}.AdsForBatchJob[${ai}]`;
-          const primary = pickString(ad["headlinePart1"], ad["AdTitle"]);
+          const primary = pickString2(ad["headlinePart1"], ad["AdTitle"]);
           if (!primary) {
             missing.push({
               layer: "ad",
@@ -113888,7 +113991,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
             });
             continue;
           }
-          const finalUrl = pickString(ad["Finalurl"], ad["DestinationUrl"], ad["finalUrl"]);
+          const finalUrl = pickString2(ad["Finalurl"], ad["DestinationUrl"], ad["finalUrl"]);
           const found = liveAdsInGroup.some((la) => liveAdHasHeadline(la, primary));
           if (!found) {
             missing.push({
@@ -113929,13 +114032,15 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
   ).length;
   if (plannedExt > liveExt && Array.isArray(extBlocks)) {
     for (let ei = liveExt; ei < extBlocks.length; ei++) {
-      const ext = asRecord2(extBlocks[ei]);
+      const ext = asRecord3(extBlocks[ei]);
+      const remediateCommand = ext && accountId && campaignId ? buildExtensionRemediateCommandLine({ accountId, campaignId, ext }) ?? void 0 : void 0;
       missing.push({
         layer: "extension",
         path: `campaign.ExtensionsForBatchJob[${ei}]`,
         plannedContent: formatExtensionPlanned(ext),
         liveNote: `\u7CFB\u5217\u7EA7\u9644\u52A0\u4FE1\u606F\u8D26\u6237\u5185 ${liveExt}/${plannedExt} \u6761`,
-        summary: `\u9644\u52A0\u4FE1\u606F\u672A\u521B\u5EFA\uFF1A${formatExtensionPlanned(ext)}`
+        summary: `\u9644\u52A0\u4FE1\u606F\u672A\u521B\u5EFA\uFF1A${formatExtensionPlanned(ext)}`,
+        remediateCommand
       });
     }
   }
@@ -113959,7 +114064,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       plannedKeywords: plannedKeywords.length,
       liveKeywords: liveKwCount,
       plannedAds: Array.isArray(groups) ? groups.reduce((n, g) => {
-        const gr = asRecord2(g);
+        const gr = asRecord3(g);
         const ads = gr?.["AdsForBatchJob"];
         return n + (Array.isArray(ads) ? ads.length : 0);
       }, 0) : 0,
@@ -114020,7 +114125,7 @@ async function fetchLiveSnapshotForCampaign(config, accountId, campaignId, campa
     )
   ]);
   const campaignFound = campaigns.some(
-    (c) => pickString(c["id"], c["Id"]) === campaignId || pickString(c["name"], c["Name"]) === campaignName
+    (c) => pickString2(c["id"], c["Id"]) === campaignId || pickString2(c["name"], c["Name"]) === campaignName
   );
   return {
     campaignFound,
@@ -114035,8 +114140,8 @@ async function fetchLiveSnapshotForCampaign(config, accountId, campaignId, campa
   };
 }
 function resolveCampaignIdFromBatch(record) {
-  const campaign = asRecord2(record["campaign"]);
-  return pickString(campaign?.["Id"], campaign?.["id"], record["campaignId"]);
+  const campaign = asRecord3(record["campaign"]);
+  return pickString2(campaign?.["Id"], campaign?.["id"], record["campaignId"]);
 }
 function shellArgPath(p) {
   return /[\s"]/.test(p) ? `"${p.replace(/"/g, '\\"')}"` : p;
@@ -114083,7 +114188,9 @@ function printBatchDiffFollowUpHint(opts) {
   if (opts.status === "Successfully") {
     console.log("  \u6838\u5BF9\u8BA1\u5212\u4E0E\u8D26\u6237\u662F\u5426\u4E00\u81F4\uFF08\u65E0\u7F3A\u5931\u5E94\u663E\u793A \u2705\uFF09\u3002\n");
   } else {
-    console.log("  \u5217\u51FA\u7F3A\u5931\u9879\u540E\u6309\u8DEF\u5F84\u8865\u5EFA\u3002\n");
+    console.log(
+      "  \u5217\u51FA\u7F3A\u5931\u9879\u540E\u81EA\u52A8\u8865\u5EFA\uFF08\u9644\u52A0\u4FE1\u606F\u7528 ad extension *\uFF1B\u7EC4/\u8BCD/RSA \u7528\u5BF9\u5E94 create \u547D\u4EE4\uFF09\u3002\n"
+    );
   }
   console.log(`  ${cmd}
 `);
@@ -114111,6 +114218,9 @@ function printMissingEntry(configFile, item) {
   if (item.liveNote) {
     console.log(`    \u5B9E\u51B5: ${item.liveNote}`);
   }
+  if (item.remediateCommand) {
+    console.log(`    \u8865\u5EFA: ${item.remediateCommand}`);
+  }
 }
 function printMissingGroupByAdGroup(configFile, layer, items) {
   const byGroup = /* @__PURE__ */ new Map();
@@ -114178,6 +114288,11 @@ function formatBatchDiffGrouped(result) {
       for (const m of layerItems) {
         printMissingEntry(configFile, m);
       }
+      if (layer === "extension" && layerItems.some((m) => m.remediateCommand)) {
+        console.log(
+          "\n  \u{1F4A1} \u9644\u52A0\u4FE1\u606F BatchJob \u5E38\u5931\u8D25\uFF1AAgent \u5E94**\u76F4\u63A5\u6267\u884C**\u4E0A\u65B9\u300C\u8865\u5EFA\u300D\u547D\u4EE4\uFF08\u7528\u6237\u5DF2\u786E\u8BA4\u8FC7 JSON\uFF09\uFF0C\u52FF\u4EC5\u8BE2\u95EE\u662F\u5426\u8865\u5EFA\u3002"
+        );
+      }
     }
   }
   console.log();
@@ -114190,14 +114305,14 @@ async function runCampaignBatchDiff(opts) {
 `);
     process.exit(1);
   }
-  const accountId = pickString(opts.account, cfg.account);
+  const accountId = pickString2(opts.account, cfg.account);
   if (!accountId) {
     console.error("\n\u274C \u7F3A\u5C11\u8D26\u6237 ID\uFF1A\u8BF7\u5728 JSON \u4E2D\u586B\u5199 account \u6216\u4F7F\u7528 -a\n");
     process.exit(1);
   }
   cfg.account = accountId;
   const config = loadConfig(opts.token);
-  let campaignId = pickString(opts.campaignId);
+  let campaignId = pickString2(opts.campaignId);
   let batchStatus;
   if (opts.batchId) {
     const batchUrl = `${config.apiBaseUrl}/query/campaign-creation-record/campaign-batch-asyncs/${opts.batchId}`;
@@ -114210,7 +114325,7 @@ async function runCampaignBatchDiff(opts) {
 `);
       process.exit(1);
     }
-    batchStatus = pickString(batch["status"]);
+    batchStatus = pickString2(batch["status"]);
     if (batchStatus === "Creating") {
       console.error("\n\u274C \u4EFB\u52A1\u4ECD\u5728\u521B\u5EFA\u4E2D\uFF0C\u8BF7\u7A0D\u540E\u518D\u6267\u884C ad batch diff\n");
       process.exit(1);
@@ -114228,7 +114343,7 @@ async function runCampaignBatchDiff(opts) {
     }
   }
   const campaign = cfg.campaign ?? {};
-  const campaignName = pickString(cfg.name, campaign["Name"], campaign["name"]);
+  const campaignName = pickString2(cfg.name, campaign["Name"], campaign["name"]);
   if (!campaignId && campaignName) {
     const googleApiUrl = requireGoogleApi(config);
     const params = new URLSearchParams();
@@ -114240,10 +114355,10 @@ async function runCampaignBatchDiff(opts) {
       opts.verbose
     );
     const hit = campaigns.find(
-      (c) => pickString(c["name"], c["Name"]).toLowerCase() === campaignName.toLowerCase()
+      (c) => pickString2(c["name"], c["Name"]).toLowerCase() === campaignName.toLowerCase()
     );
     if (hit) {
-      campaignId = pickString(hit["id"], hit["Id"]);
+      campaignId = pickString2(hit["id"], hit["Id"]);
     }
   }
   if (!campaignId) {
@@ -123718,7 +123833,7 @@ function readJsonFile(filePath) {
     }
   });
 }
-function asRecord3(value) {
+function asRecord4(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -123744,10 +123859,10 @@ function injectReportData(html, payload) {
 async function runWebsiteDiagnosisRender(opts) {
   const dataPath = path17.resolve(opts.dataFile);
   const dataRaw = await readJsonFile(dataPath);
-  let data = asRecord3(dataRaw);
+  let data = asRecord4(dataRaw);
   if (opts.collectFile) {
     const collectRaw = await readJsonFile(path17.resolve(opts.collectFile));
-    data = mergeCollectLighthouse(data, asRecord3(collectRaw));
+    data = mergeCollectLighthouse(data, asRecord4(collectRaw));
   }
   const templatePath = websiteDiagnosisReportTemplatePath();
   let html;
@@ -124388,7 +124503,7 @@ function formatMarketReportContentErrors(result) {
 }
 
 // src/commands/market-analysis/render-report.ts
-function asRecord4(value) {
+function asRecord5(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -124418,7 +124533,7 @@ async function runMarketAnalysisRender(opts) {
   }
   let html;
   try {
-    html = resolveMarketAnalysisHtml(asRecord4(dataRaw));
+    html = resolveMarketAnalysisHtml(asRecord5(dataRaw));
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     console.error(`
@@ -124430,7 +124545,7 @@ async function runMarketAnalysisRender(opts) {
     console.error("\n\u274C \u62A5\u544A HTML \u5185\u5BB9\u4E3A\u7A7A\n");
     process.exit(1);
   }
-  const reportData = asRecord4(dataRaw);
+  const reportData = asRecord5(dataRaw);
   const contentCheck = validateMarketReportContent(html, validationContextFromReport(reportData));
   if (!contentCheck.ok) {
     console.error(`
@@ -125453,21 +125568,21 @@ function buildGoogleAdsDiagnosisCollectPayload(opts) {
 }
 
 // src/commands/google-ads-diagnosis/collect-integrity.ts
-function asRecord5(value) {
+function asRecord6(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
   return null;
 }
 function itemCount(block) {
-  const items = asRecord5(block)?.items;
+  const items = asRecord6(block)?.items;
   return Array.isArray(items) ? items.length : 0;
 }
 function getCollectIntegrityWarnings(reportData) {
   const warnings = [];
   const kwItems = itemCount(reportData.keywords);
   const fullKwItems = itemCount(reportData.fullKeywords);
-  const keywordCount = Number(asRecord5(reportData.structure)?.keywordCount ?? 0);
+  const keywordCount = Number(asRecord6(reportData.structure)?.keywordCount ?? 0);
   if (kwItems === 0 && fullKwItems > 0) {
     warnings.push(
       `keywords.items \u5BF9\u6BD4\u8868\u4E3A\u7A7A\uFF0C\u4F46 fullKeywords.items \u6709 ${fullKwItems} \u884C\uFF1B\u8BF7\u786E\u8BA4 collect \u662F\u5426\u6210\u529F\u62C9\u53D6\u4E0A\u4E00\u5468\u671F keywords \u5FEB\u7167\uFF08\u73AF\u6BD4\u5217\u4F9D\u8D56 prev \u5468\u671F JSON\uFF09\u3002`
@@ -125478,7 +125593,7 @@ function getCollectIntegrityWarnings(reportData) {
     );
   }
   const campaignItems = itemCount(reportData.campaigns);
-  const campaignCount = Number(asRecord5(reportData.structure)?.campaignCount ?? 0);
+  const campaignCount = Number(asRecord6(reportData.structure)?.campaignCount ?? 0);
   if (campaignItems === 0 && campaignCount > 0) {
     warnings.push(
       `campaigns.items \u5BF9\u6BD4\u8868\u4E3A\u7A7A\uFF0C\u4F46 structure.campaignCount=${campaignCount}\uFF1B\u8BF7\u786E\u8BA4\u4E0A\u4E00\u5468\u671F campaigns \u5FEB\u7167\u662F\u5426\u62C9\u53D6\u6210\u529F\u3002`
@@ -125682,7 +125797,7 @@ import fs18 from "fs/promises";
 import path23 from "path";
 
 // src/commands/google-ads-diagnosis/report-content.ts
-function asRecord6(value) {
+function asRecord7(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125691,7 +125806,7 @@ function asRecord6(value) {
 function getNestedValue(root, path34) {
   let cur = root;
   for (const key of path34) {
-    const rec = asRecord6(cur);
+    const rec = asRecord7(cur);
     if (!rec) return void 0;
     cur = rec[key];
   }
@@ -125708,7 +125823,7 @@ function validateBudgetCompetitivenessStrategies(data) {
   }
   const warnings = [];
   for (let i = 0; i < items.length; i++) {
-    const row = asRecord6(items[i]);
+    const row = asRecord7(items[i]);
     const name2 = String(row?.name ?? row?.metric ?? i);
     if (!hasNarrativeContent(row?.strategy)) {
       warnings.push(`budgetCompetitiveness[${name2}].strategy \u4E3A\u7A7A\uFF08\u987B\u7531 Agent \u586B\u5199\uFF09`);
@@ -125717,13 +125832,13 @@ function validateBudgetCompetitivenessStrategies(data) {
   return warnings;
 }
 function validateNewFeatureRecommendations(data) {
-  const nf = asRecord6(data.newFeatures);
+  const nf = asRecord7(data.newFeatures);
   if (!nf) return [];
   const items = nf.items;
   if (!Array.isArray(items)) return [];
   const warnings = [];
   for (let i = 0; i < items.length; i++) {
-    const row = asRecord6(items[i]);
+    const row = asRecord7(items[i]);
     const name2 = String(row?.strategyName ?? row?.feature ?? row?.strategy ?? i);
     if (!hasNarrativeContent(row?.optimizerRecommendation)) {
       warnings.push(`newFeatures.items[${name2}].optimizerRecommendation \u4E3A\u7A7A\uFF08\u987B\u7531 Agent \u586B\u5199\uFF09`);
@@ -125732,13 +125847,13 @@ function validateNewFeatureRecommendations(data) {
   return warnings;
 }
 function validateAdCreativeItemSuggestions(data) {
-  const creative = asRecord6(data.adCreativeOptimization);
+  const creative = asRecord7(data.adCreativeOptimization);
   if (!creative) return [];
   const items = creative.items;
   if (!Array.isArray(items) || items.length === 0) return [];
   const warnings = [];
   for (let i = 0; i < items.length; i++) {
-    const row = asRecord6(items[i]);
+    const row = asRecord7(items[i]);
     const title = String(row?.adTitle ?? i);
     if (!hasNarrativeContent(row?.suggestion ?? row?.suggestions)) {
       warnings.push(
@@ -125753,7 +125868,7 @@ function validateGoogleAdsDiagnosisContent(data) {
     (key) => data[key] === void 0
   );
   const warnings = [];
-  const accountInfo = asRecord6(data.accountInfo);
+  const accountInfo = asRecord7(data.accountInfo);
   if (accountInfo && !accountInfo.companyName && !accountInfo.period) {
     warnings.push("accountInfo \u7F3A\u5C11 companyName \u4E0E period\uFF0C\u9875\u7709\u53EF\u80FD\u4E3A\u7A7A");
   }
@@ -125801,7 +125916,7 @@ var GOOGLE_ADS_DIAGNOSIS_RESTORE_ITEM_MODULES = [
   GOOGLE_ADS_DIAGNOSIS_BIDDING_STRATEGY_MODULE,
   GOOGLE_ADS_DIAGNOSIS_NEW_FEATURES_MODULE
 ];
-function asRecord7(value) {
+function asRecord8(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125812,7 +125927,7 @@ function isValidRateChange(value) {
   return typeof value === "number" && Number.isFinite(value);
 }
 function isComparisonTableRowValid(row) {
-  const rec = asRecord7(row);
+  const rec = asRecord8(row);
   if (!rec) return false;
   if (!String(rec.title ?? "").trim()) return false;
   if (!Number.isFinite(Number(rec.currentCost))) return false;
@@ -125824,12 +125939,12 @@ function isComparisonTableRowValid(row) {
   return true;
 }
 function isNewFeatureRowValid(row) {
-  const rec = asRecord7(row);
+  const rec = asRecord8(row);
   if (!rec) return false;
   return Boolean(String(rec.strategyName ?? rec.feature ?? rec.strategy ?? "").trim());
 }
 function isBiddingStrategyRowValid(row) {
-  const rec = asRecord7(row);
+  const rec = asRecord8(row);
   if (!rec) return false;
   if (!String(rec.campaignName ?? "").trim()) return false;
   if (!Number.isFinite(Number(rec.duration)) || Number(rec.duration) <= 0) return false;
@@ -125867,11 +125982,11 @@ function getFactItemsErrors(data) {
   for (const mod of GOOGLE_ADS_DIAGNOSIS_RESTORE_ITEM_MODULES) {
     const validator = MODULE_ITEM_VALIDATORS[mod];
     const hint = MODULE_ITEM_ERROR_HINT[mod];
-    const block = asRecord7(data[mod]);
+    const block = asRecord8(data[mod]);
     const items = block?.items;
     if (!Array.isArray(items) || items.length === 0) {
       if (mod === "keywords") {
-        const fullKw = asRecord7(data.fullKeywords)?.items;
+        const fullKw = asRecord8(data.fullKeywords)?.items;
         if (Array.isArray(fullKw) && fullKw.length > 0) {
           errors.push(
             "keywords.items \u4E3A\u7A7A\u4F46 fullKeywords.items \u6709\u6570\u636E\uFF1B\u8BF7\u4FDD\u7559\u540C\u76EE\u5F55 google-ads-diagnosis-collect.json \u540E\u91CD\u65B0 render\uFF08\u4F1A\u81EA\u52A8\u6062\u590D\u5BF9\u6BD4\u8868\uFF09"
@@ -125896,15 +126011,15 @@ var LANDING_PAGE_SPEED_KEYS = [
   "speedIndex"
 ];
 function isLandingPageSpeedValid(value) {
-  const rec = asRecord7(value);
+  const rec = asRecord8(value);
   if (!rec) return false;
   return LANDING_PAGE_SPEED_KEYS.every(
     (key) => typeof rec[key] === "number" && Number.isFinite(rec[key])
   );
 }
 function restoreLandingPageSpeedFromCollect(finalData, collectReportData) {
-  const finalBlock = asRecord7(finalData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
-  const collectBlock = asRecord7(collectReportData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
+  const finalBlock = asRecord8(finalData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
+  const collectBlock = asRecord8(collectReportData[GOOGLE_ADS_DIAGNOSIS_LANDING_PAGE_MODULE]);
   if (!collectBlock) return { data: finalData, restored: false };
   const needsDesktop = !isLandingPageSpeedValid(finalBlock?.desktop) && isLandingPageSpeedValid(collectBlock.desktop);
   const needsMobile = !isLandingPageSpeedValid(finalBlock?.mobile) && isLandingPageSpeedValid(collectBlock.mobile);
@@ -125922,8 +126037,8 @@ function mergeComparisonItemsFromCollect(finalData, collectReportData) {
   const restoredModules = [];
   for (const mod of GOOGLE_ADS_DIAGNOSIS_RESTORE_ITEM_MODULES) {
     const validator = MODULE_ITEM_VALIDATORS[mod];
-    const finalBlock = asRecord7(data[mod]);
-    const collectBlock = asRecord7(collectReportData[mod]);
+    const finalBlock = asRecord8(data[mod]);
+    const collectBlock = asRecord8(collectReportData[mod]);
     const finalItems = finalBlock?.items;
     const collectItems = collectBlock?.items;
     if (!Array.isArray(collectItems) || collectItems.length === 0) continue;
@@ -125939,7 +126054,7 @@ function mergeComparisonItemsFromCollect(finalData, collectReportData) {
 }
 
 // src/commands/google-ads-diagnosis/narrative-consistency-check.ts
-function asRecord8(value) {
+function asRecord9(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -125947,14 +126062,14 @@ function asRecord8(value) {
 }
 function collectNarrativeTexts(data) {
   const texts = [];
-  const summary = asRecord8(data.summary);
+  const summary = asRecord9(data.summary);
   if (Array.isArray(summary?.keyIssues)) {
     for (const item of summary.keyIssues) texts.push(String(item ?? ""));
   }
-  const overview = asRecord8(data.diagnosisOverview);
+  const overview = asRecord9(data.diagnosisOverview);
   if (Array.isArray(overview?.disadvantages)) {
     for (const item of overview.disadvantages) {
-      const rec = asRecord8(item);
+      const rec = asRecord9(item);
       if (rec) {
         texts.push(String(rec.title ?? ""), String(rec.description ?? ""));
       } else {
@@ -125965,16 +126080,16 @@ function collectNarrativeTexts(data) {
   return texts.filter((t) => t.trim().length > 0);
 }
 function newFeatureAccountStatus(data, strategy) {
-  const nf = asRecord8(data.newFeatures);
+  const nf = asRecord9(data.newFeatures);
   const items = nf?.items;
   if (!Array.isArray(items)) return null;
-  const row = items.find((it) => asRecord8(it)?.strategy === strategy);
-  const rec = asRecord8(row);
+  const row = items.find((it) => asRecord9(it)?.strategy === strategy);
+  const rec = asRecord9(row);
   if (!rec || typeof rec.accountStatus !== "boolean") return null;
   return rec.accountStatus;
 }
 function goldAccountFlag(data, key) {
-  const gold = asRecord8(data.goldAccount);
+  const gold = asRecord9(data.goldAccount);
   const value = gold?.[key];
   return typeof value === "boolean" ? value : null;
 }
@@ -126005,7 +126120,7 @@ function getNarrativeConsistencyErrors(data) {
 }
 
 // src/commands/google-ads-diagnosis/render-report.ts
-function asRecord9(value) {
+function asRecord10(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126014,8 +126129,8 @@ function asRecord9(value) {
 async function tryLoadCollectReportData(collectPath) {
   try {
     const raw = JSON.parse(await fs18.readFile(collectPath, "utf8"));
-    const root = asRecord9(raw);
-    const reportData = asRecord9(root?.reportData);
+    const root = asRecord10(raw);
+    const reportData = asRecord10(root?.reportData);
     return reportData ?? root;
   } catch {
     return null;
@@ -126032,7 +126147,7 @@ async function runGoogleAdsDiagnosisRender(opts) {
 `);
     process.exit(1);
   }
-  let data = asRecord9(dataRaw);
+  let data = asRecord10(dataRaw);
   if (!opts.noMergeCollect) {
     const collectPath = path23.resolve(
       opts.collectFile ?? path23.join(path23.dirname(dataPath), GOOGLE_ADS_DIAGNOSIS_COLLECT_BASENAME)
@@ -126545,7 +126660,7 @@ function ensureScorecardFromSnapshot(healthDiagnosis, merged) {
 }
 
 // src/commands/facebook-analysis/merge-snapshot.ts
-function asRecord10(value) {
+function asRecord11(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126594,7 +126709,7 @@ async function readManifest(snapshotDir) {
 async function loadSectionFile(snapshotDir, file) {
   try {
     const raw = await fs21.readFile(path28.join(snapshotDir, file), "utf8");
-    return asRecord10(JSON.parse(raw));
+    return asRecord11(JSON.parse(raw));
   } catch {
     return null;
   }
@@ -126642,7 +126757,7 @@ async function mergeFacebookSnapshotIntoReport(payload, snapshotDir) {
     if (data) sectionMap.set(art.section, data);
   }
   const overview = sectionMap.get("overview");
-  const current = asRecord10(overview?.currentPeriod);
+  const current = asRecord11(overview?.currentPeriod);
   const accountName = typeof overview?.accountName === "string" ? overview.accountName : void 0;
   const accountId = manifest.accountId ?? (typeof overview?.accountId === "string" ? overview.accountId : void 0);
   const kpis = { ...payload.kpis ?? {} };
@@ -126764,7 +126879,7 @@ function isFiniteNumber(value) {
 function asArray2(value) {
   return Array.isArray(value) ? value : [];
 }
-function asRecord11(value) {
+function asRecord12(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -126776,26 +126891,26 @@ function pushMissing(missing, id, chapter, dimension, hint) {
 function countAdSetsWithSpend(tables) {
   const rows = asArray2(tables?.adSets);
   return rows.filter((row) => {
-    const r = asRecord11(row);
+    const r = asRecord12(row);
     const spend = r?.spend;
     return isFiniteNumber(spend) && spend > 0;
   }).length;
 }
 function chartLabels(chart) {
-  const c = asRecord11(chart);
+  const c = asRecord12(chart);
   return asArray2(c?.labels).length;
 }
 function validateMetaPeriodReportContent(data) {
   const missing = [];
-  const meta = asRecord11(data.meta) ?? {};
-  const kpis = asRecord11(data.kpis) ?? {};
-  const narrative = asRecord11(data.narrative) ?? {};
-  const tables = asRecord11(data.tables);
-  const charts = asRecord11(data.charts);
-  const sections = asRecord11(data.sections);
-  const health = asRecord11(data.healthDiagnosis);
-  const priorityPlan = asRecord11(data.priorityPlan);
-  const actionChecklist = asRecord11(data.actionChecklist);
+  const meta = asRecord12(data.meta) ?? {};
+  const kpis = asRecord12(data.kpis) ?? {};
+  const narrative = asRecord12(data.narrative) ?? {};
+  const tables = asRecord12(data.tables);
+  const charts = asRecord12(data.charts);
+  const sections = asRecord12(data.sections);
+  const health = asRecord12(data.healthDiagnosis);
+  const priorityPlan = asRecord12(data.priorityPlan);
+  const actionChecklist = asRecord12(data.actionChecklist);
   const adSetsWithSpend2 = countAdSetsWithSpend(tables ?? void 0);
   const regionalNarratives = asArray2(narrative.regional).length;
   const recommendations = asArray2(narrative.recommendations);
@@ -126867,7 +126982,7 @@ function validateMetaPeriodReportContent(data) {
       "charts.audience.labels \u81F3\u5C11 1 \u9879"
     );
   }
-  const funnel = asRecord11(charts?.funnel);
+  const funnel = asRecord12(charts?.funnel);
   if (!isFiniteNumber(funnel?.reach)) {
     pushMissing(
       missing,
@@ -126931,7 +127046,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < regionalNarratives; i++) {
-      const row = asRecord11(asArray2(narrative.regional)[i]);
+      const row = asRecord12(asArray2(narrative.regional)[i]);
       if (textLen2(row?.text) < 80) {
         pushMissing(
           missing,
@@ -126961,7 +127076,7 @@ function validateMetaPeriodReportContent(data) {
       "\u5FC5\u987B\u6070\u597D 4 \u6761\uFF08\u7B80\u5316\u8868\u5355/\u533A\u57DF\u8C03\u6574/\u9884\u7B97\u91CD\u6784/\u7D20\u6750\u5EFA\u8BAE\uFF09"
     );
   } else {
-    const titles = recommendations.map((r) => asRecord11(r)?.title);
+    const titles = recommendations.map((r) => asRecord12(r)?.title);
     for (const title of RECOMMENDATION_TITLES) {
       if (!titles.includes(title)) {
         pushMissing(
@@ -126974,7 +127089,7 @@ function validateMetaPeriodReportContent(data) {
       }
     }
     for (let i = 0; i < recommendations.length; i++) {
-      const rec = asRecord11(recommendations[i]);
+      const rec = asRecord12(recommendations[i]);
       if (textLen2(rec?.content) < 150) {
         pushMissing(
           missing,
@@ -126996,7 +127111,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < supplementary.length; i++) {
-      const row = asRecord11(supplementary[i]);
+      const row = asRecord12(supplementary[i]);
       if (!textLen2(row?.dimension) || !textLen2(row?.issue)) {
         pushMissing(
           missing,
@@ -127078,7 +127193,7 @@ function validateMetaPeriodReportContent(data) {
     );
   } else {
     for (let i = 0; i < fourQuestions.length; i++) {
-      const q = asRecord11(fourQuestions[i]);
+      const q = asRecord12(fourQuestions[i]);
       const evidence = asArray2(q?.evidence).filter((e) => textLen2(e) > 0);
       if (evidence.length < 2) {
         pushMissing(
@@ -127102,7 +127217,7 @@ function validateMetaPeriodReportContent(data) {
   }
   let scorecardValidRows = 0;
   for (let i = 0; i < scorecard.length; i++) {
-    const row = asRecord11(scorecard[i]);
+    const row = asRecord12(scorecard[i]);
     const itemOk = textLen2(row?.item) > 0;
     const dataOk = textLen2(row?.data) > 0;
     const signalOk = SCORECARD_SIGNALS.includes(row?.signal);
@@ -127144,7 +127259,7 @@ function validateMetaPeriodReportContent(data) {
     );
   }
   for (const key of ["platform", "country", "adSets"]) {
-    const insight = textLen2(asRecord11(sections?.[key])?.insight);
+    const insight = textLen2(asRecord12(sections?.[key])?.insight);
     if (insight < 200) {
       pushMissing(
         missing,
@@ -127155,7 +127270,7 @@ function validateMetaPeriodReportContent(data) {
       );
     }
   }
-  const audience = asRecord11(sections?.audience);
+  const audience = asRecord12(sections?.audience);
   if (asArray2(audience?.goldenProfile).filter((s) => textLen2(s) > 0).length < 3) {
     pushMissing(
       missing,
@@ -127183,7 +127298,7 @@ function validateMetaPeriodReportContent(data) {
       "\u2265150 \u5B57"
     );
   }
-  const landingRows = asArray2(asRecord11(sections?.landingPage)?.rows);
+  const landingRows = asArray2(asRecord12(sections?.landingPage)?.rows);
   if (landingRows.length < 3) {
     pushMissing(
       missing,
@@ -127268,7 +127383,7 @@ async function readJsonFile2(filePath) {
     throw new Error(`\u65E0\u6CD5\u89E3\u6790 JSON\uFF1A${filePath}`);
   }
 }
-function asRecord12(value) {
+function asRecord13(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
   }
@@ -127283,7 +127398,7 @@ function injectReportData2(html, payload) {
 }
 async function runFacebookAnalysisRender(opts) {
   const dataPath = path29.resolve(opts.dataFile);
-  let data = asRecord12(await readJsonFile2(dataPath));
+  let data = asRecord13(await readJsonFile2(dataPath));
   if (opts.snapshotDir?.trim()) {
     data = await mergeFacebookSnapshotIntoReport(data, path29.resolve(opts.snapshotDir));
   }

package/dist/skill/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 <!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}}；构建时由 gen-skill-docs.mjs 合并 -->
 
-> **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
+> **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。向用户回复时另 Read `references/core/user-communication-guide.md`（伙伴式沟通：结论先行、先执行后解释、禁止机械贴 CLI/编号）。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
 >
 > **报告 / 分析类统一消歧（必读）**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 月报 / 周报」等，或对象不清（只有「帮我出份报告」）→ **必须先 Read `references/core/intent-routing.md`**。**§零 优先**：**网址/域名/官网/链接 + 诊断类词**（含用户说的「网络诊断/网络检测」）→ **直接 P8**，禁止走 P9/P1。**§零·B 次优先**：未命中 §零 的**行业/市场分析报告**（行业分析、市场分析、行业分析报告、「写一份 XX 行业报告」、战略/KA 市场报告、竞品/GTM 等，**无论是否提及丝路赞/广告**）→ **100% 走 P9 `market-analysis collect`+`render`**，**禁止**纯 WebSearch/WebFetch 在对话里写 Markdown/HTML 当终稿，**禁止**改走 P8/P1/P4/W5。**§零·C 关键词规划**：**拓词 / Keyword Planner / 长尾关键词 / 月搜索量 / 竞争度 / 核心词扩词**（含读 URL/文章后出 Google 词表，**无论是否提及丝路赞/账户**）→ **100% 走 W5 `keyword suggest --google-only --json-out`**，**禁止** WebSearch 编造搜索量。再按 §一 定唯一工作流。**禁止**见「报告」就默认 P4 周期或 P1 诊断。
 >

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.35-beta.5",
-  "publishedAt": 1783330558539
+  "version": "1.1.36-beta.1",
+  "publishedAt": 1783409684521
 }

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

@@ -250,4 +250,4 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 | 否词误填                | `KeywordsForBatchJob` 含常见否词词根或与 `NegativeKeywordsForBatchJob` 重复 → **warnings**（不阻断，须 Agent 修正后再 create） |
 | 实务                    | 日期格式与先后、出价策略与配套字段一致                                                                                         |
 
-`ad campaign-validate` 通过不保证 BatchJob 成功（例如仅写 `DestinationUrl` 未写 `Finalurl` 时 validate 仍可能 ✅）。异步结果用 `ad batch get` 轮询；`HasFailed` / 部分失败时用 `ad batch diff` 对照 JSON 补缺，系列级失败时改 JSON 重提，勿在半成品上反复整包创建。写操作须 `--commit`，见 `references/google-ads/google-ads.md` § ad campaign-create。
+`ad campaign-validate` 通过不保证 BatchJob 成功（例如仅写 `DestinationUrl` 未写 `Finalurl` 时 validate 仍可能 ✅）。异步结果用 `ad batch get` 轮询；`HasFailed` / 部分失败时用 `ad batch diff` 对照 JSON 补缺，系列级失败时改 JSON 重提，勿在半成品上反复整包创建。**附加信息（Sitelink 等）batch 漏建时**：`batch diff` 后 **自动** `ad extension *` 补挂，勿仅询问用户（见 `references/google-ads/google-ads-campaign-plan.md` § batch diff 后自动补建）。写操作须 `--commit`，见 `references/google-ads/google-ads.md` § ad campaign-create。

package/dist/skill/references/README.md

@@ -8,6 +8,7 @@
 | ------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | `references/core/setup.md`                  | 安装、登录（手机验证码优先）、配置、更新                                                    |
 | `references/core/agent-conventions.md`      | **Agent 必读 · 唯一规则真相源**：加载纪律、数据处理协议、硬规范、时间/币种/批量、交付前自检 |
+| `references/core/user-communication-guide.md` | **用户回复风格**：结论先行、伙伴语气、自然语言路由；禁止机械贴 CLI/编号 |
 | `references/core/intent-routing.md`         | **报告 / 分析类统一消歧**：P1–P9 与 W3/W7 同义词、信号优先级、一次追问模板                  |
 | `references/core/tips.md`                   | `--json-out` 脚本食谱（node -e 示例、文件命名、分页）                                       |
 | `references/core/playbooks.md`              | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付）                        |

package/dist/skill/references/core/agent-conventions.md

@@ -13,6 +13,7 @@
 | 触发                                                                                               | 动作                                                                                                                                                                      |
 | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **新的用户任务 / 同对话内换话题**（新需求、新账户、新媒体、新报告类型；例：刚查余额 → 改问建系列） | 按 `SKILL.md` 路由表 **重新 Read** 该任务的「必读文档」与工作流卡片后再执行 CLI；**禁止**沿用上一任务的参数记忆——对话会被压缩，「读过」≠ 当前上下文仍含正确字段名与 flags |
+| **向用户回复结论、建议、诊断说明**（非纯静默跑命令）                                               | Read `references/core/user-communication-guide.md`：结论先行、伙伴语气、禁止机械贴 CLI/编号                                                                               |
 | **工作流编号不同**（P1→P3、P4→P5）                                                                 | 即使刚做过 P1，仍须 Read 新卡片及其必读文档                                                                                                                               |
 | **报告 / 分析类话术模糊**（只说「报告/诊断/分析/检测/监测」、对象不清）                            | **必须先 Read** `references/core/intent-routing.md`，定唯一 P*/W* 后再 Read 工作流卡片；**禁止**默认 P4 或 P1                                                             |
 | **专用 report-templates**（OKKI / 询盘分析 / 周期报告纲要）                                        | Read `references/report-templates/<名>.md` **全文**（与 `report-templates/<名>.md` 同源）；勿只凭 SKILL 摘要                                                              |
@@ -40,11 +41,11 @@
 
 **计划 → 确认 → 执行 → 验证 → 推测下一步**：
 
-1. 按上表 Read 当次任务 references → 用 `-h` 确认命令 → 向用户输出操作计划。
+1. 按上表 Read 当次任务 references → 用 `-h` 确认命令 → 向用户输出操作计划（**计划用业务语言一句带过**，详见 `user-communication-guide.md`）。
 2. 涉及写入/修改/删除的操作必须与用户确认；多数破坏性操作还需 `--commit`。
 3. 按计划执行，说明每步意图。
 4. 用成对的读命令复核写入结果；异步任务每 5s 轮询直到完成。
-5. 报告/Excel/含金额话术交付前，按本文件 **§七 交付前自检** 审阅最终产物。
+5. 报告/Excel/含金额话术交付前，按本文件 **§七 交付前自检** 审阅最终产物；**同时**按 `references/core/user-communication-guide.md` 组织面向用户的摘要（结论先行，禁止机械贴命令输出）。
 6. 全部完成后预测用户下一步操作。
 
 ### 执行模式速查

package/dist/skill/references/core/user-communication-guide.md

@@ -0,0 +1,112 @@
+# 用户沟通风格（Agent 回复规范）
+
+> **何时必读**：每个面向用户的任务（查数、诊断、报告、开户、优化、异常排查等）在**组织最终回复文字**前 Read 本文件。CLI 纪律、字段口径仍以 `agent-conventions.md` 为准；本文件只管**怎么说**，不管**怎么跑命令**。
+>
+> 产品背景见《丝路赞 TSO Agent 用户全链路引导方案》；此处为 Skill 可执行摘要，**禁止**向用户暴露 P1/W12/playbook 编号。
+
+---
+
+## 一、定位
+
+用户不会按开发者逻辑提问（不会说「执行 P4」或「查 campaignStatus」）。Agent 是**广告运营伙伴**，不是「等指令的工具」。
+
+| 避免（机械） | 改为（伙伴感） |
+| ------------ | -------------- |
+| 「请执行 `google-analysis --sections overview`」 | 「我先帮您拉一下账户整体数据，稍等。」 |
+| 「您需要先关联 Google 账户」 | 「我看了一下，您还没绑定 Google 账户。绑好后我就能帮你看投放数据和优化建议，要现在开始吗？」 |
+| 贴一整段 CLI stdout / JSON | **结论先行**，数字来自脚本，用业务语言概括 |
+| 连续反问 5 个技术参数 | **能推断就先做**；缺关键项只问 1～2 个，其余用合理默认并在结论里说明 |
+
+---
+
+## 二、回复结构（默认模板）
+
+**共情/确认 → 结论先行 → 数据支撑 → 行动建议 → 下一步**
+
+1. **共情/确认**：用一句话接住用户意图（「好的，我帮您看看…」「收到，我来排查一下…」）。
+2. **结论先行**：第一句给出可操作的判断（正常 / 有问题 / 原因是什么），不要让用户从表格里自己猜。
+3. **数据支撑**：引用**当次 CLI/脚本**的真实数字（消耗、CPA、余额、状态等）；禁止编造、禁止示例 ID。
+4. **行动建议**：1～3 条可执行项，点名对象（系列名、账户、关键词）并引用数据。
+5. **下一步**：一句预测或邀请（「要我帮您调整预算吗？」「还想看关键词明细吗？」）。
+
+长任务（预计 >30s）：中间用**进度式**短句（「正在拉取系列数据…」「正在检查余额…」），不要长时间沉默后突然扔一大段表。
+
+---
+
+## 三、先执行后解释（与纪律的平衡）
+
+| 场景 | 做法 |
+| ---- | ---- |
+| 查数、诊断、报告、列表 | **先拉数再汇报**；缺账户 ID 才问；缺时间范围按 `agent-conventions.md` §五 处理（能默认则默认并注明区间） |
+| 模糊意图（「帮我看一下」「最近怎么样」） | 选**最可能**的工作流先执行（有 Google 户 → 画像/总览）；结论后附「您是不是还想…」 |
+| **campaign-create 后 Sitelink 等附加信息 batch 失败** | **自动** `ad batch diff` → 执行 `ad extension *` 补建 → 汇报已补挂条数；**勿**反问「需要我现在补上吗？」（用户已确认过 JSON） |
+| 写入/删除/充值/开户提交 | **必须先确认**（`agent-conventions.md` §四）；话术用业务语言说明「将要做什么」 |
+| 对象不清且无法推断 | **只问一次**，给 2～3 个选项，不要问卷式连问 |
+
+---
+
+## 四、自然语言 ↔ 内部路由（对用户隐藏编号）
+
+对用户只说业务语言；内部仍按 `SKILL.md` + `intent-routing.md` 路由。
+
+| 用户可能说 | 内部路由（勿写出） | 对用户怎么说 |
+| ---------- | ------------------ | ------------ |
+| 帮我看一下 Google 广告 / 账户怎么样 | P1 / P3 + 余额 | 「我先看看您 Google 账户的整体情况。」 |
+| 广告怎么不跑了 / 没花费了 | 余额 + 系列状态 + 拒审 + 落地页 | 「我来帮您排查，通常是预算、状态或审核几类原因。」 |
+| 最近效果怎么样 / 出个月报 | P4 / P1 | 「我拉一下这段时间的数据，给您一份完整报告。」 |
+| 帮我优化一下 | W6 / 优化建议 | 「我先看看哪些广告表现偏弱，给您一份优化清单。」 |
+| 哪些账户快没钱了 | P2 balance-scan | 「正在扫描全部账户余额…」 |
+| 帮我开个户 / 建广告 | W2 / W3 | 「没问题，我先告诉您需要准备哪些资料。」 |
+| 网站行不行 | P8 | 「我来给这个网站做个体检，看是否符合投放要求。」 |
+
+完整话术矩阵见产品文档第十章；Skill 内记住**结构**即可，勿背诵全文。
+
+---
+
+## 五、场景话术要点（示例骨架）
+
+### 账户概览（正常）
+
+> 帮您看完了！「{账户名}」近 {N} 天花费 {金额}，点击 {次数}，转化 {次数}，CPA {金额}，余额 {金额}（预计还能跑 {天数} 天）。整体运行正常。要我深入看看有哪些可以优化的地方吗？
+
+### 投放异常（找到原因）
+
+> 帮您排查完了，找到原因了：
+>
+> **问题**：系列「{名称}」当前是「{campaignStatusDisplay}」，{一句话原因，如预算熔断/余额不足/被拒审}。
+>
+> **建议**：{1～2 条具体动作}
+>
+> 要我帮您{下一步动作}吗？
+
+### 数据不足 / 拉数失败
+
+> 这部分数据暂时拿不到（{简短原因}）。我已经把能查到的部分整理好了；{缺什么}需要您{补什么}后我再帮您查。
+
+### 用户说「不是这个意思」
+
+> 抱歉理解偏了！您方便再说一下具体想做什么吗？或者从下面选一个：{选项 A} / {选项 B}
+
+---
+
+## 六、禁止事项（机械感来源）
+
+- **禁止**把 playbook 编号、CLI 命令名、JSON 字段名当对用户的主回复内容（技术细节放代码块或附录，且仅在用户要「技术细节」时）。
+- **禁止**无结论的数据堆砌（大表前没有一句话总结）。
+- **禁止**每条 bullet 都是「建议优化」「请关注」而无数字、无对象名。
+- **禁止**用冷冰冰的系统提示语气（「操作失败」「参数错误」）而不给下一步。
+- **禁止**在报告/分析类任务里，用户未要求时输出冗长「执行计划」清单；计划可在脑中或简短一句带过，**尽快进入执行**。
+- 交付 HTML/Excel 时：附**3～5 行摘要**（区间、币种、核心 KPI、最大问题、建议动作），不要只丢文件路径。
+
+---
+
+## 七、与现有纪律的关系
+
+| 文档 | 分工 |
+| ---- | ---- |
+| `agent-conventions.md` | 怎么拉数、怎么读 outline、怎么自检、硬规范 |
+| `intent-routing.md` | 报告/分析消歧、选哪个 P/W |
+| `playbooks.md` / `workflows.md` | 步骤清单 |
+| **本文件** | **对用户怎么说** |
+
+数值纪律不变：所有金额、状态、ID 仍只来自当次 CLI/`--json-out` 脚本；本文件只约束**表述方式**，不放宽数据真实性要求。

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

@@ -74,8 +74,9 @@
   1. 地域 ID：`ad geo search -a <id> -q "United States"` 写入 `campaign.targetedLocations[].id`。
   2. 门禁：`ad campaign-validate --config-file ./campaign.json`（必跑）。
   3. 用户确认后创建：`ad campaign-create --config-file ./campaign.json`，记录返回 taskId。
-  4. 轮询：`ad batch get --id <taskId>`（Creating → Successfully）。
-  5. 复核：`ad campaigns -a <id> --json-out ./snap` 取 `campaignId` 供后续精细操作。
+  4. 轮询：`ad batch get --id <taskId>` 直至非 Creating。
+  5. **必做** `ad batch diff`；缺失的附加信息（Sitelink 等）**自动**用 `ad extension *` 补建，勿反问用户（见 `google-ads-campaign-plan.md` § batch diff 后自动补建）。
+  6. 复核：`ad campaigns` / `ad extension list` 确认系列与扩展齐全。
 - **精细管理与日常运营**：`ad adgroup-create` / `ad keyword-create` / `ad keyword-negative-create` / `ad ad-create`（拓词辅助见 **W5**）；调整用 `ad adgroup-status` / `ad campaign-status` / `ad ad-delete` / `ad keyword-negative-delete`。完整参数见 `references/google-ads/google-ads.md`。
 - **交付/确认**：关键词匹配格式 `running shoes`=广泛 / `"..."`=词组 / `[...]`=精确；结构性写操作（新建/暂停/删除）须用户确认；写后用成对读命令复核。
 

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

@@ -44,8 +44,8 @@
 | 6   | 输出：**JSON 代码块** → **Markdown**（`google-ads-launch-plan-template.md` 正文）→ 待确认                                                                            | —                                                                                 |
 | 7   | 用户确认后 **`ad campaign-create`**                                                                                                                                  | `references/google-ads/google-ads.md`                                             |
 | 8   | 每隔5s 获取创建结果                                                                                                                                                  | `ad batch get --id <taskId> --config-file ./campaign.json`                        |
-| 9   | 创建失败根据失败原因修改json重新走创建流程，部分成功/成功/部分失败：都调用来做最后一步调整 `ad batch diff --batch-id <taskId> --config-file ./campaign.json`         |                                                                                   |
-| 10  | 输出所有失败的内容与原因，并询问用户是否需要修改后单独添加到系列中如果用户要求是则读取 `references\references/google-ads/google-ads.md` 来获取对应缺失部分的创建命令 |
+| 9   | 成功或部分成功后 **`ad batch diff`** 对照 JSON 与账户实况                                                                                                              |                                                                                   |
+| 10  | **自动补建缺失项**（见下文「batch diff 后自动补建」）：附加信息（Sitelink/Callout 等）**直接**执行 `ad extension *`；组/词/RSA 用对应 create 命令。**勿**仅汇报失败并反问用户是否补建 | `references/google-ads/google-ads.md` § batch diff 后自动补建                     |
 
 多系列：每系列一个 JSON；可选 `campaign-manifest.json`（`role: brand|competitor|generic`）仅作文件组织参考。
 
@@ -108,6 +108,34 @@ validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 +
 
 ---
 
+## batch diff 后自动补建（Agent 必遵）
+
+`campaign-create` BatchJob **常漏附加信息**（尤其 Sitelink）；系列/组/关键词/RSA 已创建成功时，**不要**停在「需要我现在补上吗？」——用户确认 JSON 时已包含这些内容，Agent **应自动补建**。
+
+| 步骤 | 动作 |
+| ---- | ---- |
+| 1 | `ad batch get` 直至 `Successfully` 或 `HasFailed`（Creating 时每 5s 轮询） |
+| 2 | `ad batch diff --batch-id <taskId> --config-file ./campaign.json [--campaign-id <id>]` |
+| 3 | 读缺失明细（或 `--json-out` 落盘中的 `missing[]`）；每条 `extension` 层若有 `remediateCommand`，**直接执行** |
+| 4 | 无 `remediateCommand` 时，按 JSON 路径与 `google-ads.md` § 批量创建工作流 映射为 `ad extension sitelink` / `callout` / `call` / `snippet` |
+| 5 | 缺组/词/RSA/否词：用 `ad adgroup-create` / `keyword-create` / `ad-create` / `keyword-negative-create` 补建（补建前 `ad extension list` 等核对，避免重复） |
+| 6 | 全部补建后再 `ad batch diff` 或 `ad extension list --campaign-id <id>` 复核；汇总告诉用户「已自动补上 N 条 Sitelink」 |
+| 7 | 仅当补建命令也失败时，才向用户说明原因并给改写方案 |
+
+**Sitelink 单条示例**（字段来自 `ExtensionsForBatchJob[i].Properties`）：
+
+```bash
+siluzan-tso ad extension sitelink -a <accountId> \
+  --level Campaign --campaign-id <campaignId> \
+  --text "<Properties.Text>" --url "<Properties.DestinationUrl>" \
+  [--line2 "<Line2>"] [--line3 "<Line3>"] \
+  --json-out ./snap
+```
+
+**禁止**：系列主体已按计划建成，却因 Sitelink batch 失败就结束任务、等用户二次确认（除非用户明确说「先不要挂扩展」）。
+
+---
+
 ## 已上线后的修改
 
 - **勿**用 `campaign-create` 覆盖已有系列；用 `ad campaign-edit` / `adgroup-*` / `keyword-*` / `ad-edit` 等（见 `references/google-ads/google-ads.md`）。

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

@@ -371,8 +371,21 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json
 2. **仅少数组/资产失败**（系列与大部分组已有 `Id`）：
    - 缺组：`ad adgroup-create`（`--json-out` 取 `id`）
    - 缺词：`ad keyword-create`（词面格式同 JSON `KeywordsForBatchJob`）
-   - 缺 RSA：`ad ad-create`（`--headlines` / `--descriptions` 从 JSON `AdsForBatchJob` 抄）  
-     补建前可用 `ad groups` / `ad keywords` 核对账户现状。
+   - 缺 RSA：`ad ad-create`（`--headlines` / `--descriptions` 从 JSON `AdsForBatchJob` 抄）
+   - **缺附加信息（常见）**：**自动**执行 `ad extension sitelink` / `callout` / `call` / `snippet`（见下节）；`batch diff` 输出含 `补建:` 行或 `--json-out` 的 `missing[].remediateCommand`  
+     补建前可用 `ad groups` / `ad keywords` / `ad extension list` 核对账户现状。
+
+### batch diff 后自动补建附加信息（Agent 必遵）
+
+BatchJob 中 `ExtensionsForBatchJob`（尤其 **Sitelink**）失败率较高，但系列/组/词/RSA 往往已成功。用户确认创建时已认可 JSON 内全部附加信息 → Agent **须直接补建**，**禁止**仅汇报「Sitelink 未创建，需要我现在补上吗？」。
+
+1. 跑 `ad batch diff`；对 `layer=extension` 的缺失项执行输出中的 **`补建:`** 命令（或读落盘 `missing[].remediateCommand`）。
+2. 字段映射：`Properties.Text` + `DestinationUrl` → `ad extension sitelink`；`CALLOUT` → `callout`；`CALL` → `call`；`STRUCTURED_SNIPPET` → `snippet`（`StructuredSnippetHeaderValue`）。
+3. 系列级统一 `--level Campaign --campaign-id <id>`；每条 `--json-out ./snap`。
+4. 补建完成后 `ad extension list -a <accountId> --campaign-id <id> --type SITELINK` 复核条数。
+5. 向用户汇报：「系列已创建；Sitelink 等 X 条已通过单独命令补挂完成」（附系列 ID 与条数即可）。
+
+完整流水线见 `references/google-ads/google-ads-campaign-plan.md` § batch diff 后自动补建。
 
 **`ad batch diff` 比对维度：**系列是否存在 → 各 `AdGroupsForBatchJob[].Name` → 组内关键词（匹配类型+词面）→ RSA 首条标题 → 系列否定词 → 附加信息条数。默认按层级树状输出每条缺失的 **JSON 路径 + 计划内容 + 账户实况**；`--json-out` 可落盘完整结构。
 

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