siluzan-tso-cli 1.1.24 → 1.1.25-beta.2

package/dist/skill/SKILL.md

@@ -17,6 +17,8 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 > **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 任务表 Read 域文档。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + 脚本读盘（见 `references/core/tips.md`）。
 >
+> **开户**：首次进入开户话题须先向用户罗列该媒体（或未指明媒体时六平台）**全部必填项**，见 `references/accounts/open-account-by-media.md` §「首次响应硬规范」。
+>
 > **Subagent（可选）**：若宿主支持 Task / 子会话，复杂报告（P5/P6/P7）或长 CLI 输出前 Read `references/core/subagent-orchestration.md`，**自行决定**是否委派；写操作确认与对用户的最终交付留在主 Agent。
 
 ---
@@ -91,9 +93,10 @@ Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git
 | 优化报告（TSO 平台） | `analytics/reporting.md` |
 | 预警 | `operations/forewarning.md` |
 | 发票 / 转账 / 充值 | `accounts/finance.md` |
-| 开户 | `accounts/open-account-by-media.md`（Google 加 `accounts/open-account-google-ui.md`） |
+| 开户 | `accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `accounts/open-account-google-ui.md`） |
 | OKKI 周报 | `report-templates/okki-weekly-google-client.md` + `core/playbooks.md` P6；可选 `core/subagent-orchestration.md` |
 | Google 询盘分析 | `report-templates/google-inquiry-analysis.md` + `core/playbooks.md` P7；可选 `core/subagent-orchestration.md` |
+| Google 广告诊断 / 账户健康检查 / `AdvertisingDiagnosis` | `report-templates/google-ads-diagnosis.md`+ `google-account-diagnosis-report.md` + `REPORT-WORKFLOW.md` |
 | 标准画像/扫描/周期报告 | `core/playbooks.md` 对应 P1–P5 |
 | P5 多账户多维度 batch | `analytics/google-analysis-batch.md` + `core/playbooks.md` P5；可选 `core/subagent-orchestration.md` |
 

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.24",
-  "publishedAt": 1780388850639
+  "version": "1.1.25-beta.2",
+  "publishedAt": 1780469383389
 }

package/dist/skill/assets/pmax-create-template.md

@@ -44,13 +44,13 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 | `budgetName` | string | | 预算资源名称 |
 | `assetGroupName` | string | | 首个资产组名称；缺省由服务端生成 |
 | `finalUrls` | string[] | ✅ | 至少 1 个 `https://` 落地页 |
-| `businessName` | string | ✅ | 商家名称（文字资产） |
-| `headlines` | string[] | ✅ | ≥3 条标题 |
-| `longHeadlines` | string[] | ✅ | ≥1 条长标题 |
-| `descriptions` | string[] | ✅ | ≥2 条描述 |
-| `imagePaths.marketing` | string | ✅* | 横图 1.91:1（建议 1200×628）路径，相对配置文件目录；**提交时自动上传** |
-| `imagePaths.square` | string | ✅* | 方图 1:1（建议 1200×1200）；自动上传 |
-| `imagePaths.logo` | string | ✅* | Logo 1:1；自动上传 |
+| `businessName` | string | ✅ | BUSINESS_NAME：1 条，≤25 字符 |
+| `headlines` | string[] | ✅ | HEADLINE：3–15 条，每条 ≤30 字符（CJK×2） |
+| `longHeadlines` | string[] | ✅ | LONG_HEADLINE：1–5 条，每条 ≤90 字符 |
+| `descriptions` | string[] | ✅ | DESCRIPTION：2–5 条，每条 ≤90 字符 |
+| `imagePaths.marketing` | string | ✅* | MARKETING_IMAGE 横图 1.91:1，≤5MB（创建 JSON 1 张；资产组 API 最多 20） |
+| `imagePaths.square` | string | ✅* | SQUARE_MARKETING_IMAGE 方图 1:1，≤5MB（创建 1 张；最多 20） |
+| `imagePaths.logo` | string | ✅* | LOGO 方图 1:1，≤5MB（创建 1 张；最多 5） |
 | `marketingImageAssetId` | string | ✅* | 已上传横图 asset.id（与 path/base64 三选一） |
 | `squareMarketingImageAssetId` | string | ✅* | 已上传方图 asset.id |
 | `logoImageAssetId` | string | ✅* | 已上传 Logo asset.id |
@@ -62,7 +62,7 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 | `biddingStrategyTypeV2` | string | | 默认 `MAXIMIZE_CONVERSIONS` |
 | `targetCpa_BidingAmount` | number | | `TARGET_CPA` 或带目标 CPA 的 `MAXIMIZE_CONVERSIONS` 时必填（**元**） |
 | `targetRoas` | number | | `TARGET_ROAS` 时必填（如 `2.5` = 250%） |
