siluzan-tso-cli 1.1.43-beta.2 → 1.1.43-beta.3

package/README.md

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

package/dist/index.js

@@ -4816,6 +4816,19 @@ function normalizeNumericMediaCustomerId(raw) {
   if (!looksLikeNumericMediaCustomerId(raw)) return null;
   return stripMediaCustomerIdDecorators(raw);
 }
+function requireNumericMediaCustomerId(raw, label = "-a, --account") {
+  const trimmed = raw?.toString().trim() ?? "";
+  if (!trimmed) {
+    throw new Error(`\u8BF7\u6307\u5B9A\u5A92\u4F53\u8D26\u6237 ID\uFF08${label}\uFF09`);
+  }
+  const id = normalizeNumericMediaCustomerId(trimmed);
+  if (!id) {
+    throw new Error(
+      `\u5A92\u4F53\u8D26\u6237 ID \u5FC5\u987B\u4E3A\u7EAF\u6570\u5B57\uFF08Google CID \u53EF\u542B\u8FDE\u5B57\u7B26\uFF0C\u5982 123-456-7890\uFF1B\u52FF\u4F20 entityId/UUID\uFF09\uFF1A${trimmed}`
+    );
+  }
+  return id;
+}
 function looksLikeEntityIdUuid(raw) {
   return ENTITY_ID_UUID_RE.test(raw.trim());
 }
@@ -107265,6 +107278,20 @@ init_list_fetch();
 
 // src/commands/ad/_shared.ts
 init_auth();
