DEC 定位器套件 —— DECELR / DECEFR / DECSLE / DECRQLP（鼠标 / 定位器事件）

字节形式

涵盖所有常见的字符串字面量写法，方便正反查找。

说明

DEC 定位器协议比 xterm 扩展鼠标模式早十年，是 VT300+ 硬件终端（以及软件模拟器在调到高 DECSCL 一致性级别 —— 见 decscl-compat-level —— 时）上报指点设备事件的方式。四个序列共同构成该族 —— 均以单引号（0x27）为中间字节：

- DECELR —— *启用定位器报告* —— \x1b[<Pn>;<Pu>'z - Pn：0 = 关闭定位器报告；1 = 启用；2 = 启用一次报告后自动关闭。 - Pu：0 或 2 = 坐标按字符单元；1 = 坐标按设备单位（像素）。 - 启用后，每次按键过 DECSLE 过滤都会发 DECLRP 报告；若 DECEFR 设了矩形，离开矩形时也发一份。

- DECSLE —— *选择定位器事件* —— \x1b[<Pm>'{ - Pm：0 = 仅显式 DECRQLP 才回；1 = 按下事件回；2 = 关闭按下事件回；3 = 抬起事件回；4 = 关闭抬起事件回。 - 可多次发不同 Pm 同时开按下 + 抬起：\x1b[1'{\x1b[3'{。

- DECEFR —— *启用过滤矩形* —— \x1b[<Pt>;<Pl>;<Pb>;<Pr>'w - 定义闭矩形：上行、左列、下行、右列。指点*离开*该矩形时触发一次 DECLRP，过滤器随即自动关闭。 - 用于只关心「鼠标离开我的控件」转换的光标追踪程序。

- DECRQLP —— *请求定位器位置* —— \x1b[<Ps>'| - Ps：事务数（目前总为 1）。 - 强制立刻发 DECLRP，与过滤 / 事件设置无关。

DECLRP —— 回复 —— \x1b[<Pe>;<Pb>;<Pr>;<Pc>;<Pp>&w（注意中间字节 &，与请求的 final 不同）： - Pe = 事件类型：0 = 定位器不可用、1 = DECRQLP 的回复、2 = 左键按下、3 = 左键抬起、4 = 中键按下、5 = 中键抬起、6 = 右键按下、7 = 右键抬起、8 = M4（第 4 键）按下、9 = M4 抬起、10 = 离开过滤矩形。 - Pb = 按键状态位掩码：1 = 左、2 = 中、4 = 右、8 = 第 4 键。可 OR。 - Pr、Pc = 行、列（1 起算），单位取自 DECELR 的 Pu。 - Pp = 页号（现代模拟器恒为 1 —— 多页是硬件终端概念）。

为何你几乎用不到：1980 年代写的若干 CAD、终端 GIS、radar / SCADA 程序仰赖此协议。某些 xterm 扩展（xterm*set-locator-events X 资源）仍允许启用。现代交互式 UI —— tmux、htop、mc、lazygit、fzf、neovim 的 :terminal —— 全部改用 SGR 鼠标模式（?1000 启用 + ?1006 SGR 编码；见 dec-mouse-tracking 与 sgr-mouse-encoding）：解析更简单、多字节坐标天然支持、跨模拟器覆盖近乎完美。

覆盖度：xterm = 完整实现（唯一广泛部署的）；gnome-terminal / konsole = 部分（DECRQLP 回合成的「无指点」DECLRP）；iTerm2 / kitty / wezterm / alacritty / ghostty / Windows Terminal / cmd / Linux console / macOS Terminal = 无 —— 序列被静默吞掉，不回。

仍可能用到的场景：专门面向旧 XFCE / CDE 上的 xterm；移植旧 SCADA 终端程序；测 terminfo 的 locator_* capabilities。否则直接用 SGR 鼠标模式。

规范出处: DEC VT510 RM (DECELR / DECEFR / DECSLE / DECRQLP / DECLRP) / xterm-ctlseqs

示例

# Enable locator reports (cell coords, one-shot), then query position.\nprintf \"\\033[2;0'z\"   # DECELR Pn=2 one-shot, Pu=0 cells\nprintf \"\\033[1'|\"     # DECRQLP — force immediate DECLRP reply\n# read reply matching: \\x1b[1;Pb;Pr;Pc;1&w

import sys\n# Set filter rectangle around rows 5-20, cols 10-60 then enable button-down events.\nsys.stdout.write(\"\\x1b[1;0'z\")        # DECELR enable, cells\nsys.stdout.write(\"\\x1b[5;10;20;60'w\") # DECEFR filter rect\nsys.stdout.write(\"\\x1b[1'{\")          # DECSLE enable button-down reports\nsys.stdout.flush()

// Disable locator reports (clean exit).\nfmt.Print(\"\\x1b[0;0'z\")

// Parse a DECLRP reply: \\x1b[Pe;Pb;Pr;Pc;Pp&w\nfunction parseDECLRP(buf) {\n  const m = /\\x1b\\[(\\d+);(\\d+);(\\d+);(\\d+);(\\d+)&w/.exec(buf);\n  if (!m) return null;\n  return { event: +m[1], buttons: +m[2], row: +m[3], col: +m[4], page: +m[5] };\n}

/* Force a single locator-position report (synchronous-ish probe). */\nprintf(\"\\x1b[1;0'z\");   /* DECELR enable, cells */\nprintf(\"\\x1b[1'|\");     /* DECRQLP */\nfflush(stdout);\n/* read reply: matches sscanf(\"\\x1b[%d;%d;%d;%d;%d&w\", &pe,&pb,&pr,&pc,&pp) */

终端支持

xterm

支持

Linux console (fbcon)

不支持

macOS Terminal.app

不支持

iTerm2

不支持

Windows Terminal

不支持

cmd.exe / ConPTY

不支持

kitty

不支持

alacritty

不支持

WezTerm

不支持

Ghostty

不支持

GNOME Terminal

部分

Konsole

部分

tmux

不支持

GNU screen

不支持

相关序列

• DECSET ?1000 / ?1006 — 鼠标跟踪
• SGR / urxvt 鼠标编码 — 鼠标上报的线缆格式（CSI M / CSI < / CSI）
• CSI ? Ps n — 私有 DSR（扩展状态查询）
• DECSCL — 选择一致性级别（`CSI Pl ; Pc " p`）