CodeCompanion.nvim 插件中 deepseek-reasoner 调用失败问题分析

问题现象

在使用 CodeCompanion.nvim 插件与 deepseek 适配器交互时，当配置模型为 deepseek-reasoner 时，会出现 Lua 运行时错误。具体表现为在提交聊天消息后，系统抛出 t: expected table, got boolean 类型错误，导致 API 调用中断，无法获取 LLM 的响应。

错误分析

从错误堆栈可以追踪到问题发生在 codecompanion/adapters/deepseek.lua 文件的第 46 行，具体是在 form_tools 函数中。该函数在处理工具调用时，预期接收一个表(table)类型参数，但实际得到了一个布尔(boolean)值，导致 vim.shared.tbl_count 函数调用失败。

技术背景

CodeCompanion.nvim 是一个 Neovim 插件，提供了与多种大型语言模型交互的能力。deepseek 是其中一个适配器实现，用于与 DeepSeek 的 API 进行通信。deepseek-reasoner 是该平台提供的一个专用推理模型。

解决方案

该问题已被开发者修复，主要修改点包括：

1. 在 form_tools 函数中添加了对输入参数的严格类型检查
2. 确保在所有情况下都返回有效的表结构
3. 处理了工具调用参数可能为布尔值的边界情况

配置建议

对于需要使用 deepseek 适配器的用户，建议采用以下配置方式：

{
  strategies = {
    chat = { adapter = "deepseek" },
  },
  adapters = {
    deepseek = function()
      return require("codecompanion.adapters").extend("deepseek", {
        schema = {
          model = {
            default = "deepseek-reasoner",  -- 或其他有效模型
          },
        },
      })
    end,
  },
}

注意事项

1. 确保已正确设置 DEEPSEEK_API_KEY 环境变量
2. 检查 Neovim 版本是否兼容（建议 v0.11.0 或更高）
3. 更新插件到最新版本以获取修复
4. 调试时可启用日志级别为 DEBUG 以获取更多信息

总结

这类参数类型不匹配问题在 Lua 开发中较为常见，特别是在处理 API 响应时。开发者在修复时不仅解决了当前问题，还增强了代码的健壮性，为未来可能的参数变化提供了更好的兼容性。用户只需确保使用最新版本的插件即可避免此问题。