終端機使用方式

本章介紹終端機本身的功能：輸入/輸出、終端機內搜尋、複製/貼上與圖片處理、vopen指令、在Windows上選擇shell，以及會話錄製。

1. 基礎知識

終端機會話即為實際的shell（在macOS / Linux上為系統預設shell；在Windows上預設為cmd，可更換——見§5）。工作目錄預設為專案根目錄，可在會話的編輯頁面中更改，該頁面還提供「啟動指令」——會在每次會話開始時自動執行（例如pnpm dev）。

輸入延遲經過特殊設計：當大量指令同時顯示在畫面上時，輸入會被優先處理，背景分頁的更新速度會被限制，如此前景區就不會落後於您的按鍵輸入。如果切換分頁後TUI出現異常，分頁標頭中的重新繪製按鈕可強制重新繪製整個畫面。

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

可在目前終端機的滾動記錄中搜尋，並可透過「下一個」/「上一個」來導航：

若要跨會話及歷史記錄搜尋，請使用全局搜尋（⌘⇧F）——詳見介面與會話管理 §8。

3. 複製與貼上

• 先選取要操作的內容使其高亮；右鍵選單會提供複製/貼上選項，常用的⌘C / ⌘V功能也同樣有效。
• 在會擷取滑鼠輸入的TUI程式（如vim、htop）中，拖動時按住Option/Alt鍵，即可強制以一般文字選取模式進行操作。

圖片貼上是用來將圖片傳送給各個agent的功能：將截圖或圖片檔案貼上或拖入終端機，VelaTerm會將圖片寫入暫存位置，並將其檔案路徑輸入終端機——這正是像claude這樣的CLI所期望的作業方式。相關設定包括：「圖片貼上」可選擇「以檔案形式上傳」（必定會產生一個檔案路徑）或「使用agent預設設定」；「自動清除已貼上的圖片」會定期刪除這些暫存圖片，並提供「立即清除」按鈕。

4. vopen：從終端機打開檔案與頁面

每個會話的PATH都包含三個簡單指令（無需安裝）：vopen、vspawn、vspawn-tree。請注意，這些是終端機指令——而在claude對話內部使用的同名/技能則是另一回事，需要於設定 ▸ 一般中開啟Vela Skills功能。vopen會將這些內容傳送到中央分頁：

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

完整顯示的文件分頁（雙模式編輯、查找與取代、PDF匯出）：文件與瀏覽器分頁。透過vspawn產生的分頁：會話產生與Git協作。

5. shell選擇（僅限Windows）

在Windows上，終端機會話可透過「新建」子選單、會話編輯頁面的下拉選單，或右鍵選擇「Shell ▸」，明確指定要使用的shell——PowerShell / pwsh / cmd / Git Bash——正在運行的會話會在重新啟動時套用此更改。設定 ▸ 終端機 ▸「預設shell」可設定新會話的預設值。

關於附帶的Git Bash：完整安裝版會附上完整套件（包含git、ssh、perl）；精簡安裝版則只包含核心功能，若缺少某些指令，系統會提示您下載完整版（也可透過右鍵選擇「下載完整Git Bash」來取得）。Agent會話不受影響——它們始終使用PowerShell。

macOS / Linux沒有shell選擇器；會話會使用系統預設的shell（$SHELL）。

6. 會話錄製

設定 ▸ 進階 ▸「錄製會話日誌」（預設為關閉）。開啟後，會從會話開始的那一刻起，將終端機內容錄製到本地檔案中（每個會話的錄製大小上限為50MB）。這項功能有兩個好處：

• 已存檔的會話可以完整重現終端機的當時畫面；
• 全局搜尋功能可以找出純終端機輸出的內容（Agent對話不需要錄製——它們已有對話記錄）。

當會話被刪除時，錄製的檔案也會被清除。

7. 常見快捷鍵

macOS的預設快捷鍵如下；在Windows / Linux上，⌘需替換為Ctrl+Alt（有幾個例外——請參考設定頁面）。除了⌘1–9以及字體大小相關的快捷鍵外，其餘所有快捷鍵都可在設定 ▸ 快捷鍵中重新設定。