@zzp123/mcp-zentao 1.6.1 → 1.7.0

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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

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;
@@ -1129,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.1",
+    "version": "1.7.0",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",