sino-bc-cli 1.8.7 → 1.8.8

package/dist/generated/api-catalog.json

@@ -1,6 +1,6 @@
 [
   {
-    "name": "sino-opti-hive-biz-line-list",
+    "name": "biz-line-list",
     "displayName": "查询业务线分页列表",
     "description": "result 为公司分页对象：total=总条数，result=当前页的 BizLineListVO 列表。\n\n核心指标字段有两个，含义不同不要混用：coreIndex = 业务线核心指标（业务线维度的 KPI 口径说明，来源业务线配置，与策略周期无关）；coreEffectIndex = 当期策略回顾里的核心效果指标（随策略周期变化，另有 prevCoreEffectIndex 为上期值）。\n\n需要查看某条业务线下挂了哪些项目及其广告账号时，用 result.result[].id 调 POST /sino-opti-hive/biz-line/project-list。",
     "group": "业务线策略",
@@ -140,7 +140,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-detail",
+    "name": "biz-line-detail",
     "displayName": "业务线详情",
     "description": "result 为 BizLineDetailVO。",
     "group": "业务线策略",
@@ -158,7 +158,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-save",
+    "name": "biz-line-save",
     "displayName": "新建业务线",
     "description": "⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。",
     "group": "业务线策略",
@@ -176,7 +176,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-update",
+    "name": "biz-line-update",
     "displayName": "编辑业务线",
     "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否更新成功。",
     "group": "业务线策略",
@@ -194,7 +194,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-status-update",
+    "name": "biz-line-status-update",
     "displayName": "切换业务线状态",
     "description": "⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。",
     "group": "业务线策略",
@@ -212,7 +212,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-del",
+    "name": "biz-line-del",
     "displayName": "删除业务线",
     "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。",
     "group": "业务线策略",
@@ -230,7 +230,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-strategy-period-list",
+    "name": "biz-line-strategy-period-list",
     "displayName": "策略周期列表",
     "description": "result 为 BizLineStrategyPeriodListVO，含 items 与 total。",
     "group": "业务线策略",
@@ -248,7 +248,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-strategy-list",
+    "name": "biz-line-strategy-list",
     "displayName": "查询策略分页列表",
     "description": "result 为公司分页对象：total=总条数，result=当前页的 BizLineStrategyDetailVO 列表。",
     "group": "业务线策略",
@@ -304,7 +304,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-strategy-spend",
+    "name": "biz-line-strategy-spend",
     "displayName": "策略周期内关联项目周表消耗汇总",
     "description": "result 为 BizLineStrategySpendVO，含 totalSpend。",
     "group": "业务线策略",
@@ -322,7 +322,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-strategy-save",
+    "name": "biz-line-strategy-save",
     "displayName": "新建策略",
     "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否保存成功。",
     "group": "业务线策略",
@@ -340,7 +340,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-strategy-update",
+    "name": "biz-line-strategy-update",
     "displayName": "编辑策略",
     "description": "⚠️ 写操作。成功时 result 为 Boolean。version 为乐观锁；overwrite=true 强制覆盖。",
     "group": "业务线策略",
@@ -358,7 +358,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-strategy-del",
+    "name": "biz-line-strategy-del",
     "displayName": "删除策略",
     "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。",
     "group": "业务线策略",
@@ -376,7 +376,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-biz-line-open-channels",
+    "name": "biz-line-open-channels",
     "displayName": "查询投放渠道列表",
     "description": "无入参，返回 ChannelEnum 全量：code = 枚举 id（即 list 的 mediaChannelId），name = 渠道名称。",
     "group": "业务线查询",
@@ -391,7 +391,7 @@
     "docFile": "biz-line-query.md"
   },
   {
-    "name": "sino-opti-hive-biz-line-open-placement-categories",
+    "name": "biz-line-open-placement-categories",
     "displayName": "查询投放品类字典树",
     "description": "无入参，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。",
     "group": "业务线查询",
@@ -406,7 +406,7 @@
     "docFile": "biz-line-query.md"
   },
   {
-    "name": "sino-opti-hive-sso-team-group-list",
+    "name": "sso-team-group-list",
     "displayName": "查询组别列表",
     "description": "无入参。返回 SSO 组别全量：code = teamCode（业务线 ssoTeamCode / ssoTeamCodeList），name = 组别名称。AccessContext 由网关注入，不出现在协议里。",
     "group": "业务线策略",
@@ -421,7 +421,7 @@
     "docFile": "sso.md"
   },
   {
-    "name": "sino-opti-hive-biz-line-project-list",
+    "name": "biz-line-project-list",
     "displayName": "业务线关联项目列表",
     "description": "按业务线 ID 查询该业务线绑定的项目列表，每个项目附带其绑定的广告账号。\n\n用途：已知业务线时，查看它下面挂了哪些项目、每个项目在投哪些渠道的哪些广告账号。常用于业务线消耗/成效数据的下钻，或校对业务线与项目的关联关系。\n\n入参：bizLineId（必填，业务线 ID）。业务线 ID 从 POST /sino-opti-hive/biz-line/list 的 result.result[].id 获得。\n\n返回：result 为项目数组，不分页、返回全量，元素含 projectId、projectName、adAccounts（广告账号列表，元素含 adAccountId、channelId、channelName）。\n\n注意事项：\n1. 只返回未删除的关联关系，且项目本身已删除的会被过滤，因此返回的项目数可能少于业务线实际配置过的项目数。\n2. adAccounts 只含分配状态为「已绑定」且未删除的广告账号；项目没有绑定账号时 adAccounts 为空数组，不是 null。\n3. channelName 由服务端按 channelId 从渠道缓存解析，缓存未命中时为 null，此时以 channelId 为准（取值同 GET /sino-opti-hive/biz-line-open/channels 的 code）。\n4. 业务线不存在、或没有任何有效关联项目时，返回空数组而不是报错。",
     "group": "业务线策略",
@@ -439,7 +439,7 @@
     }
   },
   {
-    "name": "sino-opti-hive-optimize-project-queryByPage",
+    "name": "optimize-project-query-by-page",
     "displayName": "查询优化项目分页列表",
     "description": "分页查询优化工作台项目列表。常用于给业务线挑选关联项目：出参 projectId 填入 POST /sino-opti-hive/biz-line/save（或 /update）的 projectIds。\n\nresult 为公司分页对象：total=总条数，result=当前页 OptimizeProjectVO。\n\n注意事项：\n1. userId 由网关注入，不要传。\n2. 不传 serviceCodeList 时，服务端默认只查代投类项目（code=1、85）。\n3. 排序用 sortType（lastWeekSpend / lastWeekSpendQoq / createTime）和 sortDirection（ASC/DESC），默认创建时间倒序。\n4. PageRequest 里 pagination、count、startIndex 等本接口未使用，不要传。",
     "group": "业务线策略",
@@ -457,16 +457,16 @@
     }
   },
   {
-    "name": "sino-icenter-mcp-strategy-dimension-facebook-ad-list",
+    "name": "icenter-strategy-dimension-facebook",
     "displayName": "Facebook广告策略维度数据",
-    "description": "查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。\n\n国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
+    "description": "查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。\n\n【国家维度特别说明】\ncountry_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。\n\n【入参填写规则】\n1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。\n2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。\n3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。\n4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。两者可同时使用，order 指定的字段会追加到 orders 之后。\n5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。\n\n【请求示例】\n{\n  \"startDate\": \"2026-08-01\",\n  \"endDate\": \"2026-08-31\",\n  \"dimensionValues\": {\n    \"account_id\": [\n      \"act_1036928420879324\"\n    ]\n  },\n  \"dimensions\": [\n    \"calendar_date\",\n    \"optimization_goal\"\n  ],\n  \"order\": \"calendar_date\",\n  \"orderType\": \"desc\",\n  \"page\": 1,\n  \"size\": 20\n}\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-icenter/mcp/strategy/dimension/facebook/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+ad-list",
+    "shortcut": "+facebook-dimension",
     "risk": "read",
     "summary": "Facebook广告策略维度数据",
     "docFile": "biz-line-strategy.md",
@@ -475,22 +475,22 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01"
+          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。"
         },
         "endDate": {
           "type": "string",
-          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31"
+          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。"
         },
         "dimensionValues": {
           "type": "object",
-          "description": "过滤条件，仅支持 account_id 一个 key，传其他 key 会报错",
+          "description": "过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{\"account_id\": [\"act_123\", \"act_456\"]}",
           "properties": {
             "account_id": {
               "type": "array",
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个"
+              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值形如 \"act_1036928420879324\"（带 act_ 前缀）。多个账户之间是「或」关系，返回这些账户的合并数据。"
             }
           },
           "required": [
@@ -525,11 +525,11 @@
               "country_code"
             ]
           },
