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

package/README.md

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

package/dist/index.js

@@ -4171,7 +4171,9 @@ function isTsoArgvExemptFromWriteCommit(argv) {
 function ensureWriteCommitForMutatingHttp() {
   if (isTsoArgvExemptFromWriteCommit(process.argv.slice(2))) return;
   if (isWriteAuditCommitRequiredSatisfied()) return;
-  console.error('\n\u274C \u5199\u64CD\u4F5C\u5FC5\u987B\u63D0\u4F9B\u8BF4\u660E\uFF08commit\uFF09\uFF1A\u8BF7\u4F7F\u7528 --commit "\u2026"');
+  console.error(
+    '\n\u274C \u5199\u64CD\u4F5C\u5FC5\u987B\u63D0\u4F9B\u8BF4\u660E\uFF08commit\uFF09\uFF1A\u8BF7\u5728\u547D\u4EE4\u672B\u5C3E\u52A0 --commit "\u7B80\u77ED\u8BF4\u660E"\n   \u793A\u4F8B\uFF1Asiluzan-tso ad ad-create -a <id> \u2026 --commit "\u5728\u7EC4 X \u4E0B\u521B\u5EFA RSA \u5E76\u7A0D\u540E\u6682\u505C"\n'
+  );
   process.exit(1);
 }
 async function withWriteAudit(params, execute) {
@@ -112425,32 +112427,28 @@ async function resolveCampaignCustomerName(cfg, config, verbose) {
 
 // src/commands/ad/campaign.ts
 function formatGoogleCampaignListStatus(row) {
-  let result = "-";
   const raw = row.statusV2;
-  if (raw == null || String(raw).trim() === "") return result;
-  const statusV2 = String(raw).toUpperCase();
+  if (raw == null || String(raw).trim() === "") return "-";
+  const statusLabel = String(raw);
+  const statusKey = statusLabel.toUpperCase();
+  if (statusKey === "REMOVED") {
+    return `${statusLabel}\xB7\u5DF2\u5220\u9664`;
+  }
   const start = parseCampaignTimeMs(row.startTime);
   const end = parseCampaignTimeMs(row.endTime);
-  if (start == null || end == null) return result;
+  if (start == null || end == null) return statusLabel;
   const now = Date.now();
-  if (statusV2 === "PAUSED") {
-    if (now > start && now < end) {
-      result = "\u5DF2\u6682\u505C";
-    } else if (now > end) {
-      result = "\u5DF2\u7ED3\u675F\u4F7F\u7528";
-    } else if (now < start) {
-      result = "\u672A\u6295\u653E";
-    }
-  } else if (statusV2 === "ENABLED") {
-    if (now > start && now < end) {
-      result = "\u6709\u6548";
-    } else if (now > end) {
-      result = "\u5DF2\u7ED3\u675F\u4F7F\u7528";
-    } else if (now < start) {
-      result = "\u672A\u6295\u653E";
-    }
-  }
-  return result;
+  let schedule = "-";
+  if (now < start) {
+    schedule = "\u672A\u6295\u653E";
+  } else if (now > end) {
+    schedule = "\u6295\u653E\u671F\u5DF2\u7ED3\u675F";
+  } else if (statusKey === "PAUSED") {
+    schedule = "\u5DF2\u6682\u505C";
+  } else if (statusKey === "ENABLED") {
+    schedule = "\u6709\u6548";
+  }
+  return `${statusLabel}\xB7${schedule}`;
 }
 function parseCampaignTimeMs(v) {
   if (v == null || v === "") return null;
@@ -113158,6 +113156,77 @@ init_auth();
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
+
+// src/commands/ad/rsa-cli-validate.ts
+var AD_CLI_MIN_HEADLINES = 3;
+var AD_CLI_MAX_HEADLINES = 15;
+var AD_CLI_MIN_DESCRIPTIONS = 2;
+var AD_CLI_MAX_DESCRIPTIONS = 4;
+var AD_CLI_HEADLINE_MAX_CHARS = 30;
+var AD_CLI_DESCRIPTION_MAX_CHARS = 90;
+var AD_CLI_PATH_MAX_CHARS = 15;
+function validateRsaCliCopy(input) {
+  const errors = [];
+  if (input.headlines) {
+    const hs = input.headlines.map((s) => s.trim()).filter(Boolean);
+    if (hs.length < AD_CLI_MIN_HEADLINES) {
+      errors.push(`--headlines \u81F3\u5C11 ${AD_CLI_MIN_HEADLINES} \u6761\uFF0C\u5F53\u524D ${hs.length} \u6761`);
+    } else if (hs.length > AD_CLI_MAX_HEADLINES) {
+      errors.push(`--headlines \u6700\u591A ${AD_CLI_MAX_HEADLINES} \u6761\uFF0C\u5F53\u524D ${hs.length} \u6761`);
+    }
+    for (let i = 0; i < hs.length; i++) {
+      const len = calcGoogleCharLength(hs[i]);
+      if (len > AD_CLI_HEADLINE_MAX_CHARS) {
+        errors.push(
+          `--headlines[${i}] \u8D85\u8FC7 ${AD_CLI_HEADLINE_MAX_CHARS} \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A${JSON.stringify(hs[i])}`
+        );
+      }
+    }
+  }
+  if (input.descriptions) {
+    const ds = input.descriptions.map((s) => s.trim()).filter(Boolean);
+    if (ds.length < AD_CLI_MIN_DESCRIPTIONS) {
+      errors.push(`--descriptions \u81F3\u5C11 ${AD_CLI_MIN_DESCRIPTIONS} \u6761\uFF0C\u5F53\u524D ${ds.length} \u6761`);
+    } else if (ds.length > AD_CLI_MAX_DESCRIPTIONS) {
+      errors.push(`--descriptions \u6700\u591A ${AD_CLI_MAX_DESCRIPTIONS} \u6761\uFF0C\u5F53\u524D ${ds.length} \u6761`);
+    }
+    for (let i = 0; i < ds.length; i++) {
+      const len = calcGoogleCharLength(ds[i]);
+      if (len > AD_CLI_DESCRIPTION_MAX_CHARS) {
+        errors.push(
+          `--descriptions[${i}] \u8D85\u8FC7 ${AD_CLI_DESCRIPTION_MAX_CHARS} \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A${JSON.stringify(ds[i])}`
+        );
+      }
+    }
+  }
+  for (const [label, value] of [
+    ["--path1", input.path1],
+    ["--path2", input.path2]
+  ]) {
+    if (value === void 0) continue;
+    const len = calcGoogleCharLength(value);
+    if (len > AD_CLI_PATH_MAX_CHARS) {
+      errors.push(
+        `${label} \u8D85\u8FC7 ${AD_CLI_PATH_MAX_CHARS} \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A${JSON.stringify(value)}`
+      );
+    }
+  }
+  return errors;
+}
+function formatRsaCliValidationError(errors) {
+  const lines = [
+    "",
+    "\u274C RSA \u6587\u6848\u6821\u9A8C\u5931\u8D25\uFF08\u672A\u8C03\u7528 API\uFF09\uFF1A",
+    ...errors.map((e) => `   - ${e}`),
+    "",
+    "   \u89C4\u5219\uFF1A\u6807\u9898 3\u201315 \u6761\u3001\u6BCF\u6761 \u226430 Google \u5B57\u7B26\uFF1B\u63CF\u8FF0 2\u20134 \u6761\u3001\u6BCF\u6761 \u226490\uFF1Bpath \u226415\u3002CJK/\u5168\u89D2\u6309 2 \u8BA1\u3002",
+    "   \u8BF7\u7F29\u77ED\u8D85\u957F\u6761\u76EE\u6216\u5220\u6389\u591A\u4F59\u63CF\u8FF0\u540E\u91CD\u8BD5\uFF08\u52FF\u628A\u8D85\u957F\u6587\u6848\u539F\u6837\u518D\u63D0\u4EA4\uFF09\u3002",
+    ""
+  ];
+  return lines.join("\n");
+}
+
+// src/commands/ad/ad-creative.ts
 async function runAdList(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
@@ -113237,12 +113306,14 @@ async function runAdList(opts) {
 async function runAdCreate(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  if (opts.headlines.length < 3) {
-    console.error("\n\u274C \u6807\u9898\uFF08--headlines\uFF09\u81F3\u5C11\u9700\u8981 3 \u4E2A\n");
-    process.exit(1);
-  }
-  if (opts.descriptions.length < 2) {
-    console.error("\n\u274C \u63CF\u8FF0\uFF08--descriptions\uFF09\u81F3\u5C11\u9700\u8981 2 \u4E2A\n");
+  const rsaErrors = validateRsaCliCopy({
+    headlines: opts.headlines,
+    descriptions: opts.descriptions,
+    path1: opts.path1,
+    path2: opts.path2
+  });
+  if (rsaErrors.length > 0) {
+    console.error(formatRsaCliValidationError(rsaErrors));
     process.exit(1);
   }
   const [h1, h2, h3, ...moreHeadlines] = opts.headlines;
@@ -113367,12 +113438,14 @@ async function runAdEdit(opts) {
     );
     process.exit(1);
   }
-  if (opts.headlines && opts.headlines.length < 3) {
-    console.error("\n\u274C --headlines \u81F3\u5C11\u9700\u8981 3 \u4E2A\n");
-    process.exit(1);
-  }
-  if (opts.descriptions && opts.descriptions.length < 2) {
-    console.error("\n\u274C --descriptions \u81F3\u5C11\u9700\u8981 2 \u4E2A\n");
+  const rsaErrors = validateRsaCliCopy({
+    headlines: opts.headlines,
+    descriptions: opts.descriptions,
+    path1: opts.path1,
+    path2: opts.path2
+  });
+  if (rsaErrors.length > 0) {
+    console.error(formatRsaCliValidationError(rsaErrors));
     process.exit(1);
   }
   const params = new URLSearchParams();
@@ -119651,7 +119724,7 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("campaigns").description("\u67E5\u8BE2\u5E7F\u544A\u7CFB\u5217\u5217\u8868\uFF08\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4\u4ECA\u5929\uFF09").option("-t, --token <token>", "Auth Token").option(
+  adCmd.command("campaigns").alias("campaign-list").description("\u67E5\u8BE2\u5E7F\u544A\u7CFB\u5217\u5217\u8868\uFF08\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF1B\u522B\u540D campaign-list\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4\u4ECA\u5929\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\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
@@ -119667,7 +119740,7 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("groups").description("\u67E5\u8BE2\u5E7F\u544A\u7EC4\u5217\u8868\uFF08\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4\u4ECA\u5929\uFF09").option("-t, --token <token>", "Auth Token").option(
+  adCmd.command("groups").alias("group-list").description("\u67E5\u8BE2\u5E7F\u544A\u7EC4\u5217\u8868\uFF08\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF1B\u522B\u540D group-list\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4\u4ECA\u5929\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\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
@@ -119683,7 +119756,7 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("list").description("\u67E5\u8BE2\u5E7F\u544A\uFF08\u521B\u610F\uFF09\u5217\u8868\uFF08\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4\u4ECA\u5929\uFF09").option("--include-deleted", "\u5305\u542B\u5DF2\u5220\u9664\u7684\u5E7F\u544A\uFF08\u7F51\u5173 readDeleted=true\uFF09", false).option("-t, --token <token>", "Auth Token").option(
+  adCmd.command("list").alias("ad-list").description("\u67E5\u8BE2\u5E7F\u544A\uFF08\u521B\u610F\uFF09\u5217\u8868\uFF08\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF1B\u522B\u540D ad-list\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u9ED8\u8BA4\u4ECA\u5929\uFF09").option("--include-deleted", "\u5305\u542B\u5DF2\u5220\u9664\u7684\u5E7F\u544A\uFF08\u7F51\u5173 readDeleted=true\uFF09", false).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\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
@@ -119700,7 +119773,7 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("keywords").description("\u67E5\u8BE2\u5173\u952E\u8BCD\u5217\u8868\uFF08--negative \u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD\uFF1B\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--negative", "\u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD", false).option("--start <date>", "\u5F00\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4\u4ECA\u5929\uFF09").option("-t, --token <token>", "Auth Token").option(
+  adCmd.command("keywords").alias("keyword-list").description("\u67E5\u8BE2\u5173\u952E\u8BCD\u5217\u8868\uFF08--negative \u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD\uFF1B\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF1B\u522B\u540D keyword-list\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--negative", "\u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD", false).option("--start <date>", "\u5F00\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4\u4ECA\u5929\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\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
@@ -119793,7 +119866,7 @@ function register20(program2) {
     }
   );
   adCmd.command("ad-create").description(
-    "\u521B\u5EFA\u81EA\u9002\u5E94\u641C\u7D22\u5E7F\u544A\uFF08\u5FC5\u4F20\uFF1A-a / --adgroup-id / --adgroup-name / --final-url / --headlines / --descriptions\uFF09"
+    "\u521B\u5EFA\u81EA\u9002\u5E94\u641C\u7D22\u5E7F\u544A\uFF08\u5FC5\u4F20\uFF1A-a / --adgroup-id / --adgroup-name / --final-url / --headlines / --descriptions\uFF1B\u63D0\u4EA4\u524D\u672C\u5730\u6821\u9A8C\uFF1A\u6807\u98983\u201315\u6761\u226430\u5B57\u3001\u63CF\u8FF02\u20134\u6761\u226490\u5B57\uFF0CCJK\xD72\uFF09"
   ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId\uFF08\u5FC5\u4F20\uFF09").requiredOption("--adgroup-id <id>", "\u76EE\u6807\u5E7F\u544A\u7EC4 ID\uFF08\u5FC5\u4F20\uFF0C\u6765\u81EA ad groups\uFF09").requiredOption("--adgroup-name <name>", "\u76EE\u6807\u5E7F\u544A\u7EC4\u540D\u79F0\uFF08\u5FC5\u4F20\uFF0C\u4E0E adgroup-id \u5BF9\u5E94\uFF09").requiredOption("--final-url <url>", "\u6700\u7EC8\u5230\u8FBE\u7F51\u5740\uFF08\u5FC5\u4F20\uFF09").requiredOption(
     "--headlines <h1,h2,h3,...>",
     "\u6807\u9898\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694\uFF0C\u81F3\u5C11 3 \u4E2A\uFF08\u5FC5\u4F20\uFF0C\u6700\u591A 15 \u4E2A\uFF0C\u6BCF\u4E2A \u226430 \u5B57\u7B26\uFF09",
@@ -132246,14 +132319,30 @@ init_version();
 init_cli_json_snapshot();
 
 // src/utils/agent-compat-argv.ts
+function jsonOutMissingPath(args) {
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--json-out") {
+      const next = args[i + 1];
+      return next == null || next.startsWith("-");
+    }
+    if (a.startsWith("--json-out=")) {
+      return a.slice("--json-out=".length).trim() === "";
+    }
+  }
+  return false;
+}
 function agentCompatFatalMessage(argv) {
   const args = argv.slice(2);
   if (args.includes("--period") || args.some((a) => a.startsWith("--period="))) {
     return "\n\u274C \u6CA1\u6709 --period \u9009\u9879\u3002\u8BF7\u7528 --start/--end\uFF08\u6216\u517C\u5BB9\u522B\u540D --start-date/--end-date\uFF09\u6307\u5B9A YYYY-MM-DD \u533A\u95F4\u3002\n";
   }
+  if (jsonOutMissingPath(args)) {
+    return "\n\u274C `--json-out` \u5FC5\u987B\u5E26\u8DEF\u5F84\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\uFF09\uFF0CJSON \u843D\u76D8\u800C\u975E\u6253\u5370\u5230 stdout\uFF0C\u4E0D\u80FD\u7BA1\u9053\u7ED9 python/jq\u3002\n   \u793A\u4F8B\uFF1Asiluzan-tso ad campaigns -a <id> --json-out ./snap\n   \u7136\u540E\u7528 node/python \u8BFB ./snap \u4E0B writtenFiles\uFF08\u89C1 stdout \u6458\u8981\u7684 absoluteSnapshotDir\uFF09\u3002\n";
+  }
   const cmd = args[0];
   if (cmd === "google-ads") {
-    return "\n\u274C \u6CA1\u6709 `google-ads` \u547D\u540D\u7A7A\u95F4\u3002\u8BF7\u6539\u7528\uFF1A\n   - \u8D26\u6237\u5206\u6790\u62C9\u6570\uFF1Asiluzan-tso google-analysis \u2026\n   - \u5E7F\u544A\u7CFB\u5217/\u7EC4/\u5173\u952E\u8BCD CRUD\uFF1Asiluzan-tso ad \u2026\n   - \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF1Asiluzan-tso google-ads-diagnosis \u2026\n";
+    return "\n\u274C \u6CA1\u6709 `google-ads` \u547D\u540D\u7A7A\u95F4\u3002\u8BF7\u6539\u7528\uFF1A\n   - \u8D26\u6237\u5206\u6790\u62C9\u6570\uFF1Asiluzan-tso google-analysis \u2026\n   - \u5E7F\u544A\u7CFB\u5217/\u7EC4/\u521B\u610F/\u5173\u952E\u8BCD\uFF1Asiluzan-tso ad campaigns|groups|list|keywords \u2026\n     \uFF08\u6CA1\u6709 campaign-list\uFF1B\u5217\u8868\u547D\u4EE4\u662F campaigns / groups / list / keywords\uFF09\n   - \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF1Asiluzan-tso google-ads-diagnosis \u2026\n";
   }
   if (cmd === "list" && (args.length === 1 || args[1]?.startsWith("-"))) {
     return "\n\u274C \u6CA1\u6709\u9876\u5C42 `list` \u547D\u4EE4\u3002\u67E5\u8BE2\u5E7F\u544A\u8D26\u6237\u5217\u8868\u8BF7\u7528\uFF1A\n   siluzan-tso list-accounts [-m Google] [-k <id\u6216\u5173\u952E\u5B57>] --json-out <dir>\n";

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.39-beta.3",
-  "publishedAt": 1785132603059
+  "version": "1.1.39-beta.4",
+  "publishedAt": 1785134480606
 }

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

@@ -42,7 +42,12 @@
 siluzan-tso ad campaigns -a <accountId> [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--json-out ./snap]
 ```
 
-落盘 JSON 中 **`budget` 为日预算**（主币种「元」，CLI 已 ÷100），另有 `statusDisplay`（状态文案）。
+落盘 JSON 中 **`budget` 为日预算**（主币种「元」，CLI 已 ÷100），另有 **`statusV2`**（`Enabled`/`Paused`/`Removed`）与 **`statusDisplay`**（`{statusV2}·日程文案`，如 `Enabled·有效`、`Enabled·投放期已结束`、`Removed·已删除`）。
+
+> **消歧**：`statusDisplay` 含「投放期已结束」**不是**系列已删除——以 **`statusV2`** 为准；仅 `Removed` 才不可在其下新建组/广告。日程结束仍可 `ad-create`（是否投放另看预算与系列开关）。
+
+命令名：列表是 **`ad campaigns`**（兼容别名 `campaign-list`），**没有** `google-ads` 命名空间。`--json-out` **必须带路径**（落盘，勿管道 stdout）。
+
 带 `--start` / `--end` 时，同行的 **`spend` / `impressions` / `clicks` / `conversions` 为该闭区间合计**（**不是**日消耗）。
 与日预算比较「是否超预算」时，**必须** `start=end=统计日`；多日窗口须先 ÷ 天数或改用 `balance-scan.dailySpend` / `overview.averageDailyCost` 再谈「日均」。
 
@@ -135,6 +140,8 @@ siluzan-tso ad list -a <accountId> [--start/--end <date>] [--include-deleted] [-
 
 ### 创建（RSA）
 
+写操作细节与 `--commit` 见 `google-ads-write.md`（**ad ad-create**）。CLI **提交前本地校验**字数/条数，超限直接失败、不打 API。
+
 ```bash
 siluzan-tso ad ad-create \
   -a <accountId> \
@@ -143,10 +150,17 @@ siluzan-tso ad ad-create \
   --headlines "标题1,标题2,标题3" \
   --descriptions "描述1,描述2" \
   [--path1 <≤15字符>] [--path2 <≤15字符>] \
+  --commit "创建 RSA …" \
   [--json-out <path>]
 ```
 
-`--headlines` 至少 3 条（≤30字符），`--descriptions` 至少 2 条（≤90字符）。**`--json-out`** 落盘返回网关响应（含 `id` 等字段），便于批量脚本拿到 adId 后续编辑/启停。
+| 字段 | 数量 | 每条上限（Google 字符宽，CJK×2） |
+| ---- | ---- | -------------------------------- |
+| `--headlines` | **3–15** | **≤30** |
+| `--descriptions` | **2–4** | **≤90** |
+| `--path1`/`--path2` | 可选 | **≤15** |
+
+提交前用脚本 `len`/CJK×2 自检；**禁止**一次塞入 >4 条描述。创建后暂停：`ad ad-status … --status Paused --commit "…"`。
 
 ### 启停 / 删除
 

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

@@ -7,11 +7,20 @@
 
 - 新建搜索系列 / PMax
 - campaign-validate / campaign-create / campaign-edit
-- 组/创意/关键词写操作
+- **ad ad-create（RSA）** / ad-edit / 组/关键词写操作
 - extension / device-bid
 
 ---
 
+## 写操作硬纪律（Agent 易踩）
+
+- **必须** `--commit "…"`；漏了会直接失败。
+- 列表命令：`ad campaigns` / `ad groups` / `ad list` / `ad keywords`（**没有** `google-ads`、没有必用 `campaign-list`；`campaign-list` 仅为 `campaigns` 别名）。
+- `--json-out <path>`：**路径必填**，JSON 落盘；禁止 `--json-out` 裸用或管道 stdout。
+- 系列 `statusDisplay` 含「投放期已结束」≠ 已删除；以 JSON **`statusV2`** 为准（见 `google-ads-read.md`）。
+
+---
+
 ## 金额单位（全局重要）
 
 > **所有 CLI 金额参数均按「主币种金额」传入**（如 `1.5` = ¥1.50 / $1.50）；CLI 写入网关前对「分」字段 ×100（含 `ad keyword-edit --max-cpc` → `maxCPC`）。
@@ -240,6 +249,34 @@ siluzan-tso ad adgroup-rename -a <accountId> --id <adGroupId> --name <新名称>
 
 ---
 
+## ad ad-create — 创建自适应搜索广告（RSA）
+
+在已有广告组下新增 RSA。提交前 CLI **本地校验**字数/条数（超限不打 API）。
+
+```bash
+siluzan-tso ad ad-create \
+  -a <accountId> \
+  --adgroup-id <adGroupId> --adgroup-name <adGroupName> \
+  --final-url <https://...> \
+  --headlines "H1,H2,H3,..." \
+  --descriptions "D1,D2[,D3,D4]" \
+  [--path1 <p1>] [--path2 <p2>] \
+  --commit "在 <组名> 下创建 RSA …" \
+  [--json-out <path>]
+```
+
+| 约束 | 值 |
+| ---- | -- |
+| headlines | **3–15** 条，每条 **≤30** Google 字符（CJK×2） |
+| descriptions | **2–4** 条，每条 **≤90** Google 字符（CJK×2） |
+| path1/path2 | 可选，各 **≤15** |
+
+创建后暂停：`ad ad-status -a <accountId> --id <adId> --status Paused --commit "创建后暂停"`。若列表找不到新广告，给 `ad-status` / `ad list` 加宽 `--start`/`--end`。
+
+文案合规见 `rules/google-ads-compliance-copy.md`。
+
+---
+
 ## ad ad-edit — 广告创意编辑
 
 先用 `ad list --json-out ./snap` 取得完整 JSON，再只修改传入字段，未改字段从列表原值带回。

package/dist/skill/references/report-templates/google-period-report.md

@@ -120,4 +120,4 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
 | 直接展示 `row.campaignStatusDisplay`                                              | 读 `campaignStatus` 后自行 `MAP[s] \|\| '已移除'`（`Enabled` 未命中键时会全变「已移除」） |
 | 需要英文枚举时读 `campaignStatus` 或 `campaignStatusV2`，展示前 `.upper()` 再映射 | 用 `stats` / `list-accounts` 的账户 `status` 充当系列状态                                 |
 
-原始枚举为 PascalCase（`Enabled`），与 `ad campaigns` 的 `statusDisplay`（有效/未投放/已结束使用）口径不同；周期报告「状态」列统一用 **`campaignStatusDisplay`**。
+原始枚举为 PascalCase（`Enabled`），与 `ad campaigns` 的 `statusDisplay`（如 `Enabled·有效` / `Enabled·投放期已结束`）口径不同；周期报告「状态」列统一用 **`campaignStatusDisplay`**。

package/dist/skill/report-templates/google-period-report.md

@@ -120,4 +120,4 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
 | 直接展示 `row.campaignStatusDisplay`                                              | 读 `campaignStatus` 后自行 `MAP[s] \|\| '已移除'`（`Enabled` 未命中键时会全变「已移除」） |
 | 需要英文枚举时读 `campaignStatus` 或 `campaignStatusV2`，展示前 `.upper()` 再映射 | 用 `stats` / `list-accounts` 的账户 `status` 充当系列状态                                 |
 
-原始枚举为 PascalCase（`Enabled`），与 `ad campaigns` 的 `statusDisplay`（有效/未投放/已结束使用）口径不同；周期报告「状态」列统一用 **`campaignStatusDisplay`**。
+原始枚举为 PascalCase（`Enabled`），与 `ad campaigns` 的 `statusDisplay`（如 `Enabled·有效` / `Enabled·投放期已结束`）口径不同；周期报告「状态」列统一用 **`campaignStatusDisplay`**。

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.39-beta.3'
+$PKG_VERSION = '1.1.39-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.39-beta.3"
+readonly PKG_VERSION="1.1.39-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.39-beta.3",
+  "version": "1.1.39-beta.4",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",