@zzp123/mcp-zentao 1.9.0 → 1.10.0

package/CHANGELOG.md

@@ -5,6 +5,32 @@ 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.10.0] - 2025-11-07
+
+### Fixed
+- **修复 Bug 获取工具的 API 端点和参数问题** 🔧
+  - 从错误的 `/bugs` 端点改为正确的 `/products/{productId}/bugs` 端点
+  - 移除了低效的客户端过滤逻辑，改用服务器端原生支持的 `assigntome` 状态
+  - 修复了 `onlyAssignedToMe` 参数无法正确工作的问题
+
+### Added
+- **添加排序参数支持** ✨
+  - 为 `getMyBugs` 和 `getProductBugs` 工具添加 `order` 参数
+  - 支持多种排序方式：`id_desc`(ID降序)、`id_asc`(ID升序)、`pri_desc`(优先级降序)等
+  - 默认使用 `id_desc` 排序，确保最新的 Bug 显示在前面
+  - 与禅道官方 API 完全一致的参数格式
+
+### Improved
+- **性能优化**
+  - 使用服务器端过滤替代客户端过滤，显著提升查询效率
+  - 减少不必要的数据传输，降低网络开销
+  - 更准确的分页信息和总数统计
+
+### Changed
+- 更新了 `getMyBugs` 方法签名，添加 `order` 参数
+- 更新了 `getProductBugs` 方法签名，添加 `order` 参数
+- 优化了查询参数的构建方式，使用 URLSearchParams 确保参数正确编码
+
 ## [1.9.0] - 2025-11-06
 
 ### Fixed

package/README.md

@@ -15,17 +15,17 @@ npm install @zzp123/mcp-zentao -g
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
 
-**最新版本**: v1.6.1
-- 修复 Windows 剪贴板图片读取问题
-- 使用新的 PowerShell 脚本确保正确读取剪贴板图片
-- 改进错误处理和日志输出
-
-**主要版本**:
-- v1.4.1 - 修复 uploadImageFromClipboard 返回值问题
+**最新版本**: v1.9.0
+- ✅ 修复 getMyBugs 工具的过滤逻辑问题
+- ✅ 改为客户端过滤，正确获取当前用户的bug
+- ✅ 支持 assignedTo 的对象和字符串两种格式
+
+**近期版本**:
+- v1.8.9 - 修复 resolveBug 工具自动设置默认 resolvedBuild
+- v1.8.8 - 修复 getMyBugs 工具返回Bug数量为0的问题
+- v1.6.1 - 修复 Windows 剪贴板图片读取问题
 - v1.4.0 - 新增解决Bug接口
-- v1.3.1 - 修复剪贴板图片上传核心问题
 - v1.3.0 - 添加命令行脚本支持
-- v1.2.0 - 添加文件上传/下载功能
 
 ## 使用方法
 

package/dist/api/zentaoApi.d.ts

