sino-bc-cli 1.8.26 → 1.8.27

package/dist/generated/api-catalog.json

@@ -5560,6 +5560,684 @@
       "sso"
     ]
   },
+  {
+    "name": "atw-project-page",
+    "displayName": "查询工时系统项目列表（分页）",
+    "description": "分页查询工时系统项目列表，对应 t_atw_project 单表数据。",
+    "group": "项目分析",
+    "method": "POST",
+    "path": "/sino-opti-hive/atw/query/pageProjects",
+    "timeout": 180000,
+    "tag": "项目分析",
+    "domain": "project-analysis",
+    "shortcut": "+atw-projects",
+    "risk": "read",
+    "summary": "查询工时系统项目列表（分页）",
+    "docFile": "project-analysis.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从1开始；省略默认1，显式null或小于1时报错",
+          "minimum": 1,
+          "default": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数，省略默认10，显式null或小于1时报错",
+          "minimum": 1,
+          "default": 10
+        },
+        "atwProjectIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时系统项目ID列表",
+          "description": "工时系统项目ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "atwCreateTimeStart": {
+          "type": "string",
+          "title": "工时系统项目创建时间区间开始（含）",
+          "description": "工时系统项目创建时间区间开始（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+          "example": "2026-09-22 10:00:00"
+        },
+        "atwCreateTimeEnd": {
+          "type": "string",
+          "title": "工时系统项目创建时间区间结束（含）",
+          "description": "工时系统项目创建时间区间结束（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+          "example": "2026-09-22 10:00:00"
+        },
+        "projectIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "项目ID列表",
+          "description": "项目ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "name": {
+          "type": "string",
+          "title": "工时系统项目名称",
+          "description": "工时系统项目名称；包含匹配，空白不筛选"
+        },
+        "kindCode": {
+          "type": "string",
+          "title": "服务产品编码",
+          "description": "服务产品编码，来自工时系统字典；已知示例：1=广告优化运营（代投）、85=广告诊断顾问、-888=售前咨询，非固定枚举；精确匹配，不传不筛选"
+        }
+      }
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "format": "int64",
+          "description": "符合筛选条件的总条数；越界空页仍返回真实总数"
+        },
+        "result": {
+          "type": "array",
+          "description": "当前页数据",
+          "items": {
+            "type": "object",
+            "properties": {
+              "atwProjectId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统项目ID",
+                "description": "工时系统项目ID"
+              },
+              "atwCreateTime": {
+                "type": "string",
+                "title": "工时系统项目创建时间",
+                "description": "工时系统项目创建时间，格式 yyyy-MM-dd HH:mm:ss",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+                "example": "2026-09-22 10:00:00"
+              },
+              "projectId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "项目ID",
+                "description": "项目ID"
+              },
+              "name": {
+                "type": "string",
+                "title": "工时系统项目名称",
+                "description": "工时系统项目名称"
+              },
+              "kindCode": {
+                "type": "string",
+                "title": "服务产品编码",
+                "description": "服务产品编码，来自工时系统字典；已知示例：1=广告优化运营（代投）、85=广告诊断顾问、-888=售前咨询，非固定枚举"
+              },
+              "kindName": {
+                "type": "string",
+                "title": "服务产品名称",
+                "description": "服务产品名称，来自工时系统字典"
+              }
+            }
+          }
+        },
+        "page": {
+          "type": "integer",
+          "format": "int32",
+          "description": "当前页码"
+        },
+        "size": {
+          "type": "integer",
+          "format": "int32",
+          "description": "请求的每页条数"
+        }
+      }
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso"
+    ]
+  },
+  {
+    "name": "atw-task-page",
+    "displayName": "查询工时系统项目任务列表（分页）",
+    "description": "分页查询工时系统项目任务列表，对应 t_atw_task 单表数据。",
+    "group": "项目分析",
+    "method": "POST",
+    "path": "/sino-opti-hive/atw/query/pageTasks",
+    "timeout": 180000,
+    "tag": "项目分析",
+    "domain": "project-analysis",
+    "shortcut": "+atw-tasks",
+    "risk": "read",
+    "summary": "查询工时系统项目任务列表（分页）",
+    "docFile": "project-analysis.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从1开始；省略默认1，显式null或小于1时报错",
+          "minimum": 1,
+          "default": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数，省略默认10，显式null或小于1时报错",
+          "minimum": 1,
+          "default": 10
+        },
+        "atwTaskIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时系统任务ID列表",
+          "description": "工时系统任务ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "atwProjectIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时系统项目ID列表",
+          "description": "工时系统项目ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "projectIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "项目ID列表",
+          "description": "项目ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "name": {
+          "type": "string",
+          "title": "工时系统任务名称",
+          "description": "工时系统任务名称；包含匹配，空白不筛选"
+        }
+      }
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "format": "int64",
+          "description": "符合筛选条件的总条数；越界空页仍返回真实总数"
+        },
+        "result": {
+          "type": "array",
+          "description": "当前页数据",
+          "items": {
+            "type": "object",
+            "properties": {
+              "atwTaskId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统任务ID",
+                "description": "工时系统任务ID"
+              },
+              "atwProjectId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统项目ID",
+                "description": "工时系统项目ID"
+              },
+              "projectId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "项目ID",
+                "description": "项目ID"
+              },
+              "name": {
+                "type": "string",
+                "title": "工时系统任务名称",
+                "description": "工时系统任务名称"
+              },
+              "level": {
+                "type": "integer",
+                "format": "int32",
+                "title": "工时系统任务层级",
+                "description": "工时系统任务层级，1=根节点，大于1为子任务层级"
+              },
+              "parentAtwTaskId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统父任务ID",
+                "description": "工时系统父任务ID；根节点以工时系统同步值为准"
+              }
+            }
+          }
+        },
+        "page": {
+          "type": "integer",
+          "format": "int32",
+          "description": "当前页码"
+        },
+        "size": {
+          "type": "integer",
+          "format": "int32",
+          "description": "请求的每页条数"
+        }
+      }
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso"
+    ]
+  },
+  {
+    "name": "atw-timesheet-page",
+    "displayName": "查询工时系统工时明细（分页）",
+    "description": "分页查询工时系统工时明细，对应 t_atw_timesheet 单表数据。",
+    "group": "项目分析",
+    "method": "POST",
+    "path": "/sino-opti-hive/atw/query/pageTimesheets",
+    "timeout": 180000,
+    "tag": "项目分析",
+    "domain": "project-analysis",
+    "shortcut": "+atw-timesheets",
+    "risk": "read",
+    "summary": "查询工时系统工时明细（分页）",
+    "docFile": "project-analysis.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "pageNum": {
+          "type": "integer",
+          "format": "int32",
+          "title": "页码",
+          "description": "页码，从1开始；省略默认1，显式null或小于1时报错",
+          "minimum": 1,
+          "default": 1
+        },
+        "pageSize": {
+          "type": "integer",
+          "format": "int32",
+          "title": "每页条数",
+          "description": "每页条数，省略默认10，显式null或小于1时报错",
+          "minimum": 1,
+          "default": 10
+        },
+        "atwTimesheetIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时ID列表",
+          "description": "工时ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "atwProjectIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时系统项目ID列表",
+          "description": "工时系统项目ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "atwProjectName": {
+          "type": "string",
+          "title": "工时系统项目名称",
+          "description": "工时系统项目名称；包含匹配，空白不筛选"
+        },
+        "atwTaskIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时系统任务ID列表",
+          "description": "工时系统任务ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "atwTaskName": {
+          "type": "string",
+          "title": "工时系统任务名称",
+          "description": "工时系统任务名称；包含匹配，空白不筛选"
+        },
+        "atwParentTaskIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "工时系统父任务ID列表",
+          "description": "工时系统父任务ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "atwParentTaskName": {
+          "type": "string",
+          "title": "工时系统父任务名称",
+          "description": "工时系统父任务名称；包含匹配，空白不筛选"
+        },
+        "projectIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "title": "项目ID列表",
+          "description": "项目ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "kindCode": {
+          "type": "string",
+          "title": "服务产品编码",
+          "description": "服务产品编码，来自工时系统字典；已知示例：1=广告优化运营（代投）、85=广告诊断顾问、-888=售前咨询，非固定枚举；精确匹配，不传不筛选"
+        },
+        "kindName": {
+          "type": "string",
+          "title": "服务产品名称",
+          "description": "服务产品名称，来自工时系统字典；包含匹配，空白不筛选"
+        },
+        "userIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "title": "用户ID列表",
+          "description": "用户ID列表，IN 查询；不传或空列表不筛选"
+        },
+        "channelName": {
+          "type": "string",
+          "title": "媒体渠道名称",
+          "description": "媒体渠道名称，映射表中 channel 列；例如 Facebook、Google，来自工时系统渠道字典；精确匹配，不传不筛选"
+        },
+        "roleType": {
+          "type": "string",
+          "title": "角色名称",
+          "description": "角色名称，已有映射：PM、主优化师、其他优化师、优化组长、其他成员；传名称，不传角色数字ID；精确匹配，不传不筛选"
+        },
+        "entryDate": {
+          "type": "string",
+          "title": "工时填写归属日",
+          "description": "工时填写归属日，格式 yyyy-MM-dd；精确匹配，不传不筛选",
+          "format": "date",
+          "example": "2026-09-22"
+        },
+        "year": {
+          "type": "integer",
+          "format": "int32",
+          "title": "工时填写归属年",
+          "description": "工时填写归属年，格式 yyyy，例如 2026；精确匹配，不传不筛选",
+          "example": 2026
+        },
+        "month": {
+          "type": "integer",
+          "format": "int32",
+          "title": "工时填写归属月",
+          "description": "工时填写归属月，格式 yyyyMM，例如 202609；精确匹配，不传不筛选",
+          "example": 202609
+        },
+        "week": {
+          "type": "integer",
+          "format": "int32",
+          "title": "工时填写归属周",
+          "description": "工时填写归属周，格式 YYYYww（ISO周所属年份+两位周数，01–53），例如 202639=2026年第39周；周一开始，跨年时周所属年份可能与日历年份不同；精确匹配，不传不筛选",
+          "example": 202639
+        },
+        "hour": {
+          "type": "number",
+          "title": "填写工时",
+          "description": "填写工时，单位小时，支持小数；精确匹配，不传不筛选"
+        },
+        "timeCode": {
+          "type": "string",
+          "title": "工时类型编码",
+          "description": "工时类型编码，来自工时系统字典；不是 time_code_type（REGULAR_TIME/LEAVE_TIME/OVER_TIME）；精确匹配，不传不筛选"
+        },
+        "timeCodeName": {
+          "type": "string",
+          "title": "工时类型名称",
+          "description": "工时类型名称，来自工时系统字典，与 timeCode 对应；包含匹配，空白不筛选"
+        },
+        "activity": {
+          "type": "string",
+          "title": "审批状态：UNCOMMITTED=已保存",
+          "description": "审批状态：UNCOMMITTED=已保存，APPROVING=待审批，REJECTED=未通过，APPROVED=已批准；精确匹配，不传不筛选",
+          "enum": [
+            "UNCOMMITTED",
+            "APPROVING",
+            "REJECTED",
+            "APPROVED"
+          ]
+        },
+        "submitDateStart": {
+          "type": "string",
+          "title": "工时提交时间区间开始（含）",
+          "description": "工时提交时间区间开始（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+          "example": "2026-09-22 10:00:00"
+        },
+        "submitDateEnd": {
+          "type": "string",
+          "title": "工时提交时间区间结束（含）",
+          "description": "工时提交时间区间结束（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+          "example": "2026-09-22 10:00:00"
+        },
+        "approvedDateStart": {
+          "type": "string",
+          "title": "工时审批时间区间开始（含）",
+          "description": "工时审批时间区间开始（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+          "example": "2026-09-22 10:00:00"
+        },
+        "approvedDateEnd": {
+          "type": "string",
+          "title": "工时审批时间区间结束（含）",
+          "description": "工时审批时间区间结束（含），可单独传入，格式 yyyy-MM-dd HH:mm:ss",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+          "example": "2026-09-22 10:00:00"
+        }
+      }
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "format": "int64",
+          "description": "符合筛选条件的总条数；越界空页仍返回真实总数"
+        },
+        "result": {
+          "type": "array",
+          "description": "当前页数据",
+          "items": {
+            "type": "object",
+            "properties": {
+              "atwTimesheetId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时ID",
+                "description": "工时ID"
+              },
+              "atwProjectId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统项目ID",
+                "description": "工时系统项目ID"
+              },
+              "atwProjectName": {
+                "type": "string",
+                "title": "工时系统项目名称",
+                "description": "工时系统项目名称"
+              },
+              "atwTaskId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统任务ID",
+                "description": "工时系统任务ID"
+              },
+              "atwTaskName": {
+                "type": "string",
+                "title": "工时系统任务名称",
+                "description": "工时系统任务名称"
+              },
+              "atwParentTaskId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "工时系统父任务ID",
+                "description": "工时系统父任务ID"
+              },
+              "atwParentTaskName": {
+                "type": "string",
+                "title": "工时系统父任务名称",
+                "description": "工时系统父任务名称"
+              },
+              "projectId": {
+                "type": "integer",
+                "format": "int64",
+                "title": "项目ID",
+                "description": "项目ID"
+              },
+              "kindCode": {
+                "type": "string",
+                "title": "服务产品编码",
+                "description": "服务产品编码，来自工时系统字典；已知示例：1=广告优化运营（代投）、85=广告诊断顾问、-888=售前咨询，非固定枚举"
+              },
+              "kindName": {
+                "type": "string",
+                "title": "服务产品名称",
+                "description": "服务产品名称，来自工时系统字典"
+              },
+              "userId": {
+                "type": "integer",
+                "format": "int32",
+                "title": "用户ID",
+                "description": "用户ID"
+              },
+              "channelName": {
+                "type": "string",
+                "title": "媒体渠道名称",
+                "description": "媒体渠道名称，映射表中 channel 列；例如 Facebook、Google，来自工时系统渠道字典"
+              },
+              "roleType": {
+                "type": "string",
+                "title": "角色名称",
+                "description": "角色名称，已有映射：PM、主优化师、其他优化师、优化组长、其他成员；传名称，不传角色数字ID"
+              },
+              "entryDate": {
+                "type": "string",
+                "title": "工时填写归属日",
+                "description": "工时填写归属日，格式 yyyy-MM-dd",
+                "format": "date",
+                "example": "2026-09-22"
+              },
+              "year": {
+                "type": "integer",
+                "format": "int32",
+                "title": "工时填写归属年",
+                "description": "工时填写归属年，格式 yyyy，例如 2026",
+                "example": 2026
+              },
+              "month": {
+                "type": "integer",
+                "format": "int32",
+                "title": "工时填写归属月",
+                "description": "工时填写归属月，格式 yyyyMM，例如 202609",
+                "example": 202609
+              },
+              "week": {
+                "type": "integer",
+                "format": "int32",
+                "title": "工时填写归属周",
+                "description": "工时填写归属周，格式 YYYYww（ISO周所属年份+两位周数，01–53），例如 202639=2026年第39周；周一开始，跨年时周所属年份可能与日历年份不同",
+                "example": 202639
+              },
+              "hour": {
+                "type": "number",
+                "title": "填写工时",
+                "description": "填写工时，单位小时，支持小数"
+              },
+              "timeCode": {
+                "type": "string",
+                "title": "工时类型编码",
+                "description": "工时类型编码，来自工时系统字典；不是 time_code_type（REGULAR_TIME/LEAVE_TIME/OVER_TIME）"
+              },
+              "timeCodeName": {
+                "type": "string",
+                "title": "工时类型名称",
+                "description": "工时类型名称，来自工时系统字典，与 timeCode 对应"
+              },
+              "activity": {
+                "type": "string",
+                "title": "审批状态：UNCOMMITTED=已保存",
+                "description": "审批状态：UNCOMMITTED=已保存，APPROVING=待审批，REJECTED=未通过，APPROVED=已批准",
+                "enum": [
+                  "UNCOMMITTED",
+                  "APPROVING",
+                  "REJECTED",
+                  "APPROVED"
+                ]
+              },
+              "submitDate": {
+                "type": "string",
+                "title": "工时提交时间",
+                "description": "工时提交时间，格式 yyyy-MM-dd HH:mm:ss",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+                "example": "2026-09-22 10:00:00"
+              },
+              "approvedDate": {
+                "type": "string",
+                "title": "工时审批时间",
+                "description": "工时审批时间，格式 yyyy-MM-dd HH:mm:ss",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
+                "example": "2026-09-22 10:00:00"
+              }
+            }
+          }
+        },
+        "page": {
+          "type": "integer",
+          "format": "int32",
+          "description": "当前页码"
+        },
+        "size": {
+          "type": "integer",
+          "format": "int32",
+          "description": "请求的每页条数"
+        }
+      }
+    },
+    "pagination": {
+      "pageField": "pageNum",
+      "sizeField": "pageSize",
+      "itemsField": "result",
+      "totalField": "total"
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso"
+    ]
+  },
   {
     "name": "biz-line-ai-strategy-save",
     "displayName": "保存业务线AI策略",
@@ -26949,7 +27627,7 @@
   },
   {
     "name": "sso-user-info",
-    "displayName": "查询SSO用户信息",
+    "displayName": "查询SSO用户信息(用户ID)",
     "description": "按用户ID查询SSO用户信息。返回用户ID、用户名称、账户登陆名。查不到返回 result 为 null。",
     "group": "用户信息",
     "method": "POST",
@@ -26959,7 +27637,7 @@
     "domain": "user",
     "shortcut": "+sso-info",
     "risk": "read",
-    "summary": "查询SSO用户信息",
+    "summary": "查询SSO用户信息(用户ID)",
     "docFile": "user.md",
     "requestSchema": {
       "type": "object",
@@ -27006,7 +27684,7 @@
   },
   {
     "name": "sso-user-info-batch",
-    "displayName": "批量查询SSO用户信息",
+    "displayName": "批量查询SSO用户信息(用户ID)",
     "description": "按用户ID集合批量查询SSO用户信息。返回用户ID、用户名称、账户登陆名。入参去重后查询，只返回命中项。",
     "group": "用户信息",
     "method": "POST",
@@ -27016,7 +27694,7 @@
     "domain": "user",
     "shortcut": "+sso-info-batch",
     "risk": "read",
-    "summary": "批量查询SSO用户信息",
+    "summary": "批量查询SSO用户信息(用户ID)",
     "docFile": "user.md",
     "requestSchema": {
       "type": "object",
@@ -27066,6 +27744,103 @@
       "system"
     ]
   },
+  {
+    "name": "sso-user-list",
+    "displayName": "查询SSO用户列表（支持名称模糊）",
+    "description": "查询 SSO 用户列表，userIdList和userName至少传一个。",
+    "group": "用户信息",
+    "method": "POST",
+    "path": "/bc-business-pu/user/querySsoUserList",
+    "timeout": 180000,
+    "tag": "用户信息",
+    "domain": "user",
+    "shortcut": "+sso-list",
+    "risk": "read",
+    "summary": "查询SSO用户列表（支持名称模糊）",
+    "docFile": "user.md",
+    "requestSchema": {
+      "type": "object",
+      "properties": {
+        "userIdList": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "SSO 用户 ID 列表"
+        },
+        "userName": {
+          "type": "string",
+          "description": "名称模糊查询关键字"
+        }
+      },
+      "anyOf": [
+        {
+          "required": [
+            "userIdList"
+          ],
+          "properties": {
+            "userIdList": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "type": "object"
+        },
+        {
+          "required": [
+            "userName"
+          ],
+          "properties": {
+            "userName": {
+              "type": "string",
+              "pattern": "\\S"
+            }
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "responseSchema": {
+      "type": "array",
+      "description": "用户列表，无分页包装",
+      "items": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "integer",
+            "description": "用户 ID",
+            "format": "int32"
+          },
+          "employeeNumber": {
+            "type": "string",
+            "description": "员工编号"
+          },
+          "loginName": {
+            "type": "string",
+            "description": "英文名称"
+          },
+          "userDisplayName": {
+            "type": "string",
+            "description": "用户姓名"
+          },
+          "email": {
+            "type": "string",
+            "description": "邮箱"
+          }
+        }
+      }
+    },
+    "tenant": false,
+    "roleScope": [
+      "sso",
+      "passport",
+      "system"
+    ]
+  },
   {
     "name": "media-channels",
     "displayName": "查询投放渠道列表",