siluzan-tso-cli 1.1.11-beta.7 → 1.1.12

package/README.md

@@ -41,7 +41,7 @@ HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli@beta
+npm install -g siluzan-tso-cli
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -49,7 +49,6 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.11-beta.7），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手 | 建议 `--ai` |
 |------|-------------|

package/dist/index.js

@@ -1962,7 +1962,7 @@ import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command } from "commander";
 
 // src/config/defaults.ts
-var DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
+var DEFAULT_API_BASE = "https://tso-api.siluzan.com";
 
 // ../common/dist/index.js
 import * as fs from "fs";
@@ -2257,17 +2257,29 @@ async function fetchDataPermission(mainApiUrl, auth) {
     return "";
   }
 }
-async function ensureDataPermission(config) {
-  if (config.dataPermission?.trim()) return config;
+var DATA_PERMISSION_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+async function ensureDataPermission(config, opts = {}) {
   if (!config.mainApiUrl) return config;
+  const shared = readSharedConfig();
+  const writtenAt = shared._dataPermissionWrittenAt ? new Date(shared._dataPermissionWrittenAt).getTime() : 0;
+  const isStale = !writtenAt || Date.now() - writtenAt > DATA_PERMISSION_TTL_MS;
+  if (!opts.force && config.dataPermission?.trim() && !isStale) {
+    return config;
+  }
   const dp = await fetchDataPermission(config.mainApiUrl, config);
   if (!dp) return config;
   try {
-    writeSharedConfig({ dataPermission: dp });
+    writeSharedConfig({
+      dataPermission: dp,
+      _dataPermissionWrittenAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
   } catch {
   }
   return { ...config, dataPermission: dp };
 }
+async function refreshDataPermission(config) {
+  return ensureDataPermission(config, { force: true });
+}
 function loadConfig(tokenArg) {
   const shared = readSharedConfig();
   const apiKey = process.env.SILUZAN_API_KEY ?? (shared.apiKey ? shared.apiKey : void 0);
@@ -2628,10 +2640,16 @@ function readConfigRaw() {
     return {};
   }
 }
-function writeConfigRaw(data) {
+function mergeWriteConfig(updates) {
   try {
     fs5.mkdirSync(path5.dirname(CONFIG_FILE2), { recursive: true });
-    fs5.writeFileSync(CONFIG_FILE2, JSON.stringify(data, null, 2), "utf8");
+    let existing = {};
+    try {
+      existing = JSON.parse(fs5.readFileSync(CONFIG_FILE2, "utf8"));
+    } catch {
+    }
+    Object.assign(existing, updates);
+    fs5.writeFileSync(CONFIG_FILE2, JSON.stringify(existing, null, 2), "utf8");
     if (process.platform !== "win32") {
       fs5.chmodSync(CONFIG_FILE2, 384);
     }
@@ -2661,17 +2679,17 @@ async function notifyIfOutdated() {
       fetchVersionByTag(tag, latestCacheKey, cfg),
       fetchVersionByTag(minTag, minCacheKey, cfg)
     ]);
-    writeConfigRaw({
-      ...cfg,
-      _tsoLastVersionCheck: (/* @__PURE__ */ new Date()).toISOString(),
-      ...latest ? { [latestCacheKey]: latest } : {},
-      ...minRequired ? { [minCacheKey]: minRequired } : {}
-    });
+    const cacheUpdates = {
+      _tsoLastVersionCheck: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    if (latest) cacheUpdates[latestCacheKey] = latest;
+    if (minRequired) cacheUpdates[minCacheKey] = minRequired;
+    mergeWriteConfig(cacheUpdates);
     const lastNotified = cfg._tsoLastNotified ? new Date(cfg._tsoLastNotified).getTime() : 0;
     if (Date.now() - lastNotified < 24 * 60 * 60 * 1e3) return;
     const tagLabel = isBeta ? "\uFF08\u6D4B\u8BD5\u7248\uFF09" : "\uFF08\u6B63\u5F0F\u7248\uFF09";
     if (minRequired && isNewer(current, minRequired)) {
-      writeConfigRaw({ ...cfg, _tsoLastNotified: (/* @__PURE__ */ new Date()).toISOString() });
+      mergeWriteConfig({ _tsoLastNotified: (/* @__PURE__ */ new Date()).toISOString() });
       console.log(
         `
 [SILUZAN_FORCE_UPDATE] \u5F53\u524D\u7248\u672C ${current} \u5DF2\u8FC7\u671F\uFF0C\u6700\u4F4E\u8981\u6C42\u7248\u672C ${minRequired}${tagLabel}
@@ -2682,7 +2700,7 @@ async function notifyIfOutdated() {
       return;
     }
     if (latest && isNewer(current, latest)) {
-      writeConfigRaw({ ...cfg, _tsoLastNotified: (/* @__PURE__ */ new Date()).toISOString() });
+      mergeWriteConfig({ _tsoLastNotified: (/* @__PURE__ */ new Date()).toISOString() });
       console.log(
         `
 [SILUZAN_UPDATE_AVAILABLE] \u53D1\u73B0\u65B0\u7248\u672C ${latest}${tagLabel}\uFF08\u5F53\u524D ${current}\uFF09
@@ -3024,7 +3042,10 @@ async function fetchTikTokAccountByMediaCustomerId(config, mediaCustomerId, verb
   return match ?? null;
 }
 async function runListAccounts(opts) {
-  const config = loadConfig(opts.token);
+  let config = loadConfig(opts.token);
+  if (opts.refreshDp) {
+    config = await refreshDataPermission(config);
+  }
   if (opts.media && !VALID_MEDIA_TYPES.includes(opts.media)) {
     console.error(
       `
@@ -3180,15 +3201,23 @@ async function runListAccounts(opts) {
       }
     }
   }
+  const oauthFailWarning = (() => {
+    if (items.length < 5) return null;
+    const allFail = items.every((it) => it.ma?.invalidOAuthToken === true);
+    return allFail ? "\u68C0\u6D4B\u5230\u672C\u9875\u6240\u6709\u8D26\u6237\u5747\u6807\u8BB0\u4E3A OAuth \u5931\u6548\uFF0C\u8FD9\u901A\u5E38\u662F\u670D\u52A1\u7AEF\u4F1A\u8BDD\u5F02\u5E38\u6216\u6743\u9650\u6F02\u79FB\uFF08\u975E\u771F\u5931\u6548\uFF09\u3002\u5EFA\u8BAE\u6309\u987A\u5E8F\u6392\u67E5\uFF1A\n  1) siluzan-tso list-accounts --refresh-dp  # \u5F3A\u5236\u5237\u65B0 Datapermission\n  2) siluzan-tso login                      # \u91CD\u65B0\u767B\u5F55\u83B7\u53D6\u65B0 authToken\n  3) 1 \u5206\u949F\u540E\u91CD\u8BD5\uFF1B\u82E5\u4ECD\u590D\u73B0\uFF0C\u8BF7\u5E26\u4E0A --verbose \u8F93\u51FA\u53CD\u9988\u7ED9\u5E73\u53F0\u3002" : null;
+  })();
   if (opts.json) {
     console.log(
       JSON.stringify(
-        wrapListJson({
-          page,
-          pageSize,
-          total: total ?? null,
-          items
-        }),
+        {
+          ...wrapListJson({
+            page,
+            pageSize,
+            total: total ?? null,
+            items
+          }),
+          ...oauthFailWarning ? { warning: oauthFailWarning } : {}
+        },
         null,
         2
       )
@@ -3237,6 +3266,10 @@ async function runListAccounts(opts) {
   \u2139\uFE0F  \u6B64\u5217\u8868\u4E0D\u663E\u793A Google \u5C01\u53F7\uFF08Suspended\uFF09\u72B6\u6001\uFF0C\u5982\u9700\u67E5\u770B\u53EF\u63D0\u73B0\u7684\u88AB\u5C01\u8D26\u6237\u8BF7\u8FD0\u884C\uFF1A`);
     console.log(`     siluzan-tso account withdraw-list`);
   }
+  if (oauthFailWarning) {
+    console.log(`
+  \u26A0\uFE0F  ${oauthFailWarning}`);
+  }
   console.log();
 }
 function fmtNum(v, decimals = 2) {
@@ -3695,6 +3728,500 @@ ${media} \u8D26\u6237\u4F59\u989D\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${out.l
   console.log();
 }
 
+// src/commands/balance-scan.ts
+var SCAN_PLATFORM_CONFIG = {
+  Google: {
+    path: "/query/media-account/",
+    pageParam: "pageNo",
+    fixedParams: { MediaType: "Google", mediaAccountState: "Approved,Linked" },
+    responseType: "array"
+  },
+  Yandex: {
+    path: "/query/media-account/",
+    pageParam: "pageNo",
+    fixedParams: { MediaType: "Yandex", mediaAccountState: "Approved,Linked" },
+    responseType: "array"
+  },
+  TikTok: {
+    path: "/query/media-account/tiktok/SearchMediaAcountByCriteria",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaType: "TikTok",
+      advStatus: "STATUS_ENABLE,STATUS_LIMIT,STATUS_DISABLE",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
+  },
+  BingV2: {
+    path: "/query/media-account/BingV2/SearchBingV2MediaAcountByUserId",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaType: "BingV2",
+      advStatus: "APPROVED",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
+  },
+  Kwai: {
+    path: "/query/media-account/SearchMediaAcountByCriteria",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaTypes: "Kwai",
+      MediaType: "Kwai",
+      advStatus: "",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
+  }
+};
+async function fetchOnePage(media, page, pageSize, config, verbose) {
+  const cfg = SCAN_PLATFORM_CONFIG[media];
+  if (!cfg) throw new Error(`balance scan \u6682\u4E0D\u652F\u6301\u5A92\u4F53\uFF1A${media}`);
+  const params = new URLSearchParams();
+  for (const [k, v] of Object.entries(cfg.fixedParams)) {
+    params.set(k, String(v));
+  }
+  params.set(cfg.pageParam, String(page));
+  params.set("pageSize", String(pageSize));
+  const url = `${config.apiBaseUrl}${cfg.path}?${params}`;
+  if (cfg.responseType === "array") {
+    const res2 = await apiFetchWithHeaders2(url, config, {}, verbose);
+    const items = res2.data ?? [];
+    const hit = res2.headers["s-total-hits"];
+    const total = hit !== void 0 ? parseInt(hit, 10) || void 0 : void 0;
+    return { items, total };
+  }
+  const res = await apiFetch2(url, config, {}, verbose);
+  return {
+    items: Array.isArray(res?.mas) ? res.mas : [],
+    total: typeof res?.total === "number" ? res.total : void 0
+  };
+}
+async function runBalanceScan(opts) {
+  let config = loadConfig(opts.token);
+  if (opts.refreshDp) {
+    config = await refreshDataPermission(config);
+  }
+  if (!BALANCE_SUPPORTED_MEDIA.includes(opts.media)) {
+    console.error(
+      `
+\u274C balance scan \u6682\u4E0D\u652F\u6301\u5A92\u4F53\uFF1A${opts.media}
+   \u53EF\u9009\uFF1A${BALANCE_SUPPORTED_MEDIA.join(" | ")}\uFF08MetaAd \u63A5\u53E3\u672A\u5F00\u653E\u4F59\u989D\u67E5\u8BE2\uFF09
+`
+    );
+    process.exit(1);
+  }
+  const media = opts.media;
+  const thresholdDays = opts.thresholdDays ?? 7;
+  const minBalance = opts.minBalance ?? null;
+  const minDailySpend = opts.minDailySpend ?? 0.01;
+  const targetDays = opts.targetDays ?? 30;
+  const pageSize = Math.max(1, Math.min(500, opts.pageSize ?? 200));
+  const maxPages = Math.max(1, Math.min(200, opts.maxPages ?? 20));
+  const allItems = [];
+  let total;
+  for (let page = 1; page <= maxPages; page++) {
+    process.stderr.write(`\r\u23F3 \u626B\u63CF\u4E2D\uFF1A\u7B2C ${page} \u9875\uFF08\u5DF2\u7D2F\u8BA1 ${allItems.length} \u4E2A\u8D26\u6237\uFF09...`);
+    let pageRes;
+    try {
+      pageRes = await fetchOnePage(media, page, pageSize, config, opts.verbose);
+    } catch (err) {
+      process.stderr.write("\n");
+      console.error(`
+\u274C \u62C9\u53D6\u8D26\u6237\u6E05\u5355\u5931\u8D25\uFF08\u7B2C ${page} \u9875\uFF09\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+    allItems.push(...pageRes.items);
+    if (total === void 0 && pageRes.total !== void 0) total = pageRes.total;
+    const fetched = allItems.length;
+    const knownTotal = pageRes.total ?? total;
+    if (pageRes.items.length < pageSize) break;
+    if (knownTotal !== void 0 && fetched >= knownTotal) break;
+  }
+  process.stderr.write("\n");
+  const validIds = [];
+  for (const item of allItems) {
+    const id = item.ma?.mediaCustomerId;
+    if (id && !item.ma?.invalidOAuthToken) validIds.push(String(id));
+  }
+  let balanceMap = /* @__PURE__ */ new Map();
+  let overviewMap = /* @__PURE__ */ new Map();
+  if (validIds.length > 0) {
+    const CHUNK = 100;
+    const chunks = [];
+    for (let i = 0; i < validIds.length; i += CHUNK) chunks.push(validIds.slice(i, i + CHUNK));
+    const [bMaps, oMaps] = await Promise.all([
+      Promise.all(chunks.map((ids) => fetchBalanceMap(media, ids, config, void 0, void 0, opts.verbose))),
+      Promise.all(chunks.map((ids) => fetchOverviewMap(media, ids, config, void 0, void 0, opts.verbose)))
+    ]);
+    for (const m of bMaps) for (const [k, v] of m) balanceMap.set(k, v);
+    for (const m of oMaps) for (const [k, v] of m) overviewMap.set(k, v);
+  }
+  const evaluated = [];
+  for (const item of allItems) {
+    const ma = item.ma;
+    const id = ma?.mediaCustomerId ? String(ma.mediaCustomerId) : "";
+    if (!id) continue;
+    const bal = balanceMap.get(id);
+    const ov = overviewMap.get(id);
+    const balance = bal?.remainingAccountBudget ?? null;
+    const sevenDaySpend = Number(ov?.spend ?? 0);
+    const dailySpend = sevenDaySpend > 0 ? sevenDaySpend / 7 : 0;
+    let remainingDays = null;
+    let recommendedTopup = null;
+    if (dailySpend >= minDailySpend && balance !== null) {
+      remainingDays = +(balance / dailySpend).toFixed(1);
+      const needed = dailySpend * targetDays - balance;
+      recommendedTopup = needed > 0 ? +needed.toFixed(2) : 0;
+    }
+    const lowDays = remainingDays !== null && remainingDays <= thresholdDays;
+    const lowBalance = minBalance !== null && balance !== null && balance <= minBalance;
+    if (!lowDays && !lowBalance) continue;
+    const hitReason = lowDays && lowBalance ? "both" : lowDays ? "low-days" : "low-balance";
+    evaluated.push({
+      mediaCustomerId: id,
+      name: ma.mediaCustomerName ?? null,
+      advertiserName: item.mag?.advertiserName ?? null,
+      currencyCode: bal?.currencyCode ?? ma.currencyCode ?? null,
+      balance,
+      dailySpend: dailySpend > 0 ? +dailySpend.toFixed(2) : null,
+      remainingDays,
+      recommendedTopup,
+      invalidOAuthToken: !!ma.invalidOAuthToken,
+      status: bal?.status ?? bal?.accountStatus ?? null,
+      hitReason
+    });
+  }
+  evaluated.sort((a, b) => {
+    const ad = a.remainingDays ?? Number.POSITIVE_INFINITY;
+    const bd = b.remainingDays ?? Number.POSITIVE_INFINITY;
+    return ad - bd;
+  });
+  const meta = {
+    media,
+    scannedAccounts: allItems.length,
+    validAccounts: validIds.length,
+    skippedInvalidOAuth: allItems.length - validIds.length,
+    hitCount: evaluated.length,
+    thresholds: {
+      days: thresholdDays,
+      minBalance,
+      minDailySpend,
+      targetDaysForTopup: targetDays
+    },
+    pageSize,
+    maxPages,
+    totalReported: total ?? null,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  if (opts.json) {
+    console.log(JSON.stringify({ ok: true, data: { items: evaluated }, meta }, null, 2));
+    return;
+  }
+  console.log(
+    `
+${media} \u8D26\u6237\u4F59\u989D\u626B\u63CF\u5B8C\u6210\uFF1A\u5171\u626B\u63CF ${meta.scannedAccounts} \u4E2A\u8D26\u6237\uFF08\u6709\u6548 ${meta.validAccounts}\uFF09\uFF0C\u547D\u4E2D ${meta.hitCount} \u4E2A\uFF08\u9608\u503C\uFF1A\u7EED\u822A \u2264 ${thresholdDays} \u5929` + (minBalance !== null ? ` \u6216 \u4F59\u989D \u2264 ${minBalance}` : "") + `\uFF09
+`
+  );
+  if (evaluated.length === 0) {
+    console.log("  \u2705 \u65E0\u547D\u4E2D\u8D26\u6237\u3002\n");
+    return;
+  }
+  const cols = [
+    { key: "id", header: "\u8D26\u6237ID" },
+    { key: "company", header: "\u516C\u53F8" },
+    { key: "name", header: "\u8D26\u6237\u540D" },
+    { key: "balance", header: "\u4F59\u989D" },
+    { key: "daily", header: "\u65E5\u5747\u6D88\u8017(\u8FD17\u65E5)" },
+    { key: "days", header: "\u5269\u4F59\u5929\u6570" },
+    { key: "topup", header: `\u5EFA\u8BAE\u5145\u503C(\u76EE\u6807${targetDays}\u5929)` },
+    { key: "reason", header: "\u547D\u4E2D\u539F\u56E0" }
+  ];
+  const reasonText = {
+    "low-days": `\u7EED\u822A \u2264 ${thresholdDays} \u5929`,
+    "low-balance": `\u4F59\u989D \u2264 ${minBalance ?? 0}`,
+    both: `\u7EED\u822A + \u4F59\u989D\u53CC\u4F4E`
+  };
+  const fmtMoney = (v, cur) => v == null ? "-" : `${cur ?? ""} ${v.toFixed(2)}`.trim();
+  const rows = evaluated.map((x) => ({
+    id: x.mediaCustomerId,
+    company: x.advertiserName ?? "-",
+    name: x.name ?? "-",
+    balance: fmtMoney(x.balance, x.currencyCode),
+    daily: fmtMoney(x.dailySpend, x.currencyCode),
+    days: x.remainingDays == null ? "\u2014\uFF08\u6D88\u8017\u8FC7\u4F4E\uFF09" : String(x.remainingDays),
+    topup: fmtMoney(x.recommendedTopup, x.currencyCode),
+    reason: reasonText[x.hitReason]
+  }));
+  printCliTable(rows, cols);
+  console.log(
+    `
+  \u63D0\u793A\uFF1A\u4E0A\u8868\u5DF2\u6309\u5269\u4F59\u5929\u6570\u5347\u5E8F\u6392\u5E8F\u3002
+       - \u5982\u9700\u8C03\u6574\u9608\u503C\uFF1A--threshold-days 14 / --min-balance 500
+       - \u5982\u9700\u8C03\u6574\u5EFA\u8BAE\u5145\u503C\u76EE\u6807\u7EED\u822A\uFF1A--target-days 60
+       - \u5982\u9700\u5BFC\u51FA\u7ED3\u6784\u5316\u6570\u636E\uFF1A\u52A0 --json\uFF08\u542B meta \u6C47\u603B\uFF09
+`
+  );
+}
+
+// src/commands/accounts-digest.ts
+var DIGEST_PLATFORM_CONFIG = {
+  Google: {
+    path: "/query/media-account/",
+    pageParam: "pageNo",
+    fixedParams: { MediaType: "Google", mediaAccountState: "Approved,Linked" },
+    responseType: "array"
+  },
+  Yandex: {
+    path: "/query/media-account/",
+    pageParam: "pageNo",
+    fixedParams: { MediaType: "Yandex", mediaAccountState: "Approved,Linked" },
+    responseType: "array"
+  },
+  TikTok: {
+    path: "/query/media-account/tiktok/SearchMediaAcountByCriteria",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaType: "TikTok",
+      advStatus: "STATUS_ENABLE,STATUS_LIMIT,STATUS_DISABLE",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
+  },
+  BingV2: {
+    path: "/query/media-account/BingV2/SearchBingV2MediaAcountByUserId",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaType: "BingV2",
+      advStatus: "APPROVED",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
+  },
+  Kwai: {
+    path: "/query/media-account/SearchMediaAcountByCriteria",
+    pageParam: "pageNum",
+    fixedParams: {
+      MediaTypes: "Kwai",
+      MediaType: "Kwai",
+      advStatus: "",
+      mediaAccountState: "Approved,Linked",
+      isForce: false
+    },
+    responseType: "mas"
+  }
+};
+async function fetchAccountsByMedia(media, config, opts) {
+  const cfg = DIGEST_PLATFORM_CONFIG[media];
+  if (!cfg) throw new Error(`accounts-digest \u6682\u4E0D\u652F\u6301\u5A92\u4F53\uFF1A${media}`);
+  const all = [];
+  let total;
+  for (let page = 1; page <= opts.maxPages; page++) {
+    process.stderr.write(`\r\u23F3 \u62C9\u53D6\u8D26\u6237\u6E05\u5355\uFF1A\u7B2C ${page} \u9875\uFF08\u7D2F\u8BA1 ${all.length}\uFF09...`);
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(cfg.fixedParams)) params.set(k, String(v));
+    params.set(cfg.pageParam, String(page));
+    params.set("pageSize", String(opts.pageSize));
+    const url = `${config.apiBaseUrl}${cfg.path}?${params}`;
+    if (cfg.responseType === "array") {
+      const res = await apiFetchWithHeaders2(url, config, {}, opts.verbose);
+      const pageItems = res.data ?? [];
+      all.push(...pageItems);
+      if (total === void 0) {
+        const hit = res.headers["s-total-hits"];
+        if (hit !== void 0) total = parseInt(hit, 10) || void 0;
+      }
+      if (pageItems.length < opts.pageSize) break;
+      if (total !== void 0 && all.length >= total) break;
+    } else {
+      const res = await apiFetch2(url, config, {}, opts.verbose);
+      const pageItems = Array.isArray(res?.mas) ? res.mas : [];
+      all.push(...pageItems);
+      if (total === void 0 && typeof res?.total === "number") total = res.total;
+      if (pageItems.length < opts.pageSize) break;
+      if (total !== void 0 && all.length >= total) break;
+    }
+  }
+  process.stderr.write("\n");
+  return { items: all, total };
+}
+function round2(n) {
+  if (n == null) return null;
+  const v = Number(n);
+  return Number.isFinite(v) ? +v.toFixed(2) : null;
+}
+async function runAccountsDigest(opts) {
+  let config = loadConfig(opts.token);
+  if (opts.refreshDp) config = await refreshDataPermission(config);
+  if (!BALANCE_SUPPORTED_MEDIA.includes(opts.media)) {
+    console.error(
+      `
+\u274C accounts-digest \u6682\u4E0D\u652F\u6301\u5A92\u4F53\uFF1A${opts.media}
+   \u53EF\u9009\uFF1A${BALANCE_SUPPORTED_MEDIA.join(" | ")}\uFF08MetaAd \u65E0\u4F59\u989D/\u6D88\u8017\u6C47\u603B\u63A5\u53E3\uFF09
+`
+    );
+    process.exit(1);
+  }
+  const media = opts.media;
+  const filterIds = (opts.accounts ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  const filterSet = new Set(filterIds);
+  const minSpend = opts.minSpend ?? 0;
+  const pageSize = Math.max(1, Math.min(500, opts.pageSize ?? 200));
+  const maxPages = Math.max(1, Math.min(200, opts.maxPages ?? 20));
+  let accountsList;
+  try {
+    const res = await fetchAccountsByMedia(media, config, { pageSize, maxPages, verbose: opts.verbose });
+    accountsList = res.items;
+  } catch (err) {
+    console.error(`
+\u274C \u62C9\u53D6\u8D26\u6237\u6E05\u5355\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  if (filterSet.size > 0) {
+    accountsList = accountsList.filter((it) => {
+      const id = it.ma?.mediaCustomerId;
+      return id != null && filterSet.has(String(id));
+    });
+  }
+  const validIds = accountsList.filter((it) => it.ma?.mediaCustomerId && !it.ma?.invalidOAuthToken).map((it) => String(it.ma.mediaCustomerId));
+  const CHUNK = 100;
+  const chunks = [];
+  for (let i = 0; i < validIds.length; i += CHUNK) chunks.push(validIds.slice(i, i + CHUNK));
+  const balanceMap = /* @__PURE__ */ new Map();
+  const overviewMap = /* @__PURE__ */ new Map();
+  if (chunks.length > 0) {
+    process.stderr.write(`\u23F3 \u62C9\u53D6\u4F59\u989D\u4E0E\u6D88\u8017\u6570\u636E\uFF08${validIds.length} \u4E2A\u8D26\u6237\uFF0C\u5206 ${chunks.length} \u6279\uFF09...
+`);
+    const [bMaps, oMaps] = await Promise.all([
+      Promise.all(chunks.map((ids) => fetchBalanceMap(media, ids, config, opts.startDate, opts.endDate, opts.verbose))),
+      Promise.all(chunks.map((ids) => fetchOverviewMap(media, ids, config, opts.startDate, opts.endDate, opts.verbose)))
+    ]);
+    for (const m of bMaps) for (const [k, v] of m) balanceMap.set(k, v);
+    for (const m of oMaps) for (const [k, v] of m) overviewMap.set(k, v);
+  }
+  const rows = [];
+  for (const item of accountsList) {
+    const ma = item.ma;
+    const id = ma?.mediaCustomerId ? String(ma.mediaCustomerId) : "";
+    if (!id) continue;
+    const bal = balanceMap.get(id);
+    const ov = overviewMap.get(id);
+    const spend = ov?.spend != null ? Number(ov.spend) : null;
+    if (spend != null && spend <= minSpend && minSpend > 0) continue;
+    const impressions = ov?.impressions != null ? Number(ov.impressions) : null;
+    const clicks = ov?.clicks != null ? Number(ov.clicks) : null;
+    const conversions = ov?.conversions != null ? Number(ov.conversions) : null;
+    const ctr = impressions && impressions > 0 && clicks != null ? clicks / impressions : null;
+    const cpc = clicks && clicks > 0 && spend != null ? spend / clicks : null;
+    const cpa = conversions && conversions > 0 && spend != null ? spend / conversions : null;
+    rows.push({
+      mediaCustomerId: id,
+      name: ma.mediaCustomerName ?? null,
+      advertiserName: item.mag?.advertiserName ?? null,
+      currencyCode: bal?.currencyCode ?? ma.currencyCode ?? null,
+      balance: round2(bal?.remainingAccountBudget ?? null),
+      spend: round2(spend),
+      impressions: impressions != null ? Math.round(impressions) : null,
+      clicks: clicks != null ? Math.round(clicks) : null,
+      conversions: conversions != null ? Math.round(conversions) : null,
+      ctr: ctr != null ? +(ctr * 100).toFixed(2) : null,
+      // 百分比
+      cpc: round2(cpc),
+      cpa: round2(cpa),
+      invalidOAuthToken: !!ma.invalidOAuthToken
+    });
+  }
+  rows.sort((a, b) => (b.spend ?? 0) - (a.spend ?? 0));
+  const totals = rows.reduce(
+    (acc, r) => {
+      acc.spend += r.spend ?? 0;
+      acc.clicks += r.clicks ?? 0;
+      acc.impressions += r.impressions ?? 0;
+      acc.conversions += r.conversions ?? 0;
+      return acc;
+    },
+    { spend: 0, clicks: 0, impressions: 0, conversions: 0 }
+  );
+  const meta = {
+    media,
+    window: {
+      startDate: opts.startDate ?? null,
+      endDate: opts.endDate ?? null,
+      note: opts.startDate && opts.endDate ? "\u7528\u6237/AI \u660E\u786E\u6307\u5B9A\u533A\u95F4" : "\u672A\u6307\u5B9A\u533A\u95F4\uFF0CCLI \u9ED8\u8BA4\u8FD1 7 \u5929\uFF1BSKILL \u8981\u6C42\u5148\u5411\u7528\u6237\u786E\u8BA4"
+    },
+    scanned: accountsList.length,
+    returned: rows.length,
+    totals: {
+      spend: +totals.spend.toFixed(2),
+      clicks: totals.clicks,
+      impressions: totals.impressions,
+      conversions: totals.conversions,
+      ctr: totals.impressions > 0 ? +(totals.clicks / totals.impressions * 100).toFixed(2) : null,
+      cpc: totals.clicks > 0 ? +(totals.spend / totals.clicks).toFixed(2) : null,
+      cpa: totals.conversions > 0 ? +(totals.spend / totals.conversions).toFixed(2) : null
+    },
+    currencyNote: "\u5404\u8D26\u6237\u4E3B\u5E01\u79CD\u53EF\u80FD\u4E0D\u540C\uFF0Ctotals \u76F4\u63A5\u6C42\u548C\uFF0C\u8DE8\u5E01\u79CD\u8D26\u6237\u8BF7\u6309 currencyCode \u5B57\u6BB5\u5206\u522B\u6C47\u603B",
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  if (opts.json) {
+    console.log(JSON.stringify({ ok: true, data: { items: rows }, meta }, null, 2));
+    return;
+  }
+  console.log(
+    `
+${media} \u8D26\u6237\u6295\u653E\u753B\u50CF\uFF1A\u8FD4\u56DE ${rows.length} \u4E2A\u8D26\u6237\uFF08\u626B\u63CF ${meta.scanned}\uFF09` + (opts.startDate && opts.endDate ? `\uFF0C\u533A\u95F4\uFF1A${opts.startDate} ~ ${opts.endDate}` : "\uFF0C\u533A\u95F4\uFF1ACLI \u9ED8\u8BA4\u8FD1 7 \u5929\uFF08\u5EFA\u8BAE\u660E\u786E\u6307\u5B9A --start/--end\uFF09") + `
+`
+  );
+  if (rows.length === 0) {
+    console.log("  \u6682\u65E0\u6570\u636E\u3002\n");
+    return;
+  }
+  const cols = [
+    { key: "id", header: "\u8D26\u6237ID" },
+    { key: "company", header: "\u516C\u53F8" },
+    { key: "name", header: "\u8D26\u6237\u540D" },
+    { key: "spend", header: "\u6D88\u8017" },
+    { key: "impr", header: "\u5C55\u793A" },
+    { key: "clicks", header: "\u70B9\u51FB" },
+    { key: "conv", header: "\u8F6C\u5316" },
+    { key: "ctr", header: "\u70B9\u51FB\u7387%" },
+    { key: "cpc", header: "CPC" },
+    { key: "cpa", header: "CPA" },
+    { key: "balance", header: "\u4F59\u989D" }
+  ];
+  const fmtMoney = (v, cur) => v == null ? "-" : `${cur ?? ""} ${v.toFixed(2)}`.trim();
+  const tableRows = rows.map((r) => ({
+    id: r.mediaCustomerId,
+    company: r.advertiserName ?? "-",
+    name: r.name ?? "-",
+    spend: fmtMoney(r.spend, r.currencyCode),
+    impr: r.impressions != null ? String(r.impressions) : "-",
+    clicks: r.clicks != null ? String(r.clicks) : "-",
+    conv: r.conversions != null ? String(r.conversions) : "-",
+    ctr: r.ctr != null ? r.ctr.toFixed(2) : "-",
+    cpc: fmtMoney(r.cpc, r.currencyCode),
+    cpa: fmtMoney(r.cpa, r.currencyCode),
+    balance: fmtMoney(r.balance, r.currencyCode)
+  }));
+  printCliTable(tableRows, cols);
+  console.log(
+    `
+  \u6C47\u603B\uFF1A\u6D88\u8017 ${meta.totals.spend}\uFF0C\u70B9\u51FB ${meta.totals.clicks}\uFF0C\u5C55\u793A ${meta.totals.impressions}\uFF0C\u8F6C\u5316 ${meta.totals.conversions}
+  \u63D0\u793A\uFF1A
+    - \u91D1\u989D\u4F7F\u7528\u5404\u8D26\u6237\u4E3B\u5E01\u79CD\uFF1B\u8DE8\u5E01\u79CD\u8D26\u6237\u52A0 --json \u81EA\u884C\u6309 currencyCode \u805A\u5408
+    - \u6307\u5B9A\u8D26\u6237\u5B50\u96C6\uFF1A--accounts <id1,id2,...>\uFF08\u4E0E list-accounts \u7684 mediaCustomerId \u4E00\u81F4\uFF09
+    - \u8FC7\u6EE4\u4F4E\u6D88\u8017\uFF1A--min-spend 10\uFF08\u53EA\u4FDD\u7559\u533A\u95F4\u5185\u6D88\u8017 > 10 \u7684\u8D26\u6237\uFF09
+`
+  );
+}
+
 // src/commands/stats.ts
 var VALID_MEDIA_TYPES3 = ["Google", "TikTok", "Yandex", "MetaAd", "BingV2", "Kwai"];
 function defaultDateRange2() {
@@ -6085,6 +6612,12 @@ function toGoogleDate(dateStr, offsetDays) {
   d.setDate(d.getDate() + offsetDays);
   return d.toISOString().slice(0, 10).replace(/-/g, "/");
 }
+function toDisplayMoney(raw) {
+  if (raw == null) return null;
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return null;
+  return n / 100;
+}
 function adgroupListUrl(googleApiUrl, account, startDate, endDate) {
   const params = new URLSearchParams();
   params.set("startDate", toGoogleDate(startDate, -30));
@@ -6116,7 +6649,15 @@ async function runAdCampaigns(opts) {
 `);
     process.exit(1);
   }
-  const items = data.data ?? [];
+  const rawItems = data.data ?? [];
+  const items = rawItems.map((item) => {
+    const budgetDisplay = toDisplayMoney(item.budget);
+    return {
+      ...item,
+      budgetDisplay,
+      budgetUnit: "display"
+    };
+  });
   const n = items.length;
   if (opts.json) {
     console.log(
@@ -6145,7 +6686,7 @@ async function runAdCampaigns(opts) {
     { key: "status", header: "\u72B6\u6001" },
     { key: "channelType", header: "\u7C7B\u578B" },
     { key: "bidding", header: "\u51FA\u4EF7\u7B56\u7565" },
-    { key: "budget", header: "\u9884\u7B97" },
+    { key: "budget", header: "\u65E5\u9884\u7B97" },
     { key: "clicks", header: "\u70B9\u51FB" },
     { key: "impressions", header: "\u5C55\u793A" },
     { key: "ctr", header: "\u70B9\u51FB\u7387" },
@@ -6155,12 +6696,13 @@ async function runAdCampaigns(opts) {
   const rows = items.map((item) => {
     const ctr = item.ctr != null ? (Number(item.ctr) * 100).toFixed(2) + "%" : "\u2014";
     const spend = item.spend != null ? Number(item.spend).toFixed(2) : "\u2014";
+    const budget = item.budgetDisplay != null ? item.budgetDisplay.toFixed(2) : "\u2014";
     return {
       name: (item.name ?? "").slice(0, nameW),
       status: item.statusV2 ?? "",
       channelType: item.channelTypeV2 ?? "",
       bidding: String(item.biddingStrategyTypeV2 ?? ""),
-      budget: String(item.budget ?? ""),
+      budget,
       clicks: String(item.clicks ?? 0),
       impressions: String(item.impressions ?? 0),
       ctr,
@@ -6187,7 +6729,15 @@ async function runAdGroups(opts) {
 `);
     process.exit(1);
   }
-  const items = data.data ?? [];
+  const rawItems = data.data ?? [];
+  const items = rawItems.map((item) => {
+    const maxCpcDisplay = toDisplayMoney(item["maxCPCAmount"]);
+    return {
+      ...item,
+      maxCPCAmountDisplay: maxCpcDisplay,
+      maxCPCAmountUnit: "display"
+    };
+  });
   const n = items.length;
   if (opts.json) {
     console.log(
@@ -6221,7 +6771,8 @@ async function runAdGroups(opts) {
   const rows = items.map((item) => {
     const cpc = item["averageCpc"] != null ? Number(item["averageCpc"]).toFixed(2) : "\u2014";
     const spend = item["spend"] != null ? Number(item["spend"]).toFixed(2) : "\u2014";
-    const maxCpc = item["maxCPCAmount"] != null ? String(item["maxCPCAmount"]) : "\u2014";
+    const maxCpcNum = item["maxCPCAmountDisplay"];
+    const maxCpc = maxCpcNum != null ? maxCpcNum.toFixed(2) : "\u2014";
     return {
       name: String(item["name"] ?? "").slice(0, nameW),
       campaignName: String(item["campaignName"] ?? "").slice(0, campW),
@@ -10935,6 +11486,10 @@ program.command("list-accounts").description("\u67E5\u8BE2\u5E7F\u544A\u8D26\u62
   "--plain",
   "\u5DF2\u9ED8\u8BA4 ASCII \u7EBF\u6846\uFF0C\u65E0\u9700\u518D\u4F20\uFF1B\u4FDD\u7559\u517C\u5BB9\u65E7\u811A\u672C",
   false
+).option(
+  "--refresh-dp",
+  "\u5F3A\u5236\u91CD\u62C9 Datapermission \u540E\u518D\u8BF7\u6C42\u5217\u8868\uFF08\u7528\u4E8E\u300C\u7B2C\u4E8C\u6B21\u62C9\u53D6\u5168\u90E8\u5931\u6548\u300D\u7C7B\u4F1A\u8BDD\u5F02\u5E38\u7684\u4E00\u952E\u6392\u67E5\uFF09",
+  false
 ).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
   await runListAccounts({
     token: opts.token,
@@ -10946,6 +11501,7 @@ program.command("list-accounts").description("\u67E5\u8BE2\u5E7F\u544A\u8D26\u62
     json: opts.json,
     quick: opts.quick,
     unicode: opts.unicode,
+    refreshDp: opts.refreshDp,
     verbose: opts.verbose
   });
 });
@@ -10983,6 +11539,46 @@ program.command("balance").description("\u67E5\u8BE2\u5E7F\u544A\u8D26\u6237\u5B
     verbose: opts.verbose
   });
 });
+program.command("balance-scan").description(
+  "\u4E00\u952E\u626B\u63CF\u67D0\u5A92\u4F53\u4E0B\u6240\u6709\u8D26\u6237\u7684\u4F59\u989D\uFF0C\u7B5B\u51FA\u7EED\u822A\u5929\u6570\u4E0D\u8DB3\u7684\u8D26\u6237\u3002\u66FF\u4EE3\u5FAA\u73AF\u8C03\u7528 balance \u7684\u4F20\u7EDF\u505A\u6CD5\uFF0C\u5178\u578B\u573A\u666F\uFF1A\u300C\u5E2E\u6211\u627E\u51FA 117 \u4E2A Bing \u8D26\u6237\u91CC\u4F59\u989D\u4E0D\u8DB3 7 \u5929\u7684\u300D\u3002"
+).requiredOption(
+  "-m, --media <type>",
+  "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | BingV2 | Kwai\uFF08MetaAd \u63A5\u53E3\u672A\u5F00\u653E\u4F59\u989D\u67E5\u8BE2\uFF09"
+).option("--threshold-days <n>", "\u5269\u4F59\u7EED\u822A\u5929\u6570\u9608\u503C\uFF08\u9ED8\u8BA4 7\uFF0C\u6309\u8FD1 7 \u65E5\u65E5\u5747\u6D88\u8017\u4F30\u7B97\uFF09", (v) => parseFloat(v)).option("--min-balance <n>", "\u989D\u5916\u6309\u7EDD\u5BF9\u4F59\u989D\u9608\u503C\u547D\u4E2D\uFF08\u4E3B\u5E01\u79CD\u91D1\u989D\uFF0C\u4E0E --threshold-days \u53D6\u5E76\u96C6\uFF09", (v) => parseFloat(v)).option("--min-daily-spend <n>", "\u8FD1 7 \u65E5\u65E5\u5747\u6D88\u8017 < \u6B64\u503C\u7684\u8D26\u6237\u89C6\u4E3A\u50F5\u5C38\u8D26\u6237\u4E0D\u505A\u7EED\u822A\u4F30\u7B97\uFF08\u9ED8\u8BA4 0.01\uFF09", (v) => parseFloat(v)).option("--target-days <n>", "\u5EFA\u8BAE\u5145\u503C\u6309\u6B64\u76EE\u6807\u7EED\u822A\u5929\u6570\u8BA1\u7B97\uFF08\u9ED8\u8BA4 30\uFF09", (v) => parseFloat(v)).option("--page-size <n>", "\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF0C\u4E0A\u9650 500\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF0C\u4E0A\u9650 200\uFF1B\u8D85\u51FA\u540E\u8BF7\u63D0\u9AD8 --page-size \u6216\u5206\u6B21\u626B\u63CF\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option("--json", "\u8F93\u51FA\u7ED3\u6784\u5316 JSON\uFF0C\u542B meta\uFF08\u626B\u63CF\u6570/\u547D\u4E2D\u6570/\u9608\u503C/\u65F6\u95F4\u6233\uFF09", false).option("--refresh-dp", "\u5F3A\u5236\u91CD\u62C9 Datapermission \u540E\u518D\u626B\u63CF\uFF08\u6392\u67E5\u4F1A\u8BDD\u5F02\u5E38\uFF09", false).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
+  await runBalanceScan({
+    token: opts.token,
+    media: opts.media,
+    thresholdDays: opts.thresholdDays,
+    minBalance: opts.minBalance,
+    minDailySpend: opts.minDailySpend,
+    targetDays: opts.targetDays,
+    pageSize: opts.pageSize,
+    maxPages: opts.maxPages,
+    json: opts.json,
+    refreshDp: opts.refreshDp,
+    verbose: opts.verbose
+  });
+});
+program.command("accounts-digest").description(
+  "\u591A\u8D26\u6237\u6295\u653E\u753B\u50CF\uFF1A\u4E00\u6761\u547D\u4EE4\u62FF\u9F50\u6D88\u8017/\u70B9\u51FB/\u8F6C\u5316/\u4F59\u989D/\u6D3E\u751F\u6307\u6807\uFF08CTR/CPC/CPA\uFF09\uFF0C\u66FF\u4EE3 AI \u9010\u8D26\u6237 `list-accounts` + `stats` \u7684\u7F16\u6392\u3002\u5178\u578B\u573A\u666F\uFF1A\u300C\u8FD9 10 \u4E2A\u8D26\u6237\uFF08\u6216\u67D0\u5A92\u4F53\u5168\u90E8\u8D26\u6237\uFF09\u5E2E\u6211\u6574\u7406\u4E00\u4E0B\u300D\u3002"
+).requiredOption(
+  "-m, --media <type>",
+  "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | BingV2 | Kwai\uFF08MetaAd \u65E0\u6D88\u8017\u6C47\u603B\u63A5\u53E3\uFF09"
+).option("-a, --accounts <ids>", "\u6307\u5B9A\u8D26\u6237 mediaCustomerId\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u7559\u7A7A\u5219\u626B\u63CF\u8BE5\u5A92\u4F53\u4E0B\u5168\u90E8\u8D26\u6237").option("--start <date>", "\u7EDF\u8BA1\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08SKILL \u8981\u6C42 AI \u5148\u4E0E\u7528\u6237\u786E\u8BA4\uFF09").option("--end <date>", "\u7EDF\u8BA1\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08SKILL \u8981\u6C42 AI \u5148\u4E0E\u7528\u6237\u786E\u8BA4\uFF09").option("--min-spend <n>", "\u8FC7\u6EE4\uFF1A\u533A\u95F4\u5185\u6D88\u8017 \u2264 \u6B64\u503C\u7684\u8D26\u6237\u4E0D\u8FD4\u56DE\uFF08\u9ED8\u8BA4 0\uFF09", (v) => parseFloat(v)).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF0C\u4E0A\u9650 500\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF0C\u4E0A\u9650 200\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option("--json", "\u8F93\u51FA\u7ED3\u6784\u5316 JSON\uFF0C\u542B data.items \u4E0E meta\uFF08\u533A\u95F4/\u6C47\u603B/\u5E01\u79CD\u5907\u6CE8\uFF09", false).option("--refresh-dp", "\u5F3A\u5236\u91CD\u62C9 Datapermission \u540E\u518D\u8BF7\u6C42", false).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
+  await runAccountsDigest({
+    token: opts.token,
+    media: opts.media,
+    accounts: opts.accounts,
+    startDate: opts.start,
+    endDate: opts.end,
+    minSpend: opts.minSpend,
+    pageSize: opts.pageSize,
+    maxPages: opts.maxPages,
+    json: opts.json,
+    refreshDp: opts.refreshDp,
+    verbose: opts.verbose
+  });
+});
 program.command("stats").description("\u67E5\u8BE2\u5E7F\u544A\u6D88\u8017\u3001\u70B9\u51FB\u3001\u8F6C\u5316\u7B49\u6295\u653E\u6570\u636E\uFF08\u9ED8\u8BA4\u8FD1 7 \u5929\uFF0C\u4E0D\u542B\u4ECA\u5929\uFF09").requiredOption(
   "-m, --media <type>",
   "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | MetaAd | BingV2 | Kwai"

package/dist/skill/SKILL.md

@@ -18,8 +18,14 @@ allowed-tools: Bash(siluzan-tso:*) Read
 
 如果 CLI 尚未安装，直接帮用户执行对应平台的安装脚本：
 
-- **macOS / Linux / WSL：** `bash scripts/install.sh`
-- **Windows PowerShell：** `powershell -ExecutionPolicy Bypass -File scripts/install.ps1`
+- **macOS / Linux / WSL：**
+  ```bash
+  bash <(curl -fsSL https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.sh)
+  ```
+- **Windows PowerShell：**
+  ```powershell
+  irm https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.ps1 | iex
+  ```
 
 脚本会自动完成 Node.js 检测/安装、CLI 安装、Skill 全局注册，并引导用户配置 API Key。无需选择，本脚本专为 siluzan-tso-cli 定制。
 
@@ -107,6 +113,65 @@ allowed-tools: Bash(siluzan-tso:*) Read
 - **具体业务的额外规范**：开户、优化、报告、Google 广告创建等场景的详细约束，请分别在执行前阅读对应的 `references/*.md` 文档。
 - **完成写/修改/编辑/更新等操作后需要确认数据是否正确**
 
+### 时间范围强制反问（必须遵守）
+
+任何涉及"投放数据 / 消耗 / 报告 / 周报 / 月报 / 优化建议"的任务，如果用户没给出**明确的开始与结束日期**，**不要自己猜**（尤其不要默认"最近 30 天 / 近 7 天 / 本月"）。按如下步骤处理：
+
+1. **先反问**一次：示例措辞 —
+   > 本次分析要覆盖哪个时间范围？例如：
+   > （A）最近完整自然周（周一到周日）
+   > （B）本月 1 号到昨天
+   > （C）自定义起止日（请告诉我 `YYYY-MM-DD` 起止）
+2. 用户给出范围后，**在报告首行显式标注"统计区间：YYYY-MM-DD ~ YYYY-MM-DD（时区：用户本地/UTC）"**，与调用参数保持完全一致。
+3. **只有在用户明确说"按你默认来 / 你决定"**时，才使用下方默认值白名单。
+
+### 默认值白名单（仅在用户明确授权"你决定"时才能使用）
+
+| 场景 | 允许的默认窗口 |
+|------|--------|
+| 日常投放巡检 / 余额扫描 | `now - 7d` ~ `now`（本地时间） |
+| 周报 | 上一个完整自然周（周一 00:00 ~ 周日 23:59） |
+| 月报 | 上一个完整自然月（1 号 ~ 月末） |
+| Google 关键词/系列分析 | `now - 30d` ~ `now`（与 TSO Google 接口最小窗口对齐） |
+| MetaAd 账户分析 | 不得默认，必须问（Meta 接口对窗口敏感） |
+
+### 金额与货币单位硬约束
+
+- **永远使用 `*Display` 字段或表格展示值**做用户可见的金额。**不要用原 `budget` / `maxCPCAmount`**，它们是批量接口的 `×100` 分单位，直接展示会 100 倍放大（典型错误：¥50 显示为 ¥5000）。
+- JSON 响应里任何以 `Display` 结尾的数字字段即为主币种展示值，单位来自同级 `currencyCode` 字段。
+- 当命令返回 `budgetUnit: "display"` / `maxCPCAmountUnit: "display"` 标识时，**必须**优先信任该字段。
+- 编写报告/表格时金额保留 2 位小数，并写明货币代码（例如 `¥50.00 CNY` / `$50.00 USD`）。
+
+### 品牌名 / 公司名来源硬约束
+
+- 生成任何带品牌名的方案、邮件、报告时，**不得自行生成中文译名或拼音**。品牌名**必须**来自以下来源之一（按优先级）：
+  1. 用户在对话里明确提供的品牌名
+  2. `list-accounts` 返回的 `mag.advertiserName`
+  3. 用户提供的网址 → 明确告诉用户"使用域名作为占位"（例如 `hy-steelpipe.com`）并在交付物里标注 `[待确认品牌名]`
+- **严禁**"hy-steelpipe.com"这样的英文域名被输出成类似"海悦钢管"这种虚构中文品牌。
+
+### 批量任务硬约束（≥ 5 个账户或系列）
+
+以下情形**必须**使用批量 / 扫描命令而非循环单条调用，否则严重拖慢并易卡死：
+
+| 任务 | 推荐命令 | 禁止做法 |
+|------|----------|----------|
+| 多账户余额 / 预算不足预警 | `balance-scan -m <媒体> --threshold-days 7` | 逐账户循环 `balance --accounts ...` |
+| 多账户投放画像（消耗/点击/转化汇总） | `accounts-digest -m <媒体> [-a id1,id2] --start --end --json` | 对每个账户依次 `stats --id ...` |
+| 多系列诊断 | `ad campaigns --json` + node 过滤 | 逐系列 `ad campaign-get` |
+
+如果命令行尚未提供批量入口（例如 117 个 Bing 账户的"剩余天数"计算），应：
+1. 先用 `list-accounts -m BingV2 --json` 一次性拿到全量账户（含余额/日均消耗），**不要**逐账户轮询余额。
+2. 通过 `node -e` 在本地做 `剩余天数 = 余额 / 近 7 日日均消耗` 的计算并筛选阈值。
+3. 只对命中的账户再做后续写入操作。
+
+### 运行时长与用户可见进度
+
+长任务（多账户、批量优化、报告生成）**必须**满足：
+- 预估超过 2 分钟的任务，开始前先告诉用户"预计耗时 X 分钟，将以 X 个账户一批处理"。
+- 每处理一批输出一行进度（例如 `已处理 20 / 117`）。
+- 处理超过 5 分钟仍未完成时，主动检查是否有必要降级（例如从"完整分析"降为"只筛阈值"）并告知用户。
+
 ### 必须一定要遵守的规范
 
 - 主动更新（详情请读取`references/setup.md`）
@@ -123,6 +188,85 @@ allowed-tools: Bash(siluzan-tso:*) Read
   - 广告发布（`ad batch publish` / `ad campaign-create`）— 涉及预算消耗
 - **只读操作可自主执行**：查询类命令（`list-accounts`、`balance`、`stats`、`report list`、`config show` 等）可直接执行，无需额外确认
 
+---
+
+## Playbook：高频任务的标准动作
+
+下面是 AI 遇到常见任务时**应优先采用**的编排方式。每个 Playbook 都已把"时间反问 / 批量 / 金额单位 / 品牌名"等硬约束考虑进去。除非用户明确要求，不要偏离。
+
+### P1 · 单账户投放画像（典型指令："xxx 账户帮我整理一下投放数据"）
+
+> 触发关键词：某账户数据 / 投放情况 / 整理账户 / 看下某个账户的表现
+
+1. **反问时间范围**（参见"时间范围强制反问"）。
+2. `list-accounts -m Google -k <mediaCustomerId> --quick --json`
+   - 一次拿齐：账户基础信息、创建日期、当前状态、公司名（`mag.advertiserName` 作为品牌名）
+3. `stats --media Google --accounts <id> --start-date <S> --end-date <D> --json`
+   - 拿该区间消耗、点击、转化等；**直接读响应中的主币种数值**，不要再 ×100。
+4. `ad campaigns --account <id> --start-date <S> --end-date <D> --json`
+   - 拿广告系列类型（Search / PMax / Display 等）、日预算（**用 `budgetDisplay`**）、优化得分相关字段。
+5. `stats` 结合 `accountsoverview` 字段派生"开始投放时间 / 有效投放天数 / 地区消耗分布"（如接口暂未直出，在 node 里聚合）。
+6. 用 `report-templates/google-account-diagnosis-report.md` 模板输出，**首行标注统计区间和货币**。
+
+### P2 · 多账户余额扫描 / 预算预警（典型指令："117 个 Bing 账户不足 7 天的挑出来"）
+
+> 触发关键词：不足 X 天 / 余额预警 / 账户要没钱 / 哪些账户要充值
+
+**一条命令即可完成，不要循环**：
+
+```bash
+siluzan-tso balance-scan -m BingV2 --threshold-days 7 --json
+# 筛绝对余额：再叠加 --min-balance 100
+# 自定义续航目标：--target-days 60 会算出"充到够用 60 天"的建议充值额
+```
+
+输出结构（`--json`）：
+```json
+{
+  "ok": true,
+  "data": { "items": [{ "mediaCustomerId": "...", "balance": 42.3, "dailySpend": 7.1, "remainingDays": 5.9, "recommendedTopup": 170.69, ... }] },
+  "meta": { "media": "BingV2", "scannedAccounts": 117, "hitCount": 23, "thresholds": { ... } }
+}
+```
+
+硬规矩：
+- **绝对不要** `for id of ids { balance --accounts id }` 循环，会把 117 个账户拖成几十分钟。
+- 输出报告时按 `remainingDays` 升序（命令默认已排）；金额展示用命令返回的 `balance`/`recommendedTopup` 数值 + `currencyCode`。
+- 若 `--verbose` 发现大量账户进入"僵尸账户（消耗过低）"分支，告诉用户这些账户没真正投放，不纳入预警。
+
+### P3 · 多账户投放画像汇总（典型指令："这 10 个账户数据整理一下"）
+
+> 触发关键词：这些账户 / 给我一份 X 个账户的表 / ROAS/CPA 对比
+
+**首选一条命令**：
+
+```bash
+siluzan-tso accounts-digest -m Google \
+  -a 4251234567,7209009390,... \
+  --start 2026-04-01 --end 2026-04-15 \
+  --json
+```
+
+- 一次返回：账户清单 + 消耗/点击/展示/转化 + CTR/CPC/CPA + 余额，含 `meta.totals` 汇总和货币提示。
+- 不指定 `-a` 时扫描媒体全部账户。
+- 不指定 `--start/--end` 时默认近 7 天；**SKILL 要求必须先与用户确认时间范围**，再把用户确认的区间带上。
+
+标准步骤：
+1. **反问时间范围**（P 级硬约束），拿到用户回复后再执行 `accounts-digest`。
+2. 如命令已返回 `--json`，直接基于其中 `data.items` 与 `meta.totals` 生成报告；**不要**再逐账户 `stats`。
+3. 跨币种账户：按 `item.currencyCode` 分表或在 meta.currencyNote 提示的前提下分币种小计。
+4. 金额字段严格按"金额与货币单位硬约束"处理。
+
+### P4 · Google 账户周期报告（典型指令："生成 2026.1.1-2026.4.15 的报告"）
+
+1. **确认时间范围**（用户已给则直接用，否则按 P1 反问）。
+2. 按 P1 步骤拿数据；**若区间 > 3 个月**，主动分段（季度/月）以避免接口超时。
+3. 使用 `report-templates/google-period-report.md` 模板输出。
+4. 首行必须有：`统计区间：2026-01-01 ~ 2026-04-15` + `货币：XXX`。
+5. 报告必须包含：账户概览、投放趋势、Top 关键词/系列 / 地区分布 / 优化建议；不得编造未拉取到的指标（例如没拉取到的关键词就写"未提供"而不是估算）。
+
+---
+
 ## 一些tips
 
 ### 账户ID示例

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.11-beta.7",
-  "publishedAt": 1776330275956
+  "version": "1.1.12",
+  "publishedAt": 1776410305637
 }

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

@@ -8,15 +8,42 @@
 ---
 
 ## 默认做法
-1. 询问用户需要生成哪些维度的报告，或直接生成默认报告：包含以下维度：执行摘要、每日投放趋势、月度汇总、广告系列表现、设备分布、地域分布、关键词表现、优化建议
-2. 确定报告需要如何分析请查看（`report-templates/README.md`）
-3. 根据默认模板：`report-templates/report-template.html` 为样式基准来生成html 然后将html转为pdf交付
-4. 输出 HTML 时：**默认**以 `report-templates/report-template.html` 为样式基准（适用于一切总结性、报告性、汇总性成稿）；若场景更适合作正式件、深色、单页等，再从 `report-templates/report-template*.html` 中选或询问用户，并对照 `report-templates/README.md`
-5. 注意最终交付的是用html生成的PDF
-6. 使用浏览器或能够打开html/pdf的插件帮用户打开报告
+1. **先确认统计区间**：除非用户已明确给出起止日期，否则**必须先反问**时间范围（例如"本月 1 号到昨天？还是自定义 YYYY-MM-DD 起止？"），**不得擅自默认**（参见 SKILL.md 的"时间范围强制反问"）。
+2. 询问用户需要生成哪些维度的报告，或直接生成默认报告：包含以下维度：执行摘要、每日投放趋势、月度汇总、广告系列表现、设备分布、地域分布、关键词表现、优化建议
+3. 确定报告需要如何分析请查看（`report-templates/README.md`）
+4. 根据默认模板：`report-templates/report-template.html` 为样式基准来生成html 然后将html转为pdf交付
+5. 输出 HTML 时：**默认**以 `report-templates/report-template.html` 为样式基准（适用于一切总结性、报告性、汇总性成稿）；若场景更适合作正式件、深色、单页等，再从 `report-templates/report-template*.html` 中选或询问用户，并对照 `report-templates/README.md`
+6. 注意最终交付的是用html生成的PDF
+7. 使用浏览器或能够打开html/pdf的插件帮用户打开报告
+8. **报告首行**必须标注：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`，与实际调用 `--start` / `--end` 一致。
 
 用于按账户维度拉取 Google Ads 报表、结构类数据。
 
+## 报告中的硬约束（必须遵守）
+
+### 品牌名 / 公司名来源
+
+生成带品牌名、方案、邮件、广告文案的报告时，**严禁自行生成品牌名（包括中文译名、拼音、意译）**。品牌名必须来自以下来源之一，按优先级：
+
+1. 用户在对话里明确给出的品牌名
+2. `list-accounts --json` 响应中的 `mag.advertiserName` 字段
+3. 用户仅提供网址时：**使用域名本身作为占位**（例如 `hy-steelpipe.com`），并在交付物里用 `[待确认品牌名]` 标注，让用户补充
+
+反面案例（**绝对禁止**）：
+- `https://hy-steelpipe.com/` → 自行臆造成"华悦钢管 / 海悦钢管"
+- `list-accounts` 拿到 `advertiserName: "ABC Steel"`，报告里写成"ABC 钢铁公司"
+
+### 金额单位
+
+- 所有金额字段必须使用命令返回的 `*Display` 字段或已转换后的主币种数值（例如 `budgetDisplay`、主币种消耗），**不得**将 `budget` / `maxCPCAmount` 等 `×100` 分单位直接当作金额展示（否则会出现"¥50 日预算被写成 ¥5000"的错误）。
+- 金额保留 2 位小数并带货币代码（示例：`¥50.00 CNY` / `$200.00 USD`）。
+- 货币代码从响应 `currencyCode` 字段读取；不要混用多账户货币——必要时**分币种分表**。
+
+### 预算建议
+
+- 方案里给出的"日预算 / 月预算 / 预估消耗"必须基于：当前账户实际预算（`budgetDisplay`）、历史日均消耗、用户给的预算上限。
+- 不要拍脑袋给出明显不符合账户规模的预算（例如账户日均 ¥50 的情况下建议 ¥5000/日）。若数据不足以判断，请**在报告里写明"建议区间需用户确认"**，而不是直接给一个高风险数字。
+
 ## Google 账户分析数据接口
 
 ### 指标字段对照

package/dist/skill/references/finance.md

@@ -7,7 +7,7 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
+对应页面：`https://www.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 - **PI**：形式发票（境外美金账户，英文信息）
@@ -130,10 +130,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
-- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
-- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
-- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
+- 现金充值（单笔）：https://www.siluzan.com/recharge/pay
+- 现金充值（批量）：https://www.siluzan.com/recharge/pay_batch
+- 月结充值：        https://www.siluzan.com/recharge/accountBillingQuota
+- 丝路赞钱包：      https://www.siluzan.com/recharge/siluzanWallet
 ```
 
 ---

package/dist/skill/references/reporting.md

@@ -212,8 +212,8 @@ siluzan-tso report list -m Google --json
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www-ci.siluzan.com
+# webUrl: https://www.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

package/dist/skill/references/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli@beta
+npm install -g siluzan-tso-cli
 ```
 
 ---
@@ -47,7 +47,7 @@ siluzan-tso config set --api-key <Key>     # 或通过 config set 直接写入
 siluzan-tso config set --token <Token>     # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ### 通过环境变量传入凭据（CI/CD 推荐）
 
@@ -80,9 +80,9 @@ siluzan-tso config show
 输出示例：
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api-ci.siluzan.com
-  googleApiUrl : https://googleapi-ci.mysiluzan.com
-  webUrl       : https://www-ci.siluzan.com
+  apiBaseUrl   : https://tso-api.siluzan.com
+  googleApiUrl : https://googleapi.mysiluzan.com
+  webUrl       : https://www.siluzan.com
   apiKey       : abcd****1234
 ```
 

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

@@ -6,7 +6,7 @@
 
 用 `siluzan-tso config show` 读取 **`webUrl`**，再拼接路径：
 
-首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
 
 > 若用户已登录 TSO，也可从左侧菜单进入「首页」。
 

package/dist/skill/scripts/install.ps1

@@ -10,8 +10,8 @@ $ErrorActionPreference = 'Stop'
 $PKG_NAME    = 'siluzan-tso-cli'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
-$WEB_BASE    = 'https://www-ci.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
+$WEB_BASE    = 'https://www.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN = 18

package/dist/skill/scripts/install.sh

@@ -10,8 +10,8 @@ set -euo pipefail
 readonly PKG_NAME="siluzan-tso-cli"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
-readonly WEB_BASE="https://www-ci.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
+readonly WEB_BASE="https://www.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.11-beta.7",
+  "version": "1.1.12",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "type": "module",
   "bin": {