檔案

「檔案」（⌘1）在佇列裡展示當前倉庫的工作區，中間檢視器負責預覽。

檔案樹

• 目錄按需載入，展開才讀取；單個目錄最多列出 2000 項，超出部分在底部提示；
• 顯示 Git 狀態標記，未跟蹤、已修改、已刪除與符號連結一眼可辨；
• 裸倉庫沒有工作區，該標籤會說明原因而不是顯示空列表。

預覽

• 文本預覽上限為 512 KiB 或 5000 行，超出時提示用外部應用開啟；
• 二進位制檔案不渲染，直接給出用預設應用開啟的入口；
• Markdown 可以在渲染檢視與原始碼之間切換；已刪除的檔案顯示 HEAD 中的版本；
• 預覽內容可以複製。

預覽是隻讀的。編輯請用外部編輯器，或直接在檔案樹裡做檔案級操作。

快速開啟與搜尋

搜尋結果有上限（最多 500 條），達到上限時會提示縮小範圍。搜尋可以被取消，取消後進程會被終止，不會在後臺繼續跑。

檔案操作

• 新建檔案、新建資料夾；
• 重新命名、製作副本；
• 複製、剪下、貼上；
• 刪除，刪除前需要確認。

所有操作都限定在當前倉庫根目錄內：路徑不會越出根目錄，.git 目錄不可寫，指向根目錄之外的符號連結不會被跟隨。

貼上時優先匯入系統剪貼簿裡的檔案；只有文本或圖片資料時，分別寫成 pasted.txt 或 pasted.png，大小上限 8 MiB。同一目錄下重名不會覆蓋，會按 copy、copy 2 這類字尾生成新名字；移動操作會先檢查全部目標路徑，絕不覆蓋已有檔案。

檔案操作隻影響磁碟與工作區，不改寫 Git 歷史。刪除已跟蹤檔案後，變更列表裡會出現對應的刪除記錄。

外部編輯器

應用會檢測系統裡已安裝的編輯器，例如 Cursor、VS Code、Zed 等。

• 從「在編輯器中開啟」選單選擇目標，選擇會被記住，之後預設用它；
• 也可以選擇「系統預設應用」；
• 快速開啟裡用 ⌘⏎ 直接在選中的編輯器裡開啟檔案；
• 無法識別的編輯器不會被執行。