預覽窗格

在檔案上按 A（或 Enter ／雙擊）會在檔案清單右側開啟內建預覽 — 每個分頁一個 預覽。這個窗格會佔用視窗寬度的一部分，因此顯示媒體與 PDF 時仍相當寬敞。

可以預覽哪些內容

• 文字／程式碼 — 可捲動。
• 圖片 — PNG、JPEG、GIF、WebP、BMP — 依寬度縮放。
• HEIC / AVIF / JXL — 需要安裝圖片轉換工具（macOS 內建 sips；Linux/Windows 上可 用 heif-convert、ImageMagick 或 vips）。
• SVG。
• HTML 與 Markdown — 以靜態、不執行 JavaScript 的方式呈現（指令碼絕不會執 行，因此預覽無法進行任何主動行為）。
• PDF — 分頁顯示。

對於 SVG、HTML 和 Markdown，你可以用標題列的 </> 按鈕（或手把上的 X / F2）檢視原始原始碼，而不是算繪後的檢視。Markdown 顯示的是它原本的 .md 文字，而不是轉換後的 HTML。

右進入預覽面板。其他按鈕的作用取決於檔案類型：

• 文字／圖片／SVG/HTML/Markdown — 上／下捲動；A 以作業系統預設應用程式開啟 檔案。
• PDF — 上／下翻頁；Home / End 跳至第一頁／最後一頁；A 以外部應用程式開 啟。

層級：X 往下，B 往回

面板是一個小小的堆疊，兩個按鈕在其中朝相反方向移動。X 向檔案的原始位元組靠近一步；B（或 Escape）往回退一步，只有在最上層才會關閉。

檔案	X 往下 →
文字	閱讀 → 編輯 → 已關閉
SVG、HTML、Markdown	算繪 → 原始碼 → 編輯 → 已關閉
圖片、PDF	已關閉

文字檔沒有原始碼檢視，所以第一次按 X 就直接開始編輯。標記語言需要按兩次：一次顯示原始碼，一次開始編輯。標題列的 ✕ 無論你在哪一層都會直接關閉。

Note

音訊與影片不會被預覽。 播放它們必須隨附 libmpv/FFmpeg，而其 H.264/HEVC/AAC 解碼器可 能涉及專利授權金義務，因此這些檔案會改用您的預設應用程式開啟。

編輯文字檔

文字預覽可以就地編輯。面板標題列中的鉛筆按鈕（或手把上的 X）會把它變成可編輯欄位；按 Esc 或再次按下該按鈕即可離開編輯。只有文字可以編輯：其他類型是算繪出來的檢視，而不是緩衝區。這也是 X 從不與原始碼切換衝突的原因——文字檔沒有原始碼檢視。

Ctrl/Cmd+S 儲存，即使焦點已回到檔案清單也仍然有效。在手把上，只要有內容需要儲存，A 就會儲存；沒有內容需要儲存時，它照常在外部應用程式中開啟檔案。檔名旁的圓點表示有未儲存的變更，標題列中它的旁邊會出現儲存按鈕。

在 Steam Deck 上，X 會在欄位上方喚出螢幕鍵盤，Steam 的 B 會關閉它並把你交還給面板導覽。

檔案會照原樣寫回

DeckCrate 會記住它是如何讀取該檔案的，並以同樣的方式儲存：

• 編碼 — 以舊式 Latin-1（「ANSI」）讀取的檔案仍以 Latin-1 儲存，不會被悄悄重新編碼為 UTF-8。如果你輸入了 Latin-1 無法容納的字元（例如表情符號），檔案會轉換為 UTF-8，並有提示告知你。
• 換行字元 — CRLF 檔案會保持 CRLF，包括你剛剛輸入的行。
• 身分 — 儲存是就地寫入的，所以符號連結仍然是符號連結，權限、擁有者和延伸屬性都能在編輯後保留。

標記語言透過原始碼編輯

SVG、HTML 和 Markdown 同樣可以編輯——但只能從原始碼檢視進入，鉛筆按鈕也出現在那裡。算繪檢視不是緩衝區：從排版後的頁面沒有回到檔案的路徑，所以你編輯的是標記本身。

上面所說的一切同樣適用，包括編碼與換行字元方面的保證。有兩點是標記語言特有的：

• 儲存 .md 寫入的是 Markdown，絕不會寫入它被轉換成的 HTML。
• 算繪檢視會在儲存時重新整理，所以離開編輯器時你看到的是新內容，而不是開啟時磁碟上的那個版本。

帶著未儲存的變更退回算繪檢視，看到的是已儲存的版本，同時圓點仍然顯示——那是磁碟上的內容，而圓點表示還有更多。

未儲存的變更

任何會捨棄已編輯緩衝區的操作都會先詢問，並提供儲存、捨棄或取消（手把上的 A、Y 和 B）：

• 關閉面板，
• 預覽另一個檔案，
• 開啟終端機（它與預覽共用同一個位置），
• 把分頁數量減少到低於某個含未儲存變更的分頁，
• 從命令選單或工具列結束程式。

每個分頁都保留自己的緩衝區，所以切換分頁絕不會讓你失去輸入——圓點會一直顯示，直到你儲存或捨棄。

Caution

從作業系統標題列關閉視窗不在此提示的涵蓋範圍內，會捨棄未儲存的變更。

關閉算繪

偏好設定 → 預覽 → 算繪預覽預設開啟。關閉它，SVG、HTML 和 Markdown 就會直接以原始碼開啟——此時按一次 X 即可開始編輯，</> 按鈕消失，B 會關閉面板而不是顯示算繪檢視。對這些檔案來說，算繪層級根本不存在。

文字、圖片和 PDF 不受影響。此設定只作用於此後開啟的預覽；已經開啟的面板會保持它開啟時的層級。

當檔案無法預覽時

二進位檔、不支援的格式與過大的檔案無法預覽。DeckCrate 會改為提供 以作業系統預設應用程式開啟的選項。在該提示中，您也可以按 Y 來挑選特定的應用程式 （請參閱以指定的應用程式開啟檔案…）。

以預設應用程式開啟

您可以透過預覽窗格的 A 按鈕，以預設應用程式開啟任何檔案；無法預覽的檔案則可直接這麼 做。

以指定的應用程式開啟檔案…

若只標示了單一檔案，指令選單中的**以指定的應用程式開啟檔案…**項目會顯示一份可用控制器瀏 覽的已安裝應用程式清單，並依字母順序排列。A / Enter 確認，B / Esc 取消。在「無法 預覽」的提示中，它也會以 Y 的形式提供。macOS、Linux 與 Windows 皆支援。

Note

HEIC/AVIF/JXL 預覽仰賴系統上安裝的圖片轉換工具（macOS 內建 sips；Linux/Windows 上可用 heif-convert、ImageMagick 或 vips）。當它不存在時，這些檔案會退回到「以外部應用程式 開啟」的提示 — 其他所有格式仍可正常預覽。關於該安裝什麼，請參閱各平台的建置文件。