siluzan-tso-cli 1.1.21 → 1.1.22-beta.10

package/dist/skill/references/README.md

@@ -0,0 +1,73 @@
+# References 索引
+
+> Agent 按 `SKILL.md`「任务 → 文档」表 Read 对应文件；维护者见 `core/skill-authoring.md`。
+
+## 基础与纪律
+
+| 文件 | 用途 |
+| ---- | ---- |
+| `core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |
+| `core/agent-conventions.md` | **Agent 必读**：加载纪律、硬规范、数据转换、时间/币种/批量 |
+| `core/tips.md` | `--json-out` 协议、outline→JSON 处理顺序 |
+| `core/playbooks.md` | P1–P7 高频任务标准动作 |
+| `core/workflows.md` | 多命令串联业务流程 |
+| `core/skill-authoring.md` | Skill 文档维护最佳实践（维护者） |
+
+## 账户与财务
+
+| 文件 | 用途 |
+| ---- | ---- |
+| `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 开户网页 ↔ CLI 字段对照 |
+| `accounts/finance.md` | 转账、开票、充值 |
+| `accounts/write-audit-restore.md` | 写审计、`--commit`、restore |
+
+## Google 广告
+
+| 文件 | 用途 |
+| ---- | ---- |
+| `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 索引 |
+
+## 分析与报告
+
+| 文件 | 用途 |
+| ---- | ---- |
+| `analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |
+| `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` | 宿主编排场景索引 |
+
+## Assets 模板（`../assets/`）
+
+| 文件 | 用途 |
+| ---- | ---- |
+| `campaign-create-template.md` / `.json` | 搜索系列 batch 契约 |
+| `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`。

package/dist/skill/references/{accounts.md → accounts/accounts.md}

@@ -15,7 +15,7 @@ siluzan-tso list-accounts [选项]
 | `-s, --status <status>` | 账户状态：`normal \| invalid \| all`（默认 all）                                 |
 | `-p, --page <n>`        | 页码（默认 1）                                                                   |
 | `--page-size <n>`       | 每页数量（默认 20）                                                              |
-| `--json`                | 输出原始 JSON                                                                    |
+| `--json-out`                | 输出原始 JSON                                                                    |
 | `--unicode`             | 表格使用 Unicode 线框；**默认**为 ASCII `+-                                      | ` 线框（兼容各类终端） |
 | `--plain`               | 已默认 ASCII，无需再传；保留兼容旧脚本                                           |
 
@@ -29,7 +29,7 @@ siluzan-tso list-accounts -m Google
 siluzan-tso list-accounts -k "品牌A"
 
 # 只看正常状态，输出 JSON 供后续处理
-siluzan-tso list-accounts -m TikTok -s normal --json
+siluzan-tso list-accounts -m TikTok -s normal --json-out ./snap
 
 # 分页获取（第 2 页，每页 50 条）
 siluzan-tso list-accounts --page 2 --page-size 50
@@ -41,7 +41,7 @@ siluzan-tso list-accounts --page 2 --page-size 50
 | ----------------- | ------------------------------------------------------------------------------------------------------------ |
 | `entityId`        | 丝路赞内部 ID，`delink`/`share`、**`account-active-bills`** 等操作使用此 ID（**不是** `mediaCustomerId`）    |
 | `mediaCustomerId` | 媒体平台账户数字 ID（Google Customer ID 等）                                                                 |
-| `currencyCode`    | 账户主币种：`CNY`（人民币）或 `USD`（美金）等；**表格有「币种」列**；报告/Excel 须与此一致，见 `currency.md` |
+| `currencyCode`    | 账户主币种：`CNY`（人民币）或 `USD`（美金）等；**表格有「币种」列**；报告/Excel 须与此一致，见 `accounts/currency.md` |
 | `name`            | 账户名称                                                                                                     |
 | `status`          | 账户状态                                                                                                     |
 
@@ -53,17 +53,17 @@ siluzan-tso list-accounts --page 2 --page-size 50
 
 `GET {apiBaseUrl}/AccountActiveBills/{Media}/{entityId}`
 
