sino-bc-cli 1.8.5 → 1.8.7

package/dist/generated/api-catalog.json

@@ -2,7 +2,7 @@
   {
     "name": "sino-opti-hive-biz-line-list",
     "displayName": "查询业务线分页列表",
-    "description": "result 为公司分页对象：total=总条数，result=当前页的 BizLineListVO 列表。",
+    "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": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/biz-line/list",
@@ -20,12 +20,14 @@
           "type": "integer",
           "format": "int32",
           "description": "页码，从 1 开始",
+          "title": "页码",
           "example": 1
         },
         "pageSize": {
           "type": "integer",
           "format": "int32",
           "description": "每页条数",
+          "title": "每页条数",
           "example": 20
         },
         "sortType": {
@@ -37,6 +39,7 @@
             "PERIOD",
             "TRAFFIC_LIGHT"
           ],
+          "title": "排序字段",
           "example": "SPEND"
         },
         "sortDirection": {
@@ -46,28 +49,33 @@
             "ASC",
             "DESC"
           ],
+          "title": "排序方向",
           "example": "DESC"
         },
         "name": {
           "type": "string",
-          "description": "业务线名称，模糊搜索"
+          "description": "业务线名称，模糊搜索",
+          "title": "业务线名称"
         },
         "status": {
           "type": "integer",
           "format": "int32",
           "description": "状态：1=进行中 2=已完成 3=已暂停",
+          "title": "状态",
           "example": 1
         },
         "ssoTeamCode": {
           "type": "string",
-          "description": "组别 code，精确筛选（多选请用 ssoTeamCodeList）"
+          "description": "组别 code，精确筛选（多选请用 ssoTeamCodeList）",
+          "title": "组别code"
         },
         "ssoTeamCodeList": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "组别 code 列表，多选"
+          "description": "组别 code 列表，多选",
+          "title": "组别code列表"
         },
         "trafficLightList": {
           "type": "array",
@@ -75,12 +83,14 @@
             "type": "integer",
             "format": "int32"
           },
-          "description": "红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。"
+          "description": "红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。",
+          "title": "红绿灯"
         },
         "adCategoryProjectId": {
           "type": "integer",
           "format": "int64",
-          "description": "投放品类：取接口biz-line-open-placement-categories"
+          "description": "投放品类：取接口biz-line-open-placement-categories",
+          "title": "投放品类"
         },
         "idList": {
           "type": "array",
@@ -88,7 +98,8 @@
             "type": "integer",
             "format": "int64"
           },
-          "description": "业务线 ID 列表"
+          "description": "业务线 ID 列表",
+          "title": "业务线ID列表"
         },
         "pmUserIds": {
           "type": "array",
@@ -96,29 +107,34 @@
             "type": "integer",
             "format": "int32"
           },
-          "description": "PM 用户 ID 多选（OR 语义：命中任一 PM）"
+          "description": "PM 用户 ID 多选（OR 语义：命中任一 PM）",
+          "title": "PM用户ID"
         },
         "projectRatingList": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "项目评级多选：S、A、B、C"
+          "description": "项目评级多选：S、A、B、C",
+          "title": "项目评级"
         },
         "businessRegionList": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "商务地区：EAST_CHINA=华东 SOUTH_CHINA=华南 NORTH_CHINA=华北"
+          "description": "商务地区：EAST_CHINA=华东 SOUTH_CHINA=华南 NORTH_CHINA=华北",
+          "title": "商务地区"
         },
         "newCustomerTag": {
           "type": "string",
-          "description": "新客标签单选，NEW_TAG = 新客   NONE_NEW_TAG = 非新客\n"
+          "description": "新客标签单选，NEW_TAG = 新客   NONE_NEW_TAG = 非新客\n",
+          "title": "新客标签"
         },
         "weekOverWeekFilter": {
           "type": "string",
-          "description": "周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上"
+          "description": "周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上",
+          "title": "周消耗环比"
         }
       }
     }
@@ -252,29 +268,34 @@
           "type": "integer",
           "format": "int32",
           "description": "页码，从 1 开始",
