siluzan-tso-cli 1.1.26-beta.3 → 1.1.27-beta.1

package/README.md

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

package/dist/index.js

@@ -121637,15 +121637,34 @@ async function runWebsiteDiagnosisCollect(opts) {
 }
 
 // src/commands/website-diagnosis/render-report.ts
-import fs12 from "fs/promises";
+import fs12 from "fs";
+import fsPromises from "fs/promises";
 import path17 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
-function websiteDiagnosisReportTemplatePath() {
+var TEMPLATE_BASENAMES = {
+  html: "website-diagnosis-report.html",
+  runtime: "website-diagnosis-report.runtime.js"
+};
+function resolveSkillTemplatePath(basename11) {
   const dir = path17.dirname(fileURLToPath4(import.meta.url));
-  return path17.join(dir, "skill", "siluzan-ads", "report-templates", "website-diagnosis-report.html");
+  const candidates = [
+    path17.join(dir, "skill", "report-templates", basename11),
+    path17.join(dir, "skill", "siluzan-ads", "report-templates", basename11),
+    path17.join(dir, "..", "..", "assets", "siluzan-ads", "report-templates", basename11)
+  ];
+  for (const p of candidates) {
+    if (fs12.existsSync(p)) return p;
+  }
+  return candidates[0];
+}
+function websiteDiagnosisReportTemplatePath() {
+  return resolveSkillTemplatePath(TEMPLATE_BASENAMES.html);
+}
+function websiteDiagnosisRuntimePath() {
+  return resolveSkillTemplatePath(TEMPLATE_BASENAMES.runtime);
 }
 function readJsonFile(filePath) {
-  const raw = fs12.readFile(filePath, "utf8");
+  const raw = fsPromises.readFile(filePath, "utf8");
   return raw.then((text) => {
     try {
       return JSON.parse(text);
@@ -121688,7 +121707,7 @@ async function runWebsiteDiagnosisRender(opts) {
   const templatePath = websiteDiagnosisReportTemplatePath();
   let html;
   try {
-    html = await fs12.readFile(templatePath, "utf8");
+    html = await fsPromises.readFile(templatePath, "utf8");
   } catch {
     console.error(`
 \u274C \u672A\u627E\u5230\u62A5\u544A\u6A21\u677F\uFF1A${templatePath}
@@ -121699,12 +121718,26 @@ async function runWebsiteDiagnosisRender(opts) {
   const outPath = path17.resolve(
     opts.out ?? path17.join(path17.dirname(dataPath), "website-diagnosis-report.html")
   );
-  await fs12.mkdir(path17.dirname(outPath), { recursive: true });
-  await fs12.writeFile(outPath, injectReportData(html, data), "utf8");
+  const outDir = path17.dirname(outPath);
+  await fsPromises.mkdir(outDir, { recursive: true });
+  await fsPromises.writeFile(outPath, injectReportData(html, data), "utf8");
+  const runtimeSrc = websiteDiagnosisRuntimePath();
+  const runtimeOut = path17.join(outDir, TEMPLATE_BASENAMES.runtime);
+  try {
+    await fsPromises.copyFile(runtimeSrc, runtimeOut);
+  } 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("\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u8BE5\u6587\u4EF6\u5373\u53EF\u67E5\u770B\u56FE\u8868\u4E0E\u5B8C\u6574\u7AE0\u8282\u3002\n");
+  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 ECharts CDN\uFF09\u3002\n");
 }
 
 // src/commands/website-diagnosis/register.ts

package/dist/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: siluzan-tso
-description: Operates Siluzan TSO ad accounts via siluzan-tso-cli Google/Bing/Yandex/TikTok/Kwai/Meta account management, Google Ads CRUD and PMax, analytics, optimization reports, forewarning, leads, invoicing, and RAG knowledge lookup. Use when the user mentions ad accounts, balance, spend, campaigns, keywords, open account, MCC/BC binding, or TSO reporting. On each new user task or topic switch, re-read routed references per references/core/agent-conventions.md — do not reuse prior task memory.
+description: Operates Siluzan TSO ad accounts via siluzan-tso-cli (Google/Bing/Yandex/TikTok/Kwai/MetaAd). Tasks: (accounts) list, balance, stats, spend, active-bills, history, balance-scan P2, accounts-digest P3, share/unshare, delink, OAuth, MCC/BC/BM bind-unbind, email invite, TikTok close, suspend withdraw; (open-account) apply on 6 media; (Google Ads) campaign/adgroup/ad/keyword CRUD, extensions, geo, PMax, search campaign-plan validate/create, batch async create; (analytics) google-analysis, google-analysis-batch P5, facebook-analysis P4-FB, website-diagnosis P8, ads diagnosis; (reports) P1 profile, P4 period, P6 OKKI weekly, P7 inquiry; (tools) keyword suggest, RAG query, TSO report list/create/push, AI optimize records, forewarning rules, TikTok/Meta leads, transfer/invoice/invoice-info, audit restore. Use when user mentions ad accounts, balance, spend, campaigns, keywords, open account, MCC/BC, reports, diagnosis, invoicing, or TSO. Re-read references/core/agent-conventions.md each new task.
 license: MIT
 compatibility: Requires Node.js 18+, siluzan-tso-cli installed, authenticated via send-login-code + login or config set
 metadata:
@@ -87,7 +87,7 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | 账户列表 / 余额 / 消耗 / 分享 / MCC / 多账户汇总 | `accounts/accounts.md`；金额加 `accounts/currency.md` |
 | 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md` + **`core/deliverable-preflight.md`**；多账户加 `analytics/google-analysis-batch.md` |
 | Meta/Facebook 周期或诊断报告 / `facebook-analysis` | `analytics/facebook-analysis-guide.md` + `report-templates/meta-period-report.md`（或 `meta-account-diagnosis-report.md`）+ `core/playbooks.md` P4-FB |
-| 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `report-templates/website-diagnosis-report.md`（**终稿 HTML**）+ `core/playbooks.md` P8 |
+| 网站诊断 / 落地页评分 / `website-diagnosis` | `analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md` + `core/playbooks.md` P8；Agent 只写 JSON，`website-diagnosis render` 出 HTML |
 | Google 新建搜索系列 | `google-ads/google-ads-campaign-plan.md` |
 | Google 广告 CRUD / 拒审 | `google-ads/google-ads.md` |
 | PMax | `assets/pmax-create-template.md` + `google-ads/pmax-api.md` |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.26-beta.3",
-  "publishedAt": 1780540125141
+  "version": "1.1.27-beta.1",
+  "publishedAt": 1780630877715
 }

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 场景用 `website-diagnosis render` 或按 `report-templates/website-diagnosis-report.html` 注入 JSON。
+> **最终交付**：与线上一致，为**一份可浏览器打开、含 ECharts 图表的单文件 HTML 报告**（雷达图、模块得分条形图、Lighthouse 对比图等）。TSO 网页由 Vue `WebsiteAnalysisReport/v3` 渲染；Skill/CLI 场景 **Agent 只写诊断 JSON，HTML 一律由 `website-diagnosis render` 生成**（禁止 Agent 手写 HTML）。
 
 ---
 
@@ -55,11 +55,11 @@ siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-we
 2. `website-diagnosis collect --url <url> --json-out ./snap-web`（**必须** `--json-out`）。
 3. Read `assets/website-diagnosis-rules.md`（评分规则与 JSON Schema）。
 4. 用脚本读 `writtenFiles[0]` 的 `lighthouse`、`htmlPreview`（或 `--include-html` 时的 `htmlContent`）生成结构化 `data`（见下节输出契约）。
-5. 生成诊断 JSON 后执行：
+5. 将诊断 JSON 落盘为 `diagnosis.json`（脚本写文件，勿在对话里贴全文），再执行：
    ```bash
    siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json --out ./snap-web/website-diagnosis-report.html
    ```
-   或按 `report-templates/website-diagnosis-report.html` 将 JSON 写入 `window.__WEBSITE_DIAGNOSIS__`。**禁止**只给 Markdown/纯 JSON 充当终稿。
+   **禁止** Agent 手写/拼接 HTML；**禁止**只给 Markdown 或纯 JSON 充当终稿。
 6. **禁止编造**未在采集 HTML/Lighthouse 中出现的指标。Lighthouse 缺失时须在 HTML 中醒目说明。
 
 **在 TSO Copilot 网页内**：工具返回 `rendered: true` 时，前端已渲染卡片 +「查看详情」全页 HTML，Agent 只需简短确认，**勿重复贴报告正文**（见 tso_agent `prompt.py`）。

package/dist/skill/references/core/cli-enums.md

@@ -0,0 +1,140 @@
+<!-- 本文件由 `pnpm --filter siluzan-tso-cli run gen:cli-enums` 自动生成，勿手改。源码：src/cli-enums/registry.ts -->
+
+# CLI 枚举速查
+
+> **Agent**：不确定 `--sections`、`-m`、`--operator` 等合法值时，**Read 本文件**（按章节）或执行：
+> `siluzan-tso reference enums`（Markdown） / `siluzan-tso reference enums --json`（机器可读）。
+> 各功能 reference 只保留业务说明；枚举与 CLI 校验**以此文件为准**（与源码同源）。
+
+### 媒体类型 `-m` / `--media`（多数命令）
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| list-accounts, stats, balance, account-history, open-account, transfer, … | -m, --media | Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai |
+
+
+> 区分大小写；Meta 广告账户用 MetaAd，不是 Facebook。
+
+### 媒体类型（仅 forewarning）
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| forewarning list, create, records, … | -m, --media | Google \| TikTok |
+
+
+### `google-analysis --sections` 维度（25）
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| google-analysis, google-analysis-batch run | --sections | overview \| keywords \| search-terms \| campaigns \| campaign-hour \| ads \| extensions \| devices \| geographic \| geo-matched \| campaign-geo \| campaign-geo-matched \| campaign-device \| audience \| asset-images \| videos \| materials \| resource-counts \| conversion-actions \| daily-metrics \| gold-account \| ads-index \| final-urls \| dimension-summary \| campaign-types |
+
+
+> 逗号分隔；省略=全部。`final-urls`、`campaign-types` 不传日期。
+
+### `google-analysis --level`（extensions 维度）
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| google-analysis --sections extensions | --level | Account \| Campaign \| Ad Group |
+
+
+### `google-analysis --audience-type`（audience 维度）
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| google-analysis --sections audience | --audience-type | SystemDefined \| UserDefined |
+
+
+### `facebook-analysis --sections` 维度（7）
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| facebook-analysis | --sections | overview \| ad-sets \| platform \| country \| audience \| creative \| material |
+
+
+> 默认周期报告：overview,ad-sets,platform,country,audience,creative。
+
+### `facebook-analysis --sections` Google 别名
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| facebook-analysis | --sections（别名） | — |
+
+
+> 解析后映射到左侧 canonical 名。
+
+**别名**：`campaigns` → `ad-sets`；`ad-groups` → `ad-sets`；`geographic` → `country`；`geo` → `country`；`devices` → `platform`；`network` → `platform`；`networks` → `platform`；`ads` → `creative`；`materials` → `material`；`asset-images` → `material`；`videos` → `material`
+
+### `ad extension * --level`
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| ad extension sitelink, callout, snippet, … | --level | Account \| Campaign \| AdGroup |
+
+
+### 搜索系列 `BiddingStrategyTypeV2`
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| ad campaign-create, campaign-validate（config JSON） | campaign.BiddingStrategyTypeV2 | TARGET_SPEND \| MANUAL_CPC \| TARGET_CPA \| TARGET_ROAS \| MAXIMIZE_CONVERSIONS \| MAXIMIZE_CONVERSION_VALUE |
+
+
+### 系列 `ChannelTypeV2`
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| ad campaign-create, campaign-validate | campaign.ChannelTypeV2 | SEARCH \| DISPLAY \| VIDEO \| SHOPPING \| MULTI_CHANNEL |
+
+
+### 系列 `StatusV2`
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| ad campaign-create, campaign-validate | campaign.StatusV2 | Enabled \| Paused |
+
+
+### 预算投放 `BudgetBudgetDeliveryMethodV2`
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| ad campaign-create, campaign-validate | campaign.BudgetBudgetDeliveryMethodV2 | STANDARD \| ACCELERATED \| UNSPECIFIED \| UNKNOWN |
+
+
+### PMax `BiddingStrategyTypeV2`
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| ad pmax-create, pmax-validate | campaign.BiddingStrategyTypeV2 | MAXIMIZE_CONVERSIONS \| MAXIMIZE_CONVERSION_VALUE \| TARGET_CPA \| TARGET_ROAS |
+
+
+### 预警比较运算符
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| forewarning create | --operator | GREATER_EQUALS \| GREATER \| LESS_EQUALS \| LESS \| EQUALS |
+
+
+### 开户历史状态筛选
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| account-history | --status（mediaAccountState） | Created \| Approved \| Denied \| Inactive |
+
+
+> Google 默认含 Inactive；其他媒体默认 Created,Approved,Denied。
+
+### 线索表单媒体
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| clue | -m, --media | TikTok \| Meta |
+
+
+### 网站诊断模块 status
+
+| 命令 | 选项 | 合法值 |
+| ---- | ---- | ------ |
+| website-diagnosis collect（响应字段） | modules[].status | Excellent \| Good \| Normal \| Poor \| Full \| NeedImprove \| Absent |
+
+
+> 撰写报告时转中文展示；细则见 assets/website-diagnosis-rules.md。

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

@@ -184,7 +184,11 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
    ```
 
 3. Read `assets/website-diagnosis-rules.md`；按 outline → JSON 读 `lighthouse` / `htmlPreview`。
-4. 生成与 tso_agent `getWebsiteDiagnosisData` 同结构的 `data`（6 模块、29 子项、`ratingId`、`coreIssuesIds`）。
-5. 执行 `website-diagnosis render --data <diagnosis.json> --collect <collect.json>` 生成 **带图表的** `website-diagnosis-report.html`（模板见 `report-templates/website-diagnosis-report.html`）；勿只交付 Markdown。
+4. 用脚本将诊断结果落盘为 `diagnosis.json`（与 tso_agent `getWebsiteDiagnosisData` 同结构：6 模块、29 子项、`ratingId`、`coreIssuesIds`；可含 `lighthouseResult`、`analyzedAt`）。
+5. **只调 CLI 出 HTML**（禁止 Agent 手写 HTML）：
+   ```bash
+   siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json --out ./snap-web/website-diagnosis-report.html
+   ```
+   向用户交付该 HTML 路径；勿只交付 Markdown 或 JSON。
 6. Lighthouse 缺失时在 HTML 中说明；Copilot 网页场景若已 `rendered: true` 则勿重复输出报告正文。
 7. 若用户仅需历史 ARIT 分：`list-accounts` 或 `website-diagnosis search --ids <websiteDiagnoseId>`。