siluzan-tso-cli 1.1.59-beta.2 → 1.1.59-beta.3

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.59-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.59-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -2570,7 +2570,9 @@ function buildAuthHeaders(config) {
 }
 async function parseApiResponse(status, text3, verbose) {
   if (status < 200 || status >= 300) {
-    throw new Error(formatHttpError(status, text3, { verbose }));
+    const err = new Error(formatHttpError(status, text3, { verbose }));
+    Object.assign(err, { status, rawBody: text3 });
+    throw err;
   }
   if (!text3.trim()) return null;
   try {
@@ -6434,7 +6436,8 @@ var init_wrap_snapshot_envelope = __esm({
     ]);
     GATEWAY_LIST_SECTIONS = /* @__PURE__ */ new Set([
       "search-terms",
-      "ads"
+      "ads",
+      "negative-keywords"
     ]);
   }
 });
@@ -7670,6 +7673,12 @@ var init_sections = __esm({
         defaultQuery: { limit: 0, orderByCost: true, costGreater: 0 },
         keywordOptions: true
       },
+      {
+        name: "negative-keywords",
+        description: "\u5F53\u524D\u8D26\u6237\u5426\u8BCD negativekeywordmanagement/v2/list\uFF08\u7CFB\u5217/\u5E7F\u544A\u7EC4/\u8D26\u6237\u4E09\u7EA7\uFF1B\u540D\u5355\u4E0D\u6309\u6D88\u8017\u8FC7\u6EE4\uFF0C0 \u6761\u4E5F\u843D\u76D8\uFF09",
+        dateMode: "range",
+        path: (id) => `/negativekeywordmanagement/v2/list/${id}`
+      },
       {
         name: "search-terms",
         description: "\u641C\u7D22\u8BCD searchtermmanagement/v2/list\uFF08\u9ED8\u8BA4 limit=0 \u4E0D\u5C01\u9876\uFF0CCLI \u843D\u76D8\u524D\u8FC7\u6EE4 spend>0\uFF09",
@@ -103462,6 +103471,8 @@ async function fetchGoogleAnalysisSectionJson(config, fullPath, verbose, name2,
       return fetchSection();
     case "keywords":
       return fetchSection();
+    case "negative-keywords":
+      return fetchSection();
     case "search-terms":
       return fetchSection();
     case "campaigns":
@@ -103867,6 +103878,37 @@ async function loadSectionFile(snapshotDir, file) {
     return null;
   }
 }
+function negativeKeywordText(row) {
+  const text3 = row.keywordText;
+  if (Array.isArray(text3)) {
+    const parts = text3.map((part) => String(part).trim()).filter(Boolean);
+    if (parts.length > 0) return parts.join(", ");
+  }
+  if (typeof text3 === "string" && text3.trim()) return text3.trim();
+  if (typeof row.keyword === "string" && row.keyword.trim()) return row.keyword.trim();
+  return "\u2014";
+}
+function mapNegativeKeywordRows(rows) {
+  const seen = /* @__PURE__ */ new Set();
+  const mapped = [];
+  for (const row of rows) {
+    const id = row.id == null ? "" : String(row.id);
+    if (id && seen.has(id)) continue;
+    if (id) seen.add(id);
+    const level = String(row.negativeLevel ?? "").trim();
+    const campaignName = String(row.campaignName ?? "").trim();
+    const adGroupName = String(row.adGroupName ?? "").trim();
+    mapped.push({
+      keyword: negativeKeywordText(row),
+      matchType: String(row.matchTypeV2 ?? row.matchType ?? "\u2014"),
+      level: level || "\u2014",
+      levelZh: NEGATIVE_LEVEL_ZH[level] ?? (level || "\u2014"),
+      campaignName: campaignName || "\u2014",
+      adGroupName: adGroupName || "\u2014"
+    });
+  }
+  return mapped;
+}
 function dateTagFromRange(dateRange) {
   if (!dateRange || dateRange.mode !== "range") return void 0;
   return `${dateRange.start.replace(/-/g, "")}-${dateRange.end.replace(/-/g, "")}`;
@@ -104095,6 +104137,9 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
       );
     }
   }
+  if (sectionMap.has("negative-keywords")) {
+    tables.negativeKeywords = mapNegativeKeywordRows(items(sectionMap.get("negative-keywords")));
+  }
   return {
     ...payload,
     meta,
@@ -104103,7 +104148,7 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     tables
   };
 }
-var REPORT_MERGE_SECTIONS;
+var REPORT_MERGE_SECTIONS, NEGATIVE_LEVEL_ZH;
 var init_merge_snapshot = __esm({
   "src/commands/google-analysis/merge-snapshot.ts"() {
     "use strict";
@@ -104116,8 +104161,15 @@ var init_merge_snapshot = __esm({
       "devices",
       "geographic",
       "audience",
-      "keywords"
+      "keywords",
+      "negative-keywords"
     ];
+    NEGATIVE_LEVEL_ZH = {
+      Account: "\u8D26\u6237",
+      Campaign: "\u7CFB\u5217",
+      AdGroup: "\u5E7F\u544A\u7EC4",
+      "Ad group": "\u5E7F\u544A\u7EC4"
+    };
   }
 });
 
@@ -104992,6 +105044,16 @@ function validateGooglePeriodReportContent(data) {
       "\u81F3\u5C11\u4E00\u9879\u987B\u4E3A\u6709\u6548\u6570\u5B57\uFF1B\u8BF7\u52A0 --snapshot-dir \u4ECE google-analysis \u5FEB\u7167\u5408\u5E76\uFF08\u52FF\u624B\u586B HTML\uFF09"
     );
   }
