sino-bc-cli 1.8.7 → 1.8.9

package/dist/api-doc/oapi/biz-line-strategy.md

@@ -10,11 +10,7 @@
 
 `POST /sino-opti-hive/biz-line/list`
 
-result 为公司分页对象：total=总条数，result=当前页的 BizLineListVO 列表。
-
-核心指标字段有两个，含义不同不要混用：coreIndex = 业务线核心指标（业务线维度的 KPI 口径说明，来源业务线配置，与策略周期无关）；coreEffectIndex = 当期策略回顾里的核心效果指标（随策略周期变化，另有 prevCoreEffectIndex 为上期值）。
-
-需要查看某条业务线下挂了哪些项目及其广告账号时，用 result.result[].id 调 POST /sino-opti-hive/biz-line/project-list。
+查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。
 
 **请求体**
 
@@ -42,7 +38,13 @@ result 为公司分页对象：total=总条数，result=当前页的 BizLineList
 
 `POST /sino-opti-hive/biz-line/detail`
 
-result 为 BizLineDetailVO。
+业务线详情
+
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer |  |
 
 ## 3. 新建业务线
 
@@ -50,35 +52,96 @@ result 为 BizLineDetailVO。
 
 ⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。
 
-## 4. 编辑业务线
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `name` | string | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
+| `strategyControlDegree` | integer | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
+| `adCategoryProjectIds` | array | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | 投放品类-其他说明 |
+| `customerTypeIds` | array | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | 客户类型-其他说明 |
+| `amUserIds` | array | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | 核心指标 |
+| `monthlyMaterialCount` | string | 月度上新素材量 |
+| `projectInitStatus` | string | 项目初始化状态 |
+| `projectBrief` | string | 项目 Brief |
+| `corporationIds` | array | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | 关联项目 ID |
+| `ssoTeamCode` | string | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+
+## 4. 更新业务线
 
 `POST /sino-opti-hive/biz-line/update`
 
-⚠️ 写操作。成功时 result 为 Boolean，表示是否更新成功。
+更新业务线信息
+
+**请求体**
 
-## 5. 切换业务线状态
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `status` | integer | 状态：1进行中 2已完成 3已暂停 |
+| `name` | string | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
+| `strategyControlDegree` | integer | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
+| `adCategoryProjectIds` | array | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | 投放品类-其他说明 |
+| `customerTypeIds` | array | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | 客户类型-其他说明 |
+| `amUserIds` | array | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | 核心指标 |
+| `monthlyMaterialCount` | string | 月度上新素材量 |
+| `projectInitStatus` | string | 项目初始化状态 |
+| `projectBrief` | string | 项目 Brief |
+| `corporationIds` | array | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | 关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取；按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds |
+| `ssoTeamCode` | string | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+
+## 5. 更新业务线状态
 
 `POST /sino-opti-hive/biz-line/status/update`
 
 ⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。
 
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer |  |
+| `status` | integer | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
+
 ## 6. 删除业务线
 
 `POST /sino-opti-hive/biz-line/del`
 
 ⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
 
-## 7. 策略周期列表
-
-`POST /sino-opti-hive/biz-line/strategy/period-list`
+**请求体**
 
-result 为 BizLineStrategyPeriodListVO，含 items 与 total。
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer |  |
 
-## 8. 查询策略分页列表
+## 7. 查询投放策略分页列表
 
 `POST /sino-opti-hive/biz-line/strategy/list`
 
-result 为公司分页对象：total=总条数，result=当前页的 BizLineStrategyDetailVO 列表。
+查询投放策略分页列表
 
 **请求体**
 
@@ -86,73 +149,207 @@ result 为公司分页对象：total=总条数，result=当前页的 BizLineStra
 | --- | --- | --- |
 | `pageNum` | integer | 页码，从 1 开始 |
 | `pageSize` | integer | 每页条数 |
-| `sortDirection` | string | DESC 或 ASC，默认 DESC |
-| `bizLineId` | integer | 可选。不传则按权限查全部可见业务线。通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `sortDirection` | string | 创建日期排序 DESC 或 ASC，默认 DESC |
+| `bizLineId` | integer | 可选，不传则按权限查全部可见业务线。 |
 | `trafficLight` | integer | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
 
-## 9. 策略周期内关联项目周表消耗汇总
+## 8. 查询投放策略消耗信息
 
 `POST /sino-opti-hive/biz-line/strategy/spend`
 
-result 为 BizLineStrategySpendVO，含 totalSpend。
+查询投放策略消耗信息
+
+**请求体**
 
-## 10. 新建策略
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `strategyId` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+
+## 9. 新建投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/save`
 
-⚠️ 写操作。成功时 result 为 Boolean，表示是否保存成功。
+新建投放策略，投放策略按周填写
+
+**请求体**
 
-## 11. 编辑策略
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `bizLineId` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `periodStart` | string | 策略周期起（日期） |
+| `periodEnd` | string | 策略周期止（日期） |
+| `budgetStrategyTags` | array | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | 预算策略补充说明 |
+| `mediaStrategyTags` | array | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | 受众策略补充说明 |
+| `creativeStrategy` | string | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | 项目问题&机会，最大 5000 字 |
+| `spend` | string | 周期投放消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | 预算策略 learning |
+| `mediaStrategyEffect` | integer | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | 受众策略 learning |
+| `creativeStrategyEffect` | integer | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | 素材策略 learning |
+
+## 10. 更新投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/update`
 
-⚠️ 写操作。成功时 result 为 Boolean。version 为乐观锁；overwrite=true 强制覆盖。
+更新投放策略
+
+**请求体**
 
