siluzan-tso-cli 1.1.46 → 1.1.47-beta.2

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.47-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -4026,7 +4026,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -132184,23 +132184,6 @@ function formatLocalYmd(d) {
   const day = String(d.getDate()).padStart(2, "0");
   return `${y}-${m}-${day}`;
 }
-function bingRangeTouchesTodayOrYesterday(startDate, endDate) {
-  const s = parseLocalYmd(startDate);
-  const e = parseLocalYmd(endDate);
-  if (Number.isNaN(s.getTime()) || Number.isNaN(e.getTime()) || s > e) {
-    return true;
-  }
-  const today = stripLocalDate(/* @__PURE__ */ new Date());
-  const yesterday = new Date(today);
-  yesterday.setDate(yesterday.getDate() - 1);
-  for (let cur = new Date(s); cur <= e; cur.setDate(cur.getDate() + 1)) {
-    const c = stripLocalDate(cur);
-    if (c.getTime() === today.getTime() || c.getTime() === yesterday.getTime()) {
-      return true;
-    }
-  }
-  return false;
-}
 function resolveBingDateRange(start, end, allowToday = false) {
   if (start && end) {
     const s = parseLocalYmd(start);
@@ -132213,12 +132196,6 @@ function resolveBingDateRange(start, end, allowToday = false) {
       console.error("\n\u274C \u5F00\u59CB\u65E5\u671F\u4E0D\u80FD\u665A\u4E8E\u7ED3\u675F\u65E5\u671F\u3002\n");
       process.exit(1);
     }
-    if (!allowToday && bingRangeTouchesTodayOrYesterday(start, end)) {
-      console.error(
-        "\n\u274C Bing \u62A5\u8868\u65F6\u95F4\u8303\u56F4\u4E0D\u80FD\u5305\u542B\u300C\u4ECA\u5929\u300D\u6216\u300C\u6628\u5929\u300D\uFF08\u63A5\u53E3\u9650\u5236\uFF09\u3002\u8BF7\u6539\u7528\u66F4\u65E9\u7684\u7ED3\u675F\u65E5\u671F\uFF0C\u4F8B\u5982\u524D\u5929\u53CA\u4EE5\u524D\uFF1B\u82E5\u9700\u67E5\u4ECA\u5929/\u8FD1\u5B9E\u65F6\u6570\u636E\uFF0C\u5BF9 campaigns/ad-groups/ads \u4F20 --aggregation \u6216 --return-only-complete-data\u3002\n"
-      );
-      process.exit(1);
-    }
     return { startDate: start, endDate: end };
   }
   if (!start && !end) {
@@ -132227,13 +132204,13 @@ function resolveBingDateRange(start, end, allowToday = false) {
       return { startDate: today, endDate: today };
     }
     const endD = stripLocalDate(/* @__PURE__ */ new Date());
-    endD.setDate(endD.getDate() - 2);
+    endD.setDate(endD.getDate() - 1);
     const startD = new Date(endD);
     startD.setDate(startD.getDate() - 6);
     return { startDate: formatLocalYmd(startD), endDate: formatLocalYmd(endD) };
   }
   console.error(
-    "\n\u274C --start \u4E0E --end \u987B\u540C\u65F6\u4F20\u5165\uFF0C\u6216\u540C\u65F6\u7701\u7565\u4EE5\u4F7F\u7528\u9ED8\u8BA4\u533A\u95F4\uFF08\u622A\u81F3\u524D\u5929\u5171 7 \u5929\uFF09\u3002\n"
+    "\n\u274C --start \u4E0E --end \u987B\u540C\u65F6\u4F20\u5165\uFF0C\u6216\u540C\u65F6\u7701\u7565\u4EE5\u4F7F\u7528\u9ED8\u8BA4\u533A\u95F4\uFF08\u622A\u81F3\u6628\u5929\u5171 7 \u5929\uFF09\u3002\n"
   );
   process.exit(1);
 }
@@ -132304,9 +132281,6 @@ async function enrichBingOverviewPreviousPeriod(config, accountId, record2, star
   }
   const prevRange = calcBingPreviousPeriodRange(startDate, endDate);
   if (!prevRange) return record2;
