siluzan-tso-cli 1.1.37-beta.3 → 1.1.37-beta.4

package/README.md

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

package/dist/index.js

@@ -110511,6 +110511,7 @@ function validateCampaignExtensionsForBatchJob(campaign, errors, warnings, lengt
 
 // src/commands/ad/keyword.ts
 init_auth();
+import { readFileSync as readFileSync4 } from "fs";
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
@@ -110539,6 +110540,68 @@ function formatKeywordTextForMatchType(rawCoreOrDisplay, matchType) {
     }
   }
 }
+function parseKeywordsCsv(raw) {
+  const out = [];
+  let cur = "";
+  let inDouble = false;
+  let inBracket = false;
+  for (let i = 0; i < raw.length; i++) {
+    const ch = raw[i];
+    if (ch === '"' && !inBracket) {
+      inDouble = !inDouble;
+      cur += ch;
+      continue;
+    }
+    if (ch === "[" && !inDouble && !inBracket) {
+      inBracket = true;
+      cur += ch;
+      continue;
+    }
+    if (ch === "]" && inBracket) {
+      inBracket = false;
+      cur += ch;
+      continue;
+    }
+    if (ch === "," && !inDouble && !inBracket) {
+      const t = cur.trim();
+      if (t) out.push(t);
+      cur = "";
+      continue;
+    }
+    cur += ch;
+  }
+  const last = cur.trim();
+  if (last) out.push(last);
+  return out;
+}
+function loadKeywordsFromFile(filePath) {
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync4(filePath, "utf8"));
+  } catch (err) {
+    throw new Error(
+      `\u8BFB\u53D6\u5173\u952E\u8BCD\u6587\u4EF6\u5931\u8D25\uFF08${filePath}\uFF09\uFF1A${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (!Array.isArray(raw) || raw.length === 0) {
+    throw new Error(`\u5173\u952E\u8BCD\u6587\u4EF6\u987B\u4E3A\u975E\u7A7A JSON \u5B57\u7B26\u4E32\u6570\u7EC4\uFF1A${filePath}`);
+  }
+  const list = raw.map((x) => typeof x === "string" ? x.trim() : "").filter((s) => s.length > 0);
+  if (list.length === 0) {
+    throw new Error(`\u5173\u952E\u8BCD\u6587\u4EF6\u65E0\u6709\u6548\u5B57\u7B26\u4E32\uFF1A${filePath}`);
+  }
+  return list;
+}
+function resolveKeywordTexts(opts) {
+  const fromCsv = opts.keywords?.length ? opts.keywords : [];
+  const fromFile = opts.keywordsFile ? loadKeywordsFromFile(opts.keywordsFile) : [];
+  const merged = [...fromCsv, ...fromFile];
+  if (merged.length === 0) {
+    throw new Error("\u8BF7\u4F20 --keywords \u548C/\u6216 --keywords-file\uFF08\u591A\u8BCD\u77ED\u8BED\u76F4\u63A5\u5199\u7A7A\u683C\u5373\u53EF\uFF0C\u5982 how to make\uFF09");
+  }
+  if (!opts.matchType) return merged;
+  return merged.map((k) => formatKeywordTextForMatchType(k, opts.matchType));
+}
 function firstKeywordTextFromRecord(k) {
   const kt = k["keywordText"];
   if (Array.isArray(kt) && kt.length > 0 && typeof kt[0] === "string") {
@@ -110661,8 +110724,21 @@ ${label}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672C
 async function runAdKeywordCreate(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
+  let keywords;
+  try {
+    keywords = resolveKeywordTexts({
+      keywords: opts.keywords,
+      keywordsFile: opts.keywordsFile,
+      matchType: opts.matchType
+    });
+  } catch (err) {
+    console.error(`
+\u274C ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
   const body = {
-    KeywordText: opts.keywords,
+    KeywordText: keywords,
     FinalUrl: opts.finalUrl ?? "",
     AdGroup: opts.adgroupName,
     AdGroupId: opts.adgroupId,
@@ -110688,20 +110764,33 @@ async function runAdKeywordCreate(opts) {
     section: `ad-keyword-create-${opts.account}-${opts.adgroupId}`,
     commandLabel: "ad keyword-create",
     commandHint: `${opts.account}:${opts.adgroupId}`,
-    payload: { request: { adgroupId: opts.adgroupId, count: opts.keywords.length }, response },
+    payload: { request: { adgroupId: opts.adgroupId, count: keywords.length }, response },
     idSuffix: `${opts.account}-${opts.adgroupId}`
   })) {
     return;
   }
   console.log(`
-\u2705 \u5DF2\u6DFB\u52A0 ${opts.keywords.length} \u4E2A\u5173\u952E\u8BCD\u5230\u5E7F\u544A\u7EC4\u300C${opts.adgroupName}\u300D
+\u2705 \u5DF2\u6DFB\u52A0 ${keywords.length} \u4E2A\u5173\u952E\u8BCD\u5230\u5E7F\u544A\u7EC4\u300C${opts.adgroupName}\u300D
 `);
 }
 async function runAdNegativeKeywordCreate(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
+  let keywords;
+  try {
+    keywords = resolveKeywordTexts({
+      keywords: opts.keywords,
+      keywordsFile: opts.keywordsFile,
+      matchType: opts.matchType
+    });
+  } catch (err) {
+    console.error(`
+\u274C ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
   const body = {
-    KeywordText: opts.keywords,
+    KeywordText: keywords,
     CampaignId: opts.campaignId,
     Campaign: opts.campaignName
   };
@@ -110720,7 +110809,7 @@ async function runAdNegativeKeywordCreate(opts) {
     process.exit(1);
   }
   console.log(`
-\u2705 \u5DF2\u5728${level}\u5C42\u7EA7\u6DFB\u52A0 ${opts.keywords.length} \u4E2A\u5426\u5B9A\u5173\u952E\u8BCD
+\u2705 \u5DF2\u5728${level}\u5C42\u7EA7\u6DFB\u52A0 ${keywords.length} \u4E2A\u5426\u5B9A\u5173\u952E\u8BCD
 `);
 }
 async function runAdKeywordDelete(opts) {
@@ -111957,7 +112046,7 @@ function runCampaignCreateValidation(cfg) {
 }
 
 // src/commands/ad/campaign-load.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 function stripMetaKeys(value) {
   if (Array.isArray(value)) {
     return value.map((item) => stripMetaKeys(item));
@@ -111988,7 +112077,7 @@ function loadCampaignCreateConfig(configFile) {
 function tryLoadCampaignCreateConfig(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync4(configFile, "utf8"));
+    raw = JSON.parse(readFileSync5(configFile, "utf8"));
   } catch {
     return null;
   }
@@ -113017,12 +113106,12 @@ async function runAdEdit(opts) {
 
 // src/commands/ad/extension.ts
 init_auth();
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 
 // src/commands/ad/extension-lead-form.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 var VALID_LEAD_FORM_INPUT_TYPES = [
   "FULL_NAME",
   "FIRST_NAME",
@@ -113046,7 +113135,7 @@ var LEAD_FORM_CTA_DESCRIPTION_MAX_LEN = 30;
 function loadLeadFormExtensionConfig(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync5(configFile, "utf8"));
+    raw = JSON.parse(readFileSync6(configFile, "utf8"));
   } catch {
     console.error(`
 \u274C \u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6\u5931\u8D25\uFF08${configFile}\uFF09
@@ -113158,7 +113247,7 @@ function buildLeadFormExtensionBody(cfg, extensionId) {
 }
 
 // src/commands/ad/extension-whatsapp.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 var VALID_WHATSAPP_CTA_SELECTIONS = [
   "CONTACT_US",
   "LEARN_MORE",
@@ -113170,7 +113259,7 @@ var VALID_WHATSAPP_CTA_SELECTIONS = [
 function loadWhatsappExtensionConfig(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync6(configFile, "utf8"));
+    raw = JSON.parse(readFileSync7(configFile, "utf8"));
   } catch {
     console.error(`
 \u274C \u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6\u5931\u8D25\uFF08${configFile}\uFF09
@@ -113632,7 +113721,7 @@ async function runAdExtensionUpdate(opts) {
   const googleApiUrl = requireGoogleApi(config);
   let raw;
   try {
-    raw = stripMetaKeys(JSON.parse(readFileSync7(opts.configFile, "utf8")));
+    raw = stripMetaKeys(JSON.parse(readFileSync8(opts.configFile, "utf8")));
   } catch {
     console.error(`
 \u274C \u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6\u5931\u8D25\uFF08${opts.configFile}\uFF09
@@ -115826,7 +115915,7 @@ async function runPmaxImageValidation(configFile, cfg) {
 // src/commands/ad/pmax-image-resolve.ts
 init_auth();
 import { basename as basename4, dirname as dirname8, isAbsolute as isAbsolute3, resolve as resolve7 } from "path";
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 
 // src/commands/ad/pmax-urls.ts
 function pmaxChannelTypesUrl(googleApiUrl) {
@@ -115989,7 +116078,7 @@ async function uploadPmaxImageFileBase64(config, googleApiUrl, accountId, absIma
 async function uploadPmaxImageFile(config, googleApiUrl, accountId, absImagePath, name2, verbose) {
   const fileName = basename4(absImagePath);
   const assetName = (name2 ?? fileName).trim() || fileName;
-  const fileBuffer = readFileSync8(absImagePath);
+  const fileBuffer = readFileSync9(absImagePath);
   if (fileBuffer.length <= MAX_BASE64_UPLOAD_BYTES) {
     return uploadPmaxImageFileBase64(
       config,
@@ -116075,7 +116164,7 @@ function assertPmaxImageSlotsResolved(slots, requiredKinds = ["marketing", "squa
 }
 
 // src/commands/ad/pmax-load.ts
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 
 // src/commands/ad/pmax-campaign-extensions.ts
 init_auth();
@@ -116705,7 +116794,7 @@ function detectDeprecatedPmaxVideoKeys(raw) {
 function tryLoadPmaxCreateConfig(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync9(configFile, "utf8"));
+    raw = JSON.parse(readFileSync10(configFile, "utf8"));
   } catch {
     return null;
   }
@@ -116713,7 +116802,7 @@ function tryLoadPmaxCreateConfig(configFile) {
 }
 function loadPmaxCreateConfigRaw(configFile) {
   try {
-    const raw = JSON.parse(readFileSync9(configFile, "utf8"));
+    const raw = JSON.parse(readFileSync10(configFile, "utf8"));
     return stripMetaKeys(raw);
   } catch {
     return null;
@@ -116764,19 +116853,19 @@ function buildPmaxCreateUrl(googleApiUrl, accountId) {
 }
 
 // src/commands/ad/pmax-video-upload.ts
-import { existsSync as existsSync3, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync12 } from "fs";
 import { basename as basename5, dirname as dirname10, isAbsolute as isAbsolute5, resolve as resolve9 } from "path";
 
 // src/commands/ad/pmax-shared.ts
 init_auth();
 init_cli_json_snapshot();
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync11 } from "fs";
 import { dirname as dirname9, isAbsolute as isAbsolute4, resolve as resolve8 } from "path";
 var PMAX_MONEY_KEYS = /* @__PURE__ */ new Set(["budget", "targetCpa_BidingAmount"]);
 function loadPmaxJsonFile(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync10(configFile, "utf8"));
+    raw = JSON.parse(readFileSync11(configFile, "utf8"));
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     console.error(`
@@ -116976,7 +117065,7 @@ function runPmaxVideoValidation(configFile, cfg) {
     return { errors, warnings };
   }
   try {
-    const buf = readFileSync11(abs);
+    const buf = readFileSync12(abs);
     if (buf.length === 0) errors.push(`videoPath \u4E3A\u7A7A\u6587\u4EF6\uFF1A${abs}`);
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
@@ -117039,7 +117128,7 @@ async function uploadPmaxLocalVideo(opts) {
   const fileName = basename5(opts.absVideoPath);
   const title = (opts.title ?? fileName).trim() || fileName;
   const description = (opts.description ?? "Uploaded via siluzan-tso PMax video upload").trim() || "Uploaded via siluzan-tso";
-  const fileBuffer = readFileSync11(opts.absVideoPath);
+  const fileBuffer = readFileSync12(opts.absVideoPath);
   const form = new FormData();
   form.append("media_account_id", opts.accountId.replace(/-/g, ""));
   form.append("title", title);
@@ -117097,7 +117186,7 @@ function validatePmaxVideoPathQuick(absPath) {
     return `\u89C6\u9891\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${absPath}`;
   }
   try {
-    if (readFileSync11(absPath).length === 0) return `\u89C6\u9891\u6587\u4EF6\u4E3A\u7A7A\uFF1A${absPath}`;
+    if (readFileSync12(absPath).length === 0) return `\u89C6\u9891\u6587\u4EF6\u4E3A\u7A7A\uFF1A${absPath}`;
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     return `\u65E0\u6CD5\u8BFB\u53D6\u89C6\u9891\u6587\u4EF6\uFF08${absPath}\uFF09\uFF1A${msg}`;
@@ -118500,7 +118589,7 @@ async function runAdCampaignValidate(opts) {
 }
 
 // src/commands/ad/pmax-image-convert.ts
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, readFileSync as readFileSync12, existsSync as existsSync4 } from "fs";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, readFileSync as readFileSync13, existsSync as existsSync4 } from "fs";
 import { resolve as resolve10, dirname as dirname11, basename as basename7, extname } from "path";
 var SPECS = [
   { kind: "marketing", width: 1200, height: 628, fit: "cover", suffix: "_marketing" },
@@ -118589,7 +118678,7 @@ async function runAdPmaxImageConvert(opts) {
   if (opts.updateConfig) {
     const configPath = resolve10(opts.updateConfig);
     try {
-      const raw = JSON.parse(readFileSync12(configPath, "utf8"));
+      const raw = JSON.parse(readFileSync13(configPath, "utf8"));
       const imgPaths = raw["imagePaths"] ?? {};
       if (outputPaths.marketing) imgPaths["marketing"] = outputPaths.marketing;
       if (outputPaths.square) imgPaths["square"] = outputPaths.square;
@@ -118745,6 +118834,17 @@ async function runAdPmaxBrandGuidelinesEnable(opts) {
 }
 
 // src/commands/ad/_register.ts
+function parseOptionalMatchType(raw) {
+  if (!raw?.trim()) return void 0;
+  const t = raw.trim().toLowerCase();
+  if (t === "broad") return "Broad";
+  if (t === "phrase") return "Phrase";
+  if (t === "exact") return "Exact";
+  console.error(`
+\u274C --match-type \u65E0\u6548\uFF1A${raw}\uFF1B\u5408\u6CD5\u503C Broad | Phrase | Exact
+`);
+  process.exit(1);
+}
 function register20(program2) {
   const adCmd = program2.command("ad").description(
     "Google \u5E7F\u544A\u7BA1\u7406\uFF08Google API \u5730\u5740\u4ECE TSO API \u81EA\u52A8\u63A8\u5BFC\uFF0C\u53EF\u901A\u8FC7 SILUZAN_GOOGLE_API \u73AF\u5883\u53D8\u91CF\u8986\u76D6\uFF09\n  \u542B\uFF1A\u7CFB\u5217/\u7EC4/\u521B\u610F/\u5173\u952E\u8BCD\u7B49\u5E38\u89C4\u5E7F\u544A\u6295\u653E\u4E0E\u7BA1\u7406\u80FD\u529B"
@@ -119029,10 +119129,16 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("keyword-create").description("\u5411\u5E7F\u544A\u7EC4\u6DFB\u52A0\u641C\u7D22\u5173\u952E\u8BCD").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--adgroup-id <id>", "\u76EE\u6807\u5E7F\u544A\u7EC4 ID").requiredOption("--adgroup-name <name>", "\u76EE\u6807\u5E7F\u544A\u7EC4\u540D\u79F0").requiredOption("--campaign-id <id>", "\u6240\u5C5E\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--campaign-name <name>", "\u6240\u5C5E\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").requiredOption(
+  adCmd.command("keyword-create").description("\u5411\u5E7F\u544A\u7EC4\u6DFB\u52A0\u641C\u7D22\u5173\u952E\u8BCD\uFF08\u652F\u6301\u7A7A\u683C\u591A\u8BCD\uFF1B\u53EF\u7528 --keywords-file\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--adgroup-id <id>", "\u76EE\u6807\u5E7F\u544A\u7EC4 ID").requiredOption("--adgroup-name <name>", "\u76EE\u6807\u5E7F\u544A\u7EC4\u540D\u79F0").requiredOption("--campaign-id <id>", "\u6240\u5C5E\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--campaign-name <name>", "\u6240\u5C5E\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").option(
     "--keywords <kw1,kw2,...>",
-    "\u5173\u952E\u8BCD\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694",
-    (v) => v.split(",").map((s) => s.trim())
+    "\u5173\u952E\u8BCD\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u7A7A\u683C\u591A\u8BCD\u5408\u6CD5\uFF0C\u5982 how to make\uFF09\uFF1B\u53EF\u4E0E --keywords-file \u5E76\u7528",
+    (v) => parseKeywordsCsv(v)
+  ).option(
+    "--keywords-file <path>",
+    'JSON \u5B57\u7B26\u4E32\u6570\u7EC4\u6587\u4EF6\uFF08\u63A8\u8350\u591A\u8BCD/\u5E26\u5F15\u53F7\u573A\u666F\uFF09\uFF0C\u5982 ["how to make","home cooking"]'
+  ).option(
+    "--match-type <Broad|Phrase|Exact>",
+    '\u7EDF\u4E00\u5339\u914D\u7C7B\u578B\uFF08\u5199\u5165\u65F6\u7528\u6587\u6848 "\u2026" / [\u2026] \u5305\u88C5\uFF1B\u7701\u7565\u5219\u6309\u8BCD\u9762\u539F\u6837\u63D0\u4EA4\uFF09'
   ).option("--final-url <url>", "\u5173\u952E\u8BCD\u6700\u7EC8\u5230\u8FBE\u7F51\u5740\uFF08\u53EF\u9009\uFF09").option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json",
@@ -119047,16 +119153,26 @@ function register20(program2) {
         campaignId: opts.campaignId,
         campaignName: opts.campaignName,
         keywords: opts.keywords,
+        keywordsFile: opts.keywordsFile,
+        matchType: parseOptionalMatchType(opts.matchType),
         finalUrl: opts.finalUrl,
         jsonOut: opts.jsonOut,
         verbose: opts.verbose
       });
     }
   );
-  adCmd.command("keyword-negative-create").description("\u6DFB\u52A0\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u5E7F\u544A\u7CFB\u5217\u5C42\u7EA7\uFF1B\u4F20 --adgroup-id \u5219\u4E3A\u5E7F\u544A\u7EC4\u5C42\u7EA7\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--campaign-id <id>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--campaign-name <name>", "\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").requiredOption(
+  adCmd.command("keyword-negative-create").description(
+    "\u6DFB\u52A0\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u7CFB\u5217/\u7EC4\u7EA7\uFF1B\u652F\u6301\u7A7A\u683C\u591A\u8BCD\u77ED\u8BED\uFF0C\u5982 how to make\uFF1B\u53EF\u7528 --keywords-file\uFF09"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--campaign-id <id>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--campaign-name <name>", "\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").option(
     "--keywords <kw1,kw2,...>",
-    "\u5426\u5B9A\u5173\u952E\u8BCD\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694",
-    (v) => v.split(",").map((s) => s.trim())
+    "\u5426\u5B9A\u8BCD\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u7A7A\u683C\u591A\u8BCD\u5408\u6CD5\uFF09\uFF1B\u53EF\u4E0E --keywords-file \u5E76\u7528",
+    (v) => parseKeywordsCsv(v)
+  ).option(
+    "--keywords-file <path>",
+    'JSON \u5B57\u7B26\u4E32\u6570\u7EC4\u6587\u4EF6\uFF08\u63A8\u8350\u591A\u8BCD\u77ED\u8BED\uFF09\uFF0C\u5982 ["how to make","home cooking","second hand"]'
+  ).option(
+    "--match-type <Broad|Phrase|Exact>",
+    "\u7EDF\u4E00\u5339\u914D\u7C7B\u578B\uFF08Broad \u65E0\u5305\u88C5 / Phrase \u52A0\u53CC\u5F15\u53F7 / Exact \u52A0\u65B9\u62EC\u53F7\uFF09"
   ).option("--adgroup-id <id>", "\u5E7F\u544A\u7EC4 ID\uFF08\u6307\u5B9A\u540E\u4E3A\u5E7F\u544A\u7EC4\u5C42\u7EA7\u5426\u5B9A\uFF09").option("--adgroup-name <name>", "\u5E7F\u544A\u7EC4\u540D\u79F0").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAdNegativeKeywordCreate({
@@ -119067,6 +119183,8 @@ function register20(program2) {
         adgroupId: opts.adgroupId,
         adgroupName: opts.adgroupName,
         keywords: opts.keywords,
+        keywordsFile: opts.keywordsFile,
+        matchType: parseOptionalMatchType(opts.matchType),
         verbose: opts.verbose
       });
     }

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.37-beta.3",
-  "publishedAt": 1783922347102
+  "version": "1.1.37-beta.4",
+  "publishedAt": 1783934085806
 }

package/dist/skill/assets/campaign-create-template.json

@@ -7,6 +7,7 @@
     "agentPitfalls": [
       "campaign-validate 推荐 --json-out ",
       "否词只写 campaign.NegativeKeywordsForBatchJob，禁止把 free/jobs/tutorial 等否词抄进 AdGroupsForBatchJob[].KeywordsForBatchJob",
+      "KeywordText 是 JSON 字符串数组，空格多词合法（如 how to make）；禁止因多词省略否词或让用户去后台手补",
       "RSA 须同时写 DestinationUrl 与 Finalurl（后端必填 Finalurl；仅有 DestinationUrl 时 validate 可能仍通过）",
       "SITELINK 须写 AssetFieldType: SITELINK（与 typeV2 一致）",
       "提交前：ad campaign-validate → 用户确认 → ad campaign-create（勿对 validate 加 --json-out）"
@@ -65,7 +66,24 @@
     ],
 
     "NegativeKeywordsForBatchJob": [
-      { "KeywordText": ["free", "cheap", "download"], "MatchTypeV2": "BROAD", "FinalURL": "" }
+      {
+        "KeywordText": [
+          "free",
+          "cheap",
+          "download",
+          "how to make",
+          "home cooking",
+          "second hand",
+          "near me"
+        ],
+        "MatchTypeV2": "BROAD",
+        "FinalURL": ""
+      },
+      {
+        "KeywordText": ["\"vegan recipe\"", "\"stock price\""],
+        "MatchTypeV2": "PHRASE",
+        "FinalURL": ""
+      }
     ],
 
     "ExtensionsForBatchJob": [

package/dist/skill/assets/campaign-create-template.md

@@ -31,6 +31,8 @@ JSON 模板：同目录 [`campaign-create-template.json`](campaign-create-templa
 **禁止**：把方案 Markdown「否定词表」里的 `free` / `jobs` / `tutorial` 等抄进 `KeywordsForBatchJob`——那会**主动购买**这些流量。  
 **正确**：否词只写 `NegativeKeywordsForBatchJob`；`ad campaign-validate` 会对误填给出 **warnings**（常见否词词根 / 与否词块重复）。
 
+**多词短语（与 `keyword-negative-create` 同类误判）**：`KeywordText` 是 **JSON 字符串数组**，**空格多词完全合法**（如 `"how to make"`、`"home cooking"`）。PHRASE 写 `"\"vegan recipe\""` 或裸词 + `MatchTypeV2: "PHRASE"`（validate 会补引号）。**禁止**因「多词」就省略否词或让用户去 Google Ads 后台手补——那是 Agent 误判，不是 `campaign-create` 限制。
+
 投放方案 Markdown 中 §3.3 关键词矩阵 → `KeywordsForBatchJob`；§3.3 系列级否定词 / §3.4 账户级否定词 → `NegativeKeywordsForBatchJob`（账户级列表仍须在 Google 后台单独应用）。
 
 ### CLI 参数（勿混用）
@@ -184,7 +186,7 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 | 字段                          | 类型     | 说明                                                                              |
 | ----------------------------- | -------- | --------------------------------------------------------------------------------- |
 | `AdGroupsForBatchJob`         | object[] | **至少 1 组**；见下                                                               |
-| `NegativeKeywordsForBatchJob` | object[] | 系列级否词；元素：`{ KeywordText: string[], MatchTypeV2: "BROAD", FinalURL: "" }` |
+| `NegativeKeywordsForBatchJob` | object[] | 系列级否词；元素：`{ KeywordText: string[], MatchTypeV2: "BROAD"\|"PHRASE"\|"EXACT", FinalURL: "" }`；**KeywordText 可含空格多词**（见模板示例） |
 | `ExtensionsForBatchJob`       | object[] | 附加信息；`Properties` 须 **string→string**（勿用数组值）。SITELINK 见下表        |
 
 #### SITELINK（`ExtensionsForBatchJob[i]`，`typeV2` / `AssetFieldType` = `SITELINK`）

package/dist/skill/references/core/user-communication-guide.md

@@ -27,7 +27,8 @@
 2. **结论先行**：第一句给出可操作的判断（正常 / 有问题 / 原因是什么），不要让用户从表格里自己猜。
 3. **数据支撑**：引用**当次 CLI/脚本**的真实数字（消耗、CPA、余额、状态等）；禁止编造、禁止示例 ID。
 4. **行动建议**：1～3 条可执行项，点名对象（系列名、账户、关键词）并引用数据。
-5. **下一步**：一句预测或邀请（「要我帮您调整预算吗？」「还想看关键词明细吗？」）。
+5. **下一步**：一句预测或邀请（「要我帮您调整预算吗？」「还想看关键词明细吗？」）。  
+   **注意**：客户端会另行展示可点击的 suggestion chips（完整用户话术）。本文件与各任务 reference **只要求回复里出现一句邀请**，**不要**在 skill 各任务文档里维护「可点 chips 全文清单」——那份清单由产品侧 chips 规则维护，skill 更新不应与之逐条对齐。
 
 长任务（预计 >30s）：中间用**进度式**短句（「正在拉取系列数据…」「正在检查余额…」），不要长时间沉默后突然扔一大段表。
 
@@ -59,7 +60,8 @@
 | 帮我开个户 / 建广告 | W2 / W3 | 「没问题，我先告诉您需要准备哪些资料。」 |
 | 网站行不行 | P8 | 「我来给这个网站做个体检，看是否符合投放要求。」 |
 
-完整话术矩阵见产品文档第十章；Skill 内记住**结构**即可，勿背诵全文。
+完整话术矩阵见产品文档第十章；Skill 内记住**结构**即可，勿背诵全文。  
+可点击的「下一步」完整句子由客户端 suggestion chips 提供，**禁止**在本 skill 的 playbooks/workflows 里复制维护 chips 文案表（避免 skill 更新后与产品侧脱节）。
 
 ---
 
@@ -106,7 +108,8 @@
 | ---- | ---- |
 | `agent-conventions.md` | 怎么拉数、怎么读 outline、怎么自检、硬规范 |
 | `intent-routing.md` | 报告/分析消歧、选哪个 P/W |
-| `playbooks.md` / `workflows.md` | 步骤清单 |
-| **本文件** | **对用户怎么说** |
+| `playbooks.md` / `workflows.md` | 步骤清单（执行），不维护 chips 全文 |
+| **本文件** | **对用户怎么说**（结构 + 一句下一步邀请） |
+| 客户端 suggestion chips | **可点的下一步完整话术**（产品侧维护，与本 skill 解耦） |
 
 数值纪律不变：所有金额、状态、ID 仍只来自当次 CLI/`--json-out` 脚本；本文件只约束**表述方式**，不放宽数据真实性要求。

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

@@ -268,26 +268,38 @@ siluzan-tso ad keyword-create \
   -a <accountId> \
   --adgroup-id <adGroupId> --adgroup-name <adGroupName> \
   --campaign-id <campaignId> --campaign-name <campaignName> \
-  --keywords "词1,词2,词3" [--final-url <url>] \
+  --keywords "词1,词2,多词短语" [--final-url <url>] \
+  [--match-type Broad|Phrase|Exact] [--keywords-file ./kws.json] \
   [--json-out <path>]
 ```
 
-`--json-out` 落盘 `{ request: { adgroupId, count }, response: ... }`，批量脚本可直接据此核对成功量。
+`--keywords` **支持空格多词**（逗号才是分隔符）。`--json-out` 落盘 `{ request: { adgroupId, count }, response: ... }`，批量脚本可直接据此核对成功量。
 
 ### 否定关键词
 
+**支持空格多词短语**（如 `how to make`、`home cooking`）。匹配类型与 Web 一致：裸词=广泛，`"短语"`=词组，`[词]`=完全；也可用 `--match-type`。多词/带引号时推荐 `--keywords-file`，避免 shell 转义。
+
 ```bash
 # 添加（默认系列层级；传 --adgroup-id 则为组层级）
+# 多词短语直接写空格，逗号分隔多条——CLI 支持，无需改后台手工补
 siluzan-tso ad keyword-negative-create \
   -a <accountId> \
   --campaign-id <campaignId> --campaign-name <campaignName> \
-  --keywords "词1,词2" \
-  [--adgroup-id <id> --adgroup-name <name>]
+  --keywords "how to make,home cooking,second hand,near me"
+
+# 统一词组匹配 + JSON 文件（推荐）
+# negatives.json → ["how to make","home cooking","vegan recipe"]
+siluzan-tso ad keyword-negative-create \
+  -a <accountId> \
+  --campaign-id <campaignId> --campaign-name <campaignName> \
+  --keywords-file ./negatives.json --match-type Phrase
 
 # 删除（先用 ad keywords --negative --json-out ./snap 获取 id）
 siluzan-tso ad keyword-negative-delete -a <accountId> --id <negativeKeywordId>
 ```
 
+> **禁止**因「多词」就让用户去 Google Ads 后台手工补否词——那是 Agent 误判；用上面命令即可。
+
 ---
 
 ## ad batch — 异步批量创建记录
@@ -405,6 +417,8 @@ BatchJob 中 `ExtensionsForBatchJob`（尤其 **Sitelink**）失败率较高，
 
 **关键词匹配：** 写在 `KeywordsForBatchJob` 块内；同一块同匹配类型，`MatchTypeV2` 与 `KeywordText` 词面格式必须对齐（`PHRASE` 用 `"词"`、`EXACT` 用 `[词]`、`BROAD` 直写）。
 
+**多词短语：** `KeywordText` / 否词 `NegativeKeywordsForBatchJob[].KeywordText` 是 **JSON 字符串数组**，**空格多词合法**（如 `"how to make"`）。与 `keyword-negative-create` 不同，这里**没有**逗号 CLI 解析问题——**禁止**因「多词」省略否词或让用户去后台手补。
+
 广告组/关键词/创意的分步创建仍用 `adgroup-create`、`keyword-create`、`ad-create`。
 
 ---

package/dist/skill/references/google-ads/rules/google-ads-keyword-strategy.md

@@ -409,8 +409,8 @@ Broad Match + 受众信号 = 伪装成广泛定向的精准投放。
 | ------------ | ------------------------------------------------------------ | ----------------------------------------------------------------------- |
 | 关键词调研   | `keyword -k "词" [--url]`                                    | 结果按意图分层后再添加                                                  |
 | 添加关键词   | `ad keyword-create --keywords "词1,词2"`                     | 格式：`词→BROAD`、`"词"→PHRASE`、`[词]→EXACT`                           |
-| 添加否定词   | `ad keyword-negative-create`                                 | 每周从 `ad search-terms` 挖掘                                           |
-| 创建广告系列 | `ad campaign-create --config-file`（先 `campaign-validate`） | 按本文第三章架构设计系列结构；匹配块见 `google-ads-keyword-taxonomy.md` |
+| 添加否定词   | `ad keyword-negative-create`                                 | **支持空格多词**（`how to make`）；多词用 `--keywords` 或 `--keywords-file`，**禁止**因多词改让用户后台手补 |
+| 创建广告系列 | `ad campaign-create --config-file`（先 `campaign-validate`） | `KeywordText` 为 JSON 数组，**空格多词合法**；否词写 `NegativeKeywordsForBatchJob`，勿因多词省略 |
 | 搜索词分析   | `ad search-terms`                                            | 每周导出，按第八章流程处理                                              |
 | 竞品监控     | `ad auction-insights`（如有）                                | 按第九章分析竞争态势                                                    |
 | 出价调整     | 广告系列级 Smart Bidding 设置                                | 新账户用 Manual/ECPC → 有数据后切 tCPA/tROAS                            |

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

package/dist/skill/scripts/install.sh

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

package/package.json

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