QuickTerminal - 指南

開始使用

1. 啟動應用程式 — 您將進入包含已儲存工作階段和啟動新連線按鈕的主畫面。
2. 啟動本機 shell — 點選 Local Shell 立即在您的裝置上開啟終端機工作階段。
3. 建立遠端工作階段 — 點選 New Session，選擇協定（SSH、Telnet、Mosh、Serial、AWS SSM 或 GCP IAP）並輸入連線詳細資料。
4. 儲存工作階段 — 為其命名並指派群組。隨時一鍵重新連線。
5. 探索 Command Palette — 按下 Ctrl + Shift + P 從單一可搜尋清單存取所有動作。

介面概覽

側邊欄

可摺疊的側邊欄組織您的工作區：

• 工作階段 — 按專案或環境分組的所有已儲存工作階段
• SFTP — 為作用中連線開啟圖形化檔案瀏覽器
• 片段 — 您儲存的命令程式庫
• AI Agent — 啟動 AI 助手面板
• 設定 / 說明 — 位於側邊欄底部

終端機區域

中央工作區顯示：

• 作用中的終端機，含完整的輸入與輸出
• 在多個開啟工作階段之間切換的分頁列
• 底部顯示連線狀態、協定和工作階段計時器的狀態列
• 選擇性的分割窗格檢視，以並排執行多個終端機

Command Palette

按 Ctrl + Shift + P 開啟命令面板。輸入以篩選動作，然後按 Enter 執行。QuickTerminal 中的每個功能都可透過面板存取。

本機 Shell

QuickTerminal 包含完整整合的本機 shell，用於在您自己的裝置上執行命令。

• Shell 偵測 — 自動偵測並使用您的預設 shell（bash、zsh、fish、PowerShell）
• 工作目錄追蹤 — 狀態列始終顯示您目前的目錄
• 命令歷史 — 跨工作階段的持久歷史，可用 Ctrl + R 搜尋
• 環境變數 — 自動繼承您的 shell 設定檔和環境

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

SSH 連線

SSH 是安全遠端存取的主要協定。QuickTerminal 支援所有現代 SSH 功能。

驗證

• 密碼 — 在連線時輸入認證或將其安全地儲存在工作階段中
• 基於金鑰 — 使用 RSA、Ed25519 或 ECDSA 金鑰。從檔案匯入或產生新的金鑰對
• 代理程式轉送 — 將您的本機 SSH 代理程式轉送到遠端主機以實現無縫的多跳存取
• 鍵盤互動式 — 支援雙重驗證和挑戰-回應提示

連接埠轉送

• 本機轉送 — 將遠端連接埠通道到您的本機電腦
• 遠端轉送 — 將本機服務公開給遠端主機
• 動態轉送 — 透過 SSH 通道建立 SOCKS 代理伺服器

工作階段設定

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

其他協定

Telnet

設定主機和連接埠。Telnet 連線未加密；僅在受信任的網路或需要此協定的裝置上使用。

Mosh

需要在遠端主機上安裝 Mosh 伺服器。QuickTerminal 自動處理初始 SSH 握手和 UDP 工作階段設定。適合行動或不可靠的網路條件。

Serial

選擇序列埠、鮑率（9600、19200、38400、57600、115200 等）、資料位元、停止位元、同位和流量控制。終端機顯示原始序列資料並支援傳送 break 訊號。

AWS SSM

使用您的 AWS 認證或 IAM 角色進行驗證。依識別碼或名稱選擇目標執行個體。QuickTerminal 呼叫 SSM 工作階段外掛程式以建立連線。

GCP IAP

使用您的 Google Cloud 帳戶進行驗證。選擇專案、區域和執行個體。QuickTerminal 使用您的 IAM 權限透過 IAP 建立通道。

SFTP 瀏覽器

內建的 SFTP 瀏覽器為任何 SSH 連線的主機提供圖形化檔案管理員。

