SSH 用戶端
==========

PyBreeze 內建 SSH 用戶端，用於連接遠端伺服器。
可以從 **Tools > SSH Client Tab** 或 **Tools > SSH Client Dock** 開啟。

總覽
----

SSH 用戶端提供三個主要元件，以水平分割器排列：

1. **登入元件**（頂部）-- 連線設定
2. **檔案樹**（左側，約 30% 寬度）-- 遠端檔案瀏覽器
3. **命令元件**（右側，約 70% 寬度）-- 互動式 SSH 終端機

登入元件
--------

登入元件提供 SSH 連線的輸入欄位：

.. list-table::
   :header-rows: 1
   :widths: 20 80

   * - 欄位
     - 說明
   * - **Host**
     - 遠端伺服器的主機名稱或 IP 位址。
   * - **Port**
     - SSH 連接埠號（預設：22）。
   * - **Username**
     - 您的 SSH 使用者名稱。
   * - **Password / Key**
     - 驗證憑證。支援密碼驗證和金鑰驗證。

輸入憑證後，點擊 **Connect** 建立 SSH 連線。

遠端檔案瀏覽器
--------------

連線建立後，檔案樹會顯示遠端伺服器的檔案系統。

右鍵選單操作
^^^^^^^^^^^^

在檔案樹中的任何檔案或目錄上按右鍵以存取：

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - 操作
     - 說明
   * - **Refresh**
     - 從遠端伺服器重新載入目前的目錄列表。
   * - **Create Folder**
     - 在遠端伺服器上建立新目錄。
   * - **Rename**
     - 重新命名選定的檔案或目錄。
   * - **Delete**
     - 從遠端伺服器刪除選定的檔案或目錄。
   * - **Download**
     - 將選定的檔案下載到本機。
   * - **Upload**
     - 將本機檔案上傳到目前的遠端目錄。

SSH 命令終端機
--------------

命令元件提供互動式終端機，用於在遠端伺服器上執行命令。

- 輸入命令並按 Enter 執行
- 即時顯示輸出
- 支援標準 Shell 操作
- 在連線期間維護命令歷史

使用提示
--------

- 使用 **分頁** 模式將 SSH 與程式碼編輯器分頁並列
- 使用 **停靠面板** 模式將 SSH 終端機定位在一側，同時編輯程式碼
- 檔案瀏覽器支援拖放上傳
- 您可以在不同的分頁/停靠面板中同時開啟多個 SSH 連線