siluzan-tso-cli 1.1.22-beta.7 → 1.1.22

package/dist/skill/references/operations/optimize.md

@@ -2,12 +2,10 @@
 
 > 所属 skill：`siluzan-tso`。
 >
-> 对应页面：`/advertising/AiGoogleOptimize`
-
 ```bash
 siluzan-tso optimize list    [选项]                  # 账户级优化主列表
 siluzan-tso optimize records [选项]                  # 优化操作记录列表（系列粒度，见下）
-siluzan-tso optimize get --id <id>                   # 单条详情（与网页同源）
+siluzan-tso optimize get --id <id>                   # 单条详情
 siluzan-tso optimize children --parent-id <id>       # 广告系列级明细
 ```
 
@@ -49,4 +47,4 @@ siluzan-tso optimize get --id 4ced1f51-da71-4aac-84f9-4e2c4a25675f
 siluzan-tso optimize list -a 6326027735 --json-out ./snap
 ```
 
-**接口说明（`optimize get`）**：`GET {apiBaseUrl}/Smart-Ads-Optimize/v2/{id}`。请求带 Datapermission（CLI 自动 `ensureDataPermission`）。响应体字段以后端为准，通常为格式化 JSON 打印到 stdout。
+`optimize get` 输出格式化 JSON 到 stdout；字段以后端返回为准。

package/dist/skill/report-templates/README.md

@@ -17,7 +17,7 @@
 | ------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
 | `google-period-report.md`            | Google 账户分析报告（周期/月度/诊断均用此模板）                                                                |
 | `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等）                                                                      |
-| `google-ads-diagnosis.md`            | 与网页版《Google Ads 账户诊断报告》对齐的完整骨架                                                              |
+| `google-ads-diagnosis.md`            | Google 账户诊断报告纲要（配合 `google-analysis`）                                                            |
 | `meta-period-report.md`              | Meta（Facebook）账户周期报告                                                                                   |
 | `tiktok-period-report.md`            | TikTok 广告主周期报告                                                                                          |
 | `bing-period-report.md`              | Bing（BingV2）分析报告                                                                                         |

package/dist/skill/report-templates/bing-period-report.md

@@ -3,7 +3,7 @@
 > 统计区间：`{startDate}` ~ `{endDate}`（**不可包含今天或昨天**，见下文）  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
 
-与 TSO **`reporting/media-account/BingV2/{mediaCustomerId}/...`** 及 Web 端分析模块数据块对齐：总览、设备、地域、受众（年龄/性别）、系列、广告组、广告、关键词、搜索字词。
+数据块：总览、设备、地域、受众（年龄/性别）、系列、广告组、广告、关键词、搜索字词。
 
 ---
 
@@ -18,7 +18,6 @@
 ## 1. 执行摘要（总览）
 
 - **CLI**：`siluzan-tso report bing-overview -a <mediaCustomerId> [--start … --end …] --json-out <dir>`
-- **HTTP**：`GET …/OverviewSectionData?startDate=&endDate=`
 
 ## 2. 设备与地域
 
@@ -29,7 +28,7 @@
 
 - 年龄：`report bing-age-audience` → `AgeAudienceData`
 - 性别：`report bing-gender-audience` → `GenderAudienceData`
-- 与 Web 端两次请求合并：`report bing-audience-merged`（**固定输出合并 JSON**，不做前端 `filterAudienceData` 加工）
+- 合并输出：`report bing-audience-merged`（**固定输出合并 JSON**，含年龄+性别）
 
 ## 4. 广告结构
 

package/dist/skill/report-templates/google-ads-diagnosis.md

@@ -1,6 +1,6 @@
 # Google Ads 账户诊断报告
 
-> 本模板与「Google Ads 账户诊断报告」网页版章节、数据块一一对应，便于用 Markdown 复刻或对接 `google-analysis` CLI 拉数后填充。  
+> 账户诊断报告纲要：配合 `google-analysis` CLI 拉数后填充。  
 > 占位符：`{reportDate}` `{companyName}` `{period}` 等。
 
 ---
@@ -247,7 +247,7 @@
 
 ### 8.3 搜索词洞察
 
