cmux/README.zh-TW.md

6.5 KiB
Raw Blame History

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

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe

cmux

基於 Ghostty 的 macOS 終端機,具備垂直分頁和為 AI 程式設計代理設計的通知系統

下載 cmux macOS 版

cmux 螢幕截圖

功能特色

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

安裝

DMG建議

下載 cmux macOS 版

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

Homebrew

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

稍後更新:

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 分支、工作目錄、監聽連接埠和最新通知文字。通知系統能擷取終端機序列OSC 9/99/777並提供 CLIcmux notify),您可以將其接入 Claude Code、OpenCode 等代理的鉤子。當代理等待時其窗格會顯示藍色光環分頁會在側邊欄亮起這樣我就能在多個分割窗格和分頁之間一眼看出哪個需要我。⌘⇧U 可以跳轉到最新的未讀通知。

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

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

鍵盤快捷鍵

工作區

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

介面

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

分割窗格

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

瀏覽器

快捷鍵 動作
⌘ ⇧ L 在分割中開啟瀏覽器
⌘ L 聚焦網址列
⌘ [ 後退
⌘ ] 前進
⌘ R 重新整理頁面
⌥ ⌘ I 開啟開發者工具

通知

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

尋找

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

終端機

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

視窗

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

授權條款

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

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