جسر ZCode Desktop

ZCode Desktop Bridge أداة CLI محلية غير رسمية وتجريبية للمطورين الذين يستخدمون جلسة موثقة في ZCode Desktop. تقرأ ملف موجز، وتنشئ مهمة عبر التطبيق، وتنتظر الرد، ثم تطبع النتيجة بصيغة JSON.

المشكلة

يتيح تطبيق سطح المكتب سير عمل موثقًا لواجهته، بينما تحتاج مهمة في الطرفية إلى إرسال موجز واستلام النتيجة. يستخدم الجسر واجهة تصحيح Electron المحلية وقناة الخدمة الموجودة داخل صفحة التطبيق.

الميزات الرئيسية

• بدء ZCode Desktop مع منفذ محلي لبروتوكول Chrome DevTools Protocol عند الحاجة.
• رفض استبدال جلسة سطح مكتب تعمل مسبقًا دون منفذ التصحيح.
• تحديد صفحة التطبيق من واجهة التصحيح المحلية.
• التقاط MessagePort الخاص بالخدمة أثناء إعادة تحميل الصفحة.
• إنشاء عميل RPC جانبي وإكمال مصافحة بروتوكول المحادثة.
• قبول خيارات مساحة العمل وملف الموجز ونمط التشغيل والمهلة.
• إنشاء جلسة وإرسال النص ومراجعة صفوف المحادثة حتى اكتمال الرد.
• ربط صفوف الاستجابة بالدور المرسل وطباعة JSON منظمة.

البنية التقنية

يفحص غلاف Bash الملف التنفيذي ومنفذ CDP المحلي، ثم يستدعي وحدتين في Node.js. تتصل وحدة التهيئة عبر ws، وتحقن مستمعًا يعمل عند تحميل الصفحة، وتعيد تحميل واجهة Electron لالتقاط MessagePort. تستورد شيفرة البروتوكول الداخلية من حزمة التطبيق المثبتة لإنشاء عميل جانبي. تنفذ وحدة التفويض استدعاءات RPC داخل الصفحة، وتنشئ جلسة المهمة، وترسل النص، ثم تستعلم عن الاكتمال.

أبرز الجوانب الهندسية

• تخصص التهيئة نطاقًا منفصلًا لمعرفات طلبات العميل الجانبي لتفادي تعارضها مع طلبات الواجهة.
• يلتقط مستمع تحميل الصفحة MessagePort عندما يصل إلى واجهة التطبيق.
• يطابق الاستعلام الدوري معرف الأمر ومعرف الدور قبل تجميع نص الإجابة.
• يحافظ غلاف التشغيل على العملية القائمة بدل إغلاقها لفتح منفذ التصحيح.