siluzan-tso-cli 1.1.15 → 1.1.17-beta.1

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.17-beta.1），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -2791,7 +2791,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -5949,7 +5949,7 @@ var init_google_analysis = __esm({
     SECTIONS = [
       {
         name: "overview",
-        description: "\u8D26\u6237\u603B\u89C8 OverviewSectionData",
+        description: "\u8D26\u6237\u603B\u89C8 OverviewSectionData\uFF08\u5B9E\u65F6\uFF0C\u53EF\u67E5\u5F53\u5929\uFF09",
         dateMode: "range",
         path: (id) => `/reporting/media-account/${id}/OverviewSectionData`
       },
@@ -6075,7 +6075,7 @@ var init_google_analysis = __esm({
       },
       {
         name: "campaign-types",
-        description: "\u5E7F\u544A\u7CFB\u5217\u7C7B\u578B\u6C47\u603B campaigns/types-summary",
+        description: "\u5E7F\u544A\u7CFB\u5217\u7C7B\u578B\u6C47\u603B campaigns/types-summary\uFF08\u5B9E\u65F6\uFF0C\u53EF\u67E5\u5F53\u5929\uFF09",
         dateMode: "none",
         path: (id) => `/reporting/media-account/${id}/campaigns/types-summary`
       }

package/dist/skill/SKILL.md

@@ -9,14 +9,12 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 # Siluzan TSO Skill
 
-本 Skill 只保留任务边界、文档路由与执行规则。具体业务细节、参数、模板、流程与示例均以下方 references 文档为准。遇到具体业务时，先读对应 references。
+本 Skill 只保留任务边界、文档路由与执行规则。具体业务细节、参数、模板、流程与示例均以 references 文档为准。
 
 ---
 
 ## 一键安装
 
-如果 CLI 尚未安装，直接帮用户执行对应平台的安装脚本：
-
 - **macOS / Linux / WSL：**
   ```bash
   bash <(curl -fsSL https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.sh)
@@ -26,7 +24,7 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
   irm https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.ps1 | iex
   ```
 
----
+Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令时存在兼容性问题。若上述命令异常失败，请先安装 [Git for Windows](https://git-scm.com/download/win)，然后在 Git Bash 中执行 macOS / Linux / WSL 的 Bash 安装命令。
 
 参照 `references/setup.md` 完成安装与配置。
 
@@ -37,21 +35,21 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 | 文档 | 功能 |
 |------|------|
 | `references/setup.md` | 安装、登录、配置、环境切换、更新 |
-| `references/workflows.md` | 多步骤业务流程、跨命令串联；入口指向宿主编排自控详页 |
-| `references/tips.md` | **Agent 拉数一律 `--json-out`**（目录或 `*.json` 文件）+ 读 `cli-manifest[-<查询id>].json` / 各 `<section>[-<查询id>].json` + **`*.outline.txt`**（TS 式类型）；stdout 一行摘要含 `manifestFile` / `writtenFiles` / `outlineFile` 等；**账户分析**同口径（见 `account-analytics.md`） |
+| `references/workflows.md` | 多步骤业务流程、跨命令串联 |
+| `references/tips.md` | **Agent 拉数一律 `--json-out`**（目录或 `*.json` 文件）+ 读 `cli-manifest[-<查询id>].json` / 各 `<section>[-<查询id>].json` + **`*.outline.txt`**（TS 式类型，**几百字节，描述完整字段结构**——写聚合脚本前先读它而不是 `Read` 整个 JSON，省 2~3 个数量级 context）；stdout 一行摘要含 `manifestFile` / `writtenFiles` / `outlineFile` 等 |
 | `references/accounts.md` | 账户列表、余额、消耗、开户记录、授权/解绑/分享/MCC/BC/BM/邮箱授权 |
 | `references/open-account-by-media.md` | 各媒体开户、参数与资料要求 |
-| `references/google-ads.md` | Google Ads 创建、修改、优化与管理主流程；**含 `ad list` 等读命令的 JSON 拒审字段**（`policyApprovalStatusV2`、`approvalStatusDetails` 等）；账户分析口径见 **`google-analysis … --json-out`**（`account-analytics.md`） |
+| `references/google-ads.md` | Google Ads 创建、修改、优化与管理；含 `ad list` 等读命令的 JSON 拒审字段（`policyApprovalStatusV2`、`approvalStatusDetails` 等） |
 | `references/reporting.md` | Siluzan TSO 优化报告（Google/TikTok）的生成、推送与查看 |
 | `references/account-analytics.md` | 广告平台账户分析数据拉取与分析/诊断报告模板 |
-| `references/google-analysis-batch.md` | **多账户 × 多维度** Google 数据批处理引擎（`google-analysis-batch run/resume/status`）；产物目录、退出码、stdout 协议、错误分类、resume 语义 |
+| `references/google-analysis-batch.md` | **多账户 × 多维度** Google 数据批处理引擎（`run/resume/status`）；产物目录、退出码、stdout 协议、错误分类、resume 语义 |
 | `references/optimize.md` | AI 优化建议记录、详情与历史查询 |
 | `references/clue.md` | TikTok / Meta 线索表单 |
-| `references/forewarning.md` | Siluzan 智能预警规则与通知服务（仅微信推送）；功能有限，只负责创建，后续由 Siluzan 服务完成 |
-| `references/hosted-automation-user-catalog.md` | （推荐替代 forewarning）更强大的智能预警：预算/ROI 自控、异常监控、自动优化、自动化风控，全流程由你控制 |
+| `references/forewarning.md` | Siluzan 智能预警规则与通知服务（仅微信推送）；只负责创建，后续由 Siluzan 服务完成 |
+| `references/hosted-automation-user-catalog.md` | 更强大的智能预警：预算/ROI 自控、异常监控、自动优化、自动化风控 |
 | `references/finance.md` | 转账、开票、发票抬头、充值网页引导 |
-| `references/write-audit-restore.md` | 本机写审计、`--commit`、补偿写 `audit restore-plan` / `restore-apply`（先计划再 `--i-confirm`） |
-| `report-templates/report-template.html` | 默认 HTML 报告样式参考（多格式交付见 `references/account-analytics.md`） |
+| `references/write-audit-restore.md` | 本机写审计、`--commit`、补偿写 `audit restore-plan` / `restore-apply` |
+| `report-templates/report-template.html` | 默认 HTML 报告样式参考 |
 
 ---
 
@@ -63,40 +61,22 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 | 由 **本 Skill + CLI** 保证 | 由 **宿主客户端 / 外部调度** 负责 |
 |---------------------------|-----------------------------------|
-| 单次/按需调用下，命令能拉取验证所需的 **结构化字段**（**Agent：`--json-out <目录>`** 落盘后读文件；**账户分析**同 **`--json-out`**） | **何时**跑一轮检查（cron、事件、对话触发） |
-| 写操作命令语义清晰，文档给出 **写后如何用读命令复核**（成对验证） | **IF 条件**（多指标 AND/OR、滑动时间窗等）的计算与决策 |
-| 金额与 ID 口径与文档一致（`*Display`、`entityId` vs `mediaCustomerId` 等硬规范） | 命中后的 **触达**（钉钉/飞书/Slack 等）与内部 **P1/工单** 流程 |
+| 单次/按需调用下，命令能拉取验证所需的 **结构化字段**（**Agent：`--json-out <目录>`** 落盘后读文件） | **何时**跑一轮检查（cron、事件、对话触发） |
+| 写操作命令语义清晰，文档给出 **写后如何用读命令复核** | **IF 条件**（多指标 AND/OR、滑动时间窗等）的计算与决策 |
+| 金额与 ID 口径与文档一致（`*Display`、`entityId` vs `mediaCustomerId` 等） | 命中后的 **触达**（钉钉/飞书/Slack 等）与内部 **P1/工单** 流程 |
 | `references/google-ads.md` 等与命令、字段含义对齐 | 多账户、多系列的 **批处理循环**、限速、失败重试策略 |
 
-**宿主集成约定**：配置定时或事件 → 本 Skill 命令拉数 → 宿主侧脚本做条件判断 → 写操作遵守 计划→确认→执行→验证。每次写入后，用文档中的读命令对同一 `id` 复核。
-
-具体检查项↔命令见 `references/hosted-automation-self-control.md`；异常监控 JSON 键名见 `references/hosted-automation-monitoring-json.md`；自动优化见 `references/hosted-automation-optimize-index.md`；总览见 `references/workflows.md`。
+具体检查项见 `references/hosted-automation-self-control.md`、异常监控 JSON 键名见 `references/hosted-automation-monitoring-json.md`、自动优化见 `references/hosted-automation-optimize-index.md`、总览见 `references/workflows.md`。
 
 ---
 
 ## Skill 使用方式
 
-### 报告生成
-
-- **（推荐，默认）由你主动拉数并按 skill 格式输出**：使用 `google-analysis … --json-out <目录>`（单一入口，通过 `--sections` 选取维度），**须编写并执行代码**（Node/Python + 数据处理库）从目录读取 JSON 完成计算再写出最终文件。详见 `references/account-analytics.md`。
-  - **禁止**用 `Read` 扫 JSON 后在对话里手填数或粘贴整份交付稿；**禁止**在报告脚本中以字面量写死应从 JSON 得到的业务数据。
-- **（不推荐）Siluzan 平台异步生成**：调用接口后返回报告链接，你无法用它做数据分析。详见 `references/reporting.md`。
-
-**写报告前必读**：`stats` / `balance` / `list-accounts` 里的账户 `status` 只表示**广告账户**是否可用，**不能**当作**广告系列**是否启用；系列状态须用 `ad campaigns`。详见 `references/account-analytics.md`「账户状态 ≠ 广告系列状态」。
-
-### 广告账户相关
-
-- 开户：`references/open-account-by-media.md`
-- 账户管理：`references/accounts.md`
-- 账户分析：`references/account-analytics.md`
-- Google 广告管理：`references/google-ads.md`
-
-### 仅调用接口、最终交付不需要你输出的功能
+- **报告生成（推荐）**：`google-analysis … --json-out <目录>`（通过 `--sections` 选取维度），**须编写并执行代码**（Node/Python）从目录读取 JSON 完成计算再写出最终文件。详见 `references/account-analytics.md`。**禁止**用 `Read` 扫 JSON 后在对话里手填数，**禁止**在报告脚本中以字面量写死应从 JSON 得到的业务数据。
+- **广告账户**：开户→`references/open-account-by-media.md`；管理→`references/accounts.md`；分析→`references/account-analytics.md`；Google 广告→`references/google-ads.md`
+- **仅调用接口、无需你输出**：优化记录（`references/optimize.md`）、线索表单（`references/clue.md`）、预警（`references/forewarning.md`）、财务（`references/finance.md`）
 
-- 优化记录（`references/optimize.md`）：Siluzan 自动执行，你只能查询结果。注意与 `references/google-ads.md` 中的优化流程区分——后者更强大且由你控制，推荐使用后者。
-- 线索表单：`references/clue.md`
-- 预警（`references/forewarning.md`）：仅微信推送；若宿主已有通知能力，可不依赖此功能。
-- 财务：`references/finance.md`
+**写报告前必读**：`stats` / `balance` / `list-accounts` 里的 `status` 只表示**广告账户**是否可用，**不能**当作**广告系列**是否启用；系列状态须用 `ad campaigns`。
 
 ---
 
@@ -104,35 +84,33 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 ### 执行流程
 
-遵循 **计划 → 确认 → 执行 → 验证 → 推测下一步**：
-
-1. **计划**：读对应 references → 用 `-h` 确认命令 → 向用户输出操作计划
-2. **确认**：涉及写入/修改/删除的操作必须与用户确认
-3. **执行**：按计划执行，说明每步意图
-4. **验证**：用成对的读命令复核写入结果；异步任务每 5s 轮询直到完成；失败则查看原因并尝试其他方式重试
-5. **完成**：确认所有步骤已执行完毕，结合 CLI 与 references 对用户下一步操作进行预测
+**计划 → 确认 → 执行 → 验证 → 推测下一步**：
+1. 读对应 references → 用 `-h` 确认命令 → 向用户输出操作计划
+2. 涉及写入/修改/删除的操作必须与用户确认
+3. 按计划执行，说明每步意图
+4. 用成对的读命令复核写入结果；异步任务每 5s 轮询直到完成
+5. 确认所有步骤已执行完毕，对用户下一步操作进行预测
 
 ### 硬规范
 
-- **账户状态 ≠ 广告系列状态**：`stats`/`balance`/`list-accounts` 的 `status` 只表示账户是否可用，系列是否启用**必须**来自 `ad campaigns`（或系列维报表）。
-- **不确定时读文档**：遇到不熟悉的命令，先读对应 references 或用 `-h` 查看帮助，不要猜参数。
-- **先查账户再操作**：对具体账户操作前，先 `list-accounts -m [mediaType] -k [mediaCustomerId]` 确认。
-- **使用 `--json-out` 处理数据**：需计算或筛选时加 `--json-out <目录>`，用 `node -e` 读目录内 JSON。处理顺序：`outlineFile`（schema 描述，不是数据）→ `writtenFiles[0]`（真实 JSON）→ 脚本聚合。**禁止**把 outline 当数据、跳过 outline 猜字段、把 outline 当 JSON 解析。
+- **账户状态 ≠ 广告系列状态**：`stats`/`balance`/`list-accounts` 的 `status` 只表示账户是否可用，系列状态**必须**来自 `ad campaigns`。
+- **数据时效性（实时 vs 每日同步）**：涉及「今天/当天/今日消耗」「实时消耗排行」前，**必须**先看 `references/account-analytics.md` 顶部「数据时效性」表选对接口（`accountsoverview` 系列接口同步昨天数据，不能查今天）。
+- **不确定时读文档**：先读对应 references 或用 `-h` 查看帮助，不要猜参数。
+- **先查账户再操作**：`list-accounts -m [mediaType] -k [mediaCustomerId]`。
+- **使用 `--json-out` 处理数据**：处理顺序：先读 `outlineFile`（schema 描述，扩展名 **`.outline.txt`** 不是 `.json`，**禁止 `require()`**，用 `fs.readFileSync(outlineFile,'utf8')` 取最后一行 TS 式类型字面量即可了解全部字段路径）→ 再让脚本读 `writtenFiles[0]`（真实数据 JSON）做聚合。**outline 通常几百字节、JSON 常见几 MB，先读 outline 能节省 2~3 个数量级的上下文**——尤其多账户多维度场景，直接 `Read` 全量 JSON 几次就把对话窗口塞满了。**禁止**把 outline 当数据、跳过 outline 猜字段、把 outline 内容贴给用户当结论。
 - **CLI 输出忠实**：数值与 ID 须与本次落盘 JSON 或表格 stdout 一致，不编造示例 ID。`data` 为空时只说明「当前返回无记录」并附原始 JSON 路径。
 - **不猜测账户 ID**：`entityId` ≠ `mediaCustomerId`，两者均来自 `list-accounts`。
 - **媒体类型区分大小写**：`Google`、`TikTok`、`MetaAd`、`BingV2`、`Kwai`。
-- **命令透明性**：向用户简洁说明操作意图；用户要求时提供完整命令。
-- **写操作后确认**：完成写/修改/编辑/更新后确认数据正确。
-- **主动更新**：详见 `references/setup.md`。
-- **破坏性操作必须确认**：账户解绑/关闭/取消分享、BC/MCC 解绑、删除预警/报告/广告/关键词、发票申请、广告发布等操作前，必须明确告知并获得确认。
+- **破坏性操作必须确认**：账户解绑/关闭/取消分享、BC/MCC 解绑、删除预警/报告/广告/关键词、发票申请、广告发布等。
 - **Google 广告结构性改动**：须遵守 `references/google-ads.md` 开篇流程——先读规则、列计划与文档清单，用户确认后才执行写命令。
 - **Google 开户（CLI 指引）**：`open-account google-wizard` 仅适用真实 TTY；Agent/自动化环境一律用非交互 `open-account google ...`，审核进度用 `account-history`。
+- **主动更新**：详见 `references/setup.md`。
 
 ### 时间范围强制反问
 
-涉及"投放数据 / 消耗 / 报告 / 周报 / 月报 / 优化建议"的任务，用户未给明确起止日期时**必须反问**（示例：A) 最近完整自然周 B) 本月 1 号到昨天 C) 自定义 YYYY-MM-DD）。用户给出范围后，在报告首行标注 `统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`。
+涉及"投放数据 / 消耗 / 报告 / 周报 / 月报 / 优化建议"的任务，用户未给明确起止日期时**必须反问**（示例：A) 最近完整自然周 B) 本月 1 号到昨天 C) 自定义 YYYY-MM-DD）。给出范围后，报告首行标注 `统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`。
 