+  const negativeRows = asRecord22(data.tables)?.negativeKeywords;
+  if (!Array.isArray(negativeRows)) {
+    pushMissing2(
+      missing,
+      "tables-negative-keywords",
+      "\u2468\u5426\u8BCD",
+      "tables.negativeKeywords",
+      "\u987B\u4E3A\u6570\u7EC4\uFF080 \u6761\u4E5F\u8981\u662F []\uFF09\u3002\u9ED8\u8BA4\u62C9\u6570\u52A0\u4E0A --sections negative-keywords\uFF0Crender \u5E26 --snapshot-dir"
+    );
+  }
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS) {
@@ -105028,7 +105090,7 @@ function validateGooglePeriodReportContent(data) {
     pushMissing2(
       missing,
       "narrative-recommendations",
-      "\u2468\u4F18\u5316\u5EFA\u8BAE",
+      "\u2469\u4F18\u5316\u5EFA\u8BAE",
       "narrative.recommendations",
       `\u22653 \u6761\u8DE8\u7EF4\u5EA6\u4F18\u5316\u5EFA\u8BAE\uFF08\u5F53\u524D ${recommendations.length} \u6761\uFF09`
     );
@@ -105067,7 +105129,8 @@ var init_report_content = __esm({
       "devices",
       "geographic",
       "audience",
-      "keywords"
+      "keywords",
+      "negativeKeywords"
     ];
     SECTION_LABELS = {
       overview: "\u2460\u6267\u884C\u6458\u8981",
@@ -105077,7 +105140,8 @@ var init_report_content = __esm({
       devices: "\u2464\u8BBE\u5907\u5206\u5E03",
       geographic: "\u2465\u5730\u57DF\u5206\u5E03",
       audience: "\u2466\u53D7\u4F17\u5206\u5E03",
-      keywords: "\u2467\u5173\u952E\u8BCD\u8868\u73B0"
+      keywords: "\u2467\u5173\u952E\u8BCD\u8868\u73B0",
+      negativeKeywords: "\u2468\u5426\u8BCD"
     };
   }
 });
@@ -105165,7 +105229,7 @@ async function runGoogleAnalysisRender(opts) {
 \u2705 Google Ads ${cover}\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
 `);
   console.log(
-    `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u6267\u884C\u6458\u8981 ${stats.executiveSummaryCount} \u6BB5\uFF5C\u4F18\u5316\u5EFA\u8BAE ${stats.recommendationCount} \u6761\uFF5C8 \u4E2A\u6570\u636E\u7EF4\u5206\u6790+\u5EFA\u8BAE\u5747\u5DF2\u9F50\u5168
+    `   \u5FC5\u542B\u5B57\u6BB5\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C\u6267\u884C\u6458\u8981 ${stats.executiveSummaryCount} \u6BB5\uFF5C\u4F18\u5316\u5EFA\u8BAE ${stats.recommendationCount} \u6761\uFF5C9 \u4E2A\u6570\u636E\u7EF4\u5206\u6790+\u5EFA\u8BAE\u5747\u5DF2\u9F50\u5168
 `
   );
   console.log(
@@ -122330,6 +122394,119 @@ function assertPmaxImageSlotsResolved(slots, requiredKinds = ["marketing", "squa
 import { readFileSync as readFileSync11 } from "fs";
 init_shared();
 
+// src/commands/ad/pmax-create-http-error.ts
+function normalizePmaxResumeId(value) {
+  if (value == null) return null;
+  const text3 = String(value).trim();
+  if (!text3 || text3.toLowerCase() === "null") return null;
+  return text3;
+}
+function quoteLongResumeIds(rawBody) {
+  return rawBody.replace(
+    /"(budgetId|campaignId|assetGroupId)"\s*:\s*(-?\d+)/g,
+    '"$1":"$2"'
+  );
+}
+function parsePmaxCreateFailureBody(rawBody) {
+  const text3 = rawBody.trim();
+  if (!text3.startsWith("{")) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(quoteLongResumeIds(text3));
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const rec = parsed;
+  if (typeof rec["message"] !== "string" || !rec["message"].trim()) return null;
+  if (!("budgetId" in rec) && !("campaignId" in rec) && !("assetGroupId" in rec)) return null;
+  return {
+    message: rec["message"].trim(),
+    budgetId: normalizePmaxResumeId(rec["budgetId"]),
+    campaignId: normalizePmaxResumeId(rec["campaignId"]),
+    assetGroupId: normalizePmaxResumeId(rec["assetGroupId"])
+  };
+}
+function readHttpRawBody(err) {
+  if (!err || typeof err !== "object" || !("rawBody" in err)) return "";
+  const raw = err.rawBody;
+  return typeof raw === "string" ? raw : "";
+}
+function sameResumeId(left, right) {
+  const a = left?.trim() || null;
+  const b = right?.trim() || null;
+  return a === b;
+}
+function pmaxCreateRetryAdvice(requested, failure) {
+  const got = [failure.budgetId, failure.campaignId, failure.assetGroupId];
+  if (!got.some(Boolean)) return "fix-without-ids";
+  const sent = [
+    normalizePmaxResumeId(requested.budgetId),
+    normalizePmaxResumeId(requested.campaignId),
+    normalizePmaxResumeId(requested.assetGroupId)
+  ];
+  if (sent.every((id, index) => sameResumeId(id, got[index]))) return "stop-same-step";
+  for (let index = 0; index < sent.length; index++) {
+    const previous = sent[index]?.trim() || null;
+    if (previous && previous !== got[index]) return "stop-same-step";
+  }
+  return "resume";
+}
+function pmaxCreateResumeError(cfg) {
+  const budgetId = normalizePmaxResumeId(cfg.budgetId) ?? "";
+  const campaignId = normalizePmaxResumeId(cfg.campaignId) ?? "";
+  const assetGroupId = normalizePmaxResumeId(cfg.assetGroupId) ?? "";
+  if (campaignId && !budgetId) return "BudgetId is required when CampaignId is provided.";
+  if (assetGroupId && (!budgetId || !campaignId)) {
+    return "CampaignId is required when AssetGroupId is provided.";
+  }
+  const brandGuidelinesOn = cfg.brandGuidelinesEnabled !== false;
+  if (brandGuidelinesOn && campaignId && !assetGroupId) {
+    return "AssetGroupId is required when CampaignId is provided and brand guidelines are enabled.";
+  }
+  return null;
+}
+function classifyPmaxCreateHttpError(raw) {
+  const msg = raw.trim() || "\u672A\u77E5\u9519\u8BEF";
+  const lower = msg.toLowerCase();
+  const hints = [];
+  if (/^HTTP 400\b/i.test(msg) || lower.includes("bad request")) {
+    if (/budget|日预算|budgetamount|micros/i.test(msg)) {
+      hints.push("\u68C0\u67E5 campaign.budget / \u65E5\u9884\u7B97\u91D1\u989D\u4E0E\u5E01\u79CD\u662F\u5426\u5408\u7406");
+    }
+    if (/bidding|target.?cpa|target.?roas|maximize|出价/i.test(msg)) {
+      hints.push("\u68C0\u67E5 BiddingStrategyTypeV2 \u4E0E\u914D\u5957\u91D1\u989D\u5B57\u6BB5\uFF08tCPA/tROAS\uFF09\u662F\u5426\u9F50\u5168\u4E14\u517C\u5BB9");
+    }
+    if (/image|asset|marketing|logo|图片/i.test(msg)) {
+      hints.push("\u68C0\u67E5\u6A2A\u56FE/\u65B9\u56FE/Logo \u662F\u5426\u5DF2\u4E0A\u4F20\u6210\u529F\u3001\u89C4\u683C\u662F\u5426\u8FBE\u6807\uFF08\u5148\u8DD1 ad pmax-validate\uFF09");
+    }
+    if (/final.?url|landing|落地页|url/i.test(msg)) {
+      hints.push("\u68C0\u67E5 finalUrls \u662F\u5426\u4E3A\u53EF\u8BBF\u95EE\u7684 http(s) \u843D\u5730\u9875");
+    }
+    if (/name|duplicate|已存在|同名/i.test(msg)) {
+      hints.push("\u7CFB\u5217\u540D\u53EF\u80FD\u91CD\u590D\uFF1B\u6362\u4E00\u4E2A name \u518D\u8BD5");
+    }
+    if (/geo|location|language|地域|语言/i.test(msg)) {
+      hints.push("\u68C0\u67E5 geo / language id \u662F\u5426\u6765\u81EA ad geo resolve / \u6587\u6863\u679A\u4E3E");
+    }
+    if (hints.length === 0) {
+      hints.push(
+        "\u5E38\u89C1\uFF1A\u9884\u7B97/\u51FA\u4EF7\u4E0D\u517C\u5BB9\u3001\u56FE\u7247\u8D44\u4EA7\u65E0\u6548\u3001finalUrl \u65E0\u6548\u3001\u7CFB\u5217\u91CD\u540D\uFF1B\u5148 ad pmax-validate\uFF0C\u4ECD\u5931\u8D25\u52A0 --verbose \u770B\u7F51\u5173\u539F\u6587"
+      );
+    }
+  } else if (/^HTTP 403\b/i.test(msg)) {
+    hints.push("\u8D26\u6237\u53EF\u80FD\u65E0\u6743\u521B\u5EFA\uFF1B\u5148 account check-access -a <id>\uFF0C\u786E\u8BA4\u5728\u5F53\u524D\u4E1D\u8DEF\u8D5E\u8D26\u53F7\u4E0B");
+  } else if (/^HTTP 401\b/i.test(msg)) {
+    hints.push("\u9274\u6743\u5931\u6548\uFF1B\u6267\u884C siluzan-tso login \u540E\u91CD\u8BD5");
+  }
+  if (hints.length === 0) return msg;
+  return `${msg}
+   \u63D0\u793A\uFF1A${hints.join("\uFF1B")}`;
+}
+function pmaxCreateFollowUpFailed(input) {
+  return Boolean(input.uploadError || input.linkError || input.extensionsAllOk === false);
+}
+
 // src/commands/ad/pmax-campaign-extensions.ts
 init_auth();
 var PMAX_POLICY_CALLOUT_MIN = 20;
@@ -122912,7 +123089,12 @@ function parseLocationLanguageIds(items3) {
     id: Number(item.id)
   }));
 }
+function trimmedId(value) {
+  return normalizePmaxResumeId(value) ?? void 0;
+}
 function buildPmaxCreateApiBody(cfg, imageSlots) {
+  const resumeError = pmaxCreateResumeError(cfg);
+  if (resumeError) throw new Error(resumeError);
   assertPmaxImageSlotsResolved(imageSlots);
   const body = {
     name: cfg.name.trim(),
@@ -122943,6 +123125,12 @@ function buildPmaxCreateApiBody(cfg, imageSlots) {
   if (cfg.brandGuidelinesEnabled !== void 0) {
     body.brandGuidelinesEnabled = cfg.brandGuidelinesEnabled;
   }
+  const budgetId = trimmedId(cfg.budgetId);
+  const campaignId = trimmedId(cfg.campaignId);
+  const assetGroupId = trimmedId(cfg.assetGroupId);
+  if (budgetId) body.budgetId = budgetId;
+  if (campaignId) body.campaignId = campaignId;
+  if (assetGroupId) body.assetGroupId = assetGroupId;
   return body;
 }
 function buildPmaxCreateUrl(googleApiUrl, accountId) {
@@ -123344,51 +123532,13 @@ async function linkPmaxVideoAfterCreate(opts) {
   }
 }
 
-// src/commands/ad/pmax-create-http-error.ts
-function classifyPmaxCreateHttpError(raw) {
-  const msg = raw.trim() || "\u672A\u77E5\u9519\u8BEF";
-  const lower = msg.toLowerCase();
-  const hints = [];
-  if (/^HTTP 400\b/i.test(msg) || lower.includes("bad request")) {
-    if (/budget|日预算|budgetamount|micros/i.test(msg)) {
-      hints.push("\u68C0\u67E5 campaign.budget / \u65E5\u9884\u7B97\u91D1\u989D\u4E0E\u5E01\u79CD\u662F\u5426\u5408\u7406");
-    }
-    if (/bidding|target.?cpa|target.?roas|maximize|出价/i.test(msg)) {
-      hints.push("\u68C0\u67E5 BiddingStrategyTypeV2 \u4E0E\u914D\u5957\u91D1\u989D\u5B57\u6BB5\uFF08tCPA/tROAS\uFF09\u662F\u5426\u9F50\u5168\u4E14\u517C\u5BB9");
-    }
-    if (/image|asset|marketing|logo|图片/i.test(msg)) {
-      hints.push("\u68C0\u67E5\u6A2A\u56FE/\u65B9\u56FE/Logo \u662F\u5426\u5DF2\u4E0A\u4F20\u6210\u529F\u3001\u89C4\u683C\u662F\u5426\u8FBE\u6807\uFF08\u5148\u8DD1 ad pmax-validate\uFF09");
-    }
-    if (/final.?url|landing|落地页|url/i.test(msg)) {
-      hints.push("\u68C0\u67E5 finalUrls \u662F\u5426\u4E3A\u53EF\u8BBF\u95EE\u7684 http(s) \u843D\u5730\u9875");
-    }
-    if (/name|duplicate|已存在|同名/i.test(msg)) {
-      hints.push("\u7CFB\u5217\u540D\u53EF\u80FD\u91CD\u590D\uFF1B\u6362\u4E00\u4E2A name \u518D\u8BD5");
-    }
-    if (/geo|location|language|地域|语言/i.test(msg)) {
-      hints.push("\u68C0\u67E5 geo / language id \u662F\u5426\u6765\u81EA ad geo resolve / \u6587\u6863\u679A\u4E3E");
-    }
-    if (hints.length === 0) {
-      hints.push(
-        "\u5E38\u89C1\uFF1A\u9884\u7B97/\u51FA\u4EF7\u4E0D\u517C\u5BB9\u3001\u56FE\u7247\u8D44\u4EA7\u65E0\u6548\u3001finalUrl \u65E0\u6548\u3001\u7CFB\u5217\u91CD\u540D\uFF1B\u5148 ad pmax-validate\uFF0C\u4ECD\u5931\u8D25\u52A0 --verbose \u770B\u7F51\u5173\u539F\u6587"
-      );
-    }
-  } else if (/^HTTP 403\b/i.test(msg)) {
-    hints.push("\u8D26\u6237\u53EF\u80FD\u65E0\u6743\u521B\u5EFA\uFF1B\u5148 account check-access -a <id>\uFF0C\u786E\u8BA4\u5728\u5F53\u524D\u4E1D\u8DEF\u8D5E\u8D26\u53F7\u4E0B");
-  } else if (/^HTTP 401\b/i.test(msg)) {
-    hints.push("\u9274\u6743\u5931\u6548\uFF1B\u6267\u884C siluzan-tso login \u540E\u91CD\u8BD5");
-  }
-  if (hints.length === 0) return msg;
-  return `${msg}
-   \u63D0\u793A\uFF1A${hints.join("\uFF1B")}`;
-}
-
 // src/commands/ad/pmax-create.ts
 function printVideoLinkRecoveryHint(accountId, assetGroupId, campaignId, youtubeTarget) {
   const cid = campaignId != null ? ` --campaign-id ${campaignId}` : "";
   const yt = youtubeTarget ? ` --youtube "${youtubeTarget}"` : ` --video-path "<path>"`;
   console.error(
     `   \u53EF\u624B\u52A8\uFF1Asiluzan-tso ad pmax-youtube-link -a ${accountId} --asset-group-id ${assetGroupId}${cid}${yt}
+   \u6D3B\u52A8\u5DF2\u7ECF\u521B\u5EFA\u6210\u529F\uFF0C\u4E0D\u8981\u518D\u6267\u884C pmax-create\u3002
 `
   );
 }
@@ -123471,6 +123621,39 @@ async function runAdPmaxCreate(opts) {
       opts.verbose
     );
   } catch (err) {
+    const failure = parsePmaxCreateFailureBody(readHttpRawBody(err));
+    if (failure) {
+      const advice = pmaxCreateRetryAdvice(cfg, failure);
+      console.error(`
+\u274C \u521B\u5EFA PMax \u5E7F\u544A\u7CFB\u5217\u5931\u8D25\uFF1A${failure.message}`);
+      console.error(`   budgetId\uFF1A${failure.budgetId ?? "null"}`);
+      console.error(`   campaignId\uFF1A${failure.campaignId ?? "null"}`);
+      console.error(`   assetGroupId\uFF1A${failure.assetGroupId ?? "null"}`);
+      if (advice === "resume") {
+        console.error(
+          "   \u7EED\u8DD1\uFF1A\u628A\u975E\u7A7A\u7F16\u53F7\u6309\u540C\u540D\u5199\u56DE\u8FD9\u4EFD JSON\uFF0C\u5176\u4F59\u5185\u5BB9\u4E0D\u8981\u6539\uFF0C\u518D\u6267\u884C\u4E00\u6B21 pmax-create\u3002\u7F16\u53F7\u6309\u9884\u7B97\u3001\u7CFB\u5217\u3001\u7D20\u6750\u7EC4\u5E26\u3002\u540C\u4E00\u6B65\u518D\u5931\u8D25\u5C31\u505C\u3002\n"
+        );
+      } else if (advice === "stop-same-step") {
+        console.error("   \u540C\u4E00\u6B65\u518D\u5931\u8D25\uFF0C\u505C\u6B62\u3002\u4E0D\u8981\u518D\u6267\u884C pmax-create\u3002\n");
+      } else {
+        console.error("   \u8FD9\u6B21\u8FD8\u6CA1\u6709\u5EFA\u6210\u9884\u7B97\u3001\u7CFB\u5217\u6216\u7D20\u6750\u7EC4\u3002\u4FEE\u6B63\u539F\u56E0\u540E\u7528\u539F JSON \u518D\u63D0\u4EA4\uFF0C\u4E0D\u8981\u586B\u8FD9\u4E09\u4E2A\u7F16\u53F7\u3002\n");
+      }
+      await emitCliJsonOrSnapshot(opts, {
+        section: `ad-pmax-create-${accountId}`,
+        commandLabel: "ad pmax-create",
+        commandHint: accountId,
+        payload: { ok: false, retryCreate: advice === "resume", ...failure },
+        idSuffix: accountId,
+        summaryExtras: {
+          ok: false,
+          retryCreate: advice === "resume",
+          budgetId: failure.budgetId,
+          campaignId: failure.campaignId,
+          assetGroupId: failure.assetGroupId
+        }
+      });
+      process.exit(1);
+    }
     const raw = err instanceof Error ? err.message : String(err);
     console.error(`
 \u274C \u521B\u5EFA PMax \u5E7F\u544A\u7CFB\u5217\u5931\u8D25\uFF1A${classifyPmaxCreateHttpError(raw)}
@@ -123534,6 +123717,7 @@ async function runAdPmaxCreate(opts) {
         void 0
       );
     }
+    console.error("   \u6D3B\u52A8\u5DF2\u7ECF\u521B\u5EFA\u6210\u529F\uFF0C\u4E0D\u8981\u518D\u6267\u884C pmax-create\u3002\n");
   } else if (videoResult.linkError) {
     console.error(`
 \u26A0\uFE0F  \u6D3B\u52A8\u5DF2\u521B\u5EFA\uFF0C\u4F46 YouTube \u94FE\u63A5\u5931\u8D25\uFF1A${videoResult.linkError}`);
@@ -123545,6 +123729,7 @@ async function runAdPmaxCreate(opts) {
         videoResult.youtubeTarget
       );
     }
+    console.error("   \u6D3B\u52A8\u5DF2\u7ECF\u521B\u5EFA\u6210\u529F\uFF0C\u4E0D\u8981\u518D\u6267\u884C pmax-create\u3002\n");
   } else if (videoResult.skippedReason) {
     console.error(`
 \u26A0\uFE0F  \u6D3B\u52A8\u5DF2\u521B\u5EFA\uFF0C\u4F46\u89C6\u9891\u672A\u94FE\u63A5\uFF1A${videoResult.skippedReason}
@@ -123557,6 +123742,7 @@ async function runAdPmaxCreate(opts) {
     }
     console.error(
       `   \u53EF\u624B\u52A8\u8865\u6302\uFF1Asiluzan-tso ad extension callout|snippet|lead-form -a ${accountId} --campaign-id ${campaignId} \u2026
+   \u6D3B\u52A8\u5DF2\u7ECF\u521B\u5EFA\u6210\u529F\uFF0C\u4E0D\u8981\u518D\u6267\u884C pmax-create\u3002
 `
     );
   } else if (extensionsResult?.allOk && extensionsResult.callouts.length + extensionsResult.structuredSnippets.length + extensionsResult.sitelinks.length + (extensionsResult.leadForm ? 1 : 0) + (extensionsResult.whatsapp ? 1 : 0) > 0) {
@@ -123564,12 +123750,22 @@ async function runAdPmaxCreate(opts) {
       console.log("\n\u2705 Campaign \u9644\u52A0\u8D44\u4EA7\u5DF2\u6302\u8F7D");
     }
   }
+  const followUpFailed = pmaxCreateFollowUpFailed({
+    uploadError: videoResult.uploadError,
+    linkError: videoResult.linkError,
+    extensionsAllOk: extensionsResult ? extensionsResult.allOk : void 0
+  });
+  if (followUpFailed) {
+    payload["created"] = true;
+    payload["retryCreate"] = false;
+  }
   if (await emitCliJsonOrSnapshot(opts, {
     section: `ad-pmax-create-${accountId}`,
     commandLabel: "ad pmax-create",
     commandHint: accountId,
     payload,
-    idSuffix: accountId
+    idSuffix: accountId,
+    summaryExtras: followUpFailed ? { created: true, retryCreate: false } : void 0
   })) {
     return;
   }

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.59-beta.2",
-  "publishedAt": 1793093338610
+  "version": "1.1.59-beta.3",
+  "publishedAt": 1793098194200
 }

package/dist/skill/assets/google-period-report.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "siluzan-tso/google-period-report.schema.json",
   "title": "GooglePeriodReport",
-  "description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 9 章：8 个数据维 + 优化建议；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative；kpis/charts/tables 由 --snapshot-dir 从 google-analysis 快照合并。render 校验要求合并后 kpis.cost/impressions/clicks 至少一项为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。",
+  "description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 10 章：9 个数据维 + 优化建议；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative；kpis/charts/tables 由 --snapshot-dir 从 google-analysis 快照合并。render 校验要求合并后 kpis.cost/impressions/clicks 至少一项为有效数字，且 tables.negativeKeywords 为数组（0 条也要是 []），否则拒绝出 HTML。",
   "type": "object",
   "required": ["meta", "narrative"],
   "properties": {
@@ -93,7 +93,8 @@
         "devices": { "$ref": "#/$defs/deviceRows" },
         "geographic": { "$ref": "#/$defs/geographicRows" },
         "audience": { "$ref": "#/$defs/audienceRows" },
-        "keywords": { "$ref": "#/$defs/keywordRows" }
+        "keywords": { "$ref": "#/$defs/keywordRows" },
+        "negativeKeywords": { "$ref": "#/$defs/negativeKeywordRows" }
       }
     },
     "narrative": {
@@ -109,7 +110,7 @@
         },
         "sections": {
           "type": "object",
-          "description": "8 个数据维度各自的分析+建议（对应报告 §1~§8）；每维度 analysis ≥2 条、suggestions ≥1 条",
+          "description": "9 个数据维度各自的分析+建议（对应报告 §1~§9）；每维度 analysis ≥2 条、suggestions ≥1 条",
           "required": [
             "overview",
             "dailyTrend",
@@ -118,7 +119,8 @@
             "devices",
             "geographic",
             "audience",
-            "keywords"
+            "keywords",
+            "negativeKeywords"
           ],
           "properties": {
             "overview": { "$ref": "#/$defs/sectionNarrative" },
@@ -128,12 +130,13 @@
             "devices": { "$ref": "#/$defs/sectionNarrative" },
             "geographic": { "$ref": "#/$defs/sectionNarrative" },
             "audience": { "$ref": "#/$defs/sectionNarrative" },
-            "keywords": { "$ref": "#/$defs/sectionNarrative" }
+            "keywords": { "$ref": "#/$defs/sectionNarrative" },
+            "negativeKeywords": { "$ref": "#/$defs/sectionNarrative" }
           }
         },
         "recommendations": {
           "type": "array",
-          "description": "报告 §9 优化建议；≥3 条，可跨维度综合",
+          "description": "报告 §10 优化建议；≥3 条，可跨维度综合",
           "minItems": 3,
           "items": {
             "oneOf": [
@@ -249,6 +252,19 @@
         "costPerConversion": { "type": "number" }
       }
     },
-    "keywordRows": { "type": "array", "items": { "$ref": "#/$defs/keywordRow" } }
+    "keywordRows": { "type": "array", "items": { "$ref": "#/$defs/keywordRow" } },
+    "negativeKeywordRow": {
+      "type": "object",
+      "description": "当前账户否词一行。0 条时数组为空，不要省略字段。",
+      "properties": {
+        "keyword": { "type": "string" },
+        "matchType": { "type": "string" },
+        "level": { "type": "string" },
+        "levelZh": { "type": "string" },
+        "campaignName": { "type": "string" },
+        "adGroupName": { "type": "string" }
+      }
+    },
+    "negativeKeywordRows": { "type": "array", "items": { "$ref": "#/$defs/negativeKeywordRow" } }
   }
 }

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

@@ -16,7 +16,8 @@
       "勿用 Search 的 ExtensionsForBatchJob；PMax 用 campaignExtensions（CLI 会尝试自动转换 CALLOUT/SNIPPET）",
       "Lead Gen/B2B 询盘方案：默认保留 campaignExtensions.leadForm（勿只写 callouts/snippets）；用户明确不要表单才删 leadForm",
       "审查稿须单列「潜在客户表单」节（标题/描述/字段/privacyPolicyUrl）；结构见 google-ads-pmax-launch-plan-template.md",
-      "不需要任何附加资产时设 skipCampaignExtensions: true（勿仅删除 campaignExtensions 块）"
+      "不需要任何附加资产时设 skipCampaignExtensions: true（勿仅删除 campaignExtensions 块）",
+      "创建失败：只有 400 且编号变多时，才把非空 budgetId / campaignId / assetGroupId 写回本 JSON 再跑一次，内容不改。首次创建不填。已经 200 只是扩展失败就不要再 pmax-create"
     ]
   },
 

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

