終端機使用方式

本章介紹終端機本身：輸入與輸出、終端機內搜尋、複製與貼上、貼上圖片、指令建議、內建的 v 指令、以 vrun 啟動的背景指令、Windows 上的 shell 選擇、會話錄製、算繪器設定與快捷鍵。

1. 基本操作

終端機會話執行的是真正的 shell。在 macOS 與 Linux 上使用系統預設的 shell（$SHELL）；在 Windows 上預設為 cmd，也可以變更（請參閱 §7）。工作目錄預設為專案根目錄。在會話的編輯表單中，可以變更「工作目錄（留空用專案根）」，並設定「啟動命令（可選）」，該指令會在每次會話啟動時執行（例如 pnpm dev）。

多個智慧體同時產生大量輸出時，VelaTerm 會優先處理您的輸入與目前可見的分頁，並限制背景分頁的輸出速度。此行為由設定 ▸ 進階 ▸「前台優先輸出」控制（預設開啟）。如果切換分頁後全螢幕程式的畫面出現錯亂，請點選窗格標頭中的「重繪」按鈕重新繪製。設定 ▸ 進階 ▸「切回分頁時重繪」會在分頁變為可見時自動執行此動作。

2. 終端機內搜尋（⌘F）

⌘F 會開啟目前終端機回捲內容的搜尋列（「在終端機中搜尋」），並提供上一個與下一個按鈕：

如要跨會話與歷史記錄搜尋，請使用全域搜尋（⌘⇧F），說明請見介面與會話管理。

3. 複製與貼上

• 以滑鼠選取文字後，使用 ⌘C／⌘V 或右鍵選單（「複製」、「貼上」、「全選」、「清除畫面」、「搜尋…」）。
• 在會擷取滑鼠操作的程式中（vim、htop 與大多數智慧體介面），拖曳時在 macOS 上按住 Option，或在 Windows 與 Linux 上按住 Shift，即可強制進行一般的文字選取。
• Claude Code 與 Codex 等智慧體介面可以自行複製文字。當它們剛複製過文字且終端機中沒有選取任何內容時，右鍵選單會顯示「已自動複製 N 字元 · ⌘V 貼上」。

4. 貼上圖片

將圖片貼上或拖放到終端機中，即可將圖片提供給命令列智慧體。設定 ▸ 終端機 ▸「圖片貼上」提供兩種選擇：

• 貼上檔案路徑（預設）：圖片會儲存為暫存檔，並將其路徑插入提示字元處，任何能讀取檔案的智慧體都可以開啟。Codex 會以 image_path: … 的形式接收。
• 原生圖片貼上：Claude Code 或 Codex 會從系統剪貼簿讀取圖片，並顯示自己的圖片預留位置。此選項僅在本機桌面版中提供；遠端會話一律貼上檔案路徑，讓智慧體能在其所在的機器上讀取圖片。

設定 ▸ 行為 ▸「自動清理貼上的圖片」會在應用程式結束時移除這些暫存檔，並在啟動時清除超過 24 小時的殘留檔案。「立即清理」會立即移除這些檔案。插入文件中的圖片一律不受影響。

5. 指令建議

在 macOS 與 Linux 的一般終端機會話中，VelaTerm 可以根據您 shell 本身的補全定義顯示建議清單。設定 ▸ 終端機 ▸「命令補全提示」可選擇「自動提示」（預設）、「按 Tab 提示」或「完全關閉」。使用方向鍵選擇候選項目，按 Tab 插入；Enter 一律會照原樣執行您輸入的指令。選取項目無法再移動時，上下方向鍵會交還給 shell 處理，因此在第一個候選項目上按上方向鍵，會叫出上一個指令。Windows 上不提供此清單。完整說明請參閱指令建議。

6. 內建指令

VelaTerm 啟動的每個會話，其 PATH 中都有一組簡短的指令。這些指令無須安裝，在一般終端機與智慧體會話中都能使用：

以 --help 執行指令即可查看其選項；會話指令中有每個指令的詳細說明。這些指令大多也以技能形式存在於 Claude Code（/vopen）與 Codex（$vopen）中；vrun 與 vflow 沒有對應的技能，vask 則只以技能形式存在。技能可透過設定 ▸ 一般中的「Vela 技能」按鈕安裝。

