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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/README.md +1 -1
  2. package/dist/index.js +1 -1
  3. package/dist/skill/_meta.json +2 -2
  4. package/dist/skill/assets/pmax-patch-campaign-template.json +1 -1
  5. package/dist/skill/references/analytics/account-analytics.md +1 -1
  6. package/dist/skill/references/google-ads/google-ads-write.md +1 -1
  7. package/dist/skill/references/google-ads/pmax-api.md +2 -2
  8. package/dist/skill/references/report-templates/google-period-report-excel.md +3 -1
  9. package/dist/skill/report-templates/google-period-report-excel.md +3 -1
  10. package/dist/skill/scripts/install.ps1 +1 -1
  11. package/dist/skill/scripts/install.sh +1 -1
  12. package/package.json +1 -1
package/README.md CHANGED
@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
51
51
  siluzan-tso init --force # 强制覆盖已存在文件
52
52
  ```
53
53
 
54
- > **注意**：当前为测试版（1.1.61-beta.1），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
54
+ > **注意**：当前为测试版（1.1.61-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
55
55
 
56
56
  | 助手 | 建议 `--ai` |
57
57
  | ----------------------- | ------------------------------------ |
package/dist/index.js CHANGED
@@ -126323,7 +126323,7 @@ function register21(program2) {
126323
126323
  );
126324
126324
  addPmaxJsonOptions(
126325
126325
  adCmd.command("pmax-edit").description(
126326
- "\u66F4\u65B0 PMax \u6D3B\u52A8\uFF08PATCH\uFF1B\u52FF\u7528 ad campaign-edit\uFF09\n --patch-file \u89C1 assets/pmax-patch-campaign-template.json\uFF1BassetAutomationSettings \u53EA\u6539\u63D0\u4EA4\u7684\u7C7B\u578B"
126326
+ "\u66F4\u65B0 PMax \u6D3B\u52A8\uFF08PATCH\uFF1B\u52FF\u7528 ad campaign-edit\uFF09\n --patch-file \u89C1 assets/pmax-patch-campaign-template.json\uFF1BassetAutomationSettings \u53EA\u6539\u63D0\u4EA4\u7684\u7C7B\u578B\uFF1BtextGuidelines \u672A\u4F20\u4E0D\u5199\u3001\u4F20 {} \u6E05\u7A7A"
126327
126327
  ).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(
126328
126328
  "--status <status>",
126329
126329
  "2|3|4 \u6216 Enabled|Paused|Removed\uFF08Removed \u4E0D\u53EF\u6062\u590D\uFF0C\u987B\u7528\u6237\u540C\u610F\u540E\u52A0 --i-confirm\uFF09"
package/dist/skill/_meta.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.61-beta.1",
4
- "publishedAt": 1793256524212
3
+ "version": "1.1.61-beta.2",
4
+ "publishedAt": 1793260558087
5
5
  }
package/dist/skill/assets/pmax-patch-campaign-template.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "_comment": "PATCH 活动；budget/targetCpa 填主币种元，CLI 自动 ×100。assetAutomationSettings 只改提交的类型，例如 GENERATE_IMAGE_ENHANCEMENT / GENERATE_IMAGE_EXTRACTION（OPTED_IN 或 OPTED_OUT）。未提交不写，避免把默认增强关掉",
2
+ "_comment": "PATCH 活动；budget/targetCpa 填主币种元，CLI 自动 ×100。assetAutomationSettings 只改提交的类型，例如 GENERATE_IMAGE_ENHANCEMENT / GENERATE_IMAGE_EXTRACTION（OPTED_IN 或 OPTED_OUT）。未提交不写。需要改文字规范时另加 textGuidelines（整段替换；传 {} 清空；termExclusions≤25×30；messagingRestrictions≤40×300；restrictionType 仅 RESTRICTION_BASED_EXCLUSION）。不要把 textGuidelines 留在只改预算的文件里",
3
3
  "id": "12345678901",
4
4
  "budgetId": "111222333",
5
5
  "budget": 5.5,
package/dist/skill/references/analytics/account-analytics.md CHANGED
@@ -214,7 +214,7 @@ const data = d.record ?? d.items; // record 非空=汇总维度；否则=列表
214
214
 
215
215
  `items[]` 每行额外包含：`conversionsValue`、`conversionsValuePerCost`（`spend ≤ 0` 时为 0）、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`、`manualCpcEnhancedCpcEnabled`、`percentCpcEnhancedCpcEnabled`。所有金额字段（`*Yuan` 后缀）已统一为元，可直接展示，无需换算。