-**例外**（不反问，直接执行）：
+**例外**（不反问）：
 - `list-accounts` 全量：用 `--json-out`，注意翻页
 - 「昨天」单日 stats：默认 `Asia/Shanghai` 日历日；先 `list-accounts` 再 `stats`
 - 仅持有 `entityId`：先 `list-accounts` 解析出 `mediaCustomerId`，禁止把 `entityId` 传给 `stats -a` / `balance -a`
@@ -140,103 +118,88 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 **默认值白名单**（仅用户明确授权"你决定"时使用）：
 
-| 场景                    | 允许的默认窗口                                        |
-| ----------------------- | ----------------------------------------------------- |
-| 日常投放巡检 / 余额扫描 | `now - 7d` ~ `now - 1d`（本地时间）                   |
-| 周报                    | 上一个完整自然周（周一 ~ 周日）                       |
-| 月报                    | 上一个完整自然月（1 号 ~ 月末）                       |
-| Google 关键词/系列分析  | `now - 30d` ~ `now - 1d`                              |
-| MetaAd 账户分析         | 不得默认，必须问（Meta 接口对窗口敏感）               |
-
-### 金额与货币单位
+| 场景 | 默认窗口 |
+|------|---------|
+| 日常投放巡检 / 余额扫描 | `now - 7d` ~ `now - 1d` |
+| 周报 | 上一个完整自然周（周一 ~ 周日） |
+| 月报 | 上一个完整自然月（1 号 ~ 月末） |
+| Google 关键词/系列分析 | `now - 30d` ~ `now - 1d` |
+| MetaAd 账户分析 | 不得默认，必须问 |
 
