> ## 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 代（generation），而不会丢弃 v1 的事实。
* 迁移完成后，后续变更请使用 v2 摘要。

## 什么是绑定

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

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

## 相关界面

> [card] [qxctl reconcile](https://docs.quanux.org/symphony/cn/qxctl/reconcile.md)
>
> 将已绑定内容与协调器进行协调。

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

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

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


## Related topics

- [qxctl：Symphony 智能体式管理命令行](https://docs.quanux.org/symphony/cn/qxctl/overview.md)
- [qxctl knowledge：跨向量生命周期管理](https://docs.quanux.org/symphony/cn/qxctl/knowledge.md)
- [qxctl maestro：读取 Symphony 受体存在性清单](https://docs.quanux.org/symphony/cn/qxctl/maestro.md)
- [qxctl knowledge reconcile：工作树协调](https://docs.quanux.org/symphony/cn/qxctl/reconcile.md)
- [SSFV：Symphony 语义功能向量与注册表](https://docs.quanux.org/symphony/cn/skv/ssfv.md)


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