CodeCompanion.nvim中Gemini适配器系统提示移除问题的技术解析

问题背景

在CodeCompanion.nvim插件的Gemini适配器实现中，开发者发现当用户尝试移除系统提示(system prompt)时，会导致API请求失败。该问题表现为当用户通过快捷键gs关闭系统提示后发送消息时，Gemini API返回400错误，提示"contents.parts must not be empty"。

技术细节分析

Gemini API对请求参数有严格验证机制，特别是对于system_instruction.parts字段。当用户移除系统提示后，适配器生成的请求体中该字段变为空，违反了API的参数校验规则。核心问题在于适配器未能正确处理空系统提示的情况，没有提供默认值或适当的结构。

解决方案实现

项目维护者通过以下方式解决了该问题：

1. 在适配器层面对空系统提示情况进行检测
2. 当系统提示为空时，提供符合API要求的默认数据结构
3. 确保请求体始终包含有效的parts数组，即使内容为空

相关技术延伸

这个问题揭示了大型语言模型API集成中的几个重要考量：

1. API参数验证的严格性要求
2. 空值处理的健壮性设计
3. 不同AI提供商API规范的差异性
4. 客户端适配器需要实现的防御性编程

最佳实践建议

对于基于CodeCompanion.nvim进行开发的用户，建议：

1. 始终检查适配器对特殊输入情况的处理
2. 了解所用AI提供商的API规范细节
3. 在自定义适配器时实现全面的参数验证
4. 考虑使用默认值而非完全移除关键字段

项目影响

该修复提升了Gemini适配器的稳定性，确保了在各种用户配置下都能正常工作，体现了插件对多种AI服务良好兼容性的持续追求。