-          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（国家，必须单独传，不能和其他维度同时传）"
+          "description": "分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 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": {
           "type": "string",
-          "description": "排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回"
+          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。"
         },
         "orderType": {
           "type": "string",
@@ -537,15 +537,20 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，默认 asc"
+          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。"
+        },
+        "orders": {
+          "type": "object",
+          "description": "多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可，不必传本字段。",
+          "properties": {}
         },
         "page": {
           "type": "integer",
-          "description": "页码，从1开始，默认1"
+          "description": "页码，从 1 开始，默认 1。"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认10，建议显式传且不超过1000"
+          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。"
         }
       },
       "required": [
@@ -557,7 +562,7 @@
     }
   },
   {
-    "name": "sino-icenter-mcp-strategy-dimension-google-ad-list",
+    "name": "icenter-strategy-dimension-google",
     "displayName": "Google广告策略维度数据",
     "description": "查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等），用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度，出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Google广告策略成效数据」接口。\n\n国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
     "group": "业务线策略",
@@ -566,7 +571,7 @@
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+google-ad-list",
+    "shortcut": "+google-dimension",
     "risk": "read",
     "summary": "Google广告策略维度数据",
     "docFile": "biz-line-strategy.md",
@@ -657,16 +662,16 @@
     }
   },
   {
-    "name": "sino-icenter-mcp-strategy-dimension-tiktok-ad-list",
+    "name": "icenter-strategy-dimension-tiktok",
     "displayName": "TikTok广告策略维度数据",
-    "description": "查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。\n\n国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
+    "description": "查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。\n\n【国家维度特别说明】\ncountry_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。\n\n【入参填写规则】\n1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。\n2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。\n3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。\n4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。两者可同时使用，order 指定的字段会追加到 orders 之后。\n5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。\n\n【请求示例】\n{\n  \"startDate\": \"2026-08-01\",\n  \"endDate\": \"2026-08-31\",\n  \"dimensionValues\": {\n    \"account_id\": [\n      \"<广告账户ID，格式同 account_id 维度返回值>\"\n    ]\n  },\n  \"dimensions\": [\n    \"calendar_date\",\n    \"optimization_goal\"\n  ],\n  \"order\": \"calendar_date\",\n  \"orderType\": \"desc\",\n  \"page\": 1,\n  \"size\": 20\n}\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-icenter/mcp/strategy/dimension/tiktok/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+tiktok-ad-list",
+    "shortcut": "+tiktok-dimension",
     "risk": "read",
     "summary": "TikTok广告策略维度数据",
     "docFile": "biz-line-strategy.md",
@@ -675,22 +680,22 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01"
+          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。"
         },
         "endDate": {
           "type": "string",
-          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31"
+          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。"
         },
         "dimensionValues": {
           "type": "object",
-          "description": "过滤条件，仅支持 account_id 一个 key，传其他 key 会报错",
+          "description": "过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{\"account_id\": [\"act_123\", \"act_456\"]}",
           "properties": {
             "account_id": {
               "type": "array",
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个"
+              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值格式需与本接口 account_id 维度返回的值完全一致；若不确定，可先只传 account_id 维度查询一次，确认格式后再用作过滤条件。多个账户之间是「或」关系，返回这些账户的合并数据。"
             }
           },
           "required": [
@@ -725,11 +730,11 @@
               "country_code"
             ]
           },
