Wave Terminal 开发速查表
版本unknown 更新日志2025-12-23 GitHubwavetermdev/waveterm
340px

🚀 快速开始 >>>

📦 平台要求

  • 架构：x64（ARM64计划中，目前受上游依赖限制）
  • Windows：Windows 10 1809 或更高版本、Windows 11
  • macOS：支持 Homebrew 安装
  • Linux：支持 npm 安装

📦 安装

# Windows Package Manager
winget install CommandLine.Wave

# Chocolatey
choco install wave

# 使用 Homebrew 安装 (macOS)
brew install waveterm

# 使用 Scoop 安装 (Windows)
scoop install waveterm

# 从官方网站直接下载
# 访问 https://waveterm.dev/downloads 下载安装程序

🎯 基础操作

# 启动 Wave Terminal
waveterm

# 创建新标签页
Alt + T

# 创建新终端块
Alt + N

🌐 快速命令

# 查看文件或目录
wsh view ~/Documents

# 打开网页
wsh web open github.com

# 获取 AI 帮助
wsh ai -m "如何在当前目录查找大文件？" -s
💡 Wave Terminal 是一个现代化的终端，支持图形化组件、web浏览和AI辅助功能，GPU加速渲染

🧩 核心概念 >>>

📑 Tabs (标签页)

  • 标签页：用于组织相关的工作内容
  • 多标签管理：支持同时打开多个标签页
  • 独立工作区：每个标签页是独立的工作环境

🧱 Blocks (块)

  • 终端块：运行命令行工具和脚本
  • Web浏览器块：内置浏览器查看网页
  • 文件预览块：预览各种文件类型
  • 图形组件块：显示图表、图像等

🎨 布局系统

# 拖拽调整块位置
鼠标拖拽块标题栏

# 调整块大小
拖拽块边缘

# 分割块
右键 -> Split Horizontal/Vertical

# 关闭块
右键 -> Close Block

# 查看块编号
Ctrl+Shift
💡 Tabs 和 Blocks 是 Wave Terminal 的核心组织单元，支持灵活的布局定制

⌨️ 键盘快捷键 >>>

📑 标签页操作

  • Alt + T：新建标签页
  • Alt + W：关闭当前标签页
  • Alt + Tab：切换到下一个标签页
  • Alt + Shift + Tab：切换到上一个标签页
  • Alt + 1-9：切换到指定标签页

🧱 块操作

  • Alt + N：新建终端块
  • Alt + Shift + W：关闭当前块
  • Alt + Shift + [：切换到上一个块
  • Alt + Shift + ]：切换到下一个块

🖱️ 导航操作

  • Alt + K：打开命令面板
  • Alt + F：在当前块中搜索
  • Alt + L：清空终端
  • Alt + C：复制选中内容
  • Alt + V：粘贴内容
  • Ctrl + Shift + 箭头键：导航widgets

🔄 视图操作

  • Alt + B：切换侧边栏
  • F11：全屏模式
  • Alt + +：放大
  • Alt + -：缩小
  • Alt + Shift + A：切换AI面板可见性
  • Alt + 0：聚焦AI输入
💡 使用快捷键可以大幅提升工作效率，建议熟悉常用快捷键

🛠️ wsh 命令 >>>

👁️ view - 查看内容

# 在 GUI 中查看文件
wsh view /path/to/file.txt

# 在 GUI 中查看目录
wsh view ~/Documents

# 查看远程文件
wsh view user@remote-server:/path/to/file.txt

🌐 web - Web 浏览器

# 打开网页
wsh web open github.com

# 打开特定 URL
wsh web open https://docs.waveterm.dev

# 搜索
wsh web open https://google.com/search?q=waveterm

✏️ edit - 编辑文件

# 在 GUI 中编辑文件
wsh edit /path/to/file.txt

# 编辑配置文件
wsh edit ~/.bashrc

# 编辑 JSON 文件
wsh edit config.json

📋 getmeta - 获取元数据

# 获取文件元数据
wsh getmeta /path/to/file.txt

# 获取目录元数据
wsh getmeta /path/to/directory

# 获取 URL 元数据
wsh getmeta https://example.com

📝 setmeta - 设置元数据

# 设置文件元数据
wsh setmeta /path/to/file.txt --key "author" --value "John"

# 设置多个元数据
wsh setmeta file.txt --key "category" --value "docs" \
  --key "priority" --value "high"

