@zzp123/mcp-zentao 1.8.1 → 1.8.3

package/dist/api/zentaoApi.d.ts

@@ -44,6 +44,22 @@ export declare class ZentaoAPI {
     getProjectExecutions(projectId: number): Promise<Execution[]>;
     createPlan(productId: number, plan: CreatePlanRequest): Promise<Plan>;
     getProjects(page?: number, limit?: number): Promise<Project[]>;
+    /**
+     * 修改需求（使用"更新需求（无需评审）"接口）
+     *
+     * 此方法使用自定义接口 POST /stories/:id/update-without-review
+     * 该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误
+     *
+     * 适用场景：
+     * - 系统配置了强制评审，但某些自动化场景不需要评审
+     * - API调用更新需求时无法提供评审人员
+     * - 批量导入或同步需求数据时
+     * - 第三方系统集成时自动更新需求
+     *
+     * @param storyId 需求ID
+     * @param update 需要更新的字段
+     * @returns 更新后的需求信息
+     */
     changeStory(storyId: number, update: ChangeStoryRequest): Promise<Story>;
     deleteTask(taskId: number): Promise<{
         message: string;

package/dist/api/zentaoApi.js

@@ -606,22 +606,33 @@ export class ZentaoAPI {
             throw error;
         }
     }
+    /**
+     * 修改需求（使用"更新需求（无需评审）"接口）
+     *
+     * 此方法使用自定义接口 POST /stories/:id/update-without-review
+     * 该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误
+     *
+     * 适用场景：
+     * - 系统配置了强制评审，但某些自动化场景不需要评审
+     * - API调用更新需求时无法提供评审人员
+     * - 批量导入或同步需求数据时
+     * - 第三方系统集成时自动更新需求
+     *
+     * @param storyId 需求ID
+     * @param update 需要更新的字段
+     * @returns 更新后的需求信息
+     */
     async changeStory(storyId, update) {
         try {
-            console.log(`正在变更需求 ${storyId}...`);
-            // 自动处理评审人问题
-            const updateData = { ...update };
-            // 如果用户没有设置评审人，也没有指定无需评审，则自动跳过评审
-            if (!updateData.reviewer && updateData.needNotReview !== true) {
-                updateData.needNotReview = true;
-                console.log('自动设置needNotReview=true以跳过评审要求');
-            }
-            const response = await this.request('PUT', `/stories/${storyId}`, undefined, updateData);
-            console.log('变更需求响应:', response);
+            console.log(`正在更新需求 ${storyId} (使用无需评审接口)...`);
+            // 使用 POST /stories/:id/update-without-review 接口
+            // 该接口会自动将当前用户设置为评审人员，绕过评审验证
+            const response = await this.request('POST', `/stories/${storyId}/update-without-review`, undefined, update);
+            console.log('更新需求响应:', response);
             return response;
         }
         catch (error) {
-            console.error('变更需求失败:', error);
+            console.error('更新需求失败:', error);
             throw error;
         }
     }

package/dist/index.js

@@ -581,7 +581,19 @@ server.tool("changeStory", {
             comment: z.string().optional()
         }),
         z.string()
-    ]).describe("需求变更字段 - 支持对象或JSON字符串格式")
+    ]).describe(`更新需求（无需评审）
+
+此工具使用自定义接口 POST /stories/:id/update-without-review
+该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误。
+
+适用场景：
+- 系统配置了强制评审，但某些自动化场景不需要评审
+- API调用更新需求时无法提供评审人员
+- 批量导入或同步需求数据时
+- 第三方系统集成时自动更新需求
+
+支持对象或JSON字符串格式。
+        `.trim())
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.8.1",
+    "version": "1.8.3",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",