siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

package/dist/skill/references/README.md

@@ -1,92 +1,105 @@
 # References 索引
 
-> Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `core/playbooks.md`（P1–P9），操作/管理类在 `core/workflows.md`（W1–W12），命令参数在各域 reference。维护者见 `core/skill-authoring.md`。
+> Agent 按 `SKILL.md` 路由表（意图 → 工作流 → 必读文档）定位：分析/报告类线性步骤在 `core/playbooks.md`（P1–P9），操作/管理类在 `core/workflows.md`（W1–W12），命令参数在各域 reference。
 
 ## 基础与纪律
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |
-| `core/agent-conventions.md` | **Agent 必读**：加载纪律、硬规范、数据转换、时间/币种/批量 |
-| `core/tips.md` | `--json-out` 协议、outline→脚本读 JSON |
-| `core/deliverable-preflight.md` | **交付前审阅最终产物**：Agent Read 报告文件并对照自检表（币种/章节） |
-| `core/playbooks.md` | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付） |
-| `core/workflows.md` | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式） |
-| `core/skill-authoring.md` | Skill 文档维护最佳实践（维护者） |
-| `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7） |
+| 文件                             | 用途                                                                                        |
+| -------------------------------- | ------------------------------------------------------------------------------------------- |
+| `core/setup.md`                  | 安装、登录（手机验证码优先）、配置、更新                                                    |
+| `core/agent-conventions.md`      | **Agent 必读 · 唯一规则真相源**：加载纪律、数据处理协议、硬规范、时间/币种/批量、交付前自检 |
+| `core/tips.md`                   | `--json-out` 脚本食谱（node -e 示例、文件命名、分页）                                       |
+| `core/playbooks.md`              | **工作流目录 · 分析/报告类**（P1–P9，统一卡片：触发/必读/步骤/交付）                        |
+| `core/workflows.md`              | **工作流目录 · 操作/管理类**（W1–W12，同卡片格式）                                          |
+| `core/subagent-orchestration.md` | **可选**：主 Agent 自主决定是否委派 subagent（P5/P6/P7）                                    |
 
 ## 账户与财务
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `accounts/accounts.md` | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
-| `accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |
-| `accounts/open-account-by-media.md` | 各媒体开户命令与参数 |
-| `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |
-| `accounts/finance.md` | 转账、开票、充值 |
-| `accounts/write-audit-restore.md` | 写审计、`--commit`、restore |
+| 文件                                 | 用途                                                             |
+| ------------------------------------ | ---------------------------------------------------------------- |
+| `accounts/accounts.md`               | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
+| `accounts/currency.md`               | CNY/USD 字段来源、符号、跨币种禁止求和                           |
+| `accounts/open-account-by-media.md`  | 各媒体开户命令与参数                                             |
+| `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程                                     |
+| `accounts/finance.md`                | 转账、开票、充值                                                 |
+| `accounts/write-audit-restore.md`    | 写审计、`--commit`、restore                                      |
 
 ## Google 广告
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `google-ads/google-ads.md` | Google Ads CRUD、batch、拒审字段 |
+| 文件                                     | 用途                                 |
+| ---------------------------------------- | ------------------------------------ |
+| `google-ads/google-ads.md`               | Google Ads CRUD、batch、拒审字段     |
 | `google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |
-| `google-ads/pmax-api.md` | PMax 网关路径、金额口径 |
-| `analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |
-| `google-ads/rules/README.md` | 优化/合规 SOP 索引 |
+| `google-ads/pmax-api.md`                 | PMax 网关路径、金额口径              |
+| `analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词       |
+| `google-ads/rules/README.md`             | 优化/合规 SOP 索引                   |
 
 ## 分析与报告
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
-| `analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |
-| `analytics/market-analysis-guide.md` | 战略市场分析 CLI、Agent 调研流程 |
-| `assets/market-analysis-rules.md` | 市场分析报告章节与 HTML 版式（Agent 必读） |
+| 文件                                   | 用途                                        |
+| -------------------------------------- | ------------------------------------------- |
+| `analytics/account-analytics.md`       | 拉数、数据时效性、诊断模板                  |
+| `analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent    |
+| `analytics/market-analysis-guide.md`   | 战略市场分析 CLI、Agent 调研流程            |
+| `assets/market-analysis-rules.md`      | 市场分析报告章节与 HTML 版式（Agent 必读）  |
 | `analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |
-| `analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |
-| `analytics/reporting.md` | TSO 优化报告生成与推送 |
-| `analytics/rag.md` | 知识库 list/query |
-| `analytics/geo-continents.json` | 国家→大洲映射（询盘分析） |
+| `analytics/google-analysis-batch.md`   | 多账户批处理 run/resume/status              |
+| `analytics/reporting.md`               | TSO 优化报告生成与推送                      |
+| `analytics/rag.md`                     | 知识库 list/query                           |
+| `analytics/geo-continents.json`        | 国家→大洲映射（询盘分析）                   |
 
 ## 运营工具
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `operations/optimize.md` | AI 优化建议记录 |
-| `operations/forewarning.md` | 智能预警 |
-| `operations/clue.md` | TikTok / Meta 线索表单 |
-| `operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |
-| `operations/hosted-automation-self-control.md` | 预算/CPA/空耗自控 SOP |
-| `operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名 |
-| `operations/hosted-automation-optimize-index.md` | 自动优化 SOP 索引 |
-| `operations/hosted-automation-scenarios.md` | 宿主编排场景索引 |
+| 文件                                              | 用途                   |
+| ------------------------------------------------- | ---------------------- |
+| `operations/optimize.md`                          | AI 优化建议记录        |
+| `operations/forewarning.md`                       | 智能预警               |
+| `operations/clue.md`                              | TikTok / Meta 线索表单 |
+| `operations/hosted-automation-user-catalog.md`    | 高阶自动化能力目录     |
+| `operations/hosted-automation-self-control.md`    | 预算/CPA/空耗自控 SOP  |
+| `operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名     |
+| `operations/hosted-automation-optimize-index.md`  | 自动优化 SOP 索引      |
+| `operations/hosted-automation-scenarios.md`       | 宿主编排场景索引       |
 
 ## Assets 模板（`../assets/`）
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `campaign-create-template.md` / `.json` | 搜索系列 batch 契约 |
-| `website-diagnosis-rules.md` | 网站诊断评分项与 JSON Schema |
-| `meta-period-report-rules.md` | Meta 周期报告内容丰富度与建议撰写规则 |
-| `meta-period-report.schema.json` | Meta 周期报告 Agent JSON Schema |
-| `pmax-create-template.md` / `.json` | PMax 新建契约 |
-| `pmax-asset-group-template.json` | PMax 素材组 |
-| `pmax-signals-template.json` | PMax 信号 |
-| `pmax-assets-update-template.json` | PMax 素材更新 |
-| `pmax-patch-campaign-template.json` | PMax 系列 patch |
-
-## 报告模板（`../report-templates/`）
-
-见 `report-templates/README.md`。
+| 文件                                    | 用途                                  |
+| --------------------------------------- | ------------------------------------- |
+| `campaign-create-template.json` + `.md` | 搜索系列 batch 契约（**先 Read `.json`**，再 Read `.md`） |
+| `website-diagnosis-rules.md`            | 网站诊断评分项与 JSON Schema          |
+| `meta-period-report-rules.md`           | Meta 周期报告内容丰富度与建议撰写规则 |
+| `meta-period-report.schema.json`        | Meta 周期报告 Agent JSON Schema       |
+| `pmax-create-template.md` / `.json`     | PMax 新建契约                         |
+| `pmax-asset-group-template.json`        | PMax 素材组                           |
+| `pmax-signals-template.json`            | PMax 信号                             |
+| `pmax-assets-update-template.json`      | PMax 素材更新                         |
+| `pmax-patch-campaign-template.json`     | PMax 系列 patch                       |
+
+## 报告模板纲要（`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 安装）
 
