siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

package/dist/skill/AGENTS.md

@@ -14,48 +14,47 @@
 
 ## 文档域（gstack-style domains）
 
-| 域 | 路径 | 何时 Read |
-| --- | --- | --- |
-| **Core** | `references/core/` | 纪律、安装、tips、playbooks、workflows、subagent-orchestration |
-| **Handoff** | `snippets/` | P5/P6/P7 Task 派发模板（与 SKILL 同级） |
-| **Accounts** | `references/accounts/` | 列表、余额、开户、财务、审计 |
-| **Google Ads** | `references/google-ads/` | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP |
-| **Analytics** | `references/analytics/` | 拉数、批处理、拓词、RAG、TSO 报告 |
-| **Operations** | `references/operations/` | 预警、线索、优化记录、宿主编排自动化 |
-| **Templates** | `assets/`、`report-templates/` | JSON 契约、报告纲要 |
+| 域             | 路径                                                                 | 何时 Read                                                      |
+| -------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- |
+| **Core**       | `references/core/`                                                   | 纪律、安装、tips、playbooks、workflows、subagent-orchestration |
+| **Handoff**    | `snippets/`                                                          | P5/P6/P7 Task 派发模板（与 SKILL 同级）                        |
+| **Accounts**   | `references/accounts/`                                               | 列表、余额、开户、财务、审计                                   |
+| **Google Ads** | `references/google-ads/`                                             | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP                |
+| **Analytics**  | `references/analytics/`                                              | 拉数、批处理、拓词、RAG、TSO 报告                              |
+| **Operations** | `references/operations/`                                             | 预警、线索、优化记录、宿主编排自动化                           |
+| **Templates**  | `assets/`、`references/report-templates/`、`report-templates/*.html` | JSON 契约、报告纲要、HTML 样式                                 |
 
 ## 工作流目录
 
-| 类别 | 文档 | 编号 |
-| --- | --- | --- |
-| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9 |
+| 类别          | 文档                           | 编号   |
+| ------------- | ------------------------------ | ------ |
+| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9  |
 | 操作 / 管理类 | `references/core/workflows.md` | W1–W12 |
 
 专用报告模板（被工作流卡片引用）：
 
-| ID | 文档 |
-| --- | --- |
-| 网站诊断 | `report-templates/website-diagnosis-report.md` |
-| 战略市场分析 | `report-templates/market-analysis-report.md` |
-| Google 周期 Excel | `report-templates/google-period-report-excel.md`（P4，先 outline 后脚本） |
-| OKKI 周报 | `report-templates/okki-weekly-google-client.md` |
-| 询盘分析 | `report-templates/google-inquiry-analysis.md` |
+| ID                | 文档                                                              |
+| ----------------- | ----------------------------------------------------------------- |
+| 网站诊断          | `references/report-templates/website-diagnosis-report.md`         |
+| 战略市场分析      | `references/report-templates/market-analysis-report.md`           |
+| Google 周期 Excel | `references/report-templates/google-period-report-excel.md`（P4） |
+| OKKI 周报         | `references/report-templates/okki-weekly-google-client.md`        |
+| 询盘分析          | `references/report-templates/google-inquiry-analysis.md`          |
 
 ## 维护
 
-- 结构规范：`references/core/skill-authoring.md`
-- 人类深读：`docs/skill-guide.md`
 - 源码唯一真相：`tso-cli/assets/siluzan-ads/`（勿编辑 `skills/siluzan-tso/` 副本）
+- 通用纪律唯一真相源：`references/core/agent-conventions.md`（其他文档只单行指向，不复制规则）
 
 ## CLI 代码域（与文档对齐）
 
-| CLI 模块 | 文档域 |
-| --- | --- |
-| `src/commands/list-accounts/`、`accounts-digest/`、`balance-scan/` | accounts |
-| `src/commands/open-account/`、`account-manage-register.ts` | accounts |
-| `src/commands/ad/` | google-ads |
-| `src/commands/google-analysis/`、`google-analysis-batch.ts` | analytics |
-| `src/commands/website-diagnosis/` | analytics（网站诊断） |
-| `src/commands/market-analysis/` | analytics（战略市场分析） |
-| `src/commands/report/` | analytics + report-templates |
-| `src/commands/forewarning/`、`optimize/`、`clue.ts` | operations |
+| CLI 模块                                                           | 文档域                       |
+| ------------------------------------------------------------------ | ---------------------------- |
+| `src/commands/list-accounts/`、`accounts-digest/`、`balance-scan/` | accounts                     |
+| `src/commands/open-account/`、`account-manage-register.ts`         | accounts                     |
+| `src/commands/ad/`                                                 | google-ads                   |
+| `src/commands/google-analysis/`、`google-analysis-batch.ts`        | analytics                    |
+| `src/commands/website-diagnosis/`                                  | analytics（网站诊断）        |
+| `src/commands/market-analysis/`                                    | analytics（战略市场分析）    |
+| `src/commands/report/`                                             | analytics + report-templates |
+| `src/commands/forewarning/`、`optimize/`、`clue.ts`                | operations                   |

package/dist/skill/SKILL.md

@@ -20,17 +20,9 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 <!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}}；构建时由 gen-skill-docs.mjs 合并 -->
 
-> **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 路由表 Read「必读文档」与对应工作流卡片（`core/playbooks.md` P1–P9 或 `core/workflows.md` W1–W12）。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（见 `references/core/tips.md`）——**禁止**用 Read 工具打开 `writtenFiles` 里的完整 `*.json`。
+> **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
 >
