mcp-probe-kit 3.0.14 → 3.0.16

package/build/resources/ui-ux-data/web-interface.json

@@ -0,0 +1,389 @@
+[
+  {
+    "No": "1",
+    "Category": "Accessibility",
+    "Issue": "Icon Button Labels",
+    "Keywords": "icon button aria-label",
+    "Platform": "Web",
+    "Description": "Icon-only buttons must have accessible names",
+    "Do": "Add aria-label to icon buttons",
+    "Don't": "Icon button without label",
+    "Code Example Good": "<button aria-label='Close'><XIcon /></button>",
+    "Code Example Bad": "<button><XIcon /></button>",
+    "Severity": "Critical"
+  },
+  {
+    "No": "2",
+    "Category": "Accessibility",
+    "Issue": "Form Control Labels",
+    "Keywords": "form input label aria",
+    "Platform": "Web",
+    "Description": "All form controls need labels or aria-label",
+    "Do": "Use label element or aria-label",
+    "Don't": "Input without accessible name",
+    "Code Example Good": "<label for='email'>Email</label><input id='email' />",
+    "Code Example Bad": "<input placeholder='Email' />",
+    "Severity": "Critical"
+  },
+  {
+    "No": "3",
+    "Category": "Accessibility",
+    "Issue": "Keyboard Handlers",
+    "Keywords": "keyboard onclick onkeydown",
+    "Platform": "Web",
+    "Description": "Interactive elements must support keyboard interaction",
+    "Do": "Add onKeyDown alongside onClick",
+    "Don't": "Click-only interaction",
+    "Code Example Good": "<div onClick={fn} onKeyDown={fn} tabIndex={0}>",
+    "Code Example Bad": "<div onClick={fn}>",
+    "Severity": "High"
+  },
+  {
+    "No": "4",
+    "Category": "Accessibility",
+    "Issue": "Semantic HTML",
+    "Keywords": "semantic button a label",
+    "Platform": "Web",
+    "Description": "Use semantic HTML before ARIA attributes",
+    "Do": "Use button/a/label elements",
+    "Don't": "Div with role attribute",
+    "Code Example Good": "<button onClick={fn}>Submit</button>",
+    "Code Example Bad": "<div role='button' onClick={fn}>Submit</div>",
+    "Severity": "High"
+  },
+  {
+    "No": "5",
+    "Category": "Accessibility",
+    "Issue": "Aria Live",
+    "Keywords": "aria-live polite async",
+    "Platform": "Web",
+    "Description": "Async updates need aria-live for screen readers",
+    "Do": "Add aria-live='polite' for dynamic content",
+    "Don't": "Silent async updates",
+    "Code Example Good": "<div aria-live='polite'>{status}</div>",
+    "Code Example Bad": "<div>{status}</div> // no announcement",
+    "Severity": "Medium"
+  },
+  {
+    "No": "6",
+    "Category": "Accessibility",
+    "Issue": "Decorative Icons",
+    "Keywords": "aria-hidden decorative icon",
+    "Platform": "Web",
+    "Description": "Decorative icons should be hidden from screen readers",
+    "Do": "Add aria-hidden='true' to decorative icons",
+    "Don't": "Decorative icon announced",
+    "Code Example Good": "<Icon aria-hidden='true' />",
+    "Code Example Bad": "<Icon /> // announced as 'image'",
+    "Severity": "Medium"
+  },
+  {
+    "No": "7",
+    "Category": "Focus",
+    "Issue": "Visible Focus States",
+    "Keywords": "focus-visible outline ring",
+    "Platform": "Web",
+    "Description": "All interactive elements need visible focus states",
+    "Do": "Use :focus-visible with ring/outline",
+    "Don't": "No focus indication",
+    "Code Example Good": "focus-visible:ring-2 focus-visible:ring-blue-500",
+    "Code Example Bad": "outline-none // no replacement",
+    "Severity": "Critical"
+  },
+  {
+    "No": "8",
+    "Category": "Focus",
+    "Issue": "Never Remove Outline",
+    "Keywords": "outline-none focus replacement",
+    "Platform": "Web",
+    "Description": "Never remove outline without providing replacement",
+    "Do": "Replace outline with visible alternative",
+    "Don't": "Remove outline completely",
+    "Code Example Good": "focus:outline-none focus:ring-2",
+    "Code Example Bad": "focus:outline-none // nothing else",
+    "Severity": "Critical"
+  },
+  {
+    "No": "9",
+    "Category": "Focus",
+    "Issue": "Checkbox Radio Hit Target",
+    "Keywords": "checkbox radio label target",
+    "Platform": "Web",
+    "Description": "Checkbox/radio must share hit target with label",
+    "Do": "Wrap input and label together",
+    "Don't": "Separate tiny checkbox",
+    "Code Example Good": "<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>",
+    "Code Example Bad": "<input type='checkbox' id='x' /><label for='x'>Option</label>",
+    "Severity": "Medium"
+  },
+  {
+    "No": "10",
+    "Category": "Forms",
+    "Issue": "Autocomplete Attribute",
+    "Keywords": "autocomplete input form",
+    "Platform": "Web",
+    "Description": "Inputs need autocomplete attribute for autofill",
+    "Do": "Add appropriate autocomplete value",
+    "Don't": "Missing autocomplete",
+    "Code Example Good": "<input autocomplete='email' type='email' />",
+    "Code Example Bad": "<input type='email' />",
+    "Severity": "High"
+  },
+  {
+    "No": "11",
+    "Category": "Forms",
+    "Issue": "Semantic Input Types",
+    "Keywords": "input type email tel url",
+    "Platform": "Web",
+    "Description": "Use semantic input type attributes",
+    "Do": "Use email/tel/url/number types",
+    "Don't": "text type for everything",
+    "Code Example Good": "<input type='email' />",
+    "Code Example Bad": "<input type='text' /> // for email",
+    "Severity": "Medium"
+  },
+  {
+    "No": "12",
+    "Category": "Forms",
+    "Issue": "Never Block Paste",
+    "Keywords": "paste onpaste password",
+    "Platform": "Web",
+    "Description": "Never prevent paste functionality",
+    "Do": "Allow paste on all inputs",
+    "Don't": "Block paste on password/code",
+    "Code Example Good": "<input type='password' />",
+    "Code Example Bad": "<input onPaste={e => e.preventDefault()} />",
+    "Severity": "High"
+  },
+  {
+    "No": "13",
+    "Category": "Forms",
+    "Issue": "Spellcheck Disable",
+    "Keywords": "spellcheck email code",
+    "Platform": "Web",
+    "Description": "Disable spellcheck on emails and codes",
+    "Do": "Set spellcheck='false' on codes",
+    "Don't": "Spellcheck on technical input",
+    "Code Example Good": "<input spellCheck='false' type='email' />",
+    "Code Example Bad": "<input type='email' /> // red squiggles",
+    "Severity": "Low"
+  },
+  {
+    "No": "14",
+    "Category": "Forms",
+    "Issue": "Submit Button Enabled",
+    "Keywords": "submit button disabled loading",
+    "Platform": "Web",
+    "Description": "Keep submit enabled and show spinner during requests",
+    "Do": "Show loading spinner keep enabled",
+    "Don't": "Disable button during submit",
+    "Code Example Good": "<button>{loading ? <Spinner /> : 'Submit'}</button>",
+    "Code Example Bad": "<button disabled={loading}>Submit</button>",
+    "Severity": "Medium"
+  },
+  {
+    "No": "15",
+    "Category": "Forms",
+    "Issue": "Inline Errors",
+    "Keywords": "error message inline focus",
+    "Platform": "Web",
+    "Description": "Show error messages inline near the problem field",
+    "Do": "Inline error with focus on first error",
+    "Don't": "Single error at top",
+    "Code Example Good": "<input /><span class='text-red-500'>{error}</span>",
+    "Code Example Bad": "<div class='error'>{allErrors}</div> // at top",
+    "Severity": "High"
+  },
+  {
+    "No": "16",
+    "Category": "Performance",
+    "Issue": "Virtualize Lists",
+    "Keywords": "virtualize list 50 items",
+    "Platform": "Web",
+    "Description": "Virtualize lists exceeding 50 items",
+    "Do": "Use virtual list for large datasets",
+    "Don't": "Render all items",
+    "Code Example Good": "<VirtualList items={items} />",
+    "Code Example Bad": "items.map(item => <Item />)",
+    "Severity": "High"
+  },
+  {
+    "No": "17",
+    "Category": "Performance",
+    "Issue": "Avoid Layout Reads",
+    "Keywords": "layout read render getboundingclientrect",
+    "Platform": "Web",
+    "Description": "Avoid layout reads during render phase",
+    "Do": "Read layout in effects or callbacks",
+    "Don't": "getBoundingClientRect in render",
+    "Code Example Good": "useEffect(() => { el.getBoundingClientRect() })",
+    "Code Example Bad": "const rect = el.getBoundingClientRect() // in render",
+    "Severity": "Medium"
+  },
+  {
+    "No": "18",
+    "Category": "Performance",
+    "Issue": "Batch DOM Operations",
+    "Keywords": "batch dom write read",
+    "Platform": "Web",
+    "Description": "Group DOM operations to minimize reflows",
+    "Do": "Batch writes then reads",
+    "Don't": "Interleave reads and writes",
+    "Code Example Good": "writes.forEach(w => w()); reads.forEach(r => r())",
+    "Code Example Bad": "write(); read(); write(); read(); // thrashing",
+    "Severity": "Medium"
+  },
+  {
+    "No": "19",
+    "Category": "Performance",
+    "Issue": "Preconnect CDN",
+    "Keywords": "preconnect link cdn",
+    "Platform": "Web",
+    "Description": "Add preconnect links for CDN domains",
+    "Do": "Preconnect to known domains",
+    "Don't": "<link rel='preconnect' href='https://cdn.example.com' />",
+    "Code Example Good": "// no preconnect hint",
+    "Code Example Bad": "Low"
+  },
+  {
+    "No": "20",
+    "Category": "Performance",
+    "Issue": "Lazy Load Images",
+    "Keywords": "lazy loading image below-fold",
+    "Platform": "Web",
+    "Description": "Lazy-load images below the fold",
+    "Do": "Use loading='lazy' for below-fold images",
+    "Don't": "Load all images eagerly",
+    "Code Example Good": "<img loading='lazy' src='...' />",
+    "Code Example Bad": "<img src='...' /> // above fold only",
+    "Severity": "Medium"
+  },
+  {
+    "No": "21",
+    "Category": "State",
+    "Issue": "URL Reflects State",
+    "Keywords": "url state query params",
+    "Platform": "Web",
+    "Description": "URL should reflect current UI state",
+    "Do": "Sync filters/tabs/pagination to URL",
+    "Don't": "State only in memory",
+    "Code Example Good": "?tab=settings&page=2",
+    "Code Example Bad": "useState only // lost on refresh",
+    "Severity": "High"
+  },
+  {
+    "No": "22",
+    "Category": "State",
+    "Issue": "Deep Linking",
+    "Keywords": "deep link stateful component",
+    "Platform": "Web",
+    "Description": "Stateful components should support deep-linking",
+    "Do": "Enable sharing current view via URL",
+    "Don't": "No shareable state",
+    "Code Example Good": "router.push({ query: { ...filters } })",
+    "Code Example Bad": "setFilters(f) // not in URL",
+    "Severity": "Medium"
+  },
+  {
+    "No": "23",
+    "Category": "State",
+    "Issue": "Confirm Destructive Actions",
+    "Keywords": "confirm destructive delete modal",
+    "Platform": "Web",
+    "Description": "Destructive actions require confirmation",
+    "Do": "Show confirmation dialog before delete",
+    "Don't": "Delete without confirmation",
+    "Code Example Good": "if (confirm('Delete?')) delete()",
+    "Code Example Bad": "onClick={delete} // no confirmation",
+    "Severity": "High"
+  },
+  {
+    "No": "24",
+    "Category": "Typography",
+    "Issue": "Proper Unicode",
+    "Keywords": "unicode ellipsis quotes",
+    "Platform": "Web",
+    "Description": "Use proper Unicode characters",
+    "Do": "Use ... curly quotes proper dashes",
+    "Don't": "ASCII approximations",
+    "Code Example Good": "'Hello...' with proper ellipsis",
+    "Code Example Bad": "'Hello...' with three dots",
+    "Severity": "Low"
+  },
+  {
+    "No": "25",
+    "Category": "Typography",
+    "Issue": "Text Overflow",
+    "Keywords": "truncate line-clamp overflow",
+    "Platform": "Web",
+    "Description": "Handle text overflow properly",
+    "Do": "Use truncate/line-clamp/break-words",
+    "Don't": "Text overflows container",
+    "Code Example Good": "<p class='truncate'>Long text...</p>",
+    "Code Example Bad": "<p>Long text...</p> // overflows",
+    "Severity": "Medium"
+  },
+  {
+    "No": "26",
+    "Category": "Typography",
+    "Issue": "Non-Breaking Spaces",
+    "Keywords": "nbsp unit brand",
+    "Platform": "Web",
+    "Description": "Use non-breaking spaces for units and brand names",
+    "Do": "Use &nbsp; between number and unit",
+    "Don't": "10&nbsp;kg or Next.js&nbsp;14",
+    "Code Example Good": "10 kg // may wrap",
+    "Code Example Bad": "Low"
+  },
+  {
+    "No": "27",
+    "Category": "Anti-Pattern",
+    "Issue": "No Zoom Disable",
+    "Keywords": "viewport zoom disable",
+    "Platform": "Web",
+    "Description": "Never disable zoom in viewport meta",
+    "Do": "Allow user zoom",
+    "Don't": "<meta name='viewport' content='width=device-width'>",
+    "Code Example Good": "<meta name='viewport' content='maximum-scale=1'>",
+    "Code Example Bad": "Critical"
+  },
+  {
+    "No": "28",
+    "Category": "Anti-Pattern",
+    "Issue": "No Transition All",
+    "Keywords": "transition all specific",
+    "Platform": "Web",
+    "Description": "Avoid transition: all - specify properties",
+    "Do": "Transition specific properties",
+    "Don't": "transition: all",
+    "Code Example Good": "transition-colors duration-200",
+    "Code Example Bad": "transition-all duration-200",
+    "Severity": "Medium"
+  },
+  {
+    "No": "29",
+    "Category": "Anti-Pattern",
+    "Issue": "Outline Replacement",
+    "Keywords": "outline-none ring focus",
+    "Platform": "Web",
+    "Description": "Never use outline-none without replacement",
+    "Do": "Provide visible focus replacement",
+    "Don't": "Remove outline with nothing",
+    "Code Example Good": "focus:outline-none focus:ring-2 focus:ring-blue-500",
+    "Code Example Bad": "focus:outline-none // alone",
+    "Severity": "Critical"
+  },
+  {
+    "No": "30",
+    "Category": "Anti-Pattern",
+    "Issue": "No Hardcoded Dates",
+    "Keywords": "date format intl locale",
+    "Platform": "Web",
+    "Description": "Use Intl for date/number formatting",
+    "Do": "Use Intl.DateTimeFormat",
+    "Don't": "Hardcoded date format",
+    "Code Example Good": "new Intl.DateTimeFormat('en').format(date)",
+    "Code Example Bad": "date.toLocaleDateString() // or manual format",
+    "Severity": "Medium"
+  }
+]

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