vopen 會依檔案類型選擇檢視方式：

vopen README.md          # Markdown → Markdown 編輯器
vopen src/main.rs        # 原始碼 → 具語法醒目提示的程式碼編輯器
vopen diagram.png        # 圖片 → 圖片檢視器
vopen https://crates.io  # 網址 → 瀏覽器分頁（僅限桌面版）

相對路徑會以目前目錄為基準解析，也可以一次開啟多個檔案。文件分頁的說明請見文件與瀏覽器分頁；vspawn 的說明請見會話派生與 Git 協作；vkb 的說明請見程式碼圖譜與知識庫與本機知識庫。

6.1 背景指令（vrun）

vrun <label> <command...> 會啟動指令、等待其完成，然後輸出結束代碼、經過時間與日誌的末端內容。因此，以 vrun 啟動耗時較長之建置或測試的智慧體，結果一出來就能得知。關閉會話不會停止該指令。vrun --status <label> 會回報先前啟動之指令的狀態，-t <seconds> 則設定等待時間（預設 1800 秒）；等待逾時時，vrun 會以代碼 124 結束，並讓指令繼續執行。

這類指令執行期間，終端機上方會出現「背景指令」列。每個項目會顯示其標籤與「已執行 …」、可開啟指令輸出的「日誌」按鈕，以及「停止」按鈕；點選「確認停止」即可結束指令。沒有指令執行時，此列會消失。

7. Shell 選擇（僅限 Windows）

在 Windows 上，終端機會話可以使用任何偵測到的 shell：PowerShell、pwsh、cmd、Git Bash，以及每個已安裝的 WSL 發行版。可從「新增終端機」子選單、會話編輯表單中的「Shell（留空用系統預設）」，或右鍵的「Shell」選單中選擇。執行中的會話會立即以新的 shell 重新啟動。設定 ▸ 終端機 ▸「預設 Shell」可為未明確指定 shell 的新終端機設定 shell。

只有在 WSL 回報已安裝發行版時，WSL 項目才會以 WSL: <distribution> 的形式出現。選擇其中一項會啟動該發行版，並將會話的 Windows 專案目錄對應到其中。WSL 僅適用於一般終端機會話；智慧體會話仍使用 Windows 主機的 shell。WSL 終端機中無法使用內建的 v 指令。

關於隨附的 Git Bash：full 安裝程式內含完整的 Git Bash（含 git、ssh 與 perl）。min 安裝程式只包含核心子集；執行缺少的指令時，會提示您下載完整版本，也可以透過右鍵選單中的「下載完整 Git Bash」項目下載。智慧體會話不受影響，因為它們使用 PowerShell。

macOS 與 Linux 沒有 shell 選擇器；會話使用系統預設的 shell。

8. 會話錄製

設定 ▸ 進階 ▸「記錄會話日誌」預設關閉。開啟後，VelaTerm 會將以終端機檢視執行之智慧體會話的終端機輸出儲存到本機日誌檔，每個會話最多 50 MB。一般終端機會話一律不會錄製。

錄製內容可讓您依畫面原貌重播已封存的會話，並讓其畫面文字可供搜尋。VelaTerm 只有在無法讀取智慧體本身的對話記錄時，才會使用錄製內容；否則會使用對話記錄進行檢視與搜尋。錄製檔案會與其會話一併刪除。

9. 算繪器

設定 ▸ 進階 ▸「終端算繪器」提供 DOM（預設）與 WebGL。在桌面版中建議使用 DOM。舊版本還提供 Canvas 算繪器；此選項已不再提供，先前儲存的 Canvas 偏好設定現在會改用 DOM。

10. 常用快捷鍵

下表列出 macOS 桌面版的預設值。Windows 與 Linux 版在大多數操作中以 Ctrl+Alt 取代 ⌘（向下分割為 Ctrl+Alt+E，搜尋所有會話為 Ctrl+Alt+G，儲存則維持 Ctrl+S）。瀏覽器用戶端使用以 Ctrl 為主的預設值，以避開瀏覽器本身的快捷鍵。設定 ▸ 快捷鍵會顯示您系統上的實際按鍵組合，除了切換分頁與字型大小之外，所有操作都可以在該處變更。