檔案瀏覽器

📁 Browse files（瀏覽檔案）讓你不必離開對話，就能查看中繼所在機器上的檔案：agent 工作的資料夾、機器的其他部分，以及 agent 自己的 session 所保存的資料夾。你可以用它查看 agent 改了什麼、開啟檔案、為下一則訊息複製參照，以及整理檔案。當你開始對話或變更它的工作資料夾時，也是用這個瀏覽器來選擇資料夾。

開啟方式 #

瀏覽器會以對話框的形式開在對話上方。它的標題會告訴你目前在哪個根目錄：Repository Browser（儲存庫瀏覽器）、Drives Browser（磁碟機瀏覽器）或 Session Browser（Session 瀏覽器）。用 × 或 Escape 關閉它。

在桌面上，對話框有左右並排的兩個窗格。左側窗格 File tree（檔案樹）只顯示資料夾。右側窗格顯示目前開啟之資料夾中的檔案，上方有一列路徑列。在手機上，兩個窗格上下排列，樹狀結構在上。在樹狀結構中點選資料夾即可開啟它。⌖ Focus（定位）會把樹狀結構收合到目前開啟的資料夾。旁邊的計數器會顯示樹狀結構中有多少項目，例如在 workspace 中為 12 nodes，在其他地方為 12 entries。

List（清單）和 Icons（圖示）會把檔案窗格切換為列或卡片。卡片會為圖片顯示縮圖。

三個根目錄 #

工具列左側的三個按鈕決定瀏覽器顯示的內容。

Workspace 是哪個資料夾 #

workspace 根目錄就是對話的工作資料夾。它會跟著你開啟的對話變化，而執行中的 session 會保留它實際在工作的資料夾。對話 ⋯ 選單中的 🗂️ Change CWD（變更工作資料夾）會在 agent 下次啟動時移動它，或用 🚀 Set new CWD and (re)launch（設定新工作資料夾並啟動或重新啟動）立即移動；見之後變更。工作資料夾變更時，瀏覽器會捨棄原本開啟的內容，改為顯示新的資料夾。在對話訊息中輸入 cd 不會移動瀏覽器。

Claude Cloud 對話在你的機器上沒有工作資料夾，也沒有檔案瀏覽器：agent 在 Anthropic 那邊的一份複本上工作。

磁碟機與 session 資料夾 #

磁碟機根目錄可以觸及整台機器，而不只是工作資料夾。限制對話可以在哪裡開始的允許清單（workspaceRootAllowList，見限制對話可以在哪裡開始）並不限制你能瀏覽的範圍。

session 資料夾列出 agent 的供應商為這個 session 保存的檔案。你可以查看並開啟它們。在 Session Browser 中，瀏覽器只提供 New folder（新增資料夾）：沒有 Rename（重新命名）或 Delete（刪除）。這是頁面的規則，而不是中繼的規則。透過 📀 開啟同一個資料夾時，會提供 Rename 和 Delete，中繼也不會拒絕。

工具列 #

Hidden 和 Heavy 第一次都是關閉的。名稱既是隱藏又是大型資料夾時，兩個開關都需要開啟。變更會立即生效，並重新整理樹狀結構。

你的瀏覽器會記住這些篩選條件：workspace 的 Hidden、磁碟機和 session 根目錄的 Hidden（兩者共用一個設定），以及 Heavy。它不會記住根目錄、檢視方式或哪些資料夾是展開的；這些只在頁面保持開啟期間有效，經過 Refresh 以及關閉再重新開啟對話框後仍會保留，但重新載入頁面後就不會。

開啟檔案 #

在檔案窗格中點選檔案，就會在檔案檢視器中開啟它。在資料夾選擇器（見下文）中無法開啟檔案。

在訊息中參照檔案或資料夾 #

有兩個控制項會把參照複製到剪貼簿，並以反引號包住。它們不會把參照放進輸入區：你要自己把它貼到訊息中。

在 workspace 中，路徑是相對於工作資料夾的路徑，例如 @folder:src/components。在磁碟機和 session 根目錄中，則是機器上的完整路徑。agent 收到參照時會得到什麼，以及圖片如何附加，請見檔案參照。

