@zzp123/mcp-zentao 1.18.9 → 1.18.10

package/CHANGELOG.md

@@ -1,1018 +1,1018 @@
-# Changelog
-
-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.18.7] - 2025-01-17
-
-### Fixed
-- **修复配置读取失败日志导致 MCP 启动失败** 🔧
-  - 删除 `config.ts` 中的 stderr 错误输出
-  - 配置文件读取失败时静默返回 null，不输出任何日志
-  - 配置不存在是正常情况（首次使用），不应该有错误输出
-  - 避免 stderr 输出干扰 MCP 服务器启动
-
-### Changed
-- `loadConfig()` 函数现在完全静默，失败时只返回 null
-- 错误处理完全由调用方（initZentao 工具）负责
-
-### Impact
-- ✅ MCP 服务器启动更稳定
-- ✅ 首次使用时不会有错误提示
-- ✅ 完全符合 MCP stdio 协议（stderr 只用于致命错误）
-
-## [1.18.6] - 2025-01-17
-
-### Fixed
-- **彻底清除所有 console 输出** 🔧
-  - 修复 `json-args.js` 中残留的 3 处 `console.error`
-  - 将所有错误输出改为 `process.stderr.write`
-  - 确保发布到 npm 的所有文件都不使用 console
-
-### Changed
-- `json-args.js` 错误处理统一使用 stderr 输出
-- 错误消息格式统一为 `[ERROR]` 前缀
-
-### Verification
-- ✅ Source files (src/): 0 console statements
-- ✅ Compiled files (dist/): 0 console statements
-- ✅ Helper scripts (json-args.js): 0 console statements
-- ✅ 100% console-free package
-
-## [1.18.5] - 2025-01-17
-
-### Fixed
-- **修复角色版本命令缺失问题** 🔧
-  - 添加 `zentao`、`zentao-pm`、`zentao-qa`、`zentao-dev` 四个命令入口
-  - 之前版本只有 `mcp-zentao` 一个命令，导致角色版本无法使用
-  - 现在用户可以根据需要选择不同角色的命令
-
-### Changed
-- 更新 package.json 的 bin 配置，支持所有角色版本命令
-- `zentao` - 完整版（91个工具）
-- `zentao-pm` - 产品经理版（39个工具）
-- `zentao-qa` - 测试工程师版（26个工具）
-- `zentao-dev` - 开发工程师版（38个工具）
-
-### Technical
-- 将 bin 从单一入口改为多入口配置
-- 所有角色版本的编译文件都已包含在发布包中
-
-### Migration
-```bash
-# 现在可以使用不同的命令
-zentao           # 完整版
-zentao-pm        # 产品经理版
-zentao-qa        # 测试工程师版
-zentao-dev       # 开发工程师版
-```
-
-## [1.18.4] - 2025-01-17
-
-### Fixed
-- **修复 MCP stdio 协议污染问题** 🔧
-  - 删除所有 `console.log` / `console.error` / `console.warn` 语句（240+ 处）
-  - MCP stdio 服务器的 stdout 仅用于 JSON-RPC 通信，任何日志输出都会破坏协议
-  - 保留 2 处关键错误输出到 stderr（配置加载失败、MCP 启动失败）
-  - 错误处理通过 `throw Error` 自动传递给 MCP 客户端
-
-### Changed
-- 所有调试日志已移除，不再污染 stdout
-- MCP 服务器启动失败时输出到 stderr 并正确退出
-- 配置文件加载失败时输出到 stderr
-
-### Impact
-- **协议兼容性**: 完全符合 MCP stdio 协议规范
-- **稳定性**: 避免因日志输出导致的协议解析失败
-- **性能**: 减少 I/O 开销，提升响应速度
-- **代码量**: 删除约 240 行日志代码
-
-### Technical
-- 清理 `src/api/zentaoApi.ts` 中的 176 处日志
-- 清理 `src/index.ts` 中的 91 处日志
-- 清理 `src/index-dev.ts` 中的 38 处日志
-- 清理 `src/index-pm.ts` 中的 39 处日志
-- 清理 `src/index-qa.ts` 中的 26 处日志
-- 优化 `src/config.ts` 的错误输出到 stderr
-- 保留关键启动错误处理，输出格式：`[FATAL]` / `[ERROR]`
-
-### Migration
-- 无需用户操作，升级后自动生效
-- 错误信息会通过 MCP 客户端（Claude Desktop）正确显示
-- 开发调试推荐使用官方 MCP Inspector 工具
-
-## [1.18.3] - 2025-01-12
-
-### Fixed
-- **修复MCP协议兼容性问题** 🔧
-  - 修复 `changeStory` 和 `changeRequirement` 工具的参数类型错误
-  - 移除 `z.union([z.object({...}), z.string()])` 改为纯对象类型
-  - 解决 "Expected object, received string" 错误
-  - 同时修复完整版和产品经理版本
-
-### Technical
-- 更新 `src/index.ts` 中的 `changeStory` 和 `changeRequirement` 工具定义
-- 更新 `src/index-pm.ts` 中的 `changeStory` 工具定义
-- 符合MCP协议规范，所有参数必须是对象类型
-
-## [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
-- **产品经理版再次优化** 📊
-  - 从产品经理版 (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
-- **测试工程师版优化** 🧪
-  - 从测试工程师版 (mcp-zentao-qa) 移除构建版本管理工具（4个工具）和工单管理工具（5个工具）
-  - 工具数量从 38 个减少到 29 个
-  - 包大小从 38 KB 减少到约 27 KB
-  - 更专注于Bug跟踪和测试用例管理核心功能
-
-### Technical
-- 更新 `roleConfig.ts` 中的 qa 角色配置
-- 重新生成测试工程师版源文件 (`src/index-qa.ts`)
-
-## [1.17.2] - 2025-11-10
-
-### Changed
-- **产品经理版优化** 📊
-  - 从产品经理版 (mcp-zentao-pm) 移除反馈管理工具（7个工具）
-  - 工具数量从 54 个减少到 47 个
-  - 包大小从 25 KB 减少到约 22 KB
-  - 更专注于产品规划和需求管理核心功能
-
-### Technical
-- 更新 `roleConfig.ts` 中的 pm 角色配置
-- 重新生成产品经理版源文件 (`src/index-pm.ts`)
-
-## [1.17.1] - 2025-11-10
-
-### Changed
-- **开发工程师版优化** 🔧
-  - 从开发工程师版 (mcp-zentao-dev) 移除工单管理工具（5个工具）
-  - 工具数量从 46 个减少到 41 个
-  - 包大小从 24 KB 减少到约 22 KB
-  - 更专注于核心开发工作流
-
-### Technical
-- 更新 `roleConfig.ts` 中的 dev 角色配置
-- 重新生成开发工程师版源文件 (`src/index-dev.ts`)
-
-## [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
-- **评论功能完整支持** 💬
-  - 新增 `addComment` 通用评论工具，支持9种对象类型
-  - 新增专用评论工具：
-    - `addStoryComment`: 为需求添加评论（自动识别story/requirement）
-    - `addTaskComment`: 为任务添加评论
-    - `addBugComment`: 为Bug添加评论
-  - 支持的对象类型：
-    - story（软件需求）
-    - requirement（用户需求）
-    - task（任务）
-    - bug（Bug）
-    - testcase（测试用例）
-    - testtask（测试单）
-    - todo（待办）
-    - doc（文档）
-    - doctemplate（文档模板）
-
-### Changed
-- **评论内容格式**
-  - 支持纯文本评论
-  - 支持HTML格式的富文本评论
-  - 自动处理评论提交的响应格式
-
-### Technical
-- 添加 `CommentObjectType` 类型定义
-- 添加 `AddCommentRequest` 和 `CommentResponse` 接口
-- 实现混合接口调用（使用HTML接口但保持REST API认证）
-
-## [1.14.0] - 2025-11-07
-
-### Added
-- **完整的用户需求(Requirement)支持** 🎯
-  - 扩展 Story API，统一支持软件需求(story)和用户需求(requirement)
-  - 所有现有 story 工具现已支持两种需求类型，自动识别
-  - 新增4个专用的 requirement 工具：
-    - `createRequirement`: 创建用户需求
-    - `getRequirementDetail`: 获取用户需求详情
-    - `changeRequirement`: 修改用户需求
-    - `deleteRequirement`: 删除用户需求
-  - `createStory` 工具新增 `type` 参数，可选择创建 story 或 requirement
-
-### Changed
-- **更新现有需求工具描述**
-  - `getStoryDetail`: 现支持 story 和 requirement 两种类型，自动识别
-  - `changeStory`: 现支持 story 和 requirement 两种类型，自动识别
-  - `deleteStory`: 现支持 story 和 requirement 两种类型，自动识别
-  - `getProductStories`: 返回的列表可能包含两种类型的需求
-
-### Improved
-- **更好的语义化**
-  - 专用的 requirement 工具提供更清晰的意图表达
-  - 统一接口底层实现，减少代码重复
-  - 符合禅道 API v2.0 的最新扩展
-
-## [1.13.0] - 2025-11-07
-
-### Added
-- **产品和需求列表字段过滤功能** 📦
-  - 为 `getProducts` 添加 `fields` 参数支持
-  - 为 `getProductStories` 添加 `fields` 参数支持
-  - 支持三种字段级别：
-    - `basic`: 基本信息（产品：id, name, code, status；需求：id, title, assignedTo, openedBy）
-    - `default`: 默认信息（产品：包含 PO/QD/RD 等；需求：包含 status/stage/pri 等，**默认使用**）
-    - `full`: 完整信息（所有字段）
-
-### Changed
-- **优化列表接口默认返回数据**
-  - 产品列表默认使用 `default` 字段级别，返回核心管理信息
-  - 需求列表默认使用 `basic` 字段级别，只返回最基本的4个字段
-  - 显著减少数据传输量，提升列表查询响应速度
-
-### Improved
-- **性能优化**
-  - 列表接口数据量大幅减少，特别适合快速浏览和搜索场景
-  - 减少不必要的字段传输，降低网络开销
-  - 需要详细信息时可按需设置 `fields='full'`
-
-## [1.12.0] - 2025-11-07
-
-### Added
-- **字段级别过滤功能** 📦
-  - 为 `getMyBugs` 和 `getProductBugs` 添加 `fields` 参数
-  - 支持三种字段级别：
-    - `basic`: 基本信息（8个核心字段：id, title, status, pri, severity, assignedTo, openedBy, openedDate）
-    - `default`: 默认信息（18个常用字段，适合列表展示，**默认使用**）
-    - `full`: 完整信息（所有字段）
-  - 显著减少数据传输量，提升响应速度
-
-### Changed
-- **优化默认返回数据**
-  - 默认使用 `default` 字段级别，只返回列表展示所需的字段
-  - 保持默认每页 20 条记录不变
-  - 需要完整信息时可设置 `fields='full'`
-
-### Improved
-- **性能优化**
-  - 使用 default 模式减少约 60% 的数据传输量
-  - 使用 basic 模式减少约 80% 的数据传输量
-  - 更快的响应速度和更低的网络开销
-  - 更适合移动端和弱网络环境使用
-
-## [1.11.1] - 2025-11-07
-
-### Fixed
-- **修复依赖冲突问题** 🔧
-  - 移除 package.json 中的自引用依赖 `@zzp123/mcp-zentao@1.2.1`
-  - 解决了 MCP 工具仍然使用旧版本参数（`onlyAssignedToMe`）的问题
-  - 确保用户安装后立即使用最新的 API 定义
-
-### Important
-- 如果你从旧版本升级，请重启你的 MCP 服务器或 Claude Desktop 以加载新的工具定义
-
-## [1.11.0] - 2025-11-07
-
-### Added
-- **完整的 Bug 状态筛选支持** ✨
-  - 扩展 `BugStatus` 类型，新增 16 种状态筛选类型
-  - 支持所有禅道官方 API 的状态筛选：assigntome、openedbyme、resolvedbyme、assignedbyme、assigntonull、unconfirmed、unclosed、unresolved、toclosed、postponedbugs、longlifebugs、overduebugs、review、feedback、needconfirm、bysearch
-  - MCP 工具现在提供完整的 20 种状态选项供选择
-
-- **分支筛选功能** 🌿
-  - 为 `getMyBugs` 和 `getProductBugs` 添加 `branch` 参数
-  - 支持 'all'(所有分支)、'0'(主干分支)、分支ID
-  - 默认值为 'all'，符合禅道官方 API 规范
-
-### Changed
-- **重构 Bug 列表 API 参数** 🔄
-  - 移除 `onlyAssignedToMe` 参数，改用更灵活的 `status='assigntome'`
-  - 调整参数顺序：`status, productId, page, limit, branch, order`
-  - 优化参数构建逻辑，确保与禅道官方 API 完全一致
-
-### Improved
-- **API 文档完善**
-  - 为 `getMyBugs` 和 `getProductBugs` 添加详细的 JSDoc 注释
-  - 更新工具描述，明确说明支持的状态筛选类型
-  - 参数说明更加清晰，包含默认值和示例
-
-- **更好的用户体验**
-  - MCP 工具提供完整的状态枚举，IDE 可以自动补全
-  - 所有状态选项都有中文注释说明
-  - 更符合禅道用户的使用习惯
-
-### Technical
-- 完全符合禅道官方 Bug 列表 API 文档规范
-- 支持所有官方 API 参数：branch、status、order、limit、page
-- 默认值与官方 API 保持一致
-
-## [1.10.0] - 2025-11-07
-
-### Fixed
-- **修复 Bug 获取工具的 API 端点和参数问题** 🔧
-  - 从错误的 `/bugs` 端点改为正确的 `/products/{productId}/bugs` 端点
-  - 移除了低效的客户端过滤逻辑，改用服务器端原生支持的 `assigntome` 状态
-  - 修复了 `onlyAssignedToMe` 参数无法正确工作的问题
-
-### Added
-- **添加排序参数支持** ✨
-  - 为 `getMyBugs` 和 `getProductBugs` 工具添加 `order` 参数
-  - 支持多种排序方式：`id_desc`(ID降序)、`id_asc`(ID升序)、`pri_desc`(优先级降序)等
-  - 默认使用 `id_desc` 排序，确保最新的 Bug 显示在前面
-  - 与禅道官方 API 完全一致的参数格式
-
-### Improved
-- **性能优化**
-  - 使用服务器端过滤替代客户端过滤，显著提升查询效率
-  - 减少不必要的数据传输，降低网络开销
-  - 更准确的分页信息和总数统计
-
-### Changed
-- 更新了 `getMyBugs` 方法签名，添加 `order` 参数
-- 更新了 `getProductBugs` 方法签名，添加 `order` 参数
-- 优化了查询参数的构建方式，使用 URLSearchParams 确保参数正确编码
-
-## [1.9.0] - 2025-11-06
-
-### Fixed
-- **修复 getMyBugs 工具过滤逻辑问题** 🔧
-  - 禅道API的 `/bugs` 接口不支持 `assignedTo` 参数进行服务端过滤
-  - 改为使用客户端过滤：获取更多数据后在本地筛选分配给当前用户的Bug
-  - 修复了使用 `onlyAssignedToMe=true` 时无法正确获取当前用户Bug的问题
-  - 现在能够正确识别 `assignedTo` 字段（支持对象和字符串两种格式）
-
-### Improved
-- 优化了 `getMyBugs` 的性能：当需要过滤时自动获取100条数据以确保有足够的结果
-- 增加了详细的过滤日志输出，便于调试和追踪
-
-### Changed
-- 扩展了 `Bug` 类型定义，添加了 `assignedTo`、`openedBy`、`resolvedBy` 等字段
-- 更新了文档，说明了禅道API的限制和客户端过滤的实现方式
-
-## [1.8.9] - 2025-11-06
-
-### Fixed
-- **修复 resolveBug 工具必须提供 resolvedBuild 参数的问题**
-  - 当 resolution 为 "fixed" 时，如果未提供 resolvedBuild，自动设置为 "trunk"（主干版本）
-  - 消除了使用 resolveBug 工具时的常见错误："当解决方案为"已解决(fixed)"时，必须提供解决版本(resolvedBuild)"
-  - 简化了解决Bug的操作流程，提升用户体验
-
-### Improved
-- 添加了自动默认值设置的日志输出，便于调试和追踪
-
-## [1.8.8] - 2025-11-06
-
-### Fixed
-- **修复 getMyBugs 工具返回Bug数量为0的问题**
-  - 移除了硬编码的 `assignedTo` 过滤条件
-  - 默认获取所有Bug，不再只获取分配给当前用户的Bug
-  - 添加 `onlyAssignedToMe` 参数，让用户可以选择是否只获取分配给自己的Bug
-
-### Changed
-- **优化默认产品选择逻辑**
-  - 当未指定 productId 时，默认使用第二个产品（如果存在）
-  - 如果只有一个产品，则使用第一个产品
-
-### Improved
-- 为 getMyBugs 工具添加更清晰的描述："获取Bug列表 - 默认获取所有Bug，可选择只获取分配给我的Bug"
-- 增强了工具的灵活性，满足不同使用场景
-
-## [1.8.7] - 2025-11-06
-
-### Fixed
-- **修复 uploadImageFromClipboard 工具的图片URL生成问题**
-  - 修正图片访问URL格式：从复杂的API参数格式改为简洁的 `/file-read-{id}.png` 格式
-  - 确保上传后的图片能够正确显示和访问
-  - URL示例：`http://47.120.4.95:7137/zentao/file-read-3750.png`
-
-### Technical
-- 简化图片URL生成逻辑
-- 提高图片访问的兼容性和可靠性
-
-## [1.8.6] - 2025-11-06
-
-### Fixed
-- **修复 uploadImageFromClipboard 工具路径依赖问题**
-  - 将 PowerShell 脚本内嵌到代码中，不再依赖外部文件
-  - 解决了 Claude Code 工作目录与包安装目录不匹配的问题
-  - 使用 Base64 编码避免转义问题
-
-### Improved
-- **优化 uploadImageFromClipboard 工具的用户体验**
-  - 默认行为：直接从剪贴板获取图片并上传到禅道
-  - 简化了操作流程，用户只需说"上传图片"即可
-  - 移除了对外部脚本文件的依赖，提高了可靠性
-
-### Technical
-- 脚本完全内嵌，提高可移植性
-- 不再依赖 process.cwd() 路径解析
-- 更健壮的错误处理机制
-
-## [1.8.5] - 2025-11-06
-
-### Improved
-- **优化 changeStory 工具参数说明**
-  - 为 `reviewer` 字段添加详细描述：说明其通常为必填字段，除非设置 `needNotReview=true` 跳过评审
-  - 为 `needNotReview` 字段添加说明：如果不提供 `reviewer` 则应设置为 `true`
-  - 为 `storyId` 参数添加描述，提升工具可读性
-  - 为工具本身添加整体说明："需求变更 - 支持对象或JSON字符串格式"
-
-### Technical
-- 改进 MCP 工具的参数描述，帮助 AI 助手更好地理解参数使用规则
-- 提升工具在 Claude Code 等 AI IDE 中的可用性
-
-## [1.8.0] - 2025-11-06
-
-### Changed
-- **重构需求变更接口命名**
-  - 将 `updateStory` 工具重命名为 `changeStory`，更准确地反映其功能
-  - 将 `UpdateStoryRequest` 类型重命名为 `ChangeStoryRequest`
-  - 将 `updateStory` API方法重命名为 `changeStory`
-  - 使用功能完整的"修改需求其他字段"接口替代功能有限的"变更需求"接口
-
-### Added
-- 向后兼容的类型别名：`UpdateStoryRequest` 作为 `ChangeStoryRequest` 的别名
-
-### Technical
-- 统一需求变更相关的命名规范
-- 保持向后兼容性，旧的类型名称仍然可用
-- 所有测试通过，确保重构不影响现有功能
-
-## [1.7.4] - 2025-11-06
-
-### Fixed
-- **修复 createTask 和 updateStory 中的评审人相关错误**
-  - 修复 `createTask` 工具中 `assignedTo` 参数类型错误（从字符串改为数组）
-  - 修复 `createTask` 工具中必填参数缺失问题（execution, type, estStarted, deadline）
-  - 修复 `updateStory` 工具中"评审人不能为null"错误
-  - 为 `updateStory` 添加自动跳过评审机制（needNotReview=true）
-
-### Changed
-- `CreateTaskRequest` 接口更新：将 assignedTo 从可选字符串改为必需数组
-- `createTask` MCP 工具参数重新定义：必填参数前置，类型修正
-- `updateStory` API 方法添加智能评审人处理逻辑
-- API 请求表单数据处理：支持数组类型参数的正确格式化
-
-### Technical
-- 更新测试文件以适配新的接口要求
-- TypeScript 编译验证通过，确保类型安全
-- 保持向后兼容性，同时修复API规范问题
-
-## [1.7.3] - 2025-11-06
-
-### Fixed
-- **updateStory 工具参数格式优化**
-  - 修复 `update` 参数只能接受对象格式的问题
-  - 现在同时支持对象格式和 JSON 字符串格式
-  - 自动解析 JSON 字符串并提供友好的错误提示
-
-### Changed
-- `update` 参数使用 `z.union()` 同时接受对象和字符串格式
-- 添加 JSON 字符串解析逻辑，提升工具兼容性
-
-## [1.7.2] - 2025-11-06
-
-### Added
-- **updateStory 工具重大增强**
-  - 新增29个可编辑字段支持，��全对接禅道最新API文档
-  - 支持需求基本信息编辑：title, product, parent, module, branch, plan, type
-  - 支持来源信息编辑：source, sourceNote（支持8种来源类型）
-  - 支持分类与优先级：category, pri, estimate
-  - 支持状态与阶段：stage, status
-  - 支持关键词与标识：keywords, color, grade
-  - 支持人员相关：mailto, reviewer, assignedTo, closedBy, feedbackBy
-  - 支持关闭相关：closedReason, duplicateStory（7种关闭原因）
-  - 支持评审相关：needNotReview
-  - 支持通知相关：notifyEmail
-  - 支持描述内容：spec, verify（HTML格式）
-  - 支持备注：comment
-
-### Changed
-- `UpdateStoryRequest` 接口完全重构，从7个字段扩展到29个字段
-- `updateStory` MCP 工具参数完全重新定义，支持所有新字段
-- 添加了详细的字段注释和类型定义，提升开发体验
-
-### Technical
-- 所有字段均为可选参数，支持部分更新
-- `plan` 字段支持单个ID或数组格式
-- `closedReason` 使用枚举类型确保数据正确性
-- `mailto` 和 `reviewer` 字段支持数组格式
-
-### Benefits
-- **功能完整性**：支持禅道需求管理的所有常用编辑功能
-- **灵活性**：可以批量更新多个字段，也可以单独更新单个字段
-- **类型安全**：完整的 TypeScript 类型定义，减少运行时错误
-
-## [1.7.1] - 2025-11-06
-
-### Fixed
-- **图片 HTML 格式优化**
-  - `uploadFile` 和 `uploadImageFromClipboard` 工具现在生成的 `imageHtml` 会被 `<p>` 标签包裹
-  - 修复了某些情况下图片在禅道中无法正确显示的问题
-  - 确保生成的 HTML 格式与禅道富文本编辑器的标准格式一致
-
-### Changed
-- 图片 HTML 格式从 `<img ... />` 改为 `<p><img ... /></p>`
-- 更新使用提示，明确说明图片会被包裹在 `<p>` 标签中
-
-## [1.7.0] - 2025-11-06
-
-### Added
-- **图片上传自动生成 HTML 格式**
-  - `uploadFile` 工具现在返回 `imageHtml` 字段，包含禅道所需的完整 HTML 代码
-  - `uploadImageFromClipboard` 工具同样返回 `imageHtml` 字段
-  - 新增 `imageUrl` 字段，提供完整的图片访问地址
-  - 新增 `fileId` 字段，方便后续引用
-  - 新增使用提示 `tip` 字段，帮助用户正确使用
-
-### Changed
-- ZentaoAPI 类新增 `getConfig()` 方法，允许获取配置信息以生成图片 URL
-- 图片上传返回格式优化，Claude Code 现在能自动识别并使用正确的 HTML 格式
-
-### Technical
-- 图片 HTML 格式：`<img onload="setImageSize(this,0)" src="..." alt="..." />`
-- 自动包含 `onload="setImageSize(this,0)"` 以确保图片在禅道中正确显示
-
-### Benefits
-- **提升用户体验**：Claude Code 无需手动构造 HTML 代码
-- **减少错误**：避免手动拼接 HTML 时的格式错误
-- **更直观**：返回结果中直接包含可用的 HTML 代码
-
-## [1.6.1] - 2025-11-05
-
-### Fixed
-- **修复 Windows 剪贴板图片读取问题**
-  - 替换为新的 PowerShell 脚本 `scripts/get_clipboard.ps1`
-  - 使用 `Add-Type` 加载 `System.Drawing` 程序集，确保正确处理图片
-  - 改进错误处理，提供更详细的错误信息
-  - 使用 `-ExecutionPolicy Bypass` 确保脚本可以执行
-
-### Changed
-- Windows 平台现在使用外部 PowerShell 脚本文件而非内联脚本
-- 优化了 base64 转换流程，确保内存流正确关闭
-
-## [1.6.0] - 2025-11-05
-
-### Changed - 重大更新
-- **迁移到自定义模块接口** `/custom/modules` - 替代原生 `/modules` 接口
-  - 接口路径：`GET /custom/modules`（原 `/modules`）
-  - 支持字段过滤功能：通过 `fields` 参数指定返回字段
-  - 默认返回精简字段：id、name、parent、grade、type
-  - 可选字段：id、root、branch、name、parent、path、grade、order、type、owner、collector、short
-
-### Added
-- 新增 `fields` 参数支持，可大幅减少返回数据量（60-80%）
-- 新增 `ModulesResponse` 接口：`{ modules: SimpleModule[], total: number }`
-- 更新 `SimpleModule` 接口，支持更多可选字段
-
-### Technical
-- 返回数据结构变化：从嵌套树形结构改为扁平化数组
-- 通过 `parent` 字段关联父子关系，通过 `path` 字段表示层级路径
-- 移除 `simplifyModule()` 递归处理方法（不再需要）
-- 接口响应包含 `total` 字段，返回模块总数
-
-### Benefits
-- **性能提升**：支持按需获取字段，减少60-80%数据传输量
-- **更灵活**：可根据实际需求指定返回字段
-- **更标准**：返回格式包含 total 统计信息
-
-### Breaking Changes
-- `getModules()` 返回类型从 `SimpleModule[]` 改为 `ModulesResponse`
-- `SimpleModule` 不再包含 `children` 字段（数据已扁平化）
-
-## [1.5.0] - 2025-11-05
-
-### Added
-- **模块数据简化功能** - 新增 `SimpleModule` 接口，简化模块API返回数据
-  - `getModules` 接口现在只返回核心字段：id、name、parent、grade、children
-  - 移除冗余的字段（type、path、order等），大幅减少数据传输量
-  - 保持树形结构，递归简化所有子模块数据
-
-### Changed
-- 优化 `getModules()` 方法，返回类型从 `Module[]` 改为 `SimpleModule[]`
-- 添加 `simplifyModule()` 私有方法，用于递归转换模块数据结构
-
-### Benefits
-- 减少网络传输数据量，提升API响应速度
-- 简化客户端数据处理逻辑
-- 更清晰的数据结构，只包含必要信息
-
-## [1.4.3] - 2025-11-05
-
-### Fixed
-- 将 `CHANGELOG.md` 添加到 npm 包发布文件列表中
-- 确保用户可以在安装包后查看完整的版本历史
-
-## [1.4.2] - 2025-11-05
-
-### Added
-- 创建 `CHANGELOG.md` - 完整的版本更新历史文档
-- 在 README.md 中添加版本历史章节和最新版本信息
-- 添加 npm 版本徽章和 MIT 许可证徽章
-
-### Changed
-- 更新 README.md 中的包名从 `@bigtian/mcp-zentao` 到 `@zzp123/mcp-zentao`
-- 更新 API 文档示例代码，使用最新的接口签名
-- 添加版本标记到 API 方法说明（如 v1.4.0+, v1.2.0+）
-- 完善类型定义文档，添加 `ResolveBugRequest`、`UploadFileRequest`、`FileUploadResponse` 等新接口
-
-### Documentation
-- 整理所有版本的更新内容到 CHANGELOG
-- 记录从 v1.0.x 到 v1.4.2 的完整演进历史
-- 提供清晰的版本规范说明
-
-## [1.4.1] - 2025-11-05
-
-### Fixed
-- 修复 `uploadImageFromClipboard` 工具上传成功后没有返回内容的问题，该问题导致 AI 一直等待响应而卡住
-- 改进返回数据结构，现在包含 `success` 标志位、文件大小、文件名等详细信息
-- 增强错误处理，为每个平台（Windows/macOS/Linux）提供专门的错误处理和清晰的错误提示
-- 添加完整的执行日志，方便调试和问题排查
-
-### Changed
-- 优化返回格式，统一成功和失败响应的数据结构
-- 改进错误信息，包含堆栈跟踪和解决建议
-
-## [1.4.0] - 2025-11-05
-
-### Added
-- **新增解决Bug接口** `resolveBug` - 根据最新的禅道API文档添加
-  - 接口路径：`POST /bugs/:id/resolve`
-  - 支持7种解决方案：fixed（已解决）、bydesign（设计如此）、duplicate（重复Bug）、external（外部原因）、notrepro（无法重现）、postponed（延期处理）、willnotfix（不予解决）
-  - 自动验证必填字段：fixed 需要 resolvedBuild，duplicate 需要 duplicateBug
-  - 支持备注和指派功能
-- 新增 `ResolutionType` 类型定义
-- 新增 `ResolveBugRequest` 接口定义
-
-### Technical
-- 在 `zentaoApi.ts` 中实现 `resolveBug()` 方法，包含参数验证逻辑
-- 在 `index.ts` 中注册 `resolveBug` MCP 工具
-- 完善类型系统，确保类型安全
-
-## [1.3.2] - 2025-11-05
-
-### Removed
-- 移除 `resolveBug` API 方法（之前的实现与文档不符）
-- 移除 `resolveBug` MCP 工具注册
-- 移除 `BugResolution` 接口类型定义
-
-### Reason
-- 禅道REST API文档中的修改Bug接口（`PUT /bugs/:id`）不支持修改Bug状态
-- 该接口只支持修改基本信息（标题、优先级、严重程度等），不能修改 status、resolution、resolvedBuild 等字段
-- 这些字段只在返回数据中存在，不能作为请求参数
-
-### Note
-- 此版本移除的功能在 v1.4.0 中以正确的实现方式重新添加
-
-## [1.3.1] - 2025-11-05
-
-### Fixed
-- **修复 Claude Code 中剪贴板图片无法上传的核心问题**
-- 修改 `uploadImageFromClipboard` 工具，使其主动读取系统剪贴板，而不是期望 Claude Code 提供 base64Data
-
-### Changed
-- 工具现在直接使用操作系统原生方法读取剪贴板：
-  - Windows: PowerShell 的 `System.Windows.Forms.Clipboard`
-  - macOS: `pngpaste` 命令
-  - Linux: `xclip` 命令
-- 移除 `base64Data` 必填参数，改为可选的 `filename` 和 `uid`
-
-### Technical Details
-- **问题根源**：Claude Code 输入框中粘贴的图片会上传到 Claude 服务器用于视觉分析，MCP 工具运行在本地只能访问系统剪贴板，这是两个完全独立的数据源
-- **解决方案**：工具直接读取系统剪贴板，不依赖 Claude Code 传递图片数据
-
-### Documentation
-- 创建 `为什么读取不到剪贴板图片.md` - 详细解释技术原理
-- 创建 `Claude-Code图片上传指南.md` - 提供正确的使用方法
-- 创建 `scripts/get-clipboard-base64.js` - 辅助脚本
-
-## [1.3.0] - 2025-11-05
-
-### Added
-- **命令行脚本支持** - 添加跨平台的剪贴板图片上传脚本
-  - `scripts/upload-clipboard-image.js` - Node.js 实现（跨平台）
-  - `scripts/upload-clipboard-image.ps1` - PowerShell 脚本（Windows）
-  - `scripts/upload-clipboard-image.py` - Python 实现（跨平台）
-- 添加 npm 脚本命令：
-  - `npm run upload:clipboard` - 运行 Node.js 脚本
-  - `npm run upload:clipboard:py` - 运行 Python 脚本
-- 创建 `upload.bat.example` 配置模板
-
-### Documentation
-- 创建 `scripts/README.md` - 详细的脚本使用文档
-- 创建 `scripts/MCP-INTEGRATION.md` - MCP 集成说明
-- 创建 `上传图片使用说明.md` - 中文快速开始指南
-
-### Changed
-- 更新 package.json，将 scripts 文件夹包含到发布包中
-
-### Features
-- 支持从系统剪贴板直接上传图片到禅道
-- 100% 可靠的命令行方式（不依赖 MCP）
-- 自动保存图片到本地 img 文件夹
-- 返回文件 ID 和访问 URL
-
-## [1.2.2] - 2025-11-05
-
-### Added
-- 创建专门的 `uploadImageFromClipboard` MCP 工具
-- 工具接受 `base64Data`（必填）、`filename`（可选）、`uid`（可选）参数
-
-### Changed
-- 简化剪贴板图片上传流程
-- 使工具更加明确和易用
-
-### Note
-- 此版本的实现在 v1.3.1 中被完全重写，以解决 Claude Code 集成问题
-
-## [1.2.1] - 2025-11-05
-
-### Added
-- `uploadFile` 工具支持 `base64Data` 参数，可以直接上传 base64 编码的图片
-- 自动创建 `img` 文件夹（如果不存在）
-- 智能图片格式检测（从 data URL 中提取）
-- 默认文件名生成（使用时间戳）
-
-### Changed
-- 增强 `uploadFile` 工具，同时支持 `filePath` 和 `base64Data` 两种方式
-- 改进错误处理和参数验证
-
-### Technical
-- 添加 data URL 解析逻辑
-- 支持 png、jpg、jpeg、gif 等常见图片格式
-
-## [1.2.0] - 2025-11-05
-
-### Added
-- **文件上传接口** `uploadFile` - POST `/files`
-  - 支持 multipart/form-data 格式上传
-  - 支持 `uid` 参数（用于富文本编辑器关联）
-  - 支持多种文件格式（文档、图片、媒体、压缩包等）
-- **文件下载接口** `downloadFile` - GET `/files/:id`
-  - 返回文件的二进制数据（Buffer）
-  - 支持将文件保存到指定路径
-
-### Technical
-- 添加 `FileUploadResponse` 接口类型
-- 添加 `UploadFileRequest` 接口类型
-- 实现 `zentaoApi.uploadFile()` 方法，使用 form-data 库
-- 实现 `zentaoApi.downloadFile()` 方法，支持 arraybuffer 响应
-- 安装依赖：`form-data` 和 `@types/form-data`
-
-### MCP Tools
-- 注册 `uploadFile` MCP 工具
-- 注册 `downloadFile` MCP 工具
-
-## [1.1.x] - 早期版本
-
-### Added
-- 模块管理接口 `getModules` - GET `/modules`
-  - 支持按类型和ID获取模块树
-  - 支持需求、任务、Bug、用例、反馈、产品等多种模块类型
-
-## [1.0.x] - 初始版本
-
-### Added
-- **基础功能**
-  - 禅道 API 认证（Token 获取）
-  - 配置管理（本地配置文件）
-  - MCP 服务器初始化
-
-- **任务管理**
-  - `getMyTasks` - 获取我的任务列表
-  - `getTaskDetail` - 获取任务详情
-  - `updateTask` - 更新任务
-  - `finishTask` - 完成任务
-  - `createTask` - 创建任务
-
-- **Bug管理**
-  - `getMyBugs` - 获取我的Bug列表
-  - `getBugDetail` - 获取Bug详情
-  - `createBug` - 创建Bug
-  - `updateBug` - 修改Bug
-  - `deleteBug` - 删除Bug
-
-- **产品管理**
-  - `getProducts` - 获取产品列表
-  - `getProductDetail` - 获取产品详情
-  - `createProduct` - 创建产品
-  - `updateProduct` - 更新产品
-  - `deleteProduct` - 删除产品
-
-- **项目集管理**
-  - `getPrograms` - 获取项目集列表
-  - `getProgramDetail` - 获取项目集详情
-  - `createProgram` - 创建项目集
-  - `updateProgram` - 更新项目集
-  - `deleteProgram` - 删除项目集
-
-- **项目管理**
-  - `getProjects` - 获取项目列表
-  - `getProjectDetail` - 获取项目详情
-  - `createProject` - 创建项目
-  - `updateProject` - 更新项目
-  - `deleteProject` - 删除项目
-
-- **执行管理**
-  - `getExecutions` - 获取执行列表
-  - `getExecutionDetail` - 获取执行详情
-  - `createExecution` - 创建执行
-  - `updateExecution` - 更新执行
-  - `deleteExecution` - 删除执行
-
-- **需求管理**
-  - `getStories` - 获取需求列表
-  - `getStoryDetail` - 获取需求详情
-  - `createStory` - 创建需求
-  - `updateStory` - 更新需求
-  - `deleteStory` - 删除需求
-
-- **产品计划**
-  - `getPlans` - 获取计划列表
-  - `getPlanDetail` - 获取计划详情
-  - `createPlan` - 创建计划
-  - `updatePlan` - 更新计划
-  - `deletePlan` - 删除计划
-  - `linkBugsToPlan` - 关联Bug到计划
-  - `unlinkBugsFromPlan` - 取消关联Bug
-
-- **版本管理**
-  - `getBuilds` - 获取版本列表
-  - `getBuildDetail` - 获取版本详情
-  - `createBuild` - 创建版本
-  - `updateBuild` - 更新版本
-  - `deleteBuild` - 删除版本
-
-- **反馈管理**
-  - `getFeedbacks` - 获取反馈列表
-  - `getFeedbackDetail` - 获取反馈详情
-  - `createFeedback` - 创建反馈
-  - `updateFeedback` - 更新反馈
-  - `deleteFeedback` - 删除反馈
-  - `assignFeedback` - 指派反馈
-  - `closeFeedback` - 关闭反馈
-
-- **测试用例**
-  - `getTestCases` - 获取用例列表
-  - `getTestCaseDetail` - 获取用例详情
-  - `createTestCase` - 创建用例
-  - `updateTestCase` - 更新用例
-  - `deleteTestCase` - 删除用例
-
-- **工单管理**
-  - `getTickets` - 获取工单列表
-  - `getTicketDetail` - 获取工单详情
-  - `createTicket` - 创建工单
-  - `updateTicket` - 更新工单
-  - `deleteTicket` - 删除工单
-
-- **用户管理**
-  - `getMyProfile` - 获取我的信息
-  - `getUsers` - 获取用户列表
-  - `getUserDetail` - 获取用户详情
-  - `createUser` - 创建用户
-  - `updateUser` - 更新用户
-  - `deleteUser` - 删除用户
-
-- **发布管理**
-  - `getReleases` - 获取发布列表
-  - `getReleaseDetail` - 获取发布详情
-
-### Technical
-- TypeScript 实现，提供完整的类型定义
-- 基于 Axios 的 HTTP 客户端
-- MD5 密码加密
-- 自动 Token 管理和刷新
-- 配置文件支持（~/.zentao/config.json）
-- MCP (Model Context Protocol) 集成
-- Zod schema 验证
-
-### Documentation
-- README.md - 项目说明
-- 禅道API文档.md - 完整的 API 文档
-
----
-
-## 版本规范
-
-- **主版本号 (Major)**: 不兼容的 API 变更
-- **次版本号 (Minor)**: 向下兼容的功能新增
-- **修订号 (Patch)**: 向下兼容的问题修正
-
-## 链接
-
-- [npm 包地址](https://www.npmjs.com/package/@zzp123/mcp-zentao)
-- [GitHub 仓库](https://github.com/yourusername/mcp-zentao)（待更新）
-
-## 贡献者
-
-- [@zzp123](https://github.com/zzp123) - 项目维护者
+# Changelog
+
+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.18.7] - 2025-01-17
+
+### Fixed
+- **修复配置读取失败日志导致 MCP 启动失败** 🔧
+  - 删除 `config.ts` 中的 stderr 错误输出
+  - 配置文件读取失败时静默返回 null，不输出任何日志
+  - 配置不存在是正常情况（首次使用），不应该有错误输出
+  - 避免 stderr 输出干扰 MCP 服务器启动
+
+### Changed
+- `loadConfig()` 函数现在完全静默，失败时只返回 null
+- 错误处理完全由调用方（initZentao 工具）负责
+
+### Impact
+- ✅ MCP 服务器启动更稳定
+- ✅ 首次使用时不会有错误提示
+- ✅ 完全符合 MCP stdio 协议（stderr 只用于致命错误）
+
+## [1.18.6] - 2025-01-17
+
+### Fixed
+- **彻底清除所有 console 输出** 🔧
+  - 修复 `json-args.js` 中残留的 3 处 `console.error`
+  - 将所有错误输出改为 `process.stderr.write`
+  - 确保发布到 npm 的所有文件都不使用 console
+
+### Changed
+- `json-args.js` 错误处理统一使用 stderr 输出
+- 错误消息格式统一为 `[ERROR]` 前缀
+
+### Verification
+- ✅ Source files (src/): 0 console statements
+- ✅ Compiled files (dist/): 0 console statements
+- ✅ Helper scripts (json-args.js): 0 console statements
+- ✅ 100% console-free package
+
+## [1.18.5] - 2025-01-17
+
+### Fixed
+- **修复角色版本命令缺失问题** 🔧
+  - 添加 `zentao`、`zentao-pm`、`zentao-qa`、`zentao-dev` 四个命令入口
+  - 之前版本只有 `mcp-zentao` 一个命令，导致角色版本无法使用
+  - 现在用户可以根据需要选择不同角色的命令
+
+### Changed
+- 更新 package.json 的 bin 配置，支持所有角色版本命令
+- `zentao` - 完整版（91个工具）
+- `zentao-pm` - 产品经理版（39个工具）
+- `zentao-qa` - 测试工程师版（26个工具）
+- `zentao-dev` - 开发工程师版（38个工具）
+
+### Technical
+- 将 bin 从单一入口改为多入口配置
+- 所有角色版本的编译文件都已包含在发布包中
+
+### Migration
+```bash
+# 现在可以使用不同的命令
+zentao           # 完整版
+zentao-pm        # 产品经理版
+zentao-qa        # 测试工程师版
+zentao-dev       # 开发工程师版
+```
+
+## [1.18.4] - 2025-01-17
+
+### Fixed
+- **修复 MCP stdio 协议污染问题** 🔧
+  - 删除所有 `console.log` / `console.error` / `console.warn` 语句（240+ 处）
+  - MCP stdio 服务器的 stdout 仅用于 JSON-RPC 通信，任何日志输出都会破坏协议
+  - 保留 2 处关键错误输出到 stderr（配置加载失败、MCP 启动失败）
+  - 错误处理通过 `throw Error` 自动传递给 MCP 客户端
+
+### Changed
+- 所有调试日志已移除，不再污染 stdout
+- MCP 服务器启动失败时输出到 stderr 并正确退出
+- 配置文件加载失败时输出到 stderr
+
+### Impact
+- **协议兼容性**: 完全符合 MCP stdio 协议规范
+- **稳定性**: 避免因日志输出导致的协议解析失败
+- **性能**: 减少 I/O 开销，提升响应速度
+- **代码量**: 删除约 240 行日志代码
+
+### Technical
+- 清理 `src/api/zentaoApi.ts` 中的 176 处日志
+- 清理 `src/index.ts` 中的 91 处日志
+- 清理 `src/index-dev.ts` 中的 38 处日志
+- 清理 `src/index-pm.ts` 中的 39 处日志
+- 清理 `src/index-qa.ts` 中的 26 处日志
+- 优化 `src/config.ts` 的错误输出到 stderr
+- 保留关键启动错误处理，输出格式：`[FATAL]` / `[ERROR]`
+
+### Migration
+- 无需用户操作，升级后自动生效
+- 错误信息会通过 MCP 客户端（Claude Desktop）正确显示
+- 开发调试推荐使用官方 MCP Inspector 工具
+
+## [1.18.3] - 2025-01-12
+
+### Fixed
+- **修复MCP协议兼容性问题** 🔧
+  - 修复 `changeStory` 和 `changeRequirement` 工具的参数类型错误
+  - 移除 `z.union([z.object({...}), z.string()])` 改为纯对象类型
+  - 解决 "Expected object, received string" 错误
+  - 同时修复完整版和产品经理版本
+
+### Technical
+- 更新 `src/index.ts` 中的 `changeStory` 和 `changeRequirement` 工具定义
+- 更新 `src/index-pm.ts` 中的 `changeStory` 工具定义
+- 符合MCP协议规范，所有参数必须是对象类型
+
+## [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
+- **产品经理版再次优化** 📊
+  - 从产品经理版 (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
+- **测试工程师版优化** 🧪
+  - 从测试工程师版 (mcp-zentao-qa) 移除构建版本管理工具（4个工具）和工单管理工具（5个工具）
+  - 工具数量从 38 个减少到 29 个
+  - 包大小从 38 KB 减少到约 27 KB
+  - 更专注于Bug跟踪和测试用例管理核心功能
+
+### Technical
+- 更新 `roleConfig.ts` 中的 qa 角色配置
+- 重新生成测试工程师版源文件 (`src/index-qa.ts`)
+
+## [1.17.2] - 2025-11-10
+
+### Changed
+- **产品经理版优化** 📊
+  - 从产品经理版 (mcp-zentao-pm) 移除反馈管理工具（7个工具）
+  - 工具数量从 54 个减少到 47 个
+  - 包大小从 25 KB 减少到约 22 KB
+  - 更专注于产品规划和需求管理核心功能
+
+### Technical
+- 更新 `roleConfig.ts` 中的 pm 角色配置
+- 重新生成产品经理版源文件 (`src/index-pm.ts`)
+
+## [1.17.1] - 2025-11-10
+
+### Changed
+- **开发工程师版优化** 🔧
+  - 从开发工程师版 (mcp-zentao-dev) 移除工单管理工具（5个工具）
+  - 工具数量从 46 个减少到 41 个
+  - 包大小从 24 KB 减少到约 22 KB
+  - 更专注于核心开发工作流
+
+### Technical
+- 更新 `roleConfig.ts` 中的 dev 角色配置
+- 重新生成开发工程师版源文件 (`src/index-dev.ts`)
+
+## [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
+- **评论功能完整支持** 💬
+  - 新增 `addComment` 通用评论工具，支持9种对象类型
+  - 新增专用评论工具：
+    - `addStoryComment`: 为需求添加评论（自动识别story/requirement）
+    - `addTaskComment`: 为任务添加评论
+    - `addBugComment`: 为Bug添加评论
+  - 支持的对象类型：
+    - story（软件需求）
+    - requirement（用户需求）
+    - task（任务）
+    - bug（Bug）
+    - testcase（测试用例）
+    - testtask（测试单）
+    - todo（待办）
+    - doc（文档）
+    - doctemplate（文档模板）
+
+### Changed
+- **评论内容格式**
+  - 支持纯文本评论
+  - 支持HTML格式的富文本评论
+  - 自动处理评论提交的响应格式
+
+### Technical
+- 添加 `CommentObjectType` 类型定义
+- 添加 `AddCommentRequest` 和 `CommentResponse` 接口
+- 实现混合接口调用（使用HTML接口但保持REST API认证）
+
+## [1.14.0] - 2025-11-07
+
+### Added
+- **完整的用户需求(Requirement)支持** 🎯
+  - 扩展 Story API，统一支持软件需求(story)和用户需求(requirement)
+  - 所有现有 story 工具现已支持两种需求类型，自动识别
+  - 新增4个专用的 requirement 工具：
+    - `createRequirement`: 创建用户需求
+    - `getRequirementDetail`: 获取用户需求详情
+    - `changeRequirement`: 修改用户需求
+    - `deleteRequirement`: 删除用户需求
+  - `createStory` 工具新增 `type` 参数，可选择创建 story 或 requirement
+
+### Changed
+- **更新现有需求工具描述**
+  - `getStoryDetail`: 现支持 story 和 requirement 两种类型，自动识别
+  - `changeStory`: 现支持 story 和 requirement 两种类型，自动识别
+  - `deleteStory`: 现支持 story 和 requirement 两种类型，自动识别
+  - `getProductStories`: 返回的列表可能包含两种类型的需求
+
+### Improved
+- **更好的语义化**
+  - 专用的 requirement 工具提供更清晰的意图表达
+  - 统一接口底层实现，减少代码重复
+  - 符合禅道 API v2.0 的最新扩展
+
+## [1.13.0] - 2025-11-07
+
+### Added
+- **产品和需求列表字段过滤功能** 📦
+  - 为 `getProducts` 添加 `fields` 参数支持
+  - 为 `getProductStories` 添加 `fields` 参数支持
+  - 支持三种字段级别：
+    - `basic`: 基本信息（产品：id, name, code, status；需求：id, title, assignedTo, openedBy）
+    - `default`: 默认信息（产品：包含 PO/QD/RD 等；需求：包含 status/stage/pri 等，**默认使用**）
+    - `full`: 完整信息（所有字段）
+
+### Changed
+- **优化列表接口默认返回数据**
+  - 产品列表默认使用 `default` 字段级别，返回核心管理信息
+  - 需求列表默认使用 `basic` 字段级别，只返回最基本的4个字段
+  - 显著减少数据传输量，提升列表查询响应速度
+
+### Improved
+- **性能优化**
+  - 列表接口数据量大幅减少，特别适合快速浏览和搜索场景
+  - 减少不必要的字段传输，降低网络开销
+  - 需要详细信息时可按需设置 `fields='full'`
+
+## [1.12.0] - 2025-11-07
+
+### Added
+- **字段级别过滤功能** 📦
+  - 为 `getMyBugs` 和 `getProductBugs` 添加 `fields` 参数
+  - 支持三种字段级别：
+    - `basic`: 基本信息（8个核心字段：id, title, status, pri, severity, assignedTo, openedBy, openedDate）
+    - `default`: 默认信息（18个常用字段，适合列表展示，**默认使用**）
+    - `full`: 完整信息（所有字段）
+  - 显著减少数据传输量，提升响应速度
+
+### Changed
+- **优化默认返回数据**
+  - 默认使用 `default` 字段级别，只返回列表展示所需的字段
+  - 保持默认每页 20 条记录不变
+  - 需要完整信息时可设置 `fields='full'`
+
+### Improved
+- **性能优化**
+  - 使用 default 模式减少约 60% 的数据传输量
+  - 使用 basic 模式减少约 80% 的数据传输量
+  - 更快的响应速度和更低的网络开销
+  - 更适合移动端和弱网络环境使用
+
+## [1.11.1] - 2025-11-07
+
+### Fixed
+- **修复依赖冲突问题** 🔧
+  - 移除 package.json 中的自引用依赖 `@zzp123/mcp-zentao@1.2.1`
+  - 解决了 MCP 工具仍然使用旧版本参数（`onlyAssignedToMe`）的问题
+  - 确保用户安装后立即使用最新的 API 定义
+
+### Important
+- 如果你从旧版本升级，请重启你的 MCP 服务器或 Claude Desktop 以加载新的工具定义
+
+## [1.11.0] - 2025-11-07
+
+### Added
+- **完整的 Bug 状态筛选支持** ✨
+  - 扩展 `BugStatus` 类型，新增 16 种状态筛选类型
+  - 支持所有禅道官方 API 的状态筛选：assigntome、openedbyme、resolvedbyme、assignedbyme、assigntonull、unconfirmed、unclosed、unresolved、toclosed、postponedbugs、longlifebugs、overduebugs、review、feedback、needconfirm、bysearch
+  - MCP 工具现在提供完整的 20 种状态选项供选择
+
+- **分支筛选功能** 🌿
+  - 为 `getMyBugs` 和 `getProductBugs` 添加 `branch` 参数
+  - 支持 'all'(所有分支)、'0'(主干分支)、分支ID
+  - 默认值为 'all'，符合禅道官方 API 规范
+
+### Changed
+- **重构 Bug 列表 API 参数** 🔄
+  - 移除 `onlyAssignedToMe` 参数，改用更灵活的 `status='assigntome'`
+  - 调整参数顺序：`status, productId, page, limit, branch, order`
+  - 优化参数构建逻辑，确保与禅道官方 API 完全一致
+
+### Improved
+- **API 文档完善**
+  - 为 `getMyBugs` 和 `getProductBugs` 添加详细的 JSDoc 注释
+  - 更新工具描述，明确说明支持的状态筛选类型
+  - 参数说明更加清晰，包含默认值和示例
+
+- **更好的用户体验**
+  - MCP 工具提供完整的状态枚举，IDE 可以自动补全
+  - 所有状态选项都有中文注释说明
+  - 更符合禅道用户的使用习惯
+
+### Technical
+- 完全符合禅道官方 Bug 列表 API 文档规范
+- 支持所有官方 API 参数：branch、status、order、limit、page
+- 默认值与官方 API 保持一致
+
+## [1.10.0] - 2025-11-07
+
+### Fixed
+- **修复 Bug 获取工具的 API 端点和参数问题** 🔧
+  - 从错误的 `/bugs` 端点改为正确的 `/products/{productId}/bugs` 端点
+  - 移除了低效的客户端过滤逻辑，改用服务器端原生支持的 `assigntome` 状态
+  - 修复了 `onlyAssignedToMe` 参数无法正确工作的问题
+
+### Added
+- **添加排序参数支持** ✨
+  - 为 `getMyBugs` 和 `getProductBugs` 工具添加 `order` 参数
+  - 支持多种排序方式：`id_desc`(ID降序)、`id_asc`(ID升序)、`pri_desc`(优先级降序)等
+  - 默认使用 `id_desc` 排序，确保最新的 Bug 显示在前面
+  - 与禅道官方 API 完全一致的参数格式
+
+### Improved
+- **性能优化**
+  - 使用服务器端过滤替代客户端过滤，显著提升查询效率
+  - 减少不必要的数据传输，降低网络开销
+  - 更准确的分页信息和总数统计
+
+### Changed
+- 更新了 `getMyBugs` 方法签名，添加 `order` 参数
+- 更新了 `getProductBugs` 方法签名，添加 `order` 参数
+- 优化了查询参数的构建方式，使用 URLSearchParams 确保参数正确编码
+
+## [1.9.0] - 2025-11-06
+
+### Fixed
+- **修复 getMyBugs 工具过滤逻辑问题** 🔧
+  - 禅道API的 `/bugs` 接口不支持 `assignedTo` 参数进行服务端过滤
+  - 改为使用客户端过滤：获取更多数据后在本地筛选分配给当前用户的Bug
+  - 修复了使用 `onlyAssignedToMe=true` 时无法正确获取当前用户Bug的问题
+  - 现在能够正确识别 `assignedTo` 字段（支持对象和字符串两种格式）
+
+### Improved
+- 优化了 `getMyBugs` 的性能：当需要过滤时自动获取100条数据以确保有足够的结果
+- 增加了详细的过滤日志输出，便于调试和追踪
+
+### Changed
+- 扩展了 `Bug` 类型定义，添加了 `assignedTo`、`openedBy`、`resolvedBy` 等字段
+- 更新了文档，说明了禅道API的限制和客户端过滤的实现方式
+
+## [1.8.9] - 2025-11-06
+
+### Fixed
+- **修复 resolveBug 工具必须提供 resolvedBuild 参数的问题**
+  - 当 resolution 为 "fixed" 时，如果未提供 resolvedBuild，自动设置为 "trunk"（主干版本）
+  - 消除了使用 resolveBug 工具时的常见错误："当解决方案为"已解决(fixed)"时，必须提供解决版本(resolvedBuild)"
+  - 简化了解决Bug的操作流程，提升用户体验
+
+### Improved
+- 添加了自动默认值设置的日志输出，便于调试和追踪
+
+## [1.8.8] - 2025-11-06
+
+### Fixed
+- **修复 getMyBugs 工具返回Bug数量为0的问题**
+  - 移除了硬编码的 `assignedTo` 过滤条件
+  - 默认获取所有Bug，不再只获取分配给当前用户的Bug
+  - 添加 `onlyAssignedToMe` 参数，让用户可以选择是否只获取分配给自己的Bug
+
+### Changed
+- **优化默认产品选择逻辑**
+  - 当未指定 productId 时，默认使用第二个产品（如果存在）
+  - 如果只有一个产品，则使用第一个产品
+
+### Improved
+- 为 getMyBugs 工具添加更清晰的描述："获取Bug列表 - 默认获取所有Bug，可选择只获取分配给我的Bug"
+- 增强了工具的灵活性，满足不同使用场景
+
+## [1.8.7] - 2025-11-06
+
+### Fixed
+- **修复 uploadImageFromClipboard 工具的图片URL生成问题**
+  - 修正图片访问URL格式：从复杂的API参数格式改为简洁的 `/file-read-{id}.png` 格式
+  - 确保上传后的图片能够正确显示和访问
+  - URL示例：`http://47.120.4.95:7137/zentao/file-read-3750.png`
+
+### Technical
+- 简化图片URL生成逻辑
+- 提高图片访问的兼容性和可靠性
+
+## [1.8.6] - 2025-11-06
+
+### Fixed
+- **修复 uploadImageFromClipboard 工具路径依赖问题**
+  - 将 PowerShell 脚本内嵌到代码中，不再依赖外部文件
+  - 解决了 Claude Code 工作目录与包安装目录不匹配的问题
+  - 使用 Base64 编码避免转义问题
+
+### Improved
+- **优化 uploadImageFromClipboard 工具的用户体验**
+  - 默认行为：直接从剪贴板获取图片并上传到禅道
+  - 简化了操作流程，用户只需说"上传图片"即可
+  - 移除了对外部脚本文件的依赖，提高了可靠性
+
+### Technical
+- 脚本完全内嵌，提高可移植性
+- 不再依赖 process.cwd() 路径解析
+- 更健壮的错误处理机制
+
+## [1.8.5] - 2025-11-06
+
+### Improved
+- **优化 changeStory 工具参数说明**
+  - 为 `reviewer` 字段添加详细描述：说明其通常为必填字段，除非设置 `needNotReview=true` 跳过评审
+  - 为 `needNotReview` 字段添加说明：如果不提供 `reviewer` 则应设置为 `true`
+  - 为 `storyId` 参数添加描述，提升工具可读性
+  - 为工具本身添加整体说明："需求变更 - 支持对象或JSON字符串格式"
+
+### Technical
+- 改进 MCP 工具的参数描述，帮助 AI 助手更好地理解参数使用规则
+- 提升工具在 Claude Code 等 AI IDE 中的可用性
+
+## [1.8.0] - 2025-11-06
+
+### Changed
+- **重构需求变更接口命名**
+  - 将 `updateStory` 工具重命名为 `changeStory`，更准确地反映其功能
+  - 将 `UpdateStoryRequest` 类型重命名为 `ChangeStoryRequest`
+  - 将 `updateStory` API方法重命名为 `changeStory`
+  - 使用功能完整的"修改需求其他字段"接口替代功能有限的"变更需求"接口
+
+### Added
+- 向后兼容的类型别名：`UpdateStoryRequest` 作为 `ChangeStoryRequest` 的别名
+
+### Technical
+- 统一需求变更相关的命名规范
+- 保持向后兼容性，旧的类型名称仍然可用
+- 所有测试通过，确保重构不影响现有功能
+
+## [1.7.4] - 2025-11-06
+
+### Fixed
+- **修复 createTask 和 updateStory 中的评审人相关错误**
+  - 修复 `createTask` 工具中 `assignedTo` 参数类型错误（从字符串改为数组）
+  - 修复 `createTask` 工具中必填参数缺失问题（execution, type, estStarted, deadline）
+  - 修复 `updateStory` 工具中"评审人不能为null"错误
+  - 为 `updateStory` 添加自动跳过评审机制（needNotReview=true）
+
+### Changed
+- `CreateTaskRequest` 接口更新：将 assignedTo 从可选字符串改为必需数组
+- `createTask` MCP 工具参数重新定义：必填参数前置，类型修正
+- `updateStory` API 方法添加智能评审人处理逻辑
+- API 请求表单数据处理：支持数组类型参数的正确格式化
+
+### Technical
+- 更新测试文件以适配新的接口要求
+- TypeScript 编译验证通过，确保类型安全
+- 保持向后兼容性，同时修复API规范问题
+
+## [1.7.3] - 2025-11-06
+
+### Fixed
+- **updateStory 工具参数格式优化**
+  - 修复 `update` 参数只能接受对象格式的问题
+  - 现在同时支持对象格式和 JSON 字符串格式
+  - 自动解析 JSON 字符串并提供友好的错误提示
+
+### Changed
+- `update` 参数使用 `z.union()` 同时接受对象和字符串格式
+- 添加 JSON 字符串解析逻辑，提升工具兼容性
+
+## [1.7.2] - 2025-11-06
+
+### Added
+- **updateStory 工具重大增强**
+  - 新增29个可编辑字段支持，��全对接禅道最新API文档
+  - 支持需求基本信息编辑：title, product, parent, module, branch, plan, type
+  - 支持来源信息编辑：source, sourceNote（支持8种来源类型）
+  - 支持分类与优先级：category, pri, estimate
+  - 支持状态与阶段：stage, status
+  - 支持关键词与标识：keywords, color, grade
+  - 支持人员相关：mailto, reviewer, assignedTo, closedBy, feedbackBy
+  - 支持关闭相关：closedReason, duplicateStory（7种关闭原因）
+  - 支持评审相关：needNotReview
+  - 支持通知相关：notifyEmail
+  - 支持描述内容：spec, verify（HTML格式）
+  - 支持备注：comment
+
+### Changed
+- `UpdateStoryRequest` 接口完全重构，从7个字段扩展到29个字段
+- `updateStory` MCP 工具参数完全重新定义，支持所有新字段
+- 添加了详细的字段注释和类型定义，提升开发体验
+
+### Technical
+- 所有字段均为可选参数，支持部分更新
+- `plan` 字段支持单个ID或数组格式
+- `closedReason` 使用枚举类型确保数据正确性
+- `mailto` 和 `reviewer` 字段支持数组格式
+
+### Benefits
+- **功能完整性**：支持禅道需求管理的所有常用编辑功能
+- **灵活性**：可以批量更新多个字段，也可以单独更新单个字段
+- **类型安全**：完整的 TypeScript 类型定义，减少运行时错误
+
+## [1.7.1] - 2025-11-06
+
+### Fixed
+- **图片 HTML 格式优化**
+  - `uploadFile` 和 `uploadImageFromClipboard` 工具现在生成的 `imageHtml` 会被 `<p>` 标签包裹
+  - 修复了某些情况下图片在禅道中无法正确显示的问题
+  - 确保生成的 HTML 格式与禅道富文本编辑器的标准格式一致
+
+### Changed
+- 图片 HTML 格式从 `<img ... />` 改为 `<p><img ... /></p>`
+- 更新使用提示，明确说明图片会被包裹在 `<p>` 标签中
+
+## [1.7.0] - 2025-11-06
+
+### Added
+- **图片上传自动生成 HTML 格式**
+  - `uploadFile` 工具现在返回 `imageHtml` 字段，包含禅道所需的完整 HTML 代码
+  - `uploadImageFromClipboard` 工具同样返回 `imageHtml` 字段
+  - 新增 `imageUrl` 字段，提供完整的图片访问地址
+  - 新增 `fileId` 字段，方便后续引用
+  - 新增使用提示 `tip` 字段，帮助用户正确使用
+
+### Changed
+- ZentaoAPI 类新增 `getConfig()` 方法，允许获取配置信息以生成图片 URL
+- 图片上传返回格式优化，Claude Code 现在能自动识别并使用正确的 HTML 格式
+
+### Technical
+- 图片 HTML 格式：`<img onload="setImageSize(this,0)" src="..." alt="..." />`
+- 自动包含 `onload="setImageSize(this,0)"` 以确保图片在禅道中正确显示
+
+### Benefits
+- **提升用户体验**：Claude Code 无需手动构造 HTML 代码
+- **减少错误**：避免手动拼接 HTML 时的格式错误
+- **更直观**：返回结果中直接包含可用的 HTML 代码
+
+## [1.6.1] - 2025-11-05
+
+### Fixed
+- **修复 Windows 剪贴板图片读取问题**
+  - 替换为新的 PowerShell 脚本 `scripts/get_clipboard.ps1`
+  - 使用 `Add-Type` 加载 `System.Drawing` 程序集，确保正确处理图片
+  - 改进错误处理，提供更详细的错误信息
+  - 使用 `-ExecutionPolicy Bypass` 确保脚本可以执行
+
+### Changed
+- Windows 平台现在使用外部 PowerShell 脚本文件而非内联脚本
+- 优化了 base64 转换流程，确保内存流正确关闭
+
+## [1.6.0] - 2025-11-05
+
+### Changed - 重大更新
+- **迁移到自定义模块接口** `/custom/modules` - 替代原生 `/modules` 接口
+  - 接口路径：`GET /custom/modules`（原 `/modules`）
+  - 支持字段过滤功能：通过 `fields` 参数指定返回字段
+  - 默认返回精简字段：id、name、parent、grade、type
+  - 可选字段：id、root、branch、name、parent、path、grade、order、type、owner、collector、short
+
+### Added
+- 新增 `fields` 参数支持，可大幅减少返回数据量（60-80%）
+- 新增 `ModulesResponse` 接口：`{ modules: SimpleModule[], total: number }`
+- 更新 `SimpleModule` 接口，支持更多可选字段
+
+### Technical
+- 返回数据结构变化：从嵌套树形结构改为扁平化数组
+- 通过 `parent` 字段关联父子关系，通过 `path` 字段表示层级路径
+- 移除 `simplifyModule()` 递归处理方法（不再需要）
+- 接口响应包含 `total` 字段，返回模块总数
+
+### Benefits
+- **性能提升**：支持按需获取字段，减少60-80%数据传输量
+- **更灵活**：可根据实际需求指定返回字段
+- **更标准**：返回格式包含 total 统计信息
+
+### Breaking Changes
+- `getModules()` 返回类型从 `SimpleModule[]` 改为 `ModulesResponse`
+- `SimpleModule` 不再包含 `children` 字段（数据已扁平化）
+
+## [1.5.0] - 2025-11-05
+
+### Added
+- **模块数据简化功能** - 新增 `SimpleModule` 接口，简化模块API返回数据
+  - `getModules` 接口现在只返回核心字段：id、name、parent、grade、children
+  - 移除冗余的字段（type、path、order等），大幅减少数据传输量
+  - 保持树形结构，递归简化所有子模块数据
+
+### Changed
+- 优化 `getModules()` 方法，返回类型从 `Module[]` 改为 `SimpleModule[]`
+- 添加 `simplifyModule()` 私有方法，用于递归转换模块数据结构
+
+### Benefits
+- 减少网络传输数据量，提升API响应速度
+- 简化客户端数据处理逻辑
+- 更清晰的数据结构，只包含必要信息
+
+## [1.4.3] - 2025-11-05
+
+### Fixed
+- 将 `CHANGELOG.md` 添加到 npm 包发布文件列表中
+- 确保用户可以在安装包后查看完整的版本历史
+
+## [1.4.2] - 2025-11-05
+
+### Added
+- 创建 `CHANGELOG.md` - 完整的版本更新历史文档
+- 在 README.md 中添加版本历史章节和最新版本信息
+- 添加 npm 版本徽章和 MIT 许可证徽章
+
+### Changed
+- 更新 README.md 中的包名从 `@bigtian/mcp-zentao` 到 `@zzp123/mcp-zentao`
+- 更新 API 文档示例代码，使用最新的接口签名
+- 添加版本标记到 API 方法说明（如 v1.4.0+, v1.2.0+）
+- 完善类型定义文档，添加 `ResolveBugRequest`、`UploadFileRequest`、`FileUploadResponse` 等新接口
+
+### Documentation
+- 整理所有版本的更新内容到 CHANGELOG
+- 记录从 v1.0.x 到 v1.4.2 的完整演进历史
+- 提供清晰的版本规范说明
+
+## [1.4.1] - 2025-11-05
+
+### Fixed
+- 修复 `uploadImageFromClipboard` 工具上传成功后没有返回内容的问题，该问题导致 AI 一直等待响应而卡住
+- 改进返回数据结构，现在包含 `success` 标志位、文件大小、文件名等详细信息
+- 增强错误处理，为每个平台（Windows/macOS/Linux）提供专门的错误处理和清晰的错误提示
+- 添加完整的执行日志，方便调试和问题排查
+
+### Changed
+- 优化返回格式，统一成功和失败响应的数据结构
+- 改进错误信息，包含堆栈跟踪和解决建议
+
+## [1.4.0] - 2025-11-05
+
+### Added
+- **新增解决Bug接口** `resolveBug` - 根据最新的禅道API文档添加
+  - 接口路径：`POST /bugs/:id/resolve`
+  - 支持7种解决方案：fixed（已解决）、bydesign（设计如此）、duplicate（重复Bug）、external（外部原因）、notrepro（无法重现）、postponed（延期处理）、willnotfix（不予解决）
+  - 自动验证必填字段：fixed 需要 resolvedBuild，duplicate 需要 duplicateBug
+  - 支持备注和指派功能
+- 新增 `ResolutionType` 类型定义
+- 新增 `ResolveBugRequest` 接口定义
+
+### Technical
+- 在 `zentaoApi.ts` 中实现 `resolveBug()` 方法，包含参数验证逻辑
+- 在 `index.ts` 中注册 `resolveBug` MCP 工具
+- 完善类型系统，确保类型安全
+
+## [1.3.2] - 2025-11-05
+
+### Removed
+- 移除 `resolveBug` API 方法（之前的实现与文档不符）
+- 移除 `resolveBug` MCP 工具注册
+- 移除 `BugResolution` 接口类型定义
+
+### Reason
+- 禅道REST API文档中的修改Bug接口（`PUT /bugs/:id`）不支持修改Bug状态
+- 该接口只支持修改基本信息（标题、优先级、严重程度等），不能修改 status、resolution、resolvedBuild 等字段
+- 这些字段只在返回数据中存在，不能作为请求参数
+
+### Note
+- 此版本移除的功能在 v1.4.0 中以正确的实现方式重新添加
+
+## [1.3.1] - 2025-11-05
+
+### Fixed
+- **修复 Claude Code 中剪贴板图片无法上传的核心问题**
+- 修改 `uploadImageFromClipboard` 工具，使其主动读取系统剪贴板，而不是期望 Claude Code 提供 base64Data
+
+### Changed
+- 工具现在直接使用操作系统原生方法读取剪贴板：
+  - Windows: PowerShell 的 `System.Windows.Forms.Clipboard`
+  - macOS: `pngpaste` 命令
+  - Linux: `xclip` 命令
+- 移除 `base64Data` 必填参数，改为可选的 `filename` 和 `uid`
+
+### Technical Details
+- **问题根源**：Claude Code 输入框中粘贴的图片会上传到 Claude 服务器用于视觉分析，MCP 工具运行在本地只能访问系统剪贴板，这是两个完全独立的数据源
+- **解决方案**：工具直接读取系统剪贴板，不依赖 Claude Code 传递图片数据
+
+### Documentation
+- 创建 `为什么读取不到剪贴板图片.md` - 详细解释技术原理
+- 创建 `Claude-Code图片上传指南.md` - 提供正确的使用方法
+- 创建 `scripts/get-clipboard-base64.js` - 辅助脚本
+
+## [1.3.0] - 2025-11-05
+
+### Added
+- **命令行脚本支持** - 添加跨平台的剪贴板图片上传脚本
+  - `scripts/upload-clipboard-image.js` - Node.js 实现（跨平台）
+  - `scripts/upload-clipboard-image.ps1` - PowerShell 脚本（Windows）
+  - `scripts/upload-clipboard-image.py` - Python 实现（跨平台）
+- 添加 npm 脚本命令：
+  - `npm run upload:clipboard` - 运行 Node.js 脚本
+  - `npm run upload:clipboard:py` - 运行 Python 脚本
+- 创建 `upload.bat.example` 配置模板
+
+### Documentation
+- 创建 `scripts/README.md` - 详细的脚本使用文档
+- 创建 `scripts/MCP-INTEGRATION.md` - MCP 集成说明
+- 创建 `上传图片使用说明.md` - 中文快速开始指南
+
+### Changed
+- 更新 package.json，将 scripts 文件夹包含到发布包中
+
+### Features
+- 支持从系统剪贴板直接上传图片到禅道
+- 100% 可靠的命令行方式（不依赖 MCP）
+- 自动保存图片到本地 img 文件夹
+- 返回文件 ID 和访问 URL
+
+## [1.2.2] - 2025-11-05
+
+### Added
+- 创建专门的 `uploadImageFromClipboard` MCP 工具
+- 工具接受 `base64Data`（必填）、`filename`（可选）、`uid`（可选）参数
+
+### Changed
+- 简化剪贴板图片上传流程
+- 使工具更加明确和易用
+
+### Note
+- 此版本的实现在 v1.3.1 中被完全重写，以解决 Claude Code 集成问题
+
+## [1.2.1] - 2025-11-05
+
+### Added
+- `uploadFile` 工具支持 `base64Data` 参数，可以直接上传 base64 编码的图片
+- 自动创建 `img` 文件夹（如果不存在）
+- 智能图片格式检测（从 data URL 中提取）
+- 默认文件名生成（使用时间戳）
+
+### Changed
+- 增强 `uploadFile` 工具，同时支持 `filePath` 和 `base64Data` 两种方式
+- 改进错误处理和参数验证
+
+### Technical
+- 添加 data URL 解析逻辑
+- 支持 png、jpg、jpeg、gif 等常见图片格式
+
+## [1.2.0] - 2025-11-05
+
+### Added
+- **文件上传接口** `uploadFile` - POST `/files`
+  - 支持 multipart/form-data 格式上传
+  - 支持 `uid` 参数（用于富文本编辑器关联）
+  - 支持多种文件格式（文档、图片、媒体、压缩包等）
+- **文件下载接口** `downloadFile` - GET `/files/:id`
+  - 返回文件的二进制数据（Buffer）
+  - 支持将文件保存到指定路径
+
+### Technical
+- 添加 `FileUploadResponse` 接口类型
+- 添加 `UploadFileRequest` 接口类型
+- 实现 `zentaoApi.uploadFile()` 方法，使用 form-data 库
+- 实现 `zentaoApi.downloadFile()` 方法，支持 arraybuffer 响应
+- 安装依赖：`form-data` 和 `@types/form-data`
+
+### MCP Tools
+- 注册 `uploadFile` MCP 工具
+- 注册 `downloadFile` MCP 工具
+
+## [1.1.x] - 早期版本
+
+### Added
+- 模块管理接口 `getModules` - GET `/modules`
+  - 支持按类型和ID获取模块树
+  - 支持需求、任务、Bug、用例、反馈、产品等多种模块类型
+
+## [1.0.x] - 初始版本
+
+### Added
+- **基础功能**
+  - 禅道 API 认证（Token 获取）
+  - 配置管理（本地配置文件）
+  - MCP 服务器初始化
+
+- **任务管理**
+  - `getMyTasks` - 获取我的任务列表
+  - `getTaskDetail` - 获取任务详情
+  - `updateTask` - 更新任务
+  - `finishTask` - 完成任务
+  - `createTask` - 创建任务
+
+- **Bug管理**
+  - `getMyBugs` - 获取我的Bug列表
+  - `getBugDetail` - 获取Bug详情
+  - `createBug` - 创建Bug
+  - `updateBug` - 修改Bug
+  - `deleteBug` - 删除Bug
+
+- **产品管理**
+  - `getProducts` - 获取产品列表
+  - `getProductDetail` - 获取产品详情
+  - `createProduct` - 创建产品
+  - `updateProduct` - 更新产品
+  - `deleteProduct` - 删除产品
+
+- **项目集管理**
+  - `getPrograms` - 获取项目集列表
+  - `getProgramDetail` - 获取项目集详情
+  - `createProgram` - 创建项目集
+  - `updateProgram` - 更新项目集
+  - `deleteProgram` - 删除项目集
+
+- **项目管理**
+  - `getProjects` - 获取项目列表
+  - `getProjectDetail` - 获取项目详情
+  - `createProject` - 创建项目
+  - `updateProject` - 更新项目
+  - `deleteProject` - 删除项目
+
+- **执行管理**
+  - `getExecutions` - 获取执行列表
+  - `getExecutionDetail` - 获取执行详情
+  - `createExecution` - 创建执行
+  - `updateExecution` - 更新执行
+  - `deleteExecution` - 删除执行
+
+- **需求管理**
+  - `getStories` - 获取需求列表
+  - `getStoryDetail` - 获取需求详情
+  - `createStory` - 创建需求
+  - `updateStory` - 更新需求
+  - `deleteStory` - 删除需求
+
+- **产品计划**
+  - `getPlans` - 获取计划列表
+  - `getPlanDetail` - 获取计划详情
+  - `createPlan` - 创建计划
+  - `updatePlan` - 更新计划
+  - `deletePlan` - 删除计划
+  - `linkBugsToPlan` - 关联Bug到计划
+  - `unlinkBugsFromPlan` - 取消关联Bug
+
+- **版本管理**
+  - `getBuilds` - 获取版本列表
+  - `getBuildDetail` - 获取版本详情
+  - `createBuild` - 创建版本
+  - `updateBuild` - 更新版本
+  - `deleteBuild` - 删除版本
+
+- **反馈管理**
+  - `getFeedbacks` - 获取反馈列表
+  - `getFeedbackDetail` - 获取反馈详情
+  - `createFeedback` - 创建反馈
+  - `updateFeedback` - 更新反馈
+  - `deleteFeedback` - 删除反馈
+  - `assignFeedback` - 指派反馈
+  - `closeFeedback` - 关闭反馈
+
+- **测试用例**
+  - `getTestCases` - 获取用例列表
+  - `getTestCaseDetail` - 获取用例详情
+  - `createTestCase` - 创建用例
+  - `updateTestCase` - 更新用例
+  - `deleteTestCase` - 删除用例
+
+- **工单管理**
+  - `getTickets` - 获取工单列表
+  - `getTicketDetail` - 获取工单详情
+  - `createTicket` - 创建工单
+  - `updateTicket` - 更新工单
+  - `deleteTicket` - 删除工单
+
+- **用户管理**
+  - `getMyProfile` - 获取我的信息
+  - `getUsers` - 获取用户列表
+  - `getUserDetail` - 获取用户详情
+  - `createUser` - 创建用户
+  - `updateUser` - 更新用户
+  - `deleteUser` - 删除用户
+
+- **发布管理**
+  - `getReleases` - 获取发布列表
+  - `getReleaseDetail` - 获取发布详情
+
+### Technical
+- TypeScript 实现，提供完整的类型定义
+- 基于 Axios 的 HTTP 客户端
+- MD5 密码加密
+- 自动 Token 管理和刷新
+- 配置文件支持（~/.zentao/config.json）
+- MCP (Model Context Protocol) 集成
+- Zod schema 验证
+
+### Documentation
+- README.md - 项目说明
+- 禅道API文档.md - 完整的 API 文档
+
+---
+
+## 版本规范
+
+- **主版本号 (Major)**: 不兼容的 API 变更
+- **次版本号 (Minor)**: 向下兼容的功能新增
+- **修订号 (Patch)**: 向下兼容的问题修正
+
+## 链接
+
+- [npm 包地址](https://www.npmjs.com/package/@zzp123/mcp-zentao)
+- [GitHub 仓库](https://github.com/yourusername/mcp-zentao)（待更新）
+
+## 贡献者
+
+- [@zzp123](https://github.com/zzp123) - 项目维护者