@zzp123/mcp-zentao 1.7.4 → 1.8.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.8.0] - 2025-11-06
+
+### Changed
+- **重构需求变更接口命名**
+  - 将 `updateStory` 工具重命名为 `changeStory`，更准确地反映其功能
+  - 将 `UpdateStoryRequest` 类型重命名为 `ChangeStoryRequest`
+  - 将 `updateStory` API方法重命名为 `changeStory`
+  - 使用功能完整的"修改需求其他字段"接口替代功能有限的"变更需求"接口
+
+### Added
+- 向后兼容的类型别名：`UpdateStoryRequest` 作为 `ChangeStoryRequest` 的别名
+
+### Technical
+- 统一需求变更相关的命名规范
+- 保持向后兼容性，旧的类型名称仍然可用
+- 所有测试通过，确保重构不影响现有功能
+
 ## [1.7.4] - 2025-11-06
 
 ### Fixed

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, UpdateStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
+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';
 export declare class ZentaoAPI {
     private config;
     private client;
@@ -33,7 +33,7 @@ export declare class ZentaoAPI {
     getProjectExecutions(projectId: number): Promise<Execution[]>;
     createPlan(productId: number, plan: CreatePlanRequest): Promise<Plan>;
     getProjects(page?: number, limit?: number): Promise<Project[]>;
-    updateStory(storyId: number, update: UpdateStoryRequest): Promise<Story>;
+    changeStory(storyId: number, update: ChangeStoryRequest): Promise<Story>;
     deleteTask(taskId: number): Promise<{
         message: string;
     }>;

package/dist/api/zentaoApi.js

@@ -495,9 +495,9 @@ export class ZentaoAPI {
             throw error;
         }
     }
-    async updateStory(storyId, update) {
+    async changeStory(storyId, update) {
         try {
-            console.log(`正在更新需求 ${storyId}...`);
+            console.log(`正在变更需求 ${storyId}...`);
             // 自动处理评审人问题
             const updateData = { ...update };
             // 如果用户没有设置评审人，也没有指定无需评审，则自动跳过评审
@@ -506,11 +506,11 @@ export class ZentaoAPI {
                 console.log('自动设置needNotReview=true以跳过评审要求');
             }
             const response = await this.request('PUT', `/stories/${storyId}`, undefined, updateData);
-            console.log('更新需求响应:', response);
+            console.log('变更需求响应:', response);
             return response;
         }
         catch (error) {
-            console.error('更新需求失败:', error);
+            console.error('变更需求失败:', error);
             throw error;
         }
     }

package/dist/index.js

@@ -460,8 +460,8 @@ server.tool("getProjects", {
         content: [{ type: "text", text: JSON.stringify(projects, null, 2) }]
     };
 });
-// Add updateStory tool
-server.tool("updateStory", {
+// Add changeStory tool
+server.tool("changeStory", {
     storyId: z.number(),
     update: z.union([
         z.object({
@@ -507,7 +507,7 @@ server.tool("updateStory", {
             comment: z.string().optional()
         }),
         z.string()
-    ]).describe("需求更新字段 - 支持对象或JSON字符串格式")
+    ]).describe("需求变更字段 - 支持对象或JSON字符串格式")
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
@@ -524,7 +524,7 @@ server.tool("updateStory", {
     else {
         updateData = update;
     }
-    const story = await zentaoApi.updateStory(storyId, updateData);
+    const story = await zentaoApi.changeStory(storyId, updateData);
     return {
         content: [{ type: "text", text: JSON.stringify(story, null, 2) }]
     };

package/dist/types/zentao.d.ts

@@ -256,7 +256,7 @@ export interface Project {
     PM: string | User;
     progress: number;
 }
-export interface UpdateStoryRequest {
+export interface ChangeStoryRequest {
     title?: string;
     product?: number;
     parent?: number;
@@ -287,6 +287,7 @@ export interface UpdateStoryRequest {
     verify?: string;
     comment?: string;
 }
+export type UpdateStoryRequest = ChangeStoryRequest;
 export interface CreateProgramRequest {
     name?: string;
     parent?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.7.4",
+    "version": "1.8.0",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",