mcp-probe-kit 3.0.19 → 3.0.21

package/build/lib/memory-orchestration.js

@@ -1,5 +1,35 @@
 import { createMemoryClient } from './memory-client.js';
-export async function loadMemoryInjectionContext(query) {
+import { getMemoryConfig } from './memory-config.js';
+function kindSearchPreferences(kind) {
+    switch (kind) {
+        case 'bugfix':
+            return { preferTypes: ['bugfix'], preferTags: ['bugfix', 'root-cause'] };
+        case 'ui':
+            return { preferTypes: ['component', 'pattern'], preferTags: ['ui', 'pattern'] };
+        case 'feature':
+            return { preferTypes: ['pattern', 'code'], preferTags: ['feature', 'pattern'] };
+        default:
+            return { preferTypes: [], preferTags: [] };
+    }
+}
+export function truncateInjectionText(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxChars - 3))}...`;
+}
+async function loadFullAssets(results) {
+    const client = createMemoryClient();
+    if (!client.isReadEnabled() || results.length === 0) {
+        return {};
+    }
+    const entries = await Promise.all(results.map(async (item) => {
+        const asset = await client.getAsset(item.id);
+        return asset ? [item.id, asset] : null;
+    }));
+    return Object.fromEntries(entries.filter((entry) => entry !== null));
+}
+export async function loadMemoryInjectionContext(query, kind = 'default') {
     const client = createMemoryClient();
     if (!client.isEnabled()) {
         return {
@@ -8,16 +38,23 @@ export async function loadMemoryInjectionContext(query) {
             degraded: false,
             query,
             results: [],
+            assetsById: {},
         };
     }
     try {
-        const results = await client.search(query);
+        const prefs = kindSearchPreferences(kind);
+        const results = await client.search(query, {
+            preferTypes: prefs.preferTypes,
+            preferTags: prefs.preferTags,
+        });
+        const assetsById = await loadFullAssets(results);
         return {
             enabled: true,
             available: true,
             degraded: false,
             query,
             results,
+            assetsById,
         };
     }
     catch (error) {
@@ -27,6 +64,7 @@ export async function loadMemoryInjectionContext(query) {
             degraded: true,
             query,
             results: [],
+            assetsById: {},
             error: error instanceof Error ? error.message : String(error),
         };
     }
@@ -39,7 +77,44 @@ function formatMemoryResultLabel(item) {
             : '历史资产';
     return `${item.name} [${item.type}] (${kind})`;
 }
+export function shouldShowSourceInSearch(item, config = getMemoryConfig()) {
+    if (config.searchShowSource) {
+        return Boolean(item.sourcePath);
+    }
+    if (!config.repoId || !item.sourceProject || !item.sourcePath) {
+        return false;
+    }
+    return item.sourceProject === config.repoId;
+}
+function formatSourceHint(item, config) {
+    if (!shouldShowSourceInSearch(item, config)) {
+        return '';
+    }
+    return `\n   - 来源: ${item.sourcePath}`;
+}
+function formatAssetBody(asset, config) {
+    const lines = [
+        `### ${asset.name}`,
+        `- asset_id: ${asset.id}`,
+        asset.description ? `- 描述: ${asset.description}` : '',
+        asset.usage ? `- 适用: ${asset.usage}` : '',
+        asset.tags.length > 0 ? `- 标签: ${asset.tags.join(', ')}` : '',
+        '',
+        truncateInjectionText(asset.content, config.injectionContentMaxChars),
+    ].filter(Boolean);
+    return lines.join('\n');
+}
+function formatResultBlock(item, index, context, config) {
+    const label = formatMemoryResultLabel(item);
+    const asset = context.assetsById[item.id];
+    const header = `${index + 1}. ${label} score=${item.score.toFixed(3)}\n   - 摘要: ${item.summary}${formatSourceHint(item, config)}`;
+    if (asset?.content) {
+        return `${header}\n\n${formatAssetBody(asset, config)}\n`;
+    }
+    return `${header}\n   - 全文加载失败，可手动: read_memory_asset {"asset_id": "${item.id}"}\n`;
+}
 export function renderMemoryGuideSection(context) {
+    const config = getMemoryConfig();
     if (!context.enabled) {
         return '';
     }
@@ -49,13 +124,11 @@ export function renderMemoryGuideSection(context) {
     if (context.results.length === 0) {
         return `\n\n## 🧠 记忆系统\n- 状态: 已启用\n- 检索结果: 未找到高相关记录（含历史 Bug 修复与可复用模式）\n- 处理: 继续主流程；Bug 修复验证通过后必须 \`memorize_asset\` 沉淀；功能/UI 有可复用产出再沉淀\n`;
     }
+    const loadedCount = context.results.filter((item) => context.assetsById[item.id]?.content).length;
     const items = context.results
-        .map((item, index) => {
-        const label = formatMemoryResultLabel(item);
-        return `${index + 1}. ${label} score=${item.score.toFixed(3)}\n   - 摘要: ${item.summary}\n   - 读取: read_memory_asset {\"asset_id\": \"${item.id}\"}${item.sourcePath ? `\n   - 来源: ${item.sourcePath}` : ''}`;
-    })
+        .map((item, index) => formatResultBlock(item, index, context, config))
         .join('\n');
-    return `\n\n## 🧠 记忆系统\n- 状态: 已启用\n- 指令: 开干前先复用下列记录（含历史 Bug 现象/根因/改法）；相关条目用 \`read_memory_asset\` 读全文，避免重复踩坑\n- 检索结果:\n${items}\n`;
+    return `\n\n## 🧠 记忆系统\n- 状态: 已启用\n- 指令: 下列为已自动加载的历史经验全文（${loadedCount}/${context.results.length} 条）；开干前直接复用，无需再调 \`read_memory_asset\`\n- 检索结果:\n${items}`;
 }
 export function buildMemoryPlanStep(kind = 'default') {
     if (kind === 'bugfix') {
@@ -68,7 +141,7 @@ export function buildMemoryPlanStep(kind = 'default') {
                 type: 'bugfix',
                 description: '[现象、报错信息、复现条件]',
                 summary: '[检索用：关键词 + 根因 + 修复要点，一句话]',
-                content: '【现象】...\n【根因】...\n【修复】具体改动文件与关键代码/配置\n【验证】如何确认已修好',
+                content: '【现象】...\n【根因】...\n【修复】具体改动与关键代码/配置\n【验证】如何确认已修好',
                 usage: '[再次遇到何种症状时可参考]',
                 tags: ['bugfix', 'root-cause'],
                 confidence: 0.85,

package/build/lib/memory-payload.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Unify legacy Qdrant payloads (kind/title/source) with the current asset schema.
+ */
+export declare function normalizeMemoryPayload(payload: Record<string, unknown>): Record<string, unknown>;
+export declare function payloadToMemoryFields(payload: Record<string, unknown>): {
+    id: string;
+    name: string;
+    type: string;
+    description: string;
+    summary: string;
+    content: string;
+    tags: string[];
+    confidence: number;
+    sourceProject?: string;
+    sourcePath?: string;
+    usage?: string;
+    contentHash?: string;
+    normalizedContentHash?: string;
+    createdAt: string;
+    updatedAt: string;
+};

package/build/lib/memory-payload.js

@@ -0,0 +1,65 @@
+function truncate(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxChars - 3))}...`;
+}
+/**
+ * Unify legacy Qdrant payloads (kind/title/source) with the current asset schema.
+ */
+export function normalizeMemoryPayload(payload) {
+    const normalized = { ...payload };
+    if (!normalized.name && typeof normalized.title === 'string') {
+        normalized.name = normalized.title;
+    }
+    if (!normalized.type && typeof normalized.kind === 'string') {
+        const kind = normalized.kind;
+        normalized.type = kind === 'extracted_pattern' ? 'pattern' : kind;
+    }
+    if (!normalized.description) {
+        if (typeof normalized.title === 'string') {
+            normalized.description = normalized.title;
+        }
+        else if (typeof normalized.source === 'string') {
+            normalized.description = `Legacy memory from ${normalized.source}`;
+        }
+    }
+    if (!normalized.summary && typeof normalized.content === 'string') {
+        normalized.summary = truncate(normalized.content, 280);
+    }
+    if (!normalized.createdAt && typeof normalized.created_at === 'string') {
+        normalized.createdAt = normalized.created_at;
+    }
+    if (!normalized.updatedAt) {
+        if (typeof normalized.updated_at === 'string') {
+            normalized.updatedAt = normalized.updated_at;
+        }
+        else if (typeof normalized.createdAt === 'string') {
+            normalized.updatedAt = normalized.createdAt;
+        }
+    }
+    return normalized;
+}
+export function payloadToMemoryFields(payload) {
+    const p = normalizeMemoryPayload(payload);
+    const tags = Array.isArray(p.tags)
+        ? p.tags.filter((item) => typeof item === 'string' && item.trim().length > 0)
+        : [];
+    return {
+        id: String(p.id || ''),
+        name: String(p.name || ''),
+        type: String(p.type || ''),
+        description: String(p.description || ''),
+        summary: String(p.summary || ''),
+        content: String(p.content || ''),
+        tags,
+        confidence: typeof p.confidence === 'number' && Number.isFinite(p.confidence) ? p.confidence : 0.5,
+        sourceProject: typeof p.sourceProject === 'string' ? p.sourceProject : undefined,
+        sourcePath: typeof p.sourcePath === 'string' ? p.sourcePath : undefined,
+        usage: typeof p.usage === 'string' ? p.usage : undefined,
+        contentHash: typeof p.contentHash === 'string' ? p.contentHash : undefined,
+        normalizedContentHash: typeof p.normalizedContentHash === 'string' ? p.normalizedContentHash : undefined,
+        createdAt: String(p.createdAt || ''),
+        updatedAt: String(p.updatedAt || ''),
+    };
+}

package/build/resources/ui-ux-data/metadata.json

@@ -1,6 +1,6 @@
 {
   "version": "2.2.3",
-  "syncedAt": "2026-05-26T08:30:56.969Z",
+  "syncedAt": "2026-05-27T08:58:13.736Z",
   "source": "uipro-cli",
   "format": "json"
 }

package/build/schemas/index.d.ts

@@ -688,6 +688,35 @@ export declare const allToolSchemas: ({
         };
         required: never[];
     };
+} | {
+    readonly name: "search_memory";
+    readonly description: "按语义检索共享记忆库。适合在 start_* 之外主动查找历史 Bug 修复或可复用模式；命中后用 read_memory_asset 读取全文。";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "检索 query（现象、报错、关键词、功能描述等）";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly description: "优先匹配的资产类型，如 bugfix、pattern、component";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "优先匹配的标签";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "返回条数，默认 MEMORY_SEARCH_LIMIT";
+            };
+        };
+        readonly required: readonly ["query"];
+        readonly additionalProperties: true;
+    };
 } | {
     readonly name: "read_memory_asset";
     readonly description: "当编排阶段已检索到记忆摘要，且 AI 需要查看完整沉淀代码或详细规范时使用。根据 asset_id 读取记忆资产详情。";
@@ -704,7 +733,7 @@ export declare const allToolSchemas: ({
     };
 } | {
     readonly name: "memorize_asset";
-    readonly description: "沉淀可检索资产到记忆系统：可复用代码/模式；Bug 修复后必须写入 type=bugfix（现象、根因、改法、tags 含 bugfix）。";
+    readonly description: "沉淀可检索资产到共享记忆库。Bug 修复后必须 type=bugfix，content 含【现象】【根因】【修复】【验证】。跨仓库共享时勿填 source_project/source_path，路径写入 content 即可。";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -714,7 +743,7 @@ export declare const allToolSchemas: ({
             };
             readonly type: {
                 readonly type: "string";
-                readonly description: "资产类型，如 code/component/pattern/spec";
+                readonly description: "资产类型：bugfix / pattern / component / code 等";
             };
             readonly description: {
                 readonly type: "string";
@@ -722,11 +751,11 @@ export declare const allToolSchemas: ({
             };
             readonly summary: {
                 readonly type: "string";
-                readonly description: "用于检索的凝练摘要";
+                readonly description: "检索用一句话摘要（关键词 + 根因/要点）";
             };
             readonly content: {
                 readonly type: "string";
-                readonly description: "完整内容";
+                readonly description: "完整内容（bugfix 建议结构化四段）";
             };
             readonly code_snippet: {
                 readonly type: "string";
@@ -734,15 +763,15 @@ export declare const allToolSchemas: ({
             };
             readonly file_path: {
                 readonly type: "string";
-                readonly description: "来源文件路径";
+                readonly description: "已废弃：勿用于跨仓库沉淀，路径写入 content";
             };
             readonly source_project: {
                 readonly type: "string";
-                readonly description: "来源项目";
+                readonly description: "已废弃：仅同仓库追溯时可选";
             };
             readonly source_path: {
                 readonly type: "string";
-                readonly description: "来源路径";
+                readonly description: "已废弃：仅同仓库追溯时可选";
             };
             readonly usage: {
                 readonly type: "string";
@@ -757,7 +786,7 @@ export declare const allToolSchemas: ({
                 readonly items: {
                     readonly type: "string";
                 };
-                readonly description: "标签列表";
+                readonly description: "标签列表，如 bugfix, root-cause";
             };
         };
         readonly required: readonly ["name", "description", "summary"];
@@ -779,7 +808,7 @@ export declare const allToolSchemas: ({
             };
             readonly project_name: {
                 readonly type: "string";
-                readonly description: "来源项目名";
+                readonly description: "已废弃，扫描结果不再写入 source_project";
             };
             readonly directory_path: {
                 readonly type: "string";

package/build/schemas/memory-tools.d.ts

@@ -1,4 +1,33 @@
 export declare const memoryToolSchemas: readonly [{
+    readonly name: "search_memory";
+    readonly description: "按语义检索共享记忆库。适合在 start_* 之外主动查找历史 Bug 修复或可复用模式；命中后用 read_memory_asset 读取全文。";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "检索 query（现象、报错、关键词、功能描述等）";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly description: "优先匹配的资产类型，如 bugfix、pattern、component";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "优先匹配的标签";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "返回条数，默认 MEMORY_SEARCH_LIMIT";
+            };
+        };
+        readonly required: readonly ["query"];
+        readonly additionalProperties: true;
+    };
+}, {
     readonly name: "read_memory_asset";
     readonly description: "当编排阶段已检索到记忆摘要，且 AI 需要查看完整沉淀代码或详细规范时使用。根据 asset_id 读取记忆资产详情。";
     readonly inputSchema: {
@@ -14,7 +43,7 @@ export declare const memoryToolSchemas: readonly [{
     };
 }, {
     readonly name: "memorize_asset";
-    readonly description: "沉淀可检索资产到记忆系统：可复用代码/模式；Bug 修复后必须写入 type=bugfix（现象、根因、改法、tags 含 bugfix）。";
+    readonly description: "沉淀可检索资产到共享记忆库。Bug 修复后必须 type=bugfix，content 含【现象】【根因】【修复】【验证】。跨仓库共享时勿填 source_project/source_path，路径写入 content 即可。";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -24,7 +53,7 @@ export declare const memoryToolSchemas: readonly [{
             };
             readonly type: {
                 readonly type: "string";
-                readonly description: "资产类型，如 code/component/pattern/spec";
+                readonly description: "资产类型：bugfix / pattern / component / code 等";
             };
             readonly description: {
                 readonly type: "string";
@@ -32,11 +61,11 @@ export declare const memoryToolSchemas: readonly [{
             };
             readonly summary: {
                 readonly type: "string";
-                readonly description: "用于检索的凝练摘要";
+                readonly description: "检索用一句话摘要（关键词 + 根因/要点）";
             };
             readonly content: {
                 readonly type: "string";
-                readonly description: "完整内容";
+                readonly description: "完整内容（bugfix 建议结构化四段）";
             };
             readonly code_snippet: {
                 readonly type: "string";
@@ -44,15 +73,15 @@ export declare const memoryToolSchemas: readonly [{
             };
             readonly file_path: {
                 readonly type: "string";
-                readonly description: "来源文件路径";
+                readonly description: "已废弃：勿用于跨仓库沉淀，路径写入 content";
             };
             readonly source_project: {
                 readonly type: "string";
-                readonly description: "来源项目";
+                readonly description: "已废弃：仅同仓库追溯时可选";
             };
             readonly source_path: {
                 readonly type: "string";
-                readonly description: "来源路径";
+                readonly description: "已废弃：仅同仓库追溯时可选";
             };
             readonly usage: {
                 readonly type: "string";
@@ -67,7 +96,7 @@ export declare const memoryToolSchemas: readonly [{
                 readonly items: {
                     readonly type: "string";
                 };
-                readonly description: "标签列表";
+                readonly description: "标签列表，如 bugfix, root-cause";
             };
         };
         readonly required: readonly ["name", "description", "summary"];
@@ -89,7 +118,7 @@ export declare const memoryToolSchemas: readonly [{
             };
             readonly project_name: {
                 readonly type: "string";
-                readonly description: "来源项目名";
+                readonly description: "已废弃，扫描结果不再写入 source_project";
             };
             readonly directory_path: {
                 readonly type: "string";

package/build/schemas/memory-tools.js

@@ -1,4 +1,19 @@
 export const memoryToolSchemas = [
+    {
+        name: 'search_memory',
+        description: '按语义检索共享记忆库。适合在 start_* 之外主动查找历史 Bug 修复或可复用模式；命中后用 read_memory_asset 读取全文。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: '检索 query（现象、报错、关键词、功能描述等）' },
+                type: { type: 'string', description: '优先匹配的资产类型，如 bugfix、pattern、component' },
+                tags: { type: 'array', items: { type: 'string' }, description: '优先匹配的标签' },
+                limit: { type: 'number', description: '返回条数，默认 MEMORY_SEARCH_LIMIT' },
+            },
+            required: ['query'],
+            additionalProperties: true,
+        },
+    },
     {
         name: 'read_memory_asset',
         description: '当编排阶段已检索到记忆摘要，且 AI 需要查看完整沉淀代码或详细规范时使用。根据 asset_id 读取记忆资产详情。',
@@ -16,22 +31,22 @@ export const memoryToolSchemas = [
     },
     {
         name: 'memorize_asset',
-        description: '沉淀可检索资产到记忆系统：可复用代码/模式；Bug 修复后必须写入 type=bugfix（现象、根因、改法、tags 含 bugfix）。',
+        description: '沉淀可检索资产到共享记忆库。Bug 修复后必须 type=bugfix，content 含【现象】【根因】【修复】【验证】。跨仓库共享时勿填 source_project/source_path，路径写入 content 即可。',
         inputSchema: {
             type: 'object',
             properties: {
                 name: { type: 'string', description: '资产名称' },
-                type: { type: 'string', description: '资产类型，如 code/component/pattern/spec' },
+                type: { type: 'string', description: '资产类型：bugfix / pattern / component / code 等' },
                 description: { type: 'string', description: '资产描述' },
-                summary: { type: 'string', description: '用于检索的凝练摘要' },
-                content: { type: 'string', description: '完整内容' },
+                summary: { type: 'string', description: '检索用一句话摘要（关键词 + 根因/要点）' },
+                content: { type: 'string', description: '完整内容（bugfix 建议结构化四段）' },
                 code_snippet: { type: 'string', description: '代码片段，content 的别名' },
-                file_path: { type: 'string', description: '来源文件路径' },
-                source_project: { type: 'string', description: '来源项目' },
-                source_path: { type: 'string', description: '来源路径' },
+                file_path: { type: 'string', description: '已废弃：勿用于跨仓库沉淀，路径写入 content' },
+                source_project: { type: 'string', description: '已废弃：仅同仓库追溯时可选' },
+                source_path: { type: 'string', description: '已废弃：仅同仓库追溯时可选' },
                 usage: { type: 'string', description: '适用场景/使用方式' },
                 confidence: { type: 'number', description: '置信度，0-1' },
-                tags: { type: 'array', items: { type: 'string' }, description: '标签列表' },
+                tags: { type: 'array', items: { type: 'string' }, description: '标签列表，如 bugfix, root-cause' },
             },
             required: ['name', 'description', 'summary'],
             additionalProperties: true,
@@ -45,7 +60,7 @@ export const memoryToolSchemas = [
             properties: {
                 content: { type: 'string', description: '待分析的代码或文本内容。传入该字段时走单段分析模式' },
                 file_path: { type: 'string', description: '来源文件路径。单段分析时作为来源路径使用' },
-                project_name: { type: 'string', description: '来源项目名' },
+                project_name: { type: 'string', description: '已废弃，扫描结果不再写入 source_project' },
                 directory_path: { type: 'string', description: '要扫描的目录路径。最佳实践是传相对 `project_root` 的路径，例如 `app/utils`；如果拿不到 `project_root`，才传目录绝对路径。不要传带项目名的半相对路径，例如 `font-miniapp-api/app/utils`。' },
                 project_root: { type: 'string', description: '项目根目录绝对路径。目录扫描时建议始终传入；传入后，`directory_path` 应写成相对项目根的路径。' },
                 max_files: { type: 'number', description: '最多扫描多少个文件，默认 30，最大 200' },

package/build/tools/index.d.ts

@@ -16,6 +16,7 @@ export { interview } from "./interview.js";
 export { askUser } from "./ask_user.js";
 export { uiDesignSystem, uiSearch, syncUiData } from "./ui-ux-tools.js";
 export { startUi } from "./start_ui.js";
+export { searchMemory } from "./search_memory.js";
 export { readMemoryAsset } from "./read_memory_asset.js";
 export { memorizeAsset } from "./memorize_asset.js";
 export { scanAndExtractPatterns } from "./scan_and_extract_patterns.js";

package/build/tools/index.js

@@ -20,6 +20,7 @@ export { askUser } from "./ask_user.js";
 export { uiDesignSystem, uiSearch, syncUiData } from "./ui-ux-tools.js";
 export { startUi } from "./start_ui.js";
 // 记忆工具
+export { searchMemory } from "./search_memory.js";
 export { readMemoryAsset } from "./read_memory_asset.js";
 export { memorizeAsset } from "./memorize_asset.js";
 export { scanAndExtractPatterns } from "./scan_and_extract_patterns.js";

package/build/tools/memorize_asset.js

@@ -42,6 +42,17 @@ export async function memorizeAsset(args) {
         if (!client.isEnabled()) {
             return okStructured('记忆服务未开启，已跳过沉淀。', { enabled: false, stored: false });
         }
+        const warnings = [];
+        if (type === 'bugfix') {
+            const requiredSections = ['【现象】', '【根因】', '【修复】'];
+            const missing = requiredSections.filter((section) => !content.includes(section));
+            if (missing.length > 0) {
+                warnings.push(`建议 content 包含 ${missing.join('、')}，便于跨仓库检索与复用`);
+            }
+        }
+        if (sourceProject || sourcePath) {
+            warnings.push('跨仓库共享记忆时请勿依赖 source_project/source_path；路径请写入 content 正文（可选）');
+        }
         const asset = await client.upsertAsset({
             name,
             type,
@@ -58,6 +69,7 @@ export async function memorizeAsset(args) {
             enabled: true,
             stored: true,
             asset,
+            warnings: warnings.length > 0 ? warnings : undefined,
         });
     }
     catch (error) {

package/build/tools/scan_and_extract_patterns.js

@@ -108,21 +108,22 @@ function summarizeContent(content, maxChars = 200) {
         .trim()
         .slice(0, maxChars);
 }
-function buildPattern(content, filePath, projectName) {
+function buildPattern(content, filePath) {
     const normalized = content.trim();
     const candidateNames = collectCandidateNames(normalized);
     const primaryName = candidateNames[0] || (filePath ? path.basename(filePath) : 'snippet');
     const type = detectPatternType(normalized, filePath);
     const summary = summarizeContent(normalized);
+    const fileHint = filePath ? `（摘录自 ${filePath}）` : '';
     return {
         name: primaryName,
         type,
-        description: filePath ? `从 ${filePath} 提取的可复用模式` : '从代码片段提取的可复用模式',
+        description: filePath
+            ? `从 ${filePath} 提取的可复用模式${fileHint}`
+            : '从代码片段提取的可复用模式',
         summary,
         content: normalized,
         tags: inferTags(normalized, filePath),
-        sourcePath: filePath || undefined,
-        sourceProject: projectName || undefined,
         confidence: filePath ? 0.62 : 0.55,
         candidateNames,
     };
@@ -271,7 +272,6 @@ export async function scanAndExtractPatterns(args) {
         });
         const content = getString(parsed.content);
         const filePath = getString(parsed.file_path);
-        const projectName = getString(parsed.project_name);
         const directoryPath = getString(parsed.directory_path);
         const projectRoot = resolveWorkspaceRoot(getString(parsed.project_root));
         const maxFiles = Math.max(1, Math.min(200, getNumber(parsed.max_files, 30)));
@@ -282,7 +282,7 @@ export async function scanAndExtractPatterns(args) {
                 .map((item) => item.startsWith('.') ? item.toLowerCase() : `.${item.toLowerCase()}`)
             : DEFAULT_INCLUDE_EXTENSIONS);
         if (content) {
-            const pattern = buildPattern(content, filePath, projectName || undefined);
+            const pattern = buildPattern(content, filePath);
             return okStructured(`已提取 1 个候选模式${filePath ? `: ${filePath}` : ''}`, {
                 mode: 'single',
                 patterns: [pattern],
@@ -331,7 +331,7 @@ export async function scanAndExtractPatterns(args) {
                 continue;
             }
             const relativePath = toRelativePath(absoluteFile, projectRoot).replace(/\\/g, '/');
-            patterns.push(buildPattern(normalized, relativePath, projectName || path.basename(projectRoot)));
+            patterns.push(buildPattern(normalized, relativePath));
         }
         return okStructured(`已扫描 ${files.length} 个文件，提取 ${patterns.length} 个候选模式`, {
             mode: 'directory',

package/build/tools/search_memory.d.ts

@@ -0,0 +1,7 @@
+export declare function searchMemory(args: unknown): Promise<import("../lib/response.js").ToolResponse | {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+}>;