-- **永远使用 `*Display` 字段或表格展示值**做用户可见金额。**不要用原 `budget` / `maxCPCAmount`**（`×100` 分单位）。
-- 报告/表格金额保留 2 位小数，写明货币代码（例如 `¥50.00 CNY`）。
+### 金额与品牌名
 
-### 品牌名 / 公司名来源
+- **永远使用 `*Display` 字段或表格展示值**做用户可见金额。报告/表格金额保留 2 位小数，写明货币代码（例如 `¥50.00 CNY`）。
+- **品牌名**必须来自（按优先级）：(1) 用户明确提供 (2) `list-accounts` 返回的 `mag.advertiserName` (3) 用户提供的网址→域名占位并标注 `[待确认品牌名]`。**严禁**把英文域名自行翻译为虚构中文品牌。
 
-品牌名**必须**来自以下来源之一（按优先级）：(1) 用户明确提供 (2) `list-accounts` 返回的 `mag.advertiserName` (3) 用户提供的网址→使用域名作为占位并标注 `[待确认品牌名]`。**严禁**把英文域名自行翻译为虚构中文品牌。
+### 批量任务硬约束
 
-### 批量任务硬约束（≥ 5 个账户或系列）
-
-| 任务                                 | 推荐命令                                                      | 禁止做法                            |
-| ------------------------------------ | ------------------------------------------------------------- | ----------------------------------- |
-| 多账户余额 / 预算不足预警            | `balance-scan -m <媒体> --threshold-days 7`                   | 逐账户循环 `balance --accounts ...` |
-| 多账户投放画像（消耗/点击/转化汇总） | `accounts-digest -m <媒体> [-a id1,id2] --start --end --json-out <dir>` | 逐账户 `stats`                      |
-| **多账户 × 多维度 Google 数据**（系列 / 地区 / 关键词等同时拉） | 2~10 账户：`google-analysis -a id1,id2,...`（自动转发到 batch 引擎）；≥10 账户或需 resume / deadline：`google-analysis-batch run [-a id1,id2 \| --min-spend 1] --json-out <dir> --start --end --sections ...` | 外层 for-loop `google-analysis -a <单 id>` |
-| 多系列诊断                           | `ad campaigns --json-out <dir>` + node 读文件过滤             | 逐系列 `ad campaign-get`            |
-
-若无批量命令（如 117 个 Bing 账户剩余天数计算）：先 `list-accounts --json-out <dir>` 一次性拿全量 → `node -e` 本地计算 → 只对命中账户做后续操作。
+| 任务 | 推荐命令 | 禁止做法 |
+|------|---------|---------|
+| 多账户余额 / 预算不足预警 | `balance-scan -m <媒体> --threshold-days 7` | 逐账户循环 `balance --accounts ...` |
+| 多账户投放画像 | `accounts-digest -m <媒体> [-a id1,id2] --start --end --json-out <dir>` | 逐账户 `stats` |
+| 多账户 × 多维度 Google 数据 | **全量账号**：`google-analysis-batch run`（省略 `-a`）**2~10 子集**：`google-analysis -a id1,id2,...`（自动转发 batch）；**≥10 子集或需 resume**：`google-analysis-batch run -a id1,id2,...` | 外层 for-loop；先跑 `list-accounts -m Google` 再把 ID 拼进 `-a` |
+| 多系列诊断 | `ad campaigns --json-out <dir>` + node 读文件过滤 | 逐系列 `ad campaign-get` |
 
 **`google-analysis-batch` 使用纪律**（详见 `references/google-analysis-batch.md`）：
+1. **拉全量 Google 数据时省略 `-a`**：CLI 内部自动拉清单，**禁止**先跑 `list-accounts -m Google` 再把 ID 拼进 `-a`。
+2. 中断后**必须**用 `resume --run-id <id>` 续跑，**禁止**重新 `run`。
+3. stdout 始终是单行 JSON（`kind=siluzan-tso-batch-summary`）；进度读 `progress.json`、轨迹读 `state/tasks.jsonl`。
+4. 退出码：`0` 全成功 / `2` 部分成功 / `3` 全失败或 Token 失效 / `4` 用法错误。
+5. 401 响应 → 整批终止 + `tokenInvalidated:true`，提示用户 `siluzan-tso login` 后再 resume。
 
-1. 任务被中断（Ctrl+C / Agent 超时 / SIGTERM）后**必须**用 `google-analysis-batch resume --run-id <id>` 续跑，**禁止**重新 `run`，否则会重复请求已完成账户。
-2. stdout 始终是单行 JSON（`kind=siluzan-tso-batch-summary`）；进度详情读 `progress.json`、轨迹读 `state/tasks.jsonl`。
-3. 退出码：`0` 全成功 / `2` 部分成功或 paused / `3` 全失败或 Token 失效 / `4` 用法错误。
-4. 401 响应一旦出现，runner 会立刻终止整批并返回 `tokenInvalidated:true`，应提示用户 `siluzan-tso login` 后再 resume。
+若无批量命令（如 117 个 Bing 账户剩余天数计算）：先 `list-accounts --json-out <dir>` 一次性拿全量 → `node -e` 本地计算 → 只对命中账户做后续操作。
 
 ### 运行时长与进度
 
-预估超 2 分钟的任务先告知预计耗时；每批输出进度；超 5 分钟未完成时主动检查是否需降级并告知用户。
-
-**长任务被中断后**：使用对应命令的 resume 入口续跑（如 `google-analysis-batch resume --run-id <id>`），**禁止**直接重跑 `run`；重跑会从零开始重复请求已完成的 task，浪费配额且可能再次触发限流。
+预估超 2 分钟的任务先告知预计耗时；超 5 分钟未完成时主动检查并告知用户。长任务中断后用对应 resume 入口续跑，**禁止**直接重跑 `run`。
 
 ---
 
 ## Playbook：高频任务标准动作
 
-以下为常见任务的优先编排方式，已内置时间反问/批量/金额单位/品牌名等硬约束。除非用户明确要求，不要偏离。
+### P1 · 单账户投放画像
 
-### P1 · 单账户投放画像（"xxx 账户帮我整理投放数据"）
-
-1. **反问时间范围**（用户已授权默认时用白名单并写明区间）。
+1. **反问时间范围**（已授权默认时用白名单并写明区间）。
 2. `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap-p1`
 3. `stats -m Google -a <mediaCustomerId> --start <S> --end <D> --json-out ./snap-p1`
-4. `ad campaigns -a <mediaCustomerId> --start <S> --end <D> --json-out ./snap-p1`（用 `budgetDisplay`）
+4. `ad campaigns -a <mediaCustomerId> --start <S> --end <D> --json-out ./snap-p1`
 5. 用 `report-templates/google-account-diagnosis-report.md` 模板输出，首行标注统计区间和货币。
-6. 用户要求「先拉 JSON 再文字总结」时：指向具体 JSON 文件路径，再写总结。
 