-| `videoPath` | string | | 本地视频路径（`.mp4` / `.mov` 等）；经 PyAPI 上传后自动链接（与 `youtubeUrlOrId` 二选一） |
+| `videoPath` | string | | YOUTUBE_VIDEO（可选）：本地视频 ≥10s；与 `youtubeUrlOrId` 二选一，创建时最多 1 条 |
 | `videoTitle` | string | | PyAPI 上传标题（默认文件名） |
 | `videoDescription` | string | | PyAPI 上传描述（可选） |
 | `youtubeUrlOrId` | string | | 已有 YouTube URL 或 11 位 ID；`pmax-create` 后自动链接 |

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

@@ -402,7 +402,8 @@ siluzan-tso account share-detail --customer-id 1234567890
 ## open-account — 开户申请
 
 > Google 开户字段与向导说明见 **`references/accounts/open-account-google-ui.md`**。  
-> 各媒体开户参数与接口差异见 **`references/accounts/open-account-by-media.md`**。
+> 各媒体开户参数与接口差异见 **`references/accounts/open-account-by-media.md`**。  
+> **Agent 首次响应**：必须先向用户罗列目标媒体（或未指明时全平台）**全部必填项**，见 `open-account-by-media.md` §「首次响应硬规范」与 §「全平台必填总览」。
 
 ### 广告主组 magKey 说明
 
@@ -483,27 +484,21 @@ 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 <tiktok-industries 输出的叶子节点 ID> \
   --registered-area CN \
   --promotion-link "https://www.brand-a.com" \
   --license-no "91440300XXXXXXXXXX" \
-  --license-file "/path/to/business-license.jpg"
-```
-
-> CLI 自动完成：① 上传图片到 TikTok 取得 `license_image_id`；② 存档到丝路赞；③ 按公司名自动创建/关联广告主组；④ 检查是否需要法人银联验证。  
-> **注意**：`--company` 和 `--license-no` 需用户手动提供；CLI **无**执照 OCR。
-
-**需要法人银联验证时追加：**
-
-```bash
+  --license-file "/path/to/business-license.jpg" \
   --representative-name "张三" \
   --representative-id "440300XXXXXXXXXXXXXXXXX" \
   --unionpay-account "6222XXXXXXXXXXXX" \
   --representative-phone "13800138000"
 ```
 
+> CLI 自动完成：① 上传图片到 TikTok 取得 `license_image_id`；② 存档到丝路赞；③ 按公司名自动创建/关联广告主组。  
+> **注意**：`--company` 和 `--license-no` 需用户手动提供；CLI **无**执照 OCR。法人银联四项为 **CLI 必填**（见 `open-account-by-media.md` 总览表）。币种由 CLI 固定 USD。
+
 ---
 
 ### Yandex 开户（无需图片）
@@ -511,15 +506,11 @@ siluzan-tso open-account tiktok \
 ```bash
 siluzan-tso open-account yandex \
   --company "Brand A Inc." \
-  --login "yandex_login_name" \
-  --first-name "San" \
-  --last-name "Zhang" \
   --email "zs@company.com" \
-  --tin "7712345678" \
-  --phone "+8613800138000"
+  --tin "7712345678"
 ```
 
-> **TIN 说明**：税号为普通文本，直接填写纳税人识别号（INN）即可，提交时类型固定为 `FOREIGN_LEGAL`，无需额外选择。不会根据税号自动带出公司名等信息。
+> **TIN 说明**：税号为普通文本，直接填写纳税人识别号（INN）即可，提交时类型固定为 `FOREIGN_LEGAL`。与网页 v2 一致，仅需公司名、邮箱、税号三项。
 
 ---
 
@@ -530,11 +521,14 @@ siluzan-tso open-account yandex \
 siluzan-tso open-account bing-industries --keyword "科技"
 
 siluzan-tso open-account bing \
+  --pattern Direct \
   --advertiser-name "深圳XX科技有限公司" \
   --name-short "XX科技" \
+  --name-remark-list "XX科技-推广户" \
   --province "广东省" \
   --city "深圳市" \
   --address "南山区科技园XX路XX号XX大厦" \
+  --postcode "518000" \
   --promotion-link "https://www.brand-a.com" \
   --trade-id "IT/消费电子-其他" \
   --license-file "/path/to/license.jpg"
@@ -572,6 +566,18 @@ siluzan-tso open-account kwai \
 
 ---
 
+### MetaAd（Facebook）开户链接
+
+> 无 CLI 表单提交；与网页「申请开户」相同，拉取 Meta 官方 OE 动态 URL。详见 `references/accounts/open-account-by-media.md` § MetaAd。
+
+```bash
+siluzan-tso open-account meta
+siluzan-tso open-account meta --json-out ./snap-meta-open
+siluzan-tso account-history -m MetaAd
+```
+
+---
+
 ## account close — TikTok 关闭账户
 
 > 仅支持 **TikTok** 账户。关闭后账户停止投放，如需恢复请联系丝路赞客服，操作**不可自助撤销**，谨慎使用。

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

@@ -34,7 +34,7 @@
 1. **`list-accounts`**（推荐第一步）：`items[].ma.currencyCode`；表格有 **「币种」** 列。
 2. **`balance` / `balance-scan` / `accounts-digest`**：`items[].currencyCode` 或行内已格式化的金额（含代码）。
 3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `accounts/accounts.md` 时效性说明）。
-4. **`google-analysis --sections overview`**：`overview-*.json` 根级或 `account.currencyCode`。
+4. **`google-analysis --sections overview`**：`overview-*.json` 的 `record.currencyCode`（汇总维度，`schemaVersion 3` 起整块在 `record`）。
 5. **`ad campaigns` / `ad groups`**：JSON 内 `currencyCode`（与账户主币种一致）。
 6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `accounts/finance.md`。
 

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

@@ -131,10 +131,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

@@ -3,18 +3,122 @@
 > 网页链接：`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
