mcp-probe-kit 1.0.0

package/build/tools/fix.js

@@ -0,0 +1,290 @@
+// fix 工具实现
+export async function fix(args) {
+    try {
+        const code = args?.code || "";
+        const type = args?.type || "all"; // lint, type, format, import, unused
+        const message = `请自动修复以下代码问题：
+
+📝 **代码内容**：
+${code || "请提供需要修复的代码"}
+
+🎯 **修复类型**：${type}
+
+---
+
+## 自动修复步骤
+
+### 第一步：识别问题
+
+执行以下检查：
+\`\`\`bash
+# Lint 检查
+npm run lint
+
+# TypeScript 类型检查
+tsc --noEmit
+
+# 格式化检查
+npm run format:check
+\`\`\`
+
+### 第二步：问题分类
+
+**1️⃣ Lint 错误**
+- ESLint 规则违反
+- 代码质量问题
+- 潜在 Bug
+
+**2️⃣ TypeScript 类型错误**
+- 类型不匹配
+- 缺少类型定义
+- 隐式 any
+
+**3️⃣ 格式化问题**
+- 缩进不一致
+- 引号风格
+- 分号使用
+- 换行规则
+
+**4️⃣ Import 问题**
+- 未使用的 import
+- 重复 import
+- Import 顺序混乱
+- 相对路径 vs 绝对路径
+
+**5️⃣ 未使用代码**
+- 未使用的变量
+- 未使用的函数
+- 死代码（Dead Code）
+
+---
+
+## 修复策略
+
+### 🔧 Lint 错误修复
+
+**常见问题和修复：**
+
+1. **no-unused-vars**
+\`\`\`typescript
+// ❌ Before
+const unusedVar = 123;
+function test() {
+  const result = compute();
+  return 42;
+}
+
+// ✅ After
+function test() {
+  return 42;
+}
+\`\`\`
+
+2. **no-console**
+\`\`\`typescript
+// ❌ Before
+console.log('debug info');
+
+// ✅ After (开发环境)
+if (process.env.NODE_ENV === 'development') {
+  console.log('debug info');
+}
+
+// ✅ After (使用 logger)
+logger.debug('debug info');
+\`\`\`
+
+3. **prefer-const**
+\`\`\`typescript
+// ❌ Before
+let value = 10;
+const result = value * 2;
+
+// ✅ After
+const value = 10;
+const result = value * 2;
+\`\`\`
+
+### 🔧 TypeScript 类型错误修复
+
+**常见问题和修复：**
+
+1. **隐式 any**
+\`\`\`typescript
+// ❌ Before
+function process(data) {
+  return data.value;
+}
+
+// ✅ After
+function process(data: { value: string }): string {
+  return data.value;
+}
+\`\`\`
+
+2. **类型不匹配**
+\`\`\`typescript
+// ❌ Before
+const num: number = "123";
+
+// ✅ After
+const num: number = 123;
+// 或
+const num: number = parseInt("123");
+\`\`\`
+
+3. **可能为 null/undefined**
+\`\`\`typescript
+// ❌ Before
+function getName(user) {
+  return user.name.toUpperCase();
+}
+
+// ✅ After
+function getName(user: User | null): string {
+  return user?.name?.toUpperCase() ?? 'Unknown';
+}
+\`\`\`
+
+### 🔧 Import 优化
+
+**修复策略：**
+
+\`\`\`typescript
+// ❌ Before
+import { useState, useEffect, useMemo } from 'react';
+import { Button } from './components/Button';
+import React from 'react';
+import { formatDate } from '../utils/date';
+import { api } from '../../services/api';
+
+// ✅ After
+// 外部依赖
+import React, { useEffect, useMemo, useState } from 'react';
+
+// 内部模块（按层级从远到近）
+import { api } from '../../services/api';
+import { formatDate } from '../utils/date';
+import { Button } from './components/Button';
+\`\`\`
+
+### 🔧 格式化修复
+
+**自动格式化：**
+\`\`\`bash
+# Prettier
+npm run format
+
+# ESLint 自动修复
+npm run lint:fix
+\`\`\`
+
+---
+
+## 批量修复命令
+
+**一键修复所有可自动修复的问题：**
+\`\`\`bash
+# 1. 格式化代码
+npm run format
+
+# 2. ESLint 自动修复
+npm run lint:fix
+
+# 3. 整理 import
+npx organize-imports-cli 'src/**/*.ts'
+
+# 4. 移除未使用的 import
+npx ts-unused-exports tsconfig.json --deleteUnusedFile
+
+# 5. TypeScript 类型检查
+tsc --noEmit
+\`\`\`
+
+---
+
+## 修复报告
+
+### 📊 问题统计
+- Lint 错误: X 个
+- 类型错误: Y 个
+- 格式问题: Z 个
+- Import 问题: W 个
+
+### ✅ 已自动修复
+1. [文件:行号] 问题描述 → 已修复
+2. [文件:行号] 问题描述 → 已修复
+
+### ⚠️ 需要手动处理
+1. [文件:行号] 问题描述 → 修复建议
+2. [文件:行号] 问题描述 → 修复建议
+
+### 📝 修复后的代码
+\`\`\`typescript
+// 完整的修复后代码
+\`\`\`
+
+---
+
+## 预防措施
+
+**配置自动修复：**
+
+\`\`\`.vscode/settings.json
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": true,
+    "source.organizeImports": true
+  },
+  "eslint.validate": [
+    "javascript",
+    "typescript",
+    "javascriptreact",
+    "typescriptreact"
+  ]
+}
+\`\`\`
+
+**Git Hooks（Husky）：**
+\`\`\`json
+{
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}
+\`\`\`
+
+---
+
+现在请开始分析代码问题并自动修复。`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 自动修复失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/genapi.d.ts

@@ -0,0 +1,13 @@
+export declare function genapi(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/genapi.js

@@ -0,0 +1,152 @@
+// genapi 工具实现
+export async function genapi(args) {
+    try {
+        const code = args?.code || "";
+        const format = args?.format || "markdown"; // markdown, openapi, jsdoc
+        const message = `请为以下代码生成 API 文档：
+
+📝 **代码**：
+${code || "请提供需要生成文档的代码（函数、类、API 端点等）"}
+
+📖 **文档格式**：${format}
+
+---
+
+🎯 **API 文档生成指南**：
+
+**基础信息**：
+- API 名称和描述
+- 版本信息
+- 基础 URL
+
+**详细文档**（每个端点/函数）：
+
+1. **功能描述**
+   - 简短说明（一句话）
+   - 详细描述（用途、场景）
+
+2. **请求参数**
+   | 参数名 | 类型 | 必填 | 描述 | 示例 |
+   |--------|------|------|------|------|
+   | id | string | 是 | 用户 ID | "12345" |
+   | name | string | 否 | 用户名 | "张三" |
+
+3. **返回值**
+   - 成功响应（状态码、数据结构、示例）
+   - 错误响应（错误码、错误信息）
+
+4. **示例代码**
+   \`\`\`typescript
+   // 请求示例
+   const response = await fetch('/api/users/123');
+   const data = await response.json();
+   
+   // 响应示例
+   {
+     "code": 200,
+     "data": {
+       "id": "123",
+       "name": "张三"
+     }
+   }
+   \`\`\`
+
+5. **注意事项**
+   - 权限要求
+   - 速率限制
+   - 废弃信息
+   - 相关链接
+
+---
+
+**Markdown 格式模板**：
+\`\`\`markdown
+# API 文档
+
+## 用户管理
+
+### 获取用户信息
+
+**接口地址**：\`GET /api/users/:id\`
+
+**功能描述**：根据用户 ID 获取用户详细信息
+
+**请求参数**：
+| 参数 | 类型 | 必填 | 描述 |
+|------|------|------|------|
+| id | string | 是 | 用户 ID |
+
+**返回示例**：
+\`\`\`json
+{
+  "code": 200,
+  "data": {
+    "id": "123",
+    "name": "张三",
+    "email": "zhangsan@example.com"
+  }
+}
+\`\`\`
+
+**错误码**：
+- 404: 用户不存在
+- 403: 无权限访问
+\`\`\`
+
+---
+
+**OpenAPI 3.0 格式模板**：
+\`\`\`yaml
+openapi: 3.0.0
+info:
+  title: User API
+  version: 1.0.0
+paths:
+  /api/users/{id}:
+    get:
+      summary: 获取用户信息
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: integer
+                  data:
+                    type: object
+\`\`\`
+
+---
+
+现在请根据上述代码生成完整的 API 文档，并将文档保存到项目的 \`docs/api/\` 目录。`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 生成 API 文档失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/genchangelog.d.ts

@@ -0,0 +1,13 @@
+export declare function genchangelog(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/genchangelog.js

@@ -0,0 +1,227 @@
+// genchangelog 工具实现
+export async function genchangelog(args) {
+    try {
+        const version = args?.version || "";
+        const from = args?.from || "";
+        const to = args?.to || "HEAD";
+        const message = `请生成项目的 CHANGELOG（变更日志）：
+
+📝 **版本信息**：
+${version || "请提供版本号（如：v1.2.0）"}
+
+📋 **Commit 范围**：
+从 ${from || "上一个 tag"} 到 ${to}
+
+---
+
+## Changelog 生成步骤
+
+### 第一步：获取 Commit 历史
+
+执行以下命令：
+\`\`\`bash
+# 查看 commit 历史
+git log ${from}..${to} --oneline --no-merges
+
+# 查看详细信息
+git log ${from}..${to} --pretty=format:"%h - %s (%an)" --no-merges
+
+# 查看所有 tags
+git tag -l
+
+# 查看贡献者
+git shortlog ${from}..${to} -sn
+\`\`\`
+
+### 第二步：分类 Commits
+
+按类型分组：
+- **✨ Features (feat)**：新功能
+- **🐛 Bug Fixes (fix)**：Bug 修复
+- **📝 Documentation (docs)**：文档变更
+- **💄 Styles (style)**：代码格式
+- **♻️ Refactoring (refactor)**：重构
+- **⚡ Performance (perf)**：性能优化
+- **✅ Tests (test)**：测试相关
+- **🔧 Chores (chore)**：构建/工具变更
+- **💥 BREAKING CHANGES**：破坏性变更
+
+### 第三步：生成 Changelog
+
+**格式标准**：[Keep a Changelog](https://keepachangelog.com/)
+
+\`\`\`markdown
+# 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).
+
+## [版本号] - YYYY-MM-DD
+
+### Added（新增）
+- 新功能 1 (#PR号)
+- 新功能 2 by @contributor
+
+### Changed（变更）
+- 修改的功能 1
+- 修改的功能 2
+
+### Deprecated（废弃）
+- 即将移除的功能
+
+### Removed（移除）
+- 已移除的功能
+
+### Fixed（修复）
+- Bug 修复 1 (#issue号)
+- Bug 修复 2
+
+### Security（安全）
+- 安全漏洞修复
+
+## [上一个版本] - YYYY-MM-DD
+
+...
+\`\`\`
+
+---
+
+## Changelog 模板
+
+\`\`\`markdown
+# Changelog
+
+## [${version || "1.2.0"}] - ${new Date().toISOString().split('T')[0]}
+
+### ✨ Added
+- 新增用户认证功能 (#123) [@contributor1]
+- 新增数据导出功能 (#125)
+- 新增邮件通知系统
+
+### 🔄 Changed
+- 优化数据库查询性能 (#130)
+- 更新 UI 设计风格
+- 升级依赖包到最新版本
+
+### 🗑️ Deprecated
+- \`oldAPI()\` 方法即将在 v2.0 中移除，请使用 \`newAPI()\`
+
+### ❌ Removed
+- 移除了废弃的 \`legacyFeature\`
+- 删除了未使用的配置项
+
+### 🐛 Fixed
+- 修复登录页面样式错误 (#128)
+- 修复数据分页显示问题 (#132)
+- 修复内存泄漏问题 (#135)
+
+### 🔒 Security
+- 修复 SQL 注入漏洞 (CVE-2024-XXXX)
+- 更新依赖以修复安全漏洞
+
+### 💥 BREAKING CHANGES
+- API 端点从 \`/api/v1/users\` 改为 \`/api/v2/users\`
+- 配置文件格式从 JSON 改为 YAML
+- 最低 Node.js 版本要求提升到 18.x
+
+### 📚 Documentation
+- 更新 README 文档
+- 添加 API 使用指南
+- 完善贡献指南
+
+### 🏗️ Infrastructure
+- 升级 CI/CD 流程
+- 添加 Docker 支持
+- 配置自动化测试
+
+### 👥 Contributors
+感谢以下贡献者：
+- @contributor1 - 3 commits
+- @contributor2 - 2 commits
+- @contributor3 - 1 commit
+
+**Full Changelog**: https://github.com/owner/repo/compare/v1.1.0...v${version || "1.2.0"}
+\`\`\`
+
+---
+
+## Changelog 最佳实践
+
+### 内容要求
+
+1. **明确说明变更**
+   - 用户能理解的语言（避免技术术语）
+   - 说明影响范围
+   - 提供迁移指南（破坏性变更）
+
+2. **链接相关 Issue/PR**
+   - 使用 (#123) 格式
+   - 方便追溯详细信息
+
+3. **归功贡献者**
+   - 使用 @username 格式
+   - 体现团队协作
+
+### 版本规范
+
+**语义化版本 (Semantic Versioning)**：
+- **Major (X.0.0)**：破坏性变更
+- **Minor (x.X.0)**：新功能（向后兼容）
+- **Patch (x.x.X)**：Bug 修复
+
+### 发布流程
+
+1. 更新 CHANGELOG.md
+2. 更新 package.json 版本号
+3. 创建 Git tag：\`git tag -a v1.2.0 -m "Release v1.2.0"\`
+4. 推送 tag：\`git push origin v1.2.0\`
+5. 发布 GitHub Release
+
+---
+
+## 自动化工具
+
+**推荐工具**：
+- **standard-version**：自动生成 changelog
+- **conventional-changelog**：基于 commit 生成
+- **semantic-release**：自动发布版本
+
+**使用示例**：
+\`\`\`bash
+# 安装
+npm install -D standard-version
+
+# 生成 changelog
+npx standard-version
+
+# 首次发布
+npx standard-version --first-release
+\`\`\`
+
+---
+
+现在请根据 commit 历史生成详细的 CHANGELOG.md 文件。`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 生成 Changelog 失败: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/gencommit.d.ts

@@ -0,0 +1,13 @@
+export declare function gencommit(args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;