siluzan-tso-cli 1.1.64-beta.1 → 1.1.64-beta.2

package/README.md

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

package/dist/index.js

@@ -5560,6 +5560,17 @@ function resolveAdAccountId(account, label2 = "-a, --account") {
 function withResolvedAdAccount(opts) {
   return { ...opts, account: resolveAdAccountId(opts.account) };
 }
+function negativeKeywordSlimListUrl(googleApiUrl, accountId, query) {
+  const params = new URLSearchParams();
+  if (query?.appliedLevel) params.set("appliedlevel", query.appliedLevel);
+  if (query?.readDeleted) params.set("readDeleted", "true");
+  if (query?.excludePaused) params.set("excludePaused", "true");
+  const text3 = query?.keywordText?.trim();
+  if (text3) params.set("keywordtext", text3);
+  if (query?.matchType) params.set("matchtype", query.matchType);
+  const qs = params.toString();
+  return `${googleApiUrl}/negativekeywordmanagement/v2/list/${accountId}/slim${qs ? `?${qs}` : ""}`;
+}
 async function findItemInList(listUrl, config, id, verbose) {
   const res = await apiFetch2(listUrl, config, {}, verbose);
   const item = (res.data ?? []).find((x) => x["id"] === id);
@@ -6398,6 +6409,20 @@ function coerceToRowArray(value) {
   }
   return [];
 }
+function dedupeRowsById(items3) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of items3) {
+    const rec = asRecord(item);
+    const id = rec?.id == null ? "" : String(rec.id);
+    if (id) {
+      if (seen.has(id)) continue;
+      seen.add(id);
+    }
+    out.push(item);
+  }
+  return out;
+}
 function asRecord(value) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
   return value;
