sino-bc-cli 1.8.6 → 1.8.8

package/README.md

@@ -84,7 +84,7 @@ npm ls -g --depth=0 sino-bc-cli   # 确认全局安装的版本
 sino-bc-cli /init
 ```
 
-`/init` 会把根 `SKILL.md` 与 `skills/system/`、`skills/custom/` 下的标准子技能（`SKILL.md` + `references/`，同路径以 `custom` 为准）嵌进 `~/.agents/skills/sino-bc-cli/`，不出现 `system/` 或 `custom/` 这一层；同时删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录。豆包本地列表里只应看到 **`sino-bc-cli`**。飞书豆包工作侧还需：技能·连接器 → 管理 → **本地** → 刷新。查看包内技能：`sino-bc-cli /skill`。
+`/init` 会把根 `SKILL.md` 与 `skills/oapi/`、`skills/custom/`、`skills/default/` 下的标准子技能（`SKILL.md` + `references/`，同路径以后写的层为准）嵌进 `~/.agents/skills/sino-bc-cli/`，不出现 `oapi/` / `custom/` / `default/` 这一层；同时删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录。豆包本地列表里只应看到 **`sino-bc-cli`**。飞书豆包工作侧还需：技能·连接器 → 管理 → **本地** → 刷新。查看包内技能：`sino-bc-cli /skill`。
 
 > 每次升级版本后请重新执行一次 `sino-bc-cli /init`，以刷新本地技能文件。
 
@@ -536,7 +536,7 @@ npm run rebuild
 1. **写声明**：在 `src/shortcuts/biz-line/read.ts` 或 `write.ts` 里新增一条 `IShortcutDefinition`，声明 `command`、`risk`、`flags`，并在 `resolve()` 里返回目标接口与请求体
 2. **登记**：加入 `src/shortcuts/biz-line/index.ts` 的 `BIZ_LINE_SHORTCUTS` 数组
 3. **补测试**：在 `tests/` 下用 HTTP 桩断言请求与输出
-4. **同步文档**：`skills/system/sino-bc-biz-line` 的意图表、`affordance/biz-line.md` 的 WHEN、`src/api-doc/system/` 的字段口径；手写补充放 `skills/custom/` 与 `src/api-doc/custom/`；根 `SKILL.md` 只做入口
+4. **同步文档**：`skills/oapi/sino-bc-biz-line` 的意图表、`affordance/biz-line.md` 的 WHEN、`src/api-doc/oapi/` 的字段口径；手写补充放 `skills/default/`、`skills/custom/` 与 `src/api-doc/custom/`；根 `SKILL.md` 只做入口
 
 参数解析、输出格式、写操作确认门、错误归类都由 `src/shortcuts/index.ts` 统一承担，声明里不要自己发 HTTP。接口 `name` 一律取自 `src/generated/api-catalog.json`，不要新造。
 

package/dist/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: sino-bc-cli
 description: >
-  Use when 查询或操作 BeyondClick 业务线、周策略生成、广告结构、广告成效，或配置 sino-bc-cli：
-  投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯/客户满意度/ROAS；
-  Facebook / Google / TikTok 广告结构（账户、广告系列、广告组、广告、目标、出价、定向）
-  与广告成效（消耗、曝光、点击、购买、安装）；
+  Use when 查询或操作 BeyondClick 业务线、周策略、投放渠道/品类、关联项目、广告策略维度与成效，或配置 sino-bc-cli：
+  投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯、优化项目；
+  Facebook / Google / TikTok 广告策略维度（目标、出价、定向等配置分布）
+  与广告策略成效（消耗、曝光、点击等）；
   SSO 组别；以及 /init、/get-config、/set-config。
-  用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、biz-line、
+  用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、广告策略维度、biz-line、
   Meta、Facebook、Google、TikTok、sso、sino-opti-hive 时也必须用本技能，不要自己拼 HTTP。
   完整规则在子技能 sino-bc-shared 与 sino-bc-<domain>。
 metadata:
@@ -18,13 +18,13 @@ metadata:
 
 用全局 CLI `sino-bc-cli` 查询或操作 BeyondClick。本文件是**唯一对外技能**，也是决策页：按用户意图只读一份子技能，再执行命令。不要自己拼网关 HTTP，也不要一次读完全部子技能。
 
-`/init` 之后本机目录是 `~/.agents/skills/sino-bc-cli/`，子技能嵌在其下（没有 `system/` / `custom/` 这一层）：
+`/init` 之后本机目录是 `~/.agents/skills/sino-bc-cli/`，子技能嵌在其下（没有 `oapi/` / `custom/` / `default/` 这一层）：
 
 ```text
 sino-bc-cli/
 ├── SKILL.md                 ← 本文件
 ├── sino-bc-shared/          横切：配置、信封、确认门
