mcp-probe-kit 3.0.19 → 3.0.22

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/schemas/output/ui-ux-tools.d.ts

@@ -194,6 +194,18 @@ export declare const SyncReportSchema: {
                 readonly patterns: {
                     readonly type: "number";
                 };
+                readonly shadcnBlocks: {
+                    readonly type: "number";
+                };
+                readonly shadcnComponents: {
+                    readonly type: "number";
+                };
+                readonly themes: {
+                    readonly type: "number";
+                };
+                readonly vercelGuidelines: {
+                    readonly type: "number";
+                };
             };
         };
         readonly version: {
@@ -421,6 +433,10 @@ export interface SyncReport {
         icons?: number;
         components?: number;
         patterns?: number;
+        shadcnBlocks?: number;
+        shadcnComponents?: number;
+        themes?: number;
+        vercelGuidelines?: number;
     };
     version?: string;
     timestamp?: string;

package/build/schemas/output/ui-ux-tools.js

@@ -100,6 +100,10 @@ export const SyncReportSchema = {
                 icons: { type: 'number' },
                 components: { type: 'number' },
                 patterns: { type: 'number' },
+                shadcnBlocks: { type: 'number' },
+                shadcnComponents: { type: 'number' },
+                themes: { type: 'number' },
+                vercelGuidelines: { type: 'number' },
             },
         },
         version: { type: 'string' },

package/build/schemas/ui-ux-schemas.js

@@ -33,7 +33,7 @@ export const uiDesignSystemSchema = {
 };
 export const uiSearchSchema = {
     name: "ui_search",
-    description: "搜索 UI/UX 数据库，包括颜色、图标、图表、组件、设计模式等。支持三种模式：search（搜索数据）、catalog（查看组件目录）、template（搜索 UI 模板）。使用 BM25 算法进行智能搜索，支持按类别和技术栈过滤。数据来源：uipro-cli npm 包（v2.2.0+）。",
+    description: "搜索 UI/UX 数据库，包括颜色、图标、图表、组件、设计模式，以及 shadcn/ui blocks、UI 主题预设（CSS variables）、Vercel Web Interface Guidelines 等。支持 search / catalog / template 三种模式。",
     inputSchema: {
         type: "object",
         properties: {
@@ -48,7 +48,7 @@ export const uiSearchSchema = {
             },
             category: {
                 type: "string",
-                description: "数据类别（仅 search 模式）：colors（颜色）、icons（图标）、charts（图表）、landing（落地页）、products（产品）、typography（字体）、styles（样式）、ux-guidelines（UX 指南）、web-interface（Web 界面）等",
+                description: "数据类别（search 模式）：colors、icons、charts、landing、products、typography、styles、ux-guidelines、shadcn-blocks、shadcn-components、ui-themes、ui-guidelines-vercel 等",
             },
             stack: {
                 type: "string",
@@ -69,7 +69,7 @@ export const uiSearchSchema = {
 };
 export const syncUiDataSchema = {
     name: "sync_ui_data",
-    description: "同步 UI/UX 数据到本地缓存。从 npm 包 uipro-cli 下载最新数据，支持自动检查更新和强制同步。数据存储在 ~/.mcp-probe-kit/ui-ux-data/，默认在下次启动时生效以保证当前会话一致性。",
+    description: "同步 UI/UX 数据到本地缓存。来源：uipro-cli、shadcn/ui registry、内嵌 UI 主题预设、Vercel Web Interface Guidelines。",
     inputSchema: {
         type: "object",
         properties: {

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

@@ -17,8 +17,8 @@ describe('start_ui 属性测试', () => {
             const text = result.content[0].text || '';
             // 简单的 token 估算：按空格和标点分割
             const tokenCount = text.split(/[\s\n]+/).length;
-            // 硬性约束：必须少于 800 tokens
-            expect(tokenCount).toBeLessThan(800);
+            // 硬性约束：必须少于 1050 tokens（含 shadcn/主题/规范路径后略增）
+            expect(tokenCount).toBeLessThan(1050);
         }), { numRuns: 100 });
     });
     // Feature: ui-workflow-execution-issue, Property 18: 一致的 Markdown 结构
@@ -242,7 +242,8 @@ test('任务 6.4: 无模糊语言', async () => {
                 match.includes('文件') ||
                 match.includes('权限') ||
                 match.includes('docs/') ||
-                match.includes('目录');
+                match.includes('目录') ||
+                match.includes('`');
             expect(hasSpecific).toBe(true);
         });
     }), { numRuns: 100 });

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;
+}>;

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

