npm - siluzan-tso-cli - Versions diffs - 1.1.29-beta.2 → 1.1.29-beta.21 - Mend

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

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

package/dist/skill/assets/market-analysis-rules.md CHANGED Viewed

@@ -7,15 +7,15 @@
 ## 原始业务输入（collect）
-| 字段 | CLI 选项 | 必填 |
-| ---- | -------- | ---- |
-| 客户名称 | `--customer-name` | 四选一* |
-| 客户网站 | `--website` | 四选一* |
-| 所属行业 | `--industry` | 四选一* |
-| 核心产品 | `--core-products` | 四选一* |
-| 商业定位 | `--business-position` | 否 |
-| 目标市场 | `--target-market` | 默认「全球」 |
-| 时间范围 | `--time-range` | 默认「近12个月」 |
+| 字段     | CLI 选项              | 必填             |
+| -------- | --------------------- | ---------------- |
+| 客户名称 | `--customer-name`     | 四选一\*         |
+| 客户网站 | `--website`           | 四选一\*         |
+| 所属行业 | `--industry`          | 四选一\*         |
+| 核心产品 | `--core-products`     | 四选一\*         |
+| 商业定位 | `--business-position` | 否               |
+| 目标市场 | `--target-market`     | 默认「全球」     |
+| 时间范围 | `--time-range`        | 默认「近12个月」 |
 \* 至少一项。目标市场非中国时，**禁止**用中国数据替代目标市场分析。
@@ -27,76 +27,76 @@
 ### 封面
-| 维度 | 必含内容 |
-| ---- | -------- |
+| 维度     | 必含内容                                     |
+| -------- | -------------------------------------------- |
 | 报告标识 | 标题含「战略市场分析」或「KA客户」+ 目标市场 |
-| 执行摘要 | 核心结论段或 KPI/metric 卡片（非仅标题） |
+| 执行摘要 | 核心结论段或 KPI/metric 卡片（非仅标题）     |
 ### 一、市场与趋势诊断
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
-| 1.1 | 全球市场规模与增长 | TAM/SAM/SOM 或「市场规模」+ CAGR/增长率；**须有 Chart.js 图** |
-| 1.2 | 赛道与生态定位 | 价值链/产业链表：上游·中游·下游·服务层 |
-| 1.3 | 目标市场国家拆解 | 按国家/区域：规模、增长、优先级、潜力（宜含美/加/墨或用户指定市场） |
-| 1.4 | 技术趋势 PESTEL | 政策/经济/社会/技术/环境/法规 ≥6 维表或等价结构 |
-| 1.5 | 中期预测 | 未来 3–5 年趋势 + **假设依据** |
+| #   | 维度               | 必含内容                                                            |
+| --- | ------------------ | ------------------------------------------------------------------- |
+| 1.1 | 全球市场规模与增长 | TAM/SAM/SOM 或「市场规模」+ CAGR/增长率；**须有 ECharts 图**        |
+| 1.2 | 赛道与生态定位     | 价值链/产业链表：上游·中游·下游·服务层                              |
+| 1.3 | 目标市场国家拆解   | 按国家/区域：规模、增长、优先级、潜力（宜含美/加/墨或用户指定市场） |
+| 1.4 | 技术趋势 PESTEL    | 政策/经济/社会/技术/环境/法规 ≥6 维表或等价结构                     |
+| 1.5 | 中期预测           | 未来 3–5 年趋势 + **假设依据**                                      |
 ### 二、目标行业深度洞察
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
-| 2.1 | 核心痛点 | **≥4 项**，每条有业务含义（非一句话带过） |
-| 2.2 | 法规与合规 | 核心法规表 + 技术应对 + **合规溢价/成本估算** |
+| #   | 维度         | 必含内容                                                         |
+| --- | ------------ | ---------------------------------------------------------------- |
+| 2.1 | 核心痛点     | **≥4 项**，每条有业务含义（非一句话带过）                        |
+| 2.2 | 法规与合规   | 核心法规表 + 技术应对 + **合规溢价/成本估算**                    |
 | 2.3 | 业务场景流程 | **原流程 vs 介入后新流程**（BPMN 文本）+ 效率/成本量化（如 30%） |
 ### 三、目标受众与场景
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
-| 3.1 | 受众分析 | 用户总量/市场规模；**≥4 类用户群体表**（特征/痛点/价值） |
+| #   | 维度       | 必含内容                                                     |
+| --- | ---------- | ------------------------------------------------------------ |
+| 3.1 | 受众分析   | 用户总量/市场规模；**≥4 类用户群体表**（特征/痛点/价值）     |
 | 3.2 | 场景与价值 | 核心功能、差异化、应用场景、用户价值与企业价值；**须有图表** |
 ### 四、竞争策略与定位
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
-| 4.1 | 竞品识别 | 点名 **≥3** 个主要竞品/对标品牌 |
-| 4.2 | 功能性能对比 | 对比表 **≥10 行维度** × 我方 + ≥3 竞品 + 性能指标行 |
-| 4.3 | 竞争空白 | **功能、场景、用户群、地域** 四类空白（至少覆盖 3 类） |
-| 4.4 | 定位与差异化 | **一句定位陈述** + **3 个差异化维度** |
+| #   | 维度         | 必含内容                                               |
+| --- | ------------ | ------------------------------------------------------ |
+| 4.1 | 竞品识别     | 点名 **≥3** 个主要竞品/对标品牌                        |
+| 4.2 | 功能性能对比 | 对比表 **≥10 行维度** × 我方 + ≥3 竞品 + 性能指标行    |
+| 4.3 | 竞争空白     | **功能、场景、用户群、地域** 四类空白（至少覆盖 3 类） |
+| 4.4 | 定位与差异化 | **一句定位陈述** + **3 个差异化维度**                  |
 ### 五、增长与品牌策略
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
+| #   | 维度       | 必含内容                                                         |
+| --- | ---------- | ---------------------------------------------------------------- |
 | 5.1 | GTM 三阶段 | 试点启动 → 规模复制 → 生态扩展；每阶段：目标、动作、**KPI、ROI** |
