ait stash — 完整參考
記錄、檢視、應用並刪除本地未完成工作的 stash 條目。
適用對象： 開發者與 coding agent
作用邊界#
用途： 記錄、檢視、應用並刪除本地未完成工作的 stash 條目。
影響類別： 改動本地 stash 和工作區；list 和 show 為只讀。
覆蓋： ait stash 下共 7 個公開 help surface。
下面的程式碼區塊原樣保留 1.1.1 二進位的輸出，包含它給出的每一個引數、選項、 預設值、可選值、衝突關係和必填要求。
完整命令樹#
ait stash
ait stash save
ait stash list
ait stash show
ait stash apply
ait stash pop
ait stash drop原樣輸出的 help#
ait stash#
二進位描述： Park, inspect, restore, and drop temporary local-only workspace Snapshots without advancing Line heads. A stash can be restored only while its source Line is current.
Park, inspect, restore, and drop temporary local-only workspace Snapshots without advancing Line heads. A stash can be restored only while its source Line is current.
Usage: ait stash <COMMAND>
Commands:
save Save modified workspace content as a temporary local-only stash.
list List active local-only stash metadata without changing the workspace.
show Inspect metadata for one active local-only stash.
apply Restore a same-Line stash and retain its stash record.
pop Restore a same-Line stash and then drop its stash record.
drop Drop an active stash record without changing workspace content.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')說明
暫存、檢視、恢復和丟棄臨時的僅本地工作區 Snapshot，不推進 Line head。stash 僅當其來源 Line 為目前 Line 時才能恢復。
| 引數 / 選項 | 說明 |
|---|---|
save | 將已修改的工作區內容儲存為臨時的僅本地 stash。 |
list | 列出活動的僅本地 stash 後設資料，不改變工作區。 |
show | 檢視一個活動的僅本地 stash 的後設資料。 |
apply | 恢復一個同 Line 的 stash 並保留其 stash 記錄。 |
pop | 恢復一個同 Line 的 stash，然後丟棄其 stash 記錄。 |
drop | 丟棄一條活動的 stash 記錄，不改變工作區內容。 |
help | 列印本訊息或給定子命令的幫助 |
ait stash save#
二進位描述： Save modified managed-workspace content as a temporary local-only stash Snapshot without advancing the current Line head. By default, restore the current Line head into the workspace after saving; --keep-workspace leaves the saved files in place.
Save modified managed-workspace content as a temporary local-only stash Snapshot without advancing the current Line head. By default, restore the current Line head into the workspace after saving; --keep-workspace leaves the saved files in place.
Usage: ait stash save [OPTIONS]
Options:
--message <MESSAGE>
Record an optional human-readable message with the stash.
--keep-workspace
Leave the saved files in the workspace; the Line head stays unchanged, so the workspace remains dirty relative to it.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')說明
把受管工作區的改動內容儲存為臨時、僅本地的 stash Snapshot，不推進目前 Line head。預設在儲存後把目前 Line head 恢復到工作區；--keep-workspace 會把已儲存檔案留在原處。
ait stash list#
二進位描述： List active local-only stash metadata without changing the workspace.
List active local-only stash metadata without changing the workspace.
Usage: ait stash list [OPTIONS]
Options:
--json Emit the complete machine-readable JSON result.
-h, --help Print help說明
列出活動的僅本地 stash 後設資料，不改變工作區。
| 引數 / 選項 | 說明 |
|---|---|
--json | 輸出完整的機器可讀 JSON 結果。 |
-h, --help | 列印幫助 |
ait stash show#
二進位描述： Inspect metadata for one active local-only stash without changing the workspace. This command reports the stash record and Snapshot summary; it does not display a content diff.
Inspect metadata for one active local-only stash without changing the workspace. This command reports the stash record and Snapshot summary; it does not display a content diff.
Usage: ait stash show [OPTIONS] <STASH_ID>
Arguments:
<STASH_ID>
Exact active stash ID.
Options:
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')說明
檢視一個活動的僅本地 stash 的後設資料，不改變工作區。此命令報告 stash 記錄和 Snapshot 摘要；不顯示內容 diff。
ait stash apply#
二進位描述： Replace the entire managed workspace with an active stash Snapshot and retain its stash record, without moving the current Line head. The current Line must be the stash's source Line. This restores the complete workspace rather than applying a patch or three-way merge.
Replace the entire managed workspace with an active stash Snapshot and retain its stash record, without moving the current Line head. The current Line must be the stash's source Line. This restores the complete workspace rather than applying a patch or three-way merge.
Usage: ait stash apply [OPTIONS] <STASH_ID>
Arguments:
<STASH_ID>
Exact active stash ID created on the current Line.
Options:
--force
Overwrite unsaved managed-workspace changes; this does not permit restoring a stash from another Line.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')說明
用一個活動 stash Snapshot 替換整個受管工作區，保留其 stash 記錄，並且不移動目前 Line head。目前 Line 必須是 stash 的來源 Line。此操作恢復完整工作區，而不是應用 patch 或三方合併。
ait stash pop#
二進位描述： Replace the entire managed workspace with an active stash Snapshot and drop its stash record only after a successful restore, without moving the current Line head. The current Line must be the stash's source Line. This restores the complete workspace rather than applying a patch or three-way merge.
Replace the entire managed workspace with an active stash Snapshot and drop its stash record only after a successful restore, without moving the current Line head. The current Line must be the stash's source Line. This restores the complete workspace rather than applying a patch or three-way merge.
Usage: ait stash pop [OPTIONS] <STASH_ID>
Arguments:
<STASH_ID>
Exact active stash ID created on the current Line.
Options:
--force
Overwrite unsaved managed-workspace changes; this does not permit restoring a stash from another Line.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')說明
用一個活動 stash Snapshot 替換整個受管工作區，只在成功恢復後刪除其 stash 記錄，並且不移動目前 Line head。目前 Line 必須是 stash 的來源 Line。此操作恢復完整工作區，而不是應用 patch 或三方合併。
ait stash drop#
二進位描述： Drop an active stash record without changing workspace content.
Drop an active stash record without changing workspace content.
Usage: ait stash drop [OPTIONS] <STASH_ID>
Arguments:
<STASH_ID> Exact active stash ID.
Options:
--json Emit the complete machine-readable JSON result.
-h, --help Print help說明
丟棄一條活動的 stash 記錄，不改變工作區內容。
| 引數 / 選項 | 說明 |
|---|---|
<STASH_ID> | 確切的活動 stash ID。 |
--json | 輸出完整的機器可讀 JSON 結果。 |
-h, --help | 列印幫助 |