mcp-probe-kit 1.15.1 → 2.0.0

package/build/schemas/structured-output.js

@@ -0,0 +1,1017 @@
+/**
+ * 结构化输出 Schema 定义（P0 工具）
+ * 用于 MCP 2025-11-25 协议的 structuredContent
+ *
+ * 注意：其他工具的 Schema 已按功能分类到 src/schemas/output/ 目录：
+ * - core-tools.ts: 核心开发工具 (code_review, debug, fix_bug, gentest, refactor, security_scan, perf)
+ * - generation-tools.ts: 代码生成工具 (gendoc, genapi, gensql, genreadme, genui, gen_mock, etc.)
+ * - workflow-tools.ts: 工作流编排工具 (start_review, start_release, start_refactor, start_api, start_doc)
+ * - project-tools.ts: 项目管理工具 (init_project, add_feature, analyze_project, estimate, etc.)
+ * - ui-ux-tools.ts: UI/UX 工具 (ui_design_system, ui_search, design2code, etc.)
+ * - helper-tools.ts: 辅助工具 (detect_shell, init_setting, gen_skill)
+ *
+ * 使用方式：
+ * import { CodeReviewReportSchema, DebugReportSchema } from '@/schemas/output';
+ */
+/**
+ * Commit Message Schema
+ * 用于 gencommit 工具的结构化输出
+ */
+export const CommitMessageSchema = {
+    type: 'object',
+    properties: {
+        type: {
+            type: 'string',
+            description: 'Commit 类型：feat/fix/docs/refactor/test/chore/style/perf',
+            enum: ['feat', 'fix', 'docs', 'refactor', 'test', 'chore', 'style', 'perf', 'ci', 'build', 'revert'],
+        },
+        scope: {
+            type: 'string',
+            description: 'Commit 范围（可选）',
+        },
+        subject: {
+            type: 'string',
+            description: 'Commit 主题（简短描述）',
+        },
+        body: {
+            type: 'string',
+            description: 'Commit 正文（详细描述）',
+        },
+        footer: {
+            type: 'string',
+            description: 'Commit 页脚（Breaking Changes、Issue 引用等）',
+        },
+        fullMessage: {
+            type: 'string',
+            description: '完整的 commit message（可直接使用）',
+        },
+        emoji: {
+            type: 'string',
+            description: 'Emoji 前缀（如果使用 conventional+emoji 风格）',
+        },
+    },
+    required: ['type', 'subject', 'fullMessage'],
+};
+/**
+ * Workflow Report Schema
+ * 用于 start_* 编排工具的结构化输出
+ */
+export const WorkflowReportSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '工作流执行摘要（一句话）',
+        },
+        status: {
+            type: 'string',
+            description: '执行状态',
+            enum: ['success', 'partial', 'failed', 'pending'],
+        },
+        steps: {
+            type: 'array',
+            description: '执行步骤列表',
+            items: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: '步骤名称',
+                    },
+                    status: {
+                        type: 'string',
+                        description: '步骤状态',
+                        enum: ['completed', 'skipped', 'failed', 'pending'],
+                    },
+                    description: {
+                        type: 'string',
+                        description: '步骤描述',
+                    },
+                    output: {
+                        type: 'string',
+                        description: '步骤输出（可选）',
+                    },
+                },
+                required: ['name', 'status'],
+            },
+        },
+        artifacts: {
+            type: 'array',
+            description: '生成的文件/产物',
+            items: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: '文件路径',
+                    },
+                    type: {
+                        type: 'string',
+                        description: '文件类型',
+                        enum: ['code', 'doc', 'config', 'test', 'spec'],
+                    },
+                    purpose: {
+                        type: 'string',
+                        description: '文件用途',
+                    },
+                    content: {
+                        type: 'string',
+                        description: '文件内容（可选）',
+                    },
+                },
+                required: ['path', 'type', 'purpose'],
+            },
+        },
+        nextSteps: {
+            type: 'array',
+            description: '后续建议步骤',
+            items: {
+                type: 'string',
+            },
+        },
+        warnings: {
+            type: 'array',
+            description: '警告信息',
+            items: {
+                type: 'string',
+            },
+        },
+        metadata: {
+            type: 'object',
+            description: '额外元数据（工具特定）',
+            additionalProperties: true,
+        },
+    },
+    required: ['summary', 'status', 'steps'],
+};
+/**
+ * Bug Fix Report Schema
+ * 用于 start_bugfix 的特定字段
+ */
+export const BugFixReportSchema = {
+    type: 'object',
+    allOf: [
+        { $ref: '#/definitions/WorkflowReport' },
+    ],
+    properties: {
+        rootCause: {
+            type: 'string',
+            description: '根本原因分析',
+        },
+        fixPlan: {
+            type: 'string',
+            description: '修复方案',
+        },
+        testPlan: {
+            type: 'string',
+            description: '测试计划',
+        },
+        commitDraft: {
+            type: 'object',
+            description: '提交草稿（使用 CommitMessageSchema）',
+        },
+        affectedFiles: {
+            type: 'array',
+            description: '受影响的文件',
+            items: {
+                type: 'string',
+            },
+        },
+    },
+    required: ['rootCause', 'fixPlan', 'testPlan'],
+};
+/**
+ * Feature Development Report Schema
+ * 用于 start_feature 的特定字段
+ */
+export const FeatureReportSchema = {
+    type: 'object',
+    allOf: [
+        { $ref: '#/definitions/WorkflowReport' },
+    ],
+    properties: {
+        specArtifacts: {
+            type: 'array',
+            description: '规格文档产物',
+            items: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: '文档路径',
+                    },
+                    type: {
+                        type: 'string',
+                        description: '文档类型',
+                        enum: ['requirements', 'design', 'tasks', 'api-spec'],
+                    },
+                },
+                required: ['path', 'type'],
+            },
+        },
+        estimate: {
+            type: 'object',
+            description: '工作量估算',
+            properties: {
+                storyPoints: {
+                    type: 'number',
+                    description: '故事点',
+                },
+                optimistic: {
+                    type: 'string',
+                    description: '乐观估计（如 "2-3天"）',
+                },
+                normal: {
+                    type: 'string',
+                    description: '正常估计',
+                },
+                pessimistic: {
+                    type: 'string',
+                    description: '悲观估计',
+                },
+            },
+        },
+        dependencies: {
+            type: 'array',
+            description: '依赖项',
+            items: {
+                type: 'string',
+            },
+        },
+    },
+    required: ['specArtifacts', 'estimate'],
+};
+/**
+ * UI Development Report Schema
+ * 用于 start_ui 的特定字段
+ */
+export const UIReportSchema = {
+    type: 'object',
+    allOf: [
+        { $ref: '#/definitions/WorkflowReport' },
+    ],
+    properties: {
+        designSystem: {
+            type: 'object',
+            description: '设计系统配置',
+            properties: {
+                colors: {
+                    type: 'object',
+                    description: '色彩系统',
+                },
+                typography: {
+                    type: 'object',
+                    description: '字体系统',
+                },
+                spacing: {
+                    type: 'object',
+                    description: '间距系统',
+                },
+            },
+        },
+        catalog: {
+            type: 'object',
+            description: '组件目录',
+            properties: {
+                components: {
+                    type: 'array',
+                    description: '可用组件列表',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: {
+                                type: 'string',
+                            },
+                            category: {
+                                type: 'string',
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        renderedCode: {
+            type: 'object',
+            description: '渲染的代码',
+            properties: {
+                framework: {
+                    type: 'string',
+                    description: '框架',
+                    enum: ['react', 'vue', 'html'],
+                },
+                code: {
+                    type: 'string',
+                    description: '生成的代码',
+                },
+            },
+        },
+        consistencyRules: {
+            type: 'array',
+            description: '一致性规则',
+            items: {
+                type: 'string',
+            },
+        },
+    },
+    required: ['designSystem', 'renderedCode'],
+};
+/**
+ * Onboarding Report Schema
+ * 用于 start_onboard 的特定字段
+ */
+export const OnboardingReportSchema = {
+    type: 'object',
+    allOf: [
+        { $ref: '#/definitions/WorkflowReport' },
+    ],
+    properties: {
+        projectSummary: {
+            type: 'object',
+            description: '项目概览',
+            properties: {
+                name: {
+                    type: 'string',
+                },
+                description: {
+                    type: 'string',
+                },
+                techStack: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                    },
+                },
+                architecture: {
+                    type: 'string',
+                },
+            },
+        },
+        architectureNotes: {
+            type: 'string',
+            description: '架构说明',
+        },
+        quickstart: {
+            type: 'object',
+            description: '快速开始指南',
+            properties: {
+                setup: {
+                    type: 'array',
+                    description: '设置步骤',
+                    items: {
+                        type: 'string',
+                    },
+                },
+                commonTasks: {
+                    type: 'array',
+                    description: '常见任务',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            task: {
+                                type: 'string',
+                            },
+                            command: {
+                                type: 'string',
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        keyFiles: {
+            type: 'array',
+            description: '关键文件',
+            items: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                    },
+                    purpose: {
+                        type: 'string',
+                    },
+                },
+            },
+        },
+    },
+    required: ['projectSummary', 'quickstart'],
+};
+/**
+ * Ralph Loop Report Schema
+ * 用于 start_ralph 的特定字段
+ */
+export const RalphLoopReportSchema = {
+    type: 'object',
+    allOf: [
+        { $ref: '#/definitions/WorkflowReport' },
+    ],
+    properties: {
+        loopPolicy: {
+            type: 'object',
+            description: '循环策略',
+            properties: {
+                maxIterations: {
+                    type: 'number',
+                    description: '最大迭代次数',
+                },
+                maxMinutes: {
+                    type: 'number',
+                    description: '最大运行分钟数',
+                },
+                confirmEvery: {
+                    type: 'number',
+                    description: '每几轮确认一次',
+                },
+                cooldownSeconds: {
+                    type: 'number',
+                    description: '冷却秒数',
+                },
+            },
+        },
+        iterations: {
+            type: 'array',
+            description: '迭代历史',
+            items: {
+                type: 'object',
+                properties: {
+                    iteration: {
+                        type: 'number',
+                    },
+                    status: {
+                        type: 'string',
+                        enum: ['success', 'failed', 'stopped'],
+                    },
+                    testsPass: {
+                        type: 'boolean',
+                    },
+                    changes: {
+                        type: 'string',
+                        description: 'Git diff 摘要',
+                    },
+                },
+            },
+        },
+        stopConditions: {
+            type: 'object',
+            description: '停止条件',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: '停止原因',
+                },
+                metConditions: {
+                    type: 'array',
+                    description: '满足的条件',
+                    items: {
+                        type: 'string',
+                    },
+                },
+            },
+        },
+        safetyChecks: {
+            type: 'array',
+            description: '安全检查结果',
+            items: {
+                type: 'object',
+                properties: {
+                    check: {
+                        type: 'string',
+                    },
+                    passed: {
+                        type: 'boolean',
+                    },
+                    message: {
+                        type: 'string',
+                    },
+                },
+            },
+        },
+    },
+    required: ['loopPolicy', 'iterations', 'stopConditions'],
+};
+// ============================================================================
+// 第 2 组: P1 高价值工具 Schema（7 个）
+// ============================================================================
+/**
+ * Code Review Report Schema
+ * 用于 code_review 工具的结构化输出
+ */
+export const CodeReviewReportSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '审查总结',
+        },
+        overallScore: {
+            type: 'number',
+            minimum: 0,
+            maximum: 100,
+            description: '总体评分（0-100）',
+        },
+        issues: {
+            type: 'array',
+            description: '问题列表',
+            items: {
+                type: 'object',
+                properties: {
+                    severity: {
+                        type: 'string',
+                        enum: ['critical', 'high', 'medium', 'low', 'info'],
+                        description: '严重程度',
+                    },
+                    category: {
+                        type: 'string',
+                        enum: ['security', 'performance', 'quality', 'style', 'best-practice'],
+                        description: '问题类别',
+                    },
+                    line: {
+                        type: 'number',
+                        description: '行号',
+                    },
+                    file: {
+                        type: 'string',
+                        description: '文件路径',
+                    },
+                    message: {
+                        type: 'string',
+                        description: '问题描述',
+                    },
+                    suggestion: {
+                        type: 'string',
+                        description: '修复建议',
+                    },
+                    code: {
+                        type: 'string',
+                        description: '问题代码片段',
+                    },
+                },
+                required: ['severity', 'category', 'message'],
+            },
+        },
+        strengths: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '代码优点',
+        },
+        recommendations: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '改进建议',
+        },
+        metrics: {
+            type: 'object',
+            description: '代码指标',
+            properties: {
+                complexity: { type: 'number', description: '复杂度' },
+                maintainability: { type: 'number', description: '可维护性' },
+                testCoverage: { type: 'number', description: '测试覆盖率' },
+            },
+        },
+    },
+    required: ['summary', 'overallScore', 'issues'],
+};
+/**
+ * Debug Report Schema
+ * 用于 debug 工具的结构化输出
+ */
+export const DebugReportSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '调试摘要',
+        },
+        rootCause: {
+            type: 'string',
+            description: '根本原因分析',
+        },
+        errorType: {
+            type: 'string',
+            enum: ['syntax', 'runtime', 'logic', 'performance', 'memory', 'network', 'unknown'],
+            description: '错误类型',
+        },
+        location: {
+            type: 'object',
+            description: '错误位置',
+            properties: {
+                file: { type: 'string' },
+                line: { type: 'number' },
+                column: { type: 'number' },
+                function: { type: 'string' },
+            },
+        },
+        stackTrace: {
+            type: 'array',
+            description: '堆栈跟踪',
+            items: {
+                type: 'object',
+                properties: {
+                    file: { type: 'string' },
+                    line: { type: 'number' },
+                    function: { type: 'string' },
+                },
+            },
+        },
+        debugStrategy: {
+            type: 'array',
+            description: '调试策略',
+            items: { type: 'string' },
+        },
+        solutions: {
+            type: 'array',
+            description: '解决方案列表',
+            items: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    code: { type: 'string' },
+                    priority: { type: 'string', enum: ['high', 'medium', 'low'] },
+                },
+                required: ['title', 'description'],
+            },
+        },
+        relatedIssues: {
+            type: 'array',
+            description: '相关问题',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'rootCause', 'errorType', 'solutions'],
+};
+/**
+ * Bug Analysis Schema
+ * 用于 fix_bug 工具的结构化输出
+ */
+export const BugAnalysisSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: 'Bug 摘要',
+        },
+        bugType: {
+            type: 'string',
+            enum: ['functional', 'performance', 'security', 'ui', 'data', 'integration'],
+            description: 'Bug 类型',
+        },
+        severity: {
+            type: 'string',
+            enum: ['critical', 'high', 'medium', 'low'],
+            description: '严重程度',
+        },
+        rootCause: {
+            type: 'string',
+            description: '根本原因',
+        },
+        affectedComponents: {
+            type: 'array',
+            description: '受影响的组件',
+            items: { type: 'string' },
+        },
+        affectedFiles: {
+            type: 'array',
+            description: '受影响的文件',
+            items: { type: 'string' },
+        },
+        fixPlan: {
+            type: 'object',
+            description: '修复计划',
+            properties: {
+                steps: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                estimatedTime: { type: 'string' },
+                risks: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+            },
+            required: ['steps'],
+        },
+        testPlan: {
+            type: 'object',
+            description: '测试计划',
+            properties: {
+                unitTests: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                integrationTests: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                manualTests: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+            },
+        },
+        preventionMeasures: {
+            type: 'array',
+            description: '预防措施',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'bugType', 'severity', 'rootCause', 'fixPlan', 'testPlan'],
+};
+/**
+ * Test Suite Schema
+ * 用于 gentest 工具的结构化输出
+ */
+export const TestSuiteSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '测试套件摘要',
+        },
+        framework: {
+            type: 'string',
+            enum: ['jest', 'vitest', 'mocha', 'jasmine', 'pytest', 'junit'],
+            description: '测试框架',
+        },
+        testCases: {
+            type: 'array',
+            description: '测试用例列表',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: '测试名称' },
+                    description: { type: 'string', description: '测试描述' },
+                    type: {
+                        type: 'string',
+                        enum: ['unit', 'integration', 'e2e', 'performance'],
+                        description: '测试类型',
+                    },
+                    code: { type: 'string', description: '测试代码' },
+                    assertions: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: '断言列表',
+                    },
+                },
+                required: ['name', 'type', 'code'],
+            },
+        },
+        edgeCases: {
+            type: 'array',
+            description: '边界条件测试',
+            items: {
+                type: 'object',
+                properties: {
+                    scenario: { type: 'string' },
+                    input: { type: 'string' },
+                    expectedOutput: { type: 'string' },
+                },
+            },
+        },
+        mockData: {
+            type: 'object',
+            description: 'Mock 数据定义',
+            additionalProperties: true,
+        },
+        coverage: {
+            type: 'object',
+            description: '覆盖率目标',
+            properties: {
+                statements: { type: 'number' },
+                branches: { type: 'number' },
+                functions: { type: 'number' },
+                lines: { type: 'number' },
+            },
+        },
+    },
+    required: ['summary', 'framework', 'testCases'],
+};
+/**
+ * Refactor Plan Schema
+ * 用于 refactor 工具的结构化输出
+ */
+export const RefactorPlanSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '重构摘要',
+        },
+        goal: {
+            type: 'string',
+            enum: ['improve_readability', 'reduce_complexity', 'improve_performance', 'improve_maintainability', 'modernize'],
+            description: '重构目标',
+        },
+        currentIssues: {
+            type: 'array',
+            description: '当前问题',
+            items: { type: 'string' },
+        },
+        refactoringSteps: {
+            type: 'array',
+            description: '重构步骤',
+            items: {
+                type: 'object',
+                properties: {
+                    step: { type: 'number' },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    before: { type: 'string', description: '重构前代码' },
+                    after: { type: 'string', description: '重构后代码' },
+                    rationale: { type: 'string', description: '重构理由' },
+                },
+                required: ['step', 'title', 'description'],
+            },
+        },
+        riskAssessment: {
+            type: 'object',
+            description: '风险评估',
+            properties: {
+                level: { type: 'string', enum: ['low', 'medium', 'high'] },
+                risks: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                mitigations: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+            },
+            required: ['level', 'risks'],
+        },
+        rollbackPlan: {
+            type: 'string',
+            description: '回滚计划',
+        },
+        estimatedEffort: {
+            type: 'object',
+            description: '预估工作量',
+            properties: {
+                hours: { type: 'number' },
+                complexity: { type: 'string', enum: ['low', 'medium', 'high'] },
+            },
+        },
+        expectedBenefits: {
+            type: 'array',
+            description: '预期收益',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'goal', 'refactoringSteps', 'riskAssessment'],
+};
+/**
+ * Security Report Schema
+ * 用于 security_scan 工具的结构化输出
+ */
+export const SecurityReportSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '安全扫描摘要',
+        },
+        overallRisk: {
+            type: 'string',
+            enum: ['critical', 'high', 'medium', 'low', 'none'],
+            description: '总体风险等级',
+        },
+        vulnerabilities: {
+            type: 'array',
+            description: '漏洞列表',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: '漏洞ID' },
+                    type: {
+                        type: 'string',
+                        enum: ['injection', 'xss', 'csrf', 'auth', 'crypto', 'data-exposure', 'dos', 'other'],
+                        description: '漏洞类型',
+                    },
+                    severity: {
+                        type: 'string',
+                        enum: ['critical', 'high', 'medium', 'low'],
+                        description: '严重程度',
+                    },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    location: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string' },
+                            line: { type: 'number' },
+                            code: { type: 'string' },
+                        },
+                    },
+                    cwe: { type: 'string', description: 'CWE编号' },
+                    cvss: { type: 'number', description: 'CVSS评分' },
+                    remediation: { type: 'string', description: '修复建议' },
+                    references: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: '参考链接',
+                    },
+                },
+                required: ['type', 'severity', 'title', 'description'],
+            },
+        },
+        complianceChecks: {
+            type: 'array',
+            description: '合规性检查',
+            items: {
+                type: 'object',
+                properties: {
+                    standard: { type: 'string', description: '标准名称（如OWASP Top 10）' },
+                    passed: { type: 'boolean' },
+                    details: { type: 'string' },
+                },
+            },
+        },
+        recommendations: {
+            type: 'array',
+            description: '安全建议',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'overallRisk', 'vulnerabilities'],
+};
+/**
+ * Performance Report Schema
+ * 用于 perf 工具的结构化输出
+ */
+export const PerformanceReportSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '性能分析摘要',
+        },
+        overallScore: {
+            type: 'number',
+            minimum: 0,
+            maximum: 100,
+            description: '总体性能评分',
+        },
+        bottlenecks: {
+            type: 'array',
+            description: '性能瓶颈',
+            items: {
+                type: 'object',
+                properties: {
+                    type: {
+                        type: 'string',
+                        enum: ['algorithm', 'memory', 'database', 'network', 'rendering', 'io'],
+                        description: '瓶颈类型',
+                    },
+                    severity: {
+                        type: 'string',
+                        enum: ['critical', 'high', 'medium', 'low'],
+                    },
+                    location: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string' },
+                            line: { type: 'number' },
+                            function: { type: 'string' },
+                        },
+                    },
+                    description: { type: 'string' },
+                    impact: { type: 'string', description: '性能影响' },
+                    currentMetric: { type: 'string', description: '当前指标' },
+                },
+                required: ['type', 'severity', 'description'],
+            },
+        },
+        metrics: {
+            type: 'object',
+            description: '性能指标',
+            properties: {
+                executionTime: { type: 'number', description: '执行时间（ms）' },
+                memoryUsage: { type: 'number', description: '内存使用（MB）' },
+                cpuUsage: { type: 'number', description: 'CPU使用率（%）' },
+                throughput: { type: 'number', description: '吞吐量' },
+                latency: { type: 'number', description: '延迟（ms）' },
+            },
+        },
+        optimizations: {
+            type: 'array',
+            description: '优化建议',
+            items: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    priority: { type: 'string', enum: ['high', 'medium', 'low'] },
+                    expectedImprovement: { type: 'string', description: '预期提升' },
+                    implementation: { type: 'string', description: '实现方法' },
+                },
+                required: ['title', 'description', 'priority'],
+            },
+        },
+        benchmarks: {
+            type: 'object',
+            description: '基准测试结果',
+            additionalProperties: true,
+        },
+    },
+    required: ['summary', 'overallScore', 'bottlenecks', 'optimizations'],
+};