> ## 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: Dòng lệnh quản trị agentic của Symphony

> qxctl là CLI quản trị viết bằng Go của Symphony. Tìm hiểu về 373 lệnh thực thi, registry ràng buộc engine v2 và mô hình gọi an toàn cho các engine.

`qxctl` là CLI quản trị và truy vấn của Symphony, viết bằng Go và được thiết kế ưu tiên cho agent. Nó nói ngôn ngữ của lệnh; các vector miền sở hữu các thao tác và ý nghĩa đằng sau chúng. Registry được đưa vào kho mã của nó ràng buộc mọi lệnh lá có thể thực thi với một định danh máy ổn định và bằng chứng quản trị tính năng đã được xem xét.

## Phạm vi của qxctl

qxctl triển khai khả năng quản trị cho:

* Kiểm tra kho mã và hợp đồng
* Quản trị validator, cảnh báo, bất biến, tính năng, vòng đời, phiên, đối soát, ràng buộc và Maestro
* Quản trị định danh SSIAG, kiểm toán STAV và producer Accordare
* Cú pháp vector engine đã triển khai (`skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, cùng các bề mặt SCV và SHV)

Registry hiện tại chứa **373** lệnh có thể thực thi.

## Mô hình gọi an toàn

qxctl gọi chính xác các bản cài đặt đã được xác thực bằng biên nhận, sử dụng tiến trình con có giới hạn, hạn chót cứng, kiểm tra định danh và digest của phản hồi, giao dịch theo trạng thái mong đợi và khôi phục bền vững. Nó không bao giờ chấp nhận đường dẫn adapter hay phiên bản thô thay cho biên nhận.

## Registry ràng buộc engine v2

Registry ràng buộc engine v2 hỗ trợ tám vai trò engine đã được thiết lập và các định danh vai trò tương lai có giới hạn. Trạng thái v1 cũ được đọc song song; việc di chuyển sang v2 yêu cầu một thao tác compare-and-swap tường minh ràng buộc theo digest thông qua qxctl và không bao giờ là thao tác chọn phiên bản.

## Lệnh registry

Tạo và xác minh registry mong đợi từ `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
```

Một client đã cài đặt có thể xuất bằng chứng gắn với tệp thực thi:

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

Bằng chứng mong đợi có phiên bản client, digest tệp thực thi và digest biên nhận là null. Bằng chứng quan sát ràng buộc chính xác phiên bản client và digest tệp thực thi, cùng digest biên nhận khi có. Cả hai dạng đều dùng `symphony.qxctl.command-registry.v1`.

> [!NOTE]
>
> qxctl sở hữu cú pháp và cách trình bày lệnh. Nó không sở hữu ngữ nghĩa vector hay sự thật tri thức chuẩn tắc. Chỉ những thay đổi mã nguồn đã được xem xét mới phê chuẩn một định danh `qxcmd` mới, bất kể loại bên gọi.

## Các nhóm lệnh

> [card] [knowledge](https://docs.quanux.org/symphony/vi/qxctl/knowledge.md)
>
> Quản trị vòng đời liên vector và phiên SSFV lâu dài.

> [card] [lifecycle](https://docs.quanux.org/symphony/vi/qxctl/lifecycle.md)
>
> Hồ sơ, quyền sở hữu, observe, report, boot, apply và khôi phục.

> [card] [engines](https://docs.quanux.org/symphony/vi/qxctl/engines.md)
>
> Registry ràng buộc engine và di chuyển.

> [card] [reconcile](https://docs.quanux.org/symphony/vi/qxctl/reconcile.md)
>
> Đối soát worktree qua coordinator.

> [card] [session](https://docs.quanux.org/symphony/vi/qxctl/session.md)
>
> Phiên đã xác thực và luồng bảo trì SSFV.

> [card] [maestro](https://docs.quanux.org/symphony/vi/qxctl/maestro.md)
>
> Kiểm kê receptor được suy ra và bằng chứng docking.

> [card] [validate](https://docs.quanux.org/symphony/vi/qxctl/validate.md)
>
> Chính sách cảnh báo được bảo vệ và quản trị validator.

> [card] [Lệnh vector](https://docs.quanux.org/symphony/vi/qxctl/vector-commands.md)
>
> `skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, `shv` và cú pháp accord/evolution trong tương lai.


## Related topics

- [qxctl validate: Chính sách cảnh báo của Symphony Validator](https://docs.quanux.org/symphony/vi/qxctl/validate.md)
- [qxctl knowledge: Quản trị vòng đời liên vector](https://docs.quanux.org/symphony/vi/qxctl/knowledge.md)
- [qxctl maestro: Đọc kiểm kê hiện diện receptor của Symphony](https://docs.quanux.org/symphony/vi/qxctl/maestro.md)
- [SACV: Quản trị hợp đồng API cho QuanuX Symphony](https://docs.quanux.org/symphony/vi/skv/sacv.md)
- [Bắt đầu nhanh: Khám phá QuanuX Symphony](https://docs.quanux.org/symphony/vi/quickstart.md)


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