Neovim：用 OSC 52 穿越终端剪贴板屏障

在构建各种分布式节点时，我经常需要在深层 SSH 嵌套或 WSL 隔离网段中直接操作 Neovim。此时 yank 操作会被锁死在远程的局部寄存器中，无法穿透至本地操作系统的系统剪贴板。

通常的 Hack 是配置 X11 转发、挂载共享剪贴板守护进程或安装 xclip/pbcopy 代理。但这些方案在网络层和权限管理上极其脆弱且不够优雅。自 Neovim 0.10 版本开始，其底层正式并入了对 OSC 52 的原生支持（详见核心代码合并日志 Neovim PR #25872），提供了直击底层的物理级解决方案。

OSC 52 的通信机制

OSC（Operating System Command）是一系列标准化的终端转义序列。OSC 52 的底层通信协议极其粗暴且直接：它形如 ESC ] 52 ; c ; <base64 载荷> BEL。

Neovim 根本不需要调用任何外部操作系统的剪贴板 API。它仅仅是将文本通过 base64 编码，封装进这串控制符中，直接写入当前 TTY 的标准输出流（stdout）。当你本地的终端模拟器（如 Alacritty 或 Windows Terminal）解析字节流并截获到该控制符时，由终端负责完成 base64 解码并执行底层剪贴板系统调用。

这种设计的精妙之处在于：控制信号与普通文本共享同一条 TCP 连接。它能无视任何容器边界和 SSH 跳转，免费穿透所有网络层阻碍。

寄存器与转义层的映射

要求 Neovim 版本 ≥ 0.10，且终端本身支持 OSC 52 解析（支持状态表参考 终端支持度指南 与 社区讨论，或者详见 Neovim Issue #28611）。

只需在 init.lua 中显式覆写剪贴板提供者（Provider）：

-- 构造一个仅读取 Neovim 内部寄存器的回退函数
function my_paste(reg)
  return function(lines)
    local content = vim.fn.getreg('"')
    return vim.split(content, "\n")
  end
end

-- 劫持系统剪贴板通道
vim.g.clipboard = {
  name = "OSC 52",
  copy = {
    ["+"] = require("vim.ui.clipboard.osc52").copy("+"),
    ["*"] = require("vim.ui.clipboard.osc52").copy("*"),
  },
  paste = {
    ["+"] = my_paste("+"),
    ["*"] = my_paste("*"),
  },
}

这里揭示了一个在协议实现上的不对称性缺陷。copy 的指令流是单向推送，Neovim 只需要把转义序列推向 TTY 即可完成任务。但 paste 操作需要反向的双工通信：Neovim 必须向终端发送 OSC 52 查询指令，并阻塞等待终端将本地剪贴板内容回传。

出于安全沙箱隔离的考虑，现代终端（包括 Windows Terminal）往往会阻断这种被动的远程剪贴板探测请求。因此，在配置中我注入了 my_paste 垫片，阻断了向 TTY 的查询，转而直接回读 Neovim 的匿名寄存器 "。当确实需要向编辑器粘贴本地数据时，直接利用宿主机终端原生快捷键（如 <C-v> 或 <C-S-v>），通过标准输入流（stdin）模拟普通字符键入完成写入。