告别 sleep 轮询:boo wait 命令如何让你的终端脚本又快又稳
告别 sleep 轮询:boo wait 命令如何让你的终端脚本又快又稳
boo 是一个构建在 libghostty 之上的 GNU screen 风格终端复用器(terminal multiplexer),用 Zig 编写。它的 wait 命令能让终端脚本告别 sleep 轮询:不再猜"等多久才够",而是精准等到屏幕出现指定文字、或输出安静下来为止,让自动化脚本又快又稳。
💤 sleep 轮询的困境:终端脚本为什么总差那么一秒
在传统终端自动化脚本里,"等待"通常是这样的:
screen -X -S build stuff 'make'
sleep 10 # 够吗?不够就失败,够了也浪费
screen -X hardcopy /tmp/out.txt
grep PASS /tmp/out.txt
这里有两个经典痛点:
| 痛点 | 后果 |
|---|---|
sleep 时间设短了 |
输出还没刷完,脚本读到残缺内容,竞态失败 |
sleep 时间设长了 |
每次运行白白等待,CI 里累积成浪费 |
更糟的是,用 hardcopy 之类方式读取的往往是原始字节流,可能混着转义序列、顺序混乱,脚本还得先"洗一遍"数据。而屏幕程序(TUI)的等待问题更典型:任务到底完成没?只有看屏幕才知道。
boo wait 就是为解决这个问题而生的。
🔍 什么是 boo:把"屏幕状态"变成可编程的接口
boo 的架构思路与 GNU screen 一脉相承:会话的全部输出先经过终端仿真核心解析,保存的是一份精确的屏幕状态——内容、样式、光标、滚动区、终端模式。
your terminal <-(raw tty)-> boo client <-(unix socket)-> session daemon
`- PTY + ghostty-vt Terminal
与老式 screen 不同,boo 把这层换成了 Ghostty 的 VT 核心(libghostty-vt),所以脚本读到的屏幕状态和你肉眼看到的一模一样。这为 wait 打下了基础:等待的目标不是模糊的字节流,而是"屏幕上到底显示了什么"。
会话管理保持 screen 的极简模型:Ctrl-A d 分离、boo attach 重连,全程无需复杂配置。
⚡ boo wait 快速上手:两条命令替代 sleep 循环
语法非常简单:
boo wait <name> (--text <text> | --idle) [--timeout <dur>]
两种模式二选一,语义清晰:
方式一:--text 等屏幕上出现指定文字
boo wait build --text 'PASS' --timeout 2m
命令会阻塞,直到渲染后的屏幕包含 PASS 这个子串,然后以退出码 0 结束。匹配的是纯子串,简单直接——就像你盯着屏幕看一样。
方式二:--idle 等输出安静下来
boo wait build --idle && boo peek build
--idle 在会话连续 2 秒没有新输出时触发(即输出"沉淀"后),特别适合"让长任务自己说完话"的场景:编译跑完了、命令执行完了,屏幕自然停更,脚本就该动了。
--timeout 兜底:脚本永远不挂死
--timeout <dur> 设置上限(默认 30s),到时仍未满足条件就以退出码 4 退出,而不是无限挂起。时长支持 500ms、2s、1m、4h、1d 等单位格式。这一条对 CI 至关重要:失败的会话不会拖垮整条流水线。
对比一下改进前后:
| sleep 轮询 | boo wait | |
|---|---|---|
| 等待精度 | 拍脑袋猜时间 | 屏幕文字出现 / 输出安静即返回 |
| 失败检测 | 读残缺输出,难分辨 | 超时退出码 4,语义明确 |
| 读取内容 | 原始字节流,需清洗 | 完整重绘的屏幕,干净稳定 |
| 脚本可读性 | 嵌套的 sleep + grep | 一行命令,意图自明 |
🚀 完整终端自动化流程:五步搞定
boo wait 是官方推荐的"标准自动化循环"的一环。除 attach 外,boo 的所有命令都不需要真实终端,天然适合脚本和 AI agent 驱动交互式程序:
boo new build -d -- bash # 1. 创建无头会话
boo send build --text 'make' --enter # 2. 输入命令
boo wait build --idle # 3. 等输出沉淀
boo peek build --scrollback # 4. 读取屏幕
boo kill build # 5. 清理
配合 --json 输出(boo ls --json、boo peek --json)即可获得机器可解析的结果,连 JSON 解析都替你做好了。
一个真实感的脚本片段长这样——在会话里跑测试并断言结果:
boo new test -d -- bash
boo send test --text './run_tests.sh' --enter
if boo wait test --text 'PASS' --timeout 5m; then
boo peek test --scrollback | tee test.log
else
echo "测试超时或未通过(exit $?)" >&2
exit 1
fi
boo kill test
对比传统写法里成串的 sleep,逻辑意图一目了然。
🛡️ 为什么 boo wait 更稳:匹配的是"人看到的屏幕"
wait --text 的匹配对象来自 peek 的屏幕重建:有顺序、完整重绘、状态稳定——而不是原始字节日志。这意味着即使会话在 detached 状态下,boo 也能用 libghostty 的终端状态回答终端查询,TUI 程序不会无人值守时挂住。
实现细节上,wait 每隔 50ms 检查一次状态:--text 走 peek screen 子串搜索,--idle 检查 daemon 上报的 out_idle_ms 是否达到 2 秒沉淀阈值(见 src/main.zig)。轮询发生在 boo 内部,脚本作者完全不用操心。
📊 退出码速查:让分支判断有据可依
boo 定义了清晰的退出码体系,脚本可以精确分支:
| 退出码 | 含义 |
|---|---|
0 |
成功 |
1 |
运行时错误 |
2 |
用法错误 |
3 |
会话不存在 |
4 |
wait 超时 |
boo wait deploy --text 'done' --timeout 10m
case $? in
0) echo "部署完成" ;;
4) echo "部署超时,需人工介入" ;;
3) echo "找不到 deploy 会话" ;;
*) echo "发生错误" ;;
esac
📥 快速安装与项目资料
Linux 与 macOS 可通过官方脚本一键安装(源码见 install.sh):
curl -fsSL https://raw.githubusercontent.com/coder/boo/main/install.sh | sh
也可设置 BOO_VERSION 锁定版本、BOO_INSTALL_DIR 指定安装位置。
核心资料索引:
- 项目总览与特性:README.md
wait命令完整实现:src/main.zigwait帮助页与 automation 指南:src/help.zig、src/help.zig- 会话 daemon(输出空闲时间上报):src/daemon.zig
- 屏幕状态窗口与协议:src/window.zig、src/protocol.zig
- 集成测试(真实 PTY 端到端验证):test/integration.zig
- 构建基准测试:bench/render.zig
想查看全部命令参数,随时运行 boo help wait 或 boo help automation。
✅ 小结
--text:等屏幕出现指定文字,精准到"你看到的"--idle:等输出安静 2 秒,让任务自己收尾--timeout:兜底防挂死,超时退出码4- 配合
send/peek --json/kill,组成无头会话的完整自动化闭环
如果你的终端脚本里还有 sleep 10 和 grep 原始输出的组合,不妨试试 boo 的 wait——让等待从"猜测"变成"条件",脚本自然又快又稳。🎯