> ## 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 هو واجهة سطر الأوامر الإدارية بلغة Go في Symphony. تعرّف على أوامره التنفيذية الـ 373، وسجل ربط المحركات v2، ونموذج الاستدعاء الآمن للمحركات.

`qxctl` هو واجهة سطر الأوامر الإدارية والاستعلامية في Symphony، المبنية بلغة Go والمصممة للوكلاء أولًا. هو يتحدث بالأوامر؛ أما متجهات النطاق فتملك العمليات والمعاني التي تقف خلفها. ويربط سجله المحفوظ في المستودع كل أمر تنفيذي نهائي بهوية آلية مستقرة وبأدلة إدارة ميزات تمت مراجعتها.

## ما يغطيه 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
```

تحتوي الأدلة المتوقعة على قيم فارغة لإصدار العميل وملخص الملف التنفيذي وملخص الإيصال. أما الأدلة المرصودة فتربط إصدار العميل الدقيق وملخص الملف التنفيذي، إضافةً إلى ملخص الإيصال عند توفره. يستخدم كلا الشكلين `symphony.qxctl.command-registry.v1`.

> [!NOTE]
>
> يملك qxctl قواعد الأوامر وطريقة عرضها، لكنه لا يملك دلالات المتجهات ولا حقيقة المعرفة القانونية. وحدها تغييرات المصدر التي تمت مراجعتها تُقرّ هوية `qxcmd` جديدة، بغض النظر عن فئة المستدعي.

## مجموعات الأوامر

> [card] [knowledge](https://docs.quanux.org/symphony/ar/qxctl/knowledge.md)
>
> إدارة دورة الحياة عبر المتجهات وجلسات SSFV المستمرة.

> [card] [lifecycle](https://docs.quanux.org/symphony/ar/qxctl/lifecycle.md)
>
> ملف التعريف، والملكية، والمراقبة، والتقرير، والإقلاع، والتطبيق، والاسترداد.

> [card] [engines](https://docs.quanux.org/symphony/ar/qxctl/engines.md)
>
> سجل ربط المحركات والترحيل.

> [card] [reconcile](https://docs.quanux.org/symphony/ar/qxctl/reconcile.md)
>
> تسوية شجرة العمل عبر المنسّق.

> [card] [session](https://docs.quanux.org/symphony/ar/qxctl/session.md)
>
> الجلسات المصادق عليها وتدفقات صيانة SSFV.

> [card] [maestro](https://docs.quanux.org/symphony/ar/qxctl/maestro.md)
>
> جرد المستقبِلات المشتق وأدلة الإرساء.

> [card] [validate](https://docs.quanux.org/symphony/ar/qxctl/validate.md)
>
> سياسة التحذيرات المحمية وإدارة المدقق.

> [card] [أوامر المتجهات](https://docs.quanux.org/symphony/ar/qxctl/vector-commands.md)
>
> `skvi` و`sclv` و`sacv` و`sodv` و`ssfv` و`shv`، وقواعد أوامر accord/evolution المستقبلية.


## Related topics

- [البدء السريع: استكشف QuanuX Symphony](https://docs.quanux.org/symphony/ar/quickstart.md)
- [متجه العمليات في Symphony: التحكم في العمليات عبر qxctl](https://docs.quanux.org/symphony/ar/vectors/sov.md)
- [توثيق QuanuX Symphony](https://docs.quanux.org/symphony/ar/index.md)
- [محركات متجهات Symphony: نظرة عامة على التثبيت المستقل](https://docs.quanux.org/symphony/ar/engines/overview.md)
- [qxctl validate: سياسة تحذيرات مدقق Symphony](https://docs.quanux.org/symphony/ar/qxctl/validate.md)


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