@zzp123/mcp-zentao 1.4.1 → 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/package.json

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