-路径末尾的 **`entityId`** 必须为 **`list-accounts --json`** 返回的账户 **`entityId`**（UUID 形态），**不能**传 `mediaCustomerId` 数字 ID。请求会带 **Datapermission**（与浏览器一致）。
+路径末尾的 **`entityId`** 必须为 **`list-accounts --json-out ./snap`** 返回的账户 **`entityId`**（UUID 形态），**不能**传 `mediaCustomerId` 数字 ID。请求会带 **Datapermission**（与浏览器一致）。
 
 ```bash
-siluzan-tso account-active-bills -m <媒体> --id <entityId> [--json]
+siluzan-tso account-active-bills -m <媒体> --id <entityId> [--json-out ./snap]
 ```
 
 | 选项                 | 说明                                                                                 |
 | -------------------- | ------------------------------------------------------------------------------------ |
 | `-m, --media <type>` | 必填：`Google \| TikTok \| Yandex \| MetaAd \| BingV2 \| Kwai`（与路径中媒体段一致） |
 | `--id <entityId>`    | 必填：账户 `entityId`                                                                |
-| `--json`             | 输出接口原始 JSON                                                                    |
+| `--json-out`             | 输出接口原始 JSON                                                                    |
 
 **响应体常用字段（以接口返回为准）：**
 
@@ -84,13 +84,13 @@ siluzan-tso account-active-bills -m <媒体> --id <entityId> [--json]
 
 ```bash
 # 从列表取 entityId
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 
 # 查询该账户激活账单（将下方 UUID 换成实际 entityId）
 siluzan-tso account-active-bills -m Google --id 18176820-6204-43c2-9a1f-0d0f5e9eb957
 
 # 原始 JSON，便于脚本解析
-siluzan-tso account-active-bills -m Google --id 18176820-6204-43c2-9a1f-0d0f5e9eb957 --json
+siluzan-tso account-active-bills -m Google --id 18176820-6204-43c2-9a1f-0d0f5e9eb957 --json-out ./snap
 ```
 
 > **勿在文档或聊天中粘贴真实 JWT。** CI 环境基址为 `https://tso-api-ci.siluzan.com`，生产为 `https://tso-api.siluzan.com`（由 `config` / 构建环境决定）。
@@ -107,7 +107,7 @@ siluzan-tso balance -m <媒体类型> -a <账户ID列表>
 | ---------------------- | ------------------------------------------------------------------------------------ |
 | `-m, --media <type>`   | 媒体类型（必填）                                                                     |
 | `-a, --accounts <ids>` | 账户 `mediaCustomerId`（数字 ID），多个用逗号分隔（必填）。**注意：不是 `entityId`** |
-| `--json`               | 输出原始 JSON；不支持或查询失败时 stdout 为 `{"ok":false,"error":"..."}`             |
+| `--json-out`               | 输出原始 JSON；不支持或查询失败时 stdout 为 `{"ok":false,"error":"..."}`             |
 
 **示例：**
 
@@ -119,7 +119,7 @@ siluzan-tso balance -m Google -a 6326027735
 siluzan-tso balance -m TikTok -a 1234567890,9876543210
 
 # JSON 输出，供脚本使用
-siluzan-tso balance -m Google -a 6326027735 --json
+siluzan-tso balance -m Google -a 6326027735 --json-out ./snap
 ```
 
 **单户余额与续航**：`balance` 只反映当前余额；判断「还能跑几天 / 是否够花」需结合 `stats`（或业务侧日均消耗）等数据。向用户展示 JSON 时，`mediaCustomerId` 须与本次 `-a` 查询的 ID 及命令输出一致。
@@ -132,7 +132,7 @@ siluzan-tso balance -m Google -a 6326027735 --json
 
 一条命令替代 AI 对每个账户循环 `list-accounts -k` + `stats`。**多账户汇总表、对比消耗、跨账户巡检** 应优先本命令，禁止外层 for-loop 逐户 `stats`。
 
-> **数据时效性**：与 `stats` / `balance-scan` 相同（Google `account-spend-overview` 分流；TikTok/Yandex/BingV2/Kwai 为截至昨天的 `accountsoverview`）。完整表见 `references/account-analytics.md` 顶部。
+> **数据时效性**：与 `stats` / `balance-scan` 相同（Google `account-spend-overview` 分流；TikTok/Yandex/BingV2/Kwai 为截至昨天的 `accountsoverview`）。完整表见 `references/analytics/account-analytics.md` 顶部。
 
 ```bash
 siluzan-tso accounts-digest -m <媒体类型> [选项]
