介面與會話管理

本章介紹 VelaTerm 的組織方式：視窗版面、樹狀結構的管理、分頁與分割窗格的行為、狀態點與篩選、封存、全域搜尋，以及結束時儲存工作區。其他章節都以這些內容為基礎。

1. 版面配置

遠端存取與連線到遠端服務僅出現在桌面版中；請參閱遠端開發與管理。意見回饋會在瀏覽器中開啟 VelaTerm 的意見回饋頁面。在 Windows 與 Linux 上按下 Alt 會顯示選單列，其中包含「檔案」、「終端機」與「說明」。

兩側面板都可以透過標題列按鈕隱藏，也可以拖曳邊緣調整寬度。

2. 樹狀結構：專案、集合、群組、會話

• 專案是磁碟上的一個目錄，也是一棵子樹的根節點。可透過「建立專案」（建立新資料夾）、「匯入專案」（開啟現有資料夾，⌘O）或「從 Git 複製」建立。
• 集合是不對應任何資料夾的頂層容器，用於存放不屬於單一專案的會話。請使用側邊欄底部的「新增集合」按鈕建立。
• 群組是用於整理的節點，可任意多層巢狀。
• 會話是工作的基本單位，可以是一個智慧體、一個瀏覽器頁面或一個終端機。其工作目錄預設為專案根目錄，可在會話的「編輯」表單中變更。

將滑鼠移到某一列上時會顯示 ＋ 按鈕（在專案與群組上為「新增會話」，在會話上為「新增子會話」）；在專案與群組上，還會顯示新增群組的按鈕。

大部分操作都在右鍵選單中：

專案與群組選單的開頭是建立項目：

• 「新增瀏覽器頁面」（桌面版）與「新增終端機」，後者會在該目錄中開啟臨時終端機（§5）。
• 三個可直接建立最近使用之智慧體的「新增 … 會話」項目，以及「更多 Agent 會話」，其中包含所有智慧體、已儲存的預設組合、「建立智慧代理工作階段」（可搜尋的選擇器）與「自訂參數新增…」。
• 「新增 worktree 會話…」與「新增規劃/執行會話…」；請參閱會話派生與 Git 協作與規劃與執行。
• 「匯入會話…」（僅限專案）與「恢復會話…」；請參閱AI 智慧體會話 §4。

專案選單接著提供「新增群組」、「標記」、「實驗性功能」（程式碼圖譜與程式碼稽核）、「專案資訊」（或「集合資訊」）、「重新命名」與「移除專案」（或「刪除集合」）。群組選單則提供「Git」子選單、「新增子群組」、「轉移到 Worktree…」、「標記」、「重新命名」、「封存分組」與「刪除群組」。

會話選單會依會話的類型與狀態顯示適用的項目：

• 「開啟」、「在新分頁開啟」、「在右側分割開啟」、「在下方分割開啟」、「在目前窗格開啟」（§4）。
• 「新增子會話」、「Fork 會話」、「匯出會話…」、「整理至工作階段知識庫」，以及「Git」子選單。
• 「標記」、「會話資訊」（按住 Option／Alt 可查看完整的啟動指令）、「編輯」、「重新命名」、「移動到…」。
• 「結束處理程序」（執行中時）、「封存會話」、「刪除會話」。

其他樹狀結構操作：

• 移動：拖曳節點，或使用「移動到…」。會話可以移到另一個會話之下，成為其子會話。
• 重新命名：「重新命名」可直接就地編輯名稱。未命名的會話會以您的第一則訊息作為名稱。
• 標記：「標記」可為專案、群組或會話加上表情符號標記：🔥 緊急、⭐ 重要、🐛 缺陷、✅ 已完成、🚧 進行中、📌 置頂關注、💡 想法、⚠️ 注意。再次選擇目前的標記即可將其移除。
• 多選：按住 ⌘／Ctrl 點選可切換會話的選取狀態，按住 Shift 點選可選取一個範圍。此時右鍵選單會提供「開啟選取的會話」、「並排選取的會話」（二至四個會話）、「移動所選到…」、「封存選取的會話」與「刪除選取的 N 項」。拖曳選取的項目會將其全部移動。
• 收合狀態在重新啟動後仍會保留。

