mcp-probe-kit 3.0.14 → 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": {
@@ -93,6 +93,8 @@
         "item1": "The first cold start may take 20+ seconds while npx checks or downloads dependencies.",
         "item2": "Some GitNexus dependencies use tree-sitter native modules and may require Visual Studio Build Tools.",
         "item3": "If your MCP client supports env, prefer a preinstalled gitnexus CLI and raise GitNexus timeouts.",
+        "item4": "Quick install Build Tools on Windows: winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "Quick install command:",
         "exampleTitle": "Example using a preinstalled gitnexus CLI:"
       },
       "source": {

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": {
@@ -93,6 +93,8 @@
         "item1": "初回のコールドスタートでは、npx が依存関係を確認またはダウンロードするため 20 秒以上かかることがあります。",
         "item2": "GitNexus の一部依存関係は tree-sitter ネイティブモジュールを使用しており、Windows では Visual Studio Build Tools が必要になる場合があります。",
         "item3": "MCP クライアントが env をサポートしている場合は、プリインストール済みの gitnexus CLI を優先し、GitNexus のタイムアウトを引き上げてください。",
+        "item4": "Windows では winget で Build Tools をすばやくインストールできます：winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "クイックインストールコマンド：",
         "exampleTitle": "プリインストール済み gitnexus CLI を使う設定例："
       },
       "source": {

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": {
@@ -93,6 +93,8 @@
         "item1": "첫 콜드 스타트에서는 npx 가 의존성을 확인하거나 다운로드하므로 20초 이상 걸릴 수 있습니다.",
         "item2": "GitNexus 의 일부 의존성은 tree-sitter 네이티브 모듈을 사용하며 Windows 에서는 Visual Studio Build Tools 가 필요할 수 있습니다.",
         "item3": "MCP 클라이언트가 env 를 지원하면, 미리 설치한 gitnexus CLI 를 우선 사용하고 GitNexus 타임아웃을 늘리세요.",
+        "item4": "Windows 에서 Build Tools 빠른 설치: winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "빠른 설치 명령:",
         "exampleTitle": "미리 설치한 gitnexus CLI 를 사용하는 구성 예시:"
       },
       "source": {

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": {
@@ -93,6 +93,8 @@
         "item1": "首次冷启动时，npx 可能检查或下载依赖，耗时可能超过 20 秒。",
         "item2": "GitNexus 的部分依赖使用 tree-sitter 原生模块，在 Windows 上可能需要 Visual Studio Build Tools。",
         "item3": "如果 MCP 客户端支持 env，优先使用预装的 gitnexus CLI，并适当增大 GitNexus 超时。",
+        "item4": "Windows 下可用 winget 快速安装 Build Tools：winget install Microsoft.VisualStudio.2022.BuildTools",
+        "quickInstallTitle": "快速安装命令：",
         "exampleTitle": "使用预装 gitnexus CLI 的配置示例："
       },
       "source": {

package/docs/pages/getting-started.html

@@ -317,7 +317,10 @@ npm run build</code></pre>
                             <li data-i18n="gettingStarted.step1.windowsGraph.item1">The first cold start may take 20+ seconds while npx checks or downloads dependencies.</li>
                             <li data-i18n="gettingStarted.step1.windowsGraph.item2">Some GitNexus dependencies use tree-sitter native modules and may require Visual Studio Build Tools.</li>
                             <li data-i18n="gettingStarted.step1.windowsGraph.item3">If your MCP client supports env, prefer a preinstalled gitnexus CLI and raise GitNexus timeouts.</li>
+                            <li data-i18n="gettingStarted.step1.windowsGraph.item4">Quick install Build Tools on Windows: winget install Microsoft.VisualStudio.2022.BuildTools</li>
                         </ul>
+                        <p class="mb-2" data-i18n="gettingStarted.step1.windowsGraph.quickInstallTitle">Quick install command:</p>
+                        <pre class="code-block mb-3 p-3 text-sm text-slate-200 bg-slate-900 rounded overflow-x-auto"><code>winget install Microsoft.VisualStudio.2022.BuildTools</code></pre>
                         <p class="mb-2" data-i18n="gettingStarted.step1.windowsGraph.exampleTitle">Example using a preinstalled gitnexus CLI:</p>
                         <div class="bg-slate-900 rounded-lg overflow-hidden">
                             <div class="flex items-center justify-between px-3 py-2 bg-slate-800">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.14",
+  "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",