OSC 4 — 设置调色板颜色（与查询）

在哪里用到

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

• pywal (`wal -i image.jpg`)—pywal 从图片提取 16 色调色板，再用 `\x1b]4;<n>;rgb:rr/gg/bb\x07` 在所有已打开终端里扫过槽位 0–15 —— 跑一次 `wal` 让 tmux、vim、ranger、裸 shell 同时换色
• base16-shell, base16-fzf live theme switch—`base16_<theme>` source 一个 shell 脚本，依次发 16 条 OSC 4 转义 —— `base16_solarized-dark` → `base16_gruvbox-light` 切换无需重启 shell，所有可见的彩色输出立即重绘
• xtermcontrol --get-color / --color<n>—`xtermcontrol` 是 OSC 4 的标准可脚本化接口 —— `xtermcontrol --get-color1` 用 `\x1b]4;1;?\x07` 查询当前红色槽位，`--color1 '#ff5555'` 写入
• alacritty, kitty, WezTerm runtime colour reload—三款现代终端都支持 OSC 4 —— 既覆盖标准 16 个 ANSI 槽，也覆盖扩展的 256 色方块；`wezterm cli set-cwd` 类命令可即时重绘，无需 SIGUSR1 重载配置
• tmux `set -g terminal-overrides` palette passthrough—tmux 默认剥离 OSC；设 `terminal-overrides 'xterm*:RGB'` 和 `allow-passthrough on` 后，内层窗格里的 pywal 可以重绘外层终端 —— `base16_*` 在 tmux 内行为像没有复用器

常见问题

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

为什么 \x1b]4;<n>;rgb: 对屏幕上已有的文本不生效？

终端行为分两类。xterm 与 kitty 在调色板索引变化时重绘整屏，已有字形立即翻新色。gnome-terminal（VTE）、iTerm2、alacritty、wezterm 只在后续绘制时用新调色板——缓冲区上已有的文本保留绘制时的颜色。如果在不自动重绘的终端上需要强制视觉切换，调色板切换后再发 \x1b[2J\x1b[H（清屏 + 光标回原点）触发整屏重绘。

如何只重置一个调色板索引而不重写全部 256 项？

用 OSC 104——\x1b]104;<n>\x07 把索引 <n> 重置为终端编译期默认值；\x1b]104\x07（无参数）一次性重置全部 256 项。xterm-ctlseqs 把这对作为 OSC 4 的标准反向操作——pywal、base16-shell、theme.sh 这类主题加载器退出时都发不带参数的 OSC 104，恢复用户的主题前调色板。