• 瀏覽目錄 — 使用熟悉的樹狀和清單檢視瀏覽遠端檔案系統
• 上傳檔案 — 從您的本機電腦拖放檔案或使用上傳按鈕
• 下載檔案 — 選擇檔案並下載到本機目錄
• 遠端編輯 — 在內建編輯器中開啟文字檔並直接儲存到伺服器
• 權限 — 檢視並修改檔案權限、擁有者和時間戳記
• 搜尋 — 在目前目錄樹中依名稱尋找檔案

AI 代理程式

QuickTerminal 的 AI 代理程式協助您編寫命令、分析輸出和自動執行任務。

AI 代理程式能做什麼

• 命令產生 — 以一般語言描述您想要的內容，代理程式建議正確的命令
• 輸出說明 — 將終端機輸出貼上或導流到代理程式以取得人類可讀的分析
• 錯誤診斷 — 分享錯誤訊息並取得建議的修正方案與說明
• 多步驟自動化 — 描述工作流程，代理程式產生命令序列
• 指令碼產生 — 請代理程式為重複性任務建立 shell 指令碼

使用代理程式面板

1. 從側邊欄開啟 AI Agent 面板或按 Ctrl + Shift + A。
2. 以自然語言輸入您的請求。
3. 檢閱建議的命令或說明。
4. 按一下 Insert 將命令貼至終端機，或按 Copy 複製到剪貼簿。

片段

片段可讓您儲存、組織並快速插入經常使用的命令。

建立片段

1. 從側邊欄開啟 Snippets 面板。
2. 點選 New Snippet。
3. 輸入命令、名稱和選擇性的描述。
4. 使用 ${variable_name} 語法表示參數化範本。
5. 儲存至您的片段程式庫。

範本變數

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

當您插入參數化片段時，QuickTerminal 會提示您填寫每個變數，然後再插入最終命令。

組織片段

• 指派標籤以分組相關片段（例如部署、監控、資料庫）
• 依名稱、內容或標籤搜尋片段
• 釘選您最常使用的片段以便在清單頂部快速存取

Command Palette

Command Palette 是一個通用動作啟動器，可從 QuickTerminal 中的任何位置存取。

• 按 Ctrl + Shift + P 開啟
• 輸入以篩選動作 — 模糊比對可快速找到您需要的內容
• 動作包括：建立工作階段、開啟 SFTP、切換設定、執行片段等
• 最近使用的動作顯示在頂部，以便快速重複存取

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

執行政策可讓您定義保護免受意外或破壞性命令影響的安全規則。

政策類型

設定政策

1. 前往 Settings > Execution Policies。
2. 點選 New Policy。
3. 定義模式 — 要比對的命令前置字元、regex 或關鍵字。
4. 選擇動作（block、confirm、sandbox 或 log）。
5. 設定範圍 — 套用至所有工作階段、特定群組或個別工作階段。

設定

外觀

• 主題 — Light 和 Dark 模式，可偵測系統偏好設定
• 字型系列 — 為終端機選擇您偏好的 monospace 字型
• 字型大小 — 可調整的終端機文字大小
• 配色 — 從內建終端機配色中選擇或匯入自訂配色

終端機

• Scrollback 緩衝區 — 設定在記憶體中保留多少行歷史
• 游標樣式 — 方塊、底線或直條
• Bell 行為 — 視覺閃光、系統聲音或靜音
• 選取時複製 — 自動將醒目顯示的文字複製到剪貼簿

連線

• 預設 SSH 連接埠 — 為新 SSH 工作階段設定自訂預設連接埠
• Keep-alive 間隔 — 傳送定期封包以防止連線逾時
• 斷線時重新連線 — 自動嘗試還原中斷的連線

Execution Policies

• 管理 block、confirm、sandbox 和 log 規則
• 按工作階段群組啟用或停用政策

鍵盤快速鍵

提示與訣竅

疑難排解

隱私權

• QuickTerminal 不需要帳戶或登入。
• 不會收集任何使用資料、分析或遙測資訊。
• 所有認證都使用平台原生 keystore 加密。
• AI 代理程式完全在裝置上執行 — 沒有資料傳送到外部伺服器。
• 工作階段歷史和片段都儲存在您裝置的本機上。
• SFTP 傳輸是在您的裝置和遠端主機之間直接進行。
• 應用程式在本機 shell 和序列連線中完全離線運作。