ait gc — 完整参考
查看、校验并清理符合条件的原生存储包。
适用人群： Repository 所有者与存储运维
作用边界#
用途： 查看、校验并清理符合条件的原生存储包。
影响类别： stats 和 validate 只做查看；prune 只删除符合它确切资格规则的数据。
覆盖： ait gc 下共 4 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
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.
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')说明
查看有界的本地内容统计、运行精确的只读校验，或预览安全的孤立对象包清理。除非给 gc prune 传入 --apply，清理始终只读；它绝不会删除树包、单个不可达 blob、Snapshot、Line、Task、工作区文件或远程内容。
| 参数 / 选项 | 说明 |
|---|---|
stats | 显示有界的本地内容存储摘要。 |
validate | 运行精确的只读本地内容校验。 |
prune | 预览安全的孤立对象包清理；仅在给出 --apply 时才改动。 |
help | 打印本消息或给定子命令的帮助 |
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.
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')说明
显示有界的本地 blob、树和包的数量及存储指标，不做精确的保留树遍历，也不列完整清单行。精确的保留 Snapshot 可达性请用 gc validate。
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.
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')说明
通过遍历保留的 Snapshot 树和 blob 并检查本地包元数据来运行精确的只读校验，不修改仓库或工作区状态。当 needs_attention 为 true 时，命令会先输出结果再返回非零。
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.
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')说明
默认预览确切的完全孤立对象包清理计划。--apply 会在更改本地目录元数据并删除未被引用的对象包归档之前，重新计算、验证并复核该计划。此命令绝不会清理树包、单个不可达 blob、Snapshot、Line、Task、工作区文件或远程内容。