mcp-probe-kit 3.0.19 → 3.0.21

package/build/tools/search_memory.js

@@ -0,0 +1,57 @@
+import { parseArgs, getString, getNumber } from '../utils/parseArgs.js';
+import { okStructured } from '../lib/response.js';
+import { createMemoryClient } from '../lib/memory-client.js';
+import { shouldShowSourceInSearch } from '../lib/memory-orchestration.js';
+import { getMemoryConfig } from '../lib/memory-config.js';
+import { handleToolError } from '../utils/error-handler.js';
+export async function searchMemory(args) {
+    try {
+        const parsed = parseArgs(args, {
+            defaultValues: {
+                query: '',
+                type: '',
+                limit: 0,
+            },
+        });
+        const query = getString(parsed.query);
+        if (!query) {
+            throw new Error('缺少必填参数: query');
+        }
+        const client = createMemoryClient();
+        if (!client.isEnabled()) {
+            return okStructured('记忆服务未开启，无法检索。', {
+                enabled: false,
+                results: [],
+            });
+        }
+        const config = getMemoryConfig();
+        const limit = getNumber(parsed.limit, config.searchLimit);
+        const typeFilter = getString(parsed.type);
+        const tags = Array.isArray(parsed.tags)
+            ? parsed.tags.filter((item) => typeof item === 'string')
+            : [];
+        const results = await client.search(query, {
+            limit,
+            preferTypes: typeFilter ? [typeFilter] : [],
+            preferTags: tags,
+        });
+        const items = results.map((item) => ({
+            id: item.id,
+            score: item.score,
+            name: item.name,
+            type: item.type,
+            summary: item.summary,
+            tags: item.tags,
+            sourcePath: shouldShowSourceInSearch(item, config) ? item.sourcePath : undefined,
+        }));
+        return okStructured(results.length > 0 ? `找到 ${results.length} 条相关记忆` : '未找到相关记忆', {
+            enabled: true,
+            query,
+            count: results.length,
+            results: items,
+        });
+    }
+    catch (error) {
+        return handleToolError(error, 'search_memory');
+    }
+}

package/build/tools/start_bugfix.js

