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

# 檔案編輯

> 內嵌 AI 差異比對、逐次編輯接受/拒絕、快照和復原。

Kazzle 的檔案編輯器有兩層：一個用於您的變更的普通文字編輯器，以及一個用於 AI 變更的差異比對覆蓋層。

## AI 編輯的顯示方式

當 AI 編輯檔案時，變更會在編輯器中顯示為綠色（新增）和紅色（移除）的行。每個變更區域都是一個您可以操作的編輯。

當 AI 串流時，您會看到具有語法醒目提示的即時編輯。完成後，檢視會切換到完整的差異比對。

## 接受和拒絕編輯

每個編輯都有一個浮動列，包含**保留**和**復原**按鈕。

* **保留**接受變更。裝飾消失，內容保留。
* **復原**還原變更。AI 的文字被替換為原始內容。

編輯是獨立的。您可以在同一檔案中保留某些變更並復原其他變更。當檔案中的每個編輯都解決後，檔案編輯會自動解決。

待處理的差異比對區域是唯讀的，直到您保留或復原。這可防止在 AI 剛剛變更的區域內編輯，這會破壞復原功能。

## 批量接受和拒絕

執行緒的**檔案編輯**面板可讓您一次接受或拒絕該執行緒的所有待處理編輯。

## 逐則訊息復原

每個 AI 回應都有一個**還原**按鈕。點擊它會將所有檔案還原到該回應之前的狀態，並刪除後續訊息。

如果其他執行緒在相同檔案上有待處理的變更，您會在繼續前看到警告。

## 快照

在每個 AI 回合之前，Kazzle 會將先前的檔案內容儲存到雲端儲存空間。這些快照支援逐則訊息復原：點擊還原會從快照讀取舊內容並寫回。

快照具有儲存效率。它們僅涵蓋雲端機器的檔案，不包括資料庫變更、已部署的應用程式或外部 API 呼叫。

## 跨執行緒重疊

當新的 AI 編輯與來自另一個執行緒的現有待處理編輯重疊時，重疊的編輯會自動接受。這可防止陳舊的編輯，因為文字已被覆寫，無法有意義地復原。來自其他執行緒的非重疊編輯保持待處理。

## 衝突處理

多個執行緒共用相同的雲端機器。當兩個執行緒編輯同一檔案時：

1. 執行緒 A 編輯一個區域。檔案在磁碟上變更。
2. 執行緒 B 嘗試編輯相同區域。其編輯失敗，因為舊文字不符。
3. 執行緒 B 重新讀取檔案並進行調整。

AI 會自動處理此問題。您不需要手動管理衝突。