+## 首次响应硬规范（必读）
+
+用户提出开户（或本轮对话**首次**进入开户话题）时，Agent **必须先输出完整必填清单**，再收集资料或执行 CLI。**禁止**在未列清单的情况下直接 `open-account …` 或只问一两个字段。
+
+| 用户说法 | 首次回复必须包含 |
+| -------- | ---------------- |
+| 未指明媒体 / 「开个户」/ 「各平台开户」 | 下文 **§ 全平台必填总览** 六张表（或等价完整列表） |
+| 已指明单一媒体（如「Google 开户」） | 该媒体 **§ 必填字段** 表 + 辅助查询命令（若有）+ 资料类说明（执照路径等） |
+| 多媒体同时开 | 每个目标媒体各一张必填表，**禁止**混用字段 |
+
+清单须写清：**业务含义**、**CLI 选项名**、**格式/枚举**、**是否需本地文件路径**。用户补齐后再确认并提交；写入前仍须用户确认（见 `references/core/agent-conventions.md`）。
+
+不确定字段时：先 `siluzan-tso open-account <subcommand> -h`，再以本文件与 CLI 为准，勿猜。
+
+---
+
 ## Agent 注意
 
-- **`open-account google-wizard` 需要真实 TTY**，Agent 环境无法使用，始终用非交互 `open-account <media> ...`。
+- 始终用非交互 `open-account <media> ...`。
+- **Meta/Facebook 开户**无表单提交命令，使用 `open-account meta` 获取官方 OE 链接交给用户在浏览器完成。
 - 各媒体所需资料和参数**完全不同**，不要混用。
 - 提交后轮询：`account-history -m <Media>`；通过后 `list-accounts -m <Media>`。
 - 充值激活**必须在网页**完成（见 `references/accounts/finance.md`）。
 
 ---
 
