1. 项目定位与用途
Wave Terminal 是一款开源的 AI 原生跨平台终端应用，由 Command Line Inc 开发。其定位是为开发者提供一体化、无缝的命令行工作环境，通过深度集成人工智能能力、持久远程连接和现代化界面设计，取代传统孤立工具的拼接。Wave 不仅是一个终端模拟器，更是一个智能工作台，支持在单一应用中完成命令执行、代码编辑、文件预览、远程管理和 AI 辅助等多种任务，从而提升开发效率和体验。项目遵循 Apache-2.0 许可证，完全开放源代码。
项目档案应用项目
Wave Terminal：开源 AI 集成跨平台终端，提供智能助手、持久 SSH 与内置编辑器，提升开发效率
wavetermdev/waveterm：Wave 是一款开源的 AI 原生跨平台终端，集成多种 AI 模型助手，提供持久 SSH 会话和内置编辑器，旨在为开发者打造无缝、高效的一体化命本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Wave 是一款开源的 AI 原生跨平台终端，集成多种 AI 模型助手，提供持久 SSH 会话和内置编辑器，旨在为开发者打造无缝、高效的一体化命令行工作环境。
中文项目介绍
Wave Terminal 是由 wavetermdev 开发的开源 AI 集成终端，支持 macOS、Linux 和 Windows 系统。它旨在解决传统终端功能孤立、缺乏智能辅助、远程工作体验差等问题，将 AI 能力、持久连接、文件编辑与预览深度集成，提供统一高效的工作环境。
核心功能包括：Wave AI 上下文感知助手（可读取终端输出、分析小部件、执行文件操作），持久 SSH 会话（断线自动重连），灵活的拖放式多块界面（组织终端、编辑器、AI 助手等），内置远程文件编辑器（语法高亮），丰富文件预览（markdown、图像、视频、PDF、CSV），以及强大的 wsh 命令行工具（管理 workspace 和会话间数据共享）。
技术架构采用混合模式：Go 后端处理系统级操作（如 pty、ssh、文件 I/O），Electron 壳结合 React+TypeScript 前端，通过 xterm.js 实现终端核心。配置系统使用扁平 JSON，通过 wsh 命令管理。AI 层抽象多提供商支持，包括 OpenAI、Claude、Gemini、Azure 及本地模型（Ollama、LM Studio）。
适用场景涵盖开发者日常命令行工作、远程服务器管理、AI 辅助代码调试、多任务并行处理，以及跨平台统一终端体验。安装需从官网下载安装包，平台要求为 macOS 11+、Windows 10 1809+、Linux glibc-2.28+。详细使用方式包括图形界面操作、wsh 命令调用、SSH 连接建立和 AI 配置等，具体参考官方文档。
详细信息与使用说明
2. 核心功能与解决的问题
Wave 解决了传统终端功能单一、缺乏上下文感知、远程操作不便等痛点。关键功能包括：Wave AI 助手，能读取终端输出和滚动历史，进行调试分析，并执行文件操作（需用户批准）；持久 SSH 会话，基于 WebSocket mux 实现，确保网络中断或应用重启后自动重连，保持会话状态；内置图形编辑器，支持远程文件编辑和语法高亮；丰富文件预览，直接在终端内查看 markdown、图像、视频、PDF、CSV 和目录；灵活拖放界面，可自由组织终端块、编辑器、浏览器和 AI 小部件；以及 wsh 命令行系统，实现 workspace 管理和会话间数据共享。这些功能共同消除了在多工具间切换的需要，提供了连贯高效的工作流。
3. 适用场景
Wave 适用于多种开发场景：日常命令行工作与脚本执行，提供现代化终端体验；远程服务器管理，通过持久 SSH 会话和内置编辑器实现无缝远程文件操作；AI 辅助编程，利用 Wave AI 进行代码调试、输出分析和文件修改；多任务并行处理，利用拖放界面同时运行多个终端、编辑器和预览窗口；跨平台统一环境，在 macOS、Linux 和 Windows 上获得一致体验。此外，对于需要将 AI 能力融入命令行流程的团队，Wave 的 BYOK（自带密钥）模式和本地模型支持提供了灵活、隐私友好的选择。
4. 安装方式
Wave Terminal 支持 macOS、Linux 和 Windows 三平台。安装需从官方下载页面获取安装包：https://www.waveterm.dev/download。平台最低要求：macOS 11 或更高版本（arm64/x64）；Windows 10 1809 或更高版本（x64）；Linux 基于 glibc-2.28 或更高版本（如 Debian 10、RHEL 8、Ubuntu 20.04+），支持 arm64 和 x64 架构。WSH 命令行助手有单独要求：macOS 11+、Windows 10+、Linux 内核 2.6.32+ (x64) 或 3.1+ (arm64)。平台特定的详细安装步骤请参考官方文档：https://docs.waveterm.dev/gettingstarted。仓库中未提供命令行安装脚本，需手动下载安装。
5. 使用方式
启动 Wave 后，用户可通过图形界面拖放组织终端块、编辑器、Web 浏览器和 AI 助手小部件，实现灵活布局。任意块可一键全屏切换，便于专注任务。SSH 连接通过一键操作建立，会话自动持久化并支持断线重连。AI 功能需配置 API 密钥或本地模型端点（如 Ollama），支持 OpenAI、Claude、Gemini、Azure 和 Perplexity 等提供商。命令行工具 wsh 提供强大集成：使用 `wsh ai` 将输出管道给 AI 或附加文件，`wsh file` 在本地和远程主机间复制同步文件，`wsh editconfig` 编辑配置文件，`wsh setconfig` 修改设置。主配置文件位于 ~/.config/waveterm/settings.json，AI 预设位于 ~/.config/waveterm/presets/ai.json。详细用法参考官方文档中的配置、连接、自定义等指南。
6. 实现特点与架构
Wave 采用混合架构：后端使用 Go 语言处理系统级操作（伪终端、SSH、文件 I/O），前端基于 Electron 壳和 React+TypeScript 构建，通过 xterm.js 实现终端核心。前端使用 Vite 构建工具，代码模块化，路径别名组织。配置系统采用扁平化 JSON 结构，通过 wsh 命令行工具管理，支持热重载。AI 层抽象多提供商 SDK，支持云端 API 和本地模型（Ollama、LM Studio 等 OpenAI 兼容端点）。持久 SSH 引擎基于 gorilla/websocket 和 mux 实现，确保会话可靠性和自动重连。项目通过 electron-builder 打包，支持三平台分发。整体设计注重性能、安全（原生密钥存储）和可扩展性。
思维导图
Wave Terminal
Wave AI
终端上下文读取
文件操作
CLI 集成 (wsh ai)
BYOK 支持
本地模型 (Ollama)
持久 SSH 会话
断线自动重连
网络变化恢复
基于 WebSocket mux
内置编辑器
远程文件编辑
语法高亮
现代编辑器特性
文件预览系统
Markdown
图像/视频
PDF/CSV
目录预览
块管理界面
拖放组织
全屏切换
多块并行
WSH 命令行系统
workspace 管理
数据共享
配置编辑 (wsh editconfig)
跨平台支持
macOS 11+
Windows 10 1809+
Linux glibc-2.28+
常见问题
Wave Terminal 支持哪些操作系统和架构？
Wave 支持 macOS 11+（arm64/x64）、Windows 10 1809+（x64）以及基于 glibc-2.28+ 的 Linux 发行版（如 Debian 10、RHEL 8、Ubuntu 20.04+），提供 arm64 和 x64 架构版本。WSH 命令行助手另有要求：macOS 11+、Windows 10+、Linux 内核 2.6.32+（x64）或 3.1+（arm64）。
如何配置 Wave 的 AI 功能？
Wave AI 支持自带 API 密钥（OpenAI、Claude、Gemini、Azure、Perplexity 等）或本地模型（通过 Ollama、LM Studio 等 OpenAI 兼容端点）。配置可通过图形界面或编辑配置文件（~/.config/waveterm/settings.json）完成，无需创建账户。测试阶段包含免费 AI 积分，但使用第三方服务可能产生费用。
SSH 会话的持久性是如何实现的？
Wave 使用基于 WebSocket mux 的持久化引擎，确保远程终端会话在连接中断、网络变化或应用重启后能自动重连，保持会话状态不丢失。这得益于后端 Go 代码中的 mux/websocket 实现和会话管理机制。
是否可以在终端内直接编辑和预览远程文件？
可以。Wave 内置图形编辑器支持远程文件编辑，具备语法高亮和现代编辑器特性；同时提供丰富的文件预览系统，可直接在终端内查看 markdown、图像、视频、PDF、CSV 及目录内容，无需离开应用。
Wave 是免费软件吗？如何获取？
Wave 是开源软件，遵循 Apache-2.0 许可证，可免费使用。获取方式为从官网下载安装包：https://www.waveterm.dev/download。仓库中未提供命令行安装脚本，需手动下载安装。详细平台安装指南见官方文档。