+          "title": "页码",
           "example": 1
         },
         "pageSize": {
           "type": "integer",
           "format": "int32",
           "description": "每页条数",
+          "title": "每页条数",
           "example": 20
         },
         "sortDirection": {
           "type": "string",
           "description": "DESC 或 ASC，默认 DESC",
+          "title": "排序方向",
           "example": "DESC"
         },
         "bizLineId": {
           "type": "integer",
           "format": "int64",
-          "description": "业务线 ID",
+          "description": "可选。不传则按权限查全部可见业务线。通过 POST /sino-opti-hive/biz-line/list 取 result.id",
+          "title": "业务线ID",
           "example": 1251
         },
         "trafficLight": {
           "type": "integer",
           "format": "int32",
-          "description": "红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。"
+          "description": "红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。",
+          "title": "红绿灯"
         }
       },
       "required": [
@@ -400,16 +421,52 @@
     "docFile": "sso.md"
   },
   {
-    "name": "icenter-mcp-strategy-dimension-facebook-ad-list",
+    "name": "sino-opti-hive-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": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/project-list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+project-list",
+    "risk": "read",
+    "summary": "业务线关联项目列表",
+    "docFile": "biz-line-strategy.md",
+    "requestSchema": {
+      "$ref": "#/components/schemas/BizLineProjectListReqVO"
+    }
+  },
+  {
+    "name": "sino-opti-hive-optimize-project-queryByPage",
+    "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": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/optimize/project/queryByPage",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+queryByPage",
+    "risk": "read",
+    "summary": "查询优化项目分页列表",
+    "docFile": "biz-line-strategy.md",
+    "requestSchema": {
+      "$ref": "#/components/schemas/OptimizeProjectQueryPageReqVO"
+    }
+  },
+  {
+    "name": "sino-icenter-mcp-strategy-dimension-facebook-ad-list",
     "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 字段里。",
     "group": "业务线策略",
     "method": "POST",
-    "path": "/icenter/mcp/strategy/dimension/facebook/ad/list",
+    "path": "/sino-icenter/mcp/strategy/dimension/facebook/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+facebook-dimension",
+    "shortcut": "+ad-list",
     "risk": "read",
     "summary": "Facebook广告策略维度数据",
     "docFile": "biz-line-strategy.md",
@@ -500,16 +557,16 @@
     }
   },
   {
-    "name": "icenter-mcp-strategy-dimension-google-ad-list",
+    "name": "sino-icenter-mcp-strategy-dimension-google-ad-list",
     "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": "业务线策略",
     "method": "POST",
-    "path": "/icenter/mcp/strategy/dimension/google/ad/list",
+    "path": "/sino-icenter/mcp/strategy/dimension/google/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+google-dimension",
+    "shortcut": "+google-ad-list",
     "risk": "read",
     "summary": "Google广告策略维度数据",
     "docFile": "biz-line-strategy.md",
@@ -600,16 +657,16 @@
     }
   },
   {
-    "name": "icenter-mcp-strategy-dimension-tiktok-ad-list",
+    "name": "sino-icenter-mcp-strategy-dimension-tiktok-ad-list",
     "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 字段里。",
     "group": "业务线策略",
     "method": "POST",
-    "path": "/icenter/mcp/strategy/dimension/tiktok/ad/list",
+    "path": "/sino-icenter/mcp/strategy/dimension/tiktok/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+tiktok-dimension",
+    "shortcut": "+tiktok-ad-list",
     "risk": "read",
     "summary": "TikTok广告策略维度数据",
     "docFile": "biz-line-strategy.md",
@@ -700,16 +757,16 @@
     }
   },
   {
-    "name": "icenter-mcp-strategy-metrics-facebook-ad-list",
+    "name": "sino-icenter-mcp-strategy-metrics-facebook-ad-list",
     "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 字段里。",
     "group": "业务线策略",
     "method": "POST",
-    "path": "/icenter/mcp/strategy/metrics/facebook/ad/list",
+    "path": "/sino-icenter/mcp/strategy/metrics/facebook/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+facebook-metrics",
+    "shortcut": "+facebook-ad-list",
     "risk": "read",
     "summary": "Facebook广告策略成效数据",
     "docFile": "biz-line-strategy.md",
@@ -820,16 +877,16 @@
     }
   },
   {
-    "name": "icenter-mcp-strategy-metrics-google-ad-list",
+    "name": "sino-icenter-mcp-strategy-metrics-google-ad-list",
     "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": "业务线策略",
     "method": "POST",
-    "path": "/icenter/mcp/strategy/metrics/google/ad/list",
+    "path": "/sino-icenter/mcp/strategy/metrics/google/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+google-metrics",
+    "shortcut": "+metrics-google-ad-list",
     "risk": "read",
     "summary": "Google广告策略成效数据",
     "docFile": "biz-line-strategy.md",
@@ -941,16 +998,16 @@
     }
   },
   {
-    "name": "icenter-mcp-strategy-metrics-tiktok-ad-list",
+    "name": "sino-icenter-mcp-strategy-metrics-tiktok-ad-list",
     "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": "业务线策略",
     "method": "POST",
-    "path": "/icenter/mcp/strategy/metrics/tiktok/ad/list",
+    "path": "/sino-icenter/mcp/strategy/metrics/tiktok/ad/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+tiktok-metrics",
+    "shortcut": "+metrics-tiktok-ad-list",
     "risk": "read",
     "summary": "TikTok广告策略成效数据",
     "docFile": "biz-line-strategy.md",