-          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（国家，必须单独传，不能和其他维度同时传）"
+          "description": "分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 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": {
           "type": "string",
-          "description": "排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回"
+          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。"
         },
         "orderType": {
           "type": "string",
@@ -737,15 +742,20 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，默认 asc"
+          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。"
+        },
+        "orders": {
+          "type": "object",
+          "description": "多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可，不必传本字段。",
+          "properties": {}
         },
         "page": {
           "type": "integer",
-          "description": "页码，从1开始，默认1"
+          "description": "页码，从 1 开始，默认 1。"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认10，建议显式传且不超过1000"
+          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。"
         }
       },
       "required": [
@@ -757,16 +767,16 @@
     }
   },
   {
-    "name": "sino-icenter-mcp-strategy-metrics-facebook-ad-list",
+    "name": "icenter-strategy-metrics-facebook",
     "displayName": "Facebook广告策略成效数据",
-    "description": "查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，如 spend_usd 的值为 618.42，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，如 display_spend_usd 的值带货币符号，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
+    "description": "查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。\n\n【入参填写规则】\n1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。\n2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。\n3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。\n4. indicators：成效指标数组，必填。指标会在 dimensions 指定的分组粒度上做求和聚合。\n5. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。两者可同时使用，order 指定的字段会追加到 orders 之后。\n6. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。\n\n【请求示例】\n{\n  \"startDate\": \"2026-08-01\",\n  \"endDate\": \"2026-08-31\",\n  \"dimensionValues\": {\n    \"account_id\": [\n      \"act_1036928420879324\"\n    ]\n  },\n  \"dimensions\": [\n    \"calendar_date\",\n    \"optimization_goal\"\n  ],\n  \"indicators\": [\n    \"spend_usd\",\n    \"impressions\",\n    \"clicks\"\n  ],\n  \"order\": \"spend_usd\",\n  \"orderType\": \"desc\",\n  \"page\": 1,\n  \"size\": 20\n}\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，如 spend_usd 的值为 618.42，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，如 display_spend_usd 的值带货币符号，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-icenter/mcp/strategy/metrics/facebook/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+facebook-ad-list",
+    "shortcut": "+facebook-metrics",
     "risk": "read",
     "summary": "Facebook广告策略成效数据",
     "docFile": "biz-line-strategy.md",
@@ -775,22 +785,22 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01"
+          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。"
         },
         "endDate": {
           "type": "string",
-          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天"
+          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。成效数据最多支持查询近21天，超出范围可能返回空数据。"
         },
         "dimensionValues": {
           "type": "object",
-          "description": "过滤条件，仅支持 account_id 一个 key，传其他 key 会报错",
+          "description": "过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{\"account_id\": [\"act_123\", \"act_456\"]}",
           "properties": {
             "account_id": {
               "type": "array",
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个"
+              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值形如 \"act_1036928420879324\"（带 act_ 前缀）。多个账户之间是「或」关系，返回这些账户的合并数据。"
             }
           },
           "required": [
@@ -823,7 +833,7 @@
               "targeting_genders"
             ]
           },
