浏览 1.0.0 文档
1.0.0 文档修订 2

ait gc — 完整参考

查看、校验并清理符合条件的原生存储包。

适用人群: Repository 所有者与存储运维

作用边界#

用途: 查看、校验并清理符合条件的原生存储包。

影响类别: stats 和 validate 只做查看;prune 只删除符合它确切资格规则的数据。

覆盖: ait gc 下共 4 个公开 help surface。

下面的代码块原样保留 1.0.0 二进制的输出,包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。

完整命令树#

Code · text
ait gc
ait gc stats
ait gc validate
ait gc prune

原样输出的 help#

ait gc#

二进制描述: Inspect bounded local content statistics, run exact read-only validation, or preview safe orphan object-pack cleanup. Pruning is read-only unless gc prune is given --apply; it never removes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.

Code · text
Inspect bounded local content statistics, run exact read-only validation, or preview safe orphan object-pack cleanup. Pruning is read-only unless gc prune is given --apply; it never removes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.

Usage: ait gc <COMMAND>

Commands:
  stats     Show a bounded local content-storage summary.
  validate  Run exact read-only local content validation.
  prune     Preview safe orphan object-pack cleanup; mutate only with --apply.
  help      Print this message or the help of the given subcommand(s)

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

ait gc stats#

二进制描述: Show bounded local blob, tree, and pack counts and storage metrics without exact retained-tree traversal or full inventory rows. Use gc validate for exact retained-Snapshot reachability.

Code · text
Show bounded local blob, tree, and pack counts and storage metrics without exact retained-tree traversal or full inventory rows. Use gc validate for exact retained-Snapshot reachability.

Usage: ait gc stats [OPTIONS]

Options:
      --json
          Emit the bounded summary as stable JSON.

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

ait gc validate#

二进制描述: Run exact read-only validation by traversing retained Snapshot trees and blobs and checking local pack metadata without modifying repository or workspace state. The result is emitted before the command returns nonzero when needs_attention is true.

Code · text
Run exact read-only validation by traversing retained Snapshot trees and blobs and checking local pack metadata without modifying repository or workspace state. The result is emitted before the command returns nonzero when needs_attention is true.

Usage: ait gc validate [OPTIONS]

Options:
      --json
          Emit the exact validation result as stable JSON.

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

ait gc prune#

二进制描述: Preview the exact fully orphaned object-pack cleanup plan by default. --apply recomputes, verifies, and revalidates that plan before changing local catalog metadata and deleting unreferenced object-pack archives. This command never prunes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.

Code · text
Preview the exact fully orphaned object-pack cleanup plan by default. --apply recomputes, verifies, and revalidates that plan before changing local catalog metadata and deleting unreferenced object-pack archives. This command never prunes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.

Usage: ait gc prune [OPTIONS]

Options:
      --apply
          Apply the recomputed and revalidated safe plan; without this option the command is read-only.

      --json
          Emit the preview or apply result as stable JSON.

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

Version authority

Checked against the exact 1.0.0 source

This page is public documentation, not a second product contract. Use the exact source and distribution contract for release authority.

Owning component Snapshots
  • ait-coreSNP-B06A48DA0245
  • ait-serverSNP-E90456E6425E
  • ait-runnerSNP-6B0A1BB3AFAD
  • ait-pythonSNP-973E3BFAF3DE
  • ait-nodeSNP-F962CC66AA62