النافذة

تتألف نافذة Signal Lab من أربعة أجزاء: الشريط الجانبي على اليمين يسرد الشاشات، والشريط العلوي في الأعلى يضم ما ينطبق في كل مكان، والشاشة المختارة تملأ الوسط، واللوحة السفلية تعرض وحدة التحكم والمهام الجارية والفاحص. يبدو التطبيق المكتبي وصفحة الخادم في المتصفح متماثلين؛ والفروق القليلة بينهما في في المتصفح.

الشريط الجانبي

كل شاشة أداة قائمة بذاتها، تُفتح بالنقر عليها:

الشاشة	الغرض منها
التجارب	بناء تدفقات اختبار على لوحة الرسم، وتشغيلها، وقراءة كل تشغيل خطوةً بخطوة. التجارب
الإشارات	مكتبة الإشارات: رسائل مسمّاة في مجلدات، تُعدَّل وتُرسل مجددًا. الإشارات
المحاكيات	واجهات HTTP API وهمية، وأجهزة OSC وUDP وTCP، ووسطاء MQTT، تجيب وفق قواعد. المحاكيات
OSC	إرسال رسائل OSC، ومراقبة منفذ، وبث شكل موجي إلى نقطة نهاية. OSC
MQTT	الاتصال بوسيط، ورؤية كل موضوع لديه، والنشر، ومسح القيم المحتفظ بها. MQTT
البث	الإرسال إلى مضيفات كثيرة دفعة واحدة — قائمة، أو بث، أو بث متعدد، أو تمشيط شبكة فرعية — والاستماع لمن يجيب. البث والاكتشاف
HTTP	طلب واحد واستجابته كاملة، ثم دفعة حمل على نقطة النهاية نفسها. HTTP
WebSocket	الاتصال بخدمة WebSocket، وإرسال نص أو بايتات، وقراءة كل رسالة. WebSocket
الإضعاف	مرحّل يُضعف حركة مرور UDP أو TCP بين العميل وهدفه. الإضعاف
العاصفة	حمل UDP أو TCP خام على الخوادم والروابط الخاصة بك. العاصفة
الماسح	منافذ TCP المفتوحة على مضيف، مع أول ما تقوله الخدمة. الماسح

يبدأ الشريط الجانبي عمودًا ضيقًا فيه رمز كل شاشة واسم قصير لها؛ ويظهر الاسم الكامل عند تمرير المؤشر فوقها. وتبدّل علامة ☰ في يمين الشريط العلوي (توسيع شريط التنقل / طي شريط التنقل) بين العمود الضيق والقائمة الكاملة، ويتذكر Signal Lab ما اختير.

يدل رقم على مدخل الشاشة على عدد المهام الجارية منها، كمراقب أو محاكٍ، فيُعرف ما زال يعمل دون فتحها. وفي أسفل الشريط الجانبي، يفتح رقم الإصدار نافذة «حول»، ويعدّ السطر الذي تحته كل المهام الجارية.

يفتح Signal Lab على آخر شاشة استُخدمت.

الشريط العلوي

من اليمين إلى اليسار:

العنصر	ما يفعله
☰	يعرض الشريط الجانبي عمودًا ضيقًا أو قائمة كاملة.
المضيف	المضيف، ثم اسم الكمبيوتر الذي يعمل عليه المحرك وعنوانه على الشبكة: هذا الكمبيوتر في التطبيق المكتبي، والخادم في المتصفح. وفي المتصفح يظهر أيضًا الخادم — ويُعرف بتمرير المؤشر فوقه أين يحفظ الخادم ملفاته — وتتغير النقطة بجانبه حين تفقد الصفحة اتصالها.
زر التحديث	يظهر في التطبيق المكتبي عند العثور على إصدار أحدث، ويفتح نافذة «حول» لتثبيته. انظر التحديثات.
الكتاب	التوثيق: هذا التوثيق، على صفحة الشاشة المفتوحة. ويفعل F1 الشيء نفسه من أي مكان.
✉	مراسلة المطوّرين: رسالة إلى المطوّرين. انظر مراسلة المطوّرين.
?	حول Signal Lab: الإصدار، ومن يصنع Signal Lab، وكيفية التواصل معهم، والتحديثات.
العلم	اللغة: لغة الواجهة. انظر اللغات.
تسجيل الخروج	في المتصفح، حين يطلب الخادم رمز وصول: يُنهي جلسة هذا المتصفح.
إيقاف الكل	يوقف كل المهام الجارية دفعة واحدة: المراقبات والمولّدات والمنارات والمحاكيات والمرحّلات والعواصف وعمليات المسح والتشغيلات. ويكون باهتًا حين لا يعمل شيء.

