> ## 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：Symphony 智能体化管理命令行

> qxctl 是 Symphony 的 Go 管理 CLI。了解其 373 个可执行命令、引擎绑定注册表 v2，以及面向引擎的安全调用模型。

`qxctl` 是 Symphony 基于 Go、以智能体优先的管理与查询 CLI。它负责表达命令；命令背后的操作与含义由领域向量拥有。其签入的注册表将每个可执行命令叶绑定到一个稳定的机器标识以及经过审查的功能管理证据。

## qxctl 涵盖的内容

qxctl 实现了以下方面的管理：

* 仓库与契约检查
* 验证器、警告、不变量、功能、生命周期、会话、协调、绑定以及 Maestro 管理
* SSIAG 身份、STAV 审计以及 Accordare 生产者管理
* 已实现的向量引擎语法（`skvi`、`sclv`、`sacv`、`sodv`、`ssfv`，以及 SCV 和 SHV 界面）

当前注册表包含 **373** 个可执行命令。

## 安全调用模型

qxctl 通过有边界的子进程、硬性截止时间、响应身份与摘要校验、预期状态事务以及持久化恢复，来调用经过回执验证的确切安装。它从不接受用适配器路径或原始版本号来代替回执。

## 引擎绑定注册表 v2

引擎绑定注册表 v2 支持八种既定的引擎角色以及有边界的未来角色标识。遗留的 v1 状态可双重读取；迁移到 v2 需要通过 qxctl 执行显式的、受摘要约束的比较并交换，且绝不是版本选择操作。

## 注册表命令

在 `tools/qxctl` 中生成并验证预期注册表：

```bash Registry generation and verification theme={null}
go run ./cmd/qxctl commands expected --json > COMMANDS.json
go run ./cmd/qxctl commands verify --input COMMANDS.json --json
```

已安装的客户端可以输出与可执行文件绑定的证据：

```bash Manifest from installed qxctl theme={null}
qxctl commands manifest --json
```

预期证据中的客户端版本、可执行文件摘要和回执摘要均为 null。观察证据绑定确切的客户端版本和可执行文件摘要，并在可用时附带回执摘要。两种形式都使用 `symphony.qxctl.command-registry.v1`。

> [!NOTE]
>
> qxctl 拥有命令语法与呈现方式。它不拥有向量语义或规范知识事实。无论调用方类别如何，只有经过审查的源代码变更才能批准新的 `qxcmd` 标识。

## 命令组

> [card] [knowledge](https://docs.quanux.org/symphony/zh-Hans/qxctl/knowledge.md)
>
> 跨向量生命周期与持久化 SSFV 会话管理。

> [card] [lifecycle](https://docs.quanux.org/symphony/zh-Hans/qxctl/lifecycle.md)
>
> 配置、所有权、观察、报告、启动、应用与恢复。

> [card] [engines](https://docs.quanux.org/symphony/zh-Hans/qxctl/engines.md)
>
> 引擎绑定注册表与迁移。

> [card] [reconcile](https://docs.quanux.org/symphony/zh-Hans/qxctl/reconcile.md)
>
> 协调器工作树协调。

> [card] [session](https://docs.quanux.org/symphony/zh-Hans/qxctl/session.md)
>
> 已认证会话与 SSFV 维护流。

> [card] [maestro](https://docs.quanux.org/symphony/zh-Hans/qxctl/maestro.md)
>
> 派生的受体清单与停靠证据。

> [card] [validate](https://docs.quanux.org/symphony/zh-Hans/qxctl/validate.md)
>
> 受保护的警告策略与验证器管理。

> [card] [向量命令](https://docs.quanux.org/symphony/zh-Hans/qxctl/vector-commands.md)
>
> `skvi`、`sclv`、`sacv`、`sodv`、`ssfv`、`shv`，以及未来的 accord/evolution 语法。


## Related topics

- [Symphony Intelligence Vector：未来的智能体协作](https://docs.quanux.org/symphony/zh-Hans/vectors/siv.md)
- [Symphony 架构](https://docs.quanux.org/symphony/zh-Hans/concepts/architecture.md)
- [qxctl knowledge：跨向量生命周期管理](https://docs.quanux.org/symphony/zh-Hans/qxctl/knowledge.md)
- [Symphony Ops Vector：qxctl 运维控制](https://docs.quanux.org/symphony/zh-Hans/vectors/sov.md)
- [qxctl validate：Symphony 验证器警告策略](https://docs.quanux.org/symphony/zh-Hans/qxctl/validate.md)


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