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

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.9），供内部测试使用。正式发布后安装命令将改为 `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));
@@ -7405,7 +7411,8 @@ async function runAdGroupCreate(opts) {
     campaignId: opts.campaignId,
     campaignName: opts.campaignName,
     manualCpc_EnhancedCpcEnabled: false,
-    maxCPCAmount: opts.maxCpc,
+    // 用户传主币种金额，统一 toCentAmount 转「分」（与前端、adgroup-edit 一致）
+    maxCPCAmount: toCentAmount(opts.maxCpc),
     name: opts.name,
     rotationMode: 1,
     statusV2: opts.status ?? "ENABLED",
@@ -8140,8 +8147,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 +8349,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)
@@ -13077,8 +13085,8 @@ adCmd.command("campaign-delete").description("\u5220\u9664\u5E7F\u544A\u7CFB\u52
 });
 adCmd.command("adgroup-create").description("\u5728\u5E7F\u544A\u7CFB\u5217\u4E0B\u521B\u5EFA\u641C\u7D22\u5E7F\u544A\u7EC4").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--campaign-id <id>", "\u6240\u5C5E\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--campaign-name <name>", "\u6240\u5C5E\u5E7F\u544A\u7CFB\u5217\u540D\u79F0").requiredOption("--name <name>", "\u5E7F\u544A\u7EC4\u540D\u79F0").requiredOption(
   "--max-cpc <amount>",
-  "\u6700\u9AD8\u5355\u6B21\u70B9\u51FB\u8D39\u7528\uFF08\u6700\u5C0F\u8D27\u5E01\u5355\u4F4D\uFF0C\u5982 100000 = 1 USD\uFF09",
-  parseInt
+  "\u6700\u9AD8\u5355\u6B21\u70B9\u51FB\u8D39\u7528\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 1.5 \u8868\u793A \xA51.50\uFF1BCLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\uFF09",
+  parseFloat
 ).option("--status <status>", "\u72B6\u6001\uFF1AENABLED | PAUSED\uFF08\u9ED8\u8BA4 ENABLED\uFF09", "ENABLED").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
   async (opts) => {
     await runAdGroupCreate({
@@ -13388,7 +13396,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 +13444,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) => {
@@ -13488,7 +13508,10 @@ adCmd.command("keyword-delete").description("\u5220\u9664\u641C\u7D22\u5173\u952
     });
   }
 );
-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 \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\u5165 matchTypeV2\uFF09").option("--max-cpc <n>", "\u6700\u9AD8\u6BCF\u6B21\u70B9\u51FB\u8D39\u7528 maxCPC\uFF08\u6570\u5B57\uFF0C0 \u8868\u793A\u6309\u5E73\u53F0/\u8BA1\u5212\u9ED8\u8BA4\uFF09").option("--final-url <url>", "\u5173\u952E\u8BCD\u7EA7\u6700\u7EC8\u5230\u8FBE\u7F51\u5740 finalURL").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-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 \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\u5165 matchTypeV2\uFF09").option(
+  "--max-cpc <n>",
+  "\u6700\u9AD8\u6BCF\u6B21\u70B9\u51FB\u8D39\u7528 maxCPC\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 5 \u8868\u793A \xA55\uFF1B\u26A0\uFE0F \u8FD9\u4E2A\u5B57\u6BB5\u540E\u7AEF\u5355\u4F4D\u5C31\u662F\u300C\u4E3B\u5E01\u79CD\u5143\u300D\uFF0CCLI \u76F4\u63A5\u900F\u4F20\u4E0D\u505A \xD7100\uFF0C\u4E0E budget / \u7EC4 maxCPCAmount \u4E0D\u540C\uFF1B0 \u8868\u793A\u6309\u5E73\u53F0/\u8BA1\u5212\u9ED8\u8BA4\uFF09"
+).option("--final-url <url>", "\u5173\u952E\u8BCD\u7EA7\u6700\u7EC8\u5230\u8FBE\u7F51\u5740 finalURL").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.matchType && !["Broad", "Phrase", "Exact"].includes(opts.matchType)) {
       console.error("\n\u274C --match-type \u53EA\u63A5\u53D7 Broad | Phrase | Exact\n");

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.9",
+  "publishedAt": 1777368873875
 }

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

@@ -200,36 +200,38 @@ siluzan-tso ad adgroup-create \
   --campaign-id <campaignId> \
   --campaign-name <campaignName> \
   --name <adGroupName> \
-  --max-cpc <金额（微单位）>
+  --max-cpc <主币种金额>
 ```
 
