map-client-vue/docs/model-selection-debug.md

模型选择验证指南

问题：切换模型后回答没有变化？

这个问题可能有以下几个原因,我已经添加了详细的日志来帮助你诊断。

---

🔍 如何确认模型被正确使用

方法 1: 查看控制台日志 (推荐)

打开浏览器开发者工具 (F12)，切换到 Console 标签，发送一条消息后查看日志：

关键日志标记

1. 用户选择阶段

🎯 [callModelStream] 用户选择的模型: qwen-turbo-latest
✅ [callModelStream] 找到匹配服务: 阿里云通义千问

2. 最终确认阶段

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 [callModelStream] 最终选择:
   服务: 阿里云通义千问 (dashscope)
   模型: qwen-turbo-latest
   MCP: 未选择
   工具: 0 个
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

3. 请求准备阶段

🎯 [makeChatRequestStream] 准备请求参数:
   服务类型: dashscope
   服务名称: 阿里云通义千问
   使用模型: qwen-turbo-latest
   消息数量: 2
   工具数量: 0

4. 最终发送阶段

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 [最终确认] 即将发送请求:
   模型: qwen-turbo-latest
   服务: 阿里云通义千问 (dashscope)
   URL: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

5. API 响应确认

✅ [响应确认] API 返回的模型: qwen-turbo-latest
   请求的模型: qwen-turbo-latest
   模型匹配: ✓ 一致

方法 2: 测试不同模型的特性

测试 qwen-turbo-latest (快速响应)

提问: "用一句话介绍你自己"
预期: 快速响应，简洁回答

测试 qwq-plus (推理能力)

提问: "如果 A>B，B>C，那么 A 和 C 的关系是什么？请详细说明推理过程。"
预期: 详细的逻辑推理步骤

测试 qwen-long (长上下文)

提问: "总结一下我们之前的所有对话"
预期: 能够回顾更多历史消息

测试 qwen3-omni-flash (快速响应)

提问: "快速回答：1+1=?"
预期: 极速响应

---

🐛 常见问题排查

问题 1: 模型显示但没有变化

检查点 1: 确认服务配置正确

// 在控制台执行
const providers = JSON.parse(localStorage.getItem('model-providers') || '[]')
const aliyun = providers.find(p => p.type === 'dashscope')
console.log('阿里云配置:', aliyun)
console.log('可用模型:', aliyun?.models)

检查点 2: 确认模型列表包含目标模型

// 在控制台执行
const providers = JSON.parse(localStorage.getItem('model-providers') || '[]')
providers.forEach(p => {
  console.log(`${p.name} (${p.type}):`, p.models)
})

检查点 3: 查看控制台是否有错误

• 红色错误信息
• 黄色警告信息
• 404/401/403 等 HTTP 错误

问题 2: 所有模型回答都一样

可能原因:

1. 服务类型配置错误: 检查服务类型是否为 dashscope
2. Base URL 错误: 应该是 https://dashscope.aliyuncs.com/compatible-mode/v1
3. 模型参数未传递: 查看日志中的 📋 [makeChatRequestStream] 请求体 model 字段
4. API 不支持该模型: 某些 API Key 可能没有权限使用特定模型

问题 3: API 返回模型不一致

如果看到这样的日志:

✅ [响应确认] API 返回的模型: gpt-3.5-turbo
   请求的模型: qwen-turbo-latest
   模型匹配: ✗ 不一致!

可能原因:

1. 服务配置错误: 可能连接到了错误的服务
2. 模型映射问题: API 可能自动映射到了其他模型
3. API Key 权限: 该 API Key 可能无权使用指定模型

---

🔧 修复步骤

步骤 1: 验证服务配置

// 在浏览器控制台执行
const providers = JSON.parse(localStorage.getItem('model-providers') || '[]')
const aliyun = providers.find(p => p.type === 'dashscope')

console.log('配置检查:')
console.log('✓ 服务类型:', aliyun.type)
console.log('✓ Base URL:', aliyun.baseUrl)
console.log('✓ API Key:', aliyun.apiKey?.substring(0, 10) + '...')
console.log('✓ 模型列表:', aliyun.models)
console.log('✓ 默认模型:', aliyun.defaultModel)
console.log('✓ 启用状态:', aliyun.enabled)

步骤 2: 重新配置模型列表

如果模型列表不正确:

// 在浏览器控制台执行
const providers = JSON.parse(localStorage.getItem('model-providers') || '[]')
const aliyunIndex = providers.findIndex(p => p.type === 'dashscope')

if (aliyunIndex >= 0) {
  // 更新模型列表
  providers[aliyunIndex].models = [
    'qwen-turbo-latest',
    'qwq-plus',
    'qwen-long',
    'qwen3-omni-flash'
  ]
  
  // 保存
  localStorage.setItem('model-providers', JSON.stringify(providers))
  
  console.log('✅ 模型列表已更新，请刷新页面')
  setTimeout(() => location.reload(), 2000)
}

步骤 3: 测试连接

1. 进入"模型服务"设置
2. 找到阿里云服务
3. 点击"测试连接"
4. 查看是否成功

步骤 4: 清空缓存重试

// 清空对话历史
localStorage.removeItem('chat-conversations')
localStorage.removeItem('chat-topics')

// 刷新页面
location.reload()

---

📊 预期日志输出示例

正常情况 (切换模型成功)

🎯 [callModelStream] 用户选择的模型: qwq-plus
✅ [callModelStream] 找到匹配服务: 阿里云通义千问
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 [callModelStream] 最终选择:
   服务: 阿里云通义千问 (dashscope)
   模型: qwq-plus
   MCP: 未选择
   工具: 0 个
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 [makeChatRequestStream] 准备请求参数:
   服务类型: dashscope
   服务名称: 阿里云通义千问
   使用模型: qwq-plus
   消息数量: 2
   工具数量: 0
📋 [makeChatRequestStream] 请求体 model 字段: qwq-plus
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 [最终确认] 即将发送请求:
   模型: qwq-plus
   服务: 阿里云通义千问 (dashscope)
   URL: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ [响应确认] API 返回的模型: qwq-plus
   请求的模型: qwq-plus
   模型匹配: ✓ 一致

异常情况 (服务未找到)

🎯 [callModelStream] 用户选择的模型: unknown-model
⚠️ [callModelStream] 未找到包含该模型的服务，使用默认服务

---

💡 使用建议

1. 首次使用: 先用日志确认模型是否正确传递
2. 测试对比: 用不同模型测试相同问题，对比回答差异
3. 性能对比: 观察不同模型的响应速度
4. 功能测试: 用特定模型测试其特长（如 qwq-plus 测试推理）

---

🆘 仍然有问题？

如果以上方法都无法解决问题，请：

1. 截图控制台完整日志

2. 记录以下信息：

   • 选择的模型名称
   • 服务配置（隐藏 API Key）
   • 完整的控制台输出
   • 问题描述

3. 检查以下文件：

   • /web/src/services/chatService.ts
   • /web/src/services/modelServiceManager.ts
   • localStorage 中的 model-providers

---

现在刷新页面，选择不同的模型，查看控制台日志，你应该能看到完整的模型选择和使用流程！ 🔍✨