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

package/dist/skill/references/{workflows.md → core/workflows.md}

@@ -9,37 +9,35 @@
 
 宿主编排相关文档（**入口** + 两份子页）：
 
-- **`references/hosted-automation-scenarios.md`** — 索引与导航
-- **`references/hosted-automation-self-control.md`** — 三类场景（**单日预算熔断**、**CPA 飙升降价**、**连续空耗暂停**）的逐步命令、字段对照、系数与复核
-- **`references/hosted-automation-monitoring-json.md`** — 异常监控（余额/`campaign-hour`/落地页/拒审等 **`--json` 键名与命令**）
-- **`references/hosted-automation-optimize-index.md`** — 自动优化（差素材降价/关停、高转化扩量、A/B 决胜负）**分文件 SOP**
+- **`references/operations/hosted-automation-scenarios.md`** — 索引与导航
+- **`references/operations/hosted-automation-self-control.md`** — 三类场景（**单日预算熔断**、**CPA 飙升降价**、**连续空耗暂停**）的逐步命令、字段对照、系数与复核
+- **`references/operations/hosted-automation-monitoring-json.md`** — 异常监控（余额/`campaign-hour`/落地页/拒审等 **`--json-out` 落盘 JSON 键名与命令**）
+- **`references/operations/hosted-automation-optimize-index.md`** — 自动优化（差素材降价/关停、高转化扩量、A/B 决胜负）**分文件 SOP**
 
-本文件其余章节仍为其他业务流程；实现上述自控、监控或自动优化时按需打开子页，并配合 `references/tips.md`（`--json`）、`references/google-ads.md`（写命令与拒审字段）、`references/account-analytics.md`（时间窗与报表）、`references/accounts.md`（`balance` / `balance-scan`）。
+本文件其余章节仍为其他业务流程；实现上述自控、监控或自动优化时按需打开子页，并配合 `references/core/tips.md`（`--json-out`）、`references/google-ads/google-ads.md`（写命令与拒审字段）、`references/analytics/account-analytics.md`（时间窗与报表）、`references/accounts/accounts.md`（`balance` / `balance-scan`）。
 
 ---
 
 ## 关键词规划师（拓词 / 词包）
 
-**`references/keyword-planner-workflows.md`**：`keyword` / `google-analysis` 拓词编排；**不含**建户 JSON（见下节）。
+**`references/analytics/keyword-planner-workflows.md`**：`keyword` / `google-analysis` 拓词编排；**不含**建户 JSON（见下节）。
 
 ## Google 搜索系列方案 + 创建（Agent）
 
-**`references/google-ads-campaign-plan.md`**：双轨入口、7 步流水线、`campaign-validate` 门禁、`campaign-create` + batch。字段契约见 `assets/campaign-create-template.md`；命令参数见 `references/google-ads.md`。
+**`references/google-ads/google-ads-campaign-plan.md`**：双轨入口、7 步流水线、`campaign-validate` 门禁、`campaign-create` + batch。字段契约见 `assets/campaign-create-template.md`；命令参数见 `references/google-ads/google-ads.md`。
 
 ---
 
 ## 流程一：新账户开通（Google / TikTok / Yandex / Bing / Kwai）
 
-对应页面：`/accountOpeningHistory`
+**主文档**：`references/accounts/open-account-by-media.md`（各媒体命令与参数）。Google 网页对照见 `accounts/open-account-google-ui.md`。
 
-> **网页完整链接（微前端）**：`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`（与 CLI `account-history` 同源数据）。开户提交后若需用户在网页确认，应打开此「开户记录」页，**不要**误链到「媒体账户」`manageAccounts`。
-
-### 业务背景
-
-用户在丝路赞上还没有某媒体账户时，需要提交开户申请并跟踪审核进度。**各媒体所需资料和命令参数完全不同，不要混用。**
+对应页面：`/accountOpeningHistory`。网页链接：`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`。
 
 > **AI Agent 注意**：`open-account google-wizard` 需要真实 TTY，Agent 环境无法使用，始终用非交互命令。
 
+以下保留完整示例供 workflows 内联阅读；维护时以 `accounts/open-account-by-media.md` 为准。
+
 ---
 
 ### Google 开户
@@ -200,13 +198,13 @@ siluzan-tso account-history -m Google
 | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复轮询                                                                                                      |
 | `Approved` | 审核通过 | `list-accounts` 确认账户出现；引导用户充值激活（见各媒体第四步）                                                      |