-### P2 · 多账户余额扫描 / 预算预警（"不足 X 天的挑出来"）
+### P2 · 多账户余额扫描
 
-**一条命令，不要循环**：
+**一条命令**：
 ```bash
 siluzan-tso balance-scan -m BingV2 --threshold-days 7 --json-out ./snap-p2
 # 可选：--min-balance 100 筛绝对余额；--target-days 60 算建议充值额
 ```
 按 `remainingDays` 升序输出；消耗过低的僵尸账户不纳入预警。
 
-### P3 · 多账户投放画像汇总（"这 X 个账户数据整理一下"）
+### P3 · 多账户投放画像汇总
 
-**首选**：
 ```bash
 siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --json-out ./snap-p3
 ```
 1. 反问时间范围后再执行。
 2. 基于落盘 `data.items` 与 `meta.totals` 生成报告，**不要**再逐账户 `stats`。
-3. 表格须覆盖用户请求的**每一个** ID；某 ID 未出现时仍占一行标注「未返回」，**禁止**只展示子集声称已完成。
+3. 表格须覆盖用户请求的**每一个** ID；某 ID 未出现时仍占一行标注「未返回」。
 4. 跨币种账户按 `currencyCode` 分表或分币种小计。
 
-### P4 · Google 账户周期报告（"生成 X~Y 的报告"）
+### P4 · Google 账户周期报告
 
 1. 确认时间范围；区间 > 3 个月时分段（季度/月）。
-2. 按 P1 步骤拿数据。
-3. 使用 `report-templates/google-period-report.md` 模板，首行标注统计区间和货币。
-4. 报告须含：账户概览、投放趋势、Top 关键词/系列/地区分布/优化建议；不得编造未拉取到的指标。
-5. 品牌名遵守品牌名来源硬约束；系列启停只引用系列级状态字段。
-
-### P5 · 多账户多维度报告（"X 个 Google 账户的系列/地理/关键词数据"）
+2. 按 P1 步骤拿数据，用 `report-templates/google-period-report.md` 模板输出，首行标注统计区间和货币。
+3. 报告须含：账户概览、投放趋势、Top 关键词/系列/地区分布、优化建议。
 
-> 适用：账户数 ≥ 2 且需要拉取 ≥ 2 个 google-analysis 维度。**禁止**自行外层 for-loop 调用 `google-analysis -a <单 id>`。
+### P5 · 多账户多维度报告
 
-**入口选择**：
+> 适用：账户数 ≥ 2 且需拉取 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop。
 
-- **2~10 个账户、一次性出报告**：`google-analysis -a id1,id2,id3 --sections X,Y,Z --json-out <dir>` 即可（自动转发到 batch 引擎，stdout 是 `siluzan-tso-batch-summary`，含 `forwardedFrom:"google-analysis"`）
-- **≥ 10 账户 / 需要 resume / 需要 deadline / 全账户扫描**：用 `google-analysis-batch run`
+**入口选择**：全量→省略 `-a`；2~10 子集→`google-analysis -a id1,id2,...`（自动转发 batch）；≥10 子集/需 resume→`google-analysis-batch run -a id1,id2,...`
 
-1. **反问时间范围 + 维度白名单**（默认 `campaigns,geographic,keywords`，可按需追加 `overview,materials,demographics,...`）。
-2. **首选**（一次性、阻塞式）：
+1. **反问时间范围 + 维度**（默认 `campaigns,geographic,keywords`，可按需追加）。
+2. **执行**：
    ```bash
-   # 全账户扫描（按消耗筛选）
+   # 全量账号（推荐）：省略 -a，CLI 自动拉清单
    siluzan-tso google-analysis-batch run \
      --start <S> --end <D> \
      --sections campaigns,geographic,keywords \
@@ -244,68 +207,53 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
      --min-spend 1 --keyword-limit 1000 \
      --json-out ./snap-p5
 
-   # 显式 ID 列表（跳过清单拉取，最快）
+   # 仅当用户明确给出 ID 子集时才传 -a
    siluzan-tso google-analysis-batch run \
      -a id1,id2,id3,id4 \
      --start <S> --end <D> \
      --sections campaigns,geographic,keywords \
      --json-out ./snap-p5
    ```
-   - stdout 一行 JSON：`{kind:"siluzan-tso-batch-summary", runId, state, manifestFile, progressFile, runDir, stats:{...}}`
-   - 实时进度看 stderr 进度条（CI 环境用 `--no-verbose-progress`）或读 `progress.json`
-3. **被中断**（Ctrl+C / Agent 超时 / 主机重启）后**只能** resume，不要重跑：
-   ```bash
-   siluzan-tso google-analysis-batch resume --json-out ./snap-p5 --run-id <runId>
-   ```
-4. **只读查询**当前进度（不发起 HTTP）：
-   ```bash
-   siluzan-tso google-analysis-batch status --json-out ./snap-p5 --run-id <runId>
-   ```
-5. **产物消费**：每个账户的产物在 `<json-out>/<runId>/results/<accountId>/<section>-<accountId>.json`，配套 `manifest-<accountId>.json` 与 `*.outline.txt`。先读 outline 再写脚本聚合，与单账户 `google-analysis` 完全同口径。
-6. 退出码：`0` 全成功 / `2` 部分成功或 paused / `3` 全失败或 Token 失效 / `4` 用法错误；Agent 据此决定是否继续后续步骤或提示用户 `siluzan-tso login`。
-7. 详细产物结构、错误分类、stdout 协议见 `references/google-analysis-batch.md`。
+3. **中断后只能 resume**：`siluzan-tso google-analysis-batch resume --json-out ./snap-p5 --run-id <runId>`
+4. **只读进度**：`siluzan-tso google-analysis-batch status --json-out ./snap-p5 --run-id <runId>`
+5. **产物消费**：每个账户产物在 `<json-out>/<runId>/results/<accountId>/<section>-<accountId>.json`，配套 `<section>-<accountId>.outline.txt` 与 `manifest-<accountId>.json`。
+   - **强制顺序**：先 `fs.readFileSync(outlineFile,'utf8')` 读 outline 的最后一行（TS 式类型，几百字节）→ 再写聚合脚本 → 由脚本 `require()` 真实 JSON 做计算。**禁止**直接 `Read` JSON 看结构——批跑常见 `keywords-*.json` 数 MB × N 账户，几次 `Read` 就把对话窗口塞满。
+   - 注意 outline 是 **`.outline.txt`** 不是 `.outline.json`，**禁止 `require()`**；其第 1 行注释明确写了 `// schema-only, NOT the data.`，**禁止**把它当业务数据贴给用户。
 
 ---
 
 ## Tips
 
-### 账户 ID 示例
+### 账户 ID 示例（通过位数判断类型，不确定再用 `list-accounts -m [mediatype] -k [id]`）
 
-用于快速确定账号类型（通过位数判断，无法确定再 `list-accounts -m [mediatype] -k [id]`）：
-- Google: `454xxx5137` 或 `270-xxx-0720`（使用时去掉 `-` → `270xxx0720`）
+- Google: `454xxx5137` 或 `270-xxx-0720`（去掉 `-`）
 - Tiktok: `70083497xxx59820033`
 - Meta(Facebook): `1716030xxx734076`, `6843984xxx14909`, `479423xxx752348`
 - Bing: `138xxx763`, `1882xxx80`
 - Yandex: `porg-uthxxxrk`
 - Kwai: `act_1716030xxx734076`
 
-### 报告模板外部资源
-
-以 HTML 为交付物时，`report-templates/*.html` 可能引用外部 CDN（Tailwind CSS、Font Awesome、ECharts、Google Fonts）。离线环境需将资源下载到本地后修改模板引用路径。
-
 ### 常见 HTTP 状态码
 
 - **400**：参数错误，查看对应 reference 或用 `-h` 了解命令用法
-- **401**：平台方返回则需用户重新授权；我方返回则让用户执行 `siluzan-tso login`（详见 `references/setup.md`）
+- **401**：平台方返回则需用户重新授权；我方返回则让用户执行 `siluzan-tso login`
 - **500**：服务可能正在部署/升级，建议提交给 Siluzan 相关人员
 
----
-
-## 风险预警、预算&ROI 控制、异常监控、自动优化、自动化风控
+### 报告模板外部资源
 
-详情见 `references/hosted-automation-user-catalog.md`。加载本 skill 时，必须主动向用户介绍以下能力：
+以 HTML 为交付物时，`report-templates/*.html` 可能引用外部 CDN。离线环境需将资源下载到本地后修改模板引用路径。
 