-├── sino-bc-biz-line/        业务线、周策略、广告结构、广告成效
+├── sino-bc-biz-line/        业务线、周策略、投放渠道/品类、关联项目、广告策略维度与成效
 └── sino-bc-sso/             SSO 组别
 ```
 
@@ -54,8 +54,8 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 | 用户在问 | 读 | 命令入口 |
 | --- | --- | --- |
 | 环境、API_KEY、成功/失败怎么看、写操作要不要确认 | [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md) | `/init` `/get-config` `/set-config` |
-| 投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、红绿灯/消耗/ROAS | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
-| Facebook / Google / TikTok 广告结构（账户、系列、组、广告、目标、出价、定向）或广告成效（消耗、曝光、点击、购买、安装） | 同上 | `biz-line +<shortcut>`（维度 / 成效） |
+| 投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯、关联项目/优化项目 | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
+| Facebook / Google / TikTok 广告策略维度（目标、出价、定向等配置分布）或广告策略成效（消耗、曝光、点击等） | 同上 | `biz-line +<shortcut>`（维度 / 成效） |
 | SSO 组别 | [`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md) | `sso +group-list` |
 
 不要用本技能处理：本仓库源码开发、扩展命令、npm 发版（见仓库 `README.md` / `ReleaseSteps.md`）。
@@ -64,9 +64,9 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 
 Agent 先读子技能 `sino-bc-shared`，再按意图读域技能。
 
-1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/custom/sino-bc-shared/SKILL.md`](skills/custom/sino-bc-shared/SKILL.md)）
-2. 业务线、周策略生成、广告结构、广告成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/system/sino-bc-biz-line/SKILL.md`](skills/system/sino-bc-biz-line/SKILL.md)）
-3. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/system/sino-bc-sso/SKILL.md`](skills/system/sino-bc-sso/SKILL.md)）
+1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/default/sino-bc-shared/SKILL.md`](skills/default/sino-bc-shared/SKILL.md)）
+2. 业务线、周策略生成、广告结构、广告成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
+3. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/oapi/sino-bc-sso/SKILL.md`](skills/oapi/sino-bc-sso/SKILL.md)）
 
 安装与刷新（会写入上面列出的子技能到本机 `sino-bc-cli/`，并删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录）：
 
@@ -78,6 +78,6 @@ sino-bc-cli /skill
 列出包内技能：`sino-bc-cli /skill`（只有这一条）。查看某条命令何时用：`sino-bc-cli biz-line --help`。
 升级 CLI 后请再跑一次 `/init`。
 
-> 仓库里子技能分两层：`skills/system/sino-bc-<domain>/` 由 `npm run sync-api-doc` 生成；`skills/custom/sino-bc-shared/` 与 `skills/custom/sino-bc-<domain>/references/` 手写且不会被同步覆盖。每个子技能都是标准目录：`SKILL.md` + `references/`。
-> `/init` 把根 `SKILL.md` 与两层子技能嵌进 `~/.agents/skills/sino-bc-cli/`。
+> 仓库里子技能分三层：`skills/oapi/sino-bc-<domain>/` 由 `npm run sync-api-doc` **整层重写**（域 `SKILL.md` 不再与旧文件合并）；`skills/default/sino-bc-shared/` 与 `skills/custom/sino-bc-<domain>/references/` 手写且不会被同步覆盖。域 custom 不要放 `SKILL.md`，以免 `/init` 盖掉生成稿。每个子技能都是标准目录：`SKILL.md` + `references/`。
+> `/init` 把根 `SKILL.md` 与各层子技能嵌进 `~/.agents/skills/sino-bc-cli/`。
 > 上面的索引由同步脚本维护，改它请改 `src/api-utils/render-skills.ts`。

package/dist/affordance/biz-line.md

@@ -86,6 +86,18 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +categories`
 
