瀏覽 1.1.1 文件
1.1.1

ait gc — 完整參考

檢視、校驗並清理符合條件的原生儲存包。

適用對象: Repository 所有者與儲存維運

作用邊界#

用途: 檢視、校驗並清理符合條件的原生儲存包。

影響類別: stats 和 validate 只做檢視;prune 只刪除符合它確切資格規則的資料。

覆蓋: ait gc 下共 4 個公開 help surface。

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

完整命令樹#

程式碼 · 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.

程式碼 · 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')

說明

檢視有界的本地內容統計、執行精確的只讀校驗,或預覽安全的孤立物件包清理。除非給 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.

程式碼 · 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')

說明

顯示有界的本地 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.

程式碼 · 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')

說明

透過遍歷保留的 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.

程式碼 · 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')

說明

預設預覽確切的完全孤立物件包清理計劃。--apply 會在更改本地目錄後設資料並刪除未被引用的物件包歸檔之前,重新計算、驗證並複核該計劃。此命令絕不會清理樹包、單個不可達 blob、Snapshot、Line、Task、工作區檔案或遠端內容。

版本權威

對照 1.1.1 原始碼逐條核對

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

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