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

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}

@@ -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`          | 账户状态                                                                                                     |
 
@@ -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 <媒体类型> [选项]
@@ -153,7 +153,7 @@ siluzan-tso accounts-digest -m <媒体类型> [选项]
 **`--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 <媒体类型> [选项]
@@ -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 说明
 

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`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
@@ -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/accounts/open-account-by-media.md

@@ -0,0 +1,151 @@
+# 各媒体开户
+
+> 对应页面：`/accountOpeningHistory`  
+> 网页链接：`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 多命令串联见 `references/core/workflows.md` § 流程一。
+
+## Agent 注意
+
+- **`open-account google-wizard` 需要真实 TTY**，Agent 环境无法使用，始终用非交互 `open-account <media> ...`。
+- 各媒体所需资料和参数**完全不同**，不要混用。
+- 提交后轮询：`account-history -m <Media>`；通过后 `list-accounts -m <Media>`。
+- 充值激活**必须在网页**完成（见 `references/accounts/finance.md`）。
+
+---
+
+## Google
+
+**所需信息**：公司名称、推广网址、推广类型（b2b/b2c/app）、账户名称、币种（CNY/USD）、时区、邀请邮箱
+
+**网页对照**（字段映射）：`references/accounts/open-account-google-ui.md`
+
+**常用时区**（完整：`siluzan-tso open-account google-timezones`）：
+
+| Code | 含义 |
+| ---- | ---- |
+| `Asia/Shanghai` | CNY 默认 |
+| `Asia/Hong_Kong` | USD 默认 |
+| `America/New_York` | 美东 |
+| `America/Los_Angeles` | 美西 |
+| `Europe/London` | 伦敦 |
+
+```bash
+siluzan-tso open-account google \
+  --company "Brand A Inc." \
+  --promotion-link "https://www.brand-a.com" \
+  --promotion-type b2c \
+  --account-name "品牌A美国推广账户" \
+  --currency USD \
+  --timezone "America/New_York" \
+  --invite-email "marketing@brand-a.com"
+
+siluzan-tso account-history -m Google
+siluzan-tso list-accounts -m Google
+```
+
+---
+
+## TikTok
+
+**所需信息**：营业执照图片路径、执照编号、公司名、注册地代码、行业 ID（叶子节点）、推广链接、账户名称、币种、时区
+
+> CLI 不做执照 OCR，需用户手动提供 `--company` 和 `--license-no`。
+
+```bash
+siluzan-tso open-account tiktok-areas --keyword China
+siluzan-tso open-account tiktok-industries --keyword "电商"
+siluzan-tso open-account tiktok-timezones --keyword Shanghai
+
+siluzan-tso open-account tiktok \
+  --company "Brand A Inc." \
+  --account-name "品牌A TikTok账户" \
+  --currency USD \
+  --timezone "Asia/Shanghai" \
+  --industry-id <叶子节点 ID> \
+  --registered-area CN \
+  --promotion-link "https://www.brand-a.com" \
+  --license-no "91440300XXXXXXXXXX" \
+  --license-file "/path/to/license.jpg"
+
+siluzan-tso account-history -m TikTok
+```
+
+---
+
+## Yandex
+
+**所需信息**：公司名称、Yandex 登录名、邮箱、税号（TIN）、电话
+
+```bash
+siluzan-tso open-account yandex \
+  --company "Brand A Inc." \
+  --login "brandainc_yandex" \
+  --first-name "San" \
+  --last-name "Zhang" \
+  --email "contact@brand-a.com" \
+  --tin "XXXXXXXXXX" \
+  --phone "+86XXXXXXXXXXX"
+
+siluzan-tso account-history -m Yandex
+```
+
+---
+
+## BingV2
+
+**所需信息**：广告主全称/简称、地址（省市区）、推广链接、行业名称、营业执照图片路径
+
+```bash
+siluzan-tso open-account bing-industries --keyword "科技"
+
+siluzan-tso open-account bing \
+  --advertiser-name "深圳XX科技有限公司" \
+  --name-short "XX科技" \
+  --province "广东省" \
+  --city "深圳市" \
+  --address "南山区科技园XX路XX号" \
+  --promotion-link "https://www.brand-a.com" \
+  --trade-id "IT/消费电子-其他" \
+  --license-file "/path/to/license.jpg"
+
+siluzan-tso account-history -m BingV2
+```
+
+---
+
+## Kwai
+
+**所需信息**：公司名称、主体信息、行业多级 ID、产品网址、账户类型、营业执照图片路径
+
+```bash
+siluzan-tso open-account kwai \
+  --company-name "深圳XX科技有限公司" \
+  --licence-id "91440300XXXXXXXXXX" \
+  --licence-country CN \
+  --licence-location "广东省深圳市南山区XX路XX号" \
+  --business-scope "电商零售" \
+  --product "品牌A" \
+  --ad-type 1 \
+  --product-url "https://www.brand-a.com" \
+  --licence-id-type ENTERPRISE \
+  --account-name "品牌A Kwai账户" \
+  --industry-id1 "1234" \
+  --industry-id2 "5678" \
+  --expire-type 2 \
+  --target-country US \
+  --license-file "/path/to/license.jpg"
+
+siluzan-tso account-history -m Kwai
+```
+
+---
+
+## 审核结果
+
+| 状态 | 含义 | 下一步 |
+| ---- | ---- | ------ |
+| 审核中 | 等待媒体审核 | 继续 `account-history` 轮询 |
+| 已通过 | 账户可用 | `list-accounts` 确认 + 网页充值 |
+| 已拒绝 | 资料问题 | 查看拒绝原因，修正后重新提交 |
+
+完整参数：`siluzan-tso open-account <subcommand> -h`