-| 5.2 | 品牌传播 | 品牌主张、价值、差异化信息、渠道与内容策略 |
-| 5.3 | 营销战术 | 内容营销、渠道营销、KOL/口碑、销售模式 |
+| 5.2 | 品牌传播   | 品牌主张、价值、差异化信息、渠道与内容策略                       |
+| 5.3 | 营销战术   | 内容营销、渠道营销、KOL/口碑、销售模式                           |
 ### 六、实施、资源与风险
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
-| 6.1 | 里程碑 | 任务表：阶段/任务/负责人/成果/指标 |
-| 6.2 | 资源预算 | 人力/技术/市场分配或预算比例 |
+| #   | 维度     | 必含内容                                     |
+| --- | -------- | -------------------------------------------- |
+| 6.1 | 里程碑   | 任务表：阶段/任务/负责人/成果/指标           |
+| 6.2 | 资源预算 | 人力/技术/市场分配或预算比例                 |
 | 6.3 | 风险矩阵 | 市场/竞争/技术/运营风险 + **每类 ≥2 条应对** |
 ### 附录
-| # | 维度 | 必含内容 |
-| - | ---- | -------- |
-| A.1 | 数据来源 | 机构、报告名、日期或 URL 清单 |
-| A.2 | 调研方法 | 桌面研究/访谈/问卷等 |
-| A.3 | 术语表 | 解释 ROI、CAGR、GTM、BPMN 等 **≥3** 个缩写 |
+| #   | 维度     | 必含内容                                   |
+| --- | -------- | ------------------------------------------ |
+| A.1 | 数据来源 | 机构、报告名、日期或 URL 清单              |
+| A.2 | 调研方法 | 桌面研究/访谈/问卷等                       |
+| A.3 | 术语表   | 解释 ROI、CAGR、GTM、BPMN 等 **≥3** 个缩写 |
 ### 呈现规范（HTML）
-| 维度 | 要求 |
-| ---- | ---- |
-| Chart.js | 引用 CDN + `new Chart` 图表 |
-| 来源脚注 | 图表/关键表配 `Source:` 或「来源」 |
-| 版式 | Bootstrap CDN；商务深蓝；max-width 1200px；每 slide 页码点 |
+| 维度     | 要求                                                                                        |
+| -------- | ------------------------------------------------------------------------------------------- |
+| ECharts  | 统一引用 `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.js` + `echarts.init` 图表 |
+| 来源脚注 | 图表/关键表配 `Source:` 或「来源」                                                          |
+| 版式     | Bootstrap CDN；商务深蓝；max-width 1200px；每 slide 页码点                                  |
 ---
@@ -127,8 +127,8 @@
 ## 与「账户分析 / 网站诊断」区分
