@zzp123/mcp-zentao 1.16.0 → 1.17.0

package/CHANGELOG.md

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

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/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 {};