DECRPM 解码 —— 解析 DECRQM 回复（`CSI ? Ps ; Pm $ y`）

字节形式

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

说明

DECRPM —— Report Private Mode（私有式）或 Report Mode（ANSI 式）—— 是终端对 DECRQM 查询（私有模式 `CSI ? Ps $ p`、ANSI 模式 `CSI Ps $ p`，见 `decrqm`）的回复。回复回显被查询的 `Ps`，再加一个 `Pm` 值，其小型枚举精确表达终端对该模式的认识。 **`Pm` 取值**： - **`0`** —— *不识别该模式*。视为不支持。别再探测同一 `Ps`；按会话缓存为「不支持」。 - **`1`** —— *当前为「设置」*。等效于最近一次执行了 `\x1b[?<Ps>h`（ANSI 式则 `\x1b[<Ps>h`）。 - **`2`** —— *当前为「重置」*。等效于最近一次执行了 `\x1b[?<Ps>l`（ANSI 式则 `\x1b[<Ps>l`）。 - **`3`** —— *永久设置*。终端硬编码为开；发 `\x1b[?<Ps>l` 是空操作。 - **`4`** —— *永久重置*。终端硬编码为关；发 `\x1b[?<Ps>h` 是空操作。 回复中的 `?` 与请求中的 `?` 镜像 —— 查询私有模式（如 `?2004` 括号粘贴、`?1000` 鼠标）得 `\x1b[?2004;Pm$y`；查询 ANSI 模式（如 `4` IRM、`20` LNM）得 `\x1b[4;Pm$y`，*无* `?`。消费者必须按请求形态原样匹配 —— 交错探测私有 / ANSI 时回复会被错路由。 **推荐消费者模式**（Python 风伪码）： ``` def probe_mode(ps, private=True, timeout=0.1): prefix = '?' if private else '' sys.stdout.write(f'\x1b[{prefix}{ps}$p') sys.stdout.flush() reply = read_until_finalbyte('y', timeout) # CSI ... $ y m = re.match(rf'\x1b\[{re.escape(prefix)}(\d+);(\d+)\$y', reply or '') if not m or int(m.group(1)) != ps: return 'no-reply' return {0:'unknown', 1:'set', 2:'reset', 3:'permaset', 4:'permareset'}[int(m.group(2))] ``` **「永久设置 / 永久重置」的真实含义**：终端用 `Pm=3` / `Pm=4` 表达「该特性开 / 关且无法用转义码切换」。例如： - 一直常开括号粘贴的终端（部分用户通过 xterm X 资源配置）对 `?2004` 回 `Pm=3`。 - 旧 Linux console 对 `?1000`（鼠标追踪）回 `Pm=4`，因内核 `vt` 驱动从未实现。 - ConPTY 对多数 DEC 私有模式（如 `?9` X10 鼠标、`?1015` urxvt 鼠标）回 `Pm=4`，因 conhost 翻译层把它们写死为关。 读取目的下把 `Pm=3` / `Pm=4` 等同 `Pm=1` / `Pm=2` —— 模式确在该状态 —— 但别再发会被静默忽略的 h/l。 **厂商兼容性**： - **xterm**、**kitty**、**iTerm2**、**WezTerm**、**Ghostty**、**Konsole**：完全合规 —— 五种 `Pm` 都能正确返回。 - **Alacritty**：仅实现 `Pm ∈ {0, 1, 2}` —— 永不返回 `3` / `4`。依赖 permaset/permareset 分支的工具需把「缺失」视作「未知但可能支持」。 - **Linux console**（`vt`）：只对常见模式（`?1`、`?7`、`?25`）回；其余完全静默（无回复 —— 务必加超时）。 - **Windows Terminal**：1.20 起完全合规；早期构建会对部分实际支持的模式回 `Pm=0`。 - **cmd.exe / ConPTY**：受限 —— 多数探测即使被支持也回 `Pm=0`。 - **macOS Terminal**：部分实现；部分模式即便能 h/l 切换也回 `Pm=0` 而不是 `Pm=1` / `Pm=2`。在 macOS Terminal 上别信 DECRQM 做特性检测 —— 改用行为探测。 **DECRQM + DECRPM vs DECRQSS**（见 `dcs-decrqss`）：DECRQM 是*通用模式状态*查询 —— 开 / 关 / 永久开 / 永久关 / 未知。DECRQSS 返回可设置资源的真实*值*（SGR 栈、DECSCUSR 形状、DECSTBM 行列、DECSCL 一致性级别）。「括号粘贴开了吗」用 DECRQM；「当前光标是什么形状」用 DECRQSS。TUI 启动探测通常两者都发：DECRQM 发现能力，DECRQSS 快照资源以便退出时恢复。

