siluzan-tso-cli 1.1.49-beta.2 → 1.1.49-beta.4

package/README.md

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

package/dist/index.js

@@ -117511,6 +117511,35 @@ function liveAdHasHeadline(ad, headline) {
   if (!h) return false;
   return collectRsaHeadlines(ad).includes(h);
 }
+function overlapHeadlineCount(planned, live) {
+  const liveSet = new Set(collectRsaHeadlines(live));
+  let n = 0;
+  for (const h of planned) {
+    const key = h.trim().toLowerCase();
+    if (key && liveSet.has(key)) n += 1;
+  }
+  return n;
+}
+function pickLiveAdForPlannedRsa(plannedHeadlines, primary, unmatchedLiveAds) {
+  if (unmatchedLiveAds.length === 0) return null;
+  const primaryKey = primary.trim().toLowerCase();
+  let bestIdx = -1;
+  let bestScore = 0;
+  for (let i = 0; i < unmatchedLiveAds.length; i++) {
+    const live = unmatchedLiveAds[i];
+    const overlap = overlapHeadlineCount(plannedHeadlines, live);
+    if (overlap <= 0) continue;
+    const hasPrimary = primaryKey.length > 0 && liveAdHasHeadline(live, primary);
+    const score = (hasPrimary ? 1e3 : 0) + overlap;
+    if (score > bestScore) {
+      bestScore = score;
+      bestIdx = i;
+    }
+  }
+  if (bestIdx < 0) return null;
+  const [picked] = unmatchedLiveAds.splice(bestIdx, 1);
+  return picked ?? null;
+}
 function livePoolHasText(pool, text2) {
   const t = text2.trim().toLowerCase();
   return t.length > 0 && pool.has(t);
@@ -117768,12 +117797,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
       const liveAdsInGroup = live.ads.filter(
         (a) => belongsToCampaign(a, campaignId, campaignName) && belongsToAdGroup(a, groupName, liveGroupId)
       );
-      const liveHeadlinePool = /* @__PURE__ */ new Set();
-      const liveDescPool = /* @__PURE__ */ new Set();
-      for (const la of liveAdsInGroup) {
-        for (const h of collectRsaHeadlines(la)) liveHeadlinePool.add(h);
-        for (const d of collectRsaDescriptions(la)) liveDescPool.add(d);
-      }
+      const unmatchedLiveAds = [...liveAdsInGroup];
       const ads = g["AdsForBatchJob"];
       if (Array.isArray(ads)) {
         for (let ai = 0; ai < ads.length; ai++) {
@@ -117783,11 +117807,14 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
           const primary = pickString2(ad["headlinePart1"], ad["AdTitle"]);
           const finalUrl = pickString2(ad["Finalurl"], ad["DestinationUrl"], ad["finalUrl"]);
           const rsaAssets = listPlannedRsaAssets(ad, groupPath, ai, groupName);
+          const plannedHeadlines = rsaAssets.filter((a) => a.kind === "headline").map((a) => a.text);
+          const adLabel = primary || `AdsForBatchJob[${ai}]`;
           if (groupAbsent) {
             pushItem(items3, {
               layer: "ad",
               path: path50,
               adGroupName: groupName,
+              adLabel,
               plannedContent: primary ? `RSA \u9996\u6807\u9898: ${primary}${finalUrl ? `  |  \u843D\u5730\u9875: ${finalUrl}` : ""}` : `AdsForBatchJob[${ai}]\uFF08\u7F3A\u5C11 headlinePart1\uFF09`,
               status: "skipped",
               liveNote: "\u5E7F\u544A\u7EC4\u672A\u521B\u5EFA\uFF0C\u8DF3\u8FC7\u521B\u610F\u6BD4\u5BF9",
@@ -117799,6 +117826,7 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
                 layer: "ad",
                 path: asset.path,
                 adGroupName: groupName,
+                adLabel,
                 plannedContent: `${label}: ${asset.text}`,
                 status: "skipped",
                 liveNote: "\u5E7F\u544A\u7EC4\u672A\u521B\u5EFA\uFF0C\u8DF3\u8FC7\u6587\u6848\u6BD4\u5BF9",
@@ -117807,11 +117835,15 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
             }
             continue;
           }
+          const matchedLive = pickLiveAdForPlannedRsa(plannedHeadlines, primary, unmatchedLiveAds);
+          const liveHeadlineSet = new Set(matchedLive ? collectRsaHeadlines(matchedLive) : []);
+          const liveDescSet = new Set(matchedLive ? collectRsaDescriptions(matchedLive) : []);
           if (!primary) {
             pushItem(items3, {
               layer: "ad",
               path: path50,
               adGroupName: groupName,
+              adLabel,
               plannedContent: `AdsForBatchJob[${ai}]\uFF08\u7F3A\u5C11 headlinePart1\uFF0C\u65E0\u6CD5\u6BD4\u5BF9\u6574\u6761 RSA\uFF09`,
               status: "missing",
               liveNote: `\u540C\u7EC4\u5DF2\u6709 ${liveAdsInGroup.length} \u6761\u521B\u610F`,
@@ -117819,41 +117851,44 @@ function compareCampaignCreateToLive(cfg, campaignId, live, meta) {
             });
             for (const asset of rsaAssets) {
               const label = asset.kind === "headline" ? "\u6807\u9898" : "\u63CF\u8FF0";
-              const pool = asset.kind === "headline" ? liveHeadlinePool : liveDescPool;
+              const pool = asset.kind === "headline" ? liveHeadlineSet : liveDescSet;
               const found = livePoolHasText(pool, asset.text);
               pushItem(items3, {
                 layer: "ad",
                 path: asset.path,
                 adGroupName: groupName,
+                adLabel,
                 plannedContent: `${label}: ${asset.text}`,
                 status: found ? "ok" : "missing",
-                liveNote: found ? `\u540C\u7EC4 RSA \u6587\u6848\u6C60\u5DF2\u542B\u6B64${label}` : `\u540C\u7EC4 RSA \u6587\u6848\u6C60\u672A\u89C1\u6B64${label}`,
+                liveNote: found ? `\u5DF2\u5728\u5BF9\u5E94 RSA \u4E0A\u627E\u5230\u6B64${label}` : `\u5BF9\u5E94 RSA \u672A\u89C1\u6B64${label}`,
                 summary: found ? `RSA ${label}\u5DF2\u751F\u6548\uFF1A${asset.text}` : `RSA ${label}\u672A\u751F\u6548\uFF1A${asset.text}`
               });
             }
             continue;
           }
-          const rsaFound = liveAdsInGroup.some((la) => liveAdHasHeadline(la, primary));
+          const rsaFound = matchedLive != null && liveAdHasHeadline(matchedLive, primary);
           pushItem(items3, {
             layer: "ad",
             path: path50,
             adGroupName: groupName,
+            adLabel,
             plannedContent: `RSA \u9996\u6807\u9898: ${primary}${finalUrl ? `  |  \u843D\u5730\u9875: ${finalUrl}` : ""}`,
             status: rsaFound ? "ok" : "missing",
-            liveNote: rsaFound ? `\u540C\u7EC4\u5DF2\u5339\u914D\u9996\u6807\u9898\uFF08\u5171 ${liveAdsInGroup.length} \u6761 RSA\uFF09` : `\u540C\u7EC4\u5DF2\u6709 ${liveAdsInGroup.length} \u6761 RSA\uFF0C\u65E0\u6B64\u9996\u6807\u9898`,
-            summary: rsaFound ? `RSA \u5DF2\u521B\u5EFA\uFF08\u9996\u6761\u6807\u9898\u300C${primary}\u300D\uFF09` : `RSA \u672A\u521B\u5EFA\uFF08\u9996\u6761\u6807\u9898\u300C${primary}\u300D\u5728\u8D26\u6237\u5185\u672A\u627E\u5230\uFF09`
+            liveNote: rsaFound ? `\u5DF2\u4E00\u5BF9\u4E00\u5339\u914D\u5230\u540C\u7EC4 RSA\uFF08\u6807\u9898\u91CD\u53E0 ${overlapHeadlineCount(plannedHeadlines, matchedLive)}\uFF09` : `\u540C\u7EC4 ${liveAdsInGroup.length} \u6761 RSA \u4E2D\u65E0\u6B64\u9996\u6807\u9898\uFF0C\u6216\u5DF2\u88AB\u5176\u5B83\u8BA1\u5212\u5E7F\u544A\u8BA4\u9886`,
+            summary: rsaFound ? `RSA \u5DF2\u521B\u5EFA\uFF08\u9996\u6761\u6807\u9898\u300C${primary}\u300D\uFF09` : `RSA \u672A\u521B\u5EFA\uFF08\u9996\u6761\u6807\u9898\u300C${primary}\u300D\u5728\u5BF9\u5E94\u5E7F\u544A\u4E0A\u672A\u627E\u5230\uFF09`
           });
           for (const asset of rsaAssets) {
             const label = asset.kind === "headline" ? "\u6807\u9898" : "\u63CF\u8FF0";
-            const pool = asset.kind === "headline" ? liveHeadlinePool : liveDescPool;
+            const pool = asset.kind === "headline" ? liveHeadlineSet : liveDescSet;
             const found = livePoolHasText(pool, asset.text);
             pushItem(items3, {
               layer: "ad",
               path: asset.path,
               adGroupName: groupName,
+              adLabel,
               plannedContent: `${label}: ${asset.text}`,
               status: found ? "ok" : "missing",
-              liveNote: found ? `\u540C\u7EC4 RSA \u6587\u6848\u6C60\u5DF2\u542B\u6B64${label}` : `\u540C\u7EC4 RSA \u6587\u6848\u6C60\u672A\u89C1\u6B64${label}\uFF08\u6C60\u5185 ${pool.size} \u6761\uFF09`,
+              liveNote: found ? `\u5DF2\u5728\u5BF9\u5E94 RSA \u4E0A\u627E\u5230\u6B64${label}` : `\u5BF9\u5E94 RSA \u672A\u89C1\u6B64${label}\uFF08\u8BE5\u5E7F\u544A\u6587\u6848 ${pool.size} \u6761\uFF09`,
               summary: found ? `RSA ${label}\u5DF2\u751F\u6548\uFF1A${asset.text}` : `RSA ${label}\u672A\u751F\u6548\uFF1A${asset.text}`
             });
           }
@@ -118035,6 +118070,7 @@ async function fetchLiveSnapshotForCampaign(config, accountId, campaignId, campa
   const params = new URLSearchParams();
   params.set("startDate", toGoogleDate(void 0, -30));
   params.set("endDate", toGoogleDate(void 0, 0));
+  params.set("newest", "true");
   const qs = params.toString();
   const [campaigns, adGroups, keywords, negativeKeywords, ads, extensions, targetedLocations] = await Promise.all([
     fetchList(
@@ -118353,13 +118389,31 @@ function buildCampaignCreateStatusMarkdown(result) {
         byGroup.set(key, list);
       }
       for (const [groupName, groupItems] of byGroup) {
-        const title = layer === "keyword" ? `## \u5E7F\u544A\u7EC4\u300C${groupName}\u300D\xB7 \u5173\u952E\u8BCD` : `## \u5E7F\u544A\u7EC4\u300C${groupName}\u300D\xB7 RSA \u6587\u6848`;
-        lines.push(title, ``);
-        lines.push(`| \u72B6\u6001 | \u8BA1\u5212\u5185\u5BB9 |`, `| --- | --- |`);
+        if (layer === "keyword") {
+          lines.push(`## \u5E7F\u544A\u7EC4\u300C${groupName}\u300D\xB7 \u5173\u952E\u8BCD`, ``);
+          lines.push(`| \u72B6\u6001 | \u8BA1\u5212\u5185\u5BB9 |`, `| --- | --- |`);
+          for (const item of groupItems) {
+            lines.push(`| ${statusLabel(item.status)} | ${mdCell(item.plannedContent)} |`);
+          }
+          lines.push(``);
+          continue;
+        }
+        lines.push(`## \u5E7F\u544A\u7EC4\u300C${groupName}\u300D\xB7 RSA \u6587\u6848`, ``);
+        const byAd = /* @__PURE__ */ new Map();
         for (const item of groupItems) {
-          lines.push(`| ${statusLabel(item.status)} | ${mdCell(item.plannedContent)} |`);
+          const key = item.adLabel ?? "\u2014";
+          const list = byAd.get(key) ?? [];
+          list.push(item);
+          byAd.set(key, list);
+        }
+        for (const [adLabel, adItems] of byAd) {
+          lines.push(`### \u5E7F\u544A\u300C${adLabel}\u300D`, ``);
+          lines.push(`| \u72B6\u6001 | \u8BA1\u5212\u5185\u5BB9 |`, `| --- | --- |`);
+          for (const item of adItems) {
+            lines.push(`| ${statusLabel(item.status)} | ${mdCell(item.plannedContent)} |`);
+          }
+          lines.push(``);
         }
-        lines.push(``);
       }
       continue;
     }
@@ -136024,6 +136078,7 @@ var BING_SECTIONS = [
   }
 ];
 var BING_SECTION_NAMES = BING_SECTIONS.map((s) => s.name);
+var BING_DEFAULT_SECTION_NAMES = BING_SECTION_NAMES.filter((name2) => name2 !== "audience-merged");
 var BING_SECTION_ALIASES = {
   devices: "device",
   geo: "geographic",
@@ -136031,6 +136086,19 @@ var BING_SECTION_ALIASES = {
 };
 
 // src/commands/bing-analysis/resolve-sections.ts
+var AUDIENCE_SPLIT_NAMES = [
+  "age-audience",
+  "gender-audience"
+];
+function dropMergedWhenSplitPresent(defs) {
+  const names = new Set(defs.map((d) => d.name));
+  const hasSplit = AUDIENCE_SPLIT_NAMES.some((n) => names.has(n));
+  if (!hasSplit || !names.has("audience-merged")) return defs;
+  console.error(
+    "\u5DF2\u8DF3\u8FC7 audience-merged\uFF08\u4E0E age-audience/gender-audience \u5E76\u884C\u4F1A\u89E6\u53D1 Bing SDK \u53D7\u4F17 csv \u6587\u4EF6\u9501\uFF09\u3002"
+  );
+  return defs.filter((d) => d.name !== "audience-merged");
+}
 function normalizeSectionToken2(raw) {
   const t = raw.trim();
   if (!t) return null;
@@ -136056,8 +136124,9 @@ function resolveSectionList3(sections, exclude) {
   }
   const includeCanonical = new Set(include.map((n) => normalizeSectionToken2(n)).filter(Boolean));
   const dropCanonical = new Set(dropRaw.map((n) => normalizeSectionToken2(n)).filter(Boolean));
-  const base = include.length > 0 ? BING_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...BING_SECTIONS];
-  return base.filter((s) => !dropCanonical.has(s.name));
+  const defaultSet = new Set(BING_DEFAULT_SECTION_NAMES);
+  const base = include.length > 0 ? BING_SECTIONS.filter((s) => includeCanonical.has(s.name)) : BING_SECTIONS.filter((s) => defaultSet.has(s.name));
+  return dropMergedWhenSplitPresent(base.filter((s) => !dropCanonical.has(s.name)));
 }
 
 // src/commands/bing-analysis/fetch.ts
@@ -136333,10 +136402,8 @@ async function fetchBingAudienceMergedPayload(config, id, startDate, endDate, ve
   const params = new URLSearchParams({ startDate, endDate });
   const ageUrl = reportingUrl(config, id, "AgeAudienceData", params.toString());
   const genderUrl = reportingUrl(config, id, "GenderAudienceData", params.toString());
-  const [ageData, genderData] = await Promise.all([
-    fetchBingJson(config, ageUrl, verbose),
-    fetchBingJson(config, genderUrl, verbose)
-  ]);
+  const ageData = await fetchBingJson(config, ageUrl, verbose);
+  const genderData = await fetchBingJson(config, genderUrl, verbose);
   return normalizeBingSectionPayload(
     {
       mergedParts: ["AgeAudienceData", "GenderAudienceData"],
@@ -136916,22 +136983,29 @@ function mapGeographicRows(payload) {
     (r) => pickMetrics(r, ["countryOrRegion", "countryCriteriaId", "regionName", "cityName"])
   );
 }
-function mapAudienceRows2(payload) {
+function mapAudienceLabelRows(payload, labelKey) {
   const obj = asRecord23(payload);
-  const data = asRecord23(obj?.data);
-  const ageAudience = asRecord23(data?.ageAudience);
-  const genderAudience = asRecord23(data?.genderAudience);
-  const audienceAge = asRows2(ageAudience?.audience).map((r) => {
+  return asRows2(obj?.audience).map((r) => {
     const m = pickMetrics(r, ["audience", "bidModifier"]);
-    m.ageRange = r.audience;
+    m[labelKey] = r.audience;
     return m;
   });
-  const audienceGender = asRows2(genderAudience?.audience).map((r) => {
-    const m = pickMetrics(r, ["audience", "bidModifier"]);
-    m.gender = r.audience;
-    return m;
-  });
-  return { audienceAge, audienceGender };
+}
+function mapAudienceFromMerged(payload) {
+  const data = asRecord23(asRecord23(payload)?.data);
+  return {
+    audienceAge: mapAudienceLabelRows(data?.ageAudience, "ageRange"),
+    audienceGender: mapAudienceLabelRows(data?.genderAudience, "gender")
+  };
+}
+function resolveAudienceTables(sectionMap) {
+  const fromMerged = mapAudienceFromMerged(sectionMap.get("audience-merged"));
+  const fromAge = mapAudienceLabelRows(sectionMap.get("age-audience"), "ageRange");
+  const fromGender = mapAudienceLabelRows(sectionMap.get("gender-audience"), "gender");
+  return {
+    audienceAge: fromMerged.audienceAge.length > 0 ? fromMerged.audienceAge : fromAge,
+    audienceGender: fromMerged.audienceGender.length > 0 ? fromMerged.audienceGender : fromGender
+  };
 }
 function mapCampaignRows2(payload) {
   return asRows2(payload).map((r) => ({
@@ -136954,19 +137028,30 @@ function mapAdGroupRows(payload) {
     ])
   );
 }
+function displayAdTitle(row) {
+  const raw = String(row.adTitle ?? "").trim();
+  if (raw) return { adTitle: raw, adTitleFallback: false };
+  const camp = String(row.campaignName ?? "").trim();
+  const group = String(row.adGroupName ?? "").trim();
+  const fallback = [camp, group].filter(Boolean).join(" / ");
+  return { adTitle: fallback, adTitleFallback: fallback.length > 0 };
+}
 function mapAdRows(payload) {
-  return asRows2(payload).map(
-    (r) => pickMetrics(r, [
+  return asRows2(payload).map((r) => {
+    const mapped = pickMetrics(r, [
       "campaignId",
       "campaignName",
       "adGroupId",
       "adGroupName",
       "adId",
-      "adTitle",
       "adType",
       "adStatus"
-    ])
-  );
+    ]);
+    const title = displayAdTitle(r);
+    mapped.adTitle = title.adTitle;
+    mapped.adTitleFallback = title.adTitleFallback;
+    return mapped;
+  });
 }
 function mapKeywordRows(payload) {
   return asRows2(payload).map((r) => {
@@ -137082,7 +137167,7 @@ async function mergeBingAnalysisSnapshotIntoReport(payload, snapshotDir) {
     const rows = mapGeographicRows(sectionMap.get("geographic"));
     if (rows.length > 0) tables.geographic = rows;
   }
-  const audienceMapped = mapAudienceRows2(sectionMap.get("audience-merged"));
+  const audienceMapped = resolveAudienceTables(sectionMap);
   if (audienceMapped.audienceAge.length > 0) tables.audienceAge = audienceMapped.audienceAge;
   if (audienceMapped.audienceGender.length > 0) {
     tables.audienceGender = audienceMapped.audienceGender;
@@ -137340,7 +137425,7 @@ function registerBatchCommand2(sectionHelp, aliasHelp) {
     "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF1B\u53EF\u542B\u6628\u5929/\u4ECA\u5929\uFF0C\u6570\u636E\u53EF\u80FD\u4E0D\u5B8C\u6574\uFF1B\u7701\u7565=\u622A\u81F3\u6628\u5929\u8FD1 7 \u5929\uFF09"
   ).option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option(
     "--sections <list>",
-    `\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,campaigns,keywords\uFF1B\u7701\u7565=\u5168\u90E8 11 \u4E2A\u3002\u53EF\u9009\uFF1A${sectionHelp}\uFF1B\u522B\u540D\uFF1A${aliasHelp}`
+    `\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,campaigns,keywords\uFF1B\u7701\u7565=\u9ED8\u8BA4 10 \u4E2A\uFF08\u4E0D\u542B audience-merged\uFF0C\u907F\u514D\u4E0E\u5E74\u9F84/\u6027\u522B\u7EF4\u62A2 Bing SDK \u53D7\u4F17 csv\uFF09\u3002\u53EF\u9009\uFF1A${sectionHelp}\uFF1B\u522B\u540D\uFF1A${aliasHelp}`
   ).option("--exclude <list>", "\u6392\u9664\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u4E0E --sections \u53EF\u53E0\u52A0").option(
     "--limit <n>",
     "\u4EC5 keywords / search-terms\uFF1A\u6761\u6570\u4E0A\u9650\uFF08\u9ED8\u8BA4 100\uFF0C\u4E0E\u524D\u7AEF KeywordReport/SearchQueryReport \u4E00\u81F4\uFF09",

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.49-beta.2",
-  "publishedAt": 1788233809334
+  "version": "1.1.49-beta.4",
+  "publishedAt": 1788313426269
 }

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

@@ -368,7 +368,7 @@ siluzan-tso tiktok-analysis official-report -a <mediaCustomerId> --json-out ./sn
 
 | 选项                       | 说明                                                                                                                                                                                                                                    |
 | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `--sections` / `--exclude` | `overview` `device` `geographic` `age-audience` `gender-audience` `audience-merged` `campaigns` `ad-groups` `ads` `keywords` `search-terms`（11 个）；**别名**：`devices`→`device`，`geo`→`geographic`，`search-queries`→`search-terms` |
+| `--sections` / `--exclude` | 可选 11 个：`overview` `device` `geographic` `age-audience` `gender-audience` `audience-merged` `campaigns` `ad-groups` `ads` `keywords` `search-terms`；**默认 10 个**（不含 `audience-merged`，勿与年龄/性别维同时拉）；**别名**：`devices`→`device`，`geo`→`geographic`，`search-queries`→`search-terms` |
 | `--limit`                  | 仅 `keywords` / `search-terms`：条数上限，默认 100                                                                                                                                                                                      |
 | `--start` / `--end`        | 同传或同省略；可含昨天/今天（可能不完整）；省略=截至昨天的近 7 天                                                                                                                                                                      |
 | `--concurrency`            | 默认 5，上限 16                                                                                                                                                                                                                         |
@@ -376,7 +376,7 @@ siluzan-tso tiktok-analysis official-report -a <mediaCustomerId> --json-out ./sn
 ```bash
 mkdir -p ./snap-bing
 
-# 全 11 维
+# 默认 10 维（含年龄/性别受众，不含 audience-merged）
 siluzan-tso bing-analysis -a <mediaCustomerId> --json-out ./snap-bing
 
 # 仅拉总览 + 关键词（limit 50）

package/dist/skill/references/report-templates/bing-period-report.md

@@ -13,7 +13,7 @@
 | `overview`                                               | 对象：`currentPeriod` / `previousPeriod` / `balance` / `averageDailyCost` … | → `meta` + `kpis`（环比、余额、日均）             |
 | `device`                                                 | `{ devices: Row[] }`                                                        | → `tables.devices[]`                              |
 | `geographic`                                             | `{ countries: Row[] }`                                                      | → `tables.geographic[]`                           |
-| `audience-merged`（或 `age-audience`/`gender-audience`） | `{ data: { ageAudience.audience[], genderAudience.audience[] } }`           | → `tables.audienceAge[]` / `audienceGender[]`     |
+| `age-audience` / `gender-audience`（默认）或 `audience-merged` | 拆分维 `{ audience: [] }`；merged `{ data: { ageAudience, genderAudience } }` | → `tables.audienceAge[]` / `audienceGender[]`（merged 空则回退拆分维） |
 | `campaigns`                                              | **根节点数组**                                                              | → `tables.campaigns[]`；**本期 KPI 优先由此累加** |
 | `ad-groups`                                              | **根节点数组**                                                              | → `tables.adGroups[]`（含 `qualityScore`）        |
 | `ads`                                                    | **根节点数组**                                                              | → `tables.ads[]`                                  |
@@ -28,7 +28,7 @@
 
 | 步骤             | 执行者       | 动作                                                                                                                                        |
 | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| **1. 拉数**      | Agent 调 CLI | `bing-analysis -a <id> --start <s> --end <e> --json-out ./snap-bing`（见下方「日期规则」，全 11 维或 `--sections` 指定子集）                |
+| **1. 拉数**      | Agent 调 CLI | `bing-analysis -a <id> --start <s> --end <e> --json-out ./snap-bing`（见下方「日期规则」，默认 10 维含年龄/性别、不含 `audience-merged`）                |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），把网关原始字段映射为下方 `tables.*` 契约，完成聚合与洞察                 |
 | **3. 写 JSON**   | Agent        | 撰写 `bing-period-report.json`：仅 `meta.accountId` + `narrative`（9 个分析小节）为必填；`kpis`/`tables` 可省略由 `--snapshot-dir` 自动合并 |
 | **4. 渲染 HTML** | CLI          | `bing-analysis render` — **校验 narrative 9 个分析小节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                        |
@@ -55,7 +55,7 @@ siluzan-tso bing-analysis render \
   - `audienceGender[]`：`{gender, spend, impressions, clicks, ctr, averageCpc, conversions}`
   - `campaigns[]`：`{campaignName, campaignStatus, campaignStatusDisplay, spend, impressions, clicks, ctr, conversions, costPerConversion}`
   - `adGroups[]`：`{adGroupName, campaignName, qualityScore, spend, clicks, ctr, conversions, costPerConversion}`
-  - `ads[]`：`{adTitle, adGroupName, adType, spend, clicks, ctr, conversions}`
+  - `ads[]`：`{adTitle, adGroupName, adType, spend, clicks, ctr, conversions}`（RSA 的报表 `adTitle` 常为空，`render` 用「系列 / 广告组」兜底展示并在表上方注明）
   - `keywords[]`：`{keyword, matchType, qualityScore, spend, ctr, averageCpc, conversions, costPerConversion}`
   - `searchTerms[]`：`{searchQuery, keyword, deliveredMatchType, spend, ctr, conversions, costPerConversion}`
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的叙事内容**）：
@@ -107,13 +107,13 @@ mkdir -p ./snap-bing
 
 siluzan-tso list-accounts -m BingV2 -k <mediaCustomerId> --json-out ./snap-bing
 
-# 一次批跑全部 11 维（等价于逐个 --sections 拉取，见下方速查表）
+# 一次批跑默认 10 维（含 age-audience / gender-audience，不含 audience-merged）
 siluzan-tso bing-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-bing
 siluzan-tso balance -m BingV2 --accounts <mediaCustomerId> --json-out ./snap-bing
 
-# 或仅拉本次报告所需维度（--sections 逗号分隔）
+# 或仅拉本次报告所需维度（--sections 逗号分隔；不要同时写拆分维和 audience-merged）
 siluzan-tso bing-analysis -a <mediaCustomerId> --start <S> --end <E> \
-  --sections overview,campaigns,device,geographic,audience-merged,ad-groups,ads,keywords,search-terms \
+  --sections overview,campaigns,device,geographic,age-audience,gender-audience,ad-groups,ads,keywords,search-terms \
   --limit 100 --json-out ./snap-bing
 ```
 
@@ -206,9 +206,9 @@ Bing 网关常不返回 `averageDailyCost`、`activeDays`（或为 0）。CLI
 
 ## 4. 受众
 
-- **CLI**：推荐 `bing-analysis --sections audience-merged`（年龄+性别合并 JSON）；或分别 `--sections age-audience` / `--sections gender-audience`
+- **CLI**：默认已含 `--sections age-audience,gender-audience`。不要与 `audience-merged` 同时拉（Bing SDK 会抢同一份受众 csv，merged 常 400）。`render --snapshot-dir` 优先 merged，空则回退拆分维。
 
-**数据呈现**：年龄段、性别的展示、点击、消耗、CTR、CPC（按 `data.ageAudience.audience` / `data.genderAudience.audience`）。写入 JSON `tables.audienceAge[]` / `tables.audienceGender[]`。
+**数据呈现**：年龄段、性别的展示、点击、消耗、CTR、CPC。拆分维读 `age-audience-*.json` / `gender-audience-*.json` 的 `audience[]`（标签字段 `audience`）。写入 JSON `tables.audienceAge[]`（`ageRange`）/ `tables.audienceGender[]`（`gender`）。
 
 **分析（必写）** → 写入 `narrative.sections.audience.{analysis,suggestions}`：
 
@@ -225,7 +225,7 @@ Bing 网关常不返回 `averageDailyCost`、`activeDays`（或为 0）。CLI
 | 广告组 | `bing-analysis --sections ad-groups` | `ad-groups-*.json`           |
 | 广告   | `bing-analysis --sections ads`       | `ads-*.json`                 |
 
-**数据呈现**：各表按消耗降序；系列含 `campaignStatus`；广告组可含质量分相关字段（以 outline 为准）。写入 JSON `tables.campaigns[]` / `tables.adGroups[]` / `tables.ads[]`。
+**数据呈现**：各表按消耗降序；系列含 `campaignStatus`；广告组可含质量分相关字段（以 outline 为准）。写入 JSON `tables.campaigns[]` / `tables.adGroups[]` / `tables.ads[]`。RSA 无创意标题时 HTML 仍展示「广告标题」列，内容为「系列 / 广告组」。
 
 **分析（必写，三个子块各写一段，不可合并为一句带过）**：
 

package/dist/skill/report-templates/bing-period-report.html

@@ -472,6 +472,9 @@
         color: var(--muted);
         flex: none;
       }
+      .empty-note + .table-wrap {
+        margin-top: 10px;
+      }
 
       @keyframes fadeInUp {
         from {
@@ -1022,6 +1025,10 @@
           const currency = currencyOf(data);
           const section = data.narrative?.sections?.ads;
           const sorted = topBySpend(rows, 10);
+          const usedFallback = sorted.some((r) => r.adTitleFallback);
+          const titleNotice = usedFallback
+            ? `<div class="empty-note">Bing 响应式搜索广告的报表不返回创意标题，本列用「系列 / 广告组」名称代替。</div>`
+            : "";
           const body = sorted
             .map(
               (r) => `<tr>
@@ -1038,6 +1045,7 @@
           const table =
             sorted.length > 0
               ? `<div class="card-title-row"><h3>广告 Top 10</h3><span class="hint">共 ${rows.length} 条广告，按消耗排序</span></div>
+${titleNotice}
 <div class="table-wrap"><table>
   <thead><tr><th>广告标题</th><th>广告组</th><th>广告类型</th><th class="num">消耗</th><th class="num">点击</th><th class="num">CTR</th><th class="num">转化</th></tr></thead>
   <tbody>${body}</tbody>

package/dist/skill/report-templates/bing-period-report.md

@@ -13,7 +13,7 @@
 | `overview`                                               | 对象：`currentPeriod` / `previousPeriod` / `balance` / `averageDailyCost` … | → `meta` + `kpis`（环比、余额、日均）             |
 | `device`                                                 | `{ devices: Row[] }`                                                        | → `tables.devices[]`                              |
 | `geographic`                                             | `{ countries: Row[] }`                                                      | → `tables.geographic[]`                           |
-| `audience-merged`（或 `age-audience`/`gender-audience`） | `{ data: { ageAudience.audience[], genderAudience.audience[] } }`           | → `tables.audienceAge[]` / `audienceGender[]`     |
+| `age-audience` / `gender-audience`（默认）或 `audience-merged` | 拆分维 `{ audience: [] }`；merged `{ data: { ageAudience, genderAudience } }` | → `tables.audienceAge[]` / `audienceGender[]`（merged 空则回退拆分维） |
 | `campaigns`                                              | **根节点数组**                                                              | → `tables.campaigns[]`；**本期 KPI 优先由此累加** |
 | `ad-groups`                                              | **根节点数组**                                                              | → `tables.adGroups[]`（含 `qualityScore`）        |
 | `ads`                                                    | **根节点数组**                                                              | → `tables.ads[]`                                  |
@@ -28,7 +28,7 @@
 
 | 步骤             | 执行者       | 动作                                                                                                                                        |
 | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| **1. 拉数**      | Agent 调 CLI | `bing-analysis -a <id> --start <s> --end <e> --json-out ./snap-bing`（见下方「日期规则」，全 11 维或 `--sections` 指定子集）                |
+| **1. 拉数**      | Agent 调 CLI | `bing-analysis -a <id> --start <s> --end <e> --json-out ./snap-bing`（见下方「日期规则」，默认 10 维含年龄/性别、不含 `audience-merged`）                |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），把网关原始字段映射为下方 `tables.*` 契约，完成聚合与洞察                 |
 | **3. 写 JSON**   | Agent        | 撰写 `bing-period-report.json`：仅 `meta.accountId` + `narrative`（9 个分析小节）为必填；`kpis`/`tables` 可省略由 `--snapshot-dir` 自动合并 |
 | **4. 渲染 HTML** | CLI          | `bing-analysis render` — **校验 narrative 9 个分析小节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                        |
@@ -55,7 +55,7 @@ siluzan-tso bing-analysis render \
   - `audienceGender[]`：`{gender, spend, impressions, clicks, ctr, averageCpc, conversions}`
   - `campaigns[]`：`{campaignName, campaignStatus, campaignStatusDisplay, spend, impressions, clicks, ctr, conversions, costPerConversion}`
   - `adGroups[]`：`{adGroupName, campaignName, qualityScore, spend, clicks, ctr, conversions, costPerConversion}`
-  - `ads[]`：`{adTitle, adGroupName, adType, spend, clicks, ctr, conversions}`
+  - `ads[]`：`{adTitle, adGroupName, adType, spend, clicks, ctr, conversions}`（RSA 的报表 `adTitle` 常为空，`render` 用「系列 / 广告组」兜底展示并在表上方注明）
   - `keywords[]`：`{keyword, matchType, qualityScore, spend, ctr, averageCpc, conversions, costPerConversion}`
   - `searchTerms[]`：`{searchQuery, keyword, deliveredMatchType, spend, ctr, conversions, costPerConversion}`
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的叙事内容**）：
@@ -107,13 +107,13 @@ mkdir -p ./snap-bing
 
 siluzan-tso list-accounts -m BingV2 -k <mediaCustomerId> --json-out ./snap-bing
 
-# 一次批跑全部 11 维（等价于逐个 --sections 拉取，见下方速查表）
+# 一次批跑默认 10 维（含 age-audience / gender-audience，不含 audience-merged）
 siluzan-tso bing-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-bing
 siluzan-tso balance -m BingV2 --accounts <mediaCustomerId> --json-out ./snap-bing
 
-# 或仅拉本次报告所需维度（--sections 逗号分隔）
+# 或仅拉本次报告所需维度（--sections 逗号分隔；不要同时写拆分维和 audience-merged）
 siluzan-tso bing-analysis -a <mediaCustomerId> --start <S> --end <E> \
-  --sections overview,campaigns,device,geographic,audience-merged,ad-groups,ads,keywords,search-terms \
+  --sections overview,campaigns,device,geographic,age-audience,gender-audience,ad-groups,ads,keywords,search-terms \
   --limit 100 --json-out ./snap-bing
 ```
 
@@ -206,9 +206,9 @@ Bing 网关常不返回 `averageDailyCost`、`activeDays`（或为 0）。CLI
 
 ## 4. 受众
 
-- **CLI**：推荐 `bing-analysis --sections audience-merged`（年龄+性别合并 JSON）；或分别 `--sections age-audience` / `--sections gender-audience`
+- **CLI**：默认已含 `--sections age-audience,gender-audience`。不要与 `audience-merged` 同时拉（Bing SDK 会抢同一份受众 csv，merged 常 400）。`render --snapshot-dir` 优先 merged，空则回退拆分维。
 
-**数据呈现**：年龄段、性别的展示、点击、消耗、CTR、CPC（按 `data.ageAudience.audience` / `data.genderAudience.audience`）。写入 JSON `tables.audienceAge[]` / `tables.audienceGender[]`。
+**数据呈现**：年龄段、性别的展示、点击、消耗、CTR、CPC。拆分维读 `age-audience-*.json` / `gender-audience-*.json` 的 `audience[]`（标签字段 `audience`）。写入 JSON `tables.audienceAge[]`（`ageRange`）/ `tables.audienceGender[]`（`gender`）。
 
 **分析（必写）** → 写入 `narrative.sections.audience.{analysis,suggestions}`：
 
@@ -225,7 +225,7 @@ Bing 网关常不返回 `averageDailyCost`、`activeDays`（或为 0）。CLI
 | 广告组 | `bing-analysis --sections ad-groups` | `ad-groups-*.json`           |
 | 广告   | `bing-analysis --sections ads`       | `ads-*.json`                 |
 
-**数据呈现**：各表按消耗降序；系列含 `campaignStatus`；广告组可含质量分相关字段（以 outline 为准）。写入 JSON `tables.campaigns[]` / `tables.adGroups[]` / `tables.ads[]`。
+**数据呈现**：各表按消耗降序；系列含 `campaignStatus`；广告组可含质量分相关字段（以 outline 为准）。写入 JSON `tables.campaigns[]` / `tables.adGroups[]` / `tables.ads[]`。RSA 无创意标题时 HTML 仍展示「广告标题」列，内容为「系列 / 广告组」。
 
 **分析（必写，三个子块各写一段，不可合并为一句带过）**：
 

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