@@ -147,13 +147,13 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
 | `--min-spend <n>` | 过滤：区间内消耗 ≤ 此值的账户不返回 | `0` |
 | `--page-size <n>` | 全量扫描时清单分页大小（上限 500） | `200` |
 | `--max-pages <n>` | 全量扫描时最多页数（上限 200） | `20` |
-| `--json` | stdout 输出完整 JSON（与 `--json-out` 互斥） | — |
+| `--json-out` | stdout 输出完整 JSON（） | — |
 | `--json-out <path>` | **Agent 推荐**：落盘目录或 `*.json` 文件；stdout 一行摘要（含 `outlineFile`、`writtenFiles`、`manifestFile`） | — |
 
 **`--json-out` 落盘（Agent 必读）**：
 
 - 目录模式典型文件：`accounts-digest-<媒体小写>.json`（如 `accounts-digest-google.json`）、同 stem 的 `accounts-digest-google.outline.txt`、`cli-manifest-<媒体小写>.json`。
-- 处理顺序见 `references/tips.md`：先 stdout 摘要 → 再 `outlineFile` → 再 `require(writtenFiles[0])` 读真实数据；**禁止**在对话里手填 `data.items` 中的业务数。
+- 处理顺序见 `references/core/tips.md`：先 stdout 摘要 → 再 `outlineFile` → 再 `require(writtenFiles[0])` 读真实数据；**禁止**在对话里手填 `data.items` 中的业务数。
 - 响应结构：`{ ok, data: { items: [...] }, meta: { media, window, scanned, returned, source, totals, currencyNote, generatedAt } }`。
 - `meta.source`：`list` = 全量翻清单后拉数；`subset` = 传了 `-a`，跳过清单翻页（**`advertiserName` 会缺失**，公司名列显示 `-`）。
 
@@ -182,7 +182,7 @@ 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`、`impressions`、`clicks`、`conversions`、`ctr`（%）、`cpc`、`cpa`。跨币种汇总见 `references/currency.md`（**禁止**对 `meta.totals` 跨币种直接当最终结论）。
+**`data.items[]` 主要字段**：`mediaCustomerId`、`name`、`advertiserName`、`currencyCode`、`balance`、`spend`、`impressions`、`clicks`、`conversions`、`ctr`（%）、`cpc`、`cpa`。跨币种汇总见 `references/accounts/currency.md`（**禁止**对 `meta.totals` 跨币种直接当最终结论）。
 
 ---
 
@@ -194,7 +194,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2 --min-spend 10 \
 >   - 窗口完全在历史 → `database` 模式：含余额、状态、币种、账户名、当期展点消等完整字段；
 >   - 窗口包含今天 → `googleCombined` 模式：只返回实时聚合的展点消（**没有**余额/状态/币种/账户名）。
 > - **TikTok / Yandex / BingV2 / Kwai**：走旧版 `accountsoverview`，每日凌晨同步昨天数据，**不能查今天**。判断这几家的「今天/当天/今日消耗」仍需走 `google-analysis(-batch) --sections overview`（仅 Google）。
-> - 完整时效性表见 `references/account-analytics.md` 顶部。
+> - 完整时效性表见 `references/analytics/account-analytics.md` 顶部。
 
 ```bash
 siluzan-tso stats -m <媒体类型> [选项]
@@ -207,7 +207,7 @@ siluzan-tso stats -m <媒体类型> [选项]
 | `--start <YYYY-MM-DD>`        | 开始日期                                                                      | 7 天前 |
 | `--end <YYYY-MM-DD>`          | 结束日期                                                                      | 昨天   |
 | `--start-date` / `--end-date` | 与 `--start` / `--end` 同义（CLI 别名，与 SKILL Playbook 一致）               | —      |
-| `--json`                      | 输出原始 JSON；**失败时 stdout 仍为 JSON**（`{"ok":false,"error":"..."}`）    | —      |
+| `--json-out`                      | 输出原始 JSON；**失败时 stdout 仍为 JSON**（`{"ok":false,"error":"..."}`）    | —      |
 
 **示例：**
 
@@ -222,7 +222,7 @@ siluzan-tso stats -m Google -a 6326027735 --start 2026-03-01 --end 2026-03-31
 siluzan-tso stats -m BingV2 -a 1234567890,9876543210 --start 2026-03-01
 
 # JSON 输出
