siluzan-tso-cli 1.1.37-beta.13 → 1.1.37-beta.15

package/README.md

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

package/dist/index.js

@@ -131971,7 +131971,10 @@ configureCliJsonSnapshot({
   fieldGuideRefs: [
     "references/accounts/currency.md",
     "references/core/tips.md",
-    "references/accounts/accounts.md"
+    "references/accounts/accounts.md",
+    "references/accounts/accounts-list.md",
+    "references/accounts/accounts-balance-stats.md",
+    "references/accounts/accounts-permissions.md"
   ]
 });
 var program = new Command5();

package/dist/skill/AGENTS.md

@@ -1,62 +1,35 @@
-# siluzan-tso — Agent 文档目录
+# siluzan-tso — 文档目录
 
-> 单一 Skill 包（`name: siluzan-tso`）。运行时入口：`SKILL.md` → 按域 lazy-load `references/`。
+> 入口：`SKILL.md` → 按路由表 Read 列出的文件。改文档结构时对齐 `references/core/skill-authoring.md`。
+
+## 怎么找文档
+
+| 要做什么 | 读哪里 |
+| -------- | ------ |
+| 锁定工作流 | `SKILL.md` 路由表 |
+| 报告类话术模糊 | `references/core/intent-routing.md` |
+| 步骤与产物 | `playbooks.md`（P*）或 `workflows.md`（W*） |
+| 命令参数 / 字段 | 路由表「必读文档」 |
+| 纪律与对用户怎么说 | `references/core/agent-conventions.md` |
+| 报告结构纲要 | `report-templates/*.md`（勿读 `*.html`） |
 
 ## 启动顺序
 
