sino-bc-cli 1.8.8 → 1.8.9

package/dist/generated/api-catalog.json

@@ -2,7 +2,7 @@
   {
     "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。",
+    "description": "查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/biz-line/list",
@@ -136,13 +136,17 @@
           "description": "周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上",
           "title": "周消耗环比"
         }
-      }
+      },
+      "required": [
+        "pageNum",
+        "pageSize"
+      ]
     }
   },
   {
     "name": "biz-line-detail",
     "displayName": "业务线详情",
-    "description": "result 为 BizLineDetailVO。",
+    "description": "业务线详情",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/biz-line/detail",
@@ -154,7 +158,18 @@
     "summary": "业务线详情",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineDetailReqVO"
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "title": "业务线ID",
+          "example": 1251
+        }
+      },
+      "required": [
+        "id"
+      ]
     }
   },
   {
@@ -172,13 +187,169 @@
     "summary": "新建业务线",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineSaveReqVO"
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "业务线名称，业务/产品线名称不可重复",
+          "title": "业务线名称",
+          "example": "示例业务线"
+        },
+        "mediaChannels": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name",
+          "title": "投放渠道"
+        },
+        "strategyControlDegree": {
+          "type": "integer",
+          "format": "int32",
+          "description": "策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创）",
+          "title": "策略掌控程度",
+          "example": 3
+        },
+        "adCategoryIndustryIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id",
+          "title": "投放行业ID"
+        },
+        "adCategoryProjectIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther",
+          "title": "投放品类ID"
+        },
+        "adCategoryOther": {
+          "type": "string",
+          "description": "投放品类-其他说明",
+          "title": "投放品类-其他"
+        },
+        "customerTypeIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id",
+          "title": "客户类型ID"
+        },
+        "customerTypeOther": {
+          "type": "string",
+          "description": "客户类型-其他说明",
+          "title": "客户类型-其他"
+        },
+        "amUserIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
+          "title": "AM用户ID"
+        },
+        "pmUserIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
+          "title": "PM用户ID"
+        },
+        "customerInfrastructure": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常",
+          "title": "客户基建情况"
+        },
+        "coreIndex": {
+          "type": "string",
+          "description": "核心指标",
+          "title": "核心指标",
+          "example": "ROAS"
+        },
+        "monthlyMaterialCount": {
+          "type": "string",
+          "description": "月度上新素材量",
+          "title": "月度上新素材量",
+          "example": "20"
+        },
+        "projectInitStatus": {
+          "type": "string",
+          "description": "项目初始化状态",
+          "title": "项目初始化状态"
+        },
+        "projectBrief": {
+          "type": "string",
+          "description": "项目 Brief",
+          "title": "项目Brief"
+        },
+        "corporationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID",
+          "title": "关联签约主体ID"
+        },
+        "projectIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "关联项目 ID",
+          "title": "关联项目ID"
+        },
+        "ssoTeamCode": {
+          "type": "string",
+          "description": "组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code",
+          "title": "组别code",
+          "example": "TEAM_DEMO"
+        },
+        "businessRegion": {
+          "type": "string",
+          "description": "EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填",
+          "title": "商务地区",
+          "example": "CN"
+        },
+        "projectRating": {
+          "type": "string",
+          "description": "S、A、B、C。非新客必填",
+          "title": "项目评级",
+          "example": "A"
+        },
+        "newCustomerTag": {
+          "type": "string",
+          "description": "NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客）",
+          "title": "新客标签",
+          "example": "OLD"
+        }
+      },
+      "required": [
+        "name",
+        "ssoTeamCode",
+        "businessRegion"
+      ]
     }
   },
   {
     "name": "biz-line-update",
-    "displayName": "编辑业务线",
-    "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否更新成功。",
+    "displayName": "更新业务线",
+    "description": "更新业务线信息",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/biz-line/update",
@@ -187,15 +358,187 @@
     "domain": "biz-line",
     "shortcut": "+update",
     "risk": "write",
-    "summary": "编辑业务线",
+    "summary": "更新业务线",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineUpdateReqVO"
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "通过 POST /sino-opti-hive/biz-line/list 取 result.id",
+          "title": "业务线ID",
+          "example": 1251
+        },
+        "status": {
+          "type": "integer",
+          "format": "int32",
+          "description": "状态：1进行中 2已完成 3已暂停",
+          "title": "状态",
+          "example": 1
+        },
+        "name": {
+          "type": "string",
+          "description": "业务线名称，业务/产品线名称不可重复",
+          "title": "业务线名称",
+          "example": "示例业务线"
+        },
+        "mediaChannels": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name",
+          "title": "投放渠道"
+        },
+        "strategyControlDegree": {
+          "type": "integer",
+          "format": "int32",
+          "description": "策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创）",
+          "title": "策略掌控程度",
+          "example": 3
+        },
+        "adCategoryIndustryIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id",
+          "title": "投放行业ID"
+        },
+        "adCategoryProjectIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther",
+          "title": "投放品类ID"
+        },
+        "adCategoryOther": {
+          "type": "string",
+          "description": "投放品类-其他说明",
+          "title": "投放品类-其他"
+        },
+        "customerTypeIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id",
+          "title": "客户类型ID"
+        },
+        "customerTypeOther": {
+          "type": "string",
+          "description": "客户类型-其他说明",
+          "title": "客户类型-其他"
+        },
+        "amUserIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
+          "title": "AM用户ID"
+        },
+        "pmUserIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
+          "title": "PM用户ID"
+        },
+        "customerInfrastructure": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常",
+          "title": "客户基建情况"
+        },
+        "coreIndex": {
+          "type": "string",
+          "description": "核心指标",
+          "title": "核心指标",
+          "example": "ROAS"
+        },
+        "monthlyMaterialCount": {
+          "type": "string",
+          "description": "月度上新素材量",
+          "title": "月度上新素材量",
+          "example": "20"
+        },
+        "projectInitStatus": {
+          "type": "string",
+          "description": "项目初始化状态",
+          "title": "项目初始化状态"
+        },
+        "projectBrief": {
+          "type": "string",
+          "description": "项目 Brief",
+          "title": "项目Brief"
+        },
+        "corporationIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID",
+          "title": "关联签约主体ID"
+        },
+        "projectIds": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取；按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds",
+          "title": "关联项目ID"
+        },
+        "ssoTeamCode": {
+          "type": "string",
+          "description": "组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code",
+          "title": "组别code",
+          "example": "TEAM_DEMO"
+        },
+        "businessRegion": {
+          "type": "string",
+          "description": "EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填",
+          "title": "商务地区",
+          "example": "CN"
+        },
+        "projectRating": {
+          "type": "string",
+          "description": "S、A、B、C。非新客必填",
+          "title": "项目评级",
+          "example": "A"
+        },
+        "newCustomerTag": {
+          "type": "string",
+          "description": "NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客）",
+          "title": "新客标签",
+          "example": "OLD"
+        }
+      },
+      "required": [
+        "id",
+        "status",
+        "name",
+        "ssoTeamCode",
+        "businessRegion"
+      ]
     }
   },
   {
     "name": "biz-line-status-update",
-    "displayName": "切换业务线状态",
+    "displayName": "更新业务线状态",
     "description": "⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。",
     "group": "业务线策略",
     "method": "POST",
@@ -205,10 +548,29 @@
     "domain": "biz-line",
     "shortcut": "+status",
     "risk": "write",
-    "summary": "切换业务线状态",
+    "summary": "更新业务线状态",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineStatusUpdateReqVO"
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "title": "业务线ID",
+          "example": 1251
+        },
+        "status": {
+          "type": "integer",
+          "format": "int32",
+          "description": "状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum",
+          "title": "状态",
+          "example": 1
+        }
+      },
+      "required": [
+        "id",
+        "status"
+      ]
     }
   },
   {
@@ -226,141 +588,625 @@
     "summary": "删除业务线",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineDelReqVO"
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "title": "业务线ID",
+          "example": 1251
+        }
+      },
+      "required": [
+        "id"
+      ]
     }
   },
   {
-    "name": "biz-line-strategy-period-list",
-    "displayName": "策略周期列表",
-    "description": "result 为 BizLineStrategyPeriodListVO，含 items 与 total。",
+    "name": "biz-line-strategy-list",
+    "displayName": "查询投放策略分页列表",
+    "description": "查询投放策略分页列表",
     "group": "业务线策略",
     "method": "POST",
-    "path": "/sino-opti-hive/biz-line/strategy/period-list",
+    "path": "/sino-opti-hive/biz-line/strategy/list",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+period-list",
+    "shortcut": "+strategies",
     "risk": "read",
-    "summary": "策略周期列表",
+    "summary": "查询投放策略分页列表",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineStrategyPeriodListReqVO"
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "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": "可选，不传则按权限查全部可见业务线。",
+          "title": "业务线ID",
+          "example": 1251
+        },
+        "trafficLight": {
+          "type": "integer",
+          "format": "int32",
+          "description": "红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。",
+          "title": "红绿灯"
+        }
+      },
+      "required": [
+        "pageNum",
+        "pageSize"
+      ]
     }
   },
   {
-    "name": "biz-line-strategy-list",
-    "displayName": "查询策略分页列表",
-    "description": "result 为公司分页对象：total=总条数，result=当前页的 BizLineStrategyDetailVO 列表。",
+    "name": "biz-line-strategy-spend",
+    "displayName": "查询投放策略消耗信息",
+    "description": "查询投放策略消耗信息",
     "group": "业务线策略",
     "method": "POST",
-    "path": "/sino-opti-hive/biz-line/strategy/list",
+    "path": "/sino-opti-hive/biz-line/strategy/spend",
     "timeout": 20000,
     "tag": "业务线策略",
     "domain": "biz-line",
-    "shortcut": "+strategies",
+    "shortcut": "+spend",
     "risk": "read",
-    "summary": "查询策略分页列表",
+    "summary": "查询投放策略消耗信息",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
       "type": "object",
       "properties": {
-        "pageNum": {
+        "strategyId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
+          "title": "投放策略ID",
+          "example": 1
+        }
+      },
+      "required": [
+        "strategyId"
+      ]
+    }
+  },
+  {
+    "name": "biz-line-strategy-save",
+    "displayName": "新建投放策略",
+    "description": "新建投放策略，投放策略按周填写",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/save",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-save",
+    "risk": "write",
+    "summary": "新建投放策略",
+    "docFile": "biz-line-strategy.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "bizLineId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "通过 POST /sino-opti-hive/biz-line/list 取 result.id",
+          "title": "业务线ID",
+          "example": 1251
+        },
+        "periodStart": {
+          "type": "string",
+          "format": "date",
+          "description": "策略周期起（日期）",
+          "title": "策略周期起",
+          "example": "2026-09-01"
+        },
+        "periodEnd": {
+          "type": "string",
+          "format": "date",
+          "description": "策略周期止（日期）",
+          "title": "策略周期止",
+          "example": "2026-09-01"
+        },
+        "budgetStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
+          "title": "预算策略标签ID"
+        },
+        "budgetStrategySupplement": {
+          "type": "string",
+          "description": "预算策略补充说明",
+          "title": "预算策略补充说明"
+        },
+        "mediaStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
+          "title": "媒介策略标签ID"
+        },
+        "mediaStrategySupplement": {
+          "type": "string",
+          "description": "媒介策略补充说明",
+          "title": "媒介策略补充说明"
+        },
+        "audienceStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
+          "title": "受众策略标签ID"
+        },
+        "audienceStrategySupplement": {
+          "type": "string",
+          "description": "受众策略补充说明",
+          "title": "受众策略补充说明"
+        },
+        "creativeStrategy": {
+          "type": "string",
+          "description": "素材创意策略说明，最大 5000 字",
+          "title": "素材创意策略说明"
+        },
+        "previewPeriodStart": {
+          "type": "string",
+          "format": "date",
+          "description": "上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一",
+          "title": "上期策略周期起",
+          "example": "2026-09-01"
+        },
+        "previewPeriodEnd": {
+          "type": "string",
+          "format": "date",
+          "description": "上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日）",
+          "title": "上期策略周期止",
+          "example": "2026-09-01"
+        },
+        "previewBudgetStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
+          "title": "上期预算策略标签ID"
+        },
+        "previewBudgetStrategySupplement": {
+          "type": "string",
+          "description": "上期预算策略补充说明",
+          "title": "上期预算策略补充说明"
+        },
+        "previewMediaStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
+          "title": "上期媒介策略标签ID"
+        },
+        "previewMediaStrategySupplement": {
+          "type": "string",
+          "description": "上期媒介策略补充说明",
+          "title": "上期媒介策略补充说明"
+        },
+        "previewAudienceStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
+          "title": "上期受众策略标签ID"
+        },
+        "previewAudienceStrategySupplement": {
+          "type": "string",
+          "description": "上期受众策略补充说明",
+          "title": "上期受众策略补充说明"
+        },
+        "previewCreativeStrategy": {
+          "type": "string",
+          "description": "上期素材创意策略说明，最大 5000 字",
+          "title": "上期素材创意策略说明"
+        },
+        "trafficLight": {
+          "type": "integer",
+          "format": "int32",
+          "description": "红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利",
+          "title": "红绿灯"
+        },
+        "coreIssueCategories": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他",
+          "title": "核心问题分类"
+        },
+        "issuesAndOpportunities": {
+          "type": "string",
+          "description": "项目问题&机会，最大 5000 字",
+          "title": "项目问题&机会"
+        },
+        "spend": {
+          "type": "string",
+          "description": "周期投放消耗（回顾，展示用字符串），最大 50 字",
+          "title": "周期投放消耗"
+        },
+        "customerSatisfaction": {
+          "type": "integer",
+          "format": "int32",
+          "description": "客户满意度：1满意 2不满意",
+          "title": "客户满意度"
+        },
+        "satisfactionReason": {
+          "type": "string",
+          "description": "满意度原因说明，最大 5000 字",
+          "title": "满意度原因说明"
+        },
+        "coreEffectIndex": {
+          "type": "string",
+          "description": "核心效果指标，最大 5000 字",
+          "title": "核心效果指标"
+        },
+        "budgetStrategyEffect": {
+          "type": "integer",
+          "format": "int32",
+          "description": "预算策略效果：1有效 2无效 3待观察",
+          "title": "预算策略效果"
+        },
+        "budgetStrategyLearning": {
+          "type": "string",
+          "description": "预算策略 learning",
+          "title": "预算策略learning"
+        },
+        "mediaStrategyEffect": {
+          "type": "integer",
+          "format": "int32",
+          "description": "媒介策略效果：1有效 2无效 3待观察",
+          "title": "媒介策略效果"
+        },
+        "mediaStrategyLearning": {
+          "type": "string",
+          "description": "媒介策略 learning",
+          "title": "媒介策略learning"
+        },
+        "audienceStrategyEffect": {
+          "type": "integer",
+          "format": "int32",
+          "description": "受众策略效果：1有效 2无效 3待观察",
+          "title": "受众策略效果"
+        },
+        "audienceStrategyLearning": {
+          "type": "string",
+          "description": "受众策略 learning",
+          "title": "受众策略learning"
+        },
+        "creativeStrategyEffect": {
+          "type": "integer",
+          "format": "int32",
+          "description": "素材策略效果：1有效 2无效 3待观察",
+          "title": "素材策略效果"
+        },
+        "creativeStrategyLearning": {
+          "type": "string",
+          "description": "素材策略 learning",
+          "title": "素材策略learning"
+        }
+      },
+      "required": [
+        "bizLineId",
+        "periodStart",
+        "periodEnd",
+        "budgetStrategyTags",
+        "budgetStrategySupplement",
+        "mediaStrategyTags",
+        "mediaStrategySupplement",
+        "audienceStrategyTags",
+        "audienceStrategySupplement",
+        "creativeStrategy"
+      ]
+    }
+  },
+  {
+    "name": "biz-line-strategy-update",
+    "displayName": "更新投放策略",
+    "description": "更新投放策略",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-update",
+    "risk": "write",
+    "summary": "更新投放策略",
+    "docFile": "biz-line-strategy.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
+          "title": "投放策略ID",
+          "example": 1
+        },
+        "version": {
+          "type": "integer",
+          "format": "int32",
+          "description": "乐观锁版本号",
+          "title": "乐观锁版本号",
+          "example": 1
+        },
+        "overwrite": {
+          "type": "boolean",
+          "description": "默认 false：版本冲突则报错；true 强制覆盖",
+          "title": "强制覆盖",
+          "example": false
+        },
+        "bizLineId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "通过 POST /sino-opti-hive/biz-line/list 取 result.id",
+          "title": "业务线ID",
+          "example": 1251
+        },
+        "periodStart": {
+          "type": "string",
+          "format": "date",
+          "description": "策略周期起（日期）",
+          "title": "策略周期起",
+          "example": "2026-09-01"
+        },
+        "periodEnd": {
+          "type": "string",
+          "format": "date",
+          "description": "策略周期止（日期）",
+          "title": "策略周期止",
+          "example": "2026-09-01"
+        },
+        "budgetStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
+          "title": "预算策略标签ID"
+        },
+        "budgetStrategySupplement": {
+          "type": "string",
+          "description": "预算策略补充说明",
+          "title": "预算策略补充说明"
+        },
+        "mediaStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
+          "title": "媒介策略标签ID"
+        },
+        "mediaStrategySupplement": {
+          "type": "string",
+          "description": "媒介策略补充说明",
+          "title": "媒介策略补充说明"
+        },
+        "audienceStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
+          "title": "受众策略标签ID"
+        },
+        "audienceStrategySupplement": {
+          "type": "string",
+          "description": "受众策略补充说明",
+          "title": "受众策略补充说明"
+        },
+        "creativeStrategy": {
+          "type": "string",
+          "description": "素材创意策略说明，最大 5000 字",
+          "title": "素材创意策略说明"
+        },
+        "previewPeriodStart": {
+          "type": "string",
+          "format": "date",
+          "description": "上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一",
+          "title": "上期策略周期起",
+          "example": "2026-09-01"
+        },
+        "previewPeriodEnd": {
+          "type": "string",
+          "format": "date",
+          "description": "上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日）",
+          "title": "上期策略周期止",
+          "example": "2026-09-01"
+        },
+        "previewBudgetStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id",
+          "title": "上期预算策略标签ID"
+        },
+        "previewBudgetStrategySupplement": {
+          "type": "string",
+          "description": "上期预算策略补充说明",
+          "title": "上期预算策略补充说明"
+        },
+        "previewMediaStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id",
+          "title": "上期媒介策略标签ID"
+        },
+        "previewMediaStrategySupplement": {
+          "type": "string",
+          "description": "上期媒介策略补充说明",
+          "title": "上期媒介策略补充说明"
+        },
+        "previewAudienceStrategyTags": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "description": "上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id",
+          "title": "上期受众策略标签ID"
+        },
+        "previewAudienceStrategySupplement": {
+          "type": "string",
+          "description": "上期受众策略补充说明",
+          "title": "上期受众策略补充说明"
+        },
+        "previewCreativeStrategy": {
+          "type": "string",
+          "description": "上期素材创意策略说明，最大 5000 字",
+          "title": "上期素材创意策略说明"
+        },
+        "trafficLight": {
           "type": "integer",
           "format": "int32",
-          "description": "页码，从 1 开始",
-          "title": "页码",
-          "example": 1
+          "description": "红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利",
+          "title": "红绿灯"
         },
