waveterm

官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

Wave Terminal

本文件為社群繁體中文翻譯版本。最新原文請參閱 README.md。

Wave 是一款開源、整合 AI 的終端機應用程式，支援 macOS、Linux 與 Windows。它可以搭配任何 AI 模型使用——自行提供 OpenAI、Claude 或 Gemini 的 API 金鑰，或透過 Ollama 與 LM Studio 執行本地模型，完全不需要註冊帳號。

Wave 同時支援持久化 SSH 連線，即使網路中斷或應用程式重新啟動，連線也會自動恢復。你可以使用內建的圖形化編輯器直接編輯遠端檔案，也能在不離開終端機的情況下即時預覽檔案內容。

主要功能

🤖 Wave AI — 情境感知終端機助手

Wave AI 不只是一個聊天機器人——它能直接讀取你的終端機輸出、分析目前開啟的小工具（Widget），還能執行檔案操作。當你在 Debug 時，AI 能看到你的錯誤訊息並給予針對性的建議，而不是泛泛的回答。

• 終端機情境感知：自動讀取終端機輸出與捲動緩衝區（Scrollback），用於除錯與分析
• 檔案操作：可讀取、寫入、編輯檔案，搭配自動備份機制與使用者審核確認
• CLI 整合：透過 wsh ai 命令，直接在命令列中將輸出導入 AI 或附加檔案
• BYOK（自帶金鑰）：支援 OpenAI、Claude、Gemini、Azure 等多家供應商的 API 金鑰
• 本地模型：透過 Ollama、LM Studio 及其他 OpenAI 相容供應商執行本地模型，資料完全不離開你的電腦
• 免費 Beta：體驗優化期間提供免費 AI 額度
• 即將推出：命令執行功能（需使用者核准）

詳細說明請參閱 Wave AI 文件 與 Wave AI Modes 文件。

🔗 持久化 SSH 連線

傳統的 SSH 連線在網路不穩時就會斷開，你得重新連線、重新切換目錄、重新啟動程式。Wave 的持久化 SSH 連線徹底解決了這個痛點——連線中斷後會自動重新建立，你的工作階段（Session）完整保留，就像什麼都沒發生過一樣。

• 連線中斷、網路切換、Wave 重啟後自動重新連線
• 工作階段狀態完整保留
• 一鍵即可連線遠端伺服器，完整存取終端機與檔案系統

🧩 彈性拖放介面

Wave 的介面由可自由排列的「區塊（Block）」組成。你可以將終端機、編輯器、網頁瀏覽器、AI 助手像拼圖一樣排列在同一個畫面中，打造最適合你工作流程的佈局。每個區塊都能一鍵切換全螢幕，放大查看後立即回到多區塊視圖。

✏️ 內建編輯器

不需要額外開啟 VS Code 或 Vim——Wave 內建的圖形化編輯器支援語法高亮與現代編輯功能，可以直接編輯本地或遠端檔案。對於需要快速修改設定檔或程式碼的場景特別方便。

📄 豐富的檔案預覽系統

直接在終端機內預覽各種格式的遠端檔案，無需下載：

• Markdown 文件（渲染後呈現）
• 圖片、影片
• PDF 文件
• CSV 試算表
• 目錄結構

💬 AI 聊天小工具

支援多種 AI 模型的聊天介面，可同時開啟多個 AI 對話視窗：

• OpenAI（GPT 系列）
• Anthropic Claude
• Azure OpenAI
• Perplexity
• Ollama（本地模型）

📦 Command Blocks（命令區塊）

每個執行的命令都會被獨立封裝在一個區塊中，你可以：

• 清楚分隔不同命令的輸出結果
• 個別監控長時間執行的命令
• 輕鬆回顧歷史命令的輸出

🔐 安全的密鑰儲存

使用作業系統原生的安全儲存後端（如 macOS Keychain、Windows Credential Manager）來保存 API 金鑰和登入憑證。密鑰儲存在本地，並可在不同的 SSH 連線間共享使用。

🎨 豐富的自訂選項

• 分頁主題配色
• 終端機樣式調整
• 背景圖片設定
• 打造專屬於你的工作環境

🛠️ wsh 命令系統

wsh 是 Wave 提供的強大 CLI 工具，讓你從命令列管理整個工作空間：

• 在不同終端機連線間共享資料
• 透過 wsh file 在本地與遠端 SSH 主機之間無縫複製和同步檔案
• 從命令列直接控制 Wave 的介面佈局

安裝

Wave Terminal 支援 macOS、Linux 與 Windows。

各平台的安裝說明請參閱此處。

你也可以直接從官方下載頁面安裝：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 Kernel 2.6.32 或更新版本（x64）、Linux Kernel 3.1 或更新版本（arm64）

發展藍圖

Wave 持續進化中！發展藍圖會隨每次發行版本持續更新，請至此處查閱。

想為未來版本提供建議？歡迎加入 Discord 社群，或提交 Feature Request！

連結

• 官方網站 — https://www.waveterm.dev
• 下載頁面 — https://www.waveterm.dev/download
• 技術文件 — https://docs.waveterm.dev
• X（Twitter）— https://x.com/wavetermdev
• Discord 社群 — https://discord.gg/XfvZ334gwU

從原始碼建置

請參閱 Building Wave Terminal。

貢獻

Wave 使用 GitHub Issues 進行問題追蹤。

更多資訊請參閱貢獻指南，其中包含：

• 貢獻方式
• 貢獻規範

贊助 Wave ❤️

如果 Wave Terminal 對你或你的公司有幫助，歡迎贊助開發工作。

贊助有助於支持專案的建置與維護所投入的時間。

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

授權條款

Wave Terminal 採用 Apache-2.0 授權條款。相依性資訊請參閱此處。