@zzp123/mcp-zentao 1.5.0 → 1.6.1

package/CHANGELOG.md

@@ -5,6 +5,48 @@ 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.6.1] - 2025-11-05
+
+### Fixed
+- **修复 Windows 剪贴板图片读取问题**
+  - 替换为新的 PowerShell 脚本 `scripts/get_clipboard.ps1`
+  - 使用 `Add-Type` 加载 `System.Drawing` 程序集，确保正确处理图片
+  - 改进错误处理，提供更详细的错误信息
+  - 使用 `-ExecutionPolicy Bypass` 确保脚本可以执行
+
+### Changed
+- Windows 平台现在使用外部 PowerShell 脚本文件而非内联脚本
+- 优化了 base64 转换流程，确保内存流正确关闭
+
+## [1.6.0] - 2025-11-05
+
+### Changed - 重大更新
+- **迁移到自定义模块接口** `/custom/modules` - 替代原生 `/modules` 接口
+  - 接口路径：`GET /custom/modules`（原 `/modules`）
+  - 支持字段过滤功能：通过 `fields` 参数指定返回字段
+  - 默认返回精简字段：id、name、parent、grade、type
+  - 可选字段：id、root、branch、name、parent、path、grade、order、type、owner、collector、short
+
+### Added
+- 新增 `fields` 参数支持，可大幅减少返回数据量（60-80%）
+- 新增 `ModulesResponse` 接口：`{ modules: SimpleModule[], total: number }`
+- 更新 `SimpleModule` 接口，支持更多可选字段
+
+### Technical
+- 返回数据结构变化：从嵌套树形结构改为扁平化数组
+- 通过 `parent` 字段关联父子关系，通过 `path` 字段表示层级路径
+- 移除 `simplifyModule()` 递归处理方法（不再需要）
+- 接口响应包含 `total` 字段，返回模块总数
+
+### Benefits
+- **性能提升**：支持按需获取字段，减少60-80%数据传输量
+- **更灵活**：可根据实际需求指定返回字段
+- **更标准**：返回格式包含 total 统计信息
+
+### Breaking Changes
+- `getModules()` 返回类型从 `SimpleModule[]` 改为 `ModulesResponse`
+- `SimpleModule` 不再包含 `children` 字段（数据已扁平化）
+
 ## [1.5.0] - 2025-11-05
 
 ### Added

package/README.md

@@ -15,10 +15,10 @@ npm install @zzp123/mcp-zentao -g
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
 
-**最新版本**: v1.5.0
-- 模块数据简化功能 - getModules接口现在只返回核心字段
-- 大幅减少数据传输量，提升API响应速度
-- 新增 SimpleModule 接口，优化数据结构
+**最新版本**: v1.6.1
+- 修复 Windows 剪贴板图片读取问题
+- 使用新的 PowerShell 脚本确保正确读取剪贴板图片
+- 改进错误处理和日志输出
 
 **主要版本**:
 - 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, 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';
+import { AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, ModulesResponse, 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';
 export declare class ZentaoAPI {
     private config;
     private client;
@@ -149,13 +149,13 @@ export declare class ZentaoAPI {
         message: string;
     }>;
     /**
-     * 将完整的Module对象转换为简化的SimpleModule对象
+     * 获取模块列表（使用自定义接口，支持字段过滤）
+     * @param type 模块类型：story(需求)、bug、case(用例)、task(任务)、feedback(反馈)、product
+     * @param id 对象ID：产品ID或项目ID
+     * @param fields 可选，指定返回的字段，多个字段用逗号分隔。默认返回：id,name,parent,grade,type
+     * @returns Promise<ModulesResponse> 包含模块列表和总数
      */
-    private simplifyModule;
-    /**
-     * 获取模块列表（返回简化数据）
-     */
-    getModules(type: ModuleType, id: number): Promise<SimpleModule[]>;
+    getModules(type: ModuleType, id: number, fields?: string): Promise<ModulesResponse>;
     uploadFile(uploadRequest: UploadFileRequest): Promise<FileUploadResponse>;
     downloadFile(fileId: number): Promise<Buffer>;
 }

package/dist/api/zentaoApi.js

@@ -1120,34 +1120,23 @@ export class ZentaoAPI {
     }
     // 模块相关API
     /**
-     * 将完整的Module对象转换为简化的SimpleModule对象
+     * 获取模块列表（使用自定义接口，支持字段过滤）
+     * @param type 模块类型：story(需求)、bug、case(用例)、task(任务)、feedback(反馈)、product
+     * @param id 对象ID：产品ID或项目ID
+     * @param fields 可选，指定返回的字段，多个字段用逗号分隔。默认返回：id,name,parent,grade,type
+     * @returns Promise<ModulesResponse> 包含模块列表和总数
      */
-    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) {
+    async getModules(type, id, fields) {
         try {
-            console.log(`正在获取模块列表，类型: ${type}, ID: ${id}...`);
+            console.log(`正在获取模块列表，类型: ${type}, ID: ${id}, 字段: ${fields || '默认'}...`);
             const params = { type, id };
-            const response = await this.request('GET', '/modules', params);
-            console.log('获取模块列表响应（原始数据）:', response);
-            // 转换为简化格式
-            const simpleModules = response.modules.map(module => this.simplifyModule(module));
-            console.log('获取模块列表响应（简化数据）:', simpleModules);
-            return simpleModules;
+            if (fields) {
+                params.fields = fields;
+            }
+            // 使用新的自定义接口路径
+            const response = await this.request('GET', '/custom/modules', params);
+            console.log(`获取模块列表成功，共 ${response.total} 个模块`);
+            return response;
         }
         catch (error) {
             console.error('获取模块列表失败:', error);

package/dist/index.js

@@ -926,15 +926,16 @@ server.tool("deleteTicket", { ticketId: z.number() }, async ({ ticketId }) => {
         throw new Error("Please initialize Zentao API first");
     return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.deleteTicket(ticketId), null, 2) }] };
 });
-// 模块相关工具
+// 模块相关工具（使用自定义接口，支持字段过滤）
 server.tool("getModules", {
     type: z.enum(['story', 'task', 'bug', 'case', 'feedback', 'product']),
-    id: z.number()
-}, async ({ type, id }) => {
+    id: z.number(),
+    fields: z.string().optional()
+}, async ({ type, id, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const modules = await zentaoApi.getModules(type, id);
-    return { content: [{ type: "text", text: JSON.stringify(modules, null, 2) }] };
+    const response = await zentaoApi.getModules(type, id, fields);
+    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
 });
 // 文件相关工具
 server.tool("uploadFile", {
@@ -1016,41 +1017,49 @@ server.tool("uploadImageFromClipboard", {
         // 读取系统剪贴板图片
         let fileBuffer;
         let finalFilename;
-        // Windows: 使用 PowerShell 读取剪贴板
+        // Windows: 使用 PowerShell 脚本读取剪贴板
         if (process.platform === 'win32') {
-            console.log('[uploadImageFromClipboard] Windows平台，使用PowerShell读取剪贴板...');
-            const psScript = `
-                Add-Type -AssemblyName System.Windows.Forms
-                $img = [System.Windows.Forms.Clipboard]::GetImage()
-                if ($img -ne $null) {
-                    $ms = New-Object System.IO.MemoryStream
-                    $img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
-                    [Convert]::ToBase64String($ms.ToArray())
-                } else {
-                    Write-Error "NoImage"
+            console.log('[uploadImageFromClipboard] Windows平台，使用PowerShell脚本读取剪贴板...');
+            // 使用外部 PowerShell 脚本
+            const scriptPath = path.join(process.cwd(), 'scripts', 'get_clipboard.ps1');
+            console.log(`[uploadImageFromClipboard] 脚本路径: ${scriptPath}`);
+            try {
+                const result = execSync(`powershell -ExecutionPolicy Bypass -File "${scriptPath}"`, {
+                    encoding: 'utf8',
+                    maxBuffer: 10 * 1024 * 1024,
+                    stdio: ['pipe', 'pipe', 'pipe']
+                }).trim();
+                if (!result || result.includes('NoImage') || result.includes('Error')) {
+                    console.error('[uploadImageFromClipboard] 剪贴板中没有图片');
+                    return {
+                        content: [{
+                                type: "text",
+                                text: JSON.stringify({
+                                    error: "剪贴板中没有图片",
+                                    tip: "请先复制图片，不要粘贴到输入框，直接告诉我'上传'"
+                                }, null, 2)
+                            }],
+                        isError: true
+                    };
                 }
-            `;
-            const result = execSync(`powershell -Command "${psScript.replace(/\n/g, ' ')}"`, {
-                encoding: 'utf8',
-                maxBuffer: 10 * 1024 * 1024,
-                stdio: ['pipe', 'pipe', 'pipe']
-            }).trim();
-            if (!result || result.includes('NoImage') || result.includes('Error')) {
-                console.error('[uploadImageFromClipboard] 剪贴板中没有图片');
+                fileBuffer = Buffer.from(result, 'base64');
+                finalFilename = filename || `clipboard_${Date.now()}.png`;
+                console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
+            }
+            catch (err) {
+                console.error('[uploadImageFromClipboard] Windows读取剪贴板失败:', err);
                 return {
                     content: [{
                             type: "text",
                             text: JSON.stringify({
-                                error: "剪贴板中没有图片",
-                                tip: "请先复制图片，不要粘贴到输入框，直接告诉我'上传'"
+                                error: "读取剪贴板失败",
+                                details: err.message,
+                                tip: "请确保已复制图片到剪贴板，并且 PowerShell 脚本存在于 scripts/get_clipboard.ps1"
                             }, null, 2)
                         }],
                     isError: true
                 };
             }
-            fileBuffer = Buffer.from(result, 'base64');
-            finalFilename = filename || `clipboard_${Date.now()}.png`;
-            console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
         }
         // macOS: 使用 pngpaste
         else if (process.platform === 'darwin') {

package/dist/types/zentao.d.ts

@@ -637,7 +637,18 @@ export interface SimpleModule {
     name: string;
     parent: string;
     grade: string;
-    children?: SimpleModule[];
+    type?: string;
+    path?: string;
+    root?: string;
+    branch?: string;
+    order?: string;
+    owner?: string;
+    collector?: string;
+    short?: string;
+}
+export interface ModulesResponse {
+    modules: SimpleModule[];
+    total: number;
 }
 export interface FileUploadResponse {
     id: number;

package/package.json

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

package/scripts/get_clipboard.ps1

@@ -0,0 +1,13 @@
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+$img = [System.Windows.Forms.Clipboard]::GetImage()
+if ($img) {
+    $ms = New-Object System.IO.MemoryStream
+    $img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
+    $bytes = $ms.ToArray()
+    $ms.Close()
+    $base64 = [Convert]::ToBase64String($bytes)
+    Write-Output $base64
+} else {
+    Write-Error "NoImage"
+}