siluzan-tso-cli 1.1.20-beta.21 → 1.1.20-beta.23

package/dist/skill/SKILL.md

@@ -152,7 +152,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
   - `ad campaigns --json/--json-out` → `budget`（元，与 `campaign-edit --budget` 同口径）
   - `ad groups --json` → `maxCPCAmountYuan` / `targetCpaAmountYuan`（元）
   - `google-analysis campaigns-*.json` → `budgetAmountYuan` / `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan` / `spend` / `averageCpc` / `costPerConversion`（均元）
-  - `keyword --json` → `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` + 每条 `bidAmountCurrency`（无 `-a` 为 USD，可选 `averageCpcCNY` 汇率参考；有 `-a` 为账户 `currencyCode`，勿用汇率换算）；`-a <mediaCustomerId>` 走账户级推荐接口；限定市场用 `keyword geo-list` + `--geo <id>`（**多 id = 汇总指标**；分市场须多次调用、每次一个 `--geo`，见 `references/keyword-planner-workflows.md`）
+  - `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) 用户提供网址 → 域名占位并标注 `[待确认品牌名]`。**严禁**把英文域名翻译为虚构中文品牌。
 - 完整字段表见 `references/currency.md`。
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.20-beta.21",
-  "publishedAt": 1779348843065
+  "version": "1.1.20-beta.23",
+  "publishedAt": 1779357196416
 }

package/dist/skill/assets/campaign-create-template.md

@@ -23,11 +23,11 @@ JSON 模板：同目录 [`campaign-create-template.json`](campaign-create-templa
 
 | 命令 | 支持 `--json-out`？ | 推荐用法 |
 | ---- | :-----------------: | -------- |
-| `ad campaign-validate` | **否** | `siluzan-tso ad campaign-validate --config-file ./campaign.json` 或加 `--json`；规范化输出用 `--write-normalized ./campaign.normalized.json` |
-| `ad campaign-create` | **是**（较新版本） | 落盘任务响应：`--json-out ./snap-campaign`；与 `--json` 互斥。若报 `unknown option --json-out`，升级 `siluzan-tso` 或暂用 `--json` |
+| `ad campaign-validate` | **是** | **推荐** `--json-out ./snap-campaign`（落盘 `ad-campaign-validate-<account>.json`，含 `lengthViolations`）；与 `--json` 互斥。人读：`--config-file` 即可；词面规范化：`--write-normalized`。超长勿自动截断，见 `google-ads-campaign-plan.md` § 超长人工确认 |
+| `ad campaign-create` | **是** | 落盘任务响应：`--json-out ./snap-campaign`；与 `--json` 互斥 |
 | `ad batch get` / `ad batch diff` | **是** | 轮询与 diff 结果落盘，见 `references/tips.md` |
 
-**禁止**：对 `campaign-validate` 加 `--json-out`（会报参数不支持，浪费多轮重试）。
+**Agent**：校验与 create/batch 共用同一 `--json-out` 目录时，按 stdout 摘要里的 `outlineFile` → 再读对应 JSON（勿把 outline 当数据）。
 
 ### RSA 落地页：`Finalurl` 必填
 

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

@@ -83,7 +83,7 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 | `ad campaigns --json`                               | `budget`（元，与 `--budget` 写参同口径）                                                                                                  |
 | `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，可选 `averageCpcCNY` 参考） |
+| `keyword suggest --json`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；根级与每条 `bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD） |
 | `balance` 等账户余额接口                            | `remainingAccountBudget`（元）                                                                                                            |
 
 旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。

package/dist/skill/references/currency.md

@@ -46,7 +46,7 @@
 
 ## 金额单位约定
 
-- **CLI 出口的大多数 JSON / 表格金额以「元」为单位**：`budget`、`*Yuan` 后缀（`budgetAmountYuan`、`maxCPCAmountYuan` 等）、`spend` / `averageCpc` / `costPerConversion` 等。**`keyword suggest`**：`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 的币种见根级与每条 **`bidAmountCurrency`**（传 `-a` 时为账户 `currencyCode`；无 `-a` 时为 **USD**，可选 `averageCpcCNY` 为汇率参考、非 Google 账户口径）。
+- **CLI 出口的大多数 JSON / 表格金额以「元」为单位**：`budget`、`*Yuan` 后缀（`budgetAmountYuan`、`maxCPCAmountYuan` 等）、`spend` / `averageCpc` / `costPerConversion` 等。**`keyword suggest`**：`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 的币种见根级与每条 **`bidAmountCurrency`**（传 `-a` 时为账户 `currencyCode`；无 `-a` 时为 **USD**）。
 - **写 CLI 参数**（`--budget`、`--max-cpc`、`--target-cpa`、`--amount` 等）：同样传**主币种元**，与账户 `currencyCode` 一致；CLI 内部按需 ×100 / ×1_000_000 写后端。
 - 旧版网关字段（`budgetAmount` 分、`*Micros` 微元、`maxCPCAmountDisplay` 等）**已不再落盘到 CLI 输出**，下游脚本无需做单位换算。
 

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

@@ -26,7 +26,7 @@
 | 2 | 可选 `rag query`；`keyword` / `keyword geo-list` 拓词 | `references/keyword-planner-workflows.md` |
 | 3 | 按分层规则写入 `KeywordsForBatchJob`（Exact/Phrase/Broad） | `google-ads-rules/google-ads-keyword-taxonomy.md`（参考，非 CLI 强制） |
 | 4 | 填 `campaign`（预算/出价/地域/否词≥20/RSA/附加信息） | `assets/campaign-create-template.md` |
-| 5 | **`ad campaign-validate --config-file <json>`**（失败只改 JSON） | 下文「校验」 |
+| 5 | **`ad campaign-validate --config-file <json>`**（失败只改 JSON；超长见下文「超长人工确认」） | 下文「校验」 |
 | 6 | 输出：**JSON 代码块** → **Markdown**（`google-ads-launch-plan-template.md` 正文）→ 待确认 | — |
 | 7 | 用户确认后 **`ad campaign-create`** | `google-ads.md`|
 | 8 | 每隔5s 获取创建结果| `ad batch get --id <taskId> --config-file ./campaign.json` |
@@ -72,7 +72,8 @@
 ## 校验与创建（命令速查）
 
 ```bash