3. 分頁

設定 ▸ 行為 ▸「分頁」決定會話的開啟方式：

• 單分頁（預設）：在樹狀結構中點選智慧體會話時，會沿用目前的會話分頁，就像在瀏覽器中點選連結一樣。離開的分頁會連同其所有窗格移到背景，處理程序繼續執行。終端機會話則在各自的分頁中開啟。
• 多分頁：每個會話都在各自的分頁中開啟。

「在新分頁開啟」一律會開啟新的分頁。在兩種模式下，切換到其他分頁都不會停止任何處理程序；關閉分頁（⌘W 或 ×）會結束其處理程序。對智慧體會話而言，這不會造成損失：對話會保留下來，再次開啟該節點即可恢復。

背景分頁會以「背景 N/M」顯示在狀態列中；點選後可將分頁切回前景，或將其結束。在單分頁模式下，「背景保活上限」（預設 32）會限制背景分頁的數量。超過上限時，閒置最久的背景分頁會自動結束。如果所有背景分頁都在工作或等待您回應，VelaTerm 會詢問要結束哪一個。

分頁列的其他細節：

• ⌘1–9（在 Windows 與 Linux 上為 Ctrl+1–9）可依位置切換分頁。以滑鼠中鍵點選分頁即可將其關閉。
• 分頁後方的 ＋ 會開啟臨時終端機。右側的按鈕可開啟新的終端機、新文件、內建瀏覽器分頁（桌面版）與遊戲中心。
• 分頁的右鍵選單包含「關閉分頁」、「關閉其他分頁」、「關閉右側分頁」、「關閉所有分頁」、「轉入背景保活」（讓分頁的處理程序繼續執行），以及與樹狀結構相同的會話項目。

文件分頁與瀏覽器分頁的說明請見文件與瀏覽器分頁。

4. 分割窗格

一個分頁可以包含多個窗格：

• ⌘D 向右分割，⌘⇧D 向下分割（在 Windows 與 Linux 上為 Ctrl+Alt+D 與 Ctrl+Alt+E）；窗格標頭中也有相同的按鈕。新窗格是臨時終端機，會在目前窗格的工作目錄中啟動。
• 如要在目前分頁中顯示現有的會話，請從其選單中選擇「在右側分割開啟」、「在下方分割開啟」或「在目前窗格開啟」，或將其從側邊欄拖曳到中央區域。
• 「並排選取的會話」會將選取的二至四個會話排列在同一個分頁中。
• 顯示在目前分頁其他窗格中的會話，會在側邊欄中醒目標示。

分隔線可以拖曳。背景保活以整個分頁為單位，因此離開分頁再回來時，版面配置會保持不變。⌘W 會關閉目前的窗格；關閉最後一個窗格時，分頁也會一併關閉。

5. 臨時終端機

「新增終端機」、⌘T 與分頁列中的 ＋ 都會開啟臨時終端機。臨時終端機只以分頁形式存在：它不會成為樹狀結構中的節點，關閉後即捨棄。其分頁上會標示「臨時」。臨時終端機適合執行簡短的指令；需要長時間執行的工作請放在智慧體會話中。臨時終端機的選單較為精簡：「開啟」、「在新分頁開啟」、分割相關項目、「重新命名」、「會話資訊」與「關閉草稿」。

6. 狀態點與篩選

每個智慧體會話旁的圓點表示其狀態：工作中為綠色，需要您處理時為黃色，已回覆且您已看過時為洋紅色。完整的說明請見AI 智慧體會話 §3。

狀態列會顯示「工作中」、「等待處理」（需要您處理）與「已查看」的會話數量；沒有會話的計數器會隱藏。點選計數器後，側邊欄只會顯示處於該狀態的會話；再次點選即可清除篩選。

側邊欄也有自己的工具：

