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

package/README.md

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

package/dist/index.js

@@ -104889,18 +104889,68 @@ async function writeProgress(paths, progress) {
 function readProgress(paths) {
   return readJsonIfExists(paths.progressFile);
 }
-async function appendTaskLog(paths, entry) {
+function clampTaskLogEntry(entry) {
+  const message = entry.lastError;
+  if (!message || message.length <= MAX_TASK_LOG_ERROR_CHARS) return entry;
+  return {
+    ...entry,
+    lastError: `${message.slice(0, MAX_TASK_LOG_ERROR_CHARS)}\u2026(truncated)`
+  };
+}
+function isTaskLogEntry(value) {
+  if (!value || typeof value !== "object") return false;
+  const row = value;
+  return typeof row.at === "string" && typeof row.id === "string" && typeof row.accountId === "string" && typeof row.section === "string" && typeof row.state === "string" && TASK_LOG_STATES.has(row.state) && typeof row.attempts === "number";
+}
+async function writeTaskLogLine(paths, entry) {
   await fs31.mkdir(paths.stateDir, { recursive: true });
-  await fs31.appendFile(paths.tasksLogFile, JSON.stringify(entry) + "\n", "utf8");
+  await fs31.appendFile(paths.tasksLogFile, JSON.stringify(clampTaskLogEntry(entry)) + "\n", "utf8");
+}
+async function appendTaskLog(paths, entry) {
+  const file = paths.tasksLogFile;
+  const prev = taskLogAppendQueue.get(file) ?? Promise.resolve();
+  const current = prev.then(() => writeTaskLogLine(paths, entry));
+  taskLogAppendQueue.set(
+    file,
+    current.then(
+      () => void 0,
+      () => void 0
+    )
+  );
+  await current;
 }
 async function readTaskLog(paths) {
+  let raw;
   try {
-    const raw = await fs31.readFile(paths.tasksLogFile, "utf8");
-    return raw.split("\n").filter((s) => s.trim() !== "").map((line) => JSON.parse(line));
+    raw = await fs31.readFile(paths.tasksLogFile, "utf8");
   } catch (e) {
     if (e.code === "ENOENT") return [];
     throw e;
   }
+  const entries = [];
+  let skipped = 0;
+  for (const line of raw.split("\n")) {
+    const text2 = line.trim();
+    if (!text2) continue;
+    try {
+      const parsed = JSON.parse(text2);
+      if (!isTaskLogEntry(parsed)) {
+        skipped += 1;
+        continue;
+      }
+      entries.push(parsed);
+    } catch {
+      skipped += 1;
+    }
+  }
+  if (skipped > 0) {
+    process.stderr.write(
+      `
+\u26A0\uFE0F tasks.jsonl \u6709 ${skipped} \u884C\u65E0\u6CD5\u89E3\u6790\uFF0C\u5DF2\u8DF3\u8FC7\u3002\u6CA1\u6709\u5B8C\u6574\u6210\u529F\u8BB0\u5F55\u7684\u4EFB\u52A1\u4F1A\u5728 resume \u65F6\u91CD\u8DD1\u3002
+`
+    );
+  }
+  return entries;
 }
 function replayTaskStates(entries) {
   const map = /* @__PURE__ */ new Map();
@@ -104964,11 +105014,21 @@ async function tryAcquireLock(paths) {
 async function releaseLock(paths) {
   await fs31.rm(paths.lockFile, { force: true }).catch(() => void 0);
 }
-var BATCH_SCHEMA_VERSION;
+var BATCH_SCHEMA_VERSION, MAX_TASK_LOG_ERROR_CHARS, TASK_LOG_STATES, taskLogAppendQueue;
 var init_batch_manifest = __esm({
   "src/utils/batch-manifest.ts"() {
     "use strict";
     BATCH_SCHEMA_VERSION = 1;
+    MAX_TASK_LOG_ERROR_CHARS = 500;
+    TASK_LOG_STATES = /* @__PURE__ */ new Set([
+      "pending",
+      "running",
+      "success",
+      "failed_retryable",
+      "failed_permanent",
+      "skipped"
+    ]);
+    taskLogAppendQueue = /* @__PURE__ */ new Map();
   }
 });
 
@@ -113899,8 +113959,68 @@ init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
 
+// src/commands/ad/search-field-patch.ts
+function buildSearchFieldPatch(pairs) {
+  const updateMask = [];
+  const fields = {};
+  for (const [name2, value] of pairs) {
+    updateMask.push(name2);
+    fields[name2] = value;
+  }
+  return { updateMask, fields };
+}
+function campaignEditPatchPairs(input) {
+  const pairs = [];
+  if (input.name !== void 0) pairs.push(["name", input.name]);
+  if (input.budgetCents !== void 0) pairs.push(["budgetAmount", input.budgetCents]);
+  if (input.biddingStrategyTypeV2 !== void 0) {
+    pairs.push(["biddingStrategyTypeV2", input.biddingStrategyTypeV2]);
+  }
+  if (input.targetSpendBidCeilingCents !== void 0) {
+    pairs.push(["targetSpend_BidCeilingAmount", input.targetSpendBidCeilingCents]);
+  }
+  if (input.targetCpaCents !== void 0) {
+    pairs.push(["targetCpa_BidingAmount", input.targetCpaCents]);
+  }
+  if (input.targetRoas !== void 0) pairs.push(["targetRoas", input.targetRoas]);
+  if (input.manualCpcEnhanced !== void 0) {
+    pairs.push(["manualCpc_EnhancedCpcEnabled", input.manualCpcEnhanced]);
+  }
+  return pairs;
+}
+function campaignStatusPatchPairs(status) {
+  return [["status", status]];
+}
+function adGroupEditPatchPairs(input) {
+  const pairs = [];
+  if (input.name !== void 0) pairs.push(["name", input.name]);
+  if (input.maxCpcCents !== void 0) pairs.push(["maxCpc", input.maxCpcCents]);
+  if (input.targetCpaCents !== void 0) pairs.push(["targetCpa", input.targetCpaCents]);
+  return pairs;
+}
+function adGroupStatusPatchPairs(status) {
+  return [["status", status]];
+}
+function keywordFieldPatchPairs(input) {
+  const pairs = [];
+  if (input.status !== void 0) pairs.push(["userStatus", input.status]);
+  if (input.maxCpcCents !== void 0) pairs.push(["maxCpc", input.maxCpcCents]);
+  if (input.finalUrl !== void 0) pairs.push(["finalUrl", input.finalUrl]);
+  return pairs;
+}
+function adEditPatchPairs(input) {
+  const pairs = [];
+  if (input.status !== void 0) pairs.push(["status", input.status]);
+  if (input.finalUrl !== void 0) pairs.push(["finalUrl", input.finalUrl]);
+  if (input.headlines !== void 0) pairs.push(["headlines", [...input.headlines]]);
+  if (input.descriptions !== void 0) pairs.push(["descriptions", [...input.descriptions]]);
+  if (input.path1 !== void 0) pairs.push(["path1", input.path1]);
+  if (input.path2 !== void 0) pairs.push(["path2", input.path2]);
+  return pairs;
+}
+
 // src/commands/ad/write-verification.ts
-var CAMPAIGN_WRITE_SCOPE = "gateway-full-put";
+var CAMPAIGN_WRITE_SCOPE = "search-field-patch";
 function sameWriteValue(expected, actual) {
   if (expected === actual) return true;
   if (typeof expected === "string" && typeof actual === "string") {
@@ -114537,71 +114657,91 @@ async function runAdKeywordEdit(opts) {
     );
     process.exit(1);
   }
+  const patchPairs = keywordFieldPatchPairs({
+    status: opts.status,
+    maxCpcCents: opts.maxCpc !== void 0 ? toCentAmount(opts.maxCpc) : void 0,
+    finalUrl: opts.finalUrl
+  });
+  const replacesText = opts.text !== void 0 || opts.matchType !== void 0;
   const params = new URLSearchParams();
   params.set("startDate", toGoogleDate(opts.startDate, -30));
   params.set("endDate", toGoogleDate(opts.endDate, 0));
   const listUrl = `${googleApiUrl}/keywordmanagement/v2/list/${opts.account}?${params}`;
-  let keyword;
-  try {
-    keyword = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const body = { ...keyword };
-  if (opts.matchType !== void 0) {
-    const base = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
-    if (!String(base).trim()) {
-      console.error("\n\u274C \u65E0\u6CD5\u89E3\u6790\u5F53\u524D\u5173\u952E\u8BCD\u6587\u6848\uFF0C\u8BF7\u540C\u65F6\u4F20 --text <\u8BCD\u5E72>\n");
-      process.exit(1);
-    }
-    body["keywordText"] = [formatKeywordTextForMatchType(base, opts.matchType)];
-    body["matchTypeV2"] = opts.matchType;
-  } else if (opts.text !== void 0) {
-    body["keywordText"] = [opts.text];
-  }
-  if (opts.maxCpc !== void 0) body["maxCPC"] = toCentAmount(opts.maxCpc);
-  if (opts.finalUrl !== void 0) body["finalURL"] = opts.finalUrl;
-  if (opts.status !== void 0) body["userStatusV2"] = opts.status;
   const notAppliedHint = `   \u8BF7\u52FF\u6539\u7528\u300C\u5220\u9664\u540E\u91CD\u5EFA\u300D\u7ED5\u8FC7\uFF08\u4F1A\u4E22\u5931\u5173\u952E\u8BCD id \u4E0E\u5386\u53F2\u6570\u636E\uFF09\uFF0C\u8BF7\u53CD\u9988\u5E73\u53F0\u6392\u67E5\u3002
 `;
-  const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
   let currentId = opts.id;
-  try {
-    const raw = await apiFetch2(
-      url,
-      config,
-      { method: "PUT", body: JSON.stringify([body]) },
-      opts.verbose
-    );
-    const first = Array.isArray(raw) && raw.length > 0 && raw[0] && typeof raw[0] === "object" ? raw[0] : null;
-    const returnedId = first && typeof first["id"] === "string" ? first["id"] : void 0;
-    if (returnedId && returnedId !== opts.id) {
-      currentId = returnedId;
-      console.log(
-        `
-\u2139\uFE0F \u7F51\u5173\u8FD4\u56DE\u7684\u5173\u952E\u8BCD id \u5DF2\u53D8\u66F4\u4E3A ${returnedId}\uFF08\u8BF7\u6C42\u65F6 id \u4E3A ${opts.id}\uFF0CchangeKind=replace\uFF09\uFF0C\u540E\u7EED\u67E5\u8BE2\u8BF7\u4F7F\u7528\u65B0 id\u3002
-`
+  if (replacesText) {
+    let keyword;
+    try {
+      keyword = await findItemInList(
+        listUrl,
+        config,
+        opts.id,
+        opts.verbose
       );
+    } catch (err) {
+      console.error(`
+\u274C \u67E5\u8BE2\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
     }
-    const mismatches = first ? findKeywordEditMismatches(body, first, opts) : [];
-    if (mismatches.length > 0) {
-      console.error(
-        `
-\u274C \u7F51\u5173\u8FD4\u56DE\u6210\u529F\uFF0C\u4F46\u4EE5\u4E0B\u5B57\u6BB5\u672A\u751F\u6548\uFF1A
-${mismatches.map((m) => `   - ${m}`).join("\n")}
-` + notAppliedHint
+    const body = { ...keyword };
+    if (opts.matchType !== void 0) {
+      const base = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
+      if (!String(base).trim()) {
+        console.error("\n\u274C \u65E0\u6CD5\u89E3\u6790\u5F53\u524D\u5173\u952E\u8BCD\u6587\u6848\uFF0C\u8BF7\u540C\u65F6\u4F20 --text <\u8BCD\u5E72>\n");
+        process.exit(1);
+      }
+      body["keywordText"] = [formatKeywordTextForMatchType(base, opts.matchType)];
+      body["matchTypeV2"] = opts.matchType;
+    } else if (opts.text !== void 0) {
+      body["keywordText"] = [opts.text];
+    }
+    const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
+    try {
+      const raw = await apiFetch2(
+        url,
+        config,
+        { method: "PUT", body: JSON.stringify([body]) },
+        opts.verbose
       );
+      const first = Array.isArray(raw) && raw.length > 0 && raw[0] && typeof raw[0] === "object" ? raw[0] : null;
+      const returnedId = first && typeof first["id"] === "string" ? first["id"] : void 0;
+      if (returnedId && returnedId !== opts.id) {
+        currentId = returnedId;
+        console.log(
+          `
+\u2139\uFE0F \u7F51\u5173\u8FD4\u56DE\u7684\u5173\u952E\u8BCD id \u5DF2\u53D8\u66F4\u4E3A ${returnedId}\uFF08\u8BF7\u6C42\u65F6 id \u4E3A ${opts.id}\uFF0CchangeKind=replace\uFF09\uFF0C\u540E\u7EED\u67E5\u8BE2\u8BF7\u4F7F\u7528\u65B0 id\u3002
+`
+        );
+      }
+    } catch (err) {
+      console.error(`
+\u274C \u7F16\u8F91\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
       process.exit(1);
     }
-  } catch (err) {
-    console.error(`
+  }
+  if (patchPairs.length > 0) {
+    const patchUrl = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/${currentId}`;
+    try {
+      await apiFetch2(
+        patchUrl,
+        config,
+        { method: "PATCH", body: JSON.stringify(buildSearchFieldPatch(patchPairs)) },
+        opts.verbose
+      );
+    } catch (err) {
+      console.error(`
 \u274C \u7F16\u8F91\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
 `);
-    process.exit(1);
+      process.exit(1);
+    }
   }
+  const readbackExpected = {
+    finalURL: opts.finalUrl,
+    maxCPC: opts.maxCpc !== void 0 ? toCentAmount(opts.maxCpc) : void 0
+  };
   if (opts.finalUrl !== void 0 || opts.maxCpc !== void 0 || opts.status !== void 0) {
     let fresh;
     try {
@@ -114620,7 +114760,7 @@ ${mismatches.map((m) => `   - ${m}`).join("\n")}
       );
       process.exit(1);
     }
-    const mismatches = findKeywordEditMismatches(body, fresh, opts);
+    const mismatches = findKeywordEditMismatches(readbackExpected, fresh, opts);
     if (mismatches.length > 0) {
       console.error(
         `
@@ -114658,26 +114798,17 @@ async function runAdKeywordStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/keywordmanagement/v2/list/${opts.account}?${params}`;
-  let keyword;
-  try {
-    keyword = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const body = { ...keyword, userStatusV2: opts.status };
-  const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
+  const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/${opts.id}`;
   try {
     await apiFetch2(
       url,
       config,
-      { method: "PUT", body: JSON.stringify([body]) },
+      {
+        method: "PATCH",
+        body: JSON.stringify(
+          buildSearchFieldPatch(keywordFieldPatchPairs({ status: opts.status }))
+        )
+      },
       opts.verbose
     );
   } catch (err) {
@@ -116331,7 +116462,7 @@ async function reportFailedCampaignPut(opts) {
 `);
     process.exit(1);
   }
-  const hint = judged.kind === "partial" ? "\u56DE\u8BFB\u9884\u7B97\u5DF2\u76F8\u5BF9\u63D0\u4EA4\u524D\u53D8\u5316\u3002\u9884\u7B97\u53EF\u80FD\u5DF2\u5199\u5165\uFF0C\u7CFB\u5217\u5176\u4F59\u66F4\u65B0\u672A\u5B8C\u6210\u3002\u4E0D\u8981\u6574\u5305\u91CD\u63D0\u3002" : "\u56DE\u8BFB\u5931\u8D25\u6216\u65E0\u6CD5\u5BF9\u6BD4\u9884\u7B97\uFF0C\u5199\u5165\u7ED3\u679C\u672A\u77E5\u3002\u4E0D\u8981\u6574\u5305\u91CD\u63D0\u3002";
+  const hint = judged.kind === "partial" ? "\u56DE\u8BFB\u9884\u7B97\u5DF2\u76F8\u5BF9\u63D0\u4EA4\u524D\u53D8\u5316\u3002\u9884\u7B97\u53EF\u80FD\u5DF2\u5199\u5165\uFF0C\u5176\u4F59\u66F4\u65B0\u672A\u5B8C\u6210\u3002\u4E0D\u8981\u7ACB\u523B\u91CD\u53D1\u3002" : "\u56DE\u8BFB\u5931\u8D25\u6216\u65E0\u6CD5\u5BF9\u6BD4\u9884\u7B97\uFF0C\u5199\u5165\u7ED3\u679C\u672A\u77E5\u3002\u4E0D\u8981\u7ACB\u523B\u91CD\u53D1\u3002";
   await reportCampaignWrite({
     jsonOut: opts.jsonOut,
     account: opts.account,
@@ -116403,9 +116534,14 @@ async function runAdCampaignStatus(opts) {
     );
     process.exit(1);
   }
-  const body = { ...campaign, statusV2: opts.status };
+  const body = buildSearchFieldPatch(campaignStatusPatchPairs(opts.status));
   try {
-    await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(
+      detailUrl,
+      config,
+      { method: "PATCH", body: JSON.stringify(body) },
+      opts.verbose
+    );
   } catch (err) {
     await reportFailedCampaignPut({
       err,
@@ -116721,24 +116857,17 @@ async function runAdCampaignEdit(opts) {
     );
     process.exit(1);
   }
-  const body = { ...campaign };
-  if (opts.name !== void 0) body["name"] = opts.name;
-  if (opts.budget !== void 0) body["budget"] = toCentAmount(opts.budget);
-  if (opts.biddingStrategy !== void 0) {
-    body["biddingStrategyTypeV2"] = opts.biddingStrategy.toUpperCase();
-  }
-  if (opts.targetSpendBidCeiling !== void 0)
-    body["targetSpend_BidCeilingAmount"] = toCentAmount(opts.targetSpendBidCeiling);
-  if (opts.targetCpa !== void 0) body["targetCpa_BidingAmount"] = toCentAmount(opts.targetCpa);
-  if (opts.targetRoas !== void 0) body["targetRoas"] = opts.targetRoas;
-  if (opts.manualCpcEnhanced !== void 0)
-    body["manualCpc_EnhancedCpcEnabled"] = opts.manualCpcEnhanced;
-  if (opts.targetSearchNetwork !== void 0)
-    body["targetSearchNetwork"] = opts.targetSearchNetwork;
-  if (opts.targetContentNetwork !== void 0)
-    body["targetContentNetwork"] = opts.targetContentNetwork;
-  const hasChange = opts.name !== void 0 || opts.budget !== void 0 || opts.biddingStrategy !== void 0 || opts.targetSpendBidCeiling !== void 0 || opts.targetCpa !== void 0 || opts.targetRoas !== void 0 || opts.manualCpcEnhanced !== void 0 || opts.targetSearchNetwork !== void 0 || opts.targetContentNetwork !== void 0;
-  if (!hasChange) {
+  const patchPairs = campaignEditPatchPairs({
+    name: opts.name,
+    budgetCents: opts.budget !== void 0 ? toCentAmount(opts.budget) : void 0,
+    biddingStrategyTypeV2: opts.biddingStrategy?.toUpperCase(),
+    targetSpendBidCeilingCents: opts.targetSpendBidCeiling !== void 0 ? toCentAmount(opts.targetSpendBidCeiling) : void 0,
+    targetCpaCents: opts.targetCpa !== void 0 ? toCentAmount(opts.targetCpa) : void 0,
+    targetRoas: opts.targetRoas,
+    manualCpcEnhanced: opts.manualCpcEnhanced
+  });
+  const wantsNetwork = opts.targetSearchNetwork !== void 0 || opts.targetContentNetwork !== void 0;
+  if (patchPairs.length === 0 && !wantsNetwork) {
     console.error("\n\u274C \u8BF7\u81F3\u5C11\u6307\u5B9A\u4E00\u4E2A\u4FEE\u6539\u9879\uFF08--name / --budget / --bidding / \u2026\uFF09\n");
     process.exit(1);
   }
@@ -116748,23 +116877,66 @@ async function runAdCampaignEdit(opts) {
     );
     process.exit(1);
   }
-  try {
-    await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    await reportFailedCampaignPut({
-      err,
-      detailUrl,
-      config,
-      verbose: opts.verbose,
-      budgetCentsBefore: readCampaignBudgetCents(campaign),
-      jsonOut: opts.jsonOut,
-      account: opts.account,
-      id: opts.id,
-      section: "ad-campaign-edit",
-      commandLabel: "ad campaign-edit",
-      failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
-    });
-    return;
+  if (patchPairs.length > 0) {
+    try {
+      await apiFetch2(
+        detailUrl,
+        config,
+        {
+          method: "PATCH",
+          body: JSON.stringify(buildSearchFieldPatch(patchPairs))
+        },
+        opts.verbose
+      );
+    } catch (err) {
+      await reportFailedCampaignPut({
+        err,
+        detailUrl,
+        config,
+        verbose: opts.verbose,
+        budgetCentsBefore: readCampaignBudgetCents(campaign),
+        jsonOut: opts.jsonOut,
+        account: opts.account,
+        id: opts.id,
+        section: "ad-campaign-edit",
+        commandLabel: "ad campaign-edit",
+        failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
+      });
+      return;
+    }
+  }
+  if (wantsNetwork) {
+    try {
+      const fresh = await fetchCampaignRecord(detailUrl, config, opts.verbose);
+      const networkBody = { ...fresh };
+      if (opts.targetSearchNetwork !== void 0) {
+        networkBody["targetSearchNetwork"] = opts.targetSearchNetwork;
+      }
+      if (opts.targetContentNetwork !== void 0) {
+        networkBody["targetContentNetwork"] = opts.targetContentNetwork;
+      }
+      await apiFetch2(
+        detailUrl,
+        config,
+        { method: "PUT", body: JSON.stringify(networkBody) },
+        opts.verbose
+      );
+    } catch (err) {
+      await reportFailedCampaignPut({
+        err,
+        detailUrl,
+        config,
+        verbose: opts.verbose,
+        budgetCentsBefore: readCampaignBudgetCents(campaign),
+        jsonOut: opts.jsonOut,
+        account: opts.account,
+        id: opts.id,
+        section: "ad-campaign-edit",
+        commandLabel: "ad campaign-edit",
+        failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
+      });
+      return;
+    }
   }
   const parts = [];
   if (opts.name !== void 0) parts.push(`\u540D\u79F0\u2192${opts.name}`);
@@ -116954,26 +117126,15 @@ async function runAdGroupStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
-  let adgroup;
-  try {
-    adgroup = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
-  const body = { ...adgroup, statusV2: opts.status };
-  try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u72B6\u6001\u66F4\u65B0\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
+  await patchAdGroup(
+    googleApiUrl,
+    config,
+    opts.account,
+    opts.id,
+    adGroupStatusPatchPairs(opts.status),
+    opts.verbose,
+    "\u72B6\u6001\u66F4\u65B0\u5931\u8D25"
+  );
   console.log(`
 \u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u8BBE\u7F6E\u4E3A ${opts.status}
 `);
@@ -117009,26 +117170,15 @@ async function runAdGroupRename(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
-  let adgroup;
-  try {
-    adgroup = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
-  const body = { ...adgroup, name: opts.name };
-  try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u6539\u540D\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
+  await patchAdGroup(
+    googleApiUrl,
+    config,
+    opts.account,
+    opts.id,
+    adGroupEditPatchPairs({ name: opts.name }),
+    opts.verbose,
+    "\u6539\u540D\u5931\u8D25"
+  );
   console.log(`
 \u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u6539\u540D\u4E3A\u300C${opts.name}\u300D
 `);
@@ -117052,32 +117202,38 @@ async function runAdGroupEdit(opts) {
   }
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
-  let adgroup;
-  try {
-    adgroup = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+  await patchAdGroup(
+    googleApiUrl,
+    config,
+    opts.account,
+    opts.id,
+    adGroupEditPatchPairs({
+      name: hasName ? opts.name.trim() : void 0,
+      maxCpcCents: hasMax ? toCentAmount(opts.maxCPCAmount) : void 0,
+      targetCpaCents: hasTcpa ? toCentAmount(opts.targetCpaAmount) : void 0
+    }),
+    opts.verbose,
+    "\u7F16\u8F91\u5E7F\u544A\u7EC4\u5931\u8D25"
+  );
+  console.log(`
+\u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u66F4\u65B0
 `);
-    process.exit(1);
-  }
-  const body = { ...adgroup };
-  if (hasName) body["name"] = opts.name.trim();
-  if (hasMax) body["maxCPCAmount"] = toCentAmount(opts.maxCPCAmount);
-  if (hasTcpa) body["targetCpaAmount"] = toCentAmount(opts.targetCpaAmount);
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
+}
+async function patchAdGroup(googleApiUrl, config, account, id, pairs, verbose, failureLabel) {
+  const url = `${googleApiUrl}/adgroupnmanagement/adgroup/${account}/${id}`;
   try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(
+      url,
+      config,
+      { method: "PATCH", body: JSON.stringify(buildSearchFieldPatch(pairs)) },
+      verbose
+    );
   } catch (err) {
     console.error(`
-\u274C \u7F16\u8F91\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+\u274C ${failureLabel}\uFF1A${err instanceof Error ? err.message : String(err)}
 `);
     process.exit(1);
   }
-  console.log(`
-\u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u66F4\u65B0
-`);
 }
 
 // src/commands/ad/ad-creative.ts
@@ -117304,23 +117460,17 @@ async function runAdStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/admanagement/v2/list/${opts.account}?${params}`;
-  let ad;
-  try {
-    ad = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const putUrl = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
-  const body = { ...ad, statusV2: opts.status };
+  const url = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
   try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(
+      url,
+      config,
+      {
+        method: "PATCH",
+        body: JSON.stringify(buildSearchFieldPatch(adEditPatchPairs({ status: opts.status })))
+      },
+      opts.verbose
+    );
   } catch (err) {
     console.error(`
 \u274C \u72B6\u6001\u66F4\u65B0\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
@@ -117361,6 +117511,11 @@ async function runAdDelete(opts) {
 \u2705 \u5E7F\u544A ${opts.id} \u5DF2\u5220\u9664
 `);
 }
+function emptyPathClears(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? null : trimmed;
+}
 async function runAdEdit(opts) {
   opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
@@ -117382,40 +117537,19 @@ async function runAdEdit(opts) {
     console.error(formatRsaCliValidationError(rsaErrors));
     process.exit(1);
   }
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/admanagement/v2/list/${opts.account}?${params}`;
-  let ad;
-  try {
-    ad = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const body = { ...ad };
-  if (opts.headlines) {
-    const [h1, h2, h3, ...more] = opts.headlines;
-    body["headlinePart1"] = h1;
-    body["headlinePart2"] = h2;
-    body["headlinePart3"] = h3;
-    if (more.length > 0) body["AddtionalHeadlines"] = more;
-  }
-  if (opts.descriptions) {
-    const [d1, d2, ...more] = opts.descriptions;
-    body["adDescription"] = d1;
-    body["adDescription2"] = d2;
-    if (more.length > 0) body["AddtionalAdDescriptions"] = more;
-  }
-  if (opts.finalUrl !== void 0) body["finalUrl"] = opts.finalUrl;
-  if (opts.path1 !== void 0) body["path1"] = opts.path1;
-  if (opts.path2 !== void 0) body["path2"] = opts.path2;
-  if (opts.status !== void 0) body["statusV2"] = opts.status;
-  const putUrl = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
+  const url = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
+  const body = buildSearchFieldPatch(
+    adEditPatchPairs({
+      status: opts.status,
+      finalUrl: opts.finalUrl,
+      headlines: opts.headlines,
+      descriptions: opts.descriptions,
+      path1: emptyPathClears(opts.path1),
+      path2: emptyPathClears(opts.path2)
+    })
+  );
   try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(url, config, { method: "PATCH", body: JSON.stringify(body) }, opts.verbose);
   } catch (err) {
     console.error(`
 \u274C \u7F16\u8F91\u5E7F\u544A\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
@@ -124642,7 +124776,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("campaign-status").description("\u5207\u6362\u5E7F\u544A\u7CFB\u5217\u72B6\u6001\uFF08Enabled / Paused\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=gateway-full-put\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  adCmd.command("campaign-status").description("\u5207\u6362\u5E7F\u544A\u7CFB\u5217\u72B6\u6001\uFF08Enabled / Paused\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=search-field-patch\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.status !== "Enabled" && opts.status !== "Paused") {
         console.error("\n\u274C --status \u53EA\u63A5\u53D7 Enabled \u6216 Paused\n");
@@ -125148,7 +125282,9 @@ function register21(program2) {
       verbose: opts.verbose
     });
   });
-  adCmd.command("campaign-edit").description("\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\uFF08\u540D\u79F0/\u9884\u7B97/\u51FA\u4EF7\u7B56\u7565/\u6295\u653E\u7F51\u7EDC\uFF0C\u81F3\u5C11\u4F20\u4E00\u4E2A\u4FEE\u6539\u9879\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
+  adCmd.command("campaign-edit").description(
+    "\u7F16\u8F91\u641C\u7D22\u5E7F\u544A\u7CFB\u5217\u3002\u540D\u79F0/\u9884\u7B97/\u51FA\u4EF7\u8D70\u5B57\u6BB5\u7EA7 PATCH\uFF1B\u6295\u653E\u7F51\u7EDC\u4ECD\u7528\u6574\u5305 PUT\u3002\u81F3\u5C11\u4F20\u4E00\u4E2A\u4FEE\u6539\u9879"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
     "--budget <amount>",
     "\u65B0\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 100 \u8868\u793A \xA5100\uFF1B\u652F\u6301\u5C0F\u6570\uFF1BCLI \u5185\u90E8\u81EA\u52A8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF09",
     parseFloat
@@ -125171,7 +125307,7 @@ function register21(program2) {
     "--search-network <bool>",
     "\u6295\u653E\u5230 Google \u641C\u7D22\uFF1Atrue | false",
     (v) => v === "true"
-  ).option("--content-network <bool>", "\u6295\u653E\u5230\u5C55\u793A\u7F51\u7EDC\uFF1Atrue | false", (v) => v === "true").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=gateway-full-put\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  ).option("--content-network <bool>", "\u6295\u653E\u5230\u5C55\u793A\u7F51\u7EDC\uFF1Atrue | false", (v) => v === "true").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=search-field-patch\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAdCampaignEdit({
         token: opts.token,
@@ -125204,7 +125340,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("adgroup-edit").description("\u7F16\u8F91\u5E7F\u544A\u7EC4\uFF08\u540D\u79F0\u3001\u6700\u9AD8 CPC\u3001\u7EC4\u7EA7\u76EE\u6807 CPA\uFF1B\u81F3\u5C11\u4F20\u4E00\u9879\uFF1B\u4E0E\u7F51\u5173 PUT \u4E00\u81F4\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <adgroupId>", "\u5E7F\u544A\u7EC4 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
+  adCmd.command("adgroup-edit").description("\u7F16\u8F91\u641C\u7D22\u5E7F\u544A\u7EC4\uFF08\u540D\u79F0\u3001\u6700\u9AD8 CPC\u3001\u7EC4\u7EA7\u76EE\u6807 CPA\uFF1B\u81F3\u5C11\u4F20\u4E00\u9879\uFF1B\u5B57\u6BB5\u7EA7 PATCH\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <adgroupId>", "\u5E7F\u544A\u7EC4 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
     "--max-cpc <n>",
     "\u6700\u9AD8 CPC\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 1.5 \u8868\u793A \xA51.50\uFF1BCLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF09",
     parseFloat
@@ -125228,7 +125364,7 @@ function register21(program2) {
     }
   );
   adCmd.command("ad-edit").description(
-    "\u7F16\u8F91\u81EA\u9002\u5E94\u641C\u7D22\u5E7F\u544A\uFF08RESPONSIVE_SEARCH_AD\uFF09\uFF1A\u6807\u9898/\u63CF\u8FF0/\u843D\u5730\u9875/\u8DEF\u5F84/\u72B6\u6001\uFF1B\u4E0E\u7F51\u9875 PUT admanagement/campaign \u884C\u4E3A\u4E00\u81F4"
+    "\u7F16\u8F91\u81EA\u9002\u5E94\u641C\u7D22\u5E7F\u544A\uFF08RESPONSIVE_SEARCH_AD\uFF09\uFF1A\u6807\u9898/\u63CF\u8FF0/\u843D\u5730\u9875/\u8DEF\u5F84/\u72B6\u6001\uFF1B\u5B57\u6BB5\u7EA7 PATCH\uFF0C\u53EA\u5199\u672C\u6B21\u4F20\u5165\u7684\u5B57\u6BB5"
   ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <adId>", "\u5E7F\u544A ID").option(
     "--headlines <h1,h2,h3,...>",
     "\u65B0\u6807\u9898\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u81F3\u5C11 3 \u4E2A\uFF0C\u6700\u591A 15 \u4E2A\uFF0C\u6BCF\u4E2A \u226430 \u5B57\u7B26\uFF1B\u6620\u5C04 headlinePart1/2/3 \u4E0E AddtionalHeadlines\uFF09",
@@ -125273,7 +125409,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("keyword-edit").description("\u7F16\u8F91\u641C\u7D22\u5173\u952E\u8BCD\uFF08\u6570\u7EC4 body\uFF0C\u5148 list \u518D\u5408\u5E76\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C\uFF08\u5199\u5165 keywordText \u6570\u7EC4\uFF09").option(
+  adCmd.command("keyword-edit").description("\u7F16\u8F91\u641C\u7D22\u5173\u952E\u8BCD\u3002\u72B6\u6001/\u51FA\u4EF7/\u7F51\u5740\u8D70\u5B57\u6BB5\u7EA7 PATCH\uFF1B\u6539\u8BCD\u9762\u6216\u5339\u914D\u7C7B\u578B\u4ECD\u7528\u6279\u91CF PUT").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C\uFF08\u5199\u5165 keywordText \u6570\u7EC4\uFF09").option(
     "--match-type <type>",
     '\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u5199 matchTypeV2\uFF0C\u5E76\u9ED8\u8BA4\u540C\u6B65\u6539\u5199 keywordText \u4E3A\u8BCD\u5E72/"\u8BCD"/[\u8BCD] \u4EE5\u7B26\u5408\u7F51\u5173\u63A8\u65AD\uFF09'
   ).option(
@@ -125312,7 +125448,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("keyword-status").description("\u5207\u6362\u641C\u7D22\u5173\u952E\u8BCD\u72B6\u6001\uFF08Enabled / Paused\uFF0C\u5199\u5165 userStatusV2\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  adCmd.command("keyword-status").description("\u5207\u6362\u641C\u7D22\u5173\u952E\u8BCD\u72B6\u6001\uFF08Enabled / Paused\uFF0C\u5B57\u6BB5\u7EA7 PATCH userStatus\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.status !== "Enabled" && opts.status !== "Paused") {
         console.error("\n\u274C --status \u53EA\u63A5\u53D7 Enabled \u6216 Paused\n");

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.58-beta.1",
-  "publishedAt": 1792749041510
+  "version": "1.1.58-beta.2",
+  "publishedAt": 1792980889189
 }

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

@@ -111,7 +111,7 @@ siluzan-tso ad adgroup-status -a <accountId> --id <adGroupId> --status <Enabled|
 
 ### 编辑
 
-先用 `ad groups --json-out ./snap` 查看当前值，再只改传入字段。
+先用 `ad groups --json-out ./snap` 查看当前值。编辑和启停走字段级 PATCH，只写本次传入的字段，不必把列表里的整行再送回去。
 
 ```bash
 siluzan-tso ad adgroup-edit \
@@ -120,7 +120,7 @@ siluzan-tso ad adgroup-edit \
   [--start/--end <YYYY-MM-DD>]
 ```
 
-`--max-cpc` / `--target-cpa` 与 `ad groups --json-out ./snap` 中 `maxCPCAmountYuan` / `targetCpaAmountYuan` 对齐（**元**，CLI 出口已统一）。
+`--max-cpc` / `--target-cpa` 与 `ad groups --json-out ./snap` 中 `maxCPCAmountYuan` / `targetCpaAmountYuan` 对齐（**元**，CLI 出口已统一）。列表里的 `0` 多半是未设置。`--target-cpa 0` 会照写，Google 常回 `Too low`，这个 PATCH 也不能把组级目标 CPA 清回未设置。
 
 ### 删除
 
@@ -295,12 +295,12 @@ siluzan-tso ad geo remove -a <accountId> --campaign-id <id> --location-id <id>
 
 每行 `status`（search 为 `pickStatus`）的取值和处理方式：
 
-| status         | 含义                                                         | 处理                                                                                       |
-| -------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
-| `ok`           | 唯一精确命中，已写入 `targetedLocations`                     | 直接用                                                                                     |
-| `needs_review` | 有候选，但没有精确同名（如只搜到城市/省份）                  | 看 `topCandidates`（前 5 个），**问用户**选哪个或换英文写法；禁止自行挑第一个              |
-| `unserved`     | Google Ads 不支持投放的地区（伊朗、古巴、朝鲜、克里米亚等）  | 从方案中去掉，并告诉用户原因；不要找替代 id                                                |
-| `not_found`    | 网关无候选                                                   | 换英文官方名再试，仍无则问用户                                                             |
+| status         | 含义                                                        | 处理                                                                          |
+| -------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `ok`           | 唯一精确命中，已写入 `targetedLocations`                    | 直接用                                                                        |
+| `needs_review` | 有候选，但没有精确同名（如只搜到城市/省份）                 | 看 `topCandidates`（前 5 个），**问用户**选哪个或换英文写法；禁止自行挑第一个 |
+| `unserved`     | Google Ads 不支持投放的地区（伊朗、古巴、朝鲜、克里米亚等） | 从方案中去掉，并告诉用户原因；不要找替代 id                                   |
+| `not_found`    | 网关无候选                                                  | 换英文官方名再试，仍无则问用户                                                |
 
 落盘汇总里的 `unserved[]`、`needsReview[]`、`failed[]` 必须在创建前逐项向用户说明。`failed` 不包含 `unserved`。
 

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

@@ -81,21 +81,21 @@
 
 ### 已上线 PMax 管理（CLI）
 
-| 能力             | 命令                                                                                                       |
-| ---------------- | ---------------------------------------------------------------------------------------------------------- |
-| 详情             | `ad pmax-get -a <id> --campaign-id <cid>`（读 `_brandGuidelinesActive`）                                   |
-| 改活动           | `ad pmax-edit`（`--patch-file` 或 `--status` / `--budget` + `--budget-id`；改 `Removed` 须用户同意 + `--i-confirm`） |
-| 改 Campaign 品牌 | `ad pmax-brand-assets-edit`（BG 已开启）                                                                   |
-| 启用 BG          | `ad pmax-brand-guidelines-enable --config-file …`（存量活动）                                              |
-| 新资产组         | `ad pmax-asset-group-create --config-file …`（BG 下自动省略品牌）                                          |
-| 改资产组         | `ad pmax-asset-group-edit`                                                                                 |
-| 删资产组         | `ad pmax-asset-group-edit --status REMOVED`（软删；网关无 DELETE 端点）                                    |
-| 改资产           | `ad pmax-assets-update --config-file …`                                                                    |
-| YouTube 追加     | `ad pmax-youtube-link`（单条 `--youtube` / `--video-path`）；批量见 `ad pmax-assets-update`                |
-| 信号             | `ad pmax-signals-get` / `ad pmax-signals-set`；受众下拉 `ad pmax-audiences`                                |
-| 附加资产         | `ad extension pmax-types`；`callout` / `snippet` / `lead-form` / `whatsapp`（见 `pmax-api.md` § 附加资产） |
-| 图片库           | `ad pmax-image-upload`                                                                                     |
-| 报表             | `ad pmax-report-asset-groups` / `ad pmax-report-geo`                                                       |
+| 能力             | 命令                                                                                                                          |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| 详情             | `ad pmax-get -a <id> --campaign-id <cid>`（读 `_brandGuidelinesActive`）                                                      |
+| 改活动           | `ad pmax-edit`（`--patch-file` 或 `--status` / `--budget` + `--budget-id`；改 `Removed` 须用户同意 + `--i-confirm`）          |
+| 改 Campaign 品牌 | `ad pmax-brand-assets-edit`（BG 已开启）                                                                                      |
+| 启用 BG          | `ad pmax-brand-guidelines-enable --config-file …`（存量活动）                                                                 |
+| 新资产组         | `ad pmax-asset-group-create --config-file …`（BG 下自动省略品牌）                                                             |
+| 改资产组         | `ad pmax-asset-group-edit`                                                                                                    |
+| 删资产组         | `ad pmax-asset-group-edit --status REMOVED`（软删；网关无 DELETE 端点）                                                       |
+| 改资产           | `ad pmax-assets-update --config-file …`                                                                                       |
+| YouTube 追加     | `ad pmax-youtube-link`（单条 `--youtube` / `--video-path`）；批量见 `ad pmax-assets-update`                                   |
+| 信号             | `ad pmax-signals-get` / `ad pmax-signals-set`；受众下拉 `ad pmax-audiences`                                                   |
+| 附加资产         | `ad extension pmax-types`；`callout` / `snippet` / `lead-form` / `whatsapp`（见 `pmax-api.md` § 附加资产）                    |
+| 图片库           | `ad pmax-image-upload`                                                                                                        |
+| 报表             | `ad pmax-report-asset-groups` / `ad pmax-report-geo`                                                                          |
 | 删活动           | 用户同意后 `ad campaign-delete -a <id> --id <campaignId> --i-confirm --commit "…"`（与 Search 共用；勿用 `ad campaign-edit`） |
 
 模板与 HTTP 对照：`references/google-ads/pmax-api.md`。
@@ -260,7 +260,11 @@ siluzan-tso ad campaign-edit -a <accountId> --id <campaignId> \
 
 相对运算：先 `ad campaigns --json-out ./snap` 读 `budget`（已为主币种元）、`biddingStrategyTypeV2`，再传入。
 
-`campaign-edit` / `campaign-status` 会先 GET 完整系列，改少数字段后**整包 PUT**（`writeScope=gateway-full-put`）。这不是字段级更新：服务端可能在非共享预算上另走预算更新；`budgetShared=true` 时本命令直接拒绝 `--budget`，不会改共享预算。成功回执不等于只写了本次字段。金额仍是主币种元，CLI ×100 写入网关「分」。写完会再 GET：`verification=verified` 才表示对上了本次字段；没改预算但回读预算变了则是 `partial`；读不到是 `unknown`（再查 `ad campaigns`，不要当成没改成，也不要立刻重发 PUT）。PUT 本身失败时会再 GET 一次预算：金额相对提交前变了是 `partial`（退出码 0），读不到或无法对比是 `unknown`（退出码 0），都不要整包重提；金额没变才是失败（退出码 1）。只改预算金额、且不附带系列其它字段的接口不在本命令。
+`campaign-edit` 的名称、预算、出价，以及 `campaign-status`，走字段级 PATCH（`writeScope=search-field-patch`）。请求只带本次传入的字段，没传的字段保持原样。金额仍是主币种元，CLI ×100 写入网关「分」。`budgetShared=true` 时本命令直接拒绝 `--budget`，不会改共享预算。PMax 不要用本命令。
+
+写完会再 GET：`verification=verified` 才表示对上了本次字段；没改预算但回读预算变了则是 `partial`；读不到是 `unknown`（再查 `ad campaigns`，不要当成没改成，也不要立刻重发）。请求失败时会再 GET 一次预算：金额相对提交前变了是 `partial`（退出码 0），读不到或无法对比是 `unknown`（退出码 0），都不要立刻重发；金额没变才是失败（退出码 1）。
+
+`--search-network` / `--content-network` 不在字段级 PATCH 里。只在传入这两项时，CLI 会在 PATCH 之后再 GET 一次并整包 PUT 投放网络。不要用它们顺手改其它字段。
 
 > PMax / 部分智能系列类型 Google 可能拒绝切换出价策略；以 API 返回错误为准。已上线 PMax 用 `ad pmax-edit`，不要用本命令。
 
@@ -312,14 +316,14 @@ siluzan-tso ad ad-delete -a <accountId> --id <adId>
 
 ## ad ad-edit — 广告创意编辑
 
-先用 `ad list --json-out ./snap` 取得完整 JSON，再只修改传入字段，未改字段从列表原值带回。
+字段级 PATCH，只写本次传入的字段。标题、描述、最终网址、路径只适用于响应式搜索广告；只改 `--status` 时其它广告类型也可以。`--path1` / `--path2` 传空字符串会清空该段路径。
 
-`ad list --json-out ./snap` 关键字段映射：
+`ad list --json-out ./snap` 用来读当前文案，不必把未改字段再传回去：
 
-- `headlinePart1~3` + `AddtionalHeadlines` → `--headlines`（≥3条）
-- `adDescription`/`adDescription2` + `AddtionalAdDescriptions` → `--descriptions`（≥2条）
+- `headlinePart1~3` + `AddtionalHeadlines` → `--headlines`（≥3条，整表替换）
+- `adDescription`/`adDescription2` + `AddtionalAdDescriptions` → `--descriptions`（≥2条，整表替换）
 - `finalUrl` → `--final-url`；`path1`/`path2` → `--path1`/`--path2`
-- `statusV2` → `--status`；`typeV2`（RSA=`RESPONSIVE_SEARCH_AD`）从列表保留勿手改
+- `statusV2` → `--status`
 
 ```bash
 siluzan-tso ad ad-edit \
@@ -346,7 +350,7 @@ siluzan-tso ad keyword-delete -a <accountId> --id <keywordId> --adgroup-id <adGr
 
 ## ad keyword-edit — 搜索关键词编辑
 
-先用 `ad keywords --json-out ./snap` 取完整对象，再提交修改。只改 `--final-url` / `--max-cpc` / `--status` 时原地更新，`id` 与历史数据保留；改 `--text` / `--match-type`（Google 侧词面与匹配类型不可变）会新建并删除旧词，`id` 变化时 CLI 会提示。改 `--final-url` / `--max-cpc` / `--status` 后 CLI 会重新拉列表回读实际值，只有回读一致才输出 ✅；未生效或回读失败则报错退出。此时**禁止**自行改用 `keyword-delete` + `keyword-create`，也禁止直调网关删除重建（会丢失 id 与历史数据），哪怕只改一条也不行。应停下来告知用户「平台未生效、需反馈平台」，可另给 Google Ads Editor 导入清单作为替代方案。
+只改 `--final-url` / `--max-cpc` / `--status` 时走字段级 PATCH，原地更新，`id` 与历史数据保留。`--final-url` 传空会清空关键词网址，回到广告自己的网址。改 `--text` / `--match-type`（Google 侧词面与匹配类型不可变）仍走批量 PUT，会新建并删除旧词，`id` 变化时 CLI 会提示。改 `--final-url` / `--max-cpc` / `--status` 后 CLI 会重新拉列表回读实际值，只有回读一致才输出 ✅；未生效或回读失败则报错退出。此时**禁止**自行改用 `keyword-delete` + `keyword-create`，也禁止直调网关删除重建（会丢失 id 与历史数据），哪怕只改一条也不行。应停下来告知用户「平台未生效、需反馈平台」，可另给 Google Ads Editor 导入清单作为替代方案。
 
 ```bash
 siluzan-tso ad keyword-edit \
@@ -355,13 +359,13 @@ siluzan-tso ad keyword-edit \
   [--max-cpc <n>] [--final-url <url>] [--status Enabled|Paused]
 ```
 
-传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为主币种元（CLI ×100 写入 `maxCPC`「分」字段，与 `adgroup-edit --max-cpc` 同口径）。`ad keywords --json-out ./snap` 出价见 `maxCPCYuan`。`--status` 写入 `userStatusV2`（关键词级开关，非系列的 `statusV2`）。
+传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为主币种元（CLI ×100 写入 `maxCpc`「分」字段，与 `adgroup-edit --max-cpc` 同口径）。`ad keywords --json-out ./snap` 出价见 `maxCPCYuan`。列表里的 `0` 多半是未设置；`--max-cpc 0` 会照写，Google 常回 `Too low`，不能用来清空关键词出价。`--status` 写入 `userStatus`（关键词级开关，非系列的 `status`）。
 
 ---
 
 ## ad keyword-status — 搜索关键词状态切换
 
-仅改 `userStatusV2`，走与 `keyword-edit` 相同的批量 PUT。与 `ad adgroup-status` 用法对称。
+仅改关键词状态，字段级 PATCH `userStatus`。与 `ad adgroup-status` 用法对称。
 
 ```bash
 siluzan-tso ad keyword-status -a <accountId> --id <keywordId> --status <Enabled|Paused>
@@ -462,22 +466,22 @@ siluzan-tso ad extension delete -a <accountId> --id <extensionId>
 
 **`--bid-modifier` 口径（系列级直接透传 Google 倍率）**
 
-| 倍率  | 含义                |
-| ----- | ------------------- |
-| `1.0` | 不调整              |
-| `0.8` | 降低 20%            |
-| `1.2` | 提高 20%            |
+| 倍率  | 含义                                                                                                        |
+| ----- | ----------------------------------------------------------------------------------------------------------- |
+| `1.0` | 不调整                                                                                                      |
+| `0.8` | 降低 20%                                                                                                    |
+| `1.2` | 提高 20%                                                                                                    |
 | `0`   | **写入**时排除该设备（-100%）。**列表**里网关常把「未设置」也填成 `0`，此时 Google 后台显示 `—`，不是 -100% |
 
 **展示口径（与 Google Ads 后台「出价调整」列一致）**：`list` / `google-analysis --sections campaign-device` 已输出 `bidModifierDisplay`。写表格必须用这个字段，禁止把倍率当正百分比（不要把 `0.6` 写成 `40%`）。
 
-| `bidModifier` | `bidModifierSpecified` | `bidModifierDisplay` |
-| ------------- | ---------------------- | -------------------- |
-| `0`（未设置） | 空 / `false`           | `—`                  |
-| `0`（明确排除） | `true`               | `-100%`              |
-| `1.0`         | —                      | `0%`                 |
-| `0.6`         | —                      | `-40%`               |
-| `1.1`         | —                      | `+10%`               |
+| `bidModifier`   | `bidModifierSpecified` | `bidModifierDisplay` |
+| --------------- | ---------------------- | -------------------- |
+| `0`（未设置）   | 空 / `false`           | `—`                  |
+| `0`（明确排除） | `true`                 | `-100%`              |
+| `1.0`           | —                      | `0%`                 |
+| `0.6`           | —                      | `-40%`               |
+| `1.1`           | —                      | `+10%`               |
 
 **系列级列表的限制**：系列级接口只返回 `bid_modifier`，不带 `bidModifierSpecified`，所以「未设置」和「已排除（-100%）」都显示为 `0`。CLI 对这类行输出 `bidModifierDisplay = "— 或 -100%（网关不区分…）"` 和 `unsetOrExcluded: true`。遇到时不要断言是哪一种：对用户说明需要到 Google Ads 后台确认。要在建系列时就确定排除某设备，在 `campaign-create` JSON 的 `targetedPlatforms` 里写 `{ "id": 30002, "bidModifier": -100 }`（见 `campaign-create-template.md`）。
 

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

@@ -30,6 +30,7 @@ Meta / Facebook 线索广告走 **`meta-ad`（W13）**，**禁止**用本命令
 ## Gotchas
 
 - **广告类型**：仅 Search + PMax；**不支持 Display**（见上文「支持的广告类型」）。
+- **Search 改字段**：`campaign-status`、`campaign-edit` 的名称/预算/出价、`adgroup-status` / `adgroup-rename` / `adgroup-edit`、`keyword-status`、`keyword-edit` 的状态/出价/网址、`ad-status` / `ad-edit` 都是字段级 PATCH，只写本次参数。词面和匹配类型仍是批量 PUT。`--search-network` / `--content-network` 仍是整包 PUT。PMax 用 `pmax-edit`，不要用 `campaign-edit`。
 - **命令名**：系列列表是 `ad campaigns`（别名 `campaign-list`），**禁止** `ad-campaigns` / `campaign list`。`balance`/`stats` 须 `-m Google`。
 - **Google 客户 ID（CID）带连字符**：UI / 用户口述常为 `123-456-7890`，平台 `mediaCustomerId` 与 Google 网关路径需要 `1234567890`。`ad campaigns` / `ad groups` / `ad list` 等 `-a` 与 JSON 顶层 `account` **可带连字符**（CLI 自动去掉）。若错误为 `HTTP 403：123-456-7890`（回显带横杠），先换纯数字重试，**禁止**据此直接判断 OAuth 过期或 `reauth`。
 - **禁止臆测授权过期**：`ad *` / geo / 拉数出现 403/500 时，**禁止**对用户说「授权可能过期」。须核验 ID 后执行 `account check-access -a <mediaCustomerId>`，仅当 `reauth_required`（或与 `invalidOAuthToken=true` 交叉确认）才走重授权；无激活字段时禁止谈套餐。见 [`accounts-permissions.md`](../accounts/accounts-permissions.md)。

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

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.58-beta.1"
+readonly PKG_VERSION="1.1.58-beta.2"
 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.58-beta.1",
+  "version": "1.1.58-beta.2",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",