siluzan-tso-cli 1.1.40-beta.4 → 1.1.40-beta.6

package/README.md

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

package/dist/index.js

@@ -2296,16 +2296,13 @@ function buildSiluzanClientIdentityHeaders() {
   const client = getSiluzanClientProduct();
   const runtime = resolveSiluzanClientRuntime();
   const version = getSiluzanSkillVersion();
-  const headers = {
+  return {
     "X-Siluzan-Client": client,
     "X-Siluzan-Runtime": runtime,
     "X-Siluzan-Skill-Version": version,
+    "X-Company-Source-Type": SILUZAN_AGENT_COMPANY_SOURCE_TYPE,
     "User-Agent": `${client}/${version}`
   };
-  if (runtime === "siluzan_agent") {
-    headers["X-Company-Source-Type"] = SILUZAN_AGENT_COMPANY_SOURCE_TYPE;
-  }
-  return headers;
 }
 function isPerfEnabled() {
   const v = process.env.SILUZAN_HTTP_PERF;
@@ -2332,6 +2329,19 @@ function rawRequest(url, options) {
       ...buildSiluzanClientIdentityHeaders(),
       ...options.headers
     };
+    if (process.env.SILUZAN_DEBUG_HEADERS === "1" || process.env.SILUZAN_DEBUG_HEADERS === "true") {
+      try {
+        process.stderr.write(
+          `[SILUZAN_DEBUG_HEADERS] ${method} ${url}
+  X-Company-Source-Type=${headers["X-Company-Source-Type"] ?? "(missing)"}
+  X-Siluzan-Runtime=${headers["X-Siluzan-Runtime"] ?? "(missing)"}
+  X-Siluzan-Client=${headers["X-Siluzan-Client"] ?? "(missing)"}
+  X-Siluzan-Skill-Version=${headers["X-Siluzan-Skill-Version"] ?? "(missing)"}
+`
+        );
+      } catch {
+      }
+    }
     const reqOpts = {
       hostname: parsed.hostname,
       port: parsed.port || (isHttps ? 443 : 80),
@@ -4474,56 +4484,6 @@ var init_currency_display = __esm({
   }
 });
 
-// src/utils/media-customer-id.ts
-function stripMediaCustomerIdDecorators(raw) {
-  return raw.trim().replace(/[\s-]+/g, "");
-}
-function looksLikeNumericMediaCustomerId(raw) {
-  return /^\d+$/.test(stripMediaCustomerIdDecorators(raw));
-}
-function normalizeNumericMediaCustomerId(raw) {
-  if (!looksLikeNumericMediaCustomerId(raw)) return null;
-  return stripMediaCustomerIdDecorators(raw);
-}
-function looksLikeEntityIdUuid(raw) {
-  return ENTITY_ID_UUID_RE.test(raw.trim());
-}
-function warnIfAccountIdsLookLikeEntityId(ids, command) {
-  const bad = ids.map((id) => id.trim()).filter((id) => id && looksLikeEntityIdUuid(id));
-  if (bad.length === 0) return;
-  console.error(
-    `
-\u26A0\uFE0F  ${command} \u7684 -a/--accounts \u6536\u5230\u7591\u4F3C entityId/UUID\uFF1A${bad.join(", ")}
-   \u672C\u547D\u4EE4\u9700\u8981 mediaCustomerId\uFF08list-accounts \u7684 ma.mediaCustomerId\uFF1BYandex \u5F62\u5982 porg-\u2026\uFF09\u3002
-   \u8BF7\u5148 list-accounts -m <\u5A92\u4F53> -k <\u5A92\u4F53\u8D26\u6237\u53F7> \u6838\u5BF9\u540E\u518D\u91CD\u8BD5\uFF1B\u52FF\u636E\u6B64\u76F4\u63A5 reauth\u3002
-`
-  );
-}
-function parseNumericMediaCustomerIds(input) {
-  if (!input || !input.trim()) return [];
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const raw of input.split(",")) {
-    const piece = raw.trim();
-    if (!piece) continue;
-    const id = normalizeNumericMediaCustomerId(piece);
-    if (!id) {
-      throw new Error(`mediaCustomerId \u5FC5\u987B\u4E3A\u7EAF\u6570\u5B57\uFF08\u53EF\u542B\u8FDE\u5B57\u7B26\uFF09\uFF1A${piece}`);
-    }
-    if (seen.has(id)) continue;
-    seen.add(id);
-    out.push(id);
-  }
-  return out;
-}
-var ENTITY_ID_UUID_RE;
-var init_media_customer_id = __esm({
-  "src/utils/media-customer-id.ts"() {
-    "use strict";
-    ENTITY_ID_UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-  }
-});
-
 // src/utils/balance.ts
 function fmt(d) {
   return d.toISOString().slice(0, 10);
@@ -4830,6 +4790,56 @@ var init_balance = __esm({
   }
 });
 
+// src/utils/media-customer-id.ts
+function stripMediaCustomerIdDecorators(raw) {
+  return raw.trim().replace(/[\s-]+/g, "");
+}
+function looksLikeNumericMediaCustomerId(raw) {
+  return /^\d+$/.test(stripMediaCustomerIdDecorators(raw));
+}
+function normalizeNumericMediaCustomerId(raw) {
+  if (!looksLikeNumericMediaCustomerId(raw)) return null;
+  return stripMediaCustomerIdDecorators(raw);
+}
+function looksLikeEntityIdUuid(raw) {
+  return ENTITY_ID_UUID_RE.test(raw.trim());
+}
+function warnIfAccountIdsLookLikeEntityId(ids, command) {
+  const bad = ids.map((id) => id.trim()).filter((id) => id && looksLikeEntityIdUuid(id));
+  if (bad.length === 0) return;
+  console.error(
+    `
+\u26A0\uFE0F  ${command} \u7684 -a/--accounts \u6536\u5230\u7591\u4F3C entityId/UUID\uFF1A${bad.join(", ")}
+   \u672C\u547D\u4EE4\u9700\u8981 mediaCustomerId\uFF08list-accounts \u7684 ma.mediaCustomerId\uFF1BYandex \u5F62\u5982 porg-\u2026\uFF09\u3002
+   \u8BF7\u5148 list-accounts -m <\u5A92\u4F53> -k <\u5A92\u4F53\u8D26\u6237\u53F7> \u6838\u5BF9\u540E\u518D\u91CD\u8BD5\uFF1B\u52FF\u636E\u6B64\u76F4\u63A5 reauth\u3002
+`
+  );
+}
+function parseNumericMediaCustomerIds(input) {
+  if (!input || !input.trim()) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of input.split(",")) {
+    const piece = raw.trim();
+    if (!piece) continue;
+    const id = normalizeNumericMediaCustomerId(piece);
+    if (!id) {
+      throw new Error(`mediaCustomerId \u5FC5\u987B\u4E3A\u7EAF\u6570\u5B57\uFF08\u53EF\u542B\u8FDE\u5B57\u7B26\uFF09\uFF1A${piece}`);
+    }
+    if (seen.has(id)) continue;
+    seen.add(id);
+    out.push(id);
+  }
+  return out;
+}
+var ENTITY_ID_UUID_RE;
+var init_media_customer_id = __esm({
+  "src/utils/media-customer-id.ts"() {
+    "use strict";
+    ENTITY_ID_UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  }
+});
+
 // src/utils/media-account-batch.ts
 function mediaAccountDataBatchSize(media) {
   switch (media) {
@@ -5508,12 +5518,14 @@ function resolveDailyMetricsQueryTimes(startDate, endDate, now = /* @__PURE__ */
   const endInstant = endOfDay.getTime() > now.getTime() ? formatChinaOffsetDateTime(now) : formatChinaOffsetDateTime(endOfDay);
   return { startInstant, endInstant };
 }
-var CHINA_OFFSET_MS, resolveChinaQueryTimes;
+function resolveChinaQueryTimes(startDate, endDate, _now = /* @__PURE__ */ new Date()) {
+  return { startInstant: startDate, endInstant: endDate };
+}
+var CHINA_OFFSET_MS;
 var init_daily_metrics_range = __esm({
   "src/commands/google-analysis/daily-metrics-range.ts"() {
     "use strict";
     CHINA_OFFSET_MS = 8 * 36e5;
-    resolveChinaQueryTimes = resolveDailyMetricsQueryTimes;
   }
 });
 
@@ -6025,7 +6037,7 @@ var init_sections = __esm({
         name: "daily-metrics",
         description: "\u6309\u65E5\u6307\u6807\uFF08\u4E3B\u5E73\u53F0 /report/media-account/google/account-daily-reports\uFF0C\u542B\u641C\u7D22\u4EFD\u989D\u7B49\uFF09",
         dateMode: "range",
-        /** 仅用于 manifest endpointHint；实际请求走 fetchSectionPayload 专用分支（apiBaseUrl + 东八区起止时刻） */
+        /** 仅用于 manifest endpointHint；实际请求走 fetchSectionPayload 专用分支（apiBaseUrl + YYYY-MM-DD） */
         path: () => "/report/media-account/google/account-daily-reports"
       },
       {
@@ -102120,7 +102132,7 @@ async function fetchSectionPayload(def, opts, config, id, http2) {
   }
   if (def.name === "daily-metrics") {
     const { startDate, endDate } = resolveDateRange(opts.start, opts.end);
-    const { startInstant, endInstant } = resolveDailyMetricsQueryTimes(startDate, endDate);
+    const { startInstant, endInstant } = resolveChinaQueryTimes(startDate, endDate);
     const params = new URLSearchParams({
       mediaCustomerIds: id,
       startDate: startInstant,
@@ -104078,10 +104090,10 @@ function registerRunCommand() {
     "\u7ED3\u679C\u843D\u76D8\u76EE\u5F55\uFF1B\u6BCF\u7EF4\u5EA6\u4E00\u4E2A <section>-<accountId>.json\uFF0C\u4E0E manifest-<accountId>.json \u540C\u7EA7"
   ).option("-t, --token <token>", "Auth Token").option(
     "--start <date>",
-    "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u6309 UTC+8 \u65E5\u5386\u65E5\uFF1Brange \u7C7B\u7EF4\u5EA6\u4F1A\u8F6C\u6210 \u2026T00:00:00+08:00 \u518D\u8BF7\u6C42\uFF1B\u7701\u7565=\u8FD1 7 \u5929\u622A\u81F3\u6628\u5929\uFF1B\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\uFF09"
+    "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08google-analysis \u53EA\u4F20\u5E74\u6708\u65E5\uFF1B\u7701\u7565=\u8FD1 7 \u5929\u622A\u81F3\u6628\u5929\uFF0C\u9ED8\u8BA4\u6309 UTC+8 \u65E5\u5386\uFF1B\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\uFF09"
   ).option(
     "--end <date>",
-    "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u6309 UTC+8\uFF1B\u8F6C\u6210 \u2026T23:59:59+08:00\uFF0C\u542B\u4ECA\u5929\u65F6\u622A\u5230\u5F53\u524D\u65F6\u523B\uFF09"
+    "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u53EA\u4F20\u5E74\u6708\u65E5\uFF1B\u7701\u7565=\u6628\u5929\uFF09"
   ).option("--start-date <date>", "\u540C --start\uFF08\u6587\u6863/Playbook \u517C\u5BB9\u522B\u540D\uFF09").option("--end-date <date>", "\u540C --end\uFF08\u6587\u6863/Playbook \u517C\u5BB9\u522B\u540D\uFF09").option(
     "--sections <list>",
     "\u4EC5\u6267\u884C\u6307\u5B9A\u7EF4\u5EA6\uFF08\u9017\u53F7\u5206\u9694\uFF09\uFF0C\u5982 overview,keywords,ads\uFF1B\u7701\u7565=\u5168\u90E8 25 \u4E2A"
@@ -105703,6 +105715,12 @@ var VALID_MEDIA_TYPES = [
   "BingV2",
   "Kwai"
 ];
+function applyListAccountsSearchKeyword(params, keyword) {
+  const kw = (keyword ?? "").trim();
+  if (kw) {
+    params.set("keyword", kw);
+  }
+}
 var PLATFORM_CONFIG = {
   Google: {
     path: "/query/media-account/",
@@ -106161,7 +106179,6 @@ function wrapListJson(params) {
 }
 
 // src/commands/list-accounts/main.ts
-init_media_customer_id();
 async function runListAccounts(opts) {
   let config = loadConfig(opts.token);
   if (opts.refreshDp) {
@@ -106191,14 +106208,7 @@ async function runListAccounts(opts) {
     if (platformCfg.responseType === "array" && opts.status && opts.status !== "all") {
       params.set("status", opts.status);
     }
-    if (opts.keyword) {
-      const numericId = normalizeNumericMediaCustomerId(opts.keyword);
-      if (numericId) {
-        params.set(platformCfg.idSearchParam, numericId);
-      } else {
-        params.set("mediaCustomerName", opts.keyword.trim());
-      }
-    }
+    applyListAccountsSearchKeyword(params, opts.keyword);
     const url = `${config.apiBaseUrl}${platformCfg.path}?${params}`;
     if (platformCfg.responseType === "array") {
       try {
@@ -106232,9 +106242,7 @@ async function runListAccounts(opts) {
     }
   } else {
     const params = new URLSearchParams();
-    if (opts.keyword) {
-      params.set("keyword", normalizeNumericMediaCustomerId(opts.keyword) ?? opts.keyword.trim());
-    }
+    applyListAccountsSearchKeyword(params, opts.keyword);
     if (opts.status && opts.status !== "all") params.set("status", opts.status);
     params.set("pageNo", String(page));
     params.set("pageSize", String(pageSize));

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.40-beta.4",
-  "publishedAt": 1785321077403
+  "version": "1.1.40-beta.6",
+  "publishedAt": 1785491315308
 }

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

@@ -152,7 +152,7 @@ siluzan-tso accounts-digest -m Google --start 2026-07-20 --end 2026-07-20 \
 ## stats — 查询投放消耗数据
 
 > **数据时效性**：
-> - **Google**：走 `account-spend-overview`；`--start` / `--end` 日历日按 **UTC+8** 转为 `YYYY-MM-DDTHH:mm:ss+08:00` 再请求（起 00:00:00、止 23:59:59，含今天时 end 截到当前时刻）。勿传裸 `YYYY-MM-DD`（易被当成 UTC 切窗）。
+> - **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）。
 > - 完整时效性表见 `references/analytics/account-analytics.md` 顶部。

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

@@ -17,7 +17,7 @@ siluzan-tso list-accounts [选项]
 | 选项                    | 说明                                                                             |
 | ----------------------- | -------------------------------------------------------------------------------- | ---------------------- |
 | `-m, --media <type>`    | 媒体类型（留空查全部）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai` |
-| `-k, --keyword <text>`  | 按账户名称或 ID 搜索                                                             |
+| `-k, --keyword <text>`  | 统一模糊搜索：账户名称 **或** ID（含 Google CID 带横杠）；透传 Sammamish `keyword` |
 | `-s, --status <status>` | 账户状态：`normal \| invalid \| all`（默认 all）                                 |
 | `-p, --page <n>`        | 页码（默认 1）                                                                   |
 | `--page-size <n>`       | 每页数量（默认 20）                                                              |

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

@@ -23,9 +23,9 @@
 
 | 命令 / 接口                                                                                                                                                                           | 时效性                                                                                                                                                              | 能否查"今天"                      | 典型用途                                               |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------ |
-| `google-analysis --sections overview`（Google 网关 `OverviewSectionData`）                                                                                                            | **实时**；请求起止按 **UTC+8** 墙钟                                                                                                                                 | ✅ 可查当天                       | 当天/今日消耗、当天高消耗账号排行                      |
+| `google-analysis --sections overview`（Google 网关 `OverviewSectionData`）                                                                                                            | **实时**；请求起止为 **YYYY-MM-DD**（不附加时区）                                                                                                                   | ✅ 可查当天                       | 当天/今日消耗、当天高消耗账号排行                      |
 | `google-analysis --sections campaign-types`（`types-summary`）                                                                                                                        | **实时**                                                                                                                                                            | ✅ 可查当天                       | 当天系列类型分布                                       |
-| `google-analysis` 其他 range 维度（`campaigns` / `keywords` / `devices` / `geographic` / `daily-metrics` / …）                                                                         | 实时（受 Google Ads API 同步延迟影响）；**一律东八区起止时刻**（与 `stats` 同）                                                                                      | 可查当天，但当天可能尚未结算      | 周期分析、报告                                         |
+| `google-analysis` 其他 range 维度（`campaigns` / `keywords` / `devices` / `geographic` / `daily-metrics` / …）                                                                         | 实时（受 Google Ads API 同步延迟影响）；**一律 YYYY-MM-DD**（不附加时区；与 `stats` 的 UTC+8 不同）                                                                  | 可查当天，但当天可能尚未结算      | 周期分析、报告                                         |
 | `stats -m Google` / `balance-scan -m Google` / `accounts-digest -m Google` / `list-accounts -m Google` 合并消耗（TSO `account-spend-overview`，2026-05 起）                           | **后端自动分流**：窗口完全在历史 → `database`；含今天 → `googleCombined`。**`stats` 请求起止按 UTC+8 墙钟**（`…T00:00:00+08:00` ~ `…T23:59:59+08:00`）                | ✅ 可查当天（含今天时切实时聚合） | 历史回溯、巡检、周报 KPI、余额续航估算                 |
 | `stats` / `balance-scan` / `accounts-digest` / `list-accounts` 的 **TikTok / Yandex / BingV2 / Kwai / MetaAd** 合并消耗（TSO `accountsoverview`；MetaAd OAuth 户走 `FacebookAds` 段） | **每日同步昨天**                                                                                                                                                    | ❌ 查今天会全为 0                 | 历史回溯、巡检、余额续航估算（口径为"截至昨天"）       |
 | `balance`（`GetMediaAccountInfo`）                                                                                                                                                    | 实时                                                                                                                                                                | —                                 | 仅当前余额，不反映消耗                                 |
@@ -102,7 +102,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `--json-out <dir>`          | 必填；每维一个 `<section>-<accountId>.json` + `manifest-<accountId>.json`                                  |
 | `--sections <list>`         | 仅执行指定维度（逗号分隔）；省略=全部 25 个                                                                |
 | `--exclude <list>`          | 排除指定维度；与 `--sections` 可叠加                                                                       |
-| `--start` / `--end`         | 统计区间（YYYY-MM-DD，按 **UTC+8** 日历日）；CLI 转成 `…T00:00:00+08:00` ~ `…T23:59:59+08:00` 再请求；省略=近 7 天截至昨天；`final-urls`/`campaign-types` 自动忽略 |
+| `--start` / `--end`         | 统计区间（YYYY-MM-DD，**只传年月日**；默认区间按 UTC+8 日历）。与 `stats -m Google`（会加成 `+08:00`）不同；省略=近 7 天截至昨天；`final-urls`/`campaign-types` 自动忽略 |
 | `--concurrency <n>`         | 并发数，默认 5，上限 16                                                                                    |
 | `--limit <n>`               | 透传给 `keywords`/`search-terms`（默认 **0**=不封顶；`orderByCost=true`）                                  |
 | `--level <lvl>`             | 透传给 `extensions`（Account/Campaign/Ad Group）                                                           |

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.40-beta.4'
+$PKG_VERSION = '1.1.40-beta.6'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.40-beta.4"
+readonly PKG_VERSION="1.1.40-beta.6"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

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