Merge feature/search_workitem_improve: 增强工作项搜索功能

* feature/search_workitem_improve:
  feat: 增强工作项搜索功能，支持更多筛选条件

Author: 延枚

operations/projex/types.ts

@@ -299,6 +299,16 @@ export const SearchWorkitemsSchema = z.object({
   updatedBefore: z.string().nullable().optional().describe("Updated not later than, format: YYYY-MM-DD"),
   creator: z.string().nullable().optional().describe("Creator user ID, multiple values separated by commas. Special value 'self' can be used to represent the current user"),
   assignedTo: z.string().nullable().optional().describe("Assignee user ID, multiple values separated by commas. Special value 'self' can be used to represent the current user"),
+  sprint: z.string().nullable().optional().describe("Sprint ID, multiple values separated by commas"),
+  workitemType: z.string().nullable().optional().describe("Work item type ID, multiple values separated by commas"),
+  statusStage: z.string().nullable().optional().describe("Status stage ID, multiple values separated by commas"),
+  tag: z.string().nullable().optional().describe("Tag ID, multiple values separated by commas"),
+  priority: z.string().nullable().optional().describe("Priority ID, multiple values separated by commas"),
+  subjectDescription: z.string().nullable().optional().describe("Text contained in title or description"),
+  finishTimeAfter: z.string().nullable().optional().describe("Finish time not earlier than, format: YYYY-MM-DD"),
+  finishTimeBefore: z.string().nullable().optional().describe("Finish time not later than, format: YYYY-MM-DD"),
+  updateStatusAtAfter: z.string().nullable().optional().describe("Status update time not earlier than, format: YYYY-MM-DD"),
+  updateStatusAtBefore: z.string().nullable().optional().describe("Status update time not later than, format: YYYY-MM-DD"),
 
   // Advanced parameters
   advancedConditions: z.string().nullable().optional().describe("Advanced filter conditions, JSON format"),

operations/projex/workitem.ts

@@ -39,6 +39,16 @@ export async function searchWorkitemsFunc(
   updatedBefore?: string,
   creator?: string,
   assignedTo?: string,
+  sprint?: string,
+  workitemType?: string,
+  statusStage?: string,
+  tag?: string,
+  priority?: string,
+  subjectDescription?: string,
+  finishTimeAfter?: string,
+  finishTimeBefore?: string,
+  updateStatusAtAfter?: string,
+  updateStatusAtBefore?: string,
   advancedConditions?: string,
   orderBy: string = "gmtCreate",
   includeDetails: boolean = false // 新增参数：是否自动补充缺失的description等详细信息
@@ -83,6 +93,16 @@ export async function searchWorkitemsFunc(
     updatedBefore,
     creator: finalCreator,
     assignedTo: finalAssignedTo,
+    sprint,
+    workitemType,
+    statusStage,
+    tag,
+    priority,
+    subjectDescription,
+    finishTimeAfter,
+    finishTimeBefore,
+    updateStatusAtAfter,
+    updateStatusAtBefore,
     advancedConditions
   });
 
@@ -198,6 +218,16 @@ function buildWorkitemConditions(args: {
   updatedBefore?: string;
   creator?: string;
   assignedTo?: string;
+  sprint?: string;
+  workitemType?: string;
+  statusStage?: string;
+  tag?: string;
+  priority?: string;
+  subjectDescription?: string;
+  finishTimeAfter?: string;
+  finishTimeBefore?: string;
+  updateStatusAtAfter?: string;
+  updateStatusAtBefore?: string;
   advancedConditions?: string;
 }): string | undefined {
 
@@ -286,6 +316,113 @@ function buildWorkitemConditions(args: {
     });
   }
 
+  if (args.sprint) {
+    const sprintValues = args.sprint.split(",");
+    const values = sprintValues.map(v => v.trim());
+
+    filterConditions.push({
+      className: "sprint",
+      fieldIdentifier: "sprint",
+      format: "list",
+      operator: "CONTAINS",
+      toValue: null,
+      value: values,
+    });
+  }
+
+  if (args.workitemType) {
+    const workitemTypeValues = args.workitemType.split(",");
+    const values = workitemTypeValues.map(v => v.trim());
+
+    filterConditions.push({
+      className: "workitemType",
+      fieldIdentifier: "workitemType",
+      format: "list",
+      operator: "CONTAINS",
+      toValue: null,
+      value: values,
+    });
+  }
+
+  if (args.statusStage) {
+    const statusStageValues = args.statusStage.split(",");
+    const values = statusStageValues.map(v => v.trim());
+
+    filterConditions.push({
+      className: "statusStage",
+      fieldIdentifier: "statusStage",
+      format: "list",
+      operator: "CONTAINS",
+      toValue: null,
+      value: values,
+    });
+  }
+
+  if (args.tag) {
+    const tagValues = args.tag.split(",");
+    const values = tagValues.map(v => v.trim());
+
+    filterConditions.push({
+      className: "tag",
+      fieldIdentifier: "tag",
+      format: "multiList",
+      operator: "CONTAINS",
+      toValue: null,
+      value: values,
+    });
+  }
+
+  if (args.priority) {
+    const priorityValues = args.priority.split(",");
+    const values = priorityValues.map(v => v.trim());
+
+    filterConditions.push({
+      className: "option",
+      fieldIdentifier: "priority",
+      format: "list",
+      operator: "CONTAINS",
+      toValue: null,
+      value: values,
+    });
+  }
+
+  if (args.subjectDescription) {
+    filterConditions.push({
+      className: "string",
+      fieldIdentifier: "subject-description",
+      format: "input",
+      operator: "CONTAINS",
+      toValue: null,
+      value: [args.subjectDescription],
+    });
+  }
+
+  if (args.finishTimeAfter) {
+    const finishTimeBefore = args.finishTimeBefore ? `${args.finishTimeBefore} 23:59:59` : null;
+
+    filterConditions.push({
+      className: "date",
+      fieldIdentifier: "finishTime",
+      format: "input",
+      operator: "BETWEEN",
+      toValue: finishTimeBefore,
+      value: [`${args.finishTimeAfter} 00:00:00`],
+    });
+  }
+
+  if (args.updateStatusAtAfter) {
+    const updateStatusAtBefore = args.updateStatusAtBefore ? `${args.updateStatusAtBefore} 23:59:59` : null;
+
+    filterConditions.push({
+      className: "date",
+      fieldIdentifier: "updateStatusAt",
+      format: "input",
+      operator: "BETWEEN",
+      toValue: updateStatusAtBefore,
+      value: [`${args.updateStatusAtAfter} 00:00:00`],
+    });
+  }
+
   if (filterConditions.length === 0) {
     return undefined;
   }

tool-handlers/project-management.ts

@@ -139,6 +139,16 @@ export const handleProjectManagementTools = async (request: any) => {
         args.updatedBefore ?? undefined,
         args.creator ?? undefined,
         args.assignedTo ?? undefined,
+        args.sprint ?? undefined,
+        args.workitemType ?? undefined,
+        args.statusStage ?? undefined,
+        args.tag ?? undefined,
+        args.priority ?? undefined,
+        args.subjectDescription ?? undefined,
+        args.finishTimeAfter ?? undefined,
+        args.finishTimeBefore ?? undefined,
+        args.updateStatusAtAfter ?? undefined,
+        args.updateStatusAtBefore ?? undefined,
         args.advancedConditions ?? undefined,
         args.orderBy ?? "gmtCreate",
         args.includeDetails ?? false