npm - siluzan-tso-cli - Versions diffs - 1.1.44-beta.3 → 1.1.44 - Mend

siluzan-tso-cli 1.1.44-beta.3 → 1.1.44

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 (143) hide show

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

@@ -8,21 +8,21 @@
 ## 常见入口语（路由到本文件，勿走偏）
-| 用户说法（示例）                                  | 正确工作流                                                                                       | **禁止**                                    |
-| ------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------- |
-| 「根据 www.example.com 官网生成 Google 搜索广告」 | **W3 · 本文件标准流水线**                                                                        | 只输出一张手写关键词/RSA 表；走 P8 网站诊断 |
-| 「按这份 Excel / 投放方案创建广告」               | **方案源轨**（下表）+ **必读** `rules/google-ads-plan-source-fidelity.md`                          | 猜 geo id；关键词一律 BROAD；跳过 validate  |
-| 「要表格格式 / 表格给我」                         | 先 JSON →（有账户且要创建才 `campaign-validate`）→ 按 `google-ads-launch-plan-template.md` **投影 Markdown 表格** | 跳过 JSON 直接填表；因缺账户不给表格      |
-| 「帮我写搜索广告文案/关键词」且未指定已有系列     | **W3**（含官网/RAG 归纳背景）                                                                    | 与 W5 纯拓词混淆（W5 无系列/组/RSA 结构）   |
-| 「先出方案 / 先别开户 / 先别投钱 / 只要方案」     | **仅出方案**（见下节；**不**索要账户）                                                          | 卡在 `list-accounts` / 要 mediaCustomerId 才肯出方案 |
-| 「分析这个网站能不能投广告」                      | **P8** 网站诊断                                                                                  | 本文件建户方案                              |
+| 用户说法（示例）                                  | 正确工作流                                                                                                        | **禁止**                                             |
+| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| 「根据 www.example.com 官网生成 Google 搜索广告」 | **W3 · 本文件标准流水线**                                                                                         | 只输出一张手写关键词/RSA 表；走 P8 网站诊断          |
+| 「按这份 Excel / 投放方案创建广告」               | **方案源轨**（下表）+ **必读** `rules/google-ads-plan-source-fidelity.md`                                         | 猜 geo id；关键词一律 BROAD；跳过 validate           |
+| 「要表格格式 / 表格给我」                         | 先 JSON →（有账户且要创建才 `campaign-validate`）→ 按 `google-ads-launch-plan-template.md` **投影 Markdown 表格** | 跳过 JSON 直接填表；因缺账户不给表格                 |
+| 「帮我写搜索广告文案/关键词」且未指定已有系列     | **W3**（含官网/RAG 归纳背景）                                                                                     | 与 W5 纯拓词混淆（W5 无系列/组/RSA 结构）            |
+| 「先出方案 / 先别开户 / 先别投钱 / 只要方案」     | **仅出方案**（见下节；**不**索要账户）                                                                            | 卡在 `list-accounts` / 要 mediaCustomerId 才肯出方案 |
+| 「分析这个网站能不能投广告」                      | **P8** 网站诊断                                                                                                   | 本文件建户方案                                       |
 ### 仅出方案 vs 创建（硬门禁）
-| 阶段 | 触发（满足其一即可） | 要不要 Google 账户 | Agent 必须做 | **禁止** |
-| ---- | -------------------- | ------------------ | ------------ | -------- |
-| **仅出方案** | 「出方案 / 规划 / 先别创建 / 先别开户 / 先别投钱 / 只要表格」；或用户**未**给账户且**未**说要创建/发布 | **不必须** | 落盘同构 JSON → **写代码**投影完整审查稿（默认 MD；用户指定则 Excel 等）；`account` / geo 数字 id 用占位并标注「待选定账户后补」 | **因缺账户 ID 阻塞交付**；只交概览表；未确认创建就跑 `list-accounts` 逼用户给号；未确认就 `campaign-create` |
-| **创建** | 用户已确认方案并明确要创建/发布，或已提供可用 `mediaCustomerId` 且意图是落地 | **必须** | `list-accounts` → `geo resolve` → 填真 id → `campaign-validate` → **写代码投影完整审查稿** → 用户确认 → `campaign-create` → batch… | 编造 geo id；跳过 validate；跳过完整审查稿 |
+| 阶段         | 触发（满足其一即可）                                                                                   | 要不要 Google 账户 | Agent 必须做                                                                                                                       | **禁止**                                                                                                    |
+| ------------ | ------------------------------------------------------------------------------------------------------ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| **仅出方案** | 「出方案 / 规划 / 先别创建 / 先别开户 / 先别投钱 / 只要表格」；或用户**未**给账户且**未**说要创建/发布 | **不必须**         | 落盘同构 JSON → **写代码**投影完整审查稿（默认 MD；用户指定则 Excel 等）；`account` / geo 数字 id 用占位并标注「待选定账户后补」   | **因缺账户 ID 阻塞交付**；只交概览表；未确认创建就跑 `list-accounts` 逼用户给号；未确认就 `campaign-create` |
+| **创建**     | 用户已确认方案并明确要创建/发布，或已提供可用 `mediaCustomerId` 且意图是落地                           | **必须**           | `list-accounts` → `geo resolve` → 填真 id → `campaign-validate` → **写代码投影完整审查稿** → 用户确认 → `campaign-create` → batch… | 编造 geo id；跳过 validate；跳过完整审查稿                                                                  |
 **缺参时（仅出方案）**：用户只给官网 URL、未给预算/地域/账户 → 先从官网归纳产品/落地页（必要时 `google-ads-landing-page-discovery-via-webfetch.md`），预算/地域可合理默认并在方案里写明假设；**账户 ID 一律不追问为前置条件**（写 `[PENDING_ACCOUNT]` 即可）。仅当缺官网且无法推断产品时才追问 1 项；不得因信息不全就降级为「随便写几条广告」，也**不得**把「请先提供广告账户」当成第一步。
@@ -30,11 +30,11 @@
 ---
