siluzan-tso-cli 1.1.48 → 1.1.49-beta.2

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

@@ -33,7 +33,7 @@
 | `bing-period-report.md` / `.html`            | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML                                                                                     |
 | `yandex-period-report.md` / `.html`          | **Yandex Direct 周期报告（默认）**：四步流程 → `yandex-analysis render` 出 HTML（样式对齐开发样例）                                                               |
 | `yandex-period-report-excel.md`              | **仅用户要 Excel 时**：Agent 脚本写 xlsx；无 CLI excel 子命令                                                                                                     |
-| `okki-weekly-google-client.md`               | **OKKI 周报**：Google 发客户固定话术 + 精简维度 CLI；**默认必产 5 Sheet Excel**（「表格形式」= xlsx，禁止 Markdown/HTML 代替），见 `references/core/playbooks.md` P6 |
+| `okki-weekly-google-client.md`               | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术，见 `references/core/playbooks.md` P6 |
 | `google-inquiry-analysis.md`                 | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7                                                                  |
 | `website-diagnosis-report.md` / `.html`      | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8                                                     |
 

package/dist/skill/report-templates/REPORT-WORKFLOW.md

@@ -84,7 +84,7 @@
 - **TikTok 周期报告**：产出 `tiktok-period-report.json`（见 `tiktok-period-report.md`，`meta` 可由 `--snapshot-dir` 自动合并）。
 - **Bing 周期报告**：产出 `bing-period-report.json`（见 `bing-period-report.md`，`meta`/`kpis` 可由 `--snapshot-dir` 自动合并）。
 - **Yandex 周期报告**：产出 `yandex-period-report.json`（见 `yandex-period-report.md`，`meta`/`kpis`/`tables` 可由 `--snapshot-dir` 自动合并）。
-- **OKKI（P6）/ 询盘（P7）**：Agent 脚本写 **多 Sheet `.xlsx`**（必产）；对话 Markdown 表 / 手写 HTML **不能**代替终稿。
+- **OKKI（P6）**：产出 `okki-weekly-report.json` 后走 `google-analysis okki-render` 出 **5 Sheet `.xlsx`**（必产）；**询盘（P7）**仍由 Agent 脚本写 8 Sheet `.xlsx`。对话 Markdown 表 / 手写 HTML **不能**代替终稿。
 
 ### 步骤 5b：生成终稿（按媒体与格式）
 
@@ -97,7 +97,7 @@
 | **Bing 周期报告**         | `bing-analysis render` → **HTML**（必做）                         | Agent 脚本写 xlsx；**不**默认 `render`                                                             |
 | **Yandex 周期报告**       | `yandex-analysis render` → **HTML**（必做）                       | Agent 脚本按 `yandex-period-report-excel.md` 写 xlsx；**不**默认 `render`                          |
 | **Google 诊断**           | 按 `report-template*.html` 写 HTML（默认 `report-template.html`） | 同左；用户要 Excel 时 Agent 脚本写 xlsx                                                            |
-| **OKKI 周报（P6）**       | **必产 5 Sheet `.xlsx`**（Agent 脚本；「表格形式」= xlsx）        | 同左；仅用户明确「只要话术 / 不要文件」才省略                                                      |
+| **OKKI 周报（P6）**       | **必产 5 Sheet `.xlsx`**（`google-analysis okki-render`；「表格形式」= xlsx） | 同左；仅用户明确「只要话术 / 不要文件」才省略                                                      |
 | **Google 询盘（P7）**     | **必产 8 Sheet `.xlsx`**（Agent 脚本）                            | 同左                                                                                               |
 | **网站诊断**              | `website-diagnosis render` → HTML                                 | —                                                                                                  |
 
@@ -125,7 +125,7 @@
 | 用户措辞                                                                                                                                              | 映射                                                                                                                                                                                                 |
 | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | 月报、周报、投放总结、效果回顾                                                                                                                        | 周期分析 → 对应媒体 `*-period-report.md`                                                                                                                                                             |