資料夾與檔案 #

0.9.10 新增 你可以建立資料夾、重新命名檔案和資料夾，以及刪除它們。這在 workspace 和磁碟機中都可以使用。在 session 資料夾中，瀏覽器只提供新增資料夾。

新增資料夾 #

📁+ New folder 會在檔案窗格頂端開啟一個名稱欄位。輸入名稱並按 Enter：資料夾會建立在目前開啟的資料夾中，瀏覽器也會開啟它。按 Escape 會取消。通知會顯示 Folder "name" created.。已被使用或系統拒絕的名稱會在欄位下方回報，欄位也會保持開啟。在沒有任何地方能容納資料夾時，例如 Windows 的磁碟機清單，按鈕會停用。

右鍵選單 #

在樹狀結構中的資料夾或檔案窗格中的檔案上按右鍵。在手機上則是長按。選單提供：

根目錄（工作資料夾、/ 或磁碟機）不提供 Rename 和 Delete，Session Browser 中的任何項目也不提供。你重新命名的資料夾會留在樹狀結構中原本的位置，並保持展開。

刪除 #

Delete 會先詢問中繼哪些東西會被刪除，對話框會在移除任何東西之前告訴你：

對於有內容的資料夾，紅色的 🗑 Delete 按鈕會保持停用，直到你在 Type the folder name to confirm（輸入資料夾名稱以確認）欄位中輸入資料夾名稱為止。刪除會把檔案或資料夾從磁碟上移除；它不會進入資源回收筒。

名稱與連結 #

• 名稱只能是單一路徑片段：不能是空的、. 或 ..，不能包含 / 或 \，且最多 255 個位元組。
• 當中繼在 Windows 上執行時，名稱也不能包含 < > : " | ? * 或控制字元，不能以點或空格結尾，也不能是 Windows 保留的名稱，例如 con 或 nul。
• 名稱會精確比對：資料夾中已有的名稱會被拒絕，並顯示 That name is already taken。只變更名稱的大小寫是允許的。
• 連結（符號連結）絕不會被重新命名或刪除：中繼會以 Links cannot be changed here 拒絕。workspace 樹狀結構不會列出連結。在 Linux 和 macOS 上，磁碟機和 session 根目錄會列出連結，並把指向資料夾的連結顯示為資料夾，所以你可以透過它開啟和讀取；受保護的只有連結本身。經過指向資料夾之連結的路徑，仍然會到達連結背後的資料夾。在 workspace 中，通往工作資料夾之外的連結會被視為無效路徑而拒絕。
• 作業系統不允許的變更會回報為 Permission denied。被拒絕的重新命名或刪除會以通知顯示；被拒絕的新增資料夾則顯示在名稱欄位下方。

作為資料夾選擇器 #

同一個瀏覽器也用來為 New chat（新對話）和 🗂️ Change CWD 選擇資料夾：按下路徑欄位旁的 📁。瀏覽器會在磁碟機根目錄開啟，底部的一列會顯示所選的資料夾（或 Select a folder…），✅ Use this folder as CWD（將此資料夾設為工作資料夾）會把它交回。三個根目錄都仍可使用。在這個模式下，檔案不會開啟，也不提供 Rename 和 Delete；📁+ New folder 和 📁 New folder here 可以使用，所以你可以一次建立專案資料夾並選取它。見工作資料夾。

限制 #

• workspace 樹狀結構一次只載入一個資料夾，也就是在你開啟它的時候。隱藏的名稱和大型資料夾名稱，在你開啟對應開關之前都不會列出。
• 中繼無法讀取的資料夾會顯示為空的，而不是顯示錯誤。它無法讀取的項目不會列在清單中。
• 對於尚未寫入任何檔案的 Claude 或 DeepSeek session，session 根目錄是空的，而不是錯誤。

依供應商 #

對於每個在中繼機器上的資料夾中工作的供應商，瀏覽器都是一樣的。不同的是 🕵️ 背後的 session 資料夾。