drift 终端屏保 Shell 集成三大机制:zsh TMOUT 陷阱、bash PROMPT_COMMAND 定时器与 fish 事件函数全解析

原创2026-10-28 14:09:021,360 阅读

drift 终端屏保 Shell 集成三大机制:zsh TMOUT 陷阱、bash PROMPT_COMMAND 定时器与 fish 事件函数全解析

drift 是一款闲置时自动启动的终端屏保(terminal screensaver),内置 14 种 ASCII 场景与 9 套主题,按任意键即可恢复终端。它要成为"真正的屏保",关键靠 Shell 集成:由 shell 检测闲置并在超时后自动拉起 drift。drift 官方为 zsh、bash、fish 三家各写了一套触发脚本,分别踩中了 TMOUT 陷阱、PROMPT_COMMAND 定时器、fish 事件函数三条完全不同的技术路线。本文带你逐一拆解这三大机制的工作原理、精妙细节与安装方式。

drift 终端屏保 waveform 波纹场景演示

安装 Shell 集成:一条命令搞定

无论使用哪种 shell,集成入口都是同一个命令 drift shell-init,它会把对应 shell 的触发脚本打印出来,再由你的 rc 文件 source 执行:

# Zsh — 写入 ~/.zshrc
eval "$(drift shell-init zsh)"

# Bash — 写入 ~/.bashrc
eval "$(drift shell-init bash)"

# Fish — 写入 ~/.config/fish/conf.d/drift.fish
drift shell-init fish | source

三种脚本全部集中定义在 shell_snippets.go 中,由 root.go 里的 shellInitCmd 命令按参数分发;shell_snippets_test.go 则保证每个 shell 输出中都包含预期的机制关键字(TMOUT、PROMPT_COMMAND、fish_prompt)。

所有 shell 共用一个可调变量:DRIFT_TIMEOUT,单位为秒,默认 120。建议先设置再 source,例如 export DRIFT_TIMEOUT=60(fish 中写作 set -x DRIFT_TIMEOUT 60)。

zsh 机制:TMOUT + TRAPALRM 的经典"陷阱"

zsh 脚本只有 30 行左右,却用上了 zsh 最"冷门"的一对搭档:

  1. TMOUT:zsh 原生变量,表示空闲多少秒后触发超时。但 zsh 的默认行为是——超时后直接退出 shell,这显然不能接受。
  2. TRAPALRM:定义了这个函数后,zsh 超时时不再退出,而是转而调用它,从而把"危险信号"变成"唤醒屏保"的契机。

zsh 脚本(shell_snippets.go 中的 zshSnippet)核心逻辑:

TMOUT="${DRIFT_TIMEOUT:-120}"

TRAPALRM() {
  _drift_activate
}

这里有两个关键细节:

  • 防误触发守卫:_drift_activate 开头会检查 ZLE_STATE 相关状态——只有 shell 正停在提示符等待输入(即真正闲置)时才启动 drift,避免在别的场景误弹屏保;
  • 防重入:用 DRIFT_RUNNING 环境变量做互斥锁,屏保运行期间即使 TMOUT 计时器再次触发(zsh 在 trap 返回后会重新计时)也不会重复启动;DRIFT_ENABLED 则提供总开关,unset DRIFT_ENABLED 即可一键禁用。

这套方案的优势是零后台进程:计时完全由 zsh 内核完成,不额外 fork 任何子进程,开销几乎为零。

bash 机制:PROMPT_COMMAND 驱动的背景定时器

bash 没有 zsh 那样的空闲超时变量,drift 的对策是利用 PROMPT_COMMAND:它在每次绘制新提示符前执行。脚本由此实现了一个"每次提示符刷新就重设闹钟"的循环:

_drift_prompt() {
  _drift_cancel    # 先杀掉上一轮还没响的定时器
  _drift_schedule  # 再启动一个新的 sleep $DRIFT_TIMEOUT 子进程
}

drift 终端屏保 starfield 星空场景演示

