diff --git a/README.ko.md b/README.ko.md
index 88dbe29c09..d18ccfaed9 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -13,7 +13,7 @@
-[English](README.md) | [한국어](README.ko.md)
+[English](README.md) | [한국어](README.ko.md) | [繁體中文](README.zh-TW.md)
diff --git a/README.md b/README.md
index 2b8e0637ae..a9f406725c 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@
-[English](README.md) | [한국어](README.ko.md)
+[English](README.md) | [한국어](README.ko.md) | [繁體中文](README.zh-TW.md)
diff --git a/README.zh-TW.md b/README.zh-TW.md
new file mode 100644
index 0000000000..c24dca360c
--- /dev/null
+++ b/README.zh-TW.md
@@ -0,0 +1,168 @@
+
+
+
+
+
+
+
+
+
+
+
+# Wave Terminal
+
+
+
+[English](README.md) | [한국어](README.ko.md) | [繁體中文](README.zh-TW.md)
+
+
+
+[](https://app.fossa.com/projects/git%2Bgithub.com%2Fwavetermdev%2Fwaveterm?ref=badge_shield)
+
+> 本文件為社群繁體中文翻譯版本。最新原文請參閱 [README.md](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 文件](https://docs.waveterm.dev/waveai) 與 [Wave AI Modes 文件](https://docs.waveterm.dev/waveai-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。
+
+各平台的安裝說明請參閱[此處](https://docs.waveterm.dev/gettingstarted)。
+
+你也可以直接從官方下載頁面安裝:[www.waveterm.dev/download](https://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 持續進化中!發展藍圖會隨每次發行版本持續更新,請至[此處](./ROADMAP.md)查閱。
+
+想為未來版本提供建議?歡迎加入 [Discord](https://discord.gg/XfvZ334gwU) 社群,或提交 [Feature Request](https://github.com/wavetermdev/waveterm/issues/new/choose)!
+
+## 連結
+
+- 官方網站 — 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](BUILD.md)。
+
+## 貢獻
+
+Wave 使用 GitHub Issues 進行問題追蹤。
+
+更多資訊請參閱[貢獻指南](CONTRIBUTING.md),其中包含:
+
+- [貢獻方式](CONTRIBUTING.md#contributing-to-wave-terminal)
+- [貢獻規範](CONTRIBUTING.md#before-you-start)
+
+### 贊助 Wave ❤️
+
+如果 Wave Terminal 對你或你的公司有幫助,歡迎贊助開發工作。
+
+贊助有助於支持專案的建置與維護所投入的時間。
+
+- https://github.com/sponsors/wavetermdev
+
+## 授權條款
+
+Wave Terminal 採用 Apache-2.0 授權條款。相依性資訊請參閱[此處](./ACKNOWLEDGEMENTS.md)。