@maxenlin/mcp-zentao-11-3 1.0.0-patch.1

package/dist/utils/suggestions.js

@@ -0,0 +1,200 @@
+/**
+ * 操作建议工具
+ * 根据当前上下文，建议下一步操作
+ */
+/**
+ * 根据需求上下文生成下一步建议
+ */
+export function suggestNextActionsForStory(story, hasRelatedBugs, hasTestCases) {
+    const suggestions = [];
+    // 如果需求是激活状态，建议创建任务
+    if (story.status === 'active' || story.status === 'draft') {
+        suggestions.push({
+            action: '创建开发任务',
+            description: `为需求 #${story.id} 创建开发任务`,
+            tool: 'createTaskFromStory',
+            toolArgs: { storyId: story.id },
+            priority: 'high'
+        });
+    }
+    // 如果有关联 Bug，建议查看
+    if (hasRelatedBugs) {
+        suggestions.push({
+            action: '查看关联 Bug',
+            description: `查看需求 #${story.id} 关联的所有 Bug`,
+            tool: 'getStoryRelatedBugs',
+            toolArgs: { storyId: story.id },
+            priority: 'medium'
+        });
+    }
+    // 如果没有测试用例，建议创建
+    if (!hasTestCases) {
+        suggestions.push({
+            action: '创建测试用例',
+            description: `为需求 #${story.id} 创建测试用例`,
+            tool: 'createTestCase',
+            toolArgs: { story: story.id },
+            priority: 'medium'
+        });
+    }
+    // 建议生成代码框架
+    suggestions.push({
+        action: '生成代码框架提示',
+        description: `根据需求 #${story.id} 生成代码框架提示`,
+        tool: 'generateCodePromptFromStory',
+        toolArgs: { storyId: story.id },
+        priority: 'medium'
+    });
+    // 建议分析复杂度
+    suggestions.push({
+        action: '分析需求复杂度',
+        description: `分析需求 #${story.id} 的开发复杂度`,
+        tool: 'analyzeStoryComplexity',
+        toolArgs: { storyId: story.id },
+        priority: 'low'
+    });
+    return suggestions;
+}
+/**
+ * 根据 Bug 上下文生成下一步建议
+ */
+export function suggestNextActionsForBug(bug, hasRelatedStory, isActive) {
+    const suggestions = [];
+    // 如果是激活状态的 Bug，建议创建修复任务
+    if (isActive) {
+        suggestions.push({
+            action: '创建修复任务',
+            description: `为 Bug #${bug.id} 创建修复任务`,
+            tool: 'createTaskFromBug',
+            toolArgs: { bugId: bug.id },
+            priority: 'high'
+        });
+    }
+    // 建议生成测试用例
+    suggestions.push({
+        action: '生成测试用例提示',
+        description: `根据 Bug #${bug.id} 生成测试用例提示`,
+        tool: 'generateTestPromptFromBug',
+        toolArgs: { bugId: bug.id },
+        priority: 'high'
+    });
+    // 如果有关联需求，建议查看
+    if (hasRelatedStory) {
+        suggestions.push({
+            action: '查看关联需求',
+            description: `查看 Bug #${bug.id} 关联的需求`,
+            tool: 'getBugRelatedStory',
+            toolArgs: { bugId: bug.id },
+            priority: 'medium'
+        });
+    }
+    // 建议分析优先级
+    suggestions.push({
+        action: '分析 Bug 优先级',
+        description: `分析 Bug #${bug.id} 的处理优先级`,
+        tool: 'analyzeBugPriority',
+        toolArgs: { bugId: bug.id },
+        priority: 'medium'
+    });
+    // 如果 Bug 已解决，建议标记为已解决
+    if (bug.status === 'resolved') {
+        suggestions.push({
+            action: '标记 Bug 为已关闭',
+            description: `将 Bug #${bug.id} 标记为已关闭`,
+            tool: 'resolveBug',
+            toolArgs: {
+                bugId: bug.id,
+                resolution: { resolution: 'fixed', comment: 'Bug 已修复并验证' }
+            },
+            priority: 'low'
+        });
+    }
+    return suggestions;
+}
+/**
+ * 根据任务上下文生成下一步建议
+ */
+export function suggestNextActionsForTask(task, isCompleted = false) {
+    const suggestions = [];
+    // 如果任务是待办状态，建议开始
+    if (task.status === 'wait') {
+        suggestions.push({
+            action: '开始任务',
+            description: `将任务 #${task.id} 状态更新为进行中`,
+            tool: 'updateTask',
+            toolArgs: {
+                taskId: task.id,
+                update: { status: 'doing' }
+            },
+            priority: 'high'
+        });
+    }
+    // 如果任务是进行中状态，建议完成
+    if (task.status === 'doing') {
+        suggestions.push({
+            action: '完成任务',
+            description: `将任务 #${task.id} 标记为已完成`,
+            tool: 'finishTask',
+            toolArgs: { taskId: task.id },
+            priority: 'high'
+        });
+    }
+    // 建议分析工作量
+    suggestions.push({
+        action: '分析任务工作量',
+        description: `分析任务 #${task.id} 的工作量`,
+        tool: 'analyzeTaskWorkload',
+        toolArgs: { taskId: task.id },
+        priority: 'low'
+    });
+    // 如果有关联需求，建议查看
+    if (task.story) {
+        suggestions.push({
+            action: '查看关联需求',
+            description: `查看任务 #${task.id} 关联的需求`,
+            tool: 'getStoryDetail',
+            toolArgs: { storyId: typeof task.story === 'string' ? parseInt(task.story) : task.story },
+            priority: 'medium'
+        });
+    }
+    return suggestions;
+}
+/**
+ * 格式化建议为 Markdown
+ */
+export function formatSuggestionsAsMarkdown(suggestions) {
+    if (suggestions.length === 0) {
+        return '暂无建议操作。';
+    }
+    const lines = [];
+    lines.push('## 💡 建议下一步操作\n');
+    // 按优先级分组
+    const highPriority = suggestions.filter(s => s.priority === 'high');
+    const mediumPriority = suggestions.filter(s => s.priority === 'medium');
+    const lowPriority = suggestions.filter(s => s.priority === 'low');
+    const formatGroup = (group, title) => {
+        if (group.length === 0)
+            return;
+        lines.push(`### ${title}\n`);
+        group.forEach((suggestion, index) => {
+            lines.push(`${index + 1}. **${suggestion.action}**`);
+            lines.push(`   - ${suggestion.description}`);
+            if (suggestion.tool) {
+                lines.push(`   - 工具: \`${suggestion.tool}\``);
+            }
+            lines.push('');
+        });
+    };
+    if (highPriority.length > 0) {
+        formatGroup(highPriority, '🔴 高优先级');
+    }
+    if (mediumPriority.length > 0) {
+        formatGroup(mediumPriority, '🟡 中优先级');
+    }
+    if (lowPriority.length > 0) {
+        formatGroup(lowPriority, '🟢 低优先级');
+    }
+    lines.push('---\n');
+    lines.push('💬 **提示**: 你可以直接告诉我你想执行哪个操作，例如："执行第1个操作"、"创建开发任务"等。\n');
+    return lines.join('\n');
+}

