VelaTerm 使用手冊
這是 VelaTerm 使用手冊。初次使用者建議依序閱讀前四章，其他章節可視需要查閱。
閱讀順序
| # | 章節 | 內容 | 適用對象 |
|---|---|---|---|
| 1 | 入門指南 | 安裝、新增專案、第一個終端機與第一個智慧體會話、視窗導覽 | 所有初次使用者，建議從這裡開始 |
| 2 | 介面與會話管理 | 視窗版面、專案樹及其選單、集合、標記、分頁與背景分頁、分割窗格與並排、狀態篩選、封存、全域搜尋、儲存工作區 | 所有使用者 |
| 3 | AI 智慧體會話 | 支援的十四種智慧體及其功能、狀態點與通知、恢復對話、匯入與分叉對話、權限、預設組合、安裝指引、資訊面板 | 使用 AI 程式設計智慧體的使用者 |
| 4 | 會話檢視 | 終端機檢視與會話檢視的切換、智慧體工作時傳送訊息（排入佇列、插話、中斷）、模型、推理強度與權限控制項、圖片、指令、回退、背景工作、用量上限重設後自動繼續、登入 | Claude Code、Codex、OpenCode、Pi 與 OMP 的使用者 |
| 5 | 會話派生與 Git 協作 | 以 vspawn 啟動子會話、確認卡片、worktree、Git 選單與圖形化合併 | 需要多個智慧體並行工作的使用者 |
| 6 | 規劃與執行 | 規劃會話與執行會話的工作流程、將工作拆分為多項任務並逐項確認、目錄模式、追蹤進度 | 需要規劃與驗收的大型任務 |
| 7 | 會話指令 | 十個內建指令（vspawn、vspawn-tree、vopen、vrefer、vsearch、vstat、vtell、vrun、vkb、vflow）、包括 vask 在內的 Vela 技能，以及 vela shell 指令的參考說明 | 供使用者與指令碼查閱 |
| 8 | 終端機使用方式 | 終端機基本操作、終端機內搜尋、複製與貼上、貼上圖片、指令建議、內建指令與以 vrun 執行的背景指令、Windows 上的 shell 選擇、會話錄製、算繪器選項、常用快捷鍵 | 所有使用者 |
| 9 | 指令建議 | 一般終端機中根據 shell 本身補全功能產生的建議：設定與操作方式、支援的 shell、整合的載入方式、Windows 上的現況、限制 | macOS 與 Linux 上的終端機使用者 |
| 10 | 文件與瀏覽器分頁 | 文件分頁（開啟檔案、Markdown 編輯器、編輯與儲存、新增文件與匯出 PDF）、桌面版的瀏覽器分頁，以及各類分頁如何並存 | 視需要查閱 |
| 11 | 本機知識庫 | 以 Markdown 資料夾作為知識庫：開啟或建立知識庫、匯入檔案與資料夾、撰寫與整理筆記、搜尋、連結、從工作階段知識庫複製、儲存方式 | 記錄筆記與撰寫文件 |
| 12 | 工作階段知識庫 | 從會話整理知識、整理紀錄、瀏覽與維護條目、已封存的會話、與程式碼圖譜的連結 | 保存智慧體工作中的決策與經驗教訓 |
| 13 | 程式碼圖譜與知識庫 | 為專案程式碼建立索引、檢視符號及其關係、連結與檢閱知識條目、從會話查詢、資料儲存位置（實驗性功能） | 探索程式碼 |
| 14 | 程式碼稽核 | 以 Codex 或 Claude Code 對專案進行安全稽核：模型與推理強度、Codex Security 整合、稽核範圍、報告、匯出（實驗性功能） | 安全性審查 |
| 15 | 設定與快捷鍵 | 八個設定類別的所有項目、預設快捷鍵與重新設定方式、智慧體會話選擇器 | 參考資料 |
| 16 | 遠端開發與管理 | 供其他裝置使用的遠端存取、透過 SSH（包括 Windows 主機與鏡像遠端桌面版）、URL 或帳號連線到其他機器、透過 VelaTerm 帳號共用（實驗性功能）、檔案傳輸、在手機上使用 VelaTerm、中斷連線後保留的內容、安全性 | 遠端與行動裝置使用 |
如需查看各版本的變更內容，請參閱變更記錄。
四個值得先了解的概念
- 樹狀結構中的每個智慧體會話都是一段持續進行的對話。 關閉後再次開啟，對話會接著進行。如需開始新的對話，請建立新的會話。
- 分頁的行為與瀏覽器相同。 預設情況下，開啟智慧體會話時會沿用目前的分頁，離開的分頁則在背景繼續執行。關閉分頁會結束其處理程序，即使如此，智慧體對話仍可恢復。
- 同一段對話，兩種檢視。 Claude Code、Codex、OpenCode、Pi 與 OMP 可在會話檢視中執行，也可在各自的終端機介面中執行。切換檢視後，延續的仍是同一段對話。
- 封存不等於刪除。 將已完成的工作封存，可讓樹狀結構保持整潔。已封存的會話仍可在知識庫中閱讀，並可隨時還原或匯出。
關於截圖
本手冊的截圖均在使用示範資料的開發環境中擷取，介面語言為英文（產品預設），並採用深色主題。部分截圖早於近期的介面變更，例如右側面板的「知識庫」分頁、「意見回饋」按鈕，以及「對話檢視」設定類別；截圖與文字不一致時，以文字所描述的目前版本為準。帳號用量數值、路徑等細節均為範例值。