-| `Rejected` | 被拒     | 查看拒绝原因（`account-history --json` 的 `reason` 字段）；修改资料后重新提交；如无法确定原因，引导用户联系丝路赞客服 |
+| `Rejected` | 被拒     | 查看拒绝原因（`account-history --json-out ./snap` 的 `reason` 字段）；修改资料后重新提交；如无法确定原因，引导用户联系丝路赞客服 |
 
 ---
 
 ## 流程二：AI 智投创建 → 审核 → 发布
 
-对应页面：`/advertising/AICreation`（创建向导）、`/advertising/AICreationList`（记录列表）。`ad batch` 命令见 **`references/google-ads.md`** § ad batch。
+对应页面：`/advertising/AICreation`（创建向导）、`/advertising/AICreationList`（记录列表）。`ad batch` 命令见 **`references/google-ads/google-ads.md`** § ad batch。
 
 ### 业务背景
 
@@ -223,7 +221,7 @@ AI 智投会生成一份 Google 广告草稿（包含系列/组/关键词/广告
 siluzan-tso ad batch list --customer-id <mediaCustomerId>
 
 # 过滤只看未发布草稿
-siluzan-tso ad batch list --state Unpublished --json
+siluzan-tso ad batch list --state Unpublished --json-out ./snap
 
 # 第二步：查看草稿详情（包含完整的广告系列/关键词/预算等配置）
 siluzan-tso ad batch get --id <recordId>
@@ -281,14 +279,14 @@ Failed / HasFailed（部分或全部失败）
 ├─ 有已保存的 AI 智投草稿（网页向导填写的）？
 │    └─ 是 → 流程二（ad batch update/publish）
 ├─ 需先出投放方案（口述/官网/拓词）？
-│    └─ 是 → references/google-ads-campaign-plan.md → campaign-validate → campaign-create
+│    └─ 是 → references/google-ads/google-ads-campaign-plan.md → campaign-validate → campaign-create
 └─ 已有完整 JSON 或结构化计划？
      └─ 是 → 本流程（campaign-validate → campaign-create）
 ```
 
 ### 场景 A：一体化创建（系列 + 关键词 + 广告，推荐）
 
-**方案阶段**：按 **`references/google-ads-campaign-plan.md`**（JSON → `campaign-validate` → Markdown → 用户确认 → create）。下文为命令串联速查。
+**方案阶段**：按 **`references/google-ads/google-ads-campaign-plan.md`**（JSON → `campaign-validate` → Markdown → 用户确认 → create）。下文为命令串联速查。
 
 ```bash
 # 前置：地域 ID 写入 JSON（campaign.targetedLocations[].id）
@@ -304,7 +302,7 @@ siluzan-tso ad campaign-create --config-file ./campaign.json
 siluzan-tso ad batch get --id <taskId>
 
 # 创建完成后确认系列已出现，并获取 campaignId 供后续精细操作
-siluzan-tso ad campaigns -a <mediaCustomerId> --json
+siluzan-tso ad campaigns -a <mediaCustomerId> --json-out ./snap
 ```
 
 **关键词格式说明**：
@@ -327,8 +325,8 @@ siluzan-tso ad batch get --id <taskId>
 # 等 status → Successfully
 
 # 第三步：查询广告系列，获取 campaignId 和 adGroupId
-siluzan-tso ad campaigns -a <mediaCustomerId> --json
-siluzan-tso ad groups -a <mediaCustomerId> --json
+siluzan-tso ad campaigns -a <mediaCustomerId> --json-out ./snap
+siluzan-tso ad groups -a <mediaCustomerId> --json-out ./snap
 
 # 第四步（可选）：关键词推荐辅助选词
 siluzan-tso keyword -k "跑步鞋,running shoes" --exclude "cheap,kids"
@@ -380,7 +378,7 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status P
 siluzan-tso ad ad-delete -a <mediaCustomerId> --id <adId>
 
 # 查看并清理否定关键词
-siluzan-tso ad keywords -a <mediaCustomerId> --negative --json
+siluzan-tso ad keywords -a <mediaCustomerId> --negative --json-out ./snap
 siluzan-tso ad keyword-negative-delete -a <mediaCustomerId> --id <negKwId>
 ```
 
@@ -388,7 +386,7 @@ siluzan-tso ad keyword-negative-delete -a <mediaCustomerId> --id <negKwId>
 
 ## 流程四：AI 广告优化建议查看与执行
 
