AI 智慧體會話
本章說明 VelaTerm 如何將 AI 程式設計智慧體作為具有類型的會話執行：支援的智慧體、即時狀態、自動恢復對話、匯入與分叉對話、權限模式、啟動設定、安裝指引與資訊面板。會話檢視另有專章說明：會話檢視。
1. 支援的智慧體
VelaTerm 可以啟動以下智慧體：Claude Code（顯示為「Claude」）、Codex、OpenCode、Copilot、Cursor、Antigravity、Cline、Pi、OMP、Crush、Kimi Code、Kiro、Grok Build 與 Zoo Code。每個智慧體都必須先安裝其 CLI 並完成登入。
各智慧體支援的功能不同：
| 智慧體 | 狀態回報 | 「需要您」狀態 | 恢復 | 分叉 | 權限控制 | 會話檢視 |
|---|---|---|---|---|---|---|
| Claude Code | 由智慧體回報 | ✅ | ✅ | ✅ | 五種模式 | ✅ |
| Codex | 由智慧體回報 | ✅ | ✅ | ✅ | 三種模式 | ✅ |
| OpenCode | 由智慧體回報 | ✅ | ✅ | ✗ | 兩種模式 | ✅ |
| Copilot | 由智慧體回報 | ✅ | ✅ | ✗ | 跳過開關 | ✗ |
| Cursor | 由智慧體回報 | ✗ | ✅ | ✗ | 跳過開關 | ✗ |
| Antigravity | 由智慧體回報 | ✗ | ✅ | ✗ | 跳過開關 | ✗ |
| Cline | 由智慧體回報 | ✗ | ✅ | ✗ | 跳過開關 | ✗ |
| Pi | 由智慧體回報 | — | ✅ | ✅ | 無（Pi 不會詢問） | ✅ |
| OMP | 由智慧體回報 | ✅ | ✅ | ✅ | 跳過開關；在會話檢視中有兩種模式 | ✅ |
| Crush | 部分由智慧體回報，部分從畫面讀取 | ✅ | ✅ | ✗ | 跳過開關 | ✗ |
| Kimi Code | 由智慧體回報 | ✅ | ✅ | ✗ | 跳過開關 | ✗ |
| Kiro | 由智慧體回報 | ✗ | ✅ | ✗ | 跳過開關 | ✗ |
| Grok Build | 由智慧體回報 | ✅ | ✅ | ✗ | 跳過開關 | ✗ |
| Zoo Code | 從畫面讀取 | ✅ | ✅ | ✗ | 跳過開關 | ✗ |
- 由智慧體回報表示智慧體本身會在開始工作、需要您處理與完成時通知 VelaTerm，因此狀態準確。Codex 的版本支援生命週期掛鉤時，會回報每個階段；較舊的 Codex 版本只會在回合結束時回報。「需要您」欄位顯示 ✗ 的智慧體不會回報提問或權限提示，因此在回合結束前，會話都會顯示「工作中」。
- 從畫面讀取表示 VelaTerm 會從智慧體的終端機介面辨識其狀態。
- 對於 Copilot、Cursor、Antigravity、Kimi Code、Kiro 與 Grok Build，VelaTerm 會在您第一次啟動此類會話時，在智慧體的使用者設定中加入自己的項目。智慧體在 VelaTerm 之外執行時，這些項目不會產生任何作用。
- 您自行在一般終端機中啟動的智慧體不受影響；狀態回報僅適用於由 VelaTerm 啟動的智慧體會話。
2. 建立智慧體會話
- 右鍵選單。 在專案、群組或會話上按右鍵。選單第一層提供三個智慧體：一開始是 Claude、Codex 與 OpenCode，之後則是您最近建立的三種智慧體類型。「更多 Agent 會話」會列出所有智慧體、您已儲存的預設組合、「自訂參數新增…」與「建立智慧代理工作階段」（可搜尋的選擇器）。
- 智慧體會話選擇器。 在 macOS 上按 ⌘N（在 Windows、Linux 與一般瀏覽器中為 Ctrl+Alt+N）會開啟可搜尋的智慧體與預設組合清單，最近的選擇會標示為「上次使用」。請參閱設定與快捷鍵 §9。
- 子會話。 會話的「新增子會話」子選單會在該會話之下建立新會話。也可以從對話中啟動會話；請參閱會話派生與 Git 協作。
自訂參數新增… 會開啟一個對話方塊，其中包括智慧體類型（「Agent 類型」）、選填的名稱（「會話名稱（留空自動命名）」）、「啟動參數（可選）」、可指定僅供此會話使用之替代執行檔的「可執行檔（選填）」、權限設定、適用於支援兩種檢視之智慧體的「開啟方式」（「終端機檢視」或「會話檢視」），以及「Worktree」選項。「儲存為預設組合」會以指定名稱儲存這些設定，並可選擇圖示。預設組合會出現在選單與選擇器中，並以其儲存的可執行檔、參數與權限設定啟動。
Claude、Codex、OpenCode、Pi 與 OMP 會話預設以會話檢視開啟；其他智慧體則以終端機檢視開啟。可在設定 ▸ 智慧體 ▸「預設檢視」中依智慧體分別變更。
3. 狀態點：誰在工作，誰需要您
每個智慧體會話旁的圓點會即時更新：
| 圓點 | 意義 |
|---|---|
| 綠色，脈動 | 工作中 |
| 黃色，脈動 | 需要您處理：提問或權限請求 |
| 黃色，漣漪擴散，該列帶有黃色色條 | 未讀：智慧體在您查看其他內容時已完成或提出問題 |
| 洋紅色 | 已回覆，且您已看過 |
| 藍色 | 執行中，但沒有回報任何智慧體活動 |
| 紅色 | 錯誤 |
| 灰色 | 無法取得狀態 |
智慧體停下來等待您時（提問、權限請求或回合結束），您會收到系統通知，該會話會標示為未讀，Dock 圖示標記也會將其計入。如果您正在查看該會話，則不會顯示通知。在已簽署的 macOS 版本中，點選通知即可開啟該會話。狀態列中的「通知：開」／「通知：關」項目可開啟或關閉系統通知；未讀標示與圖示標記則不受影響。有圖示標記時，側邊欄頂端會顯示一個按鈕，可一次清除所有標記。
狀態列的「工作中」、「等待處理」與「已查看」計數器可將側邊欄篩選為處於該狀態的會話；請參閱介面與會話管理 §6。
4. 自動恢復：關閉後再開啟，對話會接著進行
用一句話說明這個概念：樹狀結構中的每個智慧體會話節點，都是一段持續進行的對話。
- 首次執行時，VelaTerm 會記下智慧體本身的對話 ID。
- 之後，無論您是關閉分頁還是結束應用程式，再次開啟該節點時都會繼續同一段對話。恢復之前，VelaTerm 會確認該對話仍然存在；如果對話已被刪除，會話會重新開始，而不會啟動失敗。
- 如需開始新的對話，請建立新的會話節點。在會話檢視中，
/clear會在原位置以一個新的空白會話取代目前的會話。
位於新增會話選單末端的恢復會話… 可加入您已有的對話，例如在一般終端機中執行過的對話。請選擇「Agent 類型」，貼上智慧體的對話 ID，然後選擇「恢復並開啟」。§1 中的每種智慧體類型都可以用這種方式恢復。
專案右鍵選單中的匯入會話… 會列出工作目錄與專案目錄完全相同的現有 Codex、Claude、OpenCode 與 Kiro 對話。可依標題、智慧體或會話 ID 搜尋（「搜尋標題、Agent 名稱或會話 ID」），選取項目後選擇「匯入」。這些對話會加入專案樹；開啟任一對話即可繼續。匯入不會複製或變更智慧體本身的歷史記錄。已在 VelaTerm 中的對話（包括已封存的對話）會標示為「已匯入」。位於子目錄或獨立 worktree 中的對話，只有在將該目錄作為獨立專案開啟時才會出現。Kiro 的歷史記錄中，僅純文字記錄可供檢視。連線到遠端 VelaTerm 時，清單內容來自遠端電腦。
5. 分叉：從對話分出支線
對於已有對話的 Claude、Codex、Pi 與 OMP 會話，按右鍵 →「Fork 會話」。這會建立一個同層級節點，以來源對話目前的歷史記錄為起點，來源對話則保持不變，類似 git 的分支。可用來從相同的上下文嘗試兩種做法。
6. 權限
權限設定決定智慧體可以在不詢問您的情況下執行多少操作。
- Claude、Codex 與 OpenCode 具有具名模式。Claude：「計畫模式」、「每次詢問」、「自動接受變更」、「自動判斷」、「全部放行」。Codex：「唯讀」、「自動判斷」、「完整存取」。OpenCode：「每次詢問」、「全部放行」。
- Copilot、Cursor、Antigravity、Cline、OMP、Crush、Kimi Code、Kiro、Grok Build 與 Zoo Code 只有一個開關「跳過全部權限確認」，開啟後會以智慧體本身的略過權限選項啟動智慧體。在會話檢視中，OMP 提供「每次詢問」與「全部放行」。
- Pi 執行工具時不會詢問，因此沒有權限設定。
變更位置：
- 個別會話：會話的「編輯」表單（「權限」或「跳過全部權限確認」核取方塊）；在終端機檢視中，使用狀態列中的權限項目（「權限：詢問」／「權限：跳過」，或目前的模式名稱）；在會話檢視中，使用訊息輸入框下方的權限控制項。
- 新會話的預設值：設定 ▸ 智慧體 ▸「權限」。狀態列與會話檢視的選單也提供「設為預設」。
部分變更需要重新啟動智慧體後才會生效。此時 VelaTerm 會提供「立即重啟」或「稍後」；重新啟動會恢復對話，但會中斷執行中的任務。「全部放行」、「完整存取」與「跳過全部權限確認」會略過所有確認，請謹慎使用。
7. 啟動設定與安裝指引
啟動參數。 會話的「編輯」表單中有「啟動參數（可選）」，可為該會話加入命令列參數。設定 ▸ 智慧體中可為每種智慧體類型設定預設值。
可執行檔路徑。 如果智慧體安裝在 PATH 之外，請在設定 ▸ 智慧體中設定其「可執行檔路徑（可選）」。留空時，會從 PATH 中尋找指令。
尚未安裝？ 啟動尚未安裝的智慧體時，會話中會顯示一張卡片：「<Agent> 尚未安裝」，並附上適用於您系統的建議安裝指令。
- 「一鍵安裝」會在會話中執行該指令。找到已安裝的程式後，其路徑會儲存到設定中，並出現對話方塊，提供「立即重新啟動」或「稍後」。
- 「重試啟動」會重新啟動會話，例如在您自行安裝智慧體之後。
- 如果智慧體已安裝在 PATH 之外，請在「可執行檔路徑」中輸入完整路徑並選擇「使用這個路徑」，或使用「瀏覽…」。
- 「安裝文件」會開啟智慧體的安裝說明文件；「我自己裝」會關閉卡片。
安裝完成後，每個智慧體仍需各自登入或設定 API 金鑰。
8. 資訊面板：用量、上下文與資源
開啟智慧體會話時，右側面板的「資訊」分頁會顯示：
- Agent：智慧體類型、會話名稱、工作目錄、Git 分支、啟動時間與已執行時間。Kiro 會話還會提供連結，可開啟對話歷史記錄的唯讀檢視。
- Usage（Claude、Codex、Grok Build）：帳號配額用量，例如五小時與七天的時間範圍，以及各自的重設時間。↻ 按鈕可立即重新整理。自動重新整理及其間隔可在設定 ▸ 行為（「額度自動刷新」、「額度刷新」）中設定。重新整理失敗時，會繼續顯示上次的數值，並加上「stale」標示。
- This turn（Claude、Codex、Grok Build、OpenCode、Pi、OMP、Kiro）：模型、上下文視窗的使用程度，以及目前回合的 token 數量與工具。
- Resources：會話處理程序的 CPU 與記憶體用量；勾選「system」選項可加入整台電腦的數值。
9. 對話記錄、匯出與封存
- 按右鍵 →「匯出會話…」（Claude 與 Codex，需已有對話）會將完整對話寫入 Markdown 檔案，包括推理過程，以及每個工具呼叫的輸入與結果。
- 會話選單中的「整理至工作階段知識庫」會讓智慧體從對話中擷取可重複運用的知識；請參閱工作階段知識庫。
- 已封存的會話可在知識庫的「已封存會話」檢視中閱讀。Claude、Codex、OpenCode、Pi、OMP、Grok Build 與 Kiro 的對話會以訊息形式顯示；其他智慧體如有終端機錄製內容，則會顯示錄製內容。還原已封存的會話會保留其對話 ID，因此可以照常恢復。請參閱介面與會話管理 §8。
10. 其他行為
- 自動命名：未命名的會話會以您的第一則訊息作為名稱。
- 主題變更：在淺色與深色之間切換時，以終端機檢視執行中的 Claude 會話會隨之更新，無須重新啟動。
- Vela 技能：設定 ▸ 一般 ▸「Vela 技能」可為 Claude Code 與 Codex 安裝技能，用於啟動子會話、開啟檔案，以及讀取其他會話或傳送訊息給其他會話；請參閱會話指令。
- Windows：Claude Code 與 Codex 獲得完整支援（在 PowerShell 中執行）；其他智慧體則盡力提供支援。