-| 能力 | 说明 |
-| ---- | ---- |
-| 本报告 | 行业/竞品/GTM 战略，公开市场调研 |
-| google-analysis | 广告投放数据 |
-| website-diagnosis | 落地页 6 模块评分 |
+| 能力              | 说明                             |
+| ----------------- | -------------------------------- |
+| 本报告            | 行业/竞品/GTM 战略，公开市场调研 |
+| google-analysis   | 广告投放数据                     |
+| website-diagnosis | 落地页 6 模块评分                |

package/dist/skill/assets/meta-period-report-rules.md CHANGED Viewed

@@ -8,13 +8,13 @@
 ## 与网站诊断的对照（为何 FB 报告会显得「建议太少」）
-| 网站诊断（P8） | Meta 周期报告（P4-FB） |
-| -------------- | ---------------------- |
-| `website-diagnosis-rules.md` 规定 29 子项全覆盖 | 本文件规定 **5 维数据 + 叙事 + 建议** 全覆盖 |
-| 每项 `issue` + `suggestion`（较差项以「强烈建议：」开头） | 每条建议 `content` 须 **引用当次数字** + **可执行动作** |
-| `coreIssuesIds` + `PriorityPlan` 高/中/低 | `priorityPlan` + `narrative.recommendations` 4 条 + `supplementaryRecommendations` |
-| HTML 由 `render` 渲染全部章节 | HTML **必须**填 `executiveSummary`、`healthDiagnosis`、`sections.*.insight` 等（见下） |
-| 交付前 Read HTML 对照章节清单 | 交付前 Read HTML/xlsx 对照 `deliverable-preflight.md` § P4-FB |
+| 网站诊断（P8）                                            | Meta 周期报告（P4-FB）                                                                 |
+| --------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `website-diagnosis-rules.md` 规定 29 子项全覆盖           | 本文件规定 **5 维数据 + 叙事 + 建议** 全覆盖                                           |
+| 每项 `issue` + `suggestion`（较差项以「强烈建议：」开头） | 每条建议 `content` 须 **引用当次数字** + **可执行动作**                                |
+| `coreIssuesIds` + `PriorityPlan` 高/中/低                 | `priorityPlan` + `narrative.recommendations` 4 条 + `supplementaryRecommendations`     |
+| HTML 由 `render` 渲染全部章节                             | HTML **必须**填 `executiveSummary`、`healthDiagnosis`、`sections.*.insight` 等（见下） |
+| 交付前 Read HTML 对照章节清单                             | 交付前 Read HTML/xlsx 对照 `deliverable-preflight.md` § P4-FB                          |
 **常见失误（导致建议偏少）**：
@@ -35,45 +35,45 @@
 ### 1. `narrative.overall`（整体表现）
-| 要求 | 细则 |
-| ---- | ---- |
-| 字数 | **≥ 120 字**（中文） |
+| 要求     | 细则                                                                                       |
+| -------- | ------------------------------------------------------------------------------------------ |
+| 字数     | **≥ 120 字**（中文）                                                                       |
 | 必含数字 | 花费、`results`、CPL（`costPerResult`）、`reach`、`impressions`、`frequency` **至少 5 项** |
-| 必含口径 | `resultType`、`attributionSetting`（写入 `meta` 并在段中提及） |
-| 可选 | 若有 `previousPeriod`，写 1～2 句环比（花费 ±%、CPL ±%） |
+| 必含口径 | `resultType`、`attributionSetting`（写入 `meta` 并在段中提及）                             |
+| 可选     | 若有 `previousPeriod`，写 1～2 句环比（花费 ±%、CPL ±%）                                   |
 ### 2. `narrative.regional[]`（区域 / 广告组）
-| 要求 | 细则 |
-| ---- | ---- |
-| 条数 | **每个** `ad-sets` 中花费 >0 的广告组 **各 1 段**（不得合并成 1 句带过） |
-| 字数 | 每段 **≥ 80 字** |
-| 必含 | 组名、花费占比或绝对值、线索数、`costPerResult`、频次；判断「曝光不足 / 频次过高 / 效率领先」 |
-| 数据依据 | `ad-sets-<id>.json` → `adGroups[]` |
+| 要求     | 细则                                                                                          |
+| -------- | --------------------------------------------------------------------------------------------- |
+| 条数     | **每个** `ad-sets` 中花费 >0 的广告组 **各 1 段**（不得合并成 1 句带过）                      |
+| 字数     | 每段 **≥ 80 字**                                                                              |
+| 必含     | 组名、花费占比或绝对值、线索数、`costPerResult`、频次；判断「曝光不足 / 频次过高 / 效率领先」 |
+| 数据依据 | `ad-sets-<id>.json` → `adGroups[]`                                                            |
 ### 3. `narrative.country`（国家报告）