+## 全平台必填总览
+
+> 与 `siluzan-tso open-account <media> -h` 的 `requiredOption` 对齐；可选字段见各媒体 §。
+
+### Google（`open-account google`，无需图片）
+
+| 业务项 | CLI 选项 | 说明 |
+| ------ | -------- | ---- |
+| 公司名称 | `--company` | 用于匹配/创建广告主组 |
+| 推广链接 | `--promotion-link` | 可只写域名，CLI 补 `https://` |
+| 推广类型 | `--promotion-type` | `b2b` \| `b2c` \| `app` |
+| 账户名称 | `--account-name` | 建议 ≤22 字 |
+| 币种 | `--currency` | `USD` \| `CNY` |
+| 时区 | `--timezone` | IANA；列表：`open-account google-timezones` |
+| 邀请邮箱 | `--invite-email` | 账户邀请发往此邮箱 |
+
+### TikTok（`open-account tiktok`，需营业执照图片）
+
+| 业务项 | CLI 选项 | 说明 |
+| ------ | -------- | ---- |
+| 公司名称 | `--company` | 无 OCR，须用户手填 |
+| 账户名称 | `--account-name` | |
+| 时区 | `--timezone` | 列表：`open-account tiktok-timezones` |
+| 行业 ID | `--industry-id` | **叶子节点**数字；列表：`open-account tiktok-industries` |
+| 注册地 | `--registered-area` | 国家代码如 `CN`；列表：`open-account tiktok-areas` |
+| 推广链接 | `--promotion-link` | |
+| 执照编号 | `--license-no` | 统一社会信用代码 |
+| 执照图片 | `--license-file` | 本地 JPG/PNG 路径 |
+| 法人姓名 | `--representative-name` | CLI 必填 |
+| 法人身份证 | `--representative-id` | CLI 必填 |
+| 法人银联账号 | `--unionpay-account` | CLI 必填 |
+| 法人手机 | `--representative-phone` | CLI 必填 |
+
+> 币种由 CLI 固定为 USD，无需 `--currency`。
+
+### Yandex（`open-account yandex`，无需图片）
+
+| 业务项 | CLI 选项 | 说明 |
+| ------ | -------- | ---- |
+| 公司名称 | `--company` | |
+| 联系邮箱 | `--email` | |
+| 税号 TIN/INN | `--tin` | 类型固定 `FOREIGN_LEGAL` |
+
+### BingV2（`open-account bing`，需营业执照图片）
+
+| 业务项 | CLI 选项 | 说明 |
+| ------ | -------- | ---- |
+| 直接/代理 | `--pattern` | `Direct` \| `Agency` |
+| 广告主全称 | `--advertiser-name` | 用于匹配/创建广告主组 |
+| 公司简称 | `--name-short` | |
+| 开户名称 | `--name-remark-list` | 账户显示名 |
+| 省份 | `--province` | |
+| 城市 | `--city` | |
+| 详细地址 | `--address` | |
+| 邮编 | `--postcode` | |
+| 行业 | `--trade-id` | `bing-industries` 返回的 **name** 字段 |
+| 推广链接 | `--promotion-link` | |
+| 执照图片 | `--license-file` | JPG/PNG/PDF 本地路径 |
+
+### Kwai（`open-account kwai`，需营业执照图片）
+
+| 业务项 | CLI 选项 | 说明 |
+| ------ | -------- | ---- |
+| 营业执照号 | `--licence-id` | |
+| 注册国家 | `--licence-country` | 如 `CN` |
+| 注册地址 | `--licence-location` | 省市区详细地址 |
+| 营业范围 | `--business-scope` | |
+| 产品/品牌名 | `--product` | |
+| 账户类型 | `--ad-type` | `1` 效果 / `2` 品牌 |
+| 产品网址 | `--product-url` | |
+| 实体类型 | `--licence-id-type` | `INDIVIDUAL` \| `ENTERPRISE` |
+| 账户名称 | `--account-name` | |
+| 公司主体名 | `--company-name` | |
+| 一级行业 ID | `--industry-id1` | |
+| 二级行业 ID | `--industry-id2` | |
+| 有效期类型 | `--expire-type` | `1` 有限期（须 `--expire-at`）/ `2` 长期 |
+| 投放地区 | `--target-country` | ISO 如 `US` |
+| 执照图片 | `--license-file` | 本地路径 |
+
+### MetaAd（`open-account meta`）
+
+| 业务项 | 说明 |
+| ------ | ---- |
+| 用户侧资料 | 在 Meta 官方 OE 网页填写；CLI **无**表单字段 |
+
+---
+
 ## Google
 
-**所需信息**：公司名称、推广网址、推广类型（b2b/b2c/app）、账户名称、币种（CNY/USD）、时区、邀请邮箱
+**必填**：见上表 § Google；字段语义见 `references/accounts/open-account-google-ui.md`。
 
 **Google 字段说明**：`references/accounts/open-account-google-ui.md`
 
@@ -46,25 +150,30 @@ siluzan-tso list-accounts -m Google
 
 ## TikTok
 
-**所需信息**：营业执照图片路径、执照编号、公司名、注册地代码、行业 ID（叶子节点）、推广链接、账户名称、币种、时区
+**必填**：见上表 § TikTok。CLI 不做执照 OCR；法人银联四项在 CLI 中为必填。
 
-> 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
+```
 
+```bash
 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"
+  --license-file "/path/to/license.jpg" \
+  --representative-name "张三" \
+  --representative-id "440300XXXXXXXXXXXXXXXXX" \
+  --unionpay-account "6222XXXXXXXXXXXX" \
+  --representative-phone "13800138000"
 
 siluzan-tso account-history -m TikTok
 ```
@@ -73,17 +182,13 @@ siluzan-tso account-history -m TikTok
 
 ## Yandex
 
-**所需信息**：公司名称、Yandex 登录名、邮箱、税号（TIN）、电话
+**必填**：见上表 § Yandex（仅三项，与网页 v2 表单一致）。
 
 ```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"
+  --tin "XXXXXXXXXX"
 
 siluzan-tso account-history -m Yandex
 ```
@@ -92,17 +197,20 @@ siluzan-tso account-history -m Yandex
 
 ## BingV2
 
-**所需信息**：广告主全称/简称、地址（省市区）、推广链接、行业名称、营业执照图片路径
+**必填**：见上表 § BingV2。
 
 ```bash
 siluzan-tso open-account bing-industries --keyword "科技"
 
 siluzan-tso open-account bing \