التوثيق

التوثيق مدمج في التطبيق وفي الخادم، فهو متاح دون اتصال بالإنترنت، وبلغة الواجهة. يعرضه التطبيق المكتبي في نافذة خاصة به — والضغط على الزر مجددًا من شاشة أخرى ينقل تلك النافذة إلى صفحة الشاشة الأخرى — ويرسل الروابط التي تخرج من التوثيق إلى المتصفح. أما في المتصفح فيُفتح في علامة تبويب خاصة به. وفي نافذة «حول» زر التوثيق أيضًا، يفتح صفحة ما هو Signal Lab.

نافذة «حول»

تعرض نافذة «حول» الإصدار، والمطوّر، وعنوان التواصل (مع زر ينسخه)، والشيفرة المصدرية، والترخيص. وفي التطبيق المكتبي يبحث قسم التحديثات فيها عن التحديثات ويعرضها ويثبّتها — انظر التحديثات. وفي المتصفح تظهر فيها العبارة يُحدَّث الخادم مع صورته. ويفتح الزر مراسلة المطوّرين نموذج المراسلة.

مراسلة المطوّرين

تفتح علامة ✉ في الشريط العلوي نموذجًا يصل مباشرة إلى المطوّرين:

الحقل	ما يُكتب فيه
الرسالة	ما الذي حدث، وما الذي كان متوقعًا بدلًا منه. إلزامي؛ وبحد أقصى 20,000 حرف.
البريد الإلكتروني للرد	اختياري: عنوان يستطيع المطوّرون الرد عليه. ولا يراه غيرهم.
لقطات الشاشة	حتى 6 صور (PNG أو JPEG أو WebP أو GIF)، بحد 8 ميغابايت لكل منها و15 ميغابايت معًا. تُلصق الصورة بـ Ctrl+V، أو تُفلت الملفات على النافذة، أو يُضغط الزر إرفاق لقطة شاشة.
تُرفق تلقائيًا	أسطر وحدة التحكم والإصدار والنظام، يُرفق كلٌّ منهما ملفًا مستقلًا. ويعرض الزر عرض ما يُرسل بالضبط؛ ويُلغى تحديد أيٍّ منهما لاستبعاده.

تستبعد السجلات المرفقة اسم هذا الكمبيوتر، وعنوانه على الشبكة، والأسماء الواردة في مسارات مجلدات المستخدم. ويُرسل النموذج بـ Ctrl+Enter؛ وبعد إرساله يظهر رقم مرجعي تحتفظ به وحدة التحكم أيضًا. وتمر الرسالة عبر خدمة الاستوديو الخاصة، التي تُرسلها بالبريد الإلكتروني؛ ولا يحمل التطبيق أي كلمة مرور لذلك.

اللوحة السفلية

للوحة الموجودة تحت كل شاشة علامتا تبويب، وحدة التحكم والفاحص، وبينهما وبين أزرار اللوحة شريط المهام الجارية.

• السهم في يمينها (طي وحدة التحكم / توسيع وحدة التحكم) يطوي اللوحة إلى شريطها أو يفتحها مجددًا. وحين تكون مطوية، يظل الشريط يعرض أحدث سطر في وحدة التحكم؛ والنقر على ذلك السطر يفتح اللوحة.
• تُسحب الحافة العليا للوحة لزيادة ارتفاعها أو إنقاصه (انظر تغيير أحجام الأجزاء).
• والزر في يسارها يجعلها بارتفاع النافذة كاملًا ثم يعيدها (العودة إلى ارتفاعها السابق).

وتُحفظ للمرة القادمة حالة اللوحة مفتوحةً أو مطوية، والعلامة التي تعرضها، وارتفاعها.

وحدة التحكم

تذكر وحدة التحكم ما فعلته كل أداة وما الذي أخفق، والأحدث في الأسفل: رسالة أُرسلت وحجمها، ومراقب بدأ، وحالة استجابة وزمنها، ومهمة انتهت وسبب انتهائها. لكل سطر وقته (بدقة الميلي ثانية)، ووسم يسمّي الأداة، والرسالة، ملوّنةً بحسب نوعها — اكتمال، أو معلومة، أو تحذير، أو خطأ.

