siluzan-tso-cli 1.0.0-beta.51 → 1.0.0-beta.53

package/README.md

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

package/dist/index.js

@@ -4557,6 +4557,7 @@ async function runInvoiceInfoDelete(opts) {
 
 // src/commands/ad.ts
 import { randomUUID } from "crypto";
+import { readFileSync as readFileSync6 } from "fs";
 async function findItemInList(listUrl, config, id, verbose) {
   const res = await apiFetch2(listUrl, config, {}, verbose);
   const item = (res.data ?? []).find((x) => x["id"] === id);
@@ -5200,8 +5201,59 @@ function buildAdsForBatchJob(opts) {
   return [ad];
 }
 async function runAdCampaignCreate(opts) {
-  const config = loadConfig(opts.token);
-  console.log(opts);
+  if (opts.configFile) {
+    let fileConfig;
+    try {
+      fileConfig = JSON.parse(readFileSync6(opts.configFile, "utf8"));
+    } catch (err) {
+      console.error(`
+\u274C \u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6\u5931\u8D25\uFF08${opts.configFile}\uFF09\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+    const fromFile = {
+      account: fileConfig.account,
+      customerName: fileConfig.customerName,
+      name: fileConfig.name,
+      budget: fileConfig.budget,
+      // CampaignCreateConfig.bidding → AdCampaignCreateOptions.biddingStrategy
+      biddingStrategy: fileConfig.bidding,
+      bidCeiling: fileConfig.bidCeiling,
+      targetCpa: fileConfig.targetCpa,
+      targetRoas: fileConfig.targetRoas,
+      locationIds: fileConfig.locationIds,
+      languageIds: fileConfig.languageIds,
+      startDate: fileConfig.startDate,
+      endDate: fileConfig.endDate,
+      url: fileConfig.url,
+      status: fileConfig.status,
+      adgroupName: fileConfig.adgroupName,
+      maxCpc: fileConfig.maxCpc,
+      matchType: fileConfig.matchType,
+      keywords: fileConfig.keywords,
+      headlines: fileConfig.headlines,
+      descriptions: fileConfig.descriptions,
+      finalUrl: fileConfig.finalUrl,
+      path1: fileConfig.path1,
+      path2: fileConfig.path2,
+      productWords: fileConfig.productWords,
+      negativeKeywords: fileConfig.negativeKeywords,
+      // CampaignCreateConfig.extensions/extraAdGroups → extensionsJson/extraAdGroupsJson
+      extensionsJson: fileConfig.extensions,
+      extraAdGroupsJson: fileConfig.extraAdGroups,
+      draft: fileConfig.draft,
+      targetSearchNetwork: fileConfig.targetSearchNetwork,
+      targetContentNetwork: fileConfig.targetContentNetwork
+    };
+    opts = {
+      ...fromFile,
+      ...Object.fromEntries(
+        Object.entries(opts).filter(([, v]) => v !== void 0 && v !== "" && !(Array.isArray(v) && v.length === 0))
+      ),
+      configFile: void 0
+    };
+  }
+  const config = await ensureDataPermission(loadConfig(opts.token));
   if (!config.apiBaseUrl) {
     console.error("\n\u274C \u672A\u914D\u7F6E apiBaseUrl\uFF0C\u8BF7\u6267\u884C\uFF1Asiluzan-tso config set --api-base <URL>\n");
     process.exit(1);
@@ -5209,9 +5261,12 @@ async function runAdCampaignCreate(opts) {
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const defaultEnd = "2037-12-30";
   const budgetBatch = Math.round(opts.budget * 100);
-  const maxCpcBatch = String(Math.round(opts.maxCpc * 100));
+  const maxCpcBatch = Math.round(opts.maxCpc * 100);
   const campaign = {
+    // 预算共享（Web 默认 false = 独立预算）
+    BudgetShared: false,
     Budget: budgetBatch,
+    BudgetId: 0,
     Name: opts.name,
     StatusV2: opts.status ?? "Enabled",
     ChannelTypeV2: "SEARCH",
@@ -5222,22 +5277,51 @@ async function runAdCampaignCreate(opts) {
     ...opts.targetRoas ? { TargetRoas: opts.targetRoas } : {},
     TargetGoogleSearch: true,
     TargetSearchNetwork: opts.targetSearchNetwork ?? true,
+    // 地理位置定向类型（0 = DONT_CARE，与 Web 一致）
+    NegativeGeoTargetType: 0,
+    PositiveGeoTargetType: 0,
+    // DSA 动态搜索广告配置（搜索广告系列保持默认空值即可）
+    DSADomainName: "",
+    DSALanguageCode: "en",
     TargetContentNetwork: opts.targetContentNetwork ?? false,
     StartTime: opts.startDate ?? today,
     EndTime: opts.endDate ?? defaultEnd,
-    // 地理位置定向
+    // 否定关键词（传入则写入第一条记录；不传则空数组，后续可用 ad negative-keyword-create 追加）
+    NegativeKeywordsForBatchJob: opts.negativeKeywords && opts.negativeKeywords.length > 0 ? [{
+      KeywordText: opts.negativeKeywords,
+      MatchTypeV2: "BROAD",
+      FinalURL: ""
+    }] : [],
+    // 广告附加功能（CALL / STRUCTURED_SNIPPET / SITELINK 等，不传则空数组）
+    ExtensionsForBatchJob: opts.extensionsJson ?? [],
+    // 第一个广告组（关键词与广告：不传则为空，后续用 ad keyword-create / ad ad-create 补充）
+    AdGroupsForBatchJob: [
+      {
+        Name: opts.adgroupName,
+        StatusV2: "Enabled",
+        TypeV2: "SEARCH_STANDARD",
+        RotationModeV2: "Unspecified",
+        MaxCPCAmount: maxCpcBatch,
+        AdsForBatchJob: buildAdsForBatchJob(opts),
+        KeywordsForBatchJob: buildKeywordsForBatchJob(opts)
+      },
+      // 可通过 --extra-adgroups-json 追加更多广告组
+      ...opts.extraAdGroupsJson ?? []
+    ],
+    // 地理位置定向（id 保持字符串类型，与 Web API 一致）
     targetedLocations: opts.locationIds.map((id) => ({
+      id: String(id),
       bidModifier: 0,
-      bidModifierSpecified: false,
-      id: Number(id)
+      bidModifierSpecified: false
     })),
     excludedLocations: [],
     // 语言（默认英语 1000）
     targetedLanguages: (opts.languageIds ?? ["1000"]).map((id) => ({ id: Number(id) })),
-    // 设备（默认 PC + 移动）
+    // 设备：30000=全部，30001=移动，30002=平板（与 Web 默认三端投放一致）
     targetedPlatforms: [
-      { id: 3e4, bidModifier: 0 },
-      { id: 30001, bidModifier: 0 }
+      { id: 30001, bidModifier: 0 },
+      { id: 30002, bidModifier: 0 },
+      { id: 3e4, bidModifier: 0 }
     ],
     // 全周全天投放
     adSchedules: [2, 3, 4, 5, 6, 7, 8].map((day) => ({
@@ -5246,19 +5330,7 @@ async function runAdCampaignCreate(opts) {
       StartMinuteV2: 2,
       endHour: 24,
       EndMinuteV2: 2
-    })),
-    NegativeKeywordsForBatchJob: [],
-    ExtensionsForBatchJob: [],
-    // 第一个广告组（关键词与广告：不传则为空，后续用 ad keyword-create / ad ad-create 补充）
-    AdGroupsForBatchJob: [{
-      Name: opts.adgroupName,
-      StatusV2: "Enabled",
-      TypeV2: "SEARCH_STANDARD",
-      RotationModeV2: "Unspecified",
-      MaxCPCAmount: maxCpcBatch,
-      AdsForBatchJob: buildAdsForBatchJob(opts),
-      KeywordsForBatchJob: buildKeywordsForBatchJob(opts)
-    }]
+    }))
   };
   const adGroupsForBatchJob = campaign.AdGroupsForBatchJob;
   const keywordRecommendations = (adGroupsForBatchJob ?? []).filter((g) => typeof g.Name === "string" && g.Name.trim().length > 0).map((g) => ({
@@ -5270,9 +5342,10 @@ async function runAdCampaignCreate(opts) {
     customerName: opts.customerName,
     campaignName: opts.name,
     url: opts.url ?? "",
-    // 前端页面会传入覆盖范围与产品词，这里暂时缺少同等丰富的来源，先留空数组以通过后端字段校验
+    // locations 为地理位置名称的展示字符串列表（前端只读，后端不做校验，可留空）
     locations: [],
-    productWords: [],
+    // productWords 为产品核心词，用于 AI 生成关键词推荐，可通过 --product-words 传入
+    productWords: opts.productWords ?? [],
     // Web 端异步创建在走「立即发布」时会使用非空的 GoogleDataRecordId（UUID）且 DraftStatus 为 Published；
     // 这里保持一致，使用随机 UUID 作为唯一标识。是否直接发布由 draft 开关控制：
     // - draft=true  → DraftStatus = Draft（仅创建草稿，需后续 ad batch publish 发布）
@@ -9901,20 +9974,20 @@ adCmd.command("keyword-negative-delete").description("\u5220\u9664\u5426\u5B9A\u
 });
 adCmd.command("campaign-create").description(
   '\u65B0\u5EFA\u641C\u7D22\u5E7F\u544A\u7CFB\u5217\uFF08\u542B\u7B2C\u4E00\u4E2A\u5E7F\u544A\u7EC4\uFF0C\u5F02\u6B65\u63D0\u4EA4\uFF1B\u9ED8\u8BA4\u7ACB\u5373\u53D1\u5E03\uFF0C\u53EF\u52A0 --draft \u4EC5\u4FDD\u5B58\u4E3A\u8349\u7A3F\uFF09\n\n  \u524D\u7F6E\u6B65\u9AA4\uFF1A\n    1. siluzan-tso ad geo search -a <accountId> -q "United States"  # \u83B7\u53D6 locationId\n    2. \u586B\u5165 --location-ids\uFF0C\u521B\u5EFA\u5B8C\u6BD5\u540E\u7528 ad batch get --id <taskId> \u8DDF\u8FDB\u72B6\u6001'
-).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--customer-name <name>", "\u8D26\u6237\u540D\u79F0\uFF08\u6765\u81EA list-accounts --json \u7684 mediaAccountName \u5B57\u6BB5\uFF09").requiredOption("--name <name>", "\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").requiredOption(
+).option("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId\uFF08\u4F7F\u7528 --config-file \u65F6\u53EF\u7701\u7565\uFF0C\u4ECE\u6587\u4EF6\u8BFB\u53D6\uFF09").option("--customer-name <name>", "\u8D26\u6237\u540D\u79F0\uFF08\u6765\u81EA list-accounts --json \u7684 mediaAccountName \u5B57\u6BB5\uFF09").option("--name <name>", "\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").option(
   "--budget <amount>",
-  "\u65E5\u9884\u7B97\uFF1A\u8D26\u6237\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 100 = \u6BCF\u5929 100 USD/CNY\uFF1B\u4E0E Web / ad smart create \u4E00\u81F4\uFF0C\u5185\u90E8 \xD7100 \u5199\u5165\u63A5\u53E3\uFF09",
+  "\u65E5\u9884\u7B97\uFF1A\u8D26\u6237\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 100 = \u6BCF\u5929 100 USD/CNY\uFF1B\u5185\u90E8 \xD7100 \u5199\u5165\u63A5\u53E3\uFF09",
   parseFloat
-).requiredOption(
+).option(
   "--bidding <strategy>",
   "\u51FA\u4EF7\u7B56\u7565\uFF1ATARGET_SPEND | MANUAL_CPC | TARGET_CPA | TARGET_ROAS"
-).requiredOption(
+).option(
   "--location-ids <ids>",
   "\u6295\u653E\u5730\u7406\u4F4D\u7F6E ID\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u7528 ad geo search \u83B7\u53D6\uFF0C\u5982 2840=\u7F8E\u56FD\uFF09",
   (v) => v.split(",").map((s) => s.trim())
-).requiredOption("--adgroup-name <name>", "\u7B2C\u4E00\u4E2A\u5E7F\u544A\u7EC4\u540D\u79F0").requiredOption(
+).option("--adgroup-name <name>", "\u7B2C\u4E00\u4E2A\u5E7F\u544A\u7EC4\u540D\u79F0").option(
   "--max-cpc <amount>",
-  "\u7B2C\u4E00\u4E2A\u5E7F\u544A\u7EC4\u6700\u9AD8 CPC\uFF1A\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 1.5 = \u6BCF\u6B21\u70B9\u51FB 1.50\uFF1B\u4E0E Web / ad smart create \u4E00\u81F4\uFF0C\u5185\u90E8 \xD7100 \u5199\u5165 MaxCPCAmount\uFF09",
+  "\u7B2C\u4E00\u4E2A\u5E7F\u544A\u7EC4\u6700\u9AD8 CPC\uFF1A\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 1.5 = \u6BCF\u6B21\u70B9\u51FB 1.50\uFF1B\u5185\u90E8 \xD7100 \u5199\u5165 MaxCPCAmount\uFF09",
   parseFloat
 ).option(
   "--bid-ceiling <amount>",
@@ -9936,9 +10009,44 @@ adCmd.command("campaign-create").description(
   "--descriptions <descs>",
   "\u5E7F\u544A\u63CF\u8FF0\uFF0C\u9017\u53F7\u5206\u9694\uFF0C\u81F3\u5C11 2 \u6761\uFF0C\u6BCF\u6761 \u2264 90 \u5B57\u7B26",
   (v) => v.split(",").map((s) => s.trim())
-).option("--final-url <url>", "\u5E7F\u544A\u843D\u5730\u9875\uFF08\u5173\u952E\u8BCD\u548C\u5E7F\u544A\u5171\u7528\uFF1B\u4E0D\u4F20\u5219\u7EE7\u627F --url\uFF09").option("--path1 <path>", "\u5C55\u793A URL \u8DEF\u5F84 1\uFF08\u2264 15 \u5B57\u7B26\uFF0C\u53EF\u9009\uFF09").option("--path2 <path>", "\u5C55\u793A URL \u8DEF\u5F84 2\uFF08\u2264 15 \u5B57\u7B26\uFF0C\u53EF\u9009\uFF09").option("--draft", "\u4EC5\u4FDD\u5B58\u4E3A\u8349\u7A3F\uFF08DraftStatus=Draft\uFF0C\u9700\u8981\u540E\u7EED ad batch publish \u53D1\u5E03\uFF09", false).option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA\u539F\u59CB\u54CD\u5E94", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
+).option("--final-url <url>", "\u5E7F\u544A\u843D\u5730\u9875\uFF08\u5173\u952E\u8BCD\u548C\u5E7F\u544A\u5171\u7528\uFF1B\u4E0D\u4F20\u5219\u7EE7\u627F --url\uFF09").option("--path1 <path>", "\u5C55\u793A URL \u8DEF\u5F84 1\uFF08\u2264 15 \u5B57\u7B26\uFF0C\u53EF\u9009\uFF09").option("--path2 <path>", "\u5C55\u793A URL \u8DEF\u5F84 2\uFF08\u2264 15 \u5B57\u7B26\uFF0C\u53EF\u9009\uFF09").option(
+  "--product-words <words>",
+  "\u63A8\u5E7F\u4EA7\u54C1\u8BCD\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u5199\u5165\u5916\u5C42 productWords\uFF0C\u7528\u4E8E AI \u5173\u952E\u8BCD\u63A8\u8350\uFF09",
+  (v) => v.split(",").map((s) => s.trim())
+).option(
+  "--negative-keywords <kws>",
+  "\u5426\u5B9A\u5173\u952E\u8BCD\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u751F\u6210 NegativeKeywordsForBatchJob\uFF0C\u9ED8\u8BA4 BROAD \u5339\u914D\uFF09",
+  (v) => v.split(",").map((s) => s.trim())
+).option(
+  "--extensions-json <json>",
+  "\u5E7F\u544A\u9644\u52A0\u529F\u80FD JSON \u6570\u7EC4\u5B57\u7B26\u4E32\uFF08ExtensionsForBatchJob\uFF1B\u5305\u542B CALL/SITELINK/STRUCTURED_SNIPPET \u7B49\uFF09"
+).option(
+  "--extra-adgroups-json <json>",
+  "\u989D\u5916\u5E7F\u544A\u7EC4 JSON \u6570\u7EC4\u5B57\u7B26\u4E32\uFF08\u8FFD\u52A0\u5230 AdGroupsForBatchJob\uFF1B\u6BCF\u6761\u987B\u5305\u542B Name/MaxCPCAmount/AdsForBatchJob/KeywordsForBatchJob \u7B49\u5B57\u6BB5\uFF09"
+).option(
+  "--config-file <path>",
+  "JSON \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF08\u63A8\u8350 AI \u4F7F\u7528\uFF09\uFF1A\u5C06\u6240\u6709\u53C2\u6570\u5199\u5165 JSON \u6587\u4EF6\u518D\u4F20\u6B64\u8DEF\u5F84\uFF0C\u652F\u6301 headlines \u6570\u7EC4\uFF08\u5141\u8BB8\u5143\u7D20\u5185\u542B\u9017\u53F7\uFF09\u3001extensions/extraAdGroups \u76F4\u63A5\u4F5C\u4E3A JSON \u6570\u7EC4\uFF0CCLI \u663E\u5F0F\u4F20\u5165\u7684\u53C2\u6570\u4F1A\u8986\u76D6\u6587\u4EF6\u4E2D\u7684\u540C\u540D\u5B57\u6BB5"
+).option("--draft", "\u4EC5\u4FDD\u5B58\u4E3A\u8349\u7A3F\uFF08DraftStatus=Draft\uFF0C\u9700\u8981\u540E\u7EED ad batch publish \u53D1\u5E03\uFF09", false).option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA\u539F\u59CB\u54CD\u5E94", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
+  if (!opts.configFile) {
+    const missing = [];
+    if (!opts.account) missing.push("-a/--account");
+    if (!opts.customerName) missing.push("--customer-name");
+    if (!opts.name) missing.push("--name");
+    if (opts.budget === void 0) missing.push("--budget");
+    if (!opts.bidding) missing.push("--bidding");
+    if (!opts.locationIds?.length) missing.push("--location-ids");
+    if (!opts.adgroupName) missing.push("--adgroup-name");
+    if (opts.maxCpc === void 0) missing.push("--max-cpc");
+    if (missing.length > 0) {
+      console.error(`
+\u274C \u7F3A\u5C11\u5FC5\u586B\u53C2\u6570\uFF1A${missing.join("\uFF0C")}
+   \u63D0\u793A\uFF1A\u53EF\u4F7F\u7528 --config-file <path> \u4ECE JSON \u6587\u4EF6\u8BFB\u53D6\u6240\u6709\u53C2\u6570
+`);
+      process.exit(1);
+    }
+  }
   const strategies = ["TARGET_SPEND", "MANUAL_CPC", "TARGET_CPA", "TARGET_ROAS"];
-  if (!strategies.includes(opts.bidding)) {
+  if (opts.bidding && !strategies.includes(opts.bidding)) {
     console.error(`
 \u274C --bidding \u53EA\u63A5\u53D7 ${strategies.join(" | ")}
 `);
@@ -9955,26 +10063,46 @@ adCmd.command("campaign-create").description(
 `);
     process.exit(1);
   }
+  let extensionsJson;
+  if (opts.extensionsJson) {
+    try {
+      extensionsJson = JSON.parse(opts.extensionsJson);
+    } catch {
+      console.error("\n\u274C --extensions-json \u683C\u5F0F\u9519\u8BEF\uFF0C\u8BF7\u4F20\u5165\u5408\u6CD5\u7684 JSON \u6570\u7EC4\u5B57\u7B26\u4E32\n");
+      process.exit(1);
+    }
+  }
+  let extraAdGroupsJson;
+  if (opts.extraAdgroupsJson) {
+    try {
+      extraAdGroupsJson = JSON.parse(opts.extraAdgroupsJson);
+    } catch {
+      console.error("\n\u274C --extra-adgroups-json \u683C\u5F0F\u9519\u8BEF\uFF0C\u8BF7\u4F20\u5165\u5408\u6CD5\u7684 JSON \u6570\u7EC4\u5B57\u7B26\u4E32\n");
+      process.exit(1);
+    }
+  }
   await runAdCampaignCreate({
+    configFile: opts.configFile,
     token: opts.token,
-    account: opts.account,
-    customerName: opts.customerName,
-    name: opts.name,
-    budget: opts.budget,
-    biddingStrategy: opts.bidding,
+    // 未使用 config-file 时，这些字段已通过上方校验确保非空；config-file 场景下函数内部会从文件补全
+    account: opts.account ?? "",
+    customerName: opts.customerName ?? "",
+    name: opts.name ?? "",
+    budget: opts.budget ?? 0,
+    biddingStrategy: opts.bidding ?? "",
     bidCeiling: opts.bidCeiling,
     targetCpa: opts.targetCpa,
     targetRoas: opts.targetRoas,
     targetSearchNetwork: opts.searchNetwork,
     targetContentNetwork: opts.contentNetwork,
-    locationIds: opts.locationIds,
+    locationIds: opts.locationIds ?? [],
     languageIds: opts.langIds,
     startDate: opts.start,
     endDate: opts.end,
     url: opts.url,
     status: opts.status ?? "Enabled",
-    adgroupName: opts.adgroupName,
-    maxCpc: opts.maxCpc,
+    adgroupName: opts.adgroupName ?? "",
+    maxCpc: opts.maxCpc ?? 0,
     keywords: opts.keywords,
     matchType: opts.matchType,
     headlines: opts.headlines,
@@ -9982,6 +10110,10 @@ adCmd.command("campaign-create").description(
     finalUrl: opts.finalUrl,
     path1: opts.path1,
     path2: opts.path2,
+    productWords: opts.productWords,
+    negativeKeywords: opts.negativeKeywords,
+    extensionsJson,
+    extraAdGroupsJson,
     draft: opts.draft,
     json: opts.json,
     verbose: opts.verbose

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.0.0-beta.51",
-  "publishedAt": 1775023908902
+  "version": "1.0.0-beta.53",
+  "publishedAt": 1775034415747
 }

package/dist/skill/references/google-ads-rules/google-ads-launch-plan-template.md

@@ -2,7 +2,7 @@
 
 > 所属 skill：`siluzan-tso`。
 >
-> 用途：AI 根据用户需求生成投放计划 → 以本模板格式呈现给用户确认 → 用户确认后按计划执行 CLI 命令创建广告。
+> 用途：AI 根据用户需求生成投放计划 → 以本模板格式呈现给用户确认 → 用户确认后由助手在后台完成账户内创建。**勿向用户展示命令行或 `siluzan-tso` 等工具细节**（具体命令见文末「助手执行计划」）。
 > 触发场景：用户要求「帮我投广告」「创建广告系列」「制定投放方案」等。
 
 ---
@@ -13,14 +13,34 @@
 1. 收集信息：向用户了解产品/服务、目标、预算、地域、网站等
 2. 生成计划：按下方模板格式输出完整方案
 3. 用户确认：用户逐项审阅，提出修改
-4. 执行创建：确认后按「执行命令」章节的 CLI 命令依次执行
+4. 执行创建：用户确认后，助手在后台按计划完成创建；**不向用户复述或展示任何命令行**
 ```
 
 **关键原则**：
-- 计划中每个字段都必须能直接映射到 CLI 参数，不写无法执行的内容
-- 关键词和广告文案必须通过合规检查（参考 `google-ads-compliance.md` 第十一章）
+
+- 用户可见正文只写业务字段（预算、地域、文案等），不出现命令行、可执行脚本或工具名称
+- 助手侧须保证每个业务字段可落实为实际创建步骤（映射关系见文末「助手执行计划」）；**搜索网络仅限 Google 搜索、关闭搜索合作伙伴与展示网络**为必选策略
+- 关键词和广告文案必须通过合规检查（参考 `references/google-ads-rules/google-ads-compliance.md` 第十一章）
 - 敏感行业须额外标注合规要求（参考 `sensitive-industries.md`）
 
+### 各模块推荐数量一览
+
+以下与 `references/google-ads-rules/google-ads-compliance.md` 第七章、`references/google-ads-rules/google-ads-keyword-strategy.md`、`references/google-ads-rules/google-ads-creative-optimization.md` 第一章与第五章对齐；**正文结构以本节下「模板正文」中 Google Ads 搜索详细执行方案为准**。生成计划时按推荐条数填满表格，勿仅用少量示例占位。
+
+| 模块 | 最少 | 推荐 | 上限 / 说明 |
+|------|------|------|----------------|
+| 每广告组正向关键词 | 20 条 | **20–30 条** | >30 条宜拆广告组；**组内意图须高度一致**以利质量得分 |
+| 账户级否定词包分类 | 3 类 | **5 类**（见模板「账户级否定关键词表」） | 每类下列多条广泛/词组否定词；列表须应用到**所有**系列 |
+| 系列级补充否定词 | 3 条 | **5–10 条** | 系列专属；与账户列表互补 |
+| RSA Headlines | 12 条 | **12–15 条** | 最多 15 条；**关键位置按模板用「固定📌」标注** |
+| RSA Descriptions | 4 条 | **4 条** | 最多 4 条 |
+| Sitelink | 6 条 | **6–8 条** | 创意文档亦给出更高账户级上限，计划内以本表为准 |
+| Callout | 6 条 | **6–8 条** | 每条宜 12–15 字符（效果参考创意文档） |
+| Structured Snippet | 1 组 | **1–2 组** | 每组 **≥4 个值**（`values`） |
+| 附加电话（CALL） | 0 | **有合规客服号则 1 条** | 无电话则可不填 |
+| 潜在客户表单（Lead Form） | 0 | **线索类 B2B 可 1 套** | 在 Google Ads 后台配置；CLI 当前无对应命令时由助手说明后台步骤 |
+| 合规提示下的限制条目（Tier 2/3） | — | **每条实质限制 2–4 条** | 过少易漏项，过多影响可读性 |
+
 ---
 
 ## 模板正文
@@ -41,6 +61,8 @@ AI 生成计划时，按以下格式输出。`{{占位符}}` 由 AI 根据用户
 
 ## 一、投放目标
 
+**表项**：下表 **5 行**均需填写（产品、核心目标、KPI、受众、行业分级）。
+
 | 项目 | 内容 |
 |---|---|
 | 推广产品/服务 | {{产品或服务描述}} |
@@ -50,138 +72,204 @@ AI 生成计划时，按以下格式输出。`{{占位符}}` 由 AI 根据用户
 | 行业分类 | {{行业}} — {{Tier 1 标准 / Tier 2 受限 / Tier 3 高度管制}} |
 
 {{如为 Tier 2/3，在此插入合规提示：}}
-> ⚠️ **合规提示**：{{行业}}属于{{Tier等级}}行业，须遵守以下限制：
+> ⚠️ **合规提示**（推荐列出 **2–4 条**核心限制）：{{行业}}属于{{Tier等级}}行业，须遵守以下限制：
 > - {{限制条目 1}}
 > - {{限制条目 2}}
+> - {{限制条目 3（可选）}}
 > - 详见 `sensitive-industries.md` 第{{X}}节
 
 ---
 
 ## 二、预算与排期
 
+**表项**：下表 **4 行**（月预算、日预算、启动日、周期）。多系列时，各系列单日预算可写在第三章表格的「单日预算」列（区间或定额均可）。
+
 | 项目 | 内容 |
 |---|---|
 | 月度总预算 | {{金额}} {{币种}} |
-| 日预算 | {{金额}} {{币种}}（= 月预算 ÷ 30.4） |
+| 日预算（账户/合计） | {{金额}} {{币种}}（= 月预算 ÷ 30.4，或与各系列日预算之和一致） |
 | 启动日期 | {{YYYY-MM-DD}} |
 | 计划周期 | {{如：持续投放 / 3个月试投 / 活动期间 MM-DD ~ MM-DD}} |
 
 ---
 
-## 三、广告系列架构
+## 三、Google Ads 搜索广告详细执行方案
 
-### 系列总览
+### 3.1 网络与流量质量（必选）
 
-| # | 系列名称 | 类型 | 日预算 | 出价策略 | 地域 |
-|---|---|---|---|---|---|
-| 1 | {{系列名}} | Search | {{金额}} | {{策略}} | {{地域}} |
-| 2 | {{系列名}} | Search | {{金额}} | {{策略}} | {{地域}} |
+**注意**：**绝不要**勾选「包括 Google 搜索网络合作伙伴」和「包括 Google 展示广告网络」，否则会引入大量低质流量。
 
-### 系列 1：{{系列名称}}
+| 要求 | 说明 |
+|---|---|
+| 投放网络 | **仅限 Google 搜索网络（Google Search Network only）** |
+| 禁止项 | 不启用搜索合作伙伴；不启用展示广告网络 |
 
-**基本设置**
+---
 
-| 参数 | 值 | CLI 映射 |
-|---|---|---|
-| 系列名称 | {{名称}} | `--name` |
-| 日预算 | {{金额}} {{币种}} | `--budget` |
-| 出价策略 | {{TARGET_SPEND / MANUAL_CPC / TARGET_CPA / TARGET_ROAS}} | `--bidding` |
-| 出价上限/目标 | {{如有：CPC上限/tCPA/tROAS值}} | `--bid-ceiling` / `--target-cpa` / `--target-roas` |
-| 投放地域 | {{地域名称}}（ID: {{geo_id}}） | `--location-ids` |
-| 投放语言 | {{语言}}（ID: {{lang_id}}） | `--lang-ids` |
-| 落地页 | {{URL}} | `--url` |
-| 初始状态 | {{Enabled / Paused}} | `--status` |
+### 3.2 广告系列（Campaign）基础设置
 
-#### 广告组 1-1：{{广告组名称}}
+**表项**：按系列列展开（常见 **2–3 个搜索系列**；多于 3 个时继续增列并写清预算占比）。**广告轮换**统一建议：**优先展示效果最佳的广告（Optimize）**。
 
-**关键词**
+| 设置项 | {{系列 1 名称}} | {{系列 2 名称}} | {{系列 3（可选）}} |
+|---|---|---|---|
+| 单日预算 | {{如：$100 – $150}} | {{如：$50 – $100}} | {{…}} |
+| 投放网络 | 仅限 Google 搜索网络 | 同左 | 同左 |
+| 地理位置 | {{如：美国、加拿大、英国；预算紧则先美国}} | {{…}} | {{…}} |
+| 语言 | {{如：English}} | {{…}} | {{…}} |
+| 出价策略（首月） | {{如：每次点击费用人工出价 Manual CPC；关闭「智能点击付费 (eCPC)」，以便卡死出价上限、摸清底价}} | {{如：尽可能争取更多点击次数 Maximize Clicks，并设最高 CPC 限制（如 $3.50），用于爆款/测流}} | {{…}} |
+| 出价策略（次月） | {{如：近 30 天满 30 个目标转化后，切换为目标每次转化费用 tCPA = $X}} | {{同逻辑或单独写 tCPA}} | {{…}} |
+| 广告轮换 | 优先展示效果最佳的广告 | 同左 | 同左 |
 
-| 关键词 | 匹配类型 | 格式 |
-|---|---|---|
-| {{keyword 1}} | 完全匹配 | `[keyword 1]` |
-| {{keyword 2}} | 词组匹配 | `"keyword 2"` |
-| {{keyword 3}} | 广泛匹配 | `keyword 3` |
-| ... | ... | ... |
+> **落地页**：各系列默认 URL 在下方广告组/创意节中按组填写；若全账户统一落地页，可在本表下增加一行「默认落地页 | {{URL}}」。
+
+---
 
-**否定关键词**（系列级）
+### 3.3 广告组（Ad Group）与关键词矩阵
+
+**原则**：每一个广告组内的关键词**意图必须高度一致**，广告文案与落地页与意图对齐，**质量得分（Quality Score）**才容易拉高。匹配符号：`[完全]`、`"词组"`、广泛无括号。
+
+#### 系列 1：{{系列名称}}
+
+| 广告组名称 | 核心关键词（带匹配符号） | 对应搜索意图 | 建议基准出价 (CPC) |
+|---|---|---|---|
+| {{AG 1 名称}} | {{`"词1"` / `[词2]` / 广泛词 …，补足 10–20 条时在组下列全表}} | {{意图一句话}} | {{币种区间或定额}} |
+| {{AG 2 名称}} | {{…}} | {{…}} | {{…}} |
+
+（每个广告组下可再拆「关键词」子表：| 关键词 | 匹配类型 | 格式 |，列满推荐条数，勿停留在 3 条示例。）
+
+#### 系列 2：{{系列名称}}
+
+| 广告组名称 | 核心关键词（带匹配符号） | 对应搜索意图 | 建议基准出价 (CPC) |
+|---|---|---|---|
+| {{AG 1 名称}} | {{…}} | {{…}} | {{…}} |
+| {{AG 2 名称}} | {{…}} | {{…}} | {{…}} |
+
+（系列较多时继续复制本小节。）
+
+**系列级补充否定关键词**（除账户级列表外；**推荐 5–10 条**，**最少 3 条**）
 
 | 否定词 | 匹配类型 | 原因 |
 |---|---|---|
 | {{negative 1}} | 完全匹配 | {{原因}} |
 | {{negative 2}} | 词组匹配 | {{原因}} |
+| … | … | … |
+
+---
+
+### 3.4 账户级否定关键词表
+
+**操作位置**：Google Ads **工具与设置 → 否定关键词列表（Negative keyword lists）** 中建立，并**应用到所有广告系列**。
+
+| 否定词包分类 | 具体否定词（填入后台；默认建议**广泛匹配** unless 另有说明） |
+|---|---|
+| 平台 / 零售商 | {{如：amazon, ebay, aliexpress, walmart, home depot, lowes, target, best buy, sears}} |
+| C 端意图词 | {{如：repair, fix, DIY, near me, local, store, tutorial, video, manual, guide, how to, broken, replacing}} |
+| 微量采购词 | {{如：single, 1 pc, one piece, individual, personal}} |
+| 低质流量词 | {{如：free, cheap, used, second hand, discount, craigslist, forum, reddit}} |
+| 服务类词汇 | {{如：service, technician, mechanic, company near me, repairman}} |
+| {{自定义分类}} | {{按需增列：品牌误触、招聘、学术等}} |
+
+> **搜索词报告**：上线后每日查看实际触发词；发现 C 端/教程类长句可**复制为完全匹配否定**加入列表或系列级否定（例如将整句 `[how to replace my whirlpool dryer belt]` 否定）。
+
+---
+
+### 3.5 响应式搜索广告（RSA）
 
-**广告创意（RSA）**
+**优化师操作指令**：以下资产全部填入后台，由系统组合展示。**带【固定📌】的**，须在 Google Ads 编辑器中对应该 **Headline / Description 位置** 使用**图钉**锁定（位置 1、2… 与后台一致）。
 
-Headlines（{{N}} 条）：
+**每个广告组配置 1 个 RSA** 即可（若策略需 A/B 再增列）。
 
-| # | 标题 | 主题类别 | 字符数 |
+#### 广告组：{{AG 名称}}（所属系列：{{系列名}}）
+
+| 资产类型 | 广告文案 | 字符数 | 后台设置指令 |
 |---|---|---|---|
-| H1 | {{标题文本}} | 关键词相关 | {{N}} |
-| H2 | {{标题文本}} | 价值主张 | {{N}} |
-| H3 | {{标题文本}} | CTA | {{N}} |
-| H4 | {{标题文本}} | 社会证明 | {{N}} |
-| H5 | {{标题文本}} | 品牌 | {{N}} |
-| ... | ... | ... | ... |
+| Headline 1 | {{文案}} | {{N}} | 【固定📌在位置 1】{{说明，如：保证第一眼看到核心定位}} |
+| Headline 2 | {{文案}} | {{N}} | 【固定📌在位置 2】{{说明，如：拦截非目标客群}} |
+| Headline 3 | {{文案}} | {{N}} | 自由轮换 |
+| Headline 4 | {{文案}} | {{N}} | 自由轮换 |
+| … | … | … | … |
+| Headline 15（上限） | {{文案}} | {{N}} | 自由轮换 |
 
-Descriptions（{{N}} 条）：
+（Headlines **推荐 12–15 条**；主题分配仍参考 `references/google-ads-rules/google-ads-creative-optimization.md` 1.2 六类主题法。）
 
-| # | 描述 | 字符数 |
-|---|---|---|
-| D1 | {{描述文本}} | {{N}} |
-| D2 | {{描述文本}} | {{N}} |
+| 资产类型 | 广告文案 | 字符数 | 后台设置指令 |
+|---|---|---|---|
+| Description 1 | {{文案}} | {{N}} | 【固定📌在位置 1】{{说明}} |
+| Description 2 | {{文案}} | {{N}} | 自由轮换 |
+| Description 3 | {{文案}} | {{N}} | 自由轮换 |
+| Description 4 | {{文案}} | {{N}} | 自由轮换 |
+
+Display URL：`{{domain}}/{{path1}}/{{path2}}`（Path1/Path2 各 ≤ 15 字符）
 
-Display URL：`{{domain}}/{{path1}}/{{path2}}`
+**广告组默认最高 CPC**：{{金额}} {{币种}}（与 3.3 矩阵一致）
 
-**广告组 CPC**：{{金额}} {{币种}} → `--max-cpc`
+（多广告组时重复「广告组：{{AG}}」小节。）
 
 ---
 
-{{如有多个系列，重复「系列 N」章节}}
+### 3.6 广告附加信息（Assets / Extensions）
 
+**数量**：Sitelink **推荐 6–8**；Callout **推荐 6–8**；Structured Snippet **至少 1 组，推荐 1–2 组**，每组 **≥4 值**；**CALL** 有合规号码则 **1 条**；**Lead Form** 按业务 **0–1 套**。
+
+**联系方式**：电话走 **CALL**；**无独立「邮箱」附加信息类型**，邮箱用 **Sitelink** 指向 `mailto:` 或联系页（勿写入 RSA 正文，见 `references/google-ads-rules/google-ads-compliance.md`）。
+
+#### 附加链接（Sitelinks）
+
+| # | 建议文案 | 落地页 URL / 说明 |
+|---|---|---|
+| 1 | {{如：OEM & ODM Service}} | {{独立页或首页锚点}} |
+| 2 | {{如：Factory Tour / 验厂}} | {{URL}} |
+| 3 | {{如：Request Bulk Quote}} | {{URL}} |
+| 4 | {{如：Download Catalog}} | {{URL}} |
+| 5 | {{邮件咨询 / 联系我们（若需邮箱）}} | {{mailto: 或联系表单页}} |
+| … | （补足 **6–8** 条） | … |
+
+#### 附加宣传信息（Callouts）
+
+| Callout 文本 |
+|---|
+| {{如：No Middleman Markups}} |
+| {{如：ISO 9001 Certified}} |
+| … |
 ---
 
-## 四、附加信息
+### 3.7 优化师日常操作 S.O.P（执行规范）
 
-| 类型 | 内容 | 链接/值 |
+| 频次 | 必做事项 |
+|---|---|
+| **每日（建议前 14 天）** | 查**搜索词报告**：发现 C 端/教程/无关意图，**立即**将具体词或整句以合适匹配类型加入**账户否定列表**或系列否定；这是控制流量质量的关键 |
+| **每周** | **砍烂词**：某关键词花费 > {{如：$15}} 且无有效转化（或无线索/WhatsApp 等约定动作），**暂停**；**调出价**：有效 B2B/目标动作词可提价 **10%–15%**，争取**绝对页首展示份额** |
+| **每月** | 核对 CRM/销售数据，算真实 ROI；对「垃圾线索」来源词**降价或暂停**；评估是否满足切换 **tCPA / 智能出价** 的数据门槛 |
+
+**阶段总览**（与 `references/google-ads-rules/google-ads-campaign-optimization.md` 可对照，不替代上表日常动作）：
+
+| 阶段 | 时间 | 重点任务 |
 |---|---|---|
-| Sitelink | {{文本}} | {{URL}} |
-| Sitelink | {{文本}} | {{URL}} |
-| Sitelink | {{文本}} | {{URL}} |
-| Sitelink | {{文本}} | {{URL}} |
-| Callout | {{文本}} | — |
-| Callout | {{文本}} | — |
-| Callout | {{文本}} | — |
-| Callout | {{文本}} | — |
-| Structured Snippet | {{Header}}: {{值1, 值2, 值3, 值4}} | — |
-| Call（如适用） | {{电话号码}} | 国家码: {{+XX}} |
+| 学习期 | 第 1–2 周 | 少大改结构；盯审核、展示量、CTR |
+| 数据积累 | 第 2–4 周 | 搜索词报告驱动否定词；替换低效词 |
+| 策略校准 | 第 4–8 周 | 满足条件后智能出价；刷新创意 |
+| 持续优化 | 第 8 周+ | 地域/设备；扩系列与关键词 |
 
 ---
 
-## 五、转化追踪建议
+## 四、转化追踪建议
+
+**条目**：本表固定 **4 项**（主转化、EC、离线导入、归因），每项一行写清建议，勿留空壳占位。
 
 | 项目 | 建议 |
 |---|---|
-| 主转化动作 | {{如：表单提交 / 购买 / 60秒+通话}} |
+| 主转化动作 | {{如：表单提交 / Lead Form 提交 / 购买 / 60秒+通话}} |
 | Enhanced Conversions | {{建议启用 Web 版 / Leads 版}} |
 | 离线转化导入 | {{是否需要，频率建议}} |
 | 归因模型 | {{DDA（推荐）/ Last-click}} |
 
-> 转化追踪需在 Google Ads 后台或 GTM 中配置，CLI 暂不支持直接设置。
+> 转化追踪在 Google Ads 或 **GTM** 中配置；本计划为策略说明，具体安装与调试在后台完成。
 
 ---
 
-## 六、启动后优化节奏
-
-| 阶段 | 时间 | 重点任务 |
-|---|---|---|
-| 学习期 | 第 1-2 周 | 不做大调整；监控审核状态、展示量、基础 CTR |
-| 数据积累 | 第 2-4 周 | 分析搜索词报告，添加否定词；替换低效关键词 |
-| 策略校准 | 第 4-8 周 | 根据 CPA 数据切换至 Smart Bidding；优化广告文案 |
-| 持续优化 | 第 8 周+ | 地域/设备出价调整；扩展新系列/关键词；创意刷新 |
-
----
+## 五、合规检查清单
 
-## 七、合规检查清单
+**条数**：以下 **8 条**逐项勾选（与 `references/google-ads-rules/google-ads-compliance.md` 第十一章呼应，不增删序号以免漏检）。
 
 - [ ] 所有 headline ≤ 30 字符（CJK 按 2 字符/字计算）
 - [ ] 所有 description ≤ 90 字符
@@ -194,15 +282,32 @@ Display URL：`{{domain}}/{{path1}}/{{path2}}`
 
 ---
 
-## 八、执行命令预览
+## 六、落地与执行说明
+
+确认本计划后，助手将按上述结构在您的广告账户中完成系列、广告组、关键词、创意与附加信息的创建与配置（**不含搜索合作伙伴与展示网络**），并在过程中同步进度与结果。若部分能力（如 **RSA 图钉位置**、**账户级否定词列表批量应用**、**Lead Form**）需仅在 Google Ads 界面完成，助手将明确说明由您在后台确认的操作步骤。
+
+---
+
+**请确认以上方案，或告知需要调整的部分。确认后我将开始为您落地投放结构。**
+````
+
+---
+
+## 助手执行计划（内部，勿向用户展示或复述）
+
+用户确认方案后，助手在后台按下列顺序执行（参数须与计划正文中的业务字段一致）。**不要**把本节内容粘贴给用户或逐条朗读命令。
+
+**与产品方案对齐的硬规则**：
 
-确认后将依次执行以下命令：
+- 创建/编辑系列时：**仅 Google 搜索网络**；**勿启用**搜索合作伙伴与展示网络（若 API/后台选项由平台暴露，须显式关闭）。
+- **账户级否定关键词列表**：若当前 CLI/API 仅支持系列级否定，则对每个系列执行否定词创建，或与用户说明需在后台一次性绑定列表；**计划正文仍以「账户列表 + 全系列应用」为准**。
+- **RSA 图钉（Headline/Description 固定位置）**、**Lead Form 附加信息**：若 CLI 无字段，在 Google Ads 界面按计划补全（不向用户展示命令）。
 
 ```bash
 # 1. 查询地域 ID（如尚未确认）
 siluzan-tso ad geo search -a {{CID}} -q "{{地域名}}"
 
-# 2. 创建系列 1（一体化模式）
+# 2. 创建系列 1（一体化模式；网络选项须与计划 3.1 一致）
 siluzan-tso ad campaign-create \
   -a {{CID}} \
   --customer-name "{{账户名}}" \
@@ -247,14 +352,16 @@ siluzan-tso ad ad-create \
   --descriptions "{{descriptions}}" \
   --path1 "{{path1}}" --path2 "{{path2}}"
 
-# 7. 添加否定关键词（系列级）
+# 7. 添加否定关键词（系列级；账户级列表若后台统一管理，此处可逐系列同步同一批词）
 siluzan-tso ad keyword-negative-create \
   -a {{CID}} \
   --campaign-id <系列ID> \
   --keyword "{{否定词}}" \
   --match-type {{EXACT/PHRASE}}
 
-# 8. 部署附加信息
+# 8. 部署附加信息（Lead Form 无 CLI 时跳过，改后台）
+siluzan-tso ad extension call -a {{CID}} --country-code "{{+XX}}" --phone "{{本地号码}}"
+# （无客服电话则跳过 call；邮箱用 sitelink：mailto: 或联系页 URL，勿写入 RSA）
 siluzan-tso ad extension sitelink -a {{CID}} --text "{{文本}}" --url "{{URL}}"
 siluzan-tso ad extension callout -a {{CID}} --text "{{文本}}"
 siluzan-tso ad extension snippet -a {{CID}} --header "{{Header}}" --values "{{值列表}}"
@@ -265,11 +372,6 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
 
 ---
 
-**请确认以上方案，或告知需要调整的部分。确认后我将立即开始创建。**
-````
-
----
-
 ## AI 填充指引
 
 生成计划时遵循以下规则：
@@ -280,29 +382,32 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
 
 | 必须 | 信息 | 用途 |
 |---|---|---|
-| ✅ | 账户 ID（`-a`） | 所有命令的前提 |
+| ✅ | 广告账户 ID | 关联投放账户（执行时由助手使用，勿向用户解释命令行） |
 | ✅ | 推广的产品/服务 | 决定关键词和文案方向 |
 | ✅ | 目标（线索/销售/曝光） | 决定系列类型和出价策略 |
-| ✅ | 月度预算 | 计算日预算、系列数量 |
-| ✅ | 投放地域 | `--location-ids` |
-| ✅ | 落地页 URL | `--url` / `--final-url` |
-| 建议 | 目标 CPA / ROAS | 出价策略参数 |
-| 建议 | 竞品/行业背景 | 关键词策略 |
+| ✅ | 月度预算 | 计算日预算、系列数量与 3.2 表各列预算 |
+| ✅ | 投放地域 | 地域定向与地域 ID |
+| ✅ | 落地页 URL | 落地页与最终到达网址 |
+| 建议 | 客服电话、邮箱或联系页 URL | **CALL** 与「邮件/联系」**Sitelink** |
+| 建议 | 目标 CPA、首月最高 CPC、转化门槛 | **Manual CPC / Max Clicks / tCPA** 切换条件（见下表） |
+| 建议 | 竞品/行业背景 | 关键词矩阵与否定词包 |
 | 建议 | 已有投放数据 | 优化起点 |
 
 ### 字段填充规则
 
 | 字段 | 规则 |
 |---|---|
-| 系列命名 | 遵循 `[类型]_[目标]_[定向]_[地域]_[匹配]` 规范（参考 `google-ads-campaign-optimization.md` 2.1 节） |
-| 出价策略 | 新系列默认 `TARGET_SPEND`；有历史数据且月转化 30+ 可用 `TARGET_CPA`/`TARGET_ROAS`（参考 3.1 节） |
-| 关键词 | 按 STAG/SIAG 分组；核心高意图词用 `[完全]`，拓展词用 `"词组"` 或广泛（参考 `google-ads-keyword-strategy.md` 第二、三章） |
-| Headlines | 按六类主题法生成，目标 8-15 条；每条 ≤ 30 字符（参考 `google-ads-creative-optimization.md` 1.2 节） |
-| Descriptions | 2-4 条，各自独立可用；至少 1 条含 CTA，1 条含关键词；每条 ≤ 90 字符 |
-| 否定关键词 | 至少列出明显的品牌保护词和无关意图词 |
-| 附加信息 | Sitelink ≥ 4 条 + Callout ≥ 4 条 + Snippet ≥ 1 组 |
-| 地域 | 先用 `ad geo search` 确认 ID；多数业务建议 Presence only 模式 |
-| 日预算 | ≥ 2-3× 目标 CPA（参考 `google-ads-campaign-optimization.md` 7.1 节） |
+| 投放网络 | **仅限 Google 搜索**；正文与助手侧均**禁止**默认开启搜索合作伙伴与展示网络 |
+| 系列命名 | 遵循 `[类型]_[目标]_[定向]_[地域]_[匹配]` 规范（参考 `google-ads-campaign-optimization.md` 2.1 节）；可与业务名并用（如「B2B 源头寻源」） |
+| 出价策略（首月） | **产品默认**：核心系列用 **Manual CPC**，且**关闭 eCPC**，写明建议 CPC 上限区间；测流/爆款系列可用 **Maximize Clicks + 最高 CPC**；与 `TARGET_SPEND` 等等价映射以实际 CLI/API 可选值为准时在助手侧转换，**用户可见正文始终用 Google Ads 界面用语** |
+| 出价策略（次月） | **产品默认**：近 **30 天满 30 个**约定转化（如表单）后切换 **tCPA**；无足够数据则延续人工或 Max Clicks 并写明条件 |
+| 关键词（每广告组） | **组内意图高度一致**；**最少 5、推荐 10–20**；`[完全]` / `"词组"` / 广泛分层（`google-ads-keyword-strategy.md`） |
+| 否定词 | **账户级 5 类词包**填满模板表；系列级补充 5–10 条；上线后搜索词**每日**迭代 |
+| RSA | **12–15** 标题、**4** 描述；**至少 H1、H2 与 D1** 在表中标注【固定📌】及目标位置与理由；字符合规见第十一章 |
+| 附加信息 | Sitelink **6–8**（可含 OEM/验厂/报价/目录/联系）；Callout **6–8**；Snippet **≥1 组、每组 ≥4 值**；**Lead Form** 线索业务建议填标题与必填字段 |
+| 投放设备 | **默认全设备**；仅在用户明确要求时写侧策略，并与 `google-ads-campaign-optimization.md` 第五章一致 |
+| 地域 | 助手侧先确认 Google 地域 ID（见「助手执行计划」第 1 步）；多数业务建议 Presence only 模式 |
+| 日预算 | ≥ 2–3× 目标 CPA（参考 `google-ads-campaign-optimization.md` 7.1 节）；与 3.2 表区间一致 |
 
 ### 合规检查
 
@@ -312,14 +417,14 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
 
 - 品牌词始终独立一个系列（Exact Match + 低 CPA）
 - 竞品词独立系列（Manual CPC 或 Max Clicks + CPC 上限）
-- 非品牌高意图词和中意图词可按意图层分系列
-- 每个系列的预算分配写在「系列总览」表中
-- 预算分配参考：品牌 10-15% / 高意图非品牌 50-60% / 中意图拓展 20-30% / 竞品 5-10%
+- 非品牌高意图与中意图可按意图分系列（与 3.3 矩阵一致）
+- 每个系列的预算分配写在 **3.2** 表的「单日预算」列
+- 预算分配参考：品牌 10–15% / 高意图非品牌 50–60% / 中意图拓展 20–30% / 竞品 5–10%
 
 ### 输出格式要求
 
 - 直接输出 Markdown 文本，不需要代码围栏包裹
 - 所有金额标注币种
 - 字符数必须实际计算并填入（CJK 字符按 2 计）
-- 执行命令区域的参数必须与计划表格中的值完全一致
-- 如系列较多（>3），可将命令预览精简为仅展示第一个系列的完整命令 + 其余系列的差异说明
+- **用户可见正文中不得出现**：`siluzan-tso`、shell/bash 代码块、命令行参数（如 `--budget`）、或任何可复制的终端命令；执行细节仅保留在助手侧，对照「助手执行计划」与计划表格保持一致即可
+- 如系列较多（>3），助手侧可分系列执行；用户可见方案写全业务表格即可

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

@@ -9,7 +9,7 @@
 
 ### 第一步：规则文档阅读（不得跳过）
 
-操作开始前，**AI 必须先阅读完下面所有相关文档**，并在心智模型中内化规则后，才能进入任何「方案规划 / 广告创建 / 调整」步骤，严禁只读 `google-ads-launch-plan-template.md` 就直接出方案。
+操作开始前，**AI 必须先阅读完下面所有文档**，并在心智模型中内化规则后，才能进入任何「方案规划 / 广告创建 / 调整」步骤，严禁只读 `google-ads-launch-plan-template.md` 就直接出方案。
 
 | 文档地址 | 文档内容 |
 |----------|-----------|
@@ -591,7 +591,7 @@ siluzan-tso keyword -k "running shoes" --json
 
 ## ad campaign-create — 广告系列新增
 
-新建搜索广告系列（异步批量任务）。支持两种模式：
+新建搜索广告系列（异步批量任务）。支持两种创建模式：
 
 - **一体化模式**（推荐）：传入 `--keywords`、`--headlines`、`--descriptions`，一条命令完成系列 + 组 + 关键词 + 广告创意，与网页 AI 创建向导行为等价。
 - **骨架模式**：仅创建系列和空广告组，后续用 `ad keyword-create`、`ad ad-create` 补充内容。
@@ -603,41 +603,202 @@ siluzan-tso keyword -k "running shoes" --json
 > 广告组、关键词、广告创意的直接创建走另一套 Google 网关 API，均有对应的 `adgroup-create`、`keyword-create`、`ad-create` 等命令。  
 > 任务异步处理，任务 ID 可通过 `ad batch get --id <id>` 跟进进度。
 
-### 选项
+---
+
+### 🤖 AI 推荐用法：--config-file（JSON 配置文件）
+
+**当参数复杂（多广告组、含附加功能、标题中有逗号）时，AI 应优先使用此方式**：将所有参数写入一个 JSON 文件，再用 `--config-file` 传入路径。
+
+**优势：**
+- `headlines` 是真正的字符串数组，元素内**允许含逗号**（如 `"Global Reach, Local Impact"`）
+- `extensions` / `extraAdGroups` 直接写 JSON，不需要序列化为字符串
+- 参数复杂时无 shell 转义问题，AI 一次生成即可成功
+
+**AI 执行步骤：**
+1. 用 Write 工具将配置写入 JSON 文件（如 `/tmp/campaign.json`）
+2. 执行 `siluzan-tso ad campaign-create --config-file /tmp/campaign.json`
+3. 用返回的任务 ID 查询进度
+
+**JSON 配置文件完整 Schema：**
+
+```json
+{
+  "account": "6326027735",
+  "customerName": "账户显示名称（来自 list-accounts --json 的 mediaAccountName）",
+  "name": "搜索-品牌词-2026",
+  "budget": 100,
+  "bidding": "TARGET_SPEND",
+  "bidCeiling": 1.5,
+  "locationIds": ["2840", "2826", "2036"],
+  "languageIds": ["1000", "1017"],
+  "startDate": "2026-04-01",
+  "endDate": "2027-04-01",
+  "url": "https://www.example.com",
+  "status": "Enabled",
+  "adgroupName": "核心词_品牌词",
+  "maxCpc": 1.5,
+  "matchType": "BROAD",
+  "keywords": [
+    "brand keyword 1",
+    "brand keyword 2",
+    "brand keyword 3"
+  ],
+  "headlines": [
+    "Brand Name: Quality Products",
+    "Trusted For Over 20 Years",
+    "Global Reach, Local Impact",
+    "Contact Us Today",
+    "Request A Free Quote Now"
+  ],
+  "descriptions": [
+    "Top-quality products with certified standards. Contact us today!",
+    "Trusted by global partners. Request a free quote now!"
+  ],
+  "finalUrl": "https://www.example.com/products",
+  "path1": "products",
+  "path2": "2026",
+  "productWords": ["brand", "product"],
+  "negativeKeywords": [
+    "free", "cheap", "wikipedia", "pdf", "ebay", "amazon"
+  ],
+  "extensions": [
+    {
+      "level": "Campaign",
+      "typeV2": "CALL",
+      "AssetFieldType": "CALL",
+      "Properties": { "ContryCode": "CN", "PhoneNumber": "+86 400-XXX-XXXX" }
+    },
+    {
+      "level": "Campaign",
+      "typeV2": "SITELINK",
+      "AssetFieldType": "SITELINK",
+      "properties": {
+        "DestinationUrl": "https://www.example.com/about",
+        "Text": "About Us",
+        "Line2": "Learn about our story",
+        "Line3": "Explore our mission"
+      }
+    },
+    {
+      "level": "Campaign",
+      "typeV2": "STRUCTURED_SNIPPET",
+      "AssetFieldType": "STRUCTURED_SNIPPET",
+      "StructuredSnippetHeaderValue": {
+        "key": "Services",
+        "value": ["Quality Certified", "Global Shipping", "24/7 Support"]
+      }
+    }
+  ],
+  "extraAdGroups": [
+    {
+      "MaxCPCAmount": 150,
+      "Name": "通用词_行业词",
+      "StatusV2": "Enabled",
+      "TypeV2": "SEARCH_STANDARD",
+      "RotationModeV2": "Unspecified",
+      "KeywordsForBatchJob": [
+        {
+          "KeywordText": ["industry keyword 1", "industry keyword 2"],
+          "MatchTypeV2": "BROAD",
+          "Finalurl": "https://www.example.com"
+        }
+      ],
+      "AdsForBatchJob": [
+        {
+          "AdTitle": null,
+          "DestinationUrl": "https://www.example.com",
+          "Finalurl": "https://www.example.com",
+          "Path1": "", "Path2": "",
+          "TypeV2": "RESPONSIVE_SEARCH_AD",
+          "headlinePart1": "Industry Leading Products",
+          "headlinePart2": "Certified Quality Standards",
+          "headlinePart3": "Get A Free Quote Today",
+          "AddtionalHeadlines": [
+            "Trusted By Global Partners",
+            "20+ Years Of Experience",
+            "Contact Us Now"
+          ],
+          "adDescription": "Top-quality industry products with global shipping. Contact us today!",
+          "adDescription2": "Certified standards and reliable delivery. Request a quote now!"
+        }
+      ]
+    }
+  ],
+  "draft": false
+}
+```
+
+**字段说明：**
+
+| 字段 | 必填 | 类型 | 说明 |
+|------|------|------|------|
+| `account` | ✅ | string | Google 账户 mediaCustomerId |
+| `customerName` | ✅ | string | 账户名称（`list-accounts --json` 的 `mediaAccountName`） |
+| `name` | ✅ | string | 广告系列名称 |
+| `budget` | ✅ | number | 日预算，**主币种展示金额**（100 = 每天 100 USD/CNY，内部 ×100） |
+| `bidding` | ✅ | string | 出价策略：`TARGET_SPEND` \| `MANUAL_CPC` \| `TARGET_CPA` \| `TARGET_ROAS` |
+| `locationIds` | ✅ | string[] | 地理位置 ID 数组（`ad geo search` 获取） |
+| `adgroupName` | ✅ | string | 第一个广告组名称 |
+| `maxCpc` | ✅ | number | 第一个广告组最高 CPC，主币种展示金额（1.5 = 1.50 USD，内部 ×100） |
+| `bidCeiling` | — | number | TARGET_SPEND 出价上限（主币种，内部 ×100） |
+| `targetCpa` | — | number | TARGET_CPA 目标 CPA（主币种，内部 ×100） |
+| `targetRoas` | — | number | TARGET_ROAS 目标 ROAS（如 2.5） |
+| `languageIds` | — | string[] | 语言 ID 数组（默认 `["1000"]` = 英语，中文 = `"1017"`） |
+| `startDate` / `endDate` | — | string | 日期 YYYY-MM-DD（默认：今天 / 2037-12-30） |
+| `url` | — | string | 落地页 URL |
+| `status` | — | string | `Enabled` \| `Paused`（默认 Enabled） |
+| `matchType` | — | string | 默认匹配类型：`BROAD` \| `PHRASE` \| `EXACT` |
+| `keywords` | — | string[] | 第一个广告组关键词 |
+| `headlines` | — | string[] | 标题数组，至少 3 条，推荐 15 条，每条 ≤ 30 字符，**元素内允许含逗号** |
+| `descriptions` | — | string[] | 描述数组，至少 2 条，推荐 4 条，每条 ≤ 90 字符 |
+| `finalUrl` | — | string | 广告落地页 |
+| `path1` / `path2` | — | string | 展示 URL 路径（各 ≤ 15 字符） |
+| `productWords` | — | string[] | 推广产品词（用于 AI 关键词推荐） |
+| `negativeKeywords` | — | string[] | 否定关键词数组（默认 BROAD 匹配） |
+| `extensions` | — | array | 广告附加功能（CALL / SITELINK / STRUCTURED_SNIPPET），见 Schema |
+| `extraAdGroups` | — | array | 额外广告组，追加到 AdGroupsForBatchJob，见 Schema |
+| `draft` | — | boolean | `true` = 仅保存草稿（需后续 `ad batch publish` 发布） |
+
+---
+
+### 命令行直接传参（简单场景适用）
+
+所有参数也可以直接通过 CLI 选项传入（复杂场景推荐用 `--config-file`）：
 
 | 选项 | 必填 | 说明 |
 |------|------|------|
-| `-a, --account <id>` | ✅ | Google 账户 mediaCustomerId |
-| `--customer-name <name>` | ✅ | 账户名称（来自 `list-accounts --json` 的 `mediaAccountName`） |
-| `--name <name>` | ✅ | 广告系列名称 |
-| `--budget <amount>` | ✅ | 日预算：**账户主币种展示金额**（如 `100` = 每天 100 USD/CNY；与 Web、`ad smart create` 一致，内部 `×100` 写入 `Budget`，**非** Google micros） |
-| `--bidding <strategy>` | ✅ | 出价策略：`TARGET_SPEND` \| `MANUAL_CPC` \| `TARGET_CPA` \| `TARGET_ROAS` |
-| `--location-ids <ids>` | ✅ | 地理位置 ID，逗号分隔（用 `ad geo search` 获取，2840=美国） |
-| `--adgroup-name <name>` | ✅ | 第一个广告组名称 |
-| `--max-cpc <amount>` | ✅ | 第一个广告组最高 CPC：**主币种展示金额**（如 `1.5` = 每次点击 1.50；内部 `×100` 写入批量体 `MaxCPCAmount` 字符串） |
-| `--keywords <kws>` | — | 关键词，逗号分隔；格式：词→BROAD，`*词*`→PHRASE，`[词]`→EXACT |
-| `--match-type <type>` | — | 无格式前缀关键词的默认匹配类型（默认 BROAD） |
-| `--headlines <titles>` | — | 广告标题，逗号分隔，至少 3 条 推荐15条，每条 ≤ 30 字符 |
-| `--descriptions <descs>` | — | 广告描述，逗号分隔，至少 2 条 推荐4条，每条 ≤ 90 字符 |
-| `--final-url <url>` | — | 广告落地页（关键词 / 广告共用；不传则继承 `--url`） |
-| `--path1 / --path2` | — | 展示 URL 路径（各 ≤ 15 字符） |
-| `--url <url>` | — | 推广落地页（附在外层 body） |
-| `--lang-ids <ids>` | — | 投放语言 ID，逗号分隔（默认 1000=英语；中文=1017） |
-| `--bid-ceiling <amount>` | — | TARGET_SPEND 出价上限：主币种金额（内部 `×100`；0=不限） |
-| `--target-cpa <amount>` | — | TARGET_CPA 目标 CPA：主币种金额（内部 `×100`） |
-| `--target-roas <n>` | — | TARGET_ROAS 目标 ROAS（如 2.5；最大 1000） |
-| `--start / --end` | — | 广告系列开始/结束日期（默认：今天 / 2037-12-30） |
-| `--status` | — | 初始状态：`Enabled` \| `Paused`（默认 Enabled） |
-| `--draft` | — | 仅保存为草稿（`DraftStatus=Draft`，需后续 `ad batch publish` 发布） |
-
-**典型用法**
+| `-a, --account <id>` | ✅* | Google 账户 mediaCustomerId（*使用 `--config-file` 时可从文件读取） |
+| `--customer-name <name>` | ✅* | 账户名称 |
+| `--name <name>` | ✅* | 广告系列名称 |
+| `--budget <amount>` | ✅* | 日预算（主币种展示金额） |
+| `--bidding <strategy>` | ✅* | 出价策略 |
+| `--location-ids <ids>` | ✅* | 地理位置 ID，逗号分隔 |
+| `--adgroup-name <name>` | ✅* | 第一个广告组名称 |
+| `--max-cpc <amount>` | ✅* | 最高 CPC（主币种展示金额） |
+| `--keywords <kws>` | — | 关键词，逗号分隔 |
+| `--headlines <titles>` | — | 广告标题，逗号分隔（⚠️ 标题内不能含逗号，含逗号请用 `--config-file`） |
+| `--descriptions <descs>` | — | 广告描述，逗号分隔 |
+| `--product-words <words>` | — | 产品词，逗号分隔 |
+| `--negative-keywords <kws>` | — | 否定关键词，逗号分隔 |
+| `--extensions-json <json>` | — | 附加功能 JSON 数组字符串 |
+| `--extra-adgroups-json <json>` | — | 额外广告组 JSON 数组字符串 |
+| `--lang-ids <ids>` | — | 语言 ID，逗号分隔（默认 1000=英语） |
+| `--bid-ceiling / --target-cpa / --target-roas` | — | 出价相关参数 |
+| `--start / --end` | — | 日期 YYYY-MM-DD |
+| `--url / --final-url` | — | 落地页 |
+| `--path1 / --path2` | — | 展示路径 |
+| `--status` | — | Enabled \| Paused |
+| `--draft` | — | 仅保存草稿 |
+| `--config-file <path>` | — | JSON 配置文件路径（AI 推荐） |
+
+**典型用法（简单场景）：**
 
 ```bash
 # 前置：搜索投放地区 ID
 siluzan-tso ad geo search -a 6326027735 -q "United States"
 # 取出 id 字段，如 2840
 
-# 一体化创建（系列 + 关键词 + 广告创意，推荐）
+# 一体化创建（CLI 直接传参，适合参数较少的场景）
 siluzan-tso ad campaign-create \
   -a 6326027735 \
   --customer-name "测试账户" \
@@ -648,17 +809,28 @@ siluzan-tso ad campaign-create \
   --adgroup-name "核心词_跑步鞋" \
   --max-cpc 5 \
   --url "https://www.brand-a.com/running-shoes" \
-  --keywords "running shoes,sport shoes,[trail running]" \
-  --headlines "专业跑步鞋,轻量透气设计,品牌直销价" \
-  --descriptions "全球百万跑者信赖，专业助力每一步。,免费配送，30天无理由退换。" \
+  --keywords "running shoes,sport shoes,trail running" \
+  --headlines "Brand Running Shoes,Lightweight Design,Direct Factory Price" \
+  --descriptions "Trusted by millions worldwide.,Free shipping and 30-day returns." \
   --final-url "https://www.brand-a.com/running-shoes" \
-  --path1 "跑步鞋" \
-  --path2 "特惠"
+  --path1 "running" \
+  --path2 "shoes"
 
-# 第四步：用返回的任务 ID 查看创建进度
+# 查看创建进度
 siluzan-tso ad batch get --id <taskId>
 ```
 
+**典型用法（AI 推荐，config-file 方式）：**
+
+```bash
+# 1. AI 先写好 JSON 配置文件（使用 Write 工具）
+# 2. 执行创建
+siluzan-tso ad campaign-create --config-file /tmp/campaign-config.json
+
+# 3. 查看进度
+siluzan-tso ad batch get --id <返回的taskId>
+```
+
 ---
 
 ## ad campaign-edit — 广告系列编辑

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.0.0-beta.51",
+  "version": "1.0.0-beta.53",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "type": "module",
   "bin": {