+  --pattern Direct \
   --advertiser-name "深圳XX科技有限公司" \
   --name-short "XX科技" \
+  --name-remark-list "XX科技-推广户" \
   --province "广东省" \
   --city "深圳市" \
   --address "南山区科技园XX路XX号" \
+  --postcode "518000" \
   --promotion-link "https://www.brand-a.com" \
   --trade-id "IT/消费电子-其他" \
   --license-file "/path/to/license.jpg"
@@ -114,7 +222,7 @@ siluzan-tso account-history -m BingV2
 
 ## Kwai
 
-**所需信息**：公司名称、主体信息、行业多级 ID、产品网址、账户类型、营业执照图片路径
+**必填**：见上表 § Kwai。
 
 > **双上传**：CLI 先上传附件得 `imageId`（更新广告主组 MAG），再上传 Kwai 资质得 `blobstoreKey`（写入 `mainCertPhotos`）。二者不可混用。
 
@@ -141,6 +249,34 @@ siluzan-tso account-history -m Kwai
 
 ---
 
+## MetaAd（Facebook / Meta）
+
+**流程**：与 TSO 网页「申请开户」相同——调用 `GetOpenAccountLink` 得到 **Meta 官方 OE 动态链接**（有时效，不可写死 URL），用户在浏览器完成开户。
+
+**所需**：已配置 `siluzan-tso` 鉴权（`config show` 或 `SILUZAN_API_KEY`）。
+
+```bash
+# 获取链接（stdout 打印 URL，Agent 可直接转给用户）
+siluzan-tso open-account meta
+
+# 结构化输出（含 openAccountUrl 字段）
+siluzan-tso open-account meta --json-out ./snap-meta-open
+
+# 本机尝试自动打开浏览器（可选）
+siluzan-tso open-account meta --open-browser
+```
+
+提交后查进度：
+
+```bash
+siluzan-tso account-history -m MetaAd
+siluzan-tso list-accounts -m MetaAd
+```
+
+网页入口（需登录）：账户管理 `…/manageAccounts?mediaType=MetaAd`；开户记录 `…/accountOpeningHistory?mediaType=Meta`（CLI 打印链接时会从 `MetaAd` 自动映射为 `Meta`，与网页 Tab 一致）。
+
+---
+
 ## 审核结果
 
 | 状态 | 含义 | 下一步 |

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

@@ -67,9 +67,9 @@ siluzan-tso account-history -m Google
 
 ## 四、Agent 指令模板
 
-1. 收集：公司名、网址、推广类型、账户名、币种、时区、邀请邮箱。
+1. **首次回复**：向用户输出 Google **全部必填项**（见 § 二表格；与 `open-account-by-media.md` § 全平台总览一致），含 CLI 选项名与枚举，再请用户逐项提供；勿只问一两个字段。
 2. 时区不明时运行 `google-timezones` 或给出常用时区表。
-3. 执行 `open-account google`。
+3. 用户确认资料齐全后执行 `open-account google`。
 4. `account-history -m Google` 轮询。
 5. 通过后引导充值（`finance.md`）。
 

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

@@ -140,7 +140,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `keywords`               | 关键词；默认 `costGreater=0`（仅有消耗）、`limit=0`（不封顶）、`orderByCost=true`；可用 `--limit` 限制 Top N |
 | `search-terms`           | 搜索词；默认 `limit=0`（不封顶）、`orderByCost=true`；落盘前过滤 `spend>0`；含 `queryTargetingStatus` / `queryTargetingStatusZh`（已添加/已排除/都没有）；可用 `--limit` 限制 Top N |
 | `campaigns`              | 广告系列                                                                                            |
-| `campaign-hour`          | 系列按小时（根为 JSON 数组）                                                                        |
+| `campaign-hour`          | 系列按小时（行在 `items[]`）                                                                        |
 | `ads`                    | 广告；与 `ad list` 同源                                                                             |
 | `extensions`             | 附加信息；可选 `--level`                                                                            |
 | `devices`                | 设备分布（账户级 `DeviceSectionData`）                                                              |
@@ -152,16 +152,43 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `audience`           | 受众；可选 `--audience-type`                                                                        |
 | `asset-images`       | 图片素材                                                                                            |
 | `videos`             | 视频                                                                                                |
-| `materials`          | 合并图片+视频 `{ images, videos }`                                                                  |
+| `materials`          | 图片+视频拍平进 `items[]`，每行带 `assetType: 'image' \| 'video'`                                   |
 | `resource-counts`    | 结构统计                                                                                            |
 | `conversion-actions` | 转化动作                                                                                            |