-  if (bingRangeTouchesTodayOrYesterday(prevRange.startDate, prevRange.endDate)) {
-    return record2;
-  }
   try {
     const params = new URLSearchParams({
       startDate: prevRange.startDate,
@@ -133340,7 +133314,7 @@ function registerBatchCommand2(sectionHelp, aliasHelp) {
     "\u7ED3\u679C\u843D\u76D8\u76EE\u5F55\uFF1B\u6BCF\u7EF4\u5EA6 `<section>-<accountId>.json` + `report-manifest-<accountId>.json`"
   ).option("-t, --token <token>", "Auth Token").option(
     "--start <date>",
-    "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF1B\u4E0D\u53EF\u542B\u4ECA\u5929/\u6628\u5929\uFF0C\u9664\u975E\u4F20\u4E86 --aggregation \u6216 --return-only-complete-data\uFF09"
+    "\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}`
@@ -133350,10 +133324,10 @@ function registerBatchCommand2(sectionHelp, aliasHelp) {
     (v) => parseInt(v, 10)
   ).option("--concurrency <n>", "\u5E76\u53D1\u6570\uFF0C\u9ED8\u8BA4 5\uFF0C\u4E0A\u9650 16", (v) => parseInt(v, 10)).option(
     "--aggregation <value>",
-    "\u4EC5 campaigns/ad-groups/ads\uFF1A\u5B98\u65B9 ReportAggregation\uFF08Summary \u9ED8\u8BA4/Daily/Hourly/Weekly \u7B49\uFF09\uFF1B\u4F20\u5165\u540E\u81EA\u52A8\u5141\u8BB8\u65E5\u671F\u542B\u4ECA\u5929/\u6628\u5929\uFF0C\u7528\u4E8E\u8FD1\u5B9E\u65F6\u76D1\u63A7\u800C\u975Eperiodic\u62A5\u544A"
+    "\u4EC5 campaigns/ad-groups/ads\uFF1A\u5B98\u65B9 ReportAggregation\uFF08Summary \u9ED8\u8BA4/Daily/Hourly/Weekly \u7B49\uFF09\uFF1B\u4F20\u5165\u4E14\u7701\u7565\u65E5\u671F\u65F6\u9ED8\u8BA4\u4ECA\u5929\u5F53\u5929\uFF0C\u7528\u4E8E\u8FD1\u5B9E\u65F6\u76D1\u63A7"
   ).option(
     "--return-only-complete-data <bool>",
-    "\u4EC5 campaigns/ad-groups/ads\uFF1Atrue/false\uFF0C\u663E\u5F0F\u8986\u76D6\u7F51\u5173\u9ED8\u8BA4\u7684\u6309\u65E5\u671F\u81EA\u52A8\u5224\u65AD\uFF1B\u4F20\u5165\u540E\u81EA\u52A8\u5141\u8BB8\u65E5\u671F\u542B\u4ECA\u5929/\u6628\u5929"
+    "\u4EC5 campaigns/ad-groups/ads\uFF1Atrue/false\uFF0C\u663E\u5F0F\u8986\u76D6\u7F51\u5173\u6309\u65E5\u671F\u81EA\u52A8\u5224\u65AD\uFF1B\u542B\u6628\u5929/\u4ECA\u5929\u65F6\u4E0D\u8981\u4F20 true"
   ).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAllBingSections({
@@ -133367,7 +133341,7 @@ function registerBingAnalysisCommands(program2) {
   const sectionHelp = BING_SECTION_NAMES.join(", ");
   const aliasHelp = Object.keys(BING_SECTION_ALIASES).join(", ");
   const root = program2.command("bing-analysis").description(
-    "Bing\uFF08BingV2\uFF09\u8D26\u6237\u5206\u6790\uFF1A\u6279\u91CF\u62C9\u53D6 Section \u62A5\u8868\u6570\u636E\uFF08\u9ED8\u8BA4\uFF0C\u65E5\u671F\u4E0D\u53EF\u542B\u4ECA\u5929/\u6628\u5929\uFF0C\u4F20 --aggregation \u53EF\u89E3\u9501\uFF09\u3001\u7531 render \u751F\u6210 bing-period-report.html \u7EC8\u7A3F\uFF0C\u6216\u67E5\u8BE2\u8D26\u6237\u72B6\u6001/\u7CFB\u5217\u4E0E\u5E7F\u544A\u539F\u59CB\u5B9E\u4F53/\u62D2\u5BA1 Bulk \u5DE1\u68C0/IO/\u6708\u6D88\u8017"
+    "Bing\uFF08BingV2\uFF09\u8D26\u6237\u5206\u6790\uFF1A\u6279\u91CF\u62C9\u53D6 Section \u62A5\u8868\u6570\u636E\uFF08\u9ED8\u8BA4\u622A\u81F3\u6628\u5929\u8FD1 7 \u5929\uFF0C\u53EF\u542B\u6628\u5929/\u4ECA\u5929\uFF09\u3001\u7531 render \u751F\u6210 bing-period-report.html \u7EC8\u7A3F\uFF0C\u6216\u67E5\u8BE2\u8D26\u6237\u72B6\u6001/\u7CFB\u5217\u4E0E\u5E7F\u544A\u539F\u59CB\u5B9E\u4F53/\u62D2\u5BA1 Bulk \u5DE1\u68C0/IO/\u6708\u6D88\u8017"
   );
   root.addCommand(registerBatchCommand2(sectionHelp, aliasHelp), { isDefault: true });
   root.command("render").description(
@@ -134256,6 +134230,87 @@ function parseTikTokNumber(value) {
   const n = Number(value);
   return Number.isFinite(n) ? n : void 0;
 }
+var TIKTOK_VALUE_METRICS = ["total_purchase_value"];
+var TIKTOK_OFFICIAL_ROAS_METRICS = [
+  "complete_payment_roas",
+  "total_active_pay_roas"
+];
+var TIKTOK_ROAS_COMPANION_METRICS = [
+  "total_purchase_value",
+  "complete_payment_roas",
+  "total_active_pay_roas"
+];
+function splitTikTokCsv(raw) {
+  return raw.split(",").map((x) => x.trim()).filter(Boolean);
+}
+function pickFirstMetric(row, keys) {
+  let fallback;
+  for (const key of keys) {
+    const value = parseTikTokNumber(row[key]);
+    if (value === void 0) continue;
+    if (value > 0) return { key, value };
+    fallback ??= { key, value };
+  }
+  return fallback;
+}
+function expandTikTokOfficialReportMetrics(metrics) {
+  const parts = splitTikTokCsv(metrics);
+  const needCompanions = parts.includes("complete_payment") || TIKTOK_ROAS_COMPANION_METRICS.some((k) => parts.includes(k));
+  if (!needCompanions) return parts.join(",");
+  for (const extra of TIKTOK_ROAS_COMPANION_METRICS) {
+    if (!parts.includes(extra)) parts.push(extra);
+  }
+  return parts.join(",");
+}
+function pickTikTokOfficialRoas(row) {
+  return pickFirstMetric(row, TIKTOK_OFFICIAL_ROAS_METRICS);
+}
+function pickTikTokRevenue(row) {
+  const picked = pickFirstMetric(row, TIKTOK_VALUE_METRICS);
+  if (!picked) return { revenue: void 0, revenueSource: void 0 };
+  return { revenue: picked.value, revenueSource: picked.key };
+}
+function attachTikTokRoasFields(row) {
+  const spend = parseTikTokNumber(row.spend);
+  const official = pickTikTokOfficialRoas(row);
+  const purchase = pickTikTokRevenue(row);
+  if (purchase.revenue !== void 0) {
+    row.revenue = purchase.revenue;
+    row.revenueSource = purchase.revenueSource;
+  } else if (official && official.value > 0 && spend !== void 0 && spend > 0) {
+    row.revenue = official.value * spend;
+    row.revenueSource = `${official.key}*spend`;
+  }
+  const revenue = parseTikTokNumber(row.revenue);
+  if (official && official.value > 0) {
+    row.roas = official.value;
+    row.roasSource = official.key;
+  } else if (spend !== void 0 && spend > 0 && revenue !== void 0) {
+    row.roas = revenue / spend;
+    row.roasSource = "computed";
+  } else if (official) {
+    row.roas = official.value;
+    row.roasSource = official.key;
+  }
+}
+function summarizeTikTokOfficialReport(items2) {
+  let spend = 0;
+  let revenue = 0;
+  let hasRevenue = false;
+  for (const row of items2) {
+    spend += parseTikTokNumber(row.spend) ?? 0;
+    const rowRevenue = parseTikTokNumber(row.revenue);
+    if (rowRevenue === void 0) continue;
+    revenue += rowRevenue;
+    hasRevenue = true;
+  }
+  return {
+    spend,
+    revenue: hasRevenue ? revenue : 0,
+    roas: spend > 0 && hasRevenue ? revenue / spend : void 0,
+    itemCount: items2.length
+  };
+}
 function flattenTikTokReportRow(row) {
   const dims = row.dimensions && typeof row.dimensions === "object" && !Array.isArray(row.dimensions) ? row.dimensions : {};
   const metrics = row.metrics && typeof row.metrics === "object" && !Array.isArray(row.metrics) ? row.metrics : {};
@@ -134264,11 +134319,7 @@ function flattenTikTokReportRow(row) {
     const n = parseTikTokNumber(v);
     out[k] = n === void 0 ? v : n;
   }
-  const spend = parseTikTokNumber(out.spend);
-  const payment = parseTikTokNumber(out.complete_payment);
-  if (spend !== void 0 && spend > 0 && payment !== void 0) {
-    out.roas = payment / spend;
-  }
+  attachTikTokRoasFields(out);
   return out;
 }
 function pickAdGroupBidField(bidType) {
@@ -134476,6 +134527,7 @@ async function fetchAdEntities(config, opts) {
   );
 }
 async function fetchOfficialReport(config, opts) {
+  const metrics = expandTikTokOfficialReportMetrics(opts.metrics);
   const base = requireTikTokApiUrl(config);
   const raw = await fetchTikTokPagedList(
     config,
@@ -134487,7 +134539,7 @@ async function fetchOfficialReport(config, opts) {
         endDate: opts.endDate,
         dataLevel: opts.dataLevel,
         dimensions: opts.dimensions,
-        metrics: opts.metrics,
+        metrics,
         serviceType: opts.serviceType,
         pageNum,
         pageSize
@@ -134497,7 +134549,8 @@ async function fetchOfficialReport(config, opts) {
   );
   return {
     items: raw.items.map(flattenTikTokReportRow),
-    totalNumber: raw.totalNumber
+    totalNumber: raw.totalNumber,
+    metrics
   };
 }
 
@@ -134751,7 +134804,7 @@ async function runTikTokOfficialReport(opts) {
   const id = assertTikTokAccountId(opts.account);
   const dataLevel = opts.dataLevel.trim();
   const dimensions = opts.dimensions.trim();
-  const metrics = opts.metrics.trim();
+  const metrics = expandTikTokOfficialReportMetrics(opts.metrics.trim());
   if (!dataLevel || !dimensions || !metrics) {
     console.error("\n\u274C --data-level / --dimensions / --metrics \u5747\u4E3A\u5FC5\u586B\u3002\n");
     process.exit(1);
@@ -134776,6 +134829,7 @@ async function runTikTokOfficialReport(opts) {
   } catch (err) {
     fail("\u67E5\u8BE2 TikTok \u5B98\u65B9\u62A5\u8868\u5931\u8D25", err);
   }
+  const totals = summarizeTikTokOfficialReport(result.items);
   const payload = {
     account: id,
     dataLevel,
@@ -134784,6 +134838,7 @@ async function runTikTokOfficialReport(opts) {
     metrics,
     startDate,
     endDate,
+    totals,
     ...wrapListJson({
       page: 1,
       pageSize,
@@ -134809,9 +134864,11 @@ TikTok \u5B98\u65B9\u62A5\u8868 ${dataLevel} ${startDate}~${endDate}\uFF08${id}\
     console.log("  \u65E0\u62A5\u8868\u884C\u3002\n");
     return;
   }
-  const dimKeys = dimensions.split(",").map((x) => x.trim()).filter(Boolean);
-  const metricKeys = metrics.split(",").map((x) => x.trim()).filter(Boolean);
-  const keys = [...dimKeys, ...metricKeys, "roas"].filter((k, i, a) => a.indexOf(k) === i);
+  const dimKeys = splitTikTokCsv(dimensions);
+  const metricKeys = splitTikTokCsv(metrics);
+  const keys = [...dimKeys, ...metricKeys, "revenue", "revenueSource", "roas", "roasSource"].filter(
+    (k, i, a) => a.indexOf(k) === i
+  );
   printCliTable(
     result.items.map((r) => {
       const row = {};
@@ -134826,7 +134883,7 @@ TikTok \u5B98\u65B9\u62A5\u8868 ${dataLevel} ${startDate}~${endDate}\uFF08${id}\
   const sampleSpend = parseTikTokNumber(result.items[0]?.spend);
   if (sampleSpend !== void 0) {
     console.log(
-      "  spend \u5DF2\u8F6C\u6570\u5B57\uFF1BROAS = complete_payment / spend\uFF08spend=0 \u4E0D\u9664\uFF09\u3002\u52FF\u6DF7\u52A0\u4E0D\u540C DataLevel\u3002\n"
+      "  spend \u5DF2\u8F6C\u6570\u5B57\u3002ROAS \u4F18\u5148\u5B98\u65B9\u5217 complete_payment_roas / total_active_pay_roas\uFF0C\u5426\u5219\u7528 total_purchase_value/spend\uFF08\u89C1 roasSource\uFF09\u3002complete_payment \u662F\u7F51\u9875\u5B8C\u4ED8\u6B21\u6570\uFF0C\u4E0D\u662F\u91D1\u989D\u3002\u591A\u884C\u6C47\u603B\u89C1 totals\uFF08\u5148\u52A0\u603B\u518D\u9664\uFF0C\u52FF\u5E73\u5747\u5404\u7EC4 roas\uFF09\u3002\u52FF\u6DF7\u52A0\u4E0D\u540C DataLevel\u3002\n"
     );
   } else {
     console.log();
@@ -134979,7 +135036,7 @@ function registerTikTokAnalysisCommands(program2) {
     "TikTokAPI \u5B98\u65B9\u62A5\u8868\uFF08GET \u2026/query/report/Tiktok/search\uFF1B\u53EF\u542B\u4ECA\u5929/\u5C0F\u65F6\uFF1B\u4E0E `run` \u7684 TSO \u770B\u677F\u5468\u671F\u62A5\u8868\u4E0D\u540C\u3002ServiceType/DataLevel/Dimensions/Metrics/\u65E5\u671F/PageSize \u5FC5\u586B\uFF09"
   ).requiredOption(...ACCOUNT_OPTION2).requiredOption("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u6309\u5E7F\u544A\u4E3B timezone \u81EA\u7136\u65E5\uFF09").requiredOption("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").requiredOption("--data-level <level>", "AUCTION_CAMPAIGN / AUCTION_ADGROUP / AUCTION_AD").requiredOption("--dimensions <list>", "\u9017\u53F7\u5206\u9694\uFF0C\u5982 campaign_id \u6216 adgroup_id,stat_time_hour").requiredOption(
     "--metrics <list>",
-    "\u9017\u53F7\u5206\u9694\uFF0C\u82B1\u8D39\u987B\u7528 spend\uFF08\u4E0D\u8981 stat_cost\uFF09\uFF1B\u53EF\u542B conversion,cost_per_conversion,ctr,complete_payment"
+    "\u9017\u53F7\u5206\u9694\uFF0C\u82B1\u8D39\u987B\u7528 spend\uFF08\u4E0D\u8981 stat_cost\uFF09\u3002complete_payment \u662F\u7F51\u9875\u5B8C\u4ED8\u6B21\u6570\u3002\u542B\u5B8C\u4ED8/ROAS \u65F6\u81EA\u52A8\u9644\u5E26 total_purchase_value,complete_payment_roas,total_active_pay_roas"
   ).option("--service-type <type>", "AUCTION\uFF08\u9ED8\u8BA4\uFF09\u6216 RESERVATION", "AUCTION").option("--page-size <n>", "\u6BCF\u9875\u6761\u6570\uFF0C\u9ED8\u8BA4 200\uFF0C\u4E0A\u9650 1000", (v) => parseInt(v, 10)).option("-t, --token <token>", "Auth Token").option("--json-out <path>", JSON_OUT_OPTION_DESC2).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runTikTokOfficialReport(opts);

package/dist/skill/SKILL.md

@@ -40,7 +40,7 @@ siluzan-tso -h
 
 - `entityId`（UUID）≠ `mediaCustomerId`（`list-accounts` 的 `ma.mediaCustomerId`：Google/TikTok/Bing 多为数字；**Yandex=`porg-…`**；Meta 常带 `act_`）。`stats`/`balance`/`accounts-digest`/`ad *` 的 `-a` **只传 mediaCustomerId**；空结果或 verbose 打出 403 时**先核验 ID**，禁止把 UUID/`entityId` 传给 `-a`，也**禁止**据此直接 `reauth`。
 - **Google CID 特殊性**：UI 常写 `123-456-7890`（带连字符），平台 `mediaCustomerId` 为纯数字 `1234567890`。CLI 会自动去连字符；**勿**把带横杠 403 误判为 OAuth 失效。优先用 `list-accounts` 的纯数字 ID。
-- **禁止臆测授权过期**：见 403/`HTTP 403`/拉数失败/「可能 OAuth 失效」时，**禁止**口头推断授权过期或直接 `reauth`。须先核验 ID（及 Google 连字符），再跑 `account check-access -a <mediaCustomerId>`，以返回的 `accessible` / `reauth_required` / `no_permission` 为准；仅当 `list-accounts` 输出含激活字段且可判定未激活时才跳过用其判断授权过期；细则见 `accounts-permissions.md`。
+- **禁止臆测授权过期**：见 403/`HTTP 403`/拉数失败/「可能 OAuth 失效」时，**禁止**口头推断授权过期或直接 `reauth`。须先核验 ID（及 Google 连字符）。**`account check-access` 仅支持 Google**（无 `-m`，禁止对 TikTok/Meta/Bing/Yandex/Kwai 调用）：Google 跑 `account check-access -a <mediaCustomerId>`，以 `accessible` / `reauth_required` / `no_permission` 为准；非 Google 看 `list-accounts` 的 `invalidOAuthToken`。仅当 `list-accounts` 输出含激活字段且可判定未激活时才跳过用其判断授权过期；细则见 `accounts-permissions.md`。
 - **Google 广告命令名**：列表是 `ad campaigns`（不是 `ad-campaigns` / `campaign list`）；`balance`/`stats` 须带 `-m Google`；单国地域用 `ad geo search … --json-out`（或 `geo resolve`）。
 - **Google 广告类型边界**：CLI/Skill **仅支持** Google **搜索广告（Search）** 与 **Performance Max（PMax）** 的方案、创建与精细管理；**不支持展示广告（Display）**（含自适应展示广告 RDA、独立 Display 系列）。用户要做展示广告时须明确告知不支持，可改推 Search / PMax；**禁止**用 `campaign-create` / `ad-create` 伪装创建 Display。
 - **创建完成后交付（硬性）**：`ad batch diff` 的 stdout 含 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN`——**立刻**把中间全文原样发给用户（可先于补建）；禁止只摘要、禁止只说「创建成功/详情已交付/未发现缺失」、禁止等全部补建结束再交付。

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.46",
-  "publishedAt": 1787190466105
+  "version": "1.1.47-beta.2",
+  "publishedAt": 1787276448425
 }

package/dist/skill/references/accounts/accounts-balance-stats.md

@@ -160,7 +160,7 @@ siluzan-tso accounts-digest -m Google --start 2026-07-20 --end 2026-07-20 \
 >
 > - **Google**：走 `account-spend-overview`；`--start` / `--end` 日历日按 **UTC+8** 转为 `YYYY-MM-DDTHH:mm:ss+08:00` 再请求（起 00:00:00、止 23:59:59，含今天时 end 截到当前时刻）。与 `google-analysis`（只传年月日）口径不同。
 >   - 窗口完全在历史 → `database` 模式；窗口含今天 → `googleCombined` 模式（仅实时消耗，无余额/状态/币种/账户名）。
-> - **TikTok / Yandex / BingV2 / Kwai**：走旧版 `accountsoverview`，每日凌晨同步昨天数据，**不能查今天**。判断这几家的「今天/当天/今日消耗」仍需走 `google-analysis(-batch) --sections overview`（仅 Google）。
+> - **TikTok / Yandex / BingV2 / Kwai**：走旧版 `accountsoverview`，每日凌晨同步昨天数据，**不能查今天**。Bing 看昨天/今天消耗用 `bing-analysis`（数据可能不完整）；TikTok 用 `tiktok-analysis official-report`。Google「今天」仍走 `google-analysis(-batch) --sections overview`。
 > - 完整时效性表见 `references/analytics/account-analytics.md` 顶部。
 
 ```bash

package/dist/skill/references/accounts/accounts-list.md

@@ -167,7 +167,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---

package/dist/skill/references/accounts/accounts-permissions.md

@@ -33,6 +33,8 @@ siluzan-tso account me --check-phone 15130150466 --json-out ./snap-me
 
 ### check-access — Google 账户访问权限校验
 
+**仅支持 Google。** 无 `-m`；`-a` 只接受 Google 纯数字 `mediaCustomerId`。TikTok / MetaAd / BingV2 / Yandex / Kwai **禁止**调用本命令，授权是否失效看 `list-accounts` 的 `invalidOAuthToken`。
+
 校验当前丝路赞凭据是否对指定 **Google** 广告账户有访问权限。应在拉数/诊断前调用，避免误用他户 ID。
 
 > **硬约束**：**禁止**凭 403、空结果或经验臆测「授权/OAuth 过期」。要对用户下「授权不可用 / 需重授权」结论前，**必须**先跑本命令，以 CLI 返回的 `status` 为准；**禁止**跳过本命令直接 `reauth` 或口头推断。
@@ -488,7 +490,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 
 | 功能                                    | 媒体   | 网页路径                                          |
 | --------------------------------------- | ------ | ------------------------------------------------- |
-| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
+| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 
 **Agent 建议话术**：
 
@@ -497,5 +499,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 siluzan-tso config show   # 查看 webUrl 字段
 
 # 账户激活（Google）→ 引导至账户管理页
-# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
 ```

package/dist/skill/references/accounts/accounts.md

@@ -20,7 +20,7 @@
 - `entityId`（UUID，分享/delink/账单/`reauth`）≠ `mediaCustomerId`（`balance`/`stats`/`accounts-digest`/`ad` 的 `-a`）。**Yandex 的 mediaCustomerId 形如 `porg-…`，不是 UUID。**
 - MetaAd OAuth 户的 `mediaCustomerId` **须带 `act_` 前缀**。
 - **Google CID**：广告后台展示常为 `XXX-XXX-XXXX`（连字符），`list-accounts` / 网关要的是**纯数字**（无横杠）。`stats`/`balance`/`ad *`/`google-analysis` 的 `-a` 可带连字符（CLI 会去掉）；若仍见 `HTTP 403：123-456-7890` 这类**回显带横杠 ID**，优先改成纯数字重试，**不要**直接当 OAuth 失效去 `reauth`。
-- **禁止臆测授权过期**：403 / 拉数失败时**禁止**口头说「可能授权过期」。须 ID 核验后，对 Google 执行 `account check-access -a <mediaCustomerId>`，以返回 `status` 为准（见 [`accounts-permissions.md`](accounts-permissions.md)）；仅当 `list-accounts` 输出含激活字段且可判定未激活时，勿用其判断授权过期；非 Google 看 `invalidOAuthToken`。
+- **禁止臆测授权过期**：403 / 拉数失败时**禁止**口头说「可能授权过期」。须 ID 核验后，**仅 Google** 执行 `account check-access -a <mediaCustomerId>`（无 `-m`，其他媒体禁止调用），以返回 `status` 为准（见 [`accounts-permissions.md`](accounts-permissions.md)）；仅当 `list-accounts` 输出含激活字段且可判定未激活时，勿用其判断授权过期；非 Google 看 `invalidOAuthToken`。
 - `stats`/`balance` 空结果 + verbose `HTTP 403`：先确认 `-a` 是否为 `ma.mediaCustomerId`（且 Google 已去连字符）；**禁止**把 `entityId` / tokenId 当 `-a`；未跑 `account check-access`（或未见 `invalidOAuthToken=true`）**禁止** `reauth`。
 - 多账户余额预警用 `balance-scan`（P2），多账户消耗汇总用 `accounts-digest`（P3）；**禁止**外层 for-loop 逐户 `balance`/`stats`。
 - `stats` 默认 `spend` = **区间合计**，不是日消耗；日均看 `balance-scan.dailySpend` 或合计÷天数。

package/dist/skill/references/accounts/finance.md

@@ -126,7 +126,7 @@ siluzan-tso config show
 
 ### 充值页链接（按媒体 × 类型）
 
-链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
 
 | 充值类型                  | `<page>`              | 支持媒体（`mediaType` 参数）                |
 | ------------------------- | --------------------- | ------------------------------------------- |

package/dist/skill/references/accounts/open-account-by-media.md

@@ -1,6 +1,6 @@
 # 各媒体开户
 
-> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 网页链接：`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
 ## Contents

package/dist/skill/references/accounts/open-account-google-ui.md

@@ -65,7 +65,7 @@ siluzan-tso open-account google-wizard
 
 ```bash
 siluzan-tso account-history -m Google
-# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 
 ---

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

@@ -351,11 +351,13 @@ siluzan-tso tiktok-analysis official-report -a <mediaCustomerId> --json-out ./sn
   --data-level AUCTION_CAMPAIGN --dimensions campaign_id --metrics spend
 ```
 
+**ROAS 口径**（对齐 [网页事件](https://ads.tiktok.com/help/article/page-events?lang=zh) / [应用内事件](https://ads.tiktok.com/help/article/in-app-events?lang=zh)）：`--metrics` 含完付或 ROAS 时 CLI 自动附带 `total_purchase_value,complete_payment_roas,total_active_pay_roas`。落盘行有 `revenue` / `revenueSource` / `roas` / `roasSource`，多行汇总在 `totals`（先加总 spend/revenue 再除）。`complete_payment` 是网页支付完成**次数**；金额用 `total_purchase_value`（总付费价值）。ROAS 优先官方列 `complete_payment_roas` / `total_active_pay_roas`。**禁止** `complete_payment/spend`，**禁止**把完付=0 判成「像素没回传」，**禁止**对各组 `roas` 取平均。不确定时先 `adgroup-entities` 看 `optimization_event`。
+
 ---
 
 ## Bing（BingV2）账户分析
 
-> **日期限制**：Bing 报表不能包含今天或昨天。省略时 CLI 默认截至前天的近 7 天。用户要**已结束的完整自然月**（如「6月份」）→ `--start` 当月 1 日、`--end` 当月最后一天（6 月 = `06-30`，**禁止**减 1 天），见 `report-templates/bing-period-report.md` §日期规则。
+> **日期**：可含昨天（及今天，数据可能不完整）。网关未显式传 `returnOnlyCompleteData` 时，区间碰到今天/昨天会自动改为近实时。省略时 CLI 默认截至昨天的近 7 天。用户要**已结束的完整自然月**（如「6月份」）→ `--start` 当月 1 日、`--end` 当月最后一天（6 月 = `06-30`，**禁止**减 1 天），见 `report-templates/bing-period-report.md` §日期规则。
 >
 > **自动化巡检步骤**（封禁 / 拒审 / 落地页 / 当日超预算 / 空耗预警，只读告警）：`references/operations/hosted-automation-bing.md`。
 
@@ -365,7 +367,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` |
 | `--limit`                  | 仅 `keywords` / `search-terms`：条数上限，默认 100                                                                                                                                                                                      |
-| `--start` / `--end`        | 同传或同省略；不可含今天/昨天；省略=截至前天的近 7 天                                                                                                                                                                                   |
+| `--start` / `--end`        | 同传或同省略；可含昨天/今天（可能不完整）；省略=截至昨天的近 7 天                                                                                                                                                                      |
 | `--concurrency`            | 默认 5，上限 16                                                                                                                                                                                                                         |
 
 ```bash
@@ -431,12 +433,11 @@ siluzan-tso bing-analysis monthly-spend -a <mediaCustomerId>
 - `ad-entities` 单系列查必须带 `--campaign-id`；查全账户拒审/落地页用 `bulk-ads`，不要按系列遍历 `ad-entities`。
 - `bulk-ads` 底层为官方异步下载任务，网关等文件就绪才返回，大账户可能要几分钟，不适合放在页面同步加载场景，适合定时巡检。
 
-### Bing 近实时报表（`bing-analysis --aggregation`，日期可含今天）
+### Bing 近实时报表（`bing-analysis --aggregation`，按日/小时分桶）
 
-> `bing-analysis` 默认面向周期报告，日期**禁止**含今天/昨天；一旦显式传 `--aggregation` 或
-> `--return-only-complete-data`，即视为「单日花费」「近两小时 CPA」等近实时监控意图，
-> **自动放开**日期含今天/昨天的限制。仅 `campaigns`/`ad-groups`/`ads` 三个 section 支持这两个参数
-> （分别对应网关 `CampaignReport`/`AdGroupReport`/`AdReport`）。
+> `--aggregation` / `--return-only-complete-data` 仅 `campaigns`/`ad-groups`/`ads` 三个 section 支持
+> （分别对应网关 `CampaignReport`/`AdGroupReport`/`AdReport`）。省略这两个参数时，含昨天/今天的区间
+> 同样可以拉（网关自动近实时）；`--aggregation` 用来拿 Daily/Hourly 分桶。省略日期且传了 `--aggregation` 时默认今天当天。
 
 ```bash
 # 单日花费与日预算（同一 campaignId 算 spend / dailyBudget；isSharedBudget=true 时 dailyBudget 是共享总额）

package/dist/skill/references/analytics/rag.md

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 

package/dist/skill/references/analytics/reporting.md

@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 
 | 媒体   | 报告类型         | URL 模板                                                    |
 | ------ | ---------------- | ----------------------------------------------------------- |
-| Google | 日报（Daily）    | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
-| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
-| TikTok | 日报             | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 日报（Daily）    | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
+| TikTok | 日报             | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
 
 `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
 
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

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

@@ -125,9 +125,9 @@
 ## 四、硬规范
 
 - **账户状态 ≠ 系列状态**：`stats` / `balance` / `list-accounts` 的 `status` 只表示账户是否可用；系列状态必须来自 `ad campaigns`。
-- **数据时效性**：涉及「今天/当天/今日消耗」「实时消耗排行」前，必读 `references/analytics/account-analytics.md` 顶部「数据时效性」表。TikTok / Yandex / BingV2 / Kwai 是 `accountsoverview` 同步昨天数据，**不能查今天**。
+- **数据时效性**：涉及「今天/当天/今日消耗」「实时消耗排行」前，必读 `references/analytics/account-analytics.md` 顶部「数据时效性」表。TikTok / Yandex / BingV2 / Kwai 的 `stats`/`accountsoverview` 同步昨天数据，**不能查今天**。Bing 昨天/今天消耗走 `bing-analysis`；TikTok 走 `tiktok-analysis official-report`。
 - **先查账户再操作**（拉数 / 改账户 / 报告 / **创建广告**）：`list-accounts -m [mediaType] -k [mediaCustomerId]`；用户给出的 `mediaCustomerId` 必须 `-k` 核验，无结果则告知用户并停止，**禁止**翻页 grep 自行换 ID（会导致报告错户）；拉数、脚本、报告文件名全链路用同一 ID（以 stdout `accountId` 为准）。
-- **禁止臆测授权过期（硬约束）**：任何 403、空结果、「可能授权/OAuth 过期」话术，**禁止**凭感觉下结论或直接 `reauth`。Google：**必须**执行 `account check-access -a <mediaCustomerId>`，仅当结果为 `reauth_required`（或列表 `invalidOAuthToken=true` 与之交叉确认）才谈重授权；`no_permission` 也可能是账户不在当前丝路赞账号下。若 `list-accounts` **输出含** `scopeActivatedSources` 且可判定未激活，则勿用 check-access 判断授权过期；**无该字段时禁止谈套餐激活**。非 Google 媒体以 `list-accounts` 的 `invalidOAuthToken` 为准，同样禁止臆测。详见 `accounts-permissions.md`。
+- **禁止臆测授权过期（硬约束）**：任何 403、空结果、「可能授权/OAuth 过期」话术，**禁止**凭感觉下结论或直接 `reauth`。`account check-access` **仅支持 Google**（无 `-m`，禁止对 TikTok/Meta/Bing/Yandex/Kwai 调用）。Google：**必须**执行 `account check-access -a <mediaCustomerId>`，仅当结果为 `reauth_required`（或列表 `invalidOAuthToken=true` 与之交叉确认）才谈重授权；`no_permission` 也可能是账户不在当前丝路赞账号下。若 `list-accounts` **输出含** `scopeActivatedSources` 且可判定未激活，则勿用 check-access 判断授权过期；**无该字段时禁止谈套餐激活**。非 Google 媒体以 `list-accounts` 的 `invalidOAuthToken` 为准，同样禁止臆测。详见 `accounts-permissions.md`。
 - **一律走 CLI，禁止自拼网关请求**：查余额 / 拉数 / 写操作只用 `siluzan-tso …`。**禁止**用 curl、自写脚本或改请求头直连 TSO/Google 网关「另辟蹊径」取数；`balance` 等无数据时按 CLI/`list-accounts` **实际出现的字段**向用户说明（如授权失效；仅当输出含激活字段时才可谈套餐），**禁止**尝试任何绕过平台门禁的取数方式。
 - **W3 仅出方案例外（覆盖上条）**：用户只要「投放方案 / 规划 / 表格 / 先别创建·开户·投钱」，或未给账户且未要求创建/发布时——**禁止**把「请先提供 Google 广告账户」当作第一步；按 `google-ads-campaign-plan.md` §「仅出方案 vs 创建」落盘 JSON 后 **写代码**投影完整审查稿（默认 MD；用户指定则 Excel 等；`account`=`[PENDING_ACCOUNT]`），跳过 `list-accounts` / `geo resolve` / validate / create。**禁止**只交概览表。用户确认要创建后再要账户并续跑创建流水线。
 - **W3 审查稿（搜索与 PMax）**：JSON 落盘后、创建前，必须 **写代码**读取 JSON，按 `google-ads-launch-plan-template.md`（搜索）或 `google-ads-pmax-launch-plan-template.md`（PMax）生成完整审查文件交给用户；须含全部关键词/RSA 或全部 PMax 文案与附加资产。**禁止**用「方案总结」条数勾选代替。用户要求其他格式时改脚本输出，数据仍只从 JSON 来。
@@ -197,7 +197,7 @@
 **完整自然月口径**（用户说「X 月 / X月份 / 月报」且该月已结束，或上表「月报」默认）：
 
 - `--start` = 当月 1 日，`--end` = 当月最后一天（6 月 → `06-01` ~ `06-30`，**禁止** `06-29`）。
-- **Bing** `bing-analysis`：「不能含今天/昨天」仅当区间碰到**执行日**的今天/昨天时才需把结束日压到前天；**已结束的历史自然月必须用该月最后一天**，细则见 `report-templates/bing-period-report.md` §日期规则。交付前核对 `overview` 的 `activeDays` = 该月日历天数。
+- **Bing** `bing-analysis`：可含昨天/今天（今天可能不完整）；**已结束的历史自然月必须用该月最后一天**，细则见 `report-templates/bing-period-report.md` §日期规则。交付前核对 `overview` 的 `activeDays` = 该月日历天数。
 
 ---
 
@@ -278,7 +278,7 @@
 
 - **400**：参数错误，查看对应 reference 或 `-h`
 - **401 / OAuth 失效**：仅当 `list-accounts` 的 `invalidOAuthToken=true`（或表格「授权状态」为失效）且用户确认后——Siluzan Agent **优先**用平台重新授权工具（如 `present_reauth`）；备选 `account reauth -m <媒体> --id <entityId> --i-confirm --commit "…"`（内置 delink→OAuth，见 W9 / `accounts-permissions.md`）。走 CLI 时**必须把 stdout 中的完整授权 URL 原样贴给用户**，禁止只说「链接已生成」，也**禁止**自行改写/补全该 URL。解绑后若列表已无该户，恢复用平台授权工具或 `account auth -m <媒体>`。**丝路赞登录凭据失效** → `send-login-code` + `login --phone --code`，见 `references/core/setup.md`
-- **403（拉数空结果 / ad 网关）**：① **优先核验 `-a` 是否为 `ma.mediaCustomerId`**（勿传 `entityId`/UUID；Google 注意连字符 CID；Yandex 形如 `porg-…`）；② 仅当 `list-accounts` **输出含** `scopeActivatedSources` 且可判定未激活时，才可说明需先激活；**无该字段则禁止谈套餐**；**禁止**非 CLI 绕过取数；③ **禁止臆测授权过期**：**必须**跑 `account check-access -a <mediaCustomerId>`，以 `status` 为准后再决定是否 `reauth`；**禁止**仅凭 403 文案对用户说「授权过期」。
+- **403（拉数空结果 / ad 网关）**：① **优先核验 `-a` 是否为 `ma.mediaCustomerId`**（勿传 `entityId`/UUID；Google 注意连字符 CID；Yandex 形如 `porg-…`）；② 仅当 `list-accounts` **输出含** `scopeActivatedSources` 且可判定未激活时，才可说明需先激活；**无该字段则禁止谈套餐**；**禁止**非 CLI 绕过取数；③ **禁止臆测授权过期**：Google **必须**跑 `account check-access -a <mediaCustomerId>`（**仅 Google**，无 `-m`），以 `status` 为准后再决定是否 `reauth`；非 Google 看 `list-accounts` 的 `invalidOAuthToken`，**禁止**对 TikTok/Meta/Bing/Yandex/Kwai 跑 `check-access`；**禁止**仅凭 403 文案对用户说「授权过期」。
 - **500**：服务可能正在部署/升级，建议反馈 Siluzan 相关人员
 
 ---

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

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -127,9 +127,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

package/dist/skill/references/misc/tso-home.md

@@ -6,7 +6,7 @@
 siluzan-tso config show   # 取 webUrl
 ```
 
-首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 
 ---
 
@@ -25,7 +25,7 @@ siluzan-tso config show   # 取 webUrl
 
 ## 推荐话术
 
-1. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/v3/foreign_trade/tso/home`。
+1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
 2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
 3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。
 

package/dist/skill/references/operations/hosted-automation-bing.md

@@ -9,7 +9,7 @@
 **硬约束**：
 
 - `guard` **只支持 Google**。禁止 `guard … -m BingV2`。
-- 周期报表（不带 `--aggregation`）日期**不能含今天/昨天**；省略则默认截至前天的近 7 天。
+- 周期报表日期**可以含昨天**；今天数据可能不完整。省略则默认截至昨天的近 7 天。含昨天/今天时不要显式传 `--return-only-complete-data true`。
 - 当日花费、近两小时 CPA 必须显式传 `--aggregation Daily|Hourly`，且 `--sections` 只能是 `campaigns` / `ad-groups` / `ads`。
 - Hourly 时间桶是**太平洋时区**，和北京日期可能差一天；阈值按 `timePeriod` 对齐，不要按北京日历硬切。
 - 花费/转化用 `bing-analysis run --sections …`；日预算/启停状态用 `campaign-entities`。两套数据不要混成一行。

package/dist/skill/references/operations/hosted-automation-tiktok.md

@@ -107,7 +107,7 @@ siluzan-tso tiktok-analysis official-report -a <mediaCustomerId> --json-out ./sn
   --data-level AUCTION_CAMPAIGN --dimensions campaign_id,stat_time_hour --metrics spend
 ```
 
-广告效果（CPA 用 `cost_per_conversion` 或 `spend/conversion`；ROAS 落盘里已自算 `complete_payment/spend`）：
+广告效果（CPA 用 `cost_per_conversion` 或 `spend/conversion`；**ROAS 用落盘 `roas` / `totals.roas`**）：
 
 ```bash
 siluzan-tso tiktok-analysis official-report -a <mediaCustomerId> --json-out ./snap-tt \
@@ -116,7 +116,7 @@ siluzan-tso tiktok-analysis official-report -a <mediaCustomerId> --json-out ./sn
   --metrics spend,conversion,cost_per_conversion,complete_payment,ctr
 ```
 
-非完付目标的 `complete_payment` 常为 0，ROAS 不能当通用门槛。出价在组，广告层只能关停（本批 CLI **不**关停）。
+`--metrics` 含完付/ROAS 时 CLI 自动附带 `total_purchase_value,complete_payment_roas,total_active_pay_roas`。口径对齐 Ads Manager：`complete_payment` 是网页支付完成**次数**（不是金额）；ROAS 优先官方列 `complete_payment_roas`（网页）/ `total_active_pay_roas`（App 付费），否则 `total_purchase_value/spend`。多行用 `totals`（先加总再除），**禁止**对各组 `roas` 取平均。**`complete_payment=0` 不是像素坏了**——App / `ACTIVE_PAY` 看 `total_purchase_value`。不确定优化目标时先 `adgroup-entities` 看 `optimization_event`。出价在组，广告层只能关停（本批 CLI **不**关停）。
 
 根因分解（含小时时起止仍须同一天，必须翻完页；CLI 已自动翻）：
 

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

@@ -76,9 +76,9 @@ Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kp
 
 ## 日期规则（必读）
 
-- Bing 接口**无法**拉取过新的数据；时间范围内**任意一天**若为**今天**或**昨天**，请求会失败。
-- **CLI**：`--start` / `--end` 须**同传或同省略**；省略时默认**截至前天**的近 7 天（与 `bing-analysis` 实现一致）。
-- **自选区间且靠近当前日期**时，结束日须 ≤ **前天**（仅当区间会碰到今天/昨天才需要压到前天；**不是**把历史自然月最后一天减 1 天）。
+- 可以含**昨天**；**今天**也可以拉，但可能不完整（网关未显式传 `returnOnlyCompleteData` 时自动近实时）。含昨天/今天时**不要**显式传 `--return-only-complete-data true`。
+- **CLI**：`--start` / `--end` 须**同传或同省略**；省略时默认**截至昨天**的近 7 天（与 `bing-analysis` 实现一致）。
+- 小时/日分桶（当日花费、近两小时 CPA）仍须对 `campaigns`/`ad-groups`/`ads` 传 `--aggregation Daily|Hourly`。
 
 ### 用户说「X 月 / X月份 / 月报」（已结束的完整自然月）
 
@@ -96,7 +96,7 @@ Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kp
 siluzan-tso bing-analysis -a <id> --start 2026-06-01 --end 2026-06-30 --json-out ./snap-bing
 ```
 
-**禁止**因「Bing 不能含今天/昨天」而对**已结束的历史自然月**把 `--end` 减 1 天——该限制只针对区间内的日历日是否等于**执行当天的今天或昨天**；6 月 30 日在 7 月 8 日拉数完全合法。拉数后核对 `overview` 落盘里的 `activeDays` 应等于该月日历天数（6 月 = 30）。
+**禁止**因旧规则「Bing 不能含今天/昨天」而对**已结束的历史自然月**把 `--end` 减 1 天。6 月 30 日在 7 月 8 日拉数完全合法。拉数后核对 `overview` 落盘里的 `activeDays` 应等于该月日历天数（6 月 = 30）。
 
 ---
 

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

@@ -76,9 +76,9 @@ Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kp
 
 ## 日期规则（必读）
 
-- Bing 接口**无法**拉取过新的数据；时间范围内**任意一天**若为**今天**或**昨天**，请求会失败。
-- **CLI**：`--start` / `--end` 须**同传或同省略**；省略时默认**截至前天**的近 7 天（与 `bing-analysis` 实现一致）。
-- **自选区间且靠近当前日期**时，结束日须 ≤ **前天**（仅当区间会碰到今天/昨天才需要压到前天；**不是**把历史自然月最后一天减 1 天）。
+- 可以含**昨天**；**今天**也可以拉，但可能不完整（网关未显式传 `returnOnlyCompleteData` 时自动近实时）。含昨天/今天时**不要**显式传 `--return-only-complete-data true`。
+- **CLI**：`--start` / `--end` 须**同传或同省略**；省略时默认**截至昨天**的近 7 天（与 `bing-analysis` 实现一致）。
+- 小时/日分桶（当日花费、近两小时 CPA）仍须对 `campaigns`/`ad-groups`/`ads` 传 `--aggregation Daily|Hourly`。
 
 ### 用户说「X 月 / X月份 / 月报」（已结束的完整自然月）
 
@@ -96,7 +96,7 @@ Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kp
 siluzan-tso bing-analysis -a <id> --start 2026-06-01 --end 2026-06-30 --json-out ./snap-bing
 ```
 
-**禁止**因「Bing 不能含今天/昨天」而对**已结束的历史自然月**把 `--end` 减 1 天——该限制只针对区间内的日历日是否等于**执行当天的今天或昨天**；6 月 30 日在 7 月 8 日拉数完全合法。拉数后核对 `overview` 落盘里的 `activeDays` 应等于该月日历天数（6 月 = 30）。
+**禁止**因旧规则「Bing 不能含今天/昨天」而对**已结束的历史自然月**把 `--end` 减 1 天。6 月 30 日在 7 月 8 日拉数完全合法。拉数后核对 `overview` 落盘里的 `activeDays` 应等于该月日历天数（6 月 = 30）。
 
 ---
 

package/dist/skill/report-templates/report-template-dark.html

@@ -83,7 +83,7 @@
           <i class="fa-solid fa-circle-info text-amber-400" aria-hidden="true"></i>
           数据口径提示（示例）
         </p>
-        <p class="mt-2 pl-7 text-amber-100/80">BingV2 区间不可含今天/昨天；以接口与 CLI 为准。</p>
+        <p class="mt-2 pl-7 text-amber-100/80">BingV2 昨天/今天可能不完整；以接口与 CLI 为准。</p>
       </aside>
 
       <section class="mb-14" data-section-id="section-executive-summary">

package/dist/skill/report-templates/report-template-mobile.html

@@ -94,7 +94,7 @@
           <i class="fa-solid fa-triangle-exclamation mr-1 text-amber-500" aria-hidden="true"></i
           >口径提示
         </p>
-        <p class="mt-1">BingV2 区间勿含今天/昨天。</p>
+        <p class="mt-1">BingV2 昨天/今天数据可能不完整。</p>
       </aside>
 
       <section class="mb-10" data-section-id="section-executive-summary">

package/dist/skill/report-templates/report-template-print.html

@@ -60,7 +60,7 @@
 
       <aside class="no-print mb-8 border-2 border-black border-dashed bg-neutral-50 p-4 text-sm">
         <p class="font-bold">数据口径（示例）</p>
-        <p class="mt-1 text-neutral-800">BingV2：区间不可含今天/昨天。</p>
+        <p class="mt-1 text-neutral-800">BingV2：昨天/今天数据可能不完整。</p>
       </aside>
 
       <section class="mb-10" data-section-id="section-executive-summary">

package/dist/skill/scripts/install.ps1

@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.46'
+$PKG_VERSION = '1.1.47-beta.2'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
-$WEB_BASE    = 'https://www.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN    = 18

package/dist/skill/scripts/install.sh

@@ -9,11 +9,11 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.46"
+readonly PKG_VERSION="1.1.47-beta.2"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
-readonly WEB_BASE="https://www.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
+readonly WEB_BASE="https://www-ci.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

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