Back to Cmux

README.Zh TW

README.zh-TW.md

1.38.111.3 KB
Original Source

此翻譯由 Claude 生成。如有改進建議,歡迎提交 PR。

<h1 align="center">cmux</h1> <p align="center">基於 Ghostty 的 macOS 終端機,具備垂直分頁和為 AI 程式設計代理設計的通知系統</p> <p align="center"> <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg"> </a> </p> <p align="center"> <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">简体中文</a> | 繁體中文 | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.it.md">Italiano</a> | <a href="README.da.md">Dansk</a> | <a href="README.pl.md">Polski</a> | <a href="README.ru.md">Русский</a> | <a href="README.bs.md">Bosanski</a> | <a href="README.ar.md">العربية</a> | <a href="README.no.md">Norsk</a> | <a href="README.pt-BR.md">Português (Brasil)</a> | <a href="README.th.md">ไทย</a> | <a href="README.tr.md">Türkçe</a> | <a href="README.km.md">ភាសាខ្មែរ</a> </p> <p align="center"> <a href="https://x.com/manaflowai"></a> <a href="https://discord.gg/xsgFEVrWCZ"></a> </p> <p align="center"> </p> <p align="center"> <a href="https://www.youtube.com/watch?v=i-WxO5YUTOs">▶ 示範影片</a> · <a href="https://cmux.com/blog/zen-of-cmux">The Zen of cmux</a> </p>

功能特色

<table> <tr> <td width="40%" valign="middle"> <h3>通知提示環</h3> 當 AI 代理需要您注意時,窗格會顯示藍色光環,分頁會亮起 </td> <td width="60%"> </td> </tr> <tr> <td width="40%" valign="middle"> <h3>通知面板</h3> 在同一處檢視所有待處理通知,快速跳轉到最新未讀通知 </td> <td width="60%"> </td> </tr> <tr> <td width="40%" valign="middle"> <h3>內建瀏覽器</h3> 在終端機旁分割出瀏覽器窗格,提供從 <a href="https://github.com/vercel-labs/agent-browser">agent-browser</a> 移植的可腳本化 API </td> <td width="60%"> </td> </tr> <tr> <td width="40%" valign="middle"> <h3>垂直 + 水平分頁</h3> 側邊欄顯示 git 分支、關聯的 PR 狀態/編號、工作目錄、監聽連接埠和最新通知文字。支援水平和垂直分割。 </td> <td width="60%"> </td> </tr> </table>
  • 可腳本化 — 透過 CLI 和 socket API 建立工作區、分割窗格、傳送按鍵和自動化瀏覽器操作
  • 原生 macOS 應用程式 — 使用 Swift 和 AppKit 建構,非 Electron。啟動快速,記憶體佔用低。
  • 相容 Ghostty — 讀取您現有的 ~/.config/ghostty/config 設定檔中的主題、字型和色彩設定
  • GPU 加速 — 由 libghostty 驅動,渲染流暢

安裝

DMG(建議)

<a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg"> </a>

開啟 .dmg 檔案並將 cmux 拖曳到「應用程式」資料夾。cmux 透過 Sparkle 自動更新,您只需下載一次。

Homebrew

bash
brew tap manaflow-ai/cmux
brew install --cask cmux

稍後更新:

bash
brew upgrade --cask cmux

首次啟動時,macOS 可能會要求您確認開啟來自已識別開發者的應用程式。點擊開啟即可繼續。

為什麼做 cmux?

我同時執行大量 Claude Code 和 Codex 工作階段。之前我用 Ghostty 開了一堆分割窗格,依靠 macOS 原生通知來了解代理何時需要我。但 Claude Code 的通知內容總是千篇一律的「Claude is waiting for your input」,沒有任何上下文資訊,而且分頁一多,連標題都看不清了。

我試過幾個程式設計協調工具,但大多數都是 Electron/Tauri 應用程式,效能讓我不滿意。我也更偏好終端機,因為 GUI 協調工具會把你鎖定在它們的工作流程裡。所以我用 Swift/AppKit 建構了 cmux,作為一個原生 macOS 應用程式。它使用 libghostty 進行終端機渲染,並讀取您現有的 Ghostty 設定中的主題、字型和色彩設定。

主要新增的是側邊欄和通知系統。側邊欄有垂直分頁,顯示每個工作區的 git 分支、關聯的 PR 狀態/編號、工作目錄、監聽連接埠和最新通知文字。通知系統能擷取終端機序列(OSC 9/99/777),並提供 CLI(cmux notify),您可以將其接入 Claude Code、OpenCode 等代理的鉤子。當代理等待時,其窗格會顯示藍色光環,分頁會在側邊欄亮起,這樣我就能在多個分割窗格和分頁之間一眼看出哪個需要我。⌘⇧U 可以跳轉到最新的未讀通知。

內建瀏覽器擁有從 agent-browser 移植的可腳本化 API。代理可以擷取無障礙樹快照、取得元素參考、執行點擊、填寫表單和執行 JS。您可以在終端機旁分割出瀏覽器窗格,讓 Claude Code 直接與您的開發伺服器互動。

