> ## 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 管理受保护的生命周期配置、所有权、观察、启动以及兼容 apply 的转换，并配有严格的比较并交换保护措施。

`qxctl knowledge lifecycle ...` 语法用于管理受保护的配置、所有权、观察、启动日志以及兼容 apply 的转换。每一次变更都采用比较并交换（compare-and-swap），每一次 apply 都绑定到确切的证据。

## 配置（Profile）

为某个 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`：当常规 status 无法验证本地状态时，恢复唯一的 v1 链

## 兼容 apply 的配置

对于 `apply-compatible` 配置，仅在具备确切的启动源摘要、apply 日志比较并交换、已应用状态比较并交换、稳定的操作 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-Hans/engines/coordinator.md)
>
> 支撑生命周期计划与 apply 协调的引擎。

> [card] [qxctl engines](https://docs.quanux.org/symphony/zh-Hans/qxctl/engines.md)
>
> 管理生命周期计划所引用的引擎绑定。


## Related topics

- [qxctl knowledge：跨向量生命周期管理](https://docs.quanux.org/symphony/zh-Hans/qxctl/knowledge.md)
- [qxctl：Symphony 智能体化管理命令行](https://docs.quanux.org/symphony/zh-Hans/qxctl/overview.md)
- [qxctl knowledge engines：绑定、诊断与迁移注册表](https://docs.quanux.org/symphony/zh-Hans/qxctl/engines.md)
- [qxctl knowledge session：已认证的 Symphony 会话](https://docs.quanux.org/symphony/zh-Hans/qxctl/session.md)
- [快速入门：探索 QuanuX Symphony](https://docs.quanux.org/symphony/zh-Hans/quickstart.md)


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