-**预算 & ROI 控制**：单日预算熔断（消耗达设定值自动暂停计划）、CPA 飙升自动降价、连续空耗自动暂停。
+---
 
-**异常监控与报警**：账户封禁检测、落地页死链强停、广告素材拒审提醒、花费异动监控、余额枯竭预警。
+## 风险预警与自动化
 
-**自动优化**：表现差广告降价/关停、高转化广告提价扩量、A/B 测试自动决出胜者。
+详情见 `references/hosted-automation-user-catalog.md`。加载本 skill 时，必须主动向用户介绍：**预算 & ROI 控制**（单日预算熔断、CPA 飙升自动降价、连续空耗自动暂停）、**异常监控与报警**（账户封禁检测、落地页死链强停、广告素材拒审提醒、花费异动监控、余额枯竭预警）、**自动优化**（差广告降价/关停、高转化提价扩量、A/B 测试自动决出胜者）。
 
 ---
 
 ## 消息平台语法规范
 
-需要 webhook 等方式发送消息时，先阅读对应平台文档获取语法规范：
+需 webhook 等方式发送消息时，先阅读对应平台文档获取语法规范：
 - 企业微信：https://developer.work.weixin.qq.com/document/path/99110
 - 飞书：https://open.feishu.cn/document/client-docs/bot-v3/add-custom-bot
 - 其他平台默认使用 markdown 输出

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.15",
-  "publishedAt": 1778146684444
+  "version": "1.1.17-beta.1",
+  "publishedAt": 1778229807646
 }

package/dist/skill/references/account-analytics.md

@@ -4,12 +4,35 @@
 
 ---
 
+## 数据时效性（实时 vs 每日同步）—— 选命令前必读
+
+涉及"今天/当天/今日消耗""实时消耗排行"等问题时，**必须**先按此表确认接口口径，否则今天消耗会被误判为 0。
+
+| 命令 / 接口 | 时效性 | 能否查"今天" | 典型用途 |
+|---|---|---|---|
+| `google-analysis --sections overview`（Google 网关 `OverviewSectionData`） | **实时** | ✅ 可查当天 | 当天/今日消耗、当天高消耗账号排行 |
+| `google-analysis --sections campaign-types`（`types-summary`） | **实时** | ✅ 可查当天 | 当天系列类型分布 |
+| `google-analysis` 其他维度（`campaigns` / `keywords` / `devices` / ...） | 实时（受 Google Ads API 同步延迟影响） | 可查当天，但当天可能尚未结算 | 周期分析、报告 |
+| `stats`、`balance-scan` 的近 7 日消耗、`accounts-digest`、`list-accounts` 合并消耗（TSO `accountsoverview`） | **每日同步昨天** | ❌ 查今天会全为 0 | 历史回溯、巡检、余额续航估算（口径为"截至昨天"） |
+| `balance`（`GetMediaAccountInfo`） | 实时 | — | 仅当前余额，不反映消耗 |
+
+**选用规则**：
+
+- 「今天/当天/今日消耗」「实时消耗排行」 → 用 `google-analysis(-batch) --sections overview`，`--start` / `--end` 都设为今天
+- 「最近 N 天消耗 / 周报 / 月报 / 余额续航」 → `stats` / `balance-scan` / `accounts-digest`，默认窗口截至昨天即可
+- **禁止**用 `accountsoverview` 系列接口（`stats` / `balance-scan` / `accounts-digest` / `list-accounts` 合并消耗）判断当天消耗
+- **禁止**给当天高消耗场景加 `--min-spend`：该预筛选同样来自 `accountsoverview`，会把今天有消耗的账号当成 0 给筛掉
+
+---
+
 ## 默认做法（核心工作流）
 
 1. **先确认统计区间**：用户未给明确起止日期时**必须反问**（参见 SKILL.md 时间范围强制反问）。
 2. 确定报告维度（默认含：执行摘要、每日趋势、月度汇总、系列表现、设备分布、地域分布、关键词表现、优化建议），详见 `report-templates/README.md`。
 3. **拉数**：使用 `google-analysis … --json-out <dir>`（Google）或对应 `report <media>-*` 命令落盘。
-4. **编写并执行代码**从磁盘读取 `manifest-<accountId>.json` 与各 `<section>-<accountId>.json`，outline.json就是对应文件的格式说明，可以用于快速了解数据格式，完成筛选、聚合、排序等计算；**禁止**用 `Read` 看 JSON 后在对话里心算或手填报告数字。
+4. **编写并执行代码**从磁盘读取 `manifest-<accountId>.json` 与各 `<section>-<accountId>.json` 来完成筛选、聚合、排序等计算；**禁止**用 `Read` 看 JSON 后在对话里心算或手填报告数字。
+   - **写脚本前先读 `<section>-<accountId>.outline.txt`**（与 JSON 同 stem 的纯文本，最后一行是 TS 式类型字面量）了解字段结构；它体积只有几百字节、不含数据，比直接 `Read` 整个 `*.json`（动辄几 MB / 几万行）省**两到三个数量级**的上下文。**注意是 `.outline.txt` 不是 `.outline.json`**，不要 `require()`，用 `fs.readFileSync(outlineFile,'utf8')` 读最后一行即可。
+   - 真实数据始终从 `<section>-<accountId>.json` 由脚本读，**不要**把 outline 当作业务数据贴给用户。
 5. **由代码写出最终文件**（HTML/Excel/PDF/PPT/Markdown 等）。**禁止**在报告脚本中以源码字面量写死应从 JSON 读取的业务数据（消耗金额、系列名、日期区间等）。允许的常量仅限：快照目录路径、JSON 字段键名、版式/结构占位。
 6. **报告首行**须标注：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`，由脚本从 JSON 拼接写入，不得手写常量冒充。
 7. 交付后帮用户打开报告文件。
@@ -61,7 +84,7 @@
 
 ## Google 账户分析：`google-analysis` 命令
 
-> **重要**：`google-analysis` 是统一入口，所有 21 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。
+> **重要**：`google-analysis` 是统一入口，所有 21 个维度都通过 `--sections` 选取。关键词维度用 `--sections keywords`，**不要**用 `ad keywords` 代替。涉及「今天/当天」消耗的口径见本文顶部「数据时效性」表。
 
 ```bash
 # 单维度
@@ -98,7 +121,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 
 | 维度 | 说明 |
 |------|------|
-| `overview` | 总览 |
+| `overview` | 总览（实时，可查当天；当天高消耗账号排行首选） |
 | `keywords` | 关键词；可选 `--limit`、`--no-order-by-cost` |
 | `search-terms` | 搜索词 |
 | `campaigns` | 广告系列 |
@@ -118,7 +141,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `ads-index` | 质量指标 |
 | `final-urls` | 最终到达网址（不传 `--start`/`--end`） |
 | `dimension-summary` | 账户汇总 |
-| `campaign-types` | 系列类型（不传 `--start`/`--end`） |
+| `campaign-types` | 系列类型（实时，可查当天；不传 `--start`/`--end`） |
 
 ### stdout 摘要
 

package/dist/skill/references/accounts.md

@@ -127,7 +127,9 @@ siluzan-tso balance -m Google -a 6326027735 --json
 
 ---
 
