mcp-probe-kit 3.0.21 → 3.0.23

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__/cursor-history.unit.test.js

@@ -1,67 +1,18 @@
 import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
-const listConversationsMock = vi.fn();
-const searchHistoryMock = vi.fn();
 const readConversationMock = vi.fn();
 vi.mock('../../lib/cursor-history-client.js', () => ({
     createCursorHistoryClient: () => ({
-        listConversations: listConversationsMock,
-        searchHistory: searchHistoryMock,
         readConversation: readConversationMock,
     }),
 }));
-import { cursorListConversations } from '../cursor_list_conversations.js';
-import { cursorSearchConversations } from '../cursor_search_conversations.js';
 import { cursorReadConversation } from '../cursor_read_conversation.js';
 beforeEach(() => {
-    listConversationsMock.mockReset();
-    searchHistoryMock.mockReset();
     readConversationMock.mockReset();
 });
 afterEach(() => {
     vi.clearAllMocks();
 });
 describe('cursor history tools', () => {
-    test('cursor_list_conversations 返回摘要列表', async () => {
-        listConversationsMock.mockResolvedValue([
-            { composerId: 'c1', name: '新需求', source: 'composerHeaders' },
-        ]);
-        const result = await cursorListConversations({ title_query: '新需求', limit: 10 });
-        expect(result.isError).toBe(false);
-        expect('structuredContent' in result).toBe(true);
-        if (!('structuredContent' in result)) {
-            throw new Error('structuredContent 缺失');
-        }
-        expect(result.content[0].text).toContain('已获取 1 条 Cursor 会话摘要');
-        expect(result.structuredContent.count).toBe(1);
-        expect(listConversationsMock).toHaveBeenCalledWith({
-            titleQuery: '新需求',
-            workspaceQuery: '',
-            includeArchived: false,
-            limit: 10,
-        });
-    });
-    test('cursor_search_conversations 缺少 query 时返回错误', async () => {
-        const result = await cursorSearchConversations({});
-        expect(result.isError).toBe(true);
-        expect(result.content[0].text).toContain('缺少必填参数: query');
-    });
-    test('cursor_search_conversations 返回命中结果', async () => {
-        searchHistoryMock.mockResolvedValue([
-            { composerId: 'c1', conversationName: '新需求', bubbleId: 'b1', type: 1, text: '我们先聊需求' },
-        ]);
-        const result = await cursorSearchConversations({ query: '需求', composer_id: 'c1', limit: 5 });
-        expect(result.isError).toBe(false);
-        expect('structuredContent' in result).toBe(true);
-        if (!('structuredContent' in result)) {
-            throw new Error('structuredContent 缺失');
-        }
-        expect(result.structuredContent.count).toBe(1);
-        expect(searchHistoryMock).toHaveBeenCalledWith({
-            query: '需求',
-            composerId: 'c1',
-            limit: 5,
-        });
-    });
     test('cursor_read_conversation 返回消息时间线', async () => {
         readConversationMock.mockResolvedValue({
             composerId: 'c1',

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

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

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

@@ -0,0 +1,83 @@
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+const searchMock = vi.fn();
+const isEnabledMock = vi.fn();
+vi.mock('../../lib/memory-client.js', () => ({
+    createMemoryClient: () => ({
+        isEnabled: isEnabledMock,
+        search: searchMock,
+    }),
+}));
+import { searchMemory } from '../search_memory.js';
+import { formatSearchMemoryResultsText } from '../../lib/memory-orchestration.js';
+beforeEach(() => {
+    isEnabledMock.mockReset();
+    searchMock.mockReset();
+});
+afterEach(() => {
+    vi.clearAllMocks();
+});
+describe('formatSearchMemoryResultsText', () => {
+    test('renders id, summary, description and read hint', () => {
+        const text = formatSearchMemoryResultsText([
+            {
+                id: '6c97bd10-654e-4f25-a560-99f7469dc11a',
+                score: 0.678,
+                name: 'playwright-e2e-testing-speed-pattern',
+                type: 'pattern',
+                description: 'Speed up Playwright E2E suites',
+                summary: 'Playwright E2E parallelization pattern',
+                tags: ['pattern', 'e2e'],
+            },
+        ]);
+        expect(text).toContain('找到 1 条相关记忆');
+        expect(text).toContain('id: 6c97bd10-654e-4f25-a560-99f7469dc11a');
+        expect(text).toContain('摘要: Playwright E2E parallelization pattern');
+        expect(text).toContain('描述: Speed up Playwright E2E suites');
+        expect(text).toContain('read_memory_asset {"asset_id": "6c97bd10-654e-4f25-a560-99f7469dc11a"}');
+    });
+    test('returns empty-state text', () => {
+        expect(formatSearchMemoryResultsText([])).toBe('未找到相关记忆');
+    });
+});
+describe('search_memory 单元测试', () => {
+    test('记忆服务未开启时返回跳过结果', async () => {
+        isEnabledMock.mockReturnValue(false);
+        const result = await searchMemory({ query: 'test' });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('记忆服务未开启');
+        expect(result.structuredContent).toEqual({ enabled: false, results: [] });
+        expect(searchMock).not.toHaveBeenCalled();
+    });
+    test('命中结果时文本输出包含 asset 字段', async () => {
+        isEnabledMock.mockReturnValue(true);
+        searchMock.mockResolvedValue([
+            {
+                id: 'asset-1',
+                score: 0.88,
+                name: 'feishu-proxy-bug',
+                type: 'bugfix',
+                description: 'Feishu proxy mismatch',
+                summary: 'proxy caused 400 on HTTPS',
+                tags: ['bugfix', 'proxy'],
+            },
+        ]);
+        const result = await searchMemory({ query: 'proxy', limit: 1 });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('id: asset-1');
+        expect(result.content[0].text).toContain('摘要: proxy caused 400 on HTTPS');
+        expect(result.content[0].text).toContain('描述: Feishu proxy mismatch');
+        expect(result.structuredContent.results[0]).toEqual(expect.objectContaining({
+            id: 'asset-1',
+            description: 'Feishu proxy mismatch',
+            summary: 'proxy caused 400 on HTTPS',
+        }));
+    });
+});

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

@@ -20,8 +20,6 @@ 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";
-export { cursorListConversations } from "./cursor_list_conversations.js";
-export { cursorSearchConversations } from "./cursor_search_conversations.js";
 export { cursorReadConversation } from "./cursor_read_conversation.js";
 export { startProduct } from "./start_product.js";
 export { gitWorkReport } from "./git_work_report.js";

package/build/tools/index.js

@@ -24,8 +24,6 @@ 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";
-export { cursorListConversations } from "./cursor_list_conversations.js";
-export { cursorSearchConversations } from "./cursor_search_conversations.js";
 export { cursorReadConversation } from "./cursor_read_conversation.js";
 // 产品设计工作流
 export { startProduct } from "./start_product.js";

package/build/tools/search_memory.js

@@ -1,7 +1,7 @@
 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 { formatSearchMemoryResultsText, 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) {
@@ -40,11 +40,12 @@ export async function searchMemory(args) {
             score: item.score,
             name: item.name,
             type: item.type,
+            description: item.description,
             summary: item.summary,
             tags: item.tags,
             sourcePath: shouldShowSourceInSearch(item, config) ? item.sourcePath : undefined,
         }));
-        return okStructured(results.length > 0 ? `找到 ${results.length} 条相关记忆` : '未找到相关记忆', {
+        return okStructured(formatSearchMemoryResultsText(results, config), {
             enabled: true,
             query,
             count: results.length,

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))
@@ -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',
@@ -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}"`,