-        "pageSize": {
+        "coreIssueCategories": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他",
+          "title": "核心问题分类"
+        },
+        "issuesAndOpportunities": {
+          "type": "string",
+          "description": "项目问题&机会，最大 5000 字",
+          "title": "项目问题&机会"
+        },
+        "spend": {
+          "type": "string",
+          "description": "周期消耗（回顾，展示用字符串），最大 50 字",
+          "title": "周期消耗"
+        },
+        "customerSatisfaction": {
           "type": "integer",
           "format": "int32",
-          "description": "每页条数",
-          "title": "每页条数",
-          "example": 20
+          "description": "客户满意度：1满意 2不满意",
+          "title": "客户满意度"
         },
-        "sortDirection": {
+        "satisfactionReason": {
           "type": "string",
-          "description": "DESC 或 ASC，默认 DESC",
-          "title": "排序方向",
-          "example": "DESC"
+          "description": "满意度原因说明，最大 5000 字",
+          "title": "满意度原因说明"
         },
-        "bizLineId": {
+        "coreEffectIndex": {
+          "type": "string",
+          "description": "核心效果指标，最大 5000 字",
+          "title": "核心效果指标"
+        },
+        "budgetStrategyEffect": {
           "type": "integer",
-          "format": "int64",
-          "description": "可选。不传则按权限查全部可见业务线。通过 POST /sino-opti-hive/biz-line/list 取 result.id",
-          "title": "业务线ID",
-          "example": 1251
+          "format": "int32",
+          "description": "预算策略效果：1有效 2无效 3待观察",
+          "title": "预算策略效果"
         },
-        "trafficLight": {
+        "budgetStrategyLearning": {
+          "type": "string",
+          "description": "预算策略 learning",
+          "title": "预算策略learning"
+        },
+        "mediaStrategyEffect": {
           "type": "integer",
           "format": "int32",
-          "description": "红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。",
-          "title": "红绿灯"
+          "description": "媒介策略效果：1有效 2无效 3待观察",
+          "title": "媒介策略效果"
+        },
+        "mediaStrategyLearning": {
+          "type": "string",
+          "description": "媒介策略 learning",
+          "title": "媒介策略learning"
+        },
+        "audienceStrategyEffect": {
+          "type": "integer",
+          "format": "int32",
+          "description": "受众策略效果：1有效 2无效 3待观察",
+          "title": "受众策略效果"
+        },
+        "audienceStrategyLearning": {
+          "type": "string",
+          "description": "受众策略 learning",
+          "title": "受众策略learning"
+        },
+        "creativeStrategyEffect": {
+          "type": "integer",
+          "format": "int32",
+          "description": "素材策略效果：1有效 2无效 3待观察",
+          "title": "素材策略效果"
+        },
+        "creativeStrategyLearning": {
+          "type": "string",
+          "description": "素材策略 learning",
+          "title": "素材策略learning"
         }
       },
       "required": [
-        "bizLineId"
+        "id",
+        "version",
+        "bizLineId",
+        "periodStart",
+        "periodEnd",
+        "budgetStrategyTags",
+        "budgetStrategySupplement",
+        "mediaStrategyTags",
+        "mediaStrategySupplement",
+        "audienceStrategyTags",
+        "audienceStrategySupplement",
+        "creativeStrategy"
       ]
     }
   },