-siluzan-tso ad campaign-validate --config-file ./campaign.json [--json] [--write-normalized <path>] --commit "xxx"
+siluzan-tso ad campaign-validate --config-file ./campaign.json --json-out ./snap-campaign
+siluzan-tso ad campaign-validate --config-file ./campaign.json [--json] [--write-normalized <path>]
 siluzan-tso ad campaign-create --config-file ./campaign.json
 siluzan-tso ad batch get --id <taskId> --config-file ./campaign.json
 siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json
@@ -81,6 +82,17 @@ siluzan-tso ad geo search
 
 validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 + 后端/Google 硬约束（预算、RSA、匹配符号与 `MatchTypeV2` 对齐、搜索网络等）。**不含**关键词分层数量、匹配占比、否词条数下限。
 
+### 超长内容：禁止 Agent 自动截断
+
+标题/描述/Path/关键词/Sitelink 超限时 CLI **报错阻断**，不会在 JSON 里静默改短。
+
+1. 使用 **`ad campaign-validate --config-file <json> --json-out <dir>`**（与 create/batch 同一落盘目录），读落盘文件中的 `lengthViolations`（每项含 `path`、`limit`、`actual`、**完整** `text`）。小文件可用 `--json` 代替。
+2. Agent 将 **全部** 超长条目整理成表（路径、原文、上限、超出量），并为每条给出 **1–2 个改写方案**（保留卖点、符合字符计数；CJK 按 2 计见 `google-ads-compliance.md` §3.2.1）。
+3. **用户确认**选用方案后，Agent **只改 JSON 对应字段**，再执行 `campaign-validate`；通过后再 `campaign-create`。
+4. **禁止**：未确认前 `slice`/省略号截断、仅改 `--write-normalized` 而不经用户确认。
+
+人读模式失败时 CLI 会额外打印「📏 超长内容清单」；`--json-out` / `--json` 时见 `lengthViolations` + `agentHint`。
+
 ---
 
 ## 已上线后的修改

package/dist/skill/references/google-ads-rules/google-ads-campaign-optimization.md

@@ -249,6 +249,7 @@ siluzan-tso ad geo add -a <CID> --campaign-id <ID> --location-id <ID> --exclude
 
 # 添加出价调整（+20%）
 siluzan-tso ad geo add -a <CID> --campaign-id <ID> --location-id <ID> --bid-modifier 1.2
+siluzan-tso ad geo set-bid -a <CID> --campaign-id <ID> --location-id <ID> --bid-modifier 1.2
 
 # 查看地域效果报告
 siluzan-tso google-analysis -a <CID> --sections geographic

package/dist/skill/references/google-ads-rules/google-ads-keyword-taxonomy.md

@@ -54,7 +54,7 @@
 | 技术词 | api/sdk/integration | payment sdk integration |
 | 问题词 | how to + 问题 | how to reduce failed payments |
 
