DeepChat 项目新增多段引导消息支持的技术解析

DeepChat 作为一个开源的聊天界面组件库，近期在其最新版本中增加了一项重要功能改进——支持多段引导消息(introMessage)配置。这项功能升级为开发者提供了更灵活的聊天界面初始化方式，能够显著提升用户体验。

功能背景

在之前的版本中，DeepChat 仅支持单一引导消息配置，这限制了开发者创建更丰富聊天场景的能力。实际应用中，开发者往往需要在聊天界面初始化时展示多种类型的信息：

1. 欢迎问候语
2. 使用指南
3. 示例问题提示
4. 功能说明等

单一消息的限制迫使开发者不得不将这些内容合并到一个消息块中，既影响美观也降低了可读性。

技术实现

新版本通过重构消息处理逻辑，将 introMessage 参数类型扩展为：

{text?: string, html?: string} | {text?: string, html?: string}[]

这种设计保持了向后兼容性，同时支持以下两种使用方式：

1. 传统单消息模式
2. 新增强的多消息数组模式

核心改进包括：

1. 消息渲染层适配数组处理
2. 角色标识(avatar)的智能显示控制
3. 清空消息功能对多引导消息的特殊处理

使用示例

开发者现在可以这样配置多段引导消息：

introMessage: [
  {
    text: "欢迎使用我们的智能助手"
  },
  {
    html: "<b>您可以尝试询问：</b><br>1. 如何设置账户<br>2. 产品功能说明"
  }
]

问题修复

在功能开发过程中，开发团队发现并修复了两个关键问题：

1. 重复头像显示问题：初始版本中每个引导消息都会显示AI头像，现已优化为仅在首个消息显示
2. 清空消息异常：修复了调用clearMessages方法时出现的"innerContainer未定义"错误

最佳实践

基于此功能，我们建议：

1. 将欢迎语和操作指南分开为独立消息，提高可读性
2. 对HTML内容使用单独消息块，便于样式管理
3. 控制引导消息数量(建议2-3条)，避免信息过载

版本信息

该功能已在以下版本中提供：

• deep-chat 2.1.1
• deep-chat-react 2.1.1

对于需要提前体验的开发者，开发版(dev)9.0.192也已包含完整功能。

这项改进体现了DeepChat项目对开发者需求的快速响应能力，通过灵活的API设计，为构建更自然的聊天交互体验提供了坚实基础。