@@ -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 数据到本地缓存。从 npm 包 uipro-cli 下载最新数据，支持自动检查更新和强制同步。数据存储在 ~/.mcp-probe-kit/ui-ux-data/，默认在下次启动时生效以保证当前会话一致性。",
     inputSchema: {
         type: "object",
         properties: {

package/build/tools/start_product.js

@@ -2,6 +2,7 @@ import { parseArgs, getString, getBoolean } from "../utils/parseArgs.js";
 import { promises as fs } from "fs";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
+import { buildSkillBridgePlanStep, buildSkillHeaderNote, detectSkillBridge, renderSkillBridgeSection, } from "../lib/skill-bridge.js";
 import { WorkflowReportSchema } from "../schemas/structured-output.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 /**
@@ -76,6 +77,9 @@ export async function startProduct(args, context) {
                 isError: true,
             };
         }
+        const skillBridge = detectSkillBridge('start_product');
+        const skillBridgeStep = buildSkillBridgePlanStep(skillBridge);
+        const skillBridgeSection = renderSkillBridgeSection(skillBridge);
         const header = renderOrchestrationHeader({
             tool: 'start_product',
             goal: `完成产品设计工作流：${productName}`,
@@ -83,8 +87,9 @@ export async function startProduct(args, context) {
                 '按 delegated plan 顺序调用工具',
                 '生成 PRD、原型、设计系统与 HTML 原型',
             ],
+            notes: [buildSkillHeaderNote(skillBridge)],
         });
-        const guidanceText = header + `# 🚀 产品设计工作流执行指导
+        const guidanceText = header + skillBridgeSection + `# 🚀 产品设计工作流执行指导
 
 基于${requirementsSource}，请按照以下步骤完成从需求到 HTML 原型的完整产品设计流程。
 
@@ -308,6 +313,7 @@ ${!skipDesignSystem ? `├── design-system.json          # 设计系统配
         const plan = {
             mode: 'delegated',
             steps: [
+                skillBridgeStep,
                 {
                     id: 'context',
                     tool: 'init_project_context',
@@ -473,6 +479,7 @@ ${!skipDesignSystem ? `├── design-system.json          # 设计系统配
             ],
             metadata: {
                 plan,
+                skills: skillBridge,
             },
         };
         await reportToolProgress(context, 95, "start_product: 工作流输出已生成");