@@ -22,6 +22,7 @@
 | Lead Gen 方案 | **默认**在 `campaignExtensions` 含 **`leadForm`**（B2B/询盘/留资）；仅 callouts/snippets 不算完整方案；用户明确不要才省略                                                                   |
 | 存量补表单    | 活动已创建时用 `ad extension lead-form`（见 `pmax-lead-form-template.md` 方式 B）                                                                                                           |
 | 改已上线 PMax | 先 `ad pmax-get` 看 `_brandGuidelinesActive`；改品牌见 `pmax-api.md` § Brand Guidelines                                                                                                     |
+| 创建失败      | 只有创建接口 400，且编号比这次请求多，才把非空的 `budgetId` / `campaignId` / `assetGroupId` 写回同一份 JSON，其余内容不要改，再 `pmax-create` 一次。首次创建不填这三个字段。同一步再失败就停。已经 200、只是扩展或视频失败：不要再 `pmax-create` |
 | 列表复核      | `ad campaigns -a <id> --json-out ./snap`，`channelTypeV2` 应为 `PERFORMANCE_MAX`                                                                                                            |
 
 ---
@@ -81,6 +82,9 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 | `targetCpa_BidingAmount`      | number     |      | `TARGET_CPA` 或带目标 CPA 的 `MAXIMIZE_CONVERSIONS` 时必填（**元**）                                                                                |
 | `targetRoas`                  | number     |      | `TARGET_ROAS` 时必填（如 `2.5` = 250%）                                                                                                             |
 | `brandGuidelinesEnabled`      | boolean    |      | 省略 = 网关默认 `true`（Campaign 级 BG）；`false` = 品牌在 AssetGroup（旧路径）                                                                     |
