浏览 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