mcp-probe-kit 2.0.2 → 2.1.1

package/build/lib/task-generator.js

@@ -0,0 +1,109 @@
+/**
+ * 任务生成器
+ *
+ * 将分析任务转换为格式化的指导文本
+ */
+/**
+ * 生成完整的分析任务指导文本
+ */
+export function generateTaskGuide(detection, tasks, docsDir) {
+    const guide = `# 项目上下文初始化 - 智能分析工作流
+
+⚠️ **重要说明**：本工具采用"分析任务"模式，不提供固定模板，而是指导你分析项目实际代码，生成真正有用的文档。
+
+---
+
+## 📊 项目检测结果
+
+- **语言**：${detection.language}
+- **框架**：${detection.framework || '未检测到'}
+- **类型**：${detection.category}
+- **置信度**：${detection.confidence}%
+- **检测依据**：${detection.indicators.join(', ')}
+
+---
+
+## 📋 需要生成的文档
+
+根据项目类型，需要生成 **${tasks.length}** 个文档：
+
+${tasks.map((task, i) => `${i + 1}. \`${task.document}\` - ${task.title}`).join('\n')}
+
+---
+
+## 🔍 分析任务清单
+
+请按照以下任务清单，逐个分析并生成文档。
+
+${tasks.map((task, index) => generateSingleTaskGuide(task, index + 1, docsDir)).join('\n\n---\n\n')}
+
+---
+
+## ✅ 完成标准
+
+完成后，请确认：
+
+- [ ] 已调用 fsWrite 工具 **${tasks.length}** 次
+- [ ] 每个文档都包含真实的文件路径（不是占位符 [xxx]）
+- [ ] 每个文档都包含实际的代码示例（从项目中提取）
+- [ ] 每个文档都回答了分析任务中的所有问题
+- [ ] 每个文档都满足了内容要求
+
+---
+
+**工具**：MCP Probe Kit - init_project_context
+**版本**：2.1.0
+`;
+    return guide;
+}
+/**
+ * 生成单个任务的指导文本
+ */
+function generateSingleTaskGuide(task, index, docsDir) {
+    return `### 任务 ${index}：${task.title}
+
+**文档**：\`${docsDir}/project-context/${task.document}\`
+**用途**：${task.purpose}
+
+#### 🔍 第一步：发现（Discover）
+
+${task.analysis.discover.description}
+
+**搜索位置**：
+${task.analysis.discover.locations.map(loc => `- \`${loc}\``).join('\n')}
+
+**寻找模式**：
+${task.analysis.discover.patterns.map(p => `- ${p}`).join('\n')}
+
+**目标**：找到 **${task.analysis.discover.examples}** 个现有示例作为参考
+
+#### 📊 第二步：分析（Analyze）
+
+${task.analysis.analyze.description}
+
+**需要回答的问题**：
+${task.analysis.analyze.questions.map((q, i) => `${i + 1}. ${q}`).join('\n')}
+
+**需要提取的信息**：
+${task.analysis.analyze.extract.map(e => `- ${e}`).join('\n')}
+
+#### 📝 第三步：生成（Generate）
+
+${task.analysis.generate.description}
+
+**文档结构**：
+\`\`\`
+${task.analysis.generate.structure.join('\n')}
+\`\`\`
+
+**内容要求**：
+${task.analysis.generate.requirements.map(r => `- ${r}`).join('\n')}
+
+#### ✅ 完成标准
+
+- [ ] 已找到现有示例
+- [ ] 已回答所有分析问题
+- [ ] 已提取所有必要信息
+- [ ] 已使用 fsWrite 创建文档：\`${docsDir}/project-context/${task.document}\`
+- [ ] 文档内容符合所有要求`;
+}

package/build/lib/template-generator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 模板生成器
+ *
+ * 根据项目类型、语言、框架生成具体的文档模板内容
+ */
+import type { ProjectDetectionResult } from './project-detector.js';
+import type { DocumentTemplate } from './document-templates.js';
+/**
+ * 生成文档模板内容
+ */
+export declare function generateTemplateContent(doc: DocumentTemplate, detection: ProjectDetectionResult): string;
+export * from './templates/backend-templates.js';
+export * from './templates/frontend-templates.js';
+export * from './templates/fullstack-templates.js';

package/build/lib/template-generator.js