-| 要求 | 细则 |
-| ---- | ---- |
-| 字数 | **≥ 80 字** |
-| 必含 | CPL **最低** 与 **最高** 国家名及具体 CPL；中间梯队 1～2 国；花费集中度 |
-| 数据依据 | `country-<id>.json` → `countries[]` |
+| 要求     | 细则                                                                    |
+| -------- | ----------------------------------------------------------------------- |
+| 字数     | **≥ 80 字**                                                             |
+| 必含     | CPL **最低** 与 **最高** 国家名及具体 CPL；中间梯队 1～2 国；花费集中度 |
+| 数据依据 | `country-<id>.json` → `countries[]`                                     |
 ### 4. `narrative.recommendations[]`（固定 4 条标题）
 **必须恰好 4 条**，`title` 仅限下表枚举；`content` 须**数据驱动**，不得模板空话。
-| title | content 最低要求（每条 **≥ 150 字**） |
-| ----- | ------------------------------------- |
-| **简化表单问题** | 结合 **高频次 + 高 CPL** 的国家/组（写出名称与数字）；建议字段从 N 减到 3；说明预期对 CPL 的影响 |
-| **区域调整** | 按 **具体广告组** 写语言/市场策略（如土/葡/德）；引用各组 CPL 对比；写清「加谁、减谁、暂停谁」 |
-| **预算重构** | 给出 **具体比例**（如 4:3:3 或按 spend 占比调整）；测试周期（7/14 天）；优胜劣汰阈值（CPL > 账户均值 ×1.2 则减 30%） |
-| **素材建议** | 按 **平台**（IG/FB）与 **国家** 分述；素材套数、视频时长、形态；至少点名 1 个高花费低结果创意/版位 |
+| title            | content 最低要求（每条 **≥ 150 字**）                                                                                |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------- |
+| **简化表单问题** | 结合 **高频次 + 高 CPL** 的国家/组（写出名称与数字）；建议字段从 N 减到 3；说明预期对 CPL 的影响                     |
+| **区域调整**     | 按 **具体广告组** 写语言/市场策略（如土/葡/德）；引用各组 CPL 对比；写清「加谁、减谁、暂停谁」                       |
+| **预算重构**     | 给出 **具体比例**（如 4:3:3 或按 spend 占比调整）；测试周期（7/14 天）；优胜劣汰阈值（CPL > 账户均值 ×1.2 则减 30%） |
+| **素材建议**     | 按 **平台**（IG/FB）与 **国家** 分述；素材套数、视频时长、形态；至少点名 1 个高花费低结果创意/版位                   |
 **建议前缀（对齐网站诊断）**：
-- 问题严重（CPL > 均值 1.3 倍、频次 >2.5、零成效花费 >$50）→ `content` 以 **「强烈建议：」** 开头
-- 其余优化项 → **「推荐优化：」** 开头
+- 问题严重（CPL > 均值 1.3 倍、频次 >2.5、零成效花费 >$50）→ `content` 以 **「强烈建议：」** 开头
+- 其余优化项 → **「推荐优化：」** 开头
 ---
@@ -81,15 +81,15 @@
 在 4 条固定标题之外，**必须**再写 **7 维清单**，每条 `{ "dimension", "issue", "suggestion" }`：
-| dimension | issue（发现了什么） | suggestion（怎么办） |
-| --------- | ------------------- | -------------------- |
-| 预算与广告组 | 点名高 `spendPercentage`、差 `costPerResult` 的组 | 降预算 %、暂停、或合并受众 |
-| 平台与版位 | `publisherPlatform` + `platformPosition` 组合 | 减投差版位、加码 winner 平台 |
-| 地域 | 高消耗低结果国家 | geo 排除 / 收窄 / 单独组 |
-| 受众 | 低效 age×gender | 排除或降 bid；扩量高效段 |
-| 创意 | 高花费低 `results` 的 ad | 关停、复制 winner 结构 |
-| 频次与疲劳 | `frequency` >2.5 且转化差 | 扩受众、换创意、降预算 |
-| 接口限制 | 无按日/关键词等 | 一句说明「Meta 接口未提供」，**禁止编造** |
+| dimension    | issue（发现了什么）                               | suggestion（怎么办）                      |
+| ------------ | ------------------------------------------------- | ----------------------------------------- |
+| 预算与广告组 | 点名高 `spendPercentage`、差 `costPerResult` 的组 | 降预算 %、暂停、或合并受众                |
+| 平台与版位   | `publisherPlatform` + `platformPosition` 组合     | 减投差版位、加码 winner 平台              |
+| 地域         | 高消耗低结果国家                                  | geo 排除 / 收窄 / 单独组                  |
+| 受众         | 低效 age×gender                                   | 排除或降 bid；扩量高效段                  |
+| 创意         | 高花费低 `results` 的 ad                          | 关停、复制 winner 结构                    |
+| 频次与疲劳   | `frequency` >2.5 且转化差                         | 扩受众、换创意、降预算                    |
+| 接口限制     | 无按日/关键词等                                   | 一句说明「Meta 接口未提供」，**禁止编造** |
 每条 `suggestion` **≥ 60 字**，须含 **至少 1 个当次数字或名称**。
