【免费下载链接】tty7The terminal that outlives its window. Shells survive quitting the app, agents can drive other agents, and remote machines work the same way. Pure Rust, GPU-rendered.项目地址https://gitcode.com/gh_mirrors/tty/tty7点击查看免费下载tty7 是一款纯 Rust、GPU 渲染的现代终端它的核心承诺是窗口死了终端不死。普通终端里关掉窗口等于杀掉所有 shell而 tty7 把 shell 交给一个后台守护进程daemon持有并为每个面板维护两级回放缓冲——内存中的 8 MiB 环形缓冲 磁盘上的 256 KiB 周期性快照。正因如此无论是误关窗口、进程崩溃、kill -9还是整台机器重启重新打开 tty7 后你都能看到崩溃前屏幕上的内容。本文带你深析这套回放缓冲与会话恢复机制的设计取舍。tty7 的架构基石窗口不拥有你的 shell理解崩溃后屏幕还能回来先要理解 tty7 的分层结构窗口Window只是 GUI 客户端负责显示和输入守护进程daemon后台服务器真正持有每个 pane 的 PTY 文件描述符Pane一个终端实例拥有稳定 id如%42这个 id 是 CLI 和恢复机制寻址的关键。关闭 tty7 窗口只是断开了一条 socket 连接守护进程继续存活你的构建继续跑、agent 继续工作、SSH 会话不断开。再次打开时客户端按 pane id 重新 attach看到的正是离开时的屏幕。这套守护进程拥有会话的模型也是远程机器上体验一致的原因架构说明详见官方文档docs/getting-started/concepts.mdx。第一级缓冲内存中的 8 MiB 回放环每个 pane 的输出字节都会进入守护进程内存里的一个环形缓冲区replay ring上限由 pane.rs 中的RING_CAP定义const RING_CAP: usize 8 * 1024 * 1024; // 8 MiB回放环按几何同构段Segment切分一段输出记录了它写入时的窗口尺寸cols/rows/字号重放时客户端按原始宽度解包字节不会把旧输出按当前宽度错误折行。窗口没死、只是断连的场景——比如手机连回来、CLI 重新 attach——全靠这块环。但环也有致命弱点它只活在守护进程自己的进程里。一次崩溃、kill -9或重启环和进程一起消失窗口回来时只剩一排空白 shell。这正是第二级缓冲登场的地方。第二级缓冲磁盘快照——只存 256 KiB每 30 秒一次磁盘快照的实现集中在 scrollback.rs设计思路写在了模块注释里值得细看定时而非逐字节写盘见 SNAPSHOT_INTERVAL每个 pty 字节都落盘会带来巨大的写放大只为换取崩溃前最后几秒的新鲜度不划算。写入器跑在一个 30 秒周期的线程tty7-scrollback上server.rs且跳过环形缓冲没变化的 pane——空闲机器零 IO忙碌的 pane 反而得到最新拷贝只存 256 KiBSNAPSHOT_CAP远小于 8 MiB 的内存环。滚动内容的价值随距离屏幕底部的距离陡降最后几屏就够用了从头部裁剪trim_to终端输出只能向前解释尾部独立成立、头部不行所以超限时永远吃掉最老的部分原子写 严格权限快照先写入临时文件再rename就位读者永远不会看到写一半的文件文件从创建起就是0600权限write_private——因为它可能包含你在 pane 里 echo 过的 token、env输出和 agent 对话记录绝不能让其他用户读走。文件格式以魔术数TTY7SB\x01\x00开头MAGIC每段记录写入时的窗口几何信息尾部可携带 pane 标题。解码是全有或全无截断文件、外部文件一律拒绝读取此时 pane 回落到空白屏——这正是模块出现之前的行为没有任何损失。快照存放在配置目录的scrollback/{pane_id}.bin通常在~/.config/tty7/scrollback/。恢复流程RestoreFrom 请求与消费一次语义守护进程崩溃后重新启动它本身不记得任何 pane——但磁盘快照记得。恢复由客户端发起打开一个顶替已死 pane的新 pane 时spawn 请求里携带一个RestoreFrom结构protocol.rspub struct RestoreFrom { pub pane_id: u64, // 顶替哪个死去的 pane pub banner: OptionString, // 画在旧屏幕与新 shell 之间的一行说明 }守护进程随后执行 restored_screen读取该 pane 的最后快照 → 丢弃文件forget→ 把字节流种进新 pane 的播放环。于是窗口显示出的就是崩溃前屏幕上那些输出滚动进 scrollback 一行横幅说明 一个明显是新的 shell。两个细节很有讲究横幅文案来自客户端而非守护进程因为守护进程没有 locale——它同时服务任意语言的 GUI 和永远说英文的 CLI快照只消费一次。恢复过一次、pane 又被关闭、再重新打开时就没有东西可恢复了。这是刻意设计按相关性保留而非按时间保留无人再会请求恢复的快照会由 sweep 定期清扫避免终端输出无限期留在磁盘上。反过来可预见的退出会写得更精确store_scrollback_now 在收到正常关闭通知时把每个 pane 的屏幕最后一写此时拷贝是精确的而非最多滞后 30 秒。而用户主动关闭的 pane 走 kill_pane快照直接删除——你亲手关掉的终端不值得留尸。崩溃之外的死亡execve 原地换芯与 Windows 的例外快照解决不了进程还活着但二进制要换的场景——升级。pty master 是本进程持有的文件描述符进程一换、描述符一关slave 端就收到SIGHUPpane 里的一切陪葬。tty7 的解法在 handoff.rs利用 Unix 的execve替换镜像而保留进程——同一个 pid、同一批子进程、同一批没有FD_CLOEXEC的打开描述符。于是 pty 保持打开shell 完全感知不到换芯只有描述符另一端的代码变了。交接清单Manifest记录每个 pane 的 master fd、子进程 pid、工作目录、OSC 标题、agent 状态以及环形缓冲的完整长度所有需要跨execve存活的描述符先解除 close-on-exec失败则整体回滚旧守护进程继续服务。三样东西过不去设计上也坦然处理过不去的东西处理方式原生 SSH pane加密状态在本进程内存里exec 前主动挂断远端看到的是干净断开客户端连接窗口持有的 socket 随旧镜像死亡客户端按原有路径重连、按 pane id 重挂Windows没有execveConPTY 句柄也无法跨进程移交——守护进程照常停启靠 scrollback 快照兜底升级时shells survive the update的行为平台差异说明见 docs/reference/updates.mdx。什么能活过什么一图看懂恢复矩阵官方文档 docs/getting-started/concepts.mdx 用一张矩阵总结了 tty7 的持久性承诺关闭标签页退出 tty7停止服务器重启机器shell 继续运行✗✓✗✗布局恢复✗✓✓✓屏幕内容恢复✗✓✓✓一次截断尾部受支持的 agent 会话恢复✗✓✓✓注意停止服务器那一列重启服务器会结束该机器上所有pane 里的进程布局保留、屏幕靠快照恢复。这也是官方反复提醒别替别人顺手重启服务器的原因。排障视角下Panes came back empty256 KiB 尾部、消费一次的完整解释在 docs/reference/troubleshooting.mdx。值得借鉴的三个设计取舍新鲜度与写放大的平衡30 秒周期 只写变化的 pane把崩溃前最后几秒的损失换成了几乎为零的常态 IO按相关性保留快照的存留条件是还有哪个工作空间会请求它而不是它写了多久隐私面磁盘上的终端输出被压到最小优雅退出的降级路径清晰handoff 覆盖升级、快照覆盖崩溃与重启、Windows 无 execve 时快照就是唯一防线——每一层都知道自己的边界。核心源码索引磁盘快照格式与存储crates/tty7-core/src/daemon/scrollback.rs快照写入线程与恢复请求处理crates/tty7-core/src/daemon/server.rs内存回放环与 8 MiB 上限crates/tty7-core/src/daemon/pane.rsexecve 原地升级crates/tty7-core/src/daemon/handoff.rs持久性矩阵文档docs/getting-started/concepts.mdx所以为什么崩溃后屏幕还能回来的答案可以浓缩成一句话窗口死得起是因为 pane 从来不归窗口管屏幕回得来是因为守护进程在死之前把每块屏幕的最后几屏悄悄写进了只有你自己能读的文件里。赞分享【免费下载链接】tty7The terminal that outlives its window. Shells survive quitting the app, agents can drive other agents, and remote machines work the same way. Pure Rust, GPU-rendered.项目地址https://gitcode.com/gh_mirrors/tty/tty7点击查看免费下载相关推荐Upterm错误恢复机制进程崩溃与会话重建策略Upterm错误恢复机制进程崩溃与会话重建策略 你是否经历过终端进程意外崩溃导致工作成果丢失的情况在服务器管理、长时间脚本运行或复杂命令执行过程中会话中断开发工具桌面应用Nativefier崩溃恢复机制自动保存与会话恢复Nativefier崩溃恢复机制自动保存与会话恢复 你是否曾遇到过这样的情况正在使用Nativefier将网页转换为桌面应用时突然程序崩溃所有设置和登录CLI桌面应用开发工具Captura崩溃恢复机制自动保存与会话恢复设计Captura崩溃恢复机制自动保存与会话恢复设计 引言录屏工作者的噩梦与解决方案 你是否经历过这样的场景花费数小时录制教程或直播内容突然软件崩溃所有未桌面应用屏幕录制音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 为什么崩溃后屏幕还能回来？tty7 守护进程回放缓冲与会话恢复机制深析
【免费下载链接】tty7The terminal that outlives its window. Shells survive quitting the app, agents can drive other agents, and remote machines work the same way. Pure Rust, GPU-rendered.项目地址https://gitcode.com/gh_mirrors/tty/tty7点击查看免费下载tty7 是一款纯 Rust、GPU 渲染的现代终端它的核心承诺是窗口死了终端不死。普通终端里关掉窗口等于杀掉所有 shell而 tty7 把 shell 交给一个后台守护进程daemon持有并为每个面板维护两级回放缓冲——内存中的 8 MiB 环形缓冲 磁盘上的 256 KiB 周期性快照。正因如此无论是误关窗口、进程崩溃、kill -9还是整台机器重启重新打开 tty7 后你都能看到崩溃前屏幕上的内容。本文带你深析这套回放缓冲与会话恢复机制的设计取舍。tty7 的架构基石窗口不拥有你的 shell理解崩溃后屏幕还能回来先要理解 tty7 的分层结构窗口Window只是 GUI 客户端负责显示和输入守护进程daemon后台服务器真正持有每个 pane 的 PTY 文件描述符Pane一个终端实例拥有稳定 id如%42这个 id 是 CLI 和恢复机制寻址的关键。关闭 tty7 窗口只是断开了一条 socket 连接守护进程继续存活你的构建继续跑、agent 继续工作、SSH 会话不断开。再次打开时客户端按 pane id 重新 attach看到的正是离开时的屏幕。这套守护进程拥有会话的模型也是远程机器上体验一致的原因架构说明详见官方文档docs/getting-started/concepts.mdx。第一级缓冲内存中的 8 MiB 回放环每个 pane 的输出字节都会进入守护进程内存里的一个环形缓冲区replay ring上限由 pane.rs 中的RING_CAP定义const RING_CAP: usize 8 * 1024 * 1024; // 8 MiB回放环按几何同构段Segment切分一段输出记录了它写入时的窗口尺寸cols/rows/字号重放时客户端按原始宽度解包字节不会把旧输出按当前宽度错误折行。窗口没死、只是断连的场景——比如手机连回来、CLI 重新 attach——全靠这块环。但环也有致命弱点它只活在守护进程自己的进程里。一次崩溃、kill -9或重启环和进程一起消失窗口回来时只剩一排空白 shell。这正是第二级缓冲登场的地方。第二级缓冲磁盘快照——只存 256 KiB每 30 秒一次磁盘快照的实现集中在 scrollback.rs设计思路写在了模块注释里值得细看定时而非逐字节写盘见 SNAPSHOT_INTERVAL每个 pty 字节都落盘会带来巨大的写放大只为换取崩溃前最后几秒的新鲜度不划算。写入器跑在一个 30 秒周期的线程tty7-scrollback上server.rs且跳过环形缓冲没变化的 pane——空闲机器零 IO忙碌的 pane 反而得到最新拷贝只存 256 KiBSNAPSHOT_CAP远小于 8 MiB 的内存环。滚动内容的价值随距离屏幕底部的距离陡降最后几屏就够用了从头部裁剪trim_to终端输出只能向前解释尾部独立成立、头部不行所以超限时永远吃掉最老的部分原子写 严格权限快照先写入临时文件再rename就位读者永远不会看到写一半的文件文件从创建起就是0600权限write_private——因为它可能包含你在 pane 里 echo 过的 token、env输出和 agent 对话记录绝不能让其他用户读走。文件格式以魔术数TTY7SB\x01\x00开头MAGIC每段记录写入时的窗口几何信息尾部可携带 pane 标题。解码是全有或全无截断文件、外部文件一律拒绝读取此时 pane 回落到空白屏——这正是模块出现之前的行为没有任何损失。快照存放在配置目录的scrollback/{pane_id}.bin通常在~/.config/tty7/scrollback/。恢复流程RestoreFrom 请求与消费一次语义守护进程崩溃后重新启动它本身不记得任何 pane——但磁盘快照记得。恢复由客户端发起打开一个顶替已死 pane的新 pane 时spawn 请求里携带一个RestoreFrom结构protocol.rspub struct RestoreFrom { pub pane_id: u64, // 顶替哪个死去的 pane pub banner: OptionString, // 画在旧屏幕与新 shell 之间的一行说明 }守护进程随后执行 restored_screen读取该 pane 的最后快照 → 丢弃文件forget→ 把字节流种进新 pane 的播放环。于是窗口显示出的就是崩溃前屏幕上那些输出滚动进 scrollback 一行横幅说明 一个明显是新的 shell。两个细节很有讲究横幅文案来自客户端而非守护进程因为守护进程没有 locale——它同时服务任意语言的 GUI 和永远说英文的 CLI快照只消费一次。恢复过一次、pane 又被关闭、再重新打开时就没有东西可恢复了。这是刻意设计按相关性保留而非按时间保留无人再会请求恢复的快照会由 sweep 定期清扫避免终端输出无限期留在磁盘上。反过来可预见的退出会写得更精确store_scrollback_now 在收到正常关闭通知时把每个 pane 的屏幕最后一写此时拷贝是精确的而非最多滞后 30 秒。而用户主动关闭的 pane 走 kill_pane快照直接删除——你亲手关掉的终端不值得留尸。崩溃之外的死亡execve 原地换芯与 Windows 的例外快照解决不了进程还活着但二进制要换的场景——升级。pty master 是本进程持有的文件描述符进程一换、描述符一关slave 端就收到SIGHUPpane 里的一切陪葬。tty7 的解法在 handoff.rs利用 Unix 的execve替换镜像而保留进程——同一个 pid、同一批子进程、同一批没有FD_CLOEXEC的打开描述符。于是 pty 保持打开shell 完全感知不到换芯只有描述符另一端的代码变了。交接清单Manifest记录每个 pane 的 master fd、子进程 pid、工作目录、OSC 标题、agent 状态以及环形缓冲的完整长度所有需要跨execve存活的描述符先解除 close-on-exec失败则整体回滚旧守护进程继续服务。三样东西过不去设计上也坦然处理过不去的东西处理方式原生 SSH pane加密状态在本进程内存里exec 前主动挂断远端看到的是干净断开客户端连接窗口持有的 socket 随旧镜像死亡客户端按原有路径重连、按 pane id 重挂Windows没有execveConPTY 句柄也无法跨进程移交——守护进程照常停启靠 scrollback 快照兜底升级时shells survive the update的行为平台差异说明见 docs/reference/updates.mdx。什么能活过什么一图看懂恢复矩阵官方文档 docs/getting-started/concepts.mdx 用一张矩阵总结了 tty7 的持久性承诺关闭标签页退出 tty7停止服务器重启机器shell 继续运行✗✓✗✗布局恢复✗✓✓✓屏幕内容恢复✗✓✓✓一次截断尾部受支持的 agent 会话恢复✗✓✓✓注意停止服务器那一列重启服务器会结束该机器上所有pane 里的进程布局保留、屏幕靠快照恢复。这也是官方反复提醒别替别人顺手重启服务器的原因。排障视角下Panes came back empty256 KiB 尾部、消费一次的完整解释在 docs/reference/troubleshooting.mdx。值得借鉴的三个设计取舍新鲜度与写放大的平衡30 秒周期 只写变化的 pane把崩溃前最后几秒的损失换成了几乎为零的常态 IO按相关性保留快照的存留条件是还有哪个工作空间会请求它而不是它写了多久隐私面磁盘上的终端输出被压到最小优雅退出的降级路径清晰handoff 覆盖升级、快照覆盖崩溃与重启、Windows 无 execve 时快照就是唯一防线——每一层都知道自己的边界。核心源码索引磁盘快照格式与存储crates/tty7-core/src/daemon/scrollback.rs快照写入线程与恢复请求处理crates/tty7-core/src/daemon/server.rs内存回放环与 8 MiB 上限crates/tty7-core/src/daemon/pane.rsexecve 原地升级crates/tty7-core/src/daemon/handoff.rs持久性矩阵文档docs/getting-started/concepts.mdx所以为什么崩溃后屏幕还能回来的答案可以浓缩成一句话窗口死得起是因为 pane 从来不归窗口管屏幕回得来是因为守护进程在死之前把每块屏幕的最后几屏悄悄写进了只有你自己能读的文件里。赞分享【免费下载链接】tty7The terminal that outlives its window. Shells survive quitting the app, agents can drive other agents, and remote machines work the same way. Pure Rust, GPU-rendered.项目地址https://gitcode.com/gh_mirrors/tty/tty7点击查看免费下载相关推荐Upterm错误恢复机制进程崩溃与会话重建策略Upterm错误恢复机制进程崩溃与会话重建策略 你是否经历过终端进程意外崩溃导致工作成果丢失的情况在服务器管理、长时间脚本运行或复杂命令执行过程中会话中断开发工具桌面应用Nativefier崩溃恢复机制自动保存与会话恢复Nativefier崩溃恢复机制自动保存与会话恢复 你是否曾遇到过这样的情况正在使用Nativefier将网页转换为桌面应用时突然程序崩溃所有设置和登录CLI桌面应用开发工具Captura崩溃恢复机制自动保存与会话恢复设计Captura崩溃恢复机制自动保存与会话恢复设计 引言录屏工作者的噩梦与解决方案 你是否经历过这样的场景花费数小时录制教程或直播内容突然软件崩溃所有未桌面应用屏幕录制音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考