siluzan-tso-cli 1.1.53-beta.2 → 1.1.53-beta.4

package/README.md

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

package/dist/index.js

@@ -2467,7 +2467,13 @@ function rawRequest(url, options) {
       }
       reject(err);
     });
-    if (options.body) req.write(options.body);
+    if (options.body !== void 0) {
+      const payload = typeof options.body === "string" ? Buffer.from(options.body) : options.body;
+      if (!headers["Content-Length"] && !headers["content-length"]) {
+        req.setHeader("Content-Length", payload.length);
+      }
+      req.write(payload);
+    }
     req.end();
   });
 }
@@ -2562,6 +2568,20 @@ function formatHttpError(status, rawBody, opts) {
 function buildAuthHeaders(config) {
   return buildSiluzanAuthHeaders(config);
 }
+async function parseApiResponse(status, text2, verbose) {
+  if (status < 200 || status >= 300) {
+    throw new Error(formatHttpError(status, text2, { verbose }));
+  }
+  if (!text2.trim()) return null;
+  try {
+    return parseJsonWithStringIds(text2);
+  } catch {
+    if (verbose) {
+      console.error(`  \u26A0\uFE0F  \u54CD\u5E94\u975E JSON\uFF0C\u539F\u59CB\u5185\u5BB9\uFF1A${redactSensitive(text2).slice(0, 200)}`);
+    }
+    return text2;
+  }
+}
 async function apiFetch(url, config, options = {}, verbose = false) {
   const method = options.method ?? "GET";
   const reqHeaders = {
@@ -2580,19 +2600,7 @@ async function apiFetch(url, config, options = {}, verbose = false) {
     headers: reqHeaders,
     body
   });
-  const text2 = res.text;
-  if (res.status < 200 || res.status >= 300) {
-    throw new Error(formatHttpError(res.status, text2, { verbose }));
-  }
-  if (!text2.trim()) return null;
-  try {
-    return parseJsonWithStringIds(text2);
-  } catch {
-    if (verbose) {
-      console.error(`  \u26A0\uFE0F  \u54CD\u5E94\u975E JSON\uFF0C\u539F\u59CB\u5185\u5BB9\uFF1A${redactSensitive(text2).slice(0, 200)}`);
-    }
-    return text2;
-  }
+  return parseApiResponse(res.status, res.text, verbose);
 }
 async function apiFetchWithHeaders(url, config, options = {}, verbose = false) {
   const method = options.method ?? "GET";
@@ -134432,16 +134440,23 @@ function parseInquiryRecords(raw) {
   for (const item of list) {
     if (!item || typeof item !== "object") continue;
     const row = item;
-    const countryZh = pick(row, ["countryZh", "country", "\u56FD\u5BB6", "\u56FD\u5BB6(\u4E2D\u6587)"]);
-    const date = pick(row, ["date", "\u65F6\u95F4", "time"]);
+    const countryZh = pick(row, [
+      "\u76EE\u6807\u56FD\u5BB6/\u5730\u533A",
+      "countryZh",
+      "country",
+      "\u56FD\u5BB6",
+      "\u56FD\u5BB6(\u4E2D\u6587)"
+    ]);
+    const date = pick(row, ["\u8BE2\u76D8\u65E5\u671F", "date", "\u65F6\u95F4", "time"]);
     const month = normalizeMonth(pick(row, ["month", "\u6708\u4EFD", "ym"]), date || void 0);
     if (!countryZh && !month) continue;
     out.push({
       month,
       countryZh,
       date: date || void 0,
-      product: pick(row, ["product", "\u4EA7\u54C1"]) || void 0,
-      source: pick(row, ["source", "\u5BA2\u6237\u6765\u6E90", "\u6765\u6E90"]) || void 0
+      product: pick(row, ["\u4EA7\u54C1/\u54C1\u7C7B", "product", "\u4EA7\u54C1"]) || void 0,
+      source: pick(row, ["\u8BE2\u76D8\u6765\u6E90\u5173\u952E\u8BCD", "source", "\u5BA2\u6237\u6765\u6E90", "\u6765\u6E90"]) || void 0,
+      quality: pick(row, ["\u8BE2\u76D8\u8D28\u91CF\u5206\u7EA7", "qualityGrade", "quality"]) || void 0
     });
   }
   return out;
@@ -134464,20 +134479,36 @@ function countByCountry(rows) {
 }
 
 // src/commands/google-quarterly/plan-defaults.ts
+var PLAN_MONTH_SHARES = [0.3, 0.35, 0.35];
+function splitSuggested(spendLow) {
+  const a = round22(spendLow * PLAN_MONTH_SHARES[0]);
+  const b = round22(spendLow * PLAN_MONTH_SHARES[1]);
+  const c = round22(spendLow - a - b);
+  return [a, b, c];
+}
 function buildSpendPlanDefaults(currentSpend) {
   if (!(currentSpend > 0)) {
     return {
       currentSpend: 0,
+      spendFloor: null,
       spendLow: null,
       spendHigh: null,
-      note: "\u672C\u671F\u65E0\u82B1\u8D39\uFF0C\u65E0\u6CD5\u7ED9\u9ED8\u8BA4\u9884\u7B97"
+      monthShares: PLAN_MONTH_SHARES,
+      monthSuggested: null,
+      note: "\u672C\u671F\u65E0\u82B1\u8D39\uFF0C\u65E0\u6CD5\u7ED9\u9ED8\u8BA4\u9884\u7B97\uFF1B\u7981\u6B62\u624B\u7F16\u91D1\u989D"
     };
   }
+  const floor = round22(currentSpend);
+  const low = round22(currentSpend * 1.3);
+  const high = round22(currentSpend * 1.5);
   return {
-    currentSpend: round22(currentSpend),
-    spendLow: round22(currentSpend * 1.3),
-    spendHigh: round22(currentSpend * 1.5),
-    note: "\u9ED8\u8BA4\u76EE\u6807\uFF1A\u82B1\u8D39\u8F83\u672C\u671F\u63D0\u5347 30%\uFF5E50%"
+    currentSpend: floor,
+    spendFloor: floor,
+    spendLow: low,
+    spendHigh: high,
+    monthShares: PLAN_MONTH_SHARES,
+    monthSuggested: splitSuggested(low),
+    note: "\u4E09\u6863\u57FA\u4E8E\u672C\u671F\u82B1\u8D39\u80FD\u529B\uFF0C\u4E0D\u662F\u5BA2\u6237\u5DF2\u6279\u9884\u7B97\uFF1B\u5EFA\u8BAE\u6863\u6708\u5EA6\u9ED8\u8BA4 30%/35%/35%\uFF1BCPA / \u8BE2\u76D8\u4E0D\u5916\u63A8"
   };
 }
 
@@ -134490,14 +134521,19 @@ var continentMap = null;
 function continentsPath() {
   const dir = path27.dirname(fileURLToPath6(import.meta.url));
   const candidates = [
+    // dist/index.js → dist/skill/references/...
+    path27.join(dir, "skill", "references", "analytics", "geo-continents.json"),
     path27.join(dir, "skill", "siluzan-ads", "references", "analytics", "geo-continents.json"),
+    // dist/index.js → tso-cli/assets/...
+    path27.join(dir, "..", "assets", "siluzan-ads", "references", "analytics", "geo-continents.json"),
+    // src/commands/google-quarterly/region.ts → tso-cli/assets/...
     path27.join(dir, "..", "..", "assets", "siluzan-ads", "references", "analytics", "geo-continents.json"),
     path27.join(dir, "..", "..", "..", "assets", "siluzan-ads", "references", "analytics", "geo-continents.json")
   ];
   for (const p of candidates) {
     if (fs22.existsSync(p)) return p;
   }
-  return candidates[1];
+  return candidates[0];
 }
 function loadContinentMap() {
   if (continentMap) return continentMap;
@@ -134538,6 +134574,12 @@ function countByRegion(countryCounts, continents = loadContinentMap()) {
 }
 
 // src/commands/google-quarterly/special-ads.ts
+var EXPLORE_TYPE_META = [
+  { id: "video", label: "\u89C6\u9891 / YouTube", role: "\u54C1\u724C\u58F0\u91CF", title: "\u89C6\u9891 / YouTube \u54C1\u724C\u58F0\u91CF", chip: "\u54C1\u724C\u58F0\u91CF" },
+  { id: "pmax", label: "\u6548\u679C\u6700\u5927\u5316", role: "\u8F6C\u5316\u6548\u7387", title: "\u6548\u679C\u6700\u5927\u5316", chip: "\u8DE8\u6E20\u9053\u6548\u679C" },
+  { id: "demand", label: "\u9700\u6C42\u5F00\u53D1 / \u53D1\u73B0", role: "\u5185\u5BB9\u79CD\u8349", title: "\u9700\u6C42\u5F00\u53D1 / \u53D1\u73B0\u5E7F\u544A", chip: "\u5185\u5BB9\u79CD\u8349" },
+  { id: "display", label: "\u5C55\u793A", role: "\u518D\u8425\u9500", title: "\u5C55\u793A\u5E7F\u544A", chip: "\u8986\u76D6\xB7\u518D\u8425\u9500" }
+];
 function hasTraffic(row) {
   return rowSpend(row) > 0 || num2(row.impressions) > 0 || num2(row.clicks) > 0;
 }
@@ -134588,6 +134630,27 @@ function fromCampaign(row) {
     conversions: num2(row.conversions)
   };
 }
+function sortBySpend(items3) {
+  return [...items3].sort((a, b) => b.spend - a.spend);
+}
+function metricsFromRows(items3) {
+  let spend = 0;
+  let impressions = 0;
+  let clicks = 0;
+  let conversions = 0;
+  for (const row of items3) {
+    spend += row.spend;
+    impressions += row.impressions;
+    clicks += row.clicks;
+    conversions += row.conversions;
+  }
+  return withRates({ spend, impressions, clicks, conversions });
+}
+function campaignsInBucket(campaigns, bucket) {
+  return sortBySpend(
+    campaigns.filter((row) => channelBucket(row.channelTypeV2) === bucket && hasTraffic(row)).map(fromCampaign)
+  );
+}
 function pickYoutubeAdSubscriptions(actions) {
   const hits = actions.filter((row) => {
     const name2 = pickStr2(row, ["name", "Name", "conversionAction"]).toLowerCase();
@@ -134608,32 +134671,47 @@ function pickYoutubeAdSubscriptions(actions) {
     note: "\u53E3\u5F84=Google Ads \u8F6C\u5316\u52A8\u4F5C\uFF08YouTube \u8BA2\u9605\uFF09\uFF0C\u4E0D\u662F\u9891\u9053\u7C89\u6570"
   };
 }
-function pickSpecialAds(videos, campaigns) {
-  const videoHits = videos.filter(hasTraffic);
-  if (videoHits.length > 0) {
+function videoRowsFromReport(videos) {
+  return sortBySpend(videos.filter(hasTraffic).map(fromVideo));
+}
+function buildExploreAds(videos, campaigns, accountSpend) {
+  const videoFromReport = videoRowsFromReport(videos);
+  const videoItems = videoFromReport.length > 0 ? videoFromReport : campaignsInBucket(campaigns, "\u89C6\u9891");
+  const byId = {
+    video: videoItems,
+    pmax: campaignsInBucket(campaigns, "\u6548\u679C\u6700\u5927\u5316"),
+    demand: campaignsInBucket(campaigns, "\u53D1\u73B0"),
+    display: campaignsInBucket(campaigns, "\u5C55\u793A")
+  };
+  const types = EXPLORE_TYPE_META.map((meta) => {
+    const items3 = byId[meta.id];
     return {
-      source: "youtube",
-      label: "YouTube / \u89C6\u9891\u5E7F\u544A",
-      items: videoHits.map(fromVideo).sort((a, b) => b.spend - a.spend)
+      ...meta,
+      spend: items3.reduce((sum, row) => sum + row.spend, 0),
+      metrics: metricsFromRows(items3),
+      items: items3
     };
+  });
+  return {
+    types,
+    accountSpend,
+    hasAny: types.some((t) => t.items.length > 0)
+  };
+}
+function pickSpecialAds(videos, campaigns) {
+  const videoHits = videoRowsFromReport(videos);
+  if (videoHits.length > 0) {
+    return { source: "youtube", label: "YouTube / \u89C6\u9891\u5E7F\u544A", items: videoHits };
   }
-  const pmax = campaigns.filter(
-    (row) => String(row.channelTypeV2 ?? "").toUpperCase() === "PERFORMANCE_MAX" && hasTraffic(row)
-  );
+  const pmax = campaignsInBucket(campaigns, "\u6548\u679C\u6700\u5927\u5316");
   if (pmax.length > 0) {
-    return {
-      source: "pmax",
-      label: "\u6548\u679C\u6700\u5927\u5316",
-      items: pmax.map(fromCampaign).sort((a, b) => b.spend - a.spend)
-    };
+    return { source: "pmax", label: "\u6548\u679C\u6700\u5927\u5316", items: pmax };
   }
-  const other = campaigns.filter((row) => !isSearchChannel(row.channelTypeV2) && hasTraffic(row));
+  const other = sortBySpend(
+    campaigns.filter((row) => !isSearchChannel(row.channelTypeV2) && hasTraffic(row)).map(fromCampaign)
+  );
   if (other.length > 0) {
-    return {
-      source: "other",
-      label: "\u975E\u641C\u7D22\u5E7F\u544A",
-      items: other.map(fromCampaign).sort((a, b) => b.spend - a.spend)
-    };
+    return { source: "other", label: "\u975E\u641C\u7D22\u5E7F\u544A", items: other };
   }
   return { source: "none", label: "", items: [] };
 }
@@ -134728,7 +134806,8 @@ function buildQuarterlyFacts(input) {
   });
   const videos = input.currentSnap.videos ?? [];
   const specialAds = pickSpecialAds(videos, input.currentSnap.campaigns);
-  const videoRows = specialAds.source === "youtube" ? specialAds.items : [];
+  const exploreAds = buildExploreAds(videos, input.currentSnap.campaigns, currentMetrics.spend);
+  const videoRows = videoRowsFromReport(videos);
   const videoImpr = videoRows.reduce((s, r) => s + r.impressions, 0);
   const videoSpend = videoRows.reduce((s, r) => s + r.spend, 0);
   const videoClicks = videoRows.reduce((s, r) => s + r.clicks, 0);
@@ -134809,6 +134888,7 @@ function buildQuarterlyFacts(input) {
     countries,
     usStates,
     specialAds,
+    exploreAds,
     videosSummary: {
       impressions: videoImpr,
       spend: videoSpend,
@@ -134869,6 +134949,25 @@ function roundFacts(facts) {
       ...facts.videosSummary,
       spend: round22(facts.videosSummary.spend),
       averageCpv: facts.videosSummary.averageCpv == null ? null : round22(facts.videosSummary.averageCpv)
+    },
+    exploreAds: {
+      ...facts.exploreAds,
+      accountSpend: round22(facts.exploreAds.accountSpend),
+      types: facts.exploreAds.types.map((t) => ({
+        ...t,
+        spend: round22(t.spend),
+        metrics: {
+          ...t.metrics,
+          spend: round22(t.metrics.spend),
+          cpc: round22(t.metrics.cpc),
+          cpa: round22(t.metrics.cpa)
+        },
+        items: t.items.map((row) => ({
+          ...row,
+          spend: round22(row.spend),
+          averageCpv: row.averageCpv == null ? row.averageCpv : round22(row.averageCpv)
+        }))
+      }))
     }
   };
 }
@@ -135054,6 +135153,7 @@ async function runGoogleQuarterlyCollect(opts) {
       ],
       inquiryNote: facts.meta.inquiryNote,
       specialAds: facts.specialAds.source,
+      exploreAds: facts.exploreAds.types.filter((t) => t.items.length > 0).map((t) => t.id),
       planDefaults: facts.planDefaults
     }
   };
@@ -135066,6 +135166,7 @@ async function runGoogleQuarterlyCollect(opts) {
       accountId,
       current,
       specialAds: facts.specialAds.source,
+      exploreAds: facts.exploreAds.types.filter((t) => t.items.length > 0).map((t) => t.id),
       inquirySource: facts.meta.inquirySource,
       usGeoSource: facts.meta.usGeoSource,
       drillCountry: facts.meta.drillCountry,

package/dist/skill/AGENTS.md

@@ -12,6 +12,7 @@
 | 命令参数 / 字段    | 路由表「必读文档」                          |
 | 纪律与对用户怎么说 | `references/core/agent-conventions.md`      |
 | 报告结构纲要       | `report-templates/*.md`（勿读 `*.html`）    |
+| P10 下期规划怎么写 | `report-templates/google-quarterly-plan.md` |
 
 ## 启动顺序
 

package/dist/skill/SKILL.md

@@ -121,7 +121,7 @@ siluzan-tso -h
 | ------------------ | ------ | -------- |
 | Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |
 | Google 账户周期 **数据汇总**（只要花费/转化/8 维/Excel；**无**规划/客户版/大族） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |
-| Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md`（询盘载体须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；花费默认 +30%～+50%；**不做**行业数据） |
+| Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md` + **`report-templates/google-quarterly-plan.md`**（**未带询盘表须先问并等待**，禁止不问就 collect；有表须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；规划九章；花费三档基于本期、不是已批预算；**不做**行业数据） |
 | Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |
 | TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |
 | Yandex 账户分析 / 周期 / 月报 | **P4** | `report-templates/yandex-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `yandex-period-report-excel.md` |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.53-beta.2",
-  "publishedAt": 1789552686722
+  "version": "1.1.53-beta.4",
+  "publishedAt": 1789721782096
 }

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "siluzan-tso/google-quarterly-report.schema.json",
   "title": "GoogleQuarterlyReport",
-  "description": "Google 季度经营报告。Agent 只写 narrative；kpis/monthly/specialAds/planDefaults/usStates（消耗最高国家的一级行政区）由 collect 覆盖。",
+  "description": "Google 季度经营报告。Agent 只写 narrative；kpis/monthly/exploreAds/specialAds/planDefaults/usStates（消耗最高国家的一级行政区）由 collect 覆盖。",
   "type": "object",
   "required": ["narrative"],
   "properties": {
@@ -29,7 +29,7 @@
             "summary": { "$ref": "#/$defs/analysisBlock" }
           }
         },
-        "plan": { "$ref": "#/$defs/analysisBlock" }
+        "plan": { "$ref": "#/$defs/planBlock" }
       }
     }
   },
@@ -41,6 +41,22 @@
         "goals": { "type": "array", "items": { "type": "string" } },
         "text": { "type": "string" }
       }
+    },
+    "planBlock": {
+      "type": "object",
+      "description": "下期规划九章。analysis 必填；其余八章写规划时都应有。规则见 report-templates/google-quarterly-plan.md。",
+      "properties": {
+        "analysis": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "goals": { "$ref": "#/$defs/analysisBlock" },
+        "budget": { "$ref": "#/$defs/analysisBlock" },
+        "structure": { "$ref": "#/$defs/analysisBlock" },
+        "keywords": { "$ref": "#/$defs/analysisBlock" },
+        "audience": { "$ref": "#/$defs/analysisBlock" },
+        "creative": { "$ref": "#/$defs/analysisBlock" },
+        "roadmap": { "$ref": "#/$defs/analysisBlock" },
+        "risks": { "$ref": "#/$defs/analysisBlock" },
+        "text": { "type": "string" }
+      }
     }
   }
 }

package/dist/skill/references/README.md

@@ -108,6 +108,7 @@
 | ---------------------------------------------------------------- | ------------------------------ |
 | `google-period-report.md`                                        | Google 账户周期/月度报告（P4） |
 | `google-quarterly-report.md`                                     | Google 季度经营报告（P10）     |
+| `google-quarterly-plan.md`                                       | P10 下期规划规则（九章）       |
 | `google-period-report-excel.md`                                  | P4 用户要 Excel                |
 | `stats-daily-excel.md`                                           | P4-DAILY 按日 Excel            |
 | `meta-period-report.md` / `meta-period-report-excel.md`          | Meta 周期（P4-FB）             |

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

@@ -535,6 +535,7 @@ siluzan-tso yandex-analysis insights -a <porg-xxx> --json-out ./snap-yandex \
 | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
 | `google-period-report.md`            | Google 周期汇总报告章节                                                                                         |
 | `google-quarterly-report.md`         | Google 季度经营报告（`google-quarterly collect`+`render`，P10）                                                 |
+| `google-quarterly-plan.md`           | P10 下期规划规则（写 `narrative.plan` 前必读）                                                                  |
 | `google-account-diagnosis-report.md` | Google 诊断报告纲要                                                                                             |
 | `google-ads-diagnosis.md`            | Google Ads 诊断报告完整骨架                                                                                     |
 | `meta-period-report.md`              | Meta（Facebook）周期报告                                                                                        |

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

@@ -180,6 +180,8 @@
 
 涉及「投放数据 / 消耗 / 报告 / 周报 / 月报 / 优化建议」且用户未给明确起止日期时**必须反问**（示例：A) 最近完整自然周 B) 本月 1 号到昨天 C) 自定义 YYYY-MM-DD）。给出范围后，报告首行标注 `统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`。
 
+**P10 询盘表**：季度/月度经营报告若用户**没附**询盘表，必须先问有没有、等回复；未回答前禁止 `google-quarterly collect` / render。用户说「没有」再继续。话术见 `report-templates/google-quarterly-report.md`「询盘入场」。
+
 **例外**（不反问）：
 
 - `list-accounts` 列全部 / 数个数：一次 `list-accounts -m <媒体> --page-size 999 --json-out <dir>`，脚本读落盘 `total` / `items[]`；**禁止**默认 page-size 20 再翻页（详见 `references/accounts/accounts-list.md` § Agent 意图速查）。

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

@@ -323,9 +323,9 @@
 | P1 / P4 / P10 | 账户 ID    | 「请提供 Google 广告账户 ID（mediaCustomerId）。」                |
 | P1 / P4     | 时间         | 按 `agent-conventions.md` §五 反问区间                            |
 | P10         | 时间         | 季度话术可省略（上一完整季）；月度报告 / 下月规划用上一完整月或用户指定月 |
-| P10         | 询盘附件     | 先转 `inquiries.json` 再 `--inquiries`；**禁止**把 xlsx/csv 原文件传给 collect |
+| P10         | 询盘附件     | **未带表先问「有没有本期询盘表」并等待**；有则先看一眼表头再转 `inquiries.json` 给 `--inquiries`；用户说没有再 collect。**禁止**不问就出报告；**禁止**把 xlsx/csv 原文件传给 collect |
 | P6          | 非 OKKI 话术 | 若用户实际要普通周期报告 → 改 P4 并说明                           |
-| P7          | 无询盘文件   | 贴字段清单，**禁止编造询盘**；若用户只要账户级零转化 → 改 **P3**  |
+| P7          | 无询盘文件   | 贴字段清单，**禁止编造询盘**；用表前先看一眼表头；若用户只要账户级零转化 → 改 **P3**  |
 | P3（§零·D） | 时间区间     | 按 `agent-conventions.md` §五 反问；巡检默认近 7 天须写明区间     |
 | W3          | 预算/地域    | 先列待确认项，再进入 campaign-plan 流水线                         |
 

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

@@ -154,7 +154,7 @@
 - **时间窗口强约束**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月，**禁止**扩展到 7 个月。
 - **步骤**：
   1. （可选）Read `subagent-orchestration.md` § P7。
-  2. 询盘资料入场：用户附文件 → 解析落盘 `./snap-inquiry/inquiries.json`；仅给账户 ID → 反问账户 + 分析月份并贴字段清单，**禁止编造询盘数据**。
+  2. 询盘资料入场：用户附文件 → 先看一眼表头再落盘 `./snap-inquiry/inquiries.json`（列名接近即可）；仅给账户 ID → 反问账户 + 分析月份并贴字段清单，**禁止编造询盘数据**。
   3. CLI 拉数（同一目录）：`list-accounts`、`google-analysis --sections campaigns,keywords,search-terms,campaign-geo`，并按月拉 `m1/m2/m3` 的 `campaigns,geographic`。
   4. 脚本聚合计算 8 Sheet 数据；国家→大洲映射读 `geo-continents.json`，**禁止**硬编码国家名。
 - **产物**：必产 8 Sheet xlsx（版式见模板），**只能**由 Agent 脚本生成，**禁止**假设 `… excel` 子命令存在。
@@ -195,14 +195,14 @@
 ## P10 · Google 季度经营报告
 
 - **触发**（命中越多越稳）：Google/谷歌广告 **月度报告**、**月总结与规划**、**季度报告**、**Q3 汇总**、**Q4 规划**、**季度汇报**、**投放季报**、客户版/对外、大族模板、下月规划；或要「效率 + 区域询盘 + 国家明细 + 规划」；或「结论→效率→结构→新探索→总结→Q4」。**不是** P1 诊断、**不是** P4「只要花费转化」的周期表。用户提「行业参考」仍走 P10，**禁止编造行业数**（本批无行业章）。
-- **必读**：`report-templates/google-quarterly-report.md`。
+- **必读**：`report-templates/google-quarterly-report.md`；写 `narrative.plan` 前再 Read `report-templates/google-quarterly-plan.md`。
 - **默认产物**：**HTML**（`google-quarterly render`）。
 - **步骤**：
   1. 确认账户与区间：季度话术省略日期 → 上一完整自然季；**月度报告 / 下月规划** → 上一完整自然月（或用户指定月）作 `--start/--end`。
-  2. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p10`（取户名、币种）。
-  3. **询盘载体 → JSON（CLI 不读 xlsx）**：用户给了 xlsx / csv / 截图 / 粘贴表 → Agent 抽行落盘 `./snap-p10/inquiries.json`（字段见 `google-quarterly-report.md`「询盘入场」）再 `--inquiries`；**禁止**把原始文件传给 collect。无载体可 `--inquiry-conversion <名>`；再没有则询盘位留空，**禁止编造**。
-  4. `google-quarterly collect -a <id> --start <S> --end <D> --json-out ./snap-p10 --account-name "<名>"`（可选 `--keyword-seeds`）。YouTube 广告层用 Ads 视频报表，不拉频道订阅总数 / 来源饼 / 视频类型。
+  2. **询盘未入场则先问再停**（话术见 `google-quarterly-report.md`「询盘入场」）。没有表格且用户未说「没有」时，**禁止** collect / 写 narrative / render。用户发来表 → 抽行落盘 `./snap-p10/inquiries.json` 再 `--inquiries`（**禁止**把 xlsx 原文件传给 collect）；用户说没有 → 询盘位留空（可选 `--inquiry-conversion`，须用户点名），**禁止编造**。
+  3. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p10`（取户名、币种）。可与等询盘回复并行，但 collect 必须等询盘问完。
+  4. `google-quarterly collect -a <id> --start <S> --end <D> --json-out ./snap-p10 --account-name "<名>"`（可选 `--keyword-seeds`）。新探索四类并行（视频 / PMax / 发现 / 展示）；视频用 Ads 视频报表，不拉频道订阅总数 / 来源饼 / 视频类型。
   5. 读 `google-quarterly-collect.json`，只写 `narrative` 到 `google-quarterly.json`（禁止改 kpis / monthly / planDefaults 数字）。
-  6. 下期规划默认花费 +30%～+50%（用 `planDefaults.spendLow`～`spendHigh`）；CPA/询盘目标不自动外推。
+  6. 下期规划按 `google-quarterly-plan.md` 写九章。预算默认三档（维持本期 / +30% / +50%）+ 建议档月度 30/35/35，标「基于历史数据」，不是已批预算；CPA/询盘不外推；禁止自动调价/暂停指令。
   7. `google-quarterly render --data ./snap-p10/google-quarterly.json --out ./snap-p10/google-quarterly-report.html`。
-- **产物**：HTML 路径；专项广告无量则模板自动隐藏该章。
+- **产物**：HTML 路径；新探索（视频 / PMax / 发现 / 展示）全无量则模板自动隐藏该章。

package/dist/skill/references/report-templates/README.md

@@ -22,7 +22,8 @@
 | 文件                                         | 适用场景                                                                                                                                                          |
 | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `google-period-report.md`                    | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML                                                                           |
-| `google-quarterly-report.md` / `.html`       | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费默认 +30%～+50%；无行业章                                                                |
+| `google-quarterly-report.md` / `.html`       | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章                                                                |
+| `google-quarterly-plan.md`                   | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读                                                                                                 |
 | `google-period-report-excel.md`              | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令                                                   |
 | `stats-daily-excel.md`                       | **P4-DAILY**：账户级按日 Excel（`stats --by-day`）                                                                                                                |
 | `google-account-diagnosis-report.md`         | Google 账户深度诊断（健康度/转化/结构等）                                                                                                                         |

package/dist/skill/references/report-templates/google-inquiry-analysis.md

@@ -44,9 +44,9 @@
 2. 同时贴出**询盘字段清单 + 1 行示例**，让用户用任意方式补齐再回传：
 
    ```
-   请把近 3 个月（{S} ~ {E}）的询盘记录回贴或上传（Excel / CSV / 截图 / 文本表格均可），字段如下：
-   月份 | 序号(可空) | 国家(中文) | 时间(YYYY-MM-DD 或 Excel 序列) | 产品 | 客户来源 | IP(可空)
-   示例：4月份 | 1 | 印度 | 2026-04-12 | 滴灌带 | WhatsApp(www.extruder.cn)
+   请把近 3 个月（{S} ~ {E}）的询盘记录回贴或上传（Excel / CSV / 截图 / 文本表格均可），字段如下（* 为必填）：
+   序号 | 询盘日期* | 询盘来源关键词 | 目标国家/地区* | 产品/品类* | 客户名称/公司 | 联系方式 | 询盘内容摘要 | 询盘质量分级* | 跟进状态 | 是否成交 | 成交金额(USD)
+   示例：1 | 2026-04-12 | WhatsApp | 印度 | 滴灌带 | | | | 合格 | | |
    ```
 
 3. 拿到资料后由宿主 Agent 解析、落盘 `inquiries.json`，再进入「拉数与写 Excel」节。
@@ -58,8 +58,8 @@
 1. **账户**：`mediaCustomerId` 来自 `list-accounts -m Google -k <id>`，**禁止猜 ID**。
 2. **分析月份**：默认**上一个完整自然月**（例：今天 5/13 → 默认 4 月）。用户未明确时**反问**（A) 上月 B) 本月 1 号到昨天 C) 自定义 YYYY-MM）。
 3. **时间窗口（硬约束）**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月。例：分析月 = 2026-04 → `--start 2026-02-01 --end 2026-04-30`。**所有月度表只展示 3 行**（不延伸到 7 个月）。
-4. **询盘字段最小集**：`月份 / 国家(中文) / 时间 / 产品 / 客户来源`；可选 `序号 / IP`。
-5. **日期规范化**：`2026.4.1` / `2026/4/1` 等先规范成 `YYYY-MM-DD` 再传 CLI。
+4. **用询盘数据前先看一眼表头**。常见列见上；* 表示通常要有对应含义的列（`询盘日期`≈时间/date，`目标国家/地区`≈国家，`产品/品类`≈产品，`询盘质量分级`有则用）。列名接近即可，不必逐格校验。
+5. **日期规范化**：`2026.4.1` / `2026/4/1` 等先规范成 `YYYY-MM-DD` 再传 CLI。`月份` 可由询盘日期推导。
 
 ---
 
@@ -155,23 +155,30 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 ```json
 [
   {
-    "month": "4月份",
     "seq": 1,
+    "date": "2026-04-12",
+    "sourceKeyword": "WhatsApp",
     "country": "印度",
-    "time": "2026-04-12",
     "product": "滴灌带",
-    "source": "WhatsApp(www.extruder.cn)",
-    "ip": null
+    "company": null,
+    "contact": null,
+    "summary": null,
+    "quality": "合格",
+    "followUp": null,
+    "won": null,
+    "amountUsd": null
   }
 ]
 ```
 
-- `month`：保留运营原文（`1月份` / `4月份` …）。
-- `country`：**中文名**，与 `countryOrRegionZh` 字典对齐（脚本会自动 lookup 大洲）。Agent 解析时遇到英文/缩写应先翻译为中文，未知国家保留原文并在脚本里标 `未知大洲`。
-- `time`：`YYYY-MM-DD`；Excel 日期序列号也接受，由解析方转换。
-- `product`：自由文本（`滴灌带` / `打包带` / `片材` / `滴头` / `模具` / `贴条` / `涂布水带` …），脚本以此作 Sheet 3 产品维度透视分桶 key。
-- `source`：自由文本（`WhatsApp` / `tawk.to` / `info邮箱` / `网站留言` / `微信(xxxx)` / `阿里巴巴` / `made-in-china` / `Youtube` / `TikTok` …），脚本以此作 Sheet 3 客户来源透视分桶 key。
-- `ip`：可空。
+落盘前先看一眼表头，按含义对上即可（`时间`=`询盘日期`，`国家(中文)`=`目标国家/地区`，`产品`=`产品/品类`）。
+
+- `date`：询盘日期，`YYYY-MM-DD`。
+- `country`：目标国家/地区，中文名，与 `countryOrRegionZh` 字典对齐。
+- `product`：产品/品类，Sheet 3 产品分桶。
+- `sourceKeyword` / `source`：来源，Sheet 3 来源分桶（可空）。
+- `quality` / 其余可选列：有则写入，没有就空着。
+- `month`：可由 `date` 推导。**禁止编造**缺失值。
 
 ---