@zzp123/mcp-zentao 1.17.3 → 1.17.5

package/CHANGELOG.md

@@ -5,6 +5,39 @@ 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.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
+- **产品经理版再次优化** 📊
+  - 从产品经理版 (mcp-zentao-pm) 移除工单管理工具（5个工具）
+  - 工具数量从 47 个减少到 42 个
+  - 包大小从 44 KB 减少到约 40 KB
+  - 更专注于需求、产品和计划管理核心功能
+
+### Technical
+- 更新 `roleConfig.ts` 中的 pm 角色配置
+- 重新生成产品经理版源文件 (`src/index-pm.ts`)
+
 ## [1.17.3] - 2025-11-10
 
 ### Changed

package/README.md

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

package/dist/index-dev.js

@@ -849,48 +849,6 @@ server.tool("addStoryComment", "为需求添加评论 - 专用工具，支持软
             }]
     };
 });
-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

@@ -568,50 +568,6 @@ server.tool("deleteStory", "删除需求 - 支持软件需求(story)和用户需
         throw new Error("Please initialize Zentao API first");
     return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.deleteStory(storyId), null, 2) }] };
 });
-server.tool("getTickets", {
-    browseType: z.string().optional(),
-    param: z.string().optional(),
-    orderBy: z.string().optional(),
-    page: z.number().optional(),
-    limit: z.number().optional()
-}, async (params) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.getTickets(params), null, 2) }] };
-});
-server.tool("getTicketDetail", { ticketId: z.number() }, async ({ ticketId }) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.getTicketDetail(ticketId), null, 2) }] };
-});
-server.tool("createTicket", {
-    product: z.number(),
-    module: z.number(),
-    title: z.string(),
-    type: z.string().optional(),
-    desc: z.string().optional()
-}, async (params) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.createTicket(params), null, 2) }] };
-});
-server.tool("updateTicket", {
-    ticketId: z.number(),
-    product: z.number().optional(),
-    module: z.number().optional(),
-    title: z.string().optional(),
-    type: z.string().optional(),
-    desc: z.string().optional()
-}, async ({ ticketId, ...params }) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.updateTicket(ticketId, params), null, 2) }] };
-});
-server.tool("deleteTicket", { ticketId: z.number() }, async ({ ticketId }) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.deleteTicket(ticketId), null, 2) }] };
-});
 server.tool("getModules", {
     type: z.enum(['story', 'task', 'bug', 'case', 'feedback', 'product']),
     id: z.number(),
@@ -1014,48 +970,6 @@ server.tool("addStoryComment", "为需求添加评论 - 专用工具，支持软
             }]
     };
 });
-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

@@ -786,48 +786,6 @@ server.tool("addStoryComment", "为需求添加评论 - 专用工具，支持软
             }]
     };
 });
-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

@@ -1644,48 +1644,6 @@ server.tool("addStoryComment", "为需求添加评论 - 专用工具，支持软
             }]
     };
 });
-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', 'addStoryComment'
     ],
     // 模块和文件（所有角色）
     utility: [
@@ -96,7 +96,6 @@ export const ROLE_PERMISSIONS = {
         ...TOOL_CATEGORIES.bugReadonly,
         ...TOOL_CATEGORIES.taskReadonly,
         ...TOOL_CATEGORIES.comment,
-        ...TOOL_CATEGORIES.ticket,
         ...TOOL_CATEGORIES.utility
     ],
     // 测试工程师：Bug、测试用例、评论

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.17.3",
+    "version": "1.17.5",
     "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', 'addStoryComment'],
     utility: ['getModules', 'uploadFile', 'uploadImageFromClipboard', 'downloadFile'],
     user: ['getUsers', 'getUserDetail', 'getMyProfile', 'createUser', 'updateUser', 'deleteUser']
 };
@@ -35,7 +35,6 @@ const ROLE_PERMISSIONS = {
         ...TOOL_CATEGORIES.bugReadonly,
         ...TOOL_CATEGORIES.taskReadonly,
         ...TOOL_CATEGORIES.comment,
-        ...TOOL_CATEGORIES.ticket,
         ...TOOL_CATEGORIES.utility
     ],
     qa: [