@@ -102,10 +102,10 @@
 ```jsonc
 {
   "priorityPlan": {
-    "high": ["…", "…"],    // ≥2 条，本周必须做
-    "medium": ["…", "…"],  // ≥2 条
-    "low": ["…", "…"]      // ≥2 条，持续优化
-  }
+    "high": ["…", "…"], // ≥2 条，本周必须做
+    "medium": ["…", "…"], // ≥2 条
+    "low": ["…", "…"], // ≥2 条，持续优化
+  },
 }
 ```
@@ -117,21 +117,22 @@
 用户未指定 Excel 时，除 §一～§三外 **还必须** 填写：
-| 字段 | 最低要求 |
-| ---- | -------- |
-| `executiveSummary` | **3～5 段**，每段 **≥ 80 字**；解释「为什么」而不只报数；可拆自 `narrative.overall` 但须加深因果 |
-| `healthDiagnosis.lifecyclePhase` | `test-market` / `find-winner` / `scale` 三选一 |
-| `healthDiagnosis.lifecycleVerdict` | **≥ 60 字**，结合总花费与维度分散度 |
-| `healthDiagnosis.fourQuestions` | **恰好 4 张卡片**（钱花得值不值 / 赢在哪 / 输在哪 / 下月重点） |
-| 每张 `fourQuestions[]` | `verdict` + `evidence` **≥2 条**（含数字）+ `action` **≥ 40 字** |
-| `healthDiagnosis.scorecard` | **≥ 6 行**（平台、国家、广告组、受众等分项红绿灯） |
-| `sections.platform.insight` | **≥ 200 字** |
-| `sections.country.insight` | **≥ 200 字** |
-| `sections.adSets.insight` | **≥ 200 字** |
-| `sections.audience` | `goldenProfile` **≥3 条** + `antiProfile` **≥2 条** + `insight` **≥ 150 字** |
-| `sections.landingPage.rows` | **≥ 3 行**（心理阻碍 / 数据信号 / 推演 / 优先级） |
-| `abTests` | **≥ 3 个**实验（变量、假设、成功标准） |
-| `actionChecklist` | `today` **≥2**、`thisWeek` **≥3**、`thisMonth` **≥3** 条可执行项 |
+| 字段                               | 最低要求                                                                                                                                                                                   |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `executiveSummary`                 | **3～5 段**，每段 **≥ 80 字**；解释「为什么」而不只报数；可拆自 `narrative.overall` 但须加深因果                                                                                           |
+| `healthDiagnosis.lifecyclePhase`   | `test-market` / `find-winner` / `scale` 三选一。**可省略**：`render --snapshot-dir` 按花费与集中度自动推断；若手写须与数据一致（render 校验 `lifecyclePhase` vs `lifecyclePhaseInferred`） |
+| `healthDiagnosis.lifecycleVerdict` | **≥ 60 字**，结合总花费与维度分散度；可随 phase 由 CLI 补全                                                                                                                                |
+| **阶段判定（CLI 推断口径）**       | **测市场**：总花费 &lt; $200，或活跃维度 ≥4 且赢家花费占比 &lt;35%；**放量**：Top 广告组花费/结果占比 ≥55% 且 CPL ≤ 账户均值；**找赢家**：其余有优劣分化但未高度集中                       |
+| `healthDiagnosis.fourQuestions`    | **恰好 4 张卡片**（钱花得值不值 / 赢在哪 / 输在哪 / 下月重点）                                                                                                                             |
+| 每张 `fourQuestions[]`             | `verdict` + `evidence` **≥2 条**（含数字）+ `action` **≥ 40 字**                                                                                                                           |
+| `healthDiagnosis.scorecard`        | **≥ 6 行**有效行；每行须 `item` / `data` / `signal`(green\|yellow\|red) / `signalLabel` / `advice`。**可省略**：`render --snapshot-dir` 自动补全；render 校验行数与字段完整性              |
+| `sections.platform.insight`        | **≥ 200 字**                                                                                                                                                                               |
+| `sections.country.insight`         | **≥ 200 字**                                                                                                                                                                               |
+| `sections.adSets.insight`          | **≥ 200 字**                                                                                                                                                                               |
+| `sections.audience`                | `goldenProfile` **≥3 条** + `antiProfile` **≥2 条** + `insight` **≥ 150 字**                                                                                                               |
+| `sections.landingPage.rows`        | **≥ 3 行**（心理阻碍 / 数据信号 / 推演 / 优先级）                                                                                                                                          |
+| `abTests`                          | **≥ 3 个**实验（变量、假设、成功标准）                                                                                                                                                     |
+| `actionChecklist`                  | `today` **≥2**、`thisWeek` **≥3**、`thisMonth` **≥3** 条可执行项                                                                                                                           |
 **禁止**：HTML 中大量「（待 Agent 撰写）」占位；交付前 Read HTML 确认无空节。