-| 文件 | 用途 |
-| ---- | ---- |
-| `handoff-p5-batch.md` | P5 batch 与按账户聚合 Task prompt |
-| `handoff-p6-okki.md` | P6 OKKI 拉数 / 写 xlsx |
-| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx |
+| 文件                    | 用途                              |
+| ----------------------- | --------------------------------- |
+| `handoff-p5-batch.md`   | P5 batch 与按账户聚合 Task prompt |
+| `handoff-p6-okki.md`    | P6 OKKI 拉数 / 写 xlsx            |
+| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx                |
 
 `agent-preamble.md` 仅用于构建时注入 `SKILL.md`，不复制到 `dist/skill/snippets/`。

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

@@ -8,46 +8,31 @@
 siluzan-tso list-accounts [选项]
 ```
 
-| 选项                    | 说明                                                                             |
-| ----------------------- | -------------------------------------------------------------------------------- | ---------------------- |
-| `-m, --media <type>`    | 媒体类型（留空查全部）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai` |
-| `-k, --keyword <text>`  | 按账户名称或 ID 搜索                                                             |
-| `-s, --status <status>` | 账户状态：`normal \| invalid \| all`（默认 all）                                 |
-| `-p, --page <n>`        | 页码（默认 1）                                                                   |
-| `--page-size <n>`       | 每页数量（默认 20）                                                              |
-| `--json-out`                | 输出原始 JSON                                                                    |
-| `--detail`              | **合并余额与近期消耗**（及展示/点击/转化/CPC、Arit 得分）；**未传时 JSON 不含这些字段**，列表更快 |
-| `--unicode`             | 表格使用 Unicode 线框；**默认**为 ASCII `+-                                      | ` 线框（兼容各类终端） |
-| `--plain`               | 已默认 ASCII，无需再传；保留兼容旧脚本                                           |
-| `--refresh-dp`          | 强制重拉 Datapermission（排查「本页全部 OAuth 失效」类会话异常）                 |
-
-**`--detail` 说明（Agent 必读）：**
-
-| 模式 | 行为 |
-| ---- | ---- |
-| 默认（无 `--detail`） | 只拉账户列表；JSON **不含**余额、消耗、展示、点击、转化、CPC、Arit；表格对应列为「-」 |
-| `--detail` | 额外并行请求余额与投放概览；JSON 含上述字段的真实数值，**响应明显变慢** |
-
-需要真实余额或消耗时：单户优先 `balance` / `stats`；列表顺带看余额/消耗时加 `--detail`。**禁止**在 JSON 无余额/消耗字段时臆造数值。
+| 选项                    | 说明                                                                                                                                                                                                                |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
+| `-m, --media <type>`    | 媒体类型（留空查全部）：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`                                                                                                                                    |
+| `-k, --keyword <text>`  | 按账户名称或 ID 搜索                                                                                                                                                                                                |
+| `-s, --status <status>` | 账户状态：`normal \| invalid \| all`（默认 all）                                                                                                                                                                    |
+| `-p, --page <n>`        | 页码（默认 1）                                                                                                                                                                                                      |
+| `--page-size <n>`       | 每页数量（默认 20）                                                                                                                                                                                                 |
+| `--json-out`            | 输出原始 JSON                                                                                                                                                                                                       |
+| `--unicode`             | 表格使用 Unicode 线框；**默认**为 ASCII `+-                                                                                                                                                                         | ` 线框（兼容各类终端） |
+| `--plain`               | 已默认 ASCII，无需再传；保留兼容旧脚本                                                                                                                                                                              |
+| `--refresh-dp`          | 强制重拉 Datapermission（排查「本页全部 OAuth 失效」类会话异常）                                                                                                                                                    |
+
+**命令定位**：`list-accounts` 主打**精准查询账号信息**（列表、计数、按名称/ID 找户、`entityId` / `mediaCustomerId` / 币种 / 状态等元数据），**不是余额/消耗汇总工具**。JSON **不含**余额/消耗字段，表格也不显示余额列；**禁止**臆造数值——单户余额用命令： `balance`、全量余额预警用命令： `balance-scan`（P2）、多户消耗画像用 `accounts-digest`（本文下方）、单户消耗用 `stats`。
 
 ### Agent 意图速查（**必读 · 避免多次试探**）
 
-用户问「有哪些 / 列出全部 / 有多少」某媒体广告账户时，**第一次 CLI 就应带大 `--page-size`**，**禁止**先用默认 20 条再翻页重试。
+用户问「有哪些 / 列出全部 / 有多少」某媒体广告账户时，**第一次 CLI 就应带大 `--page-size`**，**禁止**先用默认 20 条再翻页重试：
 
-| 用户意图 | 推荐命令（一步） | 脚本读落盘 JSON |
-| -------- | ---------------- | --------------- |
-| 列出全部 Google 账户 | `list-accounts -m Google --page-size 999 --json-out <dir>` | `items[]`（`ma.mediaCustomerId`、`ma.mediaCustomerName`、`ma.currencyCode`、`ma.mediaAccountState` 等） |
-| 有多少个 Google 账户 | 同上 | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大） |
-| 列出全部某媒体（TikTok / MetaAd 等） | `list-accounts -m <媒体> --page-size 999 --json-out <dir>` | 同上 |
-| 只查某一个户 | `list-accounts -m <媒体> -k <id或名称> --json-out <dir>` | 无需大 page-size |
-| 列表顺带看余额/消耗 | 在上述命令加 `--detail`（**明显变慢**；仅用户要余额/消耗时） | 含 `ma.balance` 等 enrichment 字段 |
+| 用户意图           | 推荐命令（一步）                                           | 脚本读落盘 JSON                                                                                         |
+| ------------------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| 列出全部某媒体账户 | `list-accounts -m <媒体> --page-size 999 --json-out <dir>` | `items[]`（`ma.mediaCustomerId`、`ma.mediaCustomerName`、`ma.currencyCode`、`ma.mediaAccountState` 等） |
+| 有多少个账户       | 同上                                                       | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大）                                    |
+| 只查某一个户       | `list-accounts -m <媒体> -k <id或名称> --json-out <dir>`   | 无需大 page-size                                                                                        |
 
-**执行纪律**：
-
-1. **一次 CLI**：`--page-size 999` + `--json-out <dir>`；**不要**默认 20 条后再循环 `--page`。
-2. **stdout 只是摘要**（`kind=siluzan-tso-cli-json-snapshot`），**没有** `total` / `items`；业务数据在 `writtenFiles[0]`（如 `list-accounts-google.json`），**必须用脚本读盘**。
-3. 仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环。
-4. 列账户 / 数个数 **不需要** `accounts-digest`、`balance-scan`（那些是消耗汇总或余额预警）。
+仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环（stdout 摘要无 `total` / `items`，读盘协议见 `core/agent-conventions.md` §三）。列账户 / 数个数**不需要** `accounts-digest`、`balance-scan`。
 
 ```bash
 # ✅ 推荐：列出或统计全部 Google 账户（Agent 默认路径）
