WaveTerm 跨平台 AI 终端上手指南：5 步从安装到远程开发工作流

WaveTerm 跨平台 AI 终端上手指南5 步从安装到远程开发工作流【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/wavetermWaveTerm 是一款开源的跨平台 AI 终端macOS、Windows、Linux 全支持内置能读取终端输出的 AI 助手、可拖拽的图形块布局以及能穿越断网的持久 SSH 会话。本文按真实使用场景组织带你在约 8 分钟内跑通安装、布局、wsh 命令、远程连接和 AI 助手这五个环节。三种包管理器装到 Mac、Windows 和 Linux先确认系统门槛macOS 11Apple Silicon / x64、Windows 10 1809x64、Linux 需 glibc 2.28 以上Debian 10、RHEL 8、Ubuntu 20.04 起步x64 和 ARM64 均可。按平台选一条命令即可装完打开应用就是一条正常终端# macOSHomebrew 一条命令装好 brew install --cask wave# Windows用 winget 或 Chocolatey 任选其一 winget install CommandLine.Wave choco install wave# LinuxSnap 官方包Arch 用户可走社区维护的 AUR 包 sudo snap install --classic waveterm想要最新开发版就从源码构建安装 BUILD.md 列出的依赖Go、Node 22 LTS、TaskLinux 还需 Zig然后克隆仓库git clone https://gitcode.com/GitHub_Trending/wa/waveterm cd waveterm task init # 首次克隆后加载依赖构建出问题时重新跑一次 task dev # 启动带热更新的开发版第一次打开标签、块和一条命令三件套新标签页默认只有一个终端块用法和普通终端没区别。WaveTerm 的差异在于界面上每个格子都是一个块Block终端、文件预览、网页、AI 面板、系统监控都是同一种块可以随意拼装。打开终端先敲这三条命令感受命令行驱动图形界面的思路wsh view ~/Documents # 在块里预览目录像文件管理器 wsh web open github.com # 新开一个网页块 wsh ai -m how do I find large files in my current directory? -s # 把问题发给 AI 并自动提交wsh是 WaveTerm 的核心命令后面几节都会反复用到。完整命令清单见 docs/docs/wsh-reference.mdxwsh 功能总览见 docs/docs/wsh.mdx。拖一拖、按一按把布局改成你想要的样子块标题栏可以直接拖动换位置指针悬停在块边缘能拉出分割线调整大小纯键盘党只需要记这几组macOS 为 CmdWindows/Linux 换成 AltCtrl 不变快捷键作用CmdT/CmdN新建标签页 / 新建终端块CmdD/CmdShiftD向右水平分割 / 向下垂直分割CtrlShift方向键在块之间移动焦点按住 CtrlShift 还能显示块编号CmdM当前块放大/还原全屏看日志很方便CmdW/CmdShiftW关闭当前块 / 当前标签页Cmd1~9切到对应编号的标签页CmdCtrl1~9切换到对应编号的工作区完整列表含文件预览、网页、AI 面板各场景的快捷键在 docs/docs/keybindings.mdx。用 wsh 把命令隔离到独立块里wsh run是日常开发最顺手的用法把命令丢进独立块主终端保持干净。# 命令跑完自动关块适合 npm test 这类一次性任务 wsh run -x -- npm test # 新开块并放大显示跑长期进程如开发服务器 wsh run -m -- npm run devwsh还能在会话之间传状态变量存在本地、跨终端块持久wsh setvar DEPLOY_ENVstaging # 存一个变量 curl -H Authorization: $(wsh getvar API_KEY) https://api.example.com # 取出来用不离开终端看文件预览和编辑wsh view支持目录、Markdown、图片、CSV、PDF、视频wsh edit打开带语法高亮的内置编辑器远程机器上的文件同样能改wsh view README.md # 渲染 Markdown 预览 wsh view -m README.md # 放大模式打开 wsh edit config.json # 用内置编辑器修改文件预览块内的导航快捷键输入字符过滤文件列表CmdO打开新文件CmdE在预览和编辑模式间切换CmdS保存。详见 docs/docs/keybindings.mdx。连上远程机器SSH、WSL 和断线重连点块标题栏的连接图标laptop 形状输入userhost或userhost:port即连。它会自动读取你的~/.ssh/config连接成功后还会写进内部连接列表下次直接从下拉菜单选三个值得知道的点持久会话开启 durable 模式后SSH 终端会话能扛住断网、网络切换甚至应用重启自动重连。相关实现见 pkg/blockcontroller/durableshellcontroller.go配置项为term:durable。远程也装 wsh连接时 WaveTerm 会询问是否在远程机安装 wsh 助手装到~/.waveterm/bin/wsh。装好后远程机上的文件预览、系统监控都能用还能反向操作本机的块。文件互传远程终端里用wsh file就能搬文件wsh://local/~/前缀指向你本机wsh file cp /~/config/app.json ./app.json # 从本机复制文件到远程 wsh file cp ./results.txt /~/results.txt # 把远程结果带回本机Windows 上还支持wsl://发行版名直接连 WSL 发行版。连接机制详解见 docs/docs/connections.mdx。让 AI 看懂你的终端Wave AI 面板按CmdShiftA唤出 AI 面板聚焦输入框CtrlShift:0CmdK清空开新会话。关键开关是 Widget Context打开AI 可读终端输出和回滚缓冲、截取任意块的截图做视觉分析、在批准后可编辑文件、操作网页块——调错、分析代码、处理工作区任务就用它。关掉AI 只看你的消息和附件适合普通问答。所有文件读写都走显式批准你在命令行也能把内容直接喂给它git diff | wsh ai - # 把 diff 管道给 AI wsh ai main.go -m find bugs # 附带文件提问 wsh ai $(tail -n 500 my.log) -m review -s # 取日志末尾自动提交模型方面默认带免费 AI 额度beta也支持 BYOK 接 OpenAI、Claude、Gemini、Azure、Perplexity 等或走 Ollama、LM Studio 等本地模型聊天数据不出本机。多模型模式和 BYOK 配置见 docs/docs/waveai-modes.mdx。自定义组件栏一键启动你的常用工具右侧组件栏里的每个图标都是一个组件。改一下WAVETERM_HOME/config/widgets.json就能加自己的下面的例子让按钮一键启动一个 CPU 监控块和一个文档网页块{ system-monitor: { icon: chart-line, label: CPU Mem, color: #4CAF50, blockdef: { meta: { view: sysinfo, sysinfo:type: CPU Mem } } }, mdn-docs: { icon: book, label: MDN, blockdef: { meta: { view: web, url: https://developer.mozilla.org } } } }组件还支持跑指定命令的终端块controller: cmd可配刷新按钮、工作目录、环境变量等字段说明在 docs/docs/customwidgets.mdx。卡住了先看这里改配置配置文件在~/.config/waveterm/settings.json用wsh editconfig直接在内置编辑器里打开。常用键term:fontsize、term:theme、term:scrollback回滚上限 10000、app:globalhotkey全局热键唤起最近窗口、term:durable持久会话。键值表见 docs/docs/config.mdx。布局/工作区窗口左上角的工作区切换器可以保存整组标签页和布局CmdCtrl1~9快速切换规则见 docs/docs/workspaces.mdx。远程块右上角出现断链小图标说明远程没装上 wsh该会话降级运行重连时再允许安装即可。构建问题按 BUILD.md 重新跑task init。想提需求或报 bug仓库用 Issue 跟踪贡献流程见 CONTRIBUTING.md。下一步建议装好后先试wsh run -m -- npm run dev感受独立块 放大的工作流再接一根 SSH 并打开term:durable——这两件事跑通WaveTerm 就基本融入你的日常了。它解决的核心问题只有一个让你在终端里完成预览、浏览、编辑和 AI 协作不用再切窗口。【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考