@@ -9,13 +9,13 @@ export declare class ZentaoAPI {
     getMyTasks(status?: TaskStatus): Promise<Task[]>;
     getTaskDetail(taskId: number): Promise<Task>;
     getProducts(): Promise<Product[]>;
-    getMyBugs(status?: BugStatus, productId?: number, page?: number, limit?: number, onlyAssignedToMe?: boolean): Promise<{
+    getMyBugs(status?: BugStatus, productId?: number, page?: number, limit?: number, onlyAssignedToMe?: boolean, order?: string): Promise<{
         page: number;
         total: number;
         limit: number;
         bugs: Bug[];
     }>;
-    getProductBugs(productId: number, page?: number, limit?: number, status?: BugStatus): Promise<{
+    getProductBugs(productId: number, page?: number, limit?: number, status?: BugStatus, order?: string): Promise<{
         page: number;
         total: number;
         limit: number;

package/dist/api/zentaoApi.js

@@ -111,7 +111,7 @@ export class ZentaoAPI {
             throw error;
         }
     }
-    async getMyBugs(status, productId, page, limit, onlyAssignedToMe = false) {
+    async getMyBugs(status, productId, page, limit, onlyAssignedToMe = false, order) {
         if (!productId) {
             // 如果没有提供产品ID，获取第二个可用的产品（索引为1）
             const products = await this.getProducts();
@@ -125,73 +125,67 @@ 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: 1,
-            limit: fetchLimit
-        };
-        try {
-            console.log(`正在获取Bug列表，参数:`, params);
-            const response = await this.request('GET', '/bugs', params);
+        // 构建查询参数
+        const queryParams = new URLSearchParams();
+        // 如果需要只获取分配给我的Bug，使用 assigntome 状态
+        if (onlyAssignedToMe) {
+            queryParams.append('status', 'assigntome');
+        }
+        else if (status && status !== 'all') {
+            queryParams.append('status', status);
+        }
+        queryParams.append('page', finalPage.toString());
+        queryParams.append('limit', finalLimit.toString());
+        // 添加排序参数，默认按ID降序
+        const finalOrder = order || 'id_desc';
+        queryParams.append('order', finalOrder);
+        try {
+            console.log(`正在获取产品 ${productId} 的Bug列表，参数: status=${onlyAssignedToMe ? 'assigntome' : (status || 'all')}, page=${finalPage}, limit=${finalLimit}, order=${finalOrder}`);
+            const response = await this.request('GET', `/products/${productId}/bugs?${queryParams.toString()}`);
             console.log(`Bug列表响应: 获取到 ${response.bugs?.length || 0} 条数据`);
-            let bugs = [];
             if (Array.isArray(response)) {
-                bugs = response;
-            }
-            else if (response && typeof response === 'object' && Array.isArray(response.bugs)) {
-                bugs = response.bugs;
-            }
-            else {
-                throw new Error(`获取Bug列表失败: 响应格式不正确 ${JSON.stringify(response)}`);
+                // 如果返回的是数组，转换为标准格式
+                return {
+                    page: finalPage,
+                    total: response.length,
+                    limit: finalLimit,
+                    bugs: 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`);
+            else if (response && typeof response === 'object') {
+                if (Array.isArray(response.bugs)) {
+                    return {
+                        page: response.page || finalPage,
+                        total: response.total || response.bugs.length,
+                        limit: response.limit || finalLimit,
+                        bugs: response.bugs
+                    };
+                }
             }
-            // 应用分页
-            const start = (finalPage - 1) * finalLimit;
-            const paginatedBugs = bugs.slice(start, start + finalLimit);
-            return {
-                page: finalPage,
-                total: bugs.length,
-                limit: finalLimit,
-                bugs: paginatedBugs
-            };
+            throw new Error(`获取Bug列表失败: 响应格式不正确 ${JSON.stringify(response)}`);
         }
         catch (error) {
-            if (error instanceof Error && error.message.includes('Need product id')) {
-                throw new Error('获取Bug列表失败: 请提供产品ID');
-            }
             console.error('获取Bug列表失败:', error);
             throw error;
         }
     }
-    async getProductBugs(productId, page, limit, status) {
+    async getProductBugs(productId, page, limit, status, order) {
         try {
             // 默认每页20条，最多100条
             const finalLimit = limit ? Math.min(limit, 100) : 20;
             const finalPage = page || 1;
-            console.log(`正在获取产品 ${productId} 的Bug列表 (page=${finalPage}, limit=${finalLimit})...`);
+            const finalOrder = order || 'id_desc';
+            console.log(`正在获取产品 ${productId} 的Bug列表 (page=${finalPage}, limit=${finalLimit}, order=${finalOrder})...`);
             // 构建查询参数
             const queryParams = new URLSearchParams();
             queryParams.append('page', finalPage.toString());
             queryParams.append('limit', finalLimit.toString());
-            if (status && status !== 'all') {
+            queryParams.append('order', finalOrder);
+            // 支持 assigntome 状态
+            if (status === 'assigntome') {
+                queryParams.append('status', 'assigntome');
+            }
+            else if (status && status !== 'all') {
                 queryParams.append('status', status);
             }
             const response = await this.request('GET', `/products/${productId}/bugs?${queryParams.toString()}`);

package/dist/index.js

@@ -92,11 +92,12 @@ server.tool("getMyBugs", "获取Bug列表 - 默认获取所有Bug，可选择只
     productId: z.number().optional(),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
     limit: z.number().optional().describe("每页数量，默认20，最大100"),
-    onlyAssignedToMe: z.boolean().optional().describe("是否只获取分配给我的Bug，默认false（获取所有Bug）")
-}, async ({ status, productId, page, limit, onlyAssignedToMe }) => {
+    onlyAssignedToMe: z.boolean().optional().describe("是否只获取分配给我的Bug，默认false（获取所有Bug）"),
+    order: z.string().optional().describe("排序方式，如 id_desc(ID降序), id_asc(ID升序), pri_desc(优先级降序)等，默认id_desc")
+}, async ({ status, productId, page, limit, onlyAssignedToMe, order }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.getMyBugs(status, productId, page, limit, onlyAssignedToMe || false);
+    const result = await zentaoApi.getMyBugs(status, productId, page, limit, onlyAssignedToMe || false, order);
     // 返回分页信息和数据
     const summary = {
         summary: `当前第 ${result.page} 页，共 ${result.total} 个Bug，本页显示 ${result.bugs.length} 个`,
@@ -117,11 +118,12 @@ server.tool("getProductBugs", {
     productId: z.number(),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
     limit: z.number().optional().describe("每页数量，默认20，最大100"),
-    status: z.enum(['active', 'resolved', 'closed', 'all']).optional()
-}, async ({ productId, page, limit, status }) => {
+    status: z.enum(['active', 'resolved', 'closed', 'all']).optional(),
+    order: z.string().optional().describe("排序方式，如 id_desc(ID降序), id_asc(ID升序), pri_desc(优先级降序)等，默认id_desc")
+}, async ({ productId, page, limit, status, order }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.getProductBugs(productId, page, limit, status);
+    const result = await zentaoApi.getProductBugs(productId, page, limit, status, order);
     // 返回分页信息和数据
     const summary = {
         summary: `当前第 ${result.page} 页，共 ${result.total} 个Bug，本页显示 ${result.bugs.length} 个`,

package/package.json

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