siluzan-tso-cli 1.1.26-beta.1 → 1.1.26-beta.2

package/README.md

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

package/dist/index.js

@@ -4014,7 +4014,7 @@ var init_cli_json = __esm({
     CLI_SNAPSHOT_MANIFEST_FILE = "cli-manifest.json";
     CLI_PACKAGE = "siluzan-tso-cli";
     SCHEMA_VERSION = 1;
-    OUTLINE_AGENT_HINT = "\u5904\u7406\u987A\u5E8F\uFF1A\u5148\u8BFB outlineFile\uFF08schema \u63CF\u8FF0\uFF0C\u975E\u6570\u636E\uFF09\u4E86\u89E3\u5B57\u6BB5\u7C7B\u578B\uFF0C\u518D\u7528\u811A\u672C\u8BFB writtenFiles[0]\uFF08\u771F\u5B9E JSON \u6570\u636E\uFF09\u505A\u7B5B\u9009/\u805A\u5408\uFF1B\u4E0D\u8981\u628A outline \u5F53\u6210\u6570\u636E\uFF0C\u4E5F\u4E0D\u8981\u628A JSON \u5F53\u6210 schema\u3002";
+    OUTLINE_AGENT_HINT = "\u7981\u6B62\u7528 Read/cat \u6253\u5F00 writtenFiles \u4E2D\u7684\u5B8C\u6574\u4E1A\u52A1 *.json\u3002\u987A\u5E8F\uFF1A1) \u89E3\u6790\u672C\u884C stdout \u6458\u8981\uFF1B2) \u4EC5\u53EF\u8BFB outlineFile\uFF08*.outline.txt\uFF0Cschema\uFF09\uFF1B3) \u5FC5\u987B\u7528 node/python \u811A\u672C require/readFileSync \u8BFB JSON \u5E76\u6253\u5370\u6240\u9700\u5B57\u6BB5\u3002\u52FF\u628A JSON \u8D34\u8FDB\u5BF9\u8BDD\u3002";
     DEFAULT_FIELD_GUIDE = {
       markdownRefs: ["references/accounts/currency.md", "references/core/tips.md", "references/accounts/accounts.md"]
     };
@@ -120073,7 +120073,133 @@ init_auth();
 import * as fs9 from "fs";
 import * as path14 from "path";
 init_cli_json_snapshot();
-init_cli_table();
+
+// src/commands/open-account/bing-industry-dict.ts
+init_auth();
+var ORPHAN_PARENT_KEY = "__orphan__";
+function normalizeBingTradeReadList(readResponse) {
+  let raw = readResponse;
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+    const o = raw;
+    if ("value" in o && Array.isArray(o.value)) {
+      raw = o.value;
+    } else if ("data" in o) {
+      raw = o.data;
+      if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        const inner = raw;
+        if (Array.isArray(inner.data)) raw = inner.data;
+        else if (Array.isArray(inner.value)) raw = inner.value;
+      }
+    }
+  }
+  return Array.isArray(raw) ? raw : [];
+}
+function applyBingTradeTranslations(records, translationRows) {
+  for (const item of records) {
+    for (const row of translationRows) {
+      if (item.name == row.name) {
+        item.TranslationLanguage = row.value;
+        break;
+      }
+    }
+  }
+}
+function extractTradeListRecords(raw) {
+  if (Array.isArray(raw)) return raw;
+  if (!raw || typeof raw !== "object") return [];
+  const o = raw;
+  const data = o.data;
+  if (data && typeof data === "object" && !Array.isArray(data)) {
+    const records = data.records;
+    if (Array.isArray(records)) return records;
+  }
+  if (Array.isArray(o.records)) return o.records;
+  return [];
+}
+function buildBingIndustryOptions(records) {
+  const byId = new Map(records.map((r) => [String(r.id), r]));
+  const level2 = records.filter(
+    (r) => String(r.tradeLevel) === "2" || r.tradeLevel === 2
+  );
+  const byParent = /* @__PURE__ */ new Map();
+  for (const row of level2) {
+    const pid = row.parentId == null ? ORPHAN_PARENT_KEY : String(row.parentId);
+    if (!byParent.has(pid)) byParent.set(pid, []);
+    byParent.get(pid).push(row);
+  }
+  const cmpCode = (a, b) => String(a.code ?? "").localeCompare(String(b.code ?? ""), void 0, { numeric: true });
+  const groups = [];
+  for (const [parentKey, children] of byParent) {
+    const parent = parentKey === ORPHAN_PARENT_KEY ? null : byId.get(parentKey);
+    const label = parent?.TranslationLanguage || parent?.name || (parentKey === ORPHAN_PARENT_KEY ? "\u2014" : parentKey);
+    groups.push({
+      parentId: parentKey === ORPHAN_PARENT_KEY ? "" : parentKey,
+      label,
+      children: [...children].sort(cmpCode)
+    });
+  }
+  const emptyParent = { id: "", code: "" };
+  groups.sort((a, b) => {
+    const pa = a.parentId ? byId.get(a.parentId) : null;
+    const pb = b.parentId ? byId.get(b.parentId) : null;
+    return cmpCode(pa ?? emptyParent, pb ?? emptyParent);
+  });
+  const out = [];
+  for (const g of groups) {
+    for (const row of g.children) {
+      const id = String(row.id ?? "");
+      const label = String(row.TranslationLanguage || row.name || id);
+      out.push({
+        id,
+        label,
+        group: g.label,
+        name: String(row.name ?? "")
+      });
+    }
+  }
+  return out;
+}
+function filterBingIndustryOptions(options, keyword) {
+  const kw = keyword.trim().toLowerCase();
+  if (!kw) return options;
+  return options.filter((o) => {
+    const hay = `${o.id} ${o.label} ${o.group} ${o.name}`.toLowerCase();
+    return hay.includes(kw);
+  });
+}
+function resolveBingTradeIdForSubmit(tradeIdOrLabel, options) {
+  const raw = tradeIdOrLabel.trim();
+  if (!raw) return raw;
+  const byId = options.find((o) => o.id === raw);
+  if (byId) return byId.id;
+  const byLabel = options.find(
+    (o) => o.label === raw || o.name === raw || `${o.group}/${o.label}` === raw
+  );
+  if (byLabel) return byLabel.id;
+  return raw;
+}
+async function fetchBingIndustryOptions(config, verbose) {
+  const rawList = await apiFetch2(
+    `${config.apiBaseUrl}/BingV2Account/Management/TradeList`,
+    config,
+    { method: "POST", body: JSON.stringify({ page: 1, pageSize: 9999 }) },
+    verbose
+  );
+  const records = extractTradeListRecords(rawList).map((r) => ({
+    ...r,
+    id: String(r.id ?? "")
+  }));
+  const rawRead = await apiFetch2(
+    `${config.apiBaseUrl}/query/media-account/bing/BingTradeList/Read`,
+    config,
+    {},
+    verbose
+  );
+  applyBingTradeTranslations(records, normalizeBingTradeReadList(rawRead));
+  return buildBingIndustryOptions(records);
+}
+
+// src/commands/open-account/bing.ts
 async function uploadAttachment(filePath, apiBaseUrl, config, verbose) {
   const fileName = path14.basename(filePath);
   const fileBuffer = fs9.readFileSync(filePath);
@@ -120152,13 +120278,19 @@ async function runOpenAccountBing(opts) {
     opts.advertiserId
   );
   const accountCount = Math.min(Math.max(opts.accountCount ?? 1, 1), 6);
+  let tradeId = opts.tradeId;
+  try {
+    const industryOptions = await fetchBingIndustryOptions(config, opts.verbose);
+    tradeId = resolveBingTradeIdForSubmit(opts.tradeId, industryOptions);
+  } catch {
+  }
   const body = {
     mediaAccountGroupId: magKey,
     accountCount,
     bingCustomerInfo: {
       name: opts.advertiserName,
       province: opts.province,
-      tradeId: opts.tradeId,
+      tradeId,
       nameShort: opts.nameShort,
       postcode: opts.postcode ?? "",
       city: opts.city,
@@ -120178,7 +120310,7 @@ async function runOpenAccountBing(opts) {
       companyName: opts.advertiserName,
       postcode: opts.postcode ?? "",
       province: opts.province,
-      tradeId: opts.tradeId,
+      tradeId,
       nameShort: opts.nameShort,
       fileId,
       fileName,
@@ -120207,13 +120339,7 @@ async function runOpenAccountBingIndustries(opts) {
   const config = loadConfig(opts.token);
   let list;
   try {
-    const raw = await apiFetch2(
-      `${config.apiBaseUrl}/query/media-account/bing/BingTradeList/Read`,
-      config,
-      {},
-      opts.verbose
-    );
-    list = Array.isArray(raw) ? raw : raw.value ?? [];
+    list = await fetchBingIndustryOptions(config, opts.verbose);
   } catch (err) {
     console.error(
       `
@@ -120222,10 +120348,7 @@ async function runOpenAccountBingIndustries(opts) {
     );
     process.exit(1);
   }
-  const kw = (opts.keyword ?? "").trim().toLowerCase();
-  if (kw) {
-    list = list.filter((r) => r.name.toLowerCase().includes(kw));
-  }
+  list = filterBingIndustryOptions(list, opts.keyword ?? "");
   const n = list.length;
   const bingIndPayload = wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: list });
   if (await emitCliJsonOrSnapshot(opts, {
@@ -120237,17 +120360,21 @@ async function runOpenAccountBingIndustries(opts) {
   }
   console.log(
     `
-BingV2 \u884C\u4E1A\u5217\u8868\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${list.length} \u6761\uFF0C\u5171 ${list.length} \u6761\uFF0C\u5C06 name \u503C\u4F20\u7ED9 --trade-id\uFF09
+BingV2 \u884C\u4E1A\u5217\u8868\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${list.length} \u6761\uFF0C\u5171 ${list.length} \u6761\uFF0C--trade-id \u4F20 id \u5217\uFF0C\u4E0E\u7F51\u9875\u4E0B\u62C9\u4E00\u81F4\uFF09
 `
   );
   if (list.length === 0) {
-    console.log("  \u65E0\u6570\u636E\u3002\n");
+    console.log("  \u65E0\u6570\u636E\u3002\u53EF\u53BB\u6389 --keyword \u67E5\u770B\u5168\u91CF\uFF0C\u6216\u6362\u66F4\u77ED\u7684\u4E2D\u6587\u5173\u952E\u8BCD\u3002\n");
     return;
   }
-  printCliTable(
-    list.map((r) => ({ name: r.name })),
-    [{ key: "name", header: "\u884C\u4E1A\u540D\u79F0\uFF08--trade-id\uFF09" }]
-  );
+  let lastGroup = "";
+  for (const row of list) {
+    if (row.group !== lastGroup) {
+      console.log(`  \u25B8 ${row.group}`);
+      lastGroup = row.group;
+    }
+    console.log(`      ${row.label}  (id: ${row.id})`);
+  }
   console.log();
 }
 
@@ -121106,7 +121233,7 @@ function register24(program2) {
       });
     }
   );
-  openAccountCmd.command("bing").description("\u63D0\u4EA4 Bing/BingV2 \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("--pattern <Direct|Agency>", "\u76F4\u63A5/\u4EE3\u7406\uFF1ADirect\uFF08\u76F4\u63A5\uFF09\u6216 Agency\uFF08\u4EE3\u7406\uFF09").requiredOption("--advertiser-name <name>", "\u516C\u53F8\u540D\u79F0\uFF08\u5E7F\u544A\u4E3B\u5168\u79F0\uFF0C\u7528\u4E8E\u5339\u914D\u6216\u521B\u5EFA\u5E7F\u544A\u4E3B\u7EC4\uFF09").requiredOption("--name-short <short>", "\u516C\u53F8\u7B80\u79F0").requiredOption("--name-remark-list <name>", "\u5F00\u6237\u540D\u79F0\uFF08\u8D26\u6237\u663E\u793A\u540D\uFF09").requiredOption("--province <province>", "\u516C\u53F8\u6240\u5728\u7701\u4EFD").requiredOption("--city <city>", "\u516C\u53F8\u6240\u5728\u57CE\u5E02").requiredOption("--address <address>", "\u516C\u53F8\u8BE6\u7EC6\u5730\u5740").requiredOption("--postcode <code>", "\u516C\u53F8\u6240\u5728\u5730\u90AE\u7F16").requiredOption("--trade-id <name>", "\u884C\u4E1A\uFF08\u6765\u81EA open-account bing-industries \u7684 name \u5B57\u6BB5\uFF09").requiredOption("--promotion-link <url>", "\u5F00\u6237\u7F51\u5740\uFF08\u63A8\u5E7F\u94FE\u63A5\uFF09").requiredOption("--license-file <path>", "\u8425\u4E1A\u6267\u7167\u56FE\u7247\u672C\u5730\u8DEF\u5F84\uFF08JPG/PNG/PDF\uFF09").option("--account-count <n>", "\u5F00\u6237\u6570\u91CF\uFF081~6\uFF0C\u9ED8\u8BA4 1\uFF09", parseInt).option("--advertiser-cid <cid>", "\u7ECF\u7406\u8D26\u53F7 ID\uFF08\u53EF\u9009\uFF09").option("--advertiser-name2 <name>", "\u7ECF\u7406\u8D26\u53F7\u540D\u79F0\uFF08\u53EF\u9009\uFF0C\u4E0E --advertiser-cid \u914D\u5BF9\uFF09").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("bing").description("\u63D0\u4EA4 Bing/BingV2 \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("--pattern <Direct|Agency>", "\u76F4\u63A5/\u4EE3\u7406\uFF1ADirect\uFF08\u76F4\u63A5\uFF09\u6216 Agency\uFF08\u4EE3\u7406\uFF09").requiredOption("--advertiser-name <name>", "\u516C\u53F8\u540D\u79F0\uFF08\u5E7F\u544A\u4E3B\u5168\u79F0\uFF0C\u7528\u4E8E\u5339\u914D\u6216\u521B\u5EFA\u5E7F\u544A\u4E3B\u7EC4\uFF09").requiredOption("--name-short <short>", "\u516C\u53F8\u7B80\u79F0").requiredOption("--name-remark-list <name>", "\u5F00\u6237\u540D\u79F0\uFF08\u8D26\u6237\u663E\u793A\u540D\uFF09").requiredOption("--province <province>", "\u516C\u53F8\u6240\u5728\u7701\u4EFD").requiredOption("--city <city>", "\u516C\u53F8\u6240\u5728\u57CE\u5E02").requiredOption("--address <address>", "\u516C\u53F8\u8BE6\u7EC6\u5730\u5740").requiredOption("--postcode <code>", "\u516C\u53F8\u6240\u5728\u5730\u90AE\u7F16").requiredOption("--trade-id <id>", "\u884C\u4E1A tradeId\uFF08\u6765\u81EA open-account bing-industries \u7684 id\uFF0C\u4E0E\u7F51\u9875\u4E0B\u62C9 value \u4E00\u81F4\uFF09").requiredOption("--promotion-link <url>", "\u5F00\u6237\u7F51\u5740\uFF08\u63A8\u5E7F\u94FE\u63A5\uFF09").requiredOption("--license-file <path>", "\u8425\u4E1A\u6267\u7167\u56FE\u7247\u672C\u5730\u8DEF\u5F84\uFF08JPG/PNG/PDF\uFF09").option("--account-count <n>", "\u5F00\u6237\u6570\u91CF\uFF081~6\uFF0C\u9ED8\u8BA4 1\uFF09", parseInt).option("--advertiser-cid <cid>", "\u7ECF\u7406\u8D26\u53F7 ID\uFF08\u53EF\u9009\uFF09").option("--advertiser-name2 <name>", "\u7ECF\u7406\u8D26\u53F7\u540D\u79F0\uFF08\u53EF\u9009\uFF0C\u4E0E --advertiser-cid \u914D\u5BF9\uFF09").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 runOpenAccountBing({
         token: opts.token,
@@ -121171,7 +121298,7 @@ function register24(program2) {
       });
     }
   );
-  openAccountCmd.command("bing-industries").description("\u5217\u51FA BingV2 \u884C\u4E1A\u5206\u7C7B\uFF08\u5C06 name \u503C\u4F20\u7ED9 open-account bing \u7684 --trade-id\uFF09").option("-k, --keyword <text>", "\u6309\u4E2D\u6587\u540D\u6216\u82F1\u6587\u540D\u8FC7\u6EE4").option(
+  openAccountCmd.command("bing-industries").description("\u5217\u51FA BingV2 \u884C\u4E1A\u5206\u7C7B\uFF08\u4E0E\u7F51\u9875\u540C\u6E90\uFF1B\u5C06 id \u4F20\u7ED9 open-account bing \u7684 --trade-id\uFF09").option("-k, --keyword <text>", "\u6309\u4E2D\u6587\u884C\u4E1A\u540D\u3001\u5206\u7EC4\u540D\u3001\u82F1\u6587 name \u6216 id \u8FC7\u6EE4").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

package/dist/skill/SKILL.md

@@ -15,7 +15,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 域文档。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + 脚本读盘（见 `references/core/tips.md`）。
+> **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 任务表 Read 域文档。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（见 `references/core/tips.md`）——**禁止**用 Read 工具打开 `writtenFiles` 里的完整 `*.json`。
+>
+> **报告/Excel 交付前**：Read `references/core/deliverable-preflight.md`，运行 `node scripts/check-deliverable-snap.mjs <snapDir>`；币种只认 `currencyCode`，禁止默认 Google=美金。
 >
 > **开户**：首次进入开户话题须先向用户罗列该媒体（或未指明媒体时六平台）**全部必填项**，见 `references/accounts/open-account-by-media.md` §「首次响应硬规范」。
 >
@@ -70,7 +72,7 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 宿主具备 **Task / subagent**（或内置 Bash/Explore）时：
 
 1. **复杂报告或批处理**（P5 / P6 OKKI / P7 询盘）、预计 CLI 输出很长 → 先 Read `references/core/subagent-orchestration.md`，按**决策矩阵**选择主会话或子会话。
-2. Handoff 模板在 skill 根目录 `snippets/handoff-p{5,6,7}-*.md`；子会话只回传 manifest/exitCode 摘要，**禁止**把 MB 级 JSON 贴回主对话。
+2. Handoff 模板在 skill 根目录 `snippets/handoff-p{5,6,7}-*.md`；子会话只回传 manifest/exitCode 摘要，**禁止** Read 落盘业务 JSON、**禁止**把 MB 级 JSON 贴回主对话（须脚本读盘后只回传脚本输出）。
 3. **无 subagent 能力** → 跳过本节，按 `core/playbooks.md` 在主会话执行。
 
 写操作、`--commit`、401/batch `resume` 策略由**主 Agent**负责，不默认下放子会话。
@@ -83,7 +85,7 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | ------------------ | ----------------------------- |
 | 任意任务（首次） | `core/agent-conventions.md` |
 | 账户列表 / 余额 / 消耗 / 分享 / MCC / 多账户汇总 | `accounts/accounts.md`；金额加 `accounts/currency.md` |
-| 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md`；多账户加 `analytics/google-analysis-batch.md` |
+| 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md` + **`core/deliverable-preflight.md`**；多账户加 `analytics/google-analysis-batch.md` |
 | Meta/Facebook 周期或诊断报告 / `facebook-analysis` | `analytics/facebook-analysis-guide.md` + `report-templates/meta-period-report.md`（或 `meta-account-diagnosis-report.md`）+ `core/playbooks.md` P4-FB |
 | 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `report-templates/website-diagnosis-report.md`（**终稿 HTML**）+ `core/playbooks.md` P8 |
 | Google 新建搜索系列 | `google-ads/google-ads-campaign-plan.md` |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.26-beta.1",
-  "publishedAt": 1780483757520
+  "version": "1.1.26-beta.2",
+  "publishedAt": 1780539987793
 }

package/dist/skill/references/README.md

@@ -8,7 +8,8 @@
 | ---- | ---- |
 | `core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |
 | `core/agent-conventions.md` | **Agent 必读**：加载纪律、硬规范、数据转换、时间/币种/批量 |
-| `core/tips.md` | `--json-out` 协议、outline→JSON 处理顺序 |
+| `core/tips.md` | `--json-out` 协议、outline→脚本读 JSON |
+| `core/deliverable-preflight.md` | **交付前自检**：币种 + manifest 完整性；`scripts/check-deliverable-snap.mjs` |
 | `core/playbooks.md` | P1–P7 高频任务标准动作 |
 | `core/workflows.md` | 多命令串联业务流程 |
 | `core/skill-authoring.md` | Skill 文档维护最佳实践（维护者） |

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

@@ -517,7 +517,7 @@ siluzan-tso open-account yandex \
 ### Bing/BingV2 开户（需要营业执照图片）
 
 ```bash
-# 前置：查询 Bing 行业名称（--trade-id 传返回的 name 字段值）
+# 前置：查询 Bing 行业（--trade-id 传 bing-industries 输出的 id，与网页下拉 value 一致）
 siluzan-tso open-account bing-industries --keyword "科技"
 
 siluzan-tso open-account bing \
@@ -530,7 +530,7 @@ siluzan-tso open-account bing \
   --address "南山区科技园XX路XX号XX大厦" \
   --postcode "518000" \
   --promotion-link "https://www.brand-a.com" \
-  --trade-id "IT/消费电子-其他" \
+  --trade-id "<bing-industries 输出的 id>" \
   --license-file "/path/to/license.jpg"
 ```
 

package/dist/skill/references/accounts/open-account-by-media.md

@@ -84,7 +84,7 @@
 | 城市 | `--city` | |
 | 详细地址 | `--address` | |
 | 邮编 | `--postcode` | |
-| 行业 | `--trade-id` | `bing-industries` 返回的 **name** 字段 |
+| 行业 | `--trade-id` | 先 `bing-industries`；传输出 **id**（与网页下拉 value 一致），勿猜中文名 |
 | 推广链接 | `--promotion-link` | |
 | 执照图片 | `--license-file` | JPG/PNG/PDF 本地路径 |
 
@@ -199,6 +199,8 @@ siluzan-tso account-history -m Yandex
 
 **必填**：见上表 § BingV2。
 
+> **行业（Agent 硬规范）**：与网页一致，数据源为 `TradeList` + `BingTradeList/Read` 合并后的**二级**选项。必须先执行 `open-account bing-industries`（`--keyword` 可匹配中文行业名、分组名、英文 name 或 id），从输出取 **`id`** 填入 `--trade-id`。**禁止**凭记忆写行业名或编造「一级/二级」拼接字符串。
+
 ```bash
 siluzan-tso open-account bing-industries --keyword "科技"
 
@@ -212,7 +214,7 @@ siluzan-tso open-account bing \
   --address "南山区科技园XX路XX号" \
   --postcode "518000" \
   --promotion-link "https://www.brand-a.com" \
-  --trade-id "IT/消费电子-其他" \
+  --trade-id "<bing-industries 输出的 id>" \
   --license-file "/path/to/license.jpg"
 
 siluzan-tso account-history -m BingV2

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

@@ -32,8 +32,8 @@
 1. **先确认统计区间**：用户未给明确起止日期时**必须反问**（参见 SKILL.md 时间范围强制反问）。
 2. 确定报告维度（默认含：执行摘要、每日趋势、月度汇总、系列表现、设备分布、地域分布、关键词表现、优化建议），详见 `report-templates/README.md`。若用户使用 **「使用 okki 周报模板…」「OKKI 周报」** 等固定话术发客户，改走 **`report-templates/okki-weekly-google-client.md`**（与 SKILL **P6** 一致），不再按 `google-period-report.md` 的默认 8 维追问。
 3. **拉数**：使用 `google-analysis … --json-out <dir>`（Google）或对应 `report <media>-*` 命令落盘。
-4. **编写并执行代码**从磁盘读取 `manifest-<accountId>.json` 与各 `<section>-<accountId>.json` 来完成筛选、聚合、排序等计算；**禁止**用 `Read` 看 JSON 后在对话里心算或手填报告数字。
-   - **写脚本前先读 `<section>-<accountId>.outline.txt`**（与 JSON 同 stem 的纯文本，最后一行是 TS 式类型字面量）了解字段结构；它体积只有几百字节、不含数据，比直接 `Read` 整个 `*.json`（动辄几 MB / 几万行）省**两到三个数量级**的上下文，不要 `require()`，用 `fs.readFileSync(outlineFile,'utf8')` 读最后一行即可。
+4. **编写并执行代码**从磁盘读取 `manifest-<accountId>.json` 与各 `<section>-<accountId>.json` 来完成筛选、聚合、排序等计算；**禁止**用宿主 `Read` 打开业务 `*.json`；**禁止**在对话里心算或手填报告数字。
+   - **写脚本前**用 Read 仅打开 `<section>-<accountId>.outline.txt`（或 `node -e` 读最后一行类型字面量）了解字段结构；**业务 JSON 只许在脚本里** `require` / `readFileSync`，脚本 `console.log` 打印所需汇总。
    - 真实数据始终从 `<section>-<accountId>.json` 通过代码获取，**不要**把 outline 当作业务数据贴给用户。
 5. **由代码写出最终文件**（HTML/Excel/PDF/PPT/Markdown/word 等）。**禁止**在报告脚本中以源码字面量写死应从 JSON 读取的业务数据（消耗金额、系列名、日期区间等）。允许的常量仅限：快照目录路径、JSON 字段键名、版式/结构占位。
 6. **报告首行**须标注：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`

package/dist/skill/references/core/agent-conventions.md

@@ -24,7 +24,8 @@
 
 - **禁止**「上次已经读过 `accounts/accounts.md` / `google-ads/google-ads.md`，本任务直接 `siluzan-tso …`」
 - **禁止**用对话记忆中的示例 ID、金额、命令 flags 代替当次 Read 文档
-- **禁止**跳过 `references/core/tips.md` 里的 outline→JSON 顺序
+- **禁止**跳过 `references/core/tips.md` 里的 outline→脚本读 JSON 顺序
+- **禁止**用 Read / `cat` / `type` 打开 `--json-out` 落盘的**业务数据** `*.json`（`campaigns-*.json`、`list-accounts-*.json` 等）；只允许 Read 体积小的 `*.outline.txt` 与 `references/` 文档
 
 ---
 
@@ -36,7 +37,8 @@
 2. 涉及写入/修改/删除的操作必须与用户确认
 3. 按计划执行，说明每步意图
 4. 用成对的读命令复核写入结果；异步任务每 5s 轮询直到完成
-5. 全部完成后预测用户下一步操作
+5. **交付前**（报告/Excel/含金额话术）：Read `references/core/deliverable-preflight.md`，运行 `node scripts/check-deliverable-snap.mjs`；币种须来自 `list-accounts` / `overview` 的 `currencyCode`
+6. 全部完成后预测用户下一步操作
 
 ### 执行模式速查
 
@@ -77,15 +79,27 @@
 
 本 Skill 下**所有**业务数据均以 CLI `--json-out`（或用户提供的同构 JSON）落盘为唯一真相源。Agent **不得**在对话或脚本里「代替」磁盘数据。
 
+### 禁止 Read 完整业务 JSON（最高优先级）
+
+`--json-out` 落盘的 `writtenFiles[0]`（及同目录 `campaigns-*.json`、`keywords-*.json` 等）往往为 **MB 级**。Agent **永远不得**用宿主 **Read** 工具、`cat`、`type`、`Get-Content` 等方式把整文件读进对话上下文。
+
+| 允许 Read 的文件 | 必须用代码读取的文件 |
+| ---------------- | -------------------- |
+| `references/**/*.md`、`assets/**/*.md`（Skill 文档） | 所有 `--json-out` 业务 `*.json` |
+| 当次 `*.outline.txt`（通常小于 2KB，仅 schema） | `cli-manifest*.json` / `manifest-*.json` 中的路径索引（应用脚本 `JSON.parse` 读，勿 Read 整份 manifest 若很大） |
+| stdout **一行**摘要 JSON（命令回显，体积小） | 用户提供的同构大 JSON 文件 |
+
+**正确流程**：解析 stdout 摘要 → Read **仅** `outlineFile` 了解字段类型 → **编写并执行** `node -e` / `node script.mjs` / `python`：`require` 或 `readFileSync` 读 JSON → `console.log` / 写 xlsx/html **只输出所需字段** → 用脚本打印结果回答用户。
+
 | 必须 | 禁止 |
 | ---- | ---- |
-| 编写并**执行** Node/Python 脚本：`readFile` / `require` 读落盘 JSON → 计算 → 写出 | 用 `Read` 读大 JSON 后在回复里手填、改数、心算汇总 |
-| **先 outline 后 JSON**：`outlineFile`（`.outline.txt`）→ `writtenFiles[0]` | 跳过 outline 猜字段名；把 outline 当数据贴给用户 |
+| 编写并**执行** Node/Python 脚本读落盘 JSON → 计算 → 写出 | 用 **Read** 打开 `writtenFiles` 业务 JSON；在回复里手填、改数、心算汇总 |
+| **先 outline 后脚本读 JSON**：`outlineFile` → 代码读 `writtenFiles[0]` | 跳过 outline 猜字段名；把 outline 当数据贴给用户 |
 | 字段路径以 `outlineFile` + 当次 `writtenFiles` / manifest 为准 | 把国家名、ID、金额、词表等**业务值**写成源码字面量 |
 | 映射表 / 模板契约在运行时加载（`analytics/geo-continents.json`、`campaign-create-template.json`） | 复制配置条目进源码常量 |
 | 脚本输出与落盘 JSON 可复核 | 用「上次对话记住的数」「占位数」写入交付物 |
 
-**允许的字面量**：输出目录、Sheet/列标题、技术格式、`focusCountries` 等**用户当轮明确给出**的配置（建议落盘为 `config.json` 再读）。
+**允许的字面量**：输出目录、Sheet/列标题、技术格式、`focusCountries` 等**用户当轮明确给出**的配置（建议落盘为 `config.json` 再**用脚本**读）。
 
 完整协议见 `references/core/tips.md` § 处理顺序、§ 已有 JSON 时。
 
@@ -122,6 +136,7 @@
 - **符号**：`CNY` → **￥**；`USD` → **$**。多账户按 `currencyCode` 分表，**禁止**跨币种求和。
 - **金额单位统一为「元」**：报告保留 2 位小数。
 - **Google 广告诊断报告**：`report-templates/google-ads-diagnosis.md` § 撰写硬约束 — 每日趋势金额/CPA 必须 2 位小数；每个模块除表格外须有「分析」+「建议」，禁止只贴数据。
+- **交付前自检**：报告/Excel 交付前运行 `scripts/check-deliverable-snap.mjs`（见 `deliverable-preflight.md`）；自检失败禁止交付。
 - **品牌名优先级**：(1) 用户明确提供 → (2) `list-accounts.mag.advertiserName` → (3) 网址域名占位 `[待确认品牌名]`。**严禁**把英文域名翻译为虚构中文品牌。
 
 ---

package/dist/skill/references/core/deliverable-preflight.md

@@ -0,0 +1,107 @@
+# 交付前自检（币种 + 数据完整）
+
+> 用户反馈 Agent 产出物常见两类问题：**币种错误**（Google 默认美金、符号混用）、**报告缺章/缺数**（少拉维度、Read JSON 截断后手填）。本节给出**可执行**防线。
+
+---
+
+## 根因（简要）
+
+| 问题 | 典型原因 |
+| ---- | -------- |
+| 币种错误 | 未先 `list-accounts` 读 `currencyCode`；报告脚本写死 `USD`；CNY 用 `$` |
+| 数据缺失 | 未按模板拉全 `--sections`；未读 `manifest` 就写报告；Read 大 JSON 截断后编造；多账户漏 ID |
+
+---
+
+## 强制流程（报告/Excel 交付前）
+
+与 `references/core/agent-conventions.md`「计划 → 确认 → 执行 → **验证**」一致，**交付前增加验证步**：
+
+### 1. 币种（第一步就做）
+
+```bash
+siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap
+node -e "
+const d=require('./snap/list-accounts-google.json');
+const ma=(d.items||[]).map(x=>x.ma||x).find(m=>String(m.mediaCustomerId)===process.argv[1]);
+if(!ma){console.error('账户未找到');process.exit(1);}
+console.log(ma.currencyCode, ma.mediaCustomerName);
+" <mediaCustomerId>
+```
+
+- 将输出的 **`currencyCode`** 写入报告生成脚本（从 JSON 读，勿写死）。
+- 首行必须有：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：CNY|USD）`。
+- 符号：**CNY → ￥**，**USD → $**。详见 `references/accounts/currency.md`。
+
+### 2. 拉数完整（对照模板 + manifest）
+
+- 周期报告：按 `report-templates/google-period-report.md` 默认 7 维（或用户追加维）一次 `google-analysis --sections … --json-out`。
+- 拉数后打开 **`manifest-<accountId>.json`**（用脚本 `JSON.parse`，勿 Read 整份若很大），核对 `artifacts[].section` 与模板一致。
+
+### 3. 写报告只用脚本读 JSON
+
+见 `references/core/tips.md`：**禁止** Read 业务 `*.json`；用 `node`/Python 聚合后写 HTML/xlsx。
+
+### 4. 交付前运行自检脚本（必做）
+
+Skill 自带脚本（安装后在 skill 根目录）：
+
+```bash
+node scripts/check-deliverable-snap.mjs ./snap --preset p4-google
+# 或自定义：--required overview,campaigns,geographic
+# 已知账户为 CNY 时：--expect-currency CNY
+```
+
+| 参数 | 说明 |
+| ---- | ---- |
+| `<snapDir>` | `--json-out` 目录 |
+| `--preset p4-google` | 对齐 Google 周期报告默认 7 维 |
+| `--preset p1-google` | 单账户画像：list-accounts + stats + ad-campaigns |
+| `--required a,b` | 额外必填 section（逗号分隔，前缀匹配） |
+| `--expect-currency CNY\|USD` | 与 `list-accounts` / `overview` 中 `currencyCode` 对照 |
+
+**退出码 1** → 补拉缺失维度或修币种后再交付。**禁止**在自检失败时仍把报告发给用户。
+
+### 5. 报告正文抽检（脚本输出对照）
+
+交付前用脚本打印 3 个汇总（示例）：
+
+```bash
+node -e "
+const o=require('./snap/overview-<id>_<start>-<end>.json');
+const r=o.record||{};
+const p=r.currentPeriod||{};
+console.log('spend',p.spend,'clicks',p.clicks,'currency',r.currencyCode);
+"
+```
+
+报告中的总消耗、币种须与上述一致（允许四舍五入，**不允许数量级或币种错误**）。
+
+---
+
+## Playbook 挂钩
+
+| Playbook | 自检命令 |
+| -------- | -------- |
+| P1 | `--preset p1-google` + `--expect-currency`（来自 list-accounts） |
+| P4 | `--preset p4-google` |
+| P6 / P7 | 按 `okki-weekly-google-client.md` / `google-inquiry-analysis.md` 自建 `--required`（含各月 `campaigns`、`geographic` 等） |
+
+---
+
+## 长期改进（可选）
+
+| 手段 | 说明 |
+| ---- | ---- |
+| **skill-eval 场景** | 断言 Agent 先 `list-accounts` 且报告含 `（货币：XXX）` |
+| **CLI `snap check`** | 将本脚本收编为 `siluzan-tso snap check`（待开发） |
+| **报告模板内嵌币种占位** | 脚本写 `{currencyCode}` 而非手写符号 |
+
+---
+
+## 相关文档
+
+- `references/accounts/currency.md`
+- `report-templates/REPORT-WORKFLOW.md` § 步骤 4–5
+- `references/core/tips.md`
+- `references/core/playbooks.md`

package/dist/skill/references/core/playbooks.md

@@ -4,10 +4,10 @@
 
 | 编号 | 场景 | 必读 references |
 | ---- | ---- | --------------- |
-| P1 | 单账户投放画像 | `analytics/account-analytics.md`、`accounts/currency.md`、`core/tips.md` |
+| P1 | 单账户投放画像 | `analytics/account-analytics.md`、`accounts/currency.md`、`core/tips.md`、`core/deliverable-preflight.md` |
 | P2 | 多账户余额扫描 | `accounts/accounts.md`（`balance-scan`）、`accounts/currency.md` |
 | P3 | 多账户投放画像汇总 | `accounts/accounts.md` § accounts-digest、`accounts/currency.md`、`core/tips.md` |
-| P4 | Google 账户周期报告 | `report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md` |
+| P4 | Google 账户周期报告 | `report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md`、`core/deliverable-preflight.md` |
 | P4-FB | Meta/Facebook 周期报告 | `report-templates/meta-period-report.md`、`analytics/facebook-analysis-guide.md`、`analytics/account-analytics.md`、`core/tips.md` |
 | P5 | 多账户多维度报告 | `analytics/google-analysis-batch.md`、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
 | P6 | OKKI 周报 | `report-templates/okki-weekly-google-client.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
@@ -24,6 +24,7 @@
 4. `ad campaigns -a <mediaCustomerId> --start <S> --end <D> --json-out ./snap-p1`
 5. 诊断/画像报告：Read `report-templates/google-ads-diagnosis.md`（**硬约束：每日趋势 2 位小数、每模块必有分析**）+ `google-account-diagnosis-report.md`（章节与 CLI）；`google-analysis --json-out` 须含 `daily-metrics`（按日趋势）。
 6. 首行标注统计区间和货币；HTML 可对齐 `report-template.html` + `section-*` 区块。
+7. 交付前：`node scripts/check-deliverable-snap.mjs ./snap-p1 --preset p1-google --expect-currency <来自 list-accounts>`。
 
 ---
 
@@ -66,6 +67,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 1. 确认时间范围；区间 > 3 个月时分段（季度/月）。
 2. 按 `google-period-report.md` 默认维度执行 `google-analysis --json-out <dir>`。
 3. 报告须含：账户概览、投放趋势、Top 关键词/系列/地区分布、优化建议。
+4. 交付前：`node scripts/check-deliverable-snap.mjs <dir> --preset p4-google --expect-currency <currencyCode>`。
 
 ---
 

package/dist/skill/references/core/subagent-orchestration.md

@@ -58,7 +58,7 @@
 | `mediaCustomerId` | 来自当次 `list-accounts`，禁止猜 |
 | `dateRange` | `start` / `end`（YYYY-MM-DD）；P7 另附 `m1`/`m2`/`m3` |
 | `commands[]` | 可复制 bash 块（来自 playbook 或 report-template） |
-| `forbidden[]` | 至少包含：禁止 Read 全量 MB JSON 进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
+| `forbidden[]` | 至少包含：禁止 Read/cat 打开落盘业务 `*.json`（须 node/python 脚本读盘）；禁止把 JSON 贴进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
 | `returnSchema` | 子会话**只**回传下列内容 |
 
 ### returnSchema（子会话结束时的回复格式）

package/dist/skill/references/core/tips.md

@@ -2,7 +2,7 @@
 
 > **文档重读（与落盘无关，但同样硬）**：**每个新的用户任务**或**同对话内换话题**时，须按 `references/core/agent-conventions.md` § 文档加载纪律 **重新 Read** 当次任务对应的 `references/*.md` / `report-templates/*.md`，再执行 CLI。
 
-> **AI 助手（本 Skill）**：凡需结构化数据，一律使用 **`--json-out <路径>`**（**目录** 或 **`*.json` 具体文件**）将 JSON 写入磁盘（并更新 **`cli-manifest[-<查询id>].json`**，与 `google-analysis` 的 **`manifest-<accountId>.json`**、`report …` 的 **`report-manifest[-<accountId>].json`** 并存于各自目录），再用 **脚本读文件**（`fs.readFileSync` / `require`）做筛选与聚合；**不要**依赖对话里粘贴的 stdout 整包 JSON。命令成功时 **stdout 仅一行摘要 JSON**（体积小），其中 **`outlineFile`** 指向与当次 `*.json` **同 stem** 的 **`*.outline.txt`**（纯文本单行，接近 **TypeScript 类型字面量**：`{ a: number; b: string }`、`(T | U)[]` 等；数组由**前 8 项**去重推断并集；环 / 同对象再出现为 `any`）。完整数据仍以落盘 `*.json` 为准，类型扫一眼读 outline 文件即可。
+> **AI 助手（本 Skill）**：凡需结构化数据，一律 **`--json-out <路径>`** 落盘，再用 **Node/Python 脚本**（`require` / `readFileSync`）读 JSON 做筛选与聚合。**禁止**用宿主 **Read** 工具打开落盘业务 `*.json`（会占满上下文且易截断）。命令成功时 **stdout 仅一行摘要 JSON**（体积小）；**`outlineFile`**（`*.outline.txt`，通常小于 2KB）是唯一允许用 Read 查看的「数据结构」文件——最后一行是 TS 类型字面量。业务数据**只**通过脚本访问，脚本 stdout 打印你需要的行/汇总即可。
 >
 > **文件命名规则（重要）**：当一条命令具备明确的"查询 id"（mediaCustomerId / entityId / ruleId / auditId 等）时，目录模式落盘的 `*.json`、`*.outline.txt` 与对应 manifest **都会带上 `-<查询id>` 后缀**：
 >
@@ -21,23 +21,26 @@
 
 ---
 
-## 处理顺序（**Agent 必读**）：先 outline → 再 JSON → 再脚本聚合
+## 处理顺序（**Agent 必读**）：摘要 → outline（schema）→ **脚本**读 JSON
 
 每条 `--json-out` 命令成功后，**必须**按以下顺序处理，不要跳步、不要把 outline 当数据：
 
-1. **先读 stdout 一行摘要 JSON**：拿到 `outlineFile`、`writtenFiles[0]`、`manifestFile`，以及固定回显的 **`agentHint`** 一行说明（即"先读 outline 再读 JSON"的提示）。**不要硬编码 `<section>.json` 文件名**。
-2. **再 `fs.readFileSync(outlineFile, 'utf8')` 读 outline 文件**（即 `*.outline.txt`）：
+1. **解析 stdout 一行摘要 JSON**（禁止 Read 打开 `writtenFiles[0]` 的 `.json`）：拿到 `outlineFile`、`writtenFiles[0]`、`manifestFile`、`agentHint`。**不要硬编码 `<section>.json` 文件名**。
+2. **了解字段结构**（二选一，推荐 A）：
+   - **A**：宿主 **Read** 仅 `outlineFile`（`*.outline.txt`，体积小）；或
+   - **B**：`node -e "const fs=require('fs'); const o=fs.readFileSync(process.argv[1],'utf8').trimEnd().split('\\n').filter(l=>!l.startsWith('//')); console.log(o.pop())" <outlineFile>`
    - 第 1 行（注释）：`// outline of \`<xxx>.json\` — schema-only, NOT the data.` —— **明确告诉你它是"数据结构描述文件"**，不要把它当业务数据使用。
    - 第 2 行（注释）：中文用法说明。
    - 第 3 行（注释）：类型推断口径（数组取前 8 项去重并集；环或重复对象记为 any）。
    - 其后**可能**还有若干行 `//` 字段提示（例如 `google-analysis` 的 **`campaigns-*.outline.txt`** 会插入金额字段已统一为元的说明）。
    - **类型字面量**：**最后一个不以 `//` 开头的行**（单行 TS，如 `{ a: number; items: { ... }[] }`）—— 写筛选/聚合脚本时取这一行即可。
    - 提取写法：`outlineRaw.trimEnd().split('\n').filter(l => !l.startsWith('//')).pop()`（**不要**用 `lines[lines.length - 1]`：当最后一行是空行时会错）。
-3. **再 `require(writtenFiles[0])` / `fs.readFileSync` 读真实 JSON 数据**做筛选、聚合、计算。**禁止**：
-   - 把 outline 文件 `require` 进来当 JSON 解析（它是 `.txt` 不是 JSON）；
-   - 跳过 outline 直接猜 JSON 字段名；
-   - 把 outline 当成"摘要数据"贴给用户当结论。
-4. **交付物**用代码（Node / Python + 数据处理库）写出对应格式（HTML / Excel / PDF / PPT / Markdown 等），不要在对话里手填数。
+3. **必须用 Bash 执行脚本**读 `writtenFiles[0]`（及 manifest 中的路径）做筛选、聚合、计算——脚本内 `require` / `readFileSync`，**禁止**宿主 Read / cat / type 打开该 `.json`。**禁止**：
+   - 用 **Read** 读 `campaigns-*.json`、`list-accounts-*.json` 等落盘业务 JSON；
+   - 把 outline 当 JSON `require`（它是 `.txt`）；
+   - 跳过 outline 猜字段名；
+   - 把 outline 或整段 JSON 贴进对话当结论。
+4. **交付物**用代码写出（HTML / Excel / PDF / PPT / Markdown 等）；向用户展示的数字须来自**脚本 stdout**，不要在对话里手填数。
 
 > 这个顺序对所有三类快照统一生效：通用业务命令（`cli-manifest[-<id>].json`）、`google-analysis`（`manifest-<accountId>.json`）、`report …` 分析（`report-manifest[-<accountId>].json`）。三种 summary 都带 `outlineFile`、`agentHint` 字段。
 
@@ -324,8 +327,8 @@ console.log('可用字段：', first && Object.keys(first));
 
 ## AI Agent 使用规范
 
-- **优先用 `--json-out` 与清单文件**：同一运行目录、同一"查询 id"的多次拉数会合并到 `cli-manifest-<id>.json` 的 `artifacts[]`；不同账户/实体写入各自的 manifest，互不覆盖。读具体数据请打开 stdout 摘要 `writtenFiles[0]` 或对应 `<section>-<id>.json`。
-- **中间结果一律落盘**：跨步骤数据不要靠对话记忆，写到工作目录或临时目录并在后续脚本中 `require` / `readFile`。
+- **优先用 `--json-out` 与清单文件**：同一运行目录、同一"查询 id"的多次拉数会合并到 `cli-manifest-<id>.json` 的 `artifacts[]`；不同账户/实体写入各自的 manifest，互不覆盖。读具体数据**只**在脚本里 `require(writtenFiles[0])`，**禁止 Read 工具**打开该 json。
+- **中间结果一律落盘**：跨步骤数据不要靠对话记忆，写到工作目录并在后续 **`node`/`python` 脚本**中读盘。
 - **Windows 上避免直接管道 JSON**：PowerShell 管道可能改变编码；优先 `--json-out` + `node -e` 读文件。
 - **用 `process.stdout.write` 而不是 `console.log` 提取单个值**：前者不带换行符，方便直接赋给 shell 变量。
 - **节点代码复杂时拆分写法**：不要写超过 10 行的 `node -e` 单行，改用 `node -e "$(cat <<'EOF'\n...\nEOF\n)"` 或多行 `.mjs` 脚本文件。

package/dist/skill/references/core/workflows.md

@@ -135,7 +135,7 @@ siluzan-tso account-history -m Yandex
 **必填清单**：见 `open-account-by-media.md` § BingV2（含 `--pattern`、`--name-remark-list`、`--postcode`）。
 
 ```bash
-# 前置：查询行业名称（将输出的 name 值传给 --trade-id）
+# 前置：查询行业（将 bing-industries 输出的 id 传给 --trade-id，勿猜行业名）
 siluzan-tso open-account bing-industries --keyword "科技"
 
 # 提交开户（CLI 自动按公司名创建/关联广告主组，无需 magKey）
@@ -149,7 +149,7 @@ siluzan-tso open-account bing \
   --address "南山区科技园XX路XX号XX大厦" \
   --postcode "518000" \
   --promotion-link "https://www.brand-a.com" \
-  --trade-id "IT/消费电子-其他" \
+  --trade-id "<bing-industries 输出的 id>" \
   --license-file "/path/to/license.jpg"
 
 # 轮询审核进度

package/dist/skill/report-templates/REPORT-WORKFLOW.md

@@ -51,6 +51,14 @@
 
 ---
 
+### 步骤 4b：交付前自检（**必做**）
+
+- Read `references/core/deliverable-preflight.md`。
+- 运行 `node scripts/check-deliverable-snap.mjs <snapDir> --preset p4-google`（或按模板 `--required` / `--expect-currency`）。
+- 退出码非 0：**补拉数据或修正币种**，不得交付。
+
+---
+
 ### 步骤 5：撰写报告
 
 - 按 `*.md` 章节结构组织内容。

package/dist/skill/scripts/check-deliverable-snap.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * 交付前快照自检（币种 + 缺文件/空数据）
+ *
+ * 用法：
+ *   node scripts/check-deliverable-snap.mjs <snapDir> [--preset p4-google] [--required a,b]
+ *   node scripts/check-deliverable-snap.mjs ./snap --expect-currency CNY
+ *
+ * 退出码：0 通过；1 有 error；2 用法错误
+ */
+import fs from "node:fs";
+import path from "node:path";
+
+const PRESETS = {
+  "p4-google": [
+    "overview",
+    "daily-metrics",
+    "dimension-summary",
+    "campaigns",
+    "devices",
+    "geographic",
+    "keywords",
+  ],
+  "p1-google": ["list-accounts", "stats", "ad-campaigns"],
+};
+
+function parseArgs(argv) {
+  const snapDir = argv[2];
+  if (!snapDir) return { error: "缺少 snapDir" };
+  let preset;
+  let required = [];
+  let expectCurrency;
+  for (let i = 3; i < argv.length; i++) {
+    if (argv[i] === "--preset" && argv[i + 1]) {
+      preset = argv[++i];
+    } else if (argv[i] === "--required" && argv[i + 1]) {
+      required = argv[++i].split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (argv[i] === "--expect-currency" && argv[i + 1]) {
+      expectCurrency = argv[++i].toUpperCase();
+    }
+  }
+  if (preset) {
+    const p = PRESETS[preset];
+    if (!p) return { error: `未知 preset：${preset}，可选：${Object.keys(PRESETS).join(", ")}` };
+    required = [...new Set([...required, ...p])];
+  }
+  return { snapDir: path.resolve(snapDir), required, expectCurrency };
+}
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function listManifests(dir) {
+  return fs.readdirSync(dir).filter((f) => /^manifest(-.*)?\.json$/.test(f) || /^report-manifest(-.*)?\.json$/.test(f) || /^cli-manifest(-.*)?\.json$/.test(f));
+}
+
+function sectionMatches(artifactSection, required) {
+  return required.some((r) => artifactSection === r || artifactSection.startsWith(`${r}-`) || artifactSection.includes(r));
+}
+
+function itemCount(payload) {
+  if (!payload || typeof payload !== "object") return null;
+  if (Array.isArray(payload.items)) return payload.items.length;
+  if (Array.isArray(payload.data?.items)) return payload.data.items.length;
+  if (payload.record && typeof payload.record === "object") return 1;
+  if (Array.isArray(payload.data)) return payload.data.length;
+  return null;
+}
+
+function extractCurrencyFromPayload(payload, section) {
+  if (!payload || typeof payload !== "object") return null;
+  const rec = payload.record ?? payload.data?.record;
+  if (rec?.currencyCode) return String(rec.currencyCode);
+  const items = payload.items ?? payload.data?.items;
+  if (Array.isArray(items) && items.length > 0) {
+    const ma = items[0].ma ?? items[0];
+    if (ma?.currencyCode) return String(ma.currencyCode);
+    if (items[0].currencyCode) return String(items[0].currencyCode);
+  }
+  if (section.includes("list-accounts") && Array.isArray(items) && items[0]?.ma?.currencyCode) {
+    return String(items[0].ma.currencyCode);
+  }
+  return null;
+}
+
+function main() {
+  const parsed = parseArgs(process.argv);
+  if (parsed.error) {
+    console.error(parsed.error);
+    process.exit(2);
+  }
+  const { snapDir, required, expectCurrency } = parsed;
+  if (!fs.existsSync(snapDir)) {
+    console.error(`目录不存在：${snapDir}`);
+    process.exit(2);
+  }
+
+  const manifests = listManifests(snapDir);
+  if (manifests.length === 0) {
+    console.error(`未找到 manifest / report-manifest / cli-manifest：${snapDir}`);
+    process.exit(1);
+  }
+
+  const errors = [];
+  const warnings = [];
+  let currencySeen = null;
+
+  for (const mf of manifests) {
+    const man = readJson(path.join(snapDir, mf));
+    const arts = man.artifacts ?? [];
+    console.log(`\n📋 ${mf}（${arts.length} 个 artifact）`);
+
+    if (required.length > 0) {
+      for (const req of required) {
+        const hit = arts.some((a) => sectionMatches(String(a.section ?? ""), [req]));
+        if (!hit) errors.push(`[${mf}] 缺少维度/命令：${req}`);
+        else console.log(`  ✓ 已拉取：${req}`);
+      }
+    }
+
+    for (const art of arts) {
+      const fp = path.join(snapDir, art.file);
+      if (!fs.existsSync(fp)) {
+        errors.push(`[${mf}] 文件缺失：${art.file}`);
+        continue;
+      }
+      let payload;
+      try {
+        payload = readJson(fp);
+      } catch (e) {
+        errors.push(`[${mf}] JSON 解析失败：${art.file}`);
+        continue;
+      }
+      const n = itemCount(payload);
+      const sec = String(art.section ?? "");
+      if (n === 0) warnings.push(`[${mf}] ${art.file} items 为空（章节可能写「无数据」）`);
+      const ccy = extractCurrencyFromPayload(payload, sec);
+      if (ccy) {
+        if (!currencySeen) currencySeen = ccy;
+        else if (currencySeen !== ccy) warnings.push(`[${mf}] 币种不一致：${ccy} vs 先前 ${currencySeen}`);
+        if (sec.includes("overview") || sec.includes("list-accounts")) {
+          console.log(`  💱 币种来源 ${art.file}：${ccy}`);
+        }
+      }
+    }
+  }
+
+  if (expectCurrency) {
+    if (!currencySeen) warnings.push(`未从快照解析到 currencyCode，无法对照 --expect-currency ${expectCurrency}`);
+    else if (currencySeen !== expectCurrency) {
+      errors.push(`币种不符：快照为 ${currencySeen}，期望 ${expectCurrency}（报告须用 ￥/ $ 与代码一致）`);
+    } else console.log(`\n✓ 币种与期望一致：${expectCurrency}`);
+  } else if (currencySeen) {
+    console.log(`\n💱 建议在报告首行写：统计区间：…（货币：${currencySeen}）`);
+  }
+
+  if (warnings.length) {
+    console.log("\n⚠️ 警告：");
+    warnings.forEach((w) => console.log(`  - ${w}`));
+  }
+  if (errors.length) {
+    console.log("\n❌ 错误：");
+    errors.forEach((e) => console.log(`  - ${e}`));
+    process.exit(1);
+  }
+  console.log("\n✅ 交付前自检通过（仍须确认报告正文金额来自脚本、非手填）\n");
+}
+
+main();

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.26-beta.1'
+$PKG_VERSION = '1.1.26-beta.2'
 $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.26-beta.1"
+readonly PKG_VERSION="1.1.26-beta.2"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/eval/stub-fixtures/meta-overview.json

@@ -6,5 +6,5 @@
   "writtenFiles": ["meta-overview-3995107670753101.json", "meta-overview-3995107670753101.outline.txt"],
   "section": "meta-overview",
   "outlineFile": "meta-overview-3995107670753101.outline.txt",
-  "agentHint": "Read outline first, then JSON."
+  "agentHint": "禁止 Read 业务 *.json；先 outline schema，再用脚本读 JSON。"
 }

package/package.json

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