DeepChat 自定义加载动画导致空消息时介绍面板不显示问题解析

问题背景

在 DeepChat 项目中，开发者可以通过配置自定义加载动画来美化消息加载时的用户体验。然而，当使用 loadHistory 拦截器并返回空消息数组时，如果同时定义了自定义加载 HTML，会导致介绍面板(intro panel)无法正常显示的问题。

技术细节分析

预期行为

按照 DeepChat 的设计规范，当消息为空时，系统应当显示介绍面板。这个面板通常包含欢迎信息、使用指南或其他引导性内容，对于新用户特别重要。

问题表现

当开发者同时满足以下两个条件时，就会出现介绍面板不显示的问题：

1. 在 messageStyles 中配置了自定义加载 HTML 动画
2. 在 loadHistory 拦截器中返回空数组([])

根本原因

经过分析，问题出在加载状态的处理逻辑上。当自定义加载动画存在时，系统在完成加载后没有正确触发介绍面板的显示逻辑。这属于状态管理中的一个边界条件处理不足的问题。

解决方案

项目维护者已在开发版本 deep-chat-dev@9.0.248 和 deep-chat-react-dev@9.0.248 中修复了此问题。修复的核心思路是：

1. 确保加载状态结束时正确检查消息数组
2. 无论是否存在自定义加载动画，都按照相同逻辑处理空状态
3. 保持介绍面板的显示条件一致性

版本更新

该修复已正式发布在稳定版本中：

• deep-chat@2.2.0
• deep-chat-react@2.2.0

开发者建议

对于使用 DeepChat 的开发者，建议：

1. 及时升级到最新版本以获取此修复
2. 在实现自定义加载动画时，仍然可以放心使用空消息数组的场景
3. 测试时特别关注空状态下的UI表现

总结

这个问题的修复体现了 DeepChat 项目对细节的关注和对开发者体验的重视。通过正确处理边界条件，确保了自定义功能和核心功能的无缝协作，为开发者提供了更稳定可靠的组件解决方案。