package/dist/zentaoLegacyApi.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 禅道旧版API (11.x版本)
+ * 使用Session认证方式
+ */
+import { Bug, Task, Story, StoryStatus, TestCase, TestCaseStatus, TestResult, TestTask, CreateTestCaseRequest, TestRunRequest, Product, TaskUpdate, BugResolution } from './types.js';
+import { ZentaoConfig } from './config.js';
+export declare class ZentaoLegacyAPI {
+    private config;
+    private client;
+    private sessionId;
+    constructor(config: ZentaoConfig);
+    /**
+     * 获取SessionID
+     */
+    private getSessionId;
+    /**
+     * 登录
+     */
+    private login;
+    /**
+     * 确保已登录
+     */
+    private ensureLoggedIn;
+    /**
+     * 发起请求
+     */
+    private request;
+    /**
+     * POST请求
+     */
+    private postRequest;
+    /**
+     * 获取产品列表
+     */
+    getProducts(): Promise<Product[]>;
+    /**
+     * 获取产品的模块树
+     * @param productId 产品ID
+     * @returns 模块树对象，key是模块ID，value是模块名称
+     */
+    getProductModules(productId: number): Promise<Record<string, string>>;
+    /**
+     * 获取我的任务列表
+     */
+    getMyTasks(): Promise<Task[]>;
+    /**
+     * 获取任务详情
+     */
+    getTaskDetail(taskId: number): Promise<Task>;
+    /**
+     * 获取我的Bug列表
+     */
+    getMyBugs(): Promise<Bug[]>;
+    /**
+     * 获取Bug详情
+     */
+    getBugDetail(bugId: number): Promise<Bug>;
+    /**
+     * 更新任务
+     */
+    updateTask(taskId: number, update: TaskUpdate): Promise<Task>;
+    /**
+     * 完成任务
+     */
+    finishTask(taskId: number, update: TaskUpdate): Promise<void>;
+    /**
+     * 解决Bug
+     */
+    resolveBug(bugId: number, resolution: BugResolution): Promise<void>;
+    /**
+     * 获取产品的需求列表（支持分页，自动获取所有需求）
+     */
+    getProductStories(productId: number, status?: StoryStatus): Promise<Story[]>;
+    /**
+     * 获取需求详情
+     */
+    getStoryDetail(storyId: number): Promise<Story>;
+    /**
+     * 下载需求中的图片文件
+     */
+    downloadStoryImage(imageUrl: string): Promise<Buffer>;
+    /**
+     * 提取需求描述中的所有图片URL
+     */
+    extractImageUrls(spec: string): string[];
+    /**
+     * 提取需求描述中的文件ID
+     */
+    extractFileIds(spec: string): string[];
+    /**
+     * 搜索需求（通过关键字）
+     * 由于禅道11.3的搜索API权限限制，我们通过获取所有产品的需求然后本地过滤
+     */
+    searchStories(keyword: string, options?: {
+        productId?: number;
+        status?: StoryStatus;
+        limit?: number;
+    }): Promise<Story[]>;
+    /**
+     * 按产品名称搜索需求
+     */
+    searchStoriesByProductName(productName: string, keyword: string, options?: {
+        status?: StoryStatus;
+        limit?: number;
+    }): Promise<{
+        product: Product;
+        stories: Story[];
+    }[]>;
+    /**
+     * 获取产品的测试用例列表
+     * @param productId 产品ID
+     * @param status 用例状态
+     * @param moduleId 模块ID（可选）
+     */
+    getProductTestCases(productId: number, status?: TestCaseStatus, moduleId?: number): Promise<TestCase[]>;
+    /**
+     * 获取测试用例详情
+     */
+    getTestCaseDetail(caseId: number): Promise<TestCase>;
+    /**
+     * 创建测试用例
+     */
+    createTestCase(testCase: CreateTestCaseRequest): Promise<number>;
+    /**
+     * 获取需求的测试用例
+     */
+    getStoryTestCases(storyId: number): Promise<TestCase[]>;
+    /**
+     * 获取测试单列表
+     */
+    getTestTasks(productId?: number): Promise<TestTask[]>;
+    /**
+     * 获取测试单详情
+     */
+    getTestTaskDetail(taskId: number): Promise<TestTask>;
+    /**
+     * 获取测试单的测试结果
+     */
+    getTestTaskResults(taskId: number): Promise<TestResult[]>;
+    /**
+     * 执行测试用例
+     */
+    runTestCase(taskId: number, testRun: TestRunRequest): Promise<void>;
+    /**
+     * 获取需求关联的 Bug 列表
+     */
+    getStoryRelatedBugs(storyId: number): Promise<Bug[]>;
+    /**
+     * 获取 Bug 关联的需求
+     */
+    getBugRelatedStory(bugId: number): Promise<Story | null>;
+}