siluzan-tso-cli 1.1.21-beta.3 → 1.1.21-beta.4

package/README.md

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

package/dist/index.js

@@ -5066,6 +5066,20 @@ var init_normalize_money = __esm({
   }
 });
 
+// src/commands/google-analysis/normalize-overview.ts
+function normalizeOverviewPayload(payload) {
+  const obj = payload;
+  if (typeof obj.balance === "number" && obj.balance === 0) {
+    delete obj.balance;
+  }
+  return payload;
+}
+var init_normalize_overview = __esm({
+  "src/commands/google-analysis/normalize-overview.ts"() {
+    "use strict";
+  }
+});
+
 // src/commands/google-analysis/match-type-en2zh.json
 var match_type_en2zh_default;
 var init_match_type_en2zh = __esm({
@@ -100731,13 +100745,13 @@ async function fetchSectionPayload(def, opts, config, id) {
     !!opts.verbose,
     def.name
   );
-  return annotateZhFields(
-    normalizeMoneyScales(
-      normalizeRateScales(stripLegacyGoogleFieldsIfV2Present(data), def.name),
-      def.name
-    ),
-    def.name
-  );
+  let payload = stripLegacyGoogleFieldsIfV2Present(data);
+  payload = normalizeRateScales(payload, def.name);
+  payload = normalizeMoneyScales(payload, def.name);
+  if (def.name === "overview") {
+    payload = normalizeOverviewPayload(payload);
+  }
+  return annotateZhFields(payload, def.name);
 }
 function endpointHintForSection(def) {
   if (def.name === "materials") return "CampaignAssetView+Videos";
@@ -100779,6 +100793,7 @@ var init_fetch = __esm({
     init_sections();
     init_normalize_rates();
     init_normalize_money();
+    init_normalize_overview();
     init_translate_fields();
   }
 });

package/dist/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: siluzan-tso
 description: >-
-  Siluzan TSO 广告 skill（siluzan-tso-cli）：Google/Bing/Yandex/TikTok/Kwai 账户开户与管理、Google Ads CRUD、数据分析、优化报告、智能预警、TikTok/Meta 线索、发票财务，并提供 RAG 知识库查询，google广告关键词推荐，
+  Siluzan TSO 广告 skill（siluzan-tso-cli）：Google/Bing/Yandex/TikTok/Kwai 账户开户与管理、Google Ads CRUD、数据分析、优化报告、智能预警、TikTok/Meta 线索、发票财务，并提供 RAG 知识库查询，google广告关键词推荐；当你发现你的上下文被压缩过后，你需要根据用户的需求，重新阅读本skill相关的文件，保证skill功能正常。
 license: MIT
 metadata:
   requires: nodejs,siluzan-tso-cli
@@ -153,7 +153,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 overview-*.json` → **余额只认 `remainingAccountBudget`**（`balance` 为 0 时 CLI 已剔除该字段）
   - `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.21-beta.3",
-  "publishedAt": 1779689350731
+  "version": "1.1.21-beta.4",
+  "publishedAt": 1779697477475
 }

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`（元）；**注意：`google-analysis overview` 同时返回 `balance`（Google 原始字段，多数账户恒为 0）和 `remainingAccountBudget`（真实余额），余额取值必须用后者** |
+| `balance` 等账户余额接口                            | 余额字段为`remainingAccountBudget`（元） |
 
 旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。
 

package/dist/skill/references/hosted-automation-monitoring-json.md

@@ -43,7 +43,7 @@ siluzan-tso balance -m Google --accounts <mediaCustomerId> --json
 mkdir -p ./snap-monitor && siluzan-tso google-analysis -a <mediaCustomerId> --sections overview --start <YYYY-MM-DD> --end <YYYY-MM-DD> --json-out ./snap-monitor
 ```
 
-读 **`./snap-monitor/overview-<accountId>.json`**（具体路径见 stdout 摘要的 `writtenFiles[0]` 或 `manifest-<accountId>.json` 的 `artifacts`）。根对象常见字段：**`remainingAccountBudget`**、**`averageDailyCost`**、**`totalCost`**、**`activeDays`**、**`currencyCode`**、**`accountId`**；**`currentPeriod`** / **`previousPeriod`** 为对象块，内含 **`spend`**、`impressions`、`clicks`、`conversions` 等与 `references/account-analytics.md` 总览口径一致的指标（块内还可能出现 **`currencyCode`**）。
+读 **`./snap-monitor/overview-<accountId>.json`**（具体路径见 stdout 摘要的 `writtenFiles[0]` 或 `manifest-<accountId>.json` 的 `artifacts`）。根对象常见字段：**`remainingAccountBudget`**（余额）、**`averageDailyCost`**、**`totalCost`**、**`activeDays`**、**`currencyCode`**、**`accountId`**（无 **`balance`**，网关为 0 时 CLI 已剔除）；**`currentPeriod`** / **`previousPeriod`** 为对象块，内含 **`spend`**、`impressions`、`clicks`、`conversions` 等与 `references/account-analytics.md` 总览口径一致的指标（块内还可能出现 **`currencyCode`**）。
 
 ---
 

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