siluzan-tso-cli 1.1.29-beta.12 → 1.1.29-beta.13

package/README.md

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

package/dist/index.js

@@ -123364,20 +123364,19 @@ async function runWebsiteDiagnosisRender(opts) {
   await fsPromises.writeFile(outPath, injectReportData(html, data), "utf8");
   const runtimeSrc = websiteDiagnosisRuntimePath();
   const runtimeOut = path17.join(outDir, TEMPLATE_BASENAMES.runtime);
+  let runtimeCopied = false;
   try {
     await fsPromises.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 \u7F51\u7AD9\u8BCA\u65AD 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\uFF08ECharts\uFF1Astaticpn.siluzan.com/homeCDN/echarts.js\uFF09\u3002\n"
   );
@@ -123454,7 +123453,7 @@ function buildMarketAnalysisAgentHint() {
   return [
     "1) Read assets/market-analysis-rules.md\uFF08\u539F\u59CB\u4E1A\u52A1\u7EF4\u5EA6\u6E05\u5355\uFF09\u4E0E report-templates/market-analysis-report.md\uFF1B",
     "2) \u7528\u5BBF\u4E3B WebSearch/WebFetch \u6309\u7F3A\u5931\u7EF4\u5EA6\u8865\u5168\u516C\u5F00\u6570\u636E\uFF1B",
-    "3) \u5C06\u5B8C\u6574 HTML \u5199\u5165 market-report.json\uFF1Brender \u4F1A\u6821\u9A8C\u5FC5\u542B\u7EF4\u5EA6\uFF0C\u7F3A\u9879\u5C06\u5931\u8D25\uFF1B",
+    "3) \u5C06\u5B8C\u6574 HTML \u5199\u5165 market-report.json\uFF08\u56FE\u8868\u7EDF\u4E00 ECharts\uFF1AhomeCDN/echarts.js + echarts.init\uFF09\uFF1Brender \u4F1A\u6821\u9A8C\u5FC5\u542B\u7EF4\u5EA6\uFF0C\u7F3A\u9879\u5C06\u5931\u8D25\uFF1B",
     "4) siluzan-tso market-analysis render --data ./market-report.json --out ./market-analysis-report.html\u3002"
   ].join(" ");
 }
@@ -123462,10 +123461,11 @@ function injectChartSizeLimitStyles(htmlContent) {
   if (!htmlContent) return htmlContent;
   const chartSizeLimitStyle = `
     <style>
+      .chart-box,
+      div[id$="Chart"],
       canvas {
         max-height: 400px !important;
         width: 100% !important;
-        height: auto !important;
       }
     </style>
   `;
@@ -123562,6 +123562,7 @@ import fs13 from "fs/promises";
 import path18 from "path";
 
 // src/commands/market-analysis/report-content.ts
+var SILUZAN_ECHARTS_CDN_URL = "https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.js";
 var MARKET_REPORT_DIMENSIONS = [
   // ── 封面与元信息 ──
   {
@@ -123765,10 +123766,10 @@ var MARKET_REPORT_DIMENSIONS = [
   },
   // ── 呈现规范（原始 prompt HTML 要求）──
   {
-    id: "viz-chartjs",
+    id: "viz-echarts",
     chapter: "\u5448\u73B0",
-    dimension: "Chart.js \u6570\u636E\u53EF\u89C6\u5316",
-    hint: "\u987B\u542B chart.js \u5F15\u7528\u4E0E new Chart \u56FE\u8868"
+    dimension: "ECharts \u6570\u636E\u53EF\u89C6\u5316",
+    hint: `\u987B\u5F15\u7528 ${SILUZAN_ECHARTS_CDN_URL} \u4E14\u81F3\u5C11\u4E00\u5904 echarts.init \u56FE\u8868`
   },
   {
     id: "viz-source",
@@ -123777,6 +123778,14 @@ var MARKET_REPORT_DIMENSIONS = [
     hint: "\u987B\u542B Source: \u6216\u300C\u6765\u6E90\u300D\u811A\u6CE8"
   }
 ];
+function countEchartsInstances(html) {
+  const inits = (html.match(/echarts\.init\(/g) ?? []).length;
+  if (inits > 0) return inits;
+  return (html.match(/\.setOption\(/g) ?? []).length > 0 ? 1 : 0;
+}
+function hasEchartsCdn(html) {
+  return /homeCDN\/echarts\.js|echarts\.min\.js|npm\/echarts@/i.test(html);
+}
 function countPainPoints(html) {
   const labeled = (html.match(/痛点\s*\d/g) ?? []).length;
   if (labeled >= 4) return labeled;
@@ -123854,13 +123863,13 @@ var CONTENT_RULES = [
   { id: "appendix-sources", test: (h) => /数据来源|Source:|报告名称|发布日期|http/.test(h) },
   { id: "appendix-methods", test: (h) => /调研方法|桌面研究|访谈|问卷/.test(h) },
   { id: "appendix-glossary", test: (h) => [/ROI/.test(h), /CAGR/.test(h), /GTM/.test(h), /BPMN/.test(h)].filter(Boolean).length >= 3 },
-  { id: "viz-chartjs", test: (h, ctx) => /chart\.js/i.test(h) && ctx.chartCount >= 1 },
+  { id: "viz-echarts", test: (h, ctx) => hasEchartsCdn(h) && ctx.chartCount >= 1 },
   { id: "viz-source", test: (h) => /Source:|来源：|来源:/.test(h) }
 ];
 function validateMarketReportContent(html) {
   const ctx = {
     tableCount: (html.match(/<table/g) ?? []).length,
-    chartCount: (html.match(/new Chart\(/g) ?? []).length,
+    chartCount: countEchartsInstances(html),
     painPointCount: countPainPoints(html)
   };
   const dimById = new Map(MARKET_REPORT_DIMENSIONS.map((d) => [d.id, d]));
@@ -123966,7 +123975,9 @@ async function runMarketAnalysisRender(opts) {
     `   \u5FC5\u542B\u7EF4\u5EA6\u5DF2\u5168\u90E8\u8986\u76D6\uFF5C${stats.tables} \u8868\uFF5C${stats.charts} \u56FE\uFF5C${stats.painPoints} \u75DB\u70B9\uFF5C\u7ADE\u54C1\u8868 ${stats.competitorTableRows} \u884C
 `
   );
-  console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u5B8C\u6574\u62A5\u544A\uFF08\u9700\u8054\u7F51\u52A0\u8F7D Bootstrap / Chart.js CDN\uFF09\u3002\n");
+  console.log(
+    "\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u5B8C\u6574\u62A5\u544A\uFF08Bootstrap + ECharts\uFF1Astaticpn.siluzan.com/homeCDN/echarts.js\uFF09\u3002\n"
+  );
 }
 
 // src/commands/market-analysis/register.ts
@@ -125111,7 +125122,7 @@ async function runFacebookAnalysisRender(opts) {
     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");
+  console.log("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00 HTML \u6587\u4EF6\u5373\u53EF\u67E5\u770B\u56FE\u8868\u4E0E\u5B8C\u6574\u7AE0\u8282\uFF08ECharts\uFF1Astaticpn.siluzan.com/homeCDN/echarts.js\uFF09\u3002\n");
 }
 
 // src/commands/facebook-analysis/run-batch.ts

package/dist/skill/AGENTS.md

@@ -22,7 +22,7 @@
 | **Google Ads** | `references/google-ads/`       | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP                |
 | **Analytics**  | `references/analytics/`        | 拉数、批处理、拓词、RAG、TSO 报告                              |
 | **Operations** | `references/operations/`       | 预警、线索、优化记录、宿主编排自动化                           |
-| **Templates**  | `assets/`、`report-templates/` | JSON 契约、报告纲要                                            |
+| **Templates**  | `assets/`、`references/report-templates/`、`report-templates/*.html` | JSON 契约、报告纲要、HTML 样式 |
 
 ## 工作流目录
 
@@ -35,11 +35,11 @@
 
 | ID                | 文档                                                                      |
 | ----------------- | ------------------------------------------------------------------------- |
-| 网站诊断          | `report-templates/website-diagnosis-report.md`                            |
-| 战略市场分析      | `report-templates/market-analysis-report.md`                              |
-| Google 周期 Excel | `report-templates/google-period-report-excel.md`（P4，先 outline 后脚本） |
-| OKKI 周报         | `report-templates/okki-weekly-google-client.md`                           |
-| 询盘分析          | `report-templates/google-inquiry-analysis.md`                             |
+| 网站诊断          | `references/report-templates/website-diagnosis-report.md`                 |
+| 战略市场分析      | `references/report-templates/market-analysis-report.md`                   |
+| Google 周期 Excel | `references/report-templates/google-period-report-excel.md`（P4）         |
+| OKKI 周报         | `references/report-templates/okki-weekly-google-client.md`              |
+| 询盘分析          | `references/report-templates/google-inquiry-analysis.md`                  |
 
 ## 维护
 

package/dist/skill/SKILL.md

@@ -93,15 +93,15 @@ siluzan-tso -h   # 查看帮助
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
 | 单账户投放画像 / 诊断 | **P1** | `analytics/account-analytics.md` |
-| Google 账户周期报告 | **P4** | `report-templates/google-period-report.md` + `analytics/account-analytics.md`；要 **Excel** 加 `report-templates/google-period-report-excel.md` |
-| Meta/Facebook 周期或诊断报告 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `analytics/facebook-analysis-guide.md`；要 Excel 加 `meta-period-report-excel.md` |
-| TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `report-templates/*-period-report.md` |
+| Google 账户周期报告 | **P4** | `references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；要 **Excel** 加 `references/report-templates/google-period-report-excel.md` |
+| Meta/Facebook 周期或诊断报告 | **P4-FB** | `references/report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md` |
+| TikTok / Bing 周期报告 | **P4** | `analytics/account-analytics.md`（report tiktok-*/bing-*）+ 对应 `references/report-templates/*-period-report.md` |
 | 多账户 × 多维度批处理 | **P5** | `analytics/google-analysis-batch.md` + `analytics/account-analytics.md` |
-| OKKI 周报 | **P6** | `report-templates/okki-weekly-google-client.md`（全文） |
-| Google 询盘分析 | **P7** | `report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
+| OKKI 周报 | **P6** | `references/report-templates/okki-weekly-google-client.md`（全文） |
+| Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `analytics/geo-continents.json` |
 | 网站诊断 / 落地页评分 | **P8** | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**默认交付 HTML**） |
 | 市场分析 / 行业 / 战略市场报告 | **P9** | `analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**默认交付 HTML**） |
-| Google 广告诊断 / 账户健康检查 | **P1** | `report-templates/google-ads-diagnosis.md` + `report-templates/google-account-diagnosis-report.md` |
+| Google 广告诊断 / 账户健康检查 | **P1** | `references/report-templates/google-ads-diagnosis.md` + `references/report-templates/google-account-diagnosis-report.md` |
 | TSO 平台优化报告：列表/生成/推送 | W7 | `analytics/reporting.md` |
 | RAG 知识库检索 | W5 | `analytics/rag.md` |
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.12",
-  "publishedAt": 1781511893004
+  "version": "1.1.29-beta.13",
+  "publishedAt": 1781604463437
 }

package/dist/skill/assets/market-analysis-rules.md

@@ -36,7 +36,7 @@
 
 | # | 维度 | 必含内容 |
 | - | ---- | -------- |
-| 1.1 | 全球市场规模与增长 | TAM/SAM/SOM 或「市场规模」+ CAGR/增长率；**须有 Chart.js 图** |
+| 1.1 | 全球市场规模与增长 | TAM/SAM/SOM 或「市场规模」+ CAGR/增长率；**须有 ECharts 图** |
 | 1.2 | 赛道与生态定位 | 价值链/产业链表：上游·中游·下游·服务层 |
 | 1.3 | 目标市场国家拆解 | 按国家/区域：规模、增长、优先级、潜力（宜含美/加/墨或用户指定市场） |
 | 1.4 | 技术趋势 PESTEL | 政策/经济/社会/技术/环境/法规 ≥6 维表或等价结构 |
@@ -94,7 +94,7 @@
 
 | 维度 | 要求 |
 | ---- | ---- |
-| Chart.js | 引用 CDN + `new Chart` 图表 |
+| ECharts | 统一引用 `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.js` + `echarts.init` 图表 |
 | 来源脚注 | 图表/关键表配 `Source:` 或「来源」 |
 | 版式 | Bootstrap CDN；商务深蓝；max-width 1200px；每 slide 页码点 |
 

package/dist/skill/references/README.md

@@ -75,9 +75,24 @@
 | `pmax-assets-update-template.json`      | PMax 素材更新                         |
 | `pmax-patch-campaign-template.json`     | PMax 系列 patch                       |
 
-## 报告模板（`../report-templates/`）
-
-见 `report-templates/README.md`。
+## 报告模板纲要（`references/report-templates/`）
+
+> 安装包内与 `report-templates/*.md` 同源；HTML 样式在 `report-templates/*.html`。索引见 `references/report-templates/README.md`。
+
+| 文件 | 适用场景 |
+| ---- | -------- |
+| `google-period-report.md` | Google 账户周期/月度报告（P4） |
+| `google-period-report-excel.md` | P4 用户要 Excel |
+| `meta-period-report.md` / `meta-period-report-excel.md` | Meta 周期（P4-FB） |
+| `google-ads-diagnosis.md` / `google-account-diagnosis-report.md` | Google 诊断（P1） |
+| `website-diagnosis-report.md` | 网站诊断（P8） |
+| `market-analysis-report.md` | 战略市场分析（P9） |
+| `okki-weekly-google-client.md` | OKKI 周报（P6） |
+| `google-inquiry-analysis.md` | 询盘分析（P7） |
+| `tiktok-period-report.md` / `bing-period-report.md` | TikTok / Bing 周期（P4） |
+| `REPORT-WORKFLOW.md` | 通用六步流程 |
+
+样式参考 HTML 见根目录 `report-templates/README.md`。
 
 ## Handoff 模板（`../snippets/`，随 skill 安装）
 

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

@@ -77,7 +77,7 @@ siluzan-tso market-analysis render \
    ```bash
    siluzan-tso market-analysis render --data ./snap-market/market-report.json --out ./snap-market/market-analysis-report.html
    ```
-7. 向用户交付 HTML 路径；说明需联网加载 CDN。
+7. 向用户交付 HTML 路径；说明需联网加载 Bootstrap / ECharts CDN（`homeCDN/echarts.js`）。
 
 **禁止**跳过 `render` 直接把聊天里的 HTML 当终稿；**禁止**编造无来源的具体数据。
 

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

@@ -14,12 +14,23 @@
 | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **新的用户任务 / 同对话内换话题**（新需求、新账户、新媒体、新报告类型；例：刚查余额 → 改问建系列） | 按 `SKILL.md` 路由表 **重新 Read** 该任务的「必读文档」与工作流卡片后再执行 CLI；**禁止**沿用上一任务的参数记忆——对话会被压缩，「读过」≠ 当前上下文仍含正确字段名与 flags |
 | **工作流编号不同**（P1→P3、P4→P5）                                                                 | 即使刚做过 P1，仍须 Read 新卡片及其必读文档                                                                                                                               |
-| **专用 report-templates**（OKKI / 询盘分析）                                                       | Read 对应 `report-templates/*.md` **全文**，勿只凭 SKILL 摘要                                                                                                             |
+| **专用 report-templates**（OKKI / 询盘分析 / 周期报告纲要）                               | Read `references/report-templates/<名>.md` **全文**（与 `report-templates/<名>.md` 同源）；勿只凭 SKILL 摘要 |
 | **上下文被压缩 / 记不清字段或命令**                                                                | 重读 `SKILL.md` 路由表 + 当次任务 references                                                                                                                              |
 | **CLI 返回 400 / 字段对不上**                                                                      | 回到对应 reference 核对参数名与口径，勿猜                                                                                                                                 |
 
 所有 ID、金额、命令 flags 以**当次 Read 的文档 + 当次 CLI 输出**为准；数值只来自本次 stdout 或脚本读盘结果，不引用对话记忆里的示例值。
 
+### Skill 内 Read 路径约定
+
+| 类型 | 正确路径（相对 Skill 根目录） | 说明 |
+| ---- | ----------------------------- | ---- |
+| 命令 reference | `references/<域>/<文件>.md` | 如 `references/analytics/account-analytics.md` |
+| 报告纲要 | `references/report-templates/<文件>.md` | 如 `references/report-templates/google-period-report.md` |
+| JSON 契约 / 规则 | `assets/<文件>.md` | 如 `assets/website-diagnosis-rules.md` |
+| HTML 终稿模板 | `report-templates/*.html` | 由 CLI `render` 使用，Agent 通常只 Read 对应 `.md` 纲要 |
+
+路由表若写 `analytics/…` 或 `report-templates/…` 而无 `references/` 前缀，**Read 时仍须加上 `references/`**（`assets/`、`report-templates/*.html` 除外）。
+
 ---
 
 ## 二、执行流程

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

@@ -22,7 +22,7 @@
 ## P1 · 单账户投放画像
 
 - **触发**：对单个 Google 账户做投放画像/诊断/健康检查。
-- **必读**：`analytics/account-analytics.md`；诊断报告加 `report-templates/google-ads-diagnosis.md` + `report-templates/google-account-diagnosis-report.md`。
+- **必读**：`analytics/account-analytics.md`；诊断报告加 `references/report-templates/google-ads-diagnosis.md` + `references/report-templates/google-account-diagnosis-report.md`。
 - **步骤**：
   1. 确认统计区间（规则见 conventions §五）。
   2. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p1`（取 `currencyCode`）。
@@ -59,7 +59,7 @@
 ## P4 · Google 账户周期报告
 
 - **触发**：Google 账户某区间的周期/月度/季度汇总报告；或用户列出 Sheet/章节要 **Excel**（非 OKKI / 询盘）。
-- **必读**：`report-templates/google-period-report.md` + `analytics/account-analytics.md`；**要 Excel** 加 `report-templates/google-period-report-excel.md`（全文）。
+- **必读**：`references/report-templates/google-period-report.md` + `analytics/account-analytics.md`；**要 Excel** 加 `references/report-templates/google-period-report-excel.md`（全文）。
 - **步骤**：
   1. **账户核验**：`list-accounts -m Google -k <mediaCustomerId> --json-out <dir>`；无记录则停止并告知用户。
   2. 确认时间范围；区间 > 3 个月时分段（季度/月）。
@@ -76,7 +76,7 @@
 ## P4-FB · Meta/Facebook 账户周期报告
 
 - **触发**：Meta/Facebook 账户周期/月报/周报或诊断报告。
-- **必读**：`report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md`（内容丰富度必读）+ `analytics/facebook-analysis-guide.md`；要 Excel 加 `report-templates/meta-period-report-excel.md`。
+- **必读**：`references/report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md`（内容丰富度必读）+ `analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md`。
 - **默认交付**：**HTML**（`facebook-analysis render`）；用户明确要 Excel 时 Agent 脚本写 xlsx（步骤 1–3 不变，不调 `render`）。
 - **步骤**：
   1. `list-accounts -m MetaAd -k <mediaCustomerId> --json-out ./snap-fb` 确认账户与 `currencyCode`。
@@ -85,7 +85,7 @@
   4. **分析**：脚本读落盘 JSON 聚合（见 `facebook-analysis-guide.md`）。
   5. **写 JSON**：按 `meta-period-report-rules.md` 落盘 `meta-period-report.json`（`narrative` 4 条建议各 ≥150 字 + `supplementaryRecommendations` 7 维 + HTML 必填扩展）；无按日/关键词等写「接口未提供」，**禁止编造**。
   6. **交付**：`facebook-analysis render --data ./meta-period-report.json --snapshot-dir ./snap-fb --out ./meta-period-report.html`。
-- **交付/确认**：按 conventions §七 自检。诊断场景改用 `report-templates/meta-account-diagnosis-report.md`，拉数省略 `--sections` 拉全 7 维。
+- **交付/确认**：按 conventions §七 自检。诊断场景改用 `references/report-templates/meta-account-diagnosis-report.md`，拉数省略 `--sections` 拉全 7 维。
 
 ---
 
@@ -113,7 +113,7 @@
 ## P6 · OKKI 周报
 
 - **触发**：话术含 `使用 okki 周报模板` / `OKKI 周报` / `okki 周报`，且指向 Google 账户 + 日期区间。
-- **必读**：`report-templates/okki-weekly-google-client.md`（**全文**）+ `analytics/account-analytics.md`；可选 `core/subagent-orchestration.md`。
+- **必读**：`references/report-templates/okki-weekly-google-client.md`（**全文**）+ `analytics/account-analytics.md`；可选 `core/subagent-orchestration.md`。
 - **步骤**：
   1. （可选）Read `subagent-orchestration.md` § P6 决定是否分阶段委派。
   2. 确认 `mediaCustomerId` 与 `--start` / `--end`。
@@ -126,7 +126,7 @@
 ## P7 · Google 账户询盘分析
 
 - **触发**：话术含 `Google 账户询盘分析` / `分析 XXX Google 账号的询盘效果`，或同时含「询盘 + 账户 + Google」。
-- **必读**：`report-templates/google-inquiry-analysis.md`（**全文**）+ `analytics/account-analytics.md` + `analytics/geo-continents.json`；可选 `core/subagent-orchestration.md`。
+- **必读**：`references/report-templates/google-inquiry-analysis.md`（**全文**）+ `analytics/account-analytics.md` + `analytics/geo-continents.json`；可选 `core/subagent-orchestration.md`。
 - **时间窗口强约束**：**严格 3 个月** = 分析月份 + 向前 2 个完整自然月，**禁止**扩展到 7 个月。
 - **步骤**：
   1. （可选）Read `subagent-orchestration.md` § P7。
@@ -140,7 +140,7 @@
 ## P8 · 网站诊断
 
 - **触发**：对某 URL 做网站/落地页诊断、投放前网站评分，或话术含「网站诊断」「落地页质量」（**非** Google 账户 `AdvertisingDiagnosis`）。
-- **必读**：`analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `report-templates/website-diagnosis-report.md`。
+- **必读**：`analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `references/report-templates/website-diagnosis-report.md`。
 - **默认交付**：**HTML**（`website-diagnosis render`）；**禁止**仅 Markdown 摘要或纯 JSON 充当终稿。
 - **步骤**：
   1. 确认完整 URL（`https://` 可省略，CLI 自动补全）。
@@ -154,7 +154,7 @@
 ## P9 · 战略市场分析
 
 - **触发**：话术含「市场分析」「行业分析」「战略市场报告」「KA 市场报告」，或对某客户/行业做竞品/GTM 战略分析（**非** `google-analysis`、**非** 网站诊断）。
-- **必读**：`analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `report-templates/market-analysis-report.md`。
+- **必读**：`analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（原始业务维度清单）+ `references/report-templates/market-analysis-report.md`。
 - **默认交付**：**HTML**（`market-analysis render`）。
 - **步骤**：
   1. 确认客户信息（客户名称/网站/行业/核心产品至少一项）；`targetMarket` 默认「全球」、`timeRange` 默认「近12个月」（未给须写明）。

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

@@ -0,0 +1,45 @@
+# 报告模板纲要（report-templates）
+
+> **Agent Read 路径（推荐）**：`references/report-templates/<文件名>.md`  
+> **同源副本**：`report-templates/<文件名>.md`（Skill 根目录，与 HTML 样式模板同目录）  
+> **HTML 样式参考**（仅排版，不定义章节）：`report-templates/report-template*.html`、`report-templates/*-report.html`
+
+安装包构建时会将根目录 `report-templates/*.md` **同步到本目录**，避免 Agent 按 `references/` 前缀查找时 404。
+
+---
+
+## 周期 / 账户报告
+
+| 文件 | 工作流 | 说明 |
+| ---- | ------ | ---- |
+| `google-period-report.md` | **P4** | Google 账户周期报告（默认 HTML 纲要） |
+| `google-period-report-excel.md` | **P4** | 用户要 Excel 时全文必读 |
+| `meta-period-report.md` | **P4-FB** | Meta/Facebook 周期报告（默认 HTML） |
+| `meta-period-report-excel.md` | **P4-FB** | Meta Excel 五 Sheet |
+| `meta-account-diagnosis-report.md` | **P4-FB** | Meta 深度诊断 |
+| `tiktok-period-report.md` | **P4** | TikTok 周期报告 |
+| `bing-period-report.md` | **P4** | Bing 周期报告 |
+
+## 诊断 / 专项
+
+| 文件 | 工作流 | 说明 |
+| ---- | ------ | ---- |
+| `google-ads-diagnosis.md` | **P1** | Google 广告诊断完整纲要 |
+| `google-account-diagnosis-report.md` | **P1** | Google 账户深度诊断 |
+| `website-diagnosis-report.md` | **P8** | 网站诊断（配合 `website-diagnosis render`） |
+| `market-analysis-report.md` | **P9** | 战略市场分析交付检查清单 |
+
+## 客户交付 / Excel
+
+| 文件 | 工作流 | 说明 |
+| ---- | ------ | ---- |
+| `okki-weekly-google-client.md` | **P6** | OKKI 周报（全文必读） |
+| `google-inquiry-analysis.md` | **P7** | Google 询盘分析（全文必读） |
+
+## 通用
+
+| 文件 | 说明 |
+| ---- | ---- |
+| `REPORT-WORKFLOW.md` | 六步报告流程总览 |
+
+章节细则另见 `references/core/playbooks.md`（P1–P9）与 `references/analytics/account-analytics.md`。

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

@@ -0,0 +1,114 @@
+# 报告生成流程
+
+---
+
+## 分析报告生成步骤
+
+适用于：`google-analysis *`、`facebook-analysis *`、`report tiktok-*`、`report bing-*`、`report meta-overview` 等 CLI 拉数后由 Agent 撰写的报告。
+
+**不适用**于 TSO 优化报告（`report create` / `report push` 等），那类报告由平台生成，不走此流程。
+
+---
+
+### 步骤 1：确认账户与区间
+
+- 账户 ID 须来自 `siluzan-tso list-accounts -m <媒体>` 的实际输出，不能凭印象猜测。
+- 明确起止日期（`--start` / `--end`）。
+
+---
+
+### 步骤 2：选定内容模板
+
+根据媒体与用户意图，选择 `report-templates/` 下对应的 `*.md`：
+
+| 意图                                                                                  | Google                                                                                             | Meta                               | TikTok                    | Bing                    |
+| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------------------- | ----------------------- |
+| 周期分析 / 月报 / 周报                                                                | `google-period-report.md`                                                                          | `meta-period-report.md`            | `tiktok-period-report.md` | `bing-period-report.md` |
+| OKKI 周报 / 固定话术发客户（Google）                                                  | `okki-weekly-google-client.md`                                                                     | —                                  | —                         | —                       |
+| **询盘分析** / 固定运营触发（Goog账户询盘分析 / 我给你询盘信息分析Google账号XXX效果） | `google-inquiry-analysis.md`（**严格 3 个月** + 用户上传询盘资料 + 8 Sheet xlsx；见 SKILL **P7**） | —                                  | —                         | —                       |
+| 深度诊断 / 健康检查                                                                   | `google-account-diagnosis-report.md`                                                               | `meta-account-diagnosis-report.md` | 同周期，注明能力受限      | 同周期                  |
+
+无精确匹配时，用最接近媒体的同类 `*.md`，并在报告开头注明。
+
+---
+
+### 步骤 3：展示默认维度 + 询问追加
+
+**例外**：模板为 `okki-weekly-google-client.md` 或 `google-inquiry-analysis.md` 时**跳过**本节「追问可选追加」，按该文件固定维度拉数即可。`google-inquiry-analysis.md` 还要求**严格 3 个月**时间窗（分析月份 + 向前 2 个完整自然月），不可扩展。
+
+1. 按选定 `*.md` 的**默认维度**开始拉数（**不必等用户回复后再拉**，可并行）。
+2. 同时向用户发一条消息，说明本次默认包含哪些维度，并列出当前平台支持的**可选追加维度**，询问是否需要添加。
+3. 报告正文按默认维度写；若用户追加了维度，数据回来后在末尾补充对应章节。
+
+---
+
+### 步骤 3b：Google Excel 门禁（用户要 xlsx 时必做）
+
+在步骤 4 拉数完成、步骤 5 写脚本**之前**：
+
+1. `list-accounts -m Google -k <用户 ID> --json-out` 核验账户（**禁止**全表 grep 换 ID）。
+2. Read 本次每个 section 的 **`*.outline.txt`**（见 `google-period-report-excel.md` §执行门禁）。
+3. **禁止** `cat|json.tool|head` 或 Read 业务 `*.json` 探字段；**禁止**加载宿主第三方 xlsx Skill。
+
+### 步骤 4：拉取数据
+
+- **`google-analysis` / `report …` 账户分析子命令**：统一 **`--json-out <目录>`** 落盘，再由脚本读 **`manifest-<accountId>.json` / `report-manifest-<accountId>.json`**（清单文件名见 stdout 摘要的 `manifestFile`）与各 **`<section>-<accountId>.json`**（见 `references/analytics/account-analytics.md`）。
+- **`stats`、`ad campaigns` 等辅助命令**：按 `references/core/tips.md` 与各命令文档做结构化拉数。
+- 仅执行与**本次报告维度**对应的命令（默认 + 用户追加）。
+- 数据失败/缺失：在对应章节写 `[ 数据不可用：{原因} ]`，不写推测。
+
+---
+
+### 步骤 4b：交付前审阅最终产物（**必做**）
+
+- 按 `references/core/agent-conventions.md` §七 自检表 A/B/C 审阅。
+- **Read 刚生成的报告文件**（HTML/Markdown 等），对照当次 `report-templates/*.md` 逐项确认章节与币种。
+- 未通过：**修改产物或补拉数据后重新生成**，再次 Read 审阅；不得在未审阅时交付。
+
+---
+
+### 步骤 5：分析并撰写中间产物
+
+- 用 **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`） | **周期/定制 Sheet**：`google-period-report-excel.md`（P4，先 outline 后脚本）；**OKKI**：P6；**询盘**：P7 |
+| **网站诊断**      | `website-diagnosis render` → HTML                                 | —                                                                                                         |
+
+**禁止**：Meta 周期报告默认只交 Markdown/JSON；禁止 Agent 手写 Meta HTML。
+
+**Google 广告诊断报告**（`google-ads-diagnosis.md` / `google-account-diagnosis-report.md`）额外必遵：
+
+1. **每日趋势**（`daily-metrics` / `conversionCost`）：金额、CPA **2 位小数**；转化/点击/展示为整数；图表轴与 tooltip 同规则。
+2. **每个模块**在表/图后写 **分析**（≥2 条，有数据依据）+ **建议**（≥1 条）；禁止只贴表不写分析。详见 `google-ads-diagnosis.md` § 撰写硬约束。
+
+---
+
+### 步骤 6：末尾附数据来源（可选）
+
+```
+📌 数据来源：
+- siluzan-tso google-analysis -a <id> --sections overview --start <s> --end <e>
+- ...
+```
+
+---
+
+## 未知报告名处理
+
+| 用户措辞                                                                                                                                              | 映射                                                                                                                                                                                                 |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 月报、周报、投放总结、效果回顾                                                                                                                        | 周期分析 → 对应媒体 `*-period-report.md`                                                                                                                                                             |
+| **使用 okki 周报模板 / OKKI 周报 / okki 周报**（Google + 区间）                                                                                       | **固定话术 + 精简表 +（按需）Excel** → `okki-weekly-google-client.md`（见 SKILL **P6**）；Excel **仅**由 Agent 脚本生成，**无** CLI 内置写表子命令                                                   |
+| **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/references/report-templates/bing-period-report.md

@@ -0,0 +1,65 @@
+# Bing（Microsoft Advertising / BingV2）— 账户分析报告（模板纲要）
+
+> 统计区间：`{startDate}` ~ `{endDate}`（**不可包含今天或昨天**，见下文）  
+> 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
+
+数据块：总览、设备、地域、受众（年龄/性别）、系列、广告组、广告、关键词、搜索字词。
+
+---
+
+## 日期规则（必读）
+
+- Bing 接口**无法**拉取过新的数据；时间范围内**任意一天**若为**今天**或**昨天**，请求会失败。
+- **CLI**：`--start` / `--end` 须**同传或同省略**；省略时默认**截至前天**的近 7 天（与 `report bing-*` 实现一致）。
+- 自选区间时请确保结束日 ≤ **前天**。
+
+---
+
+## 1. 执行摘要（总览）
+
+- **CLI**：`siluzan-tso report bing-overview -a <mediaCustomerId> [--start … --end …] --json-out <dir>`
+
+## 2. 设备与地域
+
+- 设备：`report bing-device` → `DeviceSectionData`
+- 地域：`report bing-geographic` → `GeographicSectionData`（响应中常见 `countries` 等字段，**以实际 JSON 为准**）
+
+## 3. 受众
+
+- 年龄：`report bing-age-audience` → `AgeAudienceData`
+- 性别：`report bing-gender-audience` → `GenderAudienceData`
+- 合并输出：`report bing-audience-merged`（**固定输出合并 JSON**，含年龄+性别）
+
+## 4. 广告结构
+
+- 系列：`report bing-campaigns` → `CampaignReport`
+- 广告组：`report bing-ad-groups` → `AdGroupReport`
+- 广告：`report bing-ads` → `AdReport`
+
+## 5. 关键词与搜索字词
+
+- 关键词：`report bing-keywords` → `KeywordReport`，Query 含 `limit`（默认 **100**）、`orderByCost=true`
+- 搜索字词：`report bing-search-terms` → `SearchQueryReport`，参数同上
+
+## 6. 附录
+
+- 鉴权：与 TSO 其他接口相同（`config show` 中 `tsoApiBaseUrl` / Token）。
+- 与 steward「优化报告」区别：见 `meta-period-report.md` 末节；此处为**实时分析 JSON**。
+
+---
+
+### CLI 速查表
+
+| 数据块   | 子命令                        |
+| -------- | ----------------------------- |
+| 总览     | `report bing-overview`        |
+| 设备     | `report bing-device`          |
+| 地域     | `report bing-geographic`      |
+| 年龄受众 | `report bing-age-audience`    |
+| 性别受众 | `report bing-gender-audience` |
+| 受众合并 | `report bing-audience-merged` |
+| 系列     | `report bing-campaigns`       |
+| 广告组   | `report bing-ad-groups`       |
+| 广告     | `report bing-ads`             |
+| 关键词   | `report bing-keywords`        |
+| 搜索字词 | `report bing-search-terms`    |