siluzan-tso-cli 1.1.20-beta.22 → 1.1.20-beta.24

package/README.md

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

package/dist/index.js

@@ -111956,141 +111956,6 @@ async function runAdSearchTerms(opts) {
 init_auth();
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
-async function runAdGeoSearch(opts) {
-  const config = loadConfig(opts.token);
-  const googleApiUrl = requireGoogleApi(config);
-  const url = `${googleApiUrl}/campaignmanagement/geolocations/${opts.account}/${encodeURIComponent(opts.query)}`;
-  let data;
-  try {
-    data = await apiFetch2(url, config, {}, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u641C\u7D22\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const items = Array.isArray(data) ? data : data.data ?? [];
-  console.log(`
-\u5730\u7406\u4F4D\u7F6E\u641C\u7D22\u7ED3\u679C\u300C${opts.query}\u300D\uFF08\u5171 ${items.length} \u6761\uFF09
-`);
-  if (items.length === 0) {
-    console.log("  \u672A\u627E\u5230\u5339\u914D\u4F4D\u7F6E\u3002\n");
-    return;
-  }
-  for (const item of items) {
-    const id = String(item["id"] ?? "");
-    const name = String(item["locationName"] ?? item["canonicalName"] ?? item["name"] ?? "");
-    const type = String(item["targetType"] ?? item["typeV2"] ?? "");
-    console.log(`  id:${id}  ${name}  [${type}]`);
-  }
-  console.log();
-}
-async function runAdGeoList(opts) {
-  const config = loadConfig(opts.token);
-  const googleApiUrl = requireGoogleApi(config);
-  let url;
-  const params = new URLSearchParams();
-  if (opts.mode === "report") {
-    url = `${googleApiUrl}/geotargetmanagement/v2/list/${opts.account}?${params}`;
-  } else {
-    params.set("startDate", toGoogleDate(opts.startDate, -30));
-    params.set("endDate", toGoogleDate(opts.endDate, 0));
-    url = `${googleApiUrl}/campaignmanagement/v2/${opts.mode}locations/${opts.account}?${params}`;
-  }
-  let data;
-  try {
-    data = await apiFetch2(url, config, {}, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const rawData = data.data;
-  let items = Array.isArray(rawData) ? rawData : rawData?.countries ?? [];
-  if (opts.campaignId) {
-    const targetId = opts.campaignId;
-    items = items.filter((item) => String(item["campaignId"] ?? "") === targetId);
-  }
-  const modeLabel = { targeted: "\u5DF2\u5B9A\u4F4D", excluded: "\u5DF2\u6392\u9664", report: "\u6D88\u8017\u62A5\u544A" }[opts.mode];
-  const n = items.length;
-  const geoPayload = stripLegacyGoogleFieldsIfV2Present(
-    wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
-  );
-  if (await emitCliJsonOrSnapshot(opts, {
-    section: `ad-geo-${opts.mode}-${opts.account}`,
-    commandLabel: "ad geo",
-    commandHint: `${opts.mode}:${opts.account}`,
-    payload: geoPayload,
-    idSuffix: opts.account
-  })) {
-    return;
-  }
-  console.log(
-    `
-\u5730\u7406\u4F4D\u7F6E\uFF08${modeLabel}\uFF0C\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${items.length} \u6761\uFF0C\u5171 ${items.length} \u6761\uFF09
-`
-  );
-  if (items.length === 0) {
-    console.log("  \u6682\u65E0\u6570\u636E\u3002\n");
-    return;
-  }
-  for (const item of items) {
-    const id = String(item["id"] ?? item["countryCriteriaId"] ?? "");
-    const name = String(
-      item["name"] ?? item["countryOrRegion"] ?? item["country"] ?? item["location"] ?? item["canonicalName"] ?? ""
-    );
-    const campaign = item["campaignName"] ? `  campaign:${item["campaignName"]}` : "";
-    const bid = item["bidModifier"] != null ? `  \u51FA\u4EF7\u500D\u7387:${item["bidModifier"]}` : "";
-    const spend = item["spend"] != null ? `  \u6D88\u8017:${item["spend"]}` : "";
-    const clicks = item["clicks"] != null ? `  \u70B9\u51FB:${item["clicks"]}` : "";
-    console.log(`  id:${id}  ${name}${campaign}${bid}${spend}${clicks}`);
-  }
-  console.log();
-}
-async function runAdGeoAdd(opts) {
-  const config = loadConfig(opts.token);
-  const googleApiUrl = requireGoogleApi(config);
-  const body = {
-    CampaignId: opts.campaignId,
-    Id: opts.locationId,
-    TypeV2: "Location",
-    BidModifier: opts.bidModifier ?? 0,
-    BidModifierSpecified: opts.bidModifier !== void 0
-  };
-  let url = `${googleApiUrl}/campaignmanagement/criterion/${opts.account}`;
-  const method = opts.exclude ? "POST" : "PUT";
-  if (opts.exclude) url += "?isNegative=true";
-  try {
-    await apiFetch2(url, config, { method, body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u6DFB\u52A0\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const label = opts.exclude ? "\u5DF2\u6392\u9664" : "\u5DF2\u6DFB\u52A0\u5B9A\u4F4D";
-  console.log(`
-\u2705 \u5730\u7406\u4F4D\u7F6E ${opts.locationId} ${label}\uFF08\u5E7F\u544A\u7CFB\u5217\uFF1A${opts.campaignId}\uFF09
-`);
-}
-async function runAdGeoRemove(opts) {
-  const config = loadConfig(opts.token);
-  const googleApiUrl = requireGoogleApi(config);
-  const body = { campaignId: opts.campaignId, id: opts.locationId };
-  const url = `${googleApiUrl}/campaignmanagement/criterion/${opts.account}?campaignId=${opts.campaignId}`;
-  try {
-    await apiDeleteRaw(url, config, { body: JSON.stringify(body), verbose: opts.verbose });
-  } catch (err) {
-    console.error(`
-\u274C \u5220\u9664\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  console.log(`
-\u2705 \u5730\u7406\u4F4D\u7F6E ${opts.locationId} \u5DF2\u4ECE\u5E7F\u544A\u7CFB\u5217 ${opts.campaignId} \u4E2D\u79FB\u9664
-`);
-}
 
 // src/commands/ad/device-bid.ts
 init_auth();
@@ -112323,6 +112188,220 @@ async function runAdDeviceBidSet(opts) {
   );
 }
 
+// src/commands/ad/geo.ts
+async function runAdGeoSearch(opts) {
+  const config = loadConfig(opts.token);
+  const googleApiUrl = requireGoogleApi(config);
+  const url = `${googleApiUrl}/campaignmanagement/geolocations/${opts.account}/${encodeURIComponent(opts.query)}`;
+  let data;
+  try {
+    data = await apiFetch2(url, config, {}, opts.verbose);
+  } catch (err) {
+    console.error(`
+\u274C \u641C\u7D22\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  const items = Array.isArray(data) ? data : data.data ?? [];
+  console.log(`
+\u5730\u7406\u4F4D\u7F6E\u641C\u7D22\u7ED3\u679C\u300C${opts.query}\u300D\uFF08\u5171 ${items.length} \u6761\uFF09
+`);
+  if (items.length === 0) {
+    console.log("  \u672A\u627E\u5230\u5339\u914D\u4F4D\u7F6E\u3002\n");
+    return;
+  }
+  for (const item of items) {
+    const id = String(item["id"] ?? "");
+    const name = String(item["locationName"] ?? item["canonicalName"] ?? item["name"] ?? "");
+    const type = String(item["targetType"] ?? item["typeV2"] ?? "");
+    console.log(`  id:${id}  ${name}  [${type}]`);
+  }
+  console.log();
+}
+async function runAdGeoList(opts) {
+  const config = loadConfig(opts.token);
+  const googleApiUrl = requireGoogleApi(config);
+  let url;
+  const params = new URLSearchParams();
+  if (opts.mode === "report") {
+    url = `${googleApiUrl}/geotargetmanagement/v2/list/${opts.account}?${params}`;
+  } else {
+    params.set("startDate", toGoogleDate(opts.startDate, -30));
+    params.set("endDate", toGoogleDate(opts.endDate, 0));
+    url = `${googleApiUrl}/campaignmanagement/v2/${opts.mode}locations/${opts.account}?${params}`;
+  }
+  let data;
+  try {
+    data = await apiFetch2(url, config, {}, opts.verbose);
+  } catch (err) {
+    console.error(`
+\u274C \u67E5\u8BE2\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  const rawData = data.data;
+  let items = Array.isArray(rawData) ? rawData : rawData?.countries ?? [];
+  if (opts.campaignId) {
+    const targetId = opts.campaignId;
+    items = items.filter((item) => String(item["campaignId"] ?? "") === targetId);
+  }
+  const modeLabel = { targeted: "\u5DF2\u5B9A\u4F4D", excluded: "\u5DF2\u6392\u9664", report: "\u6D88\u8017\u62A5\u544A" }[opts.mode];
+  const n = items.length;
+  const geoPayload = stripLegacyGoogleFieldsIfV2Present(
+    wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+  );
+  if (await emitCliJsonOrSnapshot(opts, {
+    section: `ad-geo-${opts.mode}-${opts.account}`,
+    commandLabel: "ad geo",
+    commandHint: `${opts.mode}:${opts.account}`,
+    payload: geoPayload,
+    idSuffix: opts.account
+  })) {
+    return;
+  }
+  console.log(
+    `
+\u5730\u7406\u4F4D\u7F6E\uFF08${modeLabel}\uFF0C\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${items.length} \u6761\uFF0C\u5171 ${items.length} \u6761\uFF09
+`
+  );
+  if (items.length === 0) {
+    console.log("  \u6682\u65E0\u6570\u636E\u3002\n");
+    return;
+  }
+  for (const item of items) {
+    const id = String(item["id"] ?? item["countryCriteriaId"] ?? "");
+    const name = String(
+      item["name"] ?? item["countryOrRegion"] ?? item["country"] ?? item["location"] ?? item["canonicalName"] ?? ""
+    );
+    const campaign = item["campaignName"] ? `  campaign:${item["campaignName"]}` : "";
+    const bid = item["bidModifier"] != null && typeof item["bidModifier"] === "number" ? `  \u51FA\u4EF7\u8C03\u6574:${formatBidModifierPercent(item["bidModifier"])}` : item["bidModifier"] != null ? `  \u51FA\u4EF7\u8C03\u6574:${item["bidModifier"]}` : "";
+    const spend = item["spend"] != null ? `  \u6D88\u8017:${item["spend"]}` : "";
+    const clicks = item["clicks"] != null ? `  \u70B9\u51FB:${item["clicks"]}` : "";
+    console.log(`  id:${id}  ${name}${campaign}${bid}${spend}${clicks}`);
+  }
+  console.log();
+}
+async function runAdGeoAdd(opts) {
+  const config = loadConfig(opts.token);
+  const googleApiUrl = requireGoogleApi(config);
+  const body = {
+    CampaignId: opts.campaignId,
+    Id: opts.locationId,
+    TypeV2: "Location",
+    BidModifier: opts.bidModifier !== void 0 ? multiplierToAdGroupBidPercent(opts.bidModifier) : 0,
+    BidModifierSpecified: opts.bidModifier !== void 0
+  };
+  let url = `${googleApiUrl}/campaignmanagement/criterion/${opts.account}`;
+  const method = opts.exclude ? "POST" : "PUT";
+  if (opts.exclude) url += "?isNegative=true";
+  try {
+    await apiFetch2(url, config, { method, body: JSON.stringify(body) }, opts.verbose);
+  } catch (err) {
+    console.error(`
+\u274C \u6DFB\u52A0\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  const label = opts.exclude ? "\u5DF2\u6392\u9664" : "\u5DF2\u6DFB\u52A0\u5B9A\u4F4D";
+  console.log(`
+\u2705 \u5730\u7406\u4F4D\u7F6E ${opts.locationId} ${label}\uFF08\u5E7F\u544A\u7CFB\u5217\uFF1A${opts.campaignId}\uFF09
+`);
+}
+async function runAdGeoRemove(opts) {
+  const config = loadConfig(opts.token);
+  const googleApiUrl = requireGoogleApi(config);
+  const body = { campaignId: opts.campaignId, id: opts.locationId };
+  const url = `${googleApiUrl}/campaignmanagement/criterion/${opts.account}?campaignId=${opts.campaignId}`;
+  try {
+    await apiDeleteRaw(url, config, { body: JSON.stringify(body), verbose: opts.verbose });
+  } catch (err) {
+    console.error(`
+\u274C \u5220\u9664\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  console.log(`
+\u2705 \u5730\u7406\u4F4D\u7F6E ${opts.locationId} \u5DF2\u4ECE\u5E7F\u544A\u7CFB\u5217 ${opts.campaignId} \u4E2D\u79FB\u9664
+`);
+}
+async function fetchTargetedGeoRows(config, googleApiUrl, account, campaignId, verbose) {
+  const params = new URLSearchParams({
+    startDate: toGoogleDate(void 0, -30),
+    endDate: toGoogleDate(void 0, 0)
+  });
+  const url = `${googleApiUrl}/campaignmanagement/v2/targetedlocations/${account}?${params}`;
+  const data = await apiFetch2(url, config, {}, verbose);
+  const items = Array.isArray(data.data) ? data.data : [];
+  return items.filter((item) => String(item["campaignId"] ?? "") === campaignId);
+}
+function resolveGeoCriterionId(rows, opts) {
+  if (opts.criterionId) return opts.criterionId;
+  if (!opts.locationId) {
+    throw new Error("\u8BF7\u6307\u5B9A --criterion-id\uFF0C\u6216\u914D\u5408 --location-id \u4ECE\u5DF2\u5B9A\u5411\u5217\u8868\u81EA\u52A8\u5339\u914D");
+  }
+  const match = rows.find((r) => String(r["id"] ?? "") === opts.locationId);
+  if (!match?.["id"]) {
+    throw new Error(
+      `\u672A\u627E\u5230\u5DF2\u5B9A\u5411\u5730\u7406\u4F4D\u7F6E id=${opts.locationId}\uFF08\u7CFB\u5217 ${opts.campaignId}\uFF09\uFF0C\u8BF7\u5148\u6267\u884C ad geo list --mode targeted`
+    );
+  }
+  return String(match["id"]);
+}
+async function runAdGeoSetBid(opts) {
+  const config = loadConfig(opts.token);
+  const googleApiUrl = requireGoogleApi(config);
+  if (opts.bidModifier < 0) {
+    console.error("\n\u274C --bid-modifier \u4E0D\u80FD\u4E3A\u8D1F\u6570\n");
+    process.exit(1);
+  }
+  let rows;
+  try {
+    rows = await fetchTargetedGeoRows(
+      config,
+      googleApiUrl,
+      opts.account,
+      opts.campaignId,
+      opts.verbose
+    );
+  } catch (err) {
+    console.error(`
+\u274C \u62C9\u53D6\u5DF2\u5B9A\u5411\u5730\u7406\u4F4D\u7F6E\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  let criterionId;
+  try {
+    criterionId = resolveGeoCriterionId(rows, {
+      criterionId: opts.criterionId,
+      locationId: opts.locationId,
+      campaignId: opts.campaignId
+    });
+  } catch (err) {
+    console.error(`
+\u274C ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  const putUrl = `${googleApiUrl}/campaignmanagement/${opts.account}/campaigns/${opts.campaignId}/Criteria/${criterionId}/BidModifier/${opts.bidModifier}`;
+  try {
+    await apiFetch2(putUrl, config, { method: "PUT" }, opts.verbose);
+  } catch (err) {
+    console.error(`
+\u274C \u4FEE\u6539\u5730\u7406\u4F4D\u7F6E\u51FA\u4EF7\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  const row = rows.find((r) => String(r["id"] ?? "") === criterionId);
+  const name = String(
+    row?.["locationName"] ?? row?.["name"] ?? row?.["countryOrRegion"] ?? criterionId
+  );
+  console.log(
+    `
+\u2705 \u5DF2\u66F4\u65B0\u5730\u7406\u4F4D\u7F6E\u51FA\u4EF7\uFF08\u7CFB\u5217 ${opts.campaignId} / ${name} / id ${criterionId} \u2192 \u500D\u7387 ${opts.bidModifier}\uFF0C${formatBidModifierPercent(opts.bidModifier)}\uFF09
+`
+  );
+}
+
 // src/commands/ad/ai-creation.ts
 init_auth();
 init_cli_json_snapshot();
@@ -114033,7 +114112,7 @@ function register20(program2) {
       });
     }
   );
-  const geoCmd = adCmd.command("geo").description("\u5730\u7406\u4F4D\u7F6E\u5B9A\u5411\u7BA1\u7406\uFF08\u641C\u7D22/\u5217\u8868/\u6DFB\u52A0/\u5220\u9664\uFF09");
+  const geoCmd = adCmd.command("geo").description("\u5730\u7406\u4F4D\u7F6E\u5B9A\u5411\u7BA1\u7406\uFF08\u641C\u7D22/\u5217\u8868/\u6DFB\u52A0/\u5220\u9664/\u51FA\u4EF7\u8C03\u6574\uFF09");
   geoCmd.command("search").description("\u641C\u7D22\u53EF\u7528\u7684\u5730\u7406\u4F4D\u7F6E\uFF08\u83B7\u53D6 locationId \u7528\u4E8E\u6DFB\u52A0\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("-q, --query <text>", "\u5730\u7406\u4F4D\u7F6E\u540D\u79F0\uFF0C\u5982 Beijing | United States").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
     await runAdGeoSearch({
       token: opts.token,
@@ -114091,6 +114170,33 @@ function register20(program2) {
       });
     }
   );
+  geoCmd.command("set-bid").description(
+    "\u4FEE\u6539\u5DF2\u5B9A\u5411\u5730\u7406\u4F4D\u7F6E\u7684\u51FA\u4EF7\u8C03\u6574\uFF08PUT Criteria/\u2026/BidModifier\uFF1B\u500D\u7387\u53E3\u5F84\u540C ad device-bid set\uFF09"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--campaign-id <id>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption(
+    "--bid-modifier <n>",
+    "Google \u51FA\u4EF7\u500D\u7387\uFF1A1.0=\u4E0D\u8C03\u6574\uFF0C1.2=+20%\uFF0C0.8=-20%",
+    parseFloat
+  ).option("--criterion-id <id>", "campaign_criterion id\uFF08geo list --mode targeted --json \u2192 id\uFF09").option("--location-id <id>", "\u5730\u7406\u4F4D\u7F6E ID\uFF08\u4E0E list/search \u7684 id \u76F8\u540C\uFF1B\u4E0E --criterion-id \u4E8C\u9009\u4E00\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      if (!opts.criterionId && !opts.locationId) {
+        console.error("\n\u274C \u987B\u6307\u5B9A --criterion-id \u6216 --location-id\n");
+        process.exit(1);
+      }
+      if (Number.isNaN(opts.bidModifier)) {
+        console.error("\n\u274C --bid-modifier \u987B\u4E3A\u6709\u6548\u6570\u5B57\n");
+        process.exit(1);
+      }
+      await runAdGeoSetBid({
+        token: opts.token,
+        account: opts.account,
+        campaignId: opts.campaignId,
+        bidModifier: opts.bidModifier,
+        criterionId: opts.criterionId,
+        locationId: opts.locationId,
+        verbose: opts.verbose
+      });
+    }
+  );
   const deviceBidCmd = adCmd.command("device-bid").description("\u8BBE\u5907\u51FA\u4EF7\u8C03\u6574\uFF08\u7CFB\u5217\u7EA7 / \u5E7F\u544A\u7EC4\u7EA7\uFF1B\u4E0E\u524D\u7AEF updateDeviceAndAddress \u540C\u6E90\uFF09");
   deviceBidCmd.command("list").description("\u67E5\u8BE2\u8BBE\u5907\u51FA\u4EF7\u8C03\u6574\u5217\u8868\uFF08\u7CFB\u5217\u7EA7\u9ED8\u8BA4\uFF1B\u5E7F\u544A\u7EC4\u7EA7\u9700 --level adgroup\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--level <level>", "campaign | adgroup\uFF08\u9ED8\u8BA4 campaign\uFF09", "campaign").option("--campaign-id <id>", "\u53EF\u9009\uFF1A\u6309\u5E7F\u544A\u7CFB\u5217\u8FC7\u6EE4\uFF08\u7CFB\u5217\u7EA7\uFF09\u6216\u5FC5\u586B\u4E0A\u4E0B\u6587\uFF08\u5E7F\u544A\u7EC4\u7EA7\uFF09").option("--ad-group-id <id>", "\u5E7F\u544A\u7EC4 ID\uFF08--level adgroup \u65F6\u5FC5\u586B\uFF09").option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA", false).option(
     "--json-out <path>",

package/dist/skill/SKILL.md

@@ -151,6 +151,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 - **常用字段**：
   - `ad campaigns --json/--json-out` → `budget`（元，与 `campaign-edit --budget` 同口径）
   - `ad groups --json` → `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）
+  - `google-analysis overview-*.json` → **余额取 `remainingAccountBudget`，禁止取 `balance`**（`balance` 是 Google 原始字段，多数账户恒为 0）
   - `google-analysis campaigns-*.json` → `budgetAmountYuan` / `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan` / `spend` / `averageCpc` / `costPerConversion`（均元）
   - `keyword --json` → `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` + 根级与每条 `bidAmountCurrency`（无 `-a` 为 USD；有 `-a` 为账户 `currencyCode`）；`-a <mediaCustomerId>` 走账户级推荐接口；限定市场用 `keyword geo-list` + `--geo <id>`（**多 id = 汇总指标**；分市场须多次调用、每次一个 `--geo`，见 `references/keyword-planner-workflows.md`）
 - **品牌名优先级**：(1) 用户明确提供 → (2) `list-accounts.mag.advertiserName` → (3) 用户提供网址 → 域名占位并标注 `[待确认品牌名]`。**严禁**把英文域名翻译为虚构中文品牌。

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.20-beta.22",
-  "publishedAt": 1779355357943
+  "version": "1.1.20-beta.24",
+  "publishedAt": 1779360784218
 }

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

@@ -84,7 +84,7 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 | `ad groups --json`                                  | `maxCPCAmountYuan`、`targetCpaAmountYuan`                                                                                                 |
 | `google-analysis campaigns` 落盘 `campaigns-*.json` | `budgetAmountYuan`、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`；同行 `spend` / `averageCpc` / `costPerConversion` 也是元 |
 | `keyword suggest --json`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；根级与每条 `bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD） |
-| `balance` 等账户余额接口                            | `remainingAccountBudget`（元）                                                                                                            |
+| `balance` 等账户余额接口                            | `remainingAccountBudget`（元）；**注意：`google-analysis overview` 同时返回 `balance`（Google 原始字段，多数账户恒为 0）和 `remainingAccountBudget`（真实余额），余额取值必须用后者** |
 
 旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。
 

package/dist/skill/references/google-ads-rules/google-ads-campaign-optimization.md

@@ -249,6 +249,7 @@ siluzan-tso ad geo add -a <CID> --campaign-id <ID> --location-id <ID> --exclude
 
 # 添加出价调整（+20%）
 siluzan-tso ad geo add -a <CID> --campaign-id <ID> --location-id <ID> --bid-modifier 1.2
+siluzan-tso ad geo set-bid -a <CID> --campaign-id <ID> --location-id <ID> --bid-modifier 1.2
 
 # 查看地域效果报告
 siluzan-tso google-analysis -a <CID> --sections geographic

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

@@ -521,10 +521,29 @@ siluzan-tso ad geo list -a <accountId> --mode targeted|excluded|report [--start/
 # 添加定向
 siluzan-tso ad geo add -a <accountId> --campaign-id <id> --location-id <id> [--bid-modifier 1.2] [--exclude]
 
+# 修改已定向地区的出价调整（系列级 campaign_criterion）
+siluzan-tso ad geo set-bid -a <accountId> --campaign-id <id> --location-id <id> --bid-modifier 1.2
+# 或使用 list 返回的 criterion id
+siluzan-tso ad geo set-bid -a <accountId> --campaign-id <id> --criterion-id <id> --bid-modifier 0.8
+
 # 删除
 siluzan-tso ad geo remove -a <accountId> --campaign-id <id> --location-id <id>
 ```
 
+**`--bid-modifier` 口径（`add` / `set-bid` 均为 Google 倍率）**
+
+| 倍率 | 含义 |
+|------|------|
+| `1.0` | 不调整 |
+| `1.2` | 提高 20% |
+| `0.8` | 降低 20% |
+
+- `add`：写入 `PUT …/criterion/{account}` 时 CLI 会换算为后端百分比。
+- `set-bid`：直接 `PUT …/campaigns/{campaignId}/Criteria/{criterionId}/BidModifier/{bidModifier}`，与 `ad device-bid set`（系列级）、AI 优化 `updateDeviceAndAddress` 同源。
+- `list` 返回的 `bidModifier` 为 Google 倍率（非网页编辑弹窗里的 `+10` 百分比）。
+
+**Sammamish 落点**：`ModifyCampaignCriteriaBidModifier` → `GoogleAdsAcctMgmtServiceProviderV2.ModifyCampaignCriteriaBidModifier`。
+
 ---
 
 ## ad device-bid — 设备出价调整

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