mcp-probe-kit 1.0.0

package/build/tools/index.d.ts

@@ -0,0 +1,22 @@
+export { detectShell } from "./detect_shell.js";
+export { initSetting } from "./init_setting.js";
+export { initProject } from "./init_project.js";
+export { gencommit } from "./gencommit.js";
+export { debug } from "./debug.js";
+export { genapi } from "./genapi.js";
+export { codeReview } from "./code_review.js";
+export { gentest } from "./gentest.js";
+export { genpr } from "./genpr.js";
+export { checkDeps } from "./check_deps.js";
+export { gendoc } from "./gendoc.js";
+export { genchangelog } from "./genchangelog.js";
+export { refactor } from "./refactor.js";
+export { perf } from "./perf.js";
+export { fix } from "./fix.js";
+export { gensql } from "./gensql.js";
+export { resolveConflict } from "./resolve_conflict.js";
+export { genui } from "./genui.js";
+export { explain } from "./explain.js";
+export { convert } from "./convert.js";
+export { genreadme } from "./genreadme.js";
+export { split } from "./split.js";

package/build/tools/index.js

@@ -0,0 +1,22 @@
+export { detectShell } from "./detect_shell.js";
+export { initSetting } from "./init_setting.js";
+export { initProject } from "./init_project.js";
+export { gencommit } from "./gencommit.js";
+export { debug } from "./debug.js";
+export { genapi } from "./genapi.js";
+export { codeReview } from "./code_review.js";
+export { gentest } from "./gentest.js";
+export { genpr } from "./genpr.js";
+export { checkDeps } from "./check_deps.js";
+export { gendoc } from "./gendoc.js";
+export { genchangelog } from "./genchangelog.js";
+export { refactor } from "./refactor.js";
+export { perf } from "./perf.js";
+export { fix } from "./fix.js";
+export { gensql } from "./gensql.js";
+export { resolveConflict } from "./resolve_conflict.js";
+export { genui } from "./genui.js";
+export { explain } from "./explain.js";
+export { convert } from "./convert.js";
+export { genreadme } from "./genreadme.js";
+export { split } from "./split.js";

package/build/tools/init_project.d.ts

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

package/build/tools/init_project.js