@@ -152,7 +153,7 @@
 - [ ] `narrative.recommendations` 4 条，每条 content ≥150 字且含真实数字
 - [ ] `supplementaryRecommendations` 7 维齐全
 - [ ] `priorityPlan` high/medium/low 各 ≥2 条
-- [ ] HTML：`executiveSummary` ≥3 段、`fourQuestions` =4、`scorecard` ≥6 行
+- [ ] HTML：`executiveSummary` ≥3 段、`fourQuestions` =4、`lifecyclePhase` 与快照推断一致（或省略由 CLI 补全）、`scorecard` ≥6 行且每行五字段齐全
 - [ ] HTML：`sections.platform/country/adSets.insight` 各 ≥200 字
 - [ ] HTML：`actionChecklist` 三列非空；`abTests` ≥3
 - [ ] Excel：总数据 Sheet 叙事块 4 节齐全，无 1 句话敷衍

package/dist/skill/assets/pmax-asset-group-template.json CHANGED Viewed

@@ -1,16 +1,24 @@
 {
-  "_comment": "追加 PMax 资产组：POST .../campaign/pmax/{campaignId}/asset-group",
+  "_meta": {
+    "schema": "pmax-asset-group/v2",
+    "doc": "pmax-asset-group-template.md",
+    "note": "POST .../campaign/pmax/{campaignId}/asset-group",
+    "agentPitfalls": [
+      "提交前 CLI 自动 GET 活动详情判断 Brand Guidelines",
+      "BG 生效（_brandGuidelinesActive=true）时 businessName/Logo 可省略，CLI 自动剔除",
+      "BG 未生效时 businessName + Logo 必填",
+      "勿在 BG 生效后对 AG 用 pmax-assets-update 改 BUSINESS_NAME/LOGO"
+    ]
+  },
   "account": "6326027735",
   "campaignId": "12345678901",
   "name": "AG-Second",
   "finalUrls": ["https://www.example.com/landing"],
-  "businessName": "Test Brand Co",
   "headlines": ["Headline one ok", "Headline two ok", "Headline three ok"],
   "longHeadlines": ["Long headline for performance max"],
   "descriptions": ["Description one ok", "Description two ok"],
   "imagePaths": {
     "marketing": "./images/marketing.jpg",
-    "square": "./images/square.jpg",
-    "logo": "./images/logo.png"
+    "square": "./images/square.jpg"
   }
 }

package/dist/skill/assets/pmax-asset-group-template.md ADDED Viewed

@@ -0,0 +1,25 @@
+# `ad pmax-asset-group-create` JSON
+在同一 PMax 活动下追加资产组。
+```bash
+siluzan-tso ad pmax-get -a <accountId> --campaign-id <cid> --json-out ./snap
+siluzan-tso ad pmax-asset-group-create --config-file ./ag.json --json-out ./snap
+```
+模板：[`pmax-asset-group-template.json`](pmax-asset-group-template.json)
+## Brand Guidelines 分支（Agent 必读）
+CLI **自动** GET 活动详情，无需手填开关：
+| `_brandGuidelinesActive`（来自 pmax-get） | JSON 要求                                                               |
+| ----------------------------------------- | ----------------------------------------------------------------------- |
+| `true`                                    | **省略** `businessName`、`logoImage*`、`imagePaths.logo`（仅横图+方图） |
+| `false`                                   | **必填** `businessName` + Logo（三图齐全）                              |
+若 JSON 在 BG 生效时仍含品牌字段，CLI 会警告并忽略（不阻断）。
+## 字段
+与 `pmax-create` 资产组部分相同（`name`、`finalUrls`、标题/描述、营销图）。`campaignId` 必填。

