BotFramework-WebChat 文件上传行为变更解析与技术实现方案

功能变更背景

在 BotFramework-WebChat 4.17.0 版本中，文件上传功能进行了重要行为调整。原先用户选择文件后系统会立即自动上传，现在改为需要用户手动触发（通过回车键或点击操作）。这一变更是为了提升交互可控性，避免误操作导致意外上传。

技术实现细节

该功能通过 PR #5123 引入，核心控制参数为 styleOptions.sendAttachmentOn。开发者可以通过配置此参数来选择不同的文件提交策略：

1. 立即提交模式（传统行为）

   styleOptions: {
     sendAttachmentOn: "attach"  // 选择文件后立即上传
   }
   

2. 手动提交模式（4.17.0默认行为）

   styleOptions: {
     sendAttachmentOn: "send"  // 需要用户确认后上传
   }
   

用户界面表现差异

• 传统模式：文件选择对话框关闭后立即开始上传流程
• 新默认模式：界面会显示待提交状态（包含提示圆点），等待用户确认

最佳实践建议

1. 关键业务场景：涉及重要文件上传时建议采用手动提交模式，降低误操作风险
2. 效率优先场景：对于需要快速连续上传的场景，可切换回立即提交模式
3. 版本兼容性：升级到4.17.0+版本时应注意测试文件上传相关功能

技术决策考量

该变更体现了以下设计理念：

• 增强用户对敏感操作的控制权
• 统一WebChat与其他聊天应用的交互模式
• 为复杂场景（如多文件选择）提供更好的扩展性

开发者应根据实际业务需求选择合适的文件提交策略，平衡操作效率与安全性的关系。