@@ -0,0 +1,62 @@
+/**
+ * 模板生成器
+ *
+ * 根据项目类型、语言、框架生成具体的文档模板内容
+ */
+/**
+ * 生成文档模板内容
+ */
+export function generateTemplateContent(doc, detection) {
+    const { language, framework, category } = detection;
+    // 根据文档类型选择生成器
+    const generator = templateGenerators[doc.filename];
+    if (!generator) {
+        return generateGenericTemplate(doc, detection);
+    }
+    return generator(detection);
+}
+/**
+ * 模板生成器映射
+ */
+const templateGenerators = {
+    'how-to-add-api.md': generateHowToAddApiTemplate,
+    'how-to-database.md': generateHowToDatabaseTemplate,
+    'how-to-auth.md': generateHowToAuthTemplate,
+    'how-to-test.md': generateHowToTestTemplate,
+    'how-to-deploy.md': generateHowToDeployTemplate,
+    'how-to-new-page.md': generateHowToNewPageTemplate,
+    'how-to-call-api.md': generateHowToCallApiTemplate,
+    'how-to-state.md': generateHowToStateTemplate,
+    'how-to-routing.md': generateHowToRoutingTemplate,
+    'how-to-styling.md': generateHowToStylingTemplate,
+    'how-to-new-feature.md': generateHowToNewFeatureTemplate,
+    'how-to-api-route.md': generateHowToApiRouteTemplate,
+    // ... 其他模板生成器
+};
+/**
+ * 通用模板生成器
+ */
+function generateGenericTemplate(doc, detection) {
+    return `# ${doc.title}
+
+> ${doc.purpose}
+
+## 项目信息
+- 语言：${detection.language}
+- 框架：${detection.framework || '未检测到'}
+- 类型：${detection.category}
+
+## 操作步骤
+
+请根据项目实际情况填写具体步骤。
+
+## 参考资料
+
+- 相关文档链接
+- 示例代码文件
+`;
+}
+// 导入各个模板生成器
+export * from './templates/backend-templates.js';
+export * from './templates/frontend-templates.js';
+export * from './templates/fullstack-templates.js';

package/build/lib/templates/backend-templates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 后端项目模板生成器
+ */
+import type { ProjectDetectionResult } from '../project-detector.js';
+/**
+ * 生成"如何添加新接口"模板
+ */
+export declare function generateHowToAddApiTemplate(detection: ProjectDetectionResult): string;

package/build/lib/templates/backend-templates.js

@@ -0,0 +1,26 @@
+/**
+ * 后端项目模板生成器
+ */
+/**
+ * 生成"如何添加新接口"模板
+ */
+export function generateHowToAddApiTemplate(detection) {
+    const { language, framework } = detection;
+    // 根据语言和框架选择模板
+    if (language === 'javascript' || language === 'typescript') {
+        return generateJSBackendApiTemplate(framework);
+    }
+    else if (language === 'python') {
+        return generatePythonBackendApiTemplate(framework);
+    }
+    else if (language === 'java') {
+        return generateJavaBackendApiTemplate(framework);
+    }
+    else if (language === 'go') {
+        return generateGoBackendApiTemplate(framework);
+    }
+    else if (language === 'rust') {
+        return generateRustBackendApiTemplate(framework);
+    }
+    return generateGenericBackendApiTemplate(detection);
+}

package/build/schemas/output/project-tools.d.ts

@@ -70,6 +70,11 @@ export declare const ProjectContextSchema: {
         readonly summary: {
             readonly type: "string";
         };
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["single", "modular"];
+            readonly description: "生成模式：single（单文件）或 modular（模块化）";
+        };
         readonly projectOverview: {
             readonly type: "object";
             readonly properties: {
@@ -568,6 +573,7 @@ export interface ProjectInit {
 }
 export interface ProjectContext {
     summary: string;
+    mode?: 'single' | 'modular';
     projectOverview: {
         name?: string;
         description?: string;

package/build/schemas/output/project-tools.js

@@ -46,6 +46,11 @@ export const ProjectContextSchema = {
     type: 'object',
     properties: {
         summary: { type: 'string' },
+        mode: {
+            type: 'string',
+            enum: ['single', 'modular'],
+            description: '生成模式：single（单文件）或 modular（模块化）'
+        },
         projectOverview: {
             type: 'object',
             properties: {

package/build/tools/__tests__/start_ui.unit.test.js

@@ -73,13 +73,13 @@ describe('start_ui 单元测试', () => {
             expect(result.isError).not.toBe(true);
             expect(result.content[0].text).toMatch(/快速开始|Quick Start/i);
         });
-        test('auto 模式返回未实现消息', async () => {
+        test('auto 模式返回智能计划', async () => {
             const result = await startUi({
                 description: '测试',
                 mode: 'auto'
             });
             expect(result.isError).toBe(false);
-            expect(result.content[0].text).toMatch(/尚未实现|not yet implemented/i);
+            expect(result.content[0].text).toMatch(/智能 UI 开发计划|智能分析结果/i);
         });
     });
     describe('输出格式', () => {

package/build/tools/init_project_context.d.ts

@@ -3,6 +3,7 @@
  *
  * @param args - 工具参数
  * @param args.docs_dir - 文档目录，默认 "docs"
- * @returns MCP 响应，包含项目分析指南
+ * @param args.project_root - 项目根目录，默认当前目录
+ * @returns MCP 响应，包含文档生成指导
  */
 export declare function initProjectContext(args: any): Promise<import("../lib/response.js").ToolResponse>;