package/build/tools/start_ui.js

@@ -11,6 +11,7 @@ import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { getReasoningEngine } from "./ui-ux-tools.js";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
+import { buildSkillBridgePlanStep, buildSkillHeaderNote, detectSkillBridge, renderSkillBridgeSection, } from "../lib/skill-bridge.js";
 import { UIReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
 import { detectProjectType } from "../lib/project-detector.js";
 import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
@@ -519,6 +520,10 @@ export async function startUi(args, context) {
         if (profileDecision.warning) {
             headerNotes.push(profileDecision.warning);
         }
+        const skillBridge = detectSkillBridge('start_ui');
+        const skillBridgeStep = buildSkillBridgePlanStep(skillBridge);
+        const skillBridgeSection = renderSkillBridgeSection(skillBridge);
+        headerNotes.push(buildSkillHeaderNote(skillBridge));
         // 验证 mode 参数
         const validModes = ["auto", "manual"];
         if (mode && !validModes.includes(mode)) {
@@ -583,6 +588,7 @@ start_ui <描述> --requirements_mode=loop
             const plan = {
                 mode: 'delegated',
                 steps: [
+                    skillBridgeStep,
                     {
                         id: 'loop-1',
                         tool: 'ask_user',
@@ -666,7 +672,7 @@ start_ui <描述> --requirements_mode=loop
             const loopTemplate = profileDecision.resolved === 'strict'
                 ? LOOP_PROMPT_TEMPLATE_STRICT
                 : LOOP_PROMPT_TEMPLATE_GUIDED;
-            const guide = header + loopTemplate
+            const guide = header + skillBridgeSection + loopTemplate
                 .replace(/{description}/g, description)
                 .replace(/{question_budget}/g, String(questionBudget))
                 .replace(/{assumption_cap}/g, String(assumptionCap));
@@ -696,6 +702,7 @@ start_ui <描述> --requirements_mode=loop
                 metadata: {
                     plan,
                     template: templateMeta,
+                    skills: skillBridge,
                 },
             };
             await reportToolProgress(context, 95, "start_ui: loop 输出已生成");
@@ -808,6 +815,7 @@ ${recommendation.reasoning}
             const plan = {
                 mode: 'delegated',
                 steps: [
+                    skillBridgeStep,
                     {
                         id: 'context',
                         tool: 'init_project_context',
@@ -872,7 +880,7 @@ ${recommendation.reasoning}
                 ],
                 notes: headerNotes,
             });
-            const smartPlan = header + (profileDecision.resolved === 'strict' ? smartPlanStrict : smartPlanGuided);
+            const smartPlan = header + skillBridgeSection + (profileDecision.resolved === 'strict' ? smartPlanStrict : smartPlanGuided);
             // Create structured UI report for auto mode
             const uiReport = {
                 summary: `智能 UI 开发：${description}`,
@@ -941,6 +949,7 @@ ${recommendation.reasoning}
                 metadata: {
                     plan,
                     template: templateMeta,
+                    skills: skillBridge,
                 },
             };
             await reportToolProgress(context, 95, "start_ui: auto 输出已生成");
@@ -1002,7 +1011,7 @@ start_ui "设置页面" --framework=react
         const baseTemplate = profileDecision.resolved === 'strict'
             ? PROMPT_TEMPLATE_STRICT
             : PROMPT_TEMPLATE_GUIDED;
-        let guide = header + baseTemplate;
+        let guide = header + skillBridgeSection + baseTemplate;
         guide = safeReplace(guide, '{description}', escapeJson(description));
         guide = safeReplace(guide, '{productType}', productType);
         guide = safeReplace(guide, '{framework}', framework);
@@ -1010,6 +1019,7 @@ start_ui "设置页面" --framework=react
         const plan = {
             mode: 'delegated',
             steps: [
+                skillBridgeStep,
                 {
                     id: 'context',
                     tool: 'init_project_context',
@@ -1132,6 +1142,7 @@ start_ui "设置页面" --framework=react
             metadata: {
                 plan,
                 template: templateMeta,
+                skills: skillBridge,
             },
         };
         await reportToolProgress(context, 95, "start_ui: manual 输出已生成");

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

@@ -774,7 +774,7 @@ export async function syncUiData(args, context) {
                 console.log('Failed to check update, proceeding with sync...');
             }
         }
-        // 执行同步
+        // 执行同步（下载并写入缓存，当前会话不热切换）
         throwIfAborted(context?.signal, 'sync_ui_data 已取消');
         await reportToolProgress(context, 30, 'sync_ui_data: 下载并处理数据');
         await syncUIDataToCache(force, verbose, {
@@ -783,16 +783,14 @@ export async function syncUiData(args, context) {
                 await reportToolProgress(context, 30 + Math.round(progress * 0.6), `sync_ui_data: ${message}`);
             },
         });
-        // 重新加载数据
         throwIfAborted(context?.signal, 'sync_ui_data 已取消');
-        await reportToolProgress(context, 92, 'sync_ui_data: 重载本地缓存');
-        if (dataLoader) {
-            await dataLoader.reload();
-        }
-        const cacheDir = dataLoader?.getCacheManager().getCacheDir() || '';
+        await reportToolProgress(context, 92, 'sync_ui_data: 记录会话状态');
         // 获取同步的数据统计
         const loader = await getDataLoader();
+        const cacheDir = loader.getCacheManager().getCacheDir() || '';
+        const metadata = loader.getCacheManager().getMetadata();
         const searchEngine = loader.getSearchEngine();
+        const sessionInfo = loader.getSessionInfo();
         const syncedData = {
             summary: "UI/UX 数据同步成功",
             status: 'success',
@@ -802,20 +800,26 @@ export async function syncUiData(args, context) {
                 components: (searchEngine.getCategoryData('products') || []).length,
                 patterns: (searchEngine.getCategoryData('landing') || []).length,
             },
+            version: metadata?.version,
             timestamp: new Date().toISOString(),
         };
         await reportToolProgress(context, 100, 'sync_ui_data: 同步完成');
         return okStructured(`✅ UI/UX 数据同步成功
-
-数据已更新到缓存目录: ${cacheDir}
-
-**同步统计:**
-- 颜色: ${syncedData.synced.colors} 条
-- 图标: ${syncedData.synced.icons} 条
-- 组件: ${syncedData.synced.components} 条
-- 模式: ${syncedData.synced.patterns} 条
-
-**提示:** 数据已自动重新加载，可以立即使用最新数据。
+
+数据已更新到缓存目录: ${cacheDir}
+下载版本: ${metadata?.version || 'unknown'}
+
+**同步统计:**
+- 颜色: ${syncedData.synced.colors} 条
+- 图标: ${syncedData.synced.icons} 条
+- 组件: ${syncedData.synced.components} 条
+- 模式: ${syncedData.synced.patterns} 条
+
+**会话状态:**
+- 当前会话使用版本: ${sessionInfo.activeVersion || 'unknown'}（source: ${sessionInfo.source}）
+- 下次启动生效版本: ${sessionInfo.pendingVersion || metadata?.version || 'unknown'}
+
+**提示:** 为保证会话内结果一致，新数据将在下次启动后生效。
 `, syncedData, {
             schema: (await import('../schemas/output/ui-ux-tools.js')).SyncReportSchema,
         });

package/build/utils/ui-data-loader.d.ts

@@ -4,7 +4,7 @@
  * 三层数据策略：
  * 1. 内嵌数据（构建时同步）
  * 2. 缓存数据（运行时更新）
- * 3. 手动同步（用户触发）
+ * 3. 自动后台同步（当前会话不热切换，下次启动生效）
  */
 import { CacheManager } from './cache-manager.js';
 import { UISearchEngine } from './ui-search-engine.js';
@@ -12,6 +12,13 @@ export interface DataLoaderOptions {
     useCache?: boolean;
     autoUpdate?: boolean;
 }
+export interface UIDataSessionInfo {
+    source: 'cache' | 'embedded';
+    activeVersion?: string;
+    pendingVersion?: string;
+    lastCheckedAt?: string;
+    hasPendingUpdate: boolean;
+}
 /**
  * UI/UX 数据加载器
  */
@@ -19,7 +26,11 @@ export declare class UIDataLoader {
     private cacheManager;
     private searchEngine;
     private useCache;
+    private autoUpdate;
     private loaded;
+    private autoSyncRunning;
+    private autoSyncFailureUntil;
+    private sessionInfo;
     constructor(options?: DataLoaderOptions);
     /**
      * 加载数据
@@ -33,6 +44,7 @@ export declare class UIDataLoader {
      * 从内嵌数据加载
      */
     private loadFromEmbedded;
+    private readEmbeddedVersion;
     /**
      * 提取类别名称
      */
@@ -50,7 +62,11 @@ export declare class UIDataLoader {
      */
     getCacheManager(): CacheManager;
     /**
-     * 重新加载数据
+     * 获取当前会话的数据状态
+     */
+    getSessionInfo(): UIDataSessionInfo;
+    /**
+     * 重新加载数据（手动触发时使用）
      */
     reload(): Promise<void>;
 }