package/dist/skill/references/{open-account-google-ui.md → accounts/open-account-google-ui.md}

@@ -8,7 +8,7 @@
 | ②    | 填写申请     | 网页里完成第 1、2 步表单并提交     | **`open-account google-wizard`** 或 **`open-account google`** |
 | ③    | 等待审核     | 等待媒体/平台审核                  | **`account-history -m Google`** 轮询                          |
 | ④    | 审核通过     | 查看通过结果                       | 同上                                                          |
-| ⑤    | 充值并激活   | **必须在网页完成充值**             | 引导 `config show` → `webUrl` + 充值路径（见 `finance.md`）   |
+| ⑤    | 充值并激活   | **必须在网页完成充值**             | 引导 `config show` → `webUrl` + 充值路径（见 `accounts/finance.md`）   |
 
 页面上还有提示：**美元账户最低充值约 100 USD、人民币约 700 CNY**（以实际页面为准）。
 
@@ -115,4 +115,4 @@ siluzan-tso account-history -m Google
 | `open-account google`           | 非交互一次性提交                        |
 | `account-history -m Google`     | 开户审核进度                            |
 
-更完整的参数表见 `accounts.md` → **open-account** 章节。
+更完整的参数表见 `accounts/accounts.md` → **open-account** 章节。

package/dist/skill/references/{account-analytics.md → analytics/account-analytics.md}

@@ -1,6 +1,6 @@
 # 账户分析数据拉取与周期报告
 
-> 所属 skill：`siluzan-tso`。本文档说明如何通过 CLI 拉取 Google / Meta / TikTok / Bing 的账户分析数据并撰写报告。TSO 平台优化报告见 `references/reporting.md`。
+> 所属 skill：`siluzan-tso`。本文档说明如何通过 CLI 拉取 Google / Meta / TikTok / Bing 的账户分析数据并撰写报告。TSO 平台优化报告见 `references/analytics/reporting.md`。
 
 ---
 
@@ -86,7 +86,7 @@ CLI 出口的所有 JSON / 表格金额已统一为**元**，关键字段：
 | `keyword suggest --json`                            | `averageCpc`、`lowTopOfPageBid`、`highTopOfPageBid`；根级与每条 `bidAmountCurrency`（有 `-a` 为账户币；无 `-a` 为 USD） |
 | `balance` 等账户余额接口                            | 余额字段为`remainingAccountBudget`（元） |
 
-旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/currency.md`。
+旧字段 `budgetAmount`（分）、`maxCPCAmountDisplay`、`*Micros`（微元）**已不再落盘**，下游脚本无需做单位换算。金额保留 2 位小数，带货币代码（如 `￥50.00 CNY`、`$50.00 USD`），`currencyCode` 从响应读取，跨币种账户分表；细则见 `references/accounts/currency.md`。
 
 ### 预算建议
 

package/dist/skill/references/{google-analysis-batch.md → analytics/google-analysis-batch.md}

@@ -2,7 +2,7 @@
 
 > 适用：账户数 ≥ 5 且需拉 ≥ 2 个 google-analysis 维度。**禁止**外层 for-loop 替代。中断后**必须** `resume`，不得重跑 `run`。
 >
-> **数据时效性**：维度的实时 / 每日同步口径见 `references/account-analytics.md` 顶部「数据时效性」表。当天高消耗排行只能用 `--sections overview`，且**禁止**加 `--min-spend`（其预筛选来自非实时 `accountsoverview`）。
+> **数据时效性**：维度的实时 / 每日同步口径见 `references/analytics/account-analytics.md` 顶部「数据时效性」表。当天高消耗排行只能用 `--sections overview`，且**禁止**加 `--min-spend`（其预筛选来自非实时 `accountsoverview`）。
 
 单 Node 进程，复用 keep-alive，双层并发（账户级 × 维度级），断点续跑，错误自动分类重试。
 
@@ -69,7 +69,7 @@ siluzan-tso google-analysis-batch status --json-out ./snap-batch --run-id <runId
 | `--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`    |
+| `--sections <list>`                  | 维度（逗号分隔），合法值见 `references/analytics/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 默认               |

package/dist/skill/references/{keyword-planner-workflows.md → analytics/keyword-planner-workflows.md}

@@ -1,6 +1,6 @@
 # 关键词规划师工作流
 
