@zzp123/mcp-zentao 1.14.0 → 1.15.0

package/CHANGELOG.md

@@ -5,6 +5,37 @@ 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.15.0] - 2025-11-07
+
+### Added
+- **评论功能完整支持** 💬
+  - 新增 `addComment` 通用评论工具，支持9种对象类型
+  - 新增专用评论工具：
+    - `addStoryComment`: 为需求添加评论（自动识别story/requirement）
+    - `addTaskComment`: 为任务添加评论
+    - `addBugComment`: 为Bug添加评论
+  - 支持的对象类型：
+    - story（软件需求）
+    - requirement（用户需求）
+    - task（任务）
+    - bug（Bug）
+    - testcase（测试用例）
+    - testtask（测试单）
+    - todo（待办）
+    - doc（文档）
+    - doctemplate（文档模板）
+
+### Changed
+- **评论内容格式**
+  - 支持纯文本评论
+  - 支持HTML格式的富文本评论
+  - 自动处理评论提交的响应格式
+
+### Technical
+- 添加 `CommentObjectType` 类型定义
+- 添加 `AddCommentRequest` 和 `CommentResponse` 接口
+- 实现混合接口调用（使用HTML接口但保持REST API认证）
+
 ## [1.14.0] - 2025-11-07
 
 ### Added

package/dist/api/zentaoApi.d.ts

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

package/dist/api/zentaoApi.js

@@ -1534,6 +1534,63 @@ export class ZentaoAPI {
             throw error;
         }
     }
+    // 评论模块 - 使用 HTML 接口
+    async addComment(objectType, objectID, comment) {
+        try {
+            console.log(`正在为 ${objectType} ${objectID} 添加评论...`);
+            const token = await this.getToken();
+            const htmlUrl = `${this.config.url}/zentao/action-comment-${objectType}-${objectID}.html`;
+            // 使用 form-urlencoded 格式发送数据
+            const formData = new URLSearchParams();
+            formData.append('actioncomment', comment);
+            const response = await axios.post(htmlUrl, formData.toString(), {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'Token': token
+                },
+                timeout: 10000
+            });
+            console.log('添加评论响应:', response.data);
+            // 返回统一格式
+            if (response.data && typeof response.data === 'object') {
+                // 如果是 JSON 响应（API 模式）
+                if (response.data.status === 'success' || response.data.result === 'success') {
+                    return {
+                        status: 'success',
+                        actionID: response.data.data || response.data.actionID,
+                        message: '评论添加成功'
+                    };
+                }
+                else if (response.data.result === 'fail' || response.data.status === 'fail') {
+                    throw new Error(response.data.message || '评论添加失败');
+                }
+            }
+            // 如果返回的是 HTML 或其他格式，认为成功
+            return {
+                status: 'success',
+                message: '评论添加成功'
+            };
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                console.error('添加评论失败:', {
+                    status: error.response?.status,
+                    data: error.response?.data,
+                    message: error.message
+                });
+                // 尝试解析错误消息
+                if (error.response?.data) {
+                    const errorData = error.response.data;
+                    if (typeof errorData === 'object' && errorData.message) {
+                        throw new Error(`添加评论失败: ${errorData.message}`);
+                    }
+                }
+                throw new Error(`添加评论失败: ${error.message}`);
+            }
+            console.error('添加评论失败:', error);
+            throw error;
+        }
+    }
     // 获取配置信息（用于生成图片 URL）
     getConfig() {
         return this.config;

package/dist/index.js

@@ -1504,6 +1504,95 @@ server.tool("downloadFile", {
     fs.writeFileSync(savePath, fileBuffer);
     return { content: [{ type: "text", text: `文件已下载到: ${savePath}` }] };
 });
+// Comment tools (评论工具)
+server.tool("addComment", "添加评论 - 为需求、任务、Bug等对象添加评论", {
+    objectType: z.enum([
+        'story', // 软件需求
+        'requirement', // 用户需求
+        'task', // 任务
+        'bug', // Bug
+        'testcase', // 测试用例
+        'testtask', // 测试单
+        'todo', // 待办
+        'doc', // 文档
+        'doctemplate' // 文档模板
+    ]).describe("对象类型"),
+    objectID: z.number().describe("对象ID"),
+    comment: z.string().describe("评论内容，支持HTML格式")
+}, async ({ objectType, objectID, comment }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const result = await zentaoApi.addComment(objectType, objectID, comment);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    status: result.status,
+                    message: result.message,
+                    actionID: result.actionID,
+                    details: `已为 ${objectType} #${objectID} 添加评论`
+                }, null, 2)
+            }]
+    };
+});
+server.tool("addStoryComment", "为需求添加评论 - 专用工具，支持软件需求(story)和用户需求(requirement)", {
+    storyId: z.number().describe("需求ID"),
+    comment: z.string().describe("评论内容，支持HTML格式")
+}, async ({ storyId, comment }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    // 使用 'story' 类型，API会自动识别是 story 还是 requirement
+    const result = await zentaoApi.addComment('story', storyId, comment);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    status: result.status,
+                    message: result.message,
+                    actionID: result.actionID,
+                    details: `已为需求 #${storyId} 添加评论`
+                }, null, 2)
+            }]
+    };
+});
+server.tool("addTaskComment", "为任务添加评论", {
+    taskId: z.number().describe("任务ID"),
+    comment: z.string().describe("评论内容，支持HTML格式")
+}, async ({ taskId, comment }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const result = await zentaoApi.addComment('task', taskId, comment);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    status: result.status,
+                    message: result.message,
+                    actionID: result.actionID,
+                    details: `已为任务 #${taskId} 添加评论`
+                }, null, 2)
+            }]
+    };
+});
+server.tool("addBugComment", "为Bug添加评论", {
+    bugId: z.number().describe("Bug ID"),
+    comment: z.string().describe("评论内容，支持HTML格式")
+}, async ({ bugId, comment }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const result = await zentaoApi.addComment('bug', bugId, comment);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    status: result.status,
+                    message: result.message,
+                    actionID: result.actionID,
+                    details: `已为Bug #${bugId} 添加评论`
+                }, null, 2)
+            }]
+    };
+});
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();
 await server.connect(transport).catch(console.error);

package/dist/types/zentao.d.ts

@@ -717,3 +717,14 @@ export interface UploadFileRequest {
     filename: string;
     uid?: string;
 }
+export type CommentObjectType = 'story' | 'requirement' | 'task' | 'bug' | 'testcase' | 'testtask' | 'todo' | 'doc' | 'doctemplate';
+export interface AddCommentRequest {
+    objectType: CommentObjectType;
+    objectID: number;
+    comment: string;
+}
+export interface CommentResponse {
+    status: string;
+    data?: number;
+    message?: string;
+}

package/package.json

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