-拓词编排见 `references/keyword-planner-workflows.md`；Planner 出价用 `*USD` 与 `*CNY`，根级 `bidAmountCurrency` / `usdToCnyExchangeRate`。
+拓词编排见 `references/keyword-planner-workflows.md`；Planner 出价见 `averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 与根级、每条 `bidAmountCurrency`。
 
 ---
 

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

@@ -6,8 +6,7 @@
 
 ## 金额单位（全局重要）
 
-> **所有 CLI 金额参数均按「主币种金额」传入**（如 `1.5` = ¥1.50 / $1.50）
-> **唯一例外**：`ad keyword-edit --max-cpc` 单位为「主币种元」（直接透传，不做 ×100 转换）。
+> **所有 CLI 金额参数均按「主币种金额」传入**（如 `1.5` = ¥1.50 / $1.50）；CLI 写入网关前对「分」字段 ×100（含 `ad keyword-edit --max-cpc` → `maxCPC`）。
 > **禁止** 按 Google micros（×1,000,000）填写任何金额参数。
 
 ---
@@ -277,6 +276,8 @@ siluzan-tso keyword geo-list [--country-code <US,CN,...>] [--name-contains <text
 
 不提交 API；创建系列前**建议**跑。命令、选项、与 create 共用校验逻辑见 **`references/google-ads-campaign-plan.md`** § 校验与创建（后端/Google 硬约束，不含关键词分层占比）。
 
+**超长内容**：加 **`--json-out <dir>`**（推荐，与 create/batch 共用目录）或 `--json` 时响应含 `lengthViolations`（完整 `text` + JSON `path`）。Agent **勿自动截断**；须列出全部超长项与改写方案，用户确认后再改 JSON 并重跑 validate（流程见 `google-ads-campaign-plan.md` § 超长人工确认）。
+
 ---
 
 ## ad campaign-create — 广告系列创建
@@ -442,7 +443,7 @@ siluzan-tso ad keyword-edit \
   [--max-cpc <n>] [--final-url <url>] [--status Enabled|Paused]
 ```
 
-传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为「主币种元」（见文首金额单位说明）。`--status` 写入 `userStatusV2`（与 Web 关键词开关一致，非系列的 `statusV2`）。
+传 `--match-type` 时 CLI 自动规范 `keywordText` 括号/引号格式。至少传一项。`--max-cpc` 为主币种元（CLI ×100 写入 `maxCPC`「分」字段，与 `adgroup-edit --max-cpc` 同口径）。`ad keywords --json` 出价见 `maxCPCYuan`。`--status` 写入 `userStatusV2`（与 Web 关键词开关一致，非系列的 `statusV2`）。
 
 ---
 
@@ -520,10 +521,29 @@ siluzan-tso ad geo list -a <accountId> --mode targeted|excluded|report [--start/
 # 添加定向
 siluzan-tso ad geo add -a <accountId> --campaign-id <id> --location-id <id> [--bid-modifier 1.2] [--exclude]
 
+# 修改已定向地区的出价调整（系列级 campaign_criterion）
+siluzan-tso ad geo set-bid -a <accountId> --campaign-id <id> --location-id <id> --bid-modifier 1.2
+# 或使用 list 返回的 criterion id
+siluzan-tso ad geo set-bid -a <accountId> --campaign-id <id> --criterion-id <id> --bid-modifier 0.8
+
 # 删除
 siluzan-tso ad geo remove -a <accountId> --campaign-id <id> --location-id <id>
 ```
 
+**`--bid-modifier` 口径（`add` / `set-bid` 均为 Google 倍率）**
+
+| 倍率 | 含义 |
+|------|------|
+| `1.0` | 不调整 |
+| `1.2` | 提高 20% |
+| `0.8` | 降低 20% |
+
+- `add`：写入 `PUT …/criterion/{account}` 时 CLI 会换算为后端百分比。
+- `set-bid`：直接 `PUT …/campaigns/{campaignId}/Criteria/{criterionId}/BidModifier/{bidModifier}`，与 `ad device-bid set`（系列级）、AI 优化 `updateDeviceAndAddress` 同源。
+- `list` 返回的 `bidModifier` 为 Google 倍率（非网页编辑弹窗里的 `+10` 百分比）。
+
+**Sammamish 落点**：`ModifyCampaignCriteriaBidModifier` → `GoogleAdsAcctMgmtServiceProviderV2.ModifyCampaignCriteriaBidModifier`。
+
 ---
 
 ## ad device-bid — 设备出价调整

package/dist/skill/references/keyword-planner-workflows.md

@@ -205,6 +205,6 @@ siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [
 
 `--google-only`：只调 Google 推荐主接口（有 `-a` 为账户接口，无 `-a` 为 `keywordidea/google`），不叠加 `--url` 的网址拓词；**分支 B（仅 Google）必加**。
 
-**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级与每条 **`bidAmountCurrency`**（无账户=`USD`；有账户=`list-accounts` 的 `currencyCode`）；`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（微元 ÷1,000,000，**与 `bidAmountCurrency` 一致**）。无账户 USD 时可选 `usdToCnyExchangeRate` 与 `averageCpcCNY` 等**参考**字段（非 Google 账户币种口径）。另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。
+**返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级与每条 **`bidAmountCurrency`**（无账户=`USD`；有账户=`list-accounts` 的 `currencyCode`）；`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（微元 ÷1,000,000，**与 `bidAmountCurrency` 一致**）。另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。
 
 与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。

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