-1. Read `SKILL.md`（单一路由表：意图 → 工作流 → 必读文档）
-2. **每个新任务** Read `references/core/agent-conventions.md`
-3. 按路由表 Read「必读文档」与对应工作流卡片，再执行 `siluzan-tso …`：
-   - 分析/报告类线性步骤 → `references/core/playbooks.md`（P1–P9）
-   - 操作/管理类线性步骤 → `references/core/workflows.md`（W1–W12）
-   - 命令参数/字段口径 → 各域 `references/*.md`
-4. **P5 / P6 / P7** 或长 CLI 输出：可选 Read `references/core/subagent-orchestration.md`（主 Agent 自行决定是否委派 subagent）
-
-## 文档域（gstack-style domains）
-
-| 域             | 路径                                                                 | 何时 Read                                                      |
-| -------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- |
-| **Core**       | `references/core/`                                                   | 纪律、安装、tips、playbooks、workflows、subagent-orchestration |
-| **Handoff**    | `snippets/`                                                          | P5/P6/P7 Task 派发模板（与 SKILL 同级）                        |
-| **Accounts**   | `references/accounts/`                                               | 列表、余额、开户、财务、审计                                   |
-| **Google Ads** | `references/google-ads/`                                             | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP                |
-| **Analytics**  | `references/analytics/`                                              | 拉数、批处理、拓词、RAG、TSO 报告                              |
-| **Operations** | `references/operations/`                                             | 预警、线索、优化记录、宿主编排自动化                           |
-| **Templates**  | `assets/`、`references/report-templates/`、`report-templates/*.html` | JSON 契约、报告纲要、HTML 样式                                 |
-
-## 工作流目录
-
-| 类别          | 文档                           | 编号   |
-| ------------- | ------------------------------ | ------ |
-| 分析 / 报告类 | `references/core/playbooks.md` | P1–P9  |
-| 操作 / 管理类 | `references/core/workflows.md` | W1–W12 |
-
-专用报告模板（被工作流卡片引用）：
-
-| ID                | 文档                                                              |
-| ----------------- | ----------------------------------------------------------------- |
-| 网站诊断          | `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） |
-| 账户按日 Excel    | `references/report-templates/stats-daily-excel.md`（P4-DAILY） |
-| OKKI 周报         | `references/report-templates/okki-weekly-google-client.md`        |
-| 询盘分析          | `references/report-templates/google-inquiry-analysis.md`          |
-
-## 维护
-
-- 源码唯一真相：`tso-cli/assets/siluzan-ads/`（勿编辑 `skills/siluzan-tso/` 副本）
-- 通用纪律唯一真相源：`references/core/agent-conventions.md`（其他文档只单行指向，不复制规则）
-
-## CLI 代码域（与文档对齐）
-
-| CLI 模块                                                                | 文档域                                |
-| ----------------------------------------------------------------------- | ------------------------------------- |
-| `src/commands/list-accounts/`、`accounts-digest/`、`balance-scan/`      | accounts                              |
-| `src/commands/open-account/`、`account-manage-register.ts`              | accounts                              |
-| `src/commands/ad/`                                                      | google-ads                            |
-| `src/commands/google-analysis/`、`google-analysis-batch.ts`             | analytics                             |
-| `src/commands/facebook-analysis/`、`bing-analysis/`、`tiktok-analysis/` | analytics（架构对齐 google-analysis） |
-| `src/commands/website-diagnosis/`                                       | analytics（网站诊断）                 |
-| `src/commands/market-analysis/`                                         | analytics（战略市场分析）             |
-| `src/commands/report/`                                                  | analytics + report-templates          |
-| `src/commands/forewarning/`、`optimize/`、`clue.ts`                     | operations                            |
+1. Read `SKILL.md` 路由表，锁定唯一工作流
+2. 报告类模糊 → Read `intent-routing.md`
+3. Read「必读文档」+ 对应 playbook/workflow 卡片
+4. 写操作 / 报告交付 / 批量 / 对用户写结论 → Read `agent-conventions.md` 相关节
+5. P5/P6/P7 或长 CLI：可选 `subagent-orchestration.md`
+
+## 按域
+
+| 域 | 路径 | 说明 |
+| -- | ---- | ---- |
+| Core | `references/core/` | conventions、intent-routing、playbooks、workflows |
+| Accounts | `references/accounts/` | 直接读 `accounts-list` / `accounts-balance-stats` / `accounts-permissions` |
+| Google Ads | `references/google-ads/` | `google-ads-read` / `write` / `batch`；`rules/` 先 README 再单文件 |
+| Analytics | `references/analytics/` | 拉数、批处理、拓词 |
+| Operations | `references/operations/` | 预警、线索；自动化仅用户问起时 |
+| Templates | `report-templates/*.md`、`assets/` | 报告纲要 / JSON 契约 |
+
+源码目录：`tso-cli/assets/siluzan-ads/`。

package/dist/skill/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: siluzan-tso
-description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网/链接/落地页+诊断/检测/监测/评估/体检/报告等词（含用户混说的「网络诊断/网络检测/网络监测」）→直接P8 website-diagnosis，禁止走P9行业分析或P1账户诊断、禁止A/B/C/D追问；细则见 references/core/intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类话术→必走P9 market-analysis collect+render出HTML，禁止纯WebSearch/WebFetch在对话里写Markdown/HTML当终稿、禁止改走P8/P1/P4/W5/google-analysis；细则见 references/core/intent-routing.md §零·B。【§零·C·关键词规划】Google Ads/谷歌广告拓词、关键词规划/推荐、Keyword Planner、长尾关键词、月搜索量/搜索量、竞争度、核心词/种子词扩词（含「阅读网址/文章/页面后针对核心词出带搜索量词表」，无论是否提及丝路赞/TSO/账户）→必走W5 keyword -k … --google-only --json-out，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/campaign JSON→W3；仅要词表+搜索量/竞争度→W5；平台优化报告列表/推送→W7；对象仍不清→Read intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、六大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】Google搜索系列方案与 campaign-validate/create（W3）、系列/组/广告/关键词 CRUD/拒审、PMax 创建与素材、AI智投草稿 batch（W4）、拓词 keyword -k（W5）、AI广告优化 optimize（W6）、优化合规 SOP。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
+description: >
+  Manages Siluzan TSO ads (Google/Bing/Yandex/TikTok/Kwai/MetaAd): accounts, balance,
+  spend, open-account, Google Ads CRUD/PMax, Keyword Planner, invoices, forewarning,
+  and HTML reports (account diagnosis, period, website, market analysis). Use when the
+  user mentions 丝路赞/TSO/广告账户/出价预算, asks for 行业/市场分析报告, 网站诊断 with a
+  URL, 拓词/月搜索量/Keyword Planner, or Google Ads campaign plans. Do not use for CSO
+  content publishing (siluzan-cso).
 license: MIT
 compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
 metadata:
@@ -11,99 +17,87 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 # Siluzan TSO Skill
 
-本 Skill 只做 **任务路由**：用一张「意图 → 工作流」表把用户需求映射到**唯一**的线性工作流。
+本文件只做 **任务路由**：意图 → **唯一**工作流 → 按需 Read 子文档（参数与步骤不在此重复）。
 
-- **每个业务都有一条线性工作流**（编号步骤）：
-  - **分析 / 报告类**（拉数 → 脚本 → 交付）→ `references/core/playbooks.md`（P1–P9）
-  - **操作 / 管理类**（开户、广告 CRUD、优化、预警、推送、线索、财务、权限、巡检）→ `references/core/workflows.md`（W1–W12）
-- 业务细节、命令参数、字段口径以各域 `references/*.md` 为准（被工作流卡片引用，**不在本文件重复**）。
+- 分析 / 报告 → `references/core/playbooks.md`（P1–P9）
+- 操作 / 管理 → `references/core/workflows.md`（W1–W12）
+- 命令参数 → 路由表「必读文档」
+- 通用纪律与沟通 → `references/core/agent-conventions.md`
 
-<!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}}；构建时由 gen-skill-docs.mjs 合并 -->
-
-> **Agent 纪律（每个新任务必读）**：先 Read `references/core/agent-conventions.md`（唯一规则真相源：加载纪律、数据处理协议、时间/币种、批量约束、交付前自检），再按下方路由表 Read「必读文档」与对应工作流卡片。向用户回复时另 Read `references/core/user-communication-guide.md`（伙伴式沟通：结论先行、先执行后解释、禁止机械贴 CLI/编号）。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + **仅用代码**读落盘 JSON（脚本示例见 `references/core/tips.md`）。
->
-> **报告 / 分析类统一消歧（必读）**：用户话术含「报告 / 诊断 / 分析 / 检测 / 监测 / 月报 / 周报」等，或对象不清（只有「帮我出份报告」）→ **必须先 Read `references/core/intent-routing.md`**。**§零 优先**：**网址/域名/官网/链接 + 诊断类词**（含用户说的「网络诊断/网络检测」）→ **直接 P8**，禁止走 P9/P1。**§零·B 次优先**：未命中 §零 的**行业/市场分析报告**（行业分析、市场分析、行业分析报告、「写一份 XX 行业报告」、战略/KA 市场报告、竞品/GTM 等，**无论是否提及丝路赞/广告**）→ **100% 走 P9 `market-analysis collect`+`render`**，**禁止**纯 WebSearch/WebFetch 在对话里写 Markdown/HTML 当终稿，**禁止**改走 P8/P1/P4/W5。**§零·C 关键词规划**：**拓词 / Keyword Planner / 长尾关键词 / 月搜索量 / 竞争度 / 核心词扩词**（含读 URL/文章后出 Google 词表，**无论是否提及丝路赞/账户**）→ **100% 走 W5 `keyword -k … --google-only --json-out`**，**禁止** WebSearch 编造搜索量。再按 §一 定唯一工作流。**禁止**见「报告」就默认 P4 周期或 P1 诊断。
+> **加载**：按下方路由表 Read **一个**工作流卡片 + **一个**命令/报告 reference 后执行。写操作、报告交付、批量拉数、对用户写结论、或上下文被压缩时，再 Read `references/core/agent-conventions.md`（含 §十四沟通）。
 >
-> **默认交付格式**：用户未指定格式时，网站诊断 P8、Meta 周期 P4-FB、战略市场 P9、**Google 广告诊断 P1** 默认 **HTML**（各自 `render` 子命令），Google 周期 P4 默认 HTML；**禁止**仅交付 Markdown 摘要或纯 JSON 充当终稿。
+> **报告 / 诊断 / 分析 / 拓词话术模糊**：先 Read `references/core/intent-routing.md`，再回路由表。数据任务一律 `--json-out` + 代码读盘（示例见 `references/core/tips.md`）。未指定格式时 P1/P4/P4-FB/P8/P9 默认 **HTML**。
 
 ---
 
-## 一键安装
+## 基本使用
 
-- **macOS / Linux / WSL：**
-  ```bash
-  bash <(curl -fsSL https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.sh)
-  ```
-- **Windows PowerShell：**
-  ```powershell
-  irm https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.ps1 | iex
-  ```
+```bash
+siluzan-tso -h
+```
 
-Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git Bash](https://git-scm.com/download/win) 运行 Bash 版安装命令。
+未安装 / 未登录 / 401 → Read `references/core/setup.md`。
 
-登录与配置见 `references/core/setup.md`。**401 换凭据时优先「手机号 + 验证码」**：`send-login-code` → `login --phone --code`。
+**步骤**：① 报告类模糊 → Read `intent-routing.md` → ② 锁定下方**唯一**工作流行 → ③ Read 该行「必读文档」+ 工作流卡片 → ④ 按编号步骤执行；写操作前与用户确认；对用户写结论时 Read conventions §十四。**禁止** Read `report-templates/*.html`（由 CLI `render` 使用）。
 
 ---
 
-## 基本使用
+## 即时规范
 
-`siluzan-tso-cli` 只是包名，安装后可执行命令为 `siluzan-tso`。
-
-```bash
-siluzan-tso -h   # 查看帮助
-```
-
-**Agent 三步法**：① **网址+诊断类词（含「网络诊断」）→ 直接 P8**（`intent-routing.md` §零）；其余报告类若话术模糊，先 Read `references/core/intent-routing.md` → ② 在下方路由表锁定**唯一**工作流行 → ③ Read 该行「必读文档」与工作流卡片 → ④ 按卡片**编号步骤**执行，写操作前先与用户确认。
+- `entityId`（UUID）≠ `mediaCustomerId`（媒体数字 ID）；MetaAd 列表 ID 常带 `act_`。
+- `list-accounts` 无余额/消耗；列全部用 `--page-size 999`。
+- 多户余额用 `balance-scan`（P2），多户消耗用 `accounts-digest`（P3）；禁止外层 for-loop 逐户拉数。
+- `stats` 的 `spend` = **区间合计**，不是日消耗。
+- 行业/市场报告禁止纯 WebSearch 当终稿；须 P9 `market-analysis collect`+`render`。
 
 ---
 
 ## 路由表（意图 → 工作流 → 必读文档）
 
-> 首次进入任意任务前先 Read `references/core/agent-conventions.md`。**网址/域名/官网 + 诊断/检测/监测/报告**（含「网络诊断」）→ **§零 直接 P8**，见 `references/core/intent-routing.md`。**用户只说「报告 / 诊断 / 分析 / 检测 / 监测」且对象仍不清** → 必须先 Read `intent-routing.md`（P1–P9 与 W3/W7 统一消歧）。下表每行指向**唯一**工作流；找不到时查 `references/README.md`。
+> 写操作 / 报告交付 / 批量拉数 / 对用户回复 → Read `agent-conventions.md`。找不到行 → 澄清或 Read `intent-routing.md`（勿整本加载 `references/README.md`）。
 
 ### 账户与财务
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `references/accounts/accounts.md`（§ list-accounts 意图速查） |
-| 单户实时余额 | W1 | `references/accounts/accounts.md`（balance） |
-| 多账户余额 / 续航不足预警 | **P2** | `references/accounts/accounts.md`（balance-scan） |
-| 单户消耗 / 投放数据 | W1 / **P1** | `references/accounts/accounts.md`（stats） |
-| 多账户消耗/对比汇总 | **P3** | `references/accounts/accounts.md`（accounts-digest） |
-| 激活/充值账单明细 | W1 | `references/accounts/accounts.md`（account-active-bills） |
-| 开户（六大媒体）/ 开户进度 | W2 | `references/accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `references/accounts/open-account-google-ui.md`） |
-| 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `references/accounts/accounts.md`（account 子命令） |
-| 充值 / 钱包 | W8 | `references/accounts/finance.md`（recharge 引导网页） |
-| 转账记录 / 账户间转账 | W8 | `references/accounts/finance.md`（transfer） |
-| 发票 / 开票 / 发票抬头 | W8 | `references/accounts/finance.md`（invoice / invoice-info） |
+| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `references/accounts/accounts-list.md`（list-accounts） |
+| 单户实时余额 | W1 | `references/accounts/accounts-balance-stats.md`（balance） |
+| 多账户余额 / 续航不足预警 | **P2** | `references/accounts/accounts-balance-stats.md`（balance-scan） |
+| 单户消耗 / 投放数据 | W1 / **P1** | `references/accounts/accounts-balance-stats.md`（stats） |
+| 多账户消耗/对比汇总 | **P3** | `references/accounts/accounts-balance-stats.md`（accounts-digest） |
+| 激活/充值账单明细 | W1 | `references/accounts/accounts-list.md`（account-active-bills） |
+| 开户（六大媒体）/ 开户进度 | W2 | `references/accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `open-account-google-ui.md`） |
+| 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `references/accounts/accounts-permissions.md` |
+| 充值 / 钱包 / 转账 / 发票 / 抬头 | W8 | `references/accounts/finance.md` |
 | 审计 / 误操作恢复 | — | `references/accounts/write-audit-restore.md` |
 
 ### Google 广告投放
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 新建搜索系列 / 出投放方案 / **按 Excel·xlsx·表格投放方案创建广告** / **根据官网·网站·URL 生成 Google 搜索广告** / 搜索广告文案·关键词·**表格** / 写搜索广告计划 | **W3** | `references/google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md`；**有方案文件时必读** `references/google-ads/rules/google-ads-plan-source-fidelity.md`（Agent 写脚本 Excel→campaign JSON + **`ad geo resolve`**；不合规须问「您自己改还是我帮您改」；代改则创建后出 from→to 报告）；表格交付读 `references/google-ads/rules/google-ads-launch-plan-template.md`。**≠ P8 / ≠ P9 / ≠ W5** |
-| 广告系列/组/广告/关键词 CRUD / 拒审 | W3 | `references/google-ads/google-ads.md` |
-| PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `references/google-ads/pmax-api.md` |
-| AI 智投草稿 list/get/update/publish | W4 | `references/google-ads/google-ads.md`（§ ad batch） |
-| 拓词 / keyword / 关键词规划 / **月搜索量** / **竞争度** / Keyword Planner / 长尾词 / 核心词扩词 | **W5** | `references/analytics/keyword-planner-workflows.md`（**§零·C 强制**；客户背景先 `references/analytics/rag.md`） |
+| 新建搜索系列 / 出投放方案 / Excel·表格方案 / 官网生成搜索广告 | **W3** | `references/google-ads/google-ads-campaign-plan.md` + **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md`；有方案文件时加 `references/google-ads/rules/google-ads-plan-source-fidelity.md`。**≠ P8 / ≠ P9 / ≠ W5** |
+| 广告系列/组/广告/关键词 **查询** / 拒审字段 | W3 | `references/google-ads/google-ads-read.md` |
+| 广告系列/组/广告/关键词 **创建·编辑·启停** | W3 | `references/google-ads/google-ads-write.md` |
+| PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `references/google-ads/pmax-api.md` + `google-ads-write.md`（PMax 节） |
+| AI 智投草稿 list/get/update/publish | W4 | `references/google-ads/google-ads-batch.md` |
+| 拓词 / keyword / 关键词规划 / 月搜索量 / 竞争度 / Keyword Planner | **W5** | `references/analytics/keyword-planner-workflows.md`（**§零·C**；客户背景先 `references/analytics/rag.md`） |
 | AI 广告优化记录 / 建议 | W6 | `references/operations/optimize.md` |
-| 优化/合规 SOP | W3 / W6 | `references/google-ads/rules/README.md` |
+| 优化/合规 SOP | W3 / W6 | `references/google-ads/rules/README.md`（**仅读索引表** → 再 Read **一个**具体 `rules/*.md`） |
 
-### 分析与报告（CLI 拉数 + Agent 撰稿）
+### 分析与报告
 
 | 用户意图（关键词） | 工作流 | 必读文档 |
 | ------------------ | ------ | -------- |
-| 单账户投放画像 / **Google 广告账户诊断** / 账户健康检查 / 投放诊断报告 / 账户体检（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md`；完整 HTML 诊断加 `references/report-templates/google-ads-diagnosis.md` |
-| Google 账户 **周期** / **月度** / **季度** 报告 / 月报（**非** OKKI / **非** 询盘 / **非** 强调健康诊断） | **P4** | `references/report-templates/google-period-report.md` + `references/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` + `references/analytics/facebook-analysis-guide.md`；要 Excel 加 `references/report-templates/meta-period-report-excel.md` |
-| TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md`（tiktok-analysis/bing-analysis）+ 对应 `references/report-templates/*-period-report.md` |
-| 账户级按日 Excel / 按天导出投放数据 | **P4-DAILY** | `references/report-templates/stats-daily-excel.md` |
+| Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |
+| Google 账户周期 / 月度 / 季度报告（非 OKKI / 非询盘 / 非强调健康诊断） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |
+| Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |
+| TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |
+| 账户级按日 Excel | **P4-DAILY** | `report-templates/stats-daily-excel.md` |
 | 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |
-| OKKI 周报 | **P6** | `references/report-templates/okki-weekly-google-client.md`（全文） |
-| Google 询盘分析 | **P7** | `references/report-templates/google-inquiry-analysis.md`（全文）+ `references/analytics/geo-continents.json` |
-| **网址/域名/官网/落地页** + 网站或**网络**诊断·检测·监测·评估·体检·质量报告 / 落地页报告 / 官网体检 | **P8** | `references/core/intent-routing.md` **§零** + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（`collect`→**`prepare`**→补全 diagnosis→`render`；读 `signals`；Lighthouse 失败降级；**默认 HTML**；**≠ P9 ≠ W3**） |
-| 市场分析 / **行业分析** / **行业分析报告** / 市场调查 / 生成 **XX 行业** 报告（如电商）/ 战略市场报告 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（**必须先** `market-analysis collect` + `render`，**默认交付 HTML**；**禁止**纯 WebSearch 交 Markdown 终稿；**≠ P8**） |
+| OKKI 周报 | **P6** | `report-templates/okki-weekly-google-client.md` |
+| Google 询盘分析 | **P7** | `report-templates/google-inquiry-analysis.md` + `references/analytics/geo-continents.json` |
+| 网址/域名/官网 + 网站或网络诊断·检测·监测·报告 | **P8** | `references/core/intent-routing.md` §零 + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**≠ P9 ≠ W3**） |
+| 市场/行业分析报告 / 战略市场 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（须 collect+render；**≠ P8**） |
 | TSO 平台优化报告：列表/生成/推送 | W7 | `references/analytics/reporting.md` |
 | RAG 知识库检索 | W5 | `references/analytics/rag.md` |
 
@@ -113,24 +107,19 @@ siluzan-tso -h   # 查看帮助
 | ------------------ | ------ | -------- |
 | 智能预警：创建/查询/启停/触发记录 | W10 | `references/operations/forewarning.md` |
 | TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |
-| 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts.md` |
-| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（索引）→ `operations/hosted-automation-*.md` |
+| 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |
+| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP） |
 
 ---
 
 ## Subagent 自主委派（可选）
 
-宿主具备 **Task / subagent** 时：复杂报告或批处理（**P5 / P6 / P7**）、预计 CLI 输出很长 → 先 Read `references/core/subagent-orchestration.md`，按决策矩阵决定是否委派；handoff 模板在 `snippets/handoff-p{5,6,7}-*.md`。**写操作确认、`--commit`、401/`resume` 策略与对用户的最终交付始终留在主 Agent**。无此能力则跳过，按工作流卡片在主会话执行。
+宿主具备 Task / subagent 时：复杂报告或批处理（**P5 / P6 / P7**）、预计 CLI 输出很长 → Read `references/core/subagent-orchestration.md`；handoff 在 `snippets/handoff-p{5,6,7}-*.md`。写操作确认、`--commit`、401/`resume` 与最终交付留在主 Agent。
 
 ---
 
 ## 职责划分
 
-| 由 **本 Skill + CLI** 保证 | 由 **宿主客户端 / 外部调度** 负责 |
-| -------------------------- | --------------------------------- |
-| 结构化字段拉取（`--json-out`） | 何时触发检查（cron、对话） |
-| 写命令语义与读命令复核文档 | IF 条件计算与决策 |
-| 金额、ID、字段口径一致 | 触达（钉钉/飞书）与工单 |
-| references 与命令对齐 | 批处理循环、限速、重试；**可选** subagent 并行 |
-
-详见 `references/operations/hosted-automation-self-control.md`、`references/operations/hosted-automation-monitoring-json.md`、`references/operations/hosted-automation-optimize-index.md`。
+| 本 Skill + CLI | 宿主 / 外部调度 |
+| -------------- | --------------- |
+| 结构化拉数（`--json-out`）、写命令语义、金额/ID 口径 | 触发时机、IF 决策、触达（钉钉/飞书）、批处理限速；可选 subagent 并行 |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.37-beta.13",
-  "publishedAt": 1784533653914
+  "version": "1.1.37-beta.15",
+  "publishedAt": 1784537343907
 }

package/dist/skill/assets/campaign-create-template.md

@@ -267,4 +267,4 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 | 否词误填                | `KeywordsForBatchJob` 含常见否词词根或与 `NegativeKeywordsForBatchJob` 重复 → **warnings**（不阻断，须 Agent 修正后再 create） |
 | 实务                    | 日期格式与先后、出价策略与配套字段一致                                                                                         |
 
-`ad campaign-validate` 通过不保证 BatchJob 成功（例如仅写 `DestinationUrl` 未写 `Finalurl` 时 validate 仍可能 ✅）。异步结果用 `ad batch get` 轮询；`HasFailed` / 部分失败时用 `ad batch diff` 对照 JSON 补缺，系列级失败时改 JSON 重提，勿在半成品上反复整包创建。**附加信息（Sitelink 等）batch 漏建时**：`batch diff` 后 **自动** `ad extension *` 补挂，勿仅询问用户（见 `references/google-ads/google-ads-campaign-plan.md` § batch diff 后自动补建）。写操作须 `--commit`，见 `references/google-ads/google-ads.md` § ad campaign-create。
+`ad campaign-validate` 通过不保证 BatchJob 成功（例如仅写 `DestinationUrl` 未写 `Finalurl` 时 validate 仍可能 ✅）。异步结果用 `ad batch get` 轮询；`HasFailed` / 部分失败时用 `ad batch diff` 对照 JSON 补缺，系列级失败时改 JSON 重提，勿在半成品上反复整包创建。**附加信息（Sitelink 等）batch 漏建时**：`batch diff` 后 **自动** `ad extension *` 补挂，勿仅询问用户（见 `references/google-ads/google-ads-campaign-plan.md` § batch diff 后自动补建）。写操作须 `--commit`，见 `references/google-ads/google-ads-write.md` § ad campaign-create。

package/dist/skill/references/README.md

@@ -1,25 +1,29 @@
 # References 索引
 
-> Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `references/core/playbooks.md`（P1–P9），操作/管理类在 `references/core/workflows.md`（W1–W12），命令参数在各域 reference。
+> **运行时**：按 `SKILL.md` 路由表直接 Read 列出的文件，**不要**为找路径加载本文件全文。改文档结构见 `skill-authoring.md`。
 
 ## 基础与纪律
 
 | 文件                                        | 用途                                                                                        |
 | ------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | `references/core/setup.md`                  | 安装、登录（手机验证码优先）、配置、更新                                                    |
-| `references/core/agent-conventions.md`      | **Agent 必读 · 唯一规则真相源**：加载纪律、数据处理协议、硬规范、时间/币种/批量、交付前自检 |
-| `references/core/user-communication-guide.md` | **用户回复风格**：结论先行、伙伴语气、自然语言路由；禁止机械贴 CLI/编号 |
-| `references/core/intent-routing.md`         | **报告 / 分析类统一消歧**：P1–P9 与 W3/W7 同义词、信号优先级、一次追问模板                  |
-| `references/core/tips.md`                   | `--json-out` 脚本食谱（node -e 示例、文件命名、分页）                                       |
-| `references/core/playbooks.md`              | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付）                        |
-| `references/core/workflows.md`              | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式）                                          |
-| `references/core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7）                                    |
+| `references/core/agent-conventions.md`      | 通用纪律 + §十四沟通 |
+| `references/core/user-communication-guide.md` | 重定向 → `agent-conventions.md` §十四 |
+| `references/core/intent-routing.md`         | 报告/分析/拓词话术消歧 |
+| `references/core/tips.md`                   | `--json-out` 脚本食谱 |
+| `references/core/playbooks.md`              | 分析/报告工作流（P1–P9） |
+| `references/core/workflows.md`              | 操作/管理工作流（W1–W12） |
+| `references/core/subagent-orchestration.md` | 可选：P5/P6/P7 委派 subagent |
+| `references/core/skill-authoring.md`        | 维护约定（运行时勿加载） |
 
 ## 账户与财务
 
 | 文件                                            | 用途                                                             |
 | ----------------------------------------------- | ---------------------------------------------------------------- |
-| `references/accounts/accounts.md`               | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
+| `references/accounts/accounts.md`               | **账户域索引**（按任务再读子文件）                               |
+| `references/accounts/accounts-list.md`          | list-accounts、激活账单、开户申请历史                            |
+| `references/accounts/accounts-balance-stats.md` | balance、**balance-scan（P2）**、stats、**accounts-digest（P3）** |
+| `references/accounts/accounts-permissions.md`   | 分享/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权                    |
 | `references/accounts/currency.md`               | CNY/USD 字段来源、符号、跨币种禁止求和                           |
 | `references/accounts/open-account-by-media.md`  | 各媒体开户命令与参数                                             |
 | `references/accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程                                     |
@@ -30,7 +34,10 @@
 
 | 文件                                                | 用途                                 |
 | --------------------------------------------------- | ------------------------------------ |
-| `references/google-ads/google-ads.md`               | Google Ads CRUD、batch、拒审字段     |
+| `references/google-ads/google-ads.md`               | **Google Ads 索引**（金额/ID Gotchas） |
+| `references/google-ads/google-ads-read.md`          | 系列/组/创意/关键词/搜索词/地理查询  |
+| `references/google-ads/google-ads-write.md`         | 创建/编辑/启停/扩展/PMax/设备出价    |
+| `references/google-ads/google-ads-batch.md`         | batch 流水线、ad batch、智投草稿     |
 | `references/google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |
 | `references/google-ads/pmax-api.md`                 | PMax 网关路径、金额口径              |
 | `references/analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词       |
@@ -77,9 +84,9 @@
 | `pmax-assets-update-template.json`      | PMax 素材更新                                             |
 | `pmax-patch-campaign-template.json`     | PMax 系列 patch                                           |
 
-## 报告模板纲要（`references/report-templates/`）
+## 报告模板纲要（`report-templates/`）
 
-> 安装包内与 `report-templates/*.md` 同源；HTML 样式在 `report-templates/*.html`。索引见 `references/report-templates/README.md`。
+> 安装包内与 `report-templates/*.md` 同源；HTML 样式在 `report-templates/*.html`。索引见 `report-templates/README.md`。
 
 | 文件                                                             | 适用场景                       |
 | ---------------------------------------------------------------- | ------------------------------ |

package/dist/skill/references/accounts/accounts-balance-stats.md

@@ -0,0 +1,166 @@
+# 余额、消耗与多账户汇总
+
+> 流程见 `playbooks.md` **P2** / **P3**；单户读数见 `workflows.md` **W1**。币种口径见 `currency.md`。
+
+## Contents
+
+- balance
+- balance-scan（P2）
+- accounts-digest（P3）
+- stats
+
+## balance-scan — 多账户余额续航扫描
+
+一键扫描某媒体下账户余额，筛出续航天数不足的账户。**P2 必用**；**禁止**外层循环逐户 `balance`。
+
+```bash
+siluzan-tso balance-scan -m <媒体类型> [选项]
+```
+
+| 选项 | 说明 | 默认 |
+| ---- | ---- | ---- |
+| `-m, --media <type>` | 必填：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai` | — |
+| `-a, --accounts <ids>` | 指定 `mediaCustomerId`（逗号分隔）；**跳过清单翻页**，拉取后全部输出（不按阈值过滤） | — |
+| `--threshold-days <n>` | 剩余续航天数阈值（按近 7 日日均消耗估算） | `7` |
+| `--min-balance <n>` | 绝对余额阈值（与 threshold 取并集） | — |
+| `--min-daily-spend <n>` | 日均消耗低于此值视为僵尸账户，不做续航估算 | `0.01` |
+| `--target-days <n>` | 建议充值目标续航天数 | `30` |
+| `--page-size <n>` / `--max-pages <n>` | 全量扫描分页（上限 500 / 200） | `200` / `20` |
+| `--json-out` | Agent 推荐落盘 | — |
+
+**示例：**
+
+```bash
+# 全量巡检（Playbook P2）
+siluzan-tso balance-scan -m Google --threshold-days 7 --json-out ./snap-p2
+
+# 已知子集
+siluzan-tso balance-scan -m BingV2 -a id1,id2,id3 --json-out ./snap-p2-subset
+
+# Meta 余额续航
+siluzan-tso balance-scan -m MetaAd --json-out ./snap-p2-meta
+```
+
+**读盘要点**：按 `remainingDays` 升序交付；`hitReason="none"` 表示未触阈值；用 **`dailySpend`** 做日均，勿把 `stats` 区间合计 `spend` 当「每天消耗」。与 `balance` / `accounts-digest` 分工见 `references/core/agent-conventions.md` §八。
+
+---
+
+## balance — 查询实时余额
+
+```bash
+siluzan-tso balance -m <媒体类型> -a <账户ID列表>
+```
+
+| 选项                   | 说明                                                                                                                                  |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `-m, --media <type>`   | 媒体类型（必填）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`（MetaAd 走 `GetMediaAccountInfo`，余额字段为 `spend_cap`） |
+| `-a, --accounts <ids>` | 账户 `mediaCustomerId`（数字 ID），多个用逗号分隔（必填）。**注意：不是 `entityId`**                                                  |
+| `--json-out`           | 输出原始 JSON；不支持或查询失败时 stdout 为 `{"ok":false,"error":"..."}`                                                              |
+
+**示例：**
+
+```bash
+# 查询单个 Google 账户余额（传 mediaCustomerId）
+siluzan-tso balance -m Google -a 6326027735
+
+# 查询多个 TikTok 账户余额
+siluzan-tso balance -m TikTok -a 1234567890,9876543210
+
+# 查询 Meta 广告账户余额
+siluzan-tso balance -m MetaAd -a <mediaCustomerId>
+
+# JSON 输出，供脚本使用
+siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
+```
+
+**单户余额与续航**：`balance` 只反映当前余额；判断「还能跑几天 / 是否够花」需结合 `stats`（或业务侧日均消耗）。多账户续航预警用 `balance-scan`（P2）、多账户投放画像用下文 `accounts-digest`（P3）。
+
+---
+
+## accounts-digest — 多账户投放画像汇总
+
+一条命令替代 AI 对每个账户循环 `list-accounts -k` + `stats`。**多账户汇总表、对比消耗、跨账户巡检** 应优先本命令，禁止外层 for-loop 逐户 `stats`。
+
+> **数据时效性**：与 `stats` / `balance-scan` 相同（Google `account-spend-overview` 分流；TikTok/Yandex/BingV2/Kwai/**MetaAd** 为截至昨天的 `accountsoverview`）。完整表见 `references/analytics/account-analytics.md` 顶部。
+
+```bash
+siluzan-tso accounts-digest -m <媒体类型> [选项]
+```
+
+| 选项                   | 说明                                                                                                          | 默认    |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------- | ------- |
+| `-m, --media <type>`   | 媒体类型（必填）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`                                    | —       |
+| `-a, --accounts <ids>` | 指定 `mediaCustomerId`，逗号分隔；**留空**则翻页拉该媒体全部账户                                              | —       |
+| `--start <YYYY-MM-DD>` | 统计开始日期（SKILL 要求 AI 先与用户确认区间）                                                                | 近 7 天 |
+| `--end <YYYY-MM-DD>`   | 统计结束日期                                                                                                  | 昨天    |
+| `--min-spend <n>`      | 过滤：区间内消耗 ≤ 此值的账户不返回                                                                           | `0`     |
+| `--page-size <n>`      | 全量扫描时清单分页大小（上限 500）                                                                            | `200`   |
+| `--max-pages <n>`      | 全量扫描时最多页数（上限 200）                                                                                | `20`    |
+| `--json-out`           | stdout 输出完整 JSON（）                                                                                      | —       |
+| `--json-out <path>`    | **Agent 推荐**：落盘目录或 `*.json` 文件；stdout 一行摘要（含 `outlineFile`、`writtenFiles`、`manifestFile`） | —       |
+
+**`--json-out` 落盘**：
+
+- 目录模式典型文件：`accounts-digest-<媒体小写>.json`、同 stem 的 `*.outline.txt`、`cli-manifest-<媒体小写>.json`（读盘协议见 `references/core/agent-conventions.md` §三）。
+- 响应结构：`{ ok, data: { items: [...] }, meta: { media, window, scanned, returned, source, totals, currencyNote, generatedAt } }`。
+- `meta.source`：`list` = 全量翻清单后拉数；`subset` = 传了 `-a`，跳过清单翻页（**`advertiserName` 会缺失**，公司名列显示 `-`）。
+
+**与 `stats` / `balance-scan` 的分工**见 `references/core/agent-conventions.md` §八 批量任务硬约束。
+
+**示例：**
+
+```bash
+# 指定账户子集（跳过清单翻页，Playbook P3）
+siluzan-tso accounts-digest -m Google -a 6326027735,4256317784 \
+  --start 2026-04-01 --end 2026-04-15 \
+  --json-out ./snap-p3
+
+# 扫描某媒体全部账户（内部翻页，勿先 list-accounts 再拼 -a）
+siluzan-tso accounts-digest -m BingV2 --start 2026-05-01 --end 2026-05-24 \
+  --json-out ./snap-digest-bing
+
+# 过滤低消耗账户
+siluzan-tso accounts-digest -m Google -a id1,id2 --min-spend 10 \
+  --start 2026-04-01 --end 2026-04-15 --json-out ./snap-p3
+```
+
+**`data.items[]` 主要字段**：`mediaCustomerId`、`name`、`advertiserName`、`currencyCode`、`balance`、`spend`（**区间合计**，同 `stats`）、`impressions`、`clicks`、`conversions`、`ctr`（%）、`cpc`、`cpa`。跨币种汇总见 `references/accounts/currency.md`（**禁止**对 `meta.totals` 跨币种直接当最终结论）。
+
+---
+
+## stats — 查询投放消耗数据
+
+> **数据时效性**：
+> - **Google**：走 `account-spend-overview`（2026-05 起），后端按日期窗口分流——
+>   - 窗口完全在历史 → `database` 模式：含余额、状态、币种、账户名、当期展点消等完整字段；
+>   - 窗口包含今天 → `googleCombined` 模式：只返回实时聚合的展点消（**没有**余额/状态/币种/账户名）。
+> - **TikTok / Yandex / BingV2 / Kwai**：走旧版 `accountsoverview`，每日凌晨同步昨天数据，**不能查今天**。判断这几家的「今天/当天/今日消耗」仍需走 `google-analysis(-batch) --sections overview`（仅 Google）。
+> - 完整时效性表见 `references/analytics/account-analytics.md` 顶部。
+
+```bash
+siluzan-tso stats -m <媒体类型> [选项]
+```
+
+| 选项                          | 说明                                                                          | 默认   |
+| ----------------------------- | ----------------------------------------------------------------------------- | ------ |
+| `-m, --media <type>`          | 媒体类型（必填）                                                              | —      |
+| `-a, --accounts <ids>`        | 账户 `mediaCustomerId`（数字 ID），逗号分隔（**必填**，接口不支持查全部账户） | —      |
+| `--start <YYYY-MM-DD>`        | 开始日期                                                                      | 7 天前 |
+| `--end <YYYY-MM-DD>`          | 结束日期                                                                      | 昨天   |
+| `--start-date` / `--end-date` | 与 `--start` / `--end` 同义（CLI 别名，与 SKILL Playbook 一致）               | —      |
+| `--by-day`                    | 按日明细（`items[]` 带 `date`）；按日 Excel 见 `stats-daily-excel.md`          | 关     |
+| `--json-out`                  | 输出原始 JSON；**失败时 stdout 仍为 JSON**（`{"ok":false,"error":"..."}`）    | —      |
+
+**口径（易错）**：默认 **`spend` = 区间合计**（非日消耗）。按日加 `--by-day`；单日可用 `start=end`；日均用 `spend/天数` 或 `balance-scan` 的 `dailySpend`。
+
+**示例：**
+
+```bash
+siluzan-tso stats -m Google -a <id>
+siluzan-tso stats -m Google -a <id> --start 2026-03-01 --end 2026-03-31
+siluzan-tso stats -m Yandex -a <id> --start <S> --end <E> --by-day --json-out ./snap/daily.json
+siluzan-tso stats -m BingV2 -a <id1>,<id2> --start 2026-03-01
+siluzan-tso stats -m Google -a <id> --json-out ./snap
+```
+
+---