+## +project-list
+
+- **WHEN**：业务线关联项目列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +project-list --data '{...}'`
+
+## +queryByPage
+
+- **WHEN**：查询优化项目分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +queryByPage --data '{...}'`
+
 ## +facebook-dimension
 
 - **WHEN**：Facebook广告策略维度数据

package/dist/api-doc/custom/README.md

@@ -10,16 +10,16 @@
 
 | 目录 | 来源 | 会不会被覆盖 |
 | --- | --- | --- |
-| `system/` | `npm run sync-api-doc` 从 Apifox 全量生成 | **每次同步整层重写**，不要手改 |
+| `oapi/` | `npm run sync-api-doc` 从 Apifox 全量生成 | **每次同步整层重写**，不要手改 |
 | `custom/` | 手写（本文件就在这里） | 同步脚本只读，不会创建、改写或删除 |
 
-两层出现同名文件时，运行时按 `custom/` → `system/` 顺序取第一个命中，即**手写件优先**。所以在 `custom/` 里放一份与生成文档同名的文件，会让同步结果看起来「没生效」——需要覆盖时才这么做。
+两层出现同名文件时，运行时按 `custom/` → `oapi/` 顺序取第一个命中，即**手写件优先**。所以在 `custom/` 里放一份与生成文档同名的文件，会让同步结果看起来「没生效」——需要覆盖时才这么做。
 
 | 分组 | 命令 | 接口数 | 文档 |
 | --- | --- | --- | --- |
-| 业务线查询 | `biz-line +channels` / `+categories` | 2 | [biz-line-query.md](../system/biz-line-query.md) |
-| 业务线策略 | `biz-line +list` / `+strategies` / `+save` / `+update` / `+status` / `+delete` / `+strategy-*`，其余 `biz-line api <name>` | 13 | [biz-line-strategy.md](../system/biz-line-strategy.md) |
-| SSO | `sso +group-list` | 1 | [sso.md](../system/sso.md) |
+| 业务线查询 | `biz-line +channels` / `+categories` | 2 | [biz-line-query.md](../oapi/biz-line-query.md) |
+| 业务线策略 | `biz-line +list` / `+strategies` / `+save` / `+update` / `+status` / `+delete` / `+strategy-*`，其余 `biz-line api <name>` | 13 | [biz-line-strategy.md](../oapi/biz-line-strategy.md) |
+| SSO | `sso +group-list` | 1 | [sso.md](../oapi/sso.md) |
 
 > 接口数随 Apifox 变动，以 `src/generated/api-catalog.json` 为准，本表只作导航。
 
@@ -51,9 +51,9 @@
 
 | 文档 | 分组 | 接口数 | 说明 |
 | --- | --- | --- | --- |
-| [biz-line-query.md](../system/biz-line-query.md) | 业务线查询 | 2 | 对外开放的只读查询：渠道、品类字典 |
-| [biz-line-strategy.md](../system/biz-line-strategy.md) | 业务线策略 | 13 | 业务线主数据与周策略的增删改查；`+list` / `+strategies` 改绑此组内部接口 |
-| [sso.md](../system/sso.md) | SSO | 1 | 团队组列表；上游挂在「业务线策略」tag 下，由映射表按 endpoint 拆到独立域 `sso` |
+| [biz-line-query.md](../oapi/biz-line-query.md) | 业务线查询 | 2 | 对外开放的只读查询：渠道、品类字典 |
+| [biz-line-strategy.md](../oapi/biz-line-strategy.md) | 业务线策略 | 13 | 业务线主数据与周策略的增删改查；`+list` / `+strategies` 改绑此组内部接口 |
+| [sso.md](../oapi/sso.md) | SSO | 1 | 团队组列表；上游挂在「业务线策略」tag 下，由映射表按 endpoint 拆到独立域 `sso` |
 
 对应命令：`biz-line +<shortcut>` / `sso +<shortcut>` 与 `<domain> api <name>`，接口清单定义在 `src/generated/api-catalog.json`。维护者同步：`npm run sync-api-doc`（token 见下文）。
 