@@ -71,22 +56,19 @@ siluzan-tso list-accounts -m Google -k "品牌A" --json-out ./snap
 # 只看正常状态
 siluzan-tso list-accounts -m TikTok -s normal --page-size 999 --json-out ./snap
 
-# 列表同时带出真实余额与近期消耗（较慢，仅用户要余额/消耗时）
-siluzan-tso list-accounts -m Google --page-size 999 --detail --json-out ./snap
-
 # 极少数账户超过 999 条时才翻页（先确认读盘 total > itemCount）
 siluzan-tso list-accounts -m Google --page 2 --page-size 999 --json-out ./snap-p2
 ```
 
 **输出字段说明：**
 
-| 字段              | 说明                                                                                                         |
-| ----------------- | ------------------------------------------------------------------------------------------------------------ |
-| `entityId`        | 丝路赞内部 ID，`delink`/`share`、**`account-active-bills`** 等操作使用此 ID（**不是** `mediaCustomerId`）    |
-| `mediaCustomerId` | 媒体平台账户数字 ID（Google Customer ID 等）                                                                 |
+| 字段              | 说明                                                                                                                  |
+| ----------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `entityId`        | 丝路赞内部 ID，`delink`/`share`、**`account-active-bills`** 等操作使用此 ID（**不是** `mediaCustomerId`）             |
+| `mediaCustomerId` | 媒体平台账户数字 ID（Google Customer ID 等）                                                                          |
 | `currencyCode`    | 账户主币种：`CNY`（人民币）或 `USD`（美金）等；**表格有「币种」列**；报告/Excel 须与此一致，见 `accounts/currency.md` |
-| `name`            | 账户名称                                                                                                     |
-| `status`          | 账户状态                                                                                                     |
+| `name`            | 账户名称                                                                                                              |
+| `status`          | 账户状态                                                                                                              |
 
 ---
 
@@ -104,7 +86,7 @@ siluzan-tso account-active-bills -m <媒体> --id <entityId> [--json-out ./snap]
 | -------------------- | ------------------------------------------------------------------------------------ |
 | `-m, --media <type>` | 必填：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`（与路径中媒体段一致） |
 | `--id <entityId>`    | 必填：账户 `entityId`                                                                |