-| 轨             | 条件                                                              | 动作                                                                                                                                      |
-| -------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| **方案源轨**   | 用户已给 Excel/表格/结构化投放方案（含地域、词、匹配类型等）      | **先 Read** `rules/google-ads-plan-source-fidelity.md` → Agent **写脚本**转 JSON；**有账户且要创建**时再 `ad geo resolve` → validate → 确认 → create；**仅出方案**则脚本产出后停在 JSON+Markdown |
-| **直读直写**   | 用户已给账户/预算/组/词/RSA 等结构化数据（非文件，或已是 JSON）    | 转为 campaign-create JSON →（要创建则）validate → 确认 → create                                                                   |
-| **方案先行**   | 无完整结构，或要求「先出方案」                                    | 读本文件 + 必读规则 → 生成 JSON + Markdown；**仅出方案到此为止**；用户确认创建且已有账户后再 validate → create                                                                     |
+| 轨           | 条件                                                            | 动作                                                                                                                                                                                             |
+| ------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **方案源轨** | 用户已给 Excel/表格/结构化投放方案（含地域、词、匹配类型等）    | **先 Read** `rules/google-ads-plan-source-fidelity.md` → Agent **写脚本**转 JSON；**有账户且要创建**时再 `ad geo resolve` → validate → 确认 → create；**仅出方案**则脚本产出后停在 JSON+Markdown |
+| **直读直写** | 用户已给账户/预算/组/词/RSA 等结构化数据（非文件，或已是 JSON） | 转为 campaign-create JSON →（要创建则）validate → 确认 → create                                                                                                                                  |
+| **方案先行** | 无完整结构，或要求「先出方案」                                  | 读本文件 + 必读规则 → 生成 JSON + Markdown；**仅出方案到此为止**；用户确认创建且已有账户后再 validate → create                                                                                   |
 **硬约束**
@@ -53,24 +53,24 @@
 > **仅出方案**：做步 0（若有方案文件）→ **跳过**步 1～3 的账户/geo CLI → 做步 4～5（词与 JSON）→ **跳过**步 6 validate → 做步 7（Markdown，国家名即可）→ **停住等用户确认**；用户确认创建并给出账户后再从步 1 续跑。
-| 步  | 动作                                                                                                                                                                 | 文档/命令                                                                         |
-| --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
-| 0   | **方案源轨**：Agent 写转换脚本：方案文件 → `campaign.json`；**创建阶段**地域用 **`ad geo resolve --json-out`** 写入（**勿**对话手填）                                      | **`rules/google-ads-plan-source-fidelity.md`** + **`assets/campaign-create-template.json`** |
-| 1   | **创建阶段**：`list-accounts` 锁定 `account` / `customerName` / 币种；**仅出方案且无账户 → 跳过**                                                                                                               | `references/accounts/currency.md`                                                 |
-| 2   | 可选 `rag query`；无现成词表时再 `keyword` / `keyword geo-list` 拓词（`keyword` **可不传** `-a`）                                                                                                  | `references/analytics/keyword-planner-workflows.md`                               |
-| 3   | **创建阶段**：无方案文件时多国 **`ad geo resolve`**（或单国 `ad geo search`）写入 `locations` + `targetedLocations`；**仅出方案 → 跳过，国家名占位**                                                              | **禁止编造 id**                                                                   |
-| 4   | 无方案文件时：按分层写入 `KeywordsForBatchJob`（EXACT/PHRASE/BROAD）；否词进 `NegativeKeywordsForBatchJob`                                                             | 参考 `google-ads-keyword-taxonomy.md`；有方案源则走步骤 0                          |
-| 5   | 得到与模板同构的 `campaign-create` JSON（仅出方案时 `account`=`[PENDING_ACCOUNT]`）                                                                                                                                | **`assets/campaign-create-template.json`**                                        |
-| 6   | **创建阶段**：`ad campaign-validate --config-file <json>`；**仅出方案 → 跳过**，交付时说明「有账户后再 validate」                                                                                                                      | 下文「校验」                                                                      |
-| 6b  | **方案来自用户且不合规**（创建前）：列出问题 → **询问**「您自己改还是我帮您改？」→ 按选择处理后再 validate（**禁止**未问就静默改方案）                                         | **`rules/google-ads-plan-source-fidelity.md`** § 用户方案不合规                   |
-| 6c  | 用户选「我帮您改」：改 JSON 时**同步落盘变更账本**（from → to + reason）                                                                                              | 同上 § 创建完成报告                                                               |
-| 7   | **审查稿（必做）**：Agent **写代码**读 JSON，按 `google-ads-launch-plan-template.md` 投影完整文件（默认 MD；用户要 Excel 等则改格式）；须含全部关键词与 RSA 正文；**禁止**概览表代替；**勿**贴整份 JSON 当主交付 | `google-ads-launch-plan-template.md`                                              |
-| 8   | 用户确认后 **`ad campaign-create`**                                                                                                                                  | `references/google-ads/google-ads-write.md`                                       |
-| 9   | 每隔5s 获取创建结果                                                                                                                                                  | `ad batch get --id <taskId> --config-file ./campaign.json`                        |
-| 10  | 成功或部分成功后 **`ad batch diff`** 对照 JSON 与账户实况                                                                                                              |                                                                                   |
-| 11  | **立刻交付创建详情**：把 diff stdout 中 `BEGIN_USER_DELIVERY_MARKDOWN`…`END` 全文原样发给用户（先于补建；禁止只贴汇总表） | `agent-conventions.md` §四 |
-| 12  | **自动补建缺失项**（见下文）：扩展/地域等执行 `remediateCommand`；补建后再 diff 时可再发更新版详情。**勿**仅反问用户是否补建 | `references/google-ads/google-ads-batch.md` § batch diff 后自动补建 |
-| 13  | 代改过方案时**另附**修改表（从 xxx → xxx + 原因） | **`rules/google-ads-plan-source-fidelity.md`** § 创建完成报告 |
+| 步  | 动作                                                                                                                                                                                                             | 文档/命令                                                                                   |
+| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| 0   | **方案源轨**：Agent 写转换脚本：方案文件 → `campaign.json`；**创建阶段**地域用 **`ad geo resolve --json-out`** 写入（**勿**对话手填）                                                                            | **`rules/google-ads-plan-source-fidelity.md`** + **`assets/campaign-create-template.json`** |
+| 1   | **创建阶段**：`list-accounts` 锁定 `account` / `customerName` / 币种；**仅出方案且无账户 → 跳过**                                                                                                                | `references/accounts/currency.md`                                                           |
+| 2   | 可选 `rag query`；无现成词表时再 `keyword` / `keyword geo-list` 拓词（`keyword` **可不传** `-a`）                                                                                                                | `references/analytics/keyword-planner-workflows.md`                                         |
+| 3   | **创建阶段**：无方案文件时多国 **`ad geo resolve`**（或单国 `ad geo search`）写入 `locations` + `targetedLocations`；**仅出方案 → 跳过，国家名占位**                                                             | **禁止编造 id**                                                                             |
+| 4   | 无方案文件时：按分层写入 `KeywordsForBatchJob`（EXACT/PHRASE/BROAD）；否词进 `NegativeKeywordsForBatchJob`                                                                                                       | 参考 `google-ads-keyword-taxonomy.md`；有方案源则走步骤 0                                   |
+| 5   | 得到与模板同构的 `campaign-create` JSON（仅出方案时 `account`=`[PENDING_ACCOUNT]`）                                                                                                                              | **`assets/campaign-create-template.json`**                                                  |
+| 6   | **创建阶段**：`ad campaign-validate --config-file <json>`；**仅出方案 → 跳过**，交付时说明「有账户后再 validate」                                                                                                | 下文「校验」                                                                                |
+| 6b  | **方案来自用户且不合规**（创建前）：列出问题 → **询问**「您自己改还是我帮您改？」→ 按选择处理后再 validate（**禁止**未问就静默改方案）                                                                           | **`rules/google-ads-plan-source-fidelity.md`** § 用户方案不合规                             |
+| 6c  | 用户选「我帮您改」：改 JSON 时**同步落盘变更账本**（from → to + reason）                                                                                                                                         | 同上 § 创建完成报告                                                                         |
+| 7   | **审查稿（必做）**：Agent **写代码**读 JSON，按 `google-ads-launch-plan-template.md` 投影完整文件（默认 MD；用户要 Excel 等则改格式）；须含全部关键词与 RSA 正文；**禁止**概览表代替；**勿**贴整份 JSON 当主交付 | `google-ads-launch-plan-template.md`                                                        |
+| 8   | 用户确认后 **`ad campaign-create`**                                                                                                                                                                              | `references/google-ads/google-ads-write.md`                                                 |
+| 9   | 每隔5s 获取创建结果                                                                                                                                                                                              | `ad batch get --id <taskId> --config-file ./campaign.json`                                  |
+| 10  | 成功或部分成功后 **`ad batch diff`** 对照 JSON 与账户实况                                                                                                                                                        |                                                                                             |
+| 11  | **立刻交付创建详情**：把 diff stdout 中 `BEGIN_USER_DELIVERY_MARKDOWN`…`END` 全文原样发给用户（先于补建；禁止只贴汇总表）                                                                                        | `agent-conventions.md` §四                                                                  |
+| 12  | **自动补建缺失项**（见下文）：扩展/地域等执行 `remediateCommand`；补建后再 diff 时可再发更新版详情。**勿**仅反问用户是否补建                                                                                     | `references/google-ads/google-ads-batch.md` § batch diff 后自动补建                         |
+| 13  | 代改过方案时**另附**修改表（从 xxx → xxx + 原因）                                                                                                                                                                | **`rules/google-ads-plan-source-fidelity.md`** § 创建完成报告                               |
 多系列：每系列一个 JSON；可选 `campaign-manifest.json`（`role: brand|competitor|generic`）仅作文件组织参考。