-> **报告/Excel 交付前**：Read `references/core/deliverable-preflight.md`，**Read 最终产物**并按自检表确认币种与章节完整；币种只认当次 `list-accounts` 的 `currencyCode`。
->
-> **Google Excel（P4）**：Read `report-templates/google-period-report-excel.md`；`list-accounts -k` 核验用户 ID；拉数后**先读齐**各 `*.outline.txt` 再写脚本；禁止 `cat|head` 预览业务 JSON、禁止第三方 xlsx Skill、禁止猜字段名。
->
-> **HTML 终稿类报告（用户未指定格式时默认 HTML）**：网站诊断 P8（`website-diagnosis render`）、Meta 周期 P4-FB（`facebook-analysis render`）、战略市场 P9（`market-analysis render`）。Agent 只写 JSON，**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
->
-> **开户**：首次进入开户话题须先向用户罗列该媒体（或未指明媒体时六平台）**全部必填项**，见 `references/accounts/open-account-by-media.md` §「首次响应硬规范」。
->
-> **Subagent（可选）**：若宿主支持 Task / 子会话，复杂报告（P5/P6/P7）或长 CLI 输出前 Read `references/core/subagent-orchestration.md`，**自行决定**是否委派；写操作确认与对用户的最终交付留在主 Agent。
+> **默认交付格式**：用户未指定格式时，网站诊断 P8、Meta 周期 P4-FB、战略市场 P9 默认 **HTML**（各自 `render` 子命令），Google 周期 P4 默认 HTML；**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
 
 ---
 
@@ -71,11 +63,11 @@ siluzan-tso -h   # 查看帮助
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查：`-m <媒体> --page-size 999 --json-out`） |
-| 单户实时余额 | W1 | `accounts/accounts.md`（balance）+ `accounts/currency.md` |
-| 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan）+ `accounts/currency.md` |
-| 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats）+ `accounts/currency.md` |
-| 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest）+ `accounts/currency.md` |
+| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `accounts/accounts.md`（§ list-accounts 意图速查） |
+| 单户实时余额 | W1 | `accounts/accounts.md`（balance） |
+| 多账户余额 / 续航不足预警 | **P2** | `accounts/accounts.md`（balance-scan） |
+| 单户消耗 / 投放数据 | W1 / **P1** | `accounts/accounts.md`（stats） |
+| 多账户消耗/对比汇总 | **P3** | `accounts/accounts.md`（accounts-digest） |
 | 激活/充值账单明细 | W1 | `accounts/accounts.md`（account-active-bills） |
 | 开户（六大媒体）/ 开户进度 | W2 | `accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `accounts/open-account-google-ui.md`） |
 | 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `accounts/accounts.md`（account 子命令） |
@@ -88,9 +80,9 @@ siluzan-tso -h   # 查看帮助
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 新建搜索系列 / 出投放方案 | W3 | `google-ads/google-ads-campaign-plan.md` + `assets/campaign-create-template.md` |
+| 新建搜索系列 / 出投放方案 | W3 | `google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（结构真相源，先 Read）+ `assets/campaign-create-template.md`（字段说明） |
 | 广告系列/组/广告/关键词 CRUD / 拒审 | W3 | `google-ads/google-ads.md` |
-| PMax 系列 | W3 | `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |
+| PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |
 | AI 智投草稿 list/get/update/publish | W4 | `google-ads/google-ads.md`（§ ad batch） |
 | 拓词 / keyword / 关键词规划 | W5 | `analytics/keyword-planner-workflows.md`（客户背景先 `analytics/rag.md`） |
 | AI 广告优化记录 / 建议 | W6 | `operations/optimize.md` |
@@ -100,16 +92,16 @@ siluzan-tso -h   # 查看帮助
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` + `core/tips.md` + `core/deliverable-preflight.md` |
-| Google 账户周期报告 | **P4** | `report-templates/google-period-report.md` + `analytics/account-analytics.md` + `core/tips.md` + `core/deliverable-preflight.md`；要 **Excel** 加 `report-templates/google-period-report-excel.md`（先 outline 后脚本，禁止第三方 xlsx Skill） |
-| Meta/Facebook 周期或诊断报告 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `analytics/facebook-analysis-guide.md`；要 Excel 加 `meta-period-report-excel.md` |
-| TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `report-templates/*-period-report.md` |
+| 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` |
+| Google 账户周期报告 | **P4** | `references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；要 **Excel** 加 `references/report-templates/google-period-report-excel.md` |
+| Meta/Facebook 周期或诊断报告 | **P4-FB** | `references/report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md` |
+| TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `references/report-templates/*-period-report.md` |
 | 多账户 × 多维度批处理 | **P5** | `analytics/google-analysis-batch.md` + `analytics/account-analytics.md` |
