1.1.1
技術文件
查閱版本化的 ait-native 技術指南、命令參考、整合、維運與發布契約。
適用對象： 開發者、整合方與維運人員
找一個技術答案
搜尋目前文件
搜尋頁面標題、命令名、適用對象和技術主題。下面的目錄不依賴 JavaScript，隨時可以直接瀏覽。
開始
- 技術文件ait-native 概念、工作流程、命令、整合與維運的版本化入口。
- 快速開始安裝 1.1.1、初始化一個儲存庫、提出需求，然後檢視記錄下來的結果。
- 核心概念理解那些把意圖、隔離的工作、不可變狀態、證據與收尾串起來的儲存庫物件。
- 系統架構與授權邊界看清外部 coding client、原生繫結、ait-native 核心、Task worktree、Binary DB、伺服器與 runner 如何跨本地與可選遠端授權連線。
- 1.1.0 效能評測檢視凍結的 AIT 與 Git worktree 各 100 個 session 結果、信賴區間、驗收披露與併發邊界。
工作流程
CLI · 使用與檢視
- ait init建立或重新初始化 AIT 儲存庫權威與生效的 agent 指令。
- ait config檢視生效的工作流程路由，並應用明確的儲存庫設定改動。
- ait status檢視目前 Line、儲存庫狀態、工作區狀態、遠端以及 worktree 健康狀況。
- ait diff用有界的路徑過濾條件，比較目前工作區與目前 Line head。
- ait blame在修復之前，把某個檔案或行區間追溯到對應的 Snapshot 與 Plan 修訂。
- ait doctor在不改動儲存庫權威的前提下，找到定向的診斷入口。
CLI · Agent 工作流程
- ait plan記錄帶版本的 Markdown 沿革，並在設定的範圍內同步確切的 sprint 條目。
- ait task啟動繫結 Plan 的工作，檢視就緒狀態，並按設定好的範圍完成 Task。
- ait snapshot記錄不可變的儲存庫狀態，並檢視 Snapshot 內容或父級沿革。
- ait queue檢視進行中的工作、評審、遠端與 worktree 健康狀況的精簡清單。
- ait workflow對有界改動分類，準備遠端就緒證據，並檢視收尾狀態。
CLI · 完整 1.1.1 參考
- 完整 1.1.1 CLI 參考瀏覽每一個公開的 1.1.1 ait 命令與命令組，包含確切的輸出語法、選項、預設值、衝突關係和作用邊界。
- 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 原生儲存庫模型之間匯入、匯出並映象歷史。
CLI · 完整 1.1.1 元件參考
- ait-agent — 完整參考設定、檢視並管理可選的 Telegram、LINE、Discord 和 Slack 傳輸 worker。
- ait-agent-worker — 完整參考執行一個已接納的原生傳輸 worker，或一次有界的簽名請求事務或應答提供方事務。
- ait-server — 完整參考初始化、探測或執行持久的遠端 Repository 權威以及 Worker Job 協調。
- ait-runner — 完整參考診斷、執行、認領或提供由服務端持有的帶型別 CI 工作。
基礎設施與整合
- 並行 Task 隔離透過隔離的 worktree、AIT_RAM 扇出、不可變證據和原子 Land，並行跑多個 coding agent 的 Task。
- 遠端基礎設施部署明確的 ait-server 與 ait-runner 邊界，用於遠端權威、異地恢復和儲存庫自有的 CI。
- ait-server：遠端權威與恢復瞭解 ait-server 的遠端工作流程權威、Snapshot 儲存、災難恢復、runner 邊界與維運職責。
- ait-runner：原生 CI 執行面透過確切的 Worker Job 認領、Snapshot 物化、隔離的執行嘗試、有界證據、租約和部署控制，維運 1.1.1 原生 runner。
- ait-server REST API 參考呼叫每一個 1.1.1 ait-server HTTP 操作，包含與實作對齊的請求欄位、響應、錯誤、恢復流程和安全邊界。
- ait-agent：可選的傳輸管理器瞭解可選的 1.1.1 傳輸管理器邊界、它的四類 worker、生命週期命令，以及它與 coding client 和原生 worker 可執行檔案的關係。
- ait-agent-worker：訊息與應答執行時透過它經過驗證的命令面、四種傳輸、Codex 應答提供方、執行時準入和安全邊界，維運可選的原生訊息 worker。
- Python 整合使用 ait-native PyPI 發行版裡自帶的、直接在行程內工作的 Python 繫結。
- Node.js 整合使用受支援的 npm 包提供的、直接的 Node-API JavaScript 與 TypeScript 介面。
Binary DB v0 結構
- Binary DB v0：格式與權威檢視 Binary DB v0 的檔案格式、整數與偏移規則，以及儲存根邊界。
- Binary DB v0：工作流程記錄展開 Task、Change、worktree、Line、Stash、Tag、Land 以及內聯工作流程連結記錄的佈局與不變數。
- Binary DB v0：Snapshot 與內容記錄展開 Snapshot 父級沿革、Snapshot 連結、Tree、Blob、物件包、manifest 以及可選的檔案快取佈局。
- Binary DB v0：Git 互操作記錄展開可選的 Git 儲存庫、generation、身份、commit、檔案、ref、Tag 與 checkpoint 對映佈局。
- Binary DB v0：服務端與策略記錄展開 Patchset、attestation、Actor、評審、策略、豁免、Plan、Repository 登錄檔與 Worker Job 權威。
- Binary DB v0：payload、索引與編碼展開每一類帶型別的 payload、可重建索引記錄、後設資料位分配、enum 以及保留值規則。
- Binary DB v0：身份、恢復與轉換展開公開控制代碼的作用域、原子寫入與恢復邊界、轉換的接納條件、容量與排除項。
參考
附錄
- 附錄：設定檔案把每一個公開的 1.1.1 AIT 設定檔案對應到它的用途、歸屬、寫入邊界和詳細 schema 參考。
- 附錄：.ait/config.json目前 1.1.1 持久化 Repository 設定的完整約定，包含歸屬、預設值、生命週期寫入方、worktree 覆蓋項與恢復邊界。
- 附錄：策略與忽略規則用確切接受的欄位和匹配規則，在 .ait/policy.yaml 裡設定 1.1.1 的接納要求，在 .aitignore 裡設定儲存庫可見性。
- 附錄：Patchset CI 設定定義規範的 1.1.1 Patchset CI 套件目錄、支援的 runner、檢查項、產物，以及有界的本地定位器。
- 附錄：外部 Repository 設定透過三份 1.1.1 TOML 約定宣告、鎖定、物化、繫結並在本地覆蓋外部 Repository。
- 附錄：Agent worker 設定設定具名的 Telegram、LINE、Discord 和 Slack worker，以及憑據優先順序、執行時路徑、傳輸模式和本地應答行為。
- 附錄：發布 manifest展開通用命令介面卡與專用 AIT 原生家族發布 manifest 的 schema、邊界與歸屬規則。
- 附錄：環境變數已安裝 1.1.1 環境的規範化 31 條約定，明確寫出歸屬、設定方式、機密性與程序邊界行為。