@zzp123/mcp-zentao 1.15.0 → 1.17.0

package/CHANGELOG.md

@@ -5,6 +5,61 @@ 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.0] - 2025-11-10
+
+### Added
+- **角色专用版本** 🎭
+  - 新增三个角色专用的精简版本，大幅减少上下文占用
+  - `zentao-pm`: 产品经理版本（54个工具，文件减小32%）
+  - `zentao-qa`: 测试工程师版本（38个工具，文件减小45%）
+  - `zentao-dev`: 开发工程师版本（46个工具，文件减小44%）
+  - `zentao`: 完整版本（94个工具，所有功能）
+
+### Changed
+- **优化上下文使用** 📊
+  - 每个角色版本只包含相关工具，显著降低 LLM 上下文消耗
+  - 产品经理版本：需求、产品、计划、反馈等管理工具
+  - 测试工程师版本：Bug、测试用例、构建版本等测试工具
+  - 开发工程师版本：任务、项目、执行、Bug解决等开发工具
+
+### Technical
+- 新增角色版本源文件：`src/index-pm.ts`, `src/index-qa.ts`, `src/index-dev.ts`
+- 新增角色配置模块：`src/roleConfig.ts`
+- 新增生成脚本：`generate-role-versions.cjs`
+- 更新 package.json 支持多个 bin 入口点
+
+### Documentation
+- 新增角色分类文档：`ROLES.md`
+- 新增角色配置指南：`ROLE_GUIDE.md`
+
+## [1.16.0] - 2025-11-07
+
+### Fixed
+- **修复评论功能 - 使用正确的 REST API v1 接口** 🔧
+  - 之前版本使用的是 HTML 接口，现已改用标准 REST API
+  - 修复了评论创建、更新、删除等功能
+
+### Added
+- **完整的评论管理工具** 💬
+  - `getComments`: 获取指定对象的评论列表
+  - `getCommentDetail`: 获取单条评论详情
+  - `addComment`: 创建评论（支持11种对象类型）
+  - `updateComment`: 更新评论内容
+  - `deleteComment`: 删除评论
+  - 便捷工具：`addStoryComment`、`addTaskComment`、`addBugComment`
+
+### Changed
+- **更新评论接口实现**
+  - 使用标准 REST API：`POST /comment`、`GET /comments/{type}/{id}`
+  - 支持更多对象类型：新增 execution、project 类型
+  - 返回完整的评论对象信息（包含 id、actor、date 等）
+
+### Technical
+- 更新 `Comment` 接口定义
+- 添加 `UpdateCommentRequest` 接口
+- 添加 `CommentListResponse` 接口
+- 所有评论方法使用统一的 `request()` 方法，保持 Token 认证
+
 ## [1.15.0] - 2025-11-07
 
 ### Added

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://badge.fury.io/js/%40zzp123%2Fmcp-zentao.svg)](https://www.npmjs.com/package/@zzp123/mcp-zentao)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展。
+禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展。**支持产品经理、测试工程师、开发工程师三种角色的精简版本，大幅减少上下文占用。**
 
 ## 📦 安装
 
