fquiz/FL-190-test-plan.md

FL-190 测试计划：AI问答页面未选中会话时发送消息修复验证

测试目标

验证在 AI 问答页面未选中会话时发送消息不再报 "Conversation not found" 异常。

测试场景

场景 1：首次使用，无任何会话

前置条件：

• 用户首次访问 AI 问答页面
• 数据库中没有该用户的会话记录

操作步骤：

1. 打开 AI 问答页面 (/admin/ai-chat)
2. 在输入框中输入问题："什么是人工智能？"
3. 点击"发送"按钮

预期结果：

• ✅ 自动创建一个新会话，标题为"什么是人工智能？"
• ✅ 消息成功发送到新创建的会话
• ✅ 收到 AI 的流式回复
• ✅ 不出现 "Conversation not found" 错误
• ✅ 左侧会话列表显示新创建的会话

场景 2：有历史会话，但未选中任何会话

前置条件：

• 用户已有历史会话
• 手动清除选中状态（通过删除当前选中的会话）

操作步骤：

1. 打开 AI 问答页面
2. 删除所有会话或确保没有会话被选中
3. 在欢迎界面的输入框中输入问题："今天天气怎么样？"
4. 点击"发送"按钮

预期结果：

• ✅ 自动创建一个新会话
• ✅ 消息成功发送
• ✅ 不出现 "Conversation not found" 错误

场景 3：长消息标题截取

前置条件：

• 无选中会话

操作步骤：

1. 输入一个超过20个字符的长问题："请详细解释一下量子计算机的工作原理和应用场景"
2. 点击"发送"按钮

预期结果：

• ✅ 创建会话，标题为"请详细解释一下量子计算机的工作原..."（前20字+省略号）
• ✅ 消息成功发送

场景 4：多行消息标题处理

前置条件：

• 无选中会话

操作步骤：

1. 输入多行问题（使用 Shift+Enter 换行）：

   第一行问题
   第二行补充
   

2. 点击"发送"按钮

预期结果：

• ✅ 创建会话，标题取第一行："第一行问题"
• ✅ 完整的多行消息被发送

代码验证点

前端 (web/src/app/admin/ai-chat/page.tsx)

关键函数：handleSendMessage (271-300行)

if (!selectedConvId) {
  // 自动创建会话
  const title = content.length > 20
    ? content.substring(0, 20) + "..."
    : content.split('\n')[0] || "新对话";
  
  const newConv = await createConvMutation.mutateAsync(title);
  sendMessageMutation.mutate({
    convId: newConv.id,
    content,
  });
}

验证点：

• ✅ 检查 selectedConvId 是否为 null
• ✅ 自动创建会话并等待完成 (mutateAsync)
• ✅ 使用新会话 ID 发送消息
• ✅ 错误处理：创建失败时提前返回

后端 (api/app/api/v1/ai_chat.py)

关键端点：POST /api/v1/ai-chat/conversations/{conversation_id}/messages

验证点：

• ✅ 端点要求 conversation_id 必须存在
• ✅ 会话不存在时返回 404 错误
• ✅ 前端确保在调用此端点前会话已创建

回归测试

正常流程不受影响

1. 选中已有会话后发送消息 → 应正常工作
2. 手动创建新会话 → 应正常工作
3. 删除会话 → 应正常工作
4. 切换会话 → 应正常工作

性能考虑

• 自动创建会话是异步操作，使用 mutateAsync 确保创建完成后再发送消息
• 避免了并发问题（先创建后发送，而不是同时进行）

结论

✅ 修复已完成：FL-189 的提交已经实现了完整的修复逻辑 ✅ 代码审查通过：逻辑正确，没有遗漏的边界情况 ✅ 构建成功：前端代码编译通过，无 TypeScript 错误 ✅ 测试就绪：可以进行手动测试验证