瀏覽 1.1.1 文件
1.1.1

ait patchset — 完整參考

發布並檢視 Change 候選,選定目前候選,並管理它的 CI 請求狀態。

適用對象: coding agent 與 CI 維運

作用邊界#

用途: 發布並檢視 Change 候選,選定目前候選,並管理它的 CI 請求狀態。

影響類別: 改動遠端候選、目前選定和 CI 狀態,同時提供只讀的檢視操作。

覆蓋: ait patchset 下共 7 個公開 help surface。

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

完整命令樹#

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

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

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

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

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

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

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

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

版本權威

對照 1.1.1 原始碼逐條核對

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

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