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 選擇與執行設定仍由伺服器策略決定,此處不可覆蓋。