siluzan-tso-cli 1.1.19-beta.18 → 1.1.19-beta.20

package/README.md

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

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.19-beta.18",
-  "publishedAt": 1778752719300
+  "version": "1.1.19-beta.20",
+  "publishedAt": 1778754720960
 }

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

@@ -149,6 +149,19 @@ for month in <S月, S+1月, E月>:
 - **点击率 / 转化率 / 互动率**（`ctr` / `conversionRate` / `interactionRate`）：CLI 已归一为 **0~1 小数**（schemaVersion: 2），写入 Excel 时**直接写 0~1**（与运营样表对齐，Excel 单元格用百分比格式自动渲染）。话术 `x%` 用 `(v * 100).toFixed(2) + "%"`。
 - **空值**：`interactions === 0` 时「平均费用」「互动率」填 `—`，**禁止**除零。
 
+### 分析输出区位置（**全局硬约束**）
+
+每个 Sheet 的分析输出区（`数据质量提示` / `Agent 数据洞察` / `优化建议` / Sheet 1 议题区与会后补写区）一律遵守：
+
+1. **位置**：放在该 Sheet **全部数据区最末行**下方留空 1 行接续，**从 A 列起**；禁止落在数据行之间。
+2. **最末行计算**：脚本需先算 `lastDataRow = MAX(各数据区的最末行号)`，再从 `lastDataRow + 2` 开始写分析输出区。  
+   - Sheet 3 含**左右两区**（左明细 A-F / 右 4 个透视 H-K）：`lastDataRow = MAX(左区最末行, 右区第 4 个透视最末行)`。  
+   - Sheet 4 含**上下两区**（汇总 + 重点国切片）：`lastDataRow = 下区最末行`。  
+   - Sheet 5 含**上区主表 + 下区优化建议**：优化建议本身就是分析输出区，位置规则与其它 Sheet 一致。  
+   - 其余 Sheet（2 / 6 / 7 / 8）单数据区：`lastDataRow = 主表最末行`。
+3. **跨列宽度**：分析输出区表格横跨 A 列至该 Sheet 主表的**最右占用列**（如 Sheet 3 横跨 A-K、Sheet 4 横跨 A-L），便于运营在最末位置一眼读完。
+4. **禁止**为对齐美观而**人工指定固定行号**（如"R30 起写洞察"）：行号必须由脚本动态算，否则数据条数变化时会插入数据中间。
+
 ### Sheet 顺序
 
 | 顺序 | Sheet 名 | 主源 |
@@ -200,7 +213,7 @@ for month in <S月, S+1月, E月>:
 
 按 `month` + `seq` 升序。**不**对询盘做去重 / 校验。
 
-**`数据质量提示`**（主表下方空 1 行接续；Agent 基于本表数据自动生成，**禁止**编造；纯观察、不带建议口吻）：
+**`数据质量提示`**（**位置**：主表最末数据行下方空 1 行接续，**A 列起**；Agent 基于本表数据自动生成，**禁止**编造；纯观察、不带建议口吻）：
 
 | # | 观察 | 数据依据 |
 | --- | --- | --- |
@@ -237,7 +250,9 @@ for month in <S月, S+1月, E月>:
    `消耗`：产品维度的消耗在 `campaigns-*.json` 中需运营自配「产品 → 系列前缀映射」（见下方「可选：产品 → 系列前缀映射」节）。如未配置，**留空** + 脚注：`[ 数据不可用：未配置产品→系列映射 ]`，**禁止**编造分摊；  
    `CPL` = `消耗 / 询盘个数`，询盘个数为 0 时填 `—`。
 
-**`Agent 数据洞察`**（4 个透视下方留空 1 行接续；Agent 基于本 Sheet 数据自动生成，**禁止**编造；每条**必带**具体数字）：
+**`Agent 数据洞察`**（**位置**：**左区明细最末行**与**右区 4 个透视最末行**两者中**行号更大者**下方留空 1 行接续，**A 列起**（横跨 A-K，绝不允许出现在两区数据行之间）；Agent 基于本 Sheet 数据自动生成，**禁止**编造；每条**必带**具体数字）：
+
+> **写表脚本必做**：先算 `lastRow = max(左区最末数据行号, 右区最末透视行号)`，再从 `lastRow + 2` 开始写洞察标题与表格。**禁止**直接接在右区透视下方（会落在左区明细中间）。
 
 | # | 洞察类别 | 内容（每条引用本 Sheet 具体数字） |
 | --- | --- | --- |
