بروتوكول الإعداد والتكوين

الغرض: أسطح مشتركة للإعداد والتكوين عبر CLI وتطبيق macOS وواجهة المستخدم الويب.

المكونات

• محرك المعالج (جلسة مشتركة + مطالبات + حالة الإعداد).
• يستخدم إعداد CLI نفس تدفق المعالج المستخدم في واجهات المستخدم.
• تعرض بوابة RPC نقاط نهاية المعالج ومخطط التكوين.
• يستخدم إعداد macOS نموذج خطوات المعالج.
• تعرض واجهة المستخدم الويب نماذج التكوين من مخطط JSON وتلميحات واجهة المستخدم.

بوابة RPC

• wizard.start المعاملات: { mode?: "local"|"remote", workspace?: string }
• wizard.next المعاملات: { sessionId, answer?: { stepId, value? } }
• wizard.cancel المعاملات: { sessionId }
• wizard.status المعاملات: { sessionId }
• config.schema المعاملات: {}
• config.schema.lookup المعاملات: { path }
  • يقبل path مقاطع التكوين القياسية بالإضافة إلى معرفات الإضافات المفصولة بشرطة مائلة، على سبيل المثال plugins.entries.pack/one.config.

الاستجابات (الشكل)

• المعالج: { sessionId, done, step?, status?, error? }
• مخطط التكوين: { schema, uiHints, version, generatedAt }
• البحث في مخطط التكوين: { path, schema, hint?, hintPath?, children[] }

تلميحات واجهة المستخدم

• uiHints مفتاحها هو المسار؛ بيانات وصفية اختيارية (تسمية/مساعدة/مجموعة/ترتيب/متقدم/حساس/عنصر نائب).
• يتم عرض الحقول الحساسة كمدخلات كلمة مرور؛ لا توجد طبقة حذف.
• يتم الرجوع إلى محرر JSON الخام للعقد غير المدعومة في المخطط.

ملاحظات

• هذا المستند هو المكان الوحيد لتتبع إعادة هيكلة البروتوكول للإعداد والتكوين.

تكامل بوابة كيلووكلاء مرتبطون بخيط ACP