> ## 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 lifecycle: ملف التعريف والإقلاع والتطبيق

> إدارة ملفات تعريف دورة الحياة المحمية والملكية والملاحظات وعمليات الإقلاع والانتقالات المتوافقة مع التطبيق عبر qxctl مع ضمانات صارمة للمقارنة والمبادلة.

تدير قواعد الأوامر `qxctl knowledge lifecycle ...` ملفات التعريف المحمية، والملكية، والملاحظات، وسجلات الإقلاع، والانتقالات المتوافقة مع التطبيق. كل تعديل هو عملية مقارنة ومبادلة (compare-and-swap)، وكل عملية تطبيق مقيّدة بأدلة دقيقة.

## ملف التعريف

اضبط ملف تعريف دورة الحياة المحمي لـ TOPS:

```bash Profile compare-and-swap theme={null}
qxctl knowledge lifecycle profile set \
  --tops-id UUID \
  --input FILE \
  --expected-profile-digest absent|DIGEST
```

مرّر `absent` لملف تعريف يُنشأ لأول مرة، أو الملخص الدقيق الذي أبلغت عنه قراءة سابقة.

## الملكية

* `ownership status`: فحص جذر مشترك واحد مُكوَّن
* `ownership reconcile`: تحديث أدلته
* `ownership adopt`: التبنّي فقط بعد مراجعة كل مطالبة قديمة متحفظة
* `ownership release`: التحرير فقط لإيصال قديم واحد محدد جُعل قابلًا للاستعادة عمدًا

> [!WARNING]
>
> لا تحذف أبدًا السجل المحلي للجذر أو حاجز توافق تخطيط الإيصالات `symphony-root-ownership/1` الخاص به، ولا تُعِد كتابتهما يدويًا. يجب أن تصادف عملاء دورة الحياة الأقدم ذلك الحاجز وتتوقف عند عائق الحزمة غير المعروفة الموجود لديها.

## المراقبة والتقرير والإقلاع

* `observe`: إصدار أدلة إيصال مؤقتة ذات تخطيط ثابت
* `report`: إنتاج خطة مؤقتة جديدة
* `boot`: تقدّم دائم للتقارير فقط مع معرّف عملية مستقر وحالة سجل دقيقة
* `status`: فحص v1
* `recover --discover`: استرداد سلسلة v1 فريدة عندما يتعذر على الحالة العادية التحقق من الحالة المحلية

## ملفات التعريف المتوافقة مع التطبيق

بالنسبة لملف تعريف `apply-compatible`، استدعِ `apply` فقط مع ملخص مصدر الإقلاع الدقيق، والمقارنة والمبادلة لسجل التطبيق، والمقارنة والمبادلة للحالة المطبّقة، ومعرّف عملية مستقر، وجذور مرحلية صريحة:

```bash Apply theme={null}
qxctl knowledge lifecycle apply \
  --tops-id UUID \
  --operation-id OPID \
  --boot-source-digest DIGEST \
  --expected-apply-journal-digest DIGEST \
  --expected-applied-state-digest DIGEST \
  --staged-root PATH
```

استخدم `apply-status` لمراقبة المحاولات، أو `apply-recover` المحدود للاسترداد الدائم. لا تختر إجراءً يدويًا أبدًا ولا تعدّل الحالة المحمية.

> [!NOTE]
>
> يجب أن يغيّر تحديث الملاحظة الذي يقتصر على الطابع الزمني أدلةَ المستند دون تقديم الهويات الدلالية المستقرة.

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

> [card] [منسّق الجلسات](https://docs.quanux.org/symphony/ar/engines/coordinator.md)
>
> المحرك الذي يقف وراء تنسيق خطط دورة الحياة وتطبيقها.

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


## Related topics

- [qxctl knowledge: إدارة دورة الحياة عبر المتجهات](https://docs.quanux.org/symphony/ar/qxctl/knowledge.md)
- [qxctl: سطر الأوامر الإداري الوكيلي لـ Symphony](https://docs.quanux.org/symphony/ar/qxctl/overview.md)
- [qxctl knowledge engines: الربط والتشخيص وترحيل السجل](https://docs.quanux.org/symphony/ar/qxctl/engines.md)
- [qxctl knowledge reconcile: تسوية شجرة العمل](https://docs.quanux.org/symphony/ar/qxctl/reconcile.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.