siluzan-tso-cli 1.1.13 → 1.1.14-beta.1

package/README.md

@@ -45,7 +45,7 @@ HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--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            # 写入所有支持的平台
@@ -53,6 +53,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.14-beta.1），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -1962,7 +1962,7 @@ import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command } from "commander";
 
 // src/config/defaults.ts
-var DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+var DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
 
 // ../common/dist/index.js
 import * as fs from "fs";
@@ -2441,19 +2441,19 @@ import * as fs3 from "fs/promises";
 import * as path3 from "path";
 async function getSkillFiles(skillDir) {
   const out = {};
-  async function walk(dir, prefix) {
+  async function walk2(dir, prefix) {
     const entries = await fs3.readdir(dir, { withFileTypes: true });
     for (const ent of entries) {
       const rel = prefix ? `${prefix}/${ent.name}` : ent.name;
       const full = path3.join(dir, ent.name);
       if (ent.isDirectory()) {
-        await walk(full, rel);
+        await walk2(full, rel);
       } else {
         out[rel] = await fs3.readFile(full, "utf8");
       }
     }
   }
-  await walk(skillDir, "");
+  await walk2(skillDir, "");
   return out;
 }
 
@@ -5070,6 +5070,37 @@ async function runReportPushReceiveEmails(opts) {
   console.log();
 }
 
+// src/utils/strip-legacy-google-fields.ts
+var LEGACY_WHEN_V2_PRESENT = [
+  ["status", "statusV2"],
+  ["channelType", "channelTypeV2"],
+  ["subChannelType", "subChannelTypeV2"],
+  ["biddingStrategyType", "biddingStrategyTypeV2"],
+  ["campaignStatus", "campaignStatusV2"],
+  ["adGroupStatus", "adGroupStatusV2"],
+  ["matchType", "matchTypeV2"],
+  ["type", "typeV2"]
+];
+function stripLegacyGoogleFieldsIfV2Present(value) {
+  return walk(value);
+}
+function walk(obj) {
+  if (Array.isArray(obj)) return obj.map(walk);
+  if (obj !== null && typeof obj === "object") {
+    const o = { ...obj };
+    for (const [legacy, modern] of LEGACY_WHEN_V2_PRESENT) {
+      if (modern in o && legacy in o) {
+        delete o[legacy];
+      }
+    }
+    for (const k of Object.keys(o)) {
+      o[k] = walk(o[k]);
+    }
+    return o;
+  }
+  return obj;
+}
+
 // src/commands/google-analysis.ts
 var SECTIONS = [
   {
@@ -5292,7 +5323,7 @@ async function runOneSection(def, opts) {
       ]);
       const merged = { images, videos };
       if (opts.json) {
-        console.log(JSON.stringify(merged, null, 2));
+        console.log(JSON.stringify(stripLegacyGoogleFieldsIfV2Present(merged), null, 2));
         return;
       }
       const iLen = Array.isArray(images) ? images.length : 0;
@@ -5307,7 +5338,7 @@ async function runOneSection(def, opts) {
     }
     const data = await fetchJson(config, fullPath, !!opts.verbose);
     if (opts.json) {
-      console.log(JSON.stringify(data, null, 2));
+      console.log(JSON.stringify(stripLegacyGoogleFieldsIfV2Present(data), null, 2));
       return;
     }
     console.log(
@@ -6806,6 +6837,39 @@ function requireGoogleApi(config) {
   }
   return config.googleApiUrl;
 }
+function formatGoogleCampaignListStatus(row) {
+  let result = "-";
+  const raw = row.statusV2;
+  if (raw == null || String(raw).trim() === "") return result;
+  const statusV2 = String(raw).toUpperCase();
+  const start = parseCampaignTimeMs(row.startTime);
+  const end = parseCampaignTimeMs(row.endTime);
+  if (start == null || end == null) return result;
+  const now = Date.now();
+  if (statusV2 === "PAUSED") {
+    if (now > start && now < end) {
+      result = "\u5DF2\u6682\u505C";
+    } else if (now > end) {
+      result = "\u5DF2\u7ED3\u675F\u4F7F\u7528";
+    } else if (now < start) {
+      result = "\u672A\u6295\u653E";
+    }
+  } else if (statusV2 === "ENABLED") {
+    if (now > start && now < end) {
+      result = "\u6709\u6548";
+    } else if (now > end) {
+      result = "\u5DF2\u7ED3\u675F\u4F7F\u7528";
+    } else if (now < start) {
+      result = "\u672A\u6295\u653E";
+    }
+  }
+  return result;
+}
+function parseCampaignTimeMs(v) {
+  if (v == null || v === "") return null;
+  const t = new Date(v).getTime();
+  return Number.isFinite(t) ? t : null;
+}
 async function runAdCampaigns(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
@@ -6828,18 +6892,19 @@ async function runAdCampaigns(opts) {
     return {
       ...item,
       budgetDisplay,
-      budgetUnit: "display"
+      budgetUnit: "display",
+      statusDisplay: formatGoogleCampaignListStatus(item)
     };
   });
   const n = items.length;
   if (opts.json) {
     console.log(
       JSON.stringify(
-        {
+        stripLegacyGoogleFieldsIfV2Present({
           ...wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }),
           code: data.code ?? null,
           message: data.message ?? null
-        },
+        }),
         null,
         2
       )
@@ -6874,7 +6939,7 @@ async function runAdCampaigns(opts) {
     const budget = item.budgetDisplay != null ? item.budgetDisplay.toFixed(2) : "\u2014";
     return {
       name: (item.name ?? "").slice(0, nameW),
-      status: item.statusV2 ?? "",
+      status: item.statusDisplay ?? formatGoogleCampaignListStatus(item),
       channelType: item.channelTypeV2 ?? "",
       bidding: String(item.biddingStrategyTypeV2 ?? ""),
       budget,
@@ -6917,10 +6982,10 @@ async function runAdGroups(opts) {
   if (opts.json) {
     console.log(
       JSON.stringify(
-        {
+        stripLegacyGoogleFieldsIfV2Present({
           ...wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }),
           code: data.code ?? null
-        },
+        }),
         null,
         2
       )
@@ -6990,7 +7055,13 @@ async function runAdList(opts) {
   const n = items.length;
   if (opts.json) {
     console.log(
-      JSON.stringify(wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }), null, 2)
+      JSON.stringify(
+        stripLegacyGoogleFieldsIfV2Present(
+          wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+        ),
+        null,
+        2
+      )
     );
     return;
   }
@@ -7027,7 +7098,7 @@ async function runAdList(opts) {
       campaign: String(item["campaign"] ?? "").slice(0, campW),
       adGroup: String(item["adGroup"] ?? "").slice(0, grpW),
       status: String(item["statusV2"]),
-      type: String(item["typeV2"] ?? item["type"] ?? ""),
+      type: String(item["typeV2"] ?? ""),
       impressions: String(item["impressions"] ?? 0),
       clicks: String(item["clicks"] ?? 0),
       ctr,
@@ -7066,7 +7137,13 @@ async function runAdKeywords(opts) {
   const n = items.length;
   if (opts.json) {
     console.log(
-      JSON.stringify(wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }), null, 2)
+      JSON.stringify(
+        stripLegacyGoogleFieldsIfV2Present(
+          wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+        ),
+        null,
+        2
+      )
     );
     return;
   }
@@ -7082,7 +7159,7 @@ ${label}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672C
   if (opts.negative) {
     items.forEach((item) => {
       const kwText = Array.isArray(item["keywordText"]) ? item["keywordText"].join(", ") : String(item["text"] ?? item["keywordText"] ?? item["id"] ?? "\u2014");
-      const matchType = item["matchTypeV2"] ?? item["matchType"] ?? "\u2014";
+      const matchType = item["matchTypeV2"] ?? "\u2014";
       console.log(`  [${matchType}] ${kwText}  id: ${String(item["id"] ?? "")}`);
     });
   } else {
@@ -7113,8 +7190,8 @@ ${label}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672C
       const kwText = String(item["text"] ?? item["keywordText"] ?? "\u2014");
       const campaign = String(item["campaignName"] ?? item["campaign"] ?? "");
       const adGroup = String(item["adGroupName"] ?? item["adGroup"] ?? "");
-      const status = String(item["status"] ?? item["userStatus"] ?? "");
-      const matchType = String(item["matchTypeV2"] ?? item["matchType"] ?? "");
+      const status = String(item["userStatus"] ?? "");
+      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";
       return {
@@ -8145,7 +8222,13 @@ async function runAdExtensionList(opts) {
   const n = items.length;
   if (opts.json) {
     console.log(
-      JSON.stringify(wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }), null, 2)
+      JSON.stringify(
+        stripLegacyGoogleFieldsIfV2Present(
+          wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+        ),
+        null,
+        2
+      )
     );
     return;
   }
@@ -8278,7 +8361,13 @@ async function runAdSearchTerms(opts) {
   const n = items.length;
   if (opts.json) {
     console.log(
-      JSON.stringify(wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }), null, 2)
+      JSON.stringify(
+        stripLegacyGoogleFieldsIfV2Present(
+          wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+        ),
+        null,
+        2
+      )
     );
     return;
   }
@@ -8321,7 +8410,7 @@ async function runAdSearchTerms(opts) {
       term: term.slice(0, termW),
       campaign: String(item["campaignName"] ?? "").slice(0, campW),
       adGroup: String(item["adGroupName"] ?? "").slice(0, grpW),
-      matchType: String(item["matchType"] ?? ""),
+      matchType: String(item["matchTypeV2"] ?? ""),
       impressions: String(item["impressions"] ?? 0),
       clicks: String(item["clicks"] ?? 0),
       ctr,
@@ -8355,7 +8444,7 @@ async function runAdGeoSearch(opts) {
   for (const item of items) {
     const id = String(item["id"] ?? "");
     const name = String(item["locationName"] ?? item["canonicalName"] ?? item["name"] ?? "");
-    const type = String(item["targetType"] ?? item["typeV2"] ?? item["type"] ?? "");
+    const type = String(item["targetType"] ?? item["typeV2"] ?? "");
     console.log(`  id:${id}  ${name}  [${type}]`);
   }
   console.log();
@@ -8391,7 +8480,13 @@ async function runAdGeoList(opts) {
   const n = items.length;
   if (opts.json) {
     console.log(
-      JSON.stringify(wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items }), null, 2)
+      JSON.stringify(
+        stripLegacyGoogleFieldsIfV2Present(
+          wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items })
+        ),
+        null,
+        2
+      )
     );
     return;
   }

package/dist/skill/SKILL.md

@@ -75,6 +75,8 @@ allowed-tools: Bash(siluzan-tso:*) Read
   - 这种报告你无法用它来做数据分析除非用户明确要求（Siluzan平台的优化报告）
 - （推荐，默认生成这种报告）由你主动拉取数据，并按照skill给出的格式，输出给用户：详情请查看（`references/account-analytics.md`）
 
+**写报告前必读（账户 vs 系列）**：`stats` / `balance` / `list-accounts` 里的账户 `status` 只表示**广告账户**是否可用，**不能**当作**广告系列**是否启用；系列是否投放须用 `ad campaigns`（及 CLI 派生的 `statusDisplay` 等）。详见 `references/account-analytics.md`「账户状态 ≠ 广告系列状态」。
+
 ### 广告账户相关
 
 - 广告账户开户请阅读： `references/open-account-by-media.md`
@@ -121,6 +123,7 @@ allowed-tools: Bash(siluzan-tso:*) Read
 
 ### 硬规范
 
+- **出报告时账户状态 ≠ 广告系列状态**：`stats` / `balance` / `list-accounts` 中的 `status`（如 Enabled）只表示**广告账户**关联/可用，**绝不能**据此填写或推断**各广告系列**是否「启用/在投」。已暂停或移除的系列若被写成启用，属于严重错误。系列是否启用**必须**来自 `ad campaigns`（或系列维报表中的系列状态）。详见 `references/account-analytics.md`「账户状态 ≠ 广告系列状态」。
 - **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件或使用-h查看命令帮助，不要猜参数。
 - **先查账户再操作**：对具体账户做操作前，先通过 `list-accounts -m [mediaType] -k [mediaCustomerId]` 确认。特别是不确定是Google/Bing/TikTok这些媒体平台中的哪一个的时候
 - **使用 --json 处理数据**：需对返回数据做计算或筛选时，加 `--json`，再用 `node -e` 过滤提取（见 `references/tips.md`）。

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.13",
-  "publishedAt": 1776762370285
+  "version": "1.1.14-beta.1",
+  "publishedAt": 1776765041399
 }

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

@@ -22,6 +22,23 @@
 
 ## 报告中的硬约束（必须遵守）
 
+### 账户状态 ≠ 广告系列状态（出报告最高优先级）
+
+**常见错误**：Agent 看到 `stats`、`balance` 或账户列表里 `status: Enabled`（或「账户正常」），就在报告中把**广告系列**写成「启用」「在投」。这会导致**已暂停、已结束排期或已从投放层面移除**的系列被误标为启用。
+
+| 含义 | 数据来源（示例） | `status` / 状态字段表示什么 |
+|------|------------------|-----------------------------|
+| **广告账户**是否在媒体侧关联可用、能否拉数 | `stats`、`balance`、`list-accounts` | 账户级启用/可用，**不描述单个系列是否在投** |
+| **广告系列**是否暂停、是否在排期内可投放 | **`ad campaigns`**（含 `statusDisplay` 等）、系列维报表 | 系列级启停；**唯一**用于写「某系列启用/暂停」 |
+
+**写报告时的硬性规则**：
+
+1. **禁止**用 `stats` / `balance` / `list-accounts` 返回的账户 `status` 推断或概括**广告系列**是否启用；不得在报告正文写「根据账户状态，各系列均为启用」这类表述（除非已逐条用 `ad campaigns` 核对）。
+2. **凡是**描述「某广告系列是否投放 / 启用 / 暂停 / 移除」，**必须**基于 `siluzan-tso ad campaigns -a <mediaCustomerId> --json`（或 `google-analysis` 中带系列粒度、含系列状态的数据）。账户总览里的消耗/点击可以与系列表并列，但**系列状态列不得来自账户接口**。
+3. 若报告中有「账户概况」与「广告系列明细」两块：前者可用账户级接口；后者**系列状态列只能**来自系列级接口（如 `statusDisplay`），与账户 `status` **不得混为一谈**。
+
+**一句话**：账户「能用 / Enabled」≠ 系列「在投」；系列是否启用只看系列级数据（首推 `ad campaigns`）。
+
 ### 品牌名 / 公司名来源
 
 生成带品牌名、方案、邮件、广告文案的报告时，**严禁自行生成品牌名（包括中文译名、拼音、意译）**。品牌名必须来自以下来源之一，按优先级：

package/dist/skill/references/finance.md

@@ -7,7 +7,7 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`https://www.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
+对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
@@ -131,10 +131,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：https://www.siluzan.com/recharge/pay
-- 现金充值（批量）：https://www.siluzan.com/recharge/pay_batch
-- 月结充值：        https://www.siluzan.com/recharge/accountBillingQuota
-- 丝路赞钱包：      https://www.siluzan.com/recharge/siluzanWallet
+- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
+- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
+- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
+- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
 ```
 
 ---

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

@@ -124,7 +124,7 @@ siluzan-tso ad campaigns -a 6326027735 --start 2026-03-01 --end 2026-03-31
 siluzan-tso ad campaigns -a 6326027735 --json
 ```
 
-输出字段：名称、状态（`statusV2`）、类型（`channelTypeV2`）、预算、点击数、展示数。
+输出字段：名称、状态、类型、预算、点击数、展示数（具体字段名以 `--json` 为准；另有 CLI 派生的 `statusDisplay`、`budgetDisplay` 等便于阅读）。
 
 ---
 

package/dist/skill/references/reporting.md

@@ -212,8 +212,8 @@ siluzan-tso report list -m Google --json
 
 # 第二步：查看 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/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -47,7 +47,7 @@ siluzan-tso config set --api-key <Key>     # 或通过 config set 直接写入
 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`
 
 ### 通过环境变量传入凭据（CI/CD 推荐）
 
@@ -82,9 +82,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/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`
 
 > 若用户已登录 TSO，也可从左侧菜单进入「首页」。
 

package/dist/skill/scripts/install.ps1

@@ -10,8 +10,8 @@ $ErrorActionPreference = 'Stop'
 $PKG_NAME    = 'siluzan-tso-cli'
 $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

@@ -10,8 +10,8 @@ set -euo pipefail
 readonly PKG_NAME="siluzan-tso-cli"
 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.13",
+  "version": "1.1.14-beta.1",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",