> ## 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 engines：绑定、诊断与迁移注册表

> 通过 qxctl 使用 list、inspect、doctor、bind、unbind 以及受摘要约束的 migrate 命令，管理 Symphony 受保护的用户作用域引擎绑定配置。

`qxctl knowledge engines ...` 语法用于管理 Symphony 向量引擎受保护的用户作用域 `default` 绑定配置。它会绑定选定的内容，以供后续协调（reconciliation）使用。它不会安装、调用、激活、停靠（dock）、认证、授权或应用（apply）任何引擎。

## 命令

```bash Engines grammar theme={null}
qxctl knowledge engines list
qxctl knowledge engines inspect
qxctl knowledge engines doctor
qxctl knowledge engines bind    --expected-registry-digest absent|DIGEST ...
qxctl knowledge engines unbind  --expected-registry-digest DIGEST ...
qxctl knowledge engines migrate --expected-registry-digest DIGEST ...
```

首次对 v2 注册表进行变更时请提供 `absent`，之后的变更则提供 `list` 报告的确切摘要。每一次变更都会针对该摘要执行比较并交换（compare-and-swap）。

## 从 v1 迁移到 v2

> [!WARNING]
>
> 有效的 v1 注册表状态仍然可读。迁移到 v2 是一次独立的精确比较并交换操作，绝不是版本选择操作。不要把迁移当作引擎选择的升级路径。

* `list` 和 `inspect` 仍可基于 v1 证据工作。
* `migrate` 会生成一个关联的 v2 世代，而不会丢弃 v1 的事实记录。
* 迁移完成后，后续变更请使用 v2 摘要。

## 什么是绑定

绑定会选定确切的内容，供协调器（coordinator）后续进行协调。它：

* 不会安装引擎
* 不会调用或激活引擎
* 不会让引擎停靠到 Maestro
* 不会认证调用方
* 不会授权 apply

## 相关界面

> [card] [qxctl reconcile](https://docs.quanux.org/symphony/zh-Hans/qxctl/reconcile.md)
>
> 通过协调器协调已绑定的内容。

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

> [card] [Maestro](https://docs.quanux.org/symphony/zh-Hans/governance/maestro.md)
>
> 记录停靠关系（而非绑定）的存在权威。

> [card] [引擎概览](https://docs.quanux.org/symphony/zh-Hans/engines/overview.md)
>
> 可独立安装的向量引擎。


## Related topics

- [qxctl：Symphony 智能体化管理命令行](https://docs.quanux.org/symphony/zh-Hans/qxctl/overview.md)
- [qxctl knowledge：跨向量生命周期管理](https://docs.quanux.org/symphony/zh-Hans/qxctl/knowledge.md)
- [qxctl maestro：读取 Symphony 受体存在清单](https://docs.quanux.org/symphony/zh-Hans/qxctl/maestro.md)
- [qxctl knowledge reconcile：工作树协调](https://docs.quanux.org/symphony/zh-Hans/qxctl/reconcile.md)
- [qxctl knowledge lifecycle：配置、启动与应用](https://docs.quanux.org/symphony/zh-Hans/qxctl/lifecycle.md)


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