-  {
-    "name": "biz-line-strategy-spend",
-    "displayName": "策略周期内关联项目周表消耗汇总",
-    "description": "result 为 BizLineStrategySpendVO，含 totalSpend。",
-    "group": "业务线策略",
-    "method": "POST",
-    "path": "/sino-opti-hive/biz-line/strategy/spend",
-    "timeout": 20000,
-    "tag": "业务线策略",
-    "domain": "biz-line",
-    "shortcut": "+spend",
-    "risk": "read",
-    "summary": "策略周期内关联项目周表消耗汇总",
-    "docFile": "biz-line-strategy.md",
-    "requestSchema": {
-      "$ref": "#/components/schemas/BizLineStrategySpendReqVO"
-    }
-  },
-  {
-    "name": "biz-line-strategy-save",
-    "displayName": "新建策略",
-    "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否保存成功。",
-    "group": "业务线策略",
-    "method": "POST",
-    "path": "/sino-opti-hive/biz-line/strategy/save",
-    "timeout": 20000,
-    "tag": "业务线策略",
-    "domain": "biz-line",
-    "shortcut": "+strategy-save",
-    "risk": "write",
-    "summary": "新建策略",
-    "docFile": "biz-line-strategy.md",
-    "requestSchema": {
-      "$ref": "#/components/schemas/BizLineStrategySaveReqVO"
-    }
-  },
-  {
-    "name": "biz-line-strategy-update",
-    "displayName": "编辑策略",
-    "description": "⚠️ 写操作。成功时 result 为 Boolean。version 为乐观锁；overwrite=true 强制覆盖。",
-    "group": "业务线策略",
-    "method": "POST",
-    "path": "/sino-opti-hive/biz-line/strategy/update",
-    "timeout": 20000,
-    "tag": "业务线策略",
-    "domain": "biz-line",
-    "shortcut": "+strategy-update",
-    "risk": "write",
-    "summary": "编辑策略",
-    "docFile": "biz-line-strategy.md",
-    "requestSchema": {
-      "$ref": "#/components/schemas/BizLineStrategyUpdateReqVO"
-    }
-  },
   {
     "name": "biz-line-strategy-del",
-    "displayName": "删除策略",
-    "description": "⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。",
+    "displayName": "删除投放策略",
+    "description": "删除投放策略",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/biz-line/strategy/del",
@@ -369,16 +1215,28 @@
     "domain": "biz-line",
     "shortcut": "+strategy-delete",
     "risk": "high-risk-write",
-    "summary": "删除策略",
+    "summary": "删除投放策略",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineStrategyDelReqVO"
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "description": "通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id",
+          "title": "投放策略ID",
+          "example": 1
+        }
+      },
+      "required": [
+        "id"
+      ]
     }
   },
   {
     "name": "biz-line-open-channels",
     "displayName": "查询投放渠道列表",
-    "description": "无入参，返回 ChannelEnum 全量：code = 枚举 id（即 list 的 mediaChannelId），name = 渠道名称。",
+    "description": "查询投放渠道列表",
     "group": "业务线查询",
     "method": "GET",
     "path": "/sino-opti-hive/biz-line-open/channels",
@@ -392,8 +1250,8 @@
   },
   {
     "name": "biz-line-open-placement-categories",
-    "displayName": "查询投放品类字典树",
-    "description": "无入参，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。",
+    "displayName": "查询投放品类字典",
+    "description": "查询投放品类字典，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。",
     "group": "业务线查询",
     "method": "GET",
     "path": "/sino-opti-hive/biz-line-open/placement-categories",
@@ -402,13 +1260,13 @@
     "domain": "biz-line",
     "shortcut": "+categories",
     "risk": "read",
-    "summary": "查询投放品类字典树",
+    "summary": "查询投放品类字典",
     "docFile": "biz-line-query.md"
   },
   {
     "name": "sso-team-group-list",
     "displayName": "查询组别列表",
-    "description": "无入参。返回 SSO 组别全量：code = teamCode（业务线 ssoTeamCode / ssoTeamCodeList），name = 组别名称。AccessContext 由网关注入，不出现在协议里。",
+    "description": "查询组别列表",
     "group": "业务线策略",
     "method": "GET",
     "path": "/sino-opti-hive/sso-team/group-list",
@@ -422,8 +1280,8 @@
   },
   {
     "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. 业务线不存在、或没有任何有效关联项目时，返回空数组而不是报错。",
+    "displayName": "查询业务线关联项目和广告账号",
+    "description": "根据业务线 ID 查询业务线关联项目和广告账号\n",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/biz-line/project-list",
@@ -432,16 +1290,28 @@
     "domain": "biz-line",
     "shortcut": "+project-list",
     "risk": "read",
-    "summary": "业务线关联项目列表",
+    "summary": "查询业务线关联项目和广告账号",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/BizLineProjectListReqVO"
+      "type": "object",
+      "properties": {
+        "bizLineId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "业务线 ID，必填",
+          "title": "业务线ID",
+          "example": 1251
+        }
+      },
+      "required": [
+        "bizLineId"
+      ]
     }
   },
   {
     "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 等本接口未使用，不要传。",
+    "displayName": "查询项目分页列表",
+    "description": "查询项目分页列表",
     "group": "业务线策略",
     "method": "POST",
     "path": "/sino-opti-hive/optimize/project/queryByPage",
@@ -450,10 +1320,178 @@
     "domain": "biz-line",
     "shortcut": "+queryByPage",
     "risk": "read",
-    "summary": "查询优化项目分页列表",
+    "summary": "查询项目分页列表",
     "docFile": "biz-line-strategy.md",
     "requestSchema": {
-      "$ref": "#/components/schemas/OptimizeProjectQueryPageReqVO"
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "title": "页码",
+          "description": "页码，从 1 开始",
+          "format": "int32",
+          "example": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "title": "每页条数",
+          "description": "每页条数",
+          "format": "int32",
+          "example": 20
+        },
+        "sortType": {
+          "type": "string",
+          "title": "排序字段",
+          "description": "lastWeekSpend=上周消耗；lastWeekSpendQoq=上周消耗环比；createTime=创建时间。不传默认 createTime",
+          "enum": [
+            "lastWeekSpend",
+            "lastWeekSpendQoq",
+            "createTime"
+          ],
+          "example": "createTime"
+        },
+        "sortDirection": {
+          "type": "string",
+          "title": "排序方向",
+          "description": "ASC 升序，DESC 降序；默认 DESC",
+          "enum": [
+            "ASC",
+            "DESC"
+          ],
+          "example": "DESC"
+        },
+        "corporationId": {
+          "type": "integer",
+          "title": "签约主体ID",
+          "description": "签约主体 ID",
+          "format": "int32"
+        },
+        "corporationIdList": {
+          "type": "array",
+          "title": "签约主体ID列表",
+          "description": "签约主体 ID 多选",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "projectId": {
+          "type": "integer",
+          "title": "项目ID",
+          "description": "项目 ID，精确匹配",
+          "format": "int64"
+        },
+        "projectIdList": {
+          "type": "array",
+          "title": "项目ID列表",
+          "description": "项目 ID 多选。已知 ID 时直接传入；本接口出参 projectId 也可回填",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          }
+        },
+        "projectName": {
+          "type": "string",
+          "title": "项目名称",
+          "description": "项目名称，模糊查询"
+        },
+        "projectKeyword": {
+          "type": "string",
+          "title": "项目ID或名称",
+          "description": "项目 ID 精确，或项目名称分词模糊（空格分词，词之间 AND）"
+        },
+        "startDate": {
+          "type": "string",
+          "title": "项目周期起",
+          "description": "项目周期开始日期 yyyy-MM-dd",
+          "format": "date"
+        },
+        "endDate": {
+          "type": "string",
+          "title": "项目周期止",
+          "description": "项目周期结束日期 yyyy-MM-dd",
+          "format": "date"
+        },
+        "projectUserIdList": {
+          "type": "array",
+          "title": "项目成员ID",
+          "description": "项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId，也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "ssoTeamCodeList": {
+          "type": "array",
+          "title": "组别code",
+          "description": "组别 code 多选，按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code",
+          "items": {
+            "type": "string"
+          }
+        },
+        "adAccountId": {
+          "type": "string",
+          "title": "广告账号",
+          "description": "广告账号 ID 模糊查询，至少 2 个字符"
+        },
+        "demandOrderKeyword": {
+          "type": "string",
+          "title": "需求单编号或名称",
+          "description": "需求单编号精确，或需求单名称分词模糊（空格分词）"
+        },
+        "signalLightList": {
+          "type": "array",
+          "title": "红绿灯",
+          "description": "项目红绿灯多选，与出参 signalLight 同值（字符串，不是业务线策略 trafficLight 的整数枚举）",
+          "items": {
+            "type": "string"
+          }
+        },
+        "projectStatusList": {
+          "type": "array",
+          "title": "项目状态",
+          "description": "项目执行状态多选。本接口查的是项目（非需求）：4=待分配，5=执行中，6=已暂停，7=已完成，8=终止。出参 projectStatusName 为对应中文名",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "isLast7DSpend": {
+          "type": "array",
+          "title": "近7天是否有消耗",
+          "description": "0=否，1=是。仅传一个值时生效；同时传 0 和 1 等于不筛",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "uploadInfoTypeList": {
+          "type": "array",
+          "title": "已上传项目信息类型",
+          "description": "0=无上传，1=仅上传brief，2=仅上传mediaPlan，3=上传brief和mediaPlan。多选",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "serviceCodeList": {
+          "type": "array",
+          "title": "产品code",
+          "description": "服务/产品 code 多选。不传时服务端默认 1、85（代投类项目）",
+          "items": {
+            "type": "string"
+          }
+        },
+        "bizLineIdList": {
+          "type": "array",
+          "title": "业务线ID",
+          "description": "按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 result.id",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          }
+        }
+      }
     }
   },
   {
@@ -475,11 +1513,13 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。"
+          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。",
+          "title": "开始日期"
         },
         "endDate": {
           "type": "string",
-          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。"
+          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。",
+          "title": "结束日期"
         },
         "dimensionValues": {
           "type": "object",
@@ -490,12 +1530,14 @@
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值形如 \"act_1036928420879324\"（带 act_ 前缀）。多个账户之间是「或」关系，返回这些账户的合并数据。"
+              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值形如 \"act_1036928420879324\"（带 act_ 前缀）。多个账户之间是「或」关系，返回这些账户的合并数据。",
+              "title": "广告账户ID"
             }
           },
           "required": [
             "account_id"
-          ]
+          ],
+          "title": "过滤条件"
         },
         "dimensions": {
           "type": "array",
@@ -525,11 +1567,13 @@
               "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（国家，必须单独传，不能和其他维度同时传）"
+          "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（国家，必须单独传，不能和其他维度同时传）",
+          "title": "分组维度"
         },
         "order": {
           "type": "string",
-          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。"
+          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。",
+          "title": "排序字段"
         },
         "orderType": {
           "type": "string",
@@ -537,20 +1581,24 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。"
+          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。",
+          "title": "排序方向"
         },
         "orders": {
           "type": "object",
           "description": "多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可，不必传本字段。",
-          "properties": {}
+          "properties": {},
+          "title": "多字段排序"
         },
         "page": {
           "type": "integer",
-          "description": "页码，从 1 开始，默认 1。"
+          "description": "页码，从 1 开始，默认 1。",
+          "title": "页码"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。"
+          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。",
+          "title": "每页条数"
         }
       },
       "required": [
@@ -580,11 +1628,13 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01"
+          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01",
+          "title": "开始日期"
         },
         "endDate": {
           "type": "string",
-          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31"
+          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31",
+          "title": "结束日期"
         },
         "dimensionValues": {
           "type": "object",
@@ -595,12 +1645,14 @@
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个"
+              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个",
+              "title": "广告账户ID"
             }
           },
           "required": [
             "account_id"
-          ]
+          ],
+          "title": "过滤条件"
         },
         "dimensions": {
           "type": "array",
@@ -630,11 +1682,13 @@
               "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（广告名称）、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（国家，必须单独传，不能和其他维度同时传）"
+          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（国家，必须单独传，不能和其他维度同时传）",
+          "title": "分组维度"
         },
         "order": {
           "type": "string",
-          "description": "排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回"
+          "description": "排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回",
+          "title": "排序字段"
         },
         "orderType": {
           "type": "string",
@@ -642,15 +1696,24 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，默认 asc"
+          "description": "排序方向，默认 asc",
+          "title": "排序方向"
+        },
+        "orders": {
+          "type": "object",
+          "title": "多字段排序",
+          "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",
+          "title": "页码"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认10，建议显式传且不超过1000"
+          "description": "每页条数，默认10，建议显式传且不超过1000",
+          "title": "每页条数"
         }
       },
       "required": [
@@ -680,11 +1743,13 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。"
+          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。",
+          "title": "开始日期"
         },
         "endDate": {
           "type": "string",
-          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。"
+          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。",
+          "title": "结束日期"
         },
         "dimensionValues": {
           "type": "object",
@@ -695,12 +1760,14 @@
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值格式需与本接口 account_id 维度返回的值完全一致；若不确定，可先只传 account_id 维度查询一次，确认格式后再用作过滤条件。多个账户之间是「或」关系，返回这些账户的合并数据。"
+              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值格式需与本接口 account_id 维度返回的值完全一致；若不确定，可先只传 account_id 维度查询一次，确认格式后再用作过滤条件。多个账户之间是「或」关系，返回这些账户的合并数据。",
+              "title": "广告账户ID"
             }
           },
           "required": [
             "account_id"
-          ]
+          ],
+          "title": "过滤条件"
         },
         "dimensions": {
           "type": "array",
@@ -730,11 +1797,13 @@
               "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（国家，必须单独传，不能和其他维度同时传）"
+          "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（国家，必须单独传，不能和其他维度同时传）",
+          "title": "分组维度"
         },
         "order": {
           "type": "string",
-          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。"
+          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。",
+          "title": "排序字段"
         },
         "orderType": {
           "type": "string",
@@ -742,20 +1811,24 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。"
+          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。",
+          "title": "排序方向"
         },
         "orders": {
           "type": "object",
           "description": "多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{\"calendar_date\":\"desc\",\"account_id\":\"asc\"}。只需单字段排序时用 order + orderType 即可，不必传本字段。",
-          "properties": {}
+          "properties": {},
+          "title": "多字段排序"
         },
         "page": {
           "type": "integer",
-          "description": "页码，从 1 开始，默认 1。"
+          "description": "页码，从 1 开始，默认 1。",
+          "title": "页码"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。"
+          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。",
+          "title": "每页条数"
         }
       },
       "required": [
@@ -785,11 +1858,13 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。"
+          "description": "统计开始日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-01\"。必填。",
+          "title": "开始日期"
         },
         "endDate": {
           "type": "string",
-          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。成效数据最多支持查询近21天，超出范围可能返回空数据。"
+          "description": "统计结束日期，字符串，格式 yyyy-MM-dd，例如 \"2026-08-31\"。必填，需大于等于 startDate。成效数据最多支持查询近21天，超出范围可能返回空数据。",
+          "title": "结束日期"
         },
         "dimensionValues": {
           "type": "object",
@@ -800,12 +1875,14 @@
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值形如 \"act_1036928420879324\"（带 act_ 前缀）。多个账户之间是「或」关系，返回这些账户的合并数据。"
+              "description": "广告账户ID列表，字符串数组，必填且不能为空数组。取值形如 \"act_1036928420879324\"（带 act_ 前缀）。多个账户之间是「或」关系，返回这些账户的合并数据。",
+              "title": "广告账户ID"
             }
           },
           "required": [
             "account_id"
-          ]
+          ],
+          "title": "过滤条件"
         },
         "dimensions": {
           "type": "array",
@@ -833,7 +1910,8 @@
               "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（性别）"
+          "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（性别）",
+          "title": "分组维度"
         },
         "indicators": {
           "type": "array",
@@ -854,11 +1932,13 @@
               "engagement"
             ]
           },
