siluzan-tso-cli 1.1.29-beta.5 → 1.1.29-beta.7

package/README.md

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

package/dist/index.js

@@ -2338,6 +2338,18 @@ function decodeJwtClaims(token) {
 function decodeJwtSub(token) {
   return decodeJwtClaims(token)?.sub ?? null;
 }
+function sleep(ms) {
+  return new Promise((resolve32) => setTimeout(resolve32, ms));
+}
+async function pollUntil(fn, intervalMs, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const result = await fn();
+    if (result !== null) return result;
+    await sleep(intervalMs);
+  }
+  return null;
+}
 function getCurrentVersion(importMetaUrl) {
   try {
     const __dirname3 = path2.dirname(fileURLToPath(importMetaUrl));
@@ -121345,6 +121357,35 @@ BingV2 \u884C\u4E1A\u5217\u8868\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${list.le
 init_auth();
 import * as fs10 from "fs";
 import * as path15 from "path";
+
+// src/commands/open-account/kwai-licence-id-type.ts
+var KWAI_LICENCE_ID_TYPE_LABELS = {
+  "1": "\u7EDF\u4E00\u793E\u4F1A\u4FE1\u7528\u4EE3\u7801 / Business license Uniform social credit code",
+  "2": "DUNS / Data Universal Numbering System",
+  "3": "CNPJ"
+};
+var VALID = new Set(Object.keys(KWAI_LICENCE_ID_TYPE_LABELS));
+var LEGACY_ALIASES = {
+  ENTERPRISE: "1",
+  INDIVIDUAL: "1"
+};
+function normalizeKwaiLicenceIdType(raw) {
+  const trimmed = raw.trim();
+  const upper = trimmed.toUpperCase();
+  const legacy = LEGACY_ALIASES[upper];
+  if (legacy) {
+    return { value: legacy, legacyAlias: trimmed };
+  }
+  if (VALID.has(trimmed)) {
+    return { value: trimmed };
+  }
+  const options = Object.entries(KWAI_LICENCE_ID_TYPE_LABELS).map(([k, v]) => `${k}=${v.split(" / ")[0]}`).join("\uFF1B");
+  throw new Error(
+    `\u65E0\u6548\u7684 --licence-id-type\uFF1A${JSON.stringify(raw)}\u3002Kwai \u987B\u4F7F\u7528\u6570\u5B57\u4EE3\u7801\uFF08\u4E0E\u7F51\u9875\u4E00\u81F4\uFF09\uFF1A${options}\u3002\u52FF\u4F7F\u7528 ENTERPRISE / INDIVIDUAL\u3002`
+  );
+}
+
+// src/commands/open-account/kwai.ts
 async function uploadToKwai(filePath, apiBaseUrl, config, verbose) {
   const ext = path15.extname(filePath).toLowerCase().replace(".", "").replace("jpg", "jpeg");
   const imageType = ext || "jpeg";
@@ -121365,8 +121406,51 @@ async function uploadToKwai(filePath, apiBaseUrl, config, verbose) {
   }
   return blobstoreKey;
 }
+async function waitForKwaiAccountInHistory(config, accountName, verbose) {
+  return pollUntil(
+    async () => {
+      const params = new URLSearchParams({
+        MediaType: "Kwai",
+        mediaAccountState: "Created,Approved,Denied",
+        pageNo: "1",
+        pageSize: "5",
+        mediaCustomerName: accountName
+      });
+      const res = await apiFetchWithHeaders2(
+        `${config.apiBaseUrl}/query/media-account/?${params}`,
+        config,
+        {},
+        verbose
+      );
+      const hits = parseInt(res.headers["s-total-hits"] ?? "0", 10);
+      if (hits > 0 && res.data?.length) {
+        return res.data[0] ?? null;
+      }
+      return null;
+    },
+    2e3,
+    3e4
+  );
+}
 async function runOpenAccountKwai(opts) {
   const config = loadConfig(opts.token);
+  let licenceIdType;
+  try {
+    const normalized = normalizeKwaiLicenceIdType(opts.licenceIdType);
+    licenceIdType = normalized.value;
+    if (normalized.legacyAlias) {
+      console.error(
+        `
+  \u26A0\uFE0F  --licence-id-type ${normalized.legacyAlias} \u5DF2\u5E9F\u5F03\uFF0C\u5DF2\u81EA\u52A8\u6620\u5C04\u4E3A ${licenceIdType}\uFF08\u7EDF\u4E00\u793E\u4F1A\u4FE1\u7528\u4EE3\u7801\uFF09\u3002\u8BF7\u6539\u7528\u6570\u5B57\u4EE3\u7801\uFF0C\u89C1 open-account-by-media.md \xA7 Kwai\u3002
+`
+      );
+    }
+  } catch (err) {
+    console.error(`
+\u274C ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
   if (!fs10.existsSync(opts.licenseFile)) {
     console.error(`
 \u274C \u8425\u4E1A\u6267\u7167\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${opts.licenseFile}
@@ -121424,7 +121508,7 @@ async function runOpenAccountKwai(opts) {
       advertisementType: opts.adType,
       productUrl: opts.productUrl,
       currencyCode: "USD",
-      licenceIdType: opts.licenceIdType,
+      licenceIdType,
       accountName: opts.accountName,
       legalEntityName: opts.companyName,
       newIndustryId1: opts.industryId1,
@@ -121446,14 +121530,31 @@ async function runOpenAccountKwai(opts) {
       { method: "POST", body: JSON.stringify(body) },
       opts.verbose
     );
-    console.log("\n\u2705 Kwai \u5F00\u6237\u7533\u8BF7\u5DF2\u63D0\u4EA4\u6210\u529F\uFF0C\u8BF7\u5728\u300C\u5F00\u6237\u8BB0\u5F55\u300D\u9875\u9762\u67E5\u770B\u5BA1\u6838\u72B6\u6001\u3002\n");
-    logAccountOpeningHistoryWebUrl(config.apiBaseUrl, "Kwai");
   } catch (err) {
     console.error(`
 \u274C \u63D0\u4EA4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
 `);
     process.exit(1);
   }
+  console.log("\n  \u5DF2\u6536\u5230\u670D\u52A1\u7AEF\u53D7\u7406\uFF08HTTP 202\uFF09\uFF0C\u6B63\u5728\u786E\u8BA4\u5F00\u6237\u8BB0\u5F55\u662F\u5426\u843D\u5E93\u2026");
+  const record = await waitForKwaiAccountInHistory(config, opts.accountName, opts.verbose);
+  if (!record) {
+    console.error(
+      `
+\u274C \u5F00\u6237\u8BF7\u6C42\u5DF2\u53D7\u7406\uFF0C\u4F46\u5728 30 \u79D2\u5185\u672A\u5728\u300C\u5F00\u6237\u8BB0\u5F55\u300D\u4E2D\u67E5\u5230\u8D26\u6237\u300C${opts.accountName}\u300D\u3002
+   \u5E38\u89C1\u539F\u56E0\uFF1A--licence-id-type \u975E\u6CD5\uFF08\u987B\u4E3A 1/2/3\uFF0C\u4E0E\u7F51\u9875 KwaiOpenAnAccount \u4E00\u81F4\uFF09\u3001\u884C\u4E1A ID \u65E0\u6548\u6216\u8D44\u8D28\u5B57\u6BB5\u88AB Kwai \u5F02\u6B65\u62D2\u7EDD\u3002
+   \u8BF7\u6838\u5BF9\u53C2\u6570\u540E\u91CD\u8BD5\uFF0C\u6216\u6267\u884C\uFF1Asiluzan-tso account-history -m Kwai -k ${opts.accountName}
+`
+    );
+    process.exit(1);
+  }
+  const state = record.ma.mediaAccountState ?? "Unknown";
+  console.log(
+    `
+\u2705 Kwai \u5F00\u6237\u7533\u8BF7\u5DF2\u843D\u5E93\uFF08\u72B6\u6001\uFF1A${state}\uFF0C\u8D26\u6237\u540D\uFF1A${opts.accountName}\uFF09\u3002\u8BF7\u5728\u300C\u5F00\u6237\u8BB0\u5F55\u300D\u67E5\u770B\u5BA1\u6838\u8FDB\u5EA6\u3002
+`
+  );
+  logAccountOpeningHistoryWebUrl(config.apiBaseUrl, "Kwai");
 }
 
 // src/commands/open-account/google.ts
@@ -122347,7 +122448,10 @@ function register24(program2) {
       });
     }
   );
-  openAccountCmd.command("kwai").description("\u63D0\u4EA4 Kwai \u5F00\u6237\u7533\u8BF7\uFF08\u9700\u4E0A\u4F20\u8425\u4E1A\u6267\u7167\u56FE\u7247\uFF0C\u6309\u516C\u53F8\u540D\u81EA\u52A8\u521B\u5EFA/\u5173\u8054\u5E7F\u544A\u4E3B\u7EC4\uFF09").requiredOption("--licence-id <id>", "\u8425\u4E1A\u6267\u7167\u53F7\uFF08\u4E3B\u4F53\u4EE3\u7801\uFF09").requiredOption("--licence-country <code>", "\u4E3B\u4F53\u6CE8\u518C\u56FD\u5BB6\u4EE3\u7801\uFF0C\u5982 CN").requiredOption("--licence-location <address>", "\u4E3B\u4F53\u6CE8\u518C\u5730\uFF08\u7701\u5E02\u533A\u8BE6\u7EC6\u5730\u5740\uFF09").requiredOption("--business-scope <scope>", "\u8425\u4E1A\u8303\u56F4").requiredOption("--product <name>", "\u4EA7\u54C1\u6216\u54C1\u724C\u540D\u79F0").requiredOption("--ad-type <n>", "\u8D26\u6237\u7C7B\u578B\uFF1A1=\u6548\u679C\u5E7F\u544A 2=\u54C1\u724C\u5E7F\u544A", parseInt).requiredOption("--product-url <url>", "\u4EA7\u54C1\u6216\u54C1\u724C\u7F51\u5740").requiredOption("--licence-id-type <type>", "\u5B9E\u4F53\u7C7B\u578B\uFF1AINDIVIDUAL\uFF08\u4E2A\u4EBA\uFF09/ ENTERPRISE\uFF08\u4F01\u4E1A\uFF09").requiredOption("--account-name <name>", "\u8D26\u6237\u540D\u79F0").requiredOption("--company-name <name>", "\u516C\u53F8\u4E3B\u4F53\u540D\u79F0").requiredOption("--industry-id1 <id>", "\u4E00\u7EA7\u884C\u4E1A ID").requiredOption("--industry-id2 <id>", "\u4E8C\u7EA7\u884C\u4E1A ID").requiredOption("--expire-type <n>", "\u6709\u6548\u671F\u7C7B\u578B\uFF1A1=\u6709\u9650\u671F 2=\u957F\u671F\u6709\u6548", parseInt).requiredOption("--target-country <code>", "\u6295\u653E\u5730\u533A\u56FD\u5BB6\u4EE3\u7801\uFF0C\u5982 US").requiredOption("--license-file <path>", "\u8425\u4E1A\u6267\u7167\u56FE\u7247\u672C\u5730\u8DEF\u5F84\uFF08JPG/PNG\uFF09").option("--expire-at <ms>", "\u5230\u671F\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09\uFF0Cexpire-type=1 \u65F6\u586B\u5199", parseInt).option("--advertiser-id <magKey>", "\u53EF\u9009\uFF1A\u624B\u52A8\u6307\u5B9A\u5E7F\u544A\u4E3B\u7EC4 magKey\uFF08\u4E00\u822C\u65E0\u9700\u586B\u5199\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  openAccountCmd.command("kwai").description("\u63D0\u4EA4 Kwai \u5F00\u6237\u7533\u8BF7\uFF08\u9700\u4E0A\u4F20\u8425\u4E1A\u6267\u7167\u56FE\u7247\uFF0C\u6309\u516C\u53F8\u540D\u81EA\u52A8\u521B\u5EFA/\u5173\u8054\u5E7F\u544A\u4E3B\u7EC4\uFF09").requiredOption("--licence-id <id>", "\u8425\u4E1A\u6267\u7167\u53F7\uFF08\u4E3B\u4F53\u4EE3\u7801\uFF09").requiredOption("--licence-country <code>", "\u4E3B\u4F53\u6CE8\u518C\u56FD\u5BB6\u4EE3\u7801\uFF0C\u5982 CN").requiredOption("--licence-location <address>", "\u4E3B\u4F53\u6CE8\u518C\u5730\uFF08\u7701\u5E02\u533A\u8BE6\u7EC6\u5730\u5740\uFF09").requiredOption("--business-scope <scope>", "\u8425\u4E1A\u8303\u56F4").requiredOption("--product <name>", "\u4EA7\u54C1\u6216\u54C1\u724C\u540D\u79F0").requiredOption("--ad-type <n>", "\u8D26\u6237\u7C7B\u578B\uFF1A1=\u6548\u679C\u5E7F\u544A 2=\u54C1\u724C\u5E7F\u544A", parseInt).requiredOption("--product-url <url>", "\u4EA7\u54C1\u6216\u54C1\u724C\u7F51\u5740").requiredOption(
+    "--licence-id-type <code>",
+    "\u6267\u7167/\u8BC1\u4EF6\u7C7B\u578B\uFF1A1=\u7EDF\u4E00\u793E\u4F1A\u4FE1\u7528\u4EE3\u7801 2=DUNS 3=CNPJ\uFF08\u4E0E\u7F51\u9875 KwaiOpenAnAccount \u4E0B\u62C9 value \u4E00\u81F4\uFF09"
+  ).requiredOption("--account-name <name>", "\u8D26\u6237\u540D\u79F0").requiredOption("--company-name <name>", "\u516C\u53F8\u4E3B\u4F53\u540D\u79F0").requiredOption("--industry-id1 <id>", "\u4E00\u7EA7\u884C\u4E1A ID").requiredOption("--industry-id2 <id>", "\u4E8C\u7EA7\u884C\u4E1A ID").requiredOption("--expire-type <n>", "\u6709\u6548\u671F\u7C7B\u578B\uFF1A1=\u6709\u9650\u671F 2=\u957F\u671F\u6709\u6548", parseInt).requiredOption("--target-country <code>", "\u6295\u653E\u5730\u533A\u56FD\u5BB6\u4EE3\u7801\uFF0C\u5982 US").requiredOption("--license-file <path>", "\u8425\u4E1A\u6267\u7167\u56FE\u7247\u672C\u5730\u8DEF\u5F84\uFF08JPG/PNG\uFF09").option("--expire-at <ms>", "\u5230\u671F\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09\uFF0Cexpire-type=1 \u65F6\u586B\u5199", parseInt).option("--advertiser-id <magKey>", "\u53EF\u9009\uFF1A\u624B\u52A8\u6307\u5B9A\u5E7F\u544A\u4E3B\u7EC4 magKey\uFF08\u4E00\u822C\u65E0\u9700\u586B\u5199\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runOpenAccountKwai({
         token: opts.token,

package/dist/skill/AGENTS.md

@@ -14,48 +14,47 @@
 
 ## 文档域（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/`、`report-templates/` | JSON 契约、报告纲要 |
+| 域             | 路径                           | 何时 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/`、`report-templates/` | JSON 契约、报告纲要                                            |
 
 ## 工作流目录
 
-| 类别 | 文档 | 编号 |
-| --- | --- | --- |
-| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9 |
+| 类别          | 文档                           | 编号   |
+| ------------- | ------------------------------ | ------ |
+| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9  |
 | 操作 / 管理类 | `references/core/workflows.md` | W1–W12 |
 
 专用报告模板（被工作流卡片引用）：
 
-| ID | 文档 |
-| --- | --- |
-| 网站诊断 | `report-templates/website-diagnosis-report.md` |
-| 战略市场分析 | `report-templates/market-analysis-report.md` |
+| ID                | 文档                                                                      |
+| ----------------- | ------------------------------------------------------------------------- |
+| 网站诊断          | `report-templates/website-diagnosis-report.md`                            |
+| 战略市场分析      | `report-templates/market-analysis-report.md`                              |
 | Google 周期 Excel | `report-templates/google-period-report-excel.md`（P4，先 outline 后脚本） |
-| OKKI 周报 | `report-templates/okki-weekly-google-client.md` |
-| 询盘分析 | `report-templates/google-inquiry-analysis.md` |
+| OKKI 周报         | `report-templates/okki-weekly-google-client.md`                           |
+| 询盘分析          | `report-templates/google-inquiry-analysis.md`                             |
 
 ## 维护
 
-- 结构规范：`references/core/skill-authoring.md`
-- 人类深读：`docs/skill-guide.md`
 - 源码唯一真相：`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/website-diagnosis/` | analytics（网站诊断） |
-| `src/commands/market-analysis/` | analytics（战略市场分析） |
-| `src/commands/report/` | analytics + report-templates |
-| `src/commands/forewarning/`、`optimize/`、`clue.ts` | operations |
+| 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/website-diagnosis/`                                  | analytics（网站诊断）        |
+| `src/commands/market-analysis/`                                    | analytics（战略市场分析）    |
+| `src/commands/report/`                                             | analytics + report-templates |
+| `src/commands/forewarning/`、`optimize/`、`clue.ts`                | operations                   |

package/dist/skill/SKILL.md

@@ -20,17 +20,9 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 <!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}}；构建时由 gen-skill-docs.mjs 合并 -->
 
-> **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 路由表 Read「必读文档」与对应工作流卡片（`core/playbooks.md` P1–P9 或 `core/workflows.md` W1–W12）。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（见 `references/core/tips.md`）——**禁止**用 Read 工具打开 `writtenFiles` 里的完整 `*.json`。
+> **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
 >
-> **报告/Excel 交付前**：Read `references/core/deliverable-preflight.md`，**Read 最终产物**并按自检表确认币种与章节完整；币种只认当次 `list-accounts` 的 `currencyCode`。
->
-> **Google Excel（P4）**：Read `report-templates/google-period-report-excel.md`；`list-accounts -k` 核验用户 ID；拉数后**先读齐**各 `*.outline.txt` 再写脚本；禁止 `cat|head` 预览业务 JSON、禁止第三方 xlsx Skill、禁止猜字段名。
->
-> **HTML 终稿类报告（用户未指定格式时默认 HTML）**：网站诊断 P8（`website-diagnosis render`）、Meta 周期 P4-FB（`facebook-analysis render`）、战略市场 P9（`market-analysis render`）。Agent 只写 JSON，**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
->
-> **开户**：首次进入开户话题须先向用户罗列该媒体（或未指明媒体时六平台）**全部必填项**，见 `references/accounts/open-account-by-media.md` §「首次响应硬规范」。
->
-> **Subagent（可选）**：若宿主支持 Task / 子会话，复杂报告（P5/P6/P7）或长 CLI 输出前 Read `references/core/subagent-orchestration.md`，**自行决定**是否委派；写操作确认与对用户的最终交付留在主 Agent。
+> **默认交付格式**：用户未指定格式时，网站诊断 P8、Meta 周期 P4-FB、战略市场 P9 默认 **HTML**（各自 `render` 子命令），Google 周期 P4 默认 HTML；**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
 
 ---
 
@@ -71,11 +63,11 @@ siluzan-tso -h   # 查看帮助
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查：`-m <媒体> --page-size 999 --json-out`） |
-| 单户实时余额 | W1 | `accounts/accounts.md`（balance）+ `accounts/currency.md` |
-| 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan）+ `accounts/currency.md` |
-| 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats）+ `accounts/currency.md` |
-| 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest）+ `accounts/currency.md` |
+| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查） |
+| 单户实时余额 | W1 | `accounts/accounts.md`（balance） |
+| 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan） |
+| 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats） |
+| 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest） |
 | 激活/充值账单明细 | W1 | `accounts/accounts.md`（account-active-bills） |
 | 开户（六大媒体）/ 开户进度 | W2 | `accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `accounts/open-account-google-ui.md`） |
 | 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `accounts/accounts.md`（account 子命令） |
@@ -100,8 +92,8 @@ siluzan-tso -h   # 查看帮助
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` + `core/tips.md` + `core/deliverable-preflight.md` |
-| Google 账户周期报告 | **P4** | `report-templates/google-period-report.md` + `analytics/account-analytics.md` + `core/tips.md` + `core/deliverable-preflight.md`；要 **Excel** 加 `report-templates/google-period-report-excel.md`（先 outline 后脚本，禁止第三方 xlsx Skill） |
+| 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` |
+| Google 账户周期报告 | **P4** | `report-templates/google-period-report.md` + `analytics/account-analytics.md`；要 **Excel** 加 `report-templates/google-period-report-excel.md` |
 | Meta/Facebook 周期或诊断报告 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `analytics/facebook-analysis-guide.md`；要 Excel 加 `meta-period-report-excel.md` |
 | TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `report-templates/*-period-report.md` |
 | 多账户 × 多维度批处理 | **P5** | `analytics/google-analysis-batch.md` + `analytics/account-analytics.md` |
@@ -122,8 +114,6 @@ siluzan-tso -h   # 查看帮助
 | 日/周巡检 | W12 | `core/workflows.md`（W12）+ `accounts/accounts.md` |
 | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `operations/hosted-automation-user-catalog.md`（索引）→ `operations/hosted-automation-*.md` |
 
-> **数据/报告类任务通用纪律**：一律 `--json-out` 落盘 + **仅用脚本**读 JSON（见 `core/tips.md`）；交付前 Read 最终产物按 `core/deliverable-preflight.md` 自检（币种/章节）。
-
 ---
 
 ## Subagent 自主委派（可选）
@@ -142,10 +132,3 @@ siluzan-tso -h   # 查看帮助
 | references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行 |
 
 详见 `operations/hosted-automation-self-control.md`、`operations/hosted-automation-monitoring-json.md`、`operations/hosted-automation-optimize-index.md`。
-
----
-
-## 维护者
-
-- `references/core/skill-authoring.md` — 规范与检查清单
-- `docs/skill-guide.md` — 人类导读

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.5",
-  "publishedAt": 1781081318464
+  "version": "1.1.29-beta.7",
+  "publishedAt": 1781140799897
 }

package/dist/skill/references/README.md

@@ -1,81 +1,79 @@
 # References 索引
 
-> Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `core/playbooks.md`（P1–P9），操作/管理类在 `core/workflows.md`（W1–W12），命令参数在各域 reference。维护者见 `core/skill-authoring.md`。
+> Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `core/playbooks.md`（P1–P9），操作/管理类在 `core/workflows.md`（W1–W12），命令参数在各域 reference。
 
 ## 基础与纪律
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |
-| `core/agent-conventions.md` | **Agent 必读**：加载纪律、硬规范、数据转换、时间/币种/批量 |
-| `core/tips.md` | `--json-out` 协议、outline→脚本读 JSON |
-| `core/deliverable-preflight.md` | **交付前审阅最终产物**：Agent Read 报告文件并对照自检表（币种/章节） |
-| `core/playbooks.md` | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付） |
-| `core/workflows.md` | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式） |
-| `core/skill-authoring.md` | Skill 文档维护最佳实践（维护者） |
-| `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7） |
+| 文件                             | 用途                                                                                        |
+| -------------------------------- | ------------------------------------------------------------------------------------------- |
+| `core/setup.md`                  | 安装、登录（手机验证码优先）、配置、更新                                                    |
+| `core/agent-conventions.md`      | **Agent 必读 · 唯一规则真相源**：加载纪律、数据处理协议、硬规范、时间/币种/批量、交付前自检 |
+| `core/tips.md`                   | `--json-out` 脚本食谱（node -e 示例、文件命名、分页）                                       |
+| `core/playbooks.md`              | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付）                        |
+| `core/workflows.md`              | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式）                                          |
+| `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7）                                    |
 
 ## 账户与财务
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `accounts/accounts.md` | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
-| `accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |
-| `accounts/open-account-by-media.md` | 各媒体开户命令与参数 |
-| `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |
-| `accounts/finance.md` | 转账、开票、充值 |
-| `accounts/write-audit-restore.md` | 写审计、`--commit`、restore |
+| 文件                                 | 用途                                                             |
+| ------------------------------------ | ---------------------------------------------------------------- |
+| `accounts/accounts.md`               | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
+| `accounts/currency.md`               | CNY/USD 字段来源、符号、跨币种禁止求和                           |
+| `accounts/open-account-by-media.md`  | 各媒体开户命令与参数                                             |
+| `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程                                     |
+| `accounts/finance.md`                | 转账、开票、充值                                                 |
+| `accounts/write-audit-restore.md`    | 写审计、`--commit`、restore                                      |
 
 ## Google 广告
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `google-ads/google-ads.md` | Google Ads CRUD、batch、拒审字段 |
+| 文件                                     | 用途                                 |
+| ---------------------------------------- | ------------------------------------ |
+| `google-ads/google-ads.md`               | Google Ads CRUD、batch、拒审字段     |
 | `google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |
-| `google-ads/pmax-api.md` | PMax 网关路径、金额口径 |
-| `analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |
-| `google-ads/rules/README.md` | 优化/合规 SOP 索引 |
+| `google-ads/pmax-api.md`                 | PMax 网关路径、金额口径              |
+| `analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词       |
+| `google-ads/rules/README.md`             | 优化/合规 SOP 索引                   |
 
 ## 分析与报告
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
-| `analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |
-| `analytics/market-analysis-guide.md` | 战略市场分析 CLI、Agent 调研流程 |
-| `assets/market-analysis-rules.md` | 市场分析报告章节与 HTML 版式（Agent 必读） |
+| 文件                                   | 用途                                        |
+| -------------------------------------- | ------------------------------------------- |
+| `analytics/account-analytics.md`       | 拉数、数据时效性、诊断模板                  |
+| `analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent    |
+| `analytics/market-analysis-guide.md`   | 战略市场分析 CLI、Agent 调研流程            |
+| `assets/market-analysis-rules.md`      | 市场分析报告章节与 HTML 版式（Agent 必读）  |
 | `analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |
-| `analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |
-| `analytics/reporting.md` | TSO 优化报告生成与推送 |
-| `analytics/rag.md` | 知识库 list/query |
-| `analytics/geo-continents.json` | 国家→大洲映射（询盘分析） |
+| `analytics/google-analysis-batch.md`   | 多账户批处理 run/resume/status              |
+| `analytics/reporting.md`               | TSO 优化报告生成与推送                      |
+| `analytics/rag.md`                     | 知识库 list/query                           |
+| `analytics/geo-continents.json`        | 国家→大洲映射（询盘分析）                   |
 
 ## 运营工具
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `operations/optimize.md` | AI 优化建议记录 |
-| `operations/forewarning.md` | 智能预警 |
-| `operations/clue.md` | TikTok / Meta 线索表单 |
-| `operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |
-| `operations/hosted-automation-self-control.md` | 预算/CPA/空耗自控 SOP |
-| `operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名 |
-| `operations/hosted-automation-optimize-index.md` | 自动优化 SOP 索引 |
-| `operations/hosted-automation-scenarios.md` | 宿主编排场景索引 |
+| 文件                                              | 用途                   |
+| ------------------------------------------------- | ---------------------- |
+| `operations/optimize.md`                          | AI 优化建议记录        |
+| `operations/forewarning.md`                       | 智能预警               |
+| `operations/clue.md`                              | TikTok / Meta 线索表单 |
+| `operations/hosted-automation-user-catalog.md`    | 高阶自动化能力目录     |
+| `operations/hosted-automation-self-control.md`    | 预算/CPA/空耗自控 SOP  |
+| `operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名     |
+| `operations/hosted-automation-optimize-index.md`  | 自动优化 SOP 索引      |
+| `operations/hosted-automation-scenarios.md`       | 宿主编排场景索引       |
 
 ## Assets 模板（`../assets/`）
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `campaign-create-template.md` / `.json` | 搜索系列 batch 契约 |
-| `website-diagnosis-rules.md` | 网站诊断评分项与 JSON Schema |
-| `meta-period-report-rules.md` | Meta 周期报告内容丰富度与建议撰写规则 |
-| `meta-period-report.schema.json` | Meta 周期报告 Agent JSON Schema |
-| `pmax-create-template.md` / `.json` | PMax 新建契约 |
-| `pmax-asset-group-template.json` | PMax 素材组 |
-| `pmax-signals-template.json` | PMax 信号 |
-| `pmax-assets-update-template.json` | PMax 素材更新 |
-| `pmax-patch-campaign-template.json` | PMax 系列 patch |
+| 文件                                    | 用途                                  |
+| --------------------------------------- | ------------------------------------- |
+| `campaign-create-template.md` / `.json` | 搜索系列 batch 契约                   |
+| `website-diagnosis-rules.md`            | 网站诊断评分项与 JSON Schema          |
+| `meta-period-report-rules.md`           | Meta 周期报告内容丰富度与建议撰写规则 |
+| `meta-period-report.schema.json`        | Meta 周期报告 Agent JSON Schema       |
+| `pmax-create-template.md` / `.json`     | PMax 新建契约                         |
+| `pmax-asset-group-template.json`        | PMax 素材组                           |
+| `pmax-signals-template.json`            | PMax 信号                             |
+| `pmax-assets-update-template.json`      | PMax 素材更新                         |
+| `pmax-patch-campaign-template.json`     | PMax 系列 patch                       |
 
 ## 报告模板（`../report-templates/`）
 
@@ -83,10 +81,10 @@
 
 ## Handoff 模板（`../snippets/`，随 skill 安装）
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `handoff-p5-batch.md` | P5 batch 与按账户聚合 Task prompt |
-| `handoff-p6-okki.md` | P6 OKKI 拉数 / 写 xlsx |
-| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx |
+| 文件                    | 用途                              |
+| ----------------------- | --------------------------------- |
+| `handoff-p5-batch.md`   | P5 batch 与按账户聚合 Task prompt |
+| `handoff-p6-okki.md`    | P6 OKKI 拉数 / 写 xlsx            |
+| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx                |
 
 `agent-preamble.md` 仅用于构建时注入 `SKILL.md`，不复制到 `dist/skill/snippets/`。