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

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli@beta
+npm install -g siluzan-tso-cli
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,7 +51,6 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.59-beta.2），供内部测试使用。正式发布后安装命令将改为 `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 {
@@ -4049,7 +4051,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
   }
 });
 
@@ -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",
+  "publishedAt": 1793103761036
 }

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/accounts/accounts-list.md

@@ -170,7 +170,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---

package/dist/skill/references/accounts/accounts-permissions.md

@@ -490,7 +490,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 
 | 功能                                    | 媒体   | 网页路径                                          |
 | --------------------------------------- | ------ | ------------------------------------------------- |
-| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
+| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 
 **Agent 建议话术**：
 
@@ -499,5 +499,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 siluzan-tso config show   # 查看 webUrl 字段
 
 # 账户激活（Google）→ 引导至账户管理页
-# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
+# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
 ```

package/dist/skill/references/accounts/finance.md

@@ -126,7 +126,7 @@ siluzan-tso config show
 
 ### 充值页链接（按媒体 × 类型）
 
-链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
 
 | 充值类型                  | `<page>`              | 支持媒体（`mediaType` 参数）                |
 | ------------------------- | --------------------- | ------------------------------------------- |