+init_media_customer_id();
+function resolveAdAccountId(account, label = "-a, --account") {
+  try {
+    return requireNumericMediaCustomerId(account, label);
+  } catch (e) {
+    console.error(`
+\u274C ${e instanceof Error ? e.message : String(e)}
+`);
+    process.exit(1);
+  }
+}
+function withResolvedAdAccount(opts) {
+  return { ...opts, account: resolveAdAccountId(opts.account) };
+}
 async function findItemInList(listUrl, config, id, verbose) {
   const res = await apiFetch2(listUrl, config, {}, verbose);
   const item = (res.data ?? []).find((x) => x["id"] === id);
@@ -111394,6 +111421,9 @@ init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
 
+// src/commands/ad/campaign-create-validate.ts
+init_media_customer_id();
+
 // src/commands/ad/campaign-length-violations.ts
 function pushLengthViolation(violations, item) {
   violations.push({ ...item, excess: item.actual - item.limit });
@@ -111791,6 +111821,7 @@ function keywordRowToYuan(item) {
   return { ...rest, maxCPCYuan: toDisplayMoney(rawMaxCpc) };
 }
 async function runAdKeywords(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -111894,6 +111925,7 @@ ${label}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672C
   console.log();
 }
 async function runAdKeywordCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   let keywords;
@@ -111946,6 +111978,7 @@ async function runAdKeywordCreate(opts) {
 `);
 }
 async function runAdNegativeKeywordCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   let keywords;
@@ -111985,6 +112018,7 @@ async function runAdNegativeKeywordCreate(opts) {
 `);
 }
 async function runAdKeywordDelete(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
   const body = [{ adGroupId: opts.adgroupId, id: opts.id }];
@@ -112002,6 +112036,7 @@ async function runAdKeywordDelete(opts) {
 `);
 }
 async function runAdKeywordEdit(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
   const hasChange = opts.text !== void 0 || opts.matchType !== void 0 || opts.maxCpc !== void 0 || opts.finalUrl !== void 0 || opts.status !== void 0;
@@ -112067,6 +112102,7 @@ async function runAdKeywordEdit(opts) {
 `);
 }
 async function runAdKeywordStatus(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -112102,6 +112138,7 @@ async function runAdKeywordStatus(opts) {
 `);
 }
 async function runAdNegativeKeywordEdit(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const dateParams = new URLSearchParams();
@@ -112143,6 +112180,7 @@ async function runAdNegativeKeywordEdit(opts) {
 `);
 }
 async function runAdNegativeKeywordDelete(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const dateParams = new URLSearchParams();
@@ -112985,9 +113023,13 @@ function validateCampaignCreateConfigCore(cfg) {
       "customerName \u4E3A\u7A7A\uFF1A\u63D0\u4EA4 campaign-create \u65F6\u5C06\u6309 account \u4ECE list-accounts \u81EA\u52A8\u586B\u5145 mediaCustomerName"
     );
   }
-  const accountNum = Number(cfg.account);
-  if (!Number.isFinite(accountNum) || accountNum <= 0) {
-    pushErr2(errors, "account \u5FC5\u987B\u662F\u53EF\u89E3\u6790\u4E3A\u6B63\u6570\u7684\u5A92\u4F53\u8D26\u6237 ID\uFF08\u63D0\u4EA4\u65F6 customerId \u4E3A number\uFF09");
+  const normalizedAccount = normalizeNumericMediaCustomerId(String(cfg.account ?? "").trim());
+  const accountNum = normalizedAccount ? Number(normalizedAccount) : NaN;
+  if (!normalizedAccount || !Number.isFinite(accountNum) || accountNum <= 0) {
+    pushErr2(
+      errors,
+      "account \u5FC5\u987B\u662F\u53EF\u89E3\u6790\u4E3A\u6B63\u6570\u7684\u5A92\u4F53\u8D26\u6237 ID\uFF08\u53EF\u542B\u8FDE\u5B57\u7B26\uFF1B\u63D0\u4EA4\u65F6 customerId \u4E3A number\uFF09"
+    );
   }
   if (!cfg.campaign || typeof cfg.campaign !== "object" || Array.isArray(cfg.campaign)) {
     pushErr2(errors, "campaign \u5BF9\u8C61\u4E0D\u80FD\u4E3A\u7A7A\uFF08\u540E\u7AEF\uFF1Acampaign is null\uFF09");
@@ -113353,6 +113395,7 @@ function parseCampaignTimeMs(v) {
   return Number.isFinite(t) ? t : null;
 }
 async function runAdCampaigns(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -113435,6 +113478,7 @@ async function runAdCampaigns(opts) {
   console.log();
 }
 async function runAdCampaignStatus(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const detailUrl = `${googleApiUrl}/campaignmanagement/campaign/${opts.account}/${opts.id}`;
@@ -113469,6 +113513,7 @@ async function runAdCampaignStatus(opts) {
 `);
 }
 async function runAdCampaignDelete(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const detailUrl = `${googleApiUrl}/campaignmanagement/campaign/${opts.account}/${opts.id}`;
@@ -113506,6 +113551,7 @@ async function runAdCampaignDelete(opts) {
 }
 async function runAdCampaignCreate(opts) {
   const cfg = loadCampaignCreateConfig(opts.configFile);
+  cfg.account = resolveAdAccountId(cfg.account, "account");
   const { errors, warnings } = runCampaignCreateValidation(cfg);
   if (warnings.length > 0) {
     console.warn("\n\u26A0\uFE0F  \u6295\u653E\u914D\u7F6E\u8B66\u544A\uFF08\u4E0D\u963B\u65AD\u63D0\u4EA4\uFF0C\u4F46\u5EFA\u8BAE\u4FEE\u6B63\uFF09\uFF1A");
@@ -113712,6 +113758,7 @@ function validateCampaignEditBidding(opts) {
   }
 }
 async function runAdCampaignEdit(opts) {
+  opts = withResolvedAdAccount(opts);
   validateCampaignEditBidding(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
@@ -113781,6 +113828,7 @@ init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
 async function runAdGroups(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -113872,6 +113920,7 @@ function adGroupRowToYuan(item) {
   };
 }
 async function runAdGroupCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const body = {
@@ -113923,6 +113972,7 @@ async function runAdGroupCreate(opts) {
   }
 }
 async function runAdGroupStatus(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
@@ -113950,6 +114000,7 @@ async function runAdGroupStatus(opts) {
 `);
 }
 async function runAdGroupDelete(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
@@ -113976,6 +114027,7 @@ async function runAdGroupDelete(opts) {
 `);
 }
 async function runAdGroupRename(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
@@ -114003,6 +114055,7 @@ async function runAdGroupRename(opts) {
 `);
 }
 async function runAdGroupEdit(opts) {
+  opts = withResolvedAdAccount(opts);
   const hasName = opts.name !== void 0 && opts.name.trim() !== "";
   const hasMax = opts.maxCPCAmount !== void 0;
   const hasTcpa = opts.targetCpaAmount !== void 0;
@@ -114125,6 +114178,7 @@ function formatRsaCliValidationError(errors) {
 
 // src/commands/ad/ad-creative.ts
 async function runAdList(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -114201,6 +114255,7 @@ async function runAdList(opts) {
   console.log();
 }
 async function runAdCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const rsaErrors = validateRsaCliCopy({
@@ -114267,6 +114322,7 @@ async function runAdCreate(opts) {
   }
 }
 async function runAdStatus(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -114297,6 +114353,7 @@ async function runAdStatus(opts) {
 `);
 }
 async function runAdDelete(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -114326,6 +114383,7 @@ async function runAdDelete(opts) {
 `);
 }
 async function runAdEdit(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
   const hasTextOrUrl = opts.headlines || opts.descriptions || opts.finalUrl !== void 0 || opts.path1 !== void 0 || opts.path2 !== void 0;
@@ -114629,6 +114687,7 @@ function buildBusinessMessageBodyForCampaign(accountId, campaignId, bm) {
 
 // src/commands/ad/extension.ts
 async function runAdExtensionList(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const url = `${googleApiUrl}/extensionmanagement/v2/list/${opts.account}`;
@@ -114705,6 +114764,7 @@ async function runAdExtensionList(opts) {
   console.log();
 }
 async function runAdExtensionCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const body = {
@@ -114782,6 +114842,7 @@ async function runAdExtensionCreate(opts) {
   }
 }
 async function runAdExtensionDelete(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const listUrl = `${googleApiUrl}/extensionmanagement/v2/list/${opts.account}`;
@@ -114883,6 +114944,7 @@ async function runAdExtensionSnippetHeaders(opts) {
   console.log();
 }
 async function runAdExtensionLeadFormCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   let cfg;
@@ -114941,6 +115003,7 @@ async function runAdExtensionLeadFormCreate(opts) {
   );
 }
 async function runAdExtensionWhatsappCreate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   if (!opts.configFile) {
@@ -115003,6 +115066,7 @@ function detectExtensionUpdateKind(raw) {
   process.exit(1);
 }
 async function runAdExtensionUpdate(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   let raw;
@@ -115077,6 +115141,7 @@ init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
 async function runAdSearchTerms(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const params = new URLSearchParams();
@@ -115205,6 +115270,7 @@ function resolveCriterionId(rows, opts) {
   return String(match.id);
 }
 async function runAdDeviceBidList(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const level = opts.level ?? "campaign";
@@ -115301,6 +115367,7 @@ async function runAdDeviceBidList(opts) {
   console.log();
 }
 async function runAdDeviceBidSet(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const level = opts.level ?? "campaign";
@@ -115431,6 +115498,7 @@ function pickGeoResolveCandidate(query, items2) {
   return items2[0] ?? null;
 }
 async function runAdGeoSearch(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   let items2;
@@ -115503,6 +115571,7 @@ function parseGeoResolveQueries(opts) {
   return unique;
 }
 async function runAdGeoResolve(opts) {
+  opts = withResolvedAdAccount(opts);
   let queries;
   try {
     queries = parseGeoResolveQueries(opts);
@@ -115614,6 +115683,7 @@ async function runAdGeoResolve(opts) {
   }
 }
 async function runAdGeoList(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   let url;
@@ -115677,6 +115747,7 @@ async function runAdGeoList(opts) {
   console.log();
 }
 async function runAdGeoAdd(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const body = {
@@ -115703,6 +115774,7 @@ async function runAdGeoAdd(opts) {
 `);
 }
 async function runAdGeoRemove(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   const body = { campaignId: opts.campaignId, id: opts.locationId };
@@ -115743,6 +115815,7 @@ function resolveGeoCriterionId(rows, opts) {
   return String(match["id"]);
 }
 async function runAdGeoSetBid(opts) {
+  opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
   if (opts.bidModifier < 0) {
@@ -116599,11 +116672,12 @@ async function runCampaignBatchDiff(opts) {
 `);
     process.exit(1);
   }
-  const accountId = pickString2(opts.account, cfg.account);
-  if (!accountId) {
+  const rawAccountId = pickString2(opts.account, cfg.account);
+  if (!rawAccountId) {
     console.error("\n\u274C \u7F3A\u5C11\u8D26\u6237 ID\uFF1A\u8BF7\u5728 JSON \u4E2D\u586B\u5199 account \u6216\u4F7F\u7528 -a\n");
     process.exit(1);
   }
+  const accountId = resolveAdAccountId(rawAccountId, "account / -a");
   cfg.account = accountId;
   const config = loadConfig(opts.token);
   let campaignId = pickString2(opts.campaignId);
@@ -118624,14 +118698,7 @@ async function emitPmaxResult(opts, section, commandLabel, payload, idSuffix) {
   });
 }
 function requireAccountId(account, label = "-a, --account") {
-  const id = account?.toString().trim();
-  if (!id) {
-    console.error(`
-\u274C \u8BF7\u6307\u5B9A\u5A92\u4F53\u8D26\u6237 ID\uFF08${label}\uFF09
-`);
-    process.exit(1);
-  }
-  return id;
+  return resolveAdAccountId(account, label);
 }
 
 // src/commands/ad/pmax-video-upload.ts
@@ -118994,7 +119061,8 @@ async function runAdPmaxCreate(opts) {
   }
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
-  const accountId = cfg.account.toString().trim();
+  const accountId = resolveAdAccountId(cfg.account.toString(), "account");
+  cfg.account = accountId;
   let imageSlots;
   try {
     imageSlots = await resolvePmaxImageSlots(
@@ -122803,6 +122871,7 @@ async function runAccountMe(opts) {
 init_dist();
 init_auth();
 init_cli_json_snapshot();
+init_media_customer_id();
 
 // src/commands/account-manage/google-mcc.ts
 init_auth();
@@ -122978,18 +123047,14 @@ function hintGoogleOAuth(kind) {
   return "\u6267\u884C siluzan-tso account auth -m Google \u5B8C\u6210 OAuth \u7ED1\u5B9A\u3002";
 }
 function assertGoogleMediaCustomerId(raw) {
-  const id = raw.trim();
-  if (!id) {
-    console.error("\n\u274C --account \u4E0D\u80FD\u4E3A\u7A7A\u3002\n");
-    process.exit(1);
-  }
-  if (!/^\d+$/.test(id)) {
-    console.error(
-      "\n\u274C --account \u987B\u4E3A Google mediaCustomerId\uFF08\u7EAF\u6570\u5B57\uFF0C\u4E0E list-accounts -m Google \u4E00\u81F4\uFF09\u3002\n"
-    );
+  try {
+    return requireNumericMediaCustomerId(raw, "--account");
+  } catch (e) {
+    console.error(`
+\u274C ${e instanceof Error ? e.message : String(e)}
+`);
     process.exit(1);
   }
-  return id;
 }
 function parseCustomerAccessPermissionBody(text) {
   const trimmed = text.trim();

package/dist/skill/SKILL.md

@@ -38,7 +38,9 @@ siluzan-tso -h
 
 ## 即时规范
 
-- `entityId`（UUID）≠ `mediaCustomerId`（`list-accounts` 的 `ma.mediaCustomerId`：Google/TikTok/Bing 多为数字；**Yandex=`porg-…`**；Meta 常带 `act_`）。`stats`/`balance`/`accounts-digest` 的 `-a` **只传 mediaCustomerId**；空结果或 verbose 打出 403 时**先核验 ID**，禁止把 UUID/`entityId` 传给 `-a`，也**禁止**据此直接 `reauth`。
+- `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` 为准；细则见 `accounts-permissions.md`。
 - `list-accounts` 无余额/消耗；列全部用 `--page-size 999`。
 - 多户余额用 `balance-scan`（P2），多户消耗用 `accounts-digest`（P3）；禁止外层 for-loop 逐户拉数。
 - `stats` 的 `spend` = **区间合计**，不是日消耗。

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.43-beta.2",
-  "publishedAt": 1785994362313
+  "version": "1.1.43-beta.3",
+  "publishedAt": 1785999491310
 }

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

@@ -35,7 +35,9 @@ siluzan-tso account me --check-phone 15130150466 --json-out ./snap-me
 
 校验当前丝路赞凭据是否对指定 **Google** 广告账户有访问权限。应在拉数/诊断前调用，避免误用他户 ID。
 
-**前提（查授权是否过期时）**：须先确认该户 **套餐已激活**（`list-accounts` 的 `ma.scopeActivatedSources` 有未过期条目，或 Google 表格「套餐激活」= ✅ 已激活）。在已激活前提下，可用本命令检查授权是否可用：
+> **硬约束**：**禁止**凭 403、空结果或经验臆测「授权/OAuth 过期」。要对用户下「授权不可用 / 需重授权」结论前，**必须**先跑本命令（并满足下方套餐已激活前提），以 CLI 返回的 `status` 为准；**禁止**跳过本命令直接 `reauth` 或口头推断。
+
+**前提（查授权是否过期时）**：须先确认该户 **套餐已激活**（`list-accounts` 的 `ma.scopeActivatedSources` 有未过期条目，或 Google 表格「套餐激活」= ✅ 已激活）。在已激活前提下，**必须**用本命令检查授权是否可用：
 
 | 结果 | 含义（套餐已激活时） |
 | ---- | -------------------- |

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

@@ -19,6 +19,8 @@
 - `list-accounts` **不含**余额/消耗；列全部账户用 `--page-size 999`，禁止默认 20 再翻页。
 - `entityId`（UUID，分享/delink/账单/`reauth`）≠ `mediaCustomerId`（`balance`/`stats`/`accounts-digest`/`ad` 的 `-a`）。**Yandex 的 mediaCustomerId 形如 `porg-…`，不是 UUID。**
 - MetaAd OAuth 户的 `mediaCustomerId` **须带 `act_` 前缀**。
-- `stats`/`balance` 空结果 + verbose `HTTP 403`：先确认 `-a` 是否为 `ma.mediaCustomerId`；**禁止**把 `entityId` / tokenId 当 `-a`，也**禁止**未确认 `invalidOAuthToken=true` 就 `reauth`。
+- **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)）；非 Google 看 `list-accounts` 的 `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/core/agent-conventions.md

@@ -126,7 +126,8 @@
 
 - **账户状态 ≠ 系列状态**：`stats` / `balance` / `list-accounts` 的 `status` 只表示账户是否可用；系列状态必须来自 `ad campaigns`。
 - **数据时效性**：涉及「今天/当天/今日消耗」「实时消耗排行」前，必读 `references/analytics/account-analytics.md` 顶部「数据时效性」表。TikTok / Yandex / BingV2 / Kwai 是 `accountsoverview` 同步昨天数据，**不能查今天**。
-- **先查账户再操作**（拉数 / 改账户 / 报告 / **创建广告**）：`list-accounts -m [mediaType] -k [mediaCustomerId]`；用户给出的 `mediaCustomerId` 必须 `-k` 核验，无结果则告知用户并停止，**禁止**翻页 grep 自行换 ID（会导致报告错户）；拉数、脚本、报告文件名全链路用同一 ID（以 stdout `accountId` 为准）。**Google 额外建议**：`list-accounts` 命中后，若 `scopeActivatedSources` 显示套餐**已激活**，拉数前可用 `account check-access -a <mediaCustomerId>` 检查授权是否仍可用（`reauth_required` / `no_permission`）；**未激活套餐时勿用 check-access 判断授权过期**。`no_permission`（403）也可能表示账户不在当前丝路赞账号下。详见 `accounts-permissions.md`。
+- **先查账户再操作**（拉数 / 改账户 / 报告 / **创建广告**）：`list-accounts -m [mediaType] -k [mediaCustomerId]`；用户给出的 `mediaCustomerId` 必须 `-k` 核验，无结果则告知用户并停止，**禁止**翻页 grep 自行换 ID（会导致报告错户）；拉数、脚本、报告文件名全链路用同一 ID（以 stdout `accountId` 为准）。
+- **禁止臆测授权过期（硬约束）**：任何 403、空结果、「可能授权/OAuth 过期」话术，**禁止**凭感觉下结论或直接 `reauth`。Google：在 `list-accounts` 确认套餐**已激活**后，**必须**执行 `account check-access -a <mediaCustomerId>`，仅当结果为 `reauth_required`（或列表 `invalidOAuthToken=true` 与之交叉确认）才谈重授权；`no_permission` 也可能是账户不在当前丝路赞账号下。**未激活套餐时勿用 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 来。
@@ -276,7 +277,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（拉数空结果）**：`stats`/`balance`/`accounts-digest` 在 `--verbose` 下打出异常被吞的 `HTTP 403` 且无数据时：① **优先核验 `-a` 是否为 `ma.mediaCustomerId`**（勿传 `entityId`/UUID；Yandex 形如 `porg-…`）；② Google 再看套餐是否激活（`scopeActivatedSources`），未激活则说明需先激活，**禁止**非 CLI 绕过取数；③ **禁止**在 `invalidOAuthToken=false` 时把 403 当成 OAuth 过期并自行 `reauth`。
+- **403（拉数空结果 / ad 网关）**：① **优先核验 `-a` 是否为 `ma.mediaCustomerId`**（勿传 `entityId`/UUID；Google 注意连字符 CID；Yandex 形如 `porg-…`）；② Google 看套餐是否激活（`scopeActivatedSources`），未激活则说明需先激活，**禁止**非 CLI 绕过取数；③ **禁止臆测授权过期**：套餐已激活时**必须**跑 `account check-access -a <mediaCustomerId>`，以 `status` 为准后再决定是否 `reauth`；**禁止**仅凭 403 文案对用户说「授权过期」。
 - **500**：服务可能正在部署/升级，建议反馈 Siluzan 相关人员
 
 ---

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

@@ -26,12 +26,14 @@
 
 | 需要的 ID           | 获取命令                                                                |
 | ------------------- | ----------------------------------------------------------------------- |
-| `accountId`（`-a`） | `siluzan-tso list-accounts --json-out ./snap` → `mediaCustomerId`       |
+| `accountId`（`-a`） | `siluzan-tso list-accounts -m Google --json-out ./snap` → `mediaCustomerId`（**纯数字**；UI 的 `123-456-7890` 可原样传入，CLI 去连字符） |
 | 广告系列 `id`       | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `id`      |
 | 广告组 `id`、`name` | `siluzan-tso ad groups -a <accountId> --json-out ./snap` → `id`、`name` |
 | 广告 `id`           | `siluzan-tso ad list -a <accountId> --json-out ./snap` → `id`           |
 | 关键词 `id`         | `siluzan-tso ad keywords -a <accountId> --json-out ./snap` → `id`       |
 
+> **Google CID**：带连字符进网关曾导致 `HTTP 403：123-456-7890`；现 CLI 已归一化。仍失败时用纯数字重试；**禁止臆测授权过期**，须 `account check-access -a <mediaCustomerId>`（详见 [google-ads.md](google-ads.md) Gotchas / `accounts-permissions.md`）。
+
 ---
 
 ## ad campaigns — 广告系列管理

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

@@ -32,7 +32,7 @@
 
 | 需要的 ID           | 获取命令                                                                |
 | ------------------- | ----------------------------------------------------------------------- |
-| `accountId`（`-a`） | `siluzan-tso list-accounts --json-out ./snap` → `mediaCustomerId`       |
+| `accountId`（`-a`） / JSON `account` | `list-accounts -m Google` → `mediaCustomerId`（纯数字；UI 带连字符 CID 可传入，CLI 去横杠，见 [google-ads.md](google-ads.md) Gotchas） |
 | 广告系列 `id`       | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `id`      |
 | 广告组 `id`、`name` | `siluzan-tso ad groups -a <accountId> --json-out ./snap` → `id`、`name` |
 | 广告 `id`           | `siluzan-tso ad list -a <accountId> --json-out ./snap` → `id`           |

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

@@ -15,6 +15,10 @@
 
 ## Gotchas
 
+- **Google 客户 ID（CID）带连字符**：UI / 用户口述常为 `123-456-7890`，平台 `mediaCustomerId` 与 Google 网关路径需要 `1234567890`。`ad campaigns` / `ad groups` / `ad list` 等 `-a` 与 JSON 顶层 `account` **可带连字符**（CLI 自动去掉）。若错误为 `HTTP 403：123-456-7890`（回显带横杠），先换纯数字重试，**禁止**据此直接判断 OAuth 过期或 `reauth`。
+- **禁止臆测授权过期**：`ad *` / 拉数出现 403 或失败时，**禁止**对用户说「授权可能过期」。须核验 ID 后，在套餐已激活前提下执行 `account check-access -a <mediaCustomerId>`，仅当 `reauth_required`（或与 `invalidOAuthToken=true` 交叉确认）才走重授权。见 [`accounts-permissions.md`](../accounts/accounts-permissions.md)。
+- `-a` 必须是 `list-accounts -m Google` 的 `ma.mediaCustomerId`，**禁止**传 `entityId`（UUID）。
+
 ## 金额单位（全局重要）
 
 > **所有 CLI 金额参数均按「主币种金额」传入**（如 `1.5` = ¥1.50 / $1.50）；CLI 写入网关前对「分」字段 ×100（含 `ad keyword-edit --max-cpc` → `maxCPC`）。

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