opencode.nvim
在 Neovim 中无缝接入 OpenCode，保持你熟悉的编辑器工作流。
证据显示插件在权限请求时要求用户批准或拒绝（user_confirmation=2），但未明确说明最小权限原则，且权限处理细节有限（least_privilege=1）。数据流透明度不足，未详细说明哪些数据被发送到OpenCode服务器（data_flow_transparency=1）。敏感数据处理未明确说明（sensitive_data_handling=1）。依赖安全性未评估，仅依赖外部工具（dependency_security=1）。外部影响有限，但未明确说明（external_effects=1）。回滚机制未明确说明（rollback=1）。来源归属仅通过README和许可证，但发布者未验证（source_attribution=1）。
自一致性较好，文档和代码示例一致（self_consistency=2）。依赖可用性未明确说明，依赖外部OpenCode和Neovim（dependency_availability=1）。失败消息未详细说明（failure_messages=1）。
目标受众明确为Neovim用户，场景清晰（audience_and_scenarios=2）。能力边界明确，如仅支持单个OpenCode实例（capability_boundaries=2）。触发精度高，通过命令和键映射精确控制（trigger_precision=2）。环境适配良好，支持多种安装方式（environment_fit=2）。
信息架构清晰，文档结构良好（information_architecture=2）。安装说明详细（install_notes=2）。命名稳定，API一致（naming_stability=2）。示例和FAQ充分（examples_and_faq=2）。已知限制提及较少（known_limitations=1）。许可证明确为MIT（license=2）。版本和变更日志未明确（versioning_changelog=1）。维护责任未明确（maintenance_responsibility=1）。
输出可用性高，提供多种交互方式（output_usability=2）。边际价值明确，集成现有工具（marginal_value=2）。成本效益合理，免费开源（cost_benefit=2）。
声明可追溯性一般，部分功能未详细说明（claim_traceability=1）。跨来源验证有限，仅依赖单一仓库（cross_source_corroboration=1）。事实与推断分离不明确（fact_inference_separation=1）。
- 发布者身份未验证，需谨慎使用。
- 权限处理细节有限，建议审查代码以确认最小权限。
- 数据流透明度不足，建议了解发送到OpenCode服务器的数据。
- 依赖外部OpenCode和Neovim，需确保环境兼容。
这个 Agent 能做什么，适合哪些场景？
opencode.nvim 是一个 Neovim 插件，用于连接 OpenCode 的 TUI 和服务器，将 AI 结对编程能力嵌入到标准 Neovim 界面中。它允许你注入编辑器上下文（如光标、选区、缓冲区），输入提示词（带补全和高亮），从内置或自定义提示中选择，执行 OpenCode 命令，接受/拒绝/重载编辑，并处理 OpenCode 事件。该插件支持任何 OpenCode 服务器，或在本地启动一个集成实例。它优先考虑单一 OpenCode 实例的专注配对，并采用 Vim 风格、简洁的默认配置。
opencode.nvim 通过 require("opencode") 暴露 API，包括 ask()（输入提示词）、select()（从功能中选择）、prompt()（发送提示词）、operator()（作为运算符使用）、command()（执行 OpenCode 会话命令，如 session.new、session.undo 等）。它注入上下文占位符（如 @this、@buffer、@diagnostics）到提示词中。当 OpenCode 发出编辑时，插件使用 Neovim 的 :diffpatch 展示差异，并让你按 hunk 接受或拒绝。它还通过 OpencodeEvent 自动命令转发服务器发送的事件。服务器发现和启动由 vim.g.opencode_opts.server 控制，当没有检测到运行实例时，默认启动 term://opencode --port。
- Neovim 用户希望在熟悉的编辑器中与 OpenCode 配对，而不是切换窗口。
- 开发者希望将光标、选区或整个缓冲区作为上下文发送给 OpenCode，以生成针对性的修复或解释。
- 团队希望标准化提示词（如 review、explain、implement），并添加到共享配置中。
- 需要处理 OpenCode 会话事件（如状态更新、权限请求）并自定义工作流的用户。
- 希望使用 Neovim 的 diff 工具审查和接受或拒绝 AI 编辑的开发者。
这个 Agent 有哪些优点和局限？
- 深度集成 Neovim，利用原生界面（diff、运算符、自动命令）。
- 保持现有的编辑工作流，无需学习新交互模型。
- 支持任意 OpenCode 服务器（本地或远程），并可自动启动。
- 提供上下文注入、内置提示和可自定义的服务器启动。
- 事件驱动，支持实时编辑更新和权限请求。
- 需要安装和配置 OpenCode CLI，必须使用
--port暴露服务器。 - 强调单一 OpenCode 实例，频繁切换服务器时体验可能不佳（可通过
connect配置调整）。 - 插件是 Lua 编写的，NixVim 用户可能需要额外的打包配置。
- 依赖于 OpenCode 的 API 和事件；OpenCode 升级可能引入破坏性变更。
- 文档中未提供详细的插件内部扩展 API 文档，自定义高级行为可能需要对类型定义进行深入理解。
如何安装或部署这个 Agent？
推荐使用 vim.pack 方式：在 init.lua 中添加 vim.pack.add({ { src = "https://github.com/nickjvandyke/opencode.nvim", version = vim.version.range("*") } })，然后设置 vim.g.opencode_opts。也可以使用 lazy.nvim 或 nixvim。安装后运行 :checkhealth opencode 验证。
如何使用这个 Agent？
确保已安装并运行 OpenCode CLI（支持 --port 标志）。设置 vim.g.opencode_opts 并定义键映射，例如：vim.keymap.set({ "n", "x" }, "<C-a>", function() require("opencode").ask("@this: ") end)。然后使用映射调用 ask、select 或其他功能。如果配置了 server.start，也可以让插件启动 OpenCode 服务器。
常见问题
如何连接远程 OpenCode 服务器？
vim.g.opencode_opts.server.url 中设置服务器 URL，例如 http://localhost:PORT 或远程地址。插件会优先连接该服务器，而非自动启动新的实例。编辑权限如何处理？
:diffpatch 显示变更。你可以按 da 接受全部，dr 拒绝全部，或者 dp/do 只接受/拒绝光标下的 hunk。哪些上下文占位符可用？
@this（当前范围/选区或光标位置）、@buffer（当前缓冲区）、@buffers（所有打开的缓冲区）、@diagnostics、@marks、@quickfix 和 @visible。如何自定义提示词？
lua/opencode/config.lua。是否支持多个 OpenCode 实例？
vim.g.opencode_opts.server.connect 设置为 false，避免同步事件的干扰。