规范出处: xterm-ctlseqs (DECRPM, CSI ? Ps ; Pm $ y / CSI Ps ; Pm $ y)

参数

示例

# Probe bracketed-paste; expect ?2004;1$y if on, ?2004;2$y if off.\nprintf '\\033[?2004$p'\nIFS= read -rs -d y -t 0.1 reply </dev/tty 2>/dev/null\necho \"DECRPM: ${reply#$'\\033'}y\"

import sys, re, termios, tty, select\n\ndef probe(ps, private=True, timeout=0.1):\n    prefix = '?' if private else ''\n    fd = sys.stdin.fileno(); old = termios.tcgetattr(fd)\n    try:\n        tty.setcbreak(fd)\n        sys.stdout.write(f'\\x1b[{prefix}{ps}$p'); sys.stdout.flush()\n        buf = ''\n        while True:\n            r,_,_ = select.select([fd], [], [], timeout)\n            if not r: break\n            buf += sys.stdin.read(1)\n            if buf.endswith('y'): break\n    finally:\n        termios.tcsetattr(fd, termios.TCSADRAIN, old)\n    m = re.match(rf'\\x1b\\[{re.escape(prefix)}(\\d+);(\\d+)\\$y', buf)\n    if not m or int(m.group(1)) != ps: return 'no-reply'\n    return ['unknown','set','reset','permaset','permareset'][int(m.group(2))]\n\nprint(probe(2004))

// After DECRQM probe, switch on the Pm enum.\nswitch pm {\ncase 0: cap[ps] = capUnknown      // not recognised\ncase 1: cap[ps] = capOn           // currently set\ncase 2: cap[ps] = capOff          // currently reset\ncase 3: cap[ps] = capHardwiredOn  // can't toggle off — skip restore\ncase 4: cap[ps] = capHardwiredOff // can't toggle on  — skip enable\n}

// Node parser — match DECRPM reply, return {ps, state}.\nfunction parseDECRPM(buf) {\n  const m = /\\x1b\\[(\\??)(\\d+);(\\d+)\\$y/.exec(buf);\n  if (!m) return null;\n  return {\n    private: m[1] === '?',\n    ps: Number(m[2]),\n    state: ['unknown','set','reset','permaset','permareset'][Number(m[3])] ?? 'invalid',\n  };\n}

/* Skeleton — emit DECRQM for ?1006 (SGR mouse), parse DECRPM Pm. */\nfprintf(stdout, \"\\x1b[?1006$p\"); fflush(stdout);\n/* read until 'y'; then sscanf buf, \"\\x1b[?%d;%d$y\", &ps, &pm) */\nint ps = 0, pm = 0;\n/* ...read loop... */\nif (ps == 1006) {\n    static const char *st[] = {\"unknown\",\"set\",\"reset\",\"permaset\",\"permareset\"};\n    printf(\"SGR mouse: %s\\n\", (pm>=0 && pm<=4) ? st[pm] : \"invalid\");\n}

终端支持

xterm

支持

Linux console (fbcon)

部分

macOS Terminal.app

部分

iTerm2

支持

Windows Terminal

支持

cmd.exe / ConPTY

部分

kitty

支持

alacritty

部分

WezTerm

支持

Ghostty

支持

GNOME Terminal

部分

Konsole

支持

tmux

不支持

GNU screen

不支持

相关序列

• DECRQM — 模式状态查询（CSI ? Ps $ p）
• DECRQSS — 请求选区或设置（DCS $ q ... ST）
• DSR — 设备状态报告（CSI 5n / CSI 6n）
• CSI ? Ps n — 私有 DSR（扩展状态查询）
• XTVERSION — 上报终端名称与版本（CSI > Pp q）