package/dist/api-doc/{system → oapi}/biz-line-strategy.md

@@ -12,6 +12,10 @@
 
 result 为公司分页对象：total=总条数，result=当前页的 BizLineListVO 列表。
 
+核心指标字段有两个，含义不同不要混用：coreIndex = 业务线核心指标（业务线维度的 KPI 口径说明，来源业务线配置，与策略周期无关）；coreEffectIndex = 当期策略回顾里的核心效果指标（随策略周期变化，另有 prevCoreEffectIndex 为上期值）。
+
+需要查看某条业务线下挂了哪些项目及其广告账号时，用 result.result[].id 调 POST /sino-opti-hive/biz-line/project-list。
+
 **请求体**
 
 | 字段 | 类型 | 说明 |
@@ -83,7 +87,7 @@ result 为公司分页对象：total=总条数，result=当前页的 BizLineStra
 | `pageNum` | integer | 页码，从 1 开始 |
 | `pageSize` | integer | 每页条数 |
 | `sortDirection` | string | DESC 或 ASC，默认 DESC |
-| `bizLineId` | integer | 业务线 ID |
+| `bizLineId` | integer | 可选。不传则按权限查全部可见业务线。通过 POST /sino-opti-hive/biz-line/list 取 result.id |
 | `trafficLight` | integer | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
 
 ## 9. 策略周期内关联项目周表消耗汇总
@@ -110,13 +114,72 @@ result 为 BizLineStrategySpendVO，含 totalSpend。
 
 ⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
 
-## 13. Facebook广告策略维度数据
+## 13. 业务线关联项目列表
+
+`POST /sino-opti-hive/biz-line/project-list`
+
+按业务线 ID 查询该业务线绑定的项目列表，每个项目附带其绑定的广告账号。
+
+用途：已知业务线时，查看它下面挂了哪些项目、每个项目在投哪些渠道的哪些广告账号。常用于业务线消耗/成效数据的下钻，或校对业务线与项目的关联关系。
+
+入参：bizLineId（必填，业务线 ID）。业务线 ID 从 POST /sino-opti-hive/biz-line/list 的 result.result[].id 获得。
+
+返回：result 为项目数组，不分页、返回全量，元素含 projectId、projectName、adAccounts（广告账号列表，元素含 adAccountId、channelId、channelName）。
+
+注意事项：
+1. 只返回未删除的关联关系，且项目本身已删除的会被过滤，因此返回的项目数可能少于业务线实际配置过的项目数。
+2. adAccounts 只含分配状态为「已绑定」且未删除的广告账号；项目没有绑定账号时 adAccounts 为空数组，不是 null。
+3. channelName 由服务端按 channelId 从渠道缓存解析，缓存未命中时为 null，此时以 channelId 为准（取值同 GET /sino-opti-hive/biz-line-open/channels 的 code）。
+4. 业务线不存在、或没有任何有效关联项目时，返回空数组而不是报错。
+
+## 14. 查询优化项目分页列表
+
+`POST /sino-opti-hive/optimize/project/queryByPage`
+
+分页查询优化工作台项目列表。常用于给业务线挑选关联项目：出参 projectId 填入 POST /sino-opti-hive/biz-line/save（或 /update）的 projectIds。
 
-`POST /icenter/mcp/strategy/dimension/facebook/ad/list`
+result 为公司分页对象：total=总条数，result=当前页 OptimizeProjectVO。
+
+注意事项：
+1. userId 由网关注入，不要传。
+2. 不传 serviceCodeList 时，服务端默认只查代投类项目（code=1、85）。
+3. 排序用 sortType（lastWeekSpend / lastWeekSpendQoq / createTime）和 sortDirection（ASC/DESC），默认创建时间倒序。
+4. PageRequest 里 pagination、count、startIndex 等本接口未使用，不要传。
+
+## 15. Facebook广告策略维度数据
+
+`POST /sino-icenter/mcp/strategy/dimension/facebook/ad/list`
 
 查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。
 
