drift 终端屏保 Shell 集成三大机制:zsh TMOUT 陷阱、bash PROMPT_COMMAND 定时器与 fish 事件函数全解析
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 事件函数三条完全不同的技术路线。本文带你逐一拆解这三大机制的工作原理、精妙细节与安装方式。
安装 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 最"冷门"的一对搭档:
TMOUT:zsh 原生变量,表示空闲多少秒后触发超时。但 zsh 的默认行为是——超时后直接退出 shell,这显然不能接受。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_schedule 是真正的定时器,里面藏着三个值得一提的工程细节:
set +m/set -m:临时关闭 job control 再启动( sleep … ; drift ) &子 shell。目的是让定时器进程脱离终端前台进程组,避免它抢占前台、干扰你的输入;ps -o stat= -p $$检查:sleep 结束后先确认自己还留在前台进程组(stat 含+),如果终端已被用户切到别的作业就安静退出,防止"幽灵进程"在后台乱跑;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 行 |
快速上手与验证清单
- 安装 drift:Homebrew 用户执行
brew install phlx0/drift/drift;Arch 用户yay -S drift-bin;也可以从源码构建(见 Makefile); - 写入集成:按上文对应 shell 把
eval "$(drift shell-init …)"加入 rc 文件,需要自定义等待时间时在前面设置DRIFT_TIMEOUT; - 重开终端:所有配置都需要新开的终端会话才生效;
- 验证生效:等待
DRIFT_TIMEOUT秒不动作,屏幕应自动进入屏保,按任意键回到提示符; - 排查不激活:确认 rc 文件里确实 source 了集成代码,且
DRIFT_TIMEOUT(zsh 下即TMOUT)已设置——这是 README.md 故障排查一节给出的标准检查项; - 浏览全部场景:
drift list scenes列出 14 个场景名,drift --showcase进入交互浏览模式(↑↓切场景、←→切主题、esc退出)。
写在最后
三种 shell、三套机制,却共同实现了同一件事:让"你停下来"这个瞬间被感知,然后 drift 接管屏幕。zsh 用内核级 TMOUT/TRAPALRM 做到零开销,bash 靠 PROMPT_COMMAND 重设闹钟循环,fish 则用最纯粹的事件函数优雅收尾。理解这三条路线,你不仅会用 drift,也顺带把三种 shell 的 hook 体系各学会了半成。剩下的,就是让终端自己漂一会儿吧——press any key to resume。


