DECRQTSR / DECRSTS —— 请求 / 还原终端状态报告
保存（CSI Ps$u → DCS 回）与还原（DCS Ps$p…ST）整套 DEC 终端状态 —— dcs-decrsps 只覆盖陈现状态时的终端全态补遗。
字节形式
涵盖所有常见的字符串字面量写法，方便正反查找。
\x1b[Ps$u request \x1bP<Ps>$p<body>\x1b\\ restore\033[Ps$u request \033P<Ps>$p<body>\033\\ restore\e[Ps$u request \eP<Ps>$p<body>\e\\ restoreESC [ <Ps> $ u / ESC P <Ps> $ p <body> ESC \\1b 5b … 24 75 / 1b 50 <Ps> 24 70 <body> 1b 5c说明
DECRQTSR（*请求终端状态报告*，\x1b[<Ps>$u）与逆元 DECRSTS（*还原终端状态*，\x1bP<Ps>$p<body>\x1b\\）框出 DEC 把*整台终端*可变状态快照成不透明字节流，并稍后忠实回灌的机制。它们是 dcs-decrsps / dcs-decrqss（只覆盖*陈现*片段：光标、SGR、字符集、原点、制表位）的终端全态对偶。
请求 —— \x1b[<Ps>$u。Ps=1（唯一通用值）选 DEC 终端状态。部分 VT 系列文档为 Ps=2 保留色表状态，但无实际模拟器把 Ps=2 与 Ps=1 区别实现 —— 视 1 为唯一可移植选择子。
回复（DECTSR） —— \x1bP<Ps>$s<body>\x1b\\。$s 中间-末字节把 DECTSR 与 DECRSTS *还原*形（$p）以及 DECRPSS（$r）区分开。<body> 对主机不透明 —— 是 DEC 私有的状态序列化，包含：制表位、字符集状态（G0/G1/G2/G3 指示符 + GL/GR + UPSS）、所有模式状态（DECCKM / DECANM / DECCOLM / DECSCLM / DECSCNM / DECOM / DECAWM / DECARM / DECTCEM / DECNRCM / DECSCA / DECNKM / DECSCUSR / DECSDM / DECSLRM）、打印机状态、键盘模式状态、当前 SGR 笔、光标位置 + 保存栈、保护区状态。主机不得解析主体 —— 语义保留给原发模拟器。
还原 —— \x1bP<Ps>$p<body>\x1b\\。把同一 <body> 原样回送。终端校验 <Ps> 与保存时一致（不一致时回复模拟器静默回 \x1bP0$r\x1b\\，其他模拟器视为空操作）。跨终端还原（在 xterm 保存、到 Konsole 还原）不可移植 —— 主体格式是 DEC 实现自定义，各家自有编码。
往返模式（TUI 接管 + 还原）：
```
启动：
发 '\x1b[1$u' # DECRQTSR Ps=1
读 DCS 直至 ST # 回 '\x1bP1$s<body>\x1b\\'
保存 body
退出：
发 '\x1bP1$p' + body + '\x1b\\'
```
现代现实：多数 TUI 用 alt-screen（\x1b[?1049h/l）+ DECSC/DECRC 处理光标/SGR。DECRQTSR/DECRSTS 是 终端全态版本，仅在 alt-screen 不可用时（部分 BBS / 串口多路场景）或需要往返 DECSTR 不触碰的模式（NRCS、UPSS、DECSCA）时用。
边界
- 回复默认以 \x1b\\（ST 表为 ESC + 反斜杠）结束；xterm 在 8 位 C1 模式（decscl-compat-level）下使用单字节 \x9c —— 解析器需对两种终止都就绪。
- 主体字节可包含 \x1b 后跟除 \\ 外任意字节（DEC 把内嵌控制用 DECDLD 风格的十六进制转义编入）；天真的「按 ESC 分割」解析器会错框 —— 读至包边界处见 ST，而非首个 ESC。
- 部分模拟器（Linux console）回空主体 —— 还原成空操作。
- DECSTR（软重置）不会清掉主机持有的快照，只重置在用终端状态。
覆盖度 —— xterm = 完整（标准；主体长度通常 100–200 字节）。mlterm = 完整。WezTerm = 部分（回最小主体，还原接受但仅还原 SGR + 光标 + 制表位 —— DECSTR 会重置的模式会被重套，其余静默丢）。Konsole + gnome-terminal = 部分（回缺 UPSS / DECSCA 字段，还原同样截断）。Kitty + iTerm2 + Alacritty + Ghostty + Windows Terminal + cmd / ConPTY + macOS Terminal + Linux console = 无作用（完全不回 —— 这些场景请改用 alt-screen + cursor-save-restore + dcs-decrqss 做往返）。
规范出处: DEC VT510 RM (DECRQTSR / DECTSR / DECRSTS) / xterm-ctlseqs (CSI Ps $ u)
参数
| Ps = 1 | DEC 终端状态。唯一通用值。 |
| Ps = 2 | 保留（部分规范用于色表）；无现役模拟器与 Ps=1 区别实现。 |
| Reply $s vs Restore $p | DCS 中间-末字节 $s = 报告（终端 → 主机）；$p = 还原（主机 → 终端）。勿混。 |
| <body> | DEC 私有不透明序列化。原样往返。格式因模拟器而异 —— 不可跨终端搬运。 |
示例
# Capture full terminal state, then restore on exit (xterm).\nprintf '\\033[1$u'\nIFS= read -rs -d '\\\\' -t 0.2 snapshot </dev/tty 2>/dev/null\n# ... session runs, mutates modes ...\n# Restore: re-emit the body in DECRSTS shape.\nbody=\"${snapshot#*\\\$s}\"\nbody=\"${body%\\\\}\"\nprintf '\\033P1$p%s\\033\\\\' \"$body\"import sys, re\n# Save snapshot, then later push it back.\nsys.stdout.write('\\x1b[1$u'); sys.stdout.flush()\nreply = sys.stdin.buffer.read1(4096)\nm = re.search(rb'\\x1bP1\\$s(.*?)\\x1b\\\\', reply, re.DOTALL)\nbody = m.group(1) if m else b''\n# ... TUI session ...\nsys.stdout.flush()\nsys.stdout.buffer.write(b'\\x1bP1$p' + body + b'\\x1b\\\\')// Skeleton: probe, read until ST, persist body for the duration of the run.\nfmt.Print(\"\\x1b[1$u\")\nvar buf [4096]byte\nn, _ := os.Stdin.Read(buf[:])\n// Match \\x1bP1$s<body>\\x1b\\\\.\nbody := extractDECTSR(buf[:n])\n// ...\nfmt.Printf(\"\\x1bP1$p%s\\x1b\\\\\", body)// Snapshot at startup, restore on exit handler.\nprocess.stdout.write('\\x1b[1$u');\nlet snapshot = '';\nprocess.stdin.once('data', (buf) => {\n const m = /\\x1bP1\\$s(.*?)\\x1b\\\\/s.exec(buf.toString('binary'));\n if (m) snapshot = m[1];\n});\nprocess.on('exit', () => {\n if (snapshot) process.stdout.write('\\x1bP1$p' + snapshot + '\\x1b\\\\');\n});/* Skeleton: snapshot at TUI entry, restore at exit. */\nfputs(\"\\x1b[1$u\", stdout); fflush(stdout);\n/* read until ST seen at packet boundary, store body bytes opaquely. */\n/* on exit: fputs(\"\\x1bP1$p\", stdout); fwrite(body, 1, body_len, stdout); fputs(\"\\x1b\\\\\", stdout); */终端支持
- xterm
- 支持
- Linux console (fbcon)
- 不支持
- macOS Terminal.app
- 不支持
- iTerm2
- 不支持
- Windows Terminal
- 不支持
- cmd.exe / ConPTY
- 不支持
- kitty
- 不支持
- alacritty
- 不支持
- WezTerm
- 部分
- Ghostty
- 不支持
- GNOME Terminal
- 部分
- Konsole
- 部分
- tmux
- 支持
- GNU screen
- 支持
| xterm | Linux console (fbcon) | macOS Terminal.app | iTerm2 | Windows Terminal | cmd.exe / ConPTY | kitty | alacritty | WezTerm | Ghostty | GNOME Terminal | Konsole | tmux | GNU screen |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 | 部分 | 不支持 | 部分 | 部分 | 支持 | 支持 |
相关序列
在家族食谱中
DCS 食谱 · 3. 向终端提问 —— DECRQSS、terminfo cap、DECRQTSR、DECRQUPSS、光标样式