ait repo — 完整参考
查看或管理已注册的远程 Repository 及其 CI 任务、能力和运行记录。
适用人群： Repository 所有者与运维
作用边界#
用途： 查看或管理已注册的远程 Repository 及其 CI 任务、能力和运行记录。
影响类别： 远程读取与管理混合的入口；退役、恢复和 CI 调度会改动远程权威。
覆盖： ait repo 下共 6 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
ait repo
ait repo show
ait repo retire
ait repo restore
ait repo jobs
ait repo ci-capabilities原样输出的 help#
ait repo#
二进制描述： Inspect and manage the configured Repository on its remote server.
Inspect and manage the configured Repository on its remote server.
Usage: ait repo <COMMAND>
Commands:
show Read Repository identity, lifecycle, storage validation, and sync state.
retire Drain, archive, verify, and purge a remote Repository, or abort that retirement.
restore Restore a complete local retirement archive as a new remote Repository.
jobs Read one Worker Job or a bounded, optionally filtered Job inventory.
ci-capabilities Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help说明
在远程服务器上查看并管理已配置的 Repository。
| 参数 / 选项 | 说明 |
|---|---|
show | 读取 Repository 身份、生命周期、存储校验和同步状态。 |
retire | 排空、归档、校验并清除一个远程 Repository，或中止该退役。 |
restore | 将一份完整的本地退役归档恢复为一个新的远程 Repository。 |
jobs | 读取一个 Worker Job，或一份有界且可选过滤的 Job 清单。 |
ci-capabilities | 检查 Patchset CI 的服务器、原生 runner 和远程同步前置条件。 |
help | 打印本消息或给定子命令的帮助 |
-h, --help | 打印帮助 |
ait repo show#
二进制描述： Read Repository identity, lifecycle, storage validation, and sync state.
Read Repository identity, lifecycle, storage validation, and sync state.
Usage: ait repo show [OPTIONS]
Options:
--remote <NAME> Use this configured remote; omission uses the Repository default remote.
--json Emit the complete machine-readable JSON result.
-h, --help Print help说明
读取 Repository 身份、生命周期、存储校验和同步状态。
| 参数 / 选项 | 说明 |
|---|---|
--remote <NAME> | 使用此已配置的远程；省略时使用 Repository 默认远程。 |
--json | 输出完整的机器可读 JSON 结果。 |
-h, --help | 打印帮助 |
ait repo retire#
二进制描述： Without --abort, stop new work for the remote Repository, download and verify its complete archive, then delete its server data. An unrelated complete local archive blocks retirement and must be handled with ait repo restore --remote <NAME>; there is no archive replacement option. With --abort, reactivate the Repository and preserve any complete local archive.
Without --abort, stop new work for the remote Repository, download and verify its complete archive, then delete its server data. An unrelated complete local archive blocks retirement and must be handled with `ait repo restore --remote <NAME>`; there is no archive replacement option. With --abort, reactivate the Repository and preserve any complete local archive.
Usage: ait repo retire [OPTIONS]
Options:
--remote <NAME>
Mutate this configured remote; omission uses the Repository default remote.
--abort
Abort an in-progress retirement and reactivate the Repository while preserving any complete local archive.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')说明
不带 --abort 时，停止远程 Repository 的新工作，下载并校验其完整归档，然后删除服务器数据。一份无关的完整本地归档会阻止退役，必须用 ait repo restore --remote <NAME> 处理；不存在归档替换选项。带 --abort 时，重新激活 Repository，并保留任何完整本地归档。
ait repo restore#
二进制描述： Verify the complete .ait/remote/<remote>/ retirement archive, create a new remote Repository index, upload and save its data, then update the locally configured Repository index. The archive determines the restored identity; there is no name, index, or force override.
Verify the complete `.ait/remote/<remote>/` retirement archive, create a new remote Repository index, upload and save its data, then update the locally configured Repository index. The archive determines the restored identity; there is no name, index, or force override.
Usage: ait repo restore [OPTIONS]
Options:
--remote <NAME>
Use this configured remote; omission uses the Repository default remote.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')说明
校验完整的 .ait/remote/<remote>/ 退役归档，创建新的远程 Repository 索引，上传并保存其数据，然后更新本地配置的 Repository 索引。恢复身份由归档决定；不存在名称、索引或 force override。
ait repo jobs#
二进制描述： Read one Worker Job or a bounded, optionally filtered Job inventory.
Read one Worker Job or a bounded, optionally filtered Job inventory.
Usage: ait repo jobs [OPTIONS]
Options:
--remote <NAME> Read from this configured remote; omission uses the Repository default remote.
--worker-job-index <INDEX> Read one specific Worker Job from the current Repository; cannot be combined with list filters.
--state <STATE> Return only queued, running, succeeded, or failed Jobs. [possible values: queued, running, succeeded, failed]
--limit <COUNT> Return at most this many Jobs in list mode (1 through 1000; default 50). [default: 50]
--json Emit the complete machine-readable JSON result.
-h, --help Print help说明
读取一个 Worker Job，或一份有界且可选过滤的 Job 清单。
| 参数 / 选项 | 说明 |
|---|---|
--remote <NAME> | 从此已配置的远程读取；省略时使用 Repository 默认远程。 |
--worker-job-index <INDEX> | 从当前 Repository 读取一个特定 Worker Job；不能与列表过滤条件组合。 |
--state <STATE> | 只返回 queued、running、succeeded 或 failed 状态的 Job。[possible values: queued, running, succeeded, failed] |
--limit <COUNT> | 在列表模式下最多返回此数量的 Job（1 到 1000；默认 50）。[default: 50] |
--json | 输出完整的机器可读 JSON 结果。 |
-h, --help | 打印帮助 |
ait repo ci-capabilities#
二进制描述： Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
Usage: ait repo ci-capabilities [OPTIONS]
Options:
--remote <NAME> Use this configured remote; omission uses the Repository default remote.
--json Emit the complete machine-readable JSON result.
-h, --help Print help说明
检查 Patchset CI 的服务器、原生 runner 和远程同步前置条件。
| 参数 / 选项 | 说明 |
|---|---|
--remote <NAME> | 使用此已配置的远程；省略时使用 Repository 默认远程。 |
--json | 输出完整的机器可读 JSON 结果。 |
-h, --help | 打印帮助 |