minuet-ai.nvim

环境要求

• 已安装 Neovim
• 已安装 lazy.nvim 或 Rocks.nvim 插件管理器
• 可选安装 nvim-cmp 或 blink.cmp 作为补全菜单前端
• 准备所选 LLM 服务商的 API key，或本地 Ollama / Llama.cpp 服务
• 能够编辑 Neovim 的 Lua 配置文件

安装与启动步骤

1. 1准备插件管理器

   README 提供 lazy.nvim 和 Rocks.nvim 两种安装方式，先确认你的 Neovim 已使用其中一种管理插件。

2. 2lazy.nvim 安装

   在 lazy.nvim 的 specs 中加入插件，并在 config 中调用 setup 写入配置。

   specs = {
       {
           'milanglacier/minuet-ai.nvim',
           config = function()
               require('minuet').setup {
                   -- Your configuration options here
               }
           end,
       },
       { 'hrsh7th/nvim-cmp' },
       { 'Saghen/blink.cmp' },
   }

   复制

3. 3Rocks.nvim 安装

   如果使用 Rocks.nvim，可直接从 luarocks.org 安装该插件。

   Rocks install minuet-ai.nvim

   复制

4. 4配置 Provider

   在 setup 中通过 provider 选择默认服务商，并按对应服务商要求提供 API key 或本地服务地址。

5. 5配置虚拟文本前端

   使用虚拟文本前端时设置 auto_trigger_ft 和键位；accept 接受整段，accept_line 接受一行。

   require('minuet').setup {
       virtualtext = {
           auto_trigger_ft = {},
           keymap = {
               accept = '',
               accept_line = '',
               accept_n_lines = '',
               prev = '',
               next = '',
               dismiss = '',
           },
       },
   }

   复制

6. 6集成 nvim-cmp

   把 minuet 加入 cmp 源，并适当提高 fetching_timeout 以适应 LLM 响应速度。

   require('cmp').setup {
       sources = {
           {
               { name = 'minuet' },
           }
       },
       performance = {
           fetching_timeout = 2000,
       },
   }
   
   require('cmp').setup {
       mapping = {
           [""] = require('minuet').make_cmp_map()
       },
   }

   复制

7. 7集成 blink-cmp

   在 blink 的 sources 和 providers 中启用 minuet，并设置手动触发键位。

   require('blink-cmp').setup {
       keymap = {
           [''] = require('minuet').make_blink_map(),
       },
       sources = {
           default = { 'lsp', 'path', 'buffer', 'snippets', 'minuet' },
           providers = {
               minuet = {
                   name = 'minuet',
                   module = 'minuet.blink',
                   async = true,
                   timeout_ms = 3000,
                   score_offset = 50,
               },
           },
       },
       completion = { trigger = { prefetch_on_insert = false } },
   }

   复制

关键配置

如何确认成功

打开 Neovim，在 auto_trigger_ft 包含的文件类型中输入代码，出现虚拟文本或补全项即表示生效。

常见问题

注意事项

• context_window 为光标前后总字符数，16000 字符约等于 4000 tokens。
• throttle 和 debounce 控制请求频率，可按机器与网络情况调整。
• 本地 Ollama、Llama.cpp 后端与云端服务商可切换，具体模型名和地址以 README 对应 Provider 示例为准。
• README 未给出 Neovim 最低版本和 API key 的具体设置命令，请以官方 Requirements 与 API Keys 章节为准。