-| OKKI 周报 | **P6** | `report-templates/okki-weekly-google-client.md`（全文） |
-| Google 询盘分析 | **P7** | `report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
+| OKKI 周报 | **P6** | `references/report-templates/okki-weekly-google-client.md`（全文） |
+| Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
 | 网站诊断 / 落地页评分 | **P8** | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**默认交付 HTML**） |
 | 市场分析 / 行业 / 战略市场报告 | **P9** | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**默认交付 HTML**） |
-| Google 广告诊断 / 账户健康检查 | **P1** | `report-templates/google-ads-diagnosis.md` + `report-templates/google-account-diagnosis-report.md` |
+| Google 广告诊断 / 账户健康检查 | **P1** | `references/report-templates/google-ads-diagnosis.md` + `references/report-templates/google-account-diagnosis-report.md` |
 | TSO 平台优化报告：列表/生成/推送 | W7 | `analytics/reporting.md` |
 | RAG 知识库检索 | W5 | `analytics/rag.md` |
 
@@ -122,8 +114,6 @@ siluzan-tso -h   # 查看帮助
 | 日/周巡检 | W12 | `core/workflows.md`（W12）+ `accounts/accounts.md` |
 | 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `operations/hosted-automation-user-catalog.md`（索引）→ `operations/hosted-automation-*.md` |
 
-> **数据/报告类任务通用纪律**：一律 `--json-out` 落盘 + **仅用脚本**读 JSON（见 `core/tips.md`）；交付前 Read 最终产物按 `core/deliverable-preflight.md` 自检（币种/章节）。
-
 ---
 
 ## Subagent 自主委派（可选）
@@ -142,10 +132,3 @@ siluzan-tso -h   # 查看帮助
 | references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行 |
 
 详见 `operations/hosted-automation-self-control.md`、`operations/hosted-automation-monitoring-json.md`、`operations/hosted-automation-optimize-index.md`。
-
----
-
-## 维护者
-
-- `references/core/skill-authoring.md` — 规范与检查清单
-- `docs/skill-guide.md` — 人类导读

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.2",
-  "publishedAt": 1781060521326
+  "version": "1.1.29-beta.21",
+  "publishedAt": 1781769678495
 }

package/dist/skill/assets/campaign-create-keyword-test.fixed.json

@@ -3,13 +3,8 @@
   "customerName": "成功易人民币广告搭建测试账户",
   "name": "Searh_核心中东",
   "url": "https://www.hy-steelpipe.com/",
-  "locations": [
-    "United States"
-  ],
-  "productWords": [
-    "test",
-    "keyword"
-  ],
+  "locations": ["United States"],
+  "productWords": ["test", "keyword"],
   "googleDataRecordId": null,
   "draft": false,
   "campaign": {
@@ -114,10 +109,7 @@
     ],
     "NegativeKeywordsForBatchJob": [
       {
-        "KeywordText": [
-          "free sample",
-          "cheap"
-        ],
+        "KeywordText": ["free sample", "cheap"],
         "MatchTypeV2": "BROAD",
         "FinalURL": ""
       }
@@ -134,51 +126,36 @@
           {
             "FinalURL": "https://www.example.com/test-a",
             "MatchTypeV2": "BROAD",
-            "KeywordText": [
-              "broad match keyword"
-            ]
+            "KeywordText": ["broad match keyword"]
           },
           {
             "FinalURL": "https://www.example.com/test-a",
             "MatchTypeV2": "PHRASE",
-            "KeywordText": [
-              "\"phrase match keyword\""
-            ]
+            "KeywordText": ["\"phrase match keyword\""]
           },
           {
             "FinalURL": "https://www.example.com/test-a",
             "MatchTypeV2": "EXACT",
-            "KeywordText": [
-              "[exact match keyword]"
-            ]
+            "KeywordText": ["[exact match keyword]"]
           },
           {
             "FinalURL": "https://www.example.com/test-b",
             "MatchTypeV2": "BROAD",
-            "KeywordText": [
-              "running shoes broad"
-            ]
+            "KeywordText": ["running shoes broad"]
           },
           {
             "FinalURL": "https://www.example.com/test-b",
             "MatchTypeV2": "EXACT",
-            "KeywordText": [
-              "[steel pipe exact]"
-            ]
+            "KeywordText": ["[steel pipe exact]"]
           },
           {
             "MatchTypeV2": "EXACT",
-            "KeywordText": [
-              "[exact keyword one]",
-              "[exact keyword two]"
-            ],
+            "KeywordText": ["[exact keyword one]", "[exact keyword two]"],
             "FinalURL": "https://www.example.com/test-c"
           },
           {
             "MatchTypeV2": "PHRASE",
-            "KeywordText": [
-              "\"phrase keyword only\""
-            ],
+            "KeywordText": ["\"phrase keyword only\""],
             "FinalURL": "https://www.example.com/test-d"
           }
         ],

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

@@ -3,8 +3,10 @@
     "schema": "campaign-create/v2",
     "doc": "campaign-create-template.md",
     "note": "以 _ 开头的键仅作说明，CLI 提交前会剥离；字段名一律 PascalCase，直接对齐后端 CampaignCreationRecord + Campaign 契约",
+    "agentReadOrder": "Agent 建系列前必须先 Read 本 JSON（结构真相源），再 Read campaign-create-template.md（字段说明）；禁止只读 .md 手写 JSON",
     "agentPitfalls": [
       "campaign-validate 推荐 --json-out ",
+      "否词只写 campaign.NegativeKeywordsForBatchJob，禁止把 free/jobs/tutorial 等否词抄进 AdGroupsForBatchJob[].KeywordsForBatchJob",
       "RSA 须同时写 DestinationUrl 与 Finalurl（后端必填 Finalurl；仅有 DestinationUrl 时 validate 可能仍通过）",
       "SITELINK 须写 AssetFieldType: SITELINK（与 typeV2 一致）",
       "提交前：ad campaign-validate → 用户确认 → ad campaign-create（勿对 validate 加 --json-out）"

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

@@ -1,5 +1,7 @@
 # `ad campaign-create` JSON 配置说明
 
+> **Agent 必读（与 JSON 成对加载）**：本文件是字段说明；**结构真相源**是同目录 [`campaign-create-template.json`](campaign-create-template.json)。建系列前**必须先 Read `.json`**，再 Read 本 `.md`。**禁止**只读本文件凭印象手写 JSON。
+
 `siluzan-tso ad campaign-create` **仅**接受 `--config-file` 指向的 JSON 文件
 
 **JSON 字段名保持 PascalCase**，与后端 `Campaign` / `CampaignCreationRecord` 契约一致；`ad campaign-validate` 会**就地自动修复**关键词词面（按 `MatchTypeV2` 补全 `"` / `[]`，兼容 `matchTypeV2` / `keywordText` / `Items[]`），可用 `--write-normalized` 落盘修复后的 JSON。