package/dist/skill/assets/pmax-brand-assets-template.json ADDED Viewed

@@ -0,0 +1,25 @@
+{
+  "_meta": {
+    "schema": "pmax-brand-assets/v1",
+    "doc": "pmax-brand-assets-template.md",
+    "note": "PATCH .../campaign/pmax/{campaignId}/brand-assets；Brand Guidelines 已开启时使用",
+    "agentPitfalls": [
+      "须先 ad pmax-get 确认 _brandGuidelinesActive=true",
+      "BG 生效时勿用 pmax-assets-update 改 BUSINESS_NAME/LOGO（会 400）",
+      "至少传一项：businessName、logoImage*、landscapeLogoImage* 或 brandGuidelines",
+      "mainColor 与 accentColor 须成对",
+      "Logo 可填 imagePaths.logo，CLI 自动上传"
+    ]
+  },
+  "account": "REPLACE_mediaCustomerId",
+  "campaignId": "REPLACE_campaignId",
+  "businessName": "Renamed Brand Co",
+  "imagePaths": {
+    "logo": "./REPLACE_logo_1200x1200.png"
+  },
+  "brandGuidelines": {
+    "mainColor": "#112233",
+    "accentColor": "#445566",
+    "predefinedFontFamily": "Roboto"
+  }
+}

package/dist/skill/assets/pmax-brand-assets-template.md ADDED Viewed

@@ -0,0 +1,22 @@
+# `ad pmax-brand-assets-edit` PATCH JSON
+Brand Guidelines（BG）**已开启**时，改商家名 / Logo / 主色字体走 Campaign 级接口。
+```bash
+siluzan-tso ad pmax-get -a <accountId> --campaign-id <cid> --json-out ./snap
+# 确认 _brandGuidelinesActive === true 后：
+siluzan-tso ad pmax-brand-assets-edit -a <accountId> --campaign-id <cid> \
+  --patch-file ./brand-patch.json --json-out ./snap
+```
+模板：[`pmax-brand-assets-template.json`](pmax-brand-assets-template.json)
+| 字段                                                                                  | 说明               |
+| ------------------------------------------------------------------------------------- | ------------------ |
+| `businessName`                                                                        | 商家名（≤25 字符） |
+| `logoImageAssetId` / `logoImageBase64` / `imagePaths.logo`                            | Logo 三选一        |
+| `landscapeLogoImageAssetId` / `landscapeLogoImageBase64` / `imagePaths.landscapeLogo` | 可选横版 Logo      |
+| `brandGuidelines.mainColor` / `accentColor`                                           | 须成对             |
+| `brandGuidelines.predefinedFontFamily`                                                | 如 `Roboto`        |
+**至少传一项**。改完后 `ad pmax-get` 刷新，品牌读 `brandAssets[]`。

package/dist/skill/assets/pmax-brand-guidelines-enable-template.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "_meta": {
+    "schema": "pmax-brand-guidelines-enable/v1",
+    "doc": "pmax-brand-guidelines-enable-template.md",
+    "note": "POST .../campaign/pmax/{campaignId}/brand-guidelines/enable；启用后不可关闭",
+    "agentPitfalls": [
+      "仅当 pmax-get 显示 _brandGuidelinesActive=false 时使用",
+      "autoPopulateBrandAssets=true 时可省略 businessName/Logo（Google 自动选）",
+      "Travel Goals PMax 不支持 BG",
+      "启用成功后改品牌走 ad pmax-brand-assets-edit"
+    ]
+  },
+  "account": "REPLACE_mediaCustomerId",
+  "campaignId": "REPLACE_campaignId",
+  "autoPopulateBrandAssets": false,
+  "businessName": "Example Brand Co",
+  "imagePaths": {
+    "logo": "./REPLACE_logo_1200x1200.png"
+  },
+  "brandGuidelines": {
+    "mainColor": "#112233",
+    "accentColor": "#445566"
+  }
+}

package/dist/skill/assets/pmax-brand-guidelines-enable-template.md ADDED Viewed