@@ -0,0 +1,142 @@
+// init_project 工具实现
+export async function initProject(args) {
+    try {
+        const input = args?.input || "";
+        const projectName = args?.project_name || "新项目";
+        const message = `你需要按照 Spec-Driven Development（规范驱动开发）的方式初始化项目，参考 https://github.com/github/spec-kit 的工作流程。
+
+📋 **项目需求**：
+${input}
+
+🎯 **初始化步骤**：
+
+**第一步：创建项目基础结构**
+在当前工作区创建以下目录和文件：
+
+\`\`\`
+.
+├── memory/
+│   └── constitution.md    # 项目宪法（核心原则和约束）
+├── specs/
+│   └── 001-${projectName.toLowerCase().replace(/\s+/g, '-')}/
+│       ├── spec.md        # 功能规格说明
+│       ├── plan.md        # 实现计划
+│       ├── tasks.md       # 任务分解
+│       └── research.md    # 技术调研
+├── scripts/
+│   ├── check-prerequisites.sh
+│   └── setup.sh
+└── templates/
+    ├── spec-template.md
+    ├── plan-template.md
+    └── tasks-template.md
+\`\`\`
+
+**第二步：生成 constitution.md**
+在 \`memory/constitution.md\` 中定义项目的核心原则，包括：
+- 代码风格规范
+- 架构原则
+- 安全准则
+- 测试要求
+- 文档标准
+
+**第三步：生成 spec.md（功能规格）**
+在 \`specs/001-${projectName.toLowerCase().replace(/\s+/g, '-')}/spec.md\` 中详细描述：
+- 项目背景和目标
+- 用户故事（User Stories）
+- 功能需求
+- 非功能需求
+- 约束条件
+- 验收标准
+
+**第四步：生成 plan.md（实现计划）**
+分析需求并生成实现计划，包括：
+- 技术栈选择（框架、数据库、部署方式等）
+- 系统架构设计
+- 模块划分
+- 数据模型设计
+- API 设计
+- 关键技术决策
+
+**第五步：生成 research.md（技术调研）**
+对选定的技术栈进行调研：
+- 确认版本兼容性
+- 识别潜在风险
+- 记录最佳实践
+- 列出参考文档
+
+**第六步：生成 tasks.md（任务分解）**
+将实现计划分解为可执行的任务，格式如下：
+\`\`\`markdown
+# 任务分解
+
+## 阶段 1：项目初始化
+- [ ] Task 1.1: 搭建项目骨架 (文件: ./setup.sh)
+- [ ] Task 1.2: 配置开发环境 (文件: ./devcontainer.json)
+- [ ] Task 1.3: [P] 初始化数据库 (文件: ./database/schema.sql)
+
+## 阶段 2：核心功能实现
+- [ ] Task 2.1: 实现数据模型 (文件: ./src/models/)
+- [ ] Task 2.2: [P] 实现用户认证 (文件: ./src/auth/)
+- [ ] Task 2.3: [P] 实现业务逻辑 (文件: ./src/services/)
+  依赖: Task 2.1
+
+## 阶段 3：API 开发
+- [ ] Task 3.1: 创建 REST API (文件: ./src/api/)
+  依赖: Task 2.2, Task 2.3
+- [ ] Task 3.2: [P] 编写 API 测试 (文件: ./tests/api/)
+
+## 阶段 4：前端开发
+- [ ] Task 4.1: 搭建前端框架 (文件: ./frontend/)
+- [ ] Task 4.2: [P] 实现 UI 组件 (文件: ./frontend/components/)
+- [ ] Task 4.3: [P] 集成 API (文件: ./frontend/services/)
+  依赖: Task 3.1
+
+## 阶段 5：测试与部署
+- [ ] Task 5.1: 集成测试 (文件: ./tests/integration/)
+- [ ] Task 5.2: 性能测试 (文件: ./tests/performance/)
+- [ ] Task 5.3: 部署配置 (文件: ./deploy/)
+
+---
+**标记说明**：
+- [P]: 可以并行执行的任务
+- 依赖: 必须在指定任务完成后才能开始
+\`\`\`
+
+**第七步：生成辅助脚本**
+创建项目管理脚本：
+- \`scripts/check-prerequisites.sh\`: 检查环境依赖
+- \`scripts/setup.sh\`: 自动化项目初始化
+- \`scripts/create-new-feature.sh\`: 创建新功能分支
+
+📝 **注意事项**：
+1. 所有文件使用 Markdown 格式，保持清晰的结构
+2. 遵循项目 constitution 中定义的原则
+3. 任务分解要足够细致，每个任务应该在 2-4 小时内完成
+4. 标记清楚任务之间的依赖关系
+5. 识别可以并行执行的任务以优化开发效率
+
+🚀 **开始执行**：
+现在请按照上述步骤创建项目结构和所有必需的文档。`;
+        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/init_setting.d.ts

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

package/build/tools/init_setting.js

@@ -0,0 +1,47 @@
+// init_setting 工具实现
+export async function initSetting(args) {
+    try {
+        // 要写入的配置
+        const settings = {
+            // 统一使用 Claude-4.5-Sonnet（Chat / Composer / Edit 三处都钉死，便于复现）
+            "ai.chatModel": "claude-sonnet-4-5",
+            "ai.composerModel": "claude-sonnet-4-5",
+            "ai.editModel": "claude-sonnet-4-5",
+            // 采样温度：0 更"严格/确定"，适合生成结构化/按规范的代码与 JSON
+            "ai.temperature": 0,
+            // 单次生成的最大 token（上限按平台限制，4096 对大多数修改/重构足够）
+            // "ai.maxTokens": 4096, // 保守：4096 平衡：8192 激进：16384
+            // ======================= 代码库上下文（让模型更懂你的项目） =======================
+            // 语义检索：用向量搜索理解项目，而不是仅靠邻近几行
+            "ai.contextEngine": "semantic",
+            // 检索深度：high 提高命中率（更"聪明"地找引用/类型/API 使用示例）
+            "ai.contextDepth": "high",
+            // 是否将代码库上下文喂给模型：日常开发建议开启
+            "ai.includeCodebaseContext": true, // 做模型指纹/一致性实验时 设置成：false
+            // 语义与邻近的折中策略：balanced（常用且稳）
+            "ai.contextStrategy": "balanced", // 做模型指纹/一致性实验时 设置成：neighboring
+        };
+        const message = `你要在项目的根目录下 .cursor/settings.json 文件内容追加以下内容，不要替换原有内容：
+${JSON.stringify(settings, null, 2)}`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: message,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 初始化配置失败: ${errorMessage}\n\n可能原因：\n- 没有文件写入权限\n- 不在 Cursor 工作区中\n- 路径错误`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/build/tools/perf.d.ts

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

package/build/tools/perf.js

@@ -0,0 +1,359 @@
+// perf 工具实现
+export async function perf(args) {
+    try {
+        const code = args?.code || "";
+        const type = args?.type || "all"; // algorithm, memory, react, database
+        const message = `请分析以下代码的性能问题并提供优化建议：
+
+📝 **代码内容**：
+${code || "请提供需要性能分析的代码"}
+
+🎯 **分析重点**：${type}
+
+---
+
+## 性能分析流程
+
+### 第一步：识别性能瓶颈
+
+**常见性能问题**：
+1. **时间复杂度过高**
+   - 嵌套循环 O(n²) 或更差
+   - 未优化的算法
+   - 重复计算
+
+2. **空间复杂度问题**
+   - 内存泄漏
+   - 大对象频繁创建
+   - 缓存滥用
+
+3. **I/O 阻塞**
+   - 同步 I/O 操作
+   - 未使用连接池
+   - 缺少缓存机制
+
+4. **渲染性能**
+   - 不必要的重渲染
+   - 大列表未虚拟化
+   - 图片未优化
+
+---
+
+## 性能优化指南
+
+### 1️⃣ 算法优化
+
+**复杂度分析**：
+\`\`\`
+O(1)    - 常数时间      ✅ 最优
+O(log n) - 对数时间      ✅ 很好
+O(n)     - 线性时间      ✅ 良好
+O(n log n) - 线性对数   ⚠️ 可接受
+O(n²)    - 平方时间      ⚠️ 注意
+O(2ⁿ)    - 指数时间      ❌ 避免
+O(n!)    - 阶乘时间      ❌ 严禁
+\`\`\`
+
+**优化技巧**：
+
+**示例 1：使用 Map 替代数组查找**
+\`\`\`typescript
+// Before - O(n²)
+function findDuplicates(arr) {
+  const duplicates = [];
+  for (let i = 0; i < arr.length; i++) {
+    for (let j = i + 1; j < arr.length; j++) {
+      if (arr[i] === arr[j]) {
+        duplicates.push(arr[i]);
+      }
+    }
+  }
+  return duplicates;
+}
+
+// After - O(n)
+function findDuplicates(arr) {
+  const seen = new Map();
+  const duplicates = new Set();
+  
+  for (const item of arr) {
+    if (seen.has(item)) {
+      duplicates.add(item);
+    } else {
+      seen.set(item, true);
+    }
+  }
+  
+  return Array.from(duplicates);
+}
+\`\`\`
+
+**示例 2：缓存计算结果**
+\`\`\`typescript
+// Before - 重复计算
+function fibonacci(n) {
+  if (n <= 1) return n;
+  return fibonacci(n - 1) + fibonacci(n - 2);
+}
+
+// After - 使用 memoization
+const memo = new Map();
+function fibonacci(n) {
+  if (n <= 1) return n;
+  if (memo.has(n)) return memo.get(n);
+  
+  const result = fibonacci(n - 1) + fibonacci(n - 2);
+  memo.set(n, result);
+  return result;
+}
+\`\`\`
+
+### 2️⃣ 内存优化
+
+**避免内存泄漏**：
+\`\`\`typescript
+// ❌ 内存泄漏
+class EventManager {
+  listeners = [];
+  
+  addEventListener(listener) {
+    this.listeners.push(listener);
+    // 忘记移除监听器
+  }
+}
+
+// ✅ 正确做法
+class EventManager {
+  listeners = new Set();
+  
+  addEventListener(listener) {
+    this.listeners.add(listener);
+  }
+  
+  removeEventListener(listener) {
+    this.listeners.delete(listener);
+  }
+  
+  destroy() {
+    this.listeners.clear();
+  }
+}
+\`\`\`
+
+**对象池复用**：
+\`\`\`typescript
+// ❌ 频繁创建对象
+for (let i = 0; i < 10000; i++) {
+  const obj = { x: i, y: i * 2 };
+  process(obj);
+}
+
+// ✅ 对象池
+class ObjectPool {
+  pool = [];
+  
+  acquire() {
+    return this.pool.pop() || {};
+  }
+  
+  release(obj) {
+    this.pool.push(obj);
+  }
+}
+
+const pool = new ObjectPool();
+for (let i = 0; i < 10000; i++) {
+  const obj = pool.acquire();
+  obj.x = i;
+  obj.y = i * 2;
+  process(obj);
+  pool.release(obj);
+}
+\`\`\`
+
+### 3️⃣ React 性能优化
+
+**useMemo 和 useCallback**：
+\`\`\`typescript
+// ❌ 每次渲染都创建新函数
+function MyComponent({ data }) {
+  const processedData = expensiveComputation(data);
+  const handleClick = () => { /* ... */ };
+  
+  return <ChildComponent data={processedData} onClick={handleClick} />;
+}
+
+// ✅ 使用 hooks 优化
+function MyComponent({ data }) {
+  const processedData = useMemo(
+    () => expensiveComputation(data),
+    [data]
+  );
+  
+  const handleClick = useCallback(() => {
+    /* ... */
+  }, []);
+  
+  return <ChildComponent data={processedData} onClick={handleClick} />;
+}
+\`\`\`
+
+**React.memo 避免重渲染**：
+\`\`\`typescript
+// ✅ 使用 memo
+const ChildComponent = React.memo(({ data, onClick }) => {
+  return <div onClick={onClick}>{data}</div>;
+});
+\`\`\`
+
+**虚拟列表**：
+\`\`\`typescript
+// ❌ 渲染 10000 个元素
+function List({ items }) {
+  return (
+    <div>
+      {items.map(item => <Item key={item.id} data={item} />)}
+    </div>
+  );
+}
+
+// ✅ 使用虚拟列表
+import { FixedSizeList } from 'react-window';
+
+function List({ items }) {
+  return (
+    <FixedSizeList
+      height={600}
+      itemCount={items.length}
+      itemSize={50}
+    >
+      {({ index, style }) => (
+        <div style={style}>
+          <Item data={items[index]} />
+        </div>
+      )}
+    </FixedSizeList>
+  );
+}
+\`\`\`
+
+### 4️⃣ 数据库优化
+
+**添加索引**：
+\`\`\`sql
+-- Before
+SELECT * FROM users WHERE email = 'user@example.com';
+
+-- After
+CREATE INDEX idx_users_email ON users(email);
+SELECT * FROM users WHERE email = 'user@example.com';
+\`\`\`
+
+**查询优化**：
+\`\`\`typescript
+// ❌ N+1 查询
+const users = await User.findAll();
+for (const user of users) {
+  user.posts = await Post.findAll({ where: { userId: user.id } });
+}
+
+// ✅ 使用 JOIN
+const users = await User.findAll({
+  include: [{ model: Post }]
+});
+\`\`\`
+
+**批量操作**：
+\`\`\`typescript
+// ❌ 逐条插入
+for (const item of items) {
+  await db.insert(item);
+}
+
+// ✅ 批量插入
+await db.insertMany(items);
+\`\`\`
+
+---
+
+## 性能测试
+
+### Benchmark 测试
+\`\`\`typescript
+console.time('operation');
+// 执行操作
+console.timeEnd('operation');
+
+// 或使用 performance API
+const start = performance.now();
+// 执行操作
+const end = performance.now();
+console.log(\`耗时: \${end - start}ms\`);
+\`\`\`
+
+### 性能指标
+
+**目标值**：
+- 首屏加载：< 1s
+- 交互响应：< 100ms
+- 动画帧率：60 FPS
+- API 响应：< 200ms
+
+---
+
+## 性能优化报告模板
+
+### 📊 性能分析
+
+**当前性能**：
+- 时间复杂度：O(n²)
+- 内存占用：150MB
+- 响应时间：800ms
+
+**瓶颈识别**：
+1. 嵌套循环导致复杂度过高
+2. 未缓存计算结果
+3. 数组查找效率低
+
+### 🎯 优化方案
+
+**方案 1：算法优化**
+- 使用 Map 替代数组
+- 预期提升：70%
+
+**方案 2：添加缓存**
+- 使用 memoization
+- 预期提升：50%
+
+### 📈 优化效果
+
+**优化后性能**：
+- 时间复杂度：O(n)
+- 内存占用：50MB ↓ 67%
+- 响应时间：200ms ↓ 75%
+
+---
+
+现在请分析代码，提供详细的性能优化建议。`;
+        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/refactor.d.ts

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