siluzan-tso-cli 1.0.0-beta.29 → 1.0.0-beta.30

package/README.md

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

package/dist/index.js

@@ -1239,7 +1239,7 @@ var ASCII_TABLE_CHARS = {
 };
 function printCliTable(rows, columns, options) {
   if (rows.length === 0) return;
-  const plain = !!options?.plain;
+  const plain = options?.plain !== false;
   const indent = options?.indent ?? "  ";
   const printLine = options?.printLine ?? ((msg) => {
     console.log(msg);
@@ -1628,19 +1628,19 @@ async function runListAccounts(opts) {
   const isMetaAd = opts.media === "MetaAd";
   const isBingV2 = opts.media === "BingV2";
   const isKwai = opts.media === "Kwai";
-  const plain = !!opts.plain;
+  const tableBorderOpts = opts.unicode ? { plain: false } : void 0;
   if (isGoogle) {
-    printGoogleTable(items, plain);
+    printGoogleTable(items, tableBorderOpts);
   } else if (isYandex) {
-    printYandexTable(items, plain);
+    printYandexTable(items, tableBorderOpts);
   } else if (isTikTok) {
-    printTikTokTable(items, plain);
+    printTikTokTable(items, tableBorderOpts);
   } else if (isMetaAd) {
-    printMetaTable(items, plain);
+    printMetaTable(items, tableBorderOpts);
   } else if (isBingV2 || isKwai) {
-    printSpendMetricsAccountTable(items, plain);
+    printSpendMetricsAccountTable(items, tableBorderOpts);
   } else {
-    printDefaultTable(items, opts.media, plain);
+    printDefaultTable(items, opts.media, tableBorderOpts);
   }
   const hasMore = total !== void 0 ? page * pageSize < total : items.length >= pageSize;
   if (hasMore) {
@@ -1806,7 +1806,7 @@ function formatMetaAuditStatus(ma) {
   };
   return strMap[u] ?? String(raw);
 }
-function printMetaTable(items, plain) {
+function printMetaTable(items, tableOpts) {
   const rows = items.map((item) => {
     const ma = item.ma;
     return {
@@ -1819,9 +1819,9 @@ function printMetaTable(items, plain) {
       createdAt: fmtDate(ma.createdDateTime)
     };
   });
-  printCliTable(rows, COL_META, { plain });
+  printCliTable(rows, COL_META, tableOpts);
 }
-function printSpendMetricsAccountTable(items, plain) {
+function printSpendMetricsAccountTable(items, tableOpts) {
   const rows = items.map((item) => {
     const ma = item.ma;
     const authStatus = ma.invalidOAuthToken ? "\u26A0\uFE0F \u5931\u6548" : "\u2705 \u6B63\u5E38";
@@ -1842,9 +1842,9 @@ function printSpendMetricsAccountTable(items, plain) {
       shared: sharedCount
     };
   });
-  printCliTable(rows, COL_SPEND_METRICS, { plain });
+  printCliTable(rows, COL_SPEND_METRICS, tableOpts);
 }
-function printYandexTable(items, plain) {
+function printYandexTable(items, tableOpts) {
   const rows = items.map((item) => {
     const ma = item.ma;
     const authStatus = ma.invalidOAuthToken ? "\u26A0\uFE0F \u5931\u6548" : "\u2705 \u6B63\u5E38";
@@ -1866,9 +1866,9 @@ function printYandexTable(items, plain) {
       shared: sharedCount
     };
   });
-  printCliTable(rows, COL_YANDEX, { plain });
+  printCliTable(rows, COL_YANDEX, tableOpts);
 }
-function printTikTokTable(items, plain) {
+function printTikTokTable(items, tableOpts) {
   const rows = items.map((item) => {
     const ma = item.ma;
     const authStatus = ma.invalidOAuthToken ? "\u26A0\uFE0F \u5931\u6548" : "\u2705 \u6B63\u5E38";
@@ -1891,9 +1891,9 @@ function printTikTokTable(items, plain) {
       shared: sharedCount
     };
   });
-  printCliTable(rows, COL_TIKTOK, { plain });
+  printCliTable(rows, COL_TIKTOK, tableOpts);
 }
-function printGoogleTable(items, plain) {
+function printGoogleTable(items, tableOpts) {
   const rows = items.map((item) => {
     const ma = item.ma;
     const authStatus = ma.invalidOAuthToken ? "\u26A0\uFE0F \u5931\u6548" : "\u2705 \u6B63\u5E38";
@@ -1917,7 +1917,7 @@ function printGoogleTable(items, plain) {
       shared: sharedCount
     };
   });
-  printCliTable(rows, COL_GOOGLE, { plain });
+  printCliTable(rows, COL_GOOGLE, tableOpts);
 }
 var COL_DEFAULT_WITH_MEDIA = [
   { key: "mediaType", header: "\u5A92\u4F53\u7C7B\u578B" },
@@ -1928,7 +1928,7 @@ var COL_DEFAULT_WITH_MEDIA = [
   { key: "status", header: "\u8D26\u6237\u72B6\u6001" }
 ];
 var COL_DEFAULT_SINGLE = COL_DEFAULT_WITH_MEDIA.filter((c) => c.key !== "mediaType");
-function printDefaultTable(items, media, plain) {
+function printDefaultTable(items, media, tableOpts) {
   const rows = items.map((item) => {
     const ma = item.ma;
     let statusLabel;
@@ -1952,7 +1952,7 @@ function printDefaultTable(items, media, plain) {
     };
   });
   const columns = media ? COL_DEFAULT_SINGLE : COL_DEFAULT_WITH_MEDIA;
-  printCliTable(rows, columns, { plain });
+  printCliTable(rows, columns, tableOpts);
 }
 
 // src/commands/balance.ts
@@ -9358,8 +9358,12 @@ program.command("list-accounts").description("\u67E5\u8BE2\u5E7F\u544A\u8D26\u62
   "\u8D26\u6237\u72B6\u6001\uFF1Anormal\uFF08\u6B63\u5E38\uFF09| invalid\uFF08\u5931\u6548\uFF09| all\uFF08\u5168\u90E8\uFF0C\u9ED8\u8BA4\uFF09",
   "all"
 ).option("-p, --page <n>", "\u9875\u7801\uFF08\u9ED8\u8BA4 1\uFF09", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF\uFF08\u9ED8\u8BA4 20\uFF09", parseInt).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u539F\u59CB\u54CD\u5E94", false).option(
+  "--unicode",
+  "\u4F7F\u7528 Unicode \u7EBF\u6846\u8868\u683C\uFF08cli-table3\uFF09\uFF1B\u9ED8\u8BA4 ASCII +-|",
+  false
+).option(
   "--plain",
-  "\u4F7F\u7528 ASCII \u7EBF\u6846\u8868\u683C\uFF08cli-table3\uFF09\uFF1B\u9ED8\u8BA4\u4F7F\u7528 Unicode \u7EBF\u6846\u8868\u683C",
+  "\u5DF2\u9ED8\u8BA4 ASCII \u7EBF\u6846\uFF0C\u65E0\u9700\u518D\u4F20\uFF1B\u4FDD\u7559\u517C\u5BB9\u65E7\u811A\u672C",
   false
 ).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
   await runListAccounts({
@@ -9370,7 +9374,7 @@ program.command("list-accounts").description("\u67E5\u8BE2\u5E7F\u544A\u8D26\u62
     page: opts.page,
     pageSize: opts.pageSize,
     json: opts.json,
-    plain: opts.plain,
+    unicode: opts.unicode,
     verbose: opts.verbose
   });
 });
@@ -10649,10 +10653,7 @@ openAccountCmd.command("kwai").description("\u63D0\u4EA4 Kwai \u5F00\u6237\u7533
 });
 program.command("diagnostic").description("Google \u5E7F\u544A\u8BCA\u65AD\uFF1A\u8F93\u51FA\u4E1D\u8DEF\u8D5E\u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\u9875\u9762\u5730\u5740").action(() => {
   console.log("\nGoogle \u5E7F\u544A\u8BCA\u65AD\n");
-  console.log("  \u4E1D\u8DEF\u8D5E\u63D0\u4F9B\u4E13\u4E1A\u7684 Google \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF0C\u5E2E\u52A9\u5206\u6790\u8D26\u6237\u5065\u5EB7\u5EA6\u5E76\u751F\u6210\u4F18\u5316\u5EFA\u8BAE\u3002\n");
-  console.log("  \u8BCA\u65AD\u5165\u53E3\uFF08\u751F\u4EA7\uFF09\uFF1Ahttps://www.siluzan.com/diagnostics/");
-  console.log("  \u8BCA\u65AD\u5165\u53E3\uFF08\u6D4B\u8BD5\uFF09\uFF1Ahttps://www-ci.siluzan.com/diagnostics/\n");
-  console.log("  \u8BF7\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u4E0A\u8FF0\u5730\u5740\u5B8C\u6210\u8BCA\u65AD\u64CD\u4F5C\u3002\n");
+  console.log("  siluzan.com \u63D0\u4F9B\u4E13\u4E1A\u7684 Google \u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\uFF0C\u5E2E\u52A9\u5206\u6790\u8D26\u6237\u5065\u5EB7\u5EA6\u5E76\u751F\u6210\u4F18\u5316\u5EFA\u8BAE\u3002\n");
 });
 var activeCmd = process.argv[2];
 program.parseAsync().then(() => {

package/dist/skill/EVAL-HARNESS.md

@@ -0,0 +1,62 @@
+> 改进观察应写入 `user-adaptations.md`（见下方），由 Skill 维护者人工决定是否纳入正式 Skill 版本。
+
+1. 记录失败的测试编号与实际输出
+2. 定位到具体 Skill 文档段落（哪条规则未被遵守）
+3. **将改进建议追加到 `user-adaptations.md`**（格式见下方），不修改 Skill 文件本身
+4. 重新验证失败用例，通过后由维护者决定是否发布
+
+---
+
+## user-adaptations.md 格式规范
+
+`user-adaptations.md` 是一份**用户本地适配文件**，存放在userpath/.siluzan/user-adaptations.md (如果没有则你主动创建)
+它**不属于 Skill 包**，执行 `siluzan-tso update` 时不会被覆盖。
+
+### 用途
+
+- 记录用户在本项目中的操作习惯与偏好
+- 记录回归测试中发现的改进点（留给维护者参考）
+- 作为本 Skill 的**补充规则**，优先级低于官方 Skill 文档
+
+
+### 条目格式
+
+```markdown
+## 用户适配记录
+
+### [YYYY-MM-DD] <简短标题>
+
+- **类别**：[报告习惯 / 命令偏好 / 媒体偏好 / 账户配置 / 其他]
+- **观察**：<描述用户表现出的习惯或偏好>
+- **适配规则**：<在本项目中应当如何调整行为>
+- **来源**：[用户明确告知 / 会话观察推断 / 回归测试发现]
+
+---
+```
+
+### 示例条目
+
+```markdown
+## 用户适配记录
+
+### [2025-04-01] 用户偏好不展示门禁一声明
+
+- **类别**：报告习惯
+- **观察**：用户多次反馈"不需要看类型判断声明，直接给报告"
+- **适配规则**：本项目中，满足快速路径条件时直接生成，省略门禁一输出
+- **来源**：用户明确告知
+
+---
+
+### [2025-04-03] 默认账户 ID
+
+- **类别**：账户配置
+- **观察**：用户本项目主要操作 Google 账户 4545500137
+- **适配规则**：当用户说"那个 Google 账户"未指定 ID 时，优先询问是否为 4545500137
+- **来源**：会话观察推断
+
+---
+```
+
+---
+

package/dist/skill/SKILL.md

@@ -32,11 +32,11 @@ description: >-
 | `references/google-ads-test.md` | Google 广告业务矩阵与 Agent 测试 |
 | `references/aigc.md` | AIGC 广告方案数据准备（`aigc prepare`）及落地流程 |
 | `references/reporting.md` | TSO steward 报告、Google 网关分析、`google-analysis`、**Meta/TikTok/Bing TSO 分析**（`report meta-overview`、`report tiktok-*`、`report bing-*`）、AI 智投 / 优化 / 预警 / 线索 |
-| `report-templates/` | Google / Meta / TikTok / Bing 周期与诊断类报告 **Markdown 纲要与Style样式参考html文件**（与 `google-analysis`、`report tiktok-*`、`report bing-*` 等配合） |
+| `report-templates/` | Google / Meta / TikTok / Bing 报告资源目录。**`.md` 是内容必选纲要；`.html` 只是视觉样式参考**（与 `google-analysis`、`report tiktok-*`、`report bing-*` 等配合） |
 | `references/finance.md` | 转账 / 发票（充值需网页） |
 | `references/tso-home.md` | TSO 首页看板页面与 CLI 对照 |
 | `references/setup.md` | 安装 / 登录 / 配置 / 环境切换 |
-
+| `EVAL-HARNESS.md`|自我升级|
 ---
 
 ## 业务流程速查
@@ -151,4 +151,48 @@ CLI 命令执行后可能在输出末尾出现以下两种标记，Agent 必须
 - **分页**：默认每页 20 条，数据量大时加 `--page-size 100` 或 `--page` 翻页。
 - **充值等网页操作**：先 `config show` 取 `webUrl`，再拼路径引导用户。
 - **Google 新开户**：终端用户优先建议 `open-account google-wizard`；说明网页「五步」里**充值激活**必须网页完成。详见 `references/open-account-google-ui.md`。
+- **报告目录优先级**：生成报告时，先读 `report-templates/*.md` 定义内容，再读 `report-template*.html` 选择样式；**内容优先级永远高于样式**。
 - **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件，不要猜参数。
+
+---
+
+## 用户习惯记录（User Adaptations）
+
+### Skill 文件只读原则
+
+**Agent 不得修改本目录中的任何 Skill 文件**（包括 `SKILL.md`、`references/*.md`、`report-templates/*.md`、`EVAL-HARNESS.md`）。  
+执行 `siluzan-tso update` 时，这些文件会被 Skill 包覆盖，手动修改会丢失。
+
+### 用户习惯写入 user-adaptations.md
+
+当 Agent 在会话中观察到用户习惯、偏好或项目级配置时，将其**追加**到本 Skill 目录下的 `user-adaptations.md`：
+
+```
+.cursor/skills/siluzan-tso/user-adaptations.md
+```
+
+此文件**不属于 Skill 包**，`siluzan-tso update` 时不会覆盖。
+
+### 触发条件（何时写入）
+
+满足以下任一条件时，主动写入 `user-adaptations.md`：
+1. 用户明确告知一个偏好（"我不需要看声明"、"默认用这个账户"等）
+2. 同一会话中用户连续 2 次以上纠正相同行为
+3. 用户说"记住这个"、"以后都这样"等明确保存意图的表达
+
+### 何时读取
+
+每次新会话开始时，检查 `user-adaptations.md` 是否存在：
+- **存在**：读取并作为本项目的补充规则（优先级低于官方 Skill 文档，但高于默认行为）
+- **不存在**：正常执行，无需创建空文件
+
+### 条目格式
+
+```markdown
+### [YYYY-MM-DD] <一句话描述>
+
+- **类别**：[报告习惯 / 命令偏好 / 账户配置 / 流程偏好 / 其他]
+- **观察**：<具体的用户行为或明确表达>
+- **适配规则**：<本项目中 Agent 应当如何调整>
+- **来源**：[用户明确告知 / 会话观察]
+```

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.0.0-beta.29",
-  "publishedAt": 1774495966996
+  "version": "1.0.0-beta.30",
+  "publishedAt": 1774507264267
 }

package/dist/skill/references/accounts.md

@@ -18,6 +18,8 @@ siluzan-tso list-accounts [选项]
 | `-p, --page <n>` | 页码（默认 1） |
 | `--page-size <n>` | 每页数量（默认 20） |
 | `--json` | 输出原始 JSON |
+| `--unicode` | 表格使用 Unicode 线框；**默认**为 ASCII `+-|` 线框（兼容各类终端） |
+| `--plain` | 已默认 ASCII，无需再传；保留兼容旧脚本 |
 
 **示例：**
 

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

@@ -1,32 +1,145 @@
-# 报告模板（账户分析纲要）
-
-本目录为 **Markdown 纲要**
-
-## 报告应有的内容
-对应类型的报告应有哪些内容可以参考以下markdown文件
-| 内容描述文件 | 适用场景 |
-|----------|----------|
-| `google-period-report.md` | 按单段时间做系列/地域/设备/关键词等汇总 |
-| `google-account-diagnosis-report.md` | 健康度、结构、定向、创意、搜索词等分章诊断（纲要版） |
-| `google-ads-diagnosis.md` | **与网页版《Google Ads 账户诊断报告》章节、字段对齐**的完整 Markdown 骨架 |
-| `meta-period-report.md` | Meta（Facebook）账户周期报告纲要（当前仅总览；见 `report meta-overview`） |
-| `tiktok-period-report.md` | TikTok 广告主周期报告纲要（见 `report tiktok-*` 子命令） |
-| `bing-period-report.md` | Bing（BingV2）分析纲要（见 `report bing-*`；日期不可含今天/昨天） |
-
-- **Google**：数据用 `siluzan-tso google-analysis <子命令>` 拉取（需 `googleApiUrl`）。
-- **Meta / TikTok / Bing**：走 TSO `reporting/media-account/...`，见 `report meta-overview`、`report tiktok-overview`、`report bing-overview` 等。
-
-与 HTTP 路径的对应关系见 `references/reporting.md` 中「Google 账户分析」「Meta」「TikTok」「Bing」等小节。
-
-## 报告样式参考
-将 Markdown 纲要转为成品 HTML 时，可选用下列 **同一套区块结构**（`data-section-id` 一致）的版式参考；技术栈均为 Tailwind Play CDN + Font Awesome 6 + ECharts 5。
-
-| 报告样式文件 | 风格 | 说明 |
-|-------------|------|------|
-| `report-template.html` | **商务 / 数据看板** | 品牌色、圆角卡片、轻阴影、徽章式环比；适合对内经营分析、运营周报。 |
-| `report-template-academic.html` | **专业学术** | 衬线标题（Noto Serif SC / Source Serif 4）、纸本式窄栏、线框表、低饱和图表；适合偏研究/方法说明口吻。 |
-| `report-template-formal.html` | **正式文件 / 公文** | 红头线、居中标题、文头信息表、中文序号「一、二、…」、全框黑线表；适合对外的说明性、留痕类文档。 |
-| `report-template-dark.html` | **深色 / 演示投屏** | 锌灰底、青紫高对比图表与字号；适合会议室大屏（打印样式会尝试改浅色）。 |
-| `report-template-print.html` | **黑白打印** | 纯线框、无圆角阴影、灰阶 ECharts、环比用 ↑↓/加粗；适合归档与传真式阅读。 |
-| `report-template-onepager.html` | **对客单页精华** | 首屏叙事 + 主 KPI + 主图；第 2–6 节为 `<details>` 折叠（`data-section-id` 在折叠容器上）。 |
-| `report-template-mobile.html` | **移动端优先** | `max-w-lg` 窄栏、大触控留白、表格外滑动提示、饼图图例置底；`sm+` 渐进接近商务版。 |
+# 报告模板（账户分析纲要）
+
+本目录包含两类文件，职责**完全不同**，使用前必须区分：
+
+| 文件类型 | 职责 | 权威性 |
+|---------|------|--------|
+| `*.md` | **内容合同**：必写章节、数据来源、最低交付标准 | 最高 — 冲突时以此为准 |
+| `report-template*.html` | **样式参考**：排版、卡片、图表、打印或移动端视觉方案 | 仅限视觉 — 不定义内容 |
+
+> 完整的能力边界（哪些媒体能拉哪些数据、命令参数）**只维护**在 `references/reporting.md`，本目录不重复描述。
+
+## 使用顺序（必须遵守）
+
+1. **先读对应的 `*.md`** — 确认"这份报告必须写什么"
+2. **再读 `report-template*.html`** — 确认"这些内容怎么展示"
+3. **冲突时以 `*.md` 为准** — 不能因 HTML 缺某章节就省略 `.md` 要求的内容
+4. **HTML 中的假数据不是内容** — 示例里的假标题、假数字只是 UI 演示
+
+## 内容合同文件（先读这些）
+
+| 文件 | 适用场景 |
+|------|---------|
+| `google-period-report.md` | Google 账户周期分析（系列 / 地域 / 设备 / 关键词汇总） |
+| `google-account-diagnosis-report.md` | Google 账户健康度诊断（结构、定向、创意、搜索词等分章） |
+| `google-ads-diagnosis.md` | 与网页版《Google Ads 账户诊断报告》对齐的完整 Markdown 骨架 |
+| `meta-period-report.md` | Meta（Facebook）账户周期报告（当前仅总览；见 `report meta-overview`） |
+| `tiktok-period-report.md` | TikTok 广告主周期报告（见 `report tiktok-*` 子命令） |
+| `bing-period-report.md` | Bing（BingV2）分析（见 `report bing-*`；日期不可含今天/昨天） |
+
+**数据来源**：
+- Google：`siluzan-tso google-analysis <子命令>`（需配置 `googleApiUrl`）
+- Meta / TikTok / Bing：`siluzan-tso report <媒体>-overview`，见 `references/reporting.md`
+
+## 样式参考文件（后读这些）
+
+技术栈：Tailwind Play CDN + Font Awesome 6 + ECharts 5
+
+| 样式文件 | 风格 | 适用场景 |
+|---------|------|---------|
+| `report-template.html` | 商务 / 数据看板 | 对内经营分析、运营周报 |
+| `report-template-academic.html` | 专业学术 | 研究 / 方法说明口吻 |
+| `report-template-formal.html` | 正式文件 / 公文 | 对外说明性、留痕类文档 |
+| `report-template-dark.html` | 深色 / 演示投屏 | 会议室大屏 |
+| `report-template-print.html` | 黑白打印 | 归档与传真式阅读 |
+| `report-template-onepager.html` | 对客单页精华 | 首屏摘要 + 折叠详情 |
+| `report-template-mobile.html` | 移动端优先 | 手机查看 |
+
+## 未知报告名的处理
+
+当用户要求不在上表中的报告名时，参见 `REPORT-WORKFLOW.md` 中的映射与降级流程。
+
+## 报告生成规则
+
+> 设计哲学：**先建轨道，再跑模型**。未知报告名不是失败，编造数据才是失败。
+
+### 报告资源目录的角色划分（单一事实源）
+
+| 文件类型 | 职责 | 权威性 |
+|---------|------|--------|
+| `report-templates/*.md` | **内容合同**：必写章节、数据来源、最少交付要求 | 最高，冲突时以此为准 |
+| `report-template*.html` | **样式样板**：排版、色彩、图表、响应式 | 仅限视觉，不定义内容 |
+| `references/reporting.md` | **能力边界**：哪些媒体能拉哪些数据、命令参数 | 能力唯一真源，不在其他地方重复 |
+
+### 门禁一：开始前必须声明（不可跳过）
+
+任何报告生成任务，在拉取数据或写任何内容之前，**先在对话中输出以下声明**：
+
+```
+报告类型判断：
+- 用户意图：[周期分析 / 诊断 / 对比 / 汇报摘要]
+- 媒体：[Google / Meta / TikTok / Bing / ...]
+- 使用的内容合同（.md）：[文件名]
+- 使用的样式模板（.html）：[文件名，若需要]
+- 能力覆盖预判：[能覆盖的章节] / [因接口缺失暂无法覆盖的章节]
+```
+
+未知报告名映射规则（详见 `report-templates/REPORT-WORKFLOW.md`）：
+- 无法识别的报告名 → 先映射到 4 个原型之一（周期 / 诊断 / 对比 / 汇报），再选最接近的 `.md`
+- 无对应媒体的 `.md` → 以 Google 对应原型纲要为骨架，注明适配
+
+### 门禁二：数据驱动，禁止编造
+
+- **必须**：所有数字结论来自实际执行的 CLI 命令输出；命令 → 字段路径 → 结论，三者可追溯
+- **禁止**：照抄 HTML 示例中的假数据（如 `¥12,580`、`18,420`）填入报告
+- **禁止**：在缺乏接口支持时生成"看起来完整"的章节
+- 若某章节数据无法获取，在报告中**明确标注**，不写内容、不做猜测
+
+### 门禁三：输出前覆盖声明（必须附在每份报告末尾）
+
+```
+覆盖说明：
+✅ 已覆盖：[已输出的章节列表]
+⚠️ 未覆盖：[章节名] — 原因：[缺接口/缺参数/缺权限/用户未提供账户ID]
+```
+
+### 快速路径（数据已齐全时）
+
+满足以下全部条件时，可跳过门禁一声明，直接生成：
+1. 报告类型已明确（有对应 `.md`）
+2. 账户 ID 已确认（来自 `list-accounts` 或用户明确提供）
+3. 数据已拉取（命令已执行，结果在上下文中）
+
+### HTML 报告默认样式选择
+
+| 场景 | 默认模板 |
+|------|---------|
+| 对内分析 / 运营周报 | `report-template.html` |
+| 正式汇报 / 对外文档 | `report-template-formal.html` |
+| 投屏演示 | `report-template-dark.html` |
+| 单页摘要 | `report-template-onepager.html` |
+| 手机查看 | `report-template-mobile.html` |
+| 打印归档 | `report-template-print.html` |
+
+"带图表"= 在满足 `.md` 内容要求的前提下，把趋势/结构/对比优先用图表展示，**不是**只给图表不写结论。
+
+### 少样本决策示例（3 个必读模式）
+
+**示例 A — 标准报告生成**
+
+用户说："帮我做个 Google 月度投放总结"
+→ 意图：周期分析 → 媒体：Google
+→ 内容合同：读 `google-period-report.md`
+→ 执行门禁一声明：输出类型判断 + 覆盖预判
+→ 执行数据拉取：`google-analysis overview / campaigns / devices / keywords`
+→ 填充章节，末尾附覆盖声明
+→ 样式默认：`report-template.html`（未指定时）
+
+**示例 B — 未知报告名映射**
+
+用户说："给客户一份 Meta 广告账户健康检查"
+→ "健康检查"= 诊断型 → 媒体：Meta
+→ 当前 Meta 无诊断专用 `.md`
+→ 映射：以 `google-account-diagnosis-report.md` 为骨架，查 `references/reporting.md` 校验 Meta 能力
+→ 发现 Meta 当前只有 overview 接口（无系列/受众/搜索词细分）
+→ 声明：降级生成，注明未覆盖章节与原因
+→ 执行：`report meta-overview -a <id> --json`，仅填能覆盖的节
+→ 末尾覆盖声明：列出未覆盖原因
+
+**示例 C — 账户操作 ID 门禁**
+
+用户说："查一下 Google 账户 123456 的余额"
+→ 禁止直接用"123456"执行命令
+→ 先执行 `siluzan-tso list-accounts -m Google` 确认该 ID 在列表中
+→ 确认后取 `mediaCustomerId`，再执行 `siluzan-tso balance -m Google -a <mediaCustomerId>`
+→ 不在列表中：告知用户该 ID 未找到，请确认账户归属

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

@@ -0,0 +1,165 @@
+# 报告决策示例（少样本参考）
+
+> **重要**：这些示例记录的是**决策过程**，不是成品文本的模板。  
+> 目的：帮助 AI 理解如何从用户意图映射到正确的工具调用链，而不是照抄任何一份完整输出。
+
+---
+
+## 示例 1：标准 Google 周期报告
+
+**用户输入**：帮我做个 Google 上个月的投放总结，账户 4545500137
+
+**决策过程**：
+```
+意图识别：周期型 + Google
+内容合同：google-period-report.md
+账户确认：mediaCustomerId=4545500137（用户明确提供，仍需在 list-accounts 中验证）
+覆盖预判：能覆盖 总览/系列/设备/关键词 → 地域数据视接口状态
+```
+
+**执行命令链**：
+```bash
+siluzan-tso google-analysis overview -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
+siluzan-tso google-analysis campaigns -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
+siluzan-tso google-analysis devices   -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
+siluzan-tso google-analysis keywords  -a 4545500137 --start 2025-03-01 --end 2025-03-31 --json
+```
+
+**关键字段提取**（以 overview 为例）：
+```
+cost → 总消耗
+clicks / impressions / ctr / conversions / cpc → 核心 KPI
+costMicros 转换：除以 1,000,000 得到货币值
+```
+
+**章节填充规则**：
+- 有数据的章节：用真实数字，注明环比（需拉上期区间对比）
+- 数据为 0 的章节：如实写 0，说明可能原因（无投放/停投/权限）
+- 无接口的章节：占位标注，不推测
+
+**末尾覆盖声明模板**：
+```
+✅ 已覆盖：总览 / 广告系列表现 / 设备分布 / 关键词消耗
+⚠️ 未覆盖：地域分布 — 原因：overview 接口未返回地域细分，需单独地域命令
+📌 数据来源：google-analysis overview / campaigns / devices / keywords（上述命令已执行）
+```
+
+---
+
+## 示例 2：未知报告名 → 降级处理
+
+**用户输入**：给我出一份 Meta 广告账户健康体检报告，账户 ID 112233445
+
+**决策过程**：
+```
+意图识别："健康体检"= 诊断型 + Meta
+内容合同查找：meta 无专用诊断 .md
+映射降级：以 google-account-diagnosis-report.md 为骨架
+能力校验（查 references/reporting.md）：
+  - Meta 当前支持：OverviewSectionData（总览）
+  - Meta 当前不支持：系列细分、受众细分、搜索词、创意诊断
+降级决策：仅填总览章节，其余标注"接口待开放"
+```
+
+**执行命令链**：
+```bash
+siluzan-tso report meta-overview -a 112233445 --json
+```
+
+**声明输出（在开始前向用户说明）**：
+```
+报告类型判断：
+- 用户意图：诊断型
+- 媒体：MetaAd
+- 内容合同：google-account-diagnosis-report.md（降级适配，Meta 暂无专用诊断模板）
+- 能覆盖：账户总览（消耗/点击/展示/转化）
+- 当前无法覆盖：广告系列诊断、受众诊断、创意健康度 — 原因：Meta TSO 当前仅开放 overview 接口
+```
+
+**执行结果中的注意点**：
+- `OverviewSectionData` 返回的是时间段汇总数据，不含历史趋势序列
+- 无法给出"建议优化哪条广告系列"的结论（无系列级数据）
+- 可以给出的结论：CTR/CPC 整体水平判断、消耗趋势方向（若有环比）
+
+---
+
+## 示例 3：跨媒体汇总请求
+
+**用户输入**：给我汇总一下上周 Google 和 TikTok 的投放数据
+
+**决策过程**：
+```
+意图识别：周期型 + 多媒体（Google + TikTok）
+内容合同：google-period-report.md + tiktok-period-report.md（分别读）
+执行顺序：先 Google，再 TikTok，最后汇总章节
+```
+
+**执行命令链（分两段）**：
+```bash
+# Google 段
+siluzan-tso google-analysis overview -a <google_id> --start 2025-04-14 --end 2025-04-20 --json
+
+# TikTok 段
+siluzan-tso report tiktok-overview -a <tiktok_id> --start 2025-04-14 --end 2025-04-20 --json
+siluzan-tso report tiktok-campaigns -a <tiktok_id> --start 2025-04-14 --end 2025-04-20 --json
+```
+
+**账户 ID 确认（必须先执行）**：
+```bash
+siluzan-tso list-accounts -m Google
+siluzan-tso list-accounts -m TikTok
+```
+
+**汇总时的报告结构**：
+- 第一节：跨媒体总消耗对比（表格形式，一行一媒体）
+- 第二节：各媒体独立章节（每个媒体按自身 `.md` 要求）
+- 不要把两个媒体的数据混在同一个章节里，口径不同
+
+---
+
+## 示例 4：用户提供不存在的报告类型
+
+**用户输入**：给我做一份 Yandex 关键词效果分析报告
+
+**决策过程**：
+```
+意图识别：周期型（关键词聚焦）+ Yandex
+内容合同查找：Yandex 无专用 .md，list-accounts 支持 Yandex，但 reporting.md 无关键词接口
+能力校验：Yandex 当前仅有账户基础数据（stats）
+降级：用 google-period-report.md 骨架中的"关键词分析"章节，但说明数据来源受限
+```
+
+**声明（必须先告知用户）**：
+```
+报告类型判断：
+- 用户意图：关键词效果分析（归属周期型）
+- 媒体：Yandex
+- 内容合同：google-period-report.md 中关键词章节（降级适配）
+- 能覆盖：账户整体消耗、余额（via stats / balance）
+- 当前无法覆盖：Yandex 关键词级数据 — 原因：TSO reporting API 当前未开放 Yandex 关键词细分
+- 建议：若需关键词数据，请直接登录 Yandex Ads 后台查看
+```
+
+---
+
+## 示例 5：快速路径（数据已就绪）
+
+**场景**：用户在同一对话中已经执行过 `google-analysis overview --json`，现在说"帮我整理成报告"
+
+**决策过程**：
+```
+快速路径条件检查：
+  ✅ 报告类型明确（周期型 Google）
+  ✅ 账户 ID 已确认（上下文中有）
+  ✅ 数据已拉取（overview JSON 在上下文中）
+→ 跳过门禁一声明，直接填充章节
+→ 仍需输出门禁三覆盖声明（数据仅含 overview，其他章节标注待补充）
+```
+
+---
+
+## 这些示例不告诉你的事
+
+- 不要照抄示例中的数字（那些是说明格式用的占位符）
+- 不要把"示例 B 的覆盖声明格式"原文粘贴到真实报告里
+- 示例展示的是**推理路径**，真实报告中的结论必须来自实际命令输出

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

@@ -0,0 +1,144 @@
+# 报告生成工作流（未知报告名处理流程）
+
+本文档定义当用户请求的报告名不在已知模板列表中时的**标准处理流程**，以及每种情况下的降级规则与覆盖声明格式。
+
+---
+
+## 六步处理流程
+
+```
+步骤 1 识别意图
+   ↓
+步骤 2 原型映射
+   ↓
+步骤 3 数据能力校验
+   ↓
+步骤 4 声明（门禁一）
+   ↓
+步骤 5 执行 + 降级生成
+   ↓
+步骤 6 输出 + 覆盖声明（门禁三）
+```
+
+---
+
+### 步骤 1：识别意图
+
+从用户措辞中提取两个维度：
+
+| 维度 | 识别方法 | 示例 |
+|------|---------|------|
+| **媒体** | 关键词：Google / Meta / TikTok / Bing / Kwai | "Meta 广告分析" → MetaAd |
+| **报告类型** | 关键词映射（见下表） | "健康检查" → 诊断型 |
+
+**类型关键词映射表**
+
+| 用户说的词 | 映射到的原型 |
+|-----------|------------|
+| 月报、周报、日报、阶段分析、投放总结、效果回顾 | **周期型** |
+| 健康检查、诊断、体检、问题排查、账户分析 | **诊断型** |
+| 对比、AB测试、竞品、同期比较 | **对比型** |
+| 汇报、PPT、给客户、精华版、摘要 | **汇报摘要型** |
+
+> 若仍无法确定，默认为**周期型**，并在声明中注明推断依据。
+
+---
+
+### 步骤 2：原型映射
+
+根据「媒体 + 类型」找到最近似的内容合同（`.md`）：
+
+| 媒体 | 周期型 | 诊断型 | 对比型 | 汇报摘要型 |
+|------|--------|--------|--------|-----------|
+| Google | `google-period-report.md` | `google-account-diagnosis-report.md` | 无专用，以周期型为骨架 | 以诊断型精简 |
+| Meta | `meta-period-report.md` | 无专用 → 以诊断纲要降级 | 无专用 | 以周期型精简 |
+| TikTok | `tiktok-period-report.md` | 无专用 → 以诊断纲要降级 | 无专用 | 以周期型精简 |
+| Bing | `bing-period-report.md` | 无专用 → 以诊断纲要降级 | 无专用 | 以周期型精简 |
+| 未知媒体 | 以 Google 对应原型为骨架 | → | → | → |
+
+**降级规则（从高到低）**：
+1. 有精确对应 `.md` → 直接使用
+2. 有同媒体其他类型 `.md` → 用最接近的，声明已适配
+3. 有同类型其他媒体 `.md` → 用 Google 对应型，声明能力受限
+4. 完全无对应 → 以 `google-period-report.md` 为最小骨架，声明原因
+
+---
+
+### 步骤 3：数据能力校验
+
+打开 `references/reporting.md`，查询该媒体**当前支持的 CLI 命令**。
+
+按章节检查哪些能覆盖，哪些无法覆盖：
+
+```
+[能覆盖]   = 有对应 CLI 命令且参数已确认
+[受限]     = 有命令但需额外参数（用户未提供 accountId 等）
+[无法覆盖] = 当前无对应接口 / 命令不存在
+```
+
+---
+
+### 步骤 4：声明（门禁一，不可跳过）
+
+在开始拉数据前，向用户输出以下声明：
+
+```
+报告类型判断：
+- 用户意图：[从步骤 1 识别出的类型]
+- 媒体：[媒体名]
+- 内容合同：[选用的 .md 文件名]（若为降级，注明"适配自 xxx"]）
+- 样式模板：[.html 文件名，若未指定写"默认"]
+- 能覆盖的章节：[列表]
+- 当前无法覆盖：[章节名 + 原因]（若全覆盖写"全部覆盖"）
+```
+
+---
+
+### 步骤 5：执行 + 降级生成
+
+**正常执行路径**：
+1. 按 `.md` 中列出的 CLI 命令依次执行
+2. 每个命令加 `--json` 获取结构化数据
+3. 用实际数据填充对应章节
+
+**降级生成规则**：
+- 章节数据缺失 → 用 `[ 数据不可用：{原因} ]` 占位，不写任何推测性内容
+- 命令执行失败 → 记录错误信息，注明此章节基于上次已有数据或跳过
+- 账户 ID 未确认 → 暂停，提示用户先执行 `list-accounts` 确认
+
+**禁止**：
+- 使用 HTML 模板中的假数字填充真实报告
+- 在没有执行命令的情况下凭印象写出具体数字
+- 把无数据章节写成"暂无异常"（这是误导性结论，需说明原因）
+
+---
+
+### 步骤 6：输出 + 覆盖声明（门禁三，每份报告必须附）
+
+报告正文末尾追加：
+
+```
+---
+## 覆盖说明
+
+✅ 已覆盖：
+- [章节一]
+- [章节二]
+- ...
+
+⚠️ 未覆盖：
+- [章节名] — 原因：[缺接口 / 缺参数 / 账户未授权 / 用户未提供 ID]
+
+📌 本报告数据来源：[实际执行的命令列表]
+```
+
+---
+
+## 常见场景速查
+
+| 场景 | 处理方式 |
+|------|---------|
+| 用户说"帮我看下 Kwai 账户" | 无 Kwai 专用模板 → 用 `google-period-report.md` 骨架 → 查 `reporting.md` 确认 Kwai 支持哪些命令 → 声明降级 |
+| 用户说"生成一份竞品对比报告" | 对比型 → 当前无专用模板 → 降级为周期型 → 声明：当前无竞品数据接口，仅输出本账户数据 |
+| 用户未提供账户 ID | 步骤 5 暂停 → 提示：请先运行 `siluzan-tso list-accounts -m <媒体>` 获取 mediaCustomerId |
+| 用户要求"尽量完整"但接口有限 | 声明能力边界，在能覆盖的章节写实，在无数据章节用占位标注 — 不要为了"看起来完整"编造数据 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.0.0-beta.29",
+  "version": "1.0.0-beta.30",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "type": "module",
   "bin": {