@@ -0,0 +1,22 @@
+# `ad pmax-brand-guidelines-enable` JSON
+存量 PMax 活动启用 Brand Guidelines（**不可关闭**）。
+```bash
+siluzan-tso ad pmax-get -a <accountId> --campaign-id <cid> --json-out ./snap
+# _brandGuidelinesActive === false 时：
+siluzan-tso ad pmax-brand-guidelines-enable --config-file ./enable-bg.json --json-out ./snap
+```
+模板：[`pmax-brand-guidelines-enable-template.json`](pmax-brand-guidelines-enable-template.json)
+| 字段                      | 必填 | 说明                                                           |
+| ------------------------- | :--: | -------------------------------------------------------------- |
+| `account`                 |  ✅  | 媒体客户 ID                                                    |
+| `campaignId`              |  ✅  | 活动 ID                                                        |
+| `autoPopulateBrandAssets` |      | 默认 `false`；`true` 时 Google 自动选品牌资产                  |
+| `businessName`            | 条件 | `autoPopulateBrandAssets=false` 时必填                         |
+| Logo 相关                 | 条件 | `autoPopulateBrandAssets=false` 时必填（同 brand-assets 模板） |
+| `brandGuidelines`         |      | 可选样式                                                       |
+启用后：`pmax-asset-group-create` 可省略 `businessName`/Logo；改品牌用 `pmax-brand-assets-edit`。

package/dist/skill/assets/pmax-create-template.json CHANGED Viewed

@@ -7,8 +7,16 @@
       "勿与 Search campaign-create-template.json 混用（PMax 走 POST .../campaign/pmax，非 batch-asyncs）",
       "budget / targetCpa_BidingAmount 填主币种「元」，CLI 提交前 ×100 转 API 整型",
       "三张图：只填 imagePaths（pmax-create 会自动上传为 assetId）；勿把 Base64 写入 JSON",
+      "brandGuidelinesEnabled 省略时网关默认 true（Google v21+）；品牌在 Campaign 级 brandAssets[]，首个 AG 不含 Logo/商家名",
+      "改已上线品牌：先 pmax-get 看 _brandGuidelinesActive；true 用 pmax-brand-assets-edit，false 用 pmax-assets-update 或 pmax-brand-guidelines-enable",
       "本地视频：填 videoPath（或别名 video）；创建后 CLI 自动 PyAPI 上传并链接，与 --json-out 无关",
-      "提交前：ad pmax-validate → 用户确认 → ad pmax-create"
+      "提交前：ad pmax-validate → 用户确认 → ad pmax-create",
+      "campaignExtensions 默认必填：宣传信息≥20、结构化摘要≥20、站内链接≥6、leadForm、businessMessage",
+      "文案门禁：headlines 15、longHeadlines 5（Google 上限须填满）、descriptions 5",
+      "勿用 Search 的 ExtensionsForBatchJob；PMax 用 campaignExtensions（CLI 会尝试自动转换 CALLOUT/SNIPPET）",
+      "Lead Gen/B2B 询盘方案：默认保留 campaignExtensions.leadForm（勿只写 callouts/snippets）；用户明确不要表单才删 leadForm",
+      "方案 Markdown 须单列「潜在客户表单」节（标题/描述/字段/privacyPolicyUrl）；与 JSON 一致",
+      "不需要任何附加资产时设 skipCampaignExtensions: true（勿仅删除 campaignExtensions 块）"
     ]
   },
@@ -38,5 +46,36 @@
   "targetedLanguages": [{ "id": 1000 }],
   "biddingStrategyTypeV2": "MAXIMIZE_CONVERSIONS",
   "targetCpa_BidingAmount": 0,
-  "targetRoas": 0
+  "targetRoas": 0,
+  "campaignExtensions": {
+    "callouts": ["Free shipping", "24/7 support"],
+    "structuredSnippets": [
+      {
+        "header": "Services",
+        "values": ["Design", "Install", "Support"]
+      }
+    ],
+    "leadForm": {
+      "businessName": "Example Brand Co",
+      "headline": "Get a free quote",
+      "description": "Tell us about your project.",
+      "privacyPolicyUrl": "https://www.example.com/privacy",
+      "finalUrl": "https://www.example.com",
+      "fields": [
+        { "inputType": "FULL_NAME" },
+        { "inputType": "EMAIL" },
+        { "inputType": "PHONE_NUMBER" }
+      ]
+    },
+    "businessMessage": {
+      "starterMessage": "Hi! How can we help you today?",
+      "callToActionSelection": "CONTACT_US",
+      "callToActionDescription": "Message us on WhatsApp",
+      "whatsapp": {
+        "countryCode": "US",
+        "phoneNumber": "2125550100"
+      }
+    }
+  }
 }