@@ -93,17 +93,17 @@
 ### 按需（触及时再读）
-| 文档                                                                            | 何时                                                        |
-| ------------------------------------------------------------------------------- | ----------------------------------------------------------- |
-| `references/google-ads/rules/google-ads-keyword-strategy.md`                    | 分组/匹配/否定词策略争议                                    |
-| `references/google-ads/rules/google-ads-campaign-optimization.md`               | 出价策略、预算、学习期                                      |
-| `references/google-ads/rules/google-ads-landing-page-discovery-via-webfetch.md` | 仅首页、需推断 PDP/PLP                                      |
-| `references/google-ads/rules/google-ads-conversion-architecture.md`             | 转化/EC/归因说明                                            |
-| `references/google-ads/rules/google-ads-keyword-optimization.md`                | 上线后优化，非首建                                          |
-| `references/google-ads/rules/google-ads-account-audit.md`                       | 账户诊断，非首建                                            |
-| `references/google-ads/rules/google-ads-audience-strategy.md`                   | 受众/RLSA                                                   |
+| 文档                                                                            | 何时                                                                                                    |
+| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| `references/google-ads/rules/google-ads-keyword-strategy.md`                    | 分组/匹配/否定词策略争议                                                                                |
+| `references/google-ads/rules/google-ads-campaign-optimization.md`               | 出价策略、预算、学习期                                                                                  |
+| `references/google-ads/rules/google-ads-landing-page-discovery-via-webfetch.md` | 仅首页、需推断 PDP/PLP                                                                                  |
+| `references/google-ads/rules/google-ads-conversion-architecture.md`             | 转化/EC/归因说明                                                                                        |
+| `references/google-ads/rules/google-ads-keyword-optimization.md`                | 上线后优化，非首建                                                                                      |
+| `references/google-ads/rules/google-ads-account-audit.md`                       | 账户诊断，非首建                                                                                        |
+| `references/google-ads/rules/google-ads-audience-strategy.md`                   | 受众/RLSA                                                                                               |
 | `references/google-ads/rules/google-ads-pmax-guide.md`                          | PMax 运营/诊断；**创建**见 `assets/pmax-create-template.md` + `google-ads-pmax-launch-plan-template.md` |
-| `references/google-ads/pmax-api.md`                                             | PMax 网关路径与 Search API 边界                             |
+| `references/google-ads/pmax-api.md`                                             | PMax 网关路径与 Search API 边界                                                                         |
 复述给用户：**3–5 条**与本次任务相关的合规/策略要点即可，无需罗列全部文件名。
@@ -156,16 +156,16 @@ validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 +
 `campaign-create` BatchJob **常漏附加信息**（Sitelink）与 **投放国家**；系列/组/关键词/RSA 已创建成功时，**不要**停在「需要我现在补上吗？」——用户确认 JSON 时已包含这些内容，Agent **应自动补建**。