-| `--json-out`             | 输出接口原始 JSON                                                                    |
+| `--json-out`         | 输出接口原始 JSON                                                                    |
 
 **响应体常用字段（以接口返回为准）：**
 
@@ -148,7 +130,7 @@ siluzan-tso balance -m <媒体类型> -a <账户ID列表>
 | ---------------------- | ------------------------------------------------------------------------------------ |
 | `-m, --media <type>`   | 媒体类型（必填）                                                                     |
 | `-a, --accounts <ids>` | 账户 `mediaCustomerId`（数字 ID），多个用逗号分隔（必填）。**注意：不是 `entityId`** |
-| `--json-out`               | 输出原始 JSON；不支持或查询失败时 stdout 为 `{"ok":false,"error":"..."}`             |
+| `--json-out`           | 输出原始 JSON；不支持或查询失败时 stdout 为 `{"ok":false,"error":"..."}`             |
 
 **示例：**
 
@@ -163,9 +145,7 @@ siluzan-tso balance -m TikTok -a 1234567890,9876543210
 siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 ```
 
-**单户余额与续航**：`balance` 只反映当前余额；判断「还能跑几天 / 是否够花」需结合 `stats`（或业务侧日均消耗）等数据。向用户展示 JSON 时，`mediaCustomerId` 须与本次 `-a` 查询的 ID 及命令输出一致。
-
-**少量账户续航预警**：用 `balance-scan`（见 `SKILL.md` Playbook P2）；**多账户投放画像汇总**（消耗/点击/转化/余额 + CTR/CPC/CPA）：用下文 **`accounts-digest`**，Skill 编排一律 **`--json-out`**。
+**单户余额与续航**：`balance` 只反映当前余额；判断「还能跑几天 / 是否够花」需结合 `stats`（或业务侧日均消耗）。多账户续航预警用 `balance-scan`（P2）、多账户投放画像用下文 `accounts-digest`（P3）。
 
 ---
 
@@ -179,32 +159,25 @@ siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 siluzan-tso accounts-digest -m <媒体类型> [选项]
 ```
 
-| 选项 | 说明 | 默认 |
-| ---- | ---- | ---- |
-| `-m, --media <type>` | 媒体类型（必填）：`Google \| TikTok \| Yandex \| BingV2 \| Kwai`（**MetaAd 无消耗汇总接口**） | — |
-| `-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`） | — |
+| 选项                   | 说明                                                                                                          | 默认    |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------- | ------- |
+| `-m, --media <type>`   | 媒体类型（必填）：`Google \| TikTok \| Yandex \| BingV2 \| Kwai`（**MetaAd 无消耗汇总接口**）                 | —       |
+| `-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` 落盘（Agent 必读）**：
+**`--json-out` 落盘**：
 