+| `budgetId`                    | string     |      | 上次创建失败后已经建成的预算编号。空着就新建。续跑时和下面两个编号一起写回，其余字段不要改                                                         |
+| `campaignId`                  | string     |      | 上次创建失败后已经建成的系列编号。必须和 `budgetId` 一起传                                                                                          |
+| `assetGroupId`                | string     |      | 上次创建失败后已经建成的素材组编号。必须和 `budgetId`、`campaignId` 一起传。默认 BG 开启时不能只写到系列                                            |
 | `videoPath`                   | string     |      | YOUTUBE_VIDEO（可选）：本地视频 ≥10s；与 `youtubeUrlOrId` 二选一，创建时最多 1 条；更多视频创建后用 `pmax-youtube-link` / `pmax-assets-update` 追加 |
 | `videoTitle`                  | string     |      | PyAPI 上传标题（默认文件名）                                                                                                                        |
 | `videoDescription`            | string     |      | PyAPI 上传描述（可选）                                                                                                                              |
@@ -130,7 +134,17 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 | -------------- | -------------------------------------------------- |
 | `campaignId`   | 活动 ID                                            |
 | `assetGroupId` | 首个资产组 ID                                      |
-| `budgetId`     | 日预算 ID（后续 PATCH 改预算时需与 `budget` 成对） |
+| `budgetId`     | 日预算 ID（后续 PATCH 改预算时需与 `budget` 成对；创建失败后续跑也用它） |
+
+---
+
+## 创建失败后续跑
+
+`POST .../campaign/pmax` 失败时返回 **JSON**，不再是纯文本。`message` 是原因。`budgetId`、`campaignId`、`assetGroupId` 里非空的是已经建成的编号，没建成的是 `null`。
+
+把非空编号按同名写回**同一份** JSON，其余内容不要改，再执行一次 `pmax-create`。CLI 会原样转发这三个字段，不会改已有预算金额或系列名称。首次创建不要填它们。不带编号再提交会新建一套。编号按预算、系列、素材组带。默认品牌手册开启时不能只写 `campaignId`。同一步再失败就停（stdout 摘要 `retryCreate=false`）。
+
+创建接口已经 **200**，只是附加资产或视频没挂上：活动已经在，**不要再 `pmax-create`**。扩展用 `ad extension`，视频用 `ad pmax-youtube-link`。这时 stdout 摘要是 `created=true`、`retryCreate=false`。
 
 ---
 

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

@@ -44,7 +44,7 @@
 ## 工作流入口（线性步骤见 playbooks）
 
 > 线性步骤见 `playbooks.md`：单户画像 **P1**、Google 周期 **P4**、Meta 周期 **P4-FB**、多账户批处理 **P5**、OKKI **P6**、询盘 **P7**。
-> 「使用 okki 周报模板」→ **P6**（勿按默认 9 章追问；终稿 `google-analysis okki-render`，禁止 Agent 手写 xlsx）。Google 周期 Excel（非 OKKI/询盘）→ **P4** + `report-templates/google-period-report-excel.md`。
+> 「使用 okki 周报模板」→ **P6**（勿按默认 10 章追问；终稿 `google-analysis okki-render`，禁止 Agent 手写 xlsx）。Google 周期 Excel（非 OKKI/询盘）→ **P4** + `report-templates/google-period-report-excel.md`。
 
 拉数落盘：`google-analysis … --json-out <dir>`（Google）或 `yandex-analysis` / `bing-analysis` / `facebook-analysis` / `tiktok-analysis`；目录内生成 `<section>-<accountId>.json` + `manifest-<accountId>.json`（Meta/TikTok/Bing/Yandex 为 `report-manifest-<accountId>.json`）。读盘协议、交付自检与报告首行标注统一见 `references/core/agent-conventions.md` §三、§七。
 
@@ -78,17 +78,17 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 
 ## Google 账户分析：`google-analysis` 命令
 
