mcp-probe-kit 3.0.15 → 3.0.16

package/build/utils/ui-data-loader.js

@@ -4,15 +4,17 @@
  * 三层数据策略：
  * 1. 内嵌数据（构建时同步）
  * 2. 缓存数据（运行时更新）
- * 3. 手动同步（用户触发）
+ * 3. 自动后台同步（当前会话不热切换，下次启动生效）
  */
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { CacheManager } from './cache-manager.js';
 import { UISearchEngine } from './ui-search-engine.js';
+import { syncUIDataToCache } from './ui-sync.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const AUTO_SYNC_FAILURE_COOLDOWN_MS = 30 * 60 * 1000;
 /**
  * UI/UX 数据加载器
  */
@@ -20,11 +22,19 @@ export class UIDataLoader {
     cacheManager;
     searchEngine;
     useCache;
+    autoUpdate;
     loaded = false;
+    autoSyncRunning = false;
+    autoSyncFailureUntil = 0;
+    sessionInfo = {
+        source: 'embedded',
+        hasPendingUpdate: false,
+    };
     constructor(options = {}) {
         this.useCache = options.useCache ?? true;
+        this.autoUpdate = options.autoUpdate ?? true;
         this.cacheManager = new CacheManager({
-            autoUpdate: options.autoUpdate ?? true,
+            autoUpdate: this.autoUpdate,
         });
         this.searchEngine = new UISearchEngine();
     }
@@ -39,18 +49,30 @@ export class UIDataLoader {
         if (this.useCache && this.cacheManager.hasCache()) {
             try {
                 await this.loadFromCache();
+                const metadata = this.cacheManager.getMetadata();
+                this.sessionInfo = {
+                    source: 'cache',
+                    activeVersion: metadata?.version,
+                    hasPendingUpdate: false,
+                };
                 this.loaded = true;
-                // 后台检查更新
-                this.checkUpdateInBackground();
-                return;
             }
             catch (error) {
                 console.error('Failed to load from cache, falling back to embedded data:', error);
             }
         }
-        // 从内嵌数据加载
-        await this.loadFromEmbedded();
-        this.loaded = true;
+        if (!this.loaded) {
+            // 从内嵌数据加载
+            await this.loadFromEmbedded();
+            this.sessionInfo = {
+                source: 'embedded',
+                activeVersion: this.readEmbeddedVersion(),
+                hasPendingUpdate: false,
+            };
+            this.loaded = true;
+        }
+        // 后台自动检查并下载更新，当前会话保持版本锁定
+        void this.checkUpdateInBackground();
     }
     /**
      * 从缓存加载数据
@@ -110,6 +132,20 @@ export class UIDataLoader {
         walk(dataDir);
         this.searchEngine.loadDatasets(datasets);
     }
+    readEmbeddedVersion() {
+        try {
+            const metadataPath = path.join(__dirname, '..', 'resources', 'ui-ux-data', 'metadata.json');
+            if (!fs.existsSync(metadataPath)) {
+                return undefined;
+            }
+            const content = fs.readFileSync(metadataPath, 'utf-8');
+            const metadata = JSON.parse(content);
+            return metadata.version;
+        }
+        catch {
+            return undefined;
+        }
+    }
     /**
      * 提取类别名称
      */
@@ -127,15 +163,35 @@ export class UIDataLoader {
      * 后台检查更新
      */
     async checkUpdateInBackground() {
+        if (!this.autoUpdate) {
+            return;
+        }
+        if (this.autoSyncRunning) {
+            return;
+        }
+        if (Date.now() < this.autoSyncFailureUntil) {
+            return;
+        }
+        this.autoSyncRunning = true;
         try {
             const updateInfo = await this.cacheManager.checkUpdate();
+            this.sessionInfo.lastCheckedAt = new Date().toISOString();
             if (updateInfo.hasUpdate) {
-                console.log(`UI/UX data update available: ${updateInfo.currentVersion || 'none'} -> ${updateInfo.latestVersion}`);
-                console.log('Run "npm run sync-ui-data" to update.');
+                const current = updateInfo.currentVersion || this.sessionInfo.activeVersion || 'none';
+                console.log(`UI/UX data update available: ${current} -> ${updateInfo.latestVersion}`);
+                await syncUIDataToCache(false, false);
+                this.sessionInfo.pendingVersion = updateInfo.latestVersion;
+                this.sessionInfo.hasPendingUpdate = true;
+                console.log(`UI/UX data ${updateInfo.latestVersion} downloaded. It will apply on next restart.`);
             }
         }
         catch (error) {
-            // 静默失败，不影响主流程
+            this.autoSyncFailureUntil = Date.now() + AUTO_SYNC_FAILURE_COOLDOWN_MS;
+            const message = error instanceof Error ? error.message : String(error);
+            console.log(`UI/UX background sync skipped: ${message}`);
+        }
+        finally {
+            this.autoSyncRunning = false;
         }
     }
     /**
@@ -154,7 +210,13 @@ export class UIDataLoader {
         return this.cacheManager;
     }
     /**
-     * 重新加载数据
+     * 获取当前会话的数据状态
+     */
+    getSessionInfo() {
+        return { ...this.sessionInfo };
+    }
+    /**
+     * 重新加载数据（手动触发时使用）
      */
     async reload() {
         this.searchEngine.clear();

package/docs/i18n/en.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI Development Enhancement Toolkit · Documentation Center",
-    "version": "v3.0.10",
+    "version": "v3.0.16",
     "quickStart": "Quick Start",
     "visitMainSite": "Visit ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "Quick Start",
-      "description": "Get started with MCP Probe Kit v3.0.10 in 5 minutes",
+      "description": "Get started with MCP Probe Kit v3.0.16 in 5 minutes",
       "installConfig": "Installation & Configuration"
     },
     "tools": {

package/docs/i18n/ja.json

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

package/docs/i18n/ko.json

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

package/docs/i18n/zh-CN.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 开发增强工具集 · 文档中心",
-    "version": "v3.0.10",
+    "version": "v3.0.16",
     "quickStart": "快速开始",
     "visitMainSite": "访问主站 ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "快速开始",
-      "description": "5 分钟快速上手 MCP Probe Kit v3.0.10",
+      "description": "5 分钟快速上手 MCP Probe Kit v3.0.16",
       "installConfig": "安装配置"
     },
     "tools": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.15",
+  "version": "3.0.16",
   "description": "AI-Powered Development Toolkit - MCP Server with 22 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "mcpName": "io.github.mybolide/mcp-probe-kit",
   "type": "module",
@@ -10,6 +10,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
     "watch": "tsc --watch",
     "dev": "tsc && node build/index.js",
     "test": "vitest --run",