-| **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间；含「表格形式」）                                                                        | **固定话术 + 必产 5 Sheet `.xlsx`** → `okki-weekly-google-client.md`（见 SKILL **P6**）；「表格形式 / 表格 / 各维度表格」= Excel，**禁止**对话 Markdown 表或手写 HTML 代替；Excel **仅**由 Agent 脚本生成，**无** CLI 内置写表子命令 |
+| **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间；含「表格形式」）                                                                        | **固定话术 + 必产 5 Sheet `.xlsx`** → `okki-weekly-google-client.md`（见 SKILL **P6**）；终稿必须 `google-analysis okki-render`；「表格形式」= Excel，**禁止**对话 Markdown 表 / 手写 HTML / Agent 手写 xlsx |
 | **Goog账户询盘分析 / Google 账户询盘分析 / 分析XXX Google账号的询盘效果 / 我给你询盘信息分析Google账号XXX效果**（或含「询盘 + 账户 + Google」三要素） | **询盘 + 账户合并分析 + 严格 3 个月 + 8 Sheet xlsx** → `google-inquiry-analysis.md`（见 SKILL **P7**）；询盘资料用户上传任意载体，宿主 Agent 解析落盘 `inquiries.json`，xlsx **仅**由 Agent 脚本生成 |
 | 健康检查、诊断、账户分析                                                                                                                              | 诊断 → `google-account-diagnosis-report.md`（Google）或周期型降级                                                                                                                                    |
 | 对比、汇报、给客户看                                                                                                                                  | 以周期型为骨架，简化版本                                                                                                                                                                             |

package/dist/skill/report-templates/excel-style-guide.md

@@ -85,7 +85,7 @@ sheet.setColWidths([20, 60]); // 字符数，两列型表格：标签列窄、
 | `google-period-report-excel.md` | 本文件 | `google` |
 | `yandex-period-report-excel.md` | 本文件 | `yandex` |
 | `stats-daily-excel.md` | 本文件 | 按 `-m` 媒体参数对应色 |
-| `okki-weekly-google-client.md` | 本文件（5 Sheet 固定版式） | `google` |
+| `okki-weekly-google-client.md` | **不用本套件**；走 `google-analysis okki-render` 锁死 5 Sheet | `google` |
 | `google-inquiry-analysis.md` | 本文件（8 Sheet 固定版式） | `google` |
 
 **注意**：各模板文件里规定的 Sheet 名 / 列名 / 数据口径（业务内容）以各自 `*.md` 为准，本文件只管「怎么好看」，不改「写什么」。

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

@@ -62,6 +62,7 @@ siluzan-tso google-analysis -a <id> --start <S> --end <E> --json-out ./snap-p4 \
 
 | 维度              | ❌ 禁止猜                                            | ✅ outline 真实字段                                                                                        |
 | ----------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `overview`        | `currentPeriod.activeDays`、`previousPeriod.activeDays`、`currentPeriod.averageDailyCost` | `record.activeDays`、`record.averageDailyCost`（只在 **record 根**；period 块没有。上期这两字段接口不返回；要环比另拉上期 `daily-metrics` 数 `spend>0` 天数） |
 | `keywords`        | `keywordText`、`status`、`matchType`（单独作展示列） | `keyword`、`userStatus`、`keywordMatchTypeZh`（或 `keywordMatchType`）                                     |
 | `search-terms`    | `query`                                              | `searchTermText`；匹配类型用 `matchTypeZh`；状态用 `queryTargetingStatusZh`                                |
 | `geographic`      | `geoName`、`countryCriterionIdName`                  | `countryOrRegion`、`countryNameZh`、`countryCode`                                                          |
@@ -117,6 +118,6 @@ siluzan-tso google-analysis -a <id> --start <S> --end <E> --json-out ./snap-p4 \
 ## 相关文档
 
 - `google-period-report.md` — 默认维度与可选追加
-- `okki-weekly-google-client.md` — OKKI 固定 5 Sheet（P6）
+- `okki-weekly-google-client.md` — OKKI 固定 5 Sheet（P6，`google-analysis okki-render`）
 - `references/core/tips.md` — 摘要 → outline → 脚本
 - `references/core/playbooks.md` — P4 步骤卡片

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

@@ -768,6 +768,8 @@
             { key: "ctr", label: "点击率 CTR", fmt: pct },
             { key: "averageCpc", label: "平均点击费用", fmt: (v) => money(v, currency) },
             { key: "costPerConversion", label: "每次转化费用 CPA", fmt: (v) => money(v, currency) },
