siluzan-tso-cli 1.1.35-beta.4 → 1.1.35-beta.5

package/README.md

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

package/dist/index.js

@@ -5471,7 +5471,8 @@ var init_google_analysis = __esm({
     };
     GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS = [
       "// \u91D1\u989D\uFF1A`campaigns[].budgetAmountYuan` / `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan` \u5747\u4E3A**\u5143**\uFF08CLI \u51FA\u53E3\u7EDF\u4E00\uFF09\uFF1B\u540C\u884C `spend` / `averageCpc` / `costPerConversion` \u4E5F\u662F\u5143\u3002",
-      "// \u65E7\u5B57\u6BB5 `budgetAmount`\uFF08\u5206\uFF09/ `*Micros`\uFF08\u5FAE\u5143\uFF09\u5DF2\u4E0D\u518D\u843D\u76D8\uFF0C**\u7981\u6B62**\u518D\u505A \xF7100 / \xF71_000_000 \u6362\u7B97\u3002"
+      "// \u65E7\u5B57\u6BB5 `budgetAmount`\uFF08\u5206\uFF09/ `*Micros`\uFF08\u5FAE\u5143\uFF09\u5DF2\u4E0D\u518D\u843D\u76D8\uFF0C**\u7981\u6B62**\u518D\u505A \xF7100 / \xF71_000_000 \u6362\u7B97\u3002",
+      "// \u72B6\u6001\uFF1A\u6BCF\u884C\u542B `campaignStatusDisplay`\uFF08\u6295\u653E\u4E2D/\u5DF2\u6682\u505C/\u5DF2\u79FB\u9664\uFF09\uFF1B\u62A5\u544A\u72B6\u6001\u5217**\u76F4\u63A5\u8BFB\u6B64\u5B57\u6BB5**\uFF0C\u7981\u6B62\u5BF9 `campaignStatus` \u5199 `MAP[s]||'\u5DF2\u79FB\u9664'`\u3002"
     ];
     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"
@@ -101445,6 +101446,38 @@ var init_city_to_country = __esm({
   }
 });
 
+// src/commands/google-analysis/format-campaign-status.ts
+function formatGoogleCampaignStatusDisplay(status) {
+  if (status == null) return "\u2014";
+  const raw = String(status).trim();
+  if (raw === "") return "\u2014";
+  switch (raw.toUpperCase()) {
+    case "ENABLED":
+      return "\u6295\u653E\u4E2D";
+    case "PAUSED":
+      return "\u5DF2\u6682\u505C";
+    case "REMOVED":
+      return "\u5DF2\u79FB\u9664";
+    default:
+      return "\u672A\u77E5";
+  }
+}
+function readGoogleCampaignStatusRaw(row) {
+  if (row.campaignStatusV2 !== void 0 && row.campaignStatusV2 !== null) {
+    return row.campaignStatusV2;
+  }
+  return row.campaignStatus;
+}
+function annotateCampaignStatusDisplay(row) {
+  if (row.campaignStatusDisplay !== void 0) return;
+  row.campaignStatusDisplay = formatGoogleCampaignStatusDisplay(readGoogleCampaignStatusRaw(row));
+}
+var init_format_campaign_status = __esm({
+  "src/commands/google-analysis/format-campaign-status.ts"() {
+    "use strict";
+  }
+});
+
 // src/commands/google-analysis/translate-fields.ts
 function lookupZh(dict, key) {
   if (typeof key !== "string" || key === "") return void 0;
@@ -101463,6 +101496,14 @@ function annotateArrayRows(rows, source, target, dict) {
     }
   }
 }