-| 步骤 | 动作 |
-| ---- | ---- |
-| 1 | `ad batch get --id <taskId> --config-file ./campaign.json --json-out ./snap-campaign` 直至终端态（Creating 时每 5s 轮询；**读落盘 `agentWorkflow.nextCommand`**，勿只看人读提示） |
-| 2 | `Successfully` / `HasFailed`：执行 `agentWorkflow.nextCommand`（即 `ad batch diff … --json-out`）；**Failed** 勿 diff |
-| 3 | **立刻交付**：把本次 diff stdout 中 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN` 全文原样发给用户（即 `reportMarkdown`）。**禁止**只贴系列 ID/counts 摘要，**禁止**等补建结束再交付 |
-| 4 | 读落盘 `ok` / `missing[]`；`layer=location` → `ad geo add`；`layer=extension` → 执行 `remediateCommand` |
-| 5 | 无 `remediateCommand` 时，按 JSON 路径映射 `ad extension *` / `adgroup-create` / `keyword-create` / `ad-create` / `keyword-negative-create` |
-| 6 | 有缺失时 CLI **exit 2**；补建后再 `ad batch diff`，直到 `ok===true`；每次 diff 后若状态有变可再发更新版详情 |
-| 7 | 可简短补充「已自动补上 N 个投放国家 / M 条 Sitelink」（**不能代替**步骤 3 的 Markdown 全文） |
-| 8 | 仅当补建命令也失败时，才向用户说明原因并给改写方案；代改方案另附修改表见 `google-ads-plan-source-fidelity.md` |
+| 步骤 | 动作                                                                                                                                                                                               |
+| ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1    | `ad batch get --id <taskId> --config-file ./campaign.json --json-out ./snap-campaign` 直至终端态（Creating 时每 5s 轮询；**读落盘 `agentWorkflow.nextCommand`**，勿只看人读提示）                  |
+| 2    | `Successfully` / `HasFailed`：执行 `agentWorkflow.nextCommand`（即 `ad batch diff … --json-out`）；**Failed** 勿 diff                                                                              |
+| 3    | **立刻交付**：把本次 diff stdout 中 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN` 全文原样发给用户（即 `reportMarkdown`）。**禁止**只贴系列 ID/counts 摘要，**禁止**等补建结束再交付 |
+| 4    | 读落盘 `ok` / `missing[]`；`layer=location` → `ad geo add`；`layer=extension` → 执行 `remediateCommand`                                                                                            |
+| 5    | 无 `remediateCommand` 时，按 JSON 路径映射 `ad extension *` / `adgroup-create` / `keyword-create` / `ad-create` / `keyword-negative-create`                                                        |
+| 6    | 有缺失时 CLI **exit 2**；补建后再 `ad batch diff`，直到 `ok===true`；每次 diff 后若状态有变可再发更新版详情                                                                                        |
+| 7    | 可简短补充「已自动补上 N 个投放国家 / M 条 Sitelink」（**不能代替**步骤 3 的 Markdown 全文）                                                                                                       |
+| 8    | 仅当补建命令也失败时，才向用户说明原因并给改写方案；代改方案另附修改表见 `google-ads-plan-source-fidelity.md`                                                                                      |
 **Agent 易漏点**：`--json-out` 时人读「下一步」不会打印——**必须以落盘 `agentWorkflow` 为准**；`campaign-create` 落盘同样带 `agentWorkflow.nextCommand`（首轮 `batch get`）。

package/dist/skill/references/google-ads/google-ads-read.md CHANGED Viewed

@@ -24,13 +24,13 @@
 ## ID 来源速查
-| 需要的 ID           | 获取命令                                                                |
-| ------------------- | ----------------------------------------------------------------------- |
+| 需要的 ID           | 获取命令                                                                                                                                 |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
 | `accountId`（`-a`） | `siluzan-tso list-accounts -m Google --json-out ./snap` → `mediaCustomerId`（**纯数字**；UI 的 `123-456-7890` 可原样传入，CLI 去连字符） |
-| 广告系列 `id`       | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `id`      |
-| 广告组 `id`、`name` | `siluzan-tso ad groups -a <accountId> --json-out ./snap` → `id`、`name` |
-| 广告 `id`           | `siluzan-tso ad list -a <accountId> --json-out ./snap` → `id`           |
-| 关键词 `id`         | `siluzan-tso ad keywords -a <accountId> --json-out ./snap` → `id`       |
+| 广告系列 `id`       | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `id`                                                                       |
+| 广告组 `id`、`name` | `siluzan-tso ad groups -a <accountId> --json-out ./snap` → `id`、`name`                                                                  |
+| 广告 `id`           | `siluzan-tso ad list -a <accountId> --json-out ./snap` → `id`                                                                            |
+| 关键词 `id`         | `siluzan-tso ad keywords -a <accountId> --json-out ./snap` → `id`                                                                        |
 > **Google CID**：带连字符进网关曾导致 `HTTP 403：123-456-7890`；现 CLI 已归一化。仍失败时用纯数字重试；**禁止臆测授权过期**，须 `account check-access -a <mediaCustomerId>`（详见 [google-ads.md](google-ads.md) Gotchas / `accounts-permissions.md`）。