@@ -423,7 +423,7 @@ ${graphContext.highlights.length > 0
             : "- 任务级线索: 无"}
 - 使用方式: 先读取基线图谱，再用本次任务图谱做 TBP-4 / TBP-5 / TBP-6 的边界与真因收敛
 `;
-        const memoryContext = await loadMemoryInjectionContext([errorMessage, stackTrace, codeContext].filter(Boolean).join("\n"));
+        const memoryContext = await loadMemoryInjectionContext([errorMessage, stackTrace, codeContext].filter(Boolean).join("\n"), "bugfix");
         const memoryGuideSection = renderMemoryGuideSection(memoryContext);
         if (requirementsMode === "loop") {
             throwIfAborted(context?.signal, "start_bugfix(loop) 已取消");
@@ -512,7 +512,7 @@ ${graphContext.highlights.length > 0
                 ],
                 notes: [
                     ...headerNotes,
-                    ...(memoryContext.enabled ? ['记忆系统: 已启用，优先复用历史修复经验并在结束后评估沉淀'] : []),
+                    ...(memoryContext.enabled ? ['记忆系统: 已启用，历史修复经验全文已自动注入，结束后评估沉淀'] : []),
                 ],
             });
             const loopTemplate = profileDecision.resolved === 'strict'
@@ -577,7 +577,7 @@ ${graphContext.highlights.length > 0
             ],
             notes: [
                 ...headerNotes,
-                ...(memoryContext.enabled ? ['记忆系统: 已启用，必要时先读取相似历史资产'] : []),
+                ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史经验全文已自动注入'] : []),
             ],
         });
         const promptTemplate = profileDecision.resolved === 'strict'

package/build/tools/start_feature.js

@@ -303,7 +303,7 @@ ${graphContext.highlights.length > 0
         ]
             .filter(Boolean)
             .join("\n");
-        const memoryContext = await loadMemoryInjectionContext(`${featureName}\n${description}`);
+        const memoryContext = await loadMemoryInjectionContext(`${featureName}\n${description}`, 'feature');
         const memoryGuideSection = renderMemoryGuideSection(memoryContext);
         if (requirementsMode === "loop") {
             throwIfAborted(context?.signal, "start_feature(loop) 已取消");
@@ -392,7 +392,7 @@ ${graphContext.highlights.length > 0
                 notes: [
                     `模板档位: ${templateProfile}`,
                     graphStatusNote,
-                    ...(memoryContext.enabled ? ['记忆系统: 已启用，按需读取历史资产并在结束后评估是否沉淀'] : []),
+                    ...(memoryContext.enabled ? ['记忆系统: 已启用，历史经验全文已自动注入，结束后评估是否沉淀'] : []),
                 ],
             });
             const guide = (header + LOOP_PROMPT_TEMPLATE
@@ -452,7 +452,7 @@ ${graphContext.highlights.length > 0
             notes: [
                 `模板档位: ${templateProfile}`,
                 graphStatusNote,
-                ...(memoryContext.enabled ? ['记忆系统: 已启用，先复用摘要资产，必要时读取详情'] : []),
+                ...(memoryContext.enabled ? ['记忆系统: 已启用，历史经验全文已自动注入'] : []),
             ],
         });
         const guide = (header + PROMPT_TEMPLATE

package/build/tools/start_ui.js

@@ -542,7 +542,7 @@ export async function startUi(args, context) {
         const skillBridgeStep = buildSkillBridgePlanStep(skillBridge);
         const skillBridgeSection = renderSkillBridgeSection(skillBridge);
         headerNotes.push(buildSkillHeaderNote(skillBridge));
-        const memoryContext = await loadMemoryInjectionContext(description || templateName);
+        const memoryContext = await loadMemoryInjectionContext(description || templateName, 'ui');
         const memoryGuideSection = renderMemoryGuideSection(memoryContext);
         // 验证 mode 参数
         const validModes = ["auto", "manual"];
@@ -906,7 +906,7 @@ ${recommendation.reasoning}
                 ],
                 notes: [
                     ...headerNotes,
-                    ...(memoryContext.enabled ? ['记忆系统: 已启用，必要时先读取相似历史 UI 资产'] : []),
+                    ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史 UI 经验全文已自动注入'] : []),
                 ],
             });
             const smartPlan = header + skillBridgeSection + (profileDecision.resolved === 'strict' ? smartPlanStrict : smartPlanGuided) + memoryGuideSection;
@@ -1037,7 +1037,7 @@ start_ui "设置页面" --framework=react
             ],
             notes: [
                 ...headerNotes,
-                ...(memoryContext.enabled ? ['记忆系统: 已启用，必要时先读取相似历史 UI 资产'] : []),
+                ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史 UI 经验全文已自动注入'] : []),
             ],
         });
         const baseTemplate = profileDecision.resolved === 'strict'

package/docs/data/tools.js

@@ -402,6 +402,24 @@ verbose: true`
     }
   ],
   memory: [
+    {
+      name: 'search_memory',
+      description: '按语义检索共享记忆库，支持 type/tags 优先排序',
+      schema: 'MemorySearchSchema',
+      params: [
+        { name: 'query', type: 'string', required: true, desc: '检索关键词或问题描述' },
+        { name: 'type', type: 'string', required: false, desc: '优先匹配的类型，如 bugfix' },
+        { name: 'tags', type: 'array', required: false, desc: '优先匹配的标签' },
+        { name: 'limit', type: 'number', required: false, desc: '返回条数' }
+      ],
+      usage: '在 start_* 之外主动查找历史 Bug 修复或可复用模式',
+      example: `// 使用示例
+你: 请使用 search_memory 搜索 proxy 相关 bugfix
+
+query: "proxy 400 HTTPS"
+type: "bugfix"
+limit: 5`
+    },
     {
       name: 'read_memory_asset',
       description: '按 asset_id 读取已存储 memory 资产的完整内容和元数据',

package/docs/i18n/all-tools/en.json

@@ -41,6 +41,7 @@
     "ui_design_system": "Design System",
     "ui_search": "Search UI",
     "code_insight": "Code Insight",
+    "search_memory": "Search Memory",
     "read_memory_asset": "Read Memory",
     "memorize_asset": "Store Memory",
     "scan_and_extract_patterns": "Extract Patterns",
@@ -75,7 +76,7 @@
     },
     "memory": {
       "title": "Memory & Cursor History",
-      "count": "6 tools"
+      "count": "7 tools"
     }
   },
   "toolsData": {
@@ -167,6 +168,10 @@
       "description": "Code graph insight tool, bridging GitNexus to analyze call chains, context, and impact (auto-degrades when unavailable)",
       "usage": "Refresh the GitNexus index, perform task-level call-chain/context/impact analysis, and persist results to docs/graph-insights plus the project-context index"
     },
