siluzan-tso-cli 1.1.61-beta.2 → 1.1.62-beta.1

package/README.md

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

package/dist/index.js

@@ -114974,6 +114974,12 @@ function sameWriteValue(expected, actual) {
   }
   return false;
 }
+function biddingStrategiesMatch(expected, actual) {
+  if (sameWriteValue(expected, actual)) return true;
+  const exp = String(expected).trim().toUpperCase();
+  const act = String(actual ?? "").trim().toUpperCase();
+  return exp === "TARGET_CPA" && act === "MAXIMIZE_CONVERSIONS" || exp === "TARGET_ROAS" && act === "MAXIMIZE_CONVERSION_VALUE";
+}
 function fieldCheck(field, expected, actual, present) {
   if (!present) return { field, expected, actual: void 0, state: "unread" };
   return {
@@ -115027,10 +115033,22 @@ function evaluateCampaignReadback(after, expected, readFailed) {
   };
   push("name", expected.name, ["name", "Name"]);
   push("statusV2", expected.statusV2, ["statusV2", "StatusV2"]);
-  push("biddingStrategyTypeV2", expected.biddingStrategyTypeV2, [
-    "biddingStrategyTypeV2",
-    "BiddingStrategyTypeV2"
-  ]);
+  if (expected.biddingStrategyTypeV2 !== void 0) {
+    const found = readKey(after, ["biddingStrategyTypeV2", "BiddingStrategyTypeV2"]);
+    checks.push(
+      found.present ? {
+        field: "biddingStrategyTypeV2",
+        expected: expected.biddingStrategyTypeV2,
+        actual: found.value,
+        state: biddingStrategiesMatch(expected.biddingStrategyTypeV2, found.value) ? "match" : "mismatch"
+      } : {
+        field: "biddingStrategyTypeV2",
+        expected: expected.biddingStrategyTypeV2,
+        actual: void 0,
+        state: "unread"
+      }
+    );
+  }
   push("targetSpend_BidCeilingAmount", expected.targetSpendBidCeilingCents, [
     "targetSpend_BidCeilingAmount",
     "TargetSpend_BidCeilingAmount"
@@ -124693,6 +124711,16 @@ async function runAdPmaxGet(opts) {
 `);
   });
 }
+function readDisplayNumber(value, label2) {
+  const n = typeof value === "number" ? value : Number(String(value).trim());
+  if (!Number.isFinite(n)) {
+    console.error(`
+\u274C ${label2}\u987B\u4E3A\u6709\u9650\u6570\u5B57\uFF0C\u6536\u5230 ${String(value)}
+`);
+    process.exit(1);
+  }
+  return n;
+}
 async function runAdPmaxEdit(opts) {
   const accountId = requireAccountId(opts.account);
   const campaignId = opts.campaignId.trim();
@@ -124702,11 +124730,13 @@ async function runAdPmaxEdit(opts) {
   } else {
     body = {};
     if (opts.status !== void 0) body["statusV2"] = parseStatusV2(opts.status);
-    if (opts.budget !== void 0) body["budget"] = toCentAmount(opts.budget);
+    if (opts.budget !== void 0) body["budget"] = toCentAmount(readDisplayNumber(opts.budget, "\u9884\u7B97"));
     if (opts.budgetId !== void 0) body["budgetId"] = opts.budgetId.trim();
     if (opts.bidding !== void 0) body["biddingStrategyTypeV2"] = opts.bidding.toUpperCase();
-    if (opts.targetCpa !== void 0) body["targetCpa_BidingAmount"] = toCentAmount(opts.targetCpa);
-    if (opts.targetRoas !== void 0) body["targetRoas"] = opts.targetRoas;
+    if (opts.targetCpa !== void 0) {
+      body["targetCpa_BidingAmount"] = toCentAmount(readDisplayNumber(opts.targetCpa, "\u76EE\u6807 CPA"));
+    }
+    if (opts.targetRoas !== void 0) body["targetRoas"] = readDisplayNumber(opts.targetRoas, "\u76EE\u6807 ROAS");
     if (opts.urlExpansionOptOut !== void 0) {
       body["urlExpansionOptOut"] = opts.urlExpansionOptOut;
     }
@@ -126327,7 +126357,7 @@ function register21(program2) {
     ).requiredOption("-a, --account <id>", "Google \u5A92\u4F53\u5BA2\u6237 ID").requiredOption("--campaign-id <id>", "\u6D3B\u52A8 ID").option("--patch-file <path>", "PATCH JSON\uFF08budget/targetCpa \u586B\u5143\uFF09").option(
       "--status <status>",
       "2|3|4 \u6216 Enabled|Paused|Removed\uFF08Removed \u4E0D\u53EF\u6062\u590D\uFF0C\u987B\u7528\u6237\u540C\u610F\u540E\u52A0 --i-confirm\uFF09"
-    ).option("--i-confirm", "\u72B6\u6001\u6539 Removed \u65F6\u5FC5\u586B\uFF1A\u5DF2\u83B7\u7528\u6237\u660E\u786E\u540C\u610F", false).option("--budget <yuan>", "\u65E5\u9884\u7B97\uFF08\u5143\uFF09\uFF1B\u987B\u914D\u5408 --budget-id").option("--budget-id <id>", "budgetId\uFF08\u6765\u81EA pmax-get\uFF09").option("--bidding <strategy>", "\u51FA\u4EF7\u7B56\u7565\uFF0C\u5982 MAXIMIZE_CONVERSIONS").option("--target-cpa <yuan>", "\u76EE\u6807 CPA\uFF08\u5143\uFF09").option("--target-roas <n>", "\u76EE\u6807 ROAS").option("--url-expansion-opt-out", "\u5173\u95ED\u6700\u7EC8\u5230\u8FBE\u7F51\u5740\u6269\u5C55").option("-t, --token <token>", "Auth Token")
+    ).option("--i-confirm", "\u72B6\u6001\u6539 Removed \u65F6\u5FC5\u586B\uFF1A\u5DF2\u83B7\u7528\u6237\u660E\u786E\u540C\u610F", false).option("--budget <yuan>", "\u65E5\u9884\u7B97\uFF08\u5143\uFF09\uFF1B\u987B\u914D\u5408 --budget-id", parseFloat).option("--budget-id <id>", "budgetId\uFF08\u6765\u81EA pmax-get\uFF09").option("--bidding <strategy>", "\u51FA\u4EF7\u7B56\u7565\uFF0C\u5982 MAXIMIZE_CONVERSIONS").option("--target-cpa <yuan>", "\u76EE\u6807 CPA\uFF08\u5143\uFF09", parseFloat).option("--target-roas <n>", "\u76EE\u6807 ROAS", parseFloat).option("--url-expansion-opt-out", "\u5173\u95ED\u6700\u7EC8\u5230\u8FBE\u7F51\u5740\u6269\u5C55").option("-t, --token <token>", "Auth Token")
   ).action(
     async (opts) => {
       await runAdPmaxEdit(opts);
@@ -126595,7 +126625,7 @@ function register21(program2) {
     parseFloat
   ).option(
     "--target-cpa <n>",
-    "\u7EC4\u7EA7\u76EE\u6807 CPA\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08CLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF09",
+    "\u7EC4\u7EA7\u76EE\u6807 CPA\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08CLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF1B0 \u6E05\u7A7A\uFF0C\u56DE\u5230\u7CFB\u5217\u51FA\u4EF7\uFF09",
     parseFloat
   ).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) => {

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.61-beta.2",
-  "publishedAt": 1793260558087
+  "version": "1.1.62-beta.1",
+  "publishedAt": 1793275471119
 }

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

@@ -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 出口已统一）。列表里的 `0` 多半是未设置。`--target-cpa 0` 会照写，Google 常回 `Too low`，这个 PATCH 也不能把组级目标 CPA 清回未设置。
+`--max-cpc` / `--target-cpa` 与 `ad groups --json-out ./snap` 中 `maxCPCAmountYuan` / `targetCpaAmountYuan` 对齐（**元**，CLI 出口已统一）。列表里的 `0` 多半是未设置。`--target-cpa 0` 清空组级目标 CPA，回到系列出价。`--max-cpc` 仍须大于 0，广告组不能没有最高 CPC。
 
 ### 删除
 

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

@@ -246,6 +246,8 @@ siluzan-tso ad campaign-edit \
 | `TARGET_ROAS`          | **必填** `--target-roas`（2.5 = 250%） |
 | `MAXIMIZE_CONVERSIONS` | 可选 `--target-cpa`（目标 CPA，元）    |
 
+`TARGET_CPA` 写到 Google 的「尽可能提高转化次数」并带上目标 CPA。回读 `biddingStrategyTypeV2` 可能是 `MAXIMIZE_CONVERSIONS`，以 `targetCpa_BidingAmount` 是否等于本次金额为准。`TARGET_ROAS` 在目标回报率大于 0 时回读为 `TARGET_ROAS`；旧网关可能仍回 `MAXIMIZE_CONVERSION_VALUE`，同样以 `targetRoas` 为准。
+
 示例：
 
 ```bash
@@ -262,6 +264,8 @@ siluzan-tso ad campaign-edit -a <accountId> --id <campaignId> \
 
 `campaign-edit` 的名称、预算、出价、投放网络，以及 `campaign-status`，走字段级 PATCH（`writeScope=search-field-patch`）。请求只带本次传入的字段，没传的字段保持原样。金额仍是主币种元，CLI ×100 写入网关「分」。`--search-network` / `--content-network` 传 `true` 或 `false`，关闭传 `false`，不能传空。`budgetShared=true` 时本命令直接拒绝 `--budget`，不会改共享预算。PMax 不要用本命令。
 
+**AI Max：** 不要写系列级 `keyword_match_type`（AI Max 开启后 Google 会拒）。改单条关键词匹配类型仍用关键词命令。列表/判断渠道类型用 `channelTypeV2`，不要用旧 `channelType`。
+
 网关还支持开始/结束时间、地区类型、地区/语言/时段/否定 IP/设备的整表替换，以及动态搜索广告域名。CLI 还没有这些参数，不要自己拼 PUT 或 PATCH。
 
 写完会再 GET：`verification=verified` 才表示对上了本次字段；没改预算但回读预算变了则是 `partial`；读不到是 `unknown`（再查 `ad campaigns`，不要当成没改成，也不要立刻重发）。请求失败时会再 GET 一次预算：金额相对提交前变了是 `partial`（退出码 0），读不到或无法对比是 `unknown`（退出码 0），都不要立刻重发；金额没变才是失败（退出码 1）。
@@ -359,7 +363,7 @@ 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`。列表里的 `0` 多半是未设置；`--max-cpc 0` 会照写，Google 常回 `Too low`，不能用来清空关键词出价。`--status` 写入 `userStatus`（关键词级开关，非系列的 `status`）。
+传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为主币种元（CLI ×100 写入 `maxCpc`「分」字段，与 `adgroup-edit --max-cpc` 同口径）。`ad keywords --json-out ./snap` 出价见 `maxCPCYuan`。列表里的 `0` 多半是未设置。`--max-cpc 0` 清空关键词出价，回到广告组出价；不要用它表示「写成 0 元」。`--status` 写入 `userStatus`（关键词级开关，非系列的 `status`）。
 
 ---
 

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

@@ -18,7 +18,7 @@
 | `ad pmax-validate`                                            | 本地校验                                                                                      |
 | `ad pmax-create`                                              | 创建系列（同步返回 `campaignId` 等；失败时把已建成编号写回 JSON 再跑）           |
 | `ad pmax-channel-types`                                       | 渠道类型列表                                                                                  |
-| `ad pmax-get`                                                 | 系列详情（含 `brandAssets[]`；只读 `negativeGenderExclusions` / `negativeKeywordExclusions` 若 Google 回传；`--json-out` 附加 `_brandGuidelinesActive`、`_agentBrandHint`） |
+| `ad pmax-get`                                                 | 系列详情（含 `brandAssets[]`；`negativeGenderExclusions` / `negativeKeywordExclusions` / `negativeAgeExclusions`；PATCH 可整表替换，未传不改；`--json-out` 附加 `_brandGuidelinesActive`、`_agentBrandHint`） |
 | `ad pmax-edit`                                                | 编辑系列（预算/出价/状态/`assetAutomationSettings`/`textGuidelines`；**不可**改 `brandGuidelinesEnabled`）。图片增强/提取只改提交的类型；`textGuidelines` 未传不写，传了整段替换，传 `{}` 清空 |
 | `ad pmax-brand-assets-edit`                                   | BG 已开启时改 Campaign 级品牌（商家名/Logo/样式）                                             |
 | `ad pmax-brand-guidelines-enable`                             | 存量活动启用 BG（不可关闭）                                                                   |

package/dist/skill/references/google-ads/rules/google-ads-pmax-guide.md

@@ -370,6 +370,7 @@ AI Max for Search 是 Google 在 Search 系列中集成的 AI 优化功能包：
 - `[UI 操作]` **品牌设置（Brand Settings）：** 控制 AI 如何使用品牌名称
 - `[UI 操作]` **网址排除（URL Exclusions）：** 排除不想作为着陆页的页面（如博客、关于我们）
 - `[UI 操作]` **网址规则（URL Rules）：** 限定 AI 只能在特定目录下选择着陆页
+- **勿写系列级匹配类型：** AI Max 开启后不要设置 `Campaign.keyword_match_type`（会被 Google 拒）。可继续改**广告组内单条关键词**的匹配类型。网关 Search PATCH 当前也不写该系列级字段；以后若加写，须先判断 `enable_ai_max`。
 
 ### 10.4 与 PMax 的交互
 

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