_drift_schedule 是真正的定时器,里面藏着三个值得一提的工程细节:

  1. set +m / set -m:临时关闭 job control 再启动 ( sleep … ; drift ) & 子 shell。目的是让定时器进程脱离终端前台进程组,避免它抢占前台、干扰你的输入;
  2. ps -o stat= -p $$ 检查:sleep 结束后先确认自己还留在前台进程组(stat 含 +),如果终端已被用户切到别的作业就安静退出,防止"幽灵进程"在后台乱跑;
  3. disown:把定时器从 shell 的作业表中摘除,shell 退出时不会提示"有后台作业"。

同时脚本在注册 hook 时做了兼容性处理:若你已设置了自己的 PROMPT_COMMAND,drift 只把 _drift_prompt 前插到最前面(PROMPT_COMMAND="_drift_prompt; ${PROMPT_COMMAND}"),不会覆盖原有逻辑。执行命令会立刻触发新提示符周期,旧定时器被 cancel,天然实现"一活动就取消"。

这套方案曾在早期版本导致终端卡死——CHANGELOG.md 记录过 "bash shell integration: terminal no longer freezes when drift activates" 的修复,现在已稳定。

fish 机制:fish_prompt 与 fish_preexec 事件函数

fish 的设计哲学是"一切皆事件",所以它的集成也最简洁:不用变量拼凑 hook,而是直接监听两个内建事件:

  • fish_prompt(新提示符绘制时触发 = 用户闲置中):取消旧定时器并启动新定时器;
  • fish_preexec(任何命令执行前触发 = 用户活跃):立即取消定时器。
function _drift_on_prompt --on-event fish_prompt
  _drift_cancel
  _drift_schedule
end

function _drift_on_preexec --on-event fish_preexec
  _drift_cancel
end

fish 的定时器是 fish -c "sleep $timeout; and …; and drift" &,即用 and 串接保证"睡满且 drift 命令存在"才启动;$last_pid 记录子进程号供 cancel 使用。与 bash 方案相比,它少了 set +m、ps 检查这类防御性代码——因为 fish 的事件模型已经把"何时闲置、何时活跃"这两件事说得很清楚,不需要额外的进程组技巧。

三大机制对比速查表

维度 zsh bash fish
核心机制 TMOUT + TRAPALRM PROMPT_COMMAND + 后台 sleep fish_prompt / fish_preexec 事件
计时实现 zsh 内核计时,零子进程 每轮提示符 fork 一个子 shell 每轮提示符 fork 一个 fish -c 子进程
防重入 DRIFT_RUNNING / DRIFT_ENABLED 新定时器自动 kill 旧定时器 新定时器自动 kill 旧定时器
特殊技巧 用 trap 拦截超时退出 set +m + disown + 前台组检查 纯事件驱动,最简洁
可禁用方式 unset DRIFT_ENABLED 取消 source 或注释 rc 行 取消 source 或注释 rc 行

快速上手与验证清单

  1. 安装 drift:Homebrew 用户执行 brew install phlx0/drift/drift;Arch 用户 yay -S drift-bin;也可以从源码构建(见 Makefile);
  2. 写入集成:按上文对应 shell 把 eval "$(drift shell-init …)" 加入 rc 文件,需要自定义等待时间时在前面设置 DRIFT_TIMEOUT;
  3. 重开终端:所有配置都需要新开的终端会话才生效;
  4. 验证生效:等待 DRIFT_TIMEOUT 秒不动作,屏幕应自动进入屏保,按任意键回到提示符;
  5. 排查不激活:确认 rc 文件里确实 source 了集成代码,且 DRIFT_TIMEOUT(zsh 下即 TMOUT)已设置——这是 README.md 故障排查一节给出的标准检查项;
  6. 浏览全部场景:drift list scenes 列出 14 个场景名,drift --showcase 进入交互浏览模式(↑↓ 切场景、←→ 切主题、esc 退出)。

drift 终端屏保 boids 鸟群模拟场景演示

写在最后

三种 shell、三套机制,却共同实现了同一件事:让"你停下来"这个瞬间被感知,然后 drift 接管屏幕。zsh 用内核级 TMOUT/TRAPALRM 做到零开销,bash 靠 PROMPT_COMMAND 重设闹钟循环,fish 则用最纯粹的事件函数优雅收尾。理解这三条路线,你不仅会用 drift,也顺带把三种 shell 的 hook 体系各学会了半成。剩下的,就是让终端自己漂一会儿吧——press any key to resume。

登录后查看全文
drift