🔗 connection - 管理连接

# 列出所有连接
wsh connection list

# 添加新连接
wsh connection add --name "my-server" --type "ssh" --host "example.com" --user "username"

# 删除连接
wsh connection delete --name "my-server"

# 连接到服务器
wsh connection connect --name "my-server"
💡 wsh 命令是 Wave Terminal 的命令行工具，用于与 GUI 功能交互

⚡ wsh 高级命令 >>>

🤖 ai - AI 助手

# 使用 AI 助手
wsh ai -m "帮我解释这段代码" -s

# AI 代码审查
wsh ai -m "审查这个文件" -s script.py

# AI 生成代码
wsh ai -m "创建一个 Python HTTP 服务器" -s

⚙️ editconfig - 编辑配置

# 打开配置编辑器
wsh editconfig

# 编辑特定配置
wsh editconfig --key "theme" --value "dark"

# 重置配置
wsh editconfig --reset

🎨 setbg - 设置背景

# 设置背景图片
wsh setbg /path/to/image.png

# 设置背景颜色
wsh setbg --color "#1a1a2e"

# 重置背景
wsh setbg --reset

▶️ run - 运行命令

# 在新块中运行命令
wsh run "npm install"

# 在指定标签页运行
wsh run --tab 2 "ls -la"

# 后台运行
wsh run --background "npm start"
💡 wsh 命令支持丰富的参数选项，使用 wsh --help 查看完整帮助

🌐 远程连接 >>>

🔌 通过连接按钮连接

# 点击连接按钮
# 在界面中点击连接按钮

# SSH 连接
# 输入 username@hostname

# WSL 连接（Windows）
# 选择 WSL 发行版

🔌 SSH 连接

# SSH 连接到远程服务器
ssh user@remote-server

# 使用 SSH 配置
ssh my-server

# 指定端口连接
ssh -p 2222 user@remote-server

🪟 WSL 连接

# 连接到 WSL
wsl

# 连接到特定发行版
wsl -d Ubuntu-22.04

# 在 WSL 中运行命令
wsl -- ls -la

📁 远程文件浏览

# 挂载远程文件系统
sshfs user@remote-server:/path /local/mount

# 使用 wsh 查看远程文件
wsh view user@remote-server:/path/to/file.txt

☁️ AWS S3 连接

# 连接到 AWS S3 存储桶
# 在界面中点击连接按钮，选择 S3 选项
# 输入 AWS 凭证和存储桶信息

# 使用 wsh 查看 S3 文件
wsh view s3://my-bucket/path/to/file.txt

🔑 SSH 密钥管理

# 生成 SSH 密钥
ssh-keygen -t ed25519 -C "your_email@example.com"

# 复制公钥到远程服务器
ssh-copy-id user@remote-server

# 查看 SSH 配置
cat ~/.ssh/config
💡 Wave Terminal 原生支持 SSH 和 WSL，可无缝连接远程环境

🎨 图形化功能 >>>

🌐 内置浏览器

# 打开 Web 浏览器块
Ctrl/Cmd + Shift + W -> 选择 Web Browser

# 使用 wsh 打开网页
wsh view https://docs.waveterm.dev

# 在浏览器中预览本地文件
wsh view index.html

📄 文件预览

# 预览图片
wsh view image.png

# 预览 PDF 文件
wsh view document.pdf

# 预览 Markdown 文件
wsh view README.md

📊 图表可视化

# 使用 wsh 查看图表数据
wsh view data.json

# 预览 CSV 数据
wsh view data.csv

# 查看日志文件
wsh view app.log

🖼️ 图像处理

# 在 GUI 中查看图像
wsh view screenshot.png

