@zzp123/mcp-zentao 1.8.2 → 1.8.3

package/dist/api/zentaoApi.d.ts

@@ -45,10 +45,16 @@ export declare class ZentaoAPI {
     createPlan(productId: number, plan: CreatePlanRequest): Promise<Plan>;
     getProjects(page?: number, limit?: number): Promise<Project[]>;
     /**
-     * 修改需求（使用最新的 PUT /stories/:id 接口）
+     * 修改需求（使用"更新需求（无需评审）"接口）
      *
-     * 注意：此方法使用"修改需求其他字段"接口（PUT），支持修改29个字段
-     * 已废弃：旧的"变更需求"接口（POST /stories/:id/change）仅支持3个字段
+     * 此方法使用自定义接口 POST /stories/:id/update-without-review
+     * 该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误
+     *
+     * 适用场景：
+     * - 系统配置了强制评审，但某些自动化场景不需要评审
+     * - API调用更新需求时无法提供评审人员
+     * - 批量导入或同步需求数据时
+     * - 第三方系统集成时自动更新需求
      *
      * @param storyId 需求ID
      * @param update 需要更新的字段

package/dist/api/zentaoApi.js

@@ -607,10 +607,16 @@ export class ZentaoAPI {
         }
     }
     /**
-     * 修改需求（使用最新的 PUT /stories/:id 接口）
+     * 修改需求（使用"更新需求（无需评审）"接口）
      *
-     * 注意：此方法使用"修改需求其他字段"接口（PUT），支持修改29个字段
-     * 已废弃：旧的"变更需求"接口（POST /stories/:id/change）仅支持3个字段
+     * 此方法使用自定义接口 POST /stories/:id/update-without-review
+     * 该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误
+     *
+     * 适用场景：
+     * - 系统配置了强制评审，但某些自动化场景不需要评审
+     * - API调用更新需求时无法提供评审人员
+     * - 批量导入或同步需求数据时
+     * - 第三方系统集成时自动更新需求
      *
      * @param storyId 需求ID
      * @param update 需要更新的字段
@@ -618,21 +624,15 @@ export class ZentaoAPI {
      */
     async changeStory(storyId, update) {
         try {
-            console.log(`正在修改需求 ${storyId} (使用 PUT 接口)...`);
-            // 自动处理评审人问题
-            const updateData = { ...update };
-            // 如果用户没有设置评审人，也没有指定无需评审，则自动跳过评审
-            if (!updateData.reviewer && updateData.needNotReview !== true) {
-                updateData.needNotReview = true;
-                console.log('自动设置needNotReview=true以跳过评审要求');
-            }
-            // 使用 PUT /stories/:id 接口（功能完整的"修改需求其他字段"接口）
-            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,10 +581,16 @@ server.tool("changeStory", {
             comment: z.string().optional()
         }),
         z.string()
-    ]).describe(`修改需求字段（使用最新 PUT 接口）
+    ]).describe(`更新需求（无需评审）
 
-此工具使用"修改需求其他字段"接口（PUT /stories/:id），支持修改29个字段。
-已废弃旧的"变更需求"接口（POST /stories/:id/change），该接口仅支持3个字段。
+此工具使用自定义接口 POST /stories/:id/update-without-review
+该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误。
+
+适用场景：
+- 系统配置了强制评审，但某些自动化场景不需要评审
+- API调用更新需求时无法提供评审人员
+- 批量导入或同步需求数据时
+- 第三方系统集成时自动更新需求
 
 支持对象或JSON字符串格式。
         `.trim())

package/package.json

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