> ## 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.

# 工作階段搜尋

> 從側邊欄依標題或訊息內容尋找任何聊天工作階段

從單一 Spotlight 風格的搜尋視窗，跳轉至任何過往的聊天工作階段——主聊天或專案皆可。標題搜尋速度快，預設啟用；當需要比對訊息內容時，再開啟 **Search messages**。

## 開啟搜尋視窗

兩種開啟方式：

* 點選側邊欄的 **Search** 按鈕。
* 在 macOS 按 `⌘K`，或在 Linux 與 Windows 按 `Ctrl+K`。

只要焦點不在文字輸入欄位內，這個快速鍵在 CTOR 任何地方都可用——此設計可讓 Linux 與 Windows 上 textarea 內的 `Ctrl+K`（刪除至行尾）維持原本行為。在搜尋視窗自身的輸入欄位中，此快速鍵則用於關閉視窗。

## 輸入即搜尋

在輸入欄位開始輸入，結果會即時更新並顯示：

* 工作階段標題，並反白顯示符合的關鍵字。
* 來自符合訊息的片段（當 **Search messages** 啟用時）。
* 最後更新時間與訊息數量。
* 一個標籤——**Title match**、**Message match** 或 **Title + message**——說明命中來源。

沒有標題的工作階段會以斜體 *(untitled)* 顯示。

## 僅搜尋標題與完整訊息搜尋

頁尾有一個 **Search messages** 切換：

| 模式 | 預設 | 掃描範圍              |
| -- | -- | ----------------- |
| 關閉 | 是  | 僅工作階段標題——較快       |
| 開啟 | 選用 | 標題**與**每則訊息內容——較慢 |

切換狀態會在多次開啟之間保留，因此一旦開啟完整訊息搜尋，便會持續啟用直到您再次關閉它。

## 鍵盤操作

| 按鍵              | 動作                |
| --------------- | ----------------- |
| `↑` / `↓`       | 移動選取項目            |
| `Home` / `End`  | 跳到第一個或最後一個結果      |
| `Enter`         | 開啟選取的工作階段         |
| `Esc`           | 關閉視窗              |
| `⌘K` / `Ctrl+K` | 關閉視窗（當焦點在搜尋輸入欄位時） |

您也可以用滑鼠點選結果——滑鼠停留時會同步移動選取項目，讓鍵盤與滑鼠操作保持一致。

## 開啟結果

選取結果後會關閉視窗並切換至該工作階段。如果該工作階段屬於目前未在側邊欄開啟的專案，CTOR 會為您重新開啟該專案，讓該工作階段可立即繼續對話，而不僅是檢視。

主聊天工作階段也以相同方式開啟，不需額外步驟。