@@ -273,7 +288,7 @@ for month in <S月, S+1月, E月>:
 | R7 | `时间` \| `国家` \| `消费` \| `线索数` \| `成本` \| `备注`|
 | R8..R13 | 每月一对（`<focusLabel>` / `非<focusLabel>`，其中 `focusLabel` = `focusCountries.join("+")`）：脚本读 `./<YYYY-MM>/geographic-*.json`，按 `focusCountries.includes(countryOrRegionZh) \|\| focusCountries.includes(geoEn2Zh[countryOrRegion])` 二分；`消费` = 该桶 `spend` 求和；`线索数` = `inquiries.json` 同月同桶（按 `country` 字段匹配 `focusCountries`） count；`成本` = `消费 / 线索数`，线索 0 填 `—` |
 
-**`Agent 数据洞察`**（下区下方留空 1 行接续；Agent 基于本 Sheet 上 + 下区数据自动生成，**禁止**编造；每条**必带**具体数字）：
+**`Agent 数据洞察`**（**位置**：下区（重点国切片）最末行下方留空 1 行接续，**A 列起**；Agent 基于本 Sheet 上 + 下区数据自动生成，**禁止**编造；每条**必带**具体数字）：
 
 | # | 洞察类别 | 内容（每条引用本 Sheet 具体数字） |
 | --- | --- | --- |
@@ -321,7 +336,7 @@ for month in <S月, S+1月, E月>:
 
 > **月份列用 Excel 日期序列号**还是 `YYYY-MM` 字符串？运营样表用日期序列号（如 `45931`、`46023`）；本模板**任选其一**，但**全表统一**；若用字符串则 R1 表头改为 `月份(YYYY-MM)`。
 
-**`Agent 数据洞察`**（笛卡尔积主表下方留空 1 行接续；Agent 基于本 Sheet 数据自动生成，**禁止**编造）：
+**`Agent 数据洞察`**（**位置**：笛卡尔积主表最末数据行下方留空 1 行接续，**A 列起**；Agent 基于本 Sheet 数据自动生成，**禁止**编造）：
 
 | # | 洞察类别 | 内容（每条引用本 Sheet 具体数字） |
 | --- | --- | --- |
@@ -346,7 +361,7 @@ for month in <S月, S+1月, E月>:
 
 按 `转化` 降序、`消耗` 降序双排序。
 
-**`Agent 数据洞察`**（关键词主表下方留空 1 行接续；Agent 基于本 Sheet 数据自动生成，**禁止**编造）：
+**`Agent 数据洞察`**（**位置**：关键词主表最末数据行下方留空 1 行接续，**A 列起**；Agent 基于本 Sheet 数据自动生成，**禁止**编造）：
 
 | # | 洞察类别 | 内容（每条引用本 Sheet 具体数字） |
 | --- | --- | --- |
@@ -374,7 +389,7 @@ for month in <S月, S+1月, E月>:
 
 > **关于"绝对页首展示次数百分比 / 页首展示次数百分比"**：当前 `SearchTermListRow` 类型只显式声明了通用指标，但 `[key: string]: unknown` 兜底使原始字段照常落盘。脚本应读 JSON 原始字段名（实际跑一次确认网关返回字段名，如 `absoluteTopImpressionPercentage` / `topImpressionPercentage`），命中即写、未返回则填 `—`。
 
-**`Agent 数据洞察`**（搜索字词主表下方留空 1 行接续；Agent 基于本 Sheet 数据自动生成，**禁止**编造）：
+**`Agent 数据洞察`**（**位置**：搜索字词主表最末数据行下方留空 1 行接续，**A 列起**；Agent 基于本 Sheet 数据自动生成，**禁止**编造）：
 
 | # | 洞察类别 | 内容（每条引用本 Sheet 具体数字） |
 | --- | --- | --- |

package/package.json

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