瀏覽 1.1.1 文件
1.1.1

ait line — 完整參考

檢視並管理 Line,切換或恢復工作區狀態,合併已記錄的歷史,並清理符合條件的 Line 記錄。

適用對象: 開發者與 coding agent

作用邊界#

用途: 檢視並管理 Line,切換或恢復工作區狀態,合併已記錄的歷史,並清理符合條件的 Line 記錄。

影響類別: 讀取與本地寫入混合的入口;switch、restore、merge、create、rename、archive 和 cleanup 會改變本地狀態。

覆蓋: ait line 下共 10 個公開 help surface。

下面的程式碼區塊原樣保留 1.1.1 二進位的輸出,包含它給出的每一個引數、選項、 預設值、可選值、衝突關係和必填要求。

完整命令樹#

程式碼 · text
ait line
ait line list
ait line create
ait line switch
ait line show
ait line archive
ait line rename
ait line delete
ait line merge
ait line cleanup

原樣輸出的 help#

ait line#

二進位描述: Manage named Lines and their Snapshot heads. ait branch is a Git-friendly alias with the same subcommands, safety checks, and output; the recorded objects remain AIT Lines and Snapshots.

程式碼 · text
Manage named Lines and their Snapshot heads. `ait branch` is a Git-friendly alias with the same subcommands, safety checks, and output; the recorded objects remain AIT Lines and Snapshots.

Usage: ait line <COMMAND>

Commands:
  list     List active local Lines or Lines from a remote.
  create   Create a new local Line at a Snapshot head.
  switch   Select a local Line, optionally restoring its files.
  show     Show one local or remote Line and its current head.
  archive  Archive a local or remote Line without deleting its Snapshots.
  rename   Rename a line while preserving its stable identity and reconciling bound pointers.
  delete   Delete only a line ref after binding and unique-history protection checks.
  merge    Merge one Line into the current Line with resumable conflict state and a two-parent Snapshot.
  cleanup  Preview idle temporary Lines, or archive eligible candidates with --yes.
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help (see a summary with '-h')

說明

管理命名 Line 及其 Snapshot head。ait branch 是 Git 友好別名,具有相同子命令、安全檢查和輸出;記錄的物件仍是 AIT Line 與 Snapshot。

引數 / 選項說明
list列出活動的本地 Line 或遠端 Line。
create在一個 Snapshot head 建立新的本地 Line。
switch選擇一條本地 Line,並可選擇恢復其檔案。
show顯示一條本地或遠端 Line 及其目前 head。
archive歸檔一條本地或遠端 Line,但不刪除其 Snapshot。
rename重新命名一個 line,同時保留其穩定身份並調和繫結的指標。
delete僅刪除一個 line 引用,且須先透過繫結與唯一歷史保護檢查。
merge將一個 Line 合併進目前 Line,帶可續的衝突狀態和一個雙父級 Snapshot。
cleanup預覽閒置的臨時 Line,或用 --yes 歸檔符合條件的候選。
help列印本訊息或給定子命令的幫助

ait line list#

二進位描述: List active local Lines or Lines from a remote.

程式碼 · text
List active local Lines or Lines from a remote.

Usage: ait line list [OPTIONS]

Options:
      --all              
      --archived         
      --remote <REMOTE>  
      --json             
  -h, --help             Print help

說明

列出活動的本地 Line 或遠端 Line。

引數 / 選項說明
-h, --help列印幫助

ait line create#

二進位描述: Create a new local Line at a Snapshot head.

程式碼 · text
Create a new local Line at a Snapshot head.

Usage: ait line create [OPTIONS] <NAME>

Arguments:
  <NAME>  

Options:
      --from-snapshot <FROM_SNAPSHOT>  Start the new Line at this Snapshot instead of the current Line head.
      --switch                         Select the new Line without changing workspace files.
      --json                           
  -h, --help                           Print help

說明

在一個 Snapshot head 建立新的本地 Line。

引數 / 選項說明
--from-snapshot <FROM_SNAPSHOT>從此 Snapshot 開始新 Line,而不是從目前 Line head 開始。
--switch選定新 Line,不改變工作區檔案。
-h, --help列印幫助

ait line switch#

二進位描述: Select a local Line, optionally restoring its files.

程式碼 · text
Select a local Line, optionally restoring its files.

Usage: ait line switch [OPTIONS] <NAME>

Arguments:
  <NAME>  

Options:
      --restore  Restore the selected Line head's files into the workspace.
      --force    Allow --restore to overwrite conflicting workspace changes.
      --json     
  -h, --help     Print help