@@ -6432,7 +6457,7 @@ function wrapGoogleAnalysisSnapshotPayload(section, payload) {
     const bag = asRecord(payload);
     if (bag) {
       const r = readGatewayList(bag);
-      items3 = r.items;
+      items3 = section === "negative-keywords" ? dedupeRowsById(r.items) : r.items;
       meta = r.meta;
     }
   } else if (ROOT_ARRAY_SECTIONS.has(section)) {
@@ -8120,9 +8145,10 @@ var init_sections = __esm({
       },
       {
         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",
+        description: "\u5F53\u524D\u8D26\u6237\u5426\u8BCD negativekeywordmanagement/v2/list/{id}/slim\uFF08id/\u8BCD\u9762/\u5339\u914D/\u7EA7\u522B/\u7CFB\u5217 id/\u5E7F\u544A\u7EC4 id\uFF1B\u4E0D\u6309\u6D88\u8017\u548C\u65E5\u671F\u8FC7\u6EE4\uFF0C0 \u6761\u4E5F\u843D\u76D8\uFF09",
+        // 接口忽略日期。保留 range 是为了快照文件名仍带报告区间，避免和上一次落盘互相覆盖。
         dateMode: "range",
-        path: (id) => `/negativekeywordmanagement/v2/list/${id}`
+        path: (id) => `/negativekeywordmanagement/v2/list/${id}/slim`
       },
       {
         name: "search-terms",
@@ -104342,6 +104368,8 @@ function mapNegativeKeywordRows(rows) {
     if (id && seen.has(id)) continue;
     if (id) seen.add(id);
     const level = String(row.negativeLevel ?? "").trim();
+    const campaignId = String(row.campaignId ?? "").trim();
+    const adGroupId = String(row.adGroupId ?? "").trim();
     const campaignName = String(row.campaignName ?? "").trim();
     const adGroupName = String(row.adGroupName ?? "").trim();
     mapped.push({
@@ -104349,6 +104377,8 @@ function mapNegativeKeywordRows(rows) {
       matchType: String(row.matchTypeV2 ?? row.matchType ?? "\u2014"),
       level: level || "\u2014",
       levelZh: NEGATIVE_LEVEL_ZH[level] ?? (level || "\u2014"),
+      campaignId: campaignId || "\u2014",
+      adGroupId: adGroupId || "\u2014",
       campaignName: campaignName || "\u2014",
       adGroupName: adGroupName || "\u2014"
     });
@@ -115257,6 +115287,7 @@ function resolveKeywordTexts(opts) {
 }
 function firstKeywordTextFromRecord(k) {
   const kt = k["keywordText"];
+  if (typeof kt === "string") return kt;
   if (Array.isArray(kt) && kt.length > 0 && typeof kt[0] === "string") {
     return kt[0];
   }
@@ -115266,9 +115297,27 @@ function firstKeywordTextFromRecord(k) {
   }
   return "";
 }
+function negativeKeywordWriteBody(row) {
+  const text3 = firstKeywordTextFromRecord(row);
+  const body = {
+    id: row["id"],
+    keywordText: text3 ? [text3] : [],
+    matchTypeV2: row["matchTypeV2"],
+    negativeLevel: row["negativeLevel"]
+  };
+  const campaignId = row["campaignId"];
+  const adGroupId = row["adGroupId"];
+  if (typeof campaignId === "string" && campaignId) body["campaignId"] = campaignId;
+  if (typeof adGroupId === "string" && adGroupId) body["adGroupId"] = adGroupId;
+  return body;
+}
 function toNegativeKeywordAppliedLevelQuery(level) {
   return level === "AdGroup" ? "Ad group" : level;
 }
+function filterNegativeKeywordsByMatchType(items3, matchType) {
+  const want = matchType.toLowerCase();
+  return items3.filter((item) => String(item["matchTypeV2"] ?? "").toLowerCase() === want);
+}
 function keywordRowToYuan(item) {
   const { maxCPC: rawMaxCpc, ...rest } = item;
   if (rawMaxCpc == null) return item;
@@ -115278,14 +115327,20 @@ async function runAdKeywords(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  if (opts.negative && opts.level) {
-    params.set("appliedlevel", toNegativeKeywordAppliedLevelQuery(opts.level));
+  let url;
+  if (opts.negative) {
+    url = negativeKeywordSlimListUrl(googleApiUrl, opts.account, {
+      appliedLevel: opts.level ? toNegativeKeywordAppliedLevelQuery(opts.level) : void 0,
+      keywordText: opts.keywordText,
+      excludePaused: opts.excludePaused,
+      readDeleted: opts.readDeleted
+    });
+  } else {
+    const params = new URLSearchParams();
+    params.set("startDate", toGoogleDate(opts.startDate, -30));
+    params.set("endDate", toGoogleDate(opts.endDate, 0));
+    url = `${googleApiUrl}/keywordmanagement/v2/list/${opts.account}?${params}`;
   }
-  const endpoint = opts.negative ? "negativekeywordmanagement" : "keywordmanagement";
-  const url = `${googleApiUrl}/${endpoint}/v2/list/${opts.account}?${params}`;
   let data;
   try {
     data = await apiFetch2(url, config, {}, opts.verbose);
@@ -115297,12 +115352,15 @@ async function runAdKeywords(opts) {
   }
   const rawItems = data.data ?? [];
   const seen = /* @__PURE__ */ new Set();
-  const items3 = rawItems.filter((item) => {
+  let items3 = rawItems.filter((item) => {
     const key = item["id"];
     if (key !== void 0 && seen.has(key)) return false;
     if (key !== void 0) seen.add(key);
     return true;
   });
+  if (opts.negative && opts.matchType) {
+    items3 = filterNegativeKeywordsByMatchType(items3, opts.matchType);
+  }
   const label2 = opts.negative ? "\u5426\u5B9A\u5173\u952E\u8BCD" : "\u5173\u952E\u8BCD";
   const n = items3.length;
   const displayItems = opts.negative ? items3 : items3.map((row) => keywordRowToYuan(row));
@@ -115310,7 +115368,7 @@ async function runAdKeywords(opts) {
     wrapListJson({ page: 1, pageSize: Math.max(n, 1), total: n, items: displayItems })
   );
   if (await emitCliJsonOrSnapshot(opts, {
-    section: `ad-keywords-${opts.account}-${opts.negative ? "negative" : "positive"}`,
+    section: `ad-keywords-${opts.negative ? "negative" : "positive"}`,
     commandLabel: "ad keywords",
     commandHint: opts.account,
     payload: kwPayload,
@@ -115332,7 +115390,11 @@ ${label2}\uFF08\u8D26\u6237\uFF1A${opts.account}\uFF0C\u7B2C 1 \u9875\uFF0C\u672
       const kwText = Array.isArray(item["keywordText"]) ? item["keywordText"].join(", ") : String(item["text"] ?? item["keywordText"] ?? item["id"] ?? "\u2014");
       const matchType = item["matchTypeV2"] ?? "\u2014";
       const level = item["negativeLevel"] ?? "\u2014";
-      console.log(`  [${matchType}] ${kwText}  id: ${String(item["id"] ?? "")}  \u7EA7\u522B: ${level}`);
+      const campaignId = item["campaignId"] ? `  \u7CFB\u5217: ${String(item["campaignId"])}` : "";
+      const adGroupId = item["adGroupId"] ? `  \u5E7F\u544A\u7EC4: ${String(item["adGroupId"])}` : "";
+      console.log(
+        `  [${matchType}] ${kwText}  id: ${String(item["id"] ?? "")}  \u7EA7\u522B: ${level}${campaignId}${adGroupId}`
+      );
     });
   } else {
     const kwW = Math.min(
@@ -115516,10 +115578,7 @@ async function runAdNegativeKeywordCreate(opts) {
 `);
     process.exit(1);
   }
-  const dateParams = new URLSearchParams();
-  dateParams.set("startDate", toGoogleDate(void 0, -30));
-  dateParams.set("endDate", toGoogleDate(void 0, 0));
-  const listUrl = `${googleApiUrl}/negativekeywordmanagement/v2/list/${opts.account}?${dateParams}`;
+  const listUrl = negativeKeywordSlimListUrl(googleApiUrl, opts.account);
   const readList = async () => {
     try {
       const listed = await apiFetch2(
@@ -115793,10 +115852,7 @@ async function runAdNegativeKeywordEdit(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const dateParams = new URLSearchParams();
-  dateParams.set("startDate", toGoogleDate(opts.startDate, -30));
-  dateParams.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/negativekeywordmanagement/v2/list/${opts.account}?${dateParams}`;
+  const listUrl = negativeKeywordSlimListUrl(googleApiUrl, opts.account);
   let keyword;
   try {
     keyword = await findItemInList(listUrl, config, opts.id, opts.verbose);
@@ -115806,7 +115862,7 @@ async function runAdNegativeKeywordEdit(opts) {
 `);
     process.exit(1);
   }
-  const body = { ...keyword };
+  const body = negativeKeywordWriteBody(keyword);
   if (opts.matchType !== void 0) {
     const base2 = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
     if (!String(base2).trim()) {
@@ -115849,10 +115905,7 @@ async function runAdNegativeKeywordDelete(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const dateParams = new URLSearchParams();
-  dateParams.set("startDate", toGoogleDate(opts.startDate, -30));
-  dateParams.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/negativekeywordmanagement/v2/list/${opts.account}?${dateParams}`;
+  const listUrl = negativeKeywordSlimListUrl(googleApiUrl, opts.account);
   let keyword;
   try {
     keyword = await findItemInList(listUrl, config, opts.id, opts.verbose);
@@ -115864,7 +115917,10 @@ async function runAdNegativeKeywordDelete(opts) {
   }
   const url = `${googleApiUrl}/negativekeywordmanagement/negativekeyword/${opts.account}/${opts.id}`;
   try {
-    await apiDeleteRaw(url, config, { body: JSON.stringify(keyword), verbose: opts.verbose });
+    await apiDeleteRaw(url, config, {
+      body: JSON.stringify(negativeKeywordWriteBody(keyword)),
+      verbose: opts.verbose
+    });
   } catch (err) {
     console.error(`
 \u274C \u5220\u9664\u5426\u5B9A\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
@@ -121142,7 +121198,7 @@ async function fetchLiveSnapshotForCampaign(config, accountId, campaignId, campa
     ),
     fetchList(
       config,
-      `${googleApiUrl}/negativekeywordmanagement/v2/list/${accountId}?${qs}`,
+      negativeKeywordSlimListUrl(googleApiUrl, accountId),
       verbose
     ),
     fetchList(
@@ -127001,11 +127057,18 @@ function register21(program2) {
     }
   );
   adCmd.command("keywords").alias("keyword-list").description(
-    "\u67E5\u8BE2\u5173\u952E\u8BCD\u5217\u8868\uFF08--negative \u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD\uFF0C\u53EF\u7528 --level \u6309\u7CFB\u5217/\u7EC4/\u8D26\u6237\u8FC7\u6EE4\uFF1B\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF1B\u522B\u540D keyword-list\uFF09"
-  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--negative", "\u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD", false).option(
+    "\u67E5\u8BE2\u5173\u952E\u8BCD\u5217\u8868\uFF08--negative \u8D70\u5426\u8BCD\u7CBE\u7B80\u5217\u8868\uFF0C\u53EF\u7528 --level/--keyword/--match-type/--exclude-paused/--read-deleted\uFF1B\u6B63\u5411\u5173\u952E\u8BCD\u65E5\u671F\u9ED8\u8BA4\u8FD1 30 \u5929\uFF1B\u522B\u540D keyword-list\uFF09"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option("--negative", "\u67E5\u8BE2\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u7CBE\u7B80\u5217\u8868\uFF0C\u4E0D\u6309\u65E5\u671F\u8FC7\u6EE4\uFF09", false).option(
     "--level <level>",
     "\u5426\u5B9A\u5173\u952E\u8BCD\u5C42\u7EA7\u8FC7\u6EE4\uFF1AAccount | Campaign | AdGroup\uFF08\u4EC5\u914D\u5408 --negative\uFF1B\u4E0D\u4F20\u5219\u4E09\u7EA7\u90FD\u663E\u793A\uFF09"
-  ).option("--start <date>", "\u5F00\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4 30 \u5929\u524D\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4\u4ECA\u5929\uFF09").option("-t, --token <token>", "Auth Token").option(
+  ).option("--keyword <text>", "\u5426\u5B9A\u5173\u952E\u8BCD\u6587\u672C\uFF0C\u5305\u542B\u5373\u547D\u4E2D\uFF08\u4EC5\u914D\u5408 --negative\uFF0C\u4E0D\u533A\u5206\u5927\u5C0F\u5199\uFF09").option(
+    "--match-type <type>",
+    "\u5426\u5B9A\u5173\u952E\u8BCD\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u4EC5\u914D\u5408 --negative\uFF1B\u6309\u8FD4\u56DE\u7684 matchTypeV2 \u672C\u5730\u8FC7\u6EE4\uFF09"
+  ).option("--exclude-paused", "\u53BB\u6389\u6682\u505C\u7684\u5426\u8BCD\uFF0C\u4EE5\u53CA\u6682\u505C\u7CFB\u5217\u3001\u6682\u505C\u5E7F\u544A\u7EC4\u4E0A\u7684\u5426\u8BCD\uFF08\u4EC5\u914D\u5408 --negative\uFF09", false).option(
+    "--read-deleted",
+    "\u5305\u542B\u5DF2\u79FB\u9664\u7684\u7CFB\u5217\u3001\u5E7F\u544A\u7EC4\uFF08\u5426\u8BCD\u672C\u8EAB\u88AB\u79FB\u9664\u7684\u4ECD\u4E0D\u8FD4\u56DE\uFF1B\u4EC5\u914D\u5408 --negative\uFF09",
+    false
+  ).option("--start <date>", "\u5F00\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4 30 \u5929\u524D\uFF1B\u5426\u8BCD\u7CBE\u7B80\u5217\u8868\u5FFD\u7565\u65E5\u671F\uFF09").option("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF0C\u9ED8\u8BA4\u4ECA\u5929\uFF1B\u5426\u8BCD\u7CBE\u7B80\u5217\u8868\u5FFD\u7565\u65E5\u671F\uFF09").option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
     void 0
@@ -127015,11 +127078,26 @@ function register21(program2) {
         console.error("\n\u274C --level \u53EA\u63A5\u53D7 Account | Campaign | AdGroup\n");
         process.exit(1);
       }
+      const negativeOnly = opts.level || opts.keyword || opts.matchType || opts.excludePaused || opts.readDeleted;
+      if (negativeOnly && !opts.negative) {
+        console.error(
+          "\n\u274C --level / --keyword / --match-type / --exclude-paused / --read-deleted \u53EA\u7528\u4E8E\u5426\u5B9A\u5173\u952E\u8BCD\uFF0C\u8BF7\u52A0\u4E0A --negative\n"
+        );
+        process.exit(1);
+      }
+      if (opts.matchType && !["Broad", "Phrase", "Exact"].includes(opts.matchType)) {
+        console.error("\n\u274C --match-type \u53EA\u63A5\u53D7 Broad | Phrase | Exact\n");
+        process.exit(1);
+      }
       await runAdKeywords({
         token: opts.token,
         account: opts.account,
         negative: opts.negative,
         level: opts.level,
+        keywordText: opts.keyword,
+        matchType: opts.matchType,
+        excludePaused: opts.excludePaused,
+        readDeleted: opts.readDeleted,
         startDate: opts.start,
         endDate: opts.end,
         jsonOut: opts.jsonOut,

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.64-beta.1",
-  "publishedAt": 1793609207587
+  "version": "1.1.64-beta.2",
+  "publishedAt": 1793612804179
 }

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

@@ -78,7 +78,7 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 
 ## Google 账户分析：`google-analysis` 命令
 
-> **重要**：`google-analysis` 是统一入口，所有维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。否词名单用 `--sections negative-keywords`，**不要**另跑 `ad keywords --negative`。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
+> **重要**：`google-analysis` 是统一入口，所有维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。否词名单用 `--sections negative-keywords`，**不要**另跑 `ad keywords --negative`。这份否词是精简列表：`keywordText`、`matchTypeV2`、`negativeLevel`、`campaignId`、`adGroupId`，没有系列名，也不按 `--start` / `--end` 过滤。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
 
 ```bash
 # 单维度

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

@@ -186,10 +186,10 @@ siluzan-tso ad ad-delete -a <accountId> --id <adId>
 ### 查询
 
 ```bash
-siluzan-tso ad keywords -a <accountId> [--negative] [--start/--end <date>] [--json-out ./snap]
+siluzan-tso ad keywords -a <accountId> [--start/--end <date>] [--json-out ./snap]
 ```
 
-带日期时行上有 `conversionsValue`（账户币种的转化价值，不是 `conversions` 次数）。`--json-out` 里直接读这个字段；终端表「转化价值」列在字段缺失时为「—」。否定关键词名单没有这个指标。出价读 `maxCPCYuan`（元）。本列表按账户和日期缓存约 60 秒，**没有** `--fresh`，也**没有** `--id`。`keyword-edit` 回读报「列表仍是」时，等约 60 秒再看 `maxCPCYuan`，不要立刻重跑编辑。
+带日期时行上有 `conversionsValue`（账户币种的转化价值，不是 `conversions` 次数）。`--json-out` 里直接读这个字段；终端表「转化价值」列在字段缺失时为「—」。出价读 `maxCPCYuan`（元）。本列表按账户和日期缓存约 60 秒，**没有** `--fresh`，也**没有** `--id`。`keyword-edit` 回读报「列表仍是」时，等约 60 秒再看 `maxCPCYuan`，不要立刻重跑编辑。否定关键词不要用这条带日期的列表，见下方。
 
 ### 添加关键词
 
@@ -207,6 +207,18 @@ siluzan-tso ad keyword-create \
 
 ### 否定关键词
 
+查询走精简列表 `GET /negativekeywordmanagement/v2/list/{id}/slim`。一条对应一条否词，字段只有 `id`、`keywordText`（字符串）、`matchTypeV2`、`negativeLevel`、`campaignId`、`adGroupId`。没有分页、没有总条数、没有系列名、没有消耗。不传参数就是三级都查，含暂停，不含已移除的系列和广告组。`--start` / `--end` 会被忽略。
+
+```bash
+siluzan-tso ad keywords -a <accountId> --negative [--level Account|Campaign|AdGroup] \
+  [--keyword <文本>] [--match-type Broad|Phrase|Exact] [--exclude-paused] [--read-deleted] \
+  [--json-out ./snap]
+```
+
+`--exclude-paused` 去掉暂停的否词，以及暂停系列、暂停广告组上的否词。账户级没有暂停，不受影响。`--read-deleted` 把已移除的系列、广告组也算进来；否词本身被移除的仍然不返回。两个开关可以一起用。`--keyword` 是包含匹配，不区分大小写。`--match-type` 按返回的 `matchTypeV2` 在本地过滤，不要自己给这个接口拼 `matchtype=BROAD`：网关用旧枚举去比，会得到空列表。
+
+改、删先用这条精简记录组请求体：`keywordText` 要写成单元素数组，再带 `id`、`matchTypeV2`、`negativeLevel`，系列级加 `campaignId`，广告组级再加 `adGroupId`。
+
 **支持空格多词短语**（如 `how to make`、`home cooking`）。匹配类型与 Web 一致：裸词=广泛，`"短语"`=词组，`[词]`=完全；也可用 `--match-type`。多词/带引号时推荐 `--keywords-file`，避免 shell 转义。
 
 **三级层级：** Campaign（系列）/ AdGroup（组）/ **Account（账户级，Sammamish 2026-08 新增）**。不传 `--level` 时按是否传 `--adgroup-id` 自动判断 Campaign / AdGroup（兼容旧用法）；**账户级必须显式传 `--level Account`**，且不能传 `--campaign-id` / `--adgroup-id`。账户级否词一次生效于整个账户下所有系列（对应 Google Ads「Account Settings → Negative keywords」），**无需再去 Google 后台手工应用**——这是本次新增前的旧限制，现已由接口直接支持。

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

@@ -74,7 +74,7 @@ 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   | 否词（当前账户已有否定关键词：词面 / 匹配 / 级别 / 系列 / 广告组）           | `google-analysis --sections negative-keywords`（0 条也要落盘；名单不按本周期消耗过滤）       |
+| 9   | 否词（当前账户已有否定关键词：词面 / 匹配 / 级别 / 系列 id / 广告组 id）           | `google-analysis --sections negative-keywords`（精简列表；0 条也要落盘；不按本周期消耗过滤）       |
 | 10  | 优化建议（根据以上数据给出可执行改进建议）                                   | 不额外拉数，基于已有数据撰写                                                                  |
 
 **在执行任何数据拉取之前**，先向用户展示以下可选维度，询问是否需要追加：
@@ -143,9 +143,9 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
 
 ## 否词（必写）
 
-`negative-keywords-*.json` → `items[]`，合并后是 `tables.negativeKeywords[]`。这是**当前账户已经存在的否定关键词**（系列 / 广告组 / 账户三级），不是本周期的消耗或搜索词。
+`negative-keywords-*.json` → `items[]`，合并后是 `tables.negativeKeywords[]`。这是**当前账户已经存在的否定关键词**（系列 / 广告组 / 账户三级），来自精简列表，不是本周期的消耗或搜索词。
 
-- **呈现**：词面、匹配方式、级别（`levelZh`：账户 / 系列 / 广告组）、广告系列、广告组。0 条时表格写「当前账户否词 0 条」。
+- **呈现**：词面、匹配方式、级别（`levelZh`：账户 / 系列 / 广告组）、`campaignId`、`adGroupId`。精简列表没有系列名和广告组名。账户级没有 `campaignId`，只有广告组级才有 `adGroupId`。旧快照若还有 `campaignName` / `adGroupName` 可以照用。0 条时表格写「当前账户否词 0 条」。
 - **分析** → `narrative.sections.negativeKeywords.{analysis,suggestions}`（≥2 / ≥1）：
   - 先写总条数，再按级别拆开。有词就点名几条；0 条就写「当前否词 0 条」。
   - 其他章节如果建议加否词、出否词清单，必须引用这张表的条数。禁止在没拉到名单时写「账户没有否词」或只在建议里提否词。

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

@@ -74,7 +74,7 @@ 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   | 否词（当前账户已有否定关键词：词面 / 匹配 / 级别 / 系列 / 广告组）           | `google-analysis --sections negative-keywords`（0 条也要落盘；名单不按本周期消耗过滤）       |
+| 9   | 否词（当前账户已有否定关键词：词面 / 匹配 / 级别 / 系列 id / 广告组 id）           | `google-analysis --sections negative-keywords`（精简列表；0 条也要落盘；不按本周期消耗过滤）       |
 | 10  | 优化建议（根据以上数据给出可执行改进建议）                                   | 不额外拉数，基于已有数据撰写                                                                  |
 
 **在执行任何数据拉取之前**，先向用户展示以下可选维度，询问是否需要追加：
@@ -143,9 +143,9 @@ siluzan-tso google-analysis -a <id> --start <s> --end <e> --json-out ./snap-goog
 
 ## 否词（必写）
 
-`negative-keywords-*.json` → `items[]`，合并后是 `tables.negativeKeywords[]`。这是**当前账户已经存在的否定关键词**（系列 / 广告组 / 账户三级），不是本周期的消耗或搜索词。
+`negative-keywords-*.json` → `items[]`，合并后是 `tables.negativeKeywords[]`。这是**当前账户已经存在的否定关键词**（系列 / 广告组 / 账户三级），来自精简列表，不是本周期的消耗或搜索词。
 
-- **呈现**：词面、匹配方式、级别（`levelZh`：账户 / 系列 / 广告组）、广告系列、广告组。0 条时表格写「当前账户否词 0 条」。
+- **呈现**：词面、匹配方式、级别（`levelZh`：账户 / 系列 / 广告组）、`campaignId`、`adGroupId`。精简列表没有系列名和广告组名。账户级没有 `campaignId`，只有广告组级才有 `adGroupId`。旧快照若还有 `campaignName` / `adGroupName` 可以照用。0 条时表格写「当前账户否词 0 条」。
 - **分析** → `narrative.sections.negativeKeywords.{analysis,suggestions}`（≥2 / ≥1）：
   - 先写总条数，再按级别拆开。有词就点名几条；0 条就写「当前否词 0 条」。
   - 其他章节如果建议加否词、出否词清单，必须引用这张表的条数。禁止在没拉到名单时写「账户没有否词」或只在建议里提否词。

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.64-beta.1'
+$PKG_VERSION = '1.1.64-beta.2'
 $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.64-beta.1"
+readonly PKG_VERSION="1.1.64-beta.2"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

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