@@ -17,6 +17,27 @@ import { detectProjectType } from "../lib/project-detector.js";
 import { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRootRetryHint } from "../lib/workspace-root.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 import { buildMemoryPlanStep, loadMemoryInjectionContext, renderMemoryGuideSection, } from "../lib/memory-orchestration.js";
+import { isShadcnStack } from "../lib/shadcn-ui.js";
+function buildShadcnBlocksPlanStep(description, framework) {
+    if (!isShadcnStack(framework)) {
+        return [];
+    }
+    return [
+        {
+            id: 'shadcn-blocks',
+            tool: 'ui_search',
+            when: 'React/Next 栈：调用 ui_search（category=shadcn-blocks）匹配 block',
+            args: {
+                mode: 'search',
+                query: description,
+                category: 'shadcn-blocks',
+                stack: framework,
+                limit: 5,
+            },
+            outputs: [],
+        },
+    ];
+}
 function inferProductType(description) {
     const text = (description || '').toLowerCase();
     if (/电商|e-?commerce|shop|商城|购物/.test(text))
@@ -542,7 +563,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"];
@@ -651,6 +672,7 @@ start_ui <描述> --requirements_mode=loop
                         args: {},
                         outputs: ['docs/ui/component-catalog.json'],
                     },
+                    ...buildShadcnBlocksPlanStep(description, framework),
                     {
                         id: 'template',
                         tool: 'ui_search',
@@ -867,6 +889,7 @@ ${recommendation.reasoning}
                         args: {},
                         outputs: ['docs/ui/component-catalog.json'],
                     },
+                    ...buildShadcnBlocksPlanStep(description, inferredStack),
                     {
                         id: 'template',
                         tool: 'ui_search',
@@ -906,7 +929,7 @@ ${recommendation.reasoning}
                 ],
                 notes: [
                     ...headerNotes,
-                    ...(memoryContext.enabled ? ['记忆系统: 已启用，必要时先读取相似历史 UI 资产'] : []),
+                    ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史 UI 经验全文已自动注入'] : []),
                 ],
             });
             const smartPlan = header + skillBridgeSection + (profileDecision.resolved === 'strict' ? smartPlanStrict : smartPlanGuided) + memoryGuideSection;
@@ -1037,7 +1060,7 @@ start_ui "设置页面" --framework=react
             ],
             notes: [
                 ...headerNotes,
-                ...(memoryContext.enabled ? ['记忆系统: 已启用，必要时先读取相似历史 UI 资产'] : []),
+                ...(memoryContext.enabled ? ['记忆系统: 已启用，相似历史 UI 经验全文已自动注入'] : []),
             ],
         });
         const baseTemplate = profileDecision.resolved === 'strict'
@@ -1078,6 +1101,7 @@ start_ui "设置页面" --framework=react
                     args: {},
                     outputs: ['docs/ui/component-catalog.json'],
                 },
+                ...buildShadcnBlocksPlanStep(description, framework),
                 {
                     id: 'template',
                     tool: 'ui_search',
@@ -1151,9 +1175,12 @@ start_ui "设置页面" --framework=react
             ],
             artifacts: [],
             nextSteps: [
-                '检查项目上下文，如不存在则调用 init_project_context',
-                '检查设计系统文件，如不存在则调用 ui_design_system',
-                '检查组件目录，如不存在则调用 init_component_catalog',
+                '检查 docs/project-context.md，如不存在则调用 init_project_context',
+                '检查 docs/design-system.md，如不存在则调用 ui_design_system',
+                '检查 docs/ui/component-catalog.json，如不存在则调用 init_component_catalog',
+                ...(isShadcnStack(framework)
+                    ? [`调用 ui_search --category=shadcn-blocks --query="${description}" 匹配 shadcn block`]
+                    : []),
                 `调用 ui_search --mode=template --query="${description}"`,
                 `保存模板到 docs/ui/${templateName}.json`,
                 `调用 render_ui --framework="${framework}"`,