說明

選擇一條本地 Line,並可選擇恢復其檔案。

引數 / 選項說明
--restore把所選 Line head 的檔案恢復到工作區。
--force允許 --restore 覆蓋有衝突的工作區改動。
-h, --help列印幫助

ait line show#

二進位描述: Show one local or remote Line and its current head.

程式碼 · text
Show one local or remote Line and its current head.

Usage: ait line show [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --json  
  -h, --help  Print help

說明

顯示一條本地或遠端 Line 及其目前 head。

引數 / 選項說明
-h, --help列印幫助

ait line archive#

二進位描述: Archive a local or remote Line without deleting its Snapshots.

程式碼 · text
Archive a local or remote Line without deleting its Snapshots.

Usage: ait line archive [OPTIONS] <NAME>

Arguments:
  <NAME>  

Options:
      --remote <REMOTE>  
      --json             
  -h, --help             Print help

說明

歸檔一條本地或遠端 Line,但不刪除其 Snapshot。

引數 / 選項說明
-h, --help列印幫助

ait line rename#

二進位描述: Rename a line while preserving its stable identity and reconciling bound pointers.

程式碼 · text
Rename a line while preserving its stable identity and reconciling bound pointers.

Usage: ait line rename [OPTIONS] <OLD> <NEW>

Arguments:
  <OLD>  
  <NEW>  

Options:
      --remote <REMOTE>  
      --json             
  -h, --help             Print help

說明

重新命名一個 line,同時保留其穩定身份並調和繫結的指標。

引數 / 選項說明
-h, --help列印幫助

ait line delete#

二進位描述: Delete only a line ref after binding and unique-history protection checks.

程式碼 · text
Delete only a line ref after binding and unique-history protection checks.

Usage: ait line delete [OPTIONS] --yes <NAME>

Arguments:
  <NAME>  

Options:
      --remote <REMOTE>  
      --yes              
      --json             
  -h, --help             Print help

說明

僅刪除一個 line 引用,且須先透過繫結與唯一歷史保護檢查。

引數 / 選項說明
-h, --help列印幫助

ait line merge#

二進位描述: Merge one Line into the current Line with resumable conflict state and a two-parent Snapshot.

程式碼 · text
Merge one Line into the current Line with resumable conflict state and a two-parent Snapshot.

Usage: ait line merge [OPTIONS] [SOURCE]

Arguments:
  [SOURCE]  

Options:
      --message <MESSAGE>  
      --continue           
      --abort              
      --json               
  -h, --help               Print help

說明

將一個 Line 合併進目前 Line,帶可續的衝突狀態和一個雙父級 Snapshot。

引數 / 選項說明
-h, --help列印幫助

ait line cleanup#

二進位描述: Preview idle temporary Lines, or archive eligible candidates with --yes.

程式碼 · text
Preview idle temporary Lines, or archive eligible candidates with --yes.

Usage: ait line cleanup [OPTIONS]

Options:
      --idle-for <IDLE_FOR>  Minimum time since the Line's last activity, such as 7d, 12h, or 30m. [default: 7d]
      --kind <CLEANUP_KIND>  Restrict cleanup to review_base, review, or wip Lines.
      --limit <LIMIT>        Select at most this positive number of oldest candidates.
      --include-protected    Include non-candidates and their protection reasons in the result.
      --all                  Show every selected row; protected rows still require --include-protected.
      --yes                  Archive the eligible candidates; omission is always a read-only preview.
      --json                 
  -h, --help                 Print help

說明

預覽閒置的臨時 Line,或用 --yes 歸檔符合條件的候選。

引數 / 選項說明
--idle-for <IDLE_FOR>自該 Line 最後一次活動以來的最短時長,例如 7d、12h 或 30m。[default: 7d]
--kind <CLEANUP_KIND>將清理限定為 review_base、review 或 wip Line。
--limit <LIMIT>最多選出此正數個最舊的候選。
--include-protected在結果中包含非候選項及其保護原因。
--all顯示每個選中的行;受保護行仍需要 --include-protected。
--yes歸檔符合條件的候選;省略此選項時始終只讀預覽。
-h, --help列印幫助

版本權威

對照 1.1.1 原始碼逐條核對

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

所屬元件 Snapshot
  • ait-coreSNP-ED7593DBF982
  • ait-serverSNP-0CCD7DD2A077
  • ait-runnerSNP-35C9C133D2EE
  • ait-pythonSNP-756C731A4CC0
  • ait-nodeSNP-55E90D0A81F1