• 搜尋框（「搜尋會話 / 群組…」）可依名稱篩選樹狀結構。
• 篩選按鈕（「狀態篩選」）可選擇一或多種狀態，另外也可選擇一種標記。
• 狀態篩選會保留設定當下符合條件的會話，因此工作期間清單不會跳動。啟用「狀態篩選動態增加」（設定 ▸ 行為，預設開啟）後，之後開始符合條件的會話也會加入。側邊欄底部的「重新整理狀態篩選」會重新檢查每個會話；會話選單中的「重新整理狀態」只會檢查該會話。
• 側邊欄底部的「向下切分樹分身」會新增第二個樹狀檢視，擁有獨立的搜尋與篩選，例如一個檢視顯示需要您處理的會話，另一個顯示完整的樹狀結構。每個額外的檢視都可以關閉。

7. 右側面板

• 檔案：會話工作目錄的檔案樹。按兩下檔案即可在文件分頁中開啟。
• 資訊：會話詳細資料、帳號用量、目前回合與資源使用情況；請參閱AI 智慧體會話 §8。
• Git：分支、已暫存與未暫存的變更、未追蹤的檔案、提交，以及提交歷史。
• 知識庫：「工作階段知識庫」、已封存的會話，以及您的本機知識庫；請參閱本機知識庫與工作階段知識庫。

8. 封存：收起來，而不是刪除

已完成的工作不必刪除。在會話上按右鍵 →「封存會話」即可將其隱藏：該會話及其子會話會從樹狀結構中移除，處理程序也會結束，但所有資料都會保留。「封存分組」會封存群組中的所有會話，「封存選取的會話」則會封存選取的會話。

已封存的會話位於知識庫中。請使用側邊欄頂端的「已封存會話」按鈕開啟。已封存的會話依專案分組，搜尋框（「搜尋封存內容…」）可搜尋其內容。每個已封存的會話都支援以下操作：

• 閱讀對話。智慧體會話會顯示訊息；沒有可用的對話時，如果有終端機錄製內容，則會改為顯示錄製內容。第二個分頁會列出從該會話產生的知識條目。
• 「恢復為正常會話」會將其放回樹狀結構中的原位置，並保留對話 ID，因此開啟後會恢復原本的對話。
• 「整理至工作階段知識庫」會從中擷取可重複運用的知識。
• 「匯出完整上下文為 Markdown」（Claude 與 Codex）會將完整對話寫入檔案。
• 「徹底刪除（連帶錄製）」是唯一會移除資料的操作。

9. 全域搜尋（⌘⇧F）

「搜尋所有會話」（⌘⇧F；在 Windows 與 Linux 上為 Ctrl+Alt+G）會搜尋所有會話的內容，包括智慧體對話與已錄製的終端機輸出，而不僅是名稱。

• 可以任意順序組合多個詞語；部分詞語以及中文、日文或韓文文字也能搜尋到。結果依相關性排序。
• 結果在左側依會話分組；右側的預覽會醒目標示目前的符合項目。↑／↓ 與 Enter 可跨會話逐一瀏覽符合項目。
• 「開啟會話」會在工作區中開啟該會話。
• 除非勾選「同時搜尋封存」，否則搜尋結果不包含已封存的會話。

只有在啟用會話錄製（設定 ▸ 進階 ▸「記錄會話日誌」，預設關閉）時，才能搜尋終端機輸出。智慧體對話則一律可以搜尋。

10. 安全刪除

刪除會話會將其連同錄製內容永久移除。刪除包含已封存會話的群組或專案時，這些封存內容會保留下來；還原其中一個會話時，其專案與群組也會一併恢復。如有疑慮，請先封存：封存的內容隨時都可以還原。

11. 結束與還原工作區

結束時會詢問「結束 VelaTerm？」，並停止執行中的終端機與智慧體會話。勾選「儲存工作區」後，下次啟動時會重新開啟相同的分頁與分割。還原的會話不會自行啟動：每個窗格會顯示「已從儲存的工作區還原，程序尚未啟動。」以及「啟動」按鈕。此核取方塊會記住您上次的選擇。