FunASR项目中WebSocket协议离线模式字段解析

在FunASR项目的WebSocket协议实现中，离线文件转写模式下的is_final字段行为与在线模式存在显著差异，这一技术细节对于开发者正确实现客户端逻辑至关重要。

协议字段行为分析

FunASR的WebSocket协议文档中原本描述is_final字段表示"识别结束"，但在实际离线文件转写模式下，该字段始终保持False值。这一行为特性源于离线处理的本质差异：

1. 离线处理特性：离线模式下音频文件是完整上传后一次性处理的，不存在分段识别过程
2. 单次响应机制：服务端在处理完整个文件后会通过单个WebSocket包返回全部结果
3. 连接终止信号：不同于在线模式的流式处理，离线模式通过关闭连接来表示处理完成

客户端实现建议

基于这一行为特性，客户端实现时应遵循以下最佳实践：

1. 忽略is_final字段：在离线模式下无需检查该字段值
2. 连接状态检测：通过WebSocket连接关闭事件判断处理完成
3. 结果处理时机：收到第一个(也是唯一一个)响应包后即可开始处理结果数据

协议文档优化建议

技术文档应明确区分不同模式下的字段语义差异，建议补充说明：

• 离线模式下is_final字段无实际意义
• 客户端应通过连接状态而非该字段判断处理完成
• 两种模式下的结果获取机制差异

这种明确的协议行为描述可以帮助开发者避免实现误区，提高集成效率。