WaveTerm 终端工具完整指南：4 个日常场景 + 3 个进阶技巧一次讲清

WaveTerm 终端工具完整指南4 个日常场景 3 个进阶技巧一次讲清【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/wavetermWaveTerm 是一款开源、跨平台、集成 AI 的终端工具把文件预览、网页浏览、远程 SSH 和多终端管理放进同一个窗口解决终端与图形界面反复切换的问题。本文按安装 → 看懂界面 → 日常任务 → 进阶用法的顺序讲完从上手到熟练的路径。十分钟上手三大平台安装 WaveTerm安装走各平台的包管理器一条命令即可完成。系统要求不苛刻macOS 11、Windows 10 1809、glibc 2.28 的 Linux 发行版均可运行详见 安装文档。平台安装命令macOSbrew install --cask waveWindowswinget install CommandLine.WaveLinuxsudo snap install --classic waveterm装完后启动应用在默认终端块里执行下面这条命令输出版本号即验证成功wsh version需要源码构建时克隆仓库后按 BUILD.md 说明安装依赖并运行即可。看懂界面窗口、标签页、块、工作区四个概念第一次打开 WaveTerm 时你会看到窗口里已经有一个终端块。四个核心概念的层级关系如下窗口承载一切工作区是一组标签页及其布局的命名快照用于区分项目或环境标签页组织多条工作流块是最小单元可以是终端、预览器、浏览器或 AI 面板。块之间靠拖拽标题栏重排悬停边缘调整大小布局即拖即得。一张完整的界面示例左侧终端、中间图表与网页、右侧 AI 面板都是同一个标签页里的块常用快捷键先记这 5 个完整清单见 快捷键文档Windows/Linux 上把 Cmd 换成 Alt快捷键作用CmdT新建标签页CmdN新建终端块CmdD/CmdShiftD向右 / 向下分块CmdW关闭当前块CtrlShift方向键在块之间移动焦点保存与切换工作区工作区不保存会随窗口关闭而丢失这是新手最容易踩的坑。保存点标签栏左侧的工作区切换器在底部点 Save workspace并给它起个可读的名字。切换在切换器列表里点选目标工作区或用CmdCtrl1~9直接跳到编号工作区。效果每个项目一套环境切回时标签、布局、终端历史都还原。更多细节见 工作区文档。日常提效的 4 个场景多终端管理构建、日志、调试各占一块场景一边跑前端服务一边盯构建日志还要留一个交互终端调试。关键操作是wsh run把命令丢进独立块不占当前终端wsh run -m -- npm run dev # 新块运行服务-m 让块最大化 wsh run -- tail -f app.log # 日志单独一块做完的效果多个任务并行互不干扰CtrlShift方向键即可在块间跳转CmdM把任一临时块全屏。文件预览不离开终端看 Markdown 和图片场景评审 README 或看目录结构不想切到编辑器或文件管理器。关键操作是wsh viewwsh view ~/projects # 打开目录浏览 wsh view README.md # Markdown 渲染视图支持 Markdown、图片、CSV、视频等格式块内按CmdE可在预览与编辑模式间切换CmdO在当前目录下打开其他文件。内置网页浏览本地服务和文档并排放场景开发服务器起好后直接在同屏查看不用开浏览器。关键操作是wsh web openwsh web open localhost:3000 # 打开本地服务 wsh web open 关键词 # 作为搜索词网页块支持前进后退Cmd←/→、页内搜索CmdF、书签CmdO与终端块并排放置时改代码和看效果在同一视线内完成。AI 问答把命令输出直接喂给助手场景排查报错时需要把dmesg或git diff的输出连同上下文一起分析。关键操作是管道进wsh aidmesg | wsh ai - -s -m 帮我分析这些报错 git diff | wsh ai - # 附加后在面板里再补充提问默认先附加不自动提交方便你补上下文加-s立即发送。模型可在 OpenAI、Claude、Gemini、Ollama 本地模型间切换无需注册账号配置入口见 Wave AI 文档。进阶技巧远程开发一键 SSH文件就地编辑场景日常维护几台远程服务器希望连接、编辑、传文件都不离开 Wave。关键操作是块标题栏的连接按钮或wsh sshwsh ssh -i ~/.ssh/mykey.pem devserver wsh edit /etc/nginx/nginx.conf wsh file cp ./app.yaml /~/backup/app.yaml # 远端拷到本地效果SSH 会话支持持久化断网或重启应用后自动重连wsh file用wsh://local/~/前缀在本地与远端间透明地读写文件命令参考见 wsh 文档。自定义组件把常用入口钉在侧边栏场景团队里每个人每天都要开同一套面板比如开发服务器、监控图表。在~/.waveterm/config/widgets.json里定义组件即可{ dev-server: { icon: play, label: 开发服务, blockdef: { meta: { view: term, controller: cmd, cmd: npm run dev } } } }效果右侧组件栏出现开发服务图标点击即开块也可以在终端里用wsh launch dev-server以脚本方式触发。组件的完整写法见 自定义组件文档。自动化工作流脚本 通知串起部署步骤场景本地脚本完成起容器 → 构建 → 通知的串联人不用守在终端前。核心是wsh run开独立块、wsh notify发系统通知wsh run -- docker compose up -d npm run build wsh notify 构建完成 || wsh notify 构建失败 wsh setvar -b workspace DEPLOY_ENVstaging效果长任务在独立块中执行失败时系统级通知直接弹出来setvar/getvar让变量在块、标签页、工作区间传递多个终端块之间共享状态。常见问题速答Q按住什么键能看到块编号按住CtrlShift即显示 1-9 编号松开消失随后CtrlShift数字可跳到对应块。Q在 Wave 外面的系统终端里wsh不可用正常吗正常。wsh是 Wave 的内部命令依赖应用下发的访问令牌只在 Wave 窗口内的终端生效。Q新建的窗口关掉后布局全没了未保存的工作区随窗口关闭删除。点工作区切换器底部的 Save workspace 保存之后用CmdCtrl1~9在窗口间切换。Q远程终端断网后还要重连吗不用。持久 SSH 会话在断线、换网甚至应用重启后自动重连连接入口是块标题栏的连接按钮输入userhost即可。QmacOS 上启动时提示 ARM64 翻译警告当前跑的是 x64 版本。按 安装文档 重装与你的芯片匹配的架构版本即可或在配置中设置app:dismissarchitecturewarning屏蔽提示。收尾一个窗口装下终端、预览、网页与 AIWaveTerm 适合想把切换成本降到最低的开发者。更多资料官方文档 · wsh 命令参考 · wsh 源码【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考