-## stats — 查询投放消耗数据
+## stats — 查询投放消耗数据（每日同步昨天数据）
+
+> **数据时效性**：本接口口径为 `accountsoverview`，每日凌晨同步昨天数据，**不能查今天**。判断「今天/当天/今日消耗」请走 `google-analysis(-batch) --sections overview`。完整时效性表见 `references/account-analytics.md` 顶部。
 
 ```bash
 siluzan-tso stats -m <媒体类型> [选项]

package/dist/skill/references/finance.md

@@ -7,7 +7,7 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`https://www.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
+对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
@@ -133,10 +133,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：https://www.siluzan.com/recharge/pay
-- 现金充值（批量）：https://www.siluzan.com/recharge/pay_batch
-- 月结充值：        https://www.siluzan.com/recharge/accountBillingQuota
-- 丝路赞钱包：      https://www.siluzan.com/recharge/siluzanWallet
+- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
+- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
+- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
+- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
 ```
 
 ---

package/dist/skill/references/google-analysis-batch.md

@@ -1,43 +1,37 @@
 # `google-analysis-batch` —— 多账户 × 多维度 Google 数据批处理引擎
 
-> 适用场景：账户数 ≥ 5 且需要拉 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop 调用 `google-analysis -a <id>` 替代它。
+> 适用：账户数 ≥ 5 且需拉 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop 替代。中断后**必须** `resume`，不得重跑 `run`。
+>
+> **数据时效性**：维度的实时 / 每日同步口径见 `references/account-analytics.md` 顶部「数据时效性」表。当天高消耗排行只能用 `--sections overview`，且**禁止**加 `--min-spend`（其预筛选来自非实时 `accountsoverview`）。
 
-本命令将原本需要"Agent 写循环 + 余额扫描 + 多次 `google-analysis`"才能完成的"全 Google 账户多维度数据采集"任务下沉到 CLI 内部，做了：
-
-- **单 Node 进程**完成全部 task，复用 keep-alive，不再启动子进程做账户并发
-- **双层并发**：账户级 × 维度级（默认 4 × 6 = 24），自适应降级
-- **断点续跑**：被中断后用 `resume --run-id` 从断点继续，已成功的 task 不重复请求
-- **错误分类**：401 立即终止整批；4xx 永久失败；429/5xx/超时/网络错误指数退避重试
-- **machine-first**：stdout 一行 JSON 摘要；详细进度全部落盘，Agent 通过 `status` 读取
+单 Node 进程，复用 keep-alive，双层并发（账户级 × 维度级），断点续跑，错误自动分类重试。
 
 ---
 
 ## 子命令
 
-| 子命令   | 用途                                                  |
-| -------- | ----------------------------------------------------- |
-| `run`    | 首次执行：自动拉账户清单 + 按账户×维度并发执行 + 落盘 |
-| `resume` | 续跑：仅重做 pending / failed_retryable 的 task       |
-| `status` | 只读查询：打印 progress + 失败样例（不发起 HTTP）     |
+| 子命令 | 用途 |
+|--------|------|
+| `run` | 首次执行：自动拉账户清单 + 双层并发 + 落盘 |
+| `resume` | 续跑：仅重做 pending / failed_retryable 的 task |
+| `status` | 只读查询进度与失败样例（不发起 HTTP） |
 
 ---
 
 ## 命令示例
 
-### 首次跑全量（自动拉账户清单）
+### 获取所有google账号的指定section数据（省略 `-a`，CLI 自动拉账户清单）
 
 ```bash
 siluzan-tso google-analysis-batch run \
   --start 2026-04-30 --end 2026-05-06 \
   --sections campaigns,geographic,keywords \
-  --account-concurrency 4 \
-  --section-concurrency 6 \
-  --keyword-limit 1000 \
-  --min-spend 1 \
+  --account-concurrency 4 --section-concurrency 6 \
+  --keyword-limit 1000 --min-spend 1 \
   --json-out ./snap-batch
 ```
 
-### 显式指定账户列表（跳过清单拉取）
+### 显式指定账户（仅用户给出 ID 子集时）
 
 ```bash
 siluzan-tso google-analysis-batch run \
@@ -47,31 +41,7 @@ siluzan-tso google-analysis-batch run \
   --json-out ./snap-batch
 ```
 
-`-a` 给定时：
-- **跳过**账户清单拉取与余额/消耗查询，直接用传入 ID 构造任务（首条 stderr 提示也会消失）
-- **不应用** `--min-spend` 过滤（即使同时传也无效）
-- 账户元信息（`advertiserName` / `currencyCode` / `spend`）在 `accounts.json` 中为空，因为没拉清单
-- 等价于 `siluzan-tso google-analysis -a id1,id2,id3 --json-out <dir>`，但额外支持 `--run-id` / `--deadline` / `--max-attempts` / 自适应限流
-
-参数说明：
-
-| 参数                          | 说明                                                                 | 默认值                            |
-| ----------------------------- | -------------------------------------------------------------------- | --------------------------------- |
-| `--json-out <baseDir>`        | 必填，产物根目录；每个 runId 一个子目录                              | —                                 |
-| `--run-id <id>`               | 自定义 runId；留空自动生成 `run-YYYYMMDD-HHmmss-<rand4>`             | 自动                              |
-| `-a, --accounts <ids>`        | 显式 mediaCustomerId 列表（逗号分隔）；传入则跳过清单拉取与 min-spend | 不传=自动拉清单                   |
-| `--start` / `--end`           | 统计区间（YYYY-MM-DD）；range 类维度未传时回落到 google-analysis 默认 | 近 7 天截至昨天                   |
-| `--sections <list>`           | 维度（逗号分隔），合法值见 `references/account-analytics.md`         | `campaigns,geographic,keywords`   |
-| `--account-concurrency <n>`   | 账户级并发，1~16                                                     | 4                                 |
-| `--section-concurrency <n>`   | 单账户内维度并发，1~16                                               | 6                                 |
-| `--keyword-limit <n>`         | 透传给 keywords / search-terms 等大账户场景的条数上限                | google-analysis 默认              |
-| `--min-spend <n>`             | 区间消耗 ≤ 此值的账户跳过；0=不过滤（与 `--accounts` 同传时无效）    | 0                                 |
-| `--deadline <duration>`       | 整任务硬截止（如 `30m` / `2h` / `90s`），到期未完成标记 paused       | 不设                              |
-| `--task-timeout-ms <n>`       | 单 task 硬超时毫秒                                                   | 60000                             |
-| `--max-attempts <n>`          | 可重试错误的最大尝试次数                                             | 3                                 |
-| `--refresh-dp`                | 执行前强制刷新 Datapermission（一般无需）                            | false                             |
-| `--no-verbose-progress`       | 关闭 stderr 进度条（CI 推荐）                                        | 默认开启                          |
-| `-t, --token`                 | 临时覆盖 Token                                                       | 走 ~/.siluzan/config.json         |
+`-a` 给定时：跳过清单拉取与余额/消耗查询；不应用 `--min-spend`；`accounts.json` 元信息为空。**任何情况下都不要**先 `list-accounts` 再把全部 ID 拼进 `-a`。
 
 ### 中断后续跑
 
@@ -79,68 +49,83 @@ siluzan-tso google-analysis-batch run \
 siluzan-tso google-analysis-batch resume --json-out ./snap-batch --run-id <runId>
 ```
 
-resume 会：
-
-1. 从 `state/tasks.jsonl` 重建每个 task 的"最后一次状态"
-2. 跳过 `success` / `failed_permanent` / `skipped` 的 task
-3. 重新派发 `pending` / `running` / `failed_retryable` 的 task（`running` 是上次进程被强杀留下的"幽灵"状态）
+从 `state/tasks.jsonl` 重建状态，跳过 success / failed_permanent / skipped，重做 pending / running / failed_retryable。
 
-### 只读查询进度
+### 只读进度
 
 ```bash
 siluzan-tso google-analysis-batch status --json-out ./snap-batch --run-id <runId>
 ```
 
-`status` 不发起任何 HTTP，只读 `progress.json` + `tasks.jsonl`，输出 stdout 单行 JSON：
+不发起 HTTP，只读 `progress.json` + `tasks.jsonl`。
 
-```json
-{
-  "kind": "siluzan-tso-batch-summary",
-  "runId": "run-20260507-150000-ab12",
-  "state": "running|succeeded|partial|failed|paused",
-  "manifestFile": "...",
-  "progressFile": "...",
-  "runDir": "...",
-  "accountsTotal": 156,
-  "sections": ["campaigns", "geographic", "keywords"],
-  "progress": { ... },
-  "failedSample": [ ... ]
-}
-```
+---
+
+## 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--json-out <dir>` | 必填，产物根目录 | — |
+| `--run-id <id>` | 自定义 runId | 自动 `run-YYYYMMDD-HHmmss-<rand4>` |
+| `-a, --accounts <ids>` | 显式 ID 列表；传入则跳过清单拉取与 `--min-spend` | 省略时自动拉全量 Google 账号 |
+| `--start` / `--end` | 统计区间（YYYY-MM-DD） | 近 7 天截至昨天 |
+| `--sections <list>` | 维度（逗号分隔），合法值见 `references/account-analytics.md` | `campaigns,geographic,keywords` |
+| `--account-concurrency <n>` | 账户级并发（1~16） | 4 |
+| `--section-concurrency <n>` | 单账户内维度并发（1~16） | 6 |
+| `--keyword-limit <n>` | keywords / search-terms 条数上限 | google-analysis 默认 |
+| `--min-spend <n>` | 区间消耗 ≤ 此值跳过（与 `-a` 同传无效） | 0 |
+| `--deadline <dur>` | 整任务硬截止（如 `30m` / `2h`），到期标记 paused | 不设 |
+| `--task-timeout-ms <n>` | 单 task 硬超时 | 60000 |
+| `--max-attempts <n>` | 可重试错误最大尝试次数 | 3 |
+| `--refresh-dp` | 执行前强制刷新 Datapermission | false |
+| `--no-verbose-progress` | 关闭 stderr 进度条（CI 推荐） | false |
+| `-t, --token` | 临时覆盖 Token | `~/.siluzan/config.json` |
 
 ---
 
