siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

package/dist/skill/references/analytics/market-analysis-guide.md

@@ -1,8 +1,9 @@
 # 战略市场分析（Market Analysis）
 
-> 对齐 TSO Copilot `getMarketReport` 业务目标；**Skill/CLI 场景**与网页版分工不同：  
-> - **TSO 网页**：Copilot 工具内调 `aisearch` 一次生成 HTML  
-> - **siluzan-tso Skill**：`collect` 只落盘上下文 → **宿主 Agent** WebSearch/WebFetch 调研 → 写 `market-report.json` → `render` 出 HTML  
+> 对齐 TSO Copilot `getMarketReport` 业务目标；**Skill/CLI 场景**与网页版分工不同：
+>
+> - **TSO 网页**：Copilot 工具内调 `aisearch` 一次生成 HTML
+> - **siluzan-tso Skill**：`collect` 只落盘上下文 → **宿主 Agent** WebSearch/WebFetch 调研 → 写 `market-report.json` → `render` 出 HTML
 
 **质量门禁**（见 `assets/market-analysis-rules.md`）：`render` 按 **原始业务维度清单** 校验必含内容，缺项失败（非文件大小）。
 
@@ -12,12 +13,12 @@
 
 ## 与相近能力区分
 
-| 能力 | 入口 | 说明 |
-| ---- | ---- | ---- |
-| **战略市场分析** | `market-analysis collect` + Agent + `render` | KA 战略报告（公开数据 + Agent 归纳） |
-| **网站诊断** | `website-diagnosis collect` + Agent + `render` | 落地页 6 模块评分 |
-| **账户周期报告** | `google-analysis` | 广告投放数据 |
-| **拓词市场指标** | `keyword suggest` | Keyword Planner 搜索量/CPC |
+| 能力             | 入口                                           | 说明                                 |
+| ---------------- | ---------------------------------------------- | ------------------------------------ |
+| **战略市场分析** | `market-analysis collect` + Agent + `render`   | KA 战略报告（公开数据 + Agent 归纳） |
+| **网站诊断**     | `website-diagnosis collect` + Agent + `render` | 落地页 6 模块评分                    |
+| **账户周期报告** | `google-analysis`                              | 广告投放数据                         |
+| **拓词市场指标** | `keyword suggest`                              | Keyword Planner 搜索量/CPC           |
 
 ---
 
