> ## 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: الربط والتشخيص وترحيل السجل

> إدارة ملف تعريف ربط المحركات المحمي على نطاق المستخدم في Symphony باستخدام list وinspect وdoctor وbind وunbind وmigrate المقيد بالملخص (digest) عبر qxctl.

تدير قواعد الأوامر `qxctl knowledge engines ...` ملف تعريف الربط المحمي `default` على نطاق المستخدم لمحركات المتجهات في Symphony. فهي تربط محتوى محددًا لتسويته لاحقًا، لكنها لا تثبّت المحرك ولا تستدعيه ولا تفعّله ولا ترسيه (dock) ولا تصادق عليه ولا تخوّله ولا تطبّقه.

## الأوامر

```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 ...
```

مرّر القيمة `absent` لأول تعديل على سجل v2، أو الملخص الدقيق الذي يُبلغ عنه `list` للتعديلات اللاحقة. كل تعديل هو عملية مقارنة ومبادلة (compare-and-swap) مقابل ذلك الملخص.

## الترحيل من v1 إلى v2

> [!WARNING]
>
> تظل حالة سجل v1 الصالحة قابلة للقراءة. الترحيل إلى v2 عملية مقارنة ومبادلة دقيقة منفصلة، وليس أبدًا عملية لاختيار الإصدار. لا تتعامل مع الترحيل كمسار ترقية لاختيار المحرك.

* يستمر `list` و`inspect` في العمل على أدلة v1.
* ينتج `migrate` جيلًا مرتبطًا من v2 دون التخلي عن حقيقة v1.
* بعد الترحيل، استخدم ملخصات v2 للتعديلات المستقبلية.

## ما هو الربط

يختار الربط محتوى دقيقًا لتسويته لاحقًا بواسطة المنسّق. وهو:

* لا يثبّت محركًا
* لا يستدعي محركًا ولا يفعّله
* لا يرسي محركًا مع Maestro
* لا يصادق على المستدعي
* لا يخوّل التطبيق (apply)

## واجهات ذات صلة

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

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

> [card] [Maestro](https://docs.quanux.org/symphony/ar/governance/maestro.md)
>
> سلطة الحضور التي تسجّل الإرساء، لا الروابط.

> [card] [نظرة عامة على المحركات](https://docs.quanux.org/symphony/ar/engines/overview.md)
>
> محركات متجهات قابلة للتثبيت بشكل مستقل.


## Related topics

- [qxctl knowledge reconcile: تسوية شجرة العمل](https://docs.quanux.org/symphony/ar/qxctl/reconcile.md)
- [qxctl knowledge lifecycle: ملف التعريف والإقلاع والتطبيق](https://docs.quanux.org/symphony/ar/qxctl/lifecycle.md)
- [qxctl knowledge: إدارة دورة الحياة عبر المتجهات](https://docs.quanux.org/symphony/ar/qxctl/knowledge.md)
- [qxctl: سطر الأوامر الإداري الوكيلي لـ Symphony](https://docs.quanux.org/symphony/ar/qxctl/overview.md)
- [qxctl knowledge session: جلسات Symphony المصادق عليها](https://docs.quanux.org/symphony/ar/qxctl/session.md)


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