Snacks.nvim 项目：如何为选择器菜单项添加快捷键

在 Snacks.nvim 插件中，用户可以通过自定义选择器（picker）创建交互式菜单。本文探讨一种进阶用法：为菜单项绑定静态快捷键，实现类似 which-key 的快速导航体验，同时保留搜索过滤能力。

核心需求场景

假设我们构建了一个 Git 操作选择器：

1. 通过 <d-g> 触发 Git 功能菜单
2. 菜单包含 "Branches"、"Status"、"Log" 等常见操作
3. 初期用户通过关键词搜索定位功能（如输入 "bran" 筛选分支功能）
4. 随着使用频率增加，希望能记忆高频操作的快捷键（如 <c-b> 直接跳转分支管理）

技术实现方案

虽然官方未内置此功能，但可通过 Snacks.nvim 的现有 API 组合实现：

1. 定义带快捷键的菜单项

local git_actions = {
  {
    text = "Branches",
    key = "<c-b>",  -- 自定义快捷键标识
    action = function() require("snacks").picker.git_branches() end
  },
  -- 其他菜单项...
}

2. 动态渲染快捷键提示

在 picker 配置中通过 format 函数增强显示：

format = function(item)
  return string.format("%-20s %s", item.text, item.key or "")
end

3. 绑定快捷键响应

利用 win.input.keys 和 win.list.keys 捕获快捷键：

layout = {
  list = {
    keys = {
      ["<c-b>"] = function() 
        -- 执行对应 action
      end
    }
  }
}

进阶技巧

1. 冲突处理：当快捷键与搜索字符冲突时，可设置 timeoutlen 延迟响应
2. 视觉提示：通过 hl_group 为快捷键添加特殊高亮
3. 状态记忆：结合 vim.g 存储用户最常访问的项，动态调整快捷键分配

方案优势

相比传统 which-key：

• 保留模糊搜索能力
• 支持动态内容（如 Git 分支实时变化）
• 可结合预览窗口等 Snacks.nvim 特有功能

这种实现方式既满足了新手的学习曲线，又为高级用户提供了效率提升路径，体现了 Neovim 插件的高度可定制性。