CodeCompanion.nvim插件中系统提示与用户输入交互的深度解析

问题背景

在CodeCompanion.nvim插件使用过程中，开发者发现当配置ignore_system_prompt = true选项时会出现nil值错误。经过深入分析，这实际上是用户配置方式不当导致的问题，而非插件本身的缺陷。

核心问题分析

1. 错误根源：当用户仅配置系统提示(system prompt)而缺少用户提示(user prompt)时，插件无法正确处理消息索引，导致nil值错误。

2. 正确配置方式：

   • 必须同时包含系统提示和用户提示
   • 系统提示可通过visible = false选项隐藏
   • 用户提示内容可为空字符串

prompts = {
  {
    role = "system",
    content = "系统提示内容",
    opts = { visible = false },
  },
  {
    role = "user",
    content = "", -- 用户输入留空
  },
}

高级使用技巧

1. 界面布局优化：

   • 在系统提示内容后添加换行符可改善显示效果
   • 使用多行字符串语法保持代码可读性

2. 提示命名显示：

   • 当前版本不支持直接在聊天窗口标题显示提示名称
   • 可通过修改插件代码实现此功能（需提交PR）

最佳实践建议

1. 始终确保提示配置中包含完整的对话结构（系统+用户）
2. 合理使用visible选项控制提示的显示/隐藏
3. 对于需要用户即时输入的场景，将用户提示内容设为空字符串
4. 考虑使用多行字符串保持配置的可读性

技术实现原理

CodeCompanion.nvim内部处理提示时：

1. 会遍历所有提示消息
2. 根据角色(role)分类处理
3. 当遇到未正确配置的消息时会抛出nil错误
4. 最终将处理后的消息发送给适配器(adapter)

理解这一流程有助于开发者编写更健壮的提示配置。

总结

通过正确配置系统提示和用户提示的组合，开发者可以充分利用CodeCompanion.nvim的强大功能，同时避免常见的配置错误。对于有特殊需求的用户，可以考虑通过提交PR的方式扩展插件功能。