Skip to main content
在聊天旁的分頁檢視器中開啟專案檔案、設定資產以及聊天中引用的路徑。檔案檢視器會內嵌呈現原始碼、Markdown、影像與動畫,搜尋整個專案,並在您需要時將檔案交給外部編輯器開啟。

開啟檔案檢視器

有三種方式可以開啟檔案:
  • 從面板 — 開啟右側面板或下方面板,並從其起始頁選擇檔案以瀏覽檔案樹。
  • 從工具項目 — 當代理讀取、寫入或編輯檔案時,聊天中的路徑旁會出現檔案圖示。點選圖示即可在檢視器分頁中開啟該檔案。
  • 從聊天訊息 — 點選任何訊息中的本機檔案連結(例如 [README](README.md) 這類 Markdown 連結),即可在分頁中開啟。

檔案樹

檔案檢視會以樹狀結構列出專案,並分為兩個區段:
  • Local files — 專案目錄中的檔案與資料夾。點選資料夾可展開或收合;點選檔案可在分頁中開啟。
  • Config URL assets — 已建置應用程式設定所引用的遠端資產(影像、Lottie 與 Rive 來源),並依 Subspace 分組。每個項目都會顯示其 md5,方便您與設定比對。
按一下切換按鈕可隱藏或顯示檔案樹窗格。相依套件、建置與工具資料夾會從樹狀結構中排除(node_modules.git.github.claude.codex.huskydist.cachebun.lock),而 .bricks/build 一律會包含在內。

分頁

您開啟的每個檔案都會成為檢視器頂端的一個分頁。重新開啟已開啟的檔案會切換到既有分頁,而非重複建立;您也可以隨時重新排序或關閉分頁。

依檔案類型預覽

檢視器會依檔案選擇呈現方式: 超過大小上限的檔案(文字 1 MB、二進位 10 MB)會顯示 File is too large to preview.,並提供改用外部開啟的按鈕。

Git 變更

在 Git 專案中,檔案檢視器會疊加顯示您尚未提交的變更——與差異檢視相同的 git diff 輸出。
  • 在檔案樹中——變更過的檔案會帶有字母標記(M 已修改、A 已新增、D 已刪除、R 已重新命名),其上層資料夾則會帶有圓點,因此不必展開就能看出哪裡有變更。將游標停在檔案上可看到新增與刪除的行數。
  • 在檔案內容中——新增的行會標上底色,行號欄的標記則指出哪裡刪除了內容。
  • Content / Diff 切換——變更過的檔案,其標題列會顯示 + / 行數,旁邊是 Content | Diff 切換。Diff 會依照差異檢視的顯示設定呈現該檔案的變更。開啟另一個檔案會回到 Content;當檔案的變更已提交或還原後,這個切換會消失。

在檔案中尋找

當檢視器取得焦點時,按 Cmd+F(macOS)或 Ctrl+F(Windows 與 Linux)可開啟尋找列。它會顯示目前的相符位置與總數(例如 1/1),並標示檔案中的每個相符項。按 Enter 可跳至下一個相符項,按 Esc 或關閉按鈕可關閉尋找列。

跨檔案搜尋

在檔案樹頂端的 Search files 搜尋框中輸入內容,即可在整個專案中搜尋檔案內容。相符的檔案會出現在 Content matches 之下;點選結果即可開啟該檔案。搜尋最多會回傳 200 筆結果。

在外部開啟

按一下檢視器標頭中的 在外部開啟檔案,即可在外部編輯器中開啟目前檔案。該按鈕會列出系統上偵測到的編輯器。