DECRQCRA / DECCKSR —— 请求矩形区域校验和（`CSI Pi;Pg;Pt;Pl;Pb;Pr*y`）

字节形式

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

说明

DECRQCRA（*请求矩形区域校验和*，\x1b[<Pi>;<Pg>;<Pt>;<Pl>;<Pb>;<Pr>*y）让终端对边框矩形内每个单元的字符 + 属性算一个 16 位校验和，以 4 位大写十六进制装进 DCS DECCKSR 帧回送：\x1bP<Pi>!~<HHHH>\x1b\\。

这是 xterm vttest 的一致性金标 —— 每个绘屏特性（DECCRA、DECFRA、DECERA、ED、EL、滚屏、行回绕、SGR 笔状态承接、alt-screen 切换）都靠「绘屏 → DECRQCRA → 断言校验和等于记录的金值」来验证。Konsole 的 tests/vt-tests、mlterm 的回归集、PowerShell ConPTY 的 TerminalEcho 测试都依赖它。

参数 - Pi —— 请求 ID（0–65535）。在回复的 !~<Pi> 槽位原样回传，便于流水线发出多请求时解复用。 - Pg —— 页号（1 起算；0 或省略按 1 处理）。现代模拟器几乎不暴露多页内存，故几乎总是 1。 - Pt;Pl;Pb;Pr —— 边框矩形（上、左、下、右；1 起算，含两端）。四项均必需；省略即整页。

校验算法 —— xterm 参考实现：从 0 起，按阅读顺序逐单元减去 cell_char_code + sgr_attr_bits（属性视为带标签的位域：bold = 0x80、underline = 0x40、blink = 0x20、reverse = 0x10 等）。结果对 0x10000 取模即为上报值。算法与 SGR 位映射在不同模拟器间不同 —— 永远不要跨模拟器实现比对校验和；只在「同模拟器同版本对金值」的语境下使用。

回复 —— \x1bP<Pi>!~<HHHH>\x1b\\。!~ 中间-末字节对把 DECCKSR 与其它 DCS 回（DECRQSS 的 $r、DECRPTAB 的 $u、DECRPSS 的 !u）区分开。<HHHH> 是 4 位前补零的大写十六进制。例：全白矩形在新启动的 xterm 上 → \x1bP0!~0000\x1b\\。例：在左上角发 printf '\x1b[31mABC\x1b[0m' 后探测第一格 → \x1bP0!~01A1\x1b\\（xterm 392；值随版本漂移，故金值与版本绑定）。

边界 - 坐标越页 → 静默裁剪（无错误回复）。 - 空矩形（Pt > Pb 或 Pl > Pr）→ 校验和回 0000。 - 部分模拟器（旧版 Konsole、某些 xterm 构建）对校验和取一的补码再上报 —— 只比对自家金值，别比对抽象公式。 - 回复默认以 \x1b\\（ST 表为 ESC + 反斜杠）结束；xterm 在 8 位 C1 模式（decscl-compat-level）下使用单字节 \x9c。

覆盖度 —— xterm = 完整（标准）。mlterm + Konsole + WezTerm = 完整。Ghostty = 部分（有回但校验和值在 SGR 属性变化时与 xterm 差 ≥ 1 位 —— 视为「有回复，算法不同」）。Kitty + iTerm2 = 部分（部分构建回，部分吞）。Alacritty / Linux console / Windows Terminal / cmd / ConPTY / macOS Terminal / gnome-terminal = 无作用（完全不回 —— 探测务必加 ~100 ms 超时）。

规范出处: DEC VT510 RM (DECRQCRA / DECCKSR) / xterm-ctlseqs (CSI Pi;Pg;Pt;Pl;Pb;Pr * y)

参数

示例

# Probe top-left cell on the main screen, parse the DCS reply.\nprintf '\\033[7;1;1;1;1;1*y'\nIFS= read -rs -d '\\\\' -t 0.1 reply </dev/tty 2>/dev/null\necho \"DECCKSR: ${reply}\"   # expect: \\x1bP7!~XXXX\\x1b

import sys, re\n# Parse a DECCKSR reply, extract Pi + hex checksum.\nreply = '\\x1bP42!~01A1\\x1b\\\\'\nm = re.search(r'\\x1bP(\\d+)!~([0-9A-F]{4})\\x1b\\\\', reply)\nif m:\n    pi, chk = int(m.group(1)), int(m.group(2), 16)\n    print(f'request {pi} checksum 0x{chk:04X}')

// Pipeline three checksum probes with distinct Pi.\nfor i, rect := range [][4]int{{1,1,1,1},{1,1,1,80},{1,1,24,80}} {\n    pi := i + 1\n    fmt.Printf(\"\\x1b[%d;1;%d;%d;%d;%d*y\", pi, rect[0], rect[1], rect[2], rect[3])\n}\n// Demux replies by !~<Pi> matching to issued Pi.

// vttest-style: paint, checksum, assert against golden.\nasync function checksum(rect) {\n  process.stdout.write(`\\x1b[1;1;${rect.t};${rect.l};${rect.b};${rect.r}*y`);\n  for await (const buf of process.stdin) {\n    const m = /\\x1bP1!~([0-9A-F]{4})\\x1b\\\\/.exec(buf.toString('binary'));\n    if (m) return parseInt(m[1], 16);\n  }\n}

/* Skeleton: emit probe, read until ST, parse Pi + 4 hex digits. */\nprintf(\"\\x1b[1;1;1;1;1;1*y\"); fflush(stdout);\n/* read until 0x1b 0x5c with 100ms select timeout, then sscanf(\"\\x1bP%d!~%4x\\x1b\\\\\", ...). */

终端支持

xterm

支持

Linux console (fbcon)

不支持

macOS Terminal.app

不支持

iTerm2

部分

Windows Terminal

不支持

cmd.exe / ConPTY

不支持

kitty

部分

alacritty

不支持

WezTerm

支持

Ghostty

部分

GNOME Terminal

不支持

Konsole

支持

tmux

支持

GNU screen

支持

相关序列

• DECCRA / DECFRA / DECERA / DECSERA —— 矩形区域的复制 / 填充 / 擦除 / 选择性擦除
• DECSACE —— 选择属性改写范围（`CSI Ps * x`）
• DECRQSS — 请求选区或设置（DCS $ q ... ST）
• DECTABSR —— 制表位报告（`CSI 2 $ w`）