WaveTerm 开源终端快速上手指南3 步装好远程开发与 AI 助手少开几个窗口【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm你正在终端里跑编译想看文档要切浏览器要看远程服务器日志又要切到另一个窗口。每切一次思路就断一次。WaveTerm 是一个开源终端它把网页浏览、文件预览、图形化编辑器和 AI 助手都放进了终端所在的同一个窗口而且这个跨平台终端同时支持 macOS、Windows 和 Linux。装好它你只需要一个窗口。WaveTerm 一条命令装好macOS、Windows、Linux 系统要求与安装三个系统都能用一行命令装完装完直接打开就能用不需要额外配置。系统最低要求架构macOSmacOS 11 Big Sur 及以上Apple Silicon、x64WindowsWindows 10 1809 及以上x64x64ARM64 计划中Linuxglibc-2.28 及以上如 Ubuntu 20.04、Debian 10x64、ARM64各系统最短安装命令# macOS brew install --cask wave# Windows winget install CommandLine.Wave# Linux sudo snap install --classic waveterm首次打开 WaveTerm你会看到一个空白工作区里面只有一个终端块。按CmdNWindows/Linux 上是AltN可以再加一个终端块。到这一步它已经可以当普通终端日常使用了。需要最新开发版的话可以从源码构建克隆仓库git clone https://gitcode.com/GitHub_Trending/wa/waveterm按 BUILD.md 准备 Go、NodeJS 22 和 Task 后执行构建即可本文不展开。先搞懂 WaveTerm 的四层结构窗口、工作区、标签页、块理解一件事后面所有操作都能对上号WaveTerm 的界面是「窗口 → 工作区 → 标签页 → 块」的层级结构。块Block是最小单位。终端、网页、文件预览、代码编辑器、AI 面板每一样都是一个块可以在标签页内自由拖拽、分割、缩放。标签页Tab装一组块。按CmdT新建标签页Cmd1到Cmd9直接跳到第几个标签页。工作区Workspace装一组标签页也就是一个完整的工作现场。按CmdCtrl1到CmdCtrl9可以在已保存的工作区之间一键切换比如「本地开发」和「远程运维」各存一个切工作区就是切任务。⚠️ 新工作区默认是临时的关窗口就没了。打开窗口左侧的工作区切换器点底部的「Save workspace」保存下来标签页、布局和终端历史才会持久化。不切窗口看文件在终端里直接预览 Markdown、图片和目录WaveTerm 里看文件不用另开编辑器wsh view一条命令就能把文件以图形方式打开在旁边的块里。wsh view README.md # 以渲染后的 Markdown 预览文件 wsh view ~/Documents # 预览整个目录像文件浏览器文本和代码文件会以带语法高亮的图形化编辑器打开图片、Markdown、CSV、PDF、视频都能直接看不用退出终端。想边看边改用wsh edit config.json打开同一文件的编辑模式CmdS保存。这个能力连远程机器也适用——连上 SSH 之后远程的文件同样可以这样预览和编辑。不切窗口连远程开发SSH 连接、传文件与会话保持远程开发在 WaveTerm 里不需要开第二个终端点标签页头部的小电脑图标输入[user][host]就建立了连接~/.ssh/config里已有的 Host 会自动出现在下拉列表里。连上之后有两个最实用的点wsh file cp ./app.conf wsh://userserver/~/app.conf # 本地文件一条命令拷到远程 wsh edit /etc/nginx/nginx.conf # 用图形编辑器直接改远程配置更省心的是持久会话Durable Sessionsv0.14 引入终端头部出现盾牌图标时说明该 SSH 会话是持久的。断网、合盖休眠、甚至重启 WaveTerm远端 shell 和正在跑的命令都还在重新连接时自动接回。⚠️ 注意它只对远程 SSH 生效本地终端不受网络影响默认就是普通会话。把报错丢给内置 AIwsh ai 直接分析日志和代码WaveTerm 内置的 Wave AI 能读终端输出和文件你不需要把报错复制粘贴到网页聊天框里。tail -n 50 app.log | wsh ai -s - -m 这些错误是什么原因 # 管道输出直接发给 AI wsh ai main.go utils.go -m 找出潜在 bug # 附文件后在侧栏提问默认情况下内容只是附到 AI 侧栏你确认后再发送加-s则直接提交。AI 面板用CmdShiftA随时收起展开输入框用CtrlShift0聚焦。模型方面自带免费额度也可以自带 OpenAI、Claude、Gemini 的 API Key或者通过 Ollama 用本地模型配置入口是wsh editconfig presets/ai.json。WaveTerm 快捷键与自定义组件只记这几条就够最常用的几条快捷键其余的查 docs/keybindings 即可快捷键macOSWindows/Linux 把 Cmd 换成 Alt功能CmdN新建块默认新终端继承当前连接和目录CmdW/CmdShiftW关闭当前块 / 当前标签页CmdM放大/还原当前块全屏看长日志很方便CmdD/CmdShiftD水平 / 垂直分出新块CtrlShift方向键在块之间跳转焦点CmdCtrl1~9切换到对应工作区把常用动作变成「一键块」靠的是自定义组件。组件定义在widgets.json里用wsh editconfig widgets.json打开就能改。比如把「打开 fish shell」做成侧栏图标加一个组件配置view设为term、controller设为shell保存后侧边组件栏立刻多出一个可点的图标。两条值得试的自动化命令wsh run -x -- npm test # 新开一个块跑测试成功后自动关闭该块 wsh notify -t 部署 生产部署完成 # 长任务结束时发桌面通知WaveTerm 常见问题排查速查wsh 不可用、块编号、远程断连问题原因一行解决远程机器里wsh提示命令找不到远程端的 wsh 助手没装上或装失败wsh conn reinstall userhost在普通终端里运行 wsh 报错设计如此wsh 依赖 Wave 下发的访问令牌只在 WaveTerm 的块里使用 wsh不知道块号怎么按块编号默认隐藏按住CtrlShift即可显示SSH 连接不上不知道卡在哪需要看连接过程日志块头部点设置图标 → Debug Connection或wsh wavepath log启动时提示 ARM64 翻译警告装到了 x64 版本在走兼容层卸载后重装本机架构的原生版本远程 wsh 还有两个已知限制只支持 bash、zsh、pwsh、fish 四种 shell 注入其他 shell 需通过connections.json里的conn:shellpath换掉部分服务器 sshd 默认关闭 TCP 转发需要在远端/etc/ssh/sshd_config里把AllowTcpForwarding改为yes或local再重启 sshd。到这里装好、看懂结构、跑通看文件/远程/AI 三个工作流WaveTerm 的常用能力你已经全部碰过了。剩下的就是把它存成自己的工作区让它慢慢长成你固定的开发现场。更多细节可以查仓库内的官方文档docs/。【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考