@zzp123/mcp-zentao 1.4.0 → 1.4.2

package/README.md

@@ -1,13 +1,32 @@
 # MCP-Zentao
 
+[![npm version](https://badge.fury.io/js/%40zzp123%2Fmcp-zentao.svg)](https://www.npmjs.com/package/@zzp123/mcp-zentao)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展。
 
-## 安装
+## 📦 安装
 
 ```bash
-npm install @bigtian/mcp-zentao -g
+npm install @zzp123/mcp-zentao -g
 ```
 
+## 📋 版本历史
+
+查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
+
+**最新版本**: v1.4.2
+- 创建完整的版本更新历史文档（CHANGELOG.md）
+- 更新所有文档和示例代码
+- 修正包名和API签名
+
+**主要版本**:
+- v1.4.1 - 修复 uploadImageFromClipboard 返回值问题
+- v1.4.0 - 新增解决Bug接口
+- v1.3.1 - 修复剪贴板图片上传核心问题
+- v1.3.0 - 添加命令行脚本支持
+- v1.2.0 - 添加文件上传/下载功能
+
 ## 使用方法
 
 ### 首次使用（配置禅道信息）
@@ -158,7 +177,7 @@ docker run -d \
 ## 基本使用
 
 ```typescript
-import { ZentaoAPI } from '@bigtian/mcp-zentao';
+import { ZentaoAPI } from '@zzp123/mcp-zentao';
 
 // 创建API实例
 const api = new ZentaoAPI({
@@ -198,19 +217,34 @@ async function finishTask(taskId: number) {
     }
 }
 
-// 解决Bug
+// 解决Bug (v1.4.0+)
 async function resolveBug(bugId: number) {
     try {
-        await api.resolveBug(bugId, {
+        const result = await api.resolveBug(bugId, {
             resolution: 'fixed',
             resolvedBuild: 'trunk',
+            assignedTo: 'admin',
             comment: '问题已修复'
         });
-        console.log('Bug已解决');
+        console.log('Bug已解决:', result);
     } catch (error) {
         console.error('解决Bug失败:', error);
     }
 }
+
+// 上传剪贴板图片 (v1.3.1+)
+async function uploadClipboardImage() {
+    try {
+        // 注意：需要先复制图片到系统剪贴板
+        const result = await api.uploadFile({
+            filename: 'screenshot.png',
+            uid: 'optional-uid'
+        });
+        console.log('图片已上传:', result);
+    } catch (error) {
+        console.error('上传失败:', error);
+    }
+}
 ```
 
 ## API文档
@@ -243,12 +277,22 @@ constructor(config: {
    - 参数: taskId - 任务ID
    - 返回: Promise<void>
 
-4. `resolveBug(bugId: number, resolution: BugResolution): Promise<void>`
+4. `resolveBug(bugId: number, resolution: ResolveBugRequest): Promise<Bug>` (v1.4.0+)
    - 解决指定ID的Bug
-   - 参数: 
+   - 参数:
      - bugId - Bug ID
      - resolution - Bug解决方案
-   - 返回: Promise<void>
+   - 返回: Promise<Bug> - 返回更新后的Bug对象
+
+5. `uploadFile(request: UploadFileRequest): Promise<FileUploadResponse>` (v1.2.0+)
+   - 上传文件到禅道
+   - 参数: UploadFileRequest - 文件上传请求
+   - 返回: Promise<FileUploadResponse> - 包含文件ID和访问URL
+
+6. `downloadFile(fileId: number): Promise<Buffer>` (v1.2.0+)
+   - 从禅道下载文件
+   - 参数: fileId - 文件ID
+   - 返回: Promise<Buffer> - 文件的二进制数据
 
 ### 类型定义
 
@@ -258,6 +302,8 @@ interface Task {
     name: string;
     status: string;
     pri: number;
+    assignedTo: string;
+    deadline: string;
     // ... 其他任务属性
 }
 
@@ -266,14 +312,32 @@ interface Bug {
     title: string;
     status: string;
     severity: number;
+    resolvedBy: string;
+    resolution: string;
     // ... 其他Bug属性
 }
 
-interface BugResolution {
-    resolution: string;      // 解决方案类型
-    resolvedBuild?: string; // 解决版本
-    duplicateBug?: number;  // 重复Bug ID
-    comment?: string;       // 备注
+// v1.4.0+
+type ResolutionType = 'fixed' | 'bydesign' | 'duplicate' | 'external' | 'notrepro' | 'postponed' | 'willnotfix';
+
+interface ResolveBugRequest {
+    resolution: ResolutionType;  // 解决方案（必填）
+    resolvedBuild?: string;      // 解决版本（resolution='fixed'时必填）
+    assignedTo?: string;         // 指派给
+    comment?: string;            // 备注
+    duplicateBug?: number;       // 重复Bug的ID（resolution='duplicate'时必填）
+}
+
+// v1.2.0+
+interface UploadFileRequest {
+    file: Buffer;           // 文件数据
+    filename: string;       // 文件名
+    uid?: string;          // 唯一标识符（可选）
+}
+
+interface FileUploadResponse {
+    id: number;     // 文件ID
+    url: string;    // 文件访问URL
 }
 ```
 

package/dist/index.js

@@ -999,18 +999,26 @@ server.tool("uploadImageFromClipboard", {
     filename: z.string().optional(),
     uid: z.string().optional()
 }, async ({ filename, uid }) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
+    if (!zentaoApi) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "请先初始化禅道API配置" }, null, 2)
+                }],
+            isError: true
+        };
+    }
     const fs = await import('fs');
     const path = await import('path');
     const { execSync } = await import('child_process');
     try {
+        console.log('[uploadImageFromClipboard] 开始执行...');
         // 读取系统剪贴板图片
-        let base64Data;
         let fileBuffer;
         let finalFilename;
         // 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()
@@ -1028,64 +1036,118 @@ server.tool("uploadImageFromClipboard", {
                 stdio: ['pipe', 'pipe', 'pipe']
             }).trim();
             if (!result || result.includes('NoImage') || result.includes('Error')) {
-                throw new Error('剪贴板中没有图片。请先复制图片，不要粘贴到输入框，直接告诉我"上传"。');
+                console.error('[uploadImageFromClipboard] 剪贴板中没有图片');
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "剪贴板中没有图片",
+                                tip: "请先复制图片，不要粘贴到输入框，直接告诉我'上传'"
+                            }, null, 2)
+                        }],
+                    isError: true
+                };
             }
-            base64Data = result;
-            fileBuffer = Buffer.from(base64Data, 'base64');
+            fileBuffer = Buffer.from(result, 'base64');
             finalFilename = filename || `clipboard_${Date.now()}.png`;
+            console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
         }
         // macOS: 使用 pngpaste
         else if (process.platform === 'darwin') {
+            console.log('[uploadImageFromClipboard] macOS平台，使用pngpaste读取剪贴板...');
             const tempFile = path.join(process.cwd(), '.temp_clipboard.png');
             try {
                 execSync(`pngpaste "${tempFile}"`);
                 fileBuffer = fs.readFileSync(tempFile);
                 fs.unlinkSync(tempFile);
                 finalFilename = filename || `clipboard_${Date.now()}.png`;
+                console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
             }
-            catch {
-                throw new Error('剪贴板中没有图片。请先安装 pngpaste: brew install pngpaste');
+            catch (err) {
+                console.error('[uploadImageFromClipboard] macOS读取剪贴板失败:', err);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "剪贴板中没有图片或pngpaste未安装",
+                                tip: "请先安装 pngpaste: brew install pngpaste"
+                            }, null, 2)
+                        }],
+                    isError: true
+                };
             }
         }
         // Linux: 使用 xclip
         else {
+            console.log('[uploadImageFromClipboard] Linux平台，使用xclip读取剪贴板...');
             try {
                 const buffer = execSync('xclip -selection clipboard -t image/png -o', {
                     maxBuffer: 10 * 1024 * 1024
                 });
                 fileBuffer = buffer;
                 finalFilename = filename || `clipboard_${Date.now()}.png`;
+                console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
             }
-            catch {
-                throw new Error('剪贴板中没有图片。请先安装 xclip: sudo apt-get install xclip');
+            catch (err) {
+                console.error('[uploadImageFromClipboard] Linux读取剪贴板失败:', err);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "剪贴板中没有图片或xclip未安装",
+                                tip: "请先安装 xclip: sudo apt-get install xclip"
+                            }, null, 2)
+                        }],
+                    isError: true
+                };
             }
         }
         // 创建 img 文件夹
         const imgDir = path.join(process.cwd(), 'img');
         if (!fs.existsSync(imgDir)) {
+            console.log(`[uploadImageFromClipboard] 创建目录: ${imgDir}`);
             fs.mkdirSync(imgDir, { recursive: true });
         }
         // 保存到 img 文件夹
         const savedPath = path.join(imgDir, finalFilename);
         fs.writeFileSync(savedPath, fileBuffer);
+        console.log(`[uploadImageFromClipboard] 图片已保存到: ${savedPath}`);
         // 上传到禅道
-        const result = await zentaoApi.uploadFile({
+        console.log('[uploadImageFromClipboard] 开始上传到禅道...');
+        const uploadResult = await zentaoApi.uploadFile({
             file: fileBuffer,
             filename: finalFilename,
             uid
         });
+        console.log('[uploadImageFromClipboard] 上传成功，结果:', uploadResult);
         const response = {
-            upload: result,
+            success: true,
+            upload: uploadResult,
             savedPath: savedPath,
+            filename: finalFilename,
+            fileSize: fileBuffer.length,
             message: `图片已保存到本地并上传到禅道`
         };
-        return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+        console.log('[uploadImageFromClipboard] 返回结果:', response);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(response, null, 2)
+                }]
+        };
     }
     catch (error) {
+        console.error('[uploadImageFromClipboard] 发生错误:', error);
+        const errorResponse = {
+            success: false,
+            error: error.message || String(error),
+            stack: error.stack,
+            tip: "请检查：\n1. 确保已复制图片到剪贴板\n2. 不要粘贴到输入框，直接说'上传剪贴板图片'\n3. 或使用命令行: upload.bat"
+        };
         return {
             content: [{
                     type: "text",
-                    text: `错误: ${error.message}\n\n提示：\n1. 确保已复制图片到剪贴板\n2. 不要粘贴到输入框，直接说"上传剪贴板图片"\n3. 或使用命令行: upload.bat`
+                    text: JSON.stringify(errorResponse, null, 2)
                 }],
             isError: true
         };

package/package.json

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