-| `daily-metrics`      | 按日指标（主平台 `GET …/report/media-account/google/account-daily-reports`，`--json-out` 落盘为按日数组） |
+| `daily-metrics`      | 按日指标（主平台 `GET …/report/media-account/google/account-daily-reports`，`--json-out` 落盘为按日数组）。**广告诊断报告**中：金额/CPA **保留 2 位小数**，转化/点击/展示为整数；须配趋势**分析**段落（见 `google-ads-diagnosis.md`） |
 | `gold-account`       | 黄金账户                                                                                            |
 | `ads-index`          | 质量指标                                                                                            |
 | `final-urls`         | 最终到达网址（不传 `--start`/`--end`）                                                              |
 | `dimension-summary`  | 账户汇总                                                                                            |
 | `campaign-types`     | 系列类型（实时，可查当天；不传 `--start`/`--end`）                                                  |
 
+### 落盘 JSON
+
+| 字段 | 含义 |
+| ---- | ---- |
+| `schemaVersion` | 文件内固定 `3` |
+| `section` | 维度名（与文件名 stem 一致；仅标识，读数据用不到） |
+| `itemCount` | `items.length` |
+| `items` | **所有列表维度的行数据**统一入口（含 `materials`）；汇总维度为 `[]` |
+| `record` | **汇总维度**的整块对象；列表维度为 `null` |
+| `meta` | 仅 `search-terms` / `ads`：网关 `code`/`message`（与数据无关，可忽略） |
+
+**唯一判别规则**：`record` 非 `null` → 读 `record`（汇总维度）；否则 → 读 `items[]`（列表维度）。
+
+| 桶 | 维度 | 读法 |
+| -- | ---- | ---- |
+| **列表** | `keywords`、`search-terms`、`campaigns`、`campaign-hour`、`ads`、`extensions`、`devices`、`geographic`、`geo-matched`、`campaign-geo`、`campaign-geo-matched`、`campaign-device`、`audience`、`asset-images`、`videos`、`materials`、`daily-metrics`、`conversion-actions` | `d.items[]` |
+| **汇总** | `overview`、`resource-counts`、`dimension-summary`、`gold-account`、`ads-index`、`final-urls`、`campaign-types` | `d.record` |
+
+脚本示例（Node）—— 所有维度同一套读法：
+
+```javascript
+const d = require("./snap/campaigns-9526903813_20260401-20260430.json");
+const data = d.record ?? d.items; // record 非空=汇总维度；否则=列表行
+```
+
+旧快照（manifest `schemaVersion` 1/2，无 `items`/`record`）须按 `*.outline.txt` 最后一行类型读取。
+
 ### stdout 摘要
 
 ```json
@@ -196,24 +223,11 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | 平均点击成本 | `averageCpc`        |
 | 转化成本     | `costPerConversion` |
 
-### 中文化字段（En→Zh 字典补充）
-
-CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文字段保留**，便于排错；字典未命中时该字段缺省）：
-
-| 维度           | 源字段（英文）     | 新增字段（中文）     | 字典源                                                          |
-| -------------- | ------------------ | -------------------- | --------------------------------------------------------------- |
-| `keywords`     | `keywordMatchType` | `keywordMatchTypeZh` | `match-type-en2zh.json`（覆盖 `BROAD/PHRASE/EXACT` 大小写写法） |
-| `search-terms` | `matchType`        | `matchTypeZh`        | `match-type-en2zh.json`                                         |
-| `search-terms` | `queryTargetingStatus` | `queryTargetingStatusZh` | 网关 `Added`→已添加、`Excluded`→已排除、`None`→都没有（写 Excel「已添加/已排除」列用此字段） |
-| `campaign-geo`         | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`（覆盖 105 个国家/地区）                        |
-| `geo-matched`          | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`                                                |
-| `campaign-geo-matched` | `countryOrRegion`  | `countryOrRegionZh`  | `geo-en2zh.json`                                                |
-
-写 Excel / 报表脚本可直接读 `keywordMatchTypeZh` / `matchTypeZh` / `countryOrRegionZh` 输出中文，**不要**自己维护字典或在线翻译。判断覆盖率用 `if (row.xxxZh)` 即可。
-
 ### CampaignSectionData 关键字段
 
-`campaigns[]` 每行额外包含：`conversionsValue`、`conversionsValuePerCost`（`spend ≤ 0` 时为 0）、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`、`manualCpcEnhancedCpcEnabled`、`percentCpcEnhancedCpcEnabled`。所有金额字段（`*Yuan` 后缀）已统一为元，可直接展示，无需换算。
+> `campaigns` 维度的系列行在 `items[]`（`schemaVersion 3` 起统一信封；本节下文的 `campaigns[]` 即指 `items[]`）。
+
+`items[]` 每行额外包含：`conversionsValue`、`conversionsValuePerCost`（`spend ≤ 0` 时为 0）、`campaignTargetCpaYuan`、`maximizeConversionsTargetCpaYuan`、`manualCpcEnhancedCpcEnabled`、`percentCpcEnhancedCpcEnabled`。所有金额字段（`*Yuan` 后缀）已统一为元，可直接展示，无需换算。
 
 日预算字段为 `budgetAmountYuan`（元），脚本可直接 `row.budgetAmountYuan`；网关原始 `budgetAmount`（分）已不再落盘。
 
