Skip to content

MODEL_RECOMMENDATION_UI_UPDATE.md

Latest commit

 

History

History
173 lines (135 loc) · 5.27 KB

MODEL_RECOMMENDATION_UI_UPDATE.md

File metadata and controls

173 lines (135 loc) · 5.27 KB

模型推荐功能优化

📋 概述

将模型验证警告功能改为友好的推荐提示功能，不再强制验证用户选择的模型，而是提供参考建议，让用户自主决策。

🎯 优化目标

  • ❌ 移除：强制模型验证和警告提示
  • ✅ 改为：友好的推荐说明和建议
  • ✅ 保留：一键应用推荐配置功能

📝 修改内容

1. 前端修改（frontend/src/views/Analysis/SingleAnalysis.vue）

修改前：验证模型并显示警告

// 旧逻辑：验证模型是否合适
const validateRes = await validateModels(...)
if (!validateRes.data.valid) {
  // 显示警告：模型不合适
  modelRecommendation.value = {
    title: '⚠️ 模型选择建议',
    type: 'warning',
    ...
  }
}

修改后：显示推荐说明

// 新逻辑：直接显示推荐说明
const recommendRes = await recommendModels(depthName)
modelRecommendation.value = {
  title: '💡 模型推荐',
  type: 'info',  // 改为信息提示，不是警告
  message: '快速浏览，获取基本信息\n\n推荐模型配置：...',
  ...
}

2. 后端修改（app/routers/model_capabilities.py）

优化推荐理由格式

# 修改前
reason = (
    f"{request.research_depth}分析推荐：\n"
    f"快速模型 {quick_model}（等级{quick_info['capability_level']}）适合数据收集，"
    f"深度模型 {deep_model}（等级{deep_info['capability_level']}）适合推理决策。\n"
    f"{depth_req['description']}"
)

# 修改后
reason = (
    f"• 快速模型：{quick_level_desc}，注重速度和成本，适合数据收集\n"
    f"• 深度模型：{deep_level_desc}，注重质量和推理，适合分析决策"
)

🎨 UI 效果

修改前（警告样式）

⚠️ 模型选择建议
当前快速模型能力等级(2)低于标准分析要求(3)。
当前深度模型能力等级(2)低于标准分析要求(4)。

建议切换为：
• 快速模型：通义千问 Plus
• 深度模型：通义千问 Max

[应用推荐]
  • 类型：warning（黄色警告框）
  • 语气：强制性、警告性

修改后（信息样式）

💡 模型推荐
标准分析，全面评估股票

推荐模型配置：
• 快速模型：通义千问-Turbo
• 深度模型：通义千问-Plus

• 快速模型：基础级，注重速度和成本，适合数据收集
• 深度模型：标准级，注重质量和推理，适合分析决策

[应用推荐]
  • 类型：info（蓝色信息框）
  • 语气：建议性、友好性

📊 分析深度说明

深度等级 说明 推荐配置
1级 - 快速 快速浏览，获取基本信息 快速模型：基础级，深度模型：基础级
2级 - 基础 基础分析，了解主要指标 快速模型：基础级，深度模型：标准级
3级 - 标准 标准分析，全面评估股票 快速模型：基础级，深度模型：标准级以上
4级 - 深度 深度研究，挖掘投资机会 快速模型：标准级，深度模型：高级以上，需要推理能力
5级 - 全面 全面分析，专业投资决策 快速模型：标准级，深度模型：专业级以上，强推理能力

🔄 降级说明

如果 API 调用失败，会显示通用说明：

const generalDescriptions: Record<number, string> = {
  1: '快速分析：使用基础模型即可，注重速度和成本',
  2: '基础分析：快速模型用基础级，深度模型用标准级',
  3: '标准分析：快速模型用基础级，深度模型用标准级以上',
  4: '深度分析：快速模型用标准级，深度模型用高级以上，需要推理能力',
  5: '全面分析：快速模型用标准级，深度模型用专业级以上，强推理能力'
}

✅ 优势

  1. 用户体验更好

    • 不再有警告和强制性提示
    • 改为友好的建议和说明
    • 用户可以自主决策

  2. 信息更清晰

    • 直接说明分析深度的用途
    • 清楚展示推荐的模型配置
    • 解释推荐理由

  3. 保留便捷功能

    • 仍然可以一键应用推荐配置
    • 降低用户操作成本

  4. 更加灵活

    • 用户可以根据实际情况选择
    • 不强制使用推荐配置
    • 适应不同使用场景

🧪 测试步骤

  1. 刷新前端页面
  2. 进入单股分析页面
  3. 选择不同的分析深度（1-5级）
  4. 查看推荐提示：
    • 应该显示蓝色信息框（不是黄色警告框）
    • 标题为"💡 模型推荐"
    • 内容包含分析深度说明和推荐配置
  5. 点击"应用推荐"按钮：
    • 模型配置应该自动切换
    • 提示消失
    • 显示成功消息

📁 修改的文件

  1. ✅ frontend/src/views/Analysis/SingleAnalysis.vue

    • 修改 checkModelSuitability() 函数
    • 移除模型验证逻辑
    • 改为显示推荐说明

  2. ✅ app/routers/model_capabilities.py

    • 优化推荐理由格式
    • 使用能力等级描述
    • 简化说明文字

  3. ✅ docs/MODEL_RECOMMENDATION_UI_UPDATE.md

    • 新增功能说明文档

🎉 总结

这次优化将强制性的模型验证改为友好的推荐说明，提升了用户体验，让用户可以根据自己的需求自主选择模型配置，同时保留了一键应用推荐的便捷功能。