> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl knowledge lifecycle：設定檔、開機與套用

> 透過 qxctl 以嚴格的比較並交換防護機制，管理受保護的生命週期設定檔、擁有權、觀察、開機與相容套用的轉換。

`qxctl knowledge lifecycle ...` 語法用於管理受保護的設定檔、擁有權、觀察、開機日誌，以及相容套用（apply-compatible）的轉換。每次變更都是比較並交換（compare-and-swap），而每次套用都綁定於確切的證據。

## 設定檔

為某個 TOPS 設定受保護的生命週期設定檔：

```bash Profile compare-and-swap theme={null}
qxctl knowledge lifecycle profile set \
  --tops-id UUID \
  --input FILE \
  --expected-profile-digest absent|DIGEST
```

首次建立設定檔時請提供 `absent`，否則請提供先前讀取所回報的確切摘要。

## 擁有權

* `ownership status`：檢查一個已設定的共用根目錄
* `ownership reconcile`：重新整理其證據
* `ownership adopt`：僅在審查過每一項保守的舊版聲明之後才採用
* `ownership release`：僅針對一份刻意設為可回收的確切舊版收據進行釋放

> [!WARNING]
>
> 切勿手動刪除或改寫根目錄本機登錄檔或其 `symphony-root-ownership/1` 收據版面相容性柵欄。較舊的生命週期用戶端必須遇到該柵欄，並在其既有的未知套件阻擋條件上停止。

## 觀察、報告、開機

* `observe`：輸出可拋棄的固定版面收據證據
* `report`：產生全新的可拋棄計畫
* `boot`：具有穩定操作 ID 與確切日誌狀態的持久性僅報告推進
* `status`：v1 檢查
* `recover --discover`：當一般狀態無法驗證本機狀態時，復原唯一的 v1 鏈

## 相容套用的設定檔

對於 `apply-compatible` 設定檔，只有在提供確切的開機來源摘要、套用日誌比較並交換、已套用狀態比較並交換、穩定的操作 ID，以及明確的暫存根目錄時，才能呼叫 `apply`：

```bash Apply theme={null}
qxctl knowledge lifecycle apply \
  --tops-id UUID \
  --operation-id OPID \
  --boot-source-digest DIGEST \
  --expected-apply-journal-digest DIGEST \
  --expected-applied-state-digest DIGEST \
  --staged-root PATH
```

使用 `apply-status` 觀察嘗試狀況，或使用有界的 `apply-recover` 進行持久性復原。切勿手動選擇動作或編輯受保護的狀態。

> [!NOTE]
>
> 僅更新時間戳記的觀察重新整理，必須在不推進穩定語意識別的情況下變更文件證據。

## 相關介面

> [card] [工作階段協調器](https://docs.quanux.org/symphony/zh-Hant/engines/coordinator.md)
>
> 負責生命週期計畫與套用協調的引擎。

> [card] [qxctl engines](https://docs.quanux.org/symphony/zh-Hant/qxctl/engines.md)
>
> 管理生命週期計畫所參照的引擎綁定。


## Related topics

- [qxctl knowledge：跨向量生命週期管理](https://docs.quanux.org/symphony/zh-Hant/qxctl/knowledge.md)
- [qxctl：Symphony 代理式管理命令列](https://docs.quanux.org/symphony/zh-Hant/qxctl/overview.md)
- [qxctl knowledge engines：綁定、診斷與遷移登錄檔](https://docs.quanux.org/symphony/zh-Hant/qxctl/engines.md)
- [SEV：用於規劃變更的 Symphony 演進向量](https://docs.quanux.org/symphony/zh-Hant/skv/sev.md)
- [qxctl knowledge session：已驗證的 Symphony 工作階段](https://docs.quanux.org/symphony/zh-Hant/qxctl/session.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.