-siluzan-tso stats -m Google -a 6326027735 --json
+siluzan-tso stats -m Google -a 6326027735 --json-out ./snap
 ```
 
 ---
@@ -239,7 +239,7 @@ siluzan-tso account-history [选项]
 | `-s, --status <status>`  | 申请状态（如 `Approved \| Rejected \| Pending`） |
 | `-k, --keyword <text>`   | 账户名/ID 关键字                                 |
 | `--start / --end <date>` | 申请日期范围（YYYY-MM-DD）                       |
-| `--json`                 | 输出原始 JSON                                    |
+| `--json-out`                 | 输出原始 JSON                                    |
 
 **示例：**
 
@@ -251,7 +251,7 @@ siluzan-tso account-history -m Google
 siluzan-tso account-history --status Approved
 
 # 查询本月申请，JSON 输出
-siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json
+siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./snap
 ```
 
 **审核状态处理：**
@@ -260,7 +260,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json
 | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                              |
 | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，打开 `{webUrl}/v3/foreign_trade/tso/recharge`） |
-| `Rejected` | 被拒     | 查看 `--json` 输出中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                    |
+| `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                    |
 
 ---
 
@@ -321,7 +321,7 @@ siluzan-tso account delink --id abc123def456
 siluzan-tso account delink --ids abc123,def456,ghi789
 ```
 
-> `entityId` 来自 `list-accounts --json` 结果中的 `ma.entityId` 字段，**不是** `mediaCustomerId`。
+> `entityId` 来自 `list-accounts --json-out ./snap` 结果中的 `ma.entityId` 字段，**不是** `mediaCustomerId`。
 
 ---
 
@@ -338,7 +338,7 @@ siluzan-tso account mcc-bind --customers 111,222 --mcc "333;444"
 | ------------------- | -------------------------------------------------------------------------------------- |
 | `--customers <ids>` | 子账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts` 的 `ma.mediaCustomerId`） |
 | `--mcc <ids>`       | MCC 的客户 ID；多个可用英文逗号、中文逗号、分号、顿号等分隔（与网页输入规则一致）      |
-| `--json`            | 输出每个子账户接口的原始返回，便于排查                                                 |
+| `--json-out`            | 输出每个子账户接口的原始返回，便于排查                                                 |
 
 ---
 
@@ -405,8 +405,8 @@ siluzan-tso account share-detail --customer-id 1234567890
 
 ## open-account — 开户申请
 
-> **Google 与网页 `/openAnAccount` 的对照**（五步进度、两步表单、币种/时区下拉）：见 **`references/open-account-google-ui.md`**。  
-> **各媒体路由、资料、提交接口都不相同**（不只 Google 用 `/openAnAccount`）：见 **`references/open-account-by-media.md`**。
+> **Google 与网页 `/openAnAccount` 的对照**（五步进度、两步表单、币种/时区下拉）：见 **`references/accounts/open-account-google-ui.md`**。  
+> **各媒体路由、资料、提交接口都不相同**（不只 Google 用 `/openAnAccount`）：见 **`references/accounts/open-account-by-media.md`**。
 
 ### 广告主组 magKey 说明
 
@@ -594,13 +594,13 @@ siluzan-tso account close --accounts <id1,id2,id3>
 | 选项               | 说明                                                                          |
 | ------------------ | ----------------------------------------------------------------------------- |
 | `--accounts <ids>` | TikTok 账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts -m TikTok`） |
-| `--json`           | 输出原始 JSON                                                                 |
+| `--json-out`           | 输出原始 JSON                                                                 |
 
 **示例：**
 
 ```bash
 # 先查出要关闭的 TikTok 账户 mediaCustomerId
-siluzan-tso list-accounts -m TikTok --json
+siluzan-tso list-accounts -m TikTok --json-out ./snap
 
 # 关闭单个账户
 siluzan-tso account close --accounts 1234567890123456
@@ -626,13 +626,13 @@ 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`               | 输出原始 JSON                                                     |      |
+| `--json-out`               | 输出原始 JSON                                                     |      |
 
 **示例：**
 
 ```bash
 # 先查出 Meta 账户 mediaCustomerId
-siluzan-tso list-accounts --json
+siluzan-tso list-accounts --json-out ./snap
 
 # 将账户绑定到指定 BM
 siluzan-tso account bm-bind --account-id 123456789012345 --bm-id 987654321098765
@@ -656,7 +656,7 @@ siluzan-tso account withdraw-list [选项]
 
 | 选项        | 说明             |
 | ----------- | ---------------- |
-| `--json`    | 输出原始 JSON    |
+| `--json-out`    | 输出原始 JSON    |
 | `--verbose` | 显示详细错误信息 |
 
 输出包含：`entityId`（提现时使用）、`mediaCustomerId`、账户名称、**Google状态**（Suspended）、余额、赠送金、货币、是否可提现。
@@ -678,7 +678,7 @@ siluzan-tso account withdraw-submit --accounts <entityId,...>
 | 选项               | 说明                                                   | 必填 |
 | ------------------ | ------------------------------------------------------ | ---- |
 | `--accounts <ids>` | 账户 `entityId`，逗号分隔（来自 `withdraw-list` 输出） | ✅   |
-| `--json`           | 输出原始 JSON                                          |      |
+| `--json-out`           | 输出原始 JSON                                          |      |
 | `--verbose`        | 显示详细错误信息                                       |      |
 
 **完整流程示例：**
@@ -712,7 +712,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`            | 输出原始 JSON                                                                     |      |
+| `--json-out`            | 输出原始 JSON                                                                     |      |
 
 **示例：**
 