216
216
 
217
- 账户级转化价值 / 单转化价值 / ROAS 只对 `items[]` 汇总：`Σ conversionsValue`、`Σ conversionsValue / Σ conversions`、`Σ conversionsValue / Σ spend`。禁止对行上 `conversionsValuePerCost` 再平均。`overview` 的 `currentPeriod` / `previousPeriod` **没有** `conversionsValue`。上期这三项另拉等长上一周期的 `campaigns` 再同样汇总（窗口见 `report-templates/google-period-report-excel.md`），禁止留空或用本期估算。
217
+ 账户级转化价值 / 单转化价值 / ROAS：先确认 `campaigns` 行是否带 `conversionsValue`；有才对 `items[]` 汇总（`Σ conversionsValue`、`÷ Σ conversions`、`÷ Σ spend`），禁止对行上 `conversionsValuePerCost` 再平均。整批无该字段 → 写「未返回」，禁止用转化次数×1 等估算。`overview` period 块通常没有此字段。上期另拉等长上一周期 `campaigns` 再同样判断（见 `google-period-report-excel.md`）。
218
218
 
219
219
  | 字段 | 含义 |
220
220
  | ------------------------------------- | ------------------------------------------------ |
package/dist/skill/references/google-ads/google-ads-write.md CHANGED
@@ -84,7 +84,7 @@
84
84
  | 能力 | 命令 |
85
85
  | ---------------- | ----------------------------------------------------------------------------------------------------------------------------- |
86
86
  | 详情 | `ad pmax-get -a <id> --campaign-id <cid>`（读 `_brandGuidelinesActive`） |
87
- | 改活动 | `ad pmax-edit`（`--patch-file` 或 `--status` / `--budget` + `--budget-id`；`assetAutomationSettings` 只改提交类型，如图片增强/提取；改 `Removed` 须用户同意 + `--i-confirm`） |
87
+ | 改活动 | `ad pmax-edit`（`--patch-file` 或 `--status` / `--budget` + `--budget-id`；`assetAutomationSettings` 只改提交类型；`textGuidelines` 未传不写、传 `{}` 清空；改 `Removed` 须用户同意 + `--i-confirm`） |
88
88
  | 改 Campaign 品牌 | `ad pmax-brand-assets-edit`（BG 已开启） |
89
89
  | 启用 BG | `ad pmax-brand-guidelines-enable --config-file …`（存量活动） |
90
90
  | 新资产组 | `ad pmax-asset-group-create --config-file …`（BG 下自动省略品牌） |
package/dist/skill/references/google-ads/pmax-api.md CHANGED
@@ -18,8 +18,8 @@
18
18
  | `ad pmax-validate` | 本地校验 |
19
19
  | `ad pmax-create` | 创建系列（同步返回 `campaignId` 等；失败时把已建成编号写回 JSON 再跑） |
20
20
  | `ad pmax-channel-types` | 渠道类型列表 |
21
- | `ad pmax-get` | 系列详情（含 `brandAssets[]`；`--json-out` 附加 `_brandGuidelinesActive`、`_agentBrandHint`） |
22
- | `ad pmax-edit` | 编辑系列（预算/出价/状态/`assetAutomationSettings`；**不可**改 `brandGuidelinesEnabled`）。图片增强/提取只改提交的类型，不进创建默认值 |
21
+ | `ad pmax-get` | 系列详情（含 `brandAssets[]`；只读 `negativeGenderExclusions` / `negativeKeywordExclusions` 若 Google 回传；`--json-out` 附加 `_brandGuidelinesActive`、`_agentBrandHint`） |
22
+ | `ad pmax-edit` | 编辑系列（预算/出价/状态/`assetAutomationSettings`/`textGuidelines`；**不可**改 `brandGuidelinesEnabled`）。图片增强/提取只改提交的类型；`textGuidelines` 未传不写，传了整段替换，传 `{}` 清空 |
23
23
  | `ad pmax-brand-assets-edit` | BG 已开启时改 Campaign 级品牌（商家名/Logo/样式） |
24
24
  | `ad pmax-brand-guidelines-enable` | 存量活动启用 BG（不可关闭） |