@@ -40,10 +41,10 @@ siluzan-tso market-analysis render \
   --out ./snap-market/market-analysis-report.html
 ```
 
-| 子命令 | 网络请求 | 说明 |
-| ------ | -------- | ---- |
-| `collect` | 可选 `POST Agent /download-assets`（有 `--website` 时） | 不调用 aisearch |
-| `render` | 无 | 读取本地 JSON 写 HTML |
+| 子命令    | 网络请求                                                | 说明                  |
+| --------- | ------------------------------------------------------- | --------------------- |
+| `collect` | 可选 `POST Agent /download-assets`（有 `--website` 时） | 不调用 aisearch       |
+| `render`  | 无                                                      | 读取本地 JSON 写 HTML |
 
 有 `--website` 时走 Agent 网关（与 `website-diagnosis collect` 相同）：`SILUZAN_AGENT_BASE` / `agent.mysiluzan.com`。
 
@@ -51,16 +52,16 @@ siluzan-tso market-analysis render \
 
 ## 输入参数
 
-| 参数 | CLI 选项 | 必填 | 默认 |
-| ---- | -------- | ---- | ---- |
-| 客户名称 | `--customer-name` | 四选一* | — |
-| 客户网站 | `--website` | 四选一* | — |
-| 所属行业 | `--industry` | 四选一* | — |
-| 核心产品 | `--core-products` | 四选一* | — |
-| 商业定位 | `--business-position` | 否 | — |
-| 目标市场 | `--target-market` | 否 | 全球 |
-| 时间范围 | `--time-range` | 否 | 近12个月 |
-| 跳过官网抓取 | `--skip-website` | 否 | 有 website 时默认抓取预览 |
+| 参数         | CLI 选项              | 必填     | 默认                      |
+| ------------ | --------------------- | -------- | ------------------------- |
+| 客户名称     | `--customer-name`     | 四选一\* | —                         |
+| 客户网站     | `--website`           | 四选一\* | —                         |
+| 所属行业     | `--industry`          | 四选一\* | —                         |
+| 核心产品     | `--core-products`     | 四选一\* | —                         |
+| 商业定位     | `--business-position` | 否       | —                         |
+| 目标市场     | `--target-market`     | 否       | 全球                      |
+| 时间范围     | `--time-range`        | 否       | 近12个月                  |
+| 跳过官网抓取 | `--skip-website`      | 否       | 有 website 时默认抓取预览 |
 
 \* 客户名称、网站、行业、核心产品**至少提供一项**。
 
@@ -77,7 +78,7 @@ siluzan-tso market-analysis render \
    ```bash
    siluzan-tso market-analysis render --data ./snap-market/market-report.json --out ./snap-market/market-analysis-report.html
    ```
-7. 向用户交付 HTML 路径；说明需联网加载 CDN。
+7. 向用户交付 HTML 路径；说明需联网加载 Bootstrap / ECharts CDN（`homeCDN/echarts.js`）。
 
 **禁止**跳过 `render` 直接把聊天里的 HTML 当终稿；**禁止**编造无来源的具体数据。
 
@@ -89,7 +90,12 @@ siluzan-tso market-analysis render \
 
 ```json
 {
-  "customerInfo": { "customerName": "…", "website": "…", "targetMarket": "北美", "timeRange": "近12个月" },
+  "customerInfo": {
+    "customerName": "…",
+    "website": "…",
+    "targetMarket": "北美",
+    "timeRange": "近12个月"
+  },
   "targetMarket": "北美",
   "timeRange": "近12个月",
   "collectedAt": "2026-06-05T12:00:00.000Z",

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

@@ -25,14 +25,14 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
 
 ## 参数说明
 
-| 选项          | 默认      | 说明                                                            |
-| ------------- | --------- | --------------------------------------------------------------- |
-| `-q, --query` | 必填      | 检索词。含空白时按词分检、去重合并（`--json-out` 含 `subQueries`）  |
-| `--folder-id` | 全库      | 文件夹 ID，逗号分隔；**已识别客户/品牌时强烈建议锁定**          |
-| `--tags`      | 不过滤    | 不传 = 全库无标签限制                                           |
-| `--partition` | `default` | 仅 `wiki` 或 `default`；长正文优先 `wiki`，缺细节再补 `default` |
-| `--top-k`     | 7         | 每分检 3–30 条；多词合并上限 `min(30, topK×词数)`               |
-| `--json-out`      | false     | 机器可读输出（含 `score` 0–1，越大越相关）                      |
+| 选项          | 默认      | 说明                                                               |
+| ------------- | --------- | ------------------------------------------------------------------ |
+| `-q, --query` | 必填      | 检索词。含空白时按词分检、去重合并（`--json-out` 含 `subQueries`） |
+| `--folder-id` | 全库      | 文件夹 ID，逗号分隔；**已识别客户/品牌时强烈建议锁定**             |
+| `--tags`      | 不过滤    | 不传 = 全库无标签限制                                              |
+| `--partition` | `default` | 仅 `wiki` 或 `default`；长正文优先 `wiki`，缺细节再补 `default`    |
+| `--top-k`     | 7         | 每分检 3–30 条；多词合并上限 `min(30, topK×词数)`                  |
+| `--json-out`  | false     | 机器可读输出（含 `score` 0–1，越大越相关）                         |
 
 `belongToId` 默认从当前登录账号的 `companyId` 解析；`csoBaseUrl` 从 TSO API 自动推导，可用 `SILUZAN_CSO_BASE` 覆盖。
 
@@ -40,14 +40,14 @@ siluzan-tso rag query -q "行业术语 英文类目" --folder-id <id> --top-k 10
 
 ## TSO 业务场景路由
 
-| 用户意图                       | 建议检索词（示例）                        | 后续 TSO 命令                                                     |
-| ------------------------------ | ----------------------------------------- | ----------------------------------------------------------------- |
+| 用户意图                       | 建议检索词（示例）                        | 后续 TSO 命令                                                                                                              |
+| ------------------------------ | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
 | 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`                     |
-| 开户行业/资质核对              | 营业执照经营范围、行业描述、品牌全称      | `accounts/open-account-by-media.md` 对应媒体开户流                         |
-| 优化建议解释                   | 产品毛利结构、旺季、转化路径（表单/电话） | `optimize` 记录 + 人工解读；数据仍来自 `google-analysis`          |
+| 关键字拓词补语境               | 产品型号、英文类目、行业术语、应用场景    | `keyword suggest -k "..."`；编排见 `analytics/keyword-planner-workflows.md`                                                |
+| 账户诊断 / 周期报告「背景」段  | 公司简介、主营产品、目标市场、认证资质    | `google-analysis` + `report-templates/` 对应模板                                                                           |
+| 询盘分析报告                   | 产品线、出口市场、客户画像、大洲业务侧重  | `report-templates/google-inquiry-analysis.md`                                                                              |
+| 开户行业/资质核对              | 营业执照经营范围、行业描述、品牌全称      | `accounts/open-account-by-media.md` 对应媒体开户流                                                                         |
+| 优化建议解释                   | 产品毛利结构、旺季、转化路径（表单/电话） | `optimize` 记录 + 人工解读；数据仍来自 `google-analysis`                                                                   |
 
 检索结果**只作事实参考**：广告标题/描述须符合 `google-ads/rules/google-ads-compliance.md`；数值指标仍以 CLI 拉数为准。
 
@@ -96,9 +96,9 @@ rag list --rag-only --json-out ./snap
 
 ## 与 CSO rag 的区别
 
-| 维度      | siluzan-tso `rag`                         | siluzan-cso `rag`                             |
-| --------- | ----------------------------------------- | --------------------------------------------- |
-| 主要用途  | 广告投放、分析、拓词、报告背景            | 社媒文案、三库素材、口播写稿                  |
+| 维度      | siluzan-tso `rag`                         | siluzan-cso `rag`                                       |
+| --------- | ----------------------------------------- | ------------------------------------------------------- |
+| 主要用途  | 广告投放、分析、拓词、报告背景            | 社媒文案、三库素材、口播写稿                            |
 | 默认 tags | 不过滤（按 folder 锁客户）                | 常配合三库 tags（见 CSO `references/analytics/rag.md`） |
-| 后续命令  | `ad` / `keyword` / `google-analysis`      | `publish` / 写稿工作流                        |
-| API       | 相同 `cutapi/v1/material/queryknowledges` | 相同                                          |
+| 后续命令  | `ad` / `keyword` / `google-analysis`      | `publish` / 写稿工作流                                  |
+| API       | 相同 `cutapi/v1/material/queryknowledges` | 相同                                                    |

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

@@ -25,7 +25,7 @@ siluzan-tso report list -m <媒体> [选项]
 | `-s, --status <ready>`   | 是否已生成：`true \| false`          |
 | `-k, --keyword <text>`   | 报告名称关键字                       |
 | `--start / --end <date>` | 日期范围（YYYY-MM-DD）               |
-| `--json-out`                 | 输出原始 JSON                        |
+| `--json-out`             | 输出原始 JSON                        |
 
 **仅 JSON 交付**：若用户明确要求「只输出一个 JSON / 不要解释」，回复中**只放一个** JSON 代码块（与本次 CLI stdout 一致），前后不加说明文字；分页结果以 JSON 内 `page` / `pageSize` / `total` / `itemCount` 为准，需全量时再翻页执行。
 
@@ -109,7 +109,7 @@ siluzan-tso report push list -m <媒体> [选项]
 | `--stopped`          | 仅已停用                        |
 | `--start` / `--end`  | 日期筛选                        |
 | `-p` / `--page-size` | 分页                            |
-| `--json-out`             | 原始 JSON（列表信封 + `items`） |
+| `--json-out`         | 原始 JSON（列表信封 + `items`） |
 
 #### create — 新建推送
 
@@ -190,8 +190,8 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 
 报告生成后，在网页查看。先用 `siluzan-tso config show` 获取 `webUrl`，再按以下规则拼接链接：
 
-| 媒体   | 报告类型         | URL 模板                                                 |
-| ------ | ---------------- | -------------------------------------------------------- |
+| 媒体   | 报告类型         | URL 模板                                                    |
+| ------ | ---------------- | ----------------------------------------------------------- |
 | Google | 日报（Daily）    | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
 | Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
 | TikTok | 日报             | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |

package/dist/skill/references/analytics/website-diagnosis-guide.md

@@ -8,12 +8,12 @@
 
 ## 与「广告诊断」区分
 
-| 能力 | 入口 | 说明 |
-| ---- | ---- | ---- |
-| **网站诊断** | `website-diagnosis collect` | 落地页/官网内容与性能、营销转化、6 模块评分 |
-| **Google 广告账户诊断** | 前端 `/v3/foreign_trade/tso/tool/AdvertisingDiagnosis` | 账户投放健康度，非网站 HTML 评分 |
-| **ARIT 历史分** | `list-accounts` / `website-diagnosis search` | `ma.diagnoseReports` 中 `reportSource=ARIT` 的 `summaryScore` |
-| **账户周期报告** | `google-analysis` + `google-period-report.md` | 投放数据报告，非网站诊断 |
+| 能力                    | 入口                                                   | 说明                                                          |
+| ----------------------- | ------------------------------------------------------ | ------------------------------------------------------------- |
+| **网站诊断**            | `website-diagnosis collect`                            | 落地页/官网内容与性能、营销转化、6 模块评分                   |
+| **Google 广告账户诊断** | 前端 `/v3/foreign_trade/tso/tool/AdvertisingDiagnosis` | 账户投放健康度，非网站 HTML 评分                              |
+| **ARIT 历史分**         | `list-accounts` / `website-diagnosis search`           | `ma.diagnoseReports` 中 `reportSource=ARIT` 的 `summaryScore` |
+| **账户周期报告**        | `google-analysis` + `google-period-report.md`          | 投放数据报告，非网站诊断                                      |
 
 ---
 
@@ -33,11 +33,11 @@ siluzan-tso website-diagnosis search --ids <id1,id2> --json-out ./snap-web
 siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-web/<collect>.json
 ```
 
-| 子命令 | HTTP | 基址 |
-| ------ | ---- | ---- |
-| `performance` | `GET /api/WebsiteDiagnosisReports/performance?url=` | TSO `apiBaseUrl` |
-| `collect` | 上式 + `POST /download-assets` body `{ urls: [url] }` | TSO + Agent 网关 |
-| `search` | `GET /query/WebsiteDiagnoseReport/search?ids=` | TSO |
+| 子命令        | HTTP                                                  | 基址             |
+| ------------- | ----------------------------------------------------- | ---------------- |
+| `performance` | `GET /api/WebsiteDiagnosisReports/performance?url=`   | TSO `apiBaseUrl` |
+| `collect`     | 上式 + `POST /download-assets` body `{ urls: [url] }` | TSO + Agent 网关 |
+| `search`      | `GET /query/WebsiteDiagnoseReport/search?ids=`        | TSO              |
 
 **Agent 网关**（与 `TSOWebsiteService` 一致）：
 
@@ -94,25 +94,25 @@ siluzan-tso website-diagnosis render --data ./diagnosis.json --collect ./snap-we
 }
 ```
 
-| 字段 | 说明 |
-| ---- | ---- |
-| `ratingId` | `s1` 优秀 … `s5` 不建议投放（见规则文档评分等级） |
-| `coreIssuesIds` | 从 `ci1`–`ci10` 选取适用项 |
-| `modules[].id` | `m1`–`m6` 六板块均须出现 |
+| 字段                 | 说明                                                                           |
+| -------------------- | ------------------------------------------------------------------------------ |
+| `ratingId`           | `s1` 优秀 … `s5` 不建议投放（见规则文档评分等级）                              |
+| `coreIssuesIds`      | 从 `ci1`–`ci10` 选取适用项                                                     |
+| `modules[].id`       | `m1`–`m6` 六板块均须出现                                                       |
 | `items[].suggestion` | 较差/需优化/缺失类 status → **「强烈建议：」** 开头；其余 → **「推荐优化：」** |
 
 ---
 
 ## 六模块一览（29 子项，ID 与 tso_agent 一致）
 
-| ID | 名称 | 子项 ID |
-| -- | ---- | ------- |
-| m1 | 网站内容及结构 | m1i1–m1i9 |
-| m2 | 网站性能 | m2i1–m2i5 |
-| m3 | 营销基础与广告落地页 | m3i1、m3i2、m3i4、m3i5（无 m3i3） |
-| m4 | 用户体验与转化 | m4i1–m4i5 |
-| m5 | 媒体广告投放辅助 | m5i1、m5i2、m5i4（无 m5i3） |
-| m6 | 社交媒体辅助 | m6i1–m6i3 |
+| ID  | 名称                 | 子项 ID                           |
+| --- | -------------------- | --------------------------------- |
+| m1  | 网站内容及结构       | m1i1–m1i9                         |
+| m2  | 网站性能             | m2i1–m2i5                         |
+| m3  | 营销基础与广告落地页 | m3i1、m3i2、m3i4、m3i5（无 m3i3） |
+| m4  | 用户体验与转化       | m4i1–m4i5                         |
+| m5  | 媒体广告投放辅助     | m5i1、m5i2、m5i4（无 m5i3）       |
+| m6  | 社交媒体辅助         | m6i1–m6i3                         |
 
 子项满分、判断规则、评分细则见 **`assets/website-diagnosis-rules.md`**（摘自 `tso_agent/data/website_guide.py`）。