跳至主要内容

@Folders

@Folders​

在聊天和編輯器（Composer）中引用資料夾作為上下文，以增強AI對話效果

在Cursor中使用@Folders引用資料夾時，根據設定不同會產生兩種行為模式：

Image 3

模式1 - 資料夾引用​

預設情況下，當您@某個資料夾時：

  • AI將獲得該資料夾的路徑資訊
  • Cursor會向AI提供資料夾內容概覽
  • 這些資訊幫助AI確定後續操作的合適上下文

模式2 - 完整資料夾內容​

v0.50版本新增功能，可啟用"完整資料夾內容"模式：

  • 啟用後，@資料夾時Cursor將嘗試包含資料夾內全部內容
  • AI無需自行讀取檔案即可獲取完整上下文

啟用方式​

在Cursor設定中切換Full Folder Content選項：

Image 4

使用方法​

啟用完整資料夾內容後使用@Folders：

  • 系統將盡可能包含選定資料夾內所有檔案
  • 相比預設模式（僅提供路徑和概覽），上下文更全面

處理超出上下文視窗容量的大型資料夾時：

  • 在上下文選單中顯示大綱檢視
  • 透過提示顯示已包含檔案數量
  • 智慧管理可用上下文空間

該系統使Cursor能高效處理任意大小的資料夾，同時確保AI知曉可用上下文範圍。無論使用預設資料夾引用模式，還是啟用完整資料夾內容功能（v0.50起可用），Cursor都能提供滿足需求的上下文層級。

限制​

計費/上下文視窗​

完整資料夾內容功能對所有使用者開放：

  • 啟用Max模式時可能顯著增加請求成本
  • Cursor將嘗試填滿模型完整上下文視窗
  • 新增到提示中的檔案越多，消耗的輸入token越多

忽略檔案​

透過.cursorignore或.gitignore忽略的檔案不會包含在上下文中。