• يُبقي الخيار تمرير تلقائي أحدث سطر ظاهرًا مع وصول الأسطر؛ ويُلغى تحديده للقراءة إلى الوراء بينما يصل المزيد.
• ويفرّغها الزر مسح.
• تحتفظ بآخر 500 سطر.
• وتبديل اللغة يعيد كتابة وحدة التحكم كلها باللغة الجديدة.

المهام

لكل مهمة جارية — مراقب، أو مولّد، أو منارة، أو اتصال بوسيط، أو محاكٍ، أو مرحّل، أو عاصفة، أو مسح، أو تشغيل تجربة — شارة في الشريط برقمها ونوعها، وزر خاص بها لإيقافها. وحين لا يعمل شيء يعرض الشريط لا مهام نشطة. انظر المهام.

علامة تبويب الفاحص

تعرض علامة التبويب الفاحص كل إطار ترسله الأدوات وتستقبله ما دام الالتقاط مفعّلًا، بجانب أي شاشة يجري العمل فيها. تضيء نقطتها ما دام الالتقاط مفعّلًا، ويعدّ رقمٌ الإطارات الملتقطة. وتُفتح اللوحة بارتفاع يكفي لقائمة الفاحص وتفاصيل إطار؛ والرابط إلى إطار من مكان آخر — في الخط الزمني لتشغيل أو في قائمة محاكٍ — يفتح هذه العلامة على ذلك الإطار. وبعد فتحه، يحتفظ الفاحص بقائمته وتحديده حتى حين تكون اللوحة مغلقة. طريقة استخدامه: الفاحص.

إرسال إشارة من أي مكان

يُضغط Ctrl+K على أي شاشة لفتح لوحة إرسال إشارة: تُكتب بضعة أحرف من اسم الإشارة أو مجلدها أو هدفها، ويُختار بـ ↑ و↓، ثم يُضغط Enter لإرسالها. تسرد اللوحة حتى 12 إشارة في كل مرة. وتُغلق بـ Esc، أو بنقرة خارجها، أو بـ Ctrl+K مرة أخرى. وتذكر وحدة التحكم ما أُرسل وإلى أين. انظر الإشارات.

تغيير أحجام الأجزاء

يوجد مقبض رفيع بين الأجزاء القابلة لتغيير الحجم: الحافة العليا للوحة السفلية (ارتفاع وحدة التحكم)، وفي شاشة التجارب، حافة لوحة الخصائص (عرض لوحة الخصائص) وأعلى الخط الزمني للتشغيل (ارتفاع الخط الزمني).

• يُسحب المقبض.
• أو يُنقل التركيز إليه بـ Tab وتُستخدم مفاتيح الأسهم: كل ضغطة تحرّكه 16 بكسلًا، وأربعة أضعاف ذلك مع Shift؛ ويأخذه Home وEnd إلى أصغر حجم وأكبره.
• ويعيد النقر المزدوج عليه، أو الضغط على Enter وهو محدد، الحجمَ الافتراضي للجزء.

تُحفظ الأحجام للمرة القادمة.

التلميحات

تعرض الشاشات التسميات والقيم والحالات، وتترك شروحها للتلميحات: ما يتوقعه الحقل، وما تعنيه 0 فيه، وأي مفتاح يفعل الشيء نفسه. يظهر التلميح عند إبقاء المؤشر على عنصر نحو نصف ثانية، وفورًا عند الوصول إليه بلوحة المفاتيح؛ ويعرض الحقل تلميح تسميته. ويُخفيه Esc، أو الكتابة، أو النقر، أو التمرير. وتقرأ برامج قراءة الشاشة النص نفسه.

وتذكر رسائل الأخطاء أين حدث الخطأ وما هو ولماذا؛ وتُطوى صياغة النظام نفسه تحت التفاصيل التقنية.

الشاشات تحتفظ بحالتها

تُفتح الشاشة في أول زيارة لها ثم تبقى كما هي أثناء العمل على غيرها: ما كُتب فيها، وآخر استجابة، وقائمة رسائل المراقب والمهمة التي وراءها، وحتى موضع التمرير — كلها تبقى عند العودة. والمهمة الجارية تستمر أيًّا كانت الشاشة المعروضة.

وتُحفظ بعض القيم أيضًا بين مرات إعادة التشغيل: رسالة OSC التي كانت تُرسل، وطلب HTTP، وعنوان WebSocket، وأحجام الأجزاء، والشاشة التي كانت مفتوحة.

تنبيه جدار الحماية