-对应页面：`/advertising/intelligentOptimization`（v2）。`optimize` 命令与脱管账户说明见 **`references/optimize.md`**。
+对应页面：`/advertising/intelligentOptimization`（v2）。`optimize` 命令与脱管账户说明见 **`references/operations/optimize.md`**。
 
 ### 业务背景
 
@@ -399,7 +397,7 @@ AI 优化模块会分析账户的投放数据，给出优化建议（如调整
 siluzan-tso optimize list -a <mediaCustomerId>
 
 # 已不在 Siluzan 托管：勿用 -a（接口常 0 条）。用全量翻页 + 客户端筛 Google 客户号，再取 items[].id
-# siluzan-tso optimize list --match-media-customer-id <mediaCustomerId> [--start YYYY-MM-DD] --json
+# siluzan-tso optimize list --match-media-customer-id <mediaCustomerId> [--start YYYY-MM-DD] --json-out ./snap
 
 # 第二步：系列级优化记录（可选日期；脱管账户勿依赖 -a）
 siluzan-tso optimize records --start 2026-03-01
@@ -407,7 +405,7 @@ siluzan-tso optimize records --start 2026-03-01
 # 第三步：广告系列级明细（parentId = 上一步 list 里某批次的 id / entityId）
 siluzan-tso optimize children --parent-id <parentId>
 
-# 单条详情：id 可为 list 批次 id，或 records --json 的 items[].id
+# 单条详情：id 可为 list 批次 id，或 records --json-out ./snap 的 items[].id
 siluzan-tso optimize get --id <recordUuid>
 
 # 根据建议执行操作（以"暂停低效广告组"为例）
@@ -483,7 +481,7 @@ siluzan-tso forewarning delete -m Google --id <ruleId>
 
 ```bash
 # 查看触发了预警的账户
-siluzan-tso forewarning records -m Google --start 2026-03-20 --json
+siluzan-tso forewarning records -m Google --start 2026-03-20 --json-out ./snap
 
 # 确认对应账户的实际消耗
 siluzan-tso stats -m Google -a <entityId> --start 2026-03-20
@@ -496,7 +494,7 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status P
 
 ## 流程六：优化报告生成 → 推送管理
 
-对应页面：`/dataReport/optimizationReport`、`/dataReport/pushRecord`。命令与接口详解见 **`references/reporting.md`**。
+对应页面：`/dataReport/optimizationReport`、`/dataReport/pushRecord`。命令与接口详解见 **`references/analytics/reporting.md`**。
 
 ### 业务背景
 
@@ -504,7 +502,7 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status P
 
 ```bash
 # 第一步：查询可生成报告的账户列表
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 
 # 第二步：批量生成上月日报（-a 传 mediaCustomerId，不是 entityId）
 siluzan-tso report create \
@@ -519,15 +517,15 @@ siluzan-tso report list -m Google --status true
 
 # 第四步：获取报告查看链接（viewUrl 字段已直接包含在输出中，无需手动拼接）
 siluzan-tso report list -m Google
-# 表格中 viewUrl 列即为可点击的网页链接；--json 输出时每条记录含 viewUrl 字段
+# 表格中 viewUrl 列即为可点击的网页链接；--json-out 落盘时每条记录含 viewUrl 字段
 
 # 第五步：查看推送配置列表（是否已开启自动推送；接口同 GET .../query/report-push/settings/Google）
 siluzan-tso report push list -m Google
-# siluzan-tso report push list -m Google --json   # items[].entityId / id 用于启停删、history、update
-# siluzan-tso report push receive-emails -m Google [--json]   # 历史收件邮箱，与网页推送配置下拉同源
+# siluzan-tso report push list -m Google --json-out ./snap   # items[].entityId / id 用于启停删、history、update
+# siluzan-tso report push receive-emails -m Google [--json-out ./snap]   # 历史收件邮箱，与网页推送配置下拉同源
 
 # 推送记录（网页 /dataReport/pushRecord?entityId=...）
-# siluzan-tso report push history -m Google --setting-id <推送规则entityId> --json
+# siluzan-tso report push history -m Google --setting-id <推送规则entityId> --json-out ./snap
 
 # 新建 / 编辑（网页弹窗；--media-accounts 为 ma.entityId）
 # siluzan-tso report push create -m Google --name "..." --media-accounts <id,...> --emails a@b.com --types Daily
@@ -545,7 +543,7 @@ siluzan-tso report delete --ids <id1>,<id2>
 
 ## 流程六点五：账户分析报告（CLI 拉数 + Agent 撰稿）
 
