使用手冊

文件與瀏覽器分頁

中央區域的分頁不只有終端機。本章介紹另外兩種分頁:文件分頁(內建的 Markdown 與程式碼編輯器)與瀏覽器分頁(內嵌的網頁)。它們與會話分頁共用分頁列,開啟會話時也不會取代它們。

1. 文件分頁

1.1 開啟

以下情況會開啟文件分頁:

  • 在任何會話中執行 vopen <file>(在設定 ▸ 一般中安裝「Vela 技能」後,在 Claude Code 中使用 /vopen 技能也有相同效果);
  • 在右側面板的「檔案」分頁中按兩下檔案,或選擇「在編輯器中開啟」;
  • 從知識庫開啟筆記(請參閱本機知識庫);
  • 點選分頁列右端的「新增文件」。

檢視方式依檔案類型而定:

類型檢視
md / markdown / mdxMarkdown 編輯器,提供「所見即所得」、「原始碼模式」與「對照模式」;預設以「所見即所得」開啟
圖片(png、jpg、jpeg、gif、webp、svg、bmp、ico、avif)圖片檢視器,提供「適應視窗」與「1:1」
其他所有檔案程式碼編輯器,依檔名選擇語法醒目提示

以 vopen 開啟的 Markdown 文件

1.2 Markdown 編輯器

  • 所見即所得模式可直接以最終呈現的樣式進行編輯。輸入 / 可開啟插入選單(標題、清單、待辦清單、引文、程式碼區塊、表格、數學式、圖片與分隔線)。以圍欄標記的 mermaid 程式碼區塊會在區塊下方算繪為圖表。
  • 原始碼模式會完全依照儲存內容顯示檔案文字(包括 YAML front matter),並提供 Markdown 語法醒目提示。
  • 對照模式會並排顯示所見即所得與原始碼,無論編輯哪一側,兩者都會保持同步。
  • ⌘/(在 Windows 與 Linux 上為 Ctrl+/)可在所見即所得與原始碼之間切換。僅切換模式而未編輯時,檔案不會變更。
  • 將圖片貼上或拖放到已儲存的文件中時,圖片會儲存到文件旁的 assets 資料夾,並插入指向該圖片的相對連結。

1.3 編輯與儲存

  • ⌘S 或「儲存」按鈕會將檔案寫入磁碟。分頁上的圓點表示有尚未儲存的變更。
  • 目前使用中的文件每兩秒檢查一次磁碟。如果其他程式變更了檔案,會出現橫幅提供「重新載入」與「忽略」;如果您也有尚未儲存的編輯,重新載入按鈕會顯示為「重新載入(捨棄我的修改)」。如果在您開始編輯後,磁碟上的檔案有所變更,儲存時會先以「儲存衝突」對話方塊要求確認,再覆寫檔案。
  • 關閉有未儲存變更的分頁時,會要求您選擇「儲存並關閉」、「不儲存關閉」或「取消」。
  • ⌘F 會開啟搜尋列,提供尋找、取代、全部取代與「區分大小寫」;在每種模式下的操作方式都相同。
  • 「側欄」按鈕會顯示文件的「大綱」與其所在資料夾的「目錄樹」;點選其中的檔案即可開啟。側欄可以調整寬度。
  • 大於 10 MB 的檔案會以唯讀方式開啟,且只顯示前 10 MB,以免儲存時截斷檔案的其餘部分。
  • 在文件分頁上按右鍵,除了一般的關閉操作外,還會提供「重新整理檔案」;Markdown 文件另外提供「匯出 PDF」。

1.4 新增文件與匯出 PDF

  • 「新增文件」會開啟一份尚未存到磁碟、也不會出現在專案樹中的空白草稿。第一次儲存時會詢問儲存位置:桌面版使用系統的「另存新檔」對話方塊;瀏覽器用戶端與遠端連線視窗則會顯示「另存新檔」對話方塊,讓您在執行該會話的機器上選擇位置。語法醒目提示會依所選的檔名決定。在草稿的分頁上按右鍵,也會提供「儲存到磁碟…」。
  • 「匯出 PDF」會將 Markdown 文件轉換為向量 PDF,並自動分頁及內嵌中日韓字型。桌面版會詢問檔案的儲存位置;瀏覽器用戶端則會直接下載。

2. 瀏覽器分頁(僅限桌面版)

瀏覽器分頁會在 VelaTerm 中顯示真正的網頁,方便您將說明文件、問題追蹤頁面或本機預覽放在會話旁邊。此功能僅在桌面版中提供,瀏覽器用戶端、遠端連線視窗與行動版版面均不提供。

開啟瀏覽器分頁的方式:

  • 分頁列右端的「內建瀏覽器」按鈕;
  • ⌘⇧B 快捷鍵;
  • 在會話中執行 vopen <URL>;
  • 側邊欄中專案或群組右鍵選單內的「新增瀏覽器頁面」。

工具列: 「上一頁」、「下一頁」、「重新整理」(頁面載入時為「停止載入」)、網址列(「輸入網址或搜尋字詞」;不是網址的文字會以 Google 搜尋)、「以系統瀏覽器開啟」,以及包含 ChatGPT、Claude、Gemini 與 Google 的「快速存取」列。

兩種形式:

  • 瀏覽器分頁:透過按鈕、⌘⇧B 或 vopen <URL> 開啟。它不會儲存在專案樹中,重新啟動後也不會保留。
  • 瀏覽器頁面節點:透過「新增瀏覽器頁面」建立。它是專案樹中的節點,會記住其網址,重新啟動後仍會存在。

開啟新視窗的連結: 網頁以新視窗開啟連結時(例如 target="_blank" 連結),VelaTerm 會在新的瀏覽器分頁中開啟。

獨立頁面: 分頁列右端的「遊戲中心」按鈕會以獨立頁面開啟 VelaTerm 遊戲中心。獨立頁面沒有網址列或快速存取列,只有「上一頁」、「下一頁」與「重新整理」;它所開啟的連結會留在同一個分頁中。

安全界線: 內嵌的網頁會被視為一般的外部網站。它不會取得任何 VelaTerm 權限或憑證,而且只能開啟 http 與 https 網址。

3. 各類分頁如何並存

  • 會話、文件與瀏覽器分頁共用同一個分頁列,⌘1–9 可在所有分頁之間切換。
  • 從樹狀結構開啟會話時,只會沿用會話分頁;文件與瀏覽器分頁一律不會被取代。
  • 文件與瀏覽器分頁無法分割。⌘W 會直接將其關閉(有未儲存變更的文件會先詢問)。