DCS Sixel — 内联栅格图像（ESC P q … ESC \）

在哪里用到

实际会发出该序列的工具——把抽象字节锚定到你已经用过的命令上。

• libsixel + `img2sixel` CLI—libsixel 是参考编码器 —— `img2sixel input.png | cat` 产生 `\x1bPq…\x1b\\` DCS 流，任何支持 sixel 的终端（xterm `+T --tn xterm-direct`、mlterm、foot、关闭 kitty-graphics 的 WezTerm）都能内联渲染。libsixel 通过动态链接为多数其他工具的 sixel 输出提供后端
• gnuplot `set terminal sixel`—gnuplot 5.4+ 支持 `set terminal sixel size 800,600` 在终端内联渲染图表 —— 在长跑的拟合过程中想瞥一眼生成的图，又不想开 X11 窗口或保存 PNG 时尤为有用
• ranger / mc image preview—ranger（配合 `img2sixel` 预览脚本）与 Midnight Commander 在支持 sixel 的终端右侧窗格内联渲染图像文件预览。可移植性优于 kitty-graphics —— sixel 在 xterm / mlterm / foot / WezTerm / Windows Terminal ≥ 1.22 / Black Box 上运行，比 kitty-graphics 的 kitty / WezTerm / Ghostty 三家更广
• matplotlib `mpl_sixel` backend—Python：`import matplotlib; matplotlib.use('module://mpl_sixel'); plt.plot([1,2,3]); plt.show()` 把图表作为 sixel 直接在无 Jupyter 的终端中渲染 —— 在 HPC 场景下 Jupyter 不可用、但仍在 shell 中做交互式数值工作时流行
• Black Box / Windows Terminal sixel preview—Black Box（基于 VTE 0.73+ 的 GNOME 终端模拟器）与 Windows Terminal 1.22+ 增加了原生 sixel 渲染 —— `cat photo.six` 内联显示。两者在 CI 中都附带 sixel 感知的测试图样以捕获回归；集成商把它们作为现代参考渲染器对标

相关误区

该序列在实践中常见的踩坑——每条链接到完整的症状、成因与修复。

• ⚠Sixel 图像像素宽度不能整齐对齐到终端单元宽度 —— 在字体 9 px 宽的终端上按 8 px/列 × 80 列发 640 px 图会溢出到下一行·#terminal-width-math
• ⚠Sixel 调色板用 DEC HLS (P;2;H;L;S) 百分比缩放值 —— 不是 0–255 RGB —— 把调色板量化到 256 槽的终端在照片上会丢失颜色保真·#truecolor-detect

常见问题

针对这条序列，开发者真正会去搜索的问题的简短回答。

一段 DCS Sixel 序列里终端能渲染的最大图像尺寸是多少？

规范未指定上限 —— Sixel 在单个 DCS 包络（\x1bPq … \x1b\\）内逐像素行组流式传输，上限取决于终端的像素缓冲分配。实务边界：xterm 用 decGraphicsMaxSize（默认 1000×1000），超出静默截断；mlterm / WezTerm / Konsole / foot 接受多兆像素图像，只受内存约束；Windows Terminal 1.22 起加入 Sixel，软上限约 10 MP。真正的瓶颈是性能而非规范 —— 4K 全屏图约 2 MB base-6 编码载荷，终端串行解码并阻塞输入循环。

为什么 tmux 内 Sixel 图像渲染成乱码，即使外层终端支持？

tmux 历史上剥离 DCS 载荷 —— Sixel 以 \x1bP…\x1b\\ 到达，tmux 解析器吃掉首尾，留下 base-6 主体作字面字符显示。两种修法：(1) set -g allow-passthrough on，并把每段 Sixel 包进 \x1bPtmux;<escaped>\x1b\\（tmux; 透传包络，内层 \x1b 双写成 \x1b\x1b）；(2) 从 tmux 3.4 起原生 Sixel 支持，可经 set -g sixel on 启用 —— 无需透传包络。3.4+ 用方案 2；老版本只能用方案 1。