-对应能力：`google-analysis`、`report meta-overview`、`report tiktok-*`、`report bing-*` 与 `report-templates/*.md`。子命令与模板索引见 **`references/account-analytics.md`**。
+对应能力：`google-analysis`、`report meta-overview`、`report tiktok-*`、`report bing-*` 与 `report-templates/*.md`。子命令与模板索引见 **`references/analytics/account-analytics.md`**。
 
 ### 与流程六的区别
 
@@ -573,11 +571,11 @@ siluzan-tso report delete --ids <id1>,<id2>
 
 ```bash
 # 第一步：查询可开票订单（按媒体和币种筛选）
-siluzan-tso invoice billable -m Google -c USD --json
+siluzan-tso invoice billable -m Google -c USD --json-out ./snap
 # 记录目标订单的 entityId（字段名 entityId，不是过时的 billId）
 
 # 若需要查询钱包充值的可开票金额
-siluzan-tso invoice billable --wallet --json
+siluzan-tso invoice billable --wallet --json-out ./snap
 
 # 第二步：提交开票申请（USD 订单示例：仅 PI + 英文抬头与地址）
 siluzan-tso invoice apply \
@@ -590,7 +588,7 @@ siluzan-tso invoice apply \
   --recipient-name "张三" \
   --recipient-phone 13800138000
 
-# 人民币订单请使用 --invoice-type VATI 或 VATSI，并填写 --company-name、--tax-id、--title、--company-phone 等（见 finance.md）
+# 人民币订单请使用 --invoice-type VATI 或 VATSI，并填写 --company-name、--tax-id、--title、--company-phone 等（见 accounts/finance.md）
 
 # 第三步：查询开票申请状态
 siluzan-tso invoice list --start 2026-03-01
@@ -600,7 +598,7 @@ siluzan-tso invoice list --start 2026-03-01
 
 ## 流程八：广告线索数据提取与跟进
 
-对应页面：`/clue-form`。`clue` 命令参数见 **`references/clue.md`**。
+对应页面：`/clue-form`。`clue` 命令参数见 **`references/operations/clue.md`**。
 
 ### 业务背景
 
@@ -609,7 +607,7 @@ siluzan-tso invoice list --start 2026-03-01
 ```bash
 # 第一步：确认有哪些 TikTok/Meta 账户
 siluzan-tso list-accounts -m TikTok
-siluzan-tso list-accounts --json | Select-String "MetaAd"  # 或用 --json 过滤
+siluzan-tso list-accounts --json-out ./snap | Select-String "MetaAd"  # 或用 --json-out ./snap 过滤
 
 # 第二步：拉取 TikTok 线索（按区域分类查看）
 # 全部区域
@@ -619,28 +617,28 @@ siluzan-tso clue -m TikTok -a <advertiserId>
 siluzan-tso clue -m TikTok -a <advertiserId> --region eu
 
 # 导出为 JSON 供后续处理
-siluzan-tso clue -m TikTok -a <advertiserId> --json > tiktok-leads.json
+siluzan-tso clue -m TikTok -a <advertiserId> --json-out ./snap > tiktok-leads.json
 
 # 第三步：拉取 Meta 线索（指定日期范围）
 siluzan-tso clue -m Meta -a <pageId> \
   --start 2026-03-01 \
   --end 2026-03-31 \
-  --json > meta-leads.json
+  --json-out ./snap > meta-leads.json
 ```
 
 **定期线索提取（建议每日/每周执行）**：
 
 ```bash
 # TikTok 全账户线索（如有多个 advertiserId，逐个执行）
-siluzan-tso list-accounts -m TikTok --json
+siluzan-tso list-accounts -m TikTok --json-out ./snap
 # 对每个账户：
-siluzan-tso clue -m TikTok -a <advertiserId> --json
+siluzan-tso clue -m TikTok -a <advertiserId> --json-out ./snap
 
 # Meta 线索（本周）
 siluzan-tso clue -m Meta -a <pageId> \
   --start 2026-03-17 \
   --end 2026-03-20 \