-## 产物目录布局
+## 产物目录
 
 ```
 <json-out>/<runId>/
-├── run-manifest.json           # 参数、账户清单总数、限流配置（首次 run 时写入）
-├── progress.json               # 实时进度（每 5 个 task 原子刷新）
-├── accounts.json               # 筛选后账户清单（mediaCustomerId + 元信息）
-├── results/
-│   └── <accountId>/
-│       ├── campaigns-<accountId>.json          # 与 google-analysis 同口径
-│       ├── campaigns-<accountId>.outline.txt
-│       ├── geographic-<accountId>.json
-│       ├── geographic-<accountId>.outline.txt
-│       ├── keywords-<accountId>.json
-│       ├── keywords-<accountId>.outline.txt
-│       └── manifest-<accountId>.json
-├── errors/
-│   └── <accountId>/
-│       └── <section>.error.json                # 失败 task 的详情（class/status/message/attempts）
+├── run-manifest.json           # 参数、账户总数、限流配置
+├── progress.json               # 实时进度（每 5 task 原子刷新）
+├── accounts.json               # 筛选后账户清单
+├── results/<accountId>/
+│   ├── <section>-<accountId>.json       # 与 google-analysis 同口径
+│   ├── <section>-<accountId>.outline.txt
+│   └── manifest-<accountId>.json
+├── errors/<accountId>/
+│   └── <section>.error.json     # class / status / message / attempts
 └── state/
-    ├── tasks.jsonl                             # 事件溯源日志，每行一次状态变更
-    └── tasks.lock                              # 运行时锁，防止同 runId 并发跑
+    ├── tasks.jsonl              # 事件溯源日志
+    └── tasks.lock               # 运行时锁
 ```
 
-**产物消费**：每个 `results/<accountId>/<section>-<accountId>.json` 与单账户 `google-analysis -a <id> --json-out` 完全同口径，已有的脚本可以直接复用。先读 `*.outline.txt` 了解字段类型，再用脚本批量聚合。
+**产物消费（Agent 强制顺序）**：先读 `*.outline.txt` 了解字段类型 → 再写聚合脚本 → 由脚本读 `<section>-<accountId>.json`。与单账户 `google-analysis` 完全同口径。
+
+**为什么先读 outline 而不是直接 `Read` JSON**：
+
+- `*.outline.txt` 是与 `*.json` **同 stem 的纯文本**（**注意扩展名 `.txt` 不是 `.json`，不要 `require()`**），最后一行是 TS 式类型字面量（如 `{ items: { id: number; spend: number; ... }[]; meta: { ... } }`），通常几百字节。
+- 真实 `<section>-<accountId>.json` 在批跑场景常见 `keywords-*.json` 数 MB、`campaigns-*.json` × N 账户合计几十万行，`Read` 会**几次就把对话窗口塞满**，还有截断风险。
+- 读 outline 节省 **2~3 个数量级**的上下文 token，足够你确定字段路径再写脚本聚合。
+
+读 outline 的最小写法（脚本里也只读最后一行）：
+
+```js
+const fs = require('node:fs');
+// outlineFile 来自 manifest-<accountId>.json 的 sections[].outlineFile
+const outline = fs.readFileSync(outlineFile, 'utf8');
+const tsType = outline.trimEnd().split('\n').filter(l => !l.startsWith('//')).pop();
+// tsType 形如：{ items: { id: number; spend: number; ... }[]; meta: { ... } }
+```
+
+**禁止**：把 outline 内容当业务数据贴给用户当结论（第 1 行注释明确写了 `// outline of \`<xxx>.json\` — schema-only, NOT the data.`）。
 
 ---
 
 ## stdout 摘要协议
 
-`run` / `resume` / `status` 的 stdout **始终输出且只输出一行 JSON**（kind 固定 `siluzan-tso-batch-summary`），便于 Agent 直接 `JSON.parse`：
+`run` / `resume` / `status` 的 stdout 始终一行 JSON（`kind=siluzan-tso-batch-summary`）：
 
 ```json
 {
@@ -153,96 +138,76 @@ siluzan-tso google-analysis-batch status --json-out ./snap-batch --run-id <runId
   "tokenInvalidated": false,
   "elapsedMs": 423000,
   "stats": {
-    "totalTasks": 468,
-    "success": 462,
-    "failedPermanent": 4,
-    "failedRetryable": 2,
-    "skipped": 0,
-    "throttleEvents": 1
+    "totalTasks": 468, "success": 462,
+    "failedPermanent": 4, "failedRetryable": 2,
+    "skipped": 0, "throttleEvents": 1
   }
 }
 ```
 
-进度详情、单 task 历史不会出现在 stdout，请读 `progress.json` 与 `state/tasks.jsonl`。
+进度详情读 `progress.json` 与 `state/tasks.jsonl`，不在 stdout。
 
 ---
 
-## 退出码（Agent 可解析）
+## 退出码
 
-| 退出码 | 含义                                                       | 后续动作                                              |
-| ------ | ---------------------------------------------------------- | ----------------------------------------------------- |
-| `0`    | 全部 task 成功，state=`succeeded`                          | 继续后续步骤                                          |
-| `2`    | 部分成功（state=`partial`）或被中断/超时（state=`paused`） | 看 `errors/` 重跑或直接消费已有产物                   |
-| `3`    | 全部失败、Token 失效（401）或致命错误，state=`failed`      | `tokenInvalidated:true` → 提示 `siluzan-tso login`    |
-| `4`    | 参数错误 / 用法错误（命令未执行）                          | 修正参数后重试                                        |
+| 码 | 含义 | 后续动作 |
+|----|------|---------|
+| `0` | 全部成功，state=`succeeded` | 继续后续 |
+| `2` | 部分成功（`partial`）或超时（`paused`） | 看 `errors/` 或消费已有产物 |
+| `3` | 全失败 / Token 失效 / 致命错误（`failed`） | `tokenInvalidated:true` → `siluzan-tso login` |
+| `4` | 参数错误（命令未执行） | 修正参数重试 |
 
 ---
 
 ## 错误分类与重试
 
-| 分类               | 触发条件                                       | 处理方式                                                                                |
-| ------------------ | ---------------------------------------------- | --------------------------------------------------------------------------------------- |
-| `abort`            | HTTP 401（Token 失效）                         | **立即终止整批**，标记 `tokenInvalidated:true`；其余未跑 task 保留 pending，可 resume   |
-| `failed_permanent` | HTTP 400 / 403 / 404                           | 不重试；记入 `errors/<accountId>/<section>.error.json`                                  |
-| `failed_retryable` | HTTP 408 / 429 / 5xx / 超时 / 网络错误         | 指数退避 `base * 2^attempt + jitter`（base=1s，cap=30s），最多 `--max-attempts` 次      |
-| `skipped`          | 账户 `invalidOAuthToken=true` 或被 `--min-spend` 过滤 | 不发起 HTTP，直接落 `skipped`                                                  |
+| 分类 | 触发条件 | 处理 |
+|------|---------|------|
+| `abort` | HTTP 401 | **立即终止整批**，`tokenInvalidated:true`，可 resume |
+| `failed_permanent` | HTTP 400 / 403 / 404 | 不重试，记入 `errors/` |
+| `failed_retryable` | HTTP 408 / 429 / 5xx / 超时 / 网络错误 | 指数退避 `1s × 2^attempt + jitter`（cap 30s），最多 `--max-attempts` 次 |
+| `skipped` | `invalidOAuthToken=true` 或被 `--min-spend` 过滤 | 不发起 HTTP |
 
-**自适应降级**：滚动 20 个 task 内错误率 ≥ 30% 时，账户并发与维度并发同时减半；冷却 60s 内不再次降级。`progress.throttleEvents` 记录降级次数，便于 Agent 提示用户检查网络/限流配置。
+**自适应降级**：滚动 20 task 内错误率 ≥ 30% → 账户并发与维度并发同时减半；冷却 60s。`progress.throttleEvents` 记录次数。
 
 ---
 
 ## 与 google-analysis 的关系
 