يقرر جدار حماية Windows Defender، برنامجًا برنامجًا، هل يُسمح للأجهزة الأخرى بالوصول إليه. وفي أول مرة يستمع فيها برنامج، يسأل Windows الشخص الذي أمام الشاشة — والضغط على إلغاء هناك، أو شبكة يعدّها Windows عامة، يُسقط بصمت كل ما ترسله الأجهزة الأخرى. والعلامة المعتادة على ذلك مراقب لا يعرض شيئًا.

لذلك، في التطبيق المكتبي على Windows، وفي أول مرة يبدأ فيها شيء بالاستماع — مراقب OSC، أو مستمع الاكتشاف، أو مرحّل إضعاف، أو محاكٍ، أو تشغيل تجربة — يفحص Signal Lab جدار الحماية مرة واحدة. وحين يكون جدار الحماية عائقًا، يذكر ذلك تنبيه تحت الشريط العلوي:

• يطلب الزر السماح صلاحيات المسؤول عبر نافذة الطلب الخاصة بـ Windows، ثم يسمح للأجهزة الأخرى بالوصول إلى Signal Lab على الشبكات الخاصة وشبكات المجال.
• وعلى شبكة يعدّها Windows عامة — وكثيرًا ما تكون شبكة Wi-Fi في موقع العرض — يكون الزر السماح على الشبكات العامة أيضًا بدلًا من ذلك.
• ويُخفي الزر ليس الآن التنبيه طوال هذه الجلسة.

والسماح يستبدل بقواعد جدار الحماية الواردة الخاصة بـ Signal Lab قاعدةَ سماح واحدة. ولا تتأثر أبدًا حركة المرور داخل هذا الكمبيوتر نفسه (127.0.0.1)، لذا يمكن تجاهل التنبيه أثناء العمل على عنوان الاسترجاع. والتثبيت للجميع يتضمن القاعدة مسبقًا؛ انظر ما يضيفه برنامج الإعداد. ويذكر signallab doctor الشيء نفسه من الطرفية، ويصلحه signallab firewall allow هناك — انظر سطر الأوامر. ولا يوجد تنبيه على Linux ولا في المتصفح: فجدار حماية الخادم شأن مسؤوله.

في المتصفح

صفحة الخادم هي الواجهة نفسها، مع بعض الفروق:

• يسمّي المضيف في الشريط العلوي الخادمَ، وبجانبه الخادم.
• إذا طلب الخادم رمز وصول، يُسجَّل الدخول مرة واحدة، ويُنهي الزر تسجيل الخروج في الشريط العلوي الجلسة.
• إذا فقدت الصفحة اتصالها بالخادم، يعرض شريط العبارة انقطع الاتصال بالخادم — جارٍ إعادة الاتصال… حتى يعود الاتصال؛ وتسجّل وحدة التحكم الحدثين كليهما.
• تُنزَّل تقارير التشغيل والملفات المصدَّرة وما التقطه الفاحص عبر المتصفح بدلًا من عرضها مسارًا.
• لا تحديثات في نافذة «حول»: يُحدَّث الخادم مع صورته.

كل ما تفعله صفحة الخادم يجري على الخادم: تنطلق منه حركة المرور، وتستمع المراقبات على منافذه، وتُحفظ الملفات في مجلد بياناته. انظر المفاهيم.

اللغات

يعرض العلم في الشريط العلوي اللغة الحالية ورمزها المكوّن من حرفين. وبالنقر عليه تُفتح قائمة بكل اللغات، كلٌّ منها بعلمها واسمها بلغتها، ويُختار منها. وفي القائمة تنقّل مفاتيح ↑ و↓ وHome وEnd التحديد، وينتقل الحرف إلى اللغة التالية التي تبدأ به — في اسمها بلغتها أو بالإنجليزية، فيعثر g على Deutsch — ويختار Enter اللغة، ويُغلق Esc القائمة.

تتبدل الواجهة فورًا، دون إعادة تشغيل: كل شاشة وتلميح وخطأ، وأسطر وحدة التحكم السابقة أيضًا. وفي أول تشغيل يختار Signal Lab أول لغة من لغات النظام تتوفر لديه، أو الإنجليزية، ثم يحتفظ بالاختيار من بعدها — وفي المتصفح، لذلك المتصفح.

وتقلب العربية النافذة كلها من اليمين إلى اليسار. ويبقى ما هو بيانات من اليسار إلى اليمين كما كُتب: العناوين، ومقاطع البيانات الست عشرية، والشيفرة، ولوحة رسم التجربة.