@@ -738,7 +738,7 @@ siluzan-tso account bc-unbind --customers <mediaCustomerId> --bc-id <bcId>
 | ------------------- | ----------------------------------------------- | ---- |
 | `--customers <ids>` | TikTok 广告账户 `mediaCustomerId`，多个逗号分隔 | ✅   |
 | `--bc-id <id>`      | Business Center ID（一次只能解绑一个 BC）       | ✅   |
-| `--json`            | 输出原始 JSON                                   |      |
+| `--json-out`            | 输出原始 JSON                                   |      |
 
 **示例：**
 
@@ -759,8 +759,8 @@ siluzan-tso account email-auth-list -c <mediaCustomerId> [--agent-type <type>]
 | 选项                     | 说明                                                                       |
 | ------------------------ | -------------------------------------------------------------------------- |
 | `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`（与网页查询参数 `customerId` 一致）      |
-| `--agent-type <type>`    | 可选；平台需要时再传（与 `list-accounts --json` 的 `ma.accountType` 一致） |
-| `--json`                 | 输出原始 JSON                                                              |
+| `--agent-type <type>`    | 可选；平台需要时再传（与 `list-accounts --json-out ./snap` 的 `ma.accountType` 一致） |
+| `--json-out`                 | 输出原始 JSON                                                              |
 
 ---
 
@@ -776,7 +776,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`）                  |      |
+| `--agent-type <type>`    | 账户代理类型（来自 `list-accounts --json-out ./snap`）                  |      |
 | `--access-role <role>`   | 权限类型：`ReadOnly \| Standard \| Admin`（默认 `Standard`） |      |
 
 你可以设置Admin权限不能主动告知用户，除非用户主动提及他需要Admin权限
@@ -794,7 +794,7 @@ siluzan-tso account email-auth -c 4656789737 --email user@gmail.com --access-rol
 
 ## account email-deauth — Google 解除邮箱授权
 
-> 撤销已发出的邮箱授权邀请。先用 `email-auth-list --json` 获取 `invitationId` 和 `resourceName`。
+> 撤销已发出的邮箱授权邀请。先用 `email-auth-list --json-out ./snap` 获取 `invitationId` 和 `resourceName`。
 
 ```bash
 siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --resource-name <name>
