把终端变成工作台：WaveTerm 终端工具实战指南-平芜编程栈

把终端变成工作台：WaveTerm 终端工具实战指南

【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm

WaveTerm（Wave Terminal）是一款开源的跨平台终端工具，它解决的问题是"终端只是一块吐文字的黑框"：在这里，终端、文件预览、网页浏览器、AI 助手、系统监控图都是可以自由拖拽、拼接、缩放的"块（block）"，全部摆在同一个窗口里。如果你的日常是在终端窗口、浏览器标签页和文件管理器之间反复横跳，那下面这套玩法会正中痛点。

一行命令装好，三条命令验证

三个平台都能装，要求都不高：

系统	要求	安装命令
macOS	11 以上，Apple Silicon / x64	`brew install --cask wave`
Windows	10 1809 以上，x64	`winget install CommandLine.Wave`
Linux	glibc ≥ 2.28	`sudo snap install --classic waveterm`

首次启动就是一个干净的单终端窗口，不用任何配置。打开终端敲下面三条命令，感受一下wsh——它是 Wave 内置的、让你从命令行"够得着图形界面"的官方命令：

wsh view README.md # 把文件打开到预览块 wsh web open github.com # 把网页打开到网页块 wsh ai -m "怎么找当前目录下最大的文件？" -s

敲完你会发现窗口"长"出了新的块。记住这个感觉，后面所有的功能都是它的延伸。

把终端拖成你想要的布局 🧲

Wave 的基本单位是块：一个块可以是终端、文件预览、网页或 AI 聊天。快捷键Cmd:N新建块（Windows/Linux 用Alt替代Cmd），Cmd:D向右拆出半个块，Cmd+Shift:D向下拆。把块标题栏拖到另一个块上松手，可以交换位置或停靠合并；悬停在块边缘可以拖拽调整大小；Cmd:M把当前块放大成近全屏，再按一次立刻还原，不丢原来的位置。

块多了以后，键盘接管一切：按住Ctrl+Shift，所有块会显示编号，随后Ctrl+Shift+1~9直接跳转，方向键在块间移动焦点。最常用的几个：

快捷键	功能
`Cmd:T`	新建标签页
`Cmd:D`/`Cmd+Shift:D`	水平 / 垂直拆分新块
`Cmd:M`	放大 / 还原当前块
`Ctrl+Shift+1~9`	跳到编号块
`Cmd:Ctrl:1~9`	切换工作区
`Ctrl+Shift+方向键`	在块之间移动焦点

给每个项目单独配一个工作区

一个项目，一个工作区。工作区切换器在标签栏左侧，点开会看到所有已保存的工作区。注意：新窗口默认是"未保存"的工作区，关掉窗口就没了，所以先点底部的 "Save workspace" 保存。保存之后，标签布局、终端回滚缓冲、AI 聊天记录都会自动持久化，下次打开应用还在原处。

推荐按项目隔离：前端项目的工作区摆"dev server + 本地预览网页 + AI 聊天"三块；运维的工作区摆"远程终端 + 日志 tail"；切过去就是熟悉的现场，Cmd:Ctrl:1~9一键跳。如果某个工作区已经开在别的窗口里，切换会直接聚焦那个窗口，不会重复打开。

断网也活下来的远程会话 🛡️

点窗口顶部的笔记本电脑图标，输入user@host就是一次 SSH 连接。Wave 会解析你的~/.ssh/config，常用主机已经躺在下拉列表里，选中回车即可。

连上时 Wave 会询问是否安装一个很小的wsh助手程序，建议同意——之后远程机器上也能用文件预览、系统监控这些块。

远程开发最实用的是持久会话（durable session）：它在远端起一个轻量进程替你守住 shell 状态，思路和 tmux 一样，但内置在 Wave 里。网络闪断、笔记本休眠、甚至关掉 Wave 窗口，服务器上的会话照常运行；恢复后自动重连，回滚缓冲都还在。开启方式二选一：设置里加一行"term:durable": true（对所有 SSH 生效），或者只给当前块执行wsh setmeta term:durable=true。

人在远程 shell 里，还能直接取本地机器的文件，/~/前缀就代表"本地主目录"：

wsh file cp /~/report.txt ./report.txt # 本地文件拷到远程 wsh edit /etc/nginx/nginx.conf # 用内置编辑器改远程文件

把命令输出直接喂给 AI 助手 🤖

Wave AI 是窗口里的 AI 助手面板（Cmd+Shift+A开关，Cmd+K开新对话）。它和普通聊天框的差别在于"widget 上下文"开关：打开后它能读终端回滚缓冲、给任意块截图、读写本地文件——文件操作每一次都会弹出来请你批准，控制权始终在你手里。

更顺手的是从命令行直接喂料，wsh ai支持管道和文件附件：

ls -la | wsh ai - # 目录列表喂给它分析 wsh ai main.go utils.go -m "找 bug" # 附上文件，等你补一句再发 git diff | wsh ai -s -m "review" # -s 直接提交

模型可以完全换：自带 OpenAI、Gemini、Claude、Azure 的 Key 即可（BYOK），也可以指向本机 Ollama 等 OpenAI 兼容服务，数据不出机器。

一键启动你常用的工具

标签栏下方的组件栏默认有五个按钮：终端、文件、网页、AI、系统监控。想加自己的？编辑widgets.json，每个 widget 就是一段声明"点开它要开什么块"的 JSON，比如每次点开就跑一次测速：

"speedtest": { "icon": "gauge-high", "label": "speed", "blockdef": { "meta": { "view": "term", "controller": "cmd", "cmd": "speedtest-go --unix" } } }

保存后组件栏多一个新按钮，一点就在独立块里执行；dua这类 TUI 工具同理。字段细节见自定义 widget 文档。