+    "search_memory": {
+      "description": "Semantic search across the shared memory pool, with optional type/tags preference",
+      "usage": "Use outside start_* to find historical bugfixes or patterns; follow with read_memory_asset for full content"
+    },
     "read_memory_asset": {
       "description": "Read the full content and metadata of a stored memory asset by asset ID",
       "usage": "Use this after a workflow or search result already found a memory summary and you need the full reusable artifact"

package/docs/i18n/all-tools/ja.json

@@ -42,6 +42,7 @@
     "ui_search": "UI検索",
     "sync_ui_data": "データ同期",
     "code_insight": "コード洞察",
+    "search_memory": "メモリ検索",
     "read_memory_asset": "メモリ読取",
     "memorize_asset": "メモリ保存",
     "scan_and_extract_patterns": "パターン抽出",
@@ -76,7 +77,7 @@
     },
     "memory": {
       "title": "Memory と Cursor History",
-      "count": "6個"
+      "count": "7個"
     }
   },
   "toolsData": {

package/docs/i18n/all-tools/ko.json

@@ -42,6 +42,7 @@
     "ui_search": "UI 검색",
     "sync_ui_data": "데이터 동기화",
     "code_insight": "코드 인사이트",
+    "search_memory": "메모리 검색",
     "read_memory_asset": "메모리 읽기",
     "memorize_asset": "메모리 저장",
     "scan_and_extract_patterns": "패턴 추출",
@@ -76,7 +77,7 @@
     },
     "memory": {
       "title": "Memory 및 Cursor History",
-      "count": "6개"
+      "count": "7개"
     }
   },
   "toolsData": {

package/docs/i18n/all-tools/zh-CN.json

@@ -5,7 +5,7 @@
     "keywords": "AI 开发工具, 代码生成工具, 代码审查工具, Git 自动化, UI 生成, 代码重构, 性能优化, 安全扫描"
   },
   "page": {
-    "subtitle": "MCP Probe Kit 提供 28 个实用工具，核心与编排工具支持结构化输出"
+    "subtitle": "MCP Probe Kit 提供 29 个实用工具，核心与编排工具支持结构化输出"
   },
   "search": {
     "placeholder": "🔍 搜索工具名称或描述...",
@@ -41,6 +41,7 @@
     "ui_design_system": "设计系统",
     "ui_search": "搜索UI",
     "code_insight": "图谱洞察",
+    "search_memory": "搜索记忆",
     "read_memory_asset": "读取记忆",
     "memorize_asset": "沉淀记忆",
     "scan_and_extract_patterns": "抽取模式",
@@ -75,7 +76,7 @@
     },
     "memory": {
       "title": "记忆与 Cursor 历史",
-      "count": "6 个"
+      "count": "7 个"
     }
   },
   "toolsData": {
@@ -167,6 +168,10 @@
       "description": "代码图谱洞察工具，桥接 GitNexus 分析调用链、上下文和影响面（不可用时自动降级）",
       "usage": "用于刷新 GitNexus 图谱、获取任务级调用链/上下文/影响面，并把结果保存到 docs/graph-insights 与 project-context 索引"
     },
