🤖 opencode.nvim

neovim 版 opencode 前端 —— 一个基于终端的 AI 编程助手

✨ 描述

此插件在 Neovim 和 opencode AI 助手之间建立了桥梁，创建了一个聊天界面，同时能够捕获编辑器上下文（当前文件、选中文本）以增强你的 Prompt。它维护与工作区绑定的持久化会话，让你能像使用 Cursor AI 那样与 AI 助手进行连续对话。

主要功能

聊天面板

聊天面板是 Neovim 内的一个专用窗口，允许你与 opencode AI 助手进行持久化对话。它会显示之前的消息和回复，并自动使用你当前的工作区和编辑器状态作为上下文，让你无需离开 Neovim 即可迭代代码。你可以输入 Prompt、查看回复，并在保持聊天会话开启的同时返回代码缓冲区进行操作。

快速缓冲区聊天 (o/)（实验性）

这是一个实验性功能，允许你使用当前缓冲区作为上下文与 AI 聊天。在可视模式（Visual mode）下，它会捕获选中的文本作为上下文；在普通模式（Normal mode）下，则使用当前行。AI 会通过插件自动应用对文件的快速编辑。

欢迎尝试并提供反馈！

更多详情请参阅 快速聊天 部分。

📑 目录

• ⚠️ 注意事项
• 📋 要求
• 🚀 安装
• ⚙️ 配置
• 📖 使用
• 🔑 权限
• Context
• Agents
• 自定义/外部服务器配置
• 用户命令与 Slash 命令
• 快照上下文操作
• 上下文恢复点
• 高亮组
• Prompt 守卫
• 自定义用户钩子
• 服务器发送事件 (SSE) 自动命令
• 快速聊天
• 设置 Opencode
• 方案 (Recipes)

⚠️ 注意事项

本插件处于早期开发阶段，可能存在 Bug 或破坏性变更，暂不建议在生产环境中使用。如遇任何问题，请在 GitHub 仓库 提交反馈。

Opencode 本身也处于早期开发阶段，同样可能存在破坏性变更。请确保使用兼容的 Opencode CLI 版本 (v0.6.3 或更高)。

如果升级导致插件损坏，请提交 Issue 或降级到上一个可用的版本。

📋 要求

• 已安装并配置好 Opencode (v0.6.3+) CLI（参见下方的 设置 Opencode）。

🚀 安装

使用你偏好的包管理器安装此插件。配置选项请参考下方的 配置 部分。

使用 lazy.nvim

{
  "sudo-tee/opencode.nvim",
  config = function()
    require("opencode").setup({})
  end,
  dependencies = {
    "nvim-lua/plenary.nvim",
    {
      "MeanderingProgrammer/render-markdown.nvim",
      opts = {
        anti_conceal = { enabled = false },
        file_types = { 'markdown', 'opencode_output' },
      },
      ft = { 'markdown', 'Avante', 'copilot-chat', 'opencode_output' },
    },
    -- 可选，用于文件提及和命令补全，任选其一
    'saghen/blink.cmp',
    -- 'hrsh7th/nvim-cmp',

    -- 可选，用于文件提及拾取器，任选其一
    'folke/snacks.nvim',
    -- 'nvim-telescope/telescope.nvim',
    -- 'ibhagwan/fzf-lua',
    -- 'nvim_mini/mini.nvim',
  },
}

⚙️ 配置

-- 包含所有可用选项的默认配置
require('opencode').setup({
  preferred_picker = nil, -- 'telescope', 'fzf', 'mini.pick', 'snacks', 'select'，若为 nil 则使用最佳可用拾取器。注意：mini.pick 不支持多选
  preferred_completion = nil, -- 'blink', 'nvim-cmp', 'vim_complete'，若为 nil 则使用最佳可用补全
  default_global_keymaps = true, -- 若为 false，则禁用所有默认全局快捷键
  default_mode = 'build', -- 'build'、'plan' 或任何自定义配置。@see [OpenCode Agents](https://opencode.ai/docs/modes/)
  default_system_prompt = nil, -- 所有会话使用的自定义系统 Prompt。若为 nil，则使用内置默认系统 Prompt
  keymap_prefix = 'o', -- 全局快捷键的前缀
})