-- 目录模式典型文件：`accounts-digest-<媒体小写>.json`（如 `accounts-digest-google.json`）、同 stem 的 `accounts-digest-google.outline.txt`、`cli-manifest-<媒体小写>.json`。
-- 处理顺序见 `references/core/tips.md`：先 stdout 摘要 → 再 `outlineFile` → 再 `require(writtenFiles[0])` 读真实数据；**禁止**在对话里手填 `data.items` 中的业务数。
+- 目录模式典型文件：`accounts-digest-<媒体小写>.json`、同 stem 的 `*.outline.txt`、`cli-manifest-<媒体小写>.json`（读盘协议见 `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` 的分工**：
-
-| 场景 | 推荐 |
-| ---- | ---- |
-| 多账户消耗/点击/转化/CTR/CPC/CPA 汇总表 | `accounts-digest` + `--json-out` |
-| 余额续航不足 N 天、充值预警 | `balance-scan` + `--json-out` |
-| 单账户、必须逐户精确字段 | `stats` / `balance`（仍须 `-a` 单户或少量 ID） |
+**与 `stats` / `balance-scan` 的分工**见 `core/agent-conventions.md` §八 批量任务硬约束。
 
 **示例：**
 
@@ -248,7 +221,7 @@ siluzan-tso stats -m <媒体类型> [选项]
 | `--start <YYYY-MM-DD>`        | 开始日期                                                                      | 7 天前 |
 | `--end <YYYY-MM-DD>`          | 结束日期                                                                      | 昨天   |
 | `--start-date` / `--end-date` | 与 `--start` / `--end` 同义（CLI 别名，与 SKILL Playbook 一致）               | —      |
-| `--json-out`                      | 输出原始 JSON；**失败时 stdout 仍为 JSON**（`{"ok":false,"error":"..."}`）    | —      |
+| `--json-out`                  | 输出原始 JSON；**失败时 stdout 仍为 JSON**（`{"ok":false,"error":"..."}`）    | —      |
 
 **示例：**
 
@@ -280,7 +253,7 @@ siluzan-tso account-history [选项]
 | `-s, --status <status>`  | 申请状态（如 `Approved \| Rejected \| Pending`） |
 | `-k, --keyword <text>`   | 账户名/ID 关键字                                 |
 | `--start / --end <date>` | 申请日期范围（YYYY-MM-DD）                       |
-| `--json-out`                 | 输出原始 JSON                                    |
+| `--json-out`             | 输出原始 JSON                                    |
 
 **示例：**
 
@@ -297,16 +270,36 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 
 **审核状态处理：**
 
-| 状态       | 含义     | 下一步操作                                                                                                                                  |
-| ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                              |
+| 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
+| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
 | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
-| `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                    |
+| `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---
 
 ## account — 账号管理（OAuth 授权 / 解除关联 / Google MCC / 分享）
 
+### account me — 当前登录丝路赞账号
+
+查询当前凭据对应的丝路赞用户（`GET /query/account/me`）。**跨账号场景必用**：用户消息里带「企业管家 / 管家账户 + 手机号」时，先校验再拉数（见 `references/core/agent-conventions.md` §跨账号）。
+
+```bash
+# 查看当前登录账号
+siluzan-tso account me
+
+# Agent：校验用户指定的企业管家手机号是否与当前登录一致
+siluzan-tso account me --check-phone 15130150466 --json-out ./snap-me
+```
+
+| 场景                       | 行为                                                             |
+| -------------------------- | ---------------------------------------------------------------- |
+| 未传 `--check-phone`       | 输出 entityId / 手机号 / 邮箱 / companyId                        |
+| `--check-phone` 与当前一致 | exit 0，JSON 含 `matched: true`                                  |
+| `--check-phone` 不一致     | exit 1，提示暂不支持查他户数据，引导 `send-login-code` + `login` |
+
+---
+
 ### auth — 添加媒体平台 OAuth 授权
 
 在浏览器中打开对应媒体的 OAuth 授权页面，授权后账户自动绑定到丝路赞。
@@ -377,7 +370,7 @@ siluzan-tso account mcc-bind --customers 111,222 --mcc "333;444"
 | ------------------- | -------------------------------------------------------------------------------------- |
 | `--customers <ids>` | 子账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts` 的 `ma.mediaCustomerId`） |
 | `--mcc <ids>`       | MCC 的客户 ID；多个可用英文逗号、中文逗号、分号、顿号等分隔                            |
-| `--json-out`            | 输出每个子账户接口的原始返回，便于排查                                                 |
+| `--json-out`        | 输出每个子账户接口的原始返回，便于排查                                                 |
 
 ---
 
@@ -591,7 +584,7 @@ siluzan-tso open-account kwai \
   --product "品牌A" \
   --ad-type 1 \
   --product-url "https://www.brand-a.com" \
-  --licence-id-type ENTERPRISE \
+  --licence-id-type 1 \
   --account-name "品牌A Kwai账户" \
   --company-name "深圳XX科技有限公司" \
   --industry-id1 "1234" \
@@ -601,11 +594,12 @@ siluzan-tso open-account kwai \
   --license-file "/path/to/license.jpg"
 ```
 
