mcp-probe-kit 3.0.19 → 3.0.22

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

@@ -7,7 +7,8 @@
 import { UIDataLoader } from '../utils/ui-data-loader.js';
 import { DesignReasoningEngine } from '../utils/design-reasoning-engine.js';
 import { ASCIIBoxFormatter } from '../utils/ascii-box-formatter.js';
-import { syncUIDataToCache } from '../utils/ui-sync.js';
+import { syncUIDataToCache, checkUISourcesUpdate } from '../utils/ui-sync.js';
+import { formatShadcnResult, formatGuidelineResult, formatThemeResult, isGuidelineCategory, isShadcnCategory, isShadcnStack, isThemeCategory, pickThemeForProductType } from '../lib/shadcn-ui.js';
 import { formatDesignSystemJson } from '../utils/design-system-json-formatter.js';
 import { okStructured } from '../lib/response.js';
 import { reportToolProgress, throwIfAborted, } from '../lib/tool-execution-context.js';
@@ -127,6 +128,8 @@ export function generateCreationGuidance(productType, stack) {
         if (stackLower.includes('react') || stackLower.includes('next')) {
             config.push('React 组件样式方案（CSS Modules / Styled Components）');
             config.push('Theme Provider 配置');
+            config.push('shadcn/ui 初始化与主题变量（components.json、globals.css）');
+            config.push('优先使用 shadcn blocks/components，通过 `npx shadcn@latest add <name>` 安装');
         }
         if (stackLower.includes('vue') || stackLower.includes('nuxt')) {
             config.push('Vue 组件样式方案（Scoped CSS / CSS Modules）');
@@ -151,8 +154,14 @@ export function generateCreationGuidance(productType, stack) {
         '确保所有文档之间保持一致性',
         '使用清晰的标题层级和结构',
     ];
-    // 根据技术栈添加特定提示
-    if (stack) {
+    if (stack && isShadcnStack(stack)) {
+        tips.push(`在技术配置文档中提供 ${stack} + shadcn/ui 的具体实现示例`);
+        tips.push('用 `ui_search --category=ui-themes` 选主题，把 globalsCssSnippet 写入 globals.css');
+        tips.push('用 `ui_search --category=ui-guidelines-vercel` 对照 Vercel 界面规范（无障碍/动效/表单）');
+        tips.push('实现阶段先 `ui_search --category=shadcn-blocks` 匹配 block，再 `npx shadcn@latest add <name>` 安装');
+        tips.push('避免手写泛 Tailwind 模板；组件结构对齐 shadcn/ui new-york 风格');
+    }
+    else if (stack) {
         tips.push(`在技术配置文档中提供 ${stack} 的具体实现示例`);
         tips.push(`确保代码示例符合 ${stack} 的最佳实践`);
     }
@@ -250,6 +259,31 @@ export async function uiDesignSystem(args) {
         const fileIndex = generateFileIndex();
         // 生成创作指导
         const creationGuidance = generateCreationGuidance(request.productType, request.stack);
+        const loader = await getDataLoader();
+        const themeRecommendation = isShadcnStack(request.stack)
+            ? pickThemeForProductType(loader.getSearchEngine().getCategoryData('ui-themes') || [], request.productType)
+            : undefined;
+        const themeSection = themeRecommendation
+            ? `
+## 🎨 推荐 shadcn 主题（内嵌预设）
+
+- **主题**: ${themeRecommendation.title} (\`${themeRecommendation.name}\`)
+- **说明**: ${themeRecommendation.description}
+- **操作**: 将下方 CSS variables 写入 \`app/globals.css\`；也可用 \`ui_search --category=ui-themes --query="${request.productType}"\`
+
+\`\`\`css
+${themeRecommendation.globalsCssSnippet}
+\`\`\`
+`
+            : '';
+        const vercelSection = isShadcnStack(request.stack)
+            ? `
+## ✅ Vercel 界面规范（实现时对照）
+
+- 检索: \`ui_search --category=ui-guidelines-vercel --query="form accessibility animation"\`
+- 重点: 表单可访问性、\`prefers-reduced-motion\`、对比度、键盘焦点、禁止 \`transition: all\`
+`
+            : '';
         // 构建输出对象
         const output = {
             asciiBox,
@@ -263,117 +297,126 @@ export async function uiDesignSystem(args) {
             .map(file => `${file.order}. **${file.path}** ${file.required ? '(必需)' : '(可选)'}\n   ${file.purpose}`)
             .join('\n\n');
         // 格式化创作指导
-        const guidanceText = `
-### 设计原则文档主题
-${creationGuidance.principles.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
-
-### 交互规范文档主题
-${creationGuidance.interaction.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
-
-### 布局规范文档主题
-${creationGuidance.layout.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
-
-### 技术配置文档主题
-${creationGuidance.config.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
-
-### 创作提示
-${creationGuidance.tips.map((tip, i) => `${i + 1}. ${tip}`).join('\n')}
+        const guidanceText = `
+### 设计原则文档主题
+${creationGuidance.principles.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
+
+### 交互规范文档主题
+${creationGuidance.interaction.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
+
+### 布局规范文档主题
+${creationGuidance.layout.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
+
+### 技术配置文档主题
+${creationGuidance.config.map((topic, i) => `${i + 1}. ${topic}`).join('\n')}
+
+### 创作提示
+${creationGuidance.tips.map((tip, i) => `${i + 1}. ${tip}`).join('\n')}
 `;
-        const message = `# ✅ 设计系统推荐已生成
-
-**产品类型**: ${request.productType}
-**技术栈**: ${request.stack || 'html'}
-${request.targetAudience ? `**目标用户**: ${request.targetAudience}` : ''}
-
----
-
-## 🎨 1. 核心设计推荐（ASCII Box）
-
-以下是基于 AI 推理引擎生成的核心设计推荐：
-
-\`\`\`
-${asciiBox}
-\`\`\`
-
----
-
-## 📊 2. 精确配置数据（JSON）
-
-以下是机器可读的设计系统配置，包含所有精确数值：
-
-\`\`\`json
-${JSON.stringify(designSystemJson, null, 2)}
-\`\`\`
-
----
-
-## 📁 3. 文件索引（按创建顺序）
-
-请严格按照以下顺序创建文件：
-
-${fileIndexList}
-
-**注意**: design-system.md 是最后创建的主文档，它应该包含完整的设计系统概览和 ASCII Box 推荐。
-
----
-
-## 📝 4. 文档创作指导
-
-以下是各类文档应包含的关键主题。**请根据上述 ASCII Box 推荐和 JSON 数据自由创作内容，不要使用固定模板**：
-
-${guidanceText}
-
----
-
-## ✨ 请根据以上推荐和指导创建文档
-
-**现在，请按照文件索引的顺序，逐个创建设计系统文档。**
-
-### 创作要求：
-
-1. **使用核心数据**：
-   - 将 ASCII Box 中的核心推荐作为设计依据
-   - 使用 JSON 数据中的精确数值（颜色代码、字体大小、间距值等）
-   - 确保所有数值与 JSON 配置保持一致
-
-2. **遵循文件顺序**：
-   - 严格按照文件索引的顺序创建（1→2→3→4→5→6→7）
-   - design-system.json 最先创建（包含所有精确配置）
-   - design-system.md 最后创建（包含完整概览）
-
-3. **自由创作内容**：
-   - 参考创作指导中的主题列表
-   - 根据产品类型 "${request.productType}" 调整重点
-   ${request.stack ? `- 提供 ${request.stack} 的具体实现示例` : ''}
-   - 不要局限于固定模板，发挥创造力
-
-4. **保持一致性**：
-   - 所有文档使用相同的设计 Token（颜色、字体、间距）
-   - 确保术语和命名规范统一
-   - 交叉引用其他文档时保持准确
-
-5. **提供实用示例**：
-   - 包含具体的代码示例（不要抽象描述）
-   - 展示实际应用场景
-   - 参考反模式（antiPatterns）提供"应避免"的建议
-
-### 开始创作：
-
-**第一步**：创建 \`docs/design-system.json\`，包含所有精确配置数据（使用上面的 JSON）
-
-**第二步**：创建 \`docs/design-guidelines/README.md\`，提供设计指南的索引和导航
-
-**第三步至第六步**：依次创建四个设计指南文档（principles、interaction、layout、config）
-
-**最后一步**：创建 \`docs/design-system.md\`，包含以下内容：
-   - ASCII Box 推荐（核心设计）
-   - 完整的设计系统概览
-   - **文件索引**（列出所有设计文档的链接，方便后续查看和使用）
-   - 快速开始指南
-
----
-
-🚀 **准备好了吗？让我们开始创建第一个文件吧！**
+        const message = `# ✅ 设计系统推荐已生成
+
+**产品类型**: ${request.productType}
+**技术栈**: ${request.stack || 'html'}
+${request.targetAudience ? `**目标用户**: ${request.targetAudience}` : ''}
+
+---
+
+## 🎨 1. 核心设计推荐（ASCII Box）
+
+以下是基于 AI 推理引擎生成的核心设计推荐：
+
+\`\`\`
+${asciiBox}
+\`\`\`
+
+---
+
+## 📊 2. 精确配置数据（JSON）
+
+以下是机器可读的设计系统配置，包含所有精确数值：
+
+\`\`\`json
+${JSON.stringify(designSystemJson, null, 2)}
+\`\`\`
+
+---
+
+## 📁 3. 文件索引（按创建顺序）
+
+请严格按照以下顺序创建文件：
+
+${fileIndexList}
+
+**注意**: design-system.md 是最后创建的主文档，它应该包含完整的设计系统概览和 ASCII Box 推荐。
+
+---
+
+## 📝 4. 文档创作指导
+
+以下是各类文档应包含的关键主题。**请根据上述 ASCII Box 推荐和 JSON 数据自由创作内容，不要使用固定模板**：
+
+${guidanceText}
+${themeSection}
+${vercelSection}
+
+---
+
+## ✨ 请根据以上推荐和指导创建文档
+
+**现在，请按照文件索引的顺序，逐个创建设计系统文档。**
+
+### 创作要求：
+
+1. **使用核心数据**：
+   - 将 ASCII Box 中的核心推荐作为设计依据
+   - 使用 JSON 数据中的精确数值（颜色代码、字体大小、间距值等）
+   - 确保所有数值与 JSON 配置保持一致
+
+2. **遵循文件顺序**：
+   - 严格按照文件索引的顺序创建（1→2→3→4→5→6→7）
+   - design-system.json 最先创建（包含所有精确配置）
+   - design-system.md 最后创建（包含完整概览）
+
+3. **自由创作内容**：
+   - 参考创作指导中的主题列表
+   - 根据产品类型 "${request.productType}" 调整重点
+   ${request.stack ? `- 提供 ${request.stack} 的具体实现示例` : ''}
+   - 不要局限于固定模板，发挥创造力
+
+4. **保持一致性**：
+   - 所有文档使用相同的设计 Token（颜色、字体、间距）
+   - 确保术语和命名规范统一
+   - 交叉引用其他文档时保持准确
+
+5. **提供实用示例**：
+   - 包含具体的代码示例（不要抽象描述）
+   - 展示实际应用场景
+   - 参考反模式（antiPatterns）提供"应避免"的建议
+${isShadcnStack(request.stack) ? `
+6. **shadcn/ui 实现路径**（${request.stack}）：
+   - 用 \`ui_search --category=ui-themes\` 确认主题；上文的 globals.css 片段可直接使用
+   - 用 \`ui_search --category=shadcn-blocks --query="..."\` 找 block，再 \`npx shadcn@latest add <name>\`
+   - 用 \`ui_search --category=ui-guidelines-vercel\` 对照 Vercel 规范
+   - 在 block 基础上改文案/数据，不要从零写 Card/Button
+` : ''}
+
+### 开始创作：
+
+**第一步**：创建 \`docs/design-system.json\`，包含所有精确配置数据（使用上面的 JSON）
+
+**第二步**：创建 \`docs/design-guidelines/README.md\`，提供设计指南的索引和导航
+
+**第三步至第六步**：依次创建四个设计指南文档（principles、interaction、layout、config）
+
+**最后一步**：创建 \`docs/design-system.md\`，包含以下内容：
+   - ASCII Box 推荐（核心设计）
+   - 完整的设计系统概览
+   - **文件索引**（列出所有设计文档的链接，方便后续查看和使用）
+   - 快速开始指南
+
+---
+
+🚀 **准备好了吗？让我们开始创建第一个文件吧！**
 `;
         // 构建结构化数据对象
         const structuredData = {
@@ -409,17 +452,17 @@ ${guidanceText}
             colors: {},
             typography: {},
         };
-        return okStructured(`❌ 设计系统生成失败: ${errorMessage}
-
-**可能的原因**:
-1. 数据未加载完成
-2. 产品类型不明确
-3. 数据格式错误
-
-**建议**:
-1. 提供更具体的产品类型（如 "SaaS", "E-commerce", "Healthcare"）
-2. 添加产品描述帮助推理引擎理解需求
-3. 检查数据是否已同步（使用 \`sync_ui_data\` 工具）
+        return okStructured(`❌ 设计系统生成失败: ${errorMessage}
+
+**可能的原因**:
+1. 数据未加载完成
+2. 产品类型不明确
+3. 数据格式错误
+
+**建议**:
+1. 提供更具体的产品类型（如 "SaaS", "E-commerce", "Healthcare"）
+2. 添加产品描述帮助推理引擎理解需求
+3. 检查数据是否已同步（使用 \`sync_ui_data\` 工具）
 `, errorData, {
             schema: (await import('../schemas/output/ui-ux-tools.js')).DesignSystemSchema,
         });
@@ -443,22 +486,22 @@ export async function uiSearch(args) {
                 // 格式化组件列表
                 const components = catalog.components || [];
                 const componentList = components.map((comp, index) => {
-                    return `### ${index + 1}. ${comp.name}
-
-**描述**: ${comp.description || '无'}
-**Props**: ${Object.keys(comp.props || {}).join(', ')}
-**样式**: ${comp.styles ? Object.keys(comp.styles).join(', ') : '无'}
+                    return `### ${index + 1}. ${comp.name}
+
+**描述**: ${comp.description || '无'}
+**Props**: ${Object.keys(comp.props || {}).join(', ')}
+**样式**: ${comp.styles ? Object.keys(comp.styles).join(', ') : '无'}
 `;
                 }).join('\n---\n\n');
-                const message = `# 📦 组件目录
-
-共 ${components.length} 个可用组件
-
----
-
-${componentList}
-
-**提示**: 这些组件可以在 UI 模板中使用
+                const message = `# 📦 组件目录
+
+共 ${components.length} 个可用组件
+
+---
+
+${componentList}
+
+**提示**: 这些组件可以在 UI 模板中使用
 `;
                 const structuredData = {
                     summary: `组件目录 - ${components.length} 个组件`,
@@ -483,9 +526,9 @@ ${componentList}
                     results: [],
                     totalResults: 0,
                 };
-                return okStructured(`❌ 未找到组件目录文件
-
-请先运行 \`init_component_catalog\` 生成组件目录。
+                return okStructured(`❌ 未找到组件目录文件
+
+请先运行 \`init_component_catalog\` 生成组件目录。
 `, errorData, {
                     schema: (await import('../schemas/output/ui-ux-tools.js')).UISearchResultSchema,
                 });
@@ -510,18 +553,18 @@ ${componentList}
                         results: [],
                         totalResults: 0,
                     };
-                    return okStructured(`📭 暂无可用模板
-
-**建议**:
-1. 使用 \`start_ui\` 生成新模板
-2. 模板会自动保存到 \`docs/ui/pages/\` 目录
-3. 下次可以直接搜索使用
-
-**示例**:
-\`\`\`
-start_ui "登录页面"
-start_ui "用户列表"
-\`\`\`
+                    return okStructured(`📭 暂无可用模板
+
+**建议**:
+1. 使用 \`start_ui\` 生成新模板
+2. 模板会自动保存到 \`docs/ui/pages/\` 目录
+3. 下次可以直接搜索使用
+
+**示例**:
+\`\`\`
+start_ui "登录页面"
+start_ui "用户列表"
+\`\`\`
 `, emptyData, {
                         schema: (await import('../schemas/output/ui-ux-tools.js')).UISearchResultSchema,
                     });
@@ -558,41 +601,41 @@ start_ui "用户列表"
                         })),
                         totalResults: 0,
                     };
-                    return okStructured(`未找到匹配的模板
-
-**查询**: ${query}
-**可用模板**: ${templates.map(t => t.name).join(', ')}
-
-**建议**: 使用 \`start_ui "${query}"\` 生成新模板
+                    return okStructured(`未找到匹配的模板
+
+**查询**: ${query}
+**可用模板**: ${templates.map(t => t.name).join(', ')}
+
+**建议**: 使用 \`start_ui "${query}"\` 生成新模板
 `, noMatchData, {
                         schema: (await import('../schemas/output/ui-ux-tools.js')).UISearchResultSchema,
                     });
                 }
                 // 格式化模板列表
                 const templateList = filteredTemplates.map((t, index) => {
-                    return `### ${index + 1}. ${t.name}
-
-**文件**: \`docs/ui/pages/${t.file}\`
-**描述**: ${t.description}
-**组件数**: ${JSON.stringify(t.template).match(/"type":/g)?.length || 0}
-
-\`\`\`json
-${JSON.stringify(t.template, null, 2)}
-\`\`\`
+                    return `### ${index + 1}. ${t.name}
+
+**文件**: \`docs/ui/pages/${t.file}\`
+**描述**: ${t.description}
+**组件数**: ${JSON.stringify(t.template).match(/"type":/g)?.length || 0}
+
+\`\`\`json
+${JSON.stringify(t.template, null, 2)}
+\`\`\`
 `;
                 }).join('\n---\n\n');
-                const message = `# 📄 UI 模板搜索结果
-
-找到 ${filteredTemplates.length} 个匹配模板
-
----
-
-${templateList}
-
-**使用方法**:
-\`\`\`
-render_ui docs/ui/pages/<文件名>.json --framework=react
-\`\`\`
+                const message = `# 📄 UI 模板搜索结果
+
+找到 ${filteredTemplates.length} 个匹配模板
+
+---
+
+${templateList}
+
+**使用方法**:
+\`\`\`
+render_ui docs/ui/pages/<文件名>.json --framework=react
+\`\`\`
 `;
                 const structuredData = {
                     summary: `找到 ${filteredTemplates.length} 个模板`,
@@ -619,20 +662,20 @@ render_ui docs/ui/pages/<文件名>.json --framework=react
                     results: [],
                     totalResults: 0,
                 };
-                return okStructured(`📭 暂无可用模板
-
-模板目录不存在或为空。
-
-**建议**:
-使用 \`start_ui\` 生成第一个模板：
-
-\`\`\`
-start_ui "登录页面"
-start_ui "用户列表"
-start_ui "设置页面"
-\`\`\`
-
-模板会自动保存到 \`docs/ui/pages/\` 目录。
+                return okStructured(`📭 暂无可用模板
+
+模板目录不存在或为空。
+
+**建议**:
+使用 \`start_ui\` 生成第一个模板：
+
+\`\`\`
+start_ui "登录页面"
+start_ui "用户列表"
+start_ui "设置页面"
+\`\`\`
+
+模板会自动保存到 \`docs/ui/pages/\` 目录。
 `, errorData, {
                     schema: (await import('../schemas/output/ui-ux-tools.js')).UISearchResultSchema,
                 });
@@ -656,17 +699,17 @@ start_ui "设置页面"
                 results: [],
                 totalResults: 0,
             };
-            return okStructured(`未找到匹配的 UI/UX 数据。
-
-**搜索条件:**
-- 查询: ${query}
-- 类别: ${options.category || '全部'}
-- 技术栈: ${options.stack || '全部'}
-
-**建议:**
-1. 尝试使用更通用的关键词
-2. 检查拼写是否正确
-3. 移除类别或技术栈限制
+            return okStructured(`未找到匹配的 UI/UX 数据。
+
+**搜索条件:**
+- 查询: ${query}
+- 类别: ${options.category || '全部'}
+- 技术栈: ${options.stack || '全部'}
+
+**建议:**
+1. 尝试使用更通用的关键词
+2. 检查拼写是否正确
+3. 移除类别或技术栈限制
 `, noResultData, {
                 schema: (await import('../schemas/output/ui-ux-tools.js')).UISearchResultSchema,
             });
@@ -674,6 +717,24 @@ start_ui "设置页面"
         // 格式化结果
         const formattedResults = results.map((result, index) => {
             const data = result.data;
+            if (isShadcnCategory(result.category)) {
+                return `### ${index + 1}. ${data.name || data.title} (相关度: ${result.score.toFixed(2)})
+
+${formatShadcnResult(data)}
+`;
+            }
+            if (isThemeCategory(result.category)) {
+                return `### ${index + 1}. ${data.title || data.name} (相关度: ${result.score.toFixed(2)})
+
+${formatThemeResult(data)}
+`;
+            }
+            if (isGuidelineCategory(result.category)) {
+                return `### ${index + 1}. ${data.level} (相关度: ${result.score.toFixed(2)})
+
+${formatGuidelineResult(data)}
+`;
+            }
             const fields = Object.entries(data)
                 .filter(([_key, value]) => value != null && value !== '')
                 .map(([key, value]) => {
@@ -683,35 +744,41 @@ start_ui "设置页面"
                 return `- **${key}**: ${value}`;
             })
                 .join('\n');
-            return `### ${index + 1}. ${result.category} (相关度: ${result.score.toFixed(2)})
-
-${fields}
+            return `### ${index + 1}. ${result.category} (相关度: ${result.score.toFixed(2)})
+
+${fields}
 `;
         }).join('\n---\n\n');
-        const message = `# UI/UX 搜索结果
-
-找到 ${results.length} 条匹配结果
-
-**搜索条件:**
-- 查询: ${query}
-- 类别: ${options.category || '全部'}
-- 技术栈: ${options.stack || '全部'}
-
----
-
-${formattedResults}
+        const message = `# UI/UX 搜索结果
+
+找到 ${results.length} 条匹配结果
+
+**搜索条件:**
+- 查询: ${query}
+- 类别: ${options.category || '全部'}
+- 技术栈: ${options.stack || '全部'}
+
+---
+
+${formattedResults}
 `;
         const structuredData = {
             summary: `找到 ${results.length} 条结果`,
             query: query,
             category: options.category,
             results: results.map(result => ({
-                id: result.data.id || result.data.name || '',
+                id: result.data.name || result.data.id || result.data.title || '',
                 title: result.data.title || result.data.name || '',
                 description: result.data.description || '',
                 category: result.category,
                 score: result.score,
-                preview: JSON.stringify(result.data, null, 2),
+                preview: isShadcnCategory(result.category)
+                    ? `${result.data.installCommand || ''}\n${JSON.stringify(result.data, null, 2)}`
+                    : isThemeCategory(result.category)
+                        ? String(result.data.globalsCssSnippet || JSON.stringify(result.data, null, 2))
+                        : isGuidelineCategory(result.category)
+                            ? `${result.data.level}: ${result.data.rule}`
+                            : JSON.stringify(result.data, null, 2),
             })),
             totalResults: results.length,
         };
@@ -746,29 +813,31 @@ export async function syncUiData(args, context) {
             throwIfAborted(context?.signal, 'sync_ui_data 已取消');
             await reportToolProgress(context, 15, 'sync_ui_data: 检查上游版本');
             const loader = await getDataLoader();
-            const cacheManager = loader.getCacheManager();
+            const cacheDir = loader.getCacheManager().getCacheDir();
             try {
-                const updateInfo = await cacheManager.checkUpdate();
+                const updateInfo = await checkUISourcesUpdate(cacheDir, context?.signal);
                 if (!updateInfo.hasUpdate) {
                     await reportToolProgress(context, 100, 'sync_ui_data: 数据已是最新');
                     const upToDateData = {
                         summary: "UI/UX 数据已是最新版本",
                         status: 'success',
                         synced: {},
-                        version: updateInfo.currentVersion || 'unknown',
+                        version: updateInfo.uipro.current || updateInfo.uipro.latest,
                         timestamp: new Date().toISOString(),
                     };
-                    return okStructured(`✅ UI/UX 数据已是最新版本
-
-**当前版本:** ${updateInfo.currentVersion}
-**最新版本:** ${updateInfo.latestVersion}
-
-无需更新。如需强制同步，请使用 \`force: true\` 参数。
+                    return okStructured(`✅ UI/UX 数据已是最新版本
+
+**uipro-cli:** ${updateInfo.uipro.current || 'unknown'} (latest ${updateInfo.uipro.latest})
+**shadcn registry:** ${updateInfo.shadcn.current || 'unknown'} (latest ${updateInfo.shadcn.latest})
+**ui-themes:** ${updateInfo.themes.current || 'unknown'} (latest ${updateInfo.themes.latest})
+**vercel guidelines:** ${updateInfo.vercel.current || 'unknown'} (latest ${updateInfo.vercel.latest})
+
+无需更新。如需强制同步，请使用 \`force: true\` 参数。
 `, upToDateData, {
                         schema: (await import('../schemas/output/ui-ux-tools.js')).SyncReportSchema,
                     });
                 }
-                console.log(`Update available: ${updateInfo.currentVersion || 'none'} -> ${updateInfo.latestVersion}`);
+                console.log(`Update available: uipro ${updateInfo.uipro.current || 'none'} -> ${updateInfo.uipro.latest}; shadcn ${updateInfo.shadcn.current || 'none'} -> ${updateInfo.shadcn.latest}`);
             }
             catch (error) {
                 console.log('Failed to check update, proceeding with sync...');
@@ -779,6 +848,7 @@ export async function syncUiData(args, context) {
         await reportToolProgress(context, 30, 'sync_ui_data: 下载并处理数据');
         await syncUIDataToCache(force, verbose, {
             signal: context?.signal,
+            force,
             onProgress: async (progress, message) => {
                 await reportToolProgress(context, 30 + Math.round(progress * 0.6), `sync_ui_data: ${message}`);
             },
@@ -799,6 +869,10 @@ export async function syncUiData(args, context) {
                 icons: (searchEngine.getCategoryData('icons') || []).length,
                 components: (searchEngine.getCategoryData('products') || []).length,
                 patterns: (searchEngine.getCategoryData('landing') || []).length,
+                shadcnBlocks: (searchEngine.getCategoryData('shadcn-blocks') || []).length,
+                shadcnComponents: (searchEngine.getCategoryData('shadcn-components') || []).length,
+                themes: (searchEngine.getCategoryData('ui-themes') || []).length,
+                vercelGuidelines: (searchEngine.getCategoryData('ui-guidelines-vercel') || []).length,
             },
             version: metadata?.version,
             timestamp: new Date().toISOString(),
@@ -814,6 +888,10 @@ export async function syncUiData(args, context) {
 - 图标: ${syncedData.synced.icons} 条
 - 组件: ${syncedData.synced.components} 条
 - 模式: ${syncedData.synced.patterns} 条
+- shadcn blocks: ${syncedData.synced.shadcnBlocks || 0} 条
+- shadcn components: ${syncedData.synced.shadcnComponents || 0} 条
+- UI 主题: ${syncedData.synced.themes || 0} 套
+- Vercel 规范: ${syncedData.synced.vercelGuidelines || 0} 条
 
 **会话状态:**
 - 当前会话使用版本: ${sessionInfo.activeVersion || 'unknown'}（source: ${sessionInfo.source}）
@@ -833,18 +911,18 @@ export async function syncUiData(args, context) {
             timestamp: new Date().toISOString(),
             errors: [errorMessage],
         };
-        return okStructured(`❌ UI 数据同步失败: ${errorMessage}
-
-**可能的原因:**
-1. 网络连接问题
-2. npm registry 不可访问
-3. 磁盘空间不足
-4. 权限问题
-
-**建议:**
-1. 检查网络连接
-2. 稍后重试
-3. 使用 \`verbose: true\` 查看详细日志
+        return okStructured(`❌ UI 数据同步失败: ${errorMessage}
+
+**可能的原因:**
+1. 网络连接问题
+2. npm registry 不可访问
+3. 磁盘空间不足
+4. 权限问题
+
+**建议:**
+1. 检查网络连接
+2. 稍后重试
+3. 使用 \`verbose: true\` 查看详细日志
 `, errorData, {
             schema: (await import('../schemas/output/ui-ux-tools.js')).SyncReportSchema,
         });