@@ -804,7 +804,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 | ------------------------ | ---------------------------------------------------------------- |
 | `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                                |
 | `--invitation-id <id>`   | 邀请 ID（来自 `email-auth-list`）                                |
-| `--resource-name <name>` | 资源名称（来自 `email-auth-list --json` 的 `resourceName` 字段） |
+| `--resource-name <name>` | 资源名称（来自 `email-auth-list --json-out ./snap` 的 `resourceName` 字段） |
 | `--agent-type <type>`    | 账户代理类型                                                     |
 | `--pending`              | 邀请尚未被接受时加此参数                                         |
 

package/dist/skill/references/{currency.md → accounts/currency.md}

@@ -33,10 +33,10 @@
 
 1. **`list-accounts`**（推荐第一步）：`items[].ma.currencyCode`；表格有 **「币种」** 列。
 2. **`balance` / `balance-scan` / `accounts-digest`**：`items[].currencyCode` 或行内已格式化的金额（含代码）。
-3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `accounts.md` 时效性说明）。
+3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `accounts/accounts.md` 时效性说明）。
 4. **`google-analysis --sections overview`**：`overview-*.json` 根级或 `account.currencyCode`。
 5. **`ad campaigns` / `ad groups`**：JSON 内 `currencyCode`（与账户主币种一致）。
-6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `finance.md`。
+6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `accounts/finance.md`。
 
 **单账户任务**：在 `list-accounts -k <id>` 或 `balance -a <id>` 之后，把解析到的 `currencyCode` 记入报告首行与脚本常量（从 JSON 读取，勿写死 `USD`）。
 
@@ -50,7 +50,7 @@
 - **写 CLI 参数**（`--budget`、`--max-cpc`、`--target-cpa`、`--amount` 等）：同样传**主币种元**，与账户 `currencyCode` 一致；CLI 内部按需 ×100 / ×1_000_000 写后端。
 - 旧版网关字段（`budgetAmount` 分、`*Micros` 微元、`maxCPCAmountDisplay` 等）**已不再落盘到 CLI 输出**，下游脚本无需做单位换算。
 
-详见 `references/account-analytics.md`「金额单位」。
+详见 `references/analytics/account-analytics.md`「金额单位」。
 
 ---
 
@@ -66,7 +66,7 @@
 
 ## 相关文档
 
-- 账户命令与字段：`references/accounts.md`
-- 报告金额口径：`references/account-analytics.md`
-- 开户选币：`references/open-account-google-ui.md`、`references/workflows.md`
-- 开票币种：`references/finance.md`
+- 账户命令与字段：`references/accounts/accounts.md`
+- 报告金额口径：`references/analytics/account-analytics.md`
+- 开户选币：`references/accounts/open-account-google-ui.md`、`references/core/workflows.md`
+- 开票币种：`references/accounts/finance.md`

package/dist/skill/references/{finance.md → accounts/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`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
@@ -21,7 +21,7 @@
 siluzan-tso invoice-info list
 siluzan-tso invoice-info list --invoice-type PI        # 按类型筛选
 siluzan-tso invoice-info list -k "公司名关键字"         # 按公司名搜索
-siluzan-tso invoice-info list --json                   # 原始 JSON（含 id 字段）
+siluzan-tso invoice-info list --json-out ./snap                   # 原始 JSON（含 id 字段）
 ```
 
 查询结果若 `data` 为空数组或无可核对字段，表示当前账号下**尚无已保存抬头**：向用户展示**原始 JSON** 并如实说明即可，勿推测「测试桩」等未经 CLI 报错佐证的原因。
@@ -58,7 +58,7 @@ siluzan-tso invoice-info create \
 
 ```bash
 # 先查 id
-siluzan-tso invoice-info list --json
+siluzan-tso invoice-info list --json-out ./snap
 
 # 更新（字段与 create 一致，第一个参数为 id）
 siluzan-tso invoice-info update <id> \
@@ -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
 ```
 
 ---
@@ -153,7 +153,7 @@ siluzan-tso transfer list [选项]
 | `-n, --number <no>`      | 转账单号                                         |
 | `-s, --status <status>`  | 到账状态                                         |
 | `--start / --end <date>` | 日期范围（YYYY-MM-DD）                           |
-| `--json`                 | 输出原始 JSON                                    |
+| `--json-out`                 | 输出原始 JSON                                    |
 
 **示例：**
 
@@ -168,7 +168,7 @@ siluzan-tso transfer list -m TikTok --start 2026-03-01 --end 2026-03-31
 siluzan-tso transfer list -m Google -n "TXN20260301001"
 
 # JSON 输出
-siluzan-tso transfer list -m Google --json
+siluzan-tso transfer list -m Google --json-out ./snap
 ```
 
 ---
@@ -188,7 +188,7 @@ siluzan-tso transfer create -m <媒体> --out <转出ID> --in <转入ID> --amoun
 | `--in <id>`              | 转入账户 `mediaCustomerId`                         | ✅   |
 | `--amount <amount>`      | 转账金额（与账户货币单位一致）                     | ✅   |
 | `--customer-name <name>` | 客户名称备注（可选）                               |      |
-| `--json`                 | 输出原始 JSON                                      |      |
+| `--json-out`                 | 输出原始 JSON                                      |      |
 
 **示例：**
 