+    "search_memory": {
+      "description": "按语义检索共享记忆库，支持 type/tags 优先排序",
+      "usage": "在 start_* 之外主动查找历史 Bug 修复或可复用模式；命中后用 read_memory_asset 读全文"
+    },
     "read_memory_asset": {
       "description": "按资产 ID 读取已沉淀记忆的完整内容与元数据",
       "usage": "当编排阶段已经命中记忆摘要，需要进一步查看完整代码、规范或模式详情时使用"

package/docs/i18n/en.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI Development Enhancement Toolkit · Documentation Center",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "Quick Start",
     "visitMainSite": "Visit ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "Quick Start",
-      "description": "Get started with MCP Probe Kit v3.0.19 in 5 minutes",
+      "description": "Get started with MCP Probe Kit v3.0.21 in 5 minutes",
       "installConfig": "Installation & Configuration"
     },
     "tools": {
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "Installation & Configuration",
-    "subtitle": "Get started with MCP Probe Kit v3.0.19 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
+    "subtitle": "Get started with MCP Probe Kit v3.0.21 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
     "breadcrumb": {
       "home": "Documentation",
       "quickStart": "Quick Start",
@@ -353,7 +353,7 @@
     "subtitle": "MCP Probe Kit integrates complete development process, best practices guide from requirements to deployment",
     "overview": {
       "title": "Complete Development Process",
-      "description": "MCP Probe Kit's 28 tools cover the complete development process from requirements analysis to code deployment. Here are the recommended best practices.",
+      "description": "MCP Probe Kit's 29 tools cover the complete development process from requirements analysis to code deployment. Here are the recommended best practices.",
       "coreIdea": "Core Philosophy:",
       "coreIdeaText": "Chain the entire development process through workflow orchestration tools (start_*), making AI your development assistant."
     },
@@ -608,7 +608,7 @@
     "resources": {
       "title": "More Resources",
       "allTools": "Complete Tools Reference",
-      "allToolsDesc": "View detailed descriptions of all 28 tools",
+      "allToolsDesc": "View detailed descriptions of all 29 tools",
       "gettingStarted": "Installation & Configuration",
       "gettingStartedDesc": "Quick start guide",
       "migration": "Migration Guide",

package/docs/i18n/ja.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI開発強化ツールキット · ドキュメントセンター",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "クイックスタート",
     "visitMainSite": "ByteZoneXを訪問"
   },
   "sections": {
     "quickStart": {
       "title": "クイックスタート",
-      "description": "5分でMCP Probe Kit v3.0.19を始める",
+      "description": "5分でMCP Probe Kit v3.0.21を始める",
       "installConfig": "インストールと設定"
     },
     "tools": {

package/docs/i18n/ko.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 개발 강화 툴킷 · 문서 센터",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "빠른 시작",
     "visitMainSite": "ByteZoneX 방문"
   },
   "sections": {
     "quickStart": {
       "title": "빠른 시작",
-      "description": "5분 안에 MCP Probe Kit v3.0.19 시작하기",
+      "description": "5분 안에 MCP Probe Kit v3.0.21 시작하기",
       "installConfig": "설치 및 구성"
     },
     "tools": {

package/docs/i18n/zh-CN.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "MCP Probe Kit - AI 驱动的完整研发工具集 | 28个工具覆盖开发全流程",
-    "description": "MCP Probe Kit 提供 28 个 AI 驱动的研发工具，覆盖需求分析、代码开发、质量保障、Bug修复、版本发布全流程。支持 Cursor、Cline、Claude Desktop，100% 结构化输出。",
+    "description": "MCP Probe Kit 提供 29 个 AI 驱动的研发工具，覆盖需求分析、代码开发、质量保障、Bug修复、版本发布全流程。支持 Cursor、Cline、Claude Desktop，100% 结构化输出。",
     "keywords": "MCP Probe Kit, AI开发工具, 代码生成, 代码审查, Git工具, UI开发, 研发效率, Cursor, Cline, Claude, MCP Server"
   },
   "nav": {
@@ -14,19 +14,19 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 开发增强工具集 · 文档中心",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "快速开始",
     "visitMainSite": "访问主站 ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "快速开始",
-      "description": "5 分钟快速上手 MCP Probe Kit v3.0.19",
+      "description": "5 分钟快速上手 MCP Probe Kit v3.0.21",
       "installConfig": "安装配置"
     },
     "tools": {
       "title": "工具文档",
-      "description": "28 个实用工具的完整参考，含图谱洞察与编排工作流",
+      "description": "29 个实用工具的完整参考，含图谱洞察与编排工作流",
       "allTools": "所有工具"
     },
     "guides": {
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "安装配置",
-    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.19，支持 Cursor、Cline 和 Claude Desktop",
+    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.21，支持 Cursor、Cline 和 Claude Desktop",
     "breadcrumb": {
       "home": "文档首页",
       "quickStart": "快速开始",
@@ -353,7 +353,7 @@
     "subtitle": "MCP Probe Kit 融合完整研发流程，从需求到上线的最佳实践指南",
     "overview": {
       "title": "完整研发流程",
-      "description": "MCP Probe Kit 的 28 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。",
+      "description": "MCP Probe Kit 的 29 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。",
       "coreIdea": "核心理念：",
       "coreIdeaText": "通过工作流编排工具（start_*）串联整个开发流程，让 AI 成为你的研发助手。"
     },
@@ -608,7 +608,7 @@
     "resources": {
       "title": "更多资源",
       "allTools": "完整工具参考",
-      "allToolsDesc": "查看所有 28 个工具的详细说明",
+      "allToolsDesc": "查看所有 29 个工具的详细说明",
       "gettingStarted": "安装配置",
       "gettingStartedDesc": "快速开始使用",
       "migration": "迁移指南",

package/docs/memory-local-setup.md

@@ -1,6 +1,6 @@
 # Local Memory Stack (Qdrant + Nomic Embed)
 
-This guide documents a **lightweight local setup** for mcp-probe-kit memory tools (`memorize_asset`, `read_memory_asset`, `scan_and_extract_patterns`):
+This guide documents a **lightweight local setup** for mcp-probe-kit memory tools (`search_memory`, `memorize_asset`, `read_memory_asset`, `scan_and_extract_patterns`):
 
 - **Qdrant** — vector database (port `50008`)
 - **Infinity (nomic-embed)** — embedding API (port `50012`), replaces Ollama for users who want a smaller footprint

package/docs/memory-local-setup.zh-CN.md

@@ -1,6 +1,6 @@
 # 本地记忆栈（Qdrant + Nomic Embed）
 
-面向 `memorize_asset`、`read_memory_asset`、`scan_and_extract_patterns` 的**轻量本机部署**说明：
+面向 `search_memory`、`memorize_asset`、`read_memory_asset`、`scan_and_extract_patterns` 的**轻量本机部署**说明：
 
 - **Qdrant** — 向量库（端口 `50008`）
 - **Infinity（nomic-embed）** — 向量生成（端口 `50012`），**替代 Ollama**，对用户更轻
@@ -229,7 +229,10 @@ Swagger：`http://127.0.0.1:50012/docs`
         "MEMORY_EMBEDDING_MODEL": "nomic-ai/nomic-embed-text-v1.5",
         "MEMORY_EMBEDDING_API_KEY": "与 nomic-embed/.env 中 INFINITY_API_KEY 相同",
         "MEMORY_SEARCH_LIMIT": "3",
-        "MEMORY_SUMMARY_MAX_CHARS": "280"
+        "MEMORY_SUMMARY_MAX_CHARS": "280",
+        "MEMORY_SEARCH_MIN_SCORE": "0",
+        "MEMORY_SEARCH_SHOW_SOURCE": "false",
+        "MEMORY_REPO_ID": ""
       }
     }
   }

package/docs/pages/getting-started.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>MCP Probe Kit - AI-Powered Complete Development Toolkit | 28 Tools Covering Entire Development Lifecycle</title>
+    <title>MCP Probe Kit - AI-Powered Complete Development Toolkit | 29 Tools Covering Entire Development Lifecycle</title>
     <meta name="i18n-title" content="meta.title">
     
     <!-- SEO Meta Tags -->
@@ -99,7 +99,7 @@
                 <a href="./all-tools.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
                     <span>🛠️</span>
                     <span data-i18n="sidebar.allTools">All Tools</span>
-                    <span class="ml-auto bg-bg-page text-xs px-2 py-0.5 rounded-full">28</span>
+                    <span class="ml-auto bg-bg-page text-xs px-2 py-0.5 rounded-full">29</span>
                 </a>
             </div>
             
@@ -250,6 +250,7 @@
                         <h3 class="font-semibold mb-2" data-i18n="gettingStarted.step1.memory.title">Memory System Setup (Qdrant + Embedding)</h3>
                         <p class="mb-3 text-text-secondary">
                             <span data-i18n="gettingStarted.step1.memory.descriptionPrefix">If you want to use</span>
+                            <code class="bg-gray-200 px-1 rounded text-xs">search_memory</code>、
                             <code class="bg-gray-200 px-1 rounded text-xs">memorize_asset</code>、
                             <code class="bg-gray-200 px-1 rounded text-xs">read_memory_asset</code>、
                             <code class="bg-gray-200 px-1 rounded text-xs">scan_and_extract_patterns</code>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.19",
-  "description": "AI-Powered Development Toolkit - MCP Server with 28 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
+  "version": "3.0.21",
+  "description": "AI-Powered Development Toolkit - MCP Server with 29 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "mcpName": "io.github.mybolide/mcp-probe-kit",
   "type": "module",
   "main": "build/index.js",