```

feat(uiux): 添加UI/UX Pro Max功能增强

- 添加UI/UX意图、上下文策略和原因字段到McpRequest类型定义
- 实现条件性上下文构建逻辑，支持UI/UX上下文策略控制
- 添加UI/UX Pro Max配置项，包括默认语言、输出格式、结果上限等
- 实现UI/UX上下文信号透传机制
- 新增BeautifyResult、PersistSummary等UI/UX相关数据结构
- 实现结果数量上限控制和UI提示词美化功能
- 添加路径净化工具防止路径穿越安全问题
- 实现统一响应结构和文案本地化支持
- 支持多语言输出（中文/英文）和多种输出格式
```

Author: yuaotian

src/frontend/types/popup.d.ts

@@ -6,6 +6,9 @@ export interface McpRequest {
   predefined_options?: string[]
   is_markdown?: boolean
   project_root_path?: string
+  uiux_intent?: 'none' | 'beautify' | 'page_refactor' | 'uiux_search'
+  uiux_context_policy?: 'auto' | 'force' | 'forbid'
+  uiux_reason?: string
 }
 
 // 自定义prompt类型定义

src/frontend/utils/conditionalContext.ts

@@ -1,9 +1,16 @@
-import type { CustomPrompt } from '../types/popup'
+import type { CustomPrompt, McpRequest } from '../types/popup'
 
 // 复用条件性 prompt 的上下文拼接逻辑，保持与弹窗输入一致
