> ## 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 reconcile：工作树协调

> 针对已绑定的 Symphony 协调器协调工作树，提供兼容性检查、检查点与关闭日志，以及基于证据的双槽恢复。

`qxctl knowledge reconcile ...` 语法通过一个确切绑定的知识会话协调器（Knowledge Session Coordinator）驱动工作树协调。每次变更都以稳定标识符进行跟踪，并针对当前确切的日志摘要执行比较并交换（compare-and-swap）。

## 命令

```bash Reconcile grammar theme={null}
qxctl knowledge reconcile compatibility
qxctl knowledge reconcile begin      --operation-id OPID --expected-journal-digest absent|DIGEST ...
qxctl knowledge reconcile status
qxctl knowledge reconcile checkpoint --operation-id OPID --expected-journal-digest DIGEST
qxctl knowledge reconcile close      --operation-id OPID --expected-journal-digest DIGEST
qxctl knowledge reconcile recover    --discover
```

* `compatibility`：验证 qxctl、协调器和已绑定引擎在协议版本和作用域上是否一致。
* `begin`：使用稳定的操作标识符开启新的协调上下文。
* `status`：在不变更的情况下检查当前日志。
* `checkpoint`：通过比较并交换持久化地推进日志。
* `close`：完成协调上下文。
* `recover --discover`：当常规 status 无法验证本地状态时进行发现式恢复。

## 恢复规则

> [!WARNING]
>
> 双槽恢复是基于证据的前向修复。它绝不意味着允许丢弃不兼容的日志或未知的关键扩展。如果恢复失败，请上报处理，而不要强制执行。

仅当常规 status 无法验证本地状态时才使用发现式恢复。保留阻断项；仅在已验证的证据发生变化后再重新规划。

## 相关界面

> [card] [会话协调器](https://docs.quanux.org/symphony/cn/engines/coordinator.md)
>
> 拥有协调日志的引擎。

> [card] [qxctl session](https://docs.quanux.org/symphony/cn/qxctl/session.md)
>
> 与协调上下文配对的经过认证的会话。

> [card] [qxctl engines](https://docs.quanux.org/symphony/cn/qxctl/engines.md)
>
> 管理协调器所使用的绑定。


## Related topics

- [qxctl knowledge：跨向量生命周期管理](https://docs.quanux.org/symphony/cn/qxctl/knowledge.md)
- [qxctl：Symphony 智能体式管理命令行](https://docs.quanux.org/symphony/cn/qxctl/overview.md)
- [Symphony Vector 引擎的知识会话协调器](https://docs.quanux.org/symphony/cn/engines/coordinator.md)
- [Maestro：Symphony Vector 引擎的存在权威](https://docs.quanux.org/symphony/cn/governance/maestro.md)
- [qxctl knowledge session：经过认证的 Symphony 会话](https://docs.quanux.org/symphony/cn/qxctl/session.md)


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