@zzp123/mcp-zentao 1.8.8 → 1.9.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.0] - 2025-11-06
+
+### Fixed
+- **修复 getMyBugs 工具过滤逻辑问题** 🔧
+  - 禅道API的 `/bugs` 接口不支持 `assignedTo` 参数进行服务端过滤
+  - 改为使用客户端过滤：获取更多数据后在本地筛选分配给当前用户的Bug
+  - 修复了使用 `onlyAssignedToMe=true` 时无法正确获取当前用户Bug的问题
+  - 现在能够正确识别 `assignedTo` 字段（支持对象和字符串两种格式）
+
+### Improved
+- 优化了 `getMyBugs` 的性能：当需要过滤时自动获取100条数据以确保有足够的结果
+- 增加了详细的过滤日志输出，便于调试和追踪
+
+### Changed
+- 扩展了 `Bug` 类型定义，添加了 `assignedTo`、`openedBy`、`resolvedBy` 等字段
+- 更新了文档，说明了禅道API的限制和客户端过滤的实现方式
+
+## [1.8.9] - 2025-11-06
+
+### Fixed
+- **修复 resolveBug 工具必须提供 resolvedBuild 参数的问题**
+  - 当 resolution 为 "fixed" 时，如果未提供 resolvedBuild，自动设置为 "trunk"（主干版本）
+  - 消除了使用 resolveBug 工具时的常见错误："当解决方案为"已解决(fixed)"时，必须提供解决版本(resolvedBuild)"
+  - 简化了解决Bug的操作流程，提升用户体验
+
+### Improved
+- 添加了自动默认值设置的日志输出，便于调试和追踪
+
 ## [1.8.8] - 2025-11-06
 
 ### Fixed

package/dist/api/zentaoApi.js

@@ -125,38 +125,53 @@ export class ZentaoAPI {
         // 默认每页20条，最多100条
         const finalLimit = limit ? Math.min(limit, 100) : 20;
         const finalPage = page || 1;
+        // 禅道API的/bugs接口不支持assignedTo参数过滤，需要客户端过滤
+        // 所以获取更多数据以确保有足够的结果
+        const fetchLimit = onlyAssignedToMe ? 100 : finalLimit;
         const params = {
             status: status || 'all',
             product: productId,
-            page: finalPage,
-            limit: finalLimit
+            page: 1,
+            limit: fetchLimit
         };
-        // 只有当明确指定时才过滤 assignedTo
-        if (onlyAssignedToMe) {
-            params.assignedTo = this.config.username;
-        }
         try {
-            console.log(`正在获取Bug列表 (page=${finalPage}, limit=${finalLimit})，参数:`, params);
+            console.log(`正在获取Bug列表，参数:`, params);
             const response = await this.request('GET', '/bugs', params);
             console.log(`Bug列表响应: 获取到 ${response.bugs?.length || 0} 条数据`);
+            let bugs = [];
             if (Array.isArray(response)) {
-                // 如果返回的是数组，转换为标准格式
-                return {
-                    page: finalPage,
-                    total: response.length,
-                    limit: finalLimit,
-                    bugs: response
-                };
+                bugs = response;
             }
             else if (response && typeof response === 'object' && Array.isArray(response.bugs)) {
-                return {
-                    page: response.page || finalPage,
-                    total: response.total || response.bugs.length,
-                    limit: response.limit || finalLimit,
-                    bugs: response.bugs
-                };
+                bugs = response.bugs;
+            }
+            else {
+                throw new Error(`获取Bug列表失败: 响应格式不正确 ${JSON.stringify(response)}`);
+            }
+            // 如果需要过滤分配给当前用户的bug，在客户端进行过滤
+            if (onlyAssignedToMe) {
+                console.log(`客户端过滤：只保留分配给 ${this.config.username} 的Bug`);
+                bugs = bugs.filter(bug => {
+                    // assignedTo可能是对象或字符串
+                    if (typeof bug.assignedTo === 'object' && bug.assignedTo !== null) {
+                        return bug.assignedTo.account === this.config.username;
+                    }
+                    else if (typeof bug.assignedTo === 'string') {
+                        return bug.assignedTo === this.config.username;
+                    }
+                    return false;
+                });
+                console.log(`过滤后剩余 ${bugs.length} 个Bug`);
             }
-            throw new Error(`获取Bug列表失败: 响应格式不正确 ${JSON.stringify(response)}`);
+            // 应用分页
+            const start = (finalPage - 1) * finalLimit;
+            const paginatedBugs = bugs.slice(start, start + finalLimit);
+            return {
+                page: finalPage,
+                total: bugs.length,
+                limit: finalLimit,
+                bugs: paginatedBugs
+            };
         }
         catch (error) {
             if (error instanceof Error && error.message.includes('Need product id')) {
@@ -249,9 +264,10 @@ export class ZentaoAPI {
     async resolveBug(bugId, resolution) {
         try {
             console.log(`正在解决Bug ${bugId}...`);
-            // 验证必填字段
+            // 验证必填字段并设置默认值
             if (resolution.resolution === 'fixed' && !resolution.resolvedBuild) {
-                throw new Error('当解决方案为"已解决(fixed)"时，必须提供解决版本(resolvedBuild)');
+                console.log('解决方案为"fixed"时未提供resolvedBuild，自动设置为"trunk"');
+                resolution.resolvedBuild = 'trunk';
             }
             if (resolution.resolution === 'duplicate' && !resolution.duplicateBug) {
                 throw new Error('当解决方案为"重复Bug(duplicate)"时，必须提供重复Bug的ID(duplicateBug)');

package/dist/types/zentao.d.ts

@@ -40,6 +40,13 @@ export interface Bug {
     days_open?: number;
     aging_status?: string;
     aging_description?: string;
+    assignedTo?: any;
+    openedBy?: any;
+    resolvedBy?: any;
+    product?: number;
+    module?: number;
+    pri?: number;
+    type?: string;
 }
 export interface TaskUpdate {
     consumed?: number;

package/package.json

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