@@ -239,11 +253,11 @@ CLI 在落盘前为以下维度自动补「中文译名字段」（**原英文
 
 #### 行顶 legacy 份额（与 `competitiveMetrics` 同名 3 项）
 
-`campaigns[]` / `keywords[]` 行顶仍保留 `searchImpressionShare`、`searchBudgetLostImpressionShare`、`searchRankLostImpressionShare`。CLI 落盘前已统一为 **0~1 小数**（与 `competitiveMetrics` 同名项一致；有嵌套时以 `competitiveMetrics` 为准）。Top/AbsoluteTop/Content/ClickShare 等扩展项仅存在于 `competitiveMetrics`。展示为百分比：`(v * 100).toFixed(2) + '%'`。
+`campaigns` / `keywords` 维度的 `items[]` 行顶仍保留 `searchImpressionShare`、`searchBudgetLostImpressionShare`、`searchRankLostImpressionShare`。CLI 落盘前已统一为 **0~1 小数**（与 `competitiveMetrics` 同名项一致；有嵌套时以 `competitiveMetrics` 为准）。Top/AbsoluteTop/Content/ClickShare 等扩展项仅存在于 `competitiveMetrics`。展示为百分比：`(v * 100).toFixed(2) + '%'`。
 
 ### campaign-hour 字段
 
-`campaignId`、`campaignName`、`date`、`hour`、`spend`、`impressions`、`clicks`、`conversions`。根为 JSON 数组（非 `{ campaigns: … }` 包装）。
+`items[]` 每行：`campaignId`、`campaignName`、`date`、`hour`、`spend`、`impressions`、`clicks`、`conversions`（`schemaVersion 3` 起行统一在 `items[]`，不再是裸数组根）。
 
 ---
 

package/dist/skill/references/analytics/rag.md

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 

package/dist/skill/references/analytics/reporting.md

@@ -207,8 +207,8 @@ siluzan-tso report list -m Google --json-out ./snap
 
 # 第二步：查看 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/analytics/website-diagnosis-guide.md

@@ -2,7 +2,7 @@
 
 > 对齐 Aiagent-Server `agent/tso_agent`：`getWebsiteDiagnosisData`（`website_diagnosis_tools.py` + `data/website_guide.py`）。  
 > **CLI 负责拉数**；**6 模块 × 29 子项评分**由 Agent 按规则 + 采集数据生成 JSON。  
-> **最终交付**：与线上一致，为**一份完整 HTML 报告**（TSO 网页由 Vue `WebsiteAnalysisReport/v3` 渲染；Skill/CLI 场景由 Agent 写出 `website-diagnosis-report.html`）。
+> **最终交付**：与线上一致，为**一份可浏览器打开、含 ECharts 图表的单文件 HTML 报告**（雷达图、模块得分条形图、Lighthouse 对比图等）。TSO 网页由 Vue `WebsiteAnalysisReport/v3` 渲染；Skill/CLI 场景用 `website-diagnosis render` 或按 `report-templates/website-diagnosis-report.html` 注入 JSON。
 
 ---
 
@@ -28,6 +28,9 @@ siluzan-tso website-diagnosis performance --url https://www.example.com --json-o
 
 # 按 diagnoseId 查 ARIT 得分（ID 来自 list-accounts 的 ma.diagnoseReports）
 siluzan-tso website-diagnosis search --ids <id1,id2> --json-out ./snap-web