-  --json
+  --json-out ./snap
 ```
 
 ---
@@ -657,7 +655,7 @@ siluzan-tso clue -m Meta -a <pageId> \
 # ─── 场景A：将账户分享给团队成员 ───
 
 # 第一步：确认要分享的账户 entityId
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 # 找到目标账户的 entityId（不是 mediaCustomerId！）
 
 # 第二步：分享给指定手机号（手机号需已在丝路赞注册）
@@ -673,7 +671,7 @@ siluzan-tso account unshare --id <entityId> --account-id <userId>
 # ─── 场景B：OAuth Token 过期，重新授权 ───
 
 # 检查账户状态（invalidOAuthToken = true 表示需要重新授权）
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 
 # 重新触发 OAuth 授权流程（会在浏览器打开授权页）
 siluzan-tso account auth -m Google
@@ -685,7 +683,7 @@ siluzan-tso list-accounts -m Google
 # ─── 场景C：从平台解绑账户 ───
 
 # 先查出 entityId
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 
 # 断开单个账户（操作前确认账户名/ID 正确）
 siluzan-tso account delink --id <entityId>
@@ -703,7 +701,7 @@ siluzan-tso list-accounts -m Google
 siluzan-tso config show
 
 # 从列表中取子账户的 mediaCustomerId（数字 ID），不是 entityId
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 
 # 将一个或多个子账户绑定到指定 MCC（多个 MCC ID 可用逗号或分号分隔）
 siluzan-tso account mcc-bind --customers <mediaCustomerId1>,<mediaCustomerId2> --mcc <MCC客户ID>
@@ -711,8 +709,8 @@ siluzan-tso account mcc-bind --customers <mediaCustomerId1>,<mediaCustomerId2> -
 # 解绑：从子账户上移除与某 MCC 的关联
 siluzan-tso account mcc-unbind --customers <mediaCustomerId> --mcc <MCC客户ID>
 
-# 需要排查接口返回时加 --json
-siluzan-tso account mcc-bind --customers <mediaCustomerId> --mcc <MCC客户ID> --json
+# 需要排查接口返回时加 --json-out ./snap
+siluzan-tso account mcc-bind --customers <mediaCustomerId> --mcc <MCC客户ID> --json-out ./snap
 ```
 
 ---
@@ -728,7 +726,7 @@ siluzan-tso account mcc-bind --customers <mediaCustomerId> --mcc <MCC客户ID> -
 
 # 查看各媒体账户余额（确保余额充足）
 # 注意：balance -a 传 mediaCustomerId（数字ID），不是 entityId
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 siluzan-tso balance -m Google -a <mediaCustomerId1>,<mediaCustomerId2>
 siluzan-tso balance -m TikTok -a <mediaCustomerId3>
 
@@ -753,12 +751,12 @@ siluzan-tso ad batch list --state Failed
 siluzan-tso ad batch list --state HasFailed
 
 # 检查线索数据
-siluzan-tso clue -m TikTok -a <advertiserId> --json
-siluzan-tso clue -m Meta -a <pageId> --start 2026-03-11 --end 2026-03-17 --json
+siluzan-tso clue -m TikTok -a <advertiserId> --json-out ./snap
+siluzan-tso clue -m Meta -a <pageId> --start 2026-03-11 --end 2026-03-17 --json-out ./snap
 
 # 查看本周优化建议（托管中）
 siluzan-tso optimize list -a <mediaCustomerId>
-# 已脱管：optimize list --match-media-customer-id <mediaCustomerId> --json → items[].id
+# 已脱管：optimize list --match-media-customer-id <mediaCustomerId> --json-out ./snap → items[].id
 # siluzan-tso optimize get --id <id>
 # siluzan-tso optimize children --parent-id <id>
 ```
@@ -781,7 +779,7 @@ siluzan-tso transfer list -m Google
 siluzan-tso transfer list -m TikTok --start 2026-03-01 --end 2026-03-31
 
 # JSON 输出供对账使用
-siluzan-tso transfer list -m Google --json
+siluzan-tso transfer list -m Google --json-out ./snap
 
 # 对账：转账到账后查询账户余额（传 mediaCustomerId）
 siluzan-tso balance -m Google -a <mediaCustomerId>
@@ -814,7 +812,7 @@ siluzan-tso config show   # 取 webUrl
 
 ```bash
 # 如果链接或落地页异常，先确认账户 OAuth 正常
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 # 检查 invalidOAuthToken 字段，若为 true 则先重新授权
 siluzan-tso account auth -m Google
 ```
@@ -823,7 +821,7 @@ siluzan-tso account auth -m Google
 
 | 诊断评级         | 建议操作                                             |
 | ---------------- | ---------------------------------------------------- |
-| 优秀（85分以上） | 可直接投放；CLI 方案轨见 `google-ads-campaign-plan.md` |
+| 优秀（85分以上） | 可直接投放；CLI 方案轨见 `google-ads/google-ads-campaign-plan.md` |
 | 良好（70-84分）  | 建议优化后投放，可先小预算测试                       |
 | 一般（60-69分）  | 重点改善转化代码和页面速度后再投                     |
 | 较差（60分以下） | 需先修复关键问题（参考诊断报告），否则广告效果会很差 |
@@ -842,7 +840,7 @@ siluzan-tso account auth -m Google
 
 ```bash
 # 第一步：确认要关闭的 TikTok 账户
