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

package/README.md

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

package/dist/index.js

@@ -106072,6 +106072,55 @@ async function writeReportAnalysisSnapshot(params) {
 
 // src/commands/report/main.ts
 init_version();
+
+// src/commands/facebook-analysis/fetch.ts
+init_auth();
+function normalizeFacebookAccountId(raw) {
+  const t = raw.trim();
+  if (!t) {
+    console.error("\n\u274C --account \u4E0D\u80FD\u4E3A\u7A7A\u3002\n");
+    process.exit(1);
+  }
+  const digits = t.startsWith("act_") ? t.slice(4) : t;
+  if (!/^\d+$/.test(digits)) {
+    console.error(
+      "\n\u274C --account \u987B\u4E3A Facebook \u5E7F\u544A\u8D26\u6237 ID\uFF08\u6570\u5B57 mediaCustomerId\uFF0C\u6216 act_<\u6570\u5B57>\uFF0C\u4E0E list-accounts -m MetaAd \u4E00\u81F4\uFF09\u3002\n"
+    );
+    process.exit(1);
+  }
+  return { apiId: `act_${digits}`, manifestId: digits };
+}
+function resolveFacebookDateRange(start, end) {
+  if (start && end) return { startDate: start, endDate: end };
+  if (!start && !end) {
+    const endD = /* @__PURE__ */ new Date();
+    endD.setDate(endD.getDate() - 1);
+    const startD = new Date(endD);
+    startD.setDate(startD.getDate() - 6);
+    const fmt2 = (d) => d.toISOString().slice(0, 10);
+    return { startDate: fmt2(startD), endDate: fmt2(endD) };
+  }
+  console.error("\n\u274C --start \u4E0E --end \u987B\u540C\u65F6\u4F20\u5165\uFF0C\u6216\u540C\u65F6\u7701\u7565\u4EE5\u4F7F\u7528\u9ED8\u8BA4\u8FD1 7 \u5929\uFF08\u622A\u81F3\u6628\u5929\uFF09\u3002\n");
+  process.exit(1);
+}
+function facebookReportingUrl(config, apiId, segment, query) {
+  const q = query ? query.startsWith("?") ? query : `?${query}` : "";
+  return `${config.apiBaseUrl}/reporting/media-account/FacebookAds/${encodeURIComponent(apiId)}/${segment}${q}`;
+}
+async function fetchFacebookSectionPayload(def, opts, config, apiId) {
+  const { startDate, endDate } = resolveFacebookDateRange(opts.start, opts.end);
+  const params = new URLSearchParams({ startDate, endDate });
+  if (def.countryLimitOption && opts.limit !== void 0 && Number.isFinite(opts.limit)) {
+    params.set("limit", String(Math.max(1, Math.floor(opts.limit))));
+  }
+  const url = facebookReportingUrl(config, apiId, def.segment, params.toString());
+  return apiFetch2(url, config, {}, opts.verbose ?? false);
+}
+function endpointHintForFacebookSection(def, apiId) {
+  return `GET \u2026/FacebookAds/${apiId}/${def.segment}`;
+}
+
+// src/commands/report/main.ts
 async function runReportList(opts) {
   if (!VALID_MEDIA_TYPES5.includes(opts.media)) {
     console.error(`
@@ -106173,30 +106222,61 @@ function fmtNum2(n, digits = 2) {
   parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",");
   return parts.join(".");
 }
+function metaOverviewManifestId(raw) {
+  const t = raw.trim();
+  if (t.startsWith("act_")) return t.slice(4);
+  return t;
+}
+function buildMetaOverviewUrl(config, accountId, mediaAccountType, startDate, endDate) {
+  const { apiId, manifestId } = normalizeFacebookAccountId(accountId);
+  const params = new URLSearchParams({ startDate, endDate }).toString();
+  if (mediaAccountType === "FacebookAds") {
+    return facebookReportingUrl(config, apiId, "OverviewSectionData", params);
+  }
+  return `${config.apiBaseUrl}/reporting/media-account/MetaAd/${manifestId}/OverviewSectionData?${params}`;
+}
 async function runReportMetaOverview(opts) {
-  const id = opts.account.trim();
-  if (!/^\d+$/.test(id)) {
-    console.error("\n\u274C --account \u987B\u4E3A\u6570\u5B57 mediaCustomerId\uFF08\u4E0E list-accounts \u4E00\u81F4\uFF09\u3002\n");
+  const rawAccount = opts.account.trim();
+  let manifestId;
+  try {
+    manifestId = normalizeFacebookAccountId(rawAccount).manifestId;
+  } catch {
+    console.error(
+      "\n\u274C --account \u987B\u4E3A\u6570\u5B57 mediaCustomerId \u6216 act_<\u6570\u5B57>\uFF08\u4E0E list-accounts -m MetaAd \u4E00\u81F4\uFF09\u3002\n"
+    );
     process.exit(1);
   }
   const { startDate, endDate } = resolveMetaOverviewDateRange(opts.startDate, opts.endDate);
   const config = loadConfig(opts.token);
-  const params = new URLSearchParams({ startDate, endDate });
-  const url = `${config.apiBaseUrl}/reporting/media-account/MetaAd/${id}/OverviewSectionData?${params}`;
+  const accountDetail = await lookupMetaAccountForOverview(config, manifestId, opts.verbose);
+  const mediaAccountType = accountDetail?.mediaAccountType ?? "FacebookAds";
+  const url = buildMetaOverviewUrl(config, rawAccount, mediaAccountType, startDate, endDate);
   let data;
   try {
     data = await apiFetch2(url, config, {}, opts.verbose);
   } catch (err) {
-    console.error(`
-\u274C \u8BF7\u6C42\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("403")) {
+      console.error(
+        `
+\u274C \u8BF7\u6C42\u5931\u8D25\uFF1AHTTP 403
+   \u8D26\u6237 ${manifestId} \u7684 mediaAccountType=${mediaAccountType ?? "\u672A\u77E5"}\u3002
+   Facebook \u6388\u6743\u8D26\u6237\uFF08FacebookAds\uFF09\u987B\u8D70 FacebookAds/act_ \u8DEF\u5F84\uFF1B\u4E1D\u8DEF\u8D5E Meta \u5F00\u6237\u8D70 MetaAd \u8DEF\u5F84\u3002
+   \u5468\u671F/\u591A\u7EF4\u5EA6\u62A5\u544A\u8BF7\u6539\u7528\uFF1Asiluzan-tso facebook-analysis -a ${manifestId} --sections overview --json-out <dir>
+`
+      );
+    } else {
+      console.error(`
+\u274C \u8BF7\u6C42\u5931\u8D25\uFF1A${msg}
 `);
+    }
     process.exit(1);
   }
   if (opts.jsonOut) {
     const summary = await writeReportAnalysisSnapshot({
       snapshotDir: opts.jsonOut,
       section: "meta-overview",
-      accountId: id,
+      accountId: manifestId,
       dateRange: { start: startDate, end: endDate },
       payload: data,
       cliVersion: getCurrentVersion2()
@@ -106211,7 +106291,7 @@ async function runReportMetaOverview(opts) {
   const optRaw = row.optimizationScore;
   const optPct = typeof optRaw === "number" && optRaw <= 1 && optRaw >= 0 ? (optRaw * 100).toFixed(0) : typeof optRaw === "number" ? String(optRaw) : "\u2014";
   console.log(`
-\u2705 Meta \u8D26\u6237\u603B\u89C8  ${id}  \u533A\u95F4 ${startDate} ~ ${endDate}
+\u2705 Meta \u8D26\u6237\u603B\u89C8  ${manifestId}  \u533A\u95F4 ${startDate} ~ ${endDate}
 `);
   console.log(
     `   \u8D27\u5E01 ${currency}  \u4F18\u5316\u5F97\u5206 ${optPct}${typeof optRaw === "number" && optRaw <= 1 ? "%\uFF080\u20131 \u5DF2\u6362\u7B97\uFF09" : ""}  \u603B\u6D88\u8017 ${fmtNum2(typeof row.totalCost === "number" ? row.totalCost : cur.spend)}  \u4F59\u989D ${fmtNum2(typeof row.remainingAccountBudget === "number" ? row.remainingAccountBudget : void 0)}  \u6D3B\u8DC3\u5929\u6570 ${row.activeDays ?? "\u2014"}  \u65E5\u5747\u6D88\u8017 ${fmtNum2(typeof row.averageDailyCost === "number" ? row.averageDailyCost : void 0)}
@@ -106227,6 +106307,42 @@ async function runReportMetaOverview(opts) {
 function toSlashDate(date) {
   return date.replace(/-/g, "/");
 }
+async function lookupMetaAccountForOverview(config, manifestId, verbose = false) {
+  for (const idCandidate of [manifestId, `act_${manifestId}`]) {
+    const params = new URLSearchParams({
+      MediaTypes: "MetaAd|FacebookAds",
+      advStatus: "",
+      mediaAccountState: "Approved,Linked",
+      isForce: "false",
+      pageNum: "1",
+      pageSize: "20",
+      mediaCustomerIds: idCandidate
+    });
+    try {
+      const data = await apiFetch2(
+        `${config.apiBaseUrl}/query/media-account/SearchMediaAcountByCriteria?${params}`,
+        config,
+        {},
+        verbose
+      );
+      for (const item of data?.mas ?? []) {
+        const ma = item.ma ?? {};
+        const cidDigits = metaOverviewManifestId(String(ma.mediaCustomerId ?? ""));
+        if (cidDigits === manifestId) {
+          return {
+            entityId: String(ma.entityId ?? ""),
+            mediaCustomerId: String(ma.mediaCustomerId ?? ""),
+            mediaCustomerName: String(ma.mediaCustomerName ?? ""),
+            mediaAccountType: String(ma.mediaAccountType ?? ""),
+            mediaAccountGroupId: String(ma.mediaAccountGroupId ?? "")
+          };
+        }
+      }
+    } catch {
+    }
+  }
+  return void 0;
+}
 async function lookupAccountsByCustomerIds(apiBaseUrl, config, mediaType, customerIds, verbose = false) {
   const params = new URLSearchParams({
     MediaType: mediaType,
@@ -106239,14 +106355,17 @@ async function lookupAccountsByCustomerIds(apiBaseUrl, config, mediaType, custom
     {},
     verbose
   );
-  const idSet = new Set(customerIds.map((id) => id.trim()));
+  const idSet = new Set(
+    customerIds.map((id) => metaOverviewManifestId(id.trim())).filter(Boolean)
+  );
   const result = /* @__PURE__ */ new Map();
   const items = Array.isArray(data) ? data : [];
   for (const item of items) {
     const ma = item.ma ?? {};
     const cid = String(ma.mediaCustomerId ?? "");
-    if (idSet.has(cid)) {
-      result.set(cid, {
+    const cidDigits = metaOverviewManifestId(cid);
+    if (idSet.has(cidDigits)) {
+      result.set(cidDigits, {
         entityId: String(ma.entityId ?? ""),
         mediaCustomerId: cid,
         mediaCustomerName: String(ma.mediaCustomerName ?? ""),
@@ -107480,7 +107599,9 @@ function register13(program2) {
       verbose: opts.verbose
     });
   });
-  reportCmd.command("meta-overview").description("Meta \u8D26\u6237\u5206\u6790\u603B\u89C8\uFF08OverviewSectionData\uFF0C\u9700 tsoApiBaseUrl \u9274\u6743\uFF09").requiredOption("-a, --account <id>", "Meta \u5E7F\u544A\u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("--token <token>", "Auth Token").option(
+  reportCmd.command("meta-overview").description(
+    "Meta \u8D26\u6237\u5206\u6790\u603B\u89C8\uFF08OverviewSectionData\uFF1BFacebookAds \u6388\u6743\u6237\u8D70 FacebookAds/act_\uFF0CMetaAd \u5F00\u6237\u8D70 MetaAd\uFF09"
+  ).requiredOption("-a, --account <id>", "Meta \u5E7F\u544A\u8D26\u6237 mediaCustomerId\uFF08\u6570\u5B57\u6216 act_<\u6570\u5B57>\uFF09").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4E0E --end \u540C\u4F20\u6216\u540C\u7701\u7565\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("--token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\u76EE\u5F55\u5E76\u66F4\u65B0 report-manifest[-<accountId>].json\uFF1B\u6587\u4EF6\u540D\u4E3A `<section>[-<accountId>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09"
   ).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
@@ -122431,53 +122552,6 @@ var FACEBOOK_SECTION_ALIASES = {
   videos: "material"
 };
 
-// src/commands/facebook-analysis/fetch.ts
-init_auth();
-function normalizeFacebookAccountId(raw) {
-  const t = raw.trim();
-  if (!t) {
-    console.error("\n\u274C --account \u4E0D\u80FD\u4E3A\u7A7A\u3002\n");
-    process.exit(1);
-  }
-  const digits = t.startsWith("act_") ? t.slice(4) : t;
-  if (!/^\d+$/.test(digits)) {
-    console.error(
-      "\n\u274C --account \u987B\u4E3A Facebook \u5E7F\u544A\u8D26\u6237 ID\uFF08\u6570\u5B57 mediaCustomerId\uFF0C\u6216 act_<\u6570\u5B57>\uFF0C\u4E0E list-accounts -m MetaAd \u4E00\u81F4\uFF09\u3002\n"
-    );
-    process.exit(1);
-  }
-  return { apiId: `act_${digits}`, manifestId: digits };
-}
-function resolveFacebookDateRange(start, end) {
-  if (start && end) return { startDate: start, endDate: end };
-  if (!start && !end) {
-    const endD = /* @__PURE__ */ new Date();
-    endD.setDate(endD.getDate() - 1);
-    const startD = new Date(endD);
-    startD.setDate(startD.getDate() - 6);
-    const fmt2 = (d) => d.toISOString().slice(0, 10);
-    return { startDate: fmt2(startD), endDate: fmt2(endD) };
-  }
-  console.error("\n\u274C --start \u4E0E --end \u987B\u540C\u65F6\u4F20\u5165\uFF0C\u6216\u540C\u65F6\u7701\u7565\u4EE5\u4F7F\u7528\u9ED8\u8BA4\u8FD1 7 \u5929\uFF08\u622A\u81F3\u6628\u5929\uFF09\u3002\n");
-  process.exit(1);
-}
-function facebookReportingUrl(config, apiId, segment, query) {
-  const q = query ? query.startsWith("?") ? query : `?${query}` : "";
-  return `${config.apiBaseUrl}/reporting/media-account/FacebookAds/${encodeURIComponent(apiId)}/${segment}${q}`;
-}
-async function fetchFacebookSectionPayload(def, opts, config, apiId) {
-  const { startDate, endDate } = resolveFacebookDateRange(opts.start, opts.end);
-  const params = new URLSearchParams({ startDate, endDate });
-  if (def.countryLimitOption && opts.limit !== void 0 && Number.isFinite(opts.limit)) {
-    params.set("limit", String(Math.max(1, Math.floor(opts.limit))));
-  }
-  const url = facebookReportingUrl(config, apiId, def.segment, params.toString());
-  return apiFetch2(url, config, {}, opts.verbose ?? false);
-}
-function endpointHintForFacebookSection(def, apiId) {
-  return `GET \u2026/FacebookAds/${apiId}/${def.segment}`;
-}
-
 // src/commands/facebook-analysis/register-cli.ts
 import { Command } from "commander";
 

package/dist/skill/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: siluzan-tso
-description: Operates Siluzan TSO ad accounts via siluzan-tso-cli (Google/Bing/Yandex/TikTok/Kwai/MetaAd). Tasks (accounts) list, balance, stats, spend, active-bills, history, balance-scan P2, accounts-digest P3, share/unshare, delink, OAuth, MCC/BC/BM bind-unbind, email invite, TikTok close, suspend withdraw; (open-account) apply on 6 media; (Google Ads) campaign/adgroup/ad/keyword CRUD, extensions, geo, PMax, search campaign-plan validate/create, batch async create; (analytics) google-analysis, google-analysis-batch P5, facebook-analysis P4-FB, website-diagnosis P8, market-analysis P9, ads diagnosis; (reports) P1 profile, P4 period, P6 OKKI weekly, P7 inquiry; (tools) keyword suggest, RAG query, TSO report list/create/push, AI optimize records, forewarning rules, TikTok/Meta leads, transfer/invoice/invoice-info, audit restore. Use when user mentions ad accounts, balance, spend, campaigns, keywords, open account, MCC/BC, reports, diagnosis, market analysis, invoicing, or TSO. Re-read references/core/agent-conventions.md each new task.
+description: 通过 siluzan-tso-cli 操作丝路赞 TSO 广告账户（Google/Bing/Yandex/TikTok/Kwai/MetaAd）。（账户）列表、余额、统计、消耗、激活账单、历史、余额扫描 P2、账户摘要 P3、共享/取消共享、解绑、OAuth、MCC/BC/BM 绑定解绑、邮件邀请、TikTok 关闭、暂停撤回；（开户）六大媒体申请；（Google Ads）系列/广告组/广告/关键词 CRUD、附加信息、地理位置、PMax、搜索投放方案校验/创建、批量异步创建；（分析）google-analysis、google-analysis-batch P5、facebook-analysis P4-FB、网站诊断 P8、市场分析 P9、广告诊断；P1 账户画像、P4 周期报告、P6 OKKI 周报、P7 询盘分析；Google关键词推荐、RAG 检索、TSO 报告列表/创建/推送、智能预警、TikTok/Meta 线索、转账/发票/发票资料、审计恢复。当用户提及广告账户、余额、消耗、投放、关键词、开户、MCC/BC、报告、诊断、市场分析、开票或 TSO 时使用。
 license: MIT
-compatibility: Requires Node.js 18+, siluzan-tso-cli installed, authenticated via send-login-code + login or config set
+compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
 metadata:
   requires: nodejs,siluzan-tso-cli
 allowed-tools: Bash(siluzan-tso:*) Read Write
@@ -44,13 +44,14 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 
 ---
 
-## 可执行的操作范围
 
-| 级别 | 示例 |
-| ---- | ---- |
-| **只读** | 账户列表、余额、消耗、报告、预警记录、Google Ads 查询 |
-| **写入**（需用户确认） | 创建/修改广告、开户申请、预警规则、报告推送 |
-| **破坏性**（确认 + `--commit`） | 账户解绑/关闭、MCC/BC 解绑、删除预警/报告/广告、发票申请 |
+## 基本使用
+
+siluzan-tso-cli只是报名, 安装后可执行的命令是 siluzan-tso 
+
+```bash
+siluzan-tso -h // 查看帮助
+```
 
 ---
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.28-beta.2",
-  "publishedAt": 1780907501825
+  "version": "1.1.28-beta.4",
+  "publishedAt": 1780970734894
 }

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

@@ -265,7 +265,7 @@ const data = d.record ?? d.items; // record 非空=汇总维度；否则=列表
 
 > 周期/诊断报告：**`facebook-analysis`**（`FacebookAds` 路径，7 Section，对齐 Google 周期报告能 cover 的部分）。  
 > 撰写与 Google 对照表：**`references/analytics/facebook-analysis-guide.md`**（必读）。  
-> `report meta-overview` 仅为遗留单维总览（`MetaAd` 路径）。
+> `report meta-overview` 仅为遗留单维总览：按 `list-accounts` 的 `mediaAccountType` 自动选路径——**FacebookAds**（OAuth 授权）→ `FacebookAds/act_<id>`；**MetaAd**（丝路赞开户）→ `MetaAd/<id>`。多维度请用 `facebook-analysis`。
 
 ### 周期报告（默认 6 维，等同 Google 周期报告主流程）
 

package/dist/skill/references/core/cli-enums.md

@@ -1,5 +1,3 @@
-<!-- 本文件由 `pnpm --filter siluzan-tso-cli run gen:cli-enums` 自动生成，勿手改。源码：src/cli-enums/registry.ts -->
-
 # CLI 枚举速查
 
 > **Agent**：不确定 `--sections`、`-m`、`--operator` 等合法值时，**Read 本文件**（按章节）或执行：

package/dist/skill/report-templates/google-inquiry-analysis.md

@@ -159,7 +159,7 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 
 ## 国家 → 大洲映射
 
-- **数据源**：`references/analytics/geo-continents.json`（中文国家名 → 7 大洲，覆盖 200+ 主权国家 + 港澳台/巴勒斯坦/马恩岛/波多黎各等领土，由 `tso-cli/scripts/generate-geo-dictionaries.mjs` 与 `geo-en2zh.json` 同步生成；新增国家请加 `ISO_TO_CONTINENT` 映射后跑 `pnpm --filter siluzan-tso-cli run geo:generate`，**不要**手改 JSON）。
+- **数据源**：`references/analytics/geo-continents.json`
 - **默认 7 桶**：`亚洲` / `中东` / `欧洲` / `北美` / `南美` / `非洲` / `大洋洲`。
 - **运营常用 5 桶合并**（与样表 Sheet 3 一致）：`<重点国>` / `中东` / `非洲` / `欧美` / `亚洲(除重点国)`。**由脚本在写表前做二次合并**，伪代码：
 

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.28-beta.2'
+$PKG_VERSION = '1.1.28-beta.4'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

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

package/package.json

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

package/dist/skill/docs/skill-guide.md

@@ -1,44 +0,0 @@
-# Siluzan TSO Skill — 人类导读
-
-Agent 运行时请用 `SKILL.md` + `AGENTS.md`；本文供维护者与产品经理深读。
-
-## 设计理念（对齐 gstack）
-
-1. **薄入口**：`SKILL.md` 仅路由，<150 行
-2. **域化 references**：`core/`、`accounts/`、`google-ads/`、`analytics/`、`operations/`
-3. **渐进披露**：Playbook、参数表、SOP 按需 Read，不塞进主文件
-4. **模板分离**：`assets/*.json` 契约 vs `report-templates/*.md` 内容纲要
-
-## 目录树
-
-```
-siluzan-ads/
-├── AGENTS.md              # Agent 域目录（类似 gstack AGENTS.md）
-├── SKILL.md               # 路由入口
-├── docs/skill-guide.md    # 本文件
-├── references/
-│   ├── core/              # 纪律、安装、playbooks
-│   ├── accounts/          # 账户、开户、财务
-│   ├── google-ads/        # CLI 命令 + rules/ SOP
-│   ├── analytics/         # 拉数、批处理、拓词
-│   └── operations/        # 预警、线索、自动化
-├── assets/                # JSON/MD 创建契约
-└── report-templates/      # 报告纲要 + HTML 样式
-```
-
-## 常见维护任务
-
-| 任务 | 改哪里 |
-| --- | --- |
-| 新 CLI 命令 | `src/commands/` + 对应 `references/<域>/` |
-| 新 Playbook | `references/core/playbooks.md` + `SKILL.md` 任务表 |
-| 环境 URL | `scripts/write-defaults.mjs` + `copy-skill-assets.mjs` |
-| 发布 Skill | `npm run build:prod` → `siluzan-tso init --force` |
-
-## 与 eval 的关系
-
-场景 JSON 中 `judgeReferencePaths` 须使用域路径，例如 `references/accounts/accounts.md`。改文档后运行：
-
-```bash
-pnpm --filter siluzan-tso-cli run eval:export-cases
-```

package/dist/skill/references/core/skill-authoring.md

@@ -1,196 +0,0 @@
-# Agent SKILL 最佳实践（siluzan-tso 维护指南）
-
-本文档基于 [Agent Skills 开放规范](https://agentskills.io/specification) 与 [Cursor Skills 文档](https://cursor.com/docs/skills)，结合 siluzan-skill monorepo 的 TSO 实践，供维护 `tso-cli/assets/siluzan-ads/` 时对照。
-
----
-
-## 1. 协议要点（agentskills.io）
-
-### 1.1 目录结构
-
-```
-siluzan-tso/                    # 安装后目录名
-├── AGENTS.md                   # Agent 域目录（gstack 风格）
-├── SKILL.md.tmpl → SKILL.md    # 构建生成
-├── snippets/                   # 共享注入块
-├── docs/skill-guide.md         # 人类导读
-├── snippets/                   # agent-preamble、handoff-p5/p6/p7（构建时注入 SKILL 或随包复制）
-├── references/
-│   ├── core/                   # 纪律、安装、playbooks、subagent-orchestration
-│   ├── accounts/               # 账户、开户、财务
-│   ├── google-ads/             # CLI + rules/
-│   ├── analytics/              # 拉数、批处理、拓词
-│   └── operations/             # 预警、线索、自动化
-├── assets/
-└── report-templates/
-```
-
-源码位于 `tso-cli/assets/siluzan-ads/`，构建时 `copy-skill-assets.mjs` 替换占位符后写入 `dist/skill/`。
-
-### 1.2 SKILL.md  frontmatter
-
-| 字段 | 要求 | siluzan-tso 用法 |
-| ---- | ---- | ---------------- |
-| `name` | 小写+连字符，≤64 字，**须与安装目录名一致** | `siluzan-tso`（非 `siluzan-ads`） |
-| `description` | ≤1024 字，**第三人称**，含 WHAT + WHEN + 触发词 | 列出媒体、开户、Google Ads、报告、预警等 |
-| `license` | 可选 | `MIT` |
-| `compatibility` | 可选，≤500 字，环境依赖 | Node 18+、`siluzan-tso-cli`、鉴权 |
-| `metadata` | 可选键值 | `requires: nodejs,siluzan-tso-cli` |
-| `allowed-tools` | 可选（实验性） | `Bash(siluzan-tso:*) Read Write` |
-| `disable-model-invocation` | Cursor 扩展 | TSO 需自动激活，**不设** true |
-
-### 1.3 渐进式披露（三层加载）
-
-| 层级 | 内容 | Token 预算建议 |
-| ---- | ---- | -------------- |
-| L1 元数据 | `name` + `description` | ~100 tokens，启动时索引 |
-| L2 指令 | `SKILL.md` 正文 | <500 行，<5000 tokens，激活时加载 |
-| L3 资源 | `references/`、`assets/`、`report-templates/` | 任务相关时才 Read |
-
-**原则**：SKILL.md 只做路由与不可妥协的纪律；参数表、Playbook 步骤、优化 SOP 放 references。
-
-### 1.4 文件引用规则
-
-- 从 SKILL.md **只链接一层**（`references/foo.md`），避免 A→B→C 链式引用。
-- 路径用正斜杠，不用 Windows 反斜杠。
-- 占位符 `https://www-ci.siluzan.com`、`https://tso-api-ci.siluzan.com`、`npm install -g siluzan-tso-cli@beta` 由构建脚本替换，文档中禁止硬编码环境 URL。
-
----
-
-## 2. 内容编写原则
-
-### 2.1 简洁（Concise is Key）
-
-Agent 已具备通用能力。文档只写 **CLI 特有** 内容：字段口径、批量命令、门禁流程、与前端不一致处。
-
-❌ 解释「什么是 Google Ads」  
-✅ `budgetAmountYuan` 已是元，禁止再 ÷100
-
-### 2.2 单一术语
-
-全库统一：
-
-| 概念 | 统一用词 | 禁止混用 |
-| ---- | -------- | -------- |
-| 广告账户 ID | `mediaCustomerId` | customer id、账户号（无上下文时） |
-| 实体 ID | `entityId` | 内部 id |
-| 落盘 | `--json-out` | --json-out ./snap（已移除） |
-| 媒体 | `Google`、`TikTok`、`MetaAd`… | google、meta |
-
-### 2.3 默认 + 逃生口
-
-每个决策点给一个默认路径，例外单独一行：
-
-```markdown
-全量 Google 批处理：省略 `-a`（CLI 内部拉清单）。
-仅当用户明确给出 ID 子集时才传 `-a id1,id2,...`。
-```
-
-### 2.4 反馈环（Feedback Loop）
-
-写操作文档须含：**写命令 → 读命令复核 → 失败时查 reference**。
-
-破坏性操作统一：**用户确认 → `--commit` → 读命令验证**。
-
-### 2.5 禁止时间敏感表述
-
-不写「2025 年 8 月前用旧 API」。废弃内容放 `## 已废弃` 折叠或删除。
-
----
-
-## 3. siluzan-tso 文档分层
-
-| 文件 | 职责 |
-| ---- | ---- |
-| `SKILL.md` | 安装、能力边界、文档路由表、任务→文档速查、Playbook 索引 |
-| `references/core/agent-conventions.md` | Agent 纪律：加载时机、硬规范、数据转换、时间/币种/批量 |
-| `references/core/playbooks.md` | P1–P7 标准动作（可复制命令块） |
-| `references/core/subagent-orchestration.md` | 主 Agent 自主委派决策矩阵（无 `agents/` 目录） |
-| `snippets/handoff-p*.md` | Task handoff 模板（随 skill 安装根复制） |
-| `references/core/tips.md` | `--json-out` 协议、outline 处理顺序 |
-| `references/*.md` | 单功能域：命令、参数、输出示例 |
-| `references/google-ads/rules/` | Google 优化/合规 SOP（非 CLI 参数） |
-| `assets/*.json` / `*.md` | 创建类 JSON 契约 |
-| `report-templates/*.md` | 报告内容纲要（优先于 HTML） |
-| `report-templates/*.html` | 视觉样式，**不含业务数据** |
-| `README.md` | 给「通过 URL 安装」的大模型说明（不进 dist 路由） |
-
-### 3.1 与 CLI 代码同步
-
-**代码变更 → 必须同步 Skill**（tutorial-10 #2）。新命令注册在 `_register.ts` / `index.ts` 后：
-
-1. 更新对应 `references/*.md`
-2. 更新 `SKILL.md` 路由表（若新功能域）
-3. 评估场景：`tso-cli/eval/scenarios/` + `pnpm --filter siluzan-tso-cli run eval:export-cases`
-
-### 3.2 灰度开关（tutorial-10 #11）
-
-| 状态 | CLI 注册 | SKILL 文档 | AI 可见 |
-| ---- | -------- | ---------- | ------- |
-| 内测 | 是 | 否 | 否 |
-| 公开 | 是 | 是 | 是 |
-
----
-
-## 4. description 写法模板
-
-```yaml
-description: >-
-  Operates Siluzan TSO ad accounts via siluzan-tso-cli: Google/Bing/Yandex/TikTok/Kwai/Meta
-  account management, Google Ads CRUD, analytics, optimization reports, forewarning, leads,
-  invoicing, and RAG knowledge lookup. Use when the user mentions ad accounts, balance, spend,
-  campaigns, keywords, PMax, open account, MCC/BC binding, or TSO reporting.
-  Each new task requires re-reading routed references per SKILL.md.
-```
-
-中文项目可保留中文 description，但仍须：**第三人称 + 能力列表 + 触发场景 + 重读纪律一句**。
-
----
-
-## 5. 体积与质量检查清单
-
-发布前逐项确认：
-
-### Frontmatter
-- [ ] `name` === 安装目录名 `siluzan-tso`
-- [ ] `description` 含 WHAT、WHEN、关键词
-- [ ] `compatibility` 列出 Node + CLI + 鉴权
-
-### SKILL.md
-- [ ] 正文 < 500 行
-- [ ] 无重复 parameters 表（细节在 references）
-- [ ] 路由表覆盖所有 `references/*.md` 入口
-- [ ] Playbook 仅索引，步骤在 `core/playbooks.md`
-
-### References
-- [ ] 每个 CLI 命令族有且仅有一个主 reference
-- [ ] 含 `--json-out` 示例（查询类）
-- [ ] 写命令含 `--commit` 与复核命令
-- [ ] 无断链（如 `accounts/open-account-by-media.md` 必须存在）
-
-### 构建
-- [ ] `pnpm run build:tso:test` 后 `dist/skill/SKILL.md` 占位符已替换
-- [ ] `_meta.json` 版本与 package.json 一致
-
----
-
-## 6. 反模式（Avoid）
-
-| 反模式 | 正确做法 |
-| ------ | -------- |
-| SKILL.md 内嵌 200 行 Playbook | 移至 `references/core/playbooks.md` |
-| Agent 用 `--json` 落大 JSON 到对话 | 一律 `--json-out` + 脚本读盘 |
-| 路由表缺文件 | 补文件或删链接 |
-| google-ads-rules 深链三层 | SKILL → `google-ads/rules/README.md` → 具体规则 |
-| HTML 模板假数据当示例 | 纲要 `.md` 定义维度，数据来自 CLI |
-| 凭记忆跨任务复用参数 | 每任务重读 `core/agent-conventions.md` § 加载纪律 |
-| 固定 `agents/` 与 skill 双源维护 | 用 `subagent-orchestration.md` + handoff snippets，主 Agent 自主决策 |
-
----
-
-## 7. 相关仓库文档
-
-- `.cursor/rules/tutorial-05-core/skill-authoring.mdc` — 项目内 Skill 结构速查
-- `.cursor/rules/tutorial-10-best-practices.mdc` — CLI + Skill 同步等 12 条
-- `cso-cli/assets/siluzan-cso/SKILL.md` — 姊妹包参考（命令索引表风格）
-- https://agentskills.io/specification — 开放规范原文