@zzp123/mcp-zentao 1.17.4 → 1.17.6

package/CHANGELOG.md

@@ -5,6 +5,47 @@ 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.17.6] - 2025-11-10
+
+### Changed
+- **评论工具完全统一** 💬
+  - 移除最后一个便捷工具 `addStoryComment`
+  - 现在所有评论统一使用 `addComment` 工具
+  - 支持11种对象类型：story, requirement, task, bug, testcase, testtask, todo, doc, doctemplate, execution, project
+
+### Impact
+- **完整版**: 92工具 → 91工具 (-1个)
+- **产品经理版**: 40工具 → 39工具 (-1个)
+- **测试工程师版**: 27工具 → 26工具 (-1个)
+- **开发工程师版**: 39工具 → 38工具 (-1个)
+- **总计**: 完全统一评论API，累计减少约 106行重复代码
+
+### Technical
+- 从 `src/roleConfig.ts` 中移除 `addStoryComment`
+- 从 `src/index.ts` 删除 `addStoryComment` 工具定义
+- 重新生成所有角色版本源文件
+- 更新 `prepare-publish.cjs` 中的工具计数
+
+## [1.17.5] - 2025-11-10
+
+### Changed
+- **评论工具简化** 💬
+  - 移除 `addBugComment` 和 `addTaskComment` 便捷工具
+  - 只保留通用的 `addComment` 工具和产品经理专用的 `addStoryComment`
+  - 简化工具集，用户使用 `addComment` 可以为任何对象添加评论
+
+### Impact
+- **完整版**: 94工具 → 92工具 (-2个)
+- **产品经理版**: 42工具 → 40工具 (-2个)
+- **测试工程师版**: 29工具 → 27工具 (-2个)
+- **开发工程师版**: 41工具 → 39工具 (-2个)
+- **总计**: 减少 6个工具定义，简化约 200行代码
+
+### Technical
+- 更新 `src/roleConfig.ts` 中的 comment 工具列表
+- 从 `src/index.ts` 删除 `addTaskComment` 和 `addBugComment` 定义
+- 重新生成所有角色版本源文件
+
 ## [1.17.4] - 2025-11-10
 
 ### Changed

package/README.md

@@ -17,10 +17,10 @@ npm install @zzp123/mcp-zentao -g
 
 | 版本 | 命令 | 工具数量 | 文件大小 | 适用角色 |
 |------|------|---------|---------|---------|
-| **完整版** | `zentao` | 94个 | 69 KB | 需要使用全部功能 |
-| **产品经理版** | `zentao-pm` | 42个 | 40 KB (-55%) | 需求、产品、计划管理 |
-| **测试工程师版** | `zentao-qa` | 29个 | 27 KB (-61%) | Bug、测试用例管理 |
-| **开发工程师版** | `zentao-dev` | 41个 | 37 KB (-46%) | 任务、项目、Bug解决 |
+| **完整版** | `zentao` | 91个 | 67 KB | 需要使用全部功能 |
+| **产品经理版** | `zentao-pm` | 39个 | 39 KB (-57%) | 需求、产品、计划管理 |
+| **测试工程师版** | `zentao-qa` | 26个 | 25 KB (-71%) | Bug、测试用例管理 |
+| **开发工程师版** | `zentao-dev` | 38个 | 35 KB (-58%) | 任务、项目、Bug解决 |
 
 ### 如何选择版本？
 
@@ -83,15 +83,15 @@ npm install @zzp123/mcp-zentao -g
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
 
-**最新版本**: v1.17.4 - 2025-11-10
-- 📊 产品经理版再次优化（移除工单管理工具）
-- 🎯 产品经理版工具从 47 个减少到 42 个，减少上下文占用 55%
-- 🚀 更专注于需求、产品和计划管理核心功能
+**最新版本**: v1.17.6 - 2025-11-10
+- 💬 评论工具完全统一（移除所有便捷工具，统一使用 addComment）
+- 📊 完整版 91个工具，PM版 39个，QA版 26个，Dev版 38个
+- 🎯 累计减少约 106行重复代码，完全统一评论API
 
 **近期版本**:
