ait diff

用有界的路徑過濾條件，比較目前工作區與目前 Line head。

適用對象： 使用者與 coding agent

角色#

在做 Snapshot、修復或恢復的決定之前，使用者或 coding agent 都能放心跑。

ait diff 拿目前工作區跟目前 Line 的頭部作比較。它不支援挑任意的 Snapshot 區間；要比不可變的 Snapshot，用 ait snapshot diff。

程式碼 · bash

ait diff
ait diff --stat
ait diff --name-only
ait diff [<path>...]

路徑引數是精確的字面過濾，不是 shell 那種通配模式。--stat 和 --name-only 是兩種可選的摘要形式。

程式碼 · bash

ait diff src/LoginForm.tsx

結果會把路徑分成已修改、已缺失和未跟蹤幾類，遇到大檔案或二進位內容會截斷，而不是無節制地全打出來。

普通文字檢視重點給出改動的路徑和有用的內容。當自動化需要精確的分類時， --json 就是那道機器邊界。sprint Markdown 走的是 Plan 沿革，不會作為程式碼工作區的內容出現。

如果某個本該在的檔案不見了，先看 Task 工作區和 Line，別急著還原什麼。更不要為了湊出一個乾淨的 diff，就覆蓋掉不相干的改動。

這一頁是公開文件，不是第二份產品契約。要確認發布權威，請以確切的原始碼和分發契約為準。

所屬元件 Snapshot