-> **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads-campaign-plan.md`。关键词数量规则：`google-ads-rules/google-ads-keyword-taxonomy.md`。
+> **拓词命令**读本文；**建户 JSON + validate + create** 读 `references/google-ads/google-ads-campaign-plan.md`。关键词数量规则：`google-ads/rules/google-ads-keyword-taxonomy.md`。
 >
 > **数据口径**：`siluzan-tso keyword` 默认走 `keywordidea/google`（共享 MCC，出价 **USD**）；传 **`-a <mediaCustomerId>`** 时走 `keywordrecommendation/recommend/{id}/google`，出价币种为 `list-accounts` 的 **`currencyCode`**（如 CNY）。可选 `--url` 叠加 **网址拓词**（`websitereco`）。与 **`google-analysis` 投放表现**不是同一套数据。
 
@@ -60,7 +60,7 @@
 | 4   | 账户关键词表现 + 市场侧指标：`google-analysis` keywords → 抽词 → 分批 `keyword`  | §3                   |
 | 5   | 搜索词 + 拓词：浪费流量 / 否词线索                                               | §4                   |
 | 6   | 高商业意图粗筛：CPC、竞争度、搜索量                                              | §5                   |
-| 7   | 否词或否词根落地：`ad keyword-negative-create` 等                                | §4 + `google-ads.md` |
+| 7   | 否词或否词根落地：`ad keyword-negative-create` 等                                | §4 + `google-ads/google-ads.md` |
 | 8   | Campaign → AdGroup → JSON：`ad campaign-validate` → `ad campaign-create` | §6                   |
 | 9   | 拓词结果导出：`keyword … --json-out`，供脚本消费                                 | §7                   |
 
@@ -119,8 +119,8 @@ siluzan-tso keyword -k "pipe" --geo 2840,2826 --json-out ./snap-kw-merged
 
 ## 通用执行规范
 
-- **一律**对可复用中间结果使用 `--json-out <目录>`（或等价快照参数），再读 `cli-manifest*.json` / 各 section 的 `*.outline.txt` 了解字段；详见 **`references/tips.md`**。
-- **写账户**（新建系列/加词/加否词）：新建系列走 **`references/google-ads-campaign-plan.md`**（含 `campaign-validate`）；其余写操作先与用户确认，写后用成对读命令复核（命令见 `google-ads.md`）。
+- **一律**对可复用中间结果使用 `--json-out <目录>`（或等价快照参数），再读 `cli-manifest*.json` / 各 section 的 `*.outline.txt` 了解字段；详见 **`references/core/tips.md`**。
+- **写账户**（新建系列/加词/加否词）：新建系列走 **`references/google-ads/google-ads-campaign-plan.md`**（含 `campaign-validate`）；其余写操作先与用户确认，写后用成对读命令复核（命令见 `google-ads/google-ads.md`）。
 
 ---
 
@@ -128,7 +128,7 @@ siluzan-tso keyword -k "pipe" --geo 2840,2826 --json-out ./snap-kw-merged
 
 ### 0）先知识库、再市场侧拓词（推荐）
 
-当用户给出**客户/品牌**或需要**产品型号、英文类目、应用场景**才能写出靠谱种子词时，**先**走 `references/rag.md`，**再**调用 `keyword`（市场侧指标与账户内表现仍须区分，见文首「数据口径」）。
+当用户给出**客户/品牌**或需要**产品型号、英文类目、应用场景**才能写出靠谱种子词时，**先**走 `references/analytics/rag.md`，**再**调用 `keyword`（市场侧指标与账户内表现仍须区分，见文首「数据口径」）。
 
 1. 选定客户知识库：  
    `siluzan-tso rag list --rag-only --json`
@@ -174,7 +174,7 @@ siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "
 
 1. `siluzan-tso google-analysis -a <id> --sections search-terms --start <S> --end <E> --json-out ./snap-st`
 2. 与 `keyword` 拓词结果对照，由 AI 列否词根或精确否词；落地执行：  
-   `siluzan-tso ad keyword-negative-create …`（见 `references/google-ads.md`）。
+   `siluzan-tso ad keyword-negative-create …`（见 `references/google-ads/google-ads.md`）。
 
 ### 5）高商业意图粗筛（出价 + 竞争度 + 搜索量）
 
@@ -183,14 +183,14 @@ siluzan-tso keyword -k "structural adhesive,SG-200,curtain wall bonding" --url "
 
 ### 6）词包 → campaign-create JSON
 
-拓词落盘结果 + `google-ads-keyword-taxonomy.md` 分层建议 → 填 JSON（`KeywordsForBatchJob`、`campaign-validate`、`campaign-create`）见 **`references/google-ads-campaign-plan.md`** § 标准流水线 **步 3–7**。
+拓词落盘结果 + `google-ads-keyword-taxonomy.md` 分层建议 → 填 JSON（`KeywordsForBatchJob`、`campaign-validate`、`campaign-create`）见 **`references/google-ads/google-ads-campaign-plan.md`** § 标准流水线 **步 3–7**。
 
 ### 7）拓词结果标准化导出
 
 1. ```bash
    siluzan-tso keyword -k "..." [--url ...] [--include ...] [--exclude ...] --json-out ./snap-kw
    ```
-2. 消费顺序：**先**读该目录下 `cli-manifest*.json` 与 **`*.outline.txt`（字段结构）**，**再**用脚本 `require()` 或聚合逻辑读真实数据 JSON；禁止跳过 outline 猜字段。总约定见 **`references/tips.md`**。
+2. 消费顺序：**先**读该目录下 `cli-manifest*.json` 与 **`*.outline.txt`（字段结构）**，**再**用脚本 `require()` 或聚合逻辑读真实数据 JSON；禁止跳过 outline 猜字段。总约定见 **`references/core/tips.md`**。
 
 ---
 
@@ -207,4 +207,4 @@ siluzan-tso keyword geo-list [--country-code <codes>] [--name-contains <text>] [
 
 **返回字段**（与后端 `Samm.Core.Service.KeywordRecommendation` 对齐）：根级与每条 **`bidAmountCurrency`**（无账户=`USD`；有账户=`list-accounts` 的 `currencyCode`）；`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid`（微元 ÷1,000,000，**与 `bidAmountCurrency` 一致**）。另有 `keyword` / `montlySearch` / `competition` / `competitionV2` / `source` 等。
 
-与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。
+与只读账户关键词列表、否词 CRUD 的对照仍归 **`references/google-ads/google-ads.md`** 中 `ad keywords` / `ad keyword-*` 各节。

package/dist/skill/references/{rag.md → analytics/rag.md}

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 
@@ -42,14 +42,14 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
 
 | 用户意图                       | 建议检索词（示例）                        | 后续 TSO 命令                                                     |
 | ------------------------------ | ----------------------------------------- | ----------------------------------------------------------------- |
-| Google 搜索广告方案 / 批量草稿 | 产品卖点、应用行业、目标国家、竞品差异    | `google-ads-campaign-plan.md` + `keyword` / `campaign-create`；草稿发布见 `google-ads.md` § ad batch |
-| 关键字拓词补语境               | 产品型号、英文类目、行业术语、应用场景    | `keyword suggest -k "..."`；编排见 `keyword-planner-workflows.md` |
+| Google 搜索广告方案 / 批量草稿 | 产品卖点、应用行业、目标国家、竞品差异    | `google-ads/google-ads-campaign-plan.md` + `keyword` / `campaign-create`；草稿发布见 `google-ads/google-ads.md` § ad batch |
+| 关键字拓词补语境               | 产品型号、英文类目、行业术语、应用场景    | `keyword suggest -k "..."`；编排见 `analytics/keyword-planner-workflows.md` |
 | 账户诊断 / 周期报告「背景」段  | 公司简介、主营产品、目标市场、认证资质    | `google-analysis` + `report-templates/` 对应模板                  |
 | 询盘分析报告                   | 产品线、出口市场、客户画像、大洲业务侧重  | `report-templates/google-inquiry-analysis.md`                     |
-| 开户行业/资质核对              | 营业执照经营范围、行业描述、品牌全称      | `open-account-by-media.md` 对应媒体开户流                         |
+| 开户行业/资质核对              | 营业执照经营范围、行业描述、品牌全称      | `accounts/open-account-by-media.md` 对应媒体开户流                         |
 | 优化建议解释                   | 产品毛利结构、旺季、转化路径（表单/电话） | `optimize` 记录 + 人工解读；数据仍来自 `google-analysis`          |
 
-检索结果**只作事实参考**：广告标题/描述须符合 `google-ads-rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
+检索结果**只作事实参考**：广告标题/描述须符合 `google-ads/rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
 
 ---
 
@@ -99,6 +99,6 @@ rag list --rag-only --json
 | 维度      | siluzan-tso `rag`                         | siluzan-cso `rag`                             |
 | --------- | ----------------------------------------- | --------------------------------------------- |
 | 主要用途  | 广告投放、分析、拓词、报告背景            | 社媒文案、三库素材、口播写稿                  |
-| 默认 tags | 不过滤（按 folder 锁客户）                | 常配合三库 tags（见 CSO `references/rag.md`） |
+| 默认 tags | 不过滤（按 folder 锁客户）                | 常配合三库 tags（见 CSO `references/analytics/rag.md`） |
 | 后续命令  | `ad` / `keyword` / `google-analysis`      | `publish` / 写稿工作流                        |
 | API       | 相同 `cutapi/v1/material/queryknowledges` | 相同                                          |

package/dist/skill/references/{reporting.md → analytics/reporting.md}

@@ -3,10 +3,10 @@
 > 所属 skill：`siluzan-tso`。
 >
 > 本文档仅覆盖 **TSO steward 优化报告**：列表、生成、删除、邮件推送与网页查看。  
-> **账户分析拉数**（`google-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`）与**周期/诊断报告纲要**见 `references/account-analytics.md`。  
-> **异步批量创建记录**（`ad batch`）见 `references/google-ads.md` § ad batch。  
-> **AI 广告优化**（`optimize`）见 `references/optimize.md`。  
-> **广告线索**（`clue`）见 `references/clue.md`。
+> **账户分析拉数**（`google-analysis`、`report tiktok-*`、`report bing-*`、`report meta-overview`）与**周期/诊断报告纲要**见 `references/analytics/account-analytics.md`。  
+> **异步批量创建记录**（`ad batch`）见 `references/google-ads/google-ads.md` § ad batch。  
+> **AI 广告优化**（`optimize`）见 `references/operations/optimize.md`。  
+> **广告线索**（`clue`）见 `references/operations/clue.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
 ```