-> **重要**：`google-analysis` 是统一入口，所有 25 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
+> **重要**：`google-analysis` 是统一入口，所有维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。否词名单用 `--sections negative-keywords`，**不要**另跑 `ad keywords --negative`。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
 
 ```bash
 # 单维度
 siluzan-tso google-analysis -a <id> --sections overview --json-out <dir>
 
-# 多维度（周期报告默认 8 个拉数维，含 audience）
+# 多维度（周期报告默认 9 个拉数维，含 audience 与 negative-keywords）
 siluzan-tso google-analysis -a <id> --start YYYY-MM-DD --end YYYY-MM-DD \
-  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords --json-out <dir>
+  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords,negative-keywords --json-out <dir>
 
-# 全量 25 个（省略 --sections）
+# 全部维度（省略 --sections）
 siluzan-tso google-analysis -a <id> --json-out <dir>
 
 # 排除慢/不需要的维度

package/dist/skill/references/core/agent-conventions.md

@@ -228,7 +228,7 @@
 
 **A · 币种**：首行含 `统计区间：…（货币：CNY|USD）`；全文符号与 `currencyCode` 一致（CNY=￥、USD=$，未混用）；与当次 `list-accounts -k` 结果相同；多账户分币种分表、无跨币种「总计」行。
 
-**B · 结构完整**（对照当次 `report-templates/*.md`）：模板要求的每一章/Sheet 都存在；无整章空白（缺数据章节写 `[ 数据不可用：… ]`，禁止编造数字填坑）；优化建议独立成节、引用当次数字（Meta 周期：四问 + 3 张建议卡 + 各章 analysis/advice；Google 诊断：每模块除表格外有「分析」+「建议」）；Excel 的表头列须能在当次 `*.outline.txt` 找到对应字段、产物内账户 ID = 用户当轮给出的 `mediaCustomerId`；**Excel 内全部 ID 列为文本**（见上文「写 Excel 时所有 ID 必须是文本」）。**P6**：磁盘上必须已有 `google-analysis okki-render` 写出的 `.xlsx`（禁止 Agent 手写表）。可复制话术为默认 7 条且一条一行；禁止改成「一、二、三、四」或合成一段。只有用户本轮粘贴骨架或点名增删某一条时才改被点名的行。**P7**：磁盘上必须已有 `.xlsx`。对话 Markdown 表、手写 HTML/PDF **不能**当作终稿通过自检（用户明确只要话术除外）。
+**B · 结构完整**（对照当次 `report-templates/*.md`）：模板要求的每一章/Sheet 都存在；无整章空白（缺数据章节写 `[ 数据不可用：… ]`，禁止编造数字填坑）；优化建议独立成节、引用当次数字（Meta 周期：四问 + 3 张建议卡 + 各章 analysis/advice；Google 诊断：每模块除表格外有「分析」+「建议」）；Excel 的表头列须能在当次 `*.outline.txt` 找到对应字段、产物内账户 ID = 用户当轮给出的 `mediaCustomerId`；**Excel 内全部 ID 列为文本**（见上文「写 Excel 时所有 ID 必须是文本」）。**P6**：磁盘上必须已有 `google-analysis okki-render` 写出的 `.xlsx`（禁止 Agent 手写表）。发给用户的话术是一个代码块，行首为「您好，同步一下谷歌」、`1、消耗：` 至 `7、账户余额：`，①②③ 各一行；禁止改成「一、二、三、四」、合成一段，或在代码块外再写结论。只有用户本轮粘贴骨架或点名增删某一条时才改被点名的行。**P7**：磁盘上必须已有 `.xlsx`。对话 Markdown 表、手写 HTML/PDF **不能**当作终稿通过自检（用户明确只要话术除外）。
 
 **C · 数字可信**（抽样，不读大 JSON）：总消耗/CPA 数量级与生成过程中脚本 stdout 打印的汇总一致（若无，补跑一次极小 `node -e` 只打印 totals）；账户 ID、区间与用户需求一致；无「示例账户」「占位 123456」等模板残留；表格行数符合预期（如 P3 每个 `-a` ID 占一行）。
 
@@ -333,7 +333,7 @@
 4. **行动建议**：1～3 条，点名对象并引用数据；若建议含「打开网页 / 去充值 / 去授权」，链接须遵守 §四「禁止编造平台网页地址」，**禁止**随口给一个未经验证的 URL。
 5. **下一步**：一句邀请。客户端 suggestion chips 另展示；**不要**在 skill 各任务文档维护 chips 全文清单。
 
-**OKKI 周报例外**：上面 5 步只用于代码块**外面**的运营摘要（最多 3～5 行）。发给客户复制的正文按 `okki-weekly-google-client.md` 的默认 7 条填写，一条一行。禁止把摘要结构写进可复制块，禁止沿用上一轮或其他账户的话术。
+**OKKI 周报不走上面 5 步。** 最终回复只有两样：一行 xlsx 路径，加一个代码块。代码块从「您好，同步一下谷歌」开始，行首依次是 `1、消耗：`、`2、展示点击：`、`3、点击率：`、`4、平均点击单价：`、`5、转化：`、`5.1`、`5.2`、`6、优化建议：`（下面 ①②③ 各占一行）、`7、账户余额：`。只替换数字和对象，不改这些行首，不合成一段。代码块外面不要写结论、概览、发现、下周动作。用户**本轮**换了格式或贴了新全文，就用用户那一版，仍然只放这一个代码块。细则见 `okki-weekly-google-client.md`「对外客户话术」。
 
 长任务（>30s）：中间用进度短句，勿长时间沉默后突然扔大表。
 

package/dist/skill/references/core/intent-routing.md

@@ -269,7 +269,7 @@
 | 用户话术（含子串即可）                                                                                                                      | 工作流          | 备注                                                      |
 | ------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | --------------------------------------------------------- |
 | **网址 / URL / 域名 / 官网 / 落地页** + **诊断 / 检测 / 监测 / 评估 / 体检 / 报告 / 符合投放要求 / 能不能投**（含「网络诊断」「网络检测」） | **P8**          | 与 **§零** 同义；**优先 §零**；必 `website-diagnosis` CLI |
-| `OKKI 周报` / `okki 周报` / `使用 okki 周报模板`                                                                                            | **P6**          | **不按 P4 默认 9 章**；写 JSON 后 `okki-render` 出 xlsx；「表格形式」= Excel，禁止对话 Markdown 表 / Agent 手写 xlsx |
+| `OKKI 周报` / `okki 周报` / `使用 okki 周报模板`                                                                                            | **P6**          | **不按 P4 默认 10 章**；写 JSON 后 `okki-render` 出 xlsx；「表格形式」= Excel，禁止对话 Markdown 表 / Agent 手写 xlsx |
 | `Google 账户询盘分析` / `分析 … Google 账号的询盘效果`（**且有询盘附件/字段表**）                                                           | **P7**          | 严格 3 个月窗口；无 CRM → 改 **§零·D / P3**               |
 | `转化成本监控` / `CPA 监控` / `谷歌ADS转化成本` / `低余额账户转化成本`                                                                      | **P3（§零·D）** | `accounts-digest --max-cpa --skip-balance`；贴 `agentBrief.userDelivery` |
 | `昨日零询盘` / `零询盘账户` / `0 转化` / `有消耗无转化`（**无 CRM 附件**）                                                                  | **P3（§零·D）** | `--zero-conversions`；**不是 P7**                         |

package/dist/skill/references/core/playbooks.md

@@ -9,7 +9,7 @@
 | P1    | 单账户投放画像         | 单户拉数 + 诊断画像                    |
 | P2    | 多账户余额扫描         | 续航不足/充值预警巡检                  |
 | P3    | 多账户投放画像汇总     | accounts-digest 多户对比表             |
-| P4    | Google 账户周期报告    | 默认 9 章周期汇总（含受众）            |
+| P4    | Google 账户周期报告    | 默认 10 章周期汇总（含受众、否词）     |
 | P4-FB | Meta/Facebook 周期报告 | facebook-analysis 默认 5 维，默认 HTML |
 | P5    | 多账户多维度批处理     | google-analysis-batch，禁外层 for-loop |
 | P6    | OKKI 周报              | 写 JSON → okki-render 出 5 Sheet xlsx  |
@@ -74,19 +74,19 @@
 
 ## P4 · Google 账户周期报告
 
-- **触发**：Google 账户某区间的周期**数据汇总**（只要花费/转化/9 章，或用户列出 Sheet 要 **Excel**）。非 OKKI / 询盘 / **非**客户版经营报告。
+- **触发**：Google 账户某区间的周期**数据汇总**（只要花费/转化/10 章，或用户列出 Sheet 要 **Excel**）。非 OKKI / 询盘 / **非**客户版经营报告。
 - **不是 P10**：出现「月度报告 / 月总结与规划 / 季度报告 / Q3 汇总 / Q4 规划 / 季度汇报 / 投放季报 / 客户版 / 大族模板 / 下月规划 / 效率+区域询盘+国家明细」→ **P10**（即使带「行业参考」也不改 P9）。
 - **必读**：`report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；**要 Excel** 加 `report-templates/google-period-report-excel.md`（全文）。
 - **步骤**：
   1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户。
   2. 确认时间范围；区间 > 3 个月时分段（季度/月）。
-  3. **拉数**：用户已指定 Sheet/维度 → 只拉对应 `--sections`（见 `google-period-report-excel.md` 映射表）；未指定 → 按 `google-period-report.md` 默认 8 个拉数维（含 `audience`），并可并行追问可选追加。
+  3. **拉数**：用户已指定 Sheet/维度 → 只拉对应 `--sections`（见 `google-period-report-excel.md` 映射表）；未指定 → 按 `google-period-report.md` 默认 9 个拉数维（含 `audience`、`negative-keywords`），并可并行追问可选追加。
   4. **门禁**：对每个 section Read `<section>-<accountId>_*.outline.txt` 后再写脚本。
   5. 脚本读盘写产物：默认 **HTML**（`report-template*.html` 版式参考）；用户要 **Excel** → Agent 脚本写 xlsx（**禁止**宿主第三方 xlsx Skill；**无** CLI excel 子命令）。
-  6. 默认 HTML 报告须含：账户概览、投放趋势、Top 关键词/系列/地区/受众分布、优化建议；用户定制 Excel 以用户 Sheet 清单为准。
+  6. 默认 HTML 报告须含：账户概览、投放趋势、Top 关键词/系列/地区/受众分布、当前否词名单、优化建议；用户定制 Excel 以用户 Sheet 清单为准。
 - **产物**：按 conventions §七 自检；`accountId` 须与用户给的 `mediaCustomerId` 一致。HTML 封面按区间写成「季度」或「月度」，对不上则仍是「周期」。不要打开 HTML 改称呼。
 
-> 用户用「OKKI 周报」固定话术 → 改走 **P6**，不按默认 9 章追问。
+> 用户用「OKKI 周报」固定话术 → 改走 **P6**，不按默认 10 章追问。
 > 只要账户级按日 Excel（无多维章节）→ **P4-DAILY**。
 
 ---
@@ -146,8 +146,8 @@
   3. 同一 `--json-out` 目录执行模板命令组合：`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,geo-targeted`。
   4. 脚本读盘 → 只写 `okki-weekly-report.json` 的 `meta` + `narrative`（5 Sheet 表末分析 + 账户 Sheet 固定 5 维数据复盘；表为空也须写）。`deviceType` 是 `Desktop`/`Mobile`，禁止 `.get("DESKTOP")`，按大小写不敏感分类累加后再写设备金额。
   5. `google-analysis okki-render --data ./okki-weekly-report.json --snapshot-dir ./snap-okki --out <xlsx>`。缺分析 / 缺 5 维复盘 / 缺 `campaign-device` 或 `geo-targeted` 会拒绝出文件；按 stderr 补 JSON 后重跑。**禁止** Agent 手写 xlsx。
-  6. 按 `okki-weekly-google-client.md` **默认 7 条话术**填数，放进代码块，一条一行（第 6 条的 ①②③ 也各占一行）。禁止合成一段，禁止改成「一、二、三、四」。上一轮或其他账户的话术不算本轮骨架；只有用户**本轮**粘贴全文或点名增删某一条时才改被点名的条目。数值与 xlsx 一致。
-- **产物**：`okki-render` 写出的 `.xlsx` 路径（缺文件 = 未完成）+ 对话内客户话术；**不**按 P4 默认 9 章追加。仅用户明确「只要话术 / 不要文件」时才省略 xlsx。
+  6. **话术收口**（用户本轮没换格式时，行首一个字都不能改）：先写一行 xlsx 路径，再贴一个代码块。块内从「您好，同步一下谷歌」起，依次是 `1、消耗：`、`2、展示点击：`、`3、点击率：`、`4、平均点击单价：`、`5、转化：`、`5.1`、`5.2`、`6、优化建议：` 与 ①②③ 各一行、`7、账户余额：`。只填当次数字。禁止合成一段，禁止改成「一、二、三、四」或「结论先行」。代码块外不要再写概览。用户**本轮**粘贴了新全文或点名改某一条，就按用户的来，只动被点名的行，仍然只发这一个代码块。填数规则见 `okki-weekly-google-client.md`。
+- **产物**：`okki-render` 写出的 `.xlsx` 路径（缺文件 = 未完成）+ 上面这个代码块；**不**按 P4 默认 10 章追加。仅用户明确「只要话术 / 不要文件」时才省略 xlsx。
 
 ---
 

package/dist/skill/references/core/subagent-orchestration.md

@@ -107,7 +107,7 @@ summary: <1-3 句中文，无业务数字除非来自 manifest>
 1. 主 Agent：确认账户与日期区间。
 2. **决策**：拉数阶段若日志长 → Bash/Task + `handoff-p6-okki.md` §拉数；否则主会话执行模板 §拉数命令。
 3. **决策**：写叙事 JSON + `okki-render` → Task handoff（只读 `snapDir`，先 outline 后 JSON，见 `references/core/tips.md`）；或主会话若上下文充足。**禁止** Agent 手写 xlsx。
-4. 主 Agent：合并交付 **xlsx 路径**（须来自 `okki-render`）+ 客户话术。话术用模板默认 7 条、一条一行，禁止另写「一、二、三、四」。**没有 `.xlsx` 不得收口**（用户明确只要话术除外）。
+4. 主 Agent：最终回复只有 **xlsx 路径** + 一个话术代码块。行首用模板默认（「您好，同步一下谷歌」到 `7、账户余额：`），禁止另写「一、二、三、四」或结论摘要。用户本轮换了格式就用用户的。**没有 `.xlsx` 不得收口**（用户明确只要话术除外）。
 
 ### P5 · 多账户多维度
 

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

@@ -69,7 +69,7 @@
 | 创建         | `siluzan-tso ad pmax-create --config-file ./pmax.json [--json-out ./snap-pmax]`                                                                                                                                    |
 | 复核         | `siluzan-tso ad campaigns -a <accountId> --json-out ./snap` → `channelTypeV2` 为 `PERFORMANCE_MAX`                                                                                                                 |
 
-**PMax**：`ad pmax-create` **同步**返回 `campaignId`、`assetGroupId`、`budgetId`；无 `ad batch get/diff`。详见 `pmax-api.md`。
+**PMax**：`ad pmax-create` **同步**返回 `campaignId`、`assetGroupId`、`budgetId`；无 `ad batch get/diff`。创建接口 400 才续跑：把比这次请求多出来的非空编号写回同一份 JSON，内容不改，再执行一次。首次创建不填这三个字段。已经 200、只是扩展或视频失败时不要再 `pmax-create`。详见 `pmax-api.md`。
 
 **金额**：JSON 中 `budget`、`targetCpa_BidingAmount` 填主币种**元**；CLI 提交前 ×100（与 `ad campaigns` 列表 `budget` 口径一致）。
 

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

@@ -16,7 +16,7 @@
 | 命令                                                          | 说明                                                                                          |
 | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
 | `ad pmax-validate`                                            | 本地校验                                                                                      |
-| `ad pmax-create`                                              | 创建系列（同步返回 `campaignId` 等）                                                          |
+| `ad pmax-create`                                              | 创建系列（同步返回 `campaignId` 等；失败时把已建成编号写回 JSON 再跑）           |
 | `ad pmax-channel-types`                                       | 渠道类型列表                                                                                  |
 | `ad pmax-get`                                                 | 系列详情（含 `brandAssets[]`；`--json-out` 附加 `_brandGuidelinesActive`、`_agentBrandHint`） |
 | `ad pmax-edit`                                                | 编辑系列（预算/出价/状态；**不可**改 `brandGuidelinesEnabled`）                               |
@@ -211,3 +211,5 @@ Google v21+ 新建 PMax **默认开启** BG：`businessName` / Logo 挂在 **Cam
 
 - 勿对 PMax 使用 `ad campaign-edit`（会 **400**）
 - 新建勿用 `ad campaign-create`；用 `ad pmax-create`
+- 创建接口 400 的正文是 JSON：`message` 加 `budgetId` / `campaignId` / `assetGroupId`，没建成的是 `null`。CLI 会转发 JSON 里的这三个字段；首次创建不填。只有编号比这次请求多时，才写回同一份 JSON、内容不改、再执行一次。编号按预算、系列、素材组带。默认品牌手册开启时不能只写 `campaignId`。同一步再失败时 stdout 是 `retryCreate=false`，停。不带编号再提交会新建一套
+- 创建接口已经 200，只是附加资产或视频失败：不要再 `pmax-create`。扩展用 `ad extension`，视频用 `ad pmax-youtube-link`。stdout 是 `created=true`、`retryCreate=false`

package/dist/skill/references/report-templates/google-period-report.md

@@ -15,13 +15,13 @@
 | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | **1. 拉数**      | Agent 调 CLI | `google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google --sections <见下方默认维度对应 CLI>`                                                                                                       |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察                                                                                                                      |
-| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（8 个数据维 + 优化建议）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 会拒绝出 HTML） |
-| **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 9 章必含字段**（含受众），缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                                                                   |
+| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（9 个数据维 + 优化建议）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 或缺否词表会拒绝出 HTML） |
+| **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 10 章必含字段**（含受众、否词），缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                                                                   |
 
 ```bash
 # 步骤 1
 siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google \
-  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords
+  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords,negative-keywords
 
 # 步骤 4（步骤 2～3 完成后）
 siluzan-tso google-analysis render \
@@ -35,10 +35,10 @@ siluzan-tso google-analysis render \
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
 - `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比；另含 `activeDays` / `averageDailyCost`）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。`activeDays` / `averageDailyCost` 来自 `overview.record` 根（**不是** `currentPeriod`）；环比仍来自 `overview.previousPeriod`（上期无活跃天数，不编造）。
 - `charts.dailyTrend`：每日趋势（`dates`/`cost`/`conversions`/`cpa`）；可省略由 `daily-metrics` 自动合并。
-- `tables.{dimensionSummary,campaigns,devices,geographic,audience,keywords}`：对应 §3～§8 表格数据；可省略由同名 `google-analysis` section 自动合并。
+- `tables.{dimensionSummary,campaigns,devices,geographic,audience,keywords,negativeKeywords}`：对应 §3～§9 表格数据；可省略由同名 `google-analysis` section 自动合并。`negativeKeywords` 合并后必须是数组，**0 条也是 `[]`**。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
   - `executiveSummary[]`：≥1 段执行摘要
-  - `sections.{overview,dailyTrend,dimensionSummary,campaigns,devices,geographic,audience,keywords}`：每个维度各 `{analysis[]（≥2 条）, suggestions[]（≥1 条）}`，对应报告 §1～§8
+  - `sections.{overview,dailyTrend,dimensionSummary,campaigns,devices,geographic,audience,keywords,negativeKeywords}`：每个维度各 `{analysis[]（≥2 条）, suggestions[]（≥1 条）}`，对应报告 §1～§9
   - `recommendations[]`：≥3 条跨维度优化建议，对应报告 §9
 
 完整字段定义见 `assets/google-period-report.schema.json`。
@@ -59,7 +59,7 @@ siluzan-tso google-analysis render \
 
 ## 默认报告维度
 
-生成报告时，**默认包含**以下 9 章（8 个拉数维 + 优化建议）：
+生成报告时，**默认包含**以下 10 章（9 个拉数维 + 优化建议）：
 
 | #   | 维度                                                                         | CLI                                                                                           |
 | --- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
@@ -71,7 +71,8 @@ siluzan-tso google-analysis render \
 | 6   | 地域分布（国家/地区 消耗占比）                                               | `google-analysis --sections geographic`                                                       |
 | 7   | 受众分布（意向/兴趣/再营销/客户匹配等列表表现）                              | `google-analysis --sections audience`（默认不传 `--audience-type`，系统+自定义一起拉）       |
 | 8   | 关键词表现（词/消耗/CTR/CPC 排行）                                           | `google-analysis --sections keywords`（这个命令获取的关键词数据会来自多个系列，不能合并去重） |
-| 9   | 优化建议（根据以上数据给出可执行改进建议）                                   | 不额外拉数，基于已有数据撰写                                                                  |
+| 9   | 否词（当前账户已有否定关键词：词面 / 匹配 / 级别 / 系列 / 广告组）           | `google-analysis --sections negative-keywords`（0 条也要落盘；名单不按本周期消耗过滤）       |
+| 10  | 优化建议（根据以上数据给出可执行改进建议）                                   | 不额外拉数，基于已有数据撰写                                                                  |
 
 **在执行任何数据拉取之前**，先向用户展示以下可选维度，询问是否需要追加：
 
@@ -95,17 +96,17 @@ siluzan-tso google-analysis render \
 
 ---
 
-## 拉数顺序（默认 8 个维度）
+## 拉数顺序（默认 9 个维度）
 
 **首选：用 `google-analysis --sections` 一次拉齐**（单进程复用 keep-alive，比逐个 spawn 快 3-7×；详见 `references/analytics/account-analytics.md` 的 `all` 子命令说明）：
 
 ```bash
 mkdir -p ./snap-google
 siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google \
-  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords
+  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords,negative-keywords
 ```
 
-如果用户**追加**了维度（按上文「可选追加」表），把它们加入 `--sections` 即可；要全 21 维则省略 `--sections`。
+如果用户**追加**了维度（按上文「可选追加」表），把它们加入 `--sections` 即可；要全部维度则省略 `--sections`。
 
 > 仅在调试单个维度或需要传 `all` 暂未透传的特殊参数时，才回落到逐条 `siluzan-tso google-analysis <子命令> -a <id> …` 调用。
 
@@ -134,3 +135,16 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
   - 区分系统意向/兴趣 vs 再营销/客户匹配；空耗列表建议缩小或排除，高效列表建议观察后再加码。
   - 无行时写「本期间无受众行 / 未挂受众列表」，**禁止**编造年龄段或兴趣饼。
   - 未确认前不要写自动改出价/排除命令。
+
+---
+
+## 否词（必写）
+
+`negative-keywords-*.json` → `items[]`，合并后是 `tables.negativeKeywords[]`。这是**当前账户已经存在的否定关键词**（系列 / 广告组 / 账户三级），不是本周期的消耗或搜索词。
+
+- **呈现**：词面、匹配方式、级别（`levelZh`：账户 / 系列 / 广告组）、广告系列、广告组。0 条时表格写「当前账户否词 0 条」。
+- **分析** → `narrative.sections.negativeKeywords.{analysis,suggestions}`（≥2 / ≥1）：
+  - 先写总条数，再按级别拆开。有词就点名几条；0 条就写「当前否词 0 条」。
+  - 其他章节如果建议加否词、出否词清单，必须引用这张表的条数。禁止在没拉到名单时写「账户没有否词」或只在建议里提否词。
+  - 这张表不说明该否哪些搜索词。要谈浪费搜索词，须另拉 `search-terms`，并对照本表里已有的否词。
+  - 未确认前不要执行 `ad keyword-negative-create`。

package/dist/skill/references/report-templates/okki-weekly-google-client.md

@@ -23,7 +23,7 @@
 
 ---
 
-识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 9 章 + 追问追加」流程；按本文**固定维度 + 默认客户话术（可用户自定义）+ `okki-render` 出 5 Sheet `.xlsx`** 交付。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。话术骨架见下文，禁止另起一套标题。
+识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 10 章 + 追问追加」流程；按本文固定维度拉数，`okki-render` 出 5 Sheet `.xlsx`。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。发给用户的话术默认就是下文那个代码块：只换数字，不换行首。用户本轮另给了全文或点名改某一条，才改被点名的部分。
 
 ---
 
@@ -241,13 +241,14 @@ function deviceKind(deviceType) {
 
 ## 对外客户话术（默认结构，填数来自 JSON）
 
-> 话术是给客户看的总结，**由 Agent 填写，不要写脚本生成**。骨架固定；只有措辞和数字随当次数据变。
+> 话术由 Agent 填数，**不要写脚本生成**。用户没换格式时，下面代码块就是终稿：复制行首，只替换尖括号里的内容。
 
-**默认就用下面这 7 条。** 放进代码块再发给用户，便于原样复制。换行是骨架的一部分：
+**发给用户时只有两样东西：**
 
-- `1`～`5`、`5.1`、`5.2`、`7` 各占一行，行末用分号
-- 第 `6` 条先写「6、优化建议：」，下面 **3～5 条**建议各占一行，用 ①②③④⑤，禁止写进同一句
-- 禁止把 1～7 合成一段
+1. 一行文件路径（xlsx）
+2. 下面这一个代码块
+
+代码块外面不要写「本周结论 / 概览 / 发现 / 下周动作」。`agent-conventions.md` 的「结论先行」五步**不用于**这次回复。
 
 ```
 您好，同步一下谷歌<中文日期>投放的情况：
@@ -266,15 +267,31 @@ function deviceKind(deviceType) {
 7、账户余额：<金额>（截至查询时点）。
 ```
 
-日期写成 `2026年4月1日-4月7日`（同年可省略结束年份），须与 `--start` / `--end` 对应。
-
-**未获本轮用户改骨架时，禁止：**
+换行是骨架的一部分。`1`～`5`、`5.1`、`5.2`、`7` 各占一行，行末用中文分号 `；`。`6、优化建议：` 单独一行，下面 **3～5 条**用 ①②③④⑤，每条一行。日期写成 `2026年4月1日-4月7日`（同年可省略结束年份），须与 `--start` / `--end` 对应。
 
-- 改成「一、本周概览 / 二、本周发现 / 三、下周优化动作 / 四、需要您配合确认」，或任何另一套标题
-- 把上一轮、另一个账户、对话里出现过的话术当成这次的骨架
-- 用「结论先行」重写可复制块。运营摘要最多 3～5 行，放在代码块**外面**
+**发出去之前对一下行首**（用户本轮没换格式时，缺一条或改了一个行首都重写这块，不要解释）：
 
-**只有本轮用户**粘贴了全文骨架，或点名增删某一条（「不要 5.1」「第 3 条改成…」）时才偏离上面的结构。只改被点名的条目；用户删掉的条目不再输出。数字仍须来自当次 JSON，缺数写 `[数据不可用：原因]`。
+| 行首 | 必须长这样 |
+| --- | --- |
+| 开头 | `您好，同步一下谷歌` |
+| 1 | `1、消耗：` |
+| 2 | `2、展示点击：` |
+| 3 | `3、点击率：` |
+| 4 | `4、平均点击单价：` |
+| 5 | `5、转化：` |
+| 5.1 | `5.1` 且含「有转化的关键词」 |
+| 5.2 | `5.2` 且含「有转化的国家」 |
+| 6 | 单独一行 `6、优化建议：`，①②③ 不写在这一行 |
+| 7 | `7、账户余额：` |
+
+**这些都算没按格式，改回上面的行首再发：**
+
+- 合成一段，或把 ①②③ 写进第 6 行
+- 「一、本周概览」「二、本周发现」「三、下周优化」「四、需要您配合」
+- 代码块前先写一段结论、要点、核心发现
+- 沿用上一轮、另一个账户、或对话里见过的另一套话术
+
+**用户要换格式时很好改：** 本轮粘贴了全文，或点名「不要 5.1」「第 3 条改成…」，就按用户的写，只动被点名的行。没点名的行仍用默认行首。数字仍来自当次 JSON，缺数写 `[数据不可用：原因]`。不要因为上一轮换过格式，这一轮就继续用旧骨架。
 
 ### 填数规则
 

package/dist/skill/report-templates/google-period-report.html

@@ -807,6 +807,7 @@
     <a href="#sec-geographic">地域分布</a>
     <a href="#sec-audience">受众分布</a>
     <a href="#sec-keywords">关键词</a>
+    <a href="#sec-negative-keywords">否词</a>
     <a href="#sec-recommendations">优化建议</a>
   </div>
 </div>`;
@@ -1096,6 +1097,59 @@
 </section>`;
         }
 
+        function renderNegativeKeywords(data) {
+          const rows = Array.isArray(data.tables?.negativeKeywords)
+            ? data.tables.negativeKeywords
+            : null;
+          const section = data.narrative?.sections?.negativeKeywords;
+          const head = sectionHead(
+            "09",
+            "否词",
+            "当前账户已有否定关键词（系列 / 广告组 / 账户），不是本周期消耗",
+          );
+          const levelOrder = { 账户: 0, 系列: 1, 广告组: 2 };
+          const sorted =
+            rows == null
+              ? []
+              : [...rows].sort((a, b) => {
+                  const la = levelOrder[a.levelZh] ?? 9;
+                  const lb = levelOrder[b.levelZh] ?? 9;
+                  if (la !== lb) return la - lb;
+                  return String(a.keyword || "").localeCompare(String(b.keyword || ""));
+                });
+          const shown = sorted.slice(0, 100);
+          const body = shown
+            .map(
+              (r) => `
+<tr>
+  <td>${escapeHtml(r.keyword || "—")}</td>
+  <td>${escapeHtml(r.matchType || "—")}</td>
+  <td>${escapeHtml(r.levelZh || r.level || "—")}</td>
+  <td>${escapeHtml(r.campaignName || "—")}</td>
+  <td>${escapeHtml(r.adGroupName || "—")}</td>
+</tr>`,
+            )
+            .join("");
+          const table =
+            rows == null
+              ? '<div class="empty-note">数据不可用：negative-keywords 未拉取</div>'
+              : shown.length > 0
+                ? `<div class="table-wrap"><table>
+  <thead><tr><th>否词</th><th>匹配方式</th><th>级别</th><th>广告系列</th><th>广告组</th></tr></thead>
+  <tbody>${body}</tbody>
+</table></div>
+<div class="card-title-row" style="margin-top:10px"><span class="hint">当前否词 ${rows.length} 条，表格最多展示 100 条</span></div>`
+                : '<div class="empty-note">当前账户否词 0 条</div>';
+          return `
+<section id="sec-negative-keywords">
+  ${head}
+  <div class="card">
+    ${table}
+    ${analysisBlock(section)}
+  </div>
+</section>`;
+        }
+
         function renderRecommendations(data) {
           const recs = Array.isArray(data.narrative?.recommendations)
             ? data.narrative.recommendations
@@ -1116,7 +1170,7 @@
               : '<div class="empty-note">（待 Agent 撰写优化建议）</div>';
           return `
 <section id="sec-recommendations">
-  ${sectionHead("09", "优化建议", "综合以上数据的可执行改进建议")}
+  ${sectionHead("10", "优化建议", "综合以上数据的可执行改进建议")}
   <div class="card">${body}</div>
 </section>`;
         }
@@ -1397,6 +1451,7 @@
             renderGeographic(data),
             renderAudience(data),
             renderKeywords(data),
+            renderNegativeKeywords(data),
             renderRecommendations(data),
             renderFooter(data),
           ].join("\n");

package/dist/skill/report-templates/google-period-report.md

@@ -15,13 +15,13 @@
 | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | **1. 拉数**      | Agent 调 CLI | `google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google --sections <见下方默认维度对应 CLI>`                                                                                                       |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察                                                                                                                      |
-| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（8 个数据维 + 优化建议）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 会拒绝出 HTML） |
-| **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 9 章必含字段**（含受众），缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                                                                   |
+| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（9 个数据维 + 优化建议）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 或缺否词表会拒绝出 HTML） |
+| **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 10 章必含字段**（含受众、否词），缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                                                                   |
 
 ```bash
 # 步骤 1
 siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google \
-  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords
+  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords,negative-keywords
 
 # 步骤 4（步骤 2～3 完成后）
 siluzan-tso google-analysis render \
@@ -35,10 +35,10 @@ siluzan-tso google-analysis render \
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
 - `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比；另含 `activeDays` / `averageDailyCost`）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。`activeDays` / `averageDailyCost` 来自 `overview.record` 根（**不是** `currentPeriod`）；环比仍来自 `overview.previousPeriod`（上期无活跃天数，不编造）。
 - `charts.dailyTrend`：每日趋势（`dates`/`cost`/`conversions`/`cpa`）；可省略由 `daily-metrics` 自动合并。
-- `tables.{dimensionSummary,campaigns,devices,geographic,audience,keywords}`：对应 §3～§8 表格数据；可省略由同名 `google-analysis` section 自动合并。
+- `tables.{dimensionSummary,campaigns,devices,geographic,audience,keywords,negativeKeywords}`：对应 §3～§9 表格数据；可省略由同名 `google-analysis` section 自动合并。`negativeKeywords` 合并后必须是数组，**0 条也是 `[]`**。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
   - `executiveSummary[]`：≥1 段执行摘要
-  - `sections.{overview,dailyTrend,dimensionSummary,campaigns,devices,geographic,audience,keywords}`：每个维度各 `{analysis[]（≥2 条）, suggestions[]（≥1 条）}`，对应报告 §1～§8
+  - `sections.{overview,dailyTrend,dimensionSummary,campaigns,devices,geographic,audience,keywords,negativeKeywords}`：每个维度各 `{analysis[]（≥2 条）, suggestions[]（≥1 条）}`，对应报告 §1～§9
   - `recommendations[]`：≥3 条跨维度优化建议，对应报告 §9
 
 完整字段定义见 `assets/google-period-report.schema.json`。
@@ -59,7 +59,7 @@ siluzan-tso google-analysis render \
 
 ## 默认报告维度
 
-生成报告时，**默认包含**以下 9 章（8 个拉数维 + 优化建议）：
+生成报告时，**默认包含**以下 10 章（9 个拉数维 + 优化建议）：
 
 | #   | 维度                                                                         | CLI                                                                                           |
 | --- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
@@ -71,7 +71,8 @@ siluzan-tso google-analysis render \
 | 6   | 地域分布（国家/地区 消耗占比）                                               | `google-analysis --sections geographic`                                                       |
 | 7   | 受众分布（意向/兴趣/再营销/客户匹配等列表表现）                              | `google-analysis --sections audience`（默认不传 `--audience-type`，系统+自定义一起拉）       |
 | 8   | 关键词表现（词/消耗/CTR/CPC 排行）                                           | `google-analysis --sections keywords`（这个命令获取的关键词数据会来自多个系列，不能合并去重） |
-| 9   | 优化建议（根据以上数据给出可执行改进建议）                                   | 不额外拉数，基于已有数据撰写                                                                  |
+| 9   | 否词（当前账户已有否定关键词：词面 / 匹配 / 级别 / 系列 / 广告组）           | `google-analysis --sections negative-keywords`（0 条也要落盘；名单不按本周期消耗过滤）       |
+| 10  | 优化建议（根据以上数据给出可执行改进建议）                                   | 不额外拉数，基于已有数据撰写                                                                  |
 
 **在执行任何数据拉取之前**，先向用户展示以下可选维度，询问是否需要追加：
 
@@ -95,17 +96,17 @@ siluzan-tso google-analysis render \
 
 ---
 
-## 拉数顺序（默认 8 个维度）
+## 拉数顺序（默认 9 个维度）
 
 **首选：用 `google-analysis --sections` 一次拉齐**（单进程复用 keep-alive，比逐个 spawn 快 3-7×；详见 `references/analytics/account-analytics.md` 的 `all` 子命令说明）：
 
 ```bash
 mkdir -p ./snap-google
 siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google \
-  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords
+  --sections overview,daily-metrics,dimension-summary,campaigns,devices,geographic,audience,keywords,negative-keywords
 ```
 
-如果用户**追加**了维度（按上文「可选追加」表），把它们加入 `--sections` 即可；要全 21 维则省略 `--sections`。
+如果用户**追加**了维度（按上文「可选追加」表），把它们加入 `--sections` 即可；要全部维度则省略 `--sections`。
 
 > 仅在调试单个维度或需要传 `all` 暂未透传的特殊参数时，才回落到逐条 `siluzan-tso google-analysis <子命令> -a <id> …` 调用。
 
@@ -134,3 +135,16 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
   - 区分系统意向/兴趣 vs 再营销/客户匹配；空耗列表建议缩小或排除，高效列表建议观察后再加码。
   - 无行时写「本期间无受众行 / 未挂受众列表」，**禁止**编造年龄段或兴趣饼。
   - 未确认前不要写自动改出价/排除命令。
+
+---
+
+## 否词（必写）
+
+`negative-keywords-*.json` → `items[]`，合并后是 `tables.negativeKeywords[]`。这是**当前账户已经存在的否定关键词**（系列 / 广告组 / 账户三级），不是本周期的消耗或搜索词。
+
+- **呈现**：词面、匹配方式、级别（`levelZh`：账户 / 系列 / 广告组）、广告系列、广告组。0 条时表格写「当前账户否词 0 条」。
+- **分析** → `narrative.sections.negativeKeywords.{analysis,suggestions}`（≥2 / ≥1）：
+  - 先写总条数，再按级别拆开。有词就点名几条；0 条就写「当前否词 0 条」。
+  - 其他章节如果建议加否词、出否词清单，必须引用这张表的条数。禁止在没拉到名单时写「账户没有否词」或只在建议里提否词。
+  - 这张表不说明该否哪些搜索词。要谈浪费搜索词，须另拉 `search-terms`，并对照本表里已有的否词。
+  - 未确认前不要执行 `ad keyword-negative-create`。

package/dist/skill/report-templates/okki-weekly-google-client.md

@@ -23,7 +23,7 @@
 
 ---
 
-识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 9 章 + 追问追加」流程；按本文**固定维度 + 默认客户话术（可用户自定义）+ `okki-render` 出 5 Sheet `.xlsx`** 交付。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。话术骨架见下文，禁止另起一套标题。
+识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 10 章 + 追问追加」流程；按本文固定维度拉数，`okki-render` 出 5 Sheet `.xlsx`。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。发给用户的话术默认就是下文那个代码块：只换数字，不换行首。用户本轮另给了全文或点名改某一条，才改被点名的部分。
 
 ---
 
@@ -241,13 +241,14 @@ function deviceKind(deviceType) {
 
 ## 对外客户话术（默认结构，填数来自 JSON）
 
-> 话术是给客户看的总结，**由 Agent 填写，不要写脚本生成**。骨架固定；只有措辞和数字随当次数据变。
+> 话术由 Agent 填数，**不要写脚本生成**。用户没换格式时，下面代码块就是终稿：复制行首，只替换尖括号里的内容。
 
-**默认就用下面这 7 条。** 放进代码块再发给用户，便于原样复制。换行是骨架的一部分：
+**发给用户时只有两样东西：**
 
-- `1`～`5`、`5.1`、`5.2`、`7` 各占一行，行末用分号
-- 第 `6` 条先写「6、优化建议：」，下面 **3～5 条**建议各占一行，用 ①②③④⑤，禁止写进同一句
-- 禁止把 1～7 合成一段
+1. 一行文件路径（xlsx）
+2. 下面这一个代码块
+
+代码块外面不要写「本周结论 / 概览 / 发现 / 下周动作」。`agent-conventions.md` 的「结论先行」五步**不用于**这次回复。
 
 ```
 您好，同步一下谷歌<中文日期>投放的情况：
@@ -266,15 +267,31 @@ function deviceKind(deviceType) {
 7、账户余额：<金额>（截至查询时点）。
 ```
 
-日期写成 `2026年4月1日-4月7日`（同年可省略结束年份），须与 `--start` / `--end` 对应。
-
-**未获本轮用户改骨架时，禁止：**
+换行是骨架的一部分。`1`～`5`、`5.1`、`5.2`、`7` 各占一行，行末用中文分号 `；`。`6、优化建议：` 单独一行，下面 **3～5 条**用 ①②③④⑤，每条一行。日期写成 `2026年4月1日-4月7日`（同年可省略结束年份），须与 `--start` / `--end` 对应。
 
-- 改成「一、本周概览 / 二、本周发现 / 三、下周优化动作 / 四、需要您配合确认」，或任何另一套标题
-- 把上一轮、另一个账户、对话里出现过的话术当成这次的骨架
-- 用「结论先行」重写可复制块。运营摘要最多 3～5 行，放在代码块**外面**
+**发出去之前对一下行首**（用户本轮没换格式时，缺一条或改了一个行首都重写这块，不要解释）：
 
-**只有本轮用户**粘贴了全文骨架，或点名增删某一条（「不要 5.1」「第 3 条改成…」）时才偏离上面的结构。只改被点名的条目；用户删掉的条目不再输出。数字仍须来自当次 JSON，缺数写 `[数据不可用：原因]`。
+| 行首 | 必须长这样 |
+| --- | --- |
+| 开头 | `您好，同步一下谷歌` |
+| 1 | `1、消耗：` |
+| 2 | `2、展示点击：` |
+| 3 | `3、点击率：` |
+| 4 | `4、平均点击单价：` |
+| 5 | `5、转化：` |
+| 5.1 | `5.1` 且含「有转化的关键词」 |
+| 5.2 | `5.2` 且含「有转化的国家」 |
+| 6 | 单独一行 `6、优化建议：`，①②③ 不写在这一行 |
+| 7 | `7、账户余额：` |
+
+**这些都算没按格式，改回上面的行首再发：**
+
+- 合成一段，或把 ①②③ 写进第 6 行
+- 「一、本周概览」「二、本周发现」「三、下周优化」「四、需要您配合」
+- 代码块前先写一段结论、要点、核心发现
+- 沿用上一轮、另一个账户、或对话里见过的另一套话术
+
+**用户要换格式时很好改：** 本轮粘贴了全文，或点名「不要 5.1」「第 3 条改成…」，就按用户的写，只动被点名的行。没点名的行仍用默认行首。数字仍来自当次 JSON，缺数写 `[数据不可用：原因]`。不要因为上一轮换过格式，这一轮就继续用旧骨架。
 
 ### 填数规则
 

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.59-beta.2'
+$PKG_VERSION = '1.1.59-beta.3'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.59-beta.2"
+readonly PKG_VERSION="1.1.59-beta.3"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/dist/skill/snippets/handoff-p6-okki.md

@@ -45,7 +45,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 **任务**:
 
-1. Read `report-templates/okki-weekly-google-client.md` 中 **§标准四步流程** 与 **§对外客户话术**（默认 7 条、一条一行；主 Agent 若说明用户本轮改了骨架则从其指示）。不要自己改成「一、二、三、四」。
+1. Read `report-templates/okki-weekly-google-client.md` 的 **§对外客户话术**。交回的话术是一个代码块：行首为「您好，同步一下谷歌」、`1、消耗：`、`2、展示点击：`、`3、点击率：`、`4、平均点击单价：`、`5、转化：`、`5.1`、`5.2`、`6、优化建议：`、①②③ 各一行、`7、账户余额：`。主 Agent 若写明用户本轮换了骨架，照那个骨架交回，不要自己再改一版。
 2. 按 `assets/okki-weekly-report.schema.json` 写 `okki-weekly-report.json`：只填 `meta` + `narrative.sheetAnalysis`（5 Sheet，各 summary≥1 / suggestions≥1）+ `narrative.review`（固定 5 维：账户/关键词/搜索字词/设备/国家，每维 overview+summary+suggestion）。表为空也须写分析。`campaign-device` 的 `deviceType` 是 `Desktop`/`Mobile`/`Tablet`（不是 `DESKTOP`/`MOBILE`）；设备消耗按 `toLowerCase()` / `includes("desktop")` 分类累加，**禁止** `.get("DESKTOP")`。
 3. 执行：
    ```bash
@@ -57,4 +57,4 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
    失败则按 stderr 补 JSON 后重跑，不得改用手写表。
 4. 设备/国家必须来自 `campaign-device` / `geo-targeted`（由 render 校验）。国家不要用 `campaign-geo-matched`，那会把已移除的国家算进来。
 
-**returnSchema**: xlsx 路径 + `okki-render` exitCode + 客户话术文本（默认 7 条、一条一行）。勿贴 xlsx 二进制。
+**returnSchema**: xlsx 路径 + `okki-render` exitCode + 客户话术代码块（行首见任务 1；用户本轮换过骨架则用用户的）。勿贴 xlsx 二进制，勿另附「结论先行」摘要。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.59-beta.2",
+  "version": "1.1.59-beta.3",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",