-| 选项                     | 说明                                               | 必填 |
-| ------------------------ | -------------------------------------------------- | ---- |
-| `-a, --account <id>`     | Google mediaCustomerId                             | ✅   |
-| `--campaign-id <id>`     | 所属广告系列 ID（来自 `campaigns --json`）         | ✅   |
-| `--campaign-name <name>` | 所属广告系列名称                                   | ✅   |
-| `--name <name>`          | 广告组名称                                         | ✅   |
-| `--max-cpc <amount>`     | 最高 CPC 出价（最小货币单位，如 `100000` = 1 USD） | ✅   |
-| `--status <status>`      | `ENABLED \| PAUSED`（默认 `ENABLED`）              |      |
+> **金额单位**：`--max-cpc` 为 **主币种金额**（如 `1.5` 表示 ¥1.50），CLI 内部 `Math.round(value × 100)` 写入「分」字段，与前端表单 `arithmetic.times(maxCPCAmount, 100)`、`ad adgroup-edit` 完全一致。**禁止** 按 Google micros（×1,000,000）填写。
+
+| 选项                     | 说明                                                       | 必填 |
+| ------------------------ | ---------------------------------------------------------- | ---- |
+| `-a, --account <id>`     | Google mediaCustomerId                                     | ✅   |
+| `--campaign-id <id>`     | 所属广告系列 ID（来自 `campaigns --json`）                 | ✅   |
+| `--campaign-name <name>` | 所属广告系列名称                                           | ✅   |
+| `--name <name>`          | 广告组名称                                                 | ✅   |
+| `--max-cpc <amount>`     | 最高 CPC 出价，主币种金额（如 `1.5` = ¥1.50；CLI 内部 ×100）| ✅   |
+| `--status <status>`      | `ENABLED \| PAUSED`（默认 `ENABLED`）                      |      |
 
 **示例：**
 
 ```bash
-# 在广告系列下创建广告组，最高 CPC 1 USD
+# 在广告系列下创建广告组，最高 CPC ¥1
 siluzan-tso ad adgroup-create \
   -a 6326027735 \
   --campaign-id campaign_001 \
   --campaign-name "品牌推广_春季" \
   --name "核心词_跑步鞋" \
-  --max-cpc 100000
+  --max-cpc 1
 
-# 创建时设为暂停状态
+# 创建时设为暂停状态，最高 CPC ¥1.5
 siluzan-tso ad adgroup-create \
   -a 6326027735 \
   --campaign-id campaign_001 \
   --campaign-name "品牌推广_春季" \
   --name "竞品词" \
-  --max-cpc 150000 \
+  --max-cpc 1.5 \
   --status PAUSED
 ```
 
@@ -258,32 +260,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 +625,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 +821,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
 ```
 
 ---
@@ -944,6 +960,10 @@ siluzan-tso ad keyword-delete -a 6326027735 --id 2464982882313 --adgroup-id 1955
 
 与网页一致：**先** **`siluzan-tso ad keywords … --json`** 取该关键词完整对象，**再**用本命令提交修改；未改字段随列表结果保留。
 
+> **⚠️ 金额单位（与系列 / 组的金额字段不同！）**：关键词的 `maxCPC` 字段单位是 **「主币种元」**（直接是元，不是「分」），CLI 直接透传 **不做 ×100 转换**。这与 `ad campaign-edit --budget` / `ad adgroup-edit --max-cpc` 等"用户传元、CLI 内部 ×100"的命令**口径相反**。
+>
+> 验证依据：前端 `KeywordList.vue:266` 用 `filterSpend(maxCPC)` 直接展示原值，对应 `useFormatter.js:86` 的 `filterSpend` 内部不 ÷100（对比 `filterBudget` 显式 ÷100）。
+
 ### `ad keywords --json` 常见键名与 CLI 选项（常用）
 
 | 列表 JSON 键名                | 说明                                      | CLI                          |
@@ -952,7 +972,7 @@ siluzan-tso ad keyword-delete -a 6326027735 --id 2464982882313 --adgroup-id 1955
 | `keywordText`                 | 关键词文案（数组，一般一项）              | `--text` → `["..."]`         |
 | `matchTypeV2`                 | 匹配类型（网页用 Broad / Phrase / Exact） | `--match-type`               |
 | `matchType`                   | 另一套枚举（如 EXACT），列表里可能仍存在  | 一般随 list 结果保留，勿手改 |
-| `maxCPC`                      | 最高每次点击费用                          | `--max-cpc`                  |
+| `maxCPC`                      | 最高每次点击费用，**主币种金额**（直接是元，不要 ×100） | `--max-cpc`                  |
 | `finalURL`                    | 关键词级最终到达网址                      | `--final-url`                |
 | `adGroupId` / `campaignId` 等 | 层级与统计字段                            | 从列表保留                   |
 
@@ -1181,13 +1201,13 @@ siluzan-tso list-accounts -m Google --json -k [mediaCustomerId]
 siluzan-tso ad campaigns -a 6326027735 --json
 # 假设 campaignId = campaign_001，campaignName = "品牌推广_春季"
 
-# 第四步：创建广告组（最高 CPC 1 USD = 100000 微单位）
+# 第四步：创建广告组（最高 CPC ¥1，主币种金额；CLI 内部 ×100 写入「分」）
 siluzan-tso ad adgroup-create \
   -a 6326027735 \
   --campaign-id campaign_001 \
   --campaign-name "品牌推广_春季" \
   --name "核心词_跑步鞋" \
-  --max-cpc 100000
+  --max-cpc 1
 
 # 第五步：查询新建广告组 id
 siluzan-tso ad groups -a 6326027735 --json

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.9",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",