@@ -11,21 +11,92 @@
 npm install @zzp123/mcp-zentao -g
 ```
 
+## 🎭 角色版本选择
+
+从 v1.17.0 开始，提供了三个角色专用的精简版本，每个版本只包含对应角色常用的工具，**可显著减少 LLM 上下文占用 30-45%**：
+
+| 版本 | 命令 | 工具数量 | 文件大小 | 适用角色 |
+|------|------|---------|---------|---------|
+| **完整版** | `zentao` | 94个 | 69 KB | 需要使用全部功能 |
+| **产品经理版** | `zentao-pm` | 54个 | 47 KB (-32%) | 需求、产品、计划管理 |
+| **测试工程师版** | `zentao-qa` | 38个 | 38 KB (-45%) | Bug、测试用例、构建 |
+| **开发工程师版** | `zentao-dev` | 46个 | 39 KB (-44%) | 任务、项目、Bug解决 |
+
+### 如何选择版本？
+
+在 Claude Desktop 配置文件中，将 `command` 字段改为对应的命令即可：
+
+```json
+{
+  "mcpServers": {
+    "zentao-pm": {
+      "command": "zentao-pm",
+      "args": []
+    }
+  }
+}
+```
+
+### 各版本包含的功能
+
+<details>
+<summary><b>产品经理版 (zentao-pm)</b> - 点击展开</summary>
+
+- ✅ 初始化配置
+- ✅ 需求管理（创建、查看、修改、删除）
+- ✅ 产品管理
+- ✅ 计划管理
+- ✅ 项目集管理
+- ✅ 反馈管理
+- ✅ Bug查看（只读）
+- ✅ 任务查看（只读）
+- ✅ 评论功能
+- ✅ 工单管理
+- ✅ 文件上传
+</details>
+
+<details>
+<summary><b>测试工程师版 (zentao-qa)</b> - 点击展开</summary>
+
+- ✅ 初始化配置
+- ✅ Bug管理（创建、查看、修改、解决、删除）
+- ✅ 测试用例管理
+- ✅ 构建版本管理
+- ✅ 需求查看（只读）
+- ✅ 任务查看（只读）
+- ✅ 评论功能
+- ✅ 工单管理
+- ✅ 文件上传
+</details>
+
+<details>
+<summary><b>开发工程师版 (zentao-dev)</b> - 点击展开</summary>
+
+- ✅ 初始化配置
+- ✅ 任务管理（创建、查看、更新、完成、删除）
+- ✅ Bug解决（查看、解决、评论）
+- ✅ 项目管理
+- ✅ 执行管理
+- ✅ 构建版本管理
+- ✅ 需求查看（只读）
+- ✅ 评论功能
+- ✅ 工单管理
+- ✅ 文件上传
+</details>
+
 ## 📋 版本历史
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)
 
-**最新版本**: v1.9.0
-- ✅ 修复 getMyBugs 工具的过滤逻辑问题
-- ✅ 改为客户端过滤，正确获取当前用户的bug
-- ✅ 支持 assignedTo 的对象和字符串两种格式
+**最新版本**: v1.17.0 - 2025-11-10
+- 🎭 新增三个角色专用版本（PM/QA/Dev）
+- 📊 大幅减少上下文占用（30-45%）
+- 🚀 提升 LLM 响应速度和准确性
 
 **近期版本**:
-- v1.8.9 - 修复 resolveBug 工具自动设置默认 resolvedBuild
-- v1.8.8 - 修复 getMyBugs 工具返回Bug数量为0的问题
-- v1.6.1 - 修复 Windows 剪贴板图片读取问题
-- v1.4.0 - 新增解决Bug接口
-- v1.3.0 - 添加命令行脚本支持
+- v1.16.0 - 修复评论功能，使用正确的 REST API v1 接口
+- v1.15.0 - 新增完整的评论管理工具
+- v1.9.0 - 修复 getMyBugs 工具的过滤逻辑问题
 
 ## 使用方法
 

package/dist/api/zentaoApi.d.ts

@@ -1,4 +1,4 @@
-import { AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, ModulesResponse, ModuleType, Plan, Product, Program, Project, Release, ResolveBugRequest, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, ChangeStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
+import { AddCommentRequest, AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, Comment, CommentObjectType, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, ModulesResponse, ModuleType, Plan, Product, Program, Project, Release, ResolveBugRequest, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateCommentRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, ChangeStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
 export declare class ZentaoAPI {
     private config;
     private client;
@@ -239,6 +239,32 @@ 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>;
+    /**
+     * 获取评论列表
+     * GET /comments/{objectType}/{objectID}
+     */
+    getComments(objectType: CommentObjectType, objectID: number): Promise<Comment[]>;
+    /**
+     * 获取单条评论详情
+     * GET /comment/{id}
+     */
+    getCommentDetail(commentId: number): Promise<Comment>;
+    /**
+     * 创建评论
+     * POST /comment
+     */
+    addComment(request: AddCommentRequest): Promise<Comment>;
+    /**
+     * 更新评论
+     * PUT /comment/{id}
+     */
+    updateComment(commentId: number, update: UpdateCommentRequest): Promise<Comment>;
+    /**
+     * 删除评论
+     * DELETE /comment/{id}
+     */
+    deleteComment(commentId: number): Promise<{
+        message: string;
+    }>;
     getConfig(): ZentaoConfig;
 }

package/dist/api/zentaoApi.js

@@ -1534,63 +1534,87 @@ export class ZentaoAPI {
             throw error;
         }
     }
-    // 评论模块 - 使用 HTML 接口
-    async addComment(objectType, objectID, comment) {
+    // 评论模块 - 使用 REST API v1 接口
+    /**
+     * 获取评论列表
+     * GET /comments/{objectType}/{objectID}
+     */
+    async getComments(objectType, objectID) {
         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: '评论添加成功'
-            };
+            console.log(`正在获取 ${objectType} ${objectID} 的评论列表...`);
+            const response = await this.request('GET', `/comments/${objectType}/${objectID}`);
+            console.log('获取评论列表响应:', response);
+            return response;
+        }
+        catch (error) {
+            console.error('获取评论列表失败:', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取单条评论详情
+     * GET /comment/{id}
+     */
+    async getCommentDetail(commentId) {
+        try {
+            console.log(`正在获取评论 ${commentId} 的详情...`);
+            const response = await this.request('GET', `/comment/${commentId}`);
+            console.log('获取评论详情响应:', response);
+            return response;
+        }
+        catch (error) {
+            console.error('获取评论详情失败:', error);
+            throw error;
+        }
+    }
+    /**
+     * 创建评论
+     * POST /comment
+     */
+    async addComment(request) {
+        try {
+            console.log(`正在为 ${request.objectType} ${request.objectID} 添加评论...`);
+            const response = await this.request('POST', '/comment', undefined, request);
+            console.log('添加评论响应:', response);
+            return response;
         }
         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;
         }
     }
+    /**
+     * 更新评论
+     * PUT /comment/{id}
+     */
+    async updateComment(commentId, update) {
+        try {
+            console.log(`正在更新评论 ${commentId}...`);
+            const response = await this.request('PUT', `/comment/${commentId}`, undefined, update);
+            console.log('更新评论响应:', response);
+            return response;
+        }
+        catch (error) {
+            console.error('更新评论失败:', error);
+            throw error;
+        }
+    }
+    /**
+     * 删除评论
+     * DELETE /comment/{id}
+     */
+    async deleteComment(commentId) {
+        try {
+            console.log(`正在删除评论 ${commentId}...`);
+            const response = await this.request('DELETE', `/comment/${commentId}`);
+            console.log('删除评论响应:', response);
+            return response;
+        }
+        catch (error) {
+            console.error('删除评论失败:', error);
+            throw error;
+        }
+    }
     // 获取配置信息（用于生成图片 URL）
     getConfig() {
         return this.config;

package/dist/index-dev.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { ZentaoConfig } from './config.js';
+interface UserParams {
+    config?: ZentaoConfig;
+    name: string;
+    age: number;
+    skills: string[];
+}
+export default function main(params: UserParams): Promise<void>;
+export {};