Wave Terminal

Wave 是一款开源的、集成 AI 的终端，适用于 macOS、Linux 和 Windows。它可与任何 AI 模型配合使用。您可以使用 OpenAI、Claude 或 Gemini 的 API 密钥，也可以通过 Ollama 和 LM Studio 运行本地模型。无需注册账号。

Wave 还支持持久的 SSH 会话，即使在网络中断或系统重启后也能保持连接，并自动重新连接。您还可以使用内置的图形化编辑器编辑远程文件，并在不退出终端的情况下直接预览文件内容。

核心功能

• Wave AI：上下文感知的终端助手，能够读取终端输出、分析窗口小部件并执行文件操作。
• 持久的 SSH 会话：远程终端会话可在连接中断、网络变化或 Wave 重启后自动重新连接，始终保持可用。
• 灵活的拖放界面：可自由组织终端区块、编辑器、网页浏览器和 AI 助手。
• 内置编辑器：支持语法高亮和现代编辑器功能，方便编辑远程文件。
• 丰富的文件预览功能：支持 Markdown、图片、视频、PDF、CSV 和目录等格式的远程文件预览。
• 快速全屏切换：可将任意区块切换为全屏模式，以便更好地查看终端、编辑器或预览内容，随后立即恢复多区块视图。
• AI 聊天窗口：支持多种模型（OpenAI、Claude、Azure、Perplexity、Ollama 等）。
• 命令区块：用于隔离和监控单个命令。
• 一键远程连接：提供完整的终端和文件系统访问权限。
• 安全的密钥存储：利用系统原生后端安全地存储 API 密钥和凭据，在所有 SSH 会话中均可访问。
• 丰富的自定义选项：包括标签页主题、终端样式和背景图片等。
• 强大的 wsh 命令系统：可通过 CLI 管理工作空间，并在不同终端会话之间共享数据。
• 连接式文件管理：通过 wsh file 命令，可在本地主机和远程 SSH 主机之间无缝复制和同步文件。

Wave AI

Wave AI 是您的上下文感知终端助手，可访问您的工作空间：

• 终端上下文：读取终端输出和滚动缓冲区，用于调试和分析。
• 文件操作：读取、写入和编辑文件，具备自动备份和用户确认功能。
• CLI 集成：使用 wsh ai 命令，可直接从命令行传递输出或将文件附加到 AI 请求中。
• BYOK 支持：您可以使用自己的 OpenAI、Claude、Gemini、Azure 等提供商的 API 密钥。
• 本地模型：可通过 Ollama、LM Studio 等兼容 OpenAI 的工具运行本地模型。
• 免费试用期：在我们优化体验期间，您可享受免费的 AI 使用额度。
• 即将推出：命令执行功能（需用户批准）。

更多信息请参阅我们的 Wave AI 文档 和 Wave AI 模式文档。

安装

Wave Terminal 适用于 macOS、Linux 和 Windows。

平台特定的安装说明请参见 这里。

您也可以直接从以下链接下载 Wave Terminal：www.waveterm.dev/download。

最低系统要求

Wave Terminal 可在以下平台上运行：

• macOS 11 或更高版本（arm64、x64）
• Windows 10 1809 或更高版本（x64）
• 基于 glibc-2.28 或更高版本的 Linux 发行版（如 Debian 10、RHEL 8、Ubuntu 20.04 等）（arm64、x64）

WSH 辅助程序可在以下平台上运行：

• macOS 11 或更高版本（arm64、x64）
• Windows 10 或更高版本（x64）
• Linux 内核 2.6.32 或更高版本（x64）、3.1 或更高版本（arm64）

路线图

Wave 不断改进！我们的路线图会随着每个版本的目标持续更新。您可以在 这里 查看最新内容。

希望为我们的未来版本提供建议吗？欢迎加入我们的 Discord 社区，或提交一个 功能请求！

链接

• 官网 — https://www.waveterm.dev
• 下载页面 — https://www.waveterm.dev/download
• 文档 — https://docs.waveterm.dev
• X 平台 — https://x.com/wavetermdev
• Discord 社区 — https://discord.gg/XfvZ334gwU

从源码构建

详情请参阅 构建 Wave Terminal。

贡献

Wave 使用 GitHub Issues 进行问题跟踪。

更多信息请参阅我们的 贡献指南，其中包括：

• 贡献方式
• 贡献规范