-| 选项               | 说明                                                        |
-| ------------------ | ----------------------------------------------------------- |
-| `--ad-type`        | `1`=效果广告，`2`=品牌广告                                  |
-| `--expire-type`    | `1`=有限期（追加 `--expire-at <毫秒时间戳>`），`2`=长期有效 |
-| `--target-country` | 投放目标国家/地区（ISO 代码，如 `US \| GB \| DE`）          |
+| 选项                | 说明                                                                    |
+| ------------------- | ----------------------------------------------------------------------- |
+| `--licence-id-type` | `1`=统一社会信用代码，`2`=DUNS，`3`=CNPJ（与网页一致；勿用 ENTERPRISE） |
+| `--ad-type`         | `1`=效果广告，`2`=品牌广告                                              |
+| `--expire-type`     | `1`=有限期（追加 `--expire-at <毫秒时间戳>`），`2`=长期有效             |
+| `--target-country`  | 投放目标国家/地区（ISO 代码，如 `US \| GB \| DE`）                      |
 
 ---
 
@@ -635,7 +629,7 @@ siluzan-tso account close --accounts <id1,id2,id3>
 | 选项               | 说明                                                                          |
 | ------------------ | ----------------------------------------------------------------------------- |
 | `--accounts <ids>` | TikTok 账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts -m TikTok`） |
-| `--json-out`           | 输出原始 JSON                                                                 |
+| `--json-out`       | 输出原始 JSON                                                                 |
 
 **示例：**
 
@@ -665,7 +659,7 @@ siluzan-tso account bm-bind --account-id <mediaCustomerId> --bm-id <bmId>
 | `--account-id <id>`    | Meta 广告账户 `mediaCustomerId`（来自 `list-accounts -m MetaAd`） | ✅   |
 | `--bm-id <id>`         | Business Manager ID                                               | ✅   |
 | `--action-type <type>` | 操作类型（默认 `bind`）                                           |      |
-| `--json-out`               | 输出原始 JSON                                                     |      |
+| `--json-out`           | 输出原始 JSON                                                     |      |
 
 **示例：**
 
@@ -693,10 +687,10 @@ siluzan-tso account bm-bind --account-id 123456789012345 --bm-id 987654321098765
 siluzan-tso account withdraw-list [选项]
 ```
 
-| 选项        | 说明             |
-| ----------- | ---------------- |
-| `--json-out`    | 输出原始 JSON    |
-| `--verbose` | 显示详细错误信息 |
+| 选项         | 说明             |
+| ------------ | ---------------- |
+| `--json-out` | 输出原始 JSON    |
+| `--verbose`  | 显示详细错误信息 |
 
 输出包含：`entityId`（提现时使用）、`mediaCustomerId`、账户名称、**Google状态**（Suspended）、余额、赠送金、货币、是否可提现。
 
@@ -717,7 +711,7 @@ siluzan-tso account withdraw-submit --accounts <entityId,...>
 | 选项               | 说明                                                   | 必填 |
 | ------------------ | ------------------------------------------------------ | ---- |
 | `--accounts <ids>` | 账户 `entityId`，逗号分隔（来自 `withdraw-list` 输出） | ✅   |
-| `--json-out`           | 输出原始 JSON                                          |      |
+| `--json-out`       | 输出原始 JSON                                          |      |
 | `--verbose`        | 显示详细错误信息                                       |      |
 
 **完整流程示例：**