-## 12. 删除策略
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+| `version` | integer | 乐观锁版本号 |
+| `overwrite` | boolean | 默认 false：版本冲突则报错；true 强制覆盖 |
+| `bizLineId` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `periodStart` | string | 策略周期起（日期） |
+| `periodEnd` | string | 策略周期止（日期） |
+| `budgetStrategyTags` | array | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | 预算策略补充说明 |
+| `mediaStrategyTags` | array | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | 受众策略补充说明 |
+| `creativeStrategy` | string | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | 项目问题&机会，最大 5000 字 |
+| `spend` | string | 周期消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | 预算策略 learning |
+| `mediaStrategyEffect` | integer | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | 受众策略 learning |
+| `creativeStrategyEffect` | integer | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | 素材策略 learning |
+
+## 11. 删除投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/del`
 
-⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
+删除投放策略
 
-## 13. 业务线关联项目列表
+**请求体**
 
-`POST /sino-opti-hive/biz-line/project-list`
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
-按业务线 ID 查询该业务线绑定的项目列表，每个项目附带其绑定的广告账号。
+## 12. 查询业务线关联项目和广告账号
 
-用途：已知业务线时，查看它下面挂了哪些项目、每个项目在投哪些渠道的哪些广告账号。常用于业务线消耗/成效数据的下钻，或校对业务线与项目的关联关系。
+`POST /sino-opti-hive/biz-line/project-list`
 
-入参：bizLineId（必填，业务线 ID）。业务线 ID 从 POST /sino-opti-hive/biz-line/list 的 result.result[].id 获得。
+根据业务线 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. 业务线不存在、或没有任何有效关联项目时，返回空数组而不是报错。
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `bizLineId` | integer | 业务线 ID，必填 |
 
-## 14. 查询优化项目分页列表
+## 13. 查询项目分页列表
 
 `POST /sino-opti-hive/optimize/project/queryByPage`
 
-分页查询优化工作台项目列表。常用于给业务线挑选关联项目：出参 projectId 填入 POST /sino-opti-hive/biz-line/save（或 /update）的 projectIds。
-
-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广告策略维度数据
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `pageNum` | integer | 页码，从 1 开始 |
+| `pageSize` | integer | 每页条数 |
+| `sortType` | string | lastWeekSpend=上周消耗；lastWeekSpendQoq=上周消耗环比；createTime=创建时间。不传默认 createTime |
+| `sortDirection` | string | ASC 升序，DESC 降序；默认 DESC |
+| `corporationId` | integer | 签约主体 ID |
+| `corporationIdList` | array | 签约主体 ID 多选 |
+| `projectId` | integer | 项目 ID，精确匹配 |
+| `projectIdList` | array | 项目 ID 多选。已知 ID 时直接传入；本接口出参 projectId 也可回填 |
+| `projectName` | string | 项目名称，模糊查询 |
+| `projectKeyword` | string | 项目 ID 精确，或项目名称分词模糊（空格分词，词之间 AND） |
+| `startDate` | string | 项目周期开始日期 yyyy-MM-dd |
+| `endDate` | string | 项目周期结束日期 yyyy-MM-dd |
+| `projectUserIdList` | array | 项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId，也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `ssoTeamCodeList` | array | 组别 code 多选，按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `adAccountId` | string | 广告账号 ID 模糊查询，至少 2 个字符 |
+| `demandOrderKeyword` | string | 需求单编号精确，或需求单名称分词模糊（空格分词） |
+| `signalLightList` | array | 项目红绿灯多选，与出参 signalLight 同值（字符串，不是业务线策略 trafficLight 的整数枚举） |
+| `projectStatusList` | array | 项目执行状态多选。本接口查的是项目（非需求）：4=待分配，5=执行中，6=已暂停，7=已完成，8=终止。出参 projectStatusName 为对应中文名 |
+| `isLast7DSpend` | array | 0=否，1=是。仅传一个值时生效；同时传 0 和 1 等于不筛 |
+| `uploadInfoTypeList` | array | 0=无上传，1=仅上传brief，2=仅上传mediaPlan，3=上传brief和mediaPlan。多选 |
+| `serviceCodeList` | array | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
+| `bizLineIdList` | array | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+
+## 14. 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：
@@ -166,16 +363,17 @@ 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 |
-
-## 16. Google广告策略维度数据
+| `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 为总条数，据此判断是否还有下一页。 |
+
+## 15. Google广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
@@ -201,16 +399,44 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、cpc_bid_amount（CPC出价）、cpm_bid_amount（CPM出价）、cpv_bid_amount（CPV出价）、advertising_channel_type（广告系列类型）、keywords（关键字）、country_code（国家，必须单独传，不能和其他维度同时传） |
 | `order` | string | 排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
 | `orderType` | string | 排序方向，默认 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，建议显式传且不超过1000 |
 
-## 17. TikTok广告策略维度数据
+## 16. TikTok广告策略维度数据
 
 `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：
@@ -224,20 +450,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 |
-
-## 18. Facebook广告策略成效数据
+| `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 为总条数，据此判断是否还有下一页。 |
+
+## 17. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
-查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。
+查询 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：
@@ -252,17 +511,18 @@ 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 |
-
-## 19. Google广告策略成效数据
+| `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 为总条数，据此判断是否还有下一页。 |
+
+## 18. Google广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
@@ -288,10 +548,11 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `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 |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 20. TikTok广告策略成效数据
+## 19. TikTok广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 
@@ -317,5 +578,6 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `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 |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |

package/dist/api-doc/oapi/sso.md

@@ -10,4 +10,4 @@
 
 `GET /sino-opti-hive/sso-team/group-list`
 
-无入参。返回 SSO 组别全量：code = teamCode（业务线 ssoTeamCode / ssoTeamCodeList），name = 组别名称。AccessContext 由网关注入，不出现在协议里。
+查询组别列表