siluzan-tso-cli 1.1.21-beta.6 → 1.1.21

package/README.md

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

package/dist/index.js

@@ -3328,7 +3328,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
   }
 });
 
@@ -114340,8 +114340,26 @@ function buildPmaxCreateUrl(googleApiUrl, accountId) {
   return `${base}/accounts/${accountId}/campaign/pmax`;
 }
 
+// src/commands/ad/pmax-feature-guard.ts
+var ENV_KEY = "SILUZAN_PMAX_SETUP";
+function isPmaxSetupEnabled() {
+  const v = process.env[ENV_KEY]?.trim();
+  return v === "1" || v?.toLowerCase() === "true";
+}
+function assertPmaxSetupEnabled(feature) {
+  if (isPmaxSetupEnabled()) return;
+  console.error(
+    `
+\u274C PMax\u300C${feature}\u300D\u6682\u672A\u5728\u751F\u4EA7\u73AF\u5883\u5F00\u653E\uFF08\u642D\u5EFA\u80FD\u529B\u4ECD\u5728\u6D4B\u8BD5\uFF09\u3002
+   \u8BF7\u5728 Google Ads UI \u64CD\u4F5C\uFF0C\u6216\u672C\u5730\u8054\u8C03\u65F6\u8BBE\u7F6E ${ENV_KEY}=1 \u540E\u91CD\u8BD5\u3002
+`
+  );
+  process.exit(1);
+}
+
 // src/commands/ad/pmax-create.ts
 async function runAdPmaxCreate(opts) {
+  assertPmaxSetupEnabled("pmax-create");
   const cfg = loadPmaxCreateConfig(opts.configFile);
   const { errors: cfgErrors, warnings: cfgWarnings } = runPmaxCreateValidation(cfg);
   const { errors: imgErrors, warnings: imgWarnings } = await runPmaxImageValidation(
@@ -114431,6 +114449,7 @@ async function runAdPmaxCreate(opts) {
 import { writeFileSync as writeFileSync3 } from "fs";
 init_cli_json_snapshot();
 async function runAdPmaxValidate(opts) {
+  assertPmaxSetupEnabled("pmax-validate");
   const cfg = loadPmaxCreateConfig(opts.configFile);
   const { errors: cfgErrors, warnings: cfgWarnings } = runPmaxCreateValidation(cfg);
   const { errors: imgErrors, warnings: imgWarnings } = await runPmaxImageValidation(
@@ -114672,6 +114691,7 @@ async function runAdPmaxGet(opts) {
   });
 }
 async function runAdPmaxEdit(opts) {
+  assertPmaxSetupEnabled("pmax-edit");
   const accountId = requireAccountId(opts.account);
   const campaignId = opts.campaignId.trim();
   let body;
@@ -114733,6 +114753,7 @@ async function runAdPmaxEdit(opts) {
   });
 }
 async function runAdPmaxAssetGroupCreate(opts) {
+  assertPmaxSetupEnabled("pmax-asset-group-create");
   const cfg = loadPmaxJsonFile(opts.configFile);
   const accountId = requireAccountId(String(cfg["account"] ?? ""));
   const campaignId = String(cfg["campaignId"] ?? "").trim();
@@ -114818,6 +114839,7 @@ async function runAdPmaxAssetGroupCreate(opts) {
   });
 }
 async function runAdPmaxAssetGroupEdit(opts) {
+  assertPmaxSetupEnabled("pmax-asset-group-edit");
   const accountId = requireAccountId(opts.account);
   const assetGroupId = opts.assetGroupId.trim();
   let body;
@@ -114869,6 +114891,7 @@ async function runAdPmaxAssetGroupEdit(opts) {
   });
 }
 async function runAdPmaxAssetsUpdate(opts) {
+  assertPmaxSetupEnabled("pmax-assets-update");
   const cfg = loadPmaxJsonFile(opts.configFile);
   const accountId = requireAccountId(String(cfg["account"] ?? ""));
   const assetGroupId = String(cfg["assetGroupId"] ?? "").trim();
@@ -114929,6 +114952,7 @@ async function runAdPmaxAssetsUpdate(opts) {
   });
 }
 async function runAdPmaxYoutubeLink(opts) {
+  assertPmaxSetupEnabled("pmax-youtube-link");
   const accountId = requireAccountId(opts.account);
   const assetGroupId = opts.assetGroupId.trim();
   let body;
@@ -115018,6 +115042,7 @@ async function runAdPmaxSignalsGet(opts) {
   });
 }
 async function runAdPmaxSignalsSet(opts) {
+  assertPmaxSetupEnabled("pmax-signals-set");
   const cfg = loadPmaxJsonFile(opts.configFile);
   const accountId = requireAccountId(String(cfg["account"] ?? ""));
   const assetGroupId = String(cfg["assetGroupId"] ?? "").trim();
@@ -115137,6 +115162,7 @@ PMax \u53D7\u4F17\u6570\u636E\u6E90\uFF08\u8D26\u6237 ${accountId}\uFF09
   });
 }
 async function runAdPmaxImageUpload(opts) {
+  assertPmaxSetupEnabled("pmax-image-upload");
   const accountId = requireAccountId(opts.account);
   await withGoogleApi(opts, async (config, googleApiUrl) => {
     let data;
@@ -115366,6 +115392,7 @@ async function convertOne(sharpFn, inputPath, outputPath, spec, quality) {
   await pipeline.toFile(outputPath);
 }
 async function runAdPmaxImageConvert(opts) {
+  assertPmaxSetupEnabled("pmax-image-convert");
   const { input, inputMarketing, inputSquare, inputLogo } = opts;
   if (!input && !inputMarketing && !inputSquare && !inputLogo) {
     console.error("\n\u274C \u8BF7\u81F3\u5C11\u6307\u5B9A --input \u6216 --input-marketing / --input-square / --input-logo\n");

package/dist/skill/SKILL.md

@@ -42,9 +42,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 | `references/currency.md`                        | 账户币种 CNY/USD：字段来源、符号、跨币种禁止求和                           |
 | `references/open-account-by-media.md`           | 各媒体开户、参数与资料要求                                                 |
 | `references/google-ads-campaign-plan.md`        | Google 新建搜索系列：双轨入口、7 步流水线、`campaign-validate/create`      |
-| `assets/pmax-create-template.md`                | PMax 新建：`pmax-validate` / `pmax-create`（JSON 契约，非 Search batch）   |
-| `references/pmax-api.md`                        | PMax 网关路径、金额口径、与 Search API 边界                                |
-| `references/google-ads.md`                      | Google Ads 命令：CRUD、batch、PMax 创建、拒审字段                          |
+| `references/google-ads.md`                      | Google Ads 命令：CRUD、batch、拒审字段（**PMax 搭建暂未开放**，见硬规范）  |
 | `references/keyword-planner-workflows.md`       | `keyword` / `google-analysis` 拓词编排（不含建户 JSON 流程）               |
 | `references/rag.md`                             | 知识库检索（`rag list` + `rag query`）：客户产品/行业事实                  |
 | `references/reporting.md`                       | TSO 优化报告（Google/TikTok）生成、推送、查看                              |
@@ -105,7 +103,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 | 拉数 / 报告 / 周报 / 分析 / `google-analysis` | `references/account-analytics.md` + `references/tips.md`；多账户批处理加 `google-analysis-batch.md` |
 | Google 新建搜索系列 | `references/google-ads-campaign-plan.md`（再按需 `google-ads.md`、模板 JSON） |
 | Google 广告 CRUD / 拒审 / 系列组关键词 | `references/google-ads.md` |
-| PMax | `assets/pmax-create-template.md` + `references/pmax-api.md` |
+| PMax 搭建 / 管理 | **暂未开放** — 勿调用 `ad pmax-*` 写入命令；见下方硬规范 |
 | 拓词 / keyword | `references/keyword-planner-workflows.md`；要客户背景先 `rag.md` |
 | 优化报告（TSO 平台） | `references/reporting.md` |
 | 预警 | `references/forewarning.md` |
@@ -147,6 +145,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 - **破坏性操作必须确认 + `--commit`**：账户解绑/关闭/取消分享、BC/MCC 解绑、删除预警/报告/广告/关键词、发票申请、广告发布等。所有写/修改命令的 `--commit` 字段填写修改前后的值，便于排查或恢复。
 - **不确定时读文档**：先读对应 references 或用 `-h` 查看帮助，不要猜参数。
 - **Google 新建搜索系列**：流程仅在 `references/google-ads-campaign-plan.md` 维护。
+- **PMax 暂未开放**：**禁止**调用任何 `ad pmax-*` 搭建/写入命令（含 `pmax-create`、`pmax-validate`、`pmax-edit`、`pmax-asset-group-*`、`pmax-assets-update` 等）。用户要新建或改 PMax 时，说明 CLI 能力仍在测试，请在 **Google Ads UI** 操作；数据分析可用 `google-analysis` / `ad campaigns`（读 `channelTypeV2=PERFORMANCE_MAX`），运营建议可读 `references/google-ads-rules/google-ads-pmax-guide.md`（只读参考，不含 CLI 搭建步骤）。
 - **Google 开户**：`open-account google-wizard` 仅限真实 TTY；Agent/自动化用非交互 `open-account google ...`，审核进度用 `account-history`。
 - **主动更新**：详见 `references/setup.md`。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.21-beta.6",
-  "publishedAt": 1779702256218
+  "version": "1.1.21",
+  "publishedAt": 1779760187569
 }

package/dist/skill/references/finance.md

@@ -7,7 +7,7 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
+对应页面：`https://www.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
@@ -133,10 +133,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：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
+- 现金充值（单笔）：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
 ```
 
 ---

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

@@ -13,7 +13,7 @@
 
 - 可执行真相只有 **JSON**（`assets/campaign-create-template.json` 同构）；Markdown 只读投影。
 - 改需求 **只改 JSON**，再 `campaign-validate`，再刷新 Markdown。
-- **PMax 系列创建**走独立流水线（勿用本文件 JSON 模板）：`assets/pmax-create-template.md` + `ad pmax-validate` / `ad pmax-create`；运营诊断见 `google-ads-rules/google-ads-pmax-guide.md`。
+- **PMax 系列创建暂未开放**：勿用 `ad pmax-*` 搭建命令；请在 Google Ads UI 操作。运营诊断（只读）见 `google-ads-rules/google-ads-pmax-guide.md`。
 - 搜索网络：仅 Google 搜索（`TargetSearchNetwork`/`TargetContentNetwork`/`TargetPartnerSearchNetwork` 均为 false）。
 
 ---
@@ -63,8 +63,8 @@
 | `google-ads-rules/google-ads-keyword-optimization.md` | 上线后优化，非首建 |
 | `google-ads-rules/google-ads-account-audit.md` | 账户诊断，非首建 |
 | `google-ads-rules/google-ads-audience-strategy.md` | 受众/RLSA |
-| `google-ads-rules/google-ads-pmax-guide.md` | PMax 运营/诊断；**创建**见 `assets/pmax-create-template.md` |
-| `references/pmax-api.md` | PMax 网关路径与 Search API 边界 |
+| `google-ads-rules/google-ads-pmax-guide.md` | PMax 运营/诊断（只读参考；**CLI 搭建暂未开放**） |
+| `references/pmax-api.md` | PMax 网关路径（开发参考；生产勿调用搭建命令） |
 
 复述给用户：**3–5 条**与本次任务相关的合规/策略要点即可，无需罗列全部文件名。
 

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

@@ -31,6 +31,10 @@
 
 ## 新建 Performance Max（PMax）
 
+> **⛔ 暂未开放（生产）**：PMax CLI 搭建/写入能力仍在测试，**禁止** Agent 或用户通过 `ad pmax-create` / `pmax-validate` / `pmax-edit` 等命令操作。请在 **Google Ads UI** 新建与管理 PMax。本地联调可设环境变量 `SILUZAN_PMAX_SETUP=1` 后使用 CLI（开发专用）。
+>
+> 下列命令文档保留供后续上线参考，**当前勿执行**。
+
 > **与 Search 隔离**：勿用 `campaign-create` 或 `campaign-create-template.json`。网关摘录见 `references/pmax-api.md`。
 
 | 步骤 | 命令 |

package/dist/skill/references/pmax-api.md

@@ -1,5 +1,7 @@
 # Performance Max 网关 API（CLI 对照）
 
+> **⛔ 暂未开放（生产）**：PMax CLI 搭建/写入仍在测试。Skill 路由已屏蔽；CLI 默认拒绝 `pmax-create` 等写入命令。请在 Google Ads UI 操作，或本地设 `SILUZAN_PMAX_SETUP=1` 联调。
+>
 > 完整契约：Sammamish `src/GoogleAPI/docs/pmax-frontend-api.md`
 
 ---

package/dist/skill/references/rag.md

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

package/dist/skill/references/reporting.md

@@ -214,8 +214,8 @@ siluzan-tso report list -m Google --json
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www-ci.siluzan.com
+# webUrl: https://www.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www.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@beta
+npm install -g siluzan-tso-cli
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -129,9 +129,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api-ci.siluzan.com
-  googleApiUrl : https://googleapi-ci.mysiluzan.com
-  webUrl       : https://www-ci.siluzan.com
+  apiBaseUrl   : https://tso-api.siluzan.com
+  googleApiUrl : https://googleapi.mysiluzan.com
+  webUrl       : https://www.siluzan.com
   apiKey       : abcd****1234
 ```
 

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

@@ -6,7 +6,7 @@
 
 用 `siluzan-tso config show` 读取 **`webUrl`**，再拼接路径：
 
-首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
 
 > 若用户已登录 TSO，也可从左侧菜单进入「首页」。
 

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.21-beta.6'
+$PKG_VERSION = '1.1.21'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
-$WEB_BASE    = 'https://www-ci.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
+$WEB_BASE    = 'https://www.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.21-beta.6"
+readonly PKG_VERSION="1.1.21"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
-readonly WEB_BASE="https://www-ci.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
+readonly WEB_BASE="https://www.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

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