-列：搜索词、展示、点击、点击率、转化、转化率、每次转化费用
+列：搜索词、**已添加/已排除**（`queryTargetingStatusZh`）、展示、点击、点击率、转化、转化率、每次转化费用
 
 - **数据分析** / **优化建议**：`fullSearchTerms.analysis`、`fullSearchTerms.suggestions`
 

package/dist/skill/report-templates/google-inquiry-analysis.md

@@ -308,7 +308,7 @@ Sheet 5 整段系列明细读：`./snap-inquiry/campaigns-<accountId>_<S>-<E>.js
 | --- | --- |
 | 数据源 | `./snap-inquiry/<YYYY-MM>/campaigns-<accountId>_<月1号>-<月末>.json`（每月单独拉 `campaigns`；见「落盘防覆盖」） |
 | 聚合范围 | 该月内 **全部** `campaigns[]` 行（含已暂停但在区间内有消耗的系列；**禁止**只取 Top N 或手工筛系列） |
-| 与 Google 对齐 | 网关 `CampaignSectionData` 与 Web「账户分析 / 广告系列」同源；账户月表 = 各系列在当月起止日内指标之和 |
+| 数据口径 | `google-analysis campaigns` 与账户月表一致；账户月表 = 各系列在当月起止日内指标之和 |
 | 禁止 | `daily-metrics` / `stats` / `overview` 填上区投放列（询盘列仍来自 `inquiries.json`） |
 
 **脚本聚合（每月一份 `campaigns-*.json`）**：
@@ -443,7 +443,7 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 | R1               | `搜索字词--TOP100`                                                                                                                                                                                                                                                                      |
 | R2               | `<S> - <E>`（如 `2026年4月1日 - 2026年4月30日` 等中文区间）                                                                                                                                                                                                                             |
 | R3（A→Q，17 列） | `搜索字词` \| `搜索字词匹配类型` \| `已添加/已排除` \| `广告系列` \| `广告组` \| `搜索广告关键字` \| `点击次数` \| `展示次数` \| `点击率` \| `货币代码` \| `平均每次点击费用` \| `费用` \| `绝对页首展示次数百分比` \| `页首展示次数百分比` \| `转化次数` \| `每次转化费用` \| `转化率` |
-| R4…              | 读 `search-terms-*.json`（`data[]`）：`searchTermText` / `matchTypeZh` / **`已添加/已排除`**（若 JSON 字段不存在则填 `—`，**禁止**臆造）/ `campaignName` / `adGroupName` / `keywordText`（关键字）/ 数值字段；`货币代码` 来自 `list-accounts` 同账户 `currencyCode`                     |
+| R4…              | 读 `search-terms-*.json`（`data[]`）：`searchTermText` / `matchTypeZh` / **`queryTargetingStatusZh`**（已添加/已排除/都没有；网关字段 `queryTargetingStatus`）/ `campaignName` / `adGroupName` / `keywordText` / 数值字段；`货币代码` 来自 `list-accounts` 同账户 `currencyCode` |
 
 按 `费用` 降序前 100。
 
@@ -453,8 +453,8 @@ CPL          = 询盘个数 > 0 ? spend / 询盘个数 : —
 
 | #   | 洞察类别                                                            | 内容（每条引用本 Sheet 具体数字）                                                                                                                              |
 | --- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | **未添加但高转化搜索词**（候选加为关键词）                          | 列 `已添加/已排除` ≠ "已添加" 且 `转化次数` ≥ `{阈值}` 的搜索词，按转化降序前 10；阈值取本期搜索词转化中位数                                                   |
-| 2   | **已添加但 0 转化高消耗搜索词**（候选加为否定关键词）               | 列 `已添加/已排除` = "已添加" 且 `转化次数` = 0 且 `费用` > `¥{阈值}` 的搜索词，按消耗降序前 10；阈值取本期搜索词消耗 P75                                      |
+| 1   | **未添加但高转化搜索词**（候选加为关键词）                          | `queryTargetingStatusZh` = "都没有" 且 `转化次数` ≥ `{阈值}`，按转化降序前 10；阈值取本期搜索词转化中位数                                                     |
+| 2   | **已添加但 0 转化高消耗搜索词**（候选加为否定关键词）               | `queryTargetingStatusZh` = "已添加" 且 `转化次数` = 0 且 `费用` > `¥{阈值}`，按消耗降序前 10；阈值取本期搜索词消耗 P75                                        |
 | 3   | **无关搜索词**（意图偏离候选）                                      | 基于 `搜索字词` 文本扫描，标出与广告组 / 关键字 主题明显不符的词（如"工厂"系列出现"价格便宜""免费""教程"等），前 5；**仅展示**，**不**自动判定，由运营会上拍板 |
 | 4   | **匹配方式分布**                                                    | `Broad`：`{n_b}` 个、占消耗 `{p_b}%`；`Phrase`：`{n_p}` 个、占消耗 `{p_p}%`；`Exact`：`{n_e}` 个、占消耗 `{p_e}%`                                              |
 | 5   | **页首展示低 / 高消耗搜索词**（仅当 `页首展示次数百分比` 字段可用） | 列 `费用` Top20 中 `页首展示次数百分比` < 50% 的搜索词，前 5；提示"花了钱但很少展示到页首，出价/质量得分待优化"                                                |

package/dist/skill/report-templates/google-period-report.md

@@ -30,7 +30,7 @@
 | ------------- | ----------------------------------------------- | ------------------------------------------------------------ |
 | 系列按小时    | `google-analysis --sections campaign-hour`      | `campaign-hour`；根为 JSON 数组，含 `date`/`hour`/消耗与效果 |
 | 受众分布      | `google-analysis --sections audience`           | 可分 `SystemDefined` / `UserDefined`                         |
-| 搜索词报告    | `google-analysis --sections search-terms`       | 高消耗搜索词与关键词匹配关系                                 |
+| 搜索词报告    | `google-analysis --sections search-terms`       | 高消耗搜索词；`queryTargetingStatusZh` 列（已添加/已排除/都没有） |
 | 广告创意表现  | `google-analysis --sections ads`                | 广告标题/类型/到达网址                                       |
 | 附加信息      | `google-analysis --sections extensions`         | 附加链接/电话/宣传信息等状态                                 |
 | 图片/视频素材 | `google-analysis --sections materials`          | 图片 + 视频合并视图                                          |

package/dist/skill/report-templates/meta-period-report.md

@@ -3,16 +3,15 @@
 > 统计区间：`{startDate}` ~ `{endDate}`  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
 
-当前 TSO 侧 **Meta** 与 MarkAI `useAnalysisAction/api/meta.js` 对齐的拉数入口仅为 **账户总览**；系列/关键词/地域等维度若后端后续开放，可再扩展子命令并补全下列章节。
+当前 CLI 对 **Meta** 仅提供 **账户总览**（`report meta-overview`）；系列/关键词/地域等维度待后端开放后再补章节。
 
 ---
 
 ## 1. 执行摘要
 
-- 总消耗、余额（若有）、活跃天数、日均消耗、优化得分（接口若为 0–1，展示时 ×100 与前端一致）
+- 总消耗、余额（若有）、活跃天数、日均消耗、优化得分（接口若为 0–1，展示时 ×100）
 - 本期 / 上期：展示、点击、消耗、转化、CTR、CVR、CPC、CPA
 - **CLI**：`siluzan-tso report meta-overview -a <mediaCustomerId> [--start YYYY-MM-DD --end YYYY-MM-DD]`
-- **HTTP（TSO）**：`GET {tsoApiBaseUrl}/reporting/media-account/MetaAd/{mediaCustomerId}/OverviewSectionData?startDate=&endDate=`
 
 ## 2. 深度分析（占位）
 

package/dist/skill/report-templates/okki-weekly-google-client.md

@@ -148,7 +148,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
 | R1               | `搜索字词报告`                                                                                                                                                                                        |
 | R2               | 统计区间                                                                                                                                                                                              |
 | R3（A→N，14 列） | `搜索字词` \| `匹配类型` \| `已添加/已排除` \| `广告系列` \| `广告组` \| `关键字` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
-| R4…              | `search-terms-*.json`：`已添加/已排除` 若 JSON 无此枚举则留空或填「—」，禁止臆造；`ctr` / `conversionRate` 已归一，直接写入                                                                           |
+| R4…              | `search-terms-*.json`：`queryTargetingStatusZh`（`Added`→已添加、`Excluded`→已排除、`None`→都没有）；无该字段时读 `queryTargetingStatus` 按上表映射，仍无则「—」；`ctr` / `conversionRate` 已归一，直接写入 |
 
 ---
 

package/dist/skill/report-templates/tiktok-period-report.md

@@ -3,7 +3,7 @@
 > 统计区间：`{startDate}` ~ `{endDate}`  
 > 账户：`{mediaCustomerId}`（`{mediaCustomerName}`）
 
-与 TSO **`reporting/media-account/TikTok/{mediaCustomerId}/...`** 及周期报告常见数据块对齐：总览、广告层级（系列 / 组 / 广告）、素材视频、受众（含性别/年龄/兴趣合并块）、地域与设备可分别从广告/受众维度接口归纳（**以实际 JSON 字段为准**）。
+数据块：总览、系列/组/广告、视频素材、受众（含性别/年龄/兴趣合并）、地域与设备（**以 `--json-out` 实际字段为准**）。
 
 ---
 
@@ -11,7 +11,6 @@
 
 - 账户级消耗、展示、点击、转化、CTR、CPC 等（接口返回结构因版本可能略有差异）
 - **CLI**：`siluzan-tso report tiktok-overview -a <mediaCustomerId> [--start YYYY-MM-DD --end YYYY-MM-DD] --json-out <dir>`
-- **HTTP**：`GET {tsoApiBaseUrl}/reporting/media-account/TikTok/{id}/OverviewSectionData?startDate=&endDate=`
 
 ## 2. 广告结构（系列 / 广告组 / 广告）
 
@@ -22,19 +21,17 @@
 ## 3. 素材与创意（视频）
 
 - **CLI**：`siluzan-tso report tiktok-videos -a <id> [--start … --end …] [--take N] --json-out <dir>`
-- **HTTP**：`.../VideoReport?startDate=&endDate=&take=`
 
 ## 4. 受众分析
 
 - 单维度：`report tiktok-audience -a <id> -d <dimension> [--take N] --json-out <dir>`  
   可选 `dimension`：`gender` | `age` | `interest_category` | `country_code` | `platform` | `language`
-- **HTTP**：`.../AudienceReport?startDate=&endDate=&take=&dimensions=<dim>`
-- 周期报告中常与网页一致的三块合并：`report tiktok-audience-merged`（**固定输出合并 JSON**，含 `gender` / `age` / `interest_category` 三次响应）
+- 三块合并：`report tiktok-audience-merged`（**固定输出合并 JSON**，含 `gender` / `age` / `interest_category`）
 
 ## 5. 地域 / 兴趣辅助数据
 
-- 地区代码枚举：`report tiktok-areacode` → `GET {mainApiUrl}/query/media-account/tiktok/TikTokAreacode/Read`（解析地域报表、对照名称时使用）
-- 兴趣类目树：`report tiktok-interest-list -a <id>` → 需配置 **`tiktokApiUrl`**（`GetInterestList?mediaCustomerId=`）
+- 地区代码枚举：`report tiktok-areacode`（解析地域报表、对照名称）
+- 兴趣类目树：`report tiktok-interest-list -a <id>`（需配置 **`tiktokApiUrl`**）
 
 ## 6. 附录
 

package/dist/skill/scripts/install.ps1

@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.22-beta.7'
+$PKG_VERSION = '1.1.22'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
-$WEB_BASE    = 'https://www-ci.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
+$WEB_BASE    = 'https://www.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN    = 18

package/dist/skill/scripts/install.sh

@@ -9,11 +9,11 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.22-beta.7"
+readonly PKG_VERSION="1.1.22"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
-readonly WEB_BASE="https://www-ci.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
+readonly WEB_BASE="https://www.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.22-beta.7",
+  "version": "1.1.22",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",