التهيئة الأولية + بروتوكول التهيئة
الغرض: أسطح مشتركة للتهيئة الأولية والتهيئة عبر CLI وتطبيق macOS وواجهة الويب.المكونات
- محرك المعالج (جلسة مشتركة + مطالبات + حالة التهيئة الأولية).
- تستخدم التهيئة الأولية عبر CLI نفس تدفّق المعالج المستخدم لدى عملاء واجهة المستخدم.
- يعرِض Gateway RPC نقاط نهاية للمعالج ومخطط التهيئة.
- تستخدم التهيئة الأولية على macOS نموذج خطوات المعالج.
- تعرض واجهة الويب نماذج التهيئة اعتمادًا على JSON Schema + تلميحات واجهة المستخدم.
Gateway RPC
wizard.startparams:{ mode?: "local"|"remote", workspace?: string }wizard.nextparams:{ sessionId, answer?: { stepId, value? } }wizard.cancelparams:{ sessionId }wizard.statusparams:{ sessionId }config.schemaparams:{}
- المعالج:
{ sessionId, done, step?, status?, error? } - مخطط التهيئة:
{ schema, uiHints, version, generatedAt }
تلميحات واجهة المستخدم
uiHintsمُفهرسة حسب المسار؛ بيانات وصفية اختيارية (label/help/group/order/advanced/sensitive/placeholder).- تُعرَض الحقول الحسّاسة كمدخلات كلمة مرور؛ بدون طبقة تنقيح.
- تعود عُقد المخطط غير المدعومة إلى محرّر JSON الخام.
ملاحظات
- هذا المستند هو المكان الوحيد لتتبّع إعادة هيكلة البروتوكول الخاصة بالتهيئة الأولية/التهيئة.