siluzan-tso-cli 1.1.14-beta.7 → 1.1.14-beta.8

package/README.md

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

package/dist/index.js

@@ -6936,6 +6936,12 @@ function toDisplayMoney(raw) {
   if (!Number.isFinite(n)) return null;
   return n / 100;
 }
+function toCentAmount(displayValue) {
+  if (!Number.isFinite(displayValue)) {
+    throw new Error(`toCentAmount: \u8F93\u5165\u5FC5\u987B\u662F\u6709\u9650\u6570\u5B57\uFF0C\u6536\u5230 ${displayValue}`);
+  }
+  return Math.round(displayValue * 100);
+}
 function adgroupListUrl(googleApiUrl, account, startDate, endDate) {
   const params = new URLSearchParams();
   params.set("startDate", toGoogleDate(startDate, -30));
@@ -8140,8 +8146,8 @@ async function runAdGroupEdit(opts) {
   }
   const body = { ...adgroup };
   if (hasName) body["name"] = opts.name.trim();
-  if (hasMax) body["maxCPCAmount"] = Math.round(opts.maxCPCAmount);
-  if (hasTcpa) body["targetCpaAmount"] = Math.round(opts.targetCpaAmount);
+  if (hasMax) body["maxCPCAmount"] = toCentAmount(opts.maxCPCAmount);
+  if (hasTcpa) body["targetCpaAmount"] = toCentAmount(opts.targetCpaAmount);
   const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
   try {
     await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
@@ -8342,11 +8348,12 @@ async function runAdCampaignEdit(opts) {
   }
   const body = { ...campaign };
   if (opts.name !== void 0) body["name"] = opts.name;
-  if (opts.budget !== void 0) body["budget"] = opts.budget;
+  if (opts.budget !== void 0) body["budget"] = toCentAmount(opts.budget);
   if (opts.biddingStrategy !== void 0) body["biddingStrategyTypeV2"] = opts.biddingStrategy;
   if (opts.targetSpendBidCeiling !== void 0)
-    body["targetSpend_BidCeilingAmount"] = opts.targetSpendBidCeiling;
-  if (opts.targetCpa !== void 0) body["targetCpa_BidingAmount"] = opts.targetCpa;
+    body["targetSpend_BidCeilingAmount"] = toCentAmount(opts.targetSpendBidCeiling);
+  if (opts.targetCpa !== void 0)
+    body["targetCpa_BidingAmount"] = toCentAmount(opts.targetCpa);
   if (opts.targetSearchNetwork !== void 0)
     body["targetSearchNetwork"] = opts.targetSearchNetwork;
   if (opts.targetContentNetwork !== void 0)
@@ -13388,7 +13395,19 @@ adCmd.command("campaign-create").description(
     });
   }
 );