-- v1.17.3 - 测试工程师版优化（移除构建版本和工单管理，29个工具）
-- v1.17.2 - 产品经理版优化（移除反馈管理工具，47个工具）
-- v1.17.1 - 开发工程师版优化（移除工单管理工具，41个工具）
+- v1.17.5 - 评论工具简化（移除 addBugComment 和 addTaskComment）
+- v1.17.4 - 产品经理版移除工单管理（42个工具）
+- v1.17.3 - 测试工程师版移除构建和工单管理（29个工具）
 
 ## 使用方法
 

package/dist/index-dev.js

@@ -828,69 +828,6 @@ server.tool("deleteComment", "删除评论 - 只能删除自己的评论，管
             }]
     };
 });
-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");
-    const result = await zentaoApi.addComment({
-        objectType: 'story',
-        objectID: storyId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为需求 #${storyId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'task',
-        objectID: taskId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为任务 #${taskId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'bug',
-        objectID: bugId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为Bug #${bugId} 添加评论`,
-                    comment: result
-                }, 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/index-pm.js

@@ -949,69 +949,6 @@ server.tool("deleteComment", "删除评论 - 只能删除自己的评论，管
             }]
     };
 });
-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");
-    const result = await zentaoApi.addComment({
-        objectType: 'story',
-        objectID: storyId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为需求 #${storyId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'task',
-        objectID: taskId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为任务 #${taskId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'bug',
-        objectID: bugId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为Bug #${bugId} 添加评论`,
-                    comment: result
-                }, 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/index-qa.js

@@ -765,69 +765,6 @@ server.tool("deleteComment", "删除评论 - 只能删除自己的评论，管
             }]
     };
 });
-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");
-    const result = await zentaoApi.addComment({
-        objectType: 'story',
-        objectID: storyId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为需求 #${storyId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'task',
-        objectID: taskId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为任务 #${taskId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'bug',
-        objectID: bugId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为Bug #${bugId} 添加评论`,
-                    comment: result
-                }, 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/index.js

@@ -1622,70 +1622,6 @@ server.tool("deleteComment", "删除评论 - 只能删除自己的评论，管
             }]
     };
 });
-// 便捷工具 - 为特定类型对象添加评论
-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");
-    const result = await zentaoApi.addComment({
-        objectType: 'story',
-        objectID: storyId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为需求 #${storyId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'task',
-        objectID: taskId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为任务 #${taskId} 添加评论`,
-                    comment: result
-                }, 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({
-        objectType: 'bug',
-        objectID: bugId,
-        comment
-    });
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify({
-                    message: `已为Bug #${bugId} 添加评论`,
-                    comment: result
-                }, 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/roleConfig.js

@@ -72,7 +72,7 @@ export const TOOL_CATEGORIES = {
     // 评论功能（所有角色）
     comment: [
         'getComments', 'getCommentDetail', 'addComment',
-        'updateComment', 'deleteComment', 'addTaskComment', 'addBugComment'
+        'updateComment', 'deleteComment'
     ],
     // 模块和文件（所有角色）
     utility: [

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.17.4",
+    "version": "1.17.6",
     "description": "禅道项目管理系统的高级API集成包 - 完整版，包含所有94个工具。另有产品经理、测试工程师、开发工程师专用精简版本可选",
     "main": "dist/index.js",
     "type": "module",

package/scripts/generate-role-versions.cjs

@@ -20,7 +20,7 @@ const TOOL_CATEGORIES = {
     execution: ['getExecutionDetail', 'createExecution', 'updateExecution', 'deleteExecution', 'getExecutionBuilds'],
     build: ['getBuildDetail', 'createBuild', 'updateBuild', 'deleteBuild'],
     ticket: ['getTickets', 'getTicketDetail', 'createTicket', 'updateTicket', 'deleteTicket'],
-    comment: ['getComments', 'getCommentDetail', 'addComment', 'updateComment', 'deleteComment', 'addTaskComment', 'addBugComment', 'addStoryComment'],
+    comment: ['getComments', 'getCommentDetail', 'addComment', 'updateComment', 'deleteComment'],
     utility: ['getModules', 'uploadFile', 'uploadImageFromClipboard', 'downloadFile'],
     user: ['getUsers', 'getUserDetail', 'getMyProfile', 'createUser', 'updateUser', 'deleteUser']
 };