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

package/README.md

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

package/dist/index.js

@@ -102729,7 +102729,7 @@ init_dist();
 import * as fs18 from "fs";
 import * as path26 from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 
 // src/commands/login/urls.ts
 init_defaults();
@@ -121435,6 +121435,8 @@ function register25(program2) {
     console.log("    CLI \u62C9\u6570\uFF1A");
     console.log("      siluzan-tso website-diagnosis collect --url <url> --json-out ./snap-web");
     console.log("      siluzan-tso website-diagnosis performance --url <url> --json-out ./snap-web");
+    console.log("    \u9ED8\u8BA4\u4EA4\u4ED8 HTML\uFF1A");
+    console.log("      siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json");
     console.log("    Skill\uFF1Areferences/analytics/website-diagnosis-guide.md\n");
     console.log("  \u3010\u8D26\u6237\u5217\u8868 ARIT \u5206\u3011");
     console.log("    list-accounts \u4F1A\u8865\u5145 ma.diagnoseReports \u4E2D reportSource=ARIT \u7684\u5F97\u5206\uFF1B");
@@ -121633,7 +121635,7 @@ async function runWebsiteDiagnosisCollect(opts) {
     htmlPreview,
     ...htmlFull ? { htmlContent: htmlFull } : {},
     ...htmlError ? { htmlError } : {},
-    agentHint: "1) \u6309 website-diagnosis-rules.md \u751F\u6210\u8BCA\u65AD JSON\uFF1B2) siluzan-tso website-diagnosis render --data <diagnosis.json> --collect <\u672C\u6587\u4EF6> \u8F93\u51FA\u5E26\u56FE\u8868\u7684 website-diagnosis-report.html\u3002"
+    agentHint: "1) \u6309 website-diagnosis-rules.md \u751F\u6210\u8BCA\u65AD JSON\uFF1B2) siluzan-tso website-diagnosis render --data <diagnosis.json> --collect <\u672C\u6587\u4EF6> \u9ED8\u8BA4\u4EA7\u51FA HTML \u7EC8\u7A3F website-diagnosis-report.html\uFF08\u7981\u6B62\u4EC5 Markdown/JSON \u4EA4\u4ED8\uFF09\u3002"
   };
   if (await emitCliJsonOrSnapshot(
     { jsonOut: opts.jsonOut },
@@ -121756,7 +121758,7 @@ async function runWebsiteDiagnosisRender(opts) {
 // src/commands/website-diagnosis/register.ts
 function registerWebsiteDiagnosisCommands(program2) {
   const root = program2.command("website-diagnosis").description(
-    "\u7F51\u7AD9\u8BCA\u65AD\uFF1ALighthouse \u6027\u80FD\u3001HTML \u91C7\u96C6\uFF08Agent download-assets\uFF09\u3001ARIT \u5386\u53F2\u5F97\u5206\u67E5\u8BE2"
+    "\u7F51\u7AD9\u8BCA\u65AD\uFF1ALighthouse \u6027\u80FD\u3001HTML \u91C7\u96C6\u3001ARIT \u5386\u53F2\u5F97\u5206\uFF1B\u9ED8\u8BA4\u4EA4\u4ED8 HTML \u62A5\u544A\uFF08render \u5B50\u547D\u4EE4\uFF09"
   );
   root.command("performance").description("\u62C9\u53D6 Lighthouse \u6027\u80FD\u6570\u636E\uFF08GET WebsiteDiagnosisReports/performance\uFF09").requiredOption("--url <url>", "\u7F51\u7AD9 URL\uFF08\u53EF\u7701\u7565 https://\uFF0C\u81EA\u52A8\u8865\u5168\uFF09").option("--token <token>", "JWT\uFF08\u9ED8\u8BA4\u8BFB config / \u73AF\u5883\u53D8\u91CF\uFF09").option("--verbose", "\u6253\u5370\u8BF7\u6C42\u8BE6\u60C5").option("--json-out <dir>", "\u843D\u76D8 cli-manifest + JSON").action(async (opts) => {
     await runWebsiteDiagnosisPerformance({
@@ -121789,7 +121791,7 @@ function registerWebsiteDiagnosisCommands(program2) {
     }
   );
   root.command("render").description(
-    "\u6839\u636E\u8BCA\u65AD JSON \u751F\u6210\u5E26\u56FE\u8868\u7684\u5355\u6587\u4EF6 HTML \u62A5\u544A\uFF08website-diagnosis-report.html\uFF09"
+    "\u6839\u636E\u8BCA\u65AD JSON \u751F\u6210 HTML \u7EC8\u7A3F\uFF08\u9ED8\u8BA4\u4EA4\u4ED8\u683C\u5F0F\uFF0Cwebsite-diagnosis-report.html\uFF09"
   ).requiredOption("--data <file>", "\u8BCA\u65AD\u7ED3\u679C JSON\uFF08getWebsiteDiagnosisData \u540C\u7ED3\u6784\uFF09").option("--collect <file>", "\u53EF\u9009\uFF1Acollect \u843D\u76D8 JSON\uFF0C\u7528\u4E8E\u5408\u5E76 lighthouse").option("--out <file>", "\u8F93\u51FA HTML \u8DEF\u5F84\uFF08\u9ED8\u8BA4\u540C --data \u76EE\u5F55\uFF09").action(async (opts) => {
     await runWebsiteDiagnosisRender({
       dataFile: opts.data,
@@ -122476,6 +122478,9 @@ function endpointHintForFacebookSection(def, apiId) {
   return `GET \u2026/FacebookAds/${apiId}/${def.segment}`;
 }
 
+// src/commands/facebook-analysis/register-cli.ts
+import { Command } from "commander";
+
 // src/commands/facebook-analysis/render-report.ts
 import fs17 from "fs";
 import fsPromises2 from "fs/promises";
@@ -122746,20 +122751,19 @@ async function runFacebookAnalysisRender(opts) {
   await fsPromises2.writeFile(outPath, injectReportData2(html, data), "utf8");
   const runtimeSrc = metaPeriodReportRuntimePath();
   const runtimeOut = path24.join(outDir, TEMPLATE_BASENAMES2.runtime);
+  let runtimeCopied = false;
   try {
     await fsPromises2.copyFile(runtimeSrc, runtimeOut);
+    runtimeCopied = true;
   } catch {
-    console.error(`
-\u274C \u672A\u627E\u5230\u62A5\u544A\u8FD0\u884C\u65F6\uFF1A${runtimeSrc}
-\u8BF7\u5148\u6267\u884C npm run build
-`);
-    process.exit(1);
   }
   console.log(`
 \u2705 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u62A5\u544A\u5DF2\u751F\u6210\uFF1A${outPath}
 `);
-  console.log(`   \u8FD0\u884C\u65F6\u811A\u672C\uFF1A${runtimeOut}
+  if (runtimeCopied) {
+    console.log(`   \u8FD0\u884C\u65F6\u811A\u672C\uFF1A${runtimeOut}
 `);
+  }
   console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u56FE\u8868\u4E0E\u5B8C\u6574\u7AE0\u8282\uFF08\u9700\u8054\u7F51\u52A0\u8F7D Chart.js CDN\uFF09\u3002\n");
 }
 
@@ -122887,10 +122891,9 @@ async function runAllFacebookSections(opts) {
 }
 
 // src/commands/facebook-analysis/register-cli.ts
-function registerFacebookAnalysisCommands(program2) {
-  const sectionHelp = FACEBOOK_SECTION_NAMES.join(", ");
-  const root = program2.command("facebook-analysis").description(
-    "Facebook Ads \u8D26\u6237\u5206\u6790\u6279\u91CF\u62C9\u53D6\uFF08TSO reporting/media-account/FacebookAds/\u2026\uFF0C7 \u4E2A Section\uFF09"
+function registerBatchCommand(sectionHelp) {
+  return new Command("run").description(
+    "\u6279\u91CF\u62C9\u53D6 TSO reporting/media-account/FacebookAds Section \u6570\u636E\uFF08\u7701\u7565\u5B50\u547D\u4EE4\u540D\u65F6\u9ED8\u8BA4\u6267\u884C\u672C\u547D\u4EE4\uFF09"
   ).requiredOption(
     "-a, --account <id>",
     "Facebook \u5E7F\u544A\u8D26\u6237 mediaCustomerId\uFF08\u6570\u5B57\u6216 act_<\u6570\u5B57>\uFF09"
@@ -122910,6 +122913,13 @@ function registerFacebookAnalysisCommands(program2) {
   ).option("--concurrency <n>", "\u5E76\u53D1\u6570\uFF0C\u9ED8\u8BA4 5\uFF0C\u4E0A\u9650 16", (v) => parseInt(v, 10)).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
     await runAllFacebookSections(opts);
   });
+}
+function registerFacebookAnalysisCommands(program2) {
+  const sectionHelp = FACEBOOK_SECTION_NAMES.join(", ");
+  const root = program2.command("facebook-analysis").description(
+    "Facebook Ads \u8D26\u6237\u5206\u6790\uFF1A\u6279\u91CF\u62C9\u53D6 Section \u6570\u636E\uFF08\u9ED8\u8BA4\uFF09\uFF0C\u6216\u7531 render \u751F\u6210 HTML \u5468\u671F\u62A5\u544A"
+  );
+  root.addCommand(registerBatchCommand(sectionHelp), { isDefault: true });
   root.command("render").description(
     "\u6839\u636E Agent \u64B0\u5199\u7684\u62A5\u544A JSON \u751F\u6210 Meta/Facebook \u5468\u671F\u5206\u6790 HTML \u7EC8\u7A3F\uFF08meta-period-report.html\uFF09"
   ).requiredOption("--data <file>", "Agent \u4EA7\u51FA\u7684 meta-period-report.json").option(
@@ -122938,7 +122948,7 @@ function getVersion() {
     return "0.0.0";
   }
 }
-var program = new Command();
+var program = new Command2();
 program.name("siluzan-tso").description(
   "Siluzan \u5E7F\u544A\u8D26\u6237\u7BA1\u7406\uFF1A\u8D26\u6237\u67E5\u8BE2\u3001\u4F59\u989D\u3001\u6295\u653E\u6570\u636E\u3001\u5F00\u6237\u7533\u8BF7\uFF08Google/TikTok/Yandex/Bing/Kwai\uFF09\u3001\n\u8D26\u53F7\u5206\u4EAB/\u89E3\u7ED1\u3001\u4F18\u5316\u62A5\u544A\u3001Google \u8D26\u6237\u5206\u6790\u7F51\u5173\uFF08google-analysis\uFF09\u3001\u7F51\u7AD9\u8BCA\u65AD\uFF08website-diagnosis\uFF09\u3001\u6218\u7565\u5E02\u573A\u5206\u6790\uFF08market-analysis\uFF0CAgent \u751F\u6210\u62A5\u544A\uFF09\u3001\u5145\u503C\u8F6C\u8D26\u3001\u5F00\u7968\u3001\u667A\u80FD\u9884\u8B66\u3001Google \u5E7F\u544A\u7BA1\u7406\uFF08\u542B\u5F02\u6B65\u6279\u91CF\uFF09\u3002"
 ).version(getVersion());

package/dist/skill/SKILL.md

@@ -19,6 +19,8 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 >
 > **报告/Excel 交付前**：Read `references/core/deliverable-preflight.md`，**Read 最终产物**并按自检表确认币种与章节完整；币种只认当次 `list-accounts` 的 `currencyCode`。
 >
+> **HTML 终稿类报告（用户未指定格式时默认 HTML）**：网站诊断 P8（`website-diagnosis render`）、Meta 周期 P4-FB（`facebook-analysis render`）、战略市场 P9（`market-analysis render`）。Agent 只写 JSON，**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
+>
 > **开户**：首次进入开户话题须先向用户罗列该媒体（或未指明媒体时六平台）**全部必填项**，见 `references/accounts/open-account-by-media.md` §「首次响应硬规范」。
 >
 > **Subagent（可选）**：若宿主支持 Task / 子会话，复杂报告（P5/P6/P7）或长 CLI 输出前 Read `references/core/subagent-orchestration.md`，**自行决定**是否委派；写操作确认与对用户的最终交付留在主 Agent。
@@ -84,10 +86,10 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | 用户意图（关键词） | 必读（Read 后再 `-h` / 执行） |
 | ------------------ | ----------------------------- |
 | 任意任务（首次） | `core/agent-conventions.md` |
-| 账户列表 / 余额 / 消耗 / 分享 / MCC / 多账户汇总 | `accounts/accounts.md`；金额加 `accounts/currency.md` |
+| 账户列表 / 有多少 / 列出全部 / 余额 / 消耗 / 分享 / MCC | `accounts/accounts.md`（§ list-accounts **Agent 意图速查**：`-m <媒体> --page-size 999 --json-out` 一步拉全）；金额加 `accounts/currency.md` |
 | google ads 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md` + **`core/deliverable-preflight.md`**；多账户加 `analytics/google-analysis-batch.md` |
-| Meta/Facebook 周期或诊断报告 / `facebook-analysis` | `report-templates/meta-period-report-excel.md`（Excel 五 Sheet 基准）+ `meta-period-report.md` + `analytics/facebook-analysis-guide.md`；Agent 写 `meta-period-report.json`，`facebook-analysis render` 出 HTML |
-| 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `core/playbooks.md` P8；Agent 只写 JSON，`website-diagnosis render` 出 HTML |
+| Meta/Facebook 周期或诊断报告 / `facebook-analysis` | **默认 HTML**：`meta-period-report.md` + **`assets/meta-period-report-rules.md`**（内容丰富度必读）+ `facebook-analysis-guide.md` + `deliverable-preflight.md` → 拉数 → 分析 → JSON（4 条建议≥150字+7维补充+HTML扩展）→ `render`；**仅用户要 Excel** 时加读 `meta-period-report-excel.md` |
+| 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `core/playbooks.md` P8 + `core/deliverable-preflight.md`；Agent 只写 JSON，**默认交付** `website-diagnosis render` 产出的 **HTML**（禁止仅 Markdown/JSON） |
 | 市场分析 / 行业分析 / 战略市场报告 / `market-analysis` | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `report-templates/market-analysis-report.md` + `core/playbooks.md` P9；`collect` → Agent 按维度调研写 `market-report.json` → `render`（缺项校验） |
 | Google 新建搜索系列 | `google-ads/google-ads-campaign-plan.md` |
 | Google 广告 CRUD / 拒审 | `google-ads/google-ads.md` |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.28-beta.1",
-  "publishedAt": 1780888059129
+  "version": "1.1.28-beta.2",
+  "publishedAt": 1780907501825
 }

package/dist/skill/assets/meta-period-report-rules.md

@@ -0,0 +1,169 @@
+# Meta 周期报告撰写规则（Agent 用）
+
+> 对齐 **P8 网站诊断** 的「结构化 + 全量覆盖 + 每条必有建议」思路。  
+> 源：业务 Excel 模板（`无锡顺晟Facebook4月报告.xlsx`）+ `meta-period-report.html` 深度分析章节。  
+> **禁止**只写 KPI 表、4 条一句话建议或空白占位后交付。
+
+---
+
+## 与网站诊断的对照（为何 FB 报告会显得「建议太少」）
+
+| 网站诊断（P8） | Meta 周期报告（P4-FB） |
+| -------------- | ---------------------- |
+| `website-diagnosis-rules.md` 规定 29 子项全覆盖 | 本文件规定 **5 维数据 + 叙事 + 建议** 全覆盖 |
+| 每项 `issue` + `suggestion`（较差项以「强烈建议：」开头） | 每条建议 `content` 须 **引用当次数字** + **可执行动作** |
+| `coreIssuesIds` + `PriorityPlan` 高/中/低 | `priorityPlan` + `narrative.recommendations` 4 条 + `supplementaryRecommendations` |
+| HTML 由 `render` 渲染全部章节 | HTML **必须**填 `executiveSummary`、`healthDiagnosis`、`sections.*.insight` 等（见下） |
+| 交付前 Read HTML 对照章节清单 | 交付前 Read HTML/xlsx 对照 `deliverable-preflight.md` § P4-FB |
+
+**常见失误（导致建议偏少）**：
+
+1. 只写 Excel 叙事 4 条标题、每条 1～2 句泛化话术，未引用 CPL/花费/国家名。
+2. HTML 默认路径只填 `narrative`，**未填** `executiveSummary` / `healthDiagnosis` / `sections.insight`（模板原先不展示 `narrative.recommendations`，现已修复）。
+3. 未按 **7 维数据驱动清单** 逐条给建议，只写「优化素材」「调整预算」等空话。
+
+---
+
+## JSON 结构（摘要）
+
+完整 Schema：`assets/meta-period-report.schema.json`。  
+**Excel 与 HTML 共用** `narrative`；**HTML 默认交付**还须填「深度分析扩展」字段。
+
+---
+
+## 一、Excel / 总数据叙事（`narrative` · 必填）
+
+### 1. `narrative.overall`（整体表现）
+
+| 要求 | 细则 |
+| ---- | ---- |
+| 字数 | **≥ 120 字**（中文） |
+| 必含数字 | 花费、`results`、CPL（`costPerResult`）、`reach`、`impressions`、`frequency` **至少 5 项** |
+| 必含口径 | `resultType`、`attributionSetting`（写入 `meta` 并在段中提及） |
+| 可选 | 若有 `previousPeriod`，写 1～2 句环比（花费 ±%、CPL ±%） |
+
+### 2. `narrative.regional[]`（区域 / 广告组）
+
+| 要求 | 细则 |
+| ---- | ---- |
+| 条数 | **每个** `ad-sets` 中花费 >0 的广告组 **各 1 段**（不得合并成 1 句带过） |
+| 字数 | 每段 **≥ 80 字** |
+| 必含 | 组名、花费占比或绝对值、线索数、`costPerResult`、频次；判断「曝光不足 / 频次过高 / 效率领先」 |
+| 数据依据 | `ad-sets-<id>.json` → `adGroups[]` |
+
+### 3. `narrative.country`（国家报告）
+
+| 要求 | 细则 |
+| ---- | ---- |
+| 字数 | **≥ 80 字** |
+| 必含 | CPL **最低** 与 **最高** 国家名及具体 CPL；中间梯队 1～2 国；花费集中度 |
+| 数据依据 | `country-<id>.json` → `countries[]` |
+
+### 4. `narrative.recommendations[]`（固定 4 条标题）
+
+**必须恰好 4 条**，`title` 仅限下表枚举；`content` 须**数据驱动**，不得模板空话。
+
+| title | content 最低要求（每条 **≥ 150 字**） |
+| ----- | ------------------------------------- |
+| **简化表单问题** | 结合 **高频次 + 高 CPL** 的国家/组（写出名称与数字）；建议字段从 N 减到 3；说明预期对 CPL 的影响 |
+| **区域调整** | 按 **具体广告组** 写语言/市场策略（如土/葡/德）；引用各组 CPL 对比；写清「加谁、减谁、暂停谁」 |
+| **预算重构** | 给出 **具体比例**（如 4:3:3 或按 spend 占比调整）；测试周期（7/14 天）；优胜劣汰阈值（CPL > 账户均值 ×1.2 则减 30%） |
+| **素材建议** | 按 **平台**（IG/FB）与 **国家** 分述；素材套数、视频时长、形态；至少点名 1 个高花费低结果创意/版位 |
+
+**建议前缀（对齐网站诊断）**：
+
+- 问题严重（CPL > 均值 1.3 倍、频次 >2.5、零成效花费 >$50）→ `content` 以 **「强烈建议：」** 开头  
+- 其余优化项 → **「推荐优化：」** 开头  
+
+---
+
+## 二、数据驱动补充建议（`supplementaryRecommendations` · 必填）
+
+在 4 条固定标题之外，**必须**再写 **7 维清单**，每条 `{ "dimension", "issue", "suggestion" }`：
+
+| dimension | issue（发现了什么） | suggestion（怎么办） |
+| --------- | ------------------- | -------------------- |
+| 预算与广告组 | 点名高 `spendPercentage`、差 `costPerResult` 的组 | 降预算 %、暂停、或合并受众 |
+| 平台与版位 | `publisherPlatform` + `platformPosition` 组合 | 减投差版位、加码 winner 平台 |
+| 地域 | 高消耗低结果国家 | geo 排除 / 收窄 / 单独组 |
+| 受众 | 低效 age×gender | 排除或降 bid；扩量高效段 |
+| 创意 | 高花费低 `results` 的 ad | 关停、复制 winner 结构 |
+| 频次与疲劳 | `frequency` >2.5 且转化差 | 扩受众、换创意、降预算 |
+| 接口限制 | 无按日/关键词等 | 一句说明「Meta 接口未提供」，**禁止编造** |
+
+每条 `suggestion` **≥ 60 字**，须含 **至少 1 个当次数字或名称**。
+
+---
+
+## 三、优先级改进计划（`priorityPlan` · HTML 必填 · Excel 推荐）
+
+对齐网站诊断 `PriorityPlan`：
+
+```jsonc
+{
+  "priorityPlan": {
+    "high": ["…", "…"],    // ≥2 条，本周必须做
+    "medium": ["…", "…"],  // ≥2 条
+    "low": ["…", "…"]      // ≥2 条，持续优化
+  }
+}
+```
+
+每条 **≥ 40 字**，带责任维度（预算/素材/地域等）。
+
+---
+
+## 四、HTML 默认交付 · 深度分析扩展（必填）
+
+用户未指定 Excel 时，除 §一～§三外 **还必须** 填写：
+
+| 字段 | 最低要求 |
+| ---- | -------- |
+| `executiveSummary` | **3～5 段**，每段 **≥ 80 字**；解释「为什么」而不只报数；可拆自 `narrative.overall` 但须加深因果 |
+| `healthDiagnosis.lifecyclePhase` | `test-market` / `find-winner` / `scale` 三选一 |
+| `healthDiagnosis.lifecycleVerdict` | **≥ 60 字**，结合总花费与维度分散度 |
+| `healthDiagnosis.fourQuestions` | **恰好 4 张卡片**（钱花得值不值 / 赢在哪 / 输在哪 / 下月重点） |
+| 每张 `fourQuestions[]` | `verdict` + `evidence` **≥2 条**（含数字）+ `action` **≥ 40 字** |
+| `healthDiagnosis.scorecard` | **≥ 6 行**（平台、国家、广告组、受众等分项红绿灯） |
+| `sections.platform.insight` | **≥ 200 字** |
+| `sections.country.insight` | **≥ 200 字** |
+| `sections.adSets.insight` | **≥ 200 字** |
+| `sections.audience` | `goldenProfile` **≥3 条** + `antiProfile` **≥2 条** + `insight` **≥ 150 字** |
+| `sections.landingPage.rows` | **≥ 3 行**（心理阻碍 / 数据信号 / 推演 / 优先级） |
+| `abTests` | **≥ 3 个**实验（变量、假设、成功标准） |
+| `actionChecklist` | `today` **≥2**、`thisWeek` **≥3**、`thisMonth` **≥3** 条可执行项 |
+
+**禁止**：HTML 中大量「（待 Agent 撰写）」占位；交付前 Read HTML 确认无空节。
+
+---
+
+## 五、撰写流程（对齐 P8）
+
+1. **拉数**：`facebook-analysis` + `--json-out`（默认 5 维）。
+2. **脚本读盘**：聚合 KPI、Top/Bottom 国家、平台、受众、广告组（禁止 Read 业务 JSON 进对话）。
+3. **先 outline 后 JSON**：列出将引用的数字与 7 维建议要点，再写 `meta-period-report.json`。
+4. **渲染**：`facebook-analysis render`（HTML）或脚本写 xlsx（Excel）。
+5. **Read 终稿**：对照 `deliverable-preflight.md` § P4-FB。
+
+---
+
+## 六、自检清单（Agent 交付前勾选）
+
+- [ ] `narrative.recommendations` 4 条，每条 content ≥150 字且含真实数字
+- [ ] `supplementaryRecommendations` 7 维齐全
+- [ ] `priorityPlan` high/medium/low 各 ≥2 条
+- [ ] HTML：`executiveSummary` ≥3 段、`fourQuestions` =4、`scorecard` ≥6 行
+- [ ] HTML：`sections.platform/country/adSets.insight` 各 ≥200 字
+- [ ] HTML：`actionChecklist` 三列非空；`abTests` ≥3
+- [ ] Excel：总数据 Sheet 叙事块 4 节齐全，无 1 句话敷衍
+- [ ] 未编造 Meta 无接口维度（按日、关键词等）
+
+---
+
+## 相关文档
+
+- `report-templates/meta-period-report.md` — 流程与章节
+- `report-templates/meta-period-report-excel.md` — Excel 五 Sheet
+- `references/analytics/facebook-analysis-guide.md` — API 字段
+- `references/core/deliverable-preflight.md` — 交付审阅
+- `assets/website-diagnosis-rules.md` — 网站诊断（对照参考）

package/dist/skill/assets/meta-period-report.schema.json

@@ -60,8 +60,9 @@
         },
         "recommendations": {
           "type": "array",
-          "description": "优化建议固定 4 条",
-          "minItems": 1,
+          "description": "优化建议固定 4 条；每条 content ≥150 字且引用当次数据（见 meta-period-report-rules.md）",
+          "minItems": 4,
+          "maxItems": 4,
           "items": {
             "type": "object",
             "required": ["title", "content"],
@@ -70,12 +71,39 @@
                 "type": "string",
                 "enum": ["简化表单问题", "区域调整", "预算重构", "素材建议"]
               },
-              "content": { "type": "string" }
+              "content": {
+                "type": "string",
+                "description": "≥150 字；严重问题以「强烈建议：」开头，其余以「推荐优化：」开头"
+              }
             }
           }
         }
       }
     },
+    "supplementaryRecommendations": {
+      "type": "array",
+      "description": "7 维数据驱动补充建议（预算/平台/地域/受众/创意/频次/接口限制）；每条 suggestion ≥60 字",
+      "minItems": 7,
+      "maxItems": 7,
+      "items": {
+        "type": "object",
+        "required": ["dimension", "issue", "suggestion"],
+        "properties": {
+          "dimension": { "type": "string" },
+          "issue": { "type": "string" },
+          "suggestion": { "type": "string" }
+        }
+      }
+    },
+    "priorityPlan": {
+      "type": "object",
+      "description": "高/中/低优先级改进计划（对齐网站诊断 PriorityPlan）",
+      "properties": {
+        "high": { "type": "array", "items": { "type": "string" }, "minItems": 2 },
+        "medium": { "type": "array", "items": { "type": "string" }, "minItems": 2 },
+        "low": { "type": "array", "items": { "type": "string" }, "minItems": 2 }
+      }
+    },
     "tables": {
       "type": "object",
       "description": "Sheet2～5 表格数据；可省略，由 --snapshot-dir 合并",
@@ -106,11 +134,12 @@
     "executiveSummary": {
       "type": "array",
       "items": { "type": "string" },
-      "description": "HTML 深度分析扩展：多段执行摘要（可选，优先用 narrative.overall）"
+      "minItems": 3,
+      "description": "HTML 默认交付必填：3～5 段执行摘要，每段 ≥80 字；可深化 narrative.overall"
     },
     "healthDiagnosis": {
       "type": "object",
-      "description": "HTML 深度分析扩展：账户健康诊断（Excel 不含）",
+      "description": "HTML 默认交付必填：四问卡片 + 红绿灯表（Excel 不含）",
       "properties": {
         "lifecyclePhase": { "enum": ["test-market", "find-winner", "scale"] },
         "lifecycleVerdict": { "type": "string" },

package/dist/skill/references/README.md

@@ -69,6 +69,8 @@
 | ---- | ---- |
 | `campaign-create-template.md` / `.json` | 搜索系列 batch 契约 |
 | `website-diagnosis-rules.md` | 网站诊断评分项与 JSON Schema |
+| `meta-period-report-rules.md` | Meta 周期报告内容丰富度与建议撰写规则 |
+| `meta-period-report.schema.json` | Meta 周期报告 Agent JSON Schema |
 | `pmax-create-template.md` / `.json` | PMax 新建契约 |
 | `pmax-asset-group-template.json` | PMax 素材组 |
 | `pmax-signals-template.json` | PMax 信号 |

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

@@ -30,23 +30,52 @@ siluzan-tso list-accounts [选项]
 
 需要真实余额或消耗时：单户优先 `balance` / `stats`；列表顺带看余额/消耗时加 `--detail`。**禁止**在 JSON 无余额/消耗字段时臆造数值。
 
-**示例：**
+### Agent 意图速查（**必读 · 避免多次试探**）
+
+用户问「有哪些 / 列出全部 / 有多少」某媒体广告账户时，**第一次 CLI 就应带大 `--page-size`**，**禁止**先用默认 20 条再翻页重试。
+
+| 用户意图 | 推荐命令（一步） | 脚本读落盘 JSON |
+| -------- | ---------------- | --------------- |
+| 列出全部 Google 账户 | `list-accounts -m Google --page-size 999 --json-out <dir>` | `items[]`（`ma.mediaCustomerId`、`ma.mediaCustomerName`、`ma.currencyCode`、`ma.mediaAccountState` 等） |
+| 有多少个 Google 账户 | 同上 | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大） |
+| 列出全部某媒体（TikTok / MetaAd 等） | `list-accounts -m <媒体> --page-size 999 --json-out <dir>` | 同上 |
+| 只查某一个户 | `list-accounts -m <媒体> -k <id或名称> --json-out <dir>` | 无需大 page-size |
+| 列表顺带看余额/消耗 | 在上述命令加 `--detail`（**明显变慢**；仅用户要余额/消耗时） | 含 `ma.balance` 等 enrichment 字段 |
+
+**执行纪律**：
+
+1. **一次 CLI**：`--page-size 999` + `--json-out <dir>`；**不要**默认 20 条后再循环 `--page`。
+2. **stdout 只是摘要**（`kind=siluzan-tso-cli-json-snapshot`），**没有** `total` / `items`；业务数据在 `writtenFiles[0]`（如 `list-accounts-google.json`），**必须用脚本读盘**。
+3. 仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环。
+4. 列账户 / 数个数 **不需要** `accounts-digest`、`balance-scan`（那些是消耗汇总或余额预警）。
 
 ```bash
-# 查询所有 Google 账户（默认：JSON 不含余额/消耗字段）
-siluzan-tso list-accounts -m Google
+# ✅ 推荐：列出或统计全部 Google 账户（Agent 默认路径）
+siluzan-tso list-accounts -m Google --page-size 999 --json-out ./snap-accounts
 
-# 列表同时带出真实余额与近期消耗（较慢）
-siluzan-tso list-accounts -m Google --detail
+# 脚本读盘（示例）
+node -e "
+const fs=require('fs');
+const p='./snap-accounts/list-accounts-google.json';
+const d=JSON.parse(fs.readFileSync(p,'utf8'));
+console.log('total:', d.total, '本页:', d.itemCount);
+"
+```
+
+**示例：**
+
+```bash
+# 关键字搜索（单户/少量，无需大 page-size）
+siluzan-tso list-accounts -m Google -k "品牌A" --json-out ./snap
 
-# 关键字搜索
-siluzan-tso list-accounts -k "品牌A"
+# 只看正常状态
+siluzan-tso list-accounts -m TikTok -s normal --page-size 999 --json-out ./snap
 
-# 只看正常状态，输出 JSON 供后续处理
-siluzan-tso list-accounts -m TikTok -s normal --json-out ./snap
+# 列表同时带出真实余额与近期消耗（较慢，仅用户要余额/消耗时）
+siluzan-tso list-accounts -m Google --page-size 999 --detail --json-out ./snap
 
-# 分页获取（第 2 页，每页 50 条）
-siluzan-tso list-accounts --page 2 --page-size 50
+# 极少数账户超过 999 条时才翻页（先确认读盘 total > itemCount）
+siluzan-tso list-accounts -m Google --page 2 --page-size 999 --json-out ./snap-p2
 ```
 
 **输出字段说明：**

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

@@ -293,12 +293,13 @@ siluzan-tso facebook-analysis -a <id> --json-out ./snap-fb
 siluzan-tso facebook-analysis -a <id> --sections country --limit 10 --json-out ./snap-fb
 ```
 
-### 报告模板
+### 报告模板与交付流程
 
-| 场景 | 模板 |
-| --- | --- |
-| 周期 / 月报 / 周报 | `report-templates/meta-period-report.md`（终稿 HTML：`facebook-analysis render`） |
-| 深度诊断 | `report-templates/meta-account-diagnosis-report.md` |
+| 场景 | 模板 | 默认终稿 |
+| --- | --- | --- |
+| 周期 / 月报 / 周报 | `report-templates/meta-period-report.md` | **HTML**（四步：拉数 → 分析 → `meta-period-report.json` → `facebook-analysis render`） |
+| 用户指定 Excel | `report-templates/meta-period-report-excel.md` | Agent 脚本写 `.xlsx`（步骤 1～3 同上；**不**默认 `render`） |
+| 深度诊断 | `report-templates/meta-account-diagnosis-report.md` | 按该模板（通常 HTML） |
 
 遗留总览：`siluzan-tso report meta-overview -a <id> [--start … --end …] --json-out <dir>`。
 
@@ -374,7 +375,7 @@ siluzan-tso report bing-audience-merged -a <mediaCustomerId> --json-out ./snap-b
 | `meta-period-report.md`              | Meta（Facebook）周期报告    |
 | `tiktok-period-report.md`            | TikTok 周期报告             |
 | `bing-period-report.md`              | Bing 周期报告               |
-| `website-diagnosis-report.md`      | 网站/落地页诊断（`website-diagnosis`，见 `website-diagnosis-guide.md` P8） |
+| `website-diagnosis-report.md`      | 网站/落地页诊断（`website-diagnosis`，见 P8）；**默认交付 HTML**（`website-diagnosis render`，禁止仅 Markdown） |
 | `README.md`                          | 索引与规则                  |
 
 `.html` 文件（`report-template.html`、`report-template-academic.html` 等）为 HTML 路线的样式参考。选其他格式时仍以各 `*.md` 纲要为章节清单。

package/dist/skill/references/analytics/facebook-analysis-guide.md

@@ -4,6 +4,25 @@
 
 ---
 
+## 周期报告标准流程（默认 HTML）
+
+用户要 **Facebook / Meta 分析报告**且**未指定交付格式**时，按以下四步执行：
+
+| 步骤 | 说明 |
+| ---- | ---- |
+| **1. 拉数** | `facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb`（默认 `--sections overview,ad-sets,platform,country,audience`） |
+| **2. 分析** | Agent 用脚本读 `report-manifest-<id>.json` 与各 `<section>-<id>.json`，完成聚合与洞察（禁止 Read 业务 JSON、禁止对话里手填数） |
+| **3. 写 JSON** | 产出 `meta-period-report.json`（`narrative` 必填；HTML 扩展字段按需） |
+| **4. 渲染** | `facebook-analysis render --data ./meta-period-report.json --snapshot-dir ./snap-fb --out ./meta-period-report.html` |
+
+**禁止**：跳过步骤 3/4 直接交付 Markdown；禁止 Agent 手写 HTML。
+
+### Excel 分支（仅用户指定时）
+
+用户明确要求 **Excel / xlsx** 时：步骤 1～3 相同；步骤 4 改为 Agent 脚本按 `meta-period-report-excel.md` 写 `.xlsx`，**不**调用 `render`（除非同时要 HTML）。
+
+---
+
 ## 与 Google 周期报告的能力对照
 
 | Google 默认/常见维度 | Facebook 对应 | CLI | 说明 |
@@ -93,16 +112,16 @@
 
 ---
 
-## 周期报告默认拉数（对齐 Excel 五 Sheet）
+## 周期报告默认拉数（步骤 1）
 
 ```bash
 mkdir -p ./snap-fb
-siluzan-tso facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb
-# 等价显式（Excel 模板默认，不含 creative）：
-# --sections overview,ad-sets,platform,country,audience
+siluzan-tso facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb \
+  --sections overview,ad-sets,platform,country,audience
 ```
 
-Excel 模板章节与叙事结构：**`report-templates/meta-period-report-excel.md`**。Agent JSON Schema：**`assets/meta-period-report.schema.json`**。
+叙事结构与 Agent JSON：**`meta-period-report.md`** + **`assets/meta-period-report.schema.json`**。  
+仅 Excel 交付时再读 **`report-templates/meta-period-report-excel.md`**（5 Sheet 版式）。
 
 可选追加：`--sections material`（DC 账户）。
 
@@ -110,9 +129,10 @@ Excel 模板章节与叙事结构：**`report-templates/meta-period-report-excel
 
 ---
 
-## HTML 终稿渲染（对齐网站诊断 `render`）
+## HTML 终稿渲染（步骤 4 · 默认交付）
 
-Agent 读完各 section JSON 后撰写 `meta-period-report.json`（叙事 + 健康诊断结构），**禁止手写 HTML**：
+完成步骤 2（分析）与步骤 3（`meta-period-report.json`）后执行，**禁止手写 HTML**。  
+`render` 为独立子命令，**不需要** `-a` / `--json-out`（与批拉命令分离）：
 
 ```bash
 siluzan-tso facebook-analysis render \
@@ -129,15 +149,29 @@ siluzan-tso facebook-analysis render \
 
 ## 优化建议撰写清单（不额外拉数）
 
-结合已拉维度，至少覆盖：
+**必读** `assets/meta-period-report-rules.md`（对齐 P8 网站诊断：每条建议须**引用当次数字** + **可执行动作**，禁止空话）。
+
+### 三层建议结构
+
+| 层级 | JSON 字段 | 要求 |
+| ---- | --------- | ---- |
+| 固定 4 条 | `narrative.recommendations[]` | 标题枚举 4 个；每条 content **≥150 字** |
+| 7 维补充 | `supplementaryRecommendations` | 预算/平台/地域/受众/创意/频次/接口限制 **各 1 条** |
+| 优先级 | `priorityPlan` | high/medium/low 各 **≥2 条** |
+
+### 7 维数据驱动要点
+
+1. **预算**：高 `spendPercentage` 但 `costPerResult` 差的 Ad Set → 降预算 % / 暂停（写组名与数字）。
+2. **平台/版位**：`publisherPlatform` + `platformPosition` 组合（勿只读 `network`）。
+3. **地域**：高消耗国家转化差 → geo 排除 / 收窄（写国家名与 CPL）。
+4. **受众**：低效 age×gender → 排除或降 bid（写年龄段）。
+5. **创意**：关停高花费低 `results` 的 ad；复制 winner 结构。
+6. **频次**：`frequency` >2.5 + 转化差 → 扩受众或换创意。
+7. **接口限制**：按日/关键词等 — 一句「Meta 接口未提供」，不编造。
+
+### HTML 默认交付（还须填）
 
-1. **预算**：高 `spendPercentage` 但 `costPerResult` 差的 Ad Set → 降预算/暂停。
-2. **平台/版位**：按 `publisherPlatform` + `platformPosition` 定位高消耗低 `costPerResult` 组合（勿只读 `network`）；可分别按平台或版位汇总后给减投建议。
-3. **地域**：高消耗国家转化差 → 收窄/geo 排除。
-4. **受众**：低效 age×gender → 收窄定向。
-5. **创意**：关停高消耗低 `results` 的 ad；复制 winner 的 `creativeType`/文案结构。
-6. **频次**：`frequency` 过高 + 转化下滑 → 扩受众或换创意。
-7. **无法做的 Google 项**：按日趋势、关键词、质量分等 — 一句说明「接口未提供」，不编造。
+`executiveSummary`（3～5 段）、`healthDiagnosis`（四问+红绿灯）、`sections.*.insight`（各 ≥200 字）、`abTests`（≥3）、`actionChecklist` — 见 rules 文档 §四。
 
 ---
 

package/dist/skill/references/analytics/website-diagnosis-guide.md

@@ -2,7 +2,7 @@
 
 > 对齐 Aiagent-Server `agent/tso_agent`：`getWebsiteDiagnosisData`（`website_diagnosis_tools.py` + `data/website_guide.py`）。  
 > **CLI 负责拉数**；**6 模块 × 29 子项评分**由 Agent 按规则 + 采集数据生成 JSON。  
-> **最终交付**：与线上一致，为**一份可浏览器打开、含 ECharts 图表的单文件 HTML 报告**（雷达图、模块得分条形图、Lighthouse 对比图等）。TSO 网页由 Vue `WebsiteAnalysisReport/v3` 渲染；Skill/CLI 场景 **Agent 只写诊断 JSON，HTML 一律由 `website-diagnosis render` 生成**（禁止 Agent 手写 HTML）。
+> **最终交付**：与线上一致，为**一份可浏览器打开、含 ECharts 图表的单文件 HTML 报告**（雷达图、模块得分条形图、Lighthouse 对比图等）。**用户未指定格式时默认交付 HTML**；TSO 网页由 Vue `WebsiteAnalysisReport/v3` 渲染；Skill/CLI 场景 **Agent 只写诊断 JSON，HTML 一律由 `website-diagnosis render` 生成**（禁止 Agent 手写 HTML，禁止仅 Markdown/JSON 充当终稿）。
 
 ---
 

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

@@ -111,7 +111,7 @@
 
 **例外**（不反问）：
 
-- `list-accounts` 全量：用 `--json-out`，注意翻页；**默认无 `--detail` 时 JSON 不含余额/消耗字段**；要看列表内真实值须加 `--detail` 或另跑 `balance`/`stats`
+- `list-accounts` 列全部 / 数个数：一次 `list-accounts -m <媒体> --page-size 999 --json-out <dir>`，脚本读落盘 `list-accounts-*.json` 的 `total` / `items[]`；**禁止**默认 page-size 20 再翻页；**禁止**对 stdout 摘要解析 `total`/`items`（见 `accounts/accounts.md` § Agent 意图速查）；**默认无 `--detail` 时 JSON 不含余额/消耗**；要看余额/消耗加 `--detail` 或另跑 `balance`/`stats`
 - 「昨天」单日 stats：默认 `Asia/Shanghai` 日历日；先 `list-accounts` 再 `stats`
 - 仅持有 `entityId`：先 `list-accounts` 解出 `mediaCustomerId`，**禁止**把 `entityId` 传给 `stats -a` / `balance -a`
 - `forewarning records`、`invoice list`「本月」、TikTok `clue`「最近一周」：见对应 references

package/dist/skill/references/core/deliverable-preflight.md

@@ -51,7 +51,7 @@
 - [ ] **无**整章空白（除非该章标注 `[ 数据不可用：… ]`）
 - [ ] 执行摘要 / 概览：有消耗、展示、点击等**至少一项非空数字**（或明确写无数据）
 - [ ] 周期报告默认维（P4）：概览、日趋势、系列、设备、地域、关键词等**均有对应段落**（Meta 无接口的维度按模板写「未提供」）
-- [ ] 优化建议：独立一节，**不是**只有表格没有文字
+- [ ] 优化建议：独立一节，**不是**只有表格没有文字（Meta：**4 条 + 7 维补充**，每条引用当次数字，见 `meta-period-report-rules.md`）
 - [ ] Google 诊断：每模块除表格外有「分析」+「建议」（见 `google-ads-diagnosis.md`）
 
 **不通过** → 补拉 CLI 维度、重跑生成逻辑、**重写产物**后再 Read 审阅。
@@ -93,8 +93,9 @@
 | -------- | ---------- |
 | P1 | 画像是否含 stats + 系列要点；币种 |
 | P4 | `google-period-report.md` 8 块是否齐 |
-| P4-FB | 无接口维度是否写「未提供」 |
+| P4-FB | 对照 `meta-period-report-rules.md`：**4 条建议各 ≥150 字** + **7 维补充建议**；HTML 须无「待 Agent 撰写」占位，含执行摘要/四问/红绿灯/优化建议节；Excel：总数据叙事 4 块非空话 |
 | P6 / P7 | 按各自 `report-templates/*.md` Sheet/章节表逐项 |
+| P8 | **HTML 终稿**（非 Markdown）：`website-diagnosis-report.md` 六模块章节齐全；雷达图/得分环/条形图/Lighthouse 由 `render` 注入；Lighthouse 缺失时 callout 已说明 |
 
 ---
 

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

@@ -8,11 +8,11 @@
 | P2 | 多账户余额扫描 | `accounts/accounts.md`（`balance-scan`）、`accounts/currency.md` |
 | P3 | 多账户投放画像汇总 | `accounts/accounts.md` § accounts-digest、`accounts/currency.md`、`core/tips.md` |
 | P4 | Google 账户周期报告 | `report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md`、`core/deliverable-preflight.md` |
-| P4-FB | Meta/Facebook 周期报告 | `report-templates/meta-period-report.md`、`analytics/facebook-analysis-guide.md`、`analytics/account-analytics.md`、`core/tips.md` |
+| P4-FB | Meta/Facebook 周期报告 | `report-templates/meta-period-report.md`、`assets/meta-period-report-rules.md`、`analytics/facebook-analysis-guide.md`、`core/deliverable-preflight.md` |
 | P5 | 多账户多维度报告 | `analytics/google-analysis-batch.md`、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
 | P6 | OKKI 周报 | `report-templates/okki-weekly-google-client.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
 | P7 | Google 询盘分析 | `report-templates/google-inquiry-analysis.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`、`analytics/geo-continents.json`；可选 `core/subagent-orchestration.md` |
-| P8 | 网站诊断 | `analytics/website-diagnosis-guide.md`、`assets/website-diagnosis-rules.md`、`report-templates/website-diagnosis-report.md`、`core/tips.md` |
+| P8 | 网站诊断 | `analytics/website-diagnosis-guide.md`、`assets/website-diagnosis-rules.md`、`report-templates/website-diagnosis-report.md`、`core/tips.md`、`core/deliverable-preflight.md` |
 | P9 | 战略市场分析 | `analytics/market-analysis-guide.md`、`assets/market-analysis-rules.md`、`report-templates/market-analysis-report.md`、`core/tips.md` |
 
 ---
@@ -74,18 +74,23 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 
 ## P4-FB · Meta/Facebook 账户周期报告
 
-1. `list-accounts -m MetaAd -k <mediaCustomerId> --json-out ./snap-fb` 确认账户。
+> **默认交付 HTML**（`facebook-analysis render`）。用户**明确要求 Excel** 时改走 `meta-period-report-excel.md`（Agent 脚本写 xlsx，无 CLI excel 子命令）。
+
+1. `list-accounts -m MetaAd -k <mediaCustomerId> --json-out ./snap-fb` 确认账户与 `currencyCode`。
 2. 确认 `--start` / `--end`（>3 个月可分段，与 P4 相同）。
-3. **一次批拉**（默认 6 维，对齐 Google 周期主章节）：
+3. **步骤 1 · 拉数**（默认 5 维；用户要创意时加 `creative`）：
 
    ```bash
    siluzan-tso facebook-analysis -a <id> --start <S> --end <D> --json-out ./snap-fb \
-     --sections overview,ad-sets,platform,country,audience,creative
+     --sections overview,ad-sets,platform,country,audience
    ```
 
-4. 按 `report-templates/meta-period-report.md` 撰写；字段与 Google 对照见 `analytics/facebook-analysis-guide.md`。
-5. 无按日趋势/关键词/质量分等：对应章节写「接口未提供」，**禁止编造**。
-6. 用户要素材 Tab 时追加 `--sections material`（或全量省略 `--sections`）。
+4. **步骤 2 · 分析**：脚本读落盘 JSON，聚合指标与洞察（见 `analytics/facebook-analysis-guide.md`）。
+5. **步骤 3 · 写 JSON**：Read **`assets/meta-period-report-rules.md`**；先 outline 后落盘 `meta-period-report.json`（`narrative` 4 条建议各 ≥150 字 + `supplementaryRecommendations` 7 维 + HTML 必填扩展字段）；无按日/关键词等写「接口未提供」，**禁止编造**。
+6. **步骤 4 · 交付**：
+   - **默认（HTML）**：`facebook-analysis render --data ./meta-period-report.json --snapshot-dir ./snap-fb --out ./meta-period-report.html`
+   - **用户要 Excel**：Agent 脚本按 `meta-period-report-excel.md` 写 `.xlsx`（步骤 1～3 不变；**不**默认调用 `render`）
+7. 交付前：**Read 最终 HTML 或 xlsx**，对照 `deliverable-preflight.md` 自检。
 
 诊断场景改用 `report-templates/meta-account-diagnosis-report.md`，拉数可省略 `--sections` 拉全 7 维。
 
@@ -175,7 +180,8 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 
 ## P8 · 网站诊断
 
-> **触发**：用户要对某 URL 做网站/落地页诊断、投放前网站评分，或话术含「网站诊断」「落地页质量」（**非** Google 账户 `AdvertisingDiagnosis`）。
+> **触发**：用户要对某 URL 做网站/落地页诊断、投放前网站评分，或话术含「网站诊断」「落地页质量」（**非** Google 账户 `AdvertisingDiagnosis`）。  
+> **默认交付格式**：**HTML**（`website-diagnosis render` → `website-diagnosis-report.html`）。用户未指定格式时一律交付 HTML；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。
 
 1. 确认完整 URL（`https://` 可省略，CLI 自动补全）。
 2. 采集原料（**必须** `--json-out`）：

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

@@ -26,6 +26,7 @@
 每条 `--json-out` 命令成功后，**必须**按以下顺序处理，不要跳步、不要把 outline 当数据：
 
 1. **解析 stdout 一行摘要 JSON**（禁止 Read 打开 `writtenFiles[0]` 的 `.json`）：拿到 `outlineFile`、`writtenFiles[0]`、`manifestFile`、`agentHint`。**不要硬编码 `<section>.json` 文件名**。
+   - **反例（常见踩坑）**：摘要里**没有** `total`、`items`、`page` 等业务字段；`JSON.parse(stdout)` 后取 `result.total` 会得到 `undefined`。**禁止**用 stdout 写翻页循环；`total` / `items` 只存在于 `writtenFiles[0]` 落盘文件（如 `list-accounts-google.json`）。
 2. **了解字段结构**（二选一，推荐 A）：
    - **A**：宿主 **Read** 仅 `outlineFile`（`*.outline.txt`，体积小）；或
    - **B**：`node -e "const fs=require('fs'); const o=fs.readFileSync(process.argv[1],'utf8').trimEnd().split('\\n').filter(l=>!l.startsWith('//')); console.log(o.pop())" <outlineFile>`
@@ -320,8 +321,9 @@ console.log('可用字段：', first && Object.keys(first));
 
 ## 通用分页与查询建议
 
-- 绝大多数列表类命令默认每页 20 条记录，数据量较大时建议显式指定分页参数。
-- 建议在拉取大批量数据时使用命令自带的 `--page-size`（如设置为 `100`）与 `--page` 组合翻页，确认无更多数据后再停止，避免遗漏。
+- 绝大多数列表类命令默认每页 20 条记录，数据量较大时须显式指定 `--page-size`。
+- **`list-accounts` 列全部 / 数个数**：优先 **`--page-size 999` 一次拉取** + `--json-out` + 脚本读盘（见 `accounts/accounts.md` § Agent 意图速查）；**不要**先试默认 20 再翻页。
+- 其他列表命令（报告列表、发票列表等）在单页拉不满时，再用 `--page-size`（如 `100`）与 `--page` 组合翻页；读盘确认 `total > itemCount` 后再补下一页。
 
 ---
 

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

@@ -550,8 +550,11 @@ siluzan-tso report delete --ids <id1>,<id2>
 1. 确认账户 ID（`list-accounts`）与日期区间。
 2. 选定对应媒体的 `report-templates/*.md`（Google 周期分析默认 `google-period-report.md`；用户说 **「使用 okki 周报模板」「OKKI 周报」** 等 → **`okki-weekly-google-client.md`**，见 SKILL **P6**）。
 3. 按该 `*.md` 的**默认维度**直接拉数；**若为 OKKI 周报模板则固定维度、不追问追加**；否则向用户发消息，展示**可选追加维度**列表（见该 `*.md`），询问是否追加。
-4. 用默认维度数据撰写报告；用户追加的维度数据到位后，补充在末尾。
-5. 可选：按 `report-template*.html` 选择 HTML 样式输出（未指定时默认 `report-template.html`）。
+4. 用脚本分析落盘 JSON，撰写报告中间产物（Google：直接写 HTML/Markdown；**Meta/Facebook**：写 `meta-period-report.json`）。
+5. **交付格式**：
+   - **Meta/Facebook 周期报告（默认）**：`facebook-analysis render` → HTML（见 `meta-period-report.md` 四步流程）；用户指定 Excel 时 Agent 脚本写 xlsx，见 `meta-period-report-excel.md`。
+   - **Google 等**：按 `report-template*.html` 选择样式（未指定时默认 `report-template.html`）。
+6. 用户追加的维度数据到位后，更新 JSON/报告并重新渲染（Meta）或补充章节（Google）。
 
 ---
 
@@ -781,17 +784,31 @@ siluzan-tso balance -m Google -a <mediaCustomerId>
 
 广告投放前需评估落地页质量：页面访问速度、产品描述完整性、转化代码部署、移动端适配等。系统通过 Lighthouse + AI 分析给出评分和优化建议，判断该页面是否适合直接投放广告。
 
-### Agent 操作流程
+### Agent 操作流程（P8 · 默认交付 HTML）
 
-**网站诊断**（需在网页完成）：
+**网站诊断**（CLI + Skill，**默认产出 HTML 终稿**）：
 
 ```bash
-# 引导用户打开网站诊断页面（在 AICreation 流程中内嵌，或直接访问）
-siluzan-tso config show   # 取 webUrl
+# 1. 采集 Lighthouse + 首页 HTML
+siluzan-tso website-diagnosis collect --url <url> --json-out ./snap-web
+
+# 2. Agent 按 website-diagnosis-rules.md 生成 diagnosis.json（脚本落盘）
+
+# 3. 生成带图表的 HTML 报告（用户未指定格式时必做）
+siluzan-tso website-diagnosis render \
+  --data ./diagnosis.json \
+  --collect ./snap-web/<collect>.json \
+  --out ./snap-web/website-diagnosis-report.html
+```
 
-# 诊断入口（网页 AICreation 向导内嵌）：
+向用户交付 `website-diagnosis-report.html` 路径；**禁止**仅交付 Markdown 或 JSON。详见 `references/core/playbooks.md` P8、`references/analytics/website-diagnosis-guide.md`。
+
+**TSO 网页内嵌诊断**（Copilot / AICreation 向导，可选）：
+
+```bash
+siluzan-tso config show   # 取 webUrl
 # https://www-ci.siluzan.com/v3/foreign_trade/tso/advertising/AICreation
-# → 输入推广链接时，系统会自动触发网站诊断
+# → 输入推广链接时，系统会自动触发网站诊断并渲染 Vue 全页 HTML
 ```
 
 **CLI 辅助**（诊断前后核对账户授权）：

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

@@ -18,8 +18,8 @@
 | `google-period-report.md`            | Google 账户分析报告（周期/月度/诊断均用此模板）                                                                |
 | `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等）                                                                      |
 | `google-ads-diagnosis.md`            | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**）                      |
-| `meta-period-report.md` / `.html`    | **Meta（Facebook）周期报告**：终稿 HTML；配合 `facebook-analysis render`，见 P4-FB |
-| `meta-period-report-excel.md`        | **Excel 五 Sheet 业务模板规格**（总数据叙事 + 4 维表；内容基准） |
+| `meta-period-report.md` / `.html`    | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |
+| `meta-period-report-excel.md`        | **仅用户要 Excel 时**：5 Sheet xlsx 版式；Agent 脚本写表，无 CLI excel 子命令 |
 | `meta-account-diagnosis-report.md`   | Meta（Facebook）诊断报告（在 7 Section 内对齐 Google 诊断结构）                                                |
 | `tiktok-period-report.md`            | TikTok 广告主周期报告                                                                                          |
 | `bing-period-report.md`              | Bing（BingV2）分析报告                                                                                         |

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

@@ -59,12 +59,22 @@
 
 ---
 
-### 步骤 5：撰写报告
+### 步骤 5：分析并撰写中间产物
 
-- 按 `*.md` 章节结构组织内容。
-- 所有数字可追溯到具体命令的 JSON 输出字段。
-- 最后写**优化建议**（基于已有数据，不额外拉数）。
-- 可选：按 `report-template*.html` 选择 HTML 样式输出（未指定时默认 `report-template.html`）。
+- 用 **node/python 脚本**读落盘 JSON，完成聚合与洞察（禁止 Read 业务 JSON、禁止对话手填数）。
+- 按 `*.md` 章节结构组织叙事与建议；所有数字可追溯到 JSON 字段。
+- **Meta/Facebook**：产出 `meta-period-report.json`（见 `meta-period-report.md`）。
+- **Google 等**：可直接组织 Markdown/HTML 正文。
+
+### 步骤 5b：生成终稿（按媒体与格式）
+
+| 媒体 | 用户未指定格式 | 用户指定 Excel |
+| ---- | -------------- | -------------- |
+| **Meta/Facebook** | `facebook-analysis render` → **HTML**（必做） | Agent 脚本按 `meta-period-report-excel.md` 写 xlsx；**不**默认 `render` |
+| **Google** | 按 `report-template*.html` 写 HTML（默认 `report-template.html`） | OKKI / 询盘等见各自 `*.md` |
+| **网站诊断** | `website-diagnosis render` → HTML | — |
+
+**禁止**：Meta 周期报告默认只交 Markdown/JSON；禁止 Agent 手写 Meta HTML。
 
 **Google 广告诊断报告**（`google-ads-diagnosis.md` / `google-account-diagnosis-report.md`）额外必遵：
 

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

@@ -1,7 +1,10 @@
 # Meta（Facebook）周期报告 — Excel 模板规格
 
+> **适用场景**：用户**明确要求 Excel / xlsx** 交付时读本文件。  
+> 用户未指定格式时，**默认交付 HTML**，走 `meta-period-report.md` 标准四步（拉数 → 分析 → 写 JSON → `facebook-analysis render`），**不要**默认走 Excel。
+
 > 对照业务交付物：`无锡顺晟Facebook4月报告.xlsx`（5 个 Sheet）。  
-> CLI 拉数 → Agent 按本规格写 `meta-period-report.json` → `facebook-analysis render` 出 HTML。
+> Excel 流程：CLI 拉数 → Agent 分析并写 `meta-period-report.json` → **Agent 脚本**按本规格写 `.xlsx`（**无** CLI 内置 excel 子命令）。
 
 ---
 
@@ -84,14 +87,21 @@ Excel 导出列与 API 字段对照（撰写/渲染时统一用 API camelCase，
 - **1 段话**对比 Top 国家：最低 CPL 国家、最高 CPL 国家、中间梯队。
 - 数据依据：`country-<id>.json` → `countries[]`（按 `costPerResult` 或 `spend` 排序）。
 
-### 4. 优化建议（固定 4 条）
+### 4. 优化建议（固定 4 条 + 7 维补充）
+
+**每条 `content` ≥150 字**，须引用当次国家名/CPL/广告组名；严重项以「强烈建议：」开头。完整规则见 **`assets/meta-period-report-rules.md`**。
 
 | # | 标题 | 撰写要点 |
 | - | ---- | -------- |
-| 1 | **简化表单问题** | 结合高频次低转化市场，建议表单字段缩减（姓名+联系方式+需求类型） |
-| 2 | **区域调整** | 按广告组写语言/市场策略（如土耳其语、葡萄牙语、德语三套） |
-| 3 | **预算重构** | 组间预算比例（如 4:3:3）、测试周期（7 天）、优胜劣汰规则 |
-| 4 | **素材建议** | 素材轮播数量、IG 短视频时长、FB 是否换形态、分市场卖点差异 |
+| 1 | **简化表单问题** | 点名高频次高 CPL 国家/组；字段缩减至 3 项；写预期 CPL 改善 |
+| 2 | **区域调整** | 按广告组写语言/市场策略；写清加谁、减谁、暂停谁 |
+| 3 | **预算重构** | 具体比例（如 4:3:3）、测试 7/14 天、CPL 阈值优胜劣汰 |
+| 4 | **素材建议** | 分 IG/FB、分市场；素材套数、视频时长、高花费低结果创意处理 |
+
+**Excel 总数据 Sheet 另须**（可写在 4 条之后或单独小节）：
+
+- `supplementaryRecommendations` 7 维表（预算/平台/地域/受众/创意/频次/接口限制）
+- `priorityPlan` 高/中/低各 ≥2 条（推荐）
 
 ---
 
@@ -140,12 +150,16 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> \
     ],
     "country": "土耳其单条9.45美元，远低于其他国家…",
     "recommendations": [
-      { "title": "简化表单问题", "content": "…" },
-      { "title": "区域调整", "content": "…" },
+      { "title": "简化表单问题", "content": "强烈建议：…（≥150字，含国家/CPL数字）" },
+      { "title": "区域调整", "content": "推荐优化：…" },
       { "title": "预算重构", "content": "…" },
       { "title": "素材建议", "content": "…" }
     ]
   },
+  "supplementaryRecommendations": [
+    { "dimension": "预算与广告组", "issue": "…", "suggestion": "…" }
+  ],
+  "priorityPlan": { "high": ["…"], "medium": ["…"], "low": ["…"] },
   // 对应 Sheet2～5 表格 + 图表：可省略，由 --snapshot-dir 自动合并
   "tables": {
     "adSets": [/* 见 merge-snapshot */],
@@ -184,7 +198,9 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> \
 
 ---
 
-## 渲染命令
+## HTML 渲染（可选 · 非 Excel 默认路径）
+
+用户**同时要 HTML** 或**未要 Excel、走默认流程**时，在写完 `meta-period-report.json` 后执行：
 
 ```bash
 siluzan-tso facebook-analysis render \
@@ -193,6 +209,8 @@ siluzan-tso facebook-analysis render \
   --out ./meta-period-report.html
 ```
 
+**仅交付 Excel** 时可跳过本节。
+
 ---
 
 ## 相关文档

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

@@ -128,6 +128,104 @@ tr:hover td{background:rgba(255,255,255,.03)}
     return items.map((p) => `<p>${escapeHtml(p)}</p>`).join("");
   }
 
+  function summaryParagraphs(data) {
+    const exec = data.executiveSummary;
+    if (Array.isArray(exec) && exec.length > 0) return exec;
+    const overall = data.narrative?.overall;
+    if (typeof overall === "string" && overall.trim()) {
+      const parts = overall.split(/(?<=[。！？])\s*/).filter((s) => s.trim());
+      return parts.length > 1 ? parts : [overall];
+    }
+    return [];
+  }
+
+  function renderNarrativePerformance(narrative) {
+    if (!narrative) return "";
+    const overall = narrative.overall
+      ? `<div class="card"><h3 style="margin-top:0">整体表现</h3><p>${escapeHtml(narrative.overall)}</p></div>`
+      : "";
+    const regional = (narrative.regional || [])
+      .map(
+        (r) => `
+<div class="card">
+  <h3 style="margin-top:0">${escapeHtml(r.adGroupName || r.campaignName || "广告组")}</h3>
+  <p>${escapeHtml(r.text || "")}</p>
+</div>`,
+      )
+      .join("");
+    const country = narrative.country
+      ? `<div class="card"><h3 style="margin-top:0">国家 / 市场对比</h3><p>${escapeHtml(narrative.country)}</p></div>`
+      : "";
+    if (!overall && !regional && !country) return "";
+    return `
+<section>
+<h2>账户表现解读（数据叙事）</h2>
+${overall}${regional}${country}
+</section>`;
+  }
+
+  function renderRecommendationsBlock(data) {
+    const recs = data.narrative?.recommendations || [];
+    const extra = data.supplementaryRecommendations || [];
+    const plan = data.priorityPlan;
+    const recCards = recs
+      .map(
+        (r) => `
+<div class="card" style="margin-bottom:12px">
+  <h3 style="margin-top:0;color:#93c5fd">${escapeHtml(r.title || "优化建议")}</h3>
+  <p>${escapeHtml(r.content || "")}</p>
+</div>`,
+      )
+      .join("");
+    const extraRows = extra
+      .map(
+        (r) => `
+<tr>
+  <td>${escapeHtml(r.dimension || "")}</td>
+  <td>${escapeHtml(r.issue || "")}</td>
+  <td>${escapeHtml(r.suggestion || "")}</td>
+</tr>`,
+      )
+      .join("");
+    const planCol = (title, items, color) => `
+<div class="card check-card" style="border-color:var(--${color})">
+<h4>${escapeHtml(title)}</h4>
+<ul>${(items || []).map((li) => `<li>${escapeHtml(li)}</li>`).join("") || '<li class="empty-note">（待补充）</li>'}</ul>
+</div>`;
+    const planHtml = plan
+      ? `
+<div class="checklist" style="margin-top:16px">
+${planCol("高优先级（本周必做）", plan.high, "red")}
+${planCol("中优先级（两周内）", plan.medium, "yellow")}
+${planCol("低优先级（持续优化）", plan.low, "green")}
+</div>`
+      : "";
+    if (!recCards && !extraRows && !planHtml) {
+      return `
+<section>
+<h2>优化建议与行动计划</h2>
+<div class="card"><p class="empty-note">（待 Agent 按 meta-period-report-rules.md 撰写 narrative.recommendations 与 supplementaryRecommendations）</p></div>
+</section>`;
+    }
+    return `
+<section>
+<h2>优化建议与行动计划</h2>
+${recCards || '<div class="card"><p class="empty-note">（待撰写固定 4 条建议：简化表单 / 区域调整 / 预算重构 / 素材建议）</p></div>'}
+${
+  extraRows
+    ? `<div class="card" style="margin-top:16px">
+<h3 style="margin-top:0">数据驱动补充建议（7 维清单）</h3>
+<table>
+<thead><tr><th>维度</th><th>发现</th><th>建议</th></tr></thead>
+<tbody>${extraRows}</tbody>
+</table>
+</div>`
+    : ""
+}
+${planHtml ? `<h3 style="margin-top:24px">优先级改进计划</h3>${planHtml}` : ""}
+</section>`;
+  }
+
   function renderHero(meta, kpis) {
     const title = meta.accountName || meta.accountId || "Meta 广告账户";
     const period = meta.periodLabel || `${meta.startDate || ""} ~ ${meta.endDate || ""}`;
@@ -493,8 +591,10 @@ ${col("本月持续优化", checklist.thisMonth, "green")}
 ${renderHero(meta, kpis)}
 <section>
 <h2>执行摘要：数据背后的「为什么」</h2>
-<div class="card">${paragraphsHtml(data.executiveSummary)}</div>
+<div class="card">${paragraphsHtml(summaryParagraphs(data))}</div>
 </section>
+${renderNarrativePerformance(data.narrative)}
+${renderRecommendationsBlock(data)}
 ${renderHealthDiagnosis(data.healthDiagnosis)}
 ${renderInsightBlock("平台策略：Facebook vs Instagram", sections.platform?.insight, "chartPlatform")}
 ${renderInsightBlock("国家 / 市场矩阵", sections.country?.insight, "chartCountry")}

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

@@ -3,13 +3,51 @@
 > 统计区间：`{startDate}` ~ `{endDate}`  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
 
-> **最终交付物：一份可打开的、带 Chart.js 图表的 HTML 文件**（如 `meta-period-report.html`），不是仅 Markdown 摘要。  
-> **内容基准**：业务 Excel 模板（5 Sheet，见 `meta-period-report-excel.md`）；HTML 可追加深度分析章节（健康诊断、A/B 实验等）。  
-> 数据：`facebook-analysis --json-out` 落盘 JSON + Agent 按本纲要生成的 `meta-period-report.json`。
+> **默认交付物**：一份可打开的、带 Chart.js 图表的 **HTML 文件**（如 `meta-period-report.html`）。  
+> 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。  
+> 用户**明确要求 Excel / xlsx** 时，改走 `report-templates/meta-period-report-excel.md` 分支（见文末「Excel 分支」）。
 
-与 `google-period-report.md` 同级流程：先拉数、再按章节撰写。字段口径见 `references/analytics/facebook-analysis-guide.md`。
+字段口径见 `references/analytics/facebook-analysis-guide.md`。  
+**内容丰富度（必读）**：`assets/meta-period-report-rules.md`（对齐 P8 网站诊断：全量建议 + 字数下限 + 7 维清单）。  
+Agent JSON Schema：`assets/meta-period-report.schema.json`。
 
-**Excel 模板对照（必读）**：`report-templates/meta-period-report-excel.md` — 定义 5 个 Sheet、统一数据列、总数据叙事 4 块 + 优化建议 4 条。JSON Schema：`assets/meta-period-report.schema.json`。
+---
+
+## 标准四步流程（默认 · 交付 HTML）
+
+| 步骤 | 执行者 | 动作 |
+| ---- | ------ | ---- |
+| **1. 拉数** | Agent 调 CLI | `facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb` |
+| **2. 分析** | Agent | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察 |
+| **3. 写 JSON** | Agent | 按本纲要撰写 `meta-period-report.json`（`meta` / `narrative` / 可选 HTML 扩展字段） |
+| **4. 渲染 HTML** | CLI | `facebook-analysis render` — **禁止** Agent 手写/拼接 HTML |
+
+```bash
+# 步骤 1
+siluzan-tso facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb \
+  --sections overview,ad-sets,platform,country,audience
+
+# 步骤 4（步骤 2～3 完成后）
+siluzan-tso facebook-analysis render \
+  --data ./meta-period-report.json \
+  --snapshot-dir ./snap-fb \
+  --out ./meta-period-report.html
+```
+
+`--snapshot-dir` 与步骤 1 的 `--json-out` 同目录；CLI 自动合并 KPI、平台/国家/受众图表与表格（Agent JSON 已有字段不覆盖）。
+
+---
+
+## Excel 分支（仅当用户指定 Excel / xlsx）
+
+用户说「要 Excel」「导出 xlsx」「按业务 Excel 模板」等时：
+
+1. 步骤 1～3 **与 HTML 流程相同**（拉数 → 分析 → 写 `meta-period-report.json`）。
+2. **步骤 4 改为**：Agent 执行 **node/python 脚本**（如 `openpyxl` / `exceljs`）读取快照 JSON + `meta-period-report.json`，按 `meta-period-report-excel.md` 写出 `.xlsx`。
+3. **不要**调用 `facebook-analysis render`（除非用户同时要 HTML + Excel）。
+4. **禁止**假设存在 `siluzan-tso … excel` 子命令。
+
+版式与 5 Sheet 结构见 **`report-templates/meta-period-report-excel.md`**。
 
 ---
 
@@ -17,13 +55,10 @@
 
 | 环节 | 实现 |
 | ---- | ---- |
-| CLI 拉数 | `facebook-analysis -a <id> --start <s> --end <e> --json-out ./snap-fb` |
-| Agent 撰写 | 读各 section JSON，产出 `meta-period-report.json`（叙事 + 可选结构化字段） |
-| **完整报告** | **Agent 只写 JSON**；终稿 HTML **必须**由 CLI 生成，**禁止** Agent 现场手写/拼接 HTML |
-
-```bash
-siluzan-tso facebook-analysis render --data ./meta-period-report.json --snapshot-dir ./snap-fb --out ./meta-period-report.html
-```
+| CLI 拉数 | 步骤 1 |
+| Agent 分析 + 撰写 | 步骤 2～3 → `meta-period-report.json` |
+| **HTML 终稿** | 步骤 4 → `facebook-analysis render` |
+| **Excel 终稿** | 仅用户指定时 → Agent 脚本写 xlsx |
 
 模板源码：
 - `report-templates/meta-period-report.html` — 结构与样式（对齐深度分析月报）
@@ -98,14 +133,18 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> --start <s> --end <e> --json-
 - 数据源：`country-<id>.json` → `countries[]`。
 - **1 段话**：最低/最高 CPL 国家、中间梯队；表格按花费或 CPL 排序展示。
 
-### 4. 优化建议（`narrative.recommendations[]`，固定 4 条）
+### 4. 优化建议（`narrative.recommendations[]` + `supplementaryRecommendations` + `priorityPlan`）
+
+**固定 4 条标题**（`narrative.recommendations[]`，每条 content **≥150 字**，须引用当次 CPL/国家/组名）：
 
 | 标题 | 内容要点 |
 | ---- | -------- |
-| 简化表单问题 | 字段过多导致放弃提交；建议 3 字段 |
-| 区域调整 | 各广告组语言/市场策略（土/葡/德等） |
-| 预算重构 | 组间比例（如 4:3:3）、测试 7 天、按 CPL 优胜劣汰 |
-| 素材建议 | 素材套数、IG 短视频、FB 形态、分市场卖点 |
+| 简化表单问题 | 结合高频次高 CPL 市场；字段缩减至 3 项；写预期影响 |
+| 区域调整 | 各广告组语言/市场策略（土/葡/德等）；加减仓名单 |
+| 预算重构 | 具体比例（如 4:3:3）、测试周期、CPL 阈值优胜劣汰 |
+| 素材建议 | 分平台/分市场；素材套数、IG 短视频、FB 形态 |
+
+**另须** `supplementaryRecommendations` **7 维**（预算、平台、地域、受众、创意、频次、接口限制）与 `priorityPlan`（高/中/低各 ≥2 条）。细则见 **`assets/meta-period-report-rules.md`**。
 
 ### 5. 平台数据（Sheet3 表 + 可选 `sections.platform.insight`）
 
@@ -122,12 +161,16 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> --start <s> --end <e> --json-
 - 仅当用户追加拉取 `creative` / `material`。
 - **勿**加总各行 `results` 与 overview 对比。
 
-### HTML 深度分析扩展（Excel 不含，按需撰写）
+### HTML 深度分析扩展（**默认交付必填**，Excel 不含）
+
+用户未指定 Excel 时，除 `narrative` 外 **必须** 填写（字数见 `meta-period-report-rules.md` §四）：
 
-- `executiveSummary[]`：多段「为什么」解读
-- `healthDiagnosis`：三阶段 / 四问 / 红绿灯表
-- `sections.*.insight`：各维度 200+ 字深度解读
-- `abTests`、`actionChecklist`、`sections.landingPage`
+- `executiveSummary[]`：**3～5 段**「为什么」解读（每段 ≥80 字）
+- `healthDiagnosis`：三阶段 + **4 张四问卡片** + **≥6 行**红绿灯表
+- `sections.platform/country/adSets.insight`：各 **≥200 字**
+- `sections.audience`：`goldenProfile` ≥3 条 + `antiProfile` ≥2 条
+- `sections.landingPage.rows`：≥3 行
+- `abTests`：≥3 个实验；`actionChecklist`：today/thisWeek/thisMonth 非空
 
 ---
 
@@ -153,12 +196,14 @@ siluzan-tso facebook-analysis -a <mediaCustomerId> --start <s> --end <e> --json-
 | **`narrative.overall`** | **Excel 必含** | 整体表现 1 段 |
 | **`narrative.regional[]`** | **Excel 必含** | `{ adGroupName, text }` 区域报告 |
 | **`narrative.country`** | **Excel 必含** | 国家对比 1 段 |
-| **`narrative.recommendations[]`** | **Excel 必含** | 固定 4 条：简化表单 / 区域调整 / 预算重构 / 素材建议 |
+| **`narrative.recommendations[]`** | **必含** | 固定 4 条，每条 ≥150 字 |
+| **`supplementaryRecommendations`** | **必含** | 7 维数据驱动建议 |
+| **`priorityPlan`** | **推荐** | 高/中/低各 ≥2 条；HTML 强烈建议填写 |
 | `tables` / `charts` | 可省略 | Sheet2～5；由快照自动汇总 |
-| `executiveSummary` | HTML 扩展 | 多段深度摘要（可替代或补充 `narrative.overall`） |
-| `healthDiagnosis` | HTML 扩展 | 三阶段 / 四问 / 红绿灯表 |
-| `sections.*.insight` | HTML 扩展 | 各维度深度解读 |
-| `abTests` / `actionChecklist` | HTML 扩展 | 实验设计与行动清单 |
+| `executiveSummary` | **HTML 必填** | 3～5 段深度摘要 |
+| `healthDiagnosis` | **HTML 必填** | 四问 + 红绿灯表 |
+| `sections.*.insight` | **HTML 必填** | 各维度 ≥200 字 |
+| `abTests` / `actionChecklist` | **HTML 必填** | ≥3 实验 + 三列行动清单 |
 
 ---
 

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

package/eval/cases/uj-ops-google-accounts-list-normal.scenario.json

@@ -4,7 +4,7 @@
   "turns": [
     "帮我查一下我所有的 Google 广告账户，看看哪些是正常状态的。用 siluzan-tso，需要 JSON。"
   ],
-  "judgeExpectation": "路径：应使用 `list-accounts -m Google`（建议 --json-out）获取账户列表，并结合返回中的状态字段解释「正常」含义；不得编造未在 CLI 输出中的账户。\n输出：可按状态分组或列表说明；stub 数据即可。",
+  "judgeExpectation": "路径：应使用 `list-accounts -m Google --page-size 999 --json-out` 一次拉全（禁止默认 page-size 20 后再多次翻页）；脚本读落盘 JSON 的 total/items，并结合状态字段解释「正常」含义；不得编造未在 CLI 输出中的账户。\n输出：可按状态分组或列表说明；stub 数据即可。",
   "skillMapping": "references/accounts/accounts.md · list-accounts",
   "judgeReferencePaths": [
     "references/accounts/accounts.md"
@@ -18,6 +18,9 @@
     ],
     [
       "--json-out"
+    ],
+    [
+      "page-size"
     ]
   ]
 }

package/package.json

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