1.1.1
完整 1.1.1 CLI 參考
瀏覽每一個公開的 1.1.1 ait 命令與命令組，包含確切的輸出語法、選項、預設值、衝突關係和作用邊界。
適用對象： 開發者、coding agent 與維運
覆蓋範圍#
這是被準入的原生 ait 1.1.1 二進位給出的完整公開命令參考，覆蓋 29 個頂層命令 和 160 個非根的命令或命令組 help surface。根命令 ait --help 的輸出單獨放在下面。
Clap 自動生成的 help 別名只是導覽輔助，不算成獨立的產品操作。隱藏的 和內部的解析器 surface 同樣不在這份公開參考裡。
怎麼讀這些語法#
<VALUE>是呼叫方必須提供的值，尖括號本身不要照著輸入。[OPTIONS]、[COMMAND]以及其他方括號分組都是可選的。- 用法行裡出現的選擇關係是解析器強制的。拼命令時要保持原有的分組。
- 預設值、可選值、衝突和必填要求，都出現在 1.1.1 二進位給出它們的位置。
頂層命令索引#
ait init— 建立或重新初始化本地 AIT 儲存庫權威，並重新整理生效的儲存庫指令。ait plan— 記錄 Markdown Plan 沿革，檢視修訂版本，並在選定範圍內同步確切的原始 Markdown。ait task— 啟動繫結 Plan 的工作，檢視並審計 Task 狀態，完成已接納的工作，或放棄未完成的 Task。ait blame— 把某個路徑或行區間歸因到已記錄的 Snapshot 與 Plan 沿革，並提供一個明確的有界恢復選項。ait doctor— 針對設定的 memory 根目錄、runtime 根目錄或 Plan 權威執行定向診斷。ait queue— 以摘要形式檢視進行中的工作、評審、遠端和 worktree 清單。ait remote— 註冊並列出遠端權威，或從一個確切的遠端 Repository 權威重建本地 Line head。ait release— 建立並檢視發布檔案，建置並打包原生產物，發布這些產物，並晉級已接納的發布。ait repo— 檢視或管理已註冊的遠端 Repository 及其 CI 任務、能力和執行記錄。ait config— 檢視生效的儲存庫設定，或設定一個明確的受支援設定值。ait external— 檢視、物化、固定、連結、解除連結並診斷外部儲存庫依賴。ait status— 檢視目前的 Line、儲存庫、工作區、遠端和 worktree 狀態。ait diff— 用可選的有界路徑和輸出過濾條件，比較目前工作區與已記錄的狀態。ait pull— 匯入遠端 Line 的 Snapshot 歷史，判定 head 之間的關係，並可選地物化選定的結果。ait push— 上傳已記錄的 Snapshot 歷史，並推進一條確切的遠端 Line。ait gc— 檢視、校驗並清理符合條件的原生儲存包。ait stash— 記錄、檢視、應用並刪除本地未完成工作的 stash 條目。ait change— 在一個 Task 內建立、檢視、更新、取消以及以其他方式管理 Change 的生命週期。ait snapshot— 建立並檢視不可變的儲存庫狀態，遍歷它的父級歷史，並重放或恢復已記錄的內容。ait commit— 透過 Git 友好的 commit 命名入口建立 AIT Snapshot。ait tag— 建立、檢視、列出並刪除指向已記錄狀態的本地 AIT Tag 引用。ait patchset— 發布並檢視 Change 候選，選定目前候選，並管理它的 CI 請求狀態。ait review— 為選定的 Patchset 請求、檢視並記錄評審決定。ait attest— 建立並檢視掛在選定 Patchset 上的帶型別證據。ait policy— 對選定的 Patchset 評估、檢視並顯式豁免受支援的策略檢查。ait worktree— 檢視、診斷、恢復、遷移並清理由 AIT 持有的 Task worktree 及其後設資料。ait workflow— 對有界改動分類、校準工作流程狀態、準備遠端就緒條件，並推動設定好的收尾決策。ait line— 檢視並管理 Line，切換或恢復工作區狀態，合併已記錄的歷史，並清理符合條件的 Line 記錄。ait git— 在 Git 與 AIT 原生儲存庫模型之間匯入、匯出並映象歷史。
根 help#
下面這段是所抓取的 1.1.1 二進位裡 ait --help 的完整輸出，未作刪減。
AIT native local repository and workflow tool.
Usage: ait <COMMAND>
Commands:
init Create or reinitialize a local AIT repository.
line Manage named Lines and their Snapshot heads. [alias: branch]
git Import, export, or mirror history between Git and AIT.
blame Attribute selected lines without modifying workspace files.
doctor Inspect effective AIT configuration and host readiness without repairing it.
queue Summarize active Tasks, Changes, worktrees, and reviews.
remote Manage server endpoints and recover the canonical remote main head.
release Build, inspect, and publish versioned release artifacts.
repo Inspect and manage the configured Repository on its remote server.
config Inspect effective configuration and change supported user settings.
external Manage reproducible external Repository dependencies.
status Inspect the current repository, Line, Snapshot, workspace, and actionable local status.
diff Compare the current workspace with the current Line head.
pull Import one remote Line and safely update its local head.
push Upload one local Line and its Snapshot history to a remote.
gc Inspect and safely maintain local content storage.
stash Park and restore temporary local-only workspace Snapshots.
plan Inspect and sync local or remote Plans.
task Start, inspect, check, finish, or abandon Tasks locally or on a remote.
change Create, inspect, publish, or close Task-owned Changes.
snapshot Create and inspect immutable local Snapshots and restore selected workspace content.
commit Create an AIT Snapshot using Git-friendly commit naming.
tag Create, inspect, and delete local Snapshot Tags.
patchset Publish and inspect remote Change revisions and their CI state.
review Inspect remote Review state and record team, human Task, or AI code-review evidence.
attest Record and inspect evidence for remote Patchsets.
policy Check, inspect, or waive remote Patchset requirements.
worktree Inspect, restore, recover, synchronize, rebase, and remove isolated worktrees.
workflow Prepare Changes for review, finish ready work, and repair workflow state.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version說明
AIT 原生本地儲存庫與工作流程工具。
| 引數 / 選項 | 說明 |
|---|---|
init | 建立或重新初始化一個本地 AIT 儲存庫。 |
line | 管理命名 Line 及其 Snapshot head。[alias: branch] |
git | 在 Git 與 AIT 之間匯入、匯出或映象歷史。 |
blame | 標註所選行的歸屬，不修改工作區檔案。 |
doctor | 檢視生效的 AIT 設定和主機就緒狀態，不做修復。 |
queue | 彙總活動的 Task、Change、worktree 和評審。 |
remote | 管理伺服器端點並恢復規範的遠端 main head。 |
release | 建置、檢視併發布帶版本的 release 產物。 |
repo | 在遠端伺服器上檢視並管理已設定的 Repository。 |
config | 檢視生效設定，並改動受支援的使用者設定。 |
external | 管理可復現的外部 Repository 依賴。 |
status | 檢視目前儲存庫、Line、Snapshot、工作區以及可操作的本地狀態。 |
diff | 將目前工作區與目前 Line head 比較。 |
pull | 匯入一個遠端 Line 並安全更新其本地 head。 |
push | 把一條本地 Line 及其 Snapshot 歷史上傳到遠端。 |
gc | 檢視並安全維護本地內容儲存。 |
stash | 暫存並恢復臨時的僅本地工作區 Snapshot。 |
plan | 檢視並同步本地或遠端 Plan。 |
task | 在本地或遠端啟動、檢視、檢查、完成或放棄 Task。 |
change | 建立、檢視、發布或關閉 Task 所屬的 Change。 |
snapshot | 建立並檢視不可變的本地 Snapshot，並恢復選定的工作區內容。 |
commit | 使用 Git 友好的 commit 命名建立 AIT Snapshot。 |
tag | 建立、檢視和刪除本地 Snapshot Tag。 |
patchset | 發布並檢視遠端 Change 修訂版及其 CI 狀態。 |
review | 檢視遠端 Review 狀態，並記錄團隊、人工 Task 或 AI 程式碼評審證據。 |
attest | 記錄並檢視遠端 Patchset 的證據。 |
policy | 檢查、檢視或豁免遠端 Patchset 要求。 |
worktree | 檢視、恢復、找回、同步、rebase 和刪除隔離的 worktree。 |
workflow | 準備 Change 以供評審，完成已就緒工作，並修復工作流程狀態。 |
help | 列印本訊息或給定子命令的幫助 |
-h, --help | 列印幫助 |
-V, --version | 列印版本 |
抓取來源#
- 產品版本：
1.1.1 - 抓取所用二進位的 SHA-256：
6412a60452d5d1ee2c6d4277c09d0804e4ad73e77da58713ec312a04a6870098 - 完整 help 抓取的 SHA-256：
f6c2bb51a447220ed6c6856ea56fbe87aa518b55defd68e766d440e1cefbb185 - CLI 解析器 SHA-256：
829ccf69699c28bcca872cd2b191d256ed8aef4b4e8ada0590fb1e0aacb38215 - CLI 解析器原始碼：不可變的 1.1.1 原始碼
生成的收據記錄了每條命令路徑、給出的描述、用法、子命令列表、help 摘要 和確切的 help 文字。網站和 PDF 建置都會拿這份收據來校驗這些頁面。