mcp-probe-kit 3.2.0 → 3.3.0

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

@@ -10,6 +10,7 @@ import { ASCIIBoxFormatter } from '../utils/ascii-box-formatter.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 { renderUiHardRules, renderUiBannedList, renderPreFlightChecklist } from '../lib/quality-constraints.js';
 import { okStructured } from '../lib/response.js';
 import { reportToolProgress, throwIfAborted, } from '../lib/tool-execution-context.js';
 // 全局数据加载器实例
@@ -185,6 +186,9 @@ export function generateCreationGuidance(productType, stack) {
         layout,
         config,
         tips,
+        hardRules: renderUiHardRules(),
+        banned: renderUiBannedList(),
+        preFlight: renderPreFlightChecklist(),
     };
 }
 /**
@@ -264,24 +268,24 @@ export async function uiDesignSystem(args) {
             ? 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}
-\`\`\`
+            ? `
+## 🎨 推荐 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\`
+            ? `
+## ✅ Vercel 界面规范（实现时对照）
+
+- 检索: \`ui_search --category=ui-guidelines-vercel --query="form accessibility animation"\`
+- 重点: 表单可访问性、\`prefers-reduced-motion\`、对比度、键盘焦点、禁止 \`transition: all\`
 `
             : '';
         // 构建输出对象
@@ -297,126 +301,134 @@ ${themeRecommendation.globalsCssSnippet}
             .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')}
+
+---
+
+${creationGuidance.hardRules}
+
+${creationGuidance.banned}
+
+${creationGuidance.preFlight}
 `;
-        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 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 = {
@@ -452,17 +464,17 @@ ${isShadcnStack(request.stack) ? `
             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,
         });
@@ -486,22 +498,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} 个组件`,
@@ -526,9 +538,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,
                 });
@@ -553,18 +565,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,
                     });
@@ -601,41 +613,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} 个模板`,
@@ -662,20 +674,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,
                 });
@@ -699,17 +711,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,
             });
@@ -718,21 +730,21 @@ 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)}
+                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)}
+                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)}
+                return `### ${index + 1}. ${data.level} (相关度: ${result.score.toFixed(2)})
+
+${formatGuidelineResult(data)}
 `;
             }
             const fields = Object.entries(data)
@@ -744,23 +756,23 @@ ${formatGuidelineResult(data)}
                 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} 条结果`,
@@ -825,14 +837,14 @@ export async function syncUiData(args, context) {
                         version: updateInfo.uipro.current || updateInfo.uipro.latest,
                         timestamp: new Date().toISOString(),
                     };
-                    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\` 参数。
+                    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,
                     });
@@ -878,26 +890,26 @@ export async function syncUiData(args, context) {
             timestamp: new Date().toISOString(),
         };
         await reportToolProgress(context, 100, 'sync_ui_data: 同步完成');
-        return okStructured(`✅ UI/UX 数据同步成功
-
-数据已更新到缓存目录: ${cacheDir}
-下载版本: ${metadata?.version || 'unknown'}
-
-**同步统计:**
-- 颜色: ${syncedData.synced.colors} 条
-- 图标: ${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}）
-- 下次启动生效版本: ${sessionInfo.pendingVersion || metadata?.version || 'unknown'}
-
-**提示:** 为保证会话内结果一致，新数据将在下次启动后生效。
+        return okStructured(`✅ UI/UX 数据同步成功
+
+数据已更新到缓存目录: ${cacheDir}
+下载版本: ${metadata?.version || 'unknown'}
+
+**同步统计:**
+- 颜色: ${syncedData.synced.colors} 条
+- 图标: ${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}）
+- 下次启动生效版本: ${sessionInfo.pendingVersion || metadata?.version || 'unknown'}
+
+**提示:** 为保证会话内结果一致，新数据将在下次启动后生效。
 `, syncedData, {
             schema: (await import('../schemas/output/ui-ux-tools.js')).SyncReportSchema,
         });
@@ -911,18 +923,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,
         });