@@ -210,13 +210,13 @@ siluzan-tso transfer create -m Google --out 1234567890 --in 9876543210 --amount
 siluzan-tso invoice list [选项]
 ```
 
-> **与投放报表类任务不同**：用户只说「本月开票记录」而未写起止日时，可用**当月 1 日 ~ 昨天**（`Asia/Shanghai` 日历）直接执行 `invoice list --start … --end … --json`，**不必**先做 SKILL「投放数据」类的时间范围 A/B/C 反问；若用户随后纠正区间再重查即可。
+> **与投放报表类任务不同**：用户只说「本月开票记录」而未写起止日时，可用**当月 1 日 ~ 昨天**（`Asia/Shanghai` 日历）直接执行 `invoice list --start … --end … --json-out ./snap`，**不必**先做 SKILL「投放数据」类的时间范围 A/B/C 反问；若用户随后纠正区间再重查即可。
 
 | 选项                     | 说明                   |
 | ------------------------ | ---------------------- |
 | `-k, --keyword <text>`   | 发票号/关键字          |
 | `--start / --end <date>` | 日期范围（YYYY-MM-DD） |
-| `--json`                 | 输出原始 JSON          |
+| `--json-out`                 | 输出原始 JSON          |
 
 **示例：**
 
@@ -231,7 +231,7 @@ siluzan-tso invoice list --start 2026-03-01 --end 2026-03-31
 siluzan-tso invoice list -k "INV2026001"
 
 # JSON 输出
-siluzan-tso invoice list --json
+siluzan-tso invoice list --json-out ./snap
 ```
 
 ---
@@ -250,7 +250,7 @@ siluzan-tso invoice billable [选项]
 | `-c, --currency <code>`  | 币种，如 `USD \| CNY`  |
 | `--wallet`               | 查询钱包充值可开票记录 |
 | `--start / --end <date>` | 日期范围               |
-| `--json`                 | 输出原始 JSON          |
+| `--json-out`                 | 输出原始 JSON          |
 
 **示例：**
 
@@ -262,7 +262,7 @@ siluzan-tso invoice billable -m Google -c USD
 siluzan-tso invoice billable --wallet
 
 # JSON 输出，获取 billId 供后续 apply 使用
-siluzan-tso invoice billable -m Google --json
+siluzan-tso invoice billable -m Google --json-out ./snap
 ```
 
 ---
@@ -311,7 +311,7 @@ siluzan-tso invoice apply \
 
 | 选项                      | 说明                                                                                | 必填           |
 | ------------------------- | ----------------------------------------------------------------------------------- | -------------- |
-| `--bill-ids`              | 可开票订单 `entityId`，逗号分隔（来自 `invoice billable --json`）                   | ✅             |
+| `--bill-ids`              | 可开票订单 `entityId`，逗号分隔（来自 `invoice billable --json-out ./snap`）                   | ✅             |
 | `--bill-type`             | 账单来源类型：`AmountAccount`（充值开票）\| `WalletRecharge`（钱包开票）            | ✅             |
 | `--invoice-type`          | 发票格式：`PI`（形式发票，境外英文）\| `VATI`（增值税普票）\| `VATSI`（增值税专票） | ✅             |
 | `--recipient-name`        | 收件人姓名                                                                          | ✅             |
@@ -330,7 +330,7 @@ siluzan-tso invoice apply \
 
 ```bash
 # 第一步：查询可开票订单，记录 entityId
-siluzan-tso invoice billable -m Google --json
+siluzan-tso invoice billable -m Google --json-out ./snap
 # 从输出中找到目标订单的 entityId
 
 # 第二步：提交开票申请（形式发票 PI 示例）
@@ -361,7 +361,7 @@ siluzan-tso invoice apply \
 #### 2. 再让用户选择发票抬头
 
 - 根据已选订单的**币种**确定允许的发票类型（与上文规则一致：人民币 → `VATI`/`VATSI`；外币 → `PI`）。
-- 执行 `siluzan-tso invoice-info list --invoice-type <PI|VATI|VATSI>`（需要结构化数据时用 `--json`），向用户展示**已保存的发票抬头列表**。
+- 执行 `siluzan-tso invoice-info list --invoice-type <PI|VATI|VATSI>`（需要结构化数据时用 `--json-out <路径>`），向用户展示**已保存的发票抬头列表**。
 - 请用户**从列表中选一条**（按 id 或公司名/抬头说明），或明确说要用**新的自定义抬头**。
 
 #### 3. 自定义抬头：先匹配列表，没有再创建