WaveTerm 实践指南把终端变成多窗口开发工作台【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm一边跑着开发服务器一边盯着日志滚动还想知道刚才那个报错到底怎么回事、顺手连上测试机看一眼状态——传统终端里你只能在一堆窗口之间来回切。WaveTerm项目名也写作 Wave / Wave Terminal就是为这种场景设计的它是一款开源、AI 集成、跨平台的终端支持 macOS、Windows 和 Linux窗口里可以把终端、文件预览、网页、AI 助手等内容以块Block的形式并排摆放而不是只能一列到底。WaveTerm 和普通终端最大的区别有三点一切内容都是可拖拽的块所有块都能被命令行工具wsh驱动比如用一条命令把文件、网页、AI 对话拉成独立窗口远程 SSH 会话可以做成持久会话断网、关机都不丢状态。三分钟装好 WaveTerm先把它装起来。系统要求不高macOS 11 及以上、Windows 10 1809 及以上x64、Linux 需 glibc 2.28 及以上以下命令按你的系统选一条执行# macOS brew install --cask wave # Windows winget install CommandLine.Wave # Linux sudo snap install --classic waveterm启动后你会看到一个标签页里面是一个终端块——当普通终端用即可。想拿最新开发版的话从源码构建克隆仓库地址为https://gitcode.com/GitHub_Trending/wa/waveterm构建步骤见仓库内的 BUILD.md。把终端、日志、文档排成一个工作台这一节解决多件事同时干的问题。先记四个快捷键macOS 用 CmdWindows/Linux 用 Alt新建标签页Cmdt新建终端块Cmdn继承当前的连接和工作目录关闭块Cmdw最大化/还原块CmdmCmdd向右分屏CmdShiftd向下分屏CtrlShift方向键在块之间移动焦点光靠终端块还不够WaveTerm 的块还可以是文件预览和网页用内置的wsh命令一行就能拉出来wsh view ~/projects # 在预览块中打开文件/目录支持 markdown、图片、CSV 等 wsh web open docs.waveterm.dev # 在网页块中打开文档 wsh run -x -- npm test # 在独立块中跑命令结束后自动关闭该块排布技巧拖住块标题栏可以重排鼠标悬停在块的边缘可以调整大小。一个标签页里块的数量建议别超过 25 个左右再多加载会变慢。完整快捷键见 docs/docs/keybindings.mdx。把工作台存成可复用的工作区解决换个项目又要重新摆一遍的问题。标签页栏左侧有一个工作区Workspace切换器点它可以新建、重命名、删除工作区。两个关键细节新工作区默认是临时的窗口一关就没了只有最后一个窗口关闭时的状态会在下次启动时恢复。想保留就在切换器底部点 Save workspace判断当前是否已保存切换器顶部显示 Switch workspaces 表示已保存显示 Open workspace 表示还没保存保存后标签页、布局、终端和 AI 对话历史都会自动持久化。之后用CmdCtrl1~9直接切到编号对应的工作区前端开发台服务器运维台各占一个编号互不干扰。更多用法见 docs/docs/workspaces.mdx。一键连上远程机器解决每次都要手敲 ssh断了就白干的问题。点击块标题上的笔记本图标或按Cmdg打开连接框输入usernamehost即可发起 SSHWindows 上输入wsl://发行版名可进 WSL。连接下拉列表会自动解析你的~/.ssh/config常用的 Host 直接就在列表里连成功的连接也会被记住。连上后 Wave 会询问是否在远端安装wsh扩展默认装到~/.waveterm/bin/wsh。装好后远端会话也能用wsh view预览文件、用wsh file cat /~/配置文件把本地文件取到远端执行——/~/是本地家目录的简写。进阶一点对重要远程会话启用持久会话Durable Session。悬停块标题上的盾牌图标选 Restart as Durable或在终端里执行wsh setmeta term:durabletrue会话就不会因断网、合盖、Wave 重启而中断状态、后台进程、滚动历史全部保留重连后自动接上。注意切换普通/持久模式会重启 shell当前进程会结束。机制细节见 docs/docs/durable-sessions.mdx。让 AI 帮你读终端输出解决报错要手动复制粘贴到聊天框的问题。按CmdShifta打开内置的 WaveAI 面板开启widget context后AI 能读终端滚动历史、对任意块截图、读写文件——所有文件操作都会先请求你的批准你掌握全部访问权。从命令行把内容直接送过去更省事git diff | wsh ai - # 把 diff 管道给 AI 分析 wsh ai main.go -m find bugs -s # 附带文件、自动提交问题模型方面三选一用内置的免费云服务、自带 API KeyOpenAI、Claude、Gemini、Azure 等、或者跑本地模型Ollama、LM Studio 等 OpenAI 兼容服务。追求数据不出本机就选本地模型。配置方法见 docs/docs/waveai.mdx。个性化设置字体、主题与全局热键配置放在~/.config/waveterm/主文件是settings.json最省事的编辑方式是终端里执行wsh editconfig它会用内置编辑器打开配置。几个常用键term:theme、term:fontsize、term:scrollback——终端外观与回滚行数app:globalhotkey——设置一个全局热键在任何应用里随时唤起最近的 Wave 窗口ai:apitoken/ai:model——配置自带 Key 与默认模型配置文件是扁平的 JSON用:分层如term:fontsize支持按连接在connections.json里单独覆盖比如给某台远程机器单独调字体。完整键值列表见 docs/docs/config.mdx。常用命令与快捷键速查你想做的事命令 / 快捷键说明新建标签页 / 终端块Cmdt/CmdnWin/Linux 用 Alt左右 / 上下分屏Cmdd/CmdShiftd新块继承当前连接与目录块间移动焦点 / 跳号CtrlShift方向键/CtrlShift1~9按住 CtrlShift 可显示块编号最大化 / 关闭块Cmdm/Cmdw关闭会终止块内进程预览文件、目录wsh view 路径markdown、图片、CSV 均可渲染打开网页wsh web open url在独立网页块中打开隔离运行命令wsh run -x -- 命令结束后自动关块问 AI 问题管道 \| wsh ai -或wsh ai 文件 -m 问题-s自动提交本地↔远端传文件wsh file cat /~/文件/~/指本地家目录切换工作区CmdCtrl1~9已保存的工作区编辑配置wsh editconfig打开内置编辑器想继续深入仓库内这几篇文档是最直接的入口快速上手 docs/docs/gettingstarted.mdx、wsh 全量参考 docs/docs/wsh-reference.mdx、连接管理 docs/docs/connections.mdx、自定义组件 docs/docs/customwidgets.mdx。把上面这套流程跑一遍终端、文件、文档、远程机器和 AI 就该都摆在同一个屏幕上了。【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考