@zzp123/mcp-zentao 1.17.5 → 1.17.7

package/CHANGELOG.md

@@ -5,6 +5,27 @@ 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

package/README.md

@@ -17,10 +17,10 @@ npm install @zzp123/mcp-zentao -g
 
 | 版本 | 命令 | 工具数量 | 文件大小 | 适用角色 |
 |------|------|---------|---------|---------|
-| **完整版** | `zentao` | 92个 | 67 KB | 需要使用全部功能 |
-| **产品经理版** | `zentao-pm` | 40个 | 39 KB (-57%) | 需求、产品、计划管理 |
-| **测试工程师版** | `zentao-qa` | 27个 | 25 KB (-71%) | Bug、测试用例管理 |
-| **开发工程师版** | `zentao-dev` | 39个 | 35 KB (-58%) | 任务、项目、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.5 - 2025-11-10
-- 💬 评论工具简化（移除便捷工具，统一使用 addComment）
-- 📊 完整版 92个工具，PM版 40个，QA版 27个，Dev版 39个
-- 🎯 减少 6个工具定义，简化约 200行代码
+**最新版本**: v1.17.6 - 2025-11-10
+- 💬 评论工具完全统一（移除所有便捷工具，统一使用 addComment）
+- 📊 完整版 91个工具，PM版 39个，QA版 26个，Dev版 38个
+- 🎯 累计减少约 106行重复代码，完全统一评论API
 
 **近期版本**:
+- v1.17.5 - 评论工具简化（移除 addBugComment 和 addTaskComment）
 - v1.17.4 - 产品经理版移除工单管理（42个工具）
 - v1.17.3 - 测试工程师版移除构建和工单管理（29个工具）
-- v1.17.2 - 产品经理版移除反馈管理（47个工具）
 
 ## 使用方法
 

package/dist/api/zentaoApi.d.ts

@@ -41,7 +41,7 @@ export declare class ZentaoAPI {
      * @param limit 每页数量（默认20，最大100）
      * @param branch 分支筛选（'all'所有分支/'0'主干/分支ID，默认'all'）
      * @param order 排序字段（如：'id_desc'、'pri_desc'等，默认'id_desc'）
-     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'default'）
+     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'basic'）
      * @returns Promise<Bug列表及分页信息>
      */
     getMyBugs(status?: BugStatus, productId?: number, page?: number, limit?: number, branch?: string, order?: string, fields?: 'basic' | 'default' | 'full'): Promise<{
@@ -59,7 +59,7 @@ export declare class ZentaoAPI {
      * @param status Bug状态筛选（支持多种状态，详见BugStatus类型）
      * @param branch 分支筛选（'all'所有分支/'0'主干/分支ID，默认'all'）
      * @param order 排序字段（如：'id_desc'、'pri_desc'等，默认'id_desc'）
-     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'default'）
+     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'basic'）
      * @returns Promise<Bug列表及分页信息>
      */
     getProductBugs(productId: number, page?: number, limit?: number, status?: BugStatus, branch?: string, order?: string, fields?: 'basic' | 'default' | 'full'): Promise<{

package/dist/api/zentaoApi.js

@@ -240,7 +240,7 @@ export class ZentaoAPI {
      * @param limit 每页数量（默认20，最大100）
      * @param branch 分支筛选（'all'所有分支/'0'主干/分支ID，默认'all'）
      * @param order 排序字段（如：'id_desc'、'pri_desc'等，默认'id_desc'）
-     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'default'）
+     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'basic'）
      * @returns Promise<Bug列表及分页信息>
      */
     async getMyBugs(status, productId, page, limit, branch, order, fields) {
@@ -259,7 +259,7 @@ export class ZentaoAPI {
         const finalPage = page || 1;
         const finalBranch = branch || 'all';
         const finalOrder = order || 'id_desc';
-        const finalFields = fields || 'default';
+        const finalFields = fields || 'basic';
         // 构建查询参数
         const queryParams = new URLSearchParams();
         queryParams.append('branch', finalBranch);
@@ -317,7 +317,7 @@ export class ZentaoAPI {
      * @param status Bug状态筛选（支持多种状态，详见BugStatus类型）
      * @param branch 分支筛选（'all'所有分支/'0'主干/分支ID，默认'all'）
      * @param order 排序字段（如：'id_desc'、'pri_desc'等，默认'id_desc'）
-     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'default'）
+     * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'basic'）
      * @returns Promise<Bug列表及分页信息>
      */
     async getProductBugs(productId, page, limit, status, branch, order, fields) {
@@ -327,7 +327,7 @@ export class ZentaoAPI {
             const finalPage = page || 1;
             const finalBranch = branch || 'all';
             const finalOrder = order || 'id_desc';
-            const finalFields = fields || 'default';
+            const finalFields = fields || 'basic';
             console.log(`正在获取产品 ${productId} 的Bug列表 (status=${status || 'all'}, branch=${finalBranch}, page=${finalPage}, limit=${finalLimit}, order=${finalOrder}, fields=${finalFields})...`);
             // 构建查询参数
             const queryParams = new URLSearchParams();

package/dist/index-dev.js

@@ -828,27 +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)
-            }]
-    };
-});
 // 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,27 +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)
-            }]
-    };
-});
 // 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,27 +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)
-            }]
-    };
-});
 // 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

@@ -117,7 +117,7 @@ server.tool("getMyBugs", "获取Bug列表 - 支持多种状态筛选（指派给
     limit: z.number().optional().describe("每页数量，默认20，最大100"),
     branch: z.string().optional().describe("分支筛选：'all'(所有分支,默认)、'0'(主干分支)、分支ID"),
     order: z.string().optional().describe("排序方式，如 id_desc(ID降序), pri_desc(优先级降序), openedDate_desc(创建时间降序)等，默认id_desc"),
-    fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段)、'default'(默认字段,推荐)、'full'(完整字段)，默认'default'")
+    fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段,默认)、'default'(默认字段)、'full'(完整字段)，默认'basic'")
 }, async ({ status, productId, page, limit, branch, order, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
@@ -166,7 +166,7 @@ server.tool("getProductBugs", "获取指定产品的Bug列表 - 支持多种状
     ]).optional().describe("Bug状态筛选，默认返回所有状态"),
     branch: z.string().optional().describe("分支筛选：'all'(所有分支,默认)、'0'(主干分支)、分支ID"),
     order: z.string().optional().describe("排序方式，如 id_desc(ID降序), pri_desc(优先级降序), openedDate_desc(创建时间降序)等，默认id_desc"),
-    fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段)、'default'(默认字段,推荐)、'full'(完整字段)，默认'default'")
+    fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段,默认)、'default'(默认字段)、'full'(完整字段)，默认'basic'")
 }, async ({ productId, page, limit, status, branch, order, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
@@ -1622,28 +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)
-            }]
-    };
-});
 // 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', 'addStoryComment'
+        'updateComment', 'deleteComment'
     ],
     // 模块和文件（所有角色）
     utility: [

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.17.5",
+    "version": "1.17.7",
     "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', 'addStoryComment'],
+    comment: ['getComments', 'getCommentDetail', 'addComment', 'updateComment', 'deleteComment'],
     utility: ['getModules', 'uploadFile', 'uploadImageFromClipboard', 'downloadFile'],
     user: ['getUsers', 'getUserDetail', 'getMyProfile', 'createUser', 'updateUser', 'deleteUser']
 };