siluzan-tso-cli 1.1.37-beta.12 → 1.1.37-beta.14

package/README.md

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

package/dist/index.js

@@ -4385,6 +4385,40 @@ 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 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 init_media_customer_id = __esm({
+  "src/utils/media-customer-id.ts"() {
+    "use strict";
+  }
+});
+
 // src/utils/balance.ts
 function fmt(d) {
   return d.toISOString().slice(0, 10);
@@ -103126,20 +103160,7 @@ function parseSections(input) {
   return list;
 }
 function parseAccountIds(input) {
-  if (!input || !input.trim()) return [];
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const raw of input.split(",")) {
-    const id = raw.trim();
-    if (!id) continue;
-    if (!/^\d+$/.test(id)) {
-      throw new Error(`mediaCustomerId \u5FC5\u987B\u4E3A\u7EAF\u6570\u5B57\uFF1A${id}`);
-    }
-    if (seen.has(id)) continue;
-    seen.add(id);
-    out.push(id);
-  }
-  return out;
+  return parseNumericMediaCustomerIds(input);
 }
 function parseDeadline(s) {
   if (!s) return void 0;
@@ -103644,6 +103665,7 @@ var init_google_analysis_batch = __esm({
     init_google_analysis3();
     init_balance();
     init_version();
+    init_media_customer_id();
     DEFAULT_SECTIONS = ["campaigns", "geographic", "keywords"];
     DEFAULT_ACCOUNT_CONCURRENCY = 4;
     DEFAULT_SECTION_CONCURRENCY = 6;
@@ -103795,23 +103817,15 @@ function finiteOpt(n) {
   return typeof n === "number" && Number.isFinite(n) ? n : void 0;
 }
 function parseAccountIdsForAnalysis(input) {
-  const out = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const raw of input.split(",")) {
-    const id = raw.trim();
-    if (!id) continue;
-    if (!/^\d+$/.test(id)) {
-      console.error(`
-\u274C --account \u987B\u4E3A\u6570\u5B57 mediaCustomerId\uFF08\u4E0D\u5408\u6CD5\uFF1A${id}\uFF09\u3002
+  try {
+    return parseNumericMediaCustomerIds(input);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`
+\u274C --account \u987B\u4E3A\u6570\u5B57 mediaCustomerId\uFF1A${message}
 `);
-      process.exit(1);
-    }
-    if (!seen.has(id)) {
-      seen.add(id);
-      out.push(id);
-    }
+    process.exit(1);
   }
-  return out;
 }
 async function runMultiAccountViaBatch(accountIds, opts) {
   const targets = resolveSectionList(opts.sections, opts.exclude);
@@ -103997,6 +104011,7 @@ var init_register_cli = __esm({
     init_auth();
     init_google_analysis_snapshot();
     init_version();
+    init_media_customer_id();
     init_http_retry();
     init_sections();
     init_fetch();
@@ -105963,6 +105978,7 @@ 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) {
@@ -105993,9 +106009,9 @@ async function runListAccounts(opts) {
       params.set("status", opts.status);
     }
     if (opts.keyword) {
-      const isNumeric = /^\d+$/.test(opts.keyword.trim());
-      if (isNumeric) {
-        params.set(platformCfg.idSearchParam, opts.keyword.trim());
+      const numericId = normalizeNumericMediaCustomerId(opts.keyword);
+      if (numericId) {
+        params.set(platformCfg.idSearchParam, numericId);
       } else {
         params.set("mediaCustomerName", opts.keyword.trim());
       }
@@ -106033,7 +106049,9 @@ async function runListAccounts(opts) {
     }
   } else {
     const params = new URLSearchParams();
-    if (opts.keyword) params.set("keyword", opts.keyword);
+    if (opts.keyword) {
+      params.set("keyword", normalizeNumericMediaCustomerId(opts.keyword) ?? opts.keyword.trim());
+    }
     if (opts.status && opts.status !== "all") params.set("status", opts.status);
     params.set("pageNo", String(page));
     params.set("pageSize", String(pageSize));
@@ -106280,6 +106298,7 @@ init_auth();
 init_cli_json_snapshot();
 init_cli_table();
 init_balance();
+init_media_customer_id();
 var VALID_MEDIA_TYPES2 = ["Google", "TikTok", "Yandex", "MetaAd", "BingV2", "Kwai"];
 async function runBalance(opts) {
   const config = loadConfig(opts.token);
@@ -106316,7 +106335,7 @@ async function runBalance(opts) {
 `);
     process.exit(1);
   }
-  const accountIds = opts.accounts.split(",").map((id) => id.trim()).filter(Boolean);
+  const accountIds = opts.accounts.split(",").map((id) => id.trim()).filter(Boolean).map((id) => normalizeNumericMediaCustomerId(id) ?? id);
   if (accountIds.length === 0) {
     console.error("\n\u274C \u8BF7\u901A\u8FC7 --accounts \u63D0\u4F9B\u81F3\u5C11\u4E00\u4E2A\u8D26\u6237 ID\uFF08\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF09\n");
     process.exit(1);
@@ -106874,7 +106893,10 @@ init_cli_json_snapshot();
 init_cli_table();
 init_balance();
 init_media_account_lookup();
+init_media_customer_id();
 var VALID_MEDIA_TYPES3 = ["Google", "TikTok", "Yandex", "MetaAd", "BingV2", "Kwai"];
+var MAX_BY_DAY_SPAN = 366;
+var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 function defaultDateRange2() {
   const end = /* @__PURE__ */ new Date();
   end.setDate(end.getDate() - 1);
@@ -106883,6 +106905,77 @@ function defaultDateRange2() {
   const fmt2 = (d) => d.toISOString().slice(0, 10);
   return { startDate: fmt2(start), endDate: fmt2(end) };
 }
+function eachDateInclusive(startDate, endDate) {
+  if (!DATE_RE.test(startDate) || !DATE_RE.test(endDate)) {
+    throw new Error(`\u65E5\u671F\u683C\u5F0F\u987B\u4E3A YYYY-MM-DD\uFF0C\u6536\u5230\uFF1A${startDate} ~ ${endDate}`);
+  }
+  const [ys, ms, ds] = startDate.split("-").map(Number);
+  const [ye, me, de] = endDate.split("-").map(Number);
+  const cur = new Date(Date.UTC(ys, ms - 1, ds));
+  const end = new Date(Date.UTC(ye, me - 1, de));
+  if (Number.isNaN(cur.getTime()) || Number.isNaN(end.getTime())) {
+    throw new Error(`\u65E0\u6548\u65E5\u671F\uFF1A${startDate} ~ ${endDate}`);
+  }
+  if (cur > end) {
+    throw new Error(`\u5F00\u59CB\u65E5\u671F\u4E0D\u80FD\u665A\u4E8E\u7ED3\u675F\u65E5\u671F\uFF1A${startDate} > ${endDate}`);
+  }
+  const out = [];
+  while (cur <= end) {
+    out.push(cur.toISOString().slice(0, 10));
+    cur.setUTCDate(cur.getUTCDate() + 1);
+  }
+  if (out.length > MAX_BY_DAY_SPAN) {
+    throw new Error(
+      `--by-day \u8DE8\u5EA6\u6700\u591A ${MAX_BY_DAY_SPAN} \u5929\uFF08\u542B\u8D77\u6B62\uFF09\uFF0C\u5F53\u524D ${out.length} \u5929\uFF1B\u8BF7\u7F29\u5C0F\u533A\u95F4\u6216\u5206\u6BB5\u62C9\u53D6`
+    );
+  }
+  return out;
+}
+async function fetchStatsWindow(media, ids, config, startDate, endDate, verbose) {
+  const isGoogle = media === "Google";
+  const isMetaAd = media === "MetaAd";
+  if (isGoogle) {
+    const params = new URLSearchParams({ startDate, endDate, mediaCustomerIds: ids.join("|") });
+    const url = `${config.apiBaseUrl}/report/media-account/google/account-spend-overview?${params.toString()}`;
+    const raw = await apiFetch2(url, config, {}, verbose);
+    return parseGoogleAccountSpendOverviewRows(raw).map((row) => ({
+      mediaAccountId: row.mediaAccountId,
+      mediaCustomerName: row.mediaCustomerName,
+      spend: row.spend,
+      impressions: row.impressions,
+      clicks: row.clicks,
+      conversions: row.conversions,
+      costPerClick: row.costPerClick,
+      currencyCode: row.currencyCode,
+      remainingAccountBudget: row.remainingAccountBudget,
+      status: row.status
+    }));
+  }
+  if (isMetaAd) {
+    const accountMediaTypes = await lookupMetaMediaAccountTypes(config, ids, verbose);
+    const items2 = [];
+    for (const [route, routeIds] of groupAccountIdsByOverviewRoute(
+      "MetaAd",
+      ids,
+      accountMediaTypes
+    )) {
+      const map2 = await fetchOverviewMap(route, routeIds, config, startDate, endDate, verbose);
+      for (const item of map2.values()) {
+        items2.push(item);
+      }
+    }
+    return items2;
+  }
+  const map = await fetchOverviewMap(
+    media,
+    ids,
+    config,
+    startDate,
+    endDate,
+    verbose
+  );
+  return [...map.values()];
+}
 async function runStats(opts) {
   const config = loadConfig(opts.token);
   if (!VALID_MEDIA_TYPES3.includes(opts.media)) {
@@ -106909,57 +107002,35 @@ async function runStats(opts) {
     );
     process.exit(1);
   }
-  const ids = opts.accounts.split(",").map((id) => id.trim()).filter(Boolean);
-  const isGoogle = opts.media === "Google";
-  const isMetaAd = opts.media === "MetaAd";
+  const ids = opts.accounts.split(",").map((id) => id.trim()).filter(Boolean).map((id) => normalizeNumericMediaCustomerId(id) ?? id);
   let items2;
   try {
-    if (isGoogle) {
-      const params = new URLSearchParams({ startDate, endDate, mediaCustomerIds: ids.join("|") });
-      const url = `${config.apiBaseUrl}/report/media-account/google/account-spend-overview?${params.toString()}`;
-      const raw = await apiFetch2(url, config, {}, opts.verbose);
-      items2 = parseGoogleAccountSpendOverviewRows(raw).map((row) => ({
-        mediaAccountId: row.mediaAccountId,
-        mediaCustomerName: row.mediaCustomerName,
-        spend: row.spend,
-        impressions: row.impressions,
-        clicks: row.clicks,
-        conversions: row.conversions,
-        costPerClick: row.costPerClick,
-        currencyCode: row.currencyCode,
-        remainingAccountBudget: row.remainingAccountBudget,
-        status: row.status
-      }));
-    } else if (isMetaAd) {
-      const accountMediaTypes = await lookupMetaMediaAccountTypes(config, ids, opts.verbose);
+    if (opts.byDay) {
+      const days = eachDateInclusive(startDate, endDate);
       items2 = [];
-      for (const [route, routeIds] of groupAccountIdsByOverviewRoute(
-        "MetaAd",
-        ids,
-        accountMediaTypes
-      )) {
-        const map = await fetchOverviewMap(
-          route,
-          routeIds,
+      console.error(
+        `\u23F3 [stats --by-day] ${opts.media} ${ids.length} \u6237 \xD7 ${days.length} \u5929\uFF08${startDate} ~ ${endDate}\uFF09\u2026`
+      );
+      for (let i = 0; i < days.length; i++) {
+        const day = days[i];
+        if (opts.verbose || days.length > 7) {
+          console.error(`   \u2192 [${i + 1}/${days.length}] ${day}`);
+        }
+        const dayItems = await fetchStatsWindow(
+          opts.media,
+          ids,
           config,
-          startDate,
-          endDate,
+          day,
+          day,
           opts.verbose
         );
-        for (const item of map.values()) {
-          items2.push(item);
+        for (const row of dayItems) {
+          items2.push({ ...row, date: day });
         }
       }
+      console.error(`   \u2713 \u5B8C\u6210\uFF1A${items2.length} \u6761\u6309\u65E5\u884C`);
     } else {
-      const map = await fetchOverviewMap(
-        opts.media,
-        ids,
-        config,
-        startDate,
-        endDate,
-        opts.verbose
-      );
-      items2 = [...map.values()];
+      items2 = await fetchStatsWindow(opts.media, ids, config, startDate, endDate, opts.verbose);
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -106978,17 +107049,18 @@ async function runStats(opts) {
     process.exit(1);
   }
   const n = items2.length;
+  const section = opts.byDay ? `stats-${opts.media}-by-day` : `stats-${opts.media}`;
   const statsPayload = wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: items2 });
   if (await emitCliJsonOrSnapshot(opts, {
-    section: `stats-${opts.media}`,
+    section,
     commandLabel: "stats",
-    commandHint: opts.media,
+    commandHint: opts.byDay ? `${opts.media}-by-day` : opts.media,
     payload: statsPayload,
-    idSuffix: opts.media
+    idSuffix: opts.byDay ? `${opts.media}-by-day` : opts.media
   })) {
     return;
   }
-  const rangeLabel = `${startDate} ~ ${endDate}`;
+  const rangeLabel = opts.byDay ? `${startDate} ~ ${endDate}\uFF08\u6309\u65E5\uFF09` : `${startDate} ~ ${endDate}`;
   if (items2.length === 0) {
     console.log(`
 ${opts.media} \u6295\u653E\u6570\u636E\uFF08${rangeLabel}\uFF09\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 0 \u6761\uFF0C\u5171 0 \u6761\uFF09
@@ -107001,7 +107073,16 @@ ${opts.media} \u6295\u653E\u6570\u636E\uFF08${rangeLabel}\uFF09\uFF08\u7B2C 1 \u
 ${opts.media} \u6295\u653E\u6570\u636E\uFF08${rangeLabel}\uFF09\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${items2.length} \u6761\uFF0C\u5171 ${items2.length} \u6761\uFF09
 `
   );
-  const cols = [
+  const cols = opts.byDay ? [
+    { key: "date", header: "\u65E5\u671F" },
+    { key: "id", header: "\u8D26\u6237ID" },
+    { key: "name", header: "\u8D26\u6237\u540D\u79F0" },
+    { key: "spend", header: "\u6D88\u8017" },
+    { key: "impressions", header: "\u5C55\u793A\u6B21\u6570" },
+    { key: "clicks", header: "\u70B9\u51FB\u6B21\u6570" },
+    { key: "conversions", header: "\u8F6C\u5316\u6B21\u6570" },
+    { key: "cpc", header: "\u70B9\u51FB\u5747\u4EF7" }
+  ] : [
     { key: "id", header: "\u8D26\u6237ID" },
     { key: "name", header: "\u8D26\u6237\u540D\u79F0" },
     { key: "spend", header: "\u6D88\u8017" },
@@ -107019,7 +107100,7 @@ ${opts.media} \u6295\u653E\u6570\u636E\uFF08${rangeLabel}\uFF09\uFF08\u7B2C 1 \u
     totalImpressions += item.impressions ?? 0;
     totalClicks += item.clicks ?? 0;
     totalConversions += item.conversions ?? 0;
-    return {
+    const base = {
       id: item.mediaAccountId ?? "",
       name: item.mediaCustomerName ?? "",
       spend: item.spend?.toFixed(2) ?? "0.00",
@@ -107028,27 +107109,45 @@ ${opts.media} \u6295\u653E\u6570\u636E\uFF08${rangeLabel}\uFF09\uFF08\u7B2C 1 \u
       conversions: String(item.conversions ?? 0),
       cpc: item.costPerClick?.toFixed(4) ?? "0.0000"
     };
+    return opts.byDay ? { date: item.date ?? "", ...base } : base;
   });
   if (items2.length > 1) {
     const avgCpc = totalClicks > 0 ? (totalSpend / totalClicks).toFixed(4) : "0.0000";
-    rows.push({
-      id: "\u5408\u8BA1",
-      name: "",
-      spend: totalSpend.toFixed(2),
-      impressions: String(totalImpressions),
-      clicks: String(totalClicks),
-      conversions: String(totalConversions),
-      cpc: avgCpc
-    });
+    rows.push(
+      opts.byDay ? {
+        date: "\u5408\u8BA1",
+        id: "",
+        name: "",
+        spend: totalSpend.toFixed(2),
+        impressions: String(totalImpressions),
+        clicks: String(totalClicks),
+        conversions: String(totalConversions),
+        cpc: avgCpc
+      } : {
+        id: "\u5408\u8BA1",
+        name: "",
+        spend: totalSpend.toFixed(2),
+        impressions: String(totalImpressions),
+        clicks: String(totalClicks),
+        conversions: String(totalConversions),
+        cpc: avgCpc
+      }
+    );
   }
   printCliTable(rows, cols);
   console.log();
 }
 function register11(program2) {
-  program2.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(
+  program2.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\u533A\u95F4\u5408\u8BA1\uFF0C\u4E0D\u542B\u4ECA\u5929\uFF1B\u8981\u6309\u65E5\u660E\u7EC6\u52A0 --by-day\uFF09"
+  ).requiredOption(
     "-m, --media <type>",
     "\u5A92\u4F53\u7C7B\u578B\uFF1AGoogle | TikTok | Yandex | MetaAd | BingV2 | Kwai"
-  ).option("-a, --accounts <ids>", "\u8D26\u6237 ID\uFF0C\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF08\u7559\u7A7A\u5219\u67E5\u5168\u90E8\u8D26\u6237\uFF09").option("--start <date>", "\u5F00\u59CB\u65E5\u671F\uFF0C\u683C\u5F0F YYYY-MM-DD\uFF08\u9ED8\u8BA4 7 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF0C\u683C\u5F0F YYYY-MM-DD\uFF08\u9ED8\u8BA4\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("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option(
+  ).option("-a, --accounts <ids>", "\u8D26\u6237 mediaCustomerId\uFF0C\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF08\u5FC5\u586B\uFF09").option("--start <date>", "\u5F00\u59CB\u65E5\u671F\uFF0C\u683C\u5F0F YYYY-MM-DD\uFF08\u9ED8\u8BA4 7 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF0C\u683C\u5F0F YYYY-MM-DD\uFF08\u9ED8\u8BA4\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(
+    "--by-day",
+    "\u6309\u65E5\u660E\u7EC6\uFF1A\u5BF9\u533A\u95F4\u5185\u6BCF\u4E00\u5929\u5206\u522B\u62C9\u6570\uFF0Citems[] \u6BCF\u884C\u5E26 date\uFF1B\u5BFC\u51FA Excel/\u6309\u65E5\u8D8B\u52BF\u5FC5\u52A0\u3002\u9ED8\u8BA4\u4E0D\u52A0\u5219\u53EA\u8FD4\u56DE\u533A\u95F4\u5408\u8BA1\u4E00\u884C",
+    false
+  ).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
     void 0
@@ -107060,6 +107159,7 @@ function register11(program2) {
         accounts: opts.accounts,
         startDate: opts.start ?? opts.startDate,
         endDate: opts.end ?? opts.endDate,
+        byDay: opts.byDay,
         jsonOut: opts.jsonOut,
         verbose: opts.verbose
       });
@@ -131871,7 +131971,10 @@ configureCliJsonSnapshot({
   fieldGuideRefs: [
     "references/accounts/currency.md",
     "references/core/tips.md",
-    "references/accounts/accounts.md"
+    "references/accounts/accounts.md",
+    "references/accounts/accounts-list.md",
+    "references/accounts/accounts-balance-stats.md",
+    "references/accounts/accounts-permissions.md"
   ]
 });
 var program = new Command5();

package/dist/skill/AGENTS.md

@@ -1,61 +1,28 @@
 # siluzan-tso — Agent 文档目录
 
-> 单一 Skill 包（`name: siluzan-tso`）。运行时入口：`SKILL.md` → 按域 lazy-load `references/`。
+> 运行时入口：`SKILL.md` → 按路由表 Read **leaf** 文档。维护时对齐 `references/core/skill-authoring.md`。
 
 ## 启动顺序
 
-1. Read `SKILL.md`（单一路由表：意图 → 工作流 → 必读文档）
-2. **每个新任务** Read `references/core/agent-conventions.md`
-3. 按路由表 Read「必读文档」与对应工作流卡片，再执行 `siluzan-tso …`：
-   - 分析/报告类线性步骤 → `references/core/playbooks.md`（P1–P9）
-   - 操作/管理类线性步骤 → `references/core/workflows.md`（W1–W12）
-   - 命令参数/字段口径 → 各域 `references/*.md`
-4. **P5 / P6 / P7** 或长 CLI 输出：可选 Read `references/core/subagent-orchestration.md`（主 Agent 自行决定是否委派 subagent）
+1. Read `SKILL.md` 路由表，锁定唯一工作流
+2. 报告类模糊 → Read `references/core/intent-routing.md`
+3. Read 路由行「必读文档」+ 对应 `playbooks.md` / `workflows.md` 卡片（**直接读 leaf**，不必先经 `accounts.md` 索引）
+4. 写操作 / 报告交付 / 批量拉数 → Read `references/core/agent-conventions.md` 相关节
+5. P5/P6/P7 或长 CLI：可选 `references/core/subagent-orchestration.md`
 
-## 文档域（gstack-style domains）
+## 文档域
 
-| 域             | 路径                                                                 | 何时 Read                                                      |
-| -------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- |
-| **Core**       | `references/core/`                                                   | 纪律、安装、tips、playbooks、workflows、subagent-orchestration |
-| **Handoff**    | `snippets/`                                                          | P5/P6/P7 Task 派发模板（与 SKILL 同级）                        |
-| **Accounts**   | `references/accounts/`                                               | 列表、余额、开户、财务、审计                                   |
-| **Google Ads** | `references/google-ads/`                                             | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP                |
-| **Analytics**  | `references/analytics/`                                              | 拉数、批处理、拓词、RAG、TSO 报告                              |
-| **Operations** | `references/operations/`                                             | 预警、线索、优化记录、宿主编排自动化                           |
-| **Templates**  | `assets/`、`references/report-templates/`、`report-templates/*.html` | JSON 契约、报告纲要、HTML 样式                                 |
-
-## 工作流目录
-
-| 类别          | 文档                           | 编号   |
-| ------------- | ------------------------------ | ------ |
-| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9  |
-| 操作 / 管理类 | `references/core/workflows.md` | W1–W12 |
-
-专用报告模板（被工作流卡片引用）：
-
-| ID                | 文档                                                              |
-| ----------------- | ----------------------------------------------------------------- |
-| 网站诊断          | `references/report-templates/website-diagnosis-report.md`         |
-| 战略市场分析      | `references/report-templates/market-analysis-report.md`           |
-| Google 周期 Excel | `references/report-templates/google-period-report-excel.md`（P4） |
-| OKKI 周报         | `references/report-templates/okki-weekly-google-client.md`        |
-| 询盘分析          | `references/report-templates/google-inquiry-analysis.md`          |
+| 域 | 路径 | 何时 Read |
+| -- | ---- | --------- |
+| Core | `references/core/` | 纪律、intent-routing、playbooks、workflows |
+| Accounts | `references/accounts/` | `accounts-list` / `accounts-balance-stats` / `accounts-permissions`（`accounts.md` 仅索引） |
+| Google Ads | `references/google-ads/` | `google-ads-read` / `write` / `batch`（索引：`google-ads.md`）；`rules/` 先 README 再单文件 |
+| Analytics | `references/analytics/` | 拉数、批处理、拓词、RAG |
+| Operations | `references/operations/` | 预警、线索；自动化仅用户问起时 |
+| Templates | `report-templates/*.md`、`assets/` | 报告纲要 / JSON 契约；**禁止** Read `*.html` |
 
 ## 维护
 
-- 源码唯一真相：`tso-cli/assets/siluzan-ads/`（勿编辑 `skills/siluzan-tso/` 副本）
-- 通用纪律唯一真相源：`references/core/agent-conventions.md`（其他文档只单行指向，不复制规则）
-
-## CLI 代码域（与文档对齐）
-
-| CLI 模块                                                                | 文档域                                |
-| ----------------------------------------------------------------------- | ------------------------------------- |
-| `src/commands/list-accounts/`、`accounts-digest/`、`balance-scan/`      | accounts                              |
-| `src/commands/open-account/`、`account-manage-register.ts`              | accounts                              |
-| `src/commands/ad/`                                                      | google-ads                            |
-| `src/commands/google-analysis/`、`google-analysis-batch.ts`             | analytics                             |
-| `src/commands/facebook-analysis/`、`bing-analysis/`、`tiktok-analysis/` | analytics（架构对齐 google-analysis） |
-| `src/commands/website-diagnosis/`                                       | analytics（网站诊断）                 |
-| `src/commands/market-analysis/`                                         | analytics（战略市场分析）             |
-| `src/commands/report/`                                                  | analytics + report-templates          |
-| `src/commands/forewarning/`、`optimize/`、`clue.ts`                     | operations                            |
+- 源码：`tso-cli/assets/siluzan-ads/`
+- 纪律真相源：`references/core/agent-conventions.md`
+- 规范：`references/core/skill-authoring.md`