Windows下基于node-pty与ConPTY的终端模拟器鼠标序列传输问题

问题 #

我正在开发一款基于node-pty的JavaScript终端模拟器，目前在Windows环境下测试。测试时通过PowerShell运行MidnightCommander，但遇到了无法向终端发送鼠标控制序列的问题。我的pty构造函数代码如下：

var ptyProcess = pty.spawn('powershell.exe', [], {
name: 'ms-terminal',
cols: 120,
rows: 40,
cwd: "E:/cwd",
env: process.env,
useConpty: true
});

我尝试发送格式为\x1b[<0;x;yM的鼠标点击事件序列，但没有任何效果。当关闭ConPTY（设置useConpty: false）时，该序列能正常工作，但我希望保留ConPTY的使用。我还尝试通过发送序列ptyProcess.write("\x1b[?1003h\x1b[?1015h\x1b[?1002h\x1b[?1006h")开启鼠标事件报告，但也无济于事。请问是否使用了与ConPTY不兼容的序列？如何在使用ConPTY的情况下向终端发送鼠标数据？除了MidnightCommander还有其他测试方式吗？

解答 #

1. 序列兼容性问题 #

你用的\x1b[<0;x;yM是xterm的SGR鼠标协议序列，ConPTY对这类扩展协议的处理和传统PTY有差异。另外你设置的终端名称ms-terminal可能不被MidnightCommander识别，导致它忽略鼠标事件；同时你开启的鼠标模式组合里，部分选项可能不是ConPTY或MidnightCommander需要的，反而干扰了正常识别。

2. ConPTY下发送鼠标数据的解决方法 #

• 修正TERM环境变量：在pty配置里把TERM设为xterm-256color，让子进程认为终端支持SGR鼠标协议，同时把name也改成对应值：

var ptyProcess = pty.spawn('powershell.exe', [], {
name: 'xterm-256color',
cols: 120,
rows: 40,
cwd: "E:/cwd",
env: { ...process.env, TERM: 'xterm-256color' },
useConpty: true
});

• 调整鼠标模式开启序列：去掉冗余的?1003h和?1015h，只保留\x1b[?1002h\x1b[?1006h（启用鼠标按钮事件+SGR模式），并且要等MidnightCommander完全启动后再发送这个序列——可以监听ptyProcess的data事件，看到MC的界面输出后再执行写入操作。
• 尝试旧版X10鼠标协议：如果SGR协议还是无效，试试X10格式的序列\x1b[M<btn><x><y>，其中<btn>是按钮编码（比如左键是\x00），<x>和<y>是坐标值（需要加1，比如屏幕坐标(0,0)对应\x01\x01），ConPTY对旧协议的兼容性通常更好。

3. 其他测试方式 #

• 用Vim测试：在PowerShell里启动Vim，输入:set mouse=a启用鼠标支持，然后发送鼠标序列，看光标是否能跳转到对应位置，或者点击能否选中内容。
• 写简单的监听脚本：用Node.js写个脚本直接打印接收到的终端序列，验证ConPTY是否正确传递了鼠标数据：

// mouse-test.js
process.stdin.setRawMode(true);
process.stdin.on('data', buf => {
  console.log(`接收到的序列：${JSON.stringify(buf.toString())}`);
});

运行node mouse-test.js后发送鼠标序列，看控制台是否输出对应的控制字符，就能判断问题出在序列传递还是应用识别上。

内容的提问来源于stack exchange，提问作者René Beneš