+
+# 由诊断 JSON 生成带图表的 HTML 终稿
+siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json
 ```
 
 | 子命令 | HTTP | 基址 |
@@ -52,7 +55,11 @@ siluzan-tso website-diagnosis search --ids <id1,id2> --json-out ./snap-web
 2. `website-diagnosis collect --url <url> --json-out ./snap-web`（**必须** `--json-out`）。
 3. Read `assets/website-diagnosis-rules.md`（评分规则与 JSON Schema）。
 4. 用脚本读 `writtenFiles[0]` 的 `lighthouse`、`htmlPreview`（或 `--include-html` 时的 `htmlContent`）生成结构化 `data`（见下节输出契约）。
-5. 按 `report-templates/website-diagnosis-report.md` 生成并交付 **`website-diagnosis-report.html`**（单文件、可浏览器打开）；**禁止**只给 Markdown 摘要充当终稿。
+5. 生成诊断 JSON 后执行：
+   ```bash
+   siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json --out ./snap-web/website-diagnosis-report.html
+   ```
+   或按 `report-templates/website-diagnosis-report.html` 将 JSON 写入 `window.__WEBSITE_DIAGNOSIS__`。**禁止**只给 Markdown/纯 JSON 充当终稿。
 6. **禁止编造**未在采集 HTML/Lighthouse 中出现的指标。Lighthouse 缺失时须在 HTML 中醒目说明。
 
 **在 TSO Copilot 网页内**：工具返回 `rendered: true` 时，前端已渲染卡片 +「查看详情」全页 HTML，Agent 只需简短确认，**勿重复贴报告正文**（见 tso_agent `prompt.py`）。

package/dist/skill/references/core/agent-conventions.md

@@ -67,6 +67,7 @@
 - **破坏性操作必须确认 + `--commit`**：账户解绑/关闭/取消分享、BC/MCC 解绑、删除预警/报告/广告/关键词、发票申请、广告发布等。
 - **不确定时读文档**：先读对应 references 或用 `-h`，不要猜参数。
 - **Google 新建搜索系列**：流程仅在 `references/google-ads/google-ads-campaign-plan.md` 维护。
+- **开户首次响应**：用户第一次提出开户（或对话内首次进入开户话题）时，**必须先**按 `references/accounts/open-account-by-media.md` §「首次响应硬规范」输出**完整必填清单**（未指明媒体则列全平台六表），再收集资料；**禁止**未列清单就执行 `open-account` 或只零散追问个别字段。
 - **Google 开户**：`open-account google-wizard` 仅限真实 TTY；Agent/自动化用非交互 `open-account google ...`，审核进度用 `account-history`。
 - **主动更新**：详见 `references/core/setup.md`。
 
@@ -120,6 +121,7 @@
 - **币种只认接口字段**：`list-accounts` → `items[].ma.currencyCode`；同媒体可同时有 CNY 与 USD，不得凭媒体猜币种。
 - **符号**：`CNY` → **￥**；`USD` → **$**。多账户按 `currencyCode` 分表，**禁止**跨币种求和。
 - **金额单位统一为「元」**：报告保留 2 位小数。
+- **Google 广告诊断报告**：`report-templates/google-ads-diagnosis.md` § 撰写硬约束 — 每日趋势金额/CPA 必须 2 位小数；每个模块除表格外须有「分析」+「建议」，禁止只贴数据。
 - **品牌名优先级**：(1) 用户明确提供 → (2) `list-accounts.mag.advertiserName` → (3) 网址域名占位 `[待确认品牌名]`。**严禁**把英文域名翻译为虚构中文品牌。
 
 ---

package/dist/skill/references/core/playbooks.md

@@ -22,7 +22,8 @@
 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`
-5. 用 `report-templates/google-account-diagnosis-report.md` 模板输出，首行标注统计区间和货币。
+5. 诊断/画像报告：Read `report-templates/google-ads-diagnosis.md`（**硬约束：每日趋势 2 位小数、每模块必有分析**）+ `google-account-diagnosis-report.md`（章节与 CLI）；`google-analysis --json-out` 须含 `daily-metrics`（按日趋势）。
+6. 首行标注统计区间和货币；HTML 可对齐 `report-template.html` + `section-*` 区块。
 
 ---
 
@@ -182,6 +183,6 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 
 3. Read `assets/website-diagnosis-rules.md`；按 outline → JSON 读 `lighthouse` / `htmlPreview`。
 4. 生成与 tso_agent `getWebsiteDiagnosisData` 同结构的 `data`（6 模块、29 子项、`ratingId`、`coreIssuesIds`）。
-5. 按 `report-templates/website-diagnosis-report.md` 写出 **`website-diagnosis-report.html`**（与线上一致的整页 HTML 结构；版式可参考 `report-templates/website-diagnosis-report.html` 骨架或 `report-template.html`）。
+5. 执行 `website-diagnosis render --data <diagnosis.json> --collect <collect.json>` 生成 **带图表的** `website-diagnosis-report.html`（模板见 `report-templates/website-diagnosis-report.html`）；勿只交付 Markdown。
 6. Lighthouse 缺失时在 HTML 中说明；Copilot 网页场景若已 `rendered: true` 则勿重复输出报告正文。
 7. 若用户仅需历史 ARIT 分：`list-accounts` 或 `website-diagnosis search --ids <websiteDiagnoseId>`。