avante.nvim 怎么通过 lazy.nvim 安装并配置 DeepSeek provider?
【免费下载链接】awesome-deepseek-integrationIntegrate the DeepSeek API into popular software项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-integration
avante.nvim 是一个模拟 Cursor AI IDE 行为的 Neovim 插件:它可以提供 AI 驱动的代码建议,并让你用单个命令把建议直接应用到源文件。本文按仓库中的安装说明(docs/avante.nvim/README.md),把 avante.nvim 通过 lazy.nvim 装进 Neovim,并把 provider 配置为 DeepSeek。开始前注意文档明确标注的一点:项目处于快速迭代状态,该指南最后更新于 2024 年 10 月 19 日,此日期之后的安装与配置方式可能已经变化,请以原项目的 README 为准。
前提条件
文档给出的操作以 nvim 配置目录为基础,先确认:
- nvim 配置目录:文档说明 Linux 下默认是
~/.config/nvim,操作对象是其中的lua/plugins文件夹; - 使用 lazy.nvim 作为插件管理器:文档的安装路径就是把插件声明写入
lua/plugins,重启后由 lazy.nvim 自动下载、安装插件及其依赖; - DeepSeek API key:配置中
api_key_name = "DEEPSEEK_API_KEY"声明了插件读取 key 使用的名称,文档到此为止,没有进一步说明 key 的提供方式。
创建lua/plugins/avante.lua
进入 nvim 配置文件夹(Linux 默认~/.config/nvim),再进入lua/plugins文件夹,创建一个名为avante.lua的文件,写入以下内容:
return { { "yetone/avante.nvim", event = "VeryLazy", lazy = false, version = false, -- set this if you want to always pull the latest change opts = { provider = "deepseek", vendors = { deepseek = { __inherited_from = "openai", api_key_name = "DEEPSEEK_API_KEY", endpoint = "https://api.deepseek.com", model = "deepseek-coder", max_tokens = 8192, }, }, }, -- if you want to build from source then do `make BUILD_FROM_SOURCE=true` build = "make", -- build = "powershell -ExecutionPolicy Bypass -File Build.ps1 -BuildFromSource false" -- for windows dependencies = { "nvim-treesitter/nvim-treesitter", "stevearc/dressing.nvim", "nvim-lua/plenary.nvim", "MunifTanjim/nui.nvim", --- The below dependencies are optional, "nvim-tree/nvim-web-devicons", -- or echasnovski/mini.icons "zbirenbaum/copilot.lua", -- for providers='copilot' { -- support for image pasting "HakonHarnes/img-clip.nvim", event = "VeryLazy", opts = { -- recommended settings default = { embed_image_as_base64 = false, prompt_for_file_name = false, drag_and_drop = { insert_mode = true, }, -- required for Windows users use_absolute_path = true, }, }, }, { -- Make sure to set this up properly if you have lazy=true 'MeanderingProgrammer/render-markdown.nvim', opts = { file_types = { "markdown", "Avante" }, }, ft = { "markdown", "Avante" }, }, }, }, }这份声明里与 DeepSeek 直接相关的部分在opts中:
provider = "deepseek":指定插件使用的 provider;vendors.deepseek:DeepSeek 的接入参数。__inherited_from = "openai"表示继承 openai 厂商配置,api_key_name = "DEEPSEEK_API_KEY"声明读取 API key 的名称,endpoint = "https://api.deepseek.com"是接口地址,model = "deepseek-coder"是模型名,max_tokens = 8192。注意仓库中英文两份 README 不一致:中文 README 里同样位置的 DeepSeek 配置没有max_tokens = 8192这一行,上例采用的是英文版内容;build = "make":文档注释说明想从源码构建时改为make BUILD_FROM_SOURCE=true;被注释掉的那行是文档为 Windows 提供的构建命令;dependencies:文档用注释标明 “The below dependencies are optional”,即nvim-treesitter、dressing.nvim、plenary.nvim、nui.nvim是基础依赖集,其余四项为可选:nvim-web-devicons(图标,注释提示可换echasnovski/mini.icons)、copilot.lua(注释标明用于providers='copilot')、img-clip.nvim(图片粘贴支持,其中use_absolute_path = true注释标明是 Windows 用户所需)、render-markdown.nvim(markdown 渲染,注释提示若设置lazy=true要正确配置)。使用 DeepSeek 时文档没有要求保留哪些可选项,示例按原样保留。
重启 nvim,确认安装结果
avante.lua保存后重启 nvim。文档给出的成功行为是:重启后,lazy.nvim会根据该文件自动下载并安装 avante.nvim 插件及其依赖项。以此作为本次安装的判断依据:插件与依赖没有出现、或安装报错时,说明安装没有按文档预期完成,需要回到上面的配置与构建步骤排查。
边界与后续
- 仓库文档中“其他安装方式”和“使用”两个部分均只指向原项目 README,没有给出具体命令;插件装好后的实际操作方式以原项目文档为准。
- 再次提醒文档标注的限制:本指南对应 2024-10-19 的状态,项目快速迭代中,如果实际安装行为与本文不符,应以原项目 README 为准,不要沿用可能已过时的安装配置。
【免费下载链接】awesome-deepseek-integrationIntegrate the DeepSeek API into popular software项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-integration
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考