@@ -17,15 +19,27 @@ JSON 模板：同目录 [`campaign-create-template.json`](campaign-create-templa
 
 ## Agent 常见坑（实战）
 
-> 摘自真实创建流水：多次 `--json-out` 误用、validate 通过但 create 因 `Finalurl` 失败。提交前对照本表，避免重复踩坑。
+> 摘自真实创建流水：多次 `--json-out` 误用、validate 通过但 create 因 `Finalurl` 失败、**否词误填正向关键词**。提交前对照本表，避免重复踩坑。
+
+### 正向关键词 vs 否定关键词（勿混放）
+
+| 类型 | JSON 路径 | 说明 |
+| ---- | --------- | ---- |
+| **正向关键词**（要买的词） | `campaign.AdGroupsForBatchJob[].KeywordsForBatchJob[]` | 按组写入；含 `MatchTypeV2` + `FinalURL` |
+| **否定关键词**（要排除的词） | `campaign.NegativeKeywordsForBatchJob[]` | **系列级**；元素 `{ KeywordText: [...], MatchTypeV2: "BROAD", FinalURL: "" }` |
+
+**禁止**：把方案 Markdown「否定词表」里的 `free` / `jobs` / `tutorial` 等抄进 `KeywordsForBatchJob`——那会**主动购买**这些流量。  
+**正确**：否词只写 `NegativeKeywordsForBatchJob`；`ad campaign-validate` 会对误填给出 **warnings**（常见否词词根 / 与否词块重复）。
+
+投放方案 Markdown 中 §3.3 关键词矩阵 → `KeywordsForBatchJob`；§3.3 系列级否定词 / §3.4 账户级否定词 → `NegativeKeywordsForBatchJob`（账户级列表仍须在 Google 后台单独应用）。
 
 ### CLI 参数（勿混用）
 
-| 命令 | 支持 `--json-out`？ | 推荐用法 |
-| ---- | :-----------------: | -------- |
-| `ad campaign-validate` | **是** | **推荐** `--json-out ./snap-campaign`（落盘 `ad-campaign-validate-<account>.json`，含 `lengthViolations`）；。人读：`--config-file` 即可；词面规范化：`--write-normalized`。超长勿自动截断，见 `google-ads/google-ads-campaign-plan.md` § 超长人工确认 |
-| `ad campaign-create` | **是** | 落盘任务响应：`--json-out ./snap-campaign`； |
-| `ad batch get` / `ad batch diff` | **是** | 轮询与 diff 结果落盘，见 `references/core/tips.md` |
+| 命令                             | 支持 `--json-out`？ | 推荐用法                                                                                                                                                                                                                                               |
+| -------------------------------- | :-----------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `ad campaign-validate`           |       **是**        | **推荐** `--json-out ./snap-campaign`（落盘 `ad-campaign-validate-<account>.json`，含 `lengthViolations`）；。人读：`--config-file` 即可；词面规范化：`--write-normalized`。超长勿自动截断，见 `google-ads/google-ads-campaign-plan.md` § 超长人工确认 |
+| `ad campaign-create`             |       **是**        | 落盘任务响应：`--json-out ./snap-campaign`；                                                                                                                                                                                                           |
+| `ad batch get` / `ad batch diff` |       **是**        | 轮询与 diff 结果落盘，见 `references/core/tips.md`                                                                                                                                                                                                     |
 
 **Agent**：校验与 create/batch 共用同一 `--json-out` 目录时，按 stdout 摘要里的 `outlineFile` → 再读对应 JSON（勿把 outline 当数据）。
 
@@ -91,17 +105,17 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 
 ## 外层字段（CampaignCreationRecord）
 
-| 字段                   | 类型                | 必填 | 说明                                                                                                   |
-| ---------------------- | ------------------- | :--: | ------------------------------------------------------------------------------------------------------ |
-| `account`              | string              |  ✅  | 媒体账户 ID；提交时转为数字 `customerId`（勿依赖引号字符串）                                            |
-| `customerName`         | string              |      | 展示/智投用客户名；**可省略**——`campaign-create` / `batch publish` 会按 `account` 调 `list-accounts` 自动填入 `mediaCustomerName`。若填写则须与之一致，否则提交时 CLI 自动更正 |
-| `name`                 | string              |      | 智投 `campaignName`；缺省取 `campaign.Name`；账户内不得与已有在投/暂停系列重名，否则 BatchJob 系列创建失败 |
-| `url`                  | string              |      | 智投展示用 URL；后端只读，用于回显                                                                     |
-| `locations`            | string[]            |      | 展示用地区名（后端只读，可空数组）                                                                     |
-| `productWords`         | string[]            |      | 智投/推荐用产品核心词                                                                                  |
-| `googleDataRecordId`   | string \| null      |      | 智投记录 ID；省略时提交 `""`（CLI 默认）                                                        |
-| `draft`                | boolean             |      | `false`（默认）立即发布到 Google；`true` 仅保存草稿，需后续 `ad batch publish`                         |
-| `campaign`             | object              |  ✅  | 内层 Campaign 对象，见下表                                                                             |
+| 字段                 | 类型           | 必填 | 说明                                                                                                                                                                           |
+| -------------------- | -------------- | :--: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `account`            | string         |  ✅  | 媒体账户 ID；提交时转为数字 `customerId`（勿依赖引号字符串）                                                                                                                   |
+| `customerName`       | string         |      | 展示/智投用客户名；**可省略**——`campaign-create` / `batch publish` 会按 `account` 调 `list-accounts` 自动填入 `mediaCustomerName`。若填写则须与之一致，否则提交时 CLI 自动更正 |
+| `name`               | string         |      | 智投 `campaignName`；缺省取 `campaign.Name`；账户内不得与已有在投/暂停系列重名，否则 BatchJob 系列创建失败                                                                     |
+| `url`                | string         |      | 智投展示用 URL；后端只读，用于回显                                                                                                                                             |
+| `locations`          | string[]       |      | 展示用地区名（后端只读，可空数组）                                                                                                                                             |
+| `productWords`       | string[]       |      | 智投/推荐用产品核心词                                                                                                                                                          |
+| `googleDataRecordId` | string \| null |      | 智投记录 ID；省略时提交 `""`（CLI 默认）                                                                                                                                       |
+| `draft`              | boolean        |      | `false`（默认）立即发布到 Google；`true` 仅保存草稿，需后续 `ad batch publish`                                                                                                 |
+| `campaign`           | object         |  ✅  | 内层 Campaign 对象，见下表                                                                                                                                                     |
 
 > 提交时 CLI 另附 `KeywordRecommendationsV2`：`[{ Key: <广告组 Name>, Value: [] }, …]`，由 CLI 自动附加；JSON 文件内无需手写。
 
@@ -114,125 +128,126 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 
 ### 基础
 
-| 字段                            | 类型                  | 必填 | 说明                                                                  |
-| ------------------------------- | --------------------- | :--: | --------------------------------------------------------------------- |
-| `Name`                          | string                |  ✅  | 广告系列名；须与外层 `name` 一致；账户内唯一（在投/暂停不可重名）                                      |
-| `StatusV2`                      | "Enabled" \| "Paused" |      | 默认 `Enabled`                                                        |
-| `ChannelTypeV2`                 | string                |      | 搜索系列填 `SEARCH`                                                   |
+| 字段            | 类型                  | 必填 | 说明                                                              |
+| --------------- | --------------------- | :--: | ----------------------------------------------------------------- |
+| `Name`          | string                |  ✅  | 广告系列名；须与外层 `name` 一致；账户内唯一（在投/暂停不可重名） |
+| `StatusV2`      | "Enabled" \| "Paused" |      | 默认 `Enabled`                                                    |
+| `ChannelTypeV2` | string                |      | 搜索系列填 `SEARCH`                                               |
 
 ### 预算与出价
 
-| 字段                                  | 类型                                                  | 必填条件                       | 说明                                       |
-| ------------------------------------- | ----------------------------------------------------- | ------------------------------ | ------------------------------------------ |
-| `Budget`                              | number                                                | ✅ > 0                          | 日预算（元）                               |
-| `BudgetShared`                        | boolean                                               |                                | 共享预算时为 true                          |
-| `BudgetId`                            | number / string                                       |                                | 共享预算 id                                |
-| `BudgetBudgetDeliveryMethodV2`        | "STANDARD" \| "ACCELERATED" \| "UNSPECIFIED" \| "UNKNOWN" |                            | 默认 STANDARD                              |
-| `BiddingStrategyTypeV2`               | "TARGET_SPEND" \| "MANUAL_CPC" \| "TARGET_CPA" \| "TARGET_ROAS" \| "MAXIMIZE_CONVERSIONS" \| "MAXIMIZE_CONVERSION_VALUE" | ✅ | 出价策略 |
-| `TargetSpend_BidCeilingAmount`        | number                                                | TARGET_SPEND 时 ✅              | 每次点击费用上限（元）                     |
-| `TargetCpa_BidingAmount`              | number                                                | TARGET_CPA 时 ✅                | 目标 CPA（元）                             |
-| `TargetRoas`                          | number                                                | TARGET_ROAS 时 ✅               | 目标 ROAS（如 2.5 表示 250%）              |
-| `ManualCpc_EnhancedCpcEnabled`        | boolean                                               |                                | 是否增强 CPC                               |
+| 字段                           | 类型                                                                                                                     | 必填条件           | 说明                          |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------ | ----------------------------- |
+| `Budget`                       | number                                                                                                                   | ✅ > 0             | 日预算（元）                  |
+| `BudgetShared`                 | boolean                                                                                                                  |                    | 共享预算时为 true             |
+| `BudgetId`                     | number / string                                                                                                          |                    | 共享预算 id                   |
+| `BudgetBudgetDeliveryMethodV2` | "STANDARD" \| "ACCELERATED" \| "UNSPECIFIED" \| "UNKNOWN"                                                                |                    | 默认 STANDARD                 |
+| `BiddingStrategyTypeV2`        | "TARGET_SPEND" \| "MANUAL_CPC" \| "TARGET_CPA" \| "TARGET_ROAS" \| "MAXIMIZE_CONVERSIONS" \| "MAXIMIZE_CONVERSION_VALUE" | ✅                 | 出价策略                      |
+| `TargetSpend_BidCeilingAmount` | number                                                                                                                   | TARGET_SPEND 时 ✅ | 每次点击费用上限（元）        |
+| `TargetCpa_BidingAmount`       | number                                                                                                                   | TARGET_CPA 时 ✅   | 目标 CPA（元）                |
+| `TargetRoas`                   | number                                                                                                                   | TARGET_ROAS 时 ✅  | 目标 ROAS（如 2.5 表示 250%） |
+| `ManualCpc_EnhancedCpcEnabled` | boolean                                                                                                                  |                    | 是否增强 CPC                  |
 
 ### 网络（后端硬约束）
 
-| 字段                            | 类型    | 说明                                                                                          |
-| ------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
-| `TargetGoogleSearch`            | boolean | 默认 true；当 `TargetSearchNetwork=true` 时**必须** true                                       |
-| `TargetSearchNetwork`           | boolean | Google 搜索网络合作伙伴；产品默认建议 false                                                   |
-| `TargetContentNetwork`          | boolean | 展示网络；搜索专属方案建议 false                                                              |
-| `TargetPartnerSearchNetwork`    | boolean | **必须 false**（后端拒绝：cannot set TargetPartnerSearchNetwork）                              |
+| 字段                         | 类型    | 说明                                                              |
+| ---------------------------- | ------- | ----------------------------------------------------------------- |
+| `TargetGoogleSearch`         | boolean | 默认 true；当 `TargetSearchNetwork=true` 时**必须** true          |
+| `TargetSearchNetwork`        | boolean | Google 搜索网络合作伙伴；产品默认建议 false                       |
+| `TargetContentNetwork`       | boolean | 展示网络；搜索专属方案建议 false                                  |
+| `TargetPartnerSearchNetwork` | boolean | **必须 false**（后端拒绝：cannot set TargetPartnerSearchNetwork） |
 
 ### 地理 / 语言 / 平台
 
-| 字段                  | 类型                                          | 必填 | 说明                                                                |
-| --------------------- | --------------------------------------------- | :--: | ------------------------------------------------------------------- |
-| `targetedLocations`   | `{ id: string, bidModifier?: number }[]`      |  ✅  | 至少 1 个；先 `siluzan-tso ad geo search -a <acct> -q <地区名>`     |
-| `excludedLocations`   | 同上                                          |      | 排除地区                                                            |
-| `targetedLanguages`   | `{ id: number }[]`                            |  ✅  | 英语 1000，中文 1017                                                |
-| `targetedPlatforms`   | `{ id: number, bidModifier?: number }[]`      |      | 30001 桌面 / 30002 平板 / 30000 移动                                |
-| `excludedIpAddresses` | string[]                                      |      | 排除 IP                                                             |
-| `PositiveGeoTargetType` | number                                      |      |                                                                     |
-| `NegativeGeoTargetType` | number                                      |      |                                                                     |
+| 字段                    | 类型                                     | 必填 | 说明                                                            |
+| ----------------------- | ---------------------------------------- | :--: | --------------------------------------------------------------- |
+| `targetedLocations`     | `{ id: string, bidModifier?: number }[]` |  ✅  | 至少 1 个；先 `siluzan-tso ad geo search -a <acct> -q <地区名>` |
+| `excludedLocations`     | 同上                                     |      | 排除地区                                                        |
+| `targetedLanguages`     | `{ id: number }[]`                       |  ✅  | 英语 1000，中文 1017                                            |
+| `targetedPlatforms`     | `{ id: number, bidModifier?: number }[]` |      | 30001 桌面 / 30002 平板 / 30000 移动                            |
+| `excludedIpAddresses`   | string[]                                 |      | 排除 IP                                                         |
+| `PositiveGeoTargetType` | number                                   |      |                                                                 |
+| `NegativeGeoTargetType` | number                                   |      |                                                                 |
 
 ### 时间与 DSA
 
-| 字段              | 类型                | 说明                                                            |
-| ----------------- | ------------------- | --------------------------------------------------------------- |
-| `StartTime`       | YYYY-MM-DD          | 开始日期                                                        |
-| `EndTime`         | YYYY-MM-DD          | 结束日期（必须晚于 StartTime）                                  |
-| `adSchedules`     | object[]            | 投放时段，缺省可填全周全天（见模板）                            |
-| `DSADomainName`   | string              | 动态搜索广告域名                                                |
-| `DSALanguageCode` | string              | 默认 `en`                                                       |
+| 字段              | 类型       | 说明                                 |
+| ----------------- | ---------- | ------------------------------------ |
+| `StartTime`       | YYYY-MM-DD | 开始日期                             |
+| `EndTime`         | YYYY-MM-DD | 结束日期（必须晚于 StartTime）       |
+| `adSchedules`     | object[]   | 投放时段，缺省可填全周全天（见模板） |
+| `DSADomainName`   | string     | 动态搜索广告域名                     |
+| `DSALanguageCode` | string     | 默认 `en`                            |
 
 ### 子结构
 
-| 字段                            | 类型     | 说明                                                                          |
-| ------------------------------- | -------- | ----------------------------------------------------------------------------- |
-| `AdGroupsForBatchJob`           | object[] | **至少 1 组**；见下                                                           |
-| `NegativeKeywordsForBatchJob`   | object[] | 系列级否词；元素：`{ KeywordText: string[], MatchTypeV2: "BROAD", FinalURL: "" }` |
-| `ExtensionsForBatchJob`         | object[] | 附加信息；`Properties` 须 **string→string**（勿用数组值）。SITELINK 见下表 |
+| 字段                          | 类型     | 说明                                                                              |
+| ----------------------------- | -------- | --------------------------------------------------------------------------------- |
+| `AdGroupsForBatchJob`         | object[] | **至少 1 组**；见下                                                               |
+| `NegativeKeywordsForBatchJob` | object[] | 系列级否词；元素：`{ KeywordText: string[], MatchTypeV2: "BROAD", FinalURL: "" }` |
+| `ExtensionsForBatchJob`       | object[] | 附加信息；`Properties` 须 **string→string**（勿用数组值）。SITELINK 见下表        |
 
 #### SITELINK（`ExtensionsForBatchJob[i]`，`typeV2` / `AssetFieldType` = `SITELINK`）
 
-| 字段 | 类型 | 说明 |
-| ---- | ---- | ---- |
-| `typeV2` | string | 必填 `SITELINK` |
-| `AssetFieldType` | string | **必填** `SITELINK`（与 `typeV2` 一致；缺省会导致部分账户 BatchJob 失败） |
-| `level` / `Level` | string | 系列级填 `Campaign` |
-| `Properties` | object | 键值均为字符串；见下表 |
-| `Properties.Text` | string | 链接文字（必填）。可写 `LinkText`，提交前会映射为 `Text` |
-| `Properties.Line2` | string | 描述行 1，**≤ 25 字符**。可写 `Description1`，提交前映射为 `Line2` |
-| `Properties.Line3` | string | 描述行 2，**≤ 25 字符**；**不可省略或空字符串**（Google V20 不允许 null，空时 CLI 用 `Line2` 回填）。可写 `Description2` |
-| `Properties.DestinationUrl` | string | 落地页 URL（必填）。**勿**写 `FinalUrls` 数组——会导致 TSO 无法反序列化整包 body（`campaign creation record is null`） |
+| 字段                        | 类型   | 说明                                                                                                                     |
+| --------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
+| `typeV2`                    | string | 必填 `SITELINK`                                                                                                          |
+| `AssetFieldType`            | string | **必填** `SITELINK`（与 `typeV2` 一致；缺省会导致部分账户 BatchJob 失败）                                                |
+| `level` / `Level`           | string | 系列级填 `Campaign`                                                                                                      |
+| `Properties`                | object | 键值均为字符串；见下表                                                                                                   |
+| `Properties.Text`           | string | 链接文字（必填）。可写 `LinkText`，提交前会映射为 `Text`                                                                 |
+| `Properties.Line2`          | string | 描述行 1，**≤ 25 字符**。可写 `Description1`，提交前映射为 `Line2`                                                       |
+| `Properties.Line3`          | string | 描述行 2，**≤ 25 字符**；**不可省略或空字符串**（Google V20 不允许 null，空时 CLI 用 `Line2` 回填）。可写 `Description2` |
+| `Properties.DestinationUrl` | string | 落地页 URL（必填）。**勿**写 `FinalUrls` 数组——会导致 TSO 无法反序列化整包 body（`campaign creation record is null`）    |
 
 ---
 
 ## 广告组（`AdGroupsForBatchJob[i]`）
 
-| 字段                  | 类型                  | 必填 | 说明                                                                            |
-| --------------------- | --------------------- | :--: | ------------------------------------------------------------------------------- |
-| `Name`                | string                |  ✅  | 组名；用于提交体 `KeywordRecommendationsV2[].Key`                             |
-| `StatusV2`            | "Enabled" \| "Paused" |      | 默认 Enabled                                                                    |
-| `TypeV2`              | string                |      | 搜索系列填 `SEARCH_STANDARD`                                                    |
-| `RotationModeV2`      | string                |      | 一般 `Unspecified`                                                              |
-| `MaxCPCAmount`        | number                |  ✅(MANUAL_CPC)  | 元；MANUAL_CPC 出价策略必须 > 0                                       |
-| `KeywordsForBatchJob` | object[]              |      | 见下                                                                            |
-| `AdsForBatchJob`      | object[]              |      | 见下                                                                            |
+| 字段                  | 类型                  |      必填      | 说明                                              |
+| --------------------- | --------------------- | :------------: | ------------------------------------------------- |
+| `Name`                | string                |       ✅       | 组名；用于提交体 `KeywordRecommendationsV2[].Key` |
+| `StatusV2`            | "Enabled" \| "Paused" |                | 默认 Enabled                                      |
+| `TypeV2`              | string                |                | 搜索系列填 `SEARCH_STANDARD`                      |
+| `RotationModeV2`      | string                |                | 一般 `Unspecified`                                |
+| `MaxCPCAmount`        | number                | ✅(MANUAL_CPC) | 元；MANUAL_CPC 出价策略必须 > 0                   |
+| `KeywordsForBatchJob` | object[]              |                | 见下                                              |
+| `AdsForBatchJob`      | object[]              |                | 见下                                              |
 
 ### 关键词块（`KeywordsForBatchJob[j]`）
 
 每个块描述一组**同匹配类型**的关键词。若同一块内混用裸词 / `"词组"` / `[完全]`（或与块级 `MatchTypeV2` 冲突的符号），`campaign-validate` 会**自动拆成多个块**（顺序：BROAD → PHRASE → EXACT），再按块级类型修复词面。
 
-| 字段          | 类型                              | 说明                                                                  |
-| ------------- | --------------------------------- | --------------------------------------------------------------------- |
-| `KeywordText` | string[]                          | 关键词词面数组；PHRASE 应写 `"keyword"`，EXACT 应写 `[keyword]`（裸词亦可，`campaign-validate` 会按 `MatchTypeV2` **自动修复**） |
-| `MatchTypeV2` | "BROAD" \| "PHRASE" \| "EXACT"    | 与词面格式对应；Google 网关以词面符号为准，CLI 校验时会改写 `KeywordText` 与之对齐 |
-| `FinalURL`    | string                            | 关键词级落地页                                                        |
+| 字段          | 类型                           | 说明                                                                                                                             |
+| ------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
+| `KeywordText` | string[]                       | 关键词词面数组；PHRASE 应写 `"keyword"`，EXACT 应写 `[keyword]`（裸词亦可，`campaign-validate` 会按 `MatchTypeV2` **自动修复**） |
+| `MatchTypeV2` | "BROAD" \| "PHRASE" \| "EXACT" | 与词面格式对应；Google 网关以词面符号为准，CLI 校验时会改写 `KeywordText` 与之对齐                                               |
+| `FinalURL`    | string                         | 关键词级落地页                                                                                                                   |
 
 ### 创意块（`AdsForBatchJob[j]`，RSA）
 
-| 字段                          | 类型     | 必填 | 说明                                          |
-| ----------------------------- | -------- | :--: | --------------------------------------------- |
-| `TypeV2`                      | string   |      | RSA 填 `RESPONSIVE_SEARCH_AD`                  |
-| `DestinationUrl`              | string   |  ✅  | 展示/编辑用落地页 URL                         |
-| `Finalurl`                    | string   |  ✅  | **后端 BatchJob 必填**；与 `DestinationUrl` 填**相同** URL。勿只写前者——validate 可能仍通过，create 会失败 |
-| `AdTitle`                     | null \| string |  | 可选；无标题时写 `null`（CLI 默认）   |
-| `Path1` / `Path2`             | string   |  ✅  | 显示路径（**必填**，缺/null 会导致后端 BatchJob `ArgumentNullException`）；**≤ 15 字符**（CJK 按 2 计）；小写 a-z、数字、连字符 |
-| `headlinePart1/2/3`           | string   |  ✅  | 前 3 条标题；**每条 ≤ 30 字符**（CJK 按 2 计） |
-| `AddtionalHeadlines`          | string[] |  ✅  | 第 4–15 条标题；与前三条合计须 **15 条**（写满） |
-| `adDescription` / `adDescription2` | string |  ✅  | 前 2 条描述；**每条 ≤ 90 字符**            |
-| `AddtionalAdDescriptions`     | string[] |  ✅  | 第 3–4 条描述；与前两条合计须 **4 条**（写满）   |
+| 字段                               | 类型           | 必填 | 说明                                                                                                                            |
+| ---------------------------------- | -------------- | :--: | ------------------------------------------------------------------------------------------------------------------------------- |
+| `TypeV2`                           | string         |      | RSA 填 `RESPONSIVE_SEARCH_AD`                                                                                                   |
+| `DestinationUrl`                   | string         |  ✅  | 展示/编辑用落地页 URL                                                                                                           |
+| `Finalurl`                         | string         |  ✅  | **后端 BatchJob 必填**；与 `DestinationUrl` 填**相同** URL。勿只写前者——validate 可能仍通过，create 会失败                      |
+| `AdTitle`                          | null \| string |      | 可选；无标题时写 `null`（CLI 默认）                                                                                             |
+| `Path1` / `Path2`                  | string         |  ✅  | 显示路径（**必填**，缺/null 会导致后端 BatchJob `ArgumentNullException`）；**≤ 15 字符**（CJK 按 2 计）；小写 a-z、数字、连字符 |
+| `headlinePart1/2/3`                | string         |  ✅  | 前 3 条标题；**每条 ≤ 30 字符**（CJK 按 2 计）                                                                                  |
+| `AddtionalHeadlines`               | string[]       |  ✅  | 第 4–15 条标题；与前三条合计须 **15 条**（写满）                                                                                |
+| `adDescription` / `adDescription2` | string         |  ✅  | 前 2 条描述；**每条 ≤ 90 字符**                                                                                                 |
+| `AddtionalAdDescriptions`          | string[]       |  ✅  | 第 3–4 条描述；与前两条合计须 **4 条**（写满）                                                                                  |
 
 ---
 
 ## 校验规则（`ad campaign-validate`）
 
-| 规则 | 说明 |
-| ---- | ---- |
-| 基础 | `customerName` / `campaign` 非空；`Budget > 0`；地理/语言至少 1 项 |
-| 网络 | `TargetPartnerSearchNetwork` 须 false；不可同时关闭 Google 搜索与搜索网络 |
+| 规则                    | 说明                                                                                                       |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
+| 基础                    | `customerName` / `campaign` 非空；`Budget > 0`；地理/语言至少 1 项                                         |
+| 网络                    | `TargetPartnerSearchNetwork` 须 false；不可同时关闭 Google 搜索与搜索网络                                  |
 | RSA / 关键词 / 附加信息 | 标题 **15** 条、描述 **4** 条（须写满）；字符上限、词面非空；RSA `Path1`/`Path2` 必填；SITELINK 行长度限制 |
+| 否词误填 | `KeywordsForBatchJob` 含常见否词词根或与 `NegativeKeywordsForBatchJob` 重复 → **warnings**（不阻断，须 Agent 修正后再 create） |
 | 实务 | 日期格式与先后、出价策略与配套字段一致 |
 
 `ad campaign-validate` 通过不保证 BatchJob 成功（例如仅写 `DestinationUrl` 未写 `Finalurl` 时 validate 仍可能 ✅）。异步结果用 `ad batch get` 轮询；`HasFailed` / 部分失败时用 `ad batch diff` 对照 JSON 补缺，系列级失败时改 JSON 重提，勿在半成品上反复整包创建。写操作须 `--commit`，见 `references/google-ads/google-ads.md` § ad campaign-create。