@zzp123/mcp-zentao 1.8.4 → 1.8.6

package/CHANGELOG.md

@@ -5,6 +5,38 @@ 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.8.6] - 2025-11-06
+
+### Fixed
+- **修复 uploadImageFromClipboard 工具路径依赖问题**
+  - 将 PowerShell 脚本内嵌到代码中，不再依赖外部文件
+  - 解决了 Claude Code 工作目录与包安装目录不匹配的问题
+  - 使用 Base64 编码避免转义问题
+
+### Improved
+- **优化 uploadImageFromClipboard 工具的用户体验**
+  - 默认行为：直接从剪贴板获取图片并上传到禅道
+  - 简化了操作流程，用户只需说"上传图片"即可
+  - 移除了对外部脚本文件的依赖，提高了可靠性
+
+### Technical
+- 脚本完全内嵌，提高可移植性
+- 不再依赖 process.cwd() 路径解析
+- 更健壮的错误处理机制
+
+## [1.8.5] - 2025-11-06
+
+### Improved
+- **优化 changeStory 工具参数说明**
+  - 为 `reviewer` 字段添加详细描述：说明其通常为必填字段，除非设置 `needNotReview=true` 跳过评审
+  - 为 `needNotReview` 字段添加说明：如果不提供 `reviewer` 则应设置为 `true`
+  - 为 `storyId` 参数添加描述，提升工具可读性
+  - 为工具本身添加整体说明："需求变更 - 支持对象或JSON字符串格式"
+
+### Technical
+- 改进 MCP 工具的参数描述，帮助 AI 助手更好地理解参数使用规则
+- 提升工具在 Claude Code 等 AI IDE 中的可用性
+
 ## [1.8.0] - 2025-11-06
 
 ### Changed

package/dist/index.js

@@ -535,8 +535,8 @@ server.tool("getProjects", {
     };
 });
 // Add changeStory tool
-server.tool("changeStory", {
-    storyId: z.number(),
+server.tool("changeStory", "需求变更 - 支持对象或JSON字符串格式", {
+    storyId: z.number().describe("需求ID"),
     update: z.union([
         z.object({
             // 基本信息
@@ -563,7 +563,7 @@ server.tool("changeStory", {
             grade: z.number().optional(),
             // 人员相关
             mailto: z.array(z.string()).optional(),
-            reviewer: z.array(z.string()).optional(),
+            reviewer: z.array(z.string()).optional().describe("评审人员列表（通常为必填，除非设置needNotReview=true跳过评审）"),
             assignedTo: z.string().optional(),
             closedBy: z.string().optional(),
             feedbackBy: z.string().optional(),
@@ -571,7 +571,7 @@ server.tool("changeStory", {
             closedReason: z.enum(['done', 'subdivided', 'duplicate', 'postponed', 'willnotdo', 'cancel', 'bydesign']).optional(),
             duplicateStory: z.number().optional(),
             // 评审相关
-            needNotReview: z.boolean().optional(),
+            needNotReview: z.boolean().optional().describe("是否跳过评审，如果不提供reviewer则应设置为true"),
             // 通知相关
             notifyEmail: z.string().optional(),
             // 描述内容
@@ -1147,9 +1147,9 @@ server.tool("uploadFile", {
     }
     return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
 });
-server.tool("uploadImageFromClipboard", {
-    filename: z.string().optional(),
-    uid: z.string().optional()
+server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动获取剪贴板中的图片并上传", {
+    filename: z.string().optional().describe("自定义文件名，默认为 clipboard_时间戳.png"),
+    uid: z.string().optional().describe("禅道文件UID，用于关联需求或Bug")
 }, async ({ filename, uid }) => {
     if (!zentaoApi) {
         return {
@@ -1171,11 +1171,12 @@ server.tool("uploadImageFromClipboard", {
         // Windows: 使用 PowerShell 脚本读取剪贴板
         if (process.platform === 'win32') {
             console.log('[uploadImageFromClipboard] Windows平台，使用PowerShell脚本读取剪贴板...');
-            // 使用外部 PowerShell 脚本
-            const scriptPath = path.join(process.cwd(), 'scripts', 'get_clipboard.ps1');
-            console.log(`[uploadImageFromClipboard] 脚本路径: ${scriptPath}`);
+            // 内嵌 PowerShell 脚本，避免依赖外部文件
+            const psScript = `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-Output 'NoImage' }`;
             try {
-                const result = execSync(`powershell -ExecutionPolicy Bypass -File "${scriptPath}"`, {
+                // 使用 Base64 编码 PowerShell 脚本以避免转义问题
+                const psScriptBase64 = Buffer.from(psScript, 'utf16le').toString('base64');
+                const result = execSync(`powershell -ExecutionPolicy Bypass -EncodedCommand ${psScriptBase64}`, {
                     encoding: 'utf8',
                     maxBuffer: 10 * 1024 * 1024,
                     stdio: ['pipe', 'pipe', 'pipe']
@@ -1205,7 +1206,7 @@ server.tool("uploadImageFromClipboard", {
                             text: JSON.stringify({
                                 error: "读取剪贴板失败",
                                 details: err.message,
-                                tip: "请确保已复制图片到剪贴板，并且 PowerShell 脚本存在于 scripts/get_clipboard.ps1"
+                                tip: "请确保已复制图片到剪贴板"
                             }, null, 2)
                         }],
                     isError: true

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.8.4",
+    "version": "1.8.6",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",
@@ -22,8 +22,6 @@
         "test": "jest",
         "test:watch": "jest --watch",
         "test:manual": "ts-node test/manual-test.ts",
-        "test:story": "node quick-test-story.js",
-        "test:story:full": "node test-update-story.js",
         "prepublishOnly": "npm run test && npm run build",
         "start": "node json-args.js",
         "upload:clipboard": "node scripts/upload-clipboard-image.js",