@zzp123/mcp-zentao 1.8.9 → 1.10.0

package/CHANGELOG.md

@@ -5,6 +5,49 @@ 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
+- **修复 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

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,19 +125,23 @@ export class ZentaoAPI {
         // 默认每页20条，最多100条
         const finalLimit = limit ? Math.min(limit, 100) : 20;
         const finalPage = page || 1;
-        const params = {
-            status: status || 'all',
-            product: productId,
-            page: finalPage,
-            limit: finalLimit
-        };
-        // 只有当明确指定时才过滤 assignedTo
+        // 构建查询参数
+        const queryParams = new URLSearchParams();
+        // 如果需要只获取分配给我的Bug，使用 assigntome 状态
         if (onlyAssignedToMe) {
-            params.assignedTo = this.config.username;
+            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(`正在获取Bug列表 (page=${finalPage}, limit=${finalLimit})，参数:`, params);
-            const response = await this.request('GET', '/bugs', params);
+            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} 条数据`);
             if (Array.isArray(response)) {
                 // 如果返回的是数组，转换为标准格式
@@ -148,35 +152,40 @@ export class ZentaoAPI {
                     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
-                };
+            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
+                    };
+                }
             }
             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/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.9",
+    "version": "1.10.0",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",