如何快速上手 boo:5 分钟完成安装并创建你的第一个持久化终端会话

原创2026-10-27 17:04:42341 阅读

如何快速上手 boo:5 分钟完成安装并创建你的第一个持久化终端会话

boo 是一款 GNU screen 风格的终端复用器(terminal multiplexer),基于 libghostty 构建、用 Zig 编写。它的核心能力是"会话持久化":你断开 SSH 或关闭终端窗口后,会话仍在后台继续运行;重新 attach 时,屏幕内容、滚动历史、光标和窗口标题都会原样恢复。如果你正在寻找比 GNU screen 更现代、比 tmux 更轻量的终端会话管理工具,本文带你在 5 分钟内装好 boo 并跑通第一个会话。🚀

一、什么是 boo?它和 GNU screen、tmux 有什么区别?

boo 的设计哲学与 GNU screen 一致:会话(session)+ 前缀键(Ctrl-A),无需学习复杂配置。但 boo 用 Ghostty 终端模拟器的核心(libghostty-vt)替换了 screen 那套陈旧多年的终端解析层,因此:

  • 重绘更忠实:SGR 颜色样式、光标位置、滚动区域、窗口标题、终端模式都能精确还原;
  • 后台也能应答终端查询:detach 状态下 TUI 程序不会卡死;
  • 对脚本和 AI Agent 友好:send / peek / wait 等原语可无终端(headless)驱动交互式程序。

架构上,boo 采用"客户端 + 守护进程"模型:你的终端通过 Unix socket 连接会话守护进程,后者持有 PTY 并维护终端状态。相关实现可参考 src/client.zig、src/daemon.zig、src/window.zig 与 src/protocol.zig。

二、boo 安装方法:3 种方式拿到 boo 命令

boo 支持 Linux 与 macOS(x86_64 / aarch64)。以下是三种安装方式,任选其一。🛠️

方式 1:运行官方安装脚本(推荐,最快)

克隆仓库后执行 install.sh,它会自动下载对应平台的预编译二进制并安装:

git clone https://gitcode.com/gh_mirrors/boo10/boo
cd boo
sh install.sh
  • 默认安装到 /usr/local/bin(不可写时回退到 ~/.local/bin);
  • 可用环境变量 BOO_VERSION 锁定版本,BOO_INSTALL_DIR 指定安装目录,详见 install.sh 头部注释;
  • 若目录不在 PATH 中,脚本会打印添加到 PATH 的具体命令,照做即可。

方式 2:从源码构建

需要 Zig 0.15.2,依赖会自动拉取并编译:

git clone https://gitcode.com/gh_mirrors/boo10/boo
cd boo
zig build          # 产物位于 zig-out/bin/boo

方式 3:使用 Nix

仓库自带 flake.nix:nix develop 可进入含正确 Zig 版本的开发环境,nix build 会构建出 ./result/bin/boo。

安装完成后验证:

boo version

三、创建你的第一个持久化终端会话:4 条命令跑通全流程

1️⃣ 新建会话并立即进入

boo new work

不指定命令时,会话运行你的 $SHELL。不加名字时,会话会自动以当前目录名命名。给会话取个好名字,后面操作会方便很多。

2️⃣ 按前缀键 detach,会话转入后台

在会话内按 Ctrl-A,松开后再按 d(即 C-a d),即可分离(detach)。此时你的终端回到普通 shell,但 work 会话里的程序(比如一个正在编译的 make)仍在后台运行。这就是"持久化"的关键一步。💪

3️⃣ 随时重新 attach,屏幕原样恢复

boo attach work      # 别名:boo at work 或 boo a work

重新连接时,屏幕、滚动回看、光标位置和窗口标题都会从终端状态精确重建——就像你从未离开过。会话名支持唯一前缀匹配,例如 boo at w 即可命中 work。

4️⃣ 列出与结束会话

boo ls               # 列出所有会话(名称、attach 状态、空闲时长、标题)
boo kill work        # 结束指定会话
boo kill --all       # 结束全部会话

常用命令速查表(完整列表见 README.md 的 Usage 一节):

命令 作用
boo new [name] 新建会话并 attach
boo new name -d -- cmd 后台创建并直接运行命令
boo attach name 重新连接会话
boo rename old new 重命名会话
boo ui 全屏会话管理器
boo help <command> 查看任意命令的详细帮助

所有命令的帮助文本集中定义在 src/help.zig,boo help --all 可一次性打印全部帮助页。

四、boo 快捷键速查表:只需记住 C-a 前缀

会话内的键位与 GNU screen 默认一致,前缀键为 Ctrl-A(源码中的按键映射见 src/keys.zig):

按键 作用
C-a d(或 C-a C-d) 分离会话(detach)
C-a l(或 C-a C-l) 重绘屏幕
C-a a 发送一个字面的 C-a

五、boo ui:全屏多会话管理器

多个会话时,用 boo ui(别名 i)一键接管:左侧边栏列出全部会话及窗口标题,右侧实时渲染当前聚焦会话。支持:

  • 鼠标操作:点击会话聚焦、点击 x 结束、滚轮翻历史;
  • 键位扩展:C-a c 新建、C-a k 结束、C-a r 重命名、C-a n / C-a p 切换上/下一个会话、C-a s 隐藏侧栏;
  • 状态标记:● 表示你不在时响过铃,• 表示有未读输出,* 表示被其他客户端 attach。

完整键位说明见 src/help.zig。

六、进阶:用脚本驱动你的终端会话

除了 attach,boo 的所有命令都可以在没有终端的情况下运行,这让 boo 成为脚本和 AI Agent 的天然沙箱。官方推荐的标准循环(见 README.md Automation 一节):

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. 清理
  • send 按字面发送文本,无转义、无隐式换行,引号地狱不再存在;
  • wait --text / --idle 取代"sleep + 轮询",还能用 --timeout 2m 防止死等;
  • peek --json 输出机器可读的屏幕状态(尺寸、光标、标题、内容);
  • 退出码语义化:3 表示会话不存在,4 表示等待超时,方便脚本分支。

端到端行为可参考集成测试 test/integration.zig。

七、常见问题与注意事项

  • 一个会话同时只能有一个 attach 客户端:新的 attach 会"礼貌地抢走"(steal)旧客户端,不支持多人共享;
  • 一个会话一个窗口:没有窗口分割或页签,建议"一个任务一个会话",用 boo ui 调度;
  • 前缀键 C-a 暂不可配置,粘贴内容中的 0x01 字节会被解释为前缀(GNU screen 同样如此,boo ui 因括号粘贴机制不受影响);
  • 会话统一以 TERM=xterm-256color 运行;
  • 调试时可设置 BOO_LOG 环境变量记录守护进程日志。

以上限制详见 README.md 的 Caveats 一节。boo 目前是个年轻项目,定位是"现代版 GNU screen",而非 GNU screen 的直接替代。

总结:3 句话回顾

  1. 安装:git clone 后执行 sh install.sh,或使用 zig build 从源码构建;
  2. 持久化:boo new work 建会话 → C-a d 分离 → boo attach work 随时找回,屏幕原样恢复;
  3. 管理:boo ls 查看、boo ui 全屏调度、boo kill 清理,脚本场景再用 send / wait / peek 三件套。

从 boo new 到 detach / attach,整个流程不超过 5 分钟。会话" haunting "你的终端——这正是 boo 的口号。✨

登录后查看全文
boo