psmux 鼠标操作全指南：点击聚焦、拖拽分屏、滚轮回滚，3 层鼠标注入技术揭秘

psmux 鼠标操作全指南点击聚焦、拖拽分屏、滚轮回滚3 层鼠标注入技术揭秘【免费下载链接】psmuxTmux on Windows Powershell - tmux for PowerShell, Windows Terminal, cmd.exe. Includes psmux, pmux, and tmux commands. This is native High-Performance Tmux designed for Windows in Rust 项目地址: https://gitcode.com/gh_mirrors/ps/psmux️ psmux 是 Windows 原生的终端复用器tmux for Windows完全由 Rust 编写。它的psmux 鼠标操作开箱即用单击分屏即可聚焦、拖拽边框调整布局、滚轮回卷历史输出、拖拽选中文本自动进剪贴板——全部基于 3 层鼠标注入技术实现无需 WSL。本文是一份面向新手的 psmux 鼠标使用与原理完整指南。快速上手启用鼠标支持的 3 个步骤鼠标支持默认开启只需完成以下三步安装 psmuxPowerShell 中执行winget install psmux也支持 cargo / scoop / choco打开 psmux输入psmux或tmux、pmux别名进入直接动鼠标无需任何配置点击、拖拽、滚轮即刻生效 psmux 可直接读取你的.tmux.conftmux 老用户的配置零成本迁移鼠标行为保持一致。鼠标基础操作速查点击聚焦与拖拽分屏当mouse on默认状态时以下操作全部开箱即用鼠标动作行为左键单击分屏聚焦该分屏输入直达对应 shell左键拖动分屏边框交互式调整分屏大小左键点击状态栏标签切换到对应窗口滚轮上滚/下滚回卷该分屏输出可配置是否进入 copy mode左键拖拽选择松开左键自动复制到 Windows 剪贴板右键单击粘贴剪贴板内容细节要点拖拽自动滚屏选中文本拖到分屏顶行/底行会自动向滚回区域继续选择指针移出分屏后滚动还会加速——超过一屏的内容可以一口气选中多选语义开启pwsh-mouse-selection on后双击选词、三击选行与 tmux 的释放即复制行为完全对齐完全关闭set -g mouse off可一键抑制所有鼠标事件处理完整按键与鼠标绑定说明见 docs/keybindings.md。滚轮回卷与拖拽复制像 tmux 一样回看历史psmux 的滚轮回卷有两种触发方式滚轮直接滚动在任意分屏滚轮上滚查看该分屏的输出历史进入 copy modescroll-enter-copy-mode默认on在命令提示符处滚动即进入 vim 风格的复制模式边框变黄、标题显示[copy mode]支持v/V/Ctrlv视觉选择与/搜索在 copy mode 中鼠标拖拽选择文本、松开左键自动写入剪贴板并返回实时视图分屏首行/末行按住不动每 50ms 自动滚动一行整页长输出一次手势即可选中复制。若把scroll-enter-copy-mode设为off滚轮事件则直接转发给分屏内运行的应用适合 nvim、TUI 程序自行处理滚动。核心揭秘3 层鼠标注入技术是如何工作的这是 psmux 鼠标体验的关键差异化设计。你的每一次点击都经过三层通道递进投递VT 协议层标准的 SGR 鼠标报告ESC [ ...序列直接喂给分屏里主动请求了鼠标事件的程序——vim、htop、midnight commander 等 TUI 应用由此获得完整鼠标体验VT 桥接层面向 WSL、SSH 这类程序运行在伪终端里再转 VT 字节的场景鼠标报告以 Win32 记录写入后由桥接端还原保证跨平台客户端的鼠标不丢失原生 Win32 MOUSE_EVENT 层通过WriteConsoleInputW直接把鼠标事件记录写入分屏的控制台输入缓冲绕过 VT 解析器——crossterm、ratatui、Bubble Tea 等直接读INPUT_RECORD的程序靠这一层拿到点击、拖拽与滚轮三层协同保证了同一个鼠标动作无论分屏里跑的是什么程序都能以它听得懂的语言收到。核心实现位于 src/input.rs 与 src/ssh_input.rs架构全貌可参考 docs/architecture.md。投递规则很克制只有主动请求过鼠标的应用才会收到事件——没有请求鼠标的全屏程序不会收到报告否则会被当成键盘乱码读入。这正是 psmux 与粗暴注入式方案的本质区别。进阶场景SSH 与 WSL 下的鼠标跨平台 SSH 到 Windows 时鼠标依然可用规则如下客户端 → 服务器鼠标支持方式任意系统 → Windows 11 build 22523✅普通ssh即可macOS/Linux → Windows 10✅使用客户端包装脚本本地 Windows 10/11✅直接运行 psmuxWindows 1122523标准 SSH 伪终端即支持鼠标Windows 10 客户端使用官方包装脚本 scripts/psmux-ssh.sh本地开启 xterm SGR 鼠标报告后经ssh -T直传绕过 ConPTY 的字节吞没问题例外开关若点击会闪退会话个别老旧 conhost保持默认门控即可反之在能处理鼠标的低版本主机上可设$env:PSMUX_FORCE_MOUSE 1恢复鼠标完整兼容矩阵与原理见 docs/mouse-ssh.md。鼠标相关配置项清单选项默认作用mouseon是否接收并处理鼠标事件scroll-enter-copy-modeon滚轮滚动时进入 copy modeoff则滚轮事件直转发给应用mouse-selectiononpsmux 客户端侧拖拽选择off让 nvim 等应用自行处理选择mouse-selection-forceoff在请求了鼠标跟踪的应用中仍保留 psmux 拖拽复制pwsh-mouse-selectionoff启用 tmux 式释放即复制 双击选词/三击选行典型配置示例# 关闭进入 copy mode 的滚动让应用自己处理滚轮 set -g scroll-enter-copy-mode off # 让 nvim / opencode 等应用自行处理鼠标选择 set -g mouse-selection off # 启用 tmux 风格的选择与释放复制 set -g pwsh-mouse-selection on全部可配置项与更多用法参见 docs/configuration.md功能总览见 docs/features.md。常见问题排查Q1SSH/WezTerm 下鼠标完全没反应低版本系统Windows 10 时代出于防崩溃门控默认禁用了 VT 输入通道的鼠标。确认主机确能处理鼠标后attach 前设置$env:PSMUX_FORCE_MOUSE 1即可恢复若点击会杀掉会话说明该主机正是门控要保护的对象请保持默认。Q2滚轮变成了方向键上蹿下跳这是终端丢失鼠标注册后回退到备用滚动的典型症状。psmux 3.3.9 起已每 30 秒自动重新断言鼠标注册升级即可获得修复详见 issue #597 的处理。Q3在 nvim 里想自己拖选却被 psmux 截走了执行set -g mouse-selection off把拖拽选择权交还应用普通单击仍会正常转发给应用。Q4分屏里的应用收不到鼠标事件检查该应用是否请求了鼠标发送过鼠标 DECSET 序列或持有ENABLE_MOUSE_INPUT标志。个别应用如未注册任何通道的特殊 TUI可用set-option -p -t %N mouse-force on对该分屏单独豁免。总结psmux 的鼠标体验可以浓缩为一句话本地全通道原生支持SSH 跨平台依然可用投递规则严谨不乱码。无论你是从 tmux 迁移过来的老手还是第一次在 Windows 上碰终端复用器的新手点击聚焦、拖拽分屏、滚轮回卷这三件事在 psmux 里都不需要任何学习成本。建议配合 docs/keybindings.md 与 docs/mouse-ssh.md 作为日常速查。【免费下载链接】psmuxTmux on Windows Powershell - tmux for PowerShell, Windows Terminal, cmd.exe. Includes psmux, pmux, and tmux commands. This is native High-Performance Tmux designed for Windows in Rust 项目地址: https://gitcode.com/gh_mirrors/ps/psmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考