+function annotateCampaignStatusDisplayRows(rows) {
+  if (!Array.isArray(rows)) return;
+  for (const r of rows) {
+    if (r && typeof r === "object" && !Array.isArray(r)) {
+      annotateCampaignStatusDisplay(r);
+    }
+  }
+}
 function annotateCountryRollup(rows) {
   if (!Array.isArray(rows)) return;
   for (const r of rows) {
@@ -101483,9 +101524,15 @@ function annotateCountryRollup(rows) {
 function annotateZhFields(payload, section) {
   if (payload === null || typeof payload !== "object") return payload;
   switch (section) {
+    case "campaigns": {
+      const rows = payload.campaigns;
+      annotateCampaignStatusDisplayRows(rows);
+      break;
+    }
     case "keywords": {
       const rows = payload.keywords;
       annotateArrayRows(rows, "keywordMatchType", "keywordMatchTypeZh", MATCH_TYPE_DICT);
+      annotateCampaignStatusDisplayRows(rows);
       break;
     }
     case "search-terms": {
@@ -101520,6 +101567,7 @@ var init_translate_fields = __esm({
     init_match_type_en2zh();
     init_geo_en2zh();
     init_city_to_country();
+    init_format_campaign_status();
     MATCH_TYPE_DICT = match_type_en2zh_default;
     GEO_DICT = geo_en2zh_default;
     CITY_DICT = city_to_country_default.byName ?? {};

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.35-beta.4",
-  "publishedAt": 1783328413873
+  "version": "1.1.35-beta.5",
+  "publishedAt": 1783330558539
 }

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

@@ -42,6 +42,8 @@
 
 报告中「系列状态列」不得来自账户接口（账户状态 ≠ 系列状态，见 `references/core/agent-conventions.md` §四）：系列是否启用**必须**来自 `ad campaigns`（含 `statusDisplay`）或 `google-analysis --sections campaigns` 落盘的系列数据。
 
+**报告脚本禁止自行映射 `campaignStatus` 枚举**：网关值为 PascalCase（`Enabled`/`Paused`/`Removed`），Agent 若写 `STATUS_MAP[s] || '已移除'` 且未归一大小写，会把「投放中」误显示为「已移除」。`campaigns-*.json` 的 `items[]` 已注入 **`campaignStatusDisplay`**（`投放中` / `已暂停` / `已移除` / `—` / `未知`），HTML/Excel 状态列**直接读该字段**。
+
 ### 金额单位
 
 CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
@@ -197,6 +199,11 @@ const data = d.record ?? d.items; // record 非空=汇总维度；否则=列表
 
 `items[]` 每行额外包含：`conversionsValue`、`conversionsValuePerCost`（`spend ≤ 0` 时为 0）、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`、`manualCpcEnhancedCpcEnabled`、`percentCpcEnhancedCpcEnabled`。所有金额字段（`*Yuan` 后缀）已统一为元，可直接展示，无需换算。
 
+| 字段 | 含义 |
+| ---- | ---- |
+| `campaignStatus` / `campaignStatusV2` | 网关原始枚举（`Enabled` / `Paused` / `Removed`） |
+| `campaignStatusDisplay` | CLI 注入的中文状态文案；**报告状态列读此字段** |
+
 日预算字段为 `budgetAmountYuan`（元），脚本可直接 `row.budgetAmountYuan`；网关原始 `budgetAmount`（分）已不再落盘。
 
 #### 竞争指标 `competitiveMetrics`

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

@@ -58,3 +58,16 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
 如果用户**追加**了维度（按上文「可选追加」表），把它们加入 `--sections` 即可；要全 21 维则省略 `--sections`。
 
 > 仅在调试单个维度或需要传 `all` 暂未透传的特殊参数时，才回落到逐条 `siluzan-tso google-analysis <子命令> -a <id> …` 调用。
+
+---
+
+## 广告系列状态列（必读）
+
+`campaigns-*.json` → `items[]` 每行含 CLI 注入的 **`campaignStatusDisplay`**（`投放中` / `已暂停` / `已移除`）。
+
+| 正确 | 错误 |
+| ---- | ---- |
+| 直接展示 `row.campaignStatusDisplay` | 读 `campaignStatus` 后自行 `MAP[s] \|\| '已移除'`（`Enabled` 未命中键时会全变「已移除」） |
+| 需要英文枚举时读 `campaignStatus` 或 `campaignStatusV2`，展示前 `.upper()` 再映射 | 用 `stats` / `list-accounts` 的账户 `status` 充当系列状态 |
+
+原始枚举为 PascalCase（`Enabled`），与 `ad campaigns` 的 `statusDisplay`（有效/未投放/已结束使用）口径不同；周期报告「状态」列统一用 **`campaignStatusDisplay`**。

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

@@ -58,3 +58,16 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
 如果用户**追加**了维度（按上文「可选追加」表），把它们加入 `--sections` 即可；要全 21 维则省略 `--sections`。
 
 > 仅在调试单个维度或需要传 `all` 暂未透传的特殊参数时，才回落到逐条 `siluzan-tso google-analysis <子命令> -a <id> …` 调用。
+
+---
+
+## 广告系列状态列（必读）
+
+`campaigns-*.json` → `items[]` 每行含 CLI 注入的 **`campaignStatusDisplay`**（`投放中` / `已暂停` / `已移除`）。
+
+| 正确 | 错误 |
+| ---- | ---- |
+| 直接展示 `row.campaignStatusDisplay` | 读 `campaignStatus` 后自行 `MAP[s] \|\| '已移除'`（`Enabled` 未命中键时会全变「已移除」） |
+| 需要英文枚举时读 `campaignStatus` 或 `campaignStatusV2`，展示前 `.upper()` 再映射 | 用 `stats` / `list-accounts` 的账户 `status` 充当系列状态 |
+
+原始枚举为 PascalCase（`Enabled`），与 `ad campaigns` 的 `statusDisplay`（有效/未投放/已结束使用）口径不同；周期报告「状态」列统一用 **`campaignStatusDisplay`**。

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