赞助 Wave ❤️

如果您或您的公司觉得 Wave Terminal 很有帮助，请考虑赞助开发工作。

赞助有助于支持项目开发和维护所需的时间投入。

• https://github.com/sponsors/wavetermdev

许可证

Wave Terminal 采用 Apache-2.0 许可证授权。有关依赖项的更多信息，请参阅 此处。

Wave Terminal 快速上手指南

Wave Terminal 是一款开源的、集成 AI 功能的现代化终端，支持 macOS、Linux 和 Windows。它允许用户接入各类 AI 模型（如 OpenAI、Claude、Gemini 或本地 Ollama 模型），并提供持久的 SSH 会话、内置文件编辑器及丰富的文件预览功能。

环境准备

系统要求

在开始之前，请确保您的操作系统满足以下最低要求：

• macOS: 11 或更高版本 (支持 arm64, x64)
• Windows: 10 1809 或更高版本 (x64)
• Linux: 基于 glibc-2.28 或更高版本的发行版 (如 Debian 10, RHEL 8, Ubuntu 20.04 等)，支持 arm64 和 x64。

前置依赖

• WSH 助手环境：若需在远程主机使用高级功能，远程主机需满足：
  • Linux Kernel 2.6.32+ (x64) 或 3.1+ (arm64)
  • macOS 11+ 或 Windows 10+
• AI 模型访问（可选）：如需使用 AI 功能，请准备好以下任一服务的 API Key，或安装本地模型运行环境：
  • 云服务：OpenAI, Claude, Gemini, Azure, Perplexity
  • 本地服务：Ollama, LM Studio

安装步骤

Wave Terminal 提供图形化安装包，推荐直接通过官网下载。

方法一：官网下载安装（推荐）

访问官方下载页面获取对应系统的安装包： https://www.waveterm.dev/download

• macOS: 下载 .dmg 文件并拖入应用程序文件夹。
• Windows: 下载 .exe 安装程序并运行。
• Linux:
  • Debian/Ubuntu: 下载 .deb 包并使用 sudo dpkg -i waveterm_*.deb 安装。
  • RHEL/Fedora: 下载 .rpm 包并使用 sudo rpm -ivh waveterm-*.rpm 安装。
  • 通用：也可下载 .AppImage 文件直接运行。

方法二：命令行安装 (Linux/macOS)

如果您偏好命令行，可以使用以下脚本快速安装（需确保已安装 curl）：

curl -fsSL https://waveterm.dev/install.sh | sh

基本使用

1. 启动与界面概览

安装完成后，启动 Wave Terminal。界面采用模块化设计，您可以自由拖拽排列终端块、编辑器、网页浏览器和 AI 助手窗口。

• 全屏切换：双击任意模块标题栏或使用快捷键可快速全屏查看，再次操作即可返回多视图模式。

2. 配置 AI 助手

Wave 支持“自带密钥”（BYOK）模式，无需注册额外账号。

1. 点击界面中的 AI Chat 小部件。
2. 选择模型提供商（如 OpenAI, Claude, Ollama 等）。
3. 输入您的 API Key。密钥将利用系统原生后端安全存储，并可跨 SSH 会话共享。
4. 本地模型示例：若您已运行 Ollama，直接在模型列表中选择本地模型即可开始对话。

3. 使用持久化 SSH 连接

Wave 的 SSH 会话具有“耐久性”，网络中断或软件重启后会自动重连，保持会话状态。

• 连接远程主机： 在终端中直接输入标准 SSH 命令：

  ssh user@remote-host
  

  连接成功后，您将自动获得完整的终端和文件系统访问权限。

• 编辑远程文件： 无需退出终端，直接使用内置编辑器打开远程文件：

  wave edit /path/to/remote/file.py
  

  或者在文件预览块中直接查看 Markdown、图片、PDF、CSV 等文件。

4. 核心命令 (wsh)

Wave 提供了强大的 wsh 命令系统，用于管理工作区和数据同步。

• AI 管道输出：将命令输出直接发送给 AI 分析：

  ls -la | wsh ai "检查是否有异常大文件"
  

• 文件同步：在本地和远程主机间无缝复制文件：

  wsh file copy ./local-config.yaml user@remote-host:/etc/app/config.yaml
  

5. 自定义主题

点击设置图标，您可以更换标签页主题、终端样式以及背景图片，打造个性化的工作环境。