@zzp123/mcp-zentao 1.4.3 → 1.5.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.5.0] - 2025-11-05
+
+### Added
+- **模块数据简化功能** - 新增 `SimpleModule` 接口，简化模块API返回数据
+  - `getModules` 接口现在只返回核心字段：id、name、parent、grade、children
+  - 移除冗余的字段（type、path、order等），大幅减少数据传输量
+  - 保持树形结构，递归简化所有子模块数据
+
+### Changed
+- 优化 `getModules()` 方法，返回类型从 `Module[]` 改为 `SimpleModule[]`
+- 添加 `simplifyModule()` 私有方法，用于递归转换模块数据结构
+
+### Benefits
+- 减少网络传输数据量，提升API响应速度
+- 简化客户端数据处理逻辑
+- 更清晰的数据结构，只包含必要信息
+
 ## [1.4.3] - 2025-11-05
 
 ### Fixed

package/README.md

@@ -15,10 +15,10 @@ npm install @zzp123/mcp-zentao -g
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
 
-**最新版本**: v1.4.3
-- 将 CHANGELOG.md 添加到 npm 包中，用户可直接查看版本历史
-- 完整的文档更新和示例代码修正
-- 修正包名和API签名
+**最新版本**: v1.5.0
+- 模块数据简化功能 - getModules接口现在只返回核心字段
+- 大幅减少数据传输量，提升API响应速度
+- 新增 SimpleModule 接口，优化数据结构
 
 **主要版本**:
 - v1.4.1 - 修复 uploadImageFromClipboard 返回值问题

package/dist/api/zentaoApi.d.ts

@@ -1,4 +1,4 @@
-import { AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, Module, ModuleType, Plan, Product, Program, Project, Release, ResolveBugRequest, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, UpdateStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
+import { AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, ModuleType, Plan, Product, Program, Project, Release, ResolveBugRequest, SimpleModule, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, UpdateStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
 export declare class ZentaoAPI {
     private config;
     private client;
@@ -148,7 +148,14 @@ export declare class ZentaoAPI {
     deleteTicket(ticketId: number): Promise<{
         message: string;
     }>;
-    getModules(type: ModuleType, id: number): Promise<Module[]>;
+    /**
+     * 将完整的Module对象转换为简化的SimpleModule对象
+     */
+    private simplifyModule;
+    /**
+     * 获取模块列表（返回简化数据）
+     */
+    getModules(type: ModuleType, id: number): Promise<SimpleModule[]>;
     uploadFile(uploadRequest: UploadFileRequest): Promise<FileUploadResponse>;
     downloadFile(fileId: number): Promise<Buffer>;
 }

package/dist/api/zentaoApi.js

@@ -1119,13 +1119,35 @@ export class ZentaoAPI {
         }
     }
     // 模块相关API
+    /**
+     * 将完整的Module对象转换为简化的SimpleModule对象
+     */
+    simplifyModule(module) {
+        const simple = {
+            id: module.id,
+            name: module.name,
+            parent: module.parent,
+            grade: module.grade
+        };
+        // 递归处理子模块
+        if (module.children && module.children.length > 0) {
+            simple.children = module.children.map(child => this.simplifyModule(child));
+        }
+        return simple;
+    }
+    /**
+     * 获取模块列表（返回简化数据）
+     */
     async getModules(type, id) {
         try {
             console.log(`正在获取模块列表，类型: ${type}, ID: ${id}...`);
             const params = { type, id };
             const response = await this.request('GET', '/modules', params);
-            console.log('获取模块列表响应:', response);
-            return response.modules;
+            console.log('获取模块列表响应（原始数据）:', response);
+            // 转换为简化格式
+            const simpleModules = response.modules.map(module => this.simplifyModule(module));
+            console.log('获取模块列表响应（简化数据）:', simpleModules);
+            return simpleModules;
         }
         catch (error) {
             console.error('获取模块列表失败:', error);

package/dist/types/zentao.d.ts

@@ -626,8 +626,19 @@ export interface Module {
     owner: string;
     collector?: string;
     short?: string;
+    deleted?: string;
+    from?: number;
+    url?: string;
+    children?: Module[];
 }
 export type ModuleType = 'story' | 'task' | 'bug' | 'case' | 'feedback' | 'product';
+export interface SimpleModule {
+    id: string;
+    name: string;
+    parent: string;
+    grade: string;
+    children?: SimpleModule[];
+}
 export interface FileUploadResponse {
     id: number;
     url: string;

package/package.json

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