mcp-probe-kit 3.0.5 → 3.0.7

package/build/lib/toolset-manager.js

@@ -4,7 +4,7 @@
  */
 import { allToolSchemas } from '../schemas/index.js';
 /**
- * 工具集定义 (v3.0 精简版 - 20 个工具)
+ * 工具集定义 (v3.0 精简版)
  *
  * - core: 核心工具（日常高频）
  * - ui: UI/UX 工具（推荐使用 start_ui 统一入口）
@@ -12,10 +12,11 @@ import { allToolSchemas } from '../schemas/index.js';
  * - full: 所有工具（默认）
  */
 export const TOOLSET_DEFINITIONS = {
-    // 核心工具集 - 日常高频工具（9 个）
+    // 核心工具集 - 日常高频工具
     core: [
         'gencommit',
         'code_review',
+        'code_insight',
         'gentest',
         'refactor',
         'fix_bug',
@@ -31,11 +32,12 @@ export const TOOLSET_DEFINITIONS = {
         'ui_search', // 搜索 UI/UX 数据库
         'sync_ui_data', // 同步 UI 数据
     ],
-    // 工作流工具集 - 包含核心 + 编排 + 交互（20 个）
+    // 工作流工具集 - 包含核心 + 编排 + 交互
     workflow: [
-        // 核心工具（9 个）
+        // 核心工具
         'gencommit',
         'code_review',
+        'code_insight',
         'gentest',
         'refactor',
         'fix_bug',
@@ -58,7 +60,7 @@ export const TOOLSET_DEFINITIONS = {
         'ui_search',
         'sync_ui_data',
     ],
-    // 完整工具集 - 所有 20 个工具
+    // 完整工具集 - 所有工具
     full: 'all',
 };
 /**

package/build/schemas/code-analysis-tools.d.ts

@@ -19,6 +19,52 @@ export declare const codeAnalysisToolSchemas: readonly [{
         readonly required: readonly [];
         readonly additionalProperties: true;
     };
+}, {
+    readonly name: "code_insight";
+    readonly description: "当用户需要基于代码图谱分析调用链、上下文和影响面时使用。默认桥接 GitNexus，支持 query/context/impact 模式；不可用时自动降级并返回原因";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly mode: {
+                readonly type: "string";
+                readonly description: "分析模式：auto（默认）、query、context、impact";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "查询文本（query 模式推荐）";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly description: "目标符号（context/impact 模式推荐）";
+            };
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "仓库名称（多仓库场景可选）";
+            };
+            readonly goal: {
+                readonly type: "string";
+                readonly description: "分析目标（可选）";
+            };
+            readonly task_context: {
+                readonly type: "string";
+                readonly description: "任务上下文（可选）";
+            };
+            readonly direction: {
+                readonly type: "string";
+                readonly description: "impact 方向：upstream / downstream";
+            };
+            readonly max_depth: {
+                readonly type: "number";
+                readonly description: "impact 最大深度（可选，默认 3）";
+            };
+            readonly include_tests: {
+                readonly type: "boolean";
+                readonly description: "impact 是否包含测试文件（可选，默认 false）";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
 }, {
     readonly name: "refactor";
     readonly description: "当用户需要重构代码、改善代码结构时使用。分析代码结构，提供重构建议、重构步骤和风险评估";

package/build/schemas/code-analysis-tools.js

@@ -21,6 +21,53 @@ export const codeAnalysisToolSchemas = [
             additionalProperties: true,
         },
     },
+    {
+        name: "code_insight",
+        description: "当用户需要基于代码图谱分析调用链、上下文和影响面时使用。默认桥接 GitNexus，支持 query/context/impact 模式；不可用时自动降级并返回原因",
+        inputSchema: {
+            type: "object",
+            properties: {
+                mode: {
+                    type: "string",
+                    description: "分析模式：auto（默认）、query、context、impact",
+                },
+                query: {
+                    type: "string",
+                    description: "查询文本（query 模式推荐）",
+                },
+                target: {
+                    type: "string",
+                    description: "目标符号（context/impact 模式推荐）",
+                },
+                repo: {
+                    type: "string",
+                    description: "仓库名称（多仓库场景可选）",
+                },
+                goal: {
+                    type: "string",
+                    description: "分析目标（可选）",
+                },
+                task_context: {
+                    type: "string",
+                    description: "任务上下文（可选）",
+                },
+                direction: {
+                    type: "string",
+                    description: "impact 方向：upstream / downstream",
+                },
+                max_depth: {
+                    type: "number",
+                    description: "impact 最大深度（可选，默认 3）",
+                },
+                include_tests: {
+                    type: "boolean",
+                    description: "impact 是否包含测试文件（可选，默认 false）",
+                },
+            },
+            required: [],
+            additionalProperties: true,
+        },
+    },
     {
         name: "refactor",
         description: "当用户需要重构代码、改善代码结构时使用。分析代码结构，提供重构建议、重构步骤和风险评估",

package/build/schemas/git-tools.js

@@ -23,22 +23,22 @@ export const gitToolSchemas = [
     },
     {
         name: "git_work_report",
-        description: `基于 Git diff 分析生成工作报告（日报/周期报）
-
-核心功能：
-- 支持日报模式（单个日期）和周期报模式（日期范围）
-- 自动读取指定日期的所有 Git 提交
-- 对每个提交执行 git show 获取完整 diff
-- 使用 AI 分析 diff 内容提取实际工作内容
-
-输出格式：
-- 只输出「工作内容」部分
-- 每条以 - 开头，中文，简洁专业
-- 格式：做了什么 + 改了哪里/达到什么效果
-- 不输出：提交哈希、文件列表、统计数据、风险总结
-
-使用示例：
-- 日报：git_work_report --date 2026-1-27
+        description: `基于 Git diff 分析生成工作报告（日报/周期报）
+
+核心功能：
+- 支持日报模式（单个日期）和周期报模式（日期范围）
+- 自动读取指定日期的所有 Git 提交
+- 对每个提交执行 git show 获取完整 diff
+- 使用 AI 分析 diff 内容提取实际工作内容
+
+输出格式：
+- 只输出「工作内容」部分
+- 每条以 - 开头，中文，简洁专业
+- 格式：做了什么 + 改了哪里/达到什么效果
+- 不输出：提交哈希、文件列表、统计数据、风险总结
+
+使用示例：
+- 日报：git_work_report --date 2026-1-27
 - 周期报：git_work_report --start_date 2026-2-1 --end_date 2026-2-6`,
         inputSchema: {
             type: "object",

package/build/schemas/index.d.ts

@@ -81,6 +81,52 @@ export declare const allToolSchemas: ({
         readonly required: readonly [];
         readonly additionalProperties: true;
     };
+} | {
+    readonly name: "code_insight";
+    readonly description: "当用户需要基于代码图谱分析调用链、上下文和影响面时使用。默认桥接 GitNexus，支持 query/context/impact 模式；不可用时自动降级并返回原因";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly mode: {
+                readonly type: "string";
+                readonly description: "分析模式：auto（默认）、query、context、impact";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "查询文本（query 模式推荐）";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly description: "目标符号（context/impact 模式推荐）";
+            };
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "仓库名称（多仓库场景可选）";
+            };
+            readonly goal: {
+                readonly type: "string";
+                readonly description: "分析目标（可选）";
+            };
+            readonly task_context: {
+                readonly type: "string";
+                readonly description: "任务上下文（可选）";
+            };
+            readonly direction: {
+                readonly type: "string";
+                readonly description: "impact 方向：upstream / downstream";
+            };
+            readonly max_depth: {
+                readonly type: "number";
+                readonly description: "impact 最大深度（可选，默认 3）";
+            };
+            readonly include_tests: {
+                readonly type: "boolean";
+                readonly description: "impact 是否包含测试文件（可选，默认 false）";
+            };
+        };
+        readonly required: readonly [];
+        readonly additionalProperties: true;
+    };
 } | {
     readonly name: "refactor";
     readonly description: "当用户需要重构代码、改善代码结构时使用。分析代码结构，提供重构建议、重构步骤和风险评估";

package/build/tools/__tests__/code_insight.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,35 @@
+import { describe, expect, test } from "vitest";
+import { codeInsight } from "../code_insight.js";
+describe("code_insight 单元测试", () => {
+    test("mode 非法时返回错误", async () => {
+        const result = await codeInsight({
+            mode: "unknown-mode",
+            query: "auth",
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/不支持的 mode/i);
+    });
+    test("bridge 禁用时返回降级结果（非硬错误）", async () => {
+        const prev = process.env.MCP_ENABLE_GITNEXUS_BRIDGE;
+        process.env.MCP_ENABLE_GITNEXUS_BRIDGE = "0";
+        try {
+            const result = await codeInsight({
+                mode: "query",
+                query: "authentication middleware",
+            });
+            expect(result.isError).toBe(false);
+            expect("structuredContent" in result).toBe(true);
+            const structured = result.structuredContent;
+            expect(structured.status).toBe("degraded");
+            expect(structured.provider).toBe("gitnexus");
+        }
+        finally {
+            if (prev === undefined) {
+                delete process.env.MCP_ENABLE_GITNEXUS_BRIDGE;
+            }
+            else {
+                process.env.MCP_ENABLE_GITNEXUS_BRIDGE = prev;
+            }
+        }
+    });
+});

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

@@ -47,20 +47,20 @@ describe('start_bugfix 单元测试', () => {
     });
     test('template_profile 自动选择 strict（结构化输入）', async () => {
         const result = await startBugfix({
-            error_message: `## 复现步骤
-1. 打开登录页
-2. 输入错误账号
-3. 点击登录
-
-## 期望
-提示错误信息并保持页面可交互
-
-## 实际
-页面白屏，控制台报错
-
-## 环境
-- 浏览器: Chrome 120
-- 系统: Windows 11
+            error_message: `## 复现步骤
+1. 打开登录页
+2. 输入错误账号
+3. 点击登录
+
+## 期望
+提示错误信息并保持页面可交互
+
+## 实际
+页面白屏，控制台报错
+
+## 环境
+- 浏览器: Chrome 120
+- 系统: Windows 11
 - 版本: v2.3.0`,
             stack_trace: 'TypeError: Cannot read property',
             template_profile: 'auto',

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

@@ -62,17 +62,17 @@ describe('start_ui 单元测试', () => {
     describe('模板档位', () => {
         test('auto 模式可自动选择 strict', async () => {
             const result = await startUi({
-                description: `# 页面目标
-需要一个带筛选和批量操作的管理后台，用于管理订单与用户数据，包含导出与权限控制。
-
-## 关键交互
-1. 支持筛选、排序、分页、导出
-2. 批量启用/禁用、批量标签、批量删除
-
-## 数据来源
-来自订单服务与用户服务接口，刷新频率 30s
-
-## 状态
+                description: `# 页面目标
+需要一个带筛选和批量操作的管理后台，用于管理订单与用户数据，包含导出与权限控制。
+
+## 关键交互
+1. 支持筛选、排序、分页、导出
+2. 批量启用/禁用、批量标签、批量删除
+
+## 数据来源
+来自订单服务与用户服务接口，刷新频率 30s
+
+## 状态
 空态、加载态、错误态、无权限提示、空筛选结果`,
                 template_profile: 'auto',
             });

package/build/tools/add_feature.js

@@ -206,85 +206,85 @@ export async function addFeature(args) {
         };
         const fenceOpen = "````markdown";
         const fenceClose = "````";
-        const guide = `# 添加新功能指南（模板驱动）
-
-## 🎯 任务目标
-
-为项目添加新功能：**${featureName}**
-
-**功能描述**: ${description}
-
-**模板档位**: ${templateProfile}${profileDecision.requested === 'auto' ? '（自动）' : ''}
-${profileDecision.requested === 'auto' && profileDecision.reason ? `**选择理由**: ${profileDecision.reason}` : ''}
-
----
-
-## 📋 前置检查
-
-1. 检查文件 \`${docsDir}/project-context.md\` 是否存在
-2. 如果存在，读取并参考其中的技术栈、架构模式、编码规范
-3. 如果不存在，建议先运行 \`init_project_context\` 工具
-
----
-
-## ✅ 模板校验结果
-
-${formatValidation('requirements.md', requirementsTemplate.validation)}
-${formatValidation('design.md', designTemplate.validation)}
-${formatValidation('tasks.md', tasksTemplate.validation)}
-${combinedValidation.warnings.length > 0 ? `- 其他警告: ${combinedValidation.warnings.join('；')}` : ''}
-
----
-
-## 📝 创建文档
-
-请在 \`${docsDir}/specs/${featureName}/\` 目录下创建以下三个文件：
-
-### 文件 1: requirements.md
-
-**文件路径**: \`${docsDir}/specs/${featureName}/requirements.md\`
-**模板来源**: ${requirementsTemplate.source}
-
-${fenceOpen}
-${requirementsTemplate.content}
-${fenceClose}
-
----
-
-### 文件 2: design.md
-
-**文件路径**: \`${docsDir}/specs/${featureName}/design.md\`
-**模板来源**: ${designTemplate.source}
-
-${fenceOpen}
-${designTemplate.content}
-${fenceClose}
-
----
-
-### 文件 3: tasks.md
-
-**文件路径**: \`${docsDir}/specs/${featureName}/tasks.md\`
-**模板来源**: ${tasksTemplate.source}
-
-${fenceOpen}
-${tasksTemplate.content}
-${fenceClose}
-
----
-
-## ✅ 完成后检查
-
-- [ ] \`${docsDir}/specs/${featureName}/requirements.md\` 已创建
-- [ ] \`${docsDir}/specs/${featureName}/design.md\` 已创建
-- [ ] \`${docsDir}/specs/${featureName}/tasks.md\` 已创建
-- [ ] 所有占位符已替换
-- [ ] 内容与项目上下文一致（如有）
-
----
-
-*指南版本: 1.1.0*
-*工具: MCP Probe Kit - add_feature*
+        const guide = `# 添加新功能指南（模板驱动）
+
+## 🎯 任务目标
+
+为项目添加新功能：**${featureName}**
+
+**功能描述**: ${description}
+
+**模板档位**: ${templateProfile}${profileDecision.requested === 'auto' ? '（自动）' : ''}
+${profileDecision.requested === 'auto' && profileDecision.reason ? `**选择理由**: ${profileDecision.reason}` : ''}
+
+---
+
+## 📋 前置检查
+
+1. 检查文件 \`${docsDir}/project-context.md\` 是否存在
+2. 如果存在，读取并参考其中的技术栈、架构模式、编码规范
+3. 如果不存在，建议先运行 \`init_project_context\` 工具
+
+---
+
+## ✅ 模板校验结果
+
+${formatValidation('requirements.md', requirementsTemplate.validation)}
+${formatValidation('design.md', designTemplate.validation)}
+${formatValidation('tasks.md', tasksTemplate.validation)}
+${combinedValidation.warnings.length > 0 ? `- 其他警告: ${combinedValidation.warnings.join('；')}` : ''}
+
+---
+
+## 📝 创建文档
+
+请在 \`${docsDir}/specs/${featureName}/\` 目录下创建以下三个文件：
+
+### 文件 1: requirements.md
+
+**文件路径**: \`${docsDir}/specs/${featureName}/requirements.md\`
+**模板来源**: ${requirementsTemplate.source}
+
+${fenceOpen}
+${requirementsTemplate.content}
+${fenceClose}
+
+---
+
+### 文件 2: design.md
+
+**文件路径**: \`${docsDir}/specs/${featureName}/design.md\`
+**模板来源**: ${designTemplate.source}
+
+${fenceOpen}
+${designTemplate.content}
+${fenceClose}
+
+---
+
+### 文件 3: tasks.md
+
+**文件路径**: \`${docsDir}/specs/${featureName}/tasks.md\`
+**模板来源**: ${tasksTemplate.source}
+
+${fenceOpen}
+${tasksTemplate.content}
+${fenceClose}
+
+---
+
+## ✅ 完成后检查
+
+- [ ] \`${docsDir}/specs/${featureName}/requirements.md\` 已创建
+- [ ] \`${docsDir}/specs/${featureName}/design.md\` 已创建
+- [ ] \`${docsDir}/specs/${featureName}/tasks.md\` 已创建
+- [ ] 所有占位符已替换
+- [ ] 内容与项目上下文一致（如有）
+
+---
+
+*指南版本: 1.1.0*
+*工具: MCP Probe Kit - add_feature*
 `;
         return okText(guide, {
             schema: (await import("../schemas/output/project-tools.js")).FeatureSpecSchema,

package/build/tools/ask_user.js

@@ -28,11 +28,11 @@ export async function askUser(args) {
                 content: [
                     {
                         type: "text",
-                        text: `${header}# ❓ 向用户提问工具
-
-## 使用方法
-
-### 单个问题
+                        text: `${header}# ❓ 向用户提问工具
+
+## 使用方法
+
+### 单个问题
 \`\`\`
 ask_user "你希望支持哪些支付方式？"
 \`\`\`

package/build/tools/code_insight.d.ts

@@ -0,0 +1,8 @@
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
+export declare function codeInsight(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/build/tools/code_insight.js

@@ -0,0 +1,129 @@
+import { parseArgs, getString, getNumber, getBoolean } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
+import { runCodeInsightBridge, } from "../lib/gitnexus-bridge.js";
+import { throwIfAborted, } from "../lib/tool-execution-context.js";
+const ALLOWED_MODES = new Set(["auto", "query", "context", "impact"]);
+const ALLOWED_DIRECTIONS = new Set(["upstream", "downstream"]);
+function normalizeMode(value) {
+    const mode = (value || "auto").trim().toLowerCase();
+    if (!ALLOWED_MODES.has(mode)) {
+        throw new Error(`不支持的 mode: ${value}（可选: auto/query/context/impact）`);
+    }
+    return mode;
+}
+function normalizeDirection(value) {
+    if (!value) {
+        return undefined;
+    }
+    const direction = value.trim().toLowerCase();
+    if (!ALLOWED_DIRECTIONS.has(direction)) {
+        throw new Error(`不支持的 direction: ${value}（可选: upstream/downstream）`);
+    }
+    return direction;
+}
+function summarizeExecutions(executions) {
+    if (executions.length === 0) {
+        return "- 未执行图谱调用";
+    }
+    return executions
+        .map((item) => {
+        if (item.ok) {
+            return `- ✅ ${item.tool}: ${(item.text || "已返回结果").replace(/\s+/g, " ").slice(0, 180)}`;
+        }
+        return `- ⚠️ ${item.tool}: ${(item.error || "调用失败").replace(/\s+/g, " ").slice(0, 180)}`;
+    })
+        .join("\n");
+}
+export async function codeInsight(args, context) {
+    try {
+        throwIfAborted(context?.signal, "code_insight 已取消");
+        const parsedArgs = parseArgs(args, {
+            defaultValues: {
+                mode: "auto",
+                query: "",
+                target: "",
+                repo: "",
+                goal: "",
+                task_context: "",
+                direction: "",
+                max_depth: 3,
+                include_tests: false,
+            },
+            primaryField: "input",
+            fieldAliases: {
+                mode: ["m", "模式"],
+                query: ["q", "keyword", "关键词"],
+                target: ["symbol", "name", "目标符号"],
+                repo: ["repository", "仓库"],
+                goal: ["目的", "目标"],
+                task_context: ["context", "taskContext", "任务上下文"],
+                direction: ["dir", "方向"],
+                max_depth: ["depth", "maxDepth", "最大深度"],
+                include_tests: ["includeTests", "包含测试"],
+            },
+        });
+        const mode = normalizeMode(getString(parsedArgs.mode, "auto"));
+        const query = getString(parsedArgs.query);
+        const target = getString(parsedArgs.target);
+        const repo = getString(parsedArgs.repo);
+        const goal = getString(parsedArgs.goal);
+        const taskContext = getString(parsedArgs.task_context);
+        const direction = normalizeDirection(getString(parsedArgs.direction));
+        const maxDepth = Math.max(1, getNumber(parsedArgs.max_depth, 3));
+        const includeTests = getBoolean(parsedArgs.include_tests, false);
+        const input = getString(parsedArgs.input);
+        const finalQuery = query || (mode === "query" ? input : "");
+        const finalTarget = target || ((mode === "context" || mode === "impact") ? input : "");
+        throwIfAborted(context?.signal, "code_insight 已取消");
+        const result = await runCodeInsightBridge({
+            mode,
+            query: finalQuery,
+            target: finalTarget,
+            repo: repo || undefined,
+            goal: goal || undefined,
+            taskContext: taskContext || undefined,
+            direction,
+            maxDepth,
+            includeTests,
+            signal: context?.signal,
+        });
+        const executionSummary = summarizeExecutions(result.executions.map((item) => ({
+            tool: item.tool,
+            ok: item.ok,
+            text: item.text,
+            error: item.error,
+        })));
+        const message = `# code_insight 图谱分析结果
+
+状态: ${result.available ? "可用" : "降级"}
+模式: ${result.modeRequested} -> ${result.modeResolved}
+来源: ${result.provider}
+
+摘要:
+${result.summary}
+
+执行详情:
+${executionSummary}
+
+${result.warnings.length > 0 ? `警告: ${result.warnings.join(", ")}` : ""}`.trim();
+        return okStructured(message, {
+            status: result.available ? "ok" : "degraded",
+            provider: result.provider,
+            mode: {
+                requested: result.modeRequested,
+                resolved: result.modeResolved,
+            },
+            summary: result.summary,
+            warnings: result.warnings,
+            executions: result.executions,
+            repo: result.repo || null,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `❌ code_insight 执行失败: ${errorMessage}` }],
+            isError: true,
+        };
+    }
+}