> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 檔案檢視器

> 在分頁式的右側面板中瀏覽、預覽並搜尋專案檔案

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

## 開啟檔案檢視器

有三種方式可以開啟檔案：

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

## 檔案樹

檔案檢視會以樹狀結構列出專案，並分為兩個區段：

* **Local files** — 專案目錄中的檔案與資料夾。點選資料夾可展開或收合；點選檔案可在分頁中開啟。
* **Config URL assets** — 已建置應用程式設定所引用的遠端資產（影像、Lottie 與 Rive 來源），並依 Subspace 分組。每個項目都會顯示其 `md5`，方便您與設定比對。

按一下切換按鈕可隱藏或顯示檔案樹窗格。相依套件、建置與工具資料夾會從樹狀結構中排除（`node_modules`、`.git`、`.github`、`.claude`、`.codex`、`.husky`、`dist`、`.cache` 與 `bun.lock`），而 `.bricks/build` 一律會包含在內。

## 分頁

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

## 依檔案類型預覽

檢視器會依檔案選擇呈現方式：

| 檔案類型                                | 呈現方式                                                       |
| ----------------------------------- | ---------------------------------------------------------- |
| 原始碼、JSON、文字、dotfile、TOML、YAML、shell | 含行號並標示語法色彩的程式碼                                             |
| Markdown                            | 呈現後的預覽，並提供 **Preview** / **Source** 切換；可呈現 Mermaid 圖表與內嵌影像 |
| 影像與 SVG                             | 內嵌影像                                                       |
| 影片                                  | 內嵌播放器                                                      |
| Lottie（`.lottie` 或 Lottie JSON）     | 動畫預覽                                                       |
| Rive（`.riv`）                        | 動畫預覽                                                       |

超過大小上限的檔案（文字 1 MB、二進位 10 MB）會顯示 **File is too large to preview.**，並提供改用外部開啟的按鈕。

## 在檔案中尋找

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

## 跨檔案搜尋

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

## 在外部開啟

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