# 批量查看图像
wsh view images/*.jpg

# 查看图像元数据
wsh getmeta photo.jpg
💡 Wave Terminal 支持多种文件类型的图形化预览，无需离开终端

🤖 AI 辅助功能 >>>

💬 AI 聊天

# 启动 AI 聊天
wsh ai

# 询问问题
wsh ai "如何使用 Git 合并分支？"

# 代码解释
wsh ai "解释这段代码的作用"

🔍 代码审查

# AI 代码审查
wsh ai --review script.py

# 检查代码问题
wsh ai --check /path/to/code.js

# 优化建议
wsh ai --optimize function.py

📊 AI 访问权限

  • 终端输出：AI 可以访问当前终端的输出内容（需批准）
  • Widget 截图：AI 可以查看当前打开的 widget 内容（需批准）
  • 文件/目录：AI 可以访问指定的文件或目录内容（需批准）

✨ 代码生成

# 生成代码
wsh ai --generate "创建一个 Flask API"

# 生成测试代码
wsh ai --test "为这个函数生成单元测试"

# 生成文档
wsh ai --doc "为这个模块生成文档"

🎯 命令建议

# 获取命令建议
wsh ai "如何查找大文件？"

# 命令解释
wsh ai "解释 find 命令的用法"

# 最佳实践
wsh ai "Git 工作流最佳实践"
💡 Wave Terminal 集成了 AI 助手，可以帮助解释代码、生成代码和解决问题

⚙️ 配置和自定义 >>>

🎨 主题设置

# 打开配置编辑器
wsh editconfig

# 设置主题
wsh editconfig --key "theme" --value "dark"

# 可用主题
# - dark (深色主题)
# - light (浅色主题)
# - monokai (Monokai 主题)
# - solarized (Solarized 主题)

🔧 终端配置

# 设置默认 Shell
wsh editconfig --key "shell" --value "/bin/zsh"

# 在 Windows 上使用 Git Bash 作为默认 Shell
wsh editconfig --key "shell" --value "C:\Program Files\Git\bin\bash.exe"

# 设置字体大小
wsh editconfig --key "fontSize" --value "14"

# 设置字体
wsh editconfig --key "fontFamily" --value "JetBrains Mono"

⚙️ 配置文件管理

# 配置文件位置
# Linux/macOS: ~/.config/waveterm/settings.json
# Windows: %APPDATA%/waveterm/settings.json

# 直接编辑配置文件
wsh edit ~/.config/waveterm/settings.json

# 设置系统级全局热键
wsh editconfig --key "globalHotkeys" --value "{\"showTerminal\": \"Alt+Space\"}"

🌐 网络设置

# 设置代理
wsh editconfig --key "proxy" --value "http://proxy:8080"

# 设置超时时间
wsh editconfig --key "timeout" --value "30000"

# 禁用代理
wsh editconfig --key "proxy" --value ""

📁 文件关联

# 设置文件关联
wsh editconfig --key "fileAssociations" --value "*.py:python"

# 设置默认编辑器
wsh editconfig --key "defaultEditor" --value "vscode"

# 配置外部工具
wsh editconfig --key "externalTools" --value "git,docker"
💡 使用 wsh editconfig 可以方便地修改 Wave Terminal 的各种配置选项

💡 常用技巧 >>>

📋 剪贴板操作

# 复制到剪贴板
echo "text" | clip

# 从剪贴板粘贴
Ctrl/Cmd + V

# 查看剪贴板历史
Ctrl/Cmd + Shift + V

🔍 搜索和查找

# 在终端中搜索
Ctrl/Cmd + F

# 搜索文件
find . -name "*.py"

# 搜索文件内容
grep -r "keyword" .

📊 系统监控

# 查看系统资源
htop

# 查看磁盘使用
df -h

# 查看内存使用
free -h

🔄 自动化工作流

# 创建别名
alias ll='ls -la'

# 创建函数
function mkcd() { mkdir -p "$1"; cd "$1"; }

# 使用脚本自动化
./deploy.sh
💡 掌握这些常用技巧可以让你更高效地使用 Wave Terminal

🔧 故障排除 >>>

🐛 常见问题

  • 终端无响应：尝试 Ctrl/Cmd + C 中断当前命令
  • 连接失败：检查网络连接和 SSH 配置
  • 字体显示异常：在配置中更改字体设置
  • 性能问题：减少打开的标签页和块数量

📝 日志查看

# 查看 Wave Terminal 日志
wsh view ~/.waveterm/logs/

# 查看系统日志
journalctl -u waveterm

# 查看错误日志
cat ~/.waveterm/logs/error.log

🔄 重置配置

# 重置所有配置
wsh editconfig --reset

# 清除缓存
rm -rf ~/.waveterm/cache/

# 重新安装
npm uninstall -g @waveterm/waveterm
npm install -g @waveterm/waveterm

📞 获取帮助

# 查看帮助
wsh --help

# 查看版本
waveterm --version

# 访问社区
wsh view https://github.com/wavetermdev/waveterm
⚠️ 遇到问题时，首先查看日志文件，然后尝试重置配置