-          "description": "成效指标，字符串数组，必传且不能为空数组。指标会在 dimensions 指定的分组粒度上做求和聚合。各指标含义：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（互动次数）",
+          "title": "成效指标"
         },
         "order": {
           "type": "string",
-          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。"
+          "description": "单字段排序的字段名，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。",
+          "title": "排序字段"
         },
         "orderType": {
           "type": "string",
@@ -866,20 +1946,24 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。"
+          "description": "排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。",
+          "title": "排序方向"
         },
         "orders": {
           "type": "object",
           "description": "多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{\"spend_usd\":\"desc\",\"clicks\":\"asc\"}。只需单字段排序时用 order + orderType 即可，不必传本字段。",
-          "properties": {}
+          "properties": {},
+          "title": "多字段排序"
         },
         "page": {
           "type": "integer",
-          "description": "页码，从 1 开始，默认 1。"
+          "description": "页码，从 1 开始，默认 1。",
+          "title": "页码"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。"
+          "description": "每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。",
+          "title": "每页条数"
         }
       },
       "required": [
@@ -910,11 +1994,13 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01"
+          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01",
+          "title": "开始日期"
         },
         "endDate": {
           "type": "string",
-          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天"
+          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天",
+          "title": "结束日期"
         },
         "dimensionValues": {
           "type": "object",
@@ -925,12 +2011,14 @@
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个"
+              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个",
+              "title": "广告账户ID"
             }
           },
           "required": [
             "account_id"
-          ]
+          ],
+          "title": "过滤条件"
         },
         "dimensions": {
           "type": "array",
@@ -959,7 +2047,8 @@
               "keywords"
             ]
           },