-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("--budget <amount>", "\u65B0\u9884\u7B97\uFF08\u6700\u5C0F\u8D27\u5E01\u5355\u4F4D\uFF0C\u5982 100000 = 1 USD\uFF09", parseInt).option("--bidding <strategy>", "\u51FA\u4EF7\u7B56\u7565\uFF1ATARGET_SPEND | TARGET_CPA | TARGET_ROAS | MANUAL_CPC").option("--bid-ceiling <amount>", "TARGET_SPEND \u51FA\u4EF7\u4E0A\u9650\uFF08\u6700\u5C0F\u8D27\u5E01\u5355\u4F4D\uFF0C0=\u4E0D\u9650\uFF09", parseInt).option("--target-cpa <amount>", "TARGET_CPA \u76EE\u6807 CPA\uFF08\u6700\u5C0F\u8D27\u5E01\u5355\u4F4D\uFF09", parseInt).option(
+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(
+  "--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
+).option("--bidding <strategy>", "\u51FA\u4EF7\u7B56\u7565\uFF1ATARGET_SPEND | TARGET_CPA | TARGET_ROAS | MANUAL_CPC").option(
+  "--bid-ceiling <amount>",
+  "TARGET_SPEND \u51FA\u4EF7\u4E0A\u9650\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF080 = \u4E0D\u9650\uFF1BCLI \u5185\u90E8 \xD7100 \u5199\u5165\uFF09",
+  parseFloat
+).option(
+  "--target-cpa <amount>",
+  "TARGET_CPA \u76EE\u6807 CPA\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08CLI \u5185\u90E8 \xD7100 \u5199\u5165\uFF09",
+  parseFloat
+).option(
   "--search-network <bool>",
   "\u6295\u653E\u5230 Google \u641C\u7D22\uFF1Atrue | false",
   (v) => v === "true"
@@ -13424,11 +13443,11 @@ adCmd.command("adgroup-rename").description("\u4FEE\u6539\u5E7F\u544A\u7EC4\u540
 );
 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(
   "--max-cpc <n>",
-  "\u6700\u9AD8 CPC\uFF0C\u4E0E ad groups --json \u7684 maxCPCAmount \u540C\u53E3\u5F84\uFF08\u4E3B\u5E01\u79CD\u91D1\u989D\xD7100\uFF0C\u89C1 references/google-ads.md\uFF09",
+  "\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
 ).option(
   "--target-cpa <n>",
-  "\u7EC4\u7EA7\u76EE\u6807 CPA\uFF0C\u4E0E ad groups --json \u7684 targetCpaAmount \u540C\u53E3\u5F84\uFF08\xD7100 \u5206\u5355\u4F4D\uFF09",
+  "\u7EC4\u7EA7\u76EE\u6807 CPA\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08CLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\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.14-beta.7",
-  "publishedAt": 1777341955694
+  "version": "1.1.14-beta.8",
+  "publishedAt": 1777367679688
 }

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

@@ -511,10 +511,11 @@ siluzan-tso ad batch get --id <taskId>
 siluzan-tso ad campaigns -a <CID> --json
 
 # 切换到 Target CPA（数据充足后）
+# --target-cpa 是「主币种金额」，CLI 内部自动 ×100 写入；50 = 50 USD（不是微单位 5000）
 siluzan-tso ad campaign-edit -a <CID> --id <系列ID> \
-  --bidding TARGET_CPA --target-cpa 5000  # 50 USD (微单位)
+  --bidding TARGET_CPA --target-cpa 50
 
-# 切换到 Target ROAS
+# 切换到 Target ROAS（ROAS 是比例，不是金额，无需 ×100）
 siluzan-tso ad campaign-edit -a <CID> --id <系列ID> \
   --bidding TARGET_ROAS --target-roas 3.0
 ```

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

@@ -258,32 +258,37 @@ siluzan-tso ad adgroup-status -a 6326027735 --id adgroup_001 --status Enabled
 
 ### 广告组编辑（名称 / 最高 CPC / 组级目标 CPA）
 
-与 `adgroup-status`、`adgroup-rename` 相同：先用 **`ad groups … --json`** 查看当前 **`maxCPCAmount`**、**`targetCpaAmount`** 等，再用本命令只改传入的字段（由 CLI 与 `siluzan-tso` 合并提交）。
+先用 **`ad groups … --json`** 查看当前的 **`maxCPCAmountDisplay`**、**`targetCpaAmountDisplay`**（主币种金额）等，再用本命令只改传入的字段。
 
 ```bash
 siluzan-tso ad adgroup-edit \
   -a <accountId> \
   --id <adGroupId> \
   [--name <新名称>] \
-  [--max-cpc <n>] \
-  [--target-cpa <n>] \
+  [--max-cpc <主币种金额>] \
+  [--target-cpa <主币种金额>] \
   [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>]
 ```
 
+> **金额单位（必读）**：所有金额参数均按 **主币种金额** 传入（如 `1.5` 表示 ¥1.50）；CLI 内部 `Math.round(value × 100)` 写入后端「分」字段，与 `ad campaign-edit`、前端表单完全一致。**禁止** 按 Google micros（×1,000,000）填写。
+
 | 选项 | 说明 |
 |------|------|
-| `--max-cpc` | 与 **`ad groups --json`** 中 **`maxCPCAmount`** 同一整数口径；与主币种展示关系见 **`maxCPCAmountDisplay`**（`SKILL.md` 金额硬规范）。 |
-| `--target-cpa` | 与 **`ad groups --json`** 中 **`targetCpaAmount`** 同一整数口径。写入 **> 0** 的值才会更新组级目标 CPA；为 `0` 或不传则通常不改变该项。 |
+| `--max-cpc` | 最高 CPC，主币种金额（与 `ad groups --json` 中 **`maxCPCAmountDisplay`** 对齐）。 |
+| `--target-cpa` | 组级目标 CPA，主币种金额（与 `ad groups --json` 中 **`targetCpaAmountDisplay`** 对齐）。写入 **> 0** 才会更新。 |
 | `--name` | 新名称（可选）。 |
 
 **示例：**
 
 ```bash
-# 先取 JSON，用 maxCPCAmount / targetCpaAmount 算好新值后再写回
+# 先取 JSON，读取 maxCPCAmountDisplay / targetCpaAmountDisplay（主币种金额）算新值后再写回
 siluzan-tso ad groups -a 6326027735 --json
 
-siluzan-tso ad adgroup-edit -a 6326027735 --id 195548094874 --max-cpc 200
-siluzan-tso ad adgroup-edit -a 6326027735 --id 195548094874 --target-cpa 5000 --name "核心词_降价后"
+# 把最高 CPC 调整到 ¥2
+siluzan-tso ad adgroup-edit -a 6326027735 --id 195548094874 --max-cpc 2
+
+# 设置目标 CPA = ¥50，并改名
+siluzan-tso ad adgroup-edit -a 6326027735 --id 195548094874 --target-cpa 50 --name "核心词_降价后"
 ```
 
 ---
@@ -618,11 +623,11 @@ siluzan-tso ad batch get --id <recordId>
 siluzan-tso ad batch update --id <recordId> [选项]
 ```
 
-| 选项                     | 说明                                          |
-| ------------------------ | --------------------------------------------- |
-| `--budget <amount>`      | 新预算（最小货币单位，如 `8500` = 85 元 CNY） |
-| `--url <url>`            | 新推广链接                                    |
-| `--campaign-name <name>` | 新广告系列名称                                |
+| 选项                     | 说明                                                                |
+| ------------------------ | ------------------------------------------------------------------- |
+| `--budget <amount>`      | 新日预算，主币种金额（如 `85` 表示 ¥85；CLI 内部自动 ×100 写入「分」） |
+| `--url <url>`            | 新推广链接                                                          |
+| `--campaign-name <name>` | 新广告系列名称                                                      |
 
 ### publish — 发布草稿
 
@@ -814,33 +819,42 @@ siluzan-tso ad campaign-edit \
   -a <accountId> \
   --id <campaignId> \
   [--name <新名称>] \
-  [--budget <预算（最小货币单位）>] \
+  [--budget <主币种金额>] \
   [--bidding <出价策略>] \
-  [--bid-ceiling <出价上限>] \
+  [--bid-ceiling <主币种金额>] \
+  [--target-cpa <主币种金额>] \
   [--search-network true|false] \
   [--content-network true|false]
 ```
 
+> **金额单位（必读）**：所有金额参数均按 **主币种金额**（如 `100` 表示 ¥100，支持小数 `10.5`）传入；CLI 内部 `Math.round(value × 100)` 写入后端「分」字段，与前端表单、`ad campaign-create`、`ad batch update` 完全一致。**禁止** 按 Google micros（×1,000,000）口径填写，会被后端按「分」解读，导致金额放大 10000 倍。
+
 | 选项                | 说明                                                                      |
 | ------------------- | ------------------------------------------------------------------------- |
 | `--name`            | 新广告系列名称                                                            |
-| `--budget`          | 新预算，最小货币单位（如 100000 = 1 USD）                                 |
+| `--budget`          | 新日预算，主币种金额（如 `100` = ¥100；`10.5` = ¥10.50）                  |
 | `--bidding`         | 出价策略：`TARGET_SPEND` \| `TARGET_CPA` \| `TARGET_ROAS` \| `MANUAL_CPC` |
-| `--bid-ceiling`     | `TARGET_SPEND` 出价上限（最小货币单位，0 = 不限）                         |
-| `--target-cpa`      | `TARGET_CPA` 目标 CPA                                                     |
+| `--bid-ceiling`     | `TARGET_SPEND` 出价上限，主币种金额（`0` = 不限）                         |
+| `--target-cpa`      | `TARGET_CPA` 目标 CPA，主币种金额                                         |
 | `--search-network`  | 投放 Google 搜索：`true` \| `false`                                       |
 | `--content-network` | 投放展示网络：`true` \| `false`                                           |
 
 **示例：**
 
 ```bash
-# 修改名称和预算
+# 修改名称和预算（日预算 ¥5000）
 siluzan-tso ad campaign-edit -a 6326027735 --id 23509626948 \
-  --name "搜索-春季促销-2026" --budget 500000
+  --name "搜索-春季促销-2026" --budget 5000
+
+# 在原预算基础上 +10 元（典型相对运算流程）：
+# 1) 先 GET 系列详情，读出 budgetDisplay（主币种）
+# 2) 计算新值（主币种）= budgetDisplay + 10
+# 3) 把新值（主币种）作为 --budget 传入；CLI 内部自动 ×100
+siluzan-tso ad campaign-edit -a 6326027735 --id 23509626948 --budget 10.01
 
 # 切换出价策略为 TARGET_CPA，目标 CPA 2 USD
 siluzan-tso ad campaign-edit -a 6326027735 --id 23509626948 \
-  --bidding TARGET_CPA --target-cpa 200000
+  --bidding TARGET_CPA --target-cpa 2
 ```
 
 ---

package/dist/skill/references/hosted-automation-optimize-scale.md

@@ -52,25 +52,34 @@ siluzan-tso google-analysis campaign-hour -a <mediaCustomerId> --start <YYYY-MM-
 
 ## 最终操作
 
-**提高系列日预算**（主币种 / 微单位以 `google-ads.md`「ad campaign-edit」为准）：
+> **金额单位（关键）**：`ad campaign-edit` / `ad adgroup-edit` 所有金额参数均为 **主币种金额**（如 `100` 表示 ¥100，支持小数 `10.5`）；CLI 内部自动 `Math.round(value × 100)` 写入「分」字段。详见 `references/google-ads.md`「ad campaign-edit」金额单位说明。
+>
+> **必须先用 `*Display` 字段取主币种当前值，加减后再传回**；不要把 `budget` / `targetCpaAmount` / `maxCPCAmount` 这些"分"字段当作主币种传给 CLI。
+
+**提高系列日预算**（在原值基础上 +10 元的写法）：
 
 ```bash
-siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --budget <新值>
+# 1) GET 取主币种当前值
+CUR=$(siluzan-tso ad campaigns -a <mediaCustomerId> --json | node -e '...筛选 budgetDisplay')
+# 2) 主币种 + 10
+NEW=$(node -e "console.log((${CUR} + 10).toFixed(2))")
+# 3) 主币种金额传回
+siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --budget ${NEW}
 ```
 
 **上调系列目标 CPA**（若策略为 tCPA 等）：
 
 ```bash
-siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --target-cpa <新值>
+siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --target-cpa <主币种金额>
 ```
 
 若策略在**组级**调目标 CPA：
 
 ```bash
-siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --target-cpa <新值>
+siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --target-cpa <主币种金额>
 ```
 
-写前务必先 **`ad campaigns --json` / `ad groups --json`** 取当前值，在宿主内按配置比例计算再写入。
+写前务必先 **`ad campaigns --json` / `ad groups --json`** 取当前值，**读取 `*Display` 字段**（主币种）后按配置比例计算，再以主币种金额传回。
 
 ---
 

package/dist/skill/references/hosted-automation-self-control.md

@@ -107,28 +107,32 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status E
 **系列（tCPA / 出价上限等）**：
 
 ```bash
-siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --target-cpa <新值最小货币单位整数>
+# 所有金额参数均为「主币种金额」（如 50 表示 ¥50）；CLI 内部自动 ×100 写入「分」字段
+siluzan-tso ad campaign-edit -a <mediaCustomerId> --id <campaignId> --target-cpa <新值（主币种）>
 # 或 eCPC / 最大化点击上限等：
-# siluzan-tso ad campaign-edit ... --bid-ceiling <整数> --bidding TARGET_SPEND
+# siluzan-tso ad campaign-edit ... --bid-ceiling <主币种金额> --bidding TARGET_SPEND
 ```
 
-参数与单位见 **`references/google-ads.md`**「ad campaign-edit」。
+参数与单位见 **`references/google-ads.md`**「ad campaign-edit」金额单位说明。
 
 **广告组**：
 
 ```bash
-siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --target-cpa <与 groups --json 同口径>
+siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --target-cpa <主币种金额>
 # 或
-siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <与 groups --json 同口径>
+siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主币种金额>
 ```
 
 见 **`references/google-ads.md`**「广告组编辑」。
 
-写前建议先 **`ad groups --json` / `ad campaigns --json`** 取当前值，在宿主内算新值（如下调 12%：`new = round(old * 0.88)`），再写入。
+写前**必须**先 **`ad groups --json` / `ad campaigns --json`** 取当前值，**读取 `*Display` 字段**（主币种金额，如 `targetCpaAmountDisplay`、`maxCPCAmountDisplay`、`budgetDisplay`），在宿主内按主币种算新值（如下调 12%：`newDisplay = round((oldDisplay * 0.88) * 100) / 100`），再以主币种金额作为 `--target-cpa` / `--max-cpc` / `--budget` 传回。
+**严禁** 把 `targetCpaAmount` / `maxCPCAmount` / `budget` 这些「分」字段直接当作主币种金额传给 CLI——会被再 ×100 一次，金额放大 100 倍。
 
 ### 写后复核
 
-再次 **`ad campaigns --json`** 或 **`ad groups --json`**，确认 `targetCpa_BidingAmount` / `targetCpaAmount` / `maxCPCAmount` 等与预期一致。
+再次 **`ad campaigns --json`** 或 **`ad groups --json`**：
+- 优先比对 **`*Display` 字段**（主币种）与预期主币种金额一致；
+- 整数字段 `targetCpa_BidingAmount` / `targetCpaAmount` / `maxCPCAmount` / `budget` 应等于 `主币种 × 100` 后的整数。
 
 ### CLI 能力摘要
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.14-beta.7",
+  "version": "1.1.14-beta.8",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",