25
25
  | `ad pmax-asset-group-create` | 新建资产组 |
package/dist/skill/references/report-templates/google-period-report-excel.md CHANGED
@@ -82,7 +82,9 @@ siluzan-tso google-analysis -a <id> --start <S> --end <E> --json-out ./snap-p4 \
82
82
 
83
83
  `overview.currentPeriod` / `previousPeriod` **没有** `conversionsValue`。账户级「转化价值 / 单转化价值 / ROAS」只从 **`campaigns` 的 `items[]`** 汇总。消耗、点击、转化次数、CTR、CPC、CPA 的环比仍读 overview 的 `previousPeriod`。
84
84
 
85
- 终稿核心指标（或等价的本期 vs 上期表）出现这三行时，**必须**再拉等长上期的 `campaigns`，两期用同一公式。上期这三格禁止写成「—」，也禁止用本期去估。
85
+ 终稿核心指标（或等价的本期 vs 上期表）出现这三行时，**必须**再拉等长上期的 `campaigns`，两期用同一公式。
86
+
87
+ **先看后台有没有返回**：以当次 `campaigns-*.outline.txt` / 行上是否出现 `conversionsValue` 为准。有字段 → 按下面公式汇总填数（值为 0 也如实写 0，不要改成「—」）；**整批都没有该字段** → 写「未返回」，禁止用转化次数×1、固定客单或其它维度去估。上期同理：上期 campaigns 有字段才填上期三格，禁止用本期去估。
86
88
 
87
89
  **上期窗口**（与 Web `calcPrePeriodTimeRange` 相同，含首尾）：
88
90
 
package/dist/skill/report-templates/google-period-report-excel.md CHANGED
@@ -82,7 +82,9 @@ siluzan-tso google-analysis -a <id> --start <S> --end <E> --json-out ./snap-p4 \
82
82
 
83
83
  `overview.currentPeriod` / `previousPeriod` **没有** `conversionsValue`。账户级「转化价值 / 单转化价值 / ROAS」只从 **`campaigns` 的 `items[]`** 汇总。消耗、点击、转化次数、CTR、CPC、CPA 的环比仍读 overview 的 `previousPeriod`。
84
84
 
85
- 终稿核心指标（或等价的本期 vs 上期表）出现这三行时，**必须**再拉等长上期的 `campaigns`，两期用同一公式。上期这三格禁止写成「—」，也禁止用本期去估。
85
+ 终稿核心指标（或等价的本期 vs 上期表）出现这三行时，**必须**再拉等长上期的 `campaigns`，两期用同一公式。
86
+
87
+ **先看后台有没有返回**：以当次 `campaigns-*.outline.txt` / 行上是否出现 `conversionsValue` 为准。有字段 → 按下面公式汇总填数（值为 0 也如实写 0，不要改成「—」）；**整批都没有该字段** → 写「未返回」，禁止用转化次数×1、固定客单或其它维度去估。上期同理：上期 campaigns 有字段才填上期三格，禁止用本期去估。
86
88
 
87
89
  **上期窗口**（与 Web `calcPrePeriodTimeRange` 相同，含首尾）：
88
90
 
package/dist/skill/scripts/install.ps1 CHANGED
@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
9
9
  # -- Package info (injected at build time) ------------------------------------
10
10
  $PKG_NAME = 'siluzan-tso-cli'
11
11
  # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
12
- $PKG_VERSION = '1.1.61-beta.1'
12
+ $PKG_VERSION = '1.1.61-beta.2'
13
13
  $CLI_BIN = 'siluzan-tso'
14
14
  $SKILL_LABEL = 'Siluzan TSO'
15
15
  $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
package/dist/skill/scripts/install.sh CHANGED
@@ -9,7 +9,7 @@ set -euo pipefail
9
9
  # -- Package info (injected at build time) ------------------------------------
10
10
  readonly PKG_NAME="siluzan-tso-cli"
11
11
  # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
12
- readonly PKG_VERSION="1.1.61-beta.1"
12
+ readonly PKG_VERSION="1.1.61-beta.2"
13
13
  readonly CLI_BIN="siluzan-tso"
14
14
  readonly SKILL_LABEL="Siluzan TSO"
15
15
  readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.1.61-beta.1",
3
+ "version": "1.1.61-beta.2",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
5
5
  "keywords": [
6
6
  "ad-account",