ait patchset — 完整参考
发布并查看 Change 候选，选定当前候选，并管理它的 CI 请求状态。
适用人群： coding agent 与 CI 运维
作用边界#
用途： 发布并查看 Change 候选，选定当前候选，并管理它的 CI 请求状态。
影响类别： 改动远程候选、当前选定和 CI 状态，同时提供只读的查看操作。
覆盖： ait patchset 下共 7 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
ait patchset
ait patchset publish
ait patchset list
ait patchset show
ait patchset select
ait patchset ci-status
ait patchset rerun-ci原样输出的 help#
ait patchset#
二进制描述： Publish the current local Line head as a remote Change revision, inspect or select specific published Patchsets, and read or manually rerun their remote CI. Published Patchsets exist only on remotes; --remote selects a configured remote and there is no local Patchset mode.
Publish the current local Line head as a remote Change revision, inspect or select specific published Patchsets, and read or manually rerun their remote CI. Published Patchsets exist only on remotes; --remote selects a configured remote and there is no local Patchset mode.
Usage: ait patchset <COMMAND>
Commands:
publish Publish the current Line head as a new remote Patchset.
list List the published Patchsets owned by one remote Change without modifying it.
show Show one exact published remote Patchset without modifying it.
select Select one specific Patchset on its owning remote Change.
ci-status Read CI state for one exact remote Patchset.
rerun-ci Queue a manual CI rerun for one exact remote Patchset.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')说明
把当前本地 Line head 发布为远程 Change 修订，查看或选择特定的已发布 Patchset，并读取或手动重跑其远程 CI。已发布 Patchset 只存在于远程；--remote 选择已配置远程，不存在本地 Patchset 模式。
| 参数 / 选项 | 说明 |
|---|---|
publish | 将当前 Line head 发布为一个新的远程 Patchset。 |
list | 列出一个远程 Change 拥有的已发布 Patchset，不做修改。 |
show | 显示一个确切的已发布远程 Patchset，不做修改。 |
select | 在所属远程 Change 上选择一个特定 Patchset。 |
ci-status | 读取一个确切远程 Patchset 的 CI 状态。 |
rerun-ci | 为一个确切的远程 Patchset 排队一次手动 CI 重跑。 |
help | 打印本消息或给定子命令的帮助 |
ait patchset publish#
二进制描述： Publish the current local Line head as the next Patchset for CHANGE_ID after validating the bound worktree and synchronizing its revision Snapshot to the selected remote. --summary is required; --author-mode overrides the configured provenance mode for this publication only.
Publish the current local Line head as the next Patchset for CHANGE_ID after validating the bound worktree and synchronizing its revision Snapshot to the selected remote. --summary is required; --author-mode overrides the configured provenance mode for this publication only.
Usage: ait patchset publish [OPTIONS] --summary <SUMMARY> <CHANGE_ID>
Arguments:
<CHANGE_ID>
Exact remote Change ID that will own the new Patchset.
Options:
--summary <SUMMARY>
Required human-readable summary of this published revision.
--author-mode <MODE>
Override provenance mode for this publication; otherwise use configured default_author_mode.
[possible values: human_only, human_with_ai_assist, ai_with_human_review, ai_only_experimental]
--remote <REMOTE>
Configured remote name; defaults to the repository's default remote.
--json
Emit the complete publication result as stable JSON.
-h, --help
Print help (see a summary with '-h')说明
在校验绑定的 worktree 并把其修订 Snapshot 同步到所选远程之后，将当前本地 Line head 发布为 CHANGE_ID 的下一个 Patchset。--summary 为必填；--author-mode 仅对本次发布覆盖配置的来源模式。
ait patchset list#
二进制描述： List the published Patchsets owned by one remote Change without modifying it.
List the published Patchsets owned by one remote Change without modifying it.
Usage: ait patchset list [OPTIONS] <CHANGE_ID>
Arguments:
<CHANGE_ID> Exact remote Change ID whose published Patchsets will be listed.
Options:
--remote <REMOTE> Configured remote name; defaults to the repository's default remote.
--json Emit the complete Patchset list as stable JSON.
-h, --help Print help说明
列出一个远程 Change 拥有的已发布 Patchset，不做修改。
| 参数 / 选项 | 说明 |
|---|---|
<CHANGE_ID> | 要列出其已发布 Patchset 的确切远程 Change ID。 |
--remote <REMOTE> | 已配置的远程名称；默认使用仓库的默认远程。 |
--json | 以稳定 JSON 输出完整的 Patchset 列表。 |
-h, --help | 打印帮助 |
ait patchset show#
二进制描述： Show one exact published remote Patchset without modifying it.
Show one exact published remote Patchset without modifying it.
Usage: ait patchset show [OPTIONS] <PATCHSET_ID>
Arguments:
<PATCHSET_ID> Complete published Patchset ID; bare numeric ordinals are rejected.
Options:
--remote <REMOTE> Configured remote name; defaults to the repository's default remote.
--json Emit the complete Patchset record as stable JSON.
-h, --help Print help说明
显示一个确切的已发布远程 Patchset，不做修改。
| 参数 / 选项 | 说明 |
|---|---|
<PATCHSET_ID> | 完整的已发布 Patchset ID；不接受裸数字序号。 |
--remote <REMOTE> | 已配置的远程名称；默认使用仓库的默认远程。 |
--json | 以稳定 JSON 输出完整的 Patchset 记录。 |
-h, --help | 打印帮助 |
ait patchset select#
二进制描述： Read the requested Patchset, find its owning remote Change, then make that Patchset the Change's selected revision. The owning Change cannot be supplied or overridden by the caller.
Read the requested Patchset, find its owning remote Change, then make that Patchset the Change's selected revision. The owning Change cannot be supplied or overridden by the caller.
Usage: ait patchset select [OPTIONS] <PATCHSET_ID>
Arguments:
<PATCHSET_ID>
Complete published Patchset ID; its owning Change is derived remotely.
Options:
--remote <REMOTE>
Configured remote name; defaults to the repository's default remote.
--json
Emit the complete selection result as stable JSON.
-h, --help
Print help (see a summary with '-h')说明
读取请求的 Patchset，找到其所属远程 Change，再把该 Patchset 设为 Change 的选定修订。调用方不能提供或覆盖所属 Change。
ait patchset ci-status#
二进制描述： Read current CI readiness and the 10 most recent CI jobs for one published Patchset without changing remote data.
Read current CI readiness and the 10 most recent CI jobs for one published Patchset without changing remote data.
Usage: ait patchset ci-status [OPTIONS] <PATCHSET_ID>
Arguments:
<PATCHSET_ID>
Complete published Patchset ID; bare numeric ordinals are rejected.
Options:
--remote <REMOTE>
Configured remote name; defaults to the repository's default remote.
--json
Emit the complete CI status and fixed recent-job window as stable JSON.
-h, --help
Print help (see a summary with '-h')说明
读取一个已发布 Patchset 当前的 CI 就绪状态和最近 10 个 CI job，不改动远程数据。
ait patchset rerun-ci#
二进制描述： Queue CI for one exact published Patchset using the fixed trigger manual_rerun. Runner selection and execution profiles remain server policy and cannot be overridden here.
Queue CI for one exact published Patchset using the fixed trigger manual_rerun. Runner selection and execution profiles remain server policy and cannot be overridden here.
Usage: ait patchset rerun-ci [OPTIONS] <PATCHSET_ID>
Arguments:
<PATCHSET_ID>
Complete published Patchset ID to enqueue for a manual rerun.
Options:
--remote <REMOTE>
Configured remote name; defaults to the repository's default remote.
--json
Emit the complete queued-run result as stable JSON.
-h, --help
Print help (see a summary with '-h')说明
使用固定触发器 manual_rerun 为一个确切的已发布 Patchset 排队 CI。runner 选择与执行配置仍由服务器策略决定，此处不可覆盖。