所有操作都可以透過 CLI 和 socket API 進行腳本化 — 建立工作區/分頁、分割窗格、傳送按鍵、在瀏覽器中開啟 URL。

The Zen of cmux

cmux 不會規定開發者如何使用工具。它是一個帶有 CLI 的終端機和瀏覽器,其餘由您決定。

cmux 是一個基礎元件,而非完整方案。它提供終端機、瀏覽器、通知、工作區、分割、分頁,以及控制一切的 CLI。cmux 不會強迫您採用特定的方式使用程式設計代理。您用這些基礎元件打造什麼,由您決定。

最好的開發者一直在打造自己的工具。沒有人知道與代理協作的最佳方式,那些打造封閉產品的團隊也一樣。最了解自己程式碼庫的開發者會最先找到答案。

給一百萬個開發者可組合的基礎元件,他們會比任何自上而下設計的產品團隊更快地集體找到最高效的工作流程。

文件

如需更多 cmux 設定資訊,請前往我們的文件

鍵盤快捷鍵

工作區

快捷鍵動作
⌘ N新建工作區
⌘ 1–8跳轉到工作區 1–8
⌘ 9跳轉到最後一個工作區
⌃ ⌘ ]下一個工作區
⌃ ⌘ [上一個工作區
⌘ ⇧ W關閉工作區
⌘ ⇧ R重新命名工作區
⌘ B切換側邊欄

介面

快捷鍵動作
⌘ T新建介面
⌘ ⇧ ]下一個介面
⌘ ⇧ [上一個介面
⌃ Tab下一個介面
⌃ ⇧ Tab上一個介面
⌃ 1–8跳轉到介面 1–8
⌃ 9跳轉到最後一個介面
⌘ W關閉介面

分割窗格

快捷鍵動作
⌘ D向右分割
⌘ ⇧ D向下分割
⌥ ⌘ ← → ↑ ↓按方向切換焦點窗格
⌘ ⇧ H閃爍聚焦面板

瀏覽器

瀏覽器開發者工具快捷鍵遵循 Safari 預設設定,可在 設定 → 鍵盤快捷鍵 中自訂。

快捷鍵動作
⌘ ⇧ L在分割中開啟瀏覽器
⌘ L聚焦網址列
⌘ [後退
⌘ ]前進
⌘ R重新整理頁面
⌥ ⌘ I切換開發者工具(Safari 預設)
⌥ ⌘ C顯示 JavaScript 主控台(Safari 預設)

通知

快捷鍵動作
⌘ I顯示通知面板
⌘ ⇧ U跳轉到最新未讀

尋找

快捷鍵動作
⌘ F尋找
⌘ G / ⌘ ⇧ G尋找下一個 / 上一個
⌘ ⇧ F隱藏尋找列
⌘ E使用選取內容進行尋找

終端機

快捷鍵動作
⌘ K清除捲動緩衝區
⌘ C複製(有選取內容時)
⌘ V貼上
⌘ + / ⌘ -增大 / 縮小字型
⌘ 0重設字型大小

視窗

快捷鍵動作
⌘ ⇧ N新建視窗
⌘ ,設定
⌘ ⇧ ,重新載入設定
⌘ Q結束

每夜建構

下載 cmux NIGHTLY

cmux NIGHTLY 是一個獨立的應用程式,擁有自己的 bundle ID,因此可以與穩定版並行執行。每次從最新的 main 提交自動建構,並透過自己的 Sparkle 來源自動更新。

工作階段還原(目前行為)

重新啟動時,cmux 目前僅還原應用程式佈局和中繼資料:

  • 視窗/工作區/窗格佈局
  • 工作目錄
  • 終端機捲動緩衝區(盡力而為)
  • 瀏覽器 URL 和瀏覽歷程

cmux 不會還原終端機應用程式內的即時程序狀態。例如,活躍的 Claude Code/tmux/vim 工作階段在重新啟動後尚無法恢復。

Star 歷史

<a href="https://star-history.com/#manaflow-ai/cmux&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=manaflow-ai/cmux&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=manaflow-ai/cmux&type=Date" /> </picture> </a>

參與貢獻

參與方式:

社群

創始版

cmux 免費、開源,且將永遠如此。如果您想支持開發並提前體驗即將推出的功能:

取得創始版

  • 優先處理的功能請求/錯誤修復
  • 搶先體驗:cmux AI 為您提供每個工作區、分頁和面板的上下文資訊
  • 搶先體驗:iOS 應用程式,終端機在桌面和手機之間同步
  • 搶先體驗:雲端虛擬機
  • 搶先體驗:語音模式
  • 我的個人 iMessage/WhatsApp

授權條款

本專案採用 GNU Affero 通用公共授權條款 v3.0 或更新版本(AGPL-3.0-or-later)授權。

完整授權條款文字請參見 LICENSE 檔案。