-siluzan-tso list-accounts -m TikTok --json
+siluzan-tso list-accounts -m TikTok --json-out ./snap
 # 记录目标账户的 mediaCustomerId
 
 # 第二步：关闭账户（操作不可恢复，请再次确认）
@@ -861,7 +859,7 @@ siluzan-tso list-accounts -m TikTok
 
 ```bash
 # 第一步：查出 Meta 账户 mediaCustomerId
-siluzan-tso list-accounts --json   # 找到 MetaAd 类型账户的 mediaCustomerId
+siluzan-tso list-accounts --json-out ./snap   # 找到 MetaAd 类型账户的 mediaCustomerId
 
 # 第二步：绑定到指定 Business Manager
 siluzan-tso account bm-bind \
@@ -897,13 +895,13 @@ siluzan-tso config show   # 取 webUrl
 # → 选中 Google 账户 → 点击「激活账户」→ 选择激活方式
 ```
 
-激活/充值产生的账单明细可用 CLI 查询（`entityId` 来自 `list-accounts -m Google --json`）：
+激活/充值产生的账单明细可用 CLI 查询（`entityId` 来自 `list-accounts -m Google --json-out ./snap`）：
 
 ```bash
-siluzan-tso account-active-bills -m Google --id <entityId> [--json]
+siluzan-tso account-active-bills -m Google --id <entityId> [--json-out ./snap]
 ```
 
-详见 `references/accounts.md` 中 **account-active-bills**。
+详见 `references/accounts/accounts.md` 中 **account-active-bills**。
 
 ### 场景 E：Google 邮箱授权管理
 
@@ -917,7 +915,7 @@ siluzan-tso account email-auth -c <mediaCustomerId> --email user@gmail.com
 # 只读权限
 siluzan-tso account email-auth -c <mediaCustomerId> --email user@gmail.com --access-role ReadOnly
 
-# 撤销邀请（先从 email-auth-list --json 取 invitationId 和 resourceName）
+# 撤销邀请（先从 email-auth-list --json-out ./snap 取 invitationId 和 resourceName）
 siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --resource-name <name>
 # 若邀请尚未被接受，追加 --pending
 siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --resource-name <name> --pending
@@ -942,13 +940,13 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
    → 与 **流程十** 相同思路：
 
 ```bash
-siluzan-tso list-accounts -m Google --json
+siluzan-tso list-accounts -m Google --json-out ./snap
 siluzan-tso balance -m Google -a <mediaCustomerId>
 siluzan-tso stats -m Google -a <mediaCustomerId>
 siluzan-tso account-history -m Google
 ```
 
 3. **首页「服务推荐」跳转 AI / 建站 / 内容等**  
-   → 属其他产品线，见 **`references/tso-home.md`** 中的外链说明，勿用 `siluzan-tso` 冒充。
+   → 属其他产品线，见 **`references/misc/misc/tso-home.md`** 中的外链说明，勿用 `siluzan-tso` 冒充。
 
-**详细模块与接口对照** → **`references/tso-home.md`**。
+**详细模块与接口对照** → **`references/misc/misc/tso-home.md`**。

package/dist/skill/references/{google-ads-campaign-plan.md → google-ads/google-ads-campaign-plan.md}

@@ -1,6 +1,6 @@
 # Google 搜索广告：方案生成与系列创建
 
-> 所属 skill：`siluzan-tso`。**新建/规划搜索系列时 Read 本文件**，再按需打开下表子文档。命令参数与 CRUD 见 `references/google-ads.md`。
+> 所属 skill：`siluzan-tso`。**新建/规划搜索系列时 Read 本文件**，再按需打开下表子文档。命令参数与 CRUD 见 `references/google-ads/google-ads.md`。
 
 ---
 
@@ -13,7 +13,7 @@
 
 - 可执行真相只有 **JSON**（`assets/campaign-create-template.json` 同构）；Markdown 只读投影。
 - 改需求 **只改 JSON**，再 `campaign-validate`，再刷新 Markdown。
