@zzp123/mcp-zentao 1.7.0 → 1.7.2

package/CHANGELOG.md

@@ -5,6 +5,51 @@ 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.2] - 2025-11-06
+
+### Added
+- **updateStory 工具重大增强**
+  - 新增29个可编辑字段支持，��全对接禅道最新API文档
+  - 支持需求基本信息编辑：title, product, parent, module, branch, plan, type
+  - 支持来源信息编辑：source, sourceNote（支持8种来源类型）
+  - 支持分类与优先级：category, pri, estimate
+  - 支持状态与阶段：stage, status
+  - 支持关键词与标识：keywords, color, grade
+  - 支持人员相关：mailto, reviewer, assignedTo, closedBy, feedbackBy
+  - 支持关闭相关：closedReason, duplicateStory（7种关闭原因）
+  - 支持评审相关：needNotReview
+  - 支持通知相关：notifyEmail
+  - 支持描述内容：spec, verify（HTML格式）
+  - 支持备注：comment
+
+### Changed
+- `UpdateStoryRequest` 接口完全重构，从7个字段扩展到29个字段
+- `updateStory` MCP 工具参数完全重新定义，支持所有新字段
+- 添加了详细的字段注释和类型定义，提升开发体验
+
+### Technical
+- 所有字段均为可选参数，支持部分更新
+- `plan` 字段支持单个ID或数组格式
+- `closedReason` 使用枚举类型确保数据正确性
+- `mailto` 和 `reviewer` 字段支持数组格式
+
+### Benefits
+- **功能完整性**：支持禅道需求管理的所有常用编辑功能
+- **灵活性**：可以批量更新多个字段，也可以单独更新单个字段
+- **类型安全**：完整的 TypeScript 类型定义，减少运行时错误
+
+## [1.7.1] - 2025-11-06
+
+### Fixed
+- **图片 HTML 格式优化**
+  - `uploadFile` 和 `uploadImageFromClipboard` 工具现在生成的 `imageHtml` 会被 `<p>` 标签包裹
+  - 修复了某些情况下图片在禅道中无法正确显示的问题
+  - 确保生成的 HTML 格式与禅道富文本编辑器的标准格式一致
+
+### Changed
+- 图片 HTML 格式从 `<img ... />` 改为 `<p><img ... /></p>`
+- 更新使用提示，明确说明图片会被包裹在 `<p>` 标签中
+
 ## [1.7.0] - 2025-11-06
 
 ### Added

package/dist/index.js

@@ -464,14 +464,47 @@ server.tool("getProjects", {
 server.tool("updateStory", {
     storyId: z.number(),
     update: z.object({
+        // 基本信息
+        title: z.string().optional(),
+        product: z.number().optional(),
+        parent: z.number().optional(),
         module: z.number().optional(),
+        branch: z.number().optional(),
+        plan: z.union([z.number(), z.array(z.number())]).optional(),
+        type: z.string().optional(),
+        // 来源信息
         source: z.string().optional(),
         sourceNote: z.string().optional(),
-        pri: z.number().optional(),
+        // 分类与优先级
         category: z.string().optional(),
+        pri: z.number().optional(),
         estimate: z.number().optional(),
-        keywords: z.string().optional()
-    })
+        // 状态与阶段
+        stage: z.string().optional(),
+        status: z.string().optional(),
+        // 关键词与标识
+        keywords: z.string().optional(),
+        color: z.string().optional(),
+        grade: z.number().optional(),
+        // 人员相关
+        mailto: z.array(z.string()).optional(),
+        reviewer: z.array(z.string()).optional(),
+        assignedTo: z.string().optional(),
+        closedBy: z.string().optional(),
+        feedbackBy: z.string().optional(),
+        // 关闭相关
+        closedReason: z.enum(['done', 'subdivided', 'duplicate', 'postponed', 'willnotdo', 'cancel', 'bydesign']).optional(),
+        duplicateStory: z.number().optional(),
+        // 评审相关
+        needNotReview: z.boolean().optional(),
+        // 通知相关
+        notifyEmail: z.string().optional(),
+        // 描述内容
+        spec: z.string().optional(),
+        verify: z.string().optional(),
+        // 备注
+        comment: z.string().optional()
+    }).describe("需求更新字段 - 根据API文档支持29个可编辑字段")
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
@@ -992,13 +1025,13 @@ server.tool("uploadFile", {
     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 imageHtml = `<p><img onload="setImageSize(this,0)" src="${imageUrl}" alt="${finalFilename}" /></p>`;
     const response = {
         upload: result,
         fileId: fileId,
         imageUrl: imageUrl,
         imageHtml: imageHtml,
-        tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码`
+        tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码。图片会被包裹在 <p> 标签中以确保正确显示。`
     };
     if (savedPath) {
         response.savedPath = savedPath;
@@ -1142,7 +1175,7 @@ server.tool("uploadImageFromClipboard", {
         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 imageHtml = `<p><img onload="setImageSize(this,0)" src="${imageUrl}" alt="${finalFilename}" /></p>`;
         const response = {
             success: true,
             upload: uploadResult,
@@ -1153,7 +1186,7 @@ server.tool("uploadImageFromClipboard", {
             imageUrl: imageUrl,
             imageHtml: imageHtml,
             message: `图片已保存到本地并上传到禅道`,
-            tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码`
+            tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码。图片会被包裹在 <p> 标签中以确保正确显示。`
         };
         console.log('[uploadImageFromClipboard] 返回结果:', response);
         return {

package/dist/types/zentao.d.ts

@@ -257,13 +257,35 @@ export interface Project {
     progress: number;
 }
 export interface UpdateStoryRequest {
+    title?: string;
+    product?: number;
+    parent?: number;
     module?: number;
+    branch?: number;
+    plan?: number | number[];
+    type?: string;
     source?: string;
     sourceNote?: string;
-    pri?: number;
     category?: string;
+    pri?: number;
     estimate?: number;
+    stage?: string;
+    status?: string;
     keywords?: string;
+    color?: string;
+    grade?: number;
+    mailto?: string[];
+    reviewer?: string[];
+    assignedTo?: string;
+    closedBy?: string;
+    feedbackBy?: string;
+    closedReason?: 'done' | 'subdivided' | 'duplicate' | 'postponed' | 'willnotdo' | 'cancel' | 'bydesign';
+    duplicateStory?: number;
+    needNotReview?: boolean;
+    notifyEmail?: string;
+    spec?: string;
+    verify?: string;
+    comment?: string;
 }
 export interface CreateProgramRequest {
     name?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.7.0",
+    "version": "1.7.2",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",
@@ -42,7 +42,7 @@
     "license": "MIT",
     "repository": {
         "type": "git",
-        "url": "https://github.com/yourusername/mcp-zentao.git"
+        "url": "git+https://github.com/yourusername/mcp-zentao.git"
     },
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.6.1",