-国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+【国家维度特别说明】
+country_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。
+3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
+4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"calendar_date":"desc","account_id":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
+5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
+
+【请求示例】
+{
+  "startDate": "2026-08-01",
+  "endDate": "2026-08-31",
+  "dimensionValues": {
+    "account_id": [
+      "act_1036928420879324"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "order": "calendar_date",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -130,18 +193,19 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `startDate` | string | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
-| `endDate` | string | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31 |
-| `dimensionValues` | object | 过滤条件，仅支持 account_id 一个 key，传其他 key 会报错 |
-| `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、country_code（国家，必须单独传，不能和其他维度同时传） |
-| `order` | string | 排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+| `startDate` | string | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
+| `endDate` | string | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。 |
+| `dimensionValues` | object | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、country_code（国家，必须单独传，不能和其他维度同时传） |
+| `order` | string | 单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
+| `orderType` | string | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | 页码，从 1 开始，默认 1。 |
+| `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 14. Google广告策略维度数据
+## 16. Google广告策略维度数据
 
-`POST /icenter/mcp/strategy/dimension/google/ad/list`
+`POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
 查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等），用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度，出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Google广告策略成效数据」接口。
 
@@ -168,13 +232,40 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 15. TikTok广告策略维度数据
+## 17. TikTok广告策略维度数据
 
-`POST /icenter/mcp/strategy/dimension/tiktok/ad/list`
+`POST /sino-icenter/mcp/strategy/dimension/tiktok/ad/list`
 
 查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。
 
-国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+【国家维度特别说明】
+country_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。
+3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
+4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"calendar_date":"desc","account_id":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
+5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
+
+【请求示例】
+{
+  "startDate": "2026-08-01",
+  "endDate": "2026-08-31",
+  "dimensionValues": {
+    "account_id": [
+      "<广告账户ID，格式同 account_id 维度返回值>"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "order": "calendar_date",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -188,20 +279,53 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `startDate` | string | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
-| `endDate` | string | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31 |
-| `dimensionValues` | object | 过滤条件，仅支持 account_id 一个 key，传其他 key 会报错 |
-| `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）、country_code（国家，必须单独传，不能和其他维度同时传） |
-| `order` | string | 排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
-
-## 16. Facebook广告策略成效数据
-
-`POST /icenter/mcp/strategy/metrics/facebook/ad/list`
-
-查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。
+| `startDate` | string | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
+| `endDate` | string | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。 |
+| `dimensionValues` | object | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）、country_code（国家，必须单独传，不能和其他维度同时传） |
+| `order` | string | 单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
+| `orderType` | string | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | 页码，从 1 开始，默认 1。 |
+| `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
+
+## 18. Facebook广告策略成效数据
+
+`POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
+
+查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。
+3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
+4. indicators：成效指标数组，必填。指标会在 dimensions 指定的分组粒度上做求和聚合。
+5. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"spend_usd":"desc","clicks":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
+6. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
+
+【请求示例】
+{
+  "startDate": "2026-08-01",
+  "endDate": "2026-08-31",
+  "dimensionValues": {
+    "account_id": [
+      "act_1036928420879324"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "indicators": [
+    "spend_usd",
+    "impressions",
+    "clicks"
+  ],
+  "order": "spend_usd",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -216,19 +340,20 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `startDate` | string | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
-| `endDate` | string | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天 |
-| `dimensionValues` | object | 过滤条件，仅支持 account_id 一个 key，传其他 key 会报错 |
-| `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别） |
-| `indicators` | array | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
-| `order` | string | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+| `startDate` | string | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
+| `endDate` | string | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。成效数据最多支持查询近21天，超出范围可能返回空数据。 |
+| `dimensionValues` | object | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别） |
+| `indicators` | array | 成效指标，字符串数组，必传且不能为空数组。指标会在 dimensions 指定的分组粒度上做求和聚合。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
+| `order` | string | 单字段排序的字段名，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
+| `orderType` | string | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | 页码，从 1 开始，默认 1。 |
+| `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 17. Google广告策略成效数据
+## 19. Google广告策略成效数据
 
-`POST /icenter/mcp/strategy/metrics/google/ad/list`
+`POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
 查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置（成效目标、创意类型、出价方式、广告系列类型、关键字等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。数据最多支持近21天。
 
@@ -255,9 +380,9 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 18. TikTok广告策略成效数据
+## 20. TikTok广告策略成效数据
 
-`POST /icenter/mcp/strategy/metrics/tiktok/ad/list`
+`POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 
 查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。