@@ -53,6 +53,8 @@ siluzan-tso ad campaigns -a <accountId> [--start <YYYY-MM-DD>] [--end <YYYY-MM-D
 带 `--start` / `--end` 时，同行的 **`spend` / `impressions` / `clicks` / `conversions` 为该闭区间合计**（**不是**日消耗）。
 与日预算比较「是否超预算」时，**必须** `start=end=统计日`；多日窗口须先 ÷ 天数或改用 `balance-scan.dailySpend` / `overview.averageDailyCost` 再谈「日均」。
+> **缓存**：网关侧此列表按 `账户 + 日期区间` 缓存 60 秒（Redis）。若刚 `campaign-create` / `campaign-edit` / `campaign-status` / `campaign-delete` 后立刻查询想看到最新结果，加 `--fresh` 跳过缓存（网关 `newest=true`）；日常巡检/报表不需要，留空更省配额。
 ### 启停
 ```bash
@@ -77,6 +79,8 @@ siluzan-tso ad campaign-delete -a <accountId> --id <campaignId>
 siluzan-tso ad groups -a <accountId> [--start/--end <date>] [--json-out ./snap]
 ```
+> **缓存**：同 `ad campaigns`，网关按 `账户 + 日期区间` 缓存 60 秒；刚 `adgroup-create` / `adgroup-edit` 等写操作后要立刻看到最新结果时加 `--fresh`（网关 `newest=true`）。
 ### 创建
 ```bash
@@ -156,11 +160,11 @@ siluzan-tso ad ad-create \
   [--json-out <path>]
 ```
-| 字段 | 数量 | 每条上限（Google 字符宽，CJK×2） |
-| ---- | ---- | -------------------------------- |
-| `--headlines` | **3–15** | **≤30** |
-| `--descriptions` | **2–4** | **≤90** |
-| `--path1`/`--path2` | 可选 | **≤15** |
+| 字段                | 数量     | 每条上限（Google 字符宽，CJK×2） |
+| ------------------- | -------- | -------------------------------- |
+| `--headlines`       | **3–15** | **≤30**                          |
+| `--descriptions`    | **2–4**  | **≤90**                          |
+| `--path1`/`--path2` | 可选     | **≤15**                          |
 提交前用脚本 `len`/CJK×2 自检；**禁止**一次塞入 >4 条描述。创建后暂停：`ad ad-status … --status Paused --commit "…"`。
@@ -199,6 +203,8 @@ siluzan-tso ad keyword-create \
 **支持空格多词短语**（如 `how to make`、`home cooking`）。匹配类型与 Web 一致：裸词=广泛，`"短语"`=词组，`[词]`=完全；也可用 `--match-type`。多词/带引号时推荐 `--keywords-file`，避免 shell 转义。
+**三级层级：** Campaign（系列）/ AdGroup（组）/ **Account（账户级，Sammamish 2026-08 新增）**。不传 `--level` 时按是否传 `--adgroup-id` 自动判断 Campaign / AdGroup（兼容旧用法）；**账户级必须显式传 `--level Account`**，且不能传 `--campaign-id` / `--adgroup-id`。账户级否词一次生效于整个账户下所有系列（对应 Google Ads「Account Settings → Negative keywords」），**无需再去 Google 后台手工应用**——这是本次新增前的旧限制，现已由接口直接支持。
 ```bash
 # 添加（默认系列层级；传 --adgroup-id 则为组层级）
 # 多词短语直接写空格，逗号分隔多条——CLI 支持，无需改后台手工补
@@ -214,11 +220,23 @@ siluzan-tso ad keyword-negative-create \
   --campaign-id <campaignId> --campaign-name <campaignName> \
   --keywords-file ./negatives.json --match-type Phrase
-# 删除（先用 ad keywords --negative --json-out ./snap 获取 id）
+# 添加账户级否词（--level Account；无需 campaign-id/adgroup-id）
+siluzan-tso ad keyword-negative-create \
+  -a <accountId> --level Account \
+  --keywords "free,jobs,DIY"
+# 查询：--level Account|Campaign|AdGroup 按层级过滤；不传则三级都返回（用输出里的「级别」区分）
+siluzan-tso ad keywords -a <accountId> --negative --level Account --json-out ./snap
+siluzan-tso ad keywords -a <accountId> --negative --level AdGroup
+# 删除/编辑对三级通用（先用 ad keywords --negative --json-out ./snap 获取 id，无需额外传层级）
+# 编辑成功后 id 可能变（网关先建后删），以 CLI 提示的新 id 为准
 siluzan-tso ad keyword-negative-delete -a <accountId> --id <negativeKeywordId>
 ```
 > **禁止**因「多词」就让用户去 Google Ads 后台手工补否词——那是 Agent 误判；用上面命令即可。
+> 账户级否词账户上限约 1000 词；权限不足返回 `403`，Google 侧错误返回 `400`。
+> 查询 `--level AdGroup` 时 CLI 会映射为网关历史值 `appliedlevel=Ad group`（有空格），调用方无需关心。
 ---

package/dist/skill/references/google-ads/google-ads-write.md CHANGED Viewed

@@ -39,13 +39,13 @@
 ## ID 来源速查
-| 需要的 ID           | 获取命令                                                                |
-| ------------------- | ----------------------------------------------------------------------- |
+| 需要的 ID                            | 获取命令                                                                                                                               |
+| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
 | `accountId`（`-a`） / JSON `account` | `list-accounts -m Google` → `mediaCustomerId`（纯数字；UI 带连字符 CID 可传入，CLI 去横杠，见 [google-ads.md](google-ads.md) Gotchas） |
-| 广告系列 `id`       | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `id`      |
-| 广告组 `id`、`name` | `siluzan-tso ad groups -a <accountId> --json-out ./snap` → `id`、`name` |
-| 广告 `id`           | `siluzan-tso ad list -a <accountId> --json-out ./snap` → `id`           |
-| 关键词 `id`         | `siluzan-tso ad keywords -a <accountId> --json-out ./snap` → `id`       |
+| 广告系列 `id`                        | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `id`                                                                     |
+| 广告组 `id`、`name`                  | `siluzan-tso ad groups -a <accountId> --json-out ./snap` → `id`、`name`                                                                |
+| 广告 `id`                            | `siluzan-tso ad list -a <accountId> --json-out ./snap` → `id`                                                                          |
+| 关键词 `id`                          | `siluzan-tso ad keywords -a <accountId> --json-out ./snap` → `id`                                                                      |
 ---
@@ -63,7 +63,7 @@
 | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | 模板         | 复制 `assets/pmax-create-template.json`，字段见 `assets/pmax-create-template.md`                                                                                                                                   |
 | **素材转换** | `siluzan-tso ad pmax-image-convert --input ./banner.jpg --output-dir ./assets --prefix <name> [--update-config ./pmax.json]`                                                                                       |
-| 地理 ID      | 多国：`ad geo resolve -a <accountId> --from-file ./locations.json --json-out ./snap-geo`；单国：`ad geo search -a <accountId> -q "<地区名>"`                                                                         |
+| 地理 ID      | 多国：`ad geo resolve -a <accountId> --from-file ./locations.json --json-out ./snap-geo`；单国：`ad geo search -a <accountId> -q "<地区名>"`                                                                       |
 | 校验         | `siluzan-tso ad pmax-validate --config-file ./pmax.json [--json-out ./snap-pmax]`（图片规格 + 文案超长 `lengthViolations`；超长勿自动截断，见 `references/google-ads/google-ads-campaign-plan.md` § 超长人工确认） |
 | **审查稿**   | Agent **写代码**读 JSON，按 `rules/google-ads-pmax-launch-plan-template.md` 投影完整文件（默认 MD；用户指定则 Excel 等）→ 用户确认；**禁止**只交概览表                                                             |
 | 创建         | `siluzan-tso ad pmax-create --config-file ./pmax.json [--json-out ./snap-pmax]`                                                                                                                                    |
@@ -157,12 +157,12 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 ### 失败处理（Agent 必遵）
-| `status`       | 含义     | 做法                                                                                                   |
-| -------------- | -------- | ------------------------------------------------------------------------------------------------------ |
+| `status`       | 含义     | 做法                                                                                                       |
+| -------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
 | `Creating`     | 仍在执行 | 继续 `ad batch get`（带同一 `--config-file` + `--json-out`），读 `agentWorkflow`，勿重复 `campaign-create` |
-| `Successfully` | 全部成功 | **须** `ad batch diff`（含投放国家）；`--json-out` 时 `ok===true` 才算齐                                 |
-| `Failed`       | 全部失败 | `ad batch get` 读 `reason`/`errors` → **只改 JSON** → 再 `ad campaign-create`（**不要** `batch diff`） |
-| `HasFailed`    | 部分成功 | **须** `ad batch diff` 列出缺失 → 分步补建或删系列重提（`ok===false` / exit 2）                          |
+| `Successfully` | 全部成功 | **须** `ad batch diff`（含投放国家）；`--json-out` 时 `ok===true` 才算齐                                   |
+| `Failed`       | 全部失败 | `ad batch get` 读 `reason`/`errors` → **只改 JSON** → 再 `ad campaign-create`（**不要** `batch diff`）     |
+| `HasFailed`    | 部分成功 | **须** `ad batch diff` 列出缺失 → 分步补建或删系列重提（`ok===false` / exit 2）                            |
 **`HasFailed` 分支：**
@@ -276,11 +276,11 @@ siluzan-tso ad ad-create \
   [--json-out <path>]
 ```
-| 约束 | 值 |
-| ---- | -- |
-| headlines | **3–15** 条，每条 **≤30** Google 字符（CJK×2） |
-| descriptions | **2–4** 条，每条 **≤90** Google 字符（CJK×2） |
-| path1/path2 | 可选，各 **≤15** |
+| 约束         | 值                                             |
+| ------------ | ---------------------------------------------- |
+| headlines    | **3–15** 条，每条 **≤30** Google 字符（CJK×2） |
+| descriptions | **2–4** 条，每条 **≤90** Google 字符（CJK×2）  |
+| path1/path2  | 可选，各 **≤15**                               |
 创建后暂停：`ad ad-status -a <accountId> --id <adId> --status Paused --commit "创建后暂停"`。若列表找不到新广告，给 `ad-status` / `ad list` 加宽 `--start`/`--end`。
@@ -347,6 +347,23 @@ siluzan-tso ad keyword-status -a <accountId> --id <keywordId> --status <Enabled|
 ---
+## ad keyword-negative-create — 否词创建（系列/组/账户三级）
+```bash
+# 系列级（默认）/ 组级（传 --adgroup-id）：与旧版一致
+siluzan-tso ad keyword-negative-create -a <accountId> \
+  --campaign-id <campaignId> --campaign-name <campaignName> \
+  --keywords "词1,词2"
+# 账户级（Sammamish 2026-08 新增，Google Ads「Account Settings → Negative keywords」）：
+# --level Account，不传 campaign-id/adgroup-id；一次生效于整个账户所有系列
+siluzan-tso ad keyword-negative-create -a <accountId> --level Account --keywords "free,jobs,DIY"
+```
+详见 `google-ads-read.md` §否定关键词（含 `--level` 用法与限制：账户上限约 1000 词）。
+---
 ## ad keyword-negative-edit — 否词编辑
 ```bash
@@ -355,7 +372,7 @@ siluzan-tso ad keyword-negative-edit \
   [--text <新文本>] [--match-type Broad|Phrase|Exact]
 ```
-传 `--match-type` 时 CLI 自动同步改写外层括号/引号。
+传 `--match-type` 时 CLI 自动同步改写外层括号/引号。系列/组/账户三级通用，无需额外传层级参数。
 ---

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

@@ -4,11 +4,11 @@
 ## 支持的广告类型（硬边界）
-| 类型 | CLI / Skill | 说明 |
-| ---- | ----------- | ---- |
-| **搜索广告（Search）** | ✅ 支持 | 方案、`campaign-validate` / `campaign-create`、组/RSA/关键词 CRUD、扩展等 |
-| **Performance Max（PMax）** | ✅ 支持 | `pmax-validate` / `pmax-create` 及存量 PMax 管理（见 `pmax-api.md`） |
-| **展示广告（Display）** | ❌ **不支持** | 含独立 Display 系列、自适应展示广告（RDA）等；**禁止**创建或伪装创建 |
+| 类型                        | CLI / Skill   | 说明                                                                      |
+| --------------------------- | ------------- | ------------------------------------------------------------------------- |
+| **搜索广告（Search）**      | ✅ 支持       | 方案、`campaign-validate` / `campaign-create`、组/RSA/关键词 CRUD、扩展等 |
+| **Performance Max（PMax）** | ✅ 支持       | `pmax-validate` / `pmax-create` 及存量 PMax 管理（见 `pmax-api.md`）      |
+| **展示广告（Display）**     | ❌ **不支持** | 含独立 Display 系列、自适应展示广告（RDA）等；**禁止**创建或伪装创建      |
 用户明确要求展示广告时：如实告知不支持，可改推 Search 或 PMax；**禁止**用搜索系列 JSON / `ad-create`（RSA）冒充 Display。
@@ -16,14 +16,14 @@
 ## 何时 Read
-| 任务 | Read |
-| ---- | ---- |
-| 查系列/组/创意/关键词/搜索词/地理 | [`google-ads-read.md`](google-ads-read.md) |
-| 创建/编辑/启停/否词/附加信息/PMax/设备出价 | [`google-ads-write.md`](google-ads-write.md) |
-| batch 流水线、`ad batch`、AI 智投草稿（W4） | [`google-ads-batch.md`](google-ads-batch.md) |
-| 搜索系列 7 步方案与门禁 | [`google-ads-campaign-plan.md`](google-ads-campaign-plan.md) |
-| PMax 网关路径 | [`pmax-api.md`](pmax-api.md) |
-| 优化/合规 SOP | [`rules/README.md`](rules/README.md)（只读索引 → 再读一个 rules 文件） |
+| 任务                                        | Read                                                                   |
+| ------------------------------------------- | ---------------------------------------------------------------------- |
+| 查系列/组/创意/关键词/搜索词/地理           | [`google-ads-read.md`](google-ads-read.md)                             |
+| 创建/编辑/启停/否词/附加信息/PMax/设备出价  | [`google-ads-write.md`](google-ads-write.md)                           |
+| batch 流水线、`ad batch`、AI 智投草稿（W4） | [`google-ads-batch.md`](google-ads-batch.md)                           |
+| 搜索系列 7 步方案与门禁                     | [`google-ads-campaign-plan.md`](google-ads-campaign-plan.md)           |
+| PMax 网关路径                               | [`pmax-api.md`](pmax-api.md)                                           |
+| 优化/合规 SOP                               | [`rules/README.md`](rules/README.md)（只读索引 → 再读一个 rules 文件） |
 ## Gotchas
@@ -55,4 +55,3 @@
 | 关键词 `id`         | `siluzan-tso ad keywords -a <accountId> --json-out ./snap` → `id`       |
 ---

package/dist/skill/references/google-ads/rules/README.md CHANGED Viewed

@@ -3,22 +3,22 @@
 > **策略/SOP**，非 CLI 参数表。命令见 `google-ads-read.md` / `google-ads-write.md` / `google-ads-batch.md`。新建流程见 `google-ads-campaign-plan.md`。
 > **怎么读**：下表选 **一个**文件再 Read（审计/合规若有子模块，先读其导航再选子文件）。
-| 文件 | 何时 Read |
-| ---- | --------- |
-| `google-ads-account-audit.md` | 账户健康审计（索引 → quick / structure / assets / report） |
-| `google-ads-compliance.md` | 合规政策（索引 → forbid / copy / ops） |
-| `google-ads-campaign-optimization.md` | 系列层优化决策 |
-| `google-ads-keyword-strategy.md` | 关键词策略规划 |
-| `google-ads-keyword-optimization.md` | 关键词出价/否定/扩词 |
-| `google-ads-keyword-taxonomy.md` | 词类分层与命名 |
-| `google-ads-plan-source-fidelity.md` | **Excel/表格方案 → JSON**（有方案文件时必读） |
-| `google-ads-creative-optimization.md` | 创意/文案优化 |
-| `google-ads-audience-strategy.md` | 受众策略 |
-| `google-ads-pmax-guide.md` | PMax 运营（配合 `assets/pmax-create-template.md`） |
-| `google-ads-conversion-architecture.md` | 转化追踪架构 |
-| `google-ads-landing-page-discovery-via-webfetch.md` | 落地页发现（WebFetch） |
-| `google-ads-launch-plan-template.md` | 搜索投放审查稿（Agent 写代码从 JSON 投影） |
-| `google-ads-pmax-launch-plan-template.md` | PMax 投放审查稿（Agent 写代码从 JSON 投影） |
-| `sensitive-industries.md` | 敏感行业限制 |
+| 文件                                                | 何时 Read                                                  |
+| --------------------------------------------------- | ---------------------------------------------------------- |
+| `google-ads-account-audit.md`                       | 账户健康审计（索引 → quick / structure / assets / report） |
+| `google-ads-compliance.md`                          | 合规政策（索引 → forbid / copy / ops）                     |
+| `google-ads-campaign-optimization.md`               | 系列层优化决策                                             |
+| `google-ads-keyword-strategy.md`                    | 关键词策略规划                                             |
+| `google-ads-keyword-optimization.md`                | 关键词出价/否定/扩词                                       |
+| `google-ads-keyword-taxonomy.md`                    | 词类分层与命名                                             |
+| `google-ads-plan-source-fidelity.md`                | **Excel/表格方案 → JSON**（有方案文件时必读）              |
+| `google-ads-creative-optimization.md`               | 创意/文案优化                                              |
+| `google-ads-audience-strategy.md`                   | 受众策略                                                   |
+| `google-ads-pmax-guide.md`                          | PMax 运营（配合 `assets/pmax-create-template.md`）         |
+| `google-ads-conversion-architecture.md`             | 转化追踪架构                                               |
+| `google-ads-landing-page-discovery-via-webfetch.md` | 落地页发现（WebFetch）                                     |
+| `google-ads-launch-plan-template.md`                | 搜索投放审查稿（Agent 写代码从 JSON 投影）                 |
+| `google-ads-pmax-launch-plan-template.md`           | PMax 投放审查稿（Agent 写代码从 JSON 投影）                |
+| `sensitive-industries.md`                           | 敏感行业限制                                               |
 宿主编排自动优化：`references/operations/hosted-automation-optimize-index.md`。

package/dist/skill/references/google-ads/rules/google-ads-account-audit.md CHANGED Viewed

@@ -6,8 +6,6 @@
 ---
 - 1. 审计总览与流程
 - 2. 快速健康检查（5分钟诊断）
 - 3. 账户结构审计
@@ -33,9 +31,9 @@
 ## Contents / 何时 Read
-| 文件 | 何时 Read |
-| ---- | --------- |
-| [`google-ads-account-audit-quick.md`](google-ads-account-audit-quick.md) | 5 分钟健康检查、常见问题速查、CLI 审计命令序列 |
-| [`google-ads-account-audit-structure.md`](google-ads-account-audit-structure.md) | 账户结构、转化追踪、出价策略审计 |
-| [`google-ads-account-audit-assets.md`](google-ads-account-audit-assets.md) | 关键词/创意/地域设备/落地页/预算/竞争态势 |
-| [`google-ads-account-audit-report.md`](google-ads-account-audit-report.md) | 撰写审计报告章节（Critical/Warning/Opportunity） |
+| 文件                                                                             | 何时 Read                                        |
+| -------------------------------------------------------------------------------- | ------------------------------------------------ |
+| [`google-ads-account-audit-quick.md`](google-ads-account-audit-quick.md)         | 5 分钟健康检查、常见问题速查、CLI 审计命令序列   |
+| [`google-ads-account-audit-structure.md`](google-ads-account-audit-structure.md) | 账户结构、转化追踪、出价策略审计                 |
+| [`google-ads-account-audit-assets.md`](google-ads-account-audit-assets.md)       | 关键词/创意/地域设备/落地页/预算/竞争态势        |
+| [`google-ads-account-audit-report.md`](google-ads-account-audit-report.md)       | 撰写审计报告章节（Critical/Warning/Opportunity） |

package/dist/skill/references/google-ads/rules/google-ads-compliance.md CHANGED Viewed

@@ -7,8 +7,6 @@
 ---
 - 一、行业敏感度分级（先判断再执行）
 - 二、绝对禁止内容（关键词/文案中不可出现）
 - 三、编辑合规规则（Top 12% 被拒原因）
@@ -29,8 +27,8 @@
 ## Contents / 何时 Read
-| 文件 | 何时 Read |
-| ---- | --------- |
-| [`google-ads-compliance-forbid.md`](google-ads-compliance-forbid.md) | 行业分级、绝对禁止、编辑/虚假承诺/商标/落地页一致性 |
-| [`google-ads-compliance-copy.md`](google-ads-compliance-copy.md) | 关键词生成、多语言、修饰语、Headlines/Descriptions 清单、新广告主验证 |
-| [`google-ads-compliance-ops.md`](google-ads-compliance-ops.md) | 生成前检查、命令联动、被拒排查、申诉恢复 |
+| 文件                                                                 | 何时 Read                                                             |
+| -------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`google-ads-compliance-forbid.md`](google-ads-compliance-forbid.md) | 行业分级、绝对禁止、编辑/虚假承诺/商标/落地页一致性                   |
+| [`google-ads-compliance-copy.md`](google-ads-compliance-copy.md)     | 关键词生成、多语言、修饰语、Headlines/Descriptions 清单、新广告主验证 |
+| [`google-ads-compliance-ops.md`](google-ads-compliance-ops.md)       | 生成前检查、命令联动、被拒排查、申诉恢复                              |

package/dist/skill/references/google-ads/rules/google-ads-keyword-strategy.md CHANGED Viewed

@@ -403,15 +403,15 @@ Broad Match + 受众信号 = 伪装成广泛定向的精准投放。
 ## 十四、CLI 命令联动速查
-| 策略场景     | 命令                                                         | 要点                                                                    |
-| ------------ | ------------------------------------------------------------ | ----------------------------------------------------------------------- |
-| 关键词调研   | `keyword -k "词" [--url]`                                    | 结果按意图分层后再添加                                                  |
-| 添加关键词   | `ad keyword-create --keywords "词1,词2"`                     | 格式：`词→BROAD`、`"词"→PHRASE`、`[词]→EXACT`                           |
-| 添加否定词   | `ad keyword-negative-create`                                 | **支持空格多词**（`how to make`）；多词用 `--keywords` 或 `--keywords-file`，**禁止**因多词改让用户后台手补 |
-| 创建广告系列 | `ad campaign-create --config-file`（先 `campaign-validate`） | `KeywordText` 为 JSON 数组，**空格多词合法**；否词写 `NegativeKeywordsForBatchJob`，勿因多词省略 |
-| 搜索词分析   | `ad search-terms`                                            | 每周导出，按第八章流程处理                                              |
-| 竞品监控     | `ad auction-insights`（如有）                                | 按第九章分析竞争态势                                                    |
-| 出价调整     | 广告系列级 Smart Bidding 设置                                | 新账户用 Manual/ECPC → 有数据后切 tCPA/tROAS                            |
+| 策略场景     | 命令                                                         | 要点                                                                                                        |
+| ------------ | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
+| 关键词调研   | `keyword -k "词" [--url]`                                    | 结果按意图分层后再添加                                                                                      |
+| 添加关键词   | `ad keyword-create --keywords "词1,词2"`                     | 格式：`词→BROAD`、`"词"→PHRASE`、`[词]→EXACT`                                                               |
+| 添加否定词   | `ad keyword-negative-create`                                 | **支持空格多词**（`how to make`）；多词用 `--keywords` 或 `--keywords-file`，**禁止**因多词改让用户后台手补；`--level Account` 可直接建账户级否词（详见 `google-ads-write.md`） |
+| 创建广告系列 | `ad campaign-create --config-file`（先 `campaign-validate`） | `KeywordText` 为 JSON 数组，**空格多词合法**；否词写 `NegativeKeywordsForBatchJob`，勿因多词省略            |
+| 搜索词分析   | `ad search-terms`                                            | 每周导出，按第八章流程处理                                                                                  |
+| 竞品监控     | `ad auction-insights`（如有）                                | 按第九章分析竞争态势                                                                                        |
+| 出价调整     | 广告系列级 Smart Bidding 设置                                | 新账户用 Manual/ECPC → 有数据后切 tCPA/tROAS                                                                |
 ---

package/dist/skill/references/google-ads/rules/google-ads-launch-plan-template.md CHANGED Viewed

@@ -35,22 +35,22 @@
 ## Markdown ↔ JSON 映射（生成 JSON 时对照）
-| 计划正文（Markdown）   | `campaign-create` JSON 字段（**PascalCase 直通后端**）                                                                              |
-| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| 账户 ID / 客户名       | `account`、`customerName`（外层）                                                                                                   |
-| 系列名称               | `name`（外层展示用） / `campaign.Name`（内层）                                                                                      |
-| 日预算                 | `campaign.Budget`（**元**，CLI 内部 ×100 转分）                                                                                     |
-| 出价策略 / 上限 / tCPA | `campaign.BiddingStrategyTypeV2`、`campaign.TargetSpend_BidCeilingAmount`、`campaign.TargetCpa_BidingAmount`、`campaign.TargetRoas` |
+| 计划正文（Markdown）   | `campaign-create` JSON 字段（**PascalCase 直通后端**）                                                                                             |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 账户 ID / 客户名       | `account`、`customerName`（外层）                                                                                                                  |
+| 系列名称               | `name`（外层展示用） / `campaign.Name`（内层）                                                                                                     |
+| 日预算                 | `campaign.Budget`（**元**，CLI 内部 ×100 转分）                                                                                                    |
+| 出价策略 / 上限 / tCPA | `campaign.BiddingStrategyTypeV2`、`campaign.TargetSpend_BidCeilingAmount`、`campaign.TargetCpa_BidingAmount`、`campaign.TargetRoas`                |
 | 投放地域               | `campaign.targetedLocations: [{ id: "<geoId>" }]`（**必须**先 `ad geo search` 取 id，禁止编造）、外层 `locations`（与 targetedLocations 同序同量） |
-| 语言                   | `campaign.targetedLanguages: [{ id: 1000 }]`（英语 1000 / 中文 1017）                                                               |
-| 起止日期               | `campaign.StartTime`、`campaign.EndTime`（YYYY-MM-DD）                                                                              |
-| 落地页                 | 外层 `url`；广告组级 `KeywordsForBatchJob[].FinalURL`、创意级 `AdsForBatchJob[].Finalurl`                                           |
-| 关键词                 | `campaign.AdGroupsForBatchJob[].KeywordsForBatchJob`（`MatchTypeV2` + `KeywordText`）                                               |
-| 否定词                 | `campaign.NegativeKeywordsForBatchJob: [{ KeywordText: [...], MatchTypeV2: "BROAD", FinalURL: "" }]`                                |
-| 附加信息               | `campaign.ExtensionsForBatchJob`                                                                                                    |
-| 广告组                 | `campaign.AdGroupsForBatchJob[]`：`Name`、`MaxCPCAmount`、`KeywordsForBatchJob`、`AdsForBatchJob`                                   |
-| 仅保存草稿             | `draft: true` → 确认后 `ad batch publish`                                                                                           |
-| 立即创建               | `draft: false`（默认）                                                                                                              |
+| 语言                   | `campaign.targetedLanguages: [{ id: 1000 }]`（英语 1000 / 中文 1017）                                                                              |
+| 起止日期               | `campaign.StartTime`、`campaign.EndTime`（YYYY-MM-DD）                                                                                             |
+| 落地页                 | 外层 `url`；广告组级 `KeywordsForBatchJob[].FinalURL`、创意级 `AdsForBatchJob[].Finalurl`                                                          |
+| 关键词                 | `campaign.AdGroupsForBatchJob[].KeywordsForBatchJob`（`MatchTypeV2` + `KeywordText`）                                                              |
+| 否定词                 | `campaign.NegativeKeywordsForBatchJob: [{ KeywordText: [...], MatchTypeV2: "BROAD", FinalURL: "" }]`                                               |
+| 附加信息               | `campaign.ExtensionsForBatchJob`                                                                                                                   |
+| 广告组                 | `campaign.AdGroupsForBatchJob[]`：`Name`、`MaxCPCAmount`、`KeywordsForBatchJob`、`AdsForBatchJob`                                                  |
+| 仅保存草稿             | `draft: true` → 确认后 `ad batch publish`                                                                                                          |
+| 立即创建               | `draft: false`（默认）                                                                                                                             |
 关键词匹配（在 `KeywordsForBatchJob` 块中以 `MatchTypeV2` 区分；同一块同匹配类型）：`词`→广泛、`"词"`→词组、`[词]`→完全。
 从 Excel/表格方案导入时须保真匹配类型与地域 id，见 `google-ads-plan-source-fidelity.md`。
@@ -88,6 +88,7 @@
 {{如为 Tier 2/3，在此插入合规提示：}}
 > ⚠️ **合规提示**（推荐列出 **2–4 条**核心限制）：{{行业}}属于{{Tier等级}}行业，须遵守以下限制：
+>
 > - {{限制条目 1}}
 > - {{限制条目 2}}
 > - {{限制条目 3（可选）}}