-          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（性别）"
+          "description": "分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 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": {
           "type": "array",
@@ -844,11 +854,11 @@
               "engagement"
             ]
           },
-          "description": "成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数）"
+          "description": "成效指标，字符串数组，必传且不能为空数组。指标会在 dimensions 指定的分组粒度上做求和聚合。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数）"
         },
         "order": {
           "type": "string",
-          "description": "排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回"
+          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。"
         },
         "orderType": {
           "type": "string",
@@ -856,15 +866,20 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，默认 asc"
+          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。"
+        },
+        "orders": {
+          "type": "object",
+          "description": "多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。只需单字段排序时用 order + orderType 即可，不必传本字段。",
+          "properties": {}
         },
         "page": {
           "type": "integer",
-          "description": "页码，从1开始，默认1"
+          "description": "页码，从 1 开始，默认 1。"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认10，建议显式传且不超过1000"
+          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。"
         }
       },
       "required": [
@@ -877,7 +892,7 @@
     }
   },
   {
-    "name": "sino-icenter-mcp-strategy-metrics-google-ad-list",
+    "name": "icenter-strategy-metrics-google",
     "displayName": "Google广告策略成效数据",
     "description": "查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置（成效目标、创意类型、出价方式、广告系列类型、关键字等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，如 spend_usd 的值为 618.42，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，如 display_spend_usd 的值带货币符号，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
     "group": "业务线策略",
@@ -886,7 +901,7 @@
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+metrics-google-ad-list",
+    "shortcut": "+google-metrics",
     "risk": "read",
     "summary": "Google广告策略成效数据",
     "docFile": "biz-line-strategy.md",
@@ -998,7 +1013,7 @@
     }
   },
   {
-    "name": "sino-icenter-mcp-strategy-metrics-tiktok-ad-list",
+    "name": "icenter-strategy-metrics-tiktok",
     "displayName": "TikTok广告策略成效数据",
     "description": "查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组，每行的每个字段有两个 key：\n一是原始值，key 即请求的 code，如 spend_usd 的值为 618.42，做计算或比较时用这个；\n二是展示值，key 加 display_ 前缀，如 display_spend_usd 的值带货币符号，直接呈现给用户时用这个，空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。\nresult.total 为总条数，result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。\n外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。",
     "group": "业务线策略",
@@ -1007,7 +1022,7 @@
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+metrics-tiktok-ad-list",
+    "shortcut": "+tiktok-metrics",
     "risk": "read",
     "summary": "TikTok广告策略成效数据",
     "docFile": "biz-line-strategy.md",