+            { key: "activeDays", label: "活跃天数", fmt: int },
+            { key: "averageDailyCost", label: "日均消耗", fmt: (v) => money(v, currency) },
           ];
           const kpiHtml = kpiDefs
             .map((def, i) => {

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

@@ -33,7 +33,7 @@ siluzan-tso google-analysis render \
 `google-period-report.json` 顶层结构：
 
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
-- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。环比仍来自 `overview.previousPeriod`。
+- `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,keywords}`：对应 §3～§7 表格数据；可省略由同名 `google-analysis` section 自动合并。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：

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

@@ -6,24 +6,24 @@
 > **媒体**：当前模板仅规范 **Google**（`mediaCustomerId`）。其他媒体用各自 `*-period-report.md`。  
 > **Excel 版式基准**：与运营样表《**数据复盘分析**》类 xlsx 对齐（如 `2025.12数据复盘分析.xlsx`）；工作簿 5 个 Sheet、顺序与表头以下文规范为准。
 >
-> **默认交付（硬性，缺文件 = 任务未完成）**：磁盘上的 **5 Sheet `.xlsx`** + 对话内客户话术。  
+> **默认交付（硬性，缺文件 = 任务未完成）**：磁盘上的 **5 Sheet `.xlsx`**（由 `google-analysis okki-render` 生成）+ 对话内客户话术。  
 > 「表格形式 / 表格 / 各维度表格 / 表 / 做成表」= **Excel `.xlsx`**，**不是**对话 Markdown 表，**不是**手写 HTML/PDF。  
 > 仅当用户明确「只要话术 / 不要文件 / 不要 Excel」时才省略 xlsx。  
-> **禁止**：用对话 Markdown 表、手写 HTML、PDF 代替 `.xlsx`；禁止假设存在 CLI `excel` 子命令。
+> **禁止**：用对话 Markdown 表、手写 HTML、PDF 代替 `.xlsx`；**禁止** Agent 手写 / 脚本写 xlsx。
 
 ## Contents
 
 - 须先确认
-- 架构约定 · Excel 由谁生成
+- 标准四步流程（拉数 → 写 JSON → okki-render）
 - 拉数（一次目录）
-- xlsx 版式规范
+- xlsx 版式规范（由 CLI 锁死）
 - 对外客户话术（默认结构，填数来自 JSON）
 - 复盘小结（Excel「数据复盘」区块 / 对内补充）
 - 与 `google-period-report.md` 的差异
 
 ---
 
-识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程；按本文**固定维度 + 默认客户话术（可用户自定义）+ 5 Sheet `.xlsx`** 交付（数据全部来自 CLI 落盘 JSON，见 `references/analytics/account-analytics.md`）。**先写 xlsx 再发话术**；没有 `.xlsx` 路径不得收口。
+识别到上述意图时：**不要**再走 `google-period-report.md` 的「默认 8 维 + 追问追加」流程；按本文**固定维度 + 默认客户话术（可用户自定义）+ `okki-render` 出 5 Sheet `.xlsx`** 交付。**先 `okki-render` 再发话术**；没有 `.xlsx` 路径不得收口。
 
 ---
 
@@ -33,17 +33,35 @@
 2. **统计区间**：`--start` / `--end`（用户未给齐时按 SKILL 反问；授权默认时可用「上一完整自然周」白名单并写明）。
 3. **询盘口径**：默认使用区间内 `conversions`（转化次数，来自 `stats` 或 `overview`）。若运营定义为某类转化，须在首段脚注说明（必要时补拉 `google-analysis --sections conversion-actions` 仅作说明）。
 4. **日期写法**：`2026.4.1`、`2026/4/1` 等先规范为 `YYYY-MM-DD`（如 `2026-04-01`）再传 `--start` / `--end`。
-5. **交付**：默认 **客户话术 + 5 Sheet `.xlsx`（必产）**。「表格形式」一律当 Excel。仅用户明确只要可复制话术、不要文件时，才省略 xlsx。
+5. **交付**：默认 **客户话术 + 5 Sheet `.xlsx`（必产，由 `okki-render` 写出）**。「表格形式」一律当 Excel。仅用户明确只要可复制话术、不要文件时，才省略 xlsx。
 
 ---
 
-## 架构约定 · Excel 由谁生成
+## 标准四步流程（拉数 → 写 JSON → okki-render）
 
-- **`siluzan-tso` 不提供**「一键生成 OKKI Excel」的子命令，**也不要**在 CLI 里新增。
-- **默认必产 Excel**：由 **Agent（含 WorkBuddy 编排）** 在下列 CLI **`--json-out` 落盘后**，自行编写 **Node.js / Python** 脚本（如 `exceljs`、`xlsx`、`openpyxl`）读取 JSON → 写 `.xlsx`。没有写出 `.xlsx` = 未完成。
-- **数值一律来自落盘 JSON，禁止在脚本里写死业务数字。**
-- **所有 ID 列写字符串（文本）**，禁止 Excel 数字类型（防科学计数法）；见 `references/core/agent-conventions.md`。
-- **样式（必须）**：`import` `report-templates/excel-style-kit.mjs`，用 `createExcelWorkbook({ accent: "google" })` + `titleBar`/`sectionBar`/`tableHeader`/`dataRow`/`noteRow` 组件搭版面（`noteRow` 用于「分析」「数据复盘」文字块），**禁止**裸写无样式单元格。规范见 `report-templates/excel-style-guide.md`。
+| 步骤 | 执行者 | 动作 |
+| --- | --- | --- |
+| **1. 拉数** | Agent 调 CLI | 下方固定命令组合，同一 `--json-out` 目录 |
+| **2. 分析** | Agent | 用 **node/python 脚本**读落盘 JSON（先 outline 再 JSON），完成筛选/聚合/洞察 |
+| **3. 写 JSON** | Agent | 按 `assets/okki-weekly-report.schema.json` 撰写 `okki-weekly-report.json`：**只写 `meta` + `narrative`**；表格留给步骤 4 合并 |
+| **4. 渲染 xlsx** | CLI | `google-analysis okki-render` — **校验 5 Sheet 表末分析 + 账户 Sheet 固定 5 维数据复盘**，缺项报错不生成文件；**禁止** Agent 手写 xlsx |
+
+```bash
+siluzan-tso google-analysis okki-render \
+  --data ./okki-weekly-report.json \
+  --snapshot-dir ./snap-okki \
+  --out ./okki-weekly-report.xlsx
+```
+
+`okki-weekly-report.json` 顶层结构：
+
+- `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；日期可由 `--snapshot-dir` 补空。
+- `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
+  - `sheetAnalysis.{campaigns,keywords,searchTerms,devices,geo}`：每个 Sheet 各 `{summary[]（≥1）, suggestions[]（≥1）}`。**表为空也必须写**（例如「本周期无搜索词，暂无加词/否词建议」）。
+  - `review.{account,keywords,searchTerms,devices,geo}`：账户 Sheet「数据复盘」固定 5 维，每维 `{overview, summary, suggestion}` 均非空。
+- `tables` / `kpis`：Agent 可省略；**render 以快照覆盖**。设备/国家只认 `campaign-device` / `campaign-geo-matched`。
+
+**禁止**：自己写 Node/Python 出 xlsx、用 Markdown 表代替、跳过 `okki-render`。`okki-render` 失败时按 stderr 缺项补 JSON 后重跑，不得改用手写表。
 
 ---
 
@@ -70,12 +88,13 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 - `balance`：**当前**余额（非历史快照），话术写「截至查询时点」。
 - 「设备」「国家」两 Sheet **必须**用 **`campaign-device` / `campaign-geo-matched`**（按系列/组拆行），**不要**用账户级 `devices` / `geographic`，也**不要**用 `campaign-geo`（定向地理位置，与 OKKI「地理位置报告」口径不一致）。落盘文件名为 `campaign-device-<id>.json`、`campaign-geo-matched-<id>.json`。跨系列汇总在脚本中做。
 - 可选：`campaign-geo-matched` 支持 `--cost-greater` / `--click-greater` / `--conversions-greater`（见 `references/analytics/account-analytics.md`）。
-- TopN、排序、汇总均在脚本内对 JSON 完成，禁止心算。
-- 写脚本前先读各 `<section>-<id>.outline.txt` 再读 `.json`。
+- TopN、占比、洞察在写 `narrative` 前由脚本对 JSON 完成，禁止心算。
+- 写 JSON 前先读各 `<section>-<id>.outline.txt` 再读 `.json`。
+- 合计行、CTR/CPA、日期标题、Sheet 列顺序由 `okki-render` 计算，Agent 不要往 JSON 里填表格行。
 
 ---
 
-## xlsx 版式规范
+## xlsx 版式规范（由 CLI 锁死，Agent 不必重写）
 
 工作簿 → Sheet 名（须完全一致）→ 版式。**不**单独建「广告系列」Sheet（系列表在 `账户报告` 内）。状态枚举若为英文须转中文。
 
@@ -99,7 +118,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 | 顺序 | Sheet 名   | 数据来源                                                                             |
 | ---: | ---------- | ------------------------------------------------------------------------------------ |
-|    1 | `账户报告` | `campaigns` + 复盘文案（stats/overview 汇总后 Agent 撰写）                           |
+|    1 | `账户报告` | `campaigns` + `narrative.review`（5 维复盘，`okki-render` 写入）                     |
 |    2 | `关键词`   | `keywords`                                                                           |
 |    3 | `搜索词`   | `search-terms`                                                                       |
 |    4 | `设备`     | **`campaign-device-*.json`**（按系列/组拆行）                                        |
@@ -148,7 +167,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
      总结：
      建议：
 
-文案由 Agent 据 JSON 撰写，**不得编造**表中不存在的数字。
+文案写入 `narrative.review`（每维 `overview` / `summary` / `suggestion`），由 `okki-render` 画到账户 Sheet 底部；缺任一维会拒绝出文件。**不得编造**表中不存在的数字。
 
 ---
 
@@ -265,5 +284,5 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | 项       | `google-period-report.md` | 本文 OKKI 周报                                                                                                 |
 | -------- | ------------------------- | -------------------------------------------------------------------------------------------------------------- |
 | 默认维度 | 8 维 + 主动追问追加       | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo-matched` + `stats` + `balance` |
-| 输出形态 | 长文分析报告（默认 HTML） | **必产** 5 Sheet `.xlsx` + 客户话术；「表格形式」= Excel；**禁止**对话 Markdown 表 / 手写 HTML 代替 |
+| 输出形态 | 长文分析报告（默认 HTML，`google-analysis render`） | **必产** 5 Sheet `.xlsx`（`google-analysis okki-render`）+ 客户话术；「表格形式」= Excel；**禁止**对话 Markdown 表 / 手写 HTML / Agent 手写 xlsx |
 | 典型用户 | 内部分析                  | **发客户**的同步简报                                                                                           |

package/dist/skill/scripts/install.ps1

@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.48'
+$PKG_VERSION = '1.1.49-beta.2'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
-$WEB_BASE    = 'https://www.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN    = 18

package/dist/skill/scripts/install.sh

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

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

@@ -33,7 +33,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 **returnSchema**: 仅回传 exitCode、manifestFile、writtenFiles、outlineFiles、stderrTail、summary（无编造数字）。
 
-## 阶段 B · 写 xlsx（委派本阶段时使用）
+## 阶段 B · 写叙事 JSON + okki-render（委派本阶段时使用）
 
 **snapDir**: 同上（拉数已完成）
 
@@ -41,11 +41,20 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 
 - 禁止在脚本中写死业务数字；数值只来自落盘 JSON
 - 禁止跳过 outline；先读 `*.outline.txt` 再读 JSON
+- 禁止 Agent 手写 / 脚本写 xlsx；必须走 `google-analysis okki-render`
 
 **任务**:
 
-1. Read `report-templates/okki-weekly-google-client.md` 中 xlsx 版式与 **§对外客户话术**（默认 7 条模板；主 Agent 若指定自定义话术则从其指示）。
-2. 编写并执行 Node/Python 脚本，产出 `.xlsx` + 客户话术；**每个 Sheet 数据表末须写「分析」**（总结 + 建议，见模板各 Sheet「表末「分析」」行）。**禁止**只交 Markdown 表或手写 HTML；没有 `.xlsx` 路径 = 本阶段失败。
-3. 设备/国家 Sheet 必须用 `campaign-device` / `campaign-geo-matched` 落盘文件。
-
-**returnSchema**: 产出文件路径列表 + 脚本 exitCode；勿贴 xlsx 二进制内容。
+1. Read `report-templates/okki-weekly-google-client.md` 中 **§标准四步流程** 与 **§对外客户话术**（默认 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）。表为空也须写分析。
+3. 执行：
+   ```bash
+   siluzan-tso google-analysis okki-render \
+     --data ./okki-weekly-report.json \
+     --snapshot-dir <snapDir> \
+     --out ./okki-weekly-report.xlsx
+   ```
+   失败则按 stderr 补 JSON 后重跑，不得改用手写表。
+4. 设备/国家必须来自 `campaign-device` / `campaign-geo-matched`（由 render 校验）。
+
+**returnSchema**: xlsx 路径 + `okki-render` exitCode + 客户话术文本；勿贴 xlsx 二进制。

package/package.json

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