-- **PMax 系列创建暂未开放**：勿用 `ad pmax-*` 搭建命令；请在 Google Ads UI 操作。运营诊断（只读）见 `google-ads-rules/google-ads-pmax-guide.md`。
+- **PMax 系列创建**走独立流水线（勿用本文件 JSON 模板）：`assets/pmax-create-template.md` + `ad pmax-validate` / `ad pmax-create`；运营诊断见 `google-ads/rules/google-ads-pmax-guide.md`。
 - 搜索网络：仅 Google 搜索（`TargetSearchNetwork`/`TargetContentNetwork`/`TargetPartnerSearchNetwork` 均为 false）。
 
 ---
@@ -22,16 +22,16 @@
 
 | 步 | 动作 | 文档/命令 |
 |----|------|-----------|
-| 1 | `list-accounts` 锁定 `account` / `customerName` / 币种 | `references/currency.md` |
-| 2 | 可选 `rag query`；`keyword` / `keyword geo-list` 拓词 | `references/keyword-planner-workflows.md` |
-| 3 | 按分层规则写入 `KeywordsForBatchJob`（Exact/Phrase/Broad） | `google-ads-rules/google-ads-keyword-taxonomy.md`（参考，非 CLI 强制） |
+| 1 | `list-accounts` 锁定 `account` / `customerName` / 币种 | `references/accounts/currency.md` |
+| 2 | 可选 `rag query`；`keyword` / `keyword geo-list` 拓词 | `references/analytics/keyword-planner-workflows.md` |
+| 3 | 按分层规则写入 `KeywordsForBatchJob`（Exact/Phrase/Broad） | `google-ads/rules/google-ads-keyword-taxonomy.md`（参考，非 CLI 强制） |
 | 4 | 填 `campaign`（预算/出价/地域/否词≥20/RSA/附加信息） | `assets/campaign-create-template.md` |
 | 5 | **`ad campaign-validate --config-file <json>`**（失败只改 JSON；超长见下文「超长人工确认」） | 下文「校验」 |
 | 6 | 输出：**JSON 代码块** → **Markdown**（`google-ads-launch-plan-template.md` 正文）→ 待确认 | — |
-| 7 | 用户确认后 **`ad campaign-create`** | `google-ads.md`|
+| 7 | 用户确认后 **`ad campaign-create`** | `google-ads/google-ads.md`|
 | 8 | 每隔5s 获取创建结果| `ad batch get --id <taskId> --config-file ./campaign.json` |
 | 9 | 创建失败根据失败原因修改json重新走创建流程，部分成功/成功/部分失败：都调用来做最后一步调整 `ad batch diff --batch-id <taskId> --config-file ./campaign.json` | |
-| 10 | 输出所有失败的内容与原因，并询问用户是否需要修改后单独添加到系列中如果用户要求是则读取 `references\google-ads.md` 来获取对应缺失部分的创建命令 |
+| 10 | 输出所有失败的内容与原因，并询问用户是否需要修改后单独添加到系列中如果用户要求是则读取 `references\google-ads/google-ads.md` 来获取对应缺失部分的创建命令 |
 
 
 
@@ -45,26 +45,26 @@
 
 | 文档 | 用途 |
 |------|------|
-| `google-ads-rules/google-ads-keyword-taxonomy.md` | 核心/长尾与匹配块**建议**（Agent 参考，CLI 不强制） |
-| `google-ads-rules/google-ads-compliance.md` | 词与文案合规 |
-| `google-ads-rules/sensitive-industries.md` | 敏感行业（若相关） |
-| `google-ads-rules/google-ads-launch-plan-template.md` | 用户可见 Markdown 结构与 RSA/否词表 |
-| `google-ads-rules/google-ads-creative-optimization.md` | RSA 12–15 条、Callout/Sitelink |
+| `google-ads/rules/google-ads-keyword-taxonomy.md` | 核心/长尾与匹配块**建议**（Agent 参考，CLI 不强制） |
+| `google-ads/rules/google-ads-compliance.md` | 词与文案合规 |
+| `google-ads/rules/sensitive-industries.md` | 敏感行业（若相关） |
+| `google-ads/rules/google-ads-launch-plan-template.md` | 用户可见 Markdown 结构与 RSA/否词表 |
+| `google-ads/rules/google-ads-creative-optimization.md` | RSA 12–15 条、Callout/Sitelink |
 | `assets/campaign-create-template.md` | JSON 字段契约 |
 
 ### 按需（触及时再读）
 
 | 文档 | 何时 |
 |------|------|