-`google-analysis` 命令会**根据 `-a` 的 ID 数自动选路**，两者底层共享同一个批处理引擎：
+`google-analysis` 会根据 `-a` 的 ID 数量自动选路，底层共享同一引擎：
 
-| 维度          | `google-analysis -a <单 ID>`            | `google-analysis -a id1,id2,id3` | `google-analysis-batch run`                          |
-| ------------- | --------------------------------------- | -------------------------------- | ---------------------------------------------------- |
-| 适用账户数    | 1                                       | 2~10（轻量批量场景）             | 任意（含 0 → 自动拉全清单）                          |
-| 调度          | 单账户内多维度（默认并发 5）            | 同 batch 引擎（账户 × 维度双层） | 同左                                                 |
-| 失败处理      | 抛错给 Agent 决定是否重试               | 自动错误分类 + 退避重试 + 401 终止 | 同左                                                 |
-| 中断恢复      | 不支持                                  | 支持 `google-analysis-batch resume` | 支持 `resume`                                        |
-| stdout 摘要   | `siluzan-tso-google-analysis-snapshot-batch` | `siluzan-tso-batch-summary`（含 `forwardedFrom:"google-analysis"`） | `siluzan-tso-batch-summary`                          |
-| 产物结构      | `<dir>/<section>-<id>.json`             | `<dir>/<runId>/results/<accountId>/<section>-<id>.json` | 同左                                                 |
-| Resume 能力   | —                                       | 用 `google-analysis-batch resume --run-id <runId>` | 同左                                                 |
+| | `google-analysis -a <单ID>` | `google-analysis -a id1,id2,id3` | `google-analysis-batch run` |
+|--------|------|------|------|
+| 账户数 | 1 | 2~10 | 任意（含 0→自动拉全量） |
+| 调度 | 单账户多维度 | 双层并发 | 双层并发 |
+| 失败处理 | 抛错 | 自动分类 + 退避 + 401 终止 | 同左 |
+| 中断恢复 | 不支持 | `resume` | `resume` |
+| stdout | snapshot-batch | `siluzan-tso-batch-summary`（含 `forwardedFrom`） | `siluzan-tso-batch-summary` |
+| 产物 | `<dir>/<section>-<id>.json` | `<dir>/<runId>/results/<accountId>/<section>-<id>.json` | 同左 |
 
-落盘的单 section JSON 结构两边完全一致；目录组织不同（单 ID 直接落盘，多 ID 多一层 `runId/results/accountId/`）。下游脚本读 JSON 时只需感知路径。
+单 section JSON 结构完全一致，仅目录组织不同。
 
-**选用建议**：
-
-- 1 个账户 → `google-analysis -a id`（最简，无 runId 子目录）
-- 2~10 个账户 + 一次性出报告 → `google-analysis -a id1,id2,...`（隐式走 batch，仍是 stdout 单行 JSON）
-- ≥ 10 个账户、需要 `--deadline` / `--max-attempts` / `--run-id` / 中途 resume → 直接用 `google-analysis-batch run`
+**选用**：1 账户 → `google-analysis -a id`；2~10 子集 → `google-analysis -a id1,id2,...`（隐式 batch）；≥10 子集/需 resume → `google-analysis-batch run -a id1,id2,...`；全量 → `google-analysis-batch run`（省略 `-a`）。
 
 ---
 
 ## 常见问题
 
-**Q：被 Ctrl+C 之后能不能直接重新 `run`？**
-A：**不能**。直接 `run` 会生成新的 runId，所有 task 从零开始重复请求，浪费配额并可能再次触发限流。**只能** `resume --run-id <旧 id>`。
-
-**Q：怎么知道上次的 runId？**
-A：上次 `run` stdout 摘要里的 `runId` 字段；或浏览 `--json-out` 目录下最新的 `run-*` 子目录名。
-
-**Q：401 触发整批终止后，是否需要重新跑全量？**
-A：不需要。
-1. `siluzan-tso login` 重新登录
-2. `siluzan-tso google-analysis-batch resume --run-id <id> --refresh-dp` 续跑剩余 task
+**Q：拉全量是不是先 `list-accounts` 再把 ID 拼进 `-a`？**
+A：**不要**。`run` 不传 `-a` 时内部自动拉清单+余额+消耗，先 `list-accounts` 只是重复请求。直接 `google-analysis-batch run ...` 即可。
 
-**Q：Datapermission 不过期，那为什么还有 `--refresh-dp`？**
-A：`--refresh-dp` 用于排查 Token 重新授权后权限菜单刷新滞后等极端场景，正常路径不需要。
+**Q：Ctrl+C 后能否重新 `run`？**
+A：**不能**。会生成新 runId，所有 task 从零开始。只能 `resume --run-id <旧id>`。
 
-**Q：accounts.json 是什么时候快照的？我能否手工筛选账户后再 resume？**
-A：`accounts.json` 在首次 `run` 写入并定型；resume 默认用 manifest 里的快照，不会重新扫描账户。如果要改账户范围，请新建一个 runId 重新 run。
+**Q：怎么知道上次 runId？**
+A：上次 stdout 摘要的 `runId` 字段，或浏览 `--json-out` 下最新 `run-*` 目录名。
 
-**Q：errors 文件能驱动我做什么？**
-A：每个失败 task 对应一份 `errors/<accountId>/<section>.error.json`，含 `class` / `status` / `attempts` / `message`。可：
-- `class=permanent` → 通常是账户权限或参数问题，对该账户单独排查
-- `class=retryable` 但仍失败 → 通常是网络或服务端持续不稳定，过段时间 `resume` 即可
-
----
+**Q：401 后需要重跑全量吗？**
+A：不需要。`siluzan-tso login` 后 `resume --run-id <id> --refresh-dp` 即可。
 
-## 与 SKILL.md 的硬约束对照
+**Q：accounts.json 何时快照？能否手工改账户范围再 resume？**
+A：首次 `run` 时写入并定型。要改账户范围，新建 runId 重新 `run`。
 
-- 账户 ≥ 5 且维度 ≥ 2 时**强制**使用本命令（见 SKILL.md「批量任务硬约束」表）
-- 长任务被中断**必须** resume，不得重跑（见 SKILL.md「运行时长与进度」）
-- 401 后整批终止，需 `login` 后再 resume（见 SKILL.md 退出码描述）
+**Q：errors 文件能做什么？**
+A：`class=permanent` → 对账户单独排查权限/参数；`class=retryable` 仍失败 → 过段时间 `resume`。

package/dist/skill/references/reporting.md

@@ -214,8 +214,8 @@ siluzan-tso report list -m Google --json
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

package/dist/skill/references/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -47,7 +47,7 @@ siluzan-tso config set --api-key <Key>     # 或通过 config set 直接写入
 siluzan-tso config set --token <Token>     # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ### 通过环境变量传入凭据（CI/CD 推荐）
 
@@ -82,9 +82,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

package/dist/skill/references/tso-home.md

@@ -6,7 +6,7 @@
 
 用 `siluzan-tso config show` 读取 **`webUrl`**，再拼接路径：
 
-首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 
 > 若用户已登录 TSO，也可从左侧菜单进入「首页」。
 

package/dist/skill/scripts/install.ps1

@@ -10,8 +10,8 @@ $ErrorActionPreference = 'Stop'
 $PKG_NAME    = 'siluzan-tso-cli'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
-$WEB_BASE    = 'https://www.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN = 18
@@ -87,6 +87,10 @@ function Main {
     Write-Host "|  $SKILL_LABEL -- Install                    |" -ForegroundColor White
     Write-Host '+---------------------------------------------+' -ForegroundColor White
     Write-Host ''
+    Write-Warn 'Windows note: some agent clients may fail when running PowerShell/cmd commands.'
+    Write-Host '  If this install fails unexpectedly, install Git for Windows and rerun the Bash installer in Git Bash:' -ForegroundColor DarkGray
+    Write-Host '  https://git-scm.com/download/win' -ForegroundColor DarkGray
+    Write-Host ''
 
     # Step 1: Environment check
     Write-Step 'Step 1/4: Environment check'

package/dist/skill/scripts/install.sh

@@ -10,8 +10,8 @@ set -euo pipefail
 readonly PKG_NAME="siluzan-tso-cli"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
-readonly WEB_BASE="https://www.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
+readonly WEB_BASE="https://www-ci.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.15",
+  "version": "1.1.17-beta.1",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",