如何 5 分钟在 macOS、Windows、Linux 上装好 tty7 终端:快速上手指南 + 首次启动配置清单
如何 5 分钟在 macOS、Windows、Linux 上装好 tty7 终端:快速上手指南 + 首次启动配置清单
tty7 是一款纯 Rust、GPU 渲染的终端工作台,最大的特点是"会话比窗口活得久":退出应用后 shell 照常运行,重启电脑后布局、屏幕内容甚至支持的 AI 编码 agent 对话都会原样回来——全程不需要 tmux。本文带你用不到 5 分钟完成 macOS、Windows、Linux 三大平台的 tty7 安装,并附上一份首次启动配置清单,照着点一遍就能开始干活。
一、装之前:为什么 tty7 和普通终端不一样?
普通终端里,关掉窗口 shell 就死了。tty7 的架构是:后台常驻的 server 持有你的 shell 和窗格,窗口只是"遥控器"。
- ✅ 会话常驻:退出应用、崩溃甚至重启机器,重新打开后自动接回原会话
- ✅ Agent 感知:识别 28 个 CLI 编码 agent,状态点、通知、分支 diff 一屏看完
- ✅ 编辑器级输入:内联建议、Tab 补全、语法高亮、
⌃ R历史模糊搜索,零插件 - ✅ 远程开发:自带 SSH 栈,远端文件、仓库、窗格和 git 信息都留在远端
完整概念讲解见 docs/getting-started/concepts.mdx。
二、三步装好 tty7:三大平台安装方法
所有平台都是原生构建,无需预装任何运行时:字体直接内嵌在二进制里,Linux 版甚至把 X11/Wayland 库也打包了进去。到项目 Releases 页面按架构下载对应文件即可。
1. macOS:拖进「应用程序」就完事
| 你的 Mac | 下载文件 |
|---|---|
| Apple 芯片(M1 及以后) | tty7-<version>-macos-arm64.dmg |
| Intel 芯片 | tty7-<version>-macos-x86_64.dmg |
打开 DMG,把 tty7 拖入「应用程序」文件夹即可。官方构建已用 Developer ID 签名并通过 Apple 公证,Gatekeeper 会直接放行,不用右键"打开"走流程。测试范围是 macOS 14(Sonoma)及以上。
2. Windows:安装器或绿色版,二选一
Windows 同时提供 x86-64 和 ARM64(骁龙笔记本)两种架构:
| 文件 | 适合场景 |
|---|---|
tty7-<version>-windows-<arch>-setup.exe |
常规安装,带开始菜单项和卸载器 |
tty7-<version>-windows-<arch>.zip |
绿色版,解压后直接运行 tty7-app.exe |
两个实用细节:
- 安装器有一个默认关闭的可选项——在文件夹右键菜单里添加"Open in tty7",只写入当前用户的注册表,卸载时自动清除
- 程序静态链接了 Visual C++ 运行时,不需要单独装 VC++ Redistributable,解压即用
💡 绿色版想要"完全便携":在
tty7-app.exe旁边建一个空的data文件夹,tty7 会把设置、会话、回滚缓冲全部写在那里——U 盘党福音。
3. Linux:AppImage 一条命令搞定
下载 tty7-<version>-linux-x86_64.AppImage,赋予执行权限后直接运行,X11、Wayland、xkb、字体库全部自带,Fedora、Arch、Debian 等发行版通吃:
chmod +x tty7-*-linux-x86_64.AppImage
./tty7-*-linux-x86_64.AppImage
详细安装说明(含源码编译、卸载步骤)见 docs/getting-started/installation.mdx。
4. 附赠:tty7 命令自动上 PATH
三个平台的安装包都自带 tty7 CLI,应用首次启动就会把它放进 PATH(Unix 下是符号链接到 /usr/local/bin、~/.local/bin 等已有目录;Windows 下把安装目录加入用户 PATH)。脚本和别的终端里的编码 agent 都能用它开窗格、读输出——这是 tty7 "可被 agent 驱动"能力的基础,文档在 skills/tty7/SKILL.md。
三、首次启动配置清单
打开 tty7,你会看到一个标签页 + 一个 shell + 左侧标签栏。下面 6 项都值得花 5 分钟点一遍(按 ⌘ ,,Windows/Linux 为 Ctrl , 打开设置)。
1. 选一个顺眼的主题
Settings → Appearance → Theme,内置 9 套主题(Light、Dark、Dracula、Catppuccin Latte、Rosé Pine 等),打开 Sync with system 可让终端跟随系统亮暗模式实时切换。同页还有透明度和背景材质(Windows 支持 Mica、Acrylic)。
2. 指定默认 shell
Settings → Terminal → Shell,留空即用平台默认;也可以填 zsh、fish、pwsh 等可执行文件名或绝对路径,并加参数(如 -l 表示登录 shell)。Start in 决定新 shell 打开在哪个目录:启动目录、主目录或固定路径。
3. macOS 专属:Option 键当 Meta 用吗?
Settings → Keyboard & Mouse → Option (⌥) acts as Meta。打开后 ⌥ B 是"后退一个单词"、⌥ ⌫ 是"删一个单词";关闭则 ⌥ B 打出 ∫。常敲 shell 的人建议打开,常打重音字符的保持关闭。
4. 用 AI 编码 agent?一键装 hook
Settings → Integrations。tty7 靠进程名就能自动识别 28 个 CLI agent(头像、标签页标题、分支 + diff 免费获得);但要解锁状态点、"需要授权"通知、tty7 wait 和重启恢复会话,需要点一下对应 agent 旁的 Install——它只是在 agent 自己的配置目录里写一个小 hook,随时可移除。
5. 搞懂「退出」和「退出并停止服务」的区别
- 普通 Quit:只关窗口,后台 server 继续跑,你的编译、agent、SSH 会话都不受影响,重开应用自动接回
- 托盘菜单里的 Quit and Stop Server…:才是真正"全停",会明确警告你"还在跑的进程都会被终止",但标签和布局会保留
这就是 tty7 不需要 tmux 的原因——持久性属于底层 server,不属于你的 shell 配置。
6. 通知与快捷键预设(可选)
- Settings → General → Notifications:默认"窗口未聚焦时,前台命令跑超过 10 秒后完成"才发桌面通知,可改为 Never / Always 并调整阈值
- 从 tmux 迁移?在 Keyboard shortcuts → Preset 选 tmux,
⌃ B前缀 + 按键的习惯直接搬过来,未绑定的组合会原样透传给 shell
四、更新与卸载
- 自动更新:每 6 小时检查一次新_release,Settings → About → Check now 可手动触发;后台下载校验完成后,点"Update and relaunch"只需重启。更新通道(Stable / Nightly)在 Settings → General → Updates 切换,详见 docs/reference/updates.mdx
- 卸载:macOS 从托盘选 Quit and Stop Server 后拖入废纸篓;Windows 用"添加或删除程序";Linux 删掉 AppImage 即可。设置文件分别在
~/.config/tty7和%APPDATA%\tty7,删掉该文件夹即彻底清除
五、延伸阅读
装好之后,建议按这个顺序逛一圈文档:
- 核心概念(workspaces / tabs / panes / server):docs/getting-started/concepts.mdx
- 首次启动设置详解:docs/getting-started/first-launch.mdx
- 快捷键速查:docs/reference/keyboard-shortcuts.mdx
- 项目中文介绍:README.zh-CN.md
从下载文件到敲下第一行 ls,全程不超过 5 分钟——关掉窗口去喝杯咖啡,回来你的 shell 还在原地等。⚡