-| `google-ads-rules/google-ads-keyword-strategy.md` | 分组/匹配/否定词策略争议 |
-| `google-ads-rules/google-ads-campaign-optimization.md` | 出价策略、预算、学习期 |
-| `google-ads-rules/google-ads-landing-page-discovery-via-webfetch.md` | 仅首页、需推断 PDP/PLP |
-| `google-ads-rules/google-ads-conversion-architecture.md` | 转化/EC/归因说明 |
-| `google-ads-rules/google-ads-keyword-optimization.md` | 上线后优化，非首建 |
-| `google-ads-rules/google-ads-account-audit.md` | 账户诊断，非首建 |
-| `google-ads-rules/google-ads-audience-strategy.md` | 受众/RLSA |
-| `google-ads-rules/google-ads-pmax-guide.md` | PMax 运营/诊断（只读参考；**CLI 搭建暂未开放**） |
-| `references/pmax-api.md` | PMax 网关路径（开发参考；生产勿调用搭建命令） |
+| `google-ads/rules/google-ads-keyword-strategy.md` | 分组/匹配/否定词策略争议 |
+| `google-ads/rules/google-ads-campaign-optimization.md` | 出价策略、预算、学习期 |
+| `google-ads/rules/google-ads-landing-page-discovery-via-webfetch.md` | 仅首页、需推断 PDP/PLP |
+| `google-ads/rules/google-ads-conversion-architecture.md` | 转化/EC/归因说明 |
+| `google-ads/rules/google-ads-keyword-optimization.md` | 上线后优化，非首建 |
+| `google-ads/rules/google-ads-account-audit.md` | 账户诊断，非首建 |
+| `google-ads/rules/google-ads-audience-strategy.md` | 受众/RLSA |
+| `google-ads/rules/google-ads-pmax-guide.md` | PMax 运营/诊断；**创建**见 `assets/pmax-create-template.md` |
+| `references/google-ads/pmax-api.md` | PMax 网关路径与 Search API 边界 |
 
 复述给用户：**3–5 条**与本次任务相关的合规/策略要点即可，无需罗列全部文件名。
 
@@ -74,7 +74,7 @@
 
 ```bash
 siluzan-tso ad campaign-validate --config-file ./campaign.json --json-out ./snap-campaign
-siluzan-tso ad campaign-validate --config-file ./campaign.json [--json] [--write-normalized <path>]
+siluzan-tso ad campaign-validate --config-file ./campaign.json [--json-out ./snap] [--write-normalized <path>]
 siluzan-tso ad campaign-create --config-file ./campaign.json
 siluzan-tso ad batch get --id <taskId> --config-file ./campaign.json
 siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json
@@ -87,16 +87,16 @@ validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 +
 
 标题/描述/Path/关键词/Sitelink 超限时 CLI **报错阻断**，不会在 JSON 里静默改短。
 
-1. 使用 **`ad campaign-validate --config-file <json> --json-out <dir>`**（与 create/batch 同一落盘目录），读落盘文件中的 `lengthViolations`（每项含 `path`、`limit`、`actual`、**完整** `text`）。小文件可用 `--json` 代替。
+1. 使用 **`ad campaign-validate --config-file <json> --json-out <dir>`**（与 create/batch 同一落盘目录），读落盘文件中的 `lengthViolations`（每项含 `path`、`limit`、`actual`、**完整** `text`）。
 2. Agent 将 **全部** 超长条目整理成表（路径、原文、上限、超出量），并为每条给出 **1–2 个改写方案**（保留卖点、符合字符计数；CJK 按 2 计见 `google-ads-compliance.md` §3.2.1）。
 3. **用户确认**选用方案后，Agent **只改 JSON 对应字段**，再执行 `campaign-validate`；通过后再 `campaign-create`。
 4. **禁止**：未确认前 `slice`/省略号截断、仅改 `--write-normalized` 而不经用户确认。
 
-人读模式失败时 CLI 会额外打印「📏 超长内容清单」；`--json-out` / `--json` 时见 `lengthViolations` + `agentHint`。
+人读模式失败时 CLI 会额外打印「📏 超长内容清单」；`--json-out` 时见 `lengthViolations` + `agentHint`。
 
 ---
 
 ## 已上线后的修改
 
-- **勿**用 `campaign-create` 覆盖已有系列；用 `ad campaign-edit` / `adgroup-*` / `keyword-*` / `ad-edit` 等（见 `google-ads.md`）。
+- **勿**用 `campaign-create` 覆盖已有系列；用 `ad campaign-edit` / `adgroup-*` / `keyword-*` / `ad-edit` 等（见 `google-ads/google-ads.md`）。
 - 若属「推倒重建」：更新 JSON → validate → 新系列 `campaign-create` 或删系列后重提。