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

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.62-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -4051,7 +4051,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -6529,9 +6529,13 @@ function buildOutlineHints(section) {
   if (section === "campaigns") {
     hints.push(
       ...GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS,
-      ...GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS
+      ...GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS,
+      ...GOOGLE_ANALYSIS_CONVERSIONS_VALUE_HINTS
     );
   }
+  if (section === "ads" || section === "keywords" || section === "search-terms") {
+    hints.push(...GOOGLE_ANALYSIS_CONVERSIONS_VALUE_HINTS);
+  }
   if (section === "ads") {
     hints.push(...GOOGLE_ANALYSIS_ADS_OUTLINE_BUDGET_HINTS);
   }
@@ -6651,7 +6655,7 @@ async function writeGoogleAnalysisSnapshot(params) {
     agentHint: OUTLINE_AGENT_HINT
   };
 }
-var LEGACY_MANIFEST_FILE, CLI_PACKAGE, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_ADS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ENVELOPE_OUTLINE_HINTS, GOOGLE_ANALYSIS_OVERVIEW_ACTIVE_DAYS_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
+var LEGACY_MANIFEST_FILE, CLI_PACKAGE, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_ADS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_CONVERSIONS_VALUE_HINTS, GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ENVELOPE_OUTLINE_HINTS, GOOGLE_ANALYSIS_OVERVIEW_ACTIVE_DAYS_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
 var init_google_analysis = __esm({
   "src/utils/snapshot/google-analysis.ts"() {
     "use strict";
@@ -6674,6 +6678,9 @@ var init_google_analysis = __esm({
     GOOGLE_ANALYSIS_ADS_OUTLINE_BUDGET_HINTS = [
       "// \u91D1\u989D\uFF1A`ads[].spend` / `averageCpc` / `costPerConversion` \u843D\u76D8\u524D\u5DF2\u7EDF\u4E00\u4E3A**\u5143**\uFF08`costPerConversion` \u7531\u7F51\u5173\u5FAE\u5143 \xF71e6\uFF09\uFF1B**\u7981\u6B62**\u518D\u5BF9 `costPerConversion` \u505A \xF71_000_000\u3002"
     ];
+    GOOGLE_ANALYSIS_CONVERSIONS_VALUE_HINTS = [
+      "// \u8F6C\u5316\u4EF7\u503C\uFF1A`conversionsValue` \u662F\u8D26\u6237\u5E01\u79CD\u91D1\u989D\uFF08Google\u300C\u8F6C\u5316\u4EF7\u503C\u300D\uFF09\uFF0C\u4E0D\u662F `conversions`\uFF08\u6B21\u6570\uFF09\u3002\u62A5\u544A\u5199\u8F6C\u5316\u4EF7\u503C\u6216 ROAS \u65F6\u7528\u5B83\uFF1AROAS = conversionsValue / spend\uFF08spend \u4E3A 0 \u65F6\u8BE5\u683C\u5199\u300C\u2014\u300D\uFF09\u3002\u7981\u6B62\u7528\u6D88\u8017\u3001\u70B9\u51FB\u3001\u8F6C\u5316\u6B21\u6570\u81EA\u884C\u4F30\u7B97\u3002\u884C\u4E0A\u6CA1\u6709\u8BE5\u5B57\u6BB5\u65F6\u5199\u300C\u672A\u8FD4\u56DE\u300D\uFF0C\u7981\u6B62\u628A\u7CFB\u5217\u4EF7\u503C\u644A\u5230\u8BCD\u6216\u641C\u7D22\u5B57\u8BCD\u4E0A\u3002"
+    ];
     GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS = [
       "// \u7ADE\u4E89\u6307\u6807\uFF1A`campaigns[].competitiveMetrics` \u4E3A **0~1 \u5C0F\u6570**\uFF08\u5982 `0.0999` = 9.99%\uFF09\uFF0C\u542B Top/AbsoluteTop/Content/ClickShare \u7B49\uFF1B\u65E0\u6570\u636E\u65F6\u4E3A `null`\u3002",
       "// \u884C\u9876 `searchImpressionShare` / `searchBudgetLostImpressionShare` / `searchRankLostImpressionShare` \u843D\u76D8\u524D\u5DF2\u5F52\u4E00\u4E3A **0~1 \u5C0F\u6570**\uFF08\u4E0E `competitiveMetrics` \u540C\u540D\u9879\u4E00\u81F4\uFF09\uFF1B\u5C55\u793A\u4E3A % \u65F6 \xD7100\u3002",
@@ -114974,6 +114981,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 +115040,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"
@@ -115334,7 +115359,8 @@ ${label2}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672
       { key: "impressions", header: "\u5C55\u793A" },
       { key: "clicks", header: "\u70B9\u51FB" },
       { key: "ctr", header: "\u70B9\u51FB\u7387" },
-      { key: "spend", header: "\u8D39\u7528" }
+      { key: "spend", header: "\u8D39\u7528" },
+      { key: "conversionsValue", header: "\u8F6C\u5316\u4EF7\u503C" }
     ];
     const rows = items3.map((item) => {
       const kwText = String(item["text"] ?? item["keywordText"] ?? "\u2014");
@@ -115344,6 +115370,8 @@ ${label2}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672
       const matchType = String(item["matchTypeV2"] ?? "");
       const ctr = item["ctr"] != null ? (Number(item["ctr"]) * 100).toFixed(2) + "%" : "\u2014";
       const spend = item["spend"] != null ? Number(item["spend"]).toFixed(2) : "\u2014";
+      const valueRaw = item["conversionsValue"];
+      const conversionsValue = typeof valueRaw === "number" && Number.isFinite(valueRaw) ? valueRaw.toFixed(2) : "\u2014";
       return {
         keyword: kwText.slice(0, kwW),
         campaign: campaign.slice(0, campW),
@@ -115353,7 +115381,8 @@ ${label2}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672
         impressions: String(item["impressions"] ?? 0),
         clicks: String(item["clicks"] ?? 0),
         ctr,
-        spend
+        spend,
+        conversionsValue
       };
     });
     printCliTable(rows, cols);
@@ -119265,12 +119294,15 @@ async function runAdSearchTerms(opts) {
     { key: "impressions", header: "\u5C55\u793A" },
     { key: "clicks", header: "\u70B9\u51FB" },
     { key: "ctr", header: "\u70B9\u51FB\u7387" },
-    { key: "cost", header: "\u8D39\u7528" }
+    { key: "cost", header: "\u8D39\u7528" },
+    { key: "conversionsValue", header: "\u8F6C\u5316\u4EF7\u503C" }
   ];
   const rows = items3.map((item) => {
     const term = String(item["searchTermText"] ?? "");
     const ctr = item["ctr"] != null ? (Number(item["ctr"]) * 100).toFixed(2) + "%" : "\u2014";
     const cost = item["cost"] != null ? Number(item["cost"]).toFixed(2) : "\u2014";
+    const valueRaw = item["conversionsValue"];
+    const conversionsValue = typeof valueRaw === "number" && Number.isFinite(valueRaw) ? valueRaw.toFixed(2) : "\u2014";
     return {
       term: term.slice(0, termW),
       campaign: String(item["campaignName"] ?? "").slice(0, campW),
@@ -119279,7 +119311,8 @@ async function runAdSearchTerms(opts) {
       impressions: String(item["impressions"] ?? 0),
       clicks: String(item["clicks"] ?? 0),
       ctr,
-      cost
+      cost,
+      conversionsValue
     };
   });
   printCliTable(rows, cols);
@@ -124693,6 +124726,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 +124745,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 +126372,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 +126640,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) => {
@@ -139099,7 +139144,7 @@ function matchConversionAction(actions, name2) {
     return label2.includes(needle);
   });
   if (!hit) return null;
-  const n = num2(hit.conversions ?? hit.conversionsValue ?? hit.allConversions);
+  const n = num2(hit.conversions ?? hit.allConversions);
   return n;
 }
 function buildQuarterlyFacts(input) {

package/dist/skill/_meta.json

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

package/dist/skill/references/accounts/accounts-list.md

@@ -170,7 +170,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---

package/dist/skill/references/accounts/accounts-permissions.md

@@ -490,7 +490,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 
 | 功能                                    | 媒体   | 网页路径                                          |
 | --------------------------------------- | ------ | ------------------------------------------------- |
-| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
+| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 
 **Agent 建议话术**：
 
@@ -499,5 +499,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 siluzan-tso config show   # 查看 webUrl 字段
 
 # 账户激活（Google）→ 引导至账户管理页
-# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
 ```

package/dist/skill/references/accounts/finance.md

@@ -126,7 +126,7 @@ siluzan-tso config show
 
 ### 充值页链接（按媒体 × 类型）
 
-链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
 
 | 充值类型                  | `<page>`              | 支持媒体（`mediaType` 参数）                |
 | ------------------------- | --------------------- | ------------------------------------------- |

package/dist/skill/references/accounts/open-account-by-media.md

@@ -1,6 +1,6 @@
 # 各媒体开户
 
-> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 网页链接：`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
 ## Contents

package/dist/skill/references/accounts/open-account-google-ui.md

@@ -65,7 +65,7 @@ siluzan-tso open-account google-wizard
 
 ```bash
 siluzan-tso account-history -m Google
-# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 
 ---

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

@@ -202,12 +202,15 @@ const data = d.record ?? d.items; // record 非空=汇总维度；否则=列表
 | 消耗         | `spend`             |
 | 展示         | `impressions`       |
 | 点击         | `clicks`            |
-| 转化         | `conversions`       |
+| 转化次数     | `conversions`       |
+| 转化价值     | `conversionsValue`  |
 | 点击率       | `ctr`               |
 | 转化率       | `conversionRate`    |
 | 平均点击成本 | `averageCpc`        |
 | 转化成本     | `costPerConversion` |
 
+`conversionsValue` 是账户币种的 Google「转化价值」，和 `conversions`（次数）不是一回事。带 `startDate` / `endDate` 时，`keywords`、`search-terms`、`campaigns`、`ads`，以及 `ad keywords` / `ad search-terms` / `ad campaigns` / `ad groups` / `ad list` 的行上会有这个字段。报告要写转化价值或 ROAS 时用它：`ROAS = conversionsValue / spend`（`spend` 为 0 时该格写「—」）。禁止用消耗、点击、转化次数自己算。行上没有该字段（设备、每日趋势，或当次快照未返回）写「未返回」，禁止把系列价值摊到关键词或搜索字词上。账户级三格仍只汇总 `campaigns` 的 `items[]`。
+
 ### CampaignSectionData 关键字段
 
 > `campaigns` 维度的系列行在 `items[]`（`schemaVersion 3` 起统一信封；本节下文的 `campaigns[]` 即指 `items[]`）。

package/dist/skill/references/analytics/rag.md

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 

package/dist/skill/references/analytics/reporting.md

@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 
 | 媒体   | 报告类型         | URL 模板                                                    |
 | ------ | ---------------- | ----------------------------------------------------------- |
-| Google | 日报（Daily）    | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
-| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
-| TikTok | 日报             | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 日报（Daily）    | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
+| TikTok | 日报             | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
 
 `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
 
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

package/dist/skill/references/core/playbooks.md

@@ -81,7 +81,7 @@
 - **步骤**：
   1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户。
   2. 确认时间范围；区间 > 3 个月时分段（季度/月）。
-  3. **拉数**：用户已指定 Sheet/维度 → 只拉对应 `--sections`（见 `google-period-report-excel.md` 映射表）；未指定 → 按 `google-period-report.md` 默认 9 个拉数维（含 `audience`、`negative-keywords`），并可并行追问可选追加。终稿要「转化价值 / 单转化价值 / ROAS」的上期时，再按 excel 规格拉等长上期 `--sections campaigns` 后汇总，禁止把这三格留成「—」。
+  3. **拉数**：用户已指定 Sheet/维度 → 只拉对应 `--sections`（见 `google-period-report-excel.md` 映射表）；未指定 → 按 `google-period-report.md` 默认 9 个拉数维（含 `audience`、`negative-keywords`），并可并行追问可选追加。终稿要「转化价值 / 单转化价值 / ROAS」的上期时，再按 excel 规格拉等长上期 `--sections campaigns` 后汇总，禁止把这三格留成「—」。关键词 / 搜索字词表用各自行的 `conversionsValue`（ROAS = 该值 / `spend`），不要用系列汇总值摊下去。
   4. **门禁**：对每个 section Read `<section>-<accountId>_*.outline.txt` 后再写脚本。
   5. 脚本读盘写 `google-period-report.json`（`meta` + `narrative`，`meta.lang` 跟本轮语言）；用户要 **Excel** → Agent 脚本写 xlsx（**禁止**宿主第三方 xlsx Skill；**无** CLI excel 子命令；表头跟 `meta.lang`）。
   6. 默认 HTML：`google-analysis render --data ./google-period-report.json --snapshot-dir ./snap-google --out ./google-period-report.html --lang <zh|en>`。须含账户概览、投放趋势、Top 关键词/系列/地区/受众分布、当前否词名单、优化建议。

package/dist/skill/references/core/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -127,9 +127,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

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

@@ -50,7 +50,7 @@ siluzan-tso ad campaigns -a <accountId> [--start <YYYY-MM-DD>] [--end <YYYY-MM-D
 
 命令名：列表是 **`ad campaigns`**（兼容别名 `campaign-list`），**没有** `google-ads` 命名空间。`--json-out` **必须带路径**（落盘，勿管道 stdout）。
 
-带 `--start` / `--end` 时，同行的 **`spend` / `impressions` / `clicks` / `conversions` 为该闭区间合计**（**不是**日消耗）。
+带 `--start` / `--end` 时，同行的 **`spend` / `impressions` / `clicks` / `conversions` / `conversionsValue` 为该闭区间合计**（**不是**日消耗）。`conversionsValue` 是账户币种的转化价值，不是转化次数。报告写转化价值或 ROAS 时用它（ROAS = `conversionsValue` / `spend`）。`ad groups`、`ad list`、`ad keywords`、`ad search-terms` 在同一日期窗口下也返回该字段。
 与日预算比较「是否超预算」时，**必须** `start=end=统计日`；多日窗口须先 ÷ 天数或改用 `balance-scan.dailySpend` / `overview.averageDailyCost` 再谈「日均」。
 
 > **缓存**：网关侧此列表按 `账户 + 日期区间` 缓存 60 秒（Redis）。若刚 `campaign-create` / `campaign-edit` / `campaign-status` / `campaign-delete` 后立刻查询想看到最新结果，加 `--fresh` 跳过缓存（网关 `newest=true`）；日常巡检/报表不需要，留空更省配额。
@@ -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。
 
 ### 删除
 
@@ -185,6 +185,8 @@ siluzan-tso ad ad-delete -a <accountId> --id <adId>
 siluzan-tso ad keywords -a <accountId> [--negative] [--start/--end <date>] [--json-out ./snap]
 ```
 
+带日期时行上有 `conversionsValue`（账户币种的转化价值，不是 `conversions` 次数）。`--json-out` 里直接读这个字段；终端表「转化价值」列在字段缺失时为「—」。否定关键词名单没有这个指标。
+
 ### 添加关键词
 
 ```bash
@@ -263,6 +265,8 @@ siluzan-tso keyword geo-list [--country-code <US,CN,...>] [--name-contains <text
 siluzan-tso ad search-terms -a <accountId> [--start/--end YYYY-MM-DD] [--json-out ./snap]
 ```
 
+行上 `conversionsValue` 是该窗口的转化价值（账户币种）。ROAS = `conversionsValue` / `spend`（或同行费用字段）。不要用点击或转化次数换算。
+
 ---
 
 ## ad geo — 地理位置定向管理

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
@@ -361,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/rules/google-ads-account-audit-assets.md

@@ -228,8 +228,8 @@ siluzan-tso ad campaigns -a <CID> --json-out ./snap
 
 ### 10.2 预算分配合理性
 
-1. 从 `campaigns` 获取每个系列的 spend、conversions、costPerConversion
-2. 计算每个系列的 ROAS 或 CPA
+1. 从 `campaigns` 获取每个系列的 spend、conversions、costPerConversion、conversionsValue
+2. ROAS 用该行 `conversionsValue / spend`（`conversionsValuePerCost` 已是这一比值，不要再平均）；CPA 用 `costPerConversion`
 3. 检查以下不合理分配：
 
 | 问题                  | 检测方式                            | 处理                               |

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

@@ -165,7 +165,7 @@ Account
 **设定初始 tROAS：**
 
 1. 先用 Max Conversion Value（不设目标）运行 2-4 周
-2. 计算平均 ROAS
+2. 平均 ROAS 直接用系列行的 `conversionsValue / spend`（或行上的 `conversionsValuePerCost`），不要用转化次数估算价值
 3. 设 tROAS = 平均 ROAS 或低 10-20%（给算法空间）
 4. 每 2 周提高不超过 15-20%
 

package/dist/skill/references/misc/tso-home.md

@@ -6,7 +6,7 @@
 siluzan-tso config show   # 取 webUrl
 ```
 
-首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 
 ---
 
@@ -25,7 +25,7 @@ siluzan-tso config show   # 取 webUrl
 
 ## 推荐话术
 
-1. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/v3/foreign_trade/tso/home`。
+1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
 2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
 3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。
 

package/dist/skill/references/report-templates/google-period-report-excel.md

@@ -118,7 +118,7 @@ function valueKpis(items) {
 
 禁止对行上的 `conversionsValuePerCost` 再平均（那是行级「转化价值/费用」，不是账户 ROAS）。
 
-关键词、搜索词、设备、每日趋势的 outline 若没有 `conversionsValue`，该列写「该维度未返回」，禁止把系列转化价值摊进去。上期 `campaigns` 拉数失败时，这三格写明原因，不要留空。
+关键词、搜索字词表的转化价值读各自行的 `conversionsValue`（账户币种），ROAS = 该值 / 该行 `spend`。禁止把系列汇总摊到词上，也禁止用转化次数估算。设备、每日趋势的 outline 若没有 `conversionsValue`，该列写「该维度未返回」。关键词或搜索字词当次 outline 也没有该字段时同样写「未返回」。上期 `campaigns` 拉数失败时，账户级三格写明原因，不要留空。
 
 英文终稿表头：转化价值 → Conversion value，单转化价值 → Value / conversion，ROAS 保持 ROAS。
 

package/dist/skill/report-templates/google-period-report-excel.md

@@ -118,7 +118,7 @@ function valueKpis(items) {
 
 禁止对行上的 `conversionsValuePerCost` 再平均（那是行级「转化价值/费用」，不是账户 ROAS）。
 
-关键词、搜索词、设备、每日趋势的 outline 若没有 `conversionsValue`，该列写「该维度未返回」，禁止把系列转化价值摊进去。上期 `campaigns` 拉数失败时，这三格写明原因，不要留空。
+关键词、搜索字词表的转化价值读各自行的 `conversionsValue`（账户币种），ROAS = 该值 / 该行 `spend`。禁止把系列汇总摊到词上，也禁止用转化次数估算。设备、每日趋势的 outline 若没有 `conversionsValue`，该列写「该维度未返回」。关键词或搜索字词当次 outline 也没有该字段时同样写「未返回」。上期 `campaigns` 拉数失败时，账户级三格写明原因，不要留空。
 
 英文终稿表头：转化价值 → Conversion value，单转化价值 → Value / conversion，ROAS 保持 ROAS。
 

package/dist/skill/scripts/install.ps1

@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.61'
+$PKG_VERSION = '1.1.62-beta.2'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
-$WEB_BASE    = 'https://www.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN    = 18

package/dist/skill/scripts/install.sh

@@ -9,11 +9,11 @@ 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"
+readonly PKG_VERSION="1.1.62-beta.2"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
-readonly WEB_BASE="https://www.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
+readonly WEB_BASE="https://www-ci.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

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