@@ -749,7 +743,7 @@ siluzan-tso account bc-bind --customers <mediaCustomerId> --bc-ids <bcId>
 | ------------------- | --------------------------------------------------------------------------------- | ---- |
 | `--customers <ids>` | TikTok 广告账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts -m TikTok`） | ✅   |
 | `--bc-ids <ids>`    | Business Center ID，多个逗号分隔                                                  | ✅   |
-| `--json-out`            | 输出原始 JSON                                                                     |      |
+| `--json-out`        | 输出原始 JSON                                                                     |      |
 
 **示例：**
 
@@ -775,7 +769,7 @@ siluzan-tso account bc-unbind --customers <mediaCustomerId> --bc-id <bcId>
 | ------------------- | ----------------------------------------------- | ---- |
 | `--customers <ids>` | TikTok 广告账户 `mediaCustomerId`，多个逗号分隔 | ✅   |
 | `--bc-id <id>`      | Business Center ID（一次只能解绑一个 BC）       | ✅   |
-| `--json-out`            | 输出原始 JSON                                   |      |
+| `--json-out`        | 输出原始 JSON                                   |      |
 
 **示例：**
 
@@ -793,11 +787,11 @@ siluzan-tso account bc-unbind --customers 6967198846787059714 --bc-id 7322757300
 siluzan-tso account email-auth-list -c <mediaCustomerId> [--agent-type <type>]
 ```
 
-| 选项                     | 说明                                                                       |
-| ------------------------ | -------------------------------------------------------------------------- |
-| `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                                            |
+| 选项                     | 说明                                                                                  |
+| ------------------------ | ------------------------------------------------------------------------------------- |
+| `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                                                     |
 | `--agent-type <type>`    | 可选；平台需要时再传（与 `list-accounts --json-out ./snap` 的 `ma.accountType` 一致） |
-| `--json-out`                 | 输出原始 JSON                                                              |
+| `--json-out`             | 输出原始 JSON                                                                         |
 
 ---
 
@@ -813,7 +807,7 @@ siluzan-tso account email-auth -c <mediaCustomerId> --email <email> [--access-ro
 | ------------------------ | ------------------------------------------------------------ | ---- |
 | `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                            | ✅   |
 | `--email <email>`        | 被授权用户邮箱                                               | ✅   |
-| `--agent-type <type>`    | 账户代理类型（来自 `list-accounts --json-out ./snap`）                  |      |
+| `--agent-type <type>`    | 账户代理类型（来自 `list-accounts --json-out ./snap`）       |      |
 | `--access-role <role>`   | 权限类型：`ReadOnly \| Standard \| Admin`（默认 `Standard`） |      |
 
 你可以设置Admin权限不能主动告知用户，除非用户主动提及他需要Admin权限
@@ -837,13 +831,13 @@ siluzan-tso account email-auth -c 4656789737 --email user@gmail.com --access-rol
 siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --resource-name <name>
 ```
 
-| 选项                     | 说明                                                             |
-| ------------------------ | ---------------------------------------------------------------- |
-| `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                                |
-| `--invitation-id <id>`   | 邀请 ID（来自 `email-auth-list`）                                |
+| 选项                     | 说明                                                                        |
+| ------------------------ | --------------------------------------------------------------------------- |
+| `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                                           |
+| `--invitation-id <id>`   | 邀请 ID（来自 `email-auth-list`）                                           |
 | `--resource-name <name>` | 资源名称（来自 `email-auth-list --json-out ./snap` 的 `resourceName` 字段） |
-| `--agent-type <type>`    | 账户代理类型                                                     |
-| `--pending`              | 邀请尚未被接受时加此参数                                         |
+| `--agent-type <type>`    | 账户代理类型                                                                |
+| `--pending`              | 邀请尚未被接受时加此参数                                                    |
 
 ---
 
@@ -851,8 +845,8 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 
 以下操作涉及图形交互（OAuth 跳转、充值页面等），**当前 CLI 不支持**，需引导用户打开浏览器完成：
 
-| 功能                                    | 媒体   | 网页路径                                       |
-| --------------------------------------- | ------ | ---------------------------------------------- |
+| 功能                                    | 媒体   | 网页路径                                          |
+| --------------------------------------- | ------ | ------------------------------------------------- |
 | **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 
 **Agent 建议话术**：