-          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（关键字）"
+          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（关键字）",
+          "title": "分组维度"
         },
         "indicators": {
           "type": "array",
@@ -980,11 +2069,13 @@
               "engagement"
             ]
           },
-          "description": "成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数）"
+          "description": "成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数）",
+          "title": "成效指标"
         },
         "order": {
           "type": "string",
-          "description": "排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回"
+          "description": "排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回",
+          "title": "排序字段"
         },
         "orderType": {
           "type": "string",
@@ -992,15 +2083,24 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，默认 asc"
+          "description": "排序方向，默认 asc",
+          "title": "排序方向"
+        },
+        "orders": {
+          "type": "object",
+          "title": "多字段排序",
+          "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",
+          "title": "页码"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认10，建议显式传且不超过1000"
+          "description": "每页条数，默认10，建议显式传且不超过1000",
+          "title": "每页条数"
         }
       },
       "required": [
@@ -1031,11 +2131,13 @@
       "properties": {
         "startDate": {
           "type": "string",
-          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01"
+          "description": "开始日期，格式 yyyy-MM-dd，例如 2026-08-01",
+          "title": "开始日期"
         },
         "endDate": {
           "type": "string",
-          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天"
+          "description": "结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天",
+          "title": "结束日期"
         },
         "dimensionValues": {
           "type": "object",
@@ -1046,12 +2148,14 @@
               "items": {
                 "type": "string"
               },
-              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个"
+              "description": "广告账户ID（带格式），必须带前缀，例如 act_1036928420879324。最多传500个",
+              "title": "广告账户ID"
             }
           },
           "required": [
             "account_id"
-          ]
+          ],
+          "title": "过滤条件"
         },
         "dimensions": {
           "type": "array",
@@ -1079,7 +2183,8 @@
               "deep_cpabid"
             ]
           },
-          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（性别）、objective（广告目标）、targeting_interests（兴趣词包）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）"
+          "description": "分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：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（性别）、objective（广告目标）、targeting_interests（兴趣词包）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）",
+          "title": "分组维度"
         },
         "indicators": {
           "type": "array",
@@ -1100,11 +2205,13 @@
               "engagement"
             ]
           },
-          "description": "成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数）"
+          "description": "成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数）",
+          "title": "成效指标"
         },
         "order": {
           "type": "string",
-          "description": "排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回"
+          "description": "排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回",
+          "title": "排序字段"
         },
         "orderType": {
           "type": "string",
@@ -1112,15 +2219,24 @@
             "desc",
             "asc"
           ],
-          "description": "排序方向，默认 asc"
+          "description": "排序方向，默认 asc",
+          "title": "排序方向"
+        },
+        "orders": {
+          "type": "object",
+          "title": "多字段排序",
+          "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",
+          "title": "页码"
         },
         "size": {
           "type": "integer",
-          "description": "每页条数，默认10，建议显式传且不超过1000"
+          "description": "每页条数，默认10，建议显式传且不超过1000",
+          "title": "每页条数"
         }
       },
       "required": [