-export function buildConditionalContext(prompts: CustomPrompt[]): string {
+export function buildConditionalContext(prompts: CustomPrompt[], request?: McpRequest | null): string {
   const conditionalTexts: string[] = []
 
+  // 根据 UI/UX 上下文策略决定是否追加条件性上下文
+  const intent = request?.uiux_intent ?? 'none'
+  const policy = request?.uiux_context_policy ?? 'auto'
+  if (policy === 'forbid' || (policy === 'auto' && intent === 'none')) {
+    return ''
+  }
+
   prompts.forEach((prompt) => {
     const isEnabled = prompt.current_state ?? false
     const template = isEnabled ? prompt.template_true : prompt.template_false

src/rust/config/settings.rs

@@ -128,6 +128,16 @@ pub struct McpConfig {
     pub context7_api_key: Option<String>, // Context7 API密钥 (可选，免费使用时可为空)
     pub skill_python_path: Option<String>, // Skill Python 路径（可选，默认走 PATH）
 
+    // UI/UX Pro Max 配置
+    /// 默认语言（"zh" | "en"）
+    pub uiux_default_lang: Option<String>,
+    /// 默认输出格式（"json" | "text"）
+    pub uiux_output_format: Option<String>,
+    /// 最大结果数上限（默认 10）
+    pub uiux_max_results_cap: Option<u32>,
+    /// 是否启用 UI 提示词美化（默认 true）
+    pub uiux_beautify_enabled: Option<bool>,
+
     // 图标工坊配置
     /// 默认保存路径（相对于项目根目录，如 "assets/icons"）
     pub icon_default_save_path: Option<String>,
@@ -318,6 +328,11 @@ pub fn default_mcp_config() -> McpConfig {
         acemcp_proxy_password: None,
         context7_api_key: None,
         skill_python_path: None,
+        // UI/UX Pro Max 默认配置
+        uiux_default_lang: Some("zh".to_string()),
+        uiux_output_format: Some("json".to_string()),
+        uiux_max_results_cap: Some(10),
+        uiux_beautify_enabled: Some(true),
         // 图标工坊配置默认值
         icon_default_save_path: None,      // 使用默认 "assets/icons"
         icon_default_format: None,          // 默认 SVG

src/rust/mcp/tools/interaction/mcp.rs

@@ -25,6 +25,10 @@ impl InteractionTool {
             },
             is_markdown: request.is_markdown,
             project_root_path: request.project_root_path,
+            // 透传 UI/UX 上下文控制信号
+            uiux_intent: request.uiux_intent,
+            uiux_context_policy: request.uiux_context_policy,
+            uiux_reason: request.uiux_reason,
         };
 
         match create_tauri_popup(&popup_request) {

src/rust/mcp/tools/uiux/engine.rs

@@ -13,6 +13,7 @@ use serde::Serialize;
 use serde_json::Value;
 
 use crate::log_debug;
+use super::sanitize::{sanitize_path_segment, sanitize_slug};
 
 const MAX_RESULTS: usize = 3;
 const BOX_WIDTH: usize = 90;
@@ -534,6 +535,26 @@ pub struct SuggestResult {
     pub matched_keywords: Vec<String>,
 }
 
+#[derive(Debug, Clone, Serialize)]
+pub struct BeautifyResult {
+    pub style: Vec<HashMap<String, String>>,
+    pub color: Vec<HashMap<String, String>>,
+    pub typography: Vec<HashMap<String, String>>,
+}
+
+#[derive(Debug, Clone, Serialize)]
+pub struct PersistSummary {
+    pub design_system_dir: String,
+    pub created_files: Vec<String>,
+}
+
+#[derive(Debug, Clone)]
+pub struct DesignSystemOutput {
+    pub design_system: DesignSystem,
+    pub persisted: Option<PersistSummary>,
+    pub formatted: String,
+}
+
 struct UiuxStore {
     domains: HashMap<&'static str, DomainIndex>,
     stacks: HashMap<&'static str, DomainIndex>,
@@ -647,6 +668,13 @@ fn normalize_format(value: Option<&str>, default: &str) -> String {
         .to_lowercase()
 }
 
+/// 结果数量上限控制，避免过大输出
+pub fn cap_max_results(value: Option<u32>, cap: u32, default: u32) -> usize {
+    let cap = cap.max(1);
+    let raw = value.unwrap_or(default).max(1);
+    raw.min(cap) as usize
+}
+
 pub fn search_domain(query: &str, domain: Option<&str>, max_results: Option<usize>) -> SearchResult {
     let store = &*UIUX_STORE;
     let requested_domain = domain.unwrap_or_else(|| detect_domain(query));
@@ -769,6 +797,38 @@ pub fn format_search_json(result: &SearchResult) -> Result<String, String> {
     serde_json::to_string_pretty(result).map_err(|e| format!("JSON 序列化失败: {}", e))
 }
 
+/// UI 提示词美化：基于现有数据组合，避免重复
+pub fn beautify_prompt(query: &str, max_results: usize) -> BeautifyResult {
+    let limit = max_results.max(1);
+    let style = search_domain(query, Some("style"), Some(limit));
+    let color = search_domain(query, Some("color"), Some(limit));
+    let typography = search_domain(query, Some("typography"), Some(limit));
+
+    BeautifyResult {
+        style: dedupe_results(style.results),
+        color: dedupe_results(color.results),
+        typography: dedupe_results(typography.results),
+    }
+}
+
+fn dedupe_results(rows: Vec<HashMap<String, String>>) -> Vec<HashMap<String, String>> {
+    let mut seen = HashSet::new();
+    let mut output = Vec::new();
+    for row in rows {
+        let mut items: Vec<_> = row.iter().collect();
+        items.sort_by(|a, b| a.0.cmp(b.0));
+        let signature = items
+            .iter()
+            .map(|(k, v)| format!("{}={}", k, v))
+            .collect::<Vec<_>>()
+            .join("|");
+        if seen.insert(signature) {
+            output.push(row);
+        }
+    }
+    output
+}
+
 #[derive(Debug, Clone, Serialize)]
 pub struct PatternInfo {
     pub name: String,
@@ -1993,25 +2053,18 @@ fn format_page_override_md(design_system: &DesignSystem, page_name: &str, page_q
     lines.join("\n")
 }
 
-struct PersistResult {
-    design_system_dir: PathBuf,
-    created_files: Vec<PathBuf>,
-}
-
 fn persist_design_system(
     design_system: &DesignSystem,
     page: Option<&str>,
     output_dir: Option<&Path>,
     page_query: Option<&str>,
-) -> Result<PersistResult, String> {
+) -> Result<PersistSummary, String> {
     let base_dir = output_dir
         .map(|p| p.to_path_buf())
         .unwrap_or_else(|| std::env::current_dir().unwrap_or_else(|_| PathBuf::from(".")));
 
-    let project_slug = design_system
-        .project_name
-        .to_lowercase()
-        .replace(' ', "-");
+    // 关键路径使用净化结果防止路径穿越
+    let project_slug = sanitize_slug(&design_system.project_name);
 
     let design_system_dir = base_dir.join("design-system").join(&project_slug);
     let pages_dir = design_system_dir.join("pages");
@@ -2026,16 +2079,19 @@ fn persist_design_system(
     let mut created = vec![master_file];
 
     if let Some(page_name) = page {
-        let page_slug = page_name.to_lowercase().replace(' ', "-");
+        let page_slug = sanitize_path_segment(page_name);
         let page_file = pages_dir.join(format!("{}.md", page_slug));
         std::fs::write(&page_file, format_page_override_md(design_system, page_name, page_query))
             .map_err(|e| format!("写入页面覆盖文件失败: {}", e))?;
         created.push(page_file);
     }
 
-    Ok(PersistResult {
-        design_system_dir,
-        created_files: created,
+    Ok(PersistSummary {
+        design_system_dir: design_system_dir.to_string_lossy().to_string(),
+        created_files: created
+            .into_iter()
+            .map(|path| path.to_string_lossy().to_string())
+            .collect(),
     })
 }
 
@@ -2046,56 +2102,54 @@ pub fn generate_design_system(
     persist: bool,
     page: Option<&str>,
     output_dir: Option<&Path>,
-) -> Result<String, String> {
+) -> Result<DesignSystemOutput, String> {
     let generator = DesignSystemGenerator::new();
     let design_system = generator.generate(query, project_name);
 
-    if persist {
-        let persist_result = persist_design_system(&design_system, page, output_dir, Some(query))?;
-        let mut output = match normalize_format(format, "ascii").as_str() {
-            "markdown" => format_markdown(&design_system),
-            _ => format_ascii_box(&design_system),
-        };
+    let persisted = if persist {
+        Some(persist_design_system(&design_system, page, output_dir, Some(query))?)
+    } else {
+        None
+    };
 
-        let project_slug = design_system
-            .project_name
-            .to_lowercase()
-            .replace(' ', "-");
-        output.push_str("\n");
-        output.push_str(&"=".repeat(60));
-        output.push_str("\n");
-        output.push_str(&format!(
+    let mut formatted = match normalize_format(format, "ascii").as_str() {
+        "markdown" => format_markdown(&design_system),
+        _ => format_ascii_box(&design_system),
+    };
+
+    if persist {
+        let project_slug = sanitize_slug(&design_system.project_name);
+        formatted.push_str("\n");
+        formatted.push_str(&"=".repeat(60));
+        formatted.push_str("\n");
+        formatted.push_str(&format!(
             "✅ Design system persisted to design-system/{}/\n",
             project_slug
         ));
-        output.push_str(&format!(
+        formatted.push_str(&format!(
             "   📄 design-system/{}/MASTER.md (Global Source of Truth)\n",
             project_slug
         ));
         if let Some(page_name) = page {
-            let page_slug = page_name.to_lowercase().replace(' ', "-");
-            output.push_str(&format!(
+            let page_slug = sanitize_path_segment(page_name);
+            formatted.push_str(&format!(
                 "   📄 design-system/{}/pages/{}.md (Page Overrides)\n",
                 project_slug, page_slug
             ));
         }
-        output.push_str("\n");
-        output.push_str(&format!(
+        formatted.push_str("\n");
+        formatted.push_str(&format!(
             "📖 Usage: When building a page, check design-system/{}/pages/[page].md first.\n",
             project_slug
         ));
-        output.push_str("   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.\n");
-        output.push_str(&"=".repeat(60));
-
-        // 避免未使用告警
-        let _ = persist_result;
-
-        return Ok(output);
+        formatted.push_str("   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.\n");
+        formatted.push_str(&"=".repeat(60));
     }
 
-    Ok(match normalize_format(format, "ascii").as_str() {
-        "markdown" => format_markdown(&design_system),
-        _ => format_ascii_box(&design_system),
+    Ok(DesignSystemOutput {
+        design_system,
+        persisted,
+        formatted,
     })
 }
 

src/rust/mcp/tools/uiux/localize.rs

@@ -0,0 +1,76 @@
+// UI/UX Pro Max 文案本地化
+// 仅提供 zh/en 简洁文案，避免过度设计
+
+use super::engine::{SearchResult, SuggestResult};
+use super::types::{UiuxLang, UiuxMode};
+
+pub fn localize_text(lang: UiuxLang, zh: &str, en: &str) -> String {
+    match lang {
+        UiuxLang::Zh => zh.to_string(),
+        UiuxLang::En => en.to_string(),
+    }
+}
+
+pub fn error_text(lang: UiuxLang, message: &str) -> String {
+    match lang {
+        UiuxLang::Zh => format!("发生错误: {}", message),
+        UiuxLang::En => format!("Error: {}", message),
+    }
+}
+
+pub fn search_summary(lang: UiuxLang, mode: UiuxMode, result: &SearchResult) -> String {
+    if let Some(err) = &result.error {
+        return error_text(lang, err);
+    }
+
+    match mode {
+        UiuxMode::Beautify => localize_text(lang, "已生成 UI 美化建议。", "UI beautify suggestions generated."),
+        _ => {
+            let zh = format!("已获取检索结果，领域：{}，共 {} 条。", result.domain, result.count);
+            let en = format!("Search completed. Domain: {}. Results: {}.", result.domain, result.count);
+            localize_text(lang, &zh, &en)
+        }
+    }
+}
+
+pub fn stack_summary(lang: UiuxLang, result: &SearchResult) -> String {
+    if let Some(err) = &result.error {
+        return error_text(lang, err);
+    }
+
+    let stack = result.stack.clone().unwrap_or_else(|| "-".to_string());
+    let zh = format!("已获取栈指南：{}，共 {} 条。", stack, result.count);
+    let en = format!("Stack guidelines: {}. Results: {}.", stack, result.count);
+    localize_text(lang, &zh, &en)
+}
+
+pub fn design_system_summary(lang: UiuxLang, project_name: &str, persisted: bool) -> String {
+    if persisted {
+        let zh = format!("已生成并写入设计系统：{}。", project_name);
+        let en = format!("Design system generated and persisted: {}.", project_name);
+        localize_text(lang, &zh, &en)
+    } else {
+        let zh = format!("已生成设计系统建议：{}。", project_name);
+        let en = format!("Design system recommendations generated: {}.", project_name);
+        localize_text(lang, &zh, &en)
+    }
+}
+
+pub fn beautify_summary(lang: UiuxLang) -> String {
+    localize_text(lang, "已生成 UI 美化建议。", "UI beautify suggestions generated.")
+}
+
+pub fn suggest_summary(lang: UiuxLang, result: &SuggestResult) -> String {
+    if result.should_suggest {
+        let keywords = if result.matched_keywords.is_empty() {
+            "-".to_string()
+        } else {
+            result.matched_keywords.join(", ")
+        };
+        let zh = format!("建议使用 UI/UX 工具，匹配关键词：{}。", keywords);
+        let en = format!("UI/UX tool suggested. Matched keywords: {}.", keywords);
+        localize_text(lang, &zh, &en)
+    } else {
+        localize_text(lang, "暂无明显 UI/UX 需求。", "No strong UI/UX signal detected.")
+    }
+}