@zzp123/mcp-zentao 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -5,6 +5,42 @@ 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.7.0] - 2025-11-06
+
+### Added
+- **图片上传自动生成 HTML 格式**
+  - `uploadFile` 工具现在返回 `imageHtml` 字段，包含禅道所需的完整 HTML 代码
+  - `uploadImageFromClipboard` 工具同样返回 `imageHtml` 字段
+  - 新增 `imageUrl` 字段，提供完整的图片访问地址
+  - 新增 `fileId` 字段，方便后续引用
+  - 新增使用提示 `tip` 字段，帮助用户正确使用
+
+### Changed
+- ZentaoAPI 类新增 `getConfig()` 方法，允许获取配置信息以生成图片 URL
+- 图片上传返回格式优化，Claude Code 现在能自动识别并使用正确的 HTML 格式
+
+### Technical
+- 图片 HTML 格式：`<img onload="setImageSize(this,0)" src="..." alt="..." />`
+- 自动包含 `onload="setImageSize(this,0)"` 以确保图片在禅道中正确显示
+
+### Benefits
+- **提升用户体验**：Claude Code 无需手动构造 HTML 代码
+- **减少错误**：避免手动拼接 HTML 时的格式错误
+- **更直观**：返回结果中直接包含可用的 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 - 重大更新

package/README.md

@@ -15,11 +15,10 @@ npm install @zzp123/mcp-zentao -g
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
 
-**最新版本**: v1.6.0
-- 迁移到自定义模块接口 /custom/modules，支持字段过滤
-- 新增 fields 参数，可减少60-80%数据传输量
-- 返回数据扁平化，包含 total 统计信息
-- ⚠️ Breaking Change: getModules 返回类型变更
+**最新版本**: v1.6.1
+- 修复 Windows 剪贴板图片读取问题
+- 使用新的 PowerShell 脚本确保正确读取剪贴板图片
+- 改进错误处理和日志输出
 
 **主要版本**:
 - v1.4.1 - 修复 uploadImageFromClipboard 返回值问题

package/dist/api/zentaoApi.d.ts

@@ -158,4 +158,5 @@ export declare class ZentaoAPI {
     getModules(type: ModuleType, id: number, fields?: string): Promise<ModulesResponse>;
     uploadFile(uploadRequest: UploadFileRequest): Promise<FileUploadResponse>;
     downloadFile(fileId: number): Promise<Buffer>;
+    getConfig(): ZentaoConfig;
 }

package/dist/api/zentaoApi.js

@@ -1189,4 +1189,8 @@ export class ZentaoAPI {
             throw error;
         }
     }
+    // 获取配置信息（用于生成图片 URL）
+    getConfig() {
+        return this.config;
+    }
 }

package/dist/index.js

@@ -988,8 +988,17 @@ server.tool("uploadFile", {
         filename: finalFilename,
         uid
     });
+    // 生成禅道需要的 HTML 格式
+    const fileId = result.id;
+    const baseUrl = zentaoApi.getConfig().url;
+    const imageUrl = `${baseUrl}/zentao/entao/api.php?m=file&f=read&t=png&fileID=${fileId}`;
+    const imageHtml = `<img onload="setImageSize(this,0)" src="${imageUrl}" alt="${finalFilename}" />`;
     const response = {
         upload: result,
+        fileId: fileId,
+        imageUrl: imageUrl,
+        imageHtml: imageHtml,
+        tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码`
     };
     if (savedPath) {
         response.savedPath = savedPath;
@@ -1017,41 +1026,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') {
@@ -1121,13 +1138,22 @@ server.tool("uploadImageFromClipboard", {
             uid
         });
         console.log('[uploadImageFromClipboard] 上传成功，结果:', uploadResult);
+        // 生成禅道需要的 HTML 格式
+        const fileId = uploadResult.id;
+        const baseUrl = zentaoApi.getConfig().url;
+        const imageUrl = `${baseUrl}/zentao/entao/api.php?m=file&f=read&t=png&fileID=${fileId}`;
+        const imageHtml = `<img onload="setImageSize(this,0)" src="${imageUrl}" alt="${finalFilename}" />`;
         const response = {
             success: true,
             upload: uploadResult,
             savedPath: savedPath,
             filename: finalFilename,
             fileSize: fileBuffer.length,
-            message: `图片已保存到本地并上传到禅道`
+            fileId: fileId,
+            imageUrl: imageUrl,
+            imageHtml: imageHtml,
+            message: `图片已保存到本地并上传到禅道`,
+            tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码`
         };
         console.log('[uploadImageFromClipboard] 返回结果:', response);
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.6.0",
+    "version": "1.7.0",
     "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"
+}