Wave Terminal：5 分钟上手的完整指南

Wave Terminal：5 分钟上手的完整指南

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

Wave Terminal 是一款开源跨平台终端，把终端、文件预览、网页浏览器和 AI 助手放进同一个窗口。它解决"命令行和图形界面反复切换"的痛点，适合开发者、运维和需要频繁远程连接的用户。

• 5 分钟内装好，打开即用
• 拖拽块布局，终端、日志、文档、网页同屏
• 持久化 SSH 会话，远端长任务不怕断网
• 自带 AI 助手，自带 API key 或本地模型即可用
• 右侧组件栏一键打开自定义组件

快速上手：装好并看到第一个结果

macOS、Windows、Linux 都有官方包管理器安装，5 分钟装完。

首次打开，默认启动一个本地终端，直接就能敲命令。界面以"块"为单位：每个格子独立跑终端、看文件、开网页或聊天。最常用的几个快捷键：

• 新建标签页：Cmd/Alt+T，新建块：Cmd/Alt+N
• 显示块编号：Ctrl+Shift，然后Ctrl+Shift:1~9切焦点
• 放大或恢复块：Cmd/Alt+M，关闭当前块：Cmd/Alt+W

第一次打开就能拿到的最小成功体验：在终端输入下面这行。

wsh view ~/

目录树在图形块里打开，点文件即可预览。再输入wsh web open wikipedia.org，网页块秒开。5 分钟内，你已经在终端里看见了文件树和网页。

它是能读懂终端上下文的 AI 助手，叫 Wave AI。自带 OpenAI、Claude、Gemini 的 API key，或接 Ollama 跑本地模型，无需注册账号。Cmd/Alt+Shift+A打开面板，Ctrl+Shift:0直达输入框。配置细节见 AI 助手文档。

日常怎么用：三个高频场景

Wave Terminal 的块可以任意组合，下面三个场景覆盖了大多数日常需求。

改代码的同时盯构建日志

Cmd/Alt+D在当前块右侧新开一个块。一个块跑npm run dev，一个块跑npm run build，用Ctrl+Shift:2切焦点，输出互不干扰。编译报错一眼就能看到，不会漏在滚屏里。

连上远程服务器跑长任务

点块标题上的连接按钮，输入user@host即可 SSH。长任务前先执行：

wsh setmeta term:durable=true

远端会话从此常驻，掉线、重启都不丢，重连自动接回。远端终端里同样支持wsh view、wsh edit，直接看目录、改配置文件，改动保存前会弹确认。

不离开终端预览本地文档

wsh view docs/design.md

Markdown、图片、视频、CSV、目录都能直接预览。Markdown 和 CSV 里按Cmd/Alt+E切换预览和编辑，Cmd/Alt+S保存，Cmd/Alt+R撤销。写文档不再需要切到别的软件。

效率进阶

右侧组件栏默认有终端、文件、网页、AI、sysinfo 五个组件，你可以往里面加自己的。

在组件栏加一个 CPU 监控卡片

编辑~/.config/waveterm/config/widgets.json，加入：

{ "cpu": { "icon": "chart-line", "label": "CPU", "blockdef": { "meta": { "view": "sysinfo", "sysinfo:type": "CPU" } } } }

保存后组件栏多出一个 CPU 按钮，点一下打开监控块。完整字段说明见 自定义组件教程。

给 SSH 会话加持久化保护

这是 Wave Terminal 内置的远端守护会话，效果类似 tmux，但不用手动开。

wsh setmeta term:durable=true

执行后块标题出现盾牌图标。之后断网、合盖、重启 Wave Terminal，远端的编译、爬虫、日志抓取都照常运行；网络恢复后自动接回原会话。配置层级说明见 持久化会话文档。

少走弯路

下一步

• 快速上手：docs/docs/gettingstarted.mdx
• wsh 全量命令：docs/docs/wsh-reference.mdx
• 自定义组件：docs/docs/customwidgets.mdx